USB gadget 驱动 printer.c 分析
Posted hellokitty2
tags:
篇首语：本文由小常识网(cha138.com)小编为大家整理，主要介绍了USB gadget 驱动 printer.c 分析相关的知识，希望对你有一定的参考价值。
1. modprobe g_printer idVendor=0x0525 idProduct=0xa4a8 modprobe后面也可以加模块参数
2. prn_example从stdout获取数据然后通过USB发送出去，下面让他将文件中的内容发送出去：
# cat data_file | prn_example -write_data
3.pdev = device_create(usb_gadget_class, NULL, devt, NULL, "g_printer%d", dev->minor); /*这个应该是在gadget类下创建一个device: struct device结构*/
4. 在调用bind后，经过重重函数调用，现在设备终于饱满了，既有配置了，也有接口了，接口里也有相应的端点了。各层的关系也都联系起来了。
5.核心结构体
/*将配置分组到gadget中*/ struct usb_composite_driver { const char *name; const struct usb_device_descriptor *dev; struct usb_gadget_strings **strings; enum usb_device_speed max_speed; unsigned needs_serial:1; /*用于分配整个设备共享的资源，例如字符串ID，并使用@usb_add_config()添加其配置。 返回负的errno值可能会失败; 它应该在成功初始化时返回零。*/ int (*bind)(struct usb_composite_dev *cdev); /*与@bind相反*/ int (*unbind)(struct usb_composite_dev *); /*可选的驱动断开方法*/ void (*disconnect)(struct usb_composite_dev *); /* global suspend hooks */ void (*suspend)(struct usb_composite_dev *); void (*resume)(struct usb_composite_dev *); /*hidg_driver:指向全局composite_driver_template*/ struct usb_gadget_driver gadget_driver; };
/*代表一个复合的USB gadget*/ struct usb_composite_dev { /*只读，作为此gadget的USB外设USB控制器的抽象*/ struct usb_gadget *gadget; /*用于控制响应; 缓冲区是预先分配的*/ struct usb_request *req; /*用于OS描述符响应,缓冲区是预先分配的*/ struct usb_request *os_desc_req; /*当前active的配置*/ struct usb_configuration *config; /* OS String is a custom (yet popular) extension to the USB standard. */ u8 qw_sign[OS_STRING_QW_SIGN_LEN]; u8 b_vendor_code; struct usb_configuration *os_desc_config; unsigned int use_os_string:1; /* private: */ /* internals */ unsigned int suspended:1; struct usb_device_descriptor desc; struct list_head configs; /*usb_add_config_only()中将add的config添加到这个链表中*/ struct list_head gstrings; struct usb_composite_driver *driver; u8 next_string_id; char *def_manufacturer; /* the gadget driver won‘t enable the data pullup * while the deactivation count is nonzero. */ unsigned deactivations; /* the composite driver won‘t complete the control transfer‘s * data/status stages till delayed_status is zero. */ int delayed_status; /* protects deactivations and delayed_status counts*/ spinlock_t lock; /* public: */ unsigned int setup_pending:1; /*true when setup request is queued but not completed*/ unsigned int os_desc_pending:1; };
/*代表usb从设备的驱动程序 */ struct usb_gadget_driver { /*描述此gadget功能的字符串*/ char *function; /*String describing the gadget‘s function*/ /*此驱动能处理的最大速率*/ enum usb_device_speed max_speed; /*驱动的bind的回调*/ int (*bind)(struct usb_gadget *gadget, struct usb_gadget_driver *driver); /*驱动程序从gadget解除绑定时调用，通常来自rmmod（报告断开连接后）,在允许睡眠的环境中调用*/ void (*unbind)(struct usb_gadget *); /** @setup：由未被硬件级驱动程序处理的ep0控制请求调用。 大多数调用必须由gadget驱动程序处理， 包括描述符和配置管理。 设置数据的16位成员按USB字节顺序排列。 在in_interrupt被调用; 这可能不 会睡觉。 驱动程序将对ep0的响应排队，或将负数返回到停止。*/ int (*setup)(struct usb_gadget *,const struct usb_ctrlrequest *); /*@disconnect：在主机断开连接后停止所有传输后调用。 可能在中断上下文中调用; 这可能不能睡眠。 某些设备无法检测到断开连接，因此除非作为控制器关闭的一部分，否则可能无法调用此函数。*/ void (*disconnect)(struct usb_gadget *); void (*suspend)(struct usb_gadget *); void (*resume)(struct usb_gadget *); void (*reset)(struct usb_gadget *); /* FIXME support safe rmmod */ /*===>目前内核不支持安全的rmmod!!!*/ struct device_driver driver; /*应该绑定此驱动程序的UDC名称。 如果udc_name为NULL，则此驱动程序将绑定到任何可用的UDC。*/ char *udc_name; struct list_head pending; /*挂载在等待udc的链表上*/ unsigned match_existing_only:1; /*决定在没有available的UDC时，释放将绑定请求的driver挂载到pending链表上 see usb_gadget_probe_driver()*/ };
/*代表一个usb从设备*/ struct usb_gadget { /*sysfs_notify()使用的工作队列*/ struct work_struct work; struct usb_udc *udc; /*用于访问特定于硬件的操作的函数指针，对于gadget driver来说是只读的*/ const struct usb_gadget_ops *ops; /*指向全局的:renesas_usb3_gadget_ops*/ struct usb_ep *ep0; /*端点0，控制端点*/ struct list_head ep_list; /* of usb_ep， List of other endpoints supported by the device.*/ enum usb_device_speed speed; enum usb_device_speed max_speed; enum usb_device_state state; const char *name; struct device dev; unsigned out_epnum; /*分别为输入输出端点数*/ unsigned in_epnum; unsigned mA; struct usb_otg_caps *otg_caps; unsigned sg_supported:1; unsigned is_otg:1; /*标识是不是otg设备*/ unsigned is_a_peripheral:1; unsigned b_hnp_enable:1; unsigned a_hnp_support:1; unsigned a_alt_hnp_support:1; unsigned hnp_polling_support:1; unsigned host_request_flag:1; unsigned quirk_ep_out_aligned_size:1; unsigned quirk_altset_not_supp:1; unsigned quirk_stall_not_supp:1; unsigned quirk_zlp_not_supp:1; unsigned quirk_avoids_skb_reserve:1; unsigned is_selfpowered:1; /*表明此gadget是否为self-powered*/ unsigned deactivated:1; unsigned connected:1; unsigned lpm_capable:1; };
我们发现这些bind就是一个目的，初始化struct usb_composite_dev结构，使其逐渐丰满。因为这个结构代表一个USB设备。
经过合适的初始化后设备才能正确的工作。经过重重初始化，三层总算整合在了一起了。这三层最终形成了一个饱满的
struct usb_composite_dev结构。这个结构包含USB设备运行各种信息。包括：配置，接口，端点等。
6.作为host称为USB主机控制器驱动，作为gadget时称为USB设备控制器驱动（UDC）
7.USB设备控制器驱动，需要关心四个核心的数据结构，这些数据结构包括描述一个USB设备控制器的usb_gadget、UDC操作usb_gadget_ops、
描述一个端点的usb_ep以及描述端点操作的usb_ep_ops结构体。UDC驱动围绕这些数据结构及其成员函数展开
8.打印机的设备位置为：# ls -l /devices/virtual/usb_printer_gadget/
9.由于普通USB设备只有一个上游端口，因此它们只有一个这样的驱动程序。 控制器驱动程序可以支持任意数量的不同gadget驱动程序，
但一次只能使用其中一个。
10.host端驱动与USB主机控制器驱动的交互通过 struct urb, 而作为gadget时，驱动与USB设备控制器之间的交互使用 struct usb_request来 ########
描述一次IO请求。
11.内核文档翻译：
https://01.org/linuxgraphics/gfx-docs/drm/driver-api/usb/gadget.html?highlight=usb_composite_probe#c.usb_composite_probe
gadget驱动的生命周期
gadget驱动程序向硬件发出端点I/O请求，而无需了解硬件的许多细节，但驱动程序设置/配置代码需要处理一些差异。 像这样使用API：
1.为特定设备端USB控制器硬件注册驱动程序，例如PCI PDA（USB 2.0）上的net2280，Linux PDA中的sa11x0或pxa25x，依此类推。 此时，
设备逻辑上处于USB ch9初始状态（已连接attached），没有电源且无法使用（因为它还不支持枚举）。 任何主机都不应该看到该设备，
因为即使VBUS电源可用，它也不会激活主机用来检测设备的数据线上拉。
2.注册实现某些更高级别设备功能的gadget驱动程序。 然后将bind()绑定到usb_gadget，它会在检测到VBUS后的某个时间激活数据线上拉。
3.硬件驱动程序现在可以开始枚举。 它处理的步骤是接受USB电源和set_address请求。 其他步骤由gadget驱动程序处理。 如果在主机开
始枚举之前卸载gadget驱动程序模块，则跳过步骤7之前的步骤。
4.gadget驱动程序的setup()调用返回usb描述符，既基于总线接口硬件提供的内容，也基于正在实现的功能。 这可能涉及备用设置或配置，
除非硬件阻止此类操作。 对于OTG设备，每个配置描述符包括OTG描述符。
5.当USB主机发出set_configuration调用时，gadget驱动程序处理枚举的最后一步。 它使能该配置中使用的所有端点，使所有接口都处于
默认设置。 这涉及使用硬件端点列表，根据端点描述符启用每个端点。 它还可能涉及使用usb_gadget_vbus_draw()来从VBUS中获取更多的
电流(可选Rcar3没有实现)，如该配置所允许的那样。 对于OTG设备，设置配置还可能涉及通过用户界面报告HNP功能。
6.执行实际工作并执行数据传输，可能涉及更改接口设置或切换到新配置，直到设备与主机断开连接disconnect()。 将任意数量的传输请求
排队到每个端点。 在断开连接之前，它可能会被suspend和resume几次。 断开连接时，驱动程序将返回步骤3（上方）。
7.卸载gadget驱动程序模块时，驱动程序的unbind()将会被回调。 这样可以控制器驱动程序被卸载。
驱动程序通常会被安排，以便只加载gadget驱动程序模块（或将其静态链接到Linux内核）允许外围设备被枚举，但某些驱动程序将推迟枚举，
直到某些更高级别的组件（如用户模式守护程序）使能它。 请注意，在此最低级别，没有关于如何实现ep0配置逻辑的策略，除了它应遵守
USB规范。 这些问题属于gadget驱动程序领域，包括了解某些USB控制器强加的实施限制，或者了解复合设备可能恰好通过集成可重用组件来
构建。
请注意，OTG设备的上述生命周期可能略有不同。 除了在每个配置中提供额外的OTG描述符之外，只有与HNP相关的差异对于驱动程序代码特
别可见。 它们涉及SET_CONFIGURATION请求期间的报告要求，以及在某些挂起回调期间调用HNP的选项。 此外，SRP稍微改变了
usb_gadget_wakeup的语义。
struct usb_request 描述一次IO请求。
12.Gadget 功能驱动层, Gadget功能驱动层是USB Gadget软件结构的最上层。主要是实现USB设备的功能，
这一层通常与linux内核的其他子系统有密切的联系。
13.mod_gadget.c：这个是2.0的UDC驱动，renesas_usb3.c: 应该3.0的usb gadget的UDC驱动。
14.UDC层还需要提供USB设备的中断处理程序，中断处理尤其重要。因为所有的USB传输都是由主机发起，而有没有USB传输完全由USB中断判
定，所以USB中断处理程序是整个软件架构的核心。
15.在用户程序中，select()和poll()本质上是一样的， 不同只是引入的方式不同，前者是在BSD UNIX中引入的，后者是在System V中引入的。
用的比较广泛的是select
16.DECLARE_USB_FUNCTION_INIT(printer, gprinter_alloc_inst, gprinter_alloc);
DECLARE_USB_FUNCTION_INIT(printer, gprinter_alloc_inst, gprinter_alloc); /*==========================上面等效下面======================================*/ static struct usb_function_driver printerusb_func = { .name = "printer", .mod = THIS_MODULE, .alloc_inst = gprinter_alloc_inst, .alloc_func = gprinter_alloc, }; MODULE_ALIAS("usbfunc:printer"); /*用它来加载驱动模块*/ static int __init printermod_init(void) { return usb_function_register(&printerusb_func); } static void __exit printermod_exit(void) { usb_function_unregister(&printerusb_func); } module_init(printermod_init); module_exit(printermod_exit);
17.module_param_named(maximum_line_test, max_test, int, 0); 此定义下，该参数的外部可见参数名为：maximum_line_test，内部全局变量名为：max_test */
18.usb2.0的gadget的UDC注册过程：
usbhs_probe //[usb/renesas_usbhs/common.c] usbhs_mod_probe //[usb/renesas_usbhs/mod.c] usbhs_mod_gadget_probe //[usb/renesas_usbhs/mod_gadget.c] usb_add_gadget_udc(struct device *parent, struct usb_gadget *gadget) //[usb/gadget/udc/core.c] 将新gadget添加到udc类驱动程序列表中 udc = kzalloc(sizeof(*udc), GFP_KERNEL); udc->dev.class = udc_class; udc->dev.groups = usb_udc_attr_groups; list_add_tail(&udc->list, &udc_list); 将此udc放到全局链表udc_list中 usb_gadget_set_state(gadget, USB_STATE_NOTATTACHED); udc->vbus = true; check_pending_gadget_drivers(udc) //[usb/gadget/udc/core.c] 匹配一个usb_gadget_driver list_for_each_entry(driver, &gadget_driver_pending_list, pending) //在gadget_driver_pending_list查找pending的usb_gadget_driver if (!driver->udc_name || strcmp(driver->udc_name, dev_name(&udc->dev)) == 0) //usb_udc和usb_gadget_driver通过名字进行匹配 ret = udc_bind_to_driver(udc, driver); =====>UDC也是以一个usb_gadget的形式注册的。
19.f_printer.c中function注册过程：
DECLARE_USB_FUNCTION_INIT int __init printermod_init(void) usb_function_register(&printerusb_func) //这个注册仅仅是将usb_function_driver放到全局链表func_list中 list_add_tail(&newf->list, &func_list); //[usb/gadget/functions.c]
20.printer.c中：
printer_driver_init usb_composite_probe(struct usb_composite_driver *driver); //传参为全局变量&printer_driver driver->gadget_driver = composite_driver_template; 由usb_composite_driver构造出一个usb_gadget_driver usb_gadget_probe_driver(struct usb_gadget_driver *driver) //传参为构造出来的usb_gadget_driver 它里面去匹配已经注册的UDC,若匹配不到就挂载在gadget_driver_pending_list上。 list_for_each_entry(udc, &udc_list, list) //在udc_list上查找已经注册的usb_udc list_add_tail(&driver->pending, &gadget_driver_pending_list); //若匹配不到就将usb_gadget_driver放到链表gadget_driver_pending_list中。 udc_bind_to_driver(udc, driver); //若找到就将此usb_udc绑定到usb_gadget_driver中 udc->driver = driver; driver->bind(udc->gadget, driver); //调用usb_gadget_driver的bind(),也就是composite_bind，是模板composite_driver_template中的， 参数是usb_gadget和usb_gadget_driver struct usb_composite_dev *cdev = kzalloc(sizeof *cdev, GFP_KERNEL); //分配一个usb_composite_dev结构 cdev->gadget = usb_gadget; composite_dev_prepare(struct usb_composite_driver *composite, struct usb_composite_dev *cdev) cdev->req = usb_ep_alloc_request(gadget->ep0, GFP_KERNEL); //预先分配ep0使用的req cdev->req->complete = composite_setup_complete; //指定ep0的完成回调函数 usb_ep_autoconfig_reset(gadget); //执行一次端点的rest composite->bind(cdev); //调用usb_composite_driver的bind()，也就是printer_bind，其调用流程如① ########### update_unchanged_dev_desc(usb_device_descriptor *new, usb_device_descriptor *old) //更新设备描述符 usb_gadget_udc_start(udc); //使能usb设备控制器 udc->gadget->ops->udc_start(udc->gadget, udc->driver) //也就是调用usbhsg_gadget_ops.usbhsg_gadget_start，做一些设备控制器的初始化 usbhsg_try_start usbhsg_update_pullup usb_udc_connect_control(udc); usb_gadget_connect gadget->ops->pullup(gadget, 1); //也就是调用usbhsg_gadget_ops.pullup,使能Dp上拉 kobject_uevent(&udc->dev.kobj, KOBJ_CHANGE); //上报App printer.c中的usb_composite_driver.bind的调用流程： printer_bind //① ########### usb_get_function_instance("printer"); try_get_usb_function_instance(name); list_for_each_entry(fd, &func_list, list) 在全局链表func_list中通过name查找之前使用 fi = fd->alloc_inst(); 找到对应的usb_function_driver并调用其alloc_inst() fi->fd = fd; return fi; 然后fi->fd指向找到的usb_function_driver结构体。 usb_string_ids_tab(cdev, strings); //[usb/gadget/functions.c] 为每一个字符串都分配一个唯一的id,然后将这些id赋值给 usb_device_descriptor中的iManufacturer，iProduct，iSerialNumber。 gadget_is_otg //判断是不是otg,如果是，还要为其分配otg描述符 usb_otg_descriptor_alloc usb_add_config(cdev, &printer_cfg_driver, printer_do_config); usb_add_config_only(cdev, config); //将此config添加到usb_composite_dev cdev->configs中 printer_do_config //执行这个回调 usb_ep_autoconfig_reset usb_gadget_set_selfpowered f_printer = usb_get_function(fi_printer); f = fi->fd->alloc_func(fi); //调用usb_function_instance的usb_function_driver的alloc_func，应该就 是gprinter_alloc，获取到一个usb_function gprinter_alloc中初始化usb_function的各个成员函数(bind,unbind,setup,set_alt)，做一些链表的初始化 f->fi = fi; return f; //usb_function的usb_function_instance指向此fi status = usb_add_function(c, f_printer); list_add_tail(&function->list, &config->functions); //将此usb_function挂接在usb_configuration的functions链表上 function->bind(config, function) //调用function的bind进行绑定，也即是printer_func_bind usb_interface_id //分配一个没有使用的接口id in_ep = usb_ep_autoconfig(cdev->gadget, &fs_ep_in_desc); //根据端点描述符自动分配IN/OUT端点 out_ep = usb_ep_autoconfig(cdev->gadget, &fs_ep_out_desc); usb_assign_descriptors //对usb_function中的各个描述符赋值 for (i = 0; i < dev->q_len; i++) //为in_ep/out_ep分配usb_request，并将其插入队列中 req = printer_req_alloc(dev->in_ep, USB_BUFSIZE, GFP_KERNEL); list_add(&req->list, &dev->tx_reqs); req = printer_req_alloc(dev->out_ep, USB_BUFSIZE, GFP_KERNEL); list_add(&req->list, &dev->rx_reqs); device_create(usb_gadget_class, NULL, devt, NULL, "g_printer%d", dev->minor); //创建设备类，为创建设备文件做准备 cdev_init(&dev->printer_cdev, &printer_io_operations); //在bind()中指定对用户空间的接口printer_io_operations ret = cdev_add(&dev->printer_cdev, devt, 1); usb_ep_autoconfig_reset(cdev->gadget); //执行一次reset ep的操作 usb_composite_overwrite_options //用来以实际的值覆盖USB_GADGET_COMPOSITE_OPTIONS中的模块参数声明。
以上是关于USB gadget 驱动 printer.c 分析的主要内容，如果未能解决你的问题，请参考以下文章