如何以r8169为例开发IgH EtherCAT主站实时网卡驱动？

目录一、IgH 驱动适配框架概览为什么需要适配网卡驱动?两种驱动方案技术详情标准驱动 vs IgH 适配驱动对比IgH 设备抽象层 API适配方法论：5 步流程Generic 驱动方案ec_device 与 net_device 的关系设备 MAC 匹配机制深入源码ecdev_offer() 实现ec_device_attach() 实现ec_device_poll() 实现ecdev_receive() 实现Generic 驱动核心函数ec_gen_device_poll()二、r8169 驱动深入分析概览r8169 驱动与 EtherCAT修改点总览技术详情钩子位置总览图私有数据结构新增字段核心辅助函数 get_ecdev()中断/轮询到 Datagram 的完整调用链设备生命周期模式切换深入源码1. 私有数据结构扩展2. ec_poll() — 核心轮询函数3. ec_kick_watchdog() — PHY 链路变化处理4. rtl_rx() — RX 路径关键修改5. rtl8169_start_xmit() — TX 发送修改6. rtl_tx() — TX 完成处理修改7. rtl_irq_enable() — 中断禁用8. rtl_open() — 设备打开修改9. rtl_init_one() — 设备探测修改10. 电源管理阻断修改点完整清单三、添加新驱动指南概览适配新网卡驱动的核心思路技术详情适配 Checklist 流程图Step 0: 准备工作Step 1: 添加 EtherCAT 字段到私有数据结构Step 2: 实现 ec_poll() 函数Step 3: 修改设备初始化和清理Step 4: 修改中断控制Step 5: 修改 TX 路径Step 6: 修改 RX 路径（最关键）Step 7: 阻断电源管理Step 8: 编译和集成深入源码常见陷阱和注意事项调试方法1. 编译时调试2. 加载时调试3. 运行时调试4. 常见问题排查决策树从 r8169 适配提取的通用 diff 模式Makefile 和 configure 集成 一、IgH 驱动适配框架 5.1 — 网卡驱动适配方法论 — devices/ 概览 为什么需要适配网卡驱动? EtherCAT 主站需要精确控制网卡的数据收发时机。标准 Linux 网卡驱动使用中断驱动模型，其响应时间受内核调度器影响，无法满足 EtherCAT 周期性通信（通常 1ms 甚至更短）的确定性要求。 IgH EtherCAT Master 通过适配网卡驱动解决这个问题：将网卡从中断驱动模式切换到轮询 (Poll) 模式，由主站的实时线程主动调用 poll 函数来收发数据。 核心思想 IgH 并不重新实现网卡驱动，而是在现有 Linux 内核驱动基础上添加 EtherCAT 钩子 (hook)。驱动在运行时通过 MAC 地址匹配决定是工作在普通网络模式还是** EtherCAT 轮询模式**。两种模式互斥，同一时刻只能处于其中一种。 两种驱动方案 方案 实现 适用场景 性能 Generic 驱动 devices/generic.c 快速验证，无需修改驱动源码 一般（通过 socket 收发，有额外拷贝） 原生适配驱动 devices/r8169/ 等 生产环境，需要最佳实时性能 优秀（直接 DMA 零拷贝） 技术详情 标准驱动 vs IgH 适配驱动对比 IgH 设备抽象层 API IgH 为网卡驱动提供一组简洁的 API（定义在 devices/ecdev.h），驱动只需调用这几个函数即可完成适配： API 函数 签名 作用 调用时机 ecdev_offer() ec_device_t *ecdev_offer(struct net_device *, ec_pollfunc_t, struct module *) 将网卡设备"提交"给 EtherCAT 主站系统。