​1 USB ECM介绍

USB ECM,属于USB-IF定义的CDC(Communication Device Class)下的一个子类:Ethernet Networking Control Model,用于Host和Device之间交换以太网帧。下图是从USB ECM规范中截取:

2 关键描述符解析

用USB tool抓取ECM设备的描述符,部分关键描述符如下。

首先是IAD描述符。

IAD Descriptor        : Interface AssociationDescriptor,接口关联描述符,将多个接口组合在一起。

bDescriptorType     : 0x0B 表示描述符类型是IAD描述符。

bInterfaceCount      : 0x02表示组合的接口数目是2个。

bFunctionClass        : 0x02表示CDC class。

bFunctionSubClass  : 0x06表示ECM subclass.

接下来是接口0的描述符,接口0用作ECM的control接口。

Interface Descriptor   : 接口描述符

bInterfaceNumber     : 0x00 标识该接口为接口0

bAlternateSetting      : 0x00 如果同一个接口有多个描述符设置,那该值就用来区分是哪个

bNumEndpoints         : 0x01表示该接口使用1个端点

bInterfaceClass           : 0x02 表示CDC class

bInterfaceSubClass     : 0x06 表示ECM subclass

bInterfaceProtocol      : 0x00 表示使用标准协议

以下三个CDC Interface Descriptor属于functional descriptor,functional descriptor用来描述class-specific的信息,从属于某个标准接口描述符下。

HeaderFunctional Descriptor,CDC class-specific的描述符必须以这个描述符作为开头。

UnionFunctional Descriptor,包含控制接口信息。

EthernetNetworking Functional Descriptor,包含网卡的信息,比如MAC地址、统计能力等。其中MAC地址是通过字符串index来间接表示的,位于该描述符第4个字节,这里是06,表示String Descriptor 6中存放了MAC地址。

接口0的端点描述符,使用IN-2端点,端点方向为IN(Device->Host),中断传输方式。

接下来是接口1的描述符,大部分字段的意义和接口0的描述符类似,因此不再重复解释。接口1用作ECM的data接口。

接口1用做ECM的data接口。分配了两个端点。

接口1的端点描述符,使用了IN-1端点,传输类型为Bulk。

接口1的另一个端点描述符,使用了OUT-1端点,传输类型为Bulk。

接下来是字串描述符,这里只截取了字串6,也就是存放MAC地址的字串。

3 数据通路

Device ->Host:

在ECM Gadget驱动中,USB角色是device,在本地注册一个以太网卡设备,网络协议栈发送数据到该网卡,该网卡驱动会将数据以USB传输的方式发送到主机。Host端有ECM Host驱动,也会在Host端注册一个以太网卡,收到USB传输过来的数据后,网卡会将数据上报给Host端的网络协议栈。

Host -> Devcie:

Host端网络协议栈把数据发给ECM Host驱动,ECM Host驱动以USB传输的方式将数据发送给Device,Device端网卡收到数据后,上报给Device端网络协议栈。

4 驱动流程

源码位置在:

drivers\usb\gadget\function\f_ecm.c

drivers\usb\gadget\function\u_ether.c

4.1 驱动的注册

注册function到USB gadget驱动框架中。

DECLARE_USB_FUNCTION_INIT(ecm, ecm_alloc_inst, ecm_alloc);

  

4.2 USB function的实现

  • ecm_alloc_inst函数主要是调用gether_setup_default创建一个net设备。

opts->net = gether_setup_default();

  

  • ecm_alloc函数主要做两件事:

一是从net设备中获取该网卡host mac地址并记录下来,后续bind时会添加到描述符中。

  status = gether_get_host_addr_cdc(opts->net, ecm->ethaddr,
sizeof(ecm->ethaddr));

  

二是按USB function driver框架注册各回调函数。

  ecm->port.func.name = "cdc_ethernet";
/* descriptors are per-instance copies */
ecm->port.func.bind = ecm_bind;
ecm->port.func.unbind = ecm_unbind;
ecm->port.func.set_alt = ecm_set_alt;
ecm->port.func.get_alt = ecm_get_alt;
ecm->port.func.setup = ecm_setup;
ecm->port.func.disable = ecm_disable;
ecm->port.func.free_func = ecm_free;

  

  • ecm_bind函数主要完成USB bind的过程:

一是将net设备和gadget关联,并注册net设备。

  if (!ecm_opts->bound) {
mutex_lock(&ecm_opts->lock);
gether_set_gadget(ecm_opts->net, cdev->gadget);
status = gether_register_netdev(ecm_opts->net);
mutex_unlock(&ecm_opts->lock);
if (status)
return status;
ecm_opts->bound = true;
}

  

二是处理字符串描述符。

  ecm_string_defs[1].s = ecm->ethaddr;

us = usb_gstrings_attach(cdev, ecm_strings,
ARRAY_SIZE(ecm_string_defs));
if (IS_ERR(us))
return PTR_ERR(us);
ecm_control_intf.iInterface = us[0].id;
ecm_data_intf.iInterface = us[2].id;
ecm_desc.iMACAddress = us[1].id;
ecm_iad_descriptor.iFunction = us[3].id;

  

三是分配interface,并将interface信息更新到描述符中。

  /* allocate instance-specific interface IDs */
status = usb_interface_id(c, f);
if (status < 0)
goto fail;
ecm->ctrl_id = status;
ecm_iad_descriptor.bFirstInterface = status;

ecm_control_intf.bInterfaceNumber = status;
ecm_union_desc.bMasterInterface0 = status;

status = usb_interface_id(c, f);
if (status < 0)
goto fail;
ecm->data_id = status;

ecm_data_nop_intf.bInterfaceNumber = status;
ecm_data_intf.bInterfaceNumber = status;
ecm_union_desc.bSlaveInterface0 = status;

  

四是分配端点。

  /* allocate instance-specific endpoints */
ep = usb_ep_autoconfig(cdev->gadget, &fs_ecm_in_desc);
if (!ep)
goto fail;
ecm->port.in_ep = ep;

ep = usb_ep_autoconfig(cdev->gadget, &fs_ecm_out_desc);
if (!ep)
goto fail;
ecm->port.out_ep = ep;
ep = usb_ep_autoconfig(cdev->gadget, &fs_ecm_notify_desc);
if (!ep)
goto fail;
ecm->notify = ep;

  

五是分配描述符。

  status = usb_assign_descriptors(f, ecm_fs_function, ecm_hs_function,
ecm_ss_function, NULL);

  

4.3 网卡部分的实现

  • 网卡设备操作函数集

static const struct net_device_ops eth_netdev_ops = {
.ndo_open = eth_open,
.ndo_stop = eth_stop,
.ndo_start_xmit = eth_start_xmit,
.ndo_set_mac_address = eth_mac_addr,
.ndo_validate_addr = eth_validate_addr,
};

  

  • 分配网卡设备

static inline struct net_device *gether_setup_default(void)
{
return gether_setup_name_default("usb");
}

  

  • 注册网卡设备

int gether_register_netdev(struct net_device *net)

  

  • 数据的收发

static netdev_tx_t eth_start_xmit(struct sk_buff *skb,
struct net_device *net)
static void rx_fill(struct eth_dev *dev, gfp_t gfp_flags)
static void process_rx_w(struct work_struct *work)
static void process_tx_w(struct work_struct *w)

  

以上就是对Linux USB ECM Gadget驱动的介绍,谢谢阅读。

文章会在公众号“大鱼嵌入式”同步发布,欢迎关注,一起交流。

Linux USB ECM Gadget 驱动介绍的更多相关文章

  1. Linux USB 鼠标输入驱动具体解释

    平台:mini2440 内核:linux 2.6.32.2 USB设备插入时.内核会读取设备信息,接着就把id_table里的信息与读取到的信息做比較.看是否匹配,假设匹配.就调用probe函数. U ...

  2. [置顶] 自娱自乐6之Linux gadget驱动5(自编gadget驱动,包涵与之通讯的主机usb驱动,已调试通过)

    这个代码调试,你首先要保证你的udc驱动没用问题,这个有些矛盾,应为我本来要用gadget驱动来调试udc驱动,结果反过来了. 这是在zero基础改的,大概的改动 1. 去掉loop. 2. sink ...

  3. Linux usb gadget框架概述

    很幸运,在公司开发了gadget相关驱动,总结下来,大大小小开发了四个与gadget相关的驱动,字符驱动.g_multi.g_ether.g_zero,在这里把自己对gadget的开发中自己的感悟记录 ...

  4. Linux主机USB RNDIS网卡驱动实现不完整导致的一例问题

    某通信模块设备,通过USB提供RDNIS和ECM网卡功能.在实际应用中发现,USB RNDIS网卡模式下,当使用AT指令以不同的CID拨号的时候,在Windows主机上能正常拨号成功,但在Linux主 ...

  5. Linux USB驱动

    linux usb 驱动详解 一 http://blog.163.com/cl2006ky@126/blog/static/87195173201131245557340/ USB设备驱动开发-USB ...

  6. Linux USB摄像头驱动【转】

    本文转载自:http://www.itdadao.com/articles/c15a509940p0.html 在 cortex-a8 中,可接入摄像头的接口通常可以分为两种, CAMERA 接口和 ...

  7. Linux usb子系统(三):通过usbfs操作设备的用户空间驱动

    内核中提供了USB设备文件系统(usbdevfs,Linux 2.6改为usbfs,即USB文件系统),它和/proc类似,都是动态产生的.通过在/etc/fstab文件中添加如下一行:none /p ...

  8. Linux usb子系统(二):USB设备驱动usb-skeleton.c

    usb驱动分为通过usbfs操作设备的用户空间驱动,内核空间的内核驱动.两者不能同时进行,否则容易引发对共享资源访问的问题,死锁!使用了内核驱动,就不能在usbfs里驱动该设备. 下面转载的一篇分析u ...

  9. Linux usb子系统(一) _写一个usb鼠标驱动

    USB总线是一种典型的热插拔的总线标准,由于其优异的性能几乎成为了当下大小设备中的标配. USB的驱动可以分为3类:SoC的USB控制器的驱动,主机端USB设备的驱动,设备上的USB Gadget驱动 ...

随机推荐

  1. Python脚本打包成exe执行文件

    需求 一个教辅目录结构检查工具,目录结构是[书籍]-[章节]-[题目|答案]-[*.jpg],后台有个异步处理的服务,需要强依赖这个目录结构. 书籍解析是单独的pipeline,日志对用户不可见,这里 ...

  2. Leedcode算法专题训练(贪心)

    1. 分配饼干 455. 分发饼干 题目描述:每个孩子都有一个满足度 grid,每个饼干都有一个大小 size,只有饼干的大小大于等于一个孩子的满足度,该孩子才会获得满足.求解最多可以获得满足的孩子数 ...

  3. 浅入kubernetes(5):尝试kubeadm

    本篇介绍利用 kubernetes 的命令行工具,快速创建集群实例,完成 hello world 实践. 上一篇试用 minikube 去搭建集群,这一篇将介绍通过 kubeadm 去操作. 命令行工 ...

  4. Vue Hello World

    1 Vue介绍 伟大的项目是从Hello World而来的,Hello World尽管没有什么实际性的作用,但是在于意义重大.(哈哈哈哈) 好了不废话了入正题. Vue是一套用于构建用户界面的渐进式J ...

  5. LNMP架构上线动态网站

    第一步,一键安装所需程序 yum install -y nginx php php-mysql php-fpm mariadb-server 第二步,修改Nginx配置文件/etc/nginx/ngi ...

  6. K8s - 解决主机重启后kubelet无法自动启动问题 错误:The connection to the server 192.168.60.128:6443 was refused - did you specify the right host or port?

    1,问题描述 (1)在安装配置好 Kubernetes 后,正常情况下服务器关机重启,kubelet 也会自动启动的.但最近配置的一台服务器重启后,输入命令 kubectl get nodes 查看节 ...

  7. 所谓 ICMP,不过将军与士卒而已

    什么是 ICMP 协议 关于这点我们在 IP 协议那篇文章中提过一嘴,IP 协议作为一种提供不可靠数据交付的网络层协议,在传输的过程中,其 IP 数据报可能会发生丢失.重复.延迟和乱序等各种情况, 但 ...

  8. 一台window服务器部署多个tomcat(超简单配置)!!!

    1.首先准备好已经安装好的jdk环境,点击查看JDK安装. 2.准备好一个全新的tomcat,我这里使用的是tomcat-7.0.109.rar绿色版. 3.解压文件,并复制成三份.我这里是放在F:\ ...

  9. 1.5.1- HTML之相对路径

    网页需要图片,首先需要找到它.实际工作中,通常新建一个文件夹专门用于存放图像文件,这时插入图像,就需要采用"路径"的方式来制定图像文件的位置.路径可以分为相对路径与绝对路径. 相对 ...

  10. 命令行运行py文件报错

    起因 今天用ubuntu 终端运行py文件报了个错,找不到模块? 我切换回pycharm中运行,运行一切正常 解决 在报错模块中,插入绝对路径 import sys sys.path.append(' ...