2. 内核源码结构分析

ECM（Ethernet Control Model）Gadget 驱动的核心源码位于 drivers/usb/gadget/function/ 目录下，由 u_ecm.c 和 u_ecm.h 两个文件构成。理解这两个文件的数据结构与函数调用链，是进行参数调优与数据传输优化的基础。

2.1 关键数据结构

u_ecm.h 定义了 ECM 驱动的核心数据结构，其中 f_ecm 是驱动实例的载体，ecm_ep_descs 管理端点描述符。

struct f_ecm {
    struct usb_function     func;
    struct usb_ep           *in_ep, *out_ep, *notify_ep;
    struct ecm_ep_descs    fs, hs, ss;
    struct ecm_notify       notify;
    struct eth_dev          *dev;
    struct net_device       *net;
    u8                      ctrl_id, data_id;
    atomic_t                online;
    unsigned                qmult;
    unsigned                mtu;
    // ... 其他调优参数
};

2.2 函数调用链分析

u_ecm.c 实现了 ECM 功能的生命周期管理、USB 请求处理、网络数据收发等核心逻辑。函数调用链可归纳为以下三大主线：

2.2.1 功能注册与绑定链

从模块初始化到功能实例绑定到 USB 配置的完整路径：

1. ecm_mod_init() → 注册 USB 功能驱动
2. ecm_bind() → 分配 f_ecm 实例，初始化端点
3. ecm_set_alt() → 根据配置选择高速/全速描述符
4. ecm_open() → 激活端点，启动网络设备

2.2.2 数据发送链

从网络层到 USB 请求提交的完整路径：

1. eth_start_xmit() → 网络设备发送回调
2. ecm_xmit() → 封装 ECM 头，准备 USB 请求
3. usb_ep_queue() → 将请求提交到批量输出端点
4. 硬件完成中断 → ecm_tx_complete() → 释放 skb，统计发送

2.2.3 数据接收链

从 USB 请求完成到网络协议栈的路径：

1. 硬件接收中断 → ecm_rx_complete() → 检查数据完整性
2. ecm_unwrap() → 解析 ECM 头，提取以太网帧
3. netif_rx() → 将 skb 送入网络协议栈
4. 重新分配请求 → usb_ep_queue() → 准备下一次接收

2.3 核心函数调用关系图

2.4 关键函数参数调优对照表

以下表格列出了 u_ecm.c 中直接影响性能的关键函数及其可调参数：

2.5 数据结构关系图

2.6 源码分析要点总结

• 数据结构层面：f_ecm 是核心结构体，包含端点、网络设备、调优参数等所有关键信息；ecm_ep_descs 管理不同速度模式下的端点描述符。
• 函数调用链：分为注册绑定链、数据发送链、数据接收链三条主线，其中发送链和接收链是性能调优的重点。
• 调优入口：qmult、mtu、请求预分配数量、DMA 对齐等参数均在 u_ecm.c 中定义或使用。
• 跨文件依赖：u_ecm.c 依赖 u_ether.c 提供的 eth_dev 管理功能，分析时需联动阅读。