添加链接 注册    登录
link管理
链接快照平台
  • 输入网页链接，自动生成快照
  • 标签化管理网页链接
相关文章推荐
奔放的黄瓜  ·  Linux密码密文：保障账户安全的必备信息 ...·  3 天前    · 
不拘小节的酸菜鱼  ·  使用linux的GDB打印STL(vecto ...·  2 天前    · 
英勇无比的领带  ·  Pycuda program not ...·  2 天前    · 
高大的青蛙  ·  Running JSP on Linux ...·  2 天前    · 
打酱油的小刀  ·  linux去除重复行命令 • Worktile社区·  昨天    · 
粗眉毛的蚂蚁  ·  ConflictAlgorithm ...·  2 月前    · 
阳刚的核桃  ·  ST百灵(002424)_股票行情，行情首页 ...·  4 月前    · 
霸气的小马驹  ·  线性代数—Wolfram 语言参考资料·  7 月前    · 
温柔的遥控器  ·  ayawawa口中的剪子石头布到底是什么？ ...·  1 年前    · 
朝气蓬勃的火腿肠  ·  前端解决跨域问题 - 简书·  1 年前    · 
link管理  ›  读书笔记 <Bootstrap Yourself with Linux USB Stack>_qq635f6f89e5645的技术博客_
otg host usb接口 linux系统
https://blog.51cto.com/u_15854579/6969247
阳光的雪糕
2 月前

书笔记 <Bootstrap Yourself with Linux USB Stack>

第一章 USB and Linux Introduction

  1. 关于USB的硬件
    三种类型:

USB Transceiver, 通常包含一个USB core在芯片上
Standalone USB Controller, transceiver + digital portion
Integrated USB Controller,



第二章 USB: An Overview

  1. USB System Architecture


    分为三个主要部分:
    USB device
    USB host
    USB interconnect
  2. USB host

    HCD: host control driver
    USBD: USB driver
    IRP: input/output request packets

    它由以下几部分组成:
    Client Software
    USB System Software
    Host Controller
  3. USB Device

    它由以下3部分组成:
    Function
    USB Logical Device
    USB Bus Interface
  4. USB Host和USB Device之间如何交互


    Endpoint, 一个device可以根据其function提供多个endpoint, 每个以device address, endpoint number, endpoint direction唯一标识.
    Endpoint Zero是一个特殊的endpoint, 每个device都必须要实现它. 它供Usb host初始化和获得device的信息.
    Endpoint需要通过以下几点描述它自己:
    The bus access frequency/latency requirement
    The bandwidth requirement
    The endpoint number
    The error-handling behavior requirements
    The maximum packet size that the endpoint is capable of sending or receiving
    The transfer type for the endpoint
    The direction in which data is transferred between the endpoint and thehost


    pipe, 它用来在逻辑上表示device endpoint和host software之间的联系. 最重要的一个pipe, 是用来连接host和endpoint zero的.
    stream pipe, 非USB-define format的数据
    message pipe, USB-define format的数据
  5. Enumeration
    它由host和device侧的USB logical layer共同配合完成.
    USB标准定义了标注流程:
    1. The USB device is attached to the host, which receives an event indicating a change in the pipe’s status. The USB device is in the powered state, and the port it is attached to is disabled.
    2. The host queries about the change in the bus.
    3. Once the host determines that a new device is attached, it waits for at least 100ms for the device to become stable after power, after which it enables and resets the port.
    4. After a successful reset, the USB device is in a default state and can draw power to a range of 100 mA from VBUS pin.
    5. Once the device is in a default state, the host assigns a unique address to the USB device, which moves the device to an address state.
    6. The host starts communicating with the USB device in the default control pipe and reads the device descriptor.
    7. Subsequently, the host reads the device configuration information.
    8. The host selects the configuration, which move the device to a configured state and makes it ready for use.


    Description
    标准定义device, configuration,interface, endpoint, string五类description.

  6. USB Transfers
    定义了4种transfer, 它们都描述了下述的属性:
    n Direction of communication flow
    n Constraint in the packet size
    n Bus access constraints
    n Latency constraints
    n Required data sequences
    n Error handling

    Control Transfer,
    Bulk Transfer, 大数据
    Interrupt Transfer, 小数据
    Isochronous Transfer, audio,video之类的实时大数据
  7. 一些重要术语
    Short packet. A short packet can be defined as a packet whose payload is
    shorter than the maximum size or zero length packet (ZLP). A short
    packet could indicate the end of a transfer.
    Zero length packet (ZLP) . A zero length data packet transfer does not
    contain data as part of the transfer. When the data to be sent is an exact
    multiple of wMaxPacketSize, a ZLP has to be sent after the data transfer
    is complete to indicate the end of the transfer. Sometimes a ZLP feature
    is implemented as part of the hardware or has to be taken care when
    designing Chapter 9/USB.
    STALL . A STALL indicates that a function is unable to transmit or
    receive data or that even a control pipe request is not supported. The
    state of a function after returning a STALL is undefined.

第三章, Overview of the linux USB Subsystem

  1. Linux kernel中的USB相关代码结构


  2. 关于Gadget subsystem
    USB controller driver实现了USB device controller, 它用来抽象硬件的功能给gadget layer使用.
    gadget layer实现了USB protocol framework,它是device driver layer和
    class driver layer之间的接口, 比如存储器.
    class driver layer实现了USB deivce的某些功能.

第四章, Linux USB Host Driver

  1. USB Host stack


  2. Linux USB Host Stack
    usbcore, /drivers/usb/core
    Host Control Driver, /drivers/usb/host



第5章, USB Device Notification

  1. Linux USB device和system之间的通知机制采用的是publish-subscribe模式
    Kernel中为了这种常用的notification(不光是给usb subsystem使用, network driver经常使用这套机制), 实现了一套notifier chain的机制.
    相关实现代码在 kernel/notifier.c , 有四种类型的notification:
    Atomic
    Blocking
    Raw
    Sleepable Read-Copy Update (SRCU)
  2. Linux USB Notification layer


    sample code:

第六章, Device File System 

[plain] 
      view plain
1. #include <linux/module.h>  
2. #include <linux/kernel.h>  
3. #include <linux/usb.h>  
4. static int usb_notify_subscriber(struct notifier_block *self, unsigned long  
5. action, void *dev)  
7.     printk(KERN_INFO "usb_notify_subscriber \n");  
8.     switch (action) {  
9.     case USB_DEVICE_ADD:  
10.         printk(KERN_INFO "usb_notify_subscriber:USB device added \n");  
11.         break;  
12. <pre name="code" class="plain">    case USB_DEVICE_REMOVE:  
13.         printk(KERN_INFO "usb_notify_subscriber:USBdevice removed \n");  
14. </pre>        break;<br>  
15.     case USB_BUS_ADD:<br>  
16.         printk(KERN_INFO "usb_notify_subscriber:USB Bus added \n");<br>  
17.         break;<br>  
18.     case USB_BUS_REMOVE:<br>  
19.         printk(KERN_INFO "usb_notify_subscriber:USB Bus removed \n");<br>  
20.     }<br>  
21.     return NOTIFY_OK;<br>  
22. }<br>  
23. <br>  
24. static struct notifier_block usb_simple_nb = {<br>  
25.     .notifier_call = usb_notify_subscriber,<br>  
26. };<br>  
27. <br>  
28. int init_module(void)<br>  
29. {<br>  
30.     printk(KERN_INFO "Init USB simple subscriber.\n");<br>  
31.     /*<br>  
32.     * Register to the USB core to get notification on any addition or removal of USB devices<br>  
33.     */<br>  
34.     usb_register_notify(&usb_simple_nb);<br>  
35.     return 0;<br>  
36. }<br>  
37. <br>  
38. void cleanup_module(void)<br>  
39. {<br>  
40.     /*<br>  
41.     * Remove the notifier<br>  
42.     */<br>  
43.     usb_unregister_notify(&usb_simple_nb);<br>  
44.     printk(KERN_INFO "Remove USB simple subscriber\n");<br>  
45. }<br>  
46. <br>  
47. MODULE_LICENSE ("GPL");<br>  
48. <br>  
49. Makefile:<br>  
50. obj-m += simple_usb_subscriber.o<br>  
51. all:<br>  
52. make -C /lib/modules/$(shell uname -r)/build M=$(PWD) modules<br>  
53. clean:<br>  
54. make -C /lib/modules/$(shell uname -r)/build M=$(PWD) clean<br>  
55. <br>  
56. <br>  
57. <pre></pre>  
58. <pre></pre>  
59. <pre></pre>  
60. <pre></pre>  
61. <pre></pre>  
62. <pre></pre>  
63. <pre></pre>  
64. <pre></pre>  
65. <pre></pre>  
66. <pre></pre>  
67. <pre></pre>  
1.
  1. USB framework符合内核的惯例, 通过引入新的符合VFS的文件系统:usbfs来提供和应用程序之间的交互
    相关的实现是usbcore的一部分:
    drivers/usb/core/inode.c
    drivers/usb/core/devices.c
    drivers/usb/core/devio.c.



  2. VFS的说明文档
    Documentation/filesystems/vfs.txt

第七章 电源管理

  2. 关键的数据结构struct dev_pm_ops 可以看出,分为三组:普通, no irq, runtime
    struct dev_pm_info

  4. usb pm manager sequence figure


  5. 相关文档
    Documentation/power/*.txt
    Documentation/usb/power-management.txt
    Documentation/usb/persist.txt

第八章 Hub

  1. 关键数据结构
    struct usb_hub_descriptor struct usb_tt struct usb_hub

    usb hub是usb core的一部分,通过实现一个hub daemon(khubd kernel thread)来响应hub event.
  2. 对于hub的debug支持, 通过config USB_ANNOUNCE_NEW_DEVICES引入
    config USB_ANNOUNCE_NEW_DEVICES
    bool "USB announce new devices"
    depends on USB
    default N
    help

第9章 通用驱动

  1. 由usbcore支持的, 管理device, device driver, urb及相关的通讯信息的框架
    核心结构 usb_generic_driver , usb_driver , usb_device 内核代码中各个结构定义前的注释相当清晰.






  2. 请注意, 在completion的处理过程中, 不要耽误太长时间, 以为它是由硬件在interrupt的情况下调用的. 都会用spinlock保护, 所以需要只能做尽可能少的工作.
  3. 内核的代码中提供了 usb-skeleton.c 的代码, 帮组我们学习如何写一个device driver.

第十章 Host Driver for Embedded Controller

  1. 核心数据结构
    struct hc_driver , 照例是一系列callback, 用它们与usbcore交互
    struct usb_hcd, 同时,定义了一系列HCD interface(HCDI)来为HCD和usbcore所使用.
    HCD在linux framework中被实现为一种bus.
  2. USB Host Driver的实现坐落于drivers/usb/host/, HCDI的实现在/drivers/usb/core/hcd.c

    HCD通常实现以下三种标准中的一种或几种
    Enhanced Host Controller Interface (EHCI),
    Universal Host Controller Interface (UHCI),
    Open Host Controller Interface (OHCI)

    HCD的初始化过程

  3. kernel的代码中提供了一个简单的HCD Driver的例子, drivers/usb/gadget/ dummy_hcd.c

第十三章 Linux USB Gadget Driver

  1. Linux USB Gadget Driver的layer图




    Device Firmware Driver, 用来实现硬件spec的逻辑, 比如访问register, memory, interrupt. 它为上层的layer提供关于与Linux Device Control交互的接口
    Driver/USB Device Framework, 这层承上启下, 实现了USB spec中所定义的state machine, 用以实现enumeration.
    USB Class Driver, 用来实现真正的逻辑功能
  2. 相关资料
    http://www.usb.org/developers/devclass_docs#approved http://www.linux-usb.org/gadget/ , Texas Instruments OMAP processors, including ARMv5TEJ models ( omap_udc ,in 2.6 kernel)with USB OTG capabilities.
    Documentation/usb/ gadget_serial.txt

Chapter 12 Peripheral Device Controller Driver
它座落在function driver和PDC driver之间, 用来提供对USB deivce的管理

  1. PDC driver基于platform driver framework或者PCI driver framework来搭建
    主要的工作是分配资源, 如, memory, IRQ
  2. 第一节介绍了platform driver framework的情况及关键数据结构, 很值得参考




    这里remap的动作,通过ioremap完成.
  3. 最后一节以Renesas的USB Controll为例, 讲解了PDC Driver
    代码在drivers/usb/gadget/ r8a66597-udc.h

第十三章 Gadget Driver

  1. 核心数据结构
    struct usb_gadget , 一般情况下,它是用户定义的gadget driver的一个子集, 开发gadget驱动的时候,会定义一些额外的usb_gadget信息
    struct usb_ep , 它提供了管理endpoint的接口
    struct usb_gadget_driver , 它是与class driver的接口
    struct usb_request , 它被gadget driver和function driver用来和PDC进行信息传递
  2. Gadget driver用来提供管理endpoint.










第14章 Class Driver

  2. linux支持一个driver能够适用多种功能, 通过gadget的composite driver来提供
    关键数据结构:
    struct usb_function struct usb_configuration
    class driver使用
    int usb_composite_register(struct usb_composite_driver *),
    void usb_composite_unregister(struct usb_composite_driver *);
    来把自己注册到composite framework中, 而composite framework又是gadget framework的一种抽象.




  6. 内核的代码中提供了关于class driver和composite driver的一个简单例子
    drivers/usb/gadget/ f_loopback.c drivers/usb/gadget/zero.c

    http://www.usb.org/developers/devclass_docs#approved

第15章 Linux USB OTG Driver

  1. OTG是用来让usb device可以p2p链接, 也就是让usb device能够自带一些host的功能,从而可以互相直接联系
    它作为USB 2.0的补充标准而存在, 包括
    minimal USB host capability,
    Session Request Protocol(SRP),
    Host Negotiation Protocol (HNP),
    8mA on VBUS.
    相关代码在:
    include/linux/usb/otg.h
    drivers/usb/otg
  3. 关键数据结构
    struct otg_transceiver
    OTG的framework的组织没有gadget那么清晰,主要在drivers/usb/otg目录下, 还有一些重要的工作是由usbcore完成,在drivers/usb/core/hub.c
    OTG的framework主要用来接收硬件的电信号及响应物理层的一些逻辑
    http://www.linux-usb.org/gadget/h2-otg.html



  7. 以drivers/usb/otg/isp1301_omap作为例子讲解了一下OTG driver
    OTG driver很依赖与它所寄生的controller或者其它的一些外围glue logic, 而isp1301_omap的controller是坐落在I2C上,所以它会利用I2C的一些结构包装自己

    otg_transceiver object会被保存下来给gadget和host framework使用. 相关实现在driver/usb/otg/otg.c

第16章 USB Virtual File Systems

新的内核已经把usbfs废弃掉了, 请注意!!! udev使用/dev/bus/usb代替!!!
http://markmail.org/message/3mw5yw465qmxgnwp

https://bugs.launchpad.net/ubuntu/+source/linux/+bug/488274

  2. 提供了两种VFS, usbfs, gadgetfs
    USBView是一个有用的工具: http://www.kroah.com/linux-usb/ 或者是使用ubuntu带的usb-devices

    gadgetfs需要在编译kernel的时候打开

  4. 目前都由sysfs来向application layer提供usb的信息
    如,/sys/bus/usb/devices, 格式为bus-port.port.port:config.interface

第17章 User Space USB Driver

  1. 通过libusb, usbfs, /dev/来实现User Space USB Driver



    libptp和usbutils是libusb的主要使用者.
  2. 使用UIO framework来实现User Space USB Driver
    与上面的方法完全不同, 它一定程度上违反了linux的概念, 但是作为一种手段, 还是挺受商业上的欢迎

    关键数据结构
    linux/ uio_driver.h drivers/uio/ uio.c struct uio_info
    它有一个很明显的区别, 它需要独自操作内存空间. 它同时也需要在编译内核的时候开启Userspace I/O drivers的编译选项.

    文中举了一个基于PCI的硬件的UIO driver的例子, 随书附带的光盘中的代码可以供以后开发来参考.

    lsuio这个开源的工具也可以帮组我们理解UIO Driver, http://www.osadl.org/projects/downloads/UIO/user/lsuio-0.2.0.tar.gz .
  3. 通过gadgetfs来实现User Space Driver
    它提供了同步和异步两种通信方式
    http://www.linux-usb.org/gadget/usb.c上提供了一个简单例子
  4. 有用的资源
    http://blog.kernelkahani.com/?p=19 http://www.linux-usb.org/gadget/
    http://lwn.net/Articles/232575/
    http://www.osadl.org/UIO.uio0.0.html
    http://lse.sourceforge.net/io/aio.html

第18章 Debugging Using Linux USB

  1. usbmon tools提供了对USB的调试, 方便收集host和device之间的transactions信息, 并通过linux的debug system暴露给用户使用
    这是最好的工具, 但是需要开启内核相关的编译选项才能使用:)
    实现的代码在drivers/usb/mon/下, 实现了两种模式的:binary, text
    文中就text的实现做了简要描述:
    它通过在usb core中加入一些hook点, 把信息通过预先定义的文件接口传递给user space.
    URB submit, URB complete, error这几个事件发生时都会把URB的信息map到对应的usbmon数据结构struct mon_event_text 中
    内核的代码中,对于该结构没有过多的注释, 文中的注释还是很全的:)
    text的实现只map了一部分URB的信息, binary的实现则获取了所有的信息.


    文中详细介绍了如何阅读/sys/kernel/debug/usbmon/目录下的各个文件(对应的usb设备, 内容, ...)


    也有一些正对特别的class driver提供的usbmon版本, 比如scsimon

    大部分的kernel debug的信息都在/sys/kernel/debug目录下
  2. usbfs_snoop也是一个基于usbfs的帮助调试的好工具
    文中对它也进行了介绍

  3. usbmon和usbfs_snoop的重要区别
    usbmon 抓取了kernel functional drivers和lower usbcore之间的URB信息
    usbfs_snoop 抓取的是应用程序和usbcore的文件操作之间的URB信息
  4. LeCroy and Ellisys 是用来从physical层抓usb packet的好工具, 不过都要钱的, 穷人用不起:(
  5. 更多有用的资源
    http://www.linuxjournal.com/article/7582 /Documentation/usb/usbmon.txt http://people.redhat.com/zaitcev/linux/OLS05_zaitcev.pdf -- usbmon的详细介绍的paper

第19章 Test Using Linux USB

  2. linux提供了usbtest的unit test框架
    drivers/usb/misc/ usbtest.c


  5. 接着介绍了关于usb的function test, 它们都是基于USB IF定义的接口来设计的
    它们都提供了相应的parameter来帮组测试各个相关功能

    Storage USB Gadget, drivers/usb/gadget/ file_storage.c , http://www.linux-usb.org/gadget/file_storage.html
    Serial USB Gadget, drivers/usb/gadget/serial.c, drivers/usb/gadget/u_serial.c, drivers/usb/gadget/f_serial.c, drivers/usb/gadget/f_acm.c
    communication device class (CDC)

    USB Network Gadget, drivers/usb/gadget/ether.c, drivers/usb/gadget/f_ecm.c, drivers/usb/gadget/u_ether.c
    Ethernet Control Model (ECM)

    HID (Human Interface Devices) USB Gadget, http://lxr.free-electrons.com/source/drivers/usb/gadget/hid.c
  6. 相关资源
    http://www.linux-usb.org/usbtest/ http://linux-usb-test.sourceforge.net/docs/interop-0.2/book1.html

APPENDIX

提供了一个USB Regression Tool

通过图形+script的方式方面开发人员定制test case及反馈结果



 
推荐文章
奔放的黄瓜  ·  Linux密码密文：保障账户安全的必备信息 (linux passwd 密码密文) – 后浪云
3 天前
不拘小节的酸菜鱼  ·  使用linux的GDB打印STL(vector,map,set..................) - 哈哈不是嘎嘎
2 天前
英勇无比的领带  ·  Pycuda program not running on Jetson Nano - Jetson Nano - NVIDIA Developer Forums
2 天前
高大的青蛙  ·  Running JSP on Linux tomcat - Oracle Forums
2 天前
打酱油的小刀  ·  linux去除重复行命令 • Worktile社区
昨天
粗眉毛的蚂蚁  ·  ConflictAlgorithm enum - sql library - Dart API
2 月前
阳刚的核桃  ·  ST百灵(002424)_股票行情，行情首页_中财网
4 月前
霸气的小马驹  ·  线性代数—Wolfram 语言参考资料
7 月前
温柔的遥控器  ·  ayawawa口中的剪子石头布到底是什么？ - 知乎
1 年前
朝气蓬勃的火腿肠  ·  前端解决跨域问题 - 简书
1 年前
Link管理   ·   51好读   ·   Sov5搜索   ·   小百科
link管理 - 链接快照平台