Linux-USB驱动笔记-Gadget Function驱动

1、前言

在Linux-USB驱动笔记（四）–USB整体框架中有説到Gadget Function驱动，下面我们来具体看一下。

Gadget Function就是指设备的功能，比如作为U盘，需要文件存储的功能，则需要File Storage驱动，这个驱动也称为Function驱动。

2、Gadget Function 驱动

Function驱动只是利用通用的API，并通过usb_request与底层UDC驱动交互。

Gadget Function 驱动相关的代码位于 /drivers/usb/gadget/function 目录下。

2.1、usb_function – 配置的一个功能

struct usb_function {
  const char      *name;
  struct usb_gadget_strings  **strings;
  struct usb_descriptor_header  **fs_descriptors; //全速和低速描述符表
  struct usb_descriptor_header  **hs_descriptors; //高速描述符表
  struct usb_descriptor_header  **ss_descriptors; //超高速描述符表
  struct usb_descriptor_header  **ssp_descriptors;//超高速加描述符表

  struct usb_configuration  *config; //usb配置

  struct usb_os_desc_table  *os_desc_table;
  unsigned      os_desc_n;


  /* 配置管理:  bind/unbind */
   // gadget注册前绑定资源(接口标识，类描述符，端点，IO缓存)
  int      (*bind)(struct usb_configuration *,
          struct usb_function *);
  void      (*unbind)(struct usb_configuration *,
          struct usb_function *);
  void      (*free_func)(struct usb_function *f);
  struct module    *mod;

  /* 运行状态管理 */
  int      (*set_alt)(struct usb_function *,
          unsigned interface, unsigned alt);
  int      (*get_alt)(struct usb_function *,
          unsigned interface);
  void      (*disable)(struct usb_function *);
  int      (*setup)(struct usb_function *,
          const struct usb_ctrlrequest *);
  bool      (*req_match)(struct usb_function *,
          const struct usb_ctrlrequest *,
          bool config0);
  void      (*suspend)(struct usb_function *);
  void      (*resume)(struct usb_function *);

  /* USB 3.0 附加 */
  int      (*get_status)(struct usb_function *);
  int      (*func_suspend)(struct usb_function *,
            u8 suspend_opt);
  /* private: */
  /* internals */
  struct list_head    list;
  DECLARE_BITMAP(endpoints, 32);
  const struct usb_function_instance *fi;

  unsigned int    bind_deactivated:1;
};

重要字段及其含义如下：

2.2、usb_request – I/O请求

struct usb_request {
  void      *buf;
  unsigned    length;
  dma_addr_t    dma;

  struct scatterlist  *sg;
  unsigned    num_sgs;
  unsigned    num_mapped_sgs;

  unsigned    stream_id:16;
  unsigned    no_interrupt:1;
  unsigned    zero:1;
  unsigned    short_not_ok:1;
  unsigned    dma_mapped:1;

  void      (*complete)(struct usb_ep *ep,
          struct usb_request *req);
  void      *context;
  struct list_head  list;

  int      status;
  unsigned    actual;
};

在Gadget驱动中，用usb_request结构体来描述一次传输请求。这个和主机侧的URB类似，只是它更轻量，可以有更多的预分配。

2.3、usb_function_driver

struct usb_function_driver {
  const char *name;
  struct module *mod;
  struct list_head list;
  struct usb_function_instance *(*alloc_inst)(void);
  struct usb_function *(*alloc_func)(struct usb_function_instance *inst);
};

在Gadget驱动中，用usb_request结构体来描述一次传输请求。这个和主机侧的URB类似，只是它更轻量，可以有更多的预分配。

和platform_driver类似，用来注册usb_function驱动。

3、API函数

上面这些通用的API都是调用到UDC驱动中的函数，然后进行硬件操作。

USB驱动框架到此就结束了。