functions.c文件说明

说明

drivers/usb/gadget/functions.c 这个文件里面就7个函数，所以单独给拿出来说一下。从名字可以看出，这文件是个中间层的作用，连接configfs和实际的function驱动。还是挺有意思的，大家一起来看看。

usb_function_register/unregister

将usb_function_driver结构体加入到func_list全局链表当中，就是将list变量加入进去。除了这个啥也没有干，下面就是这个结构体的说明。

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); };

usb_get/put_function_instance

struct usb_function_instance *usb_get_function_instance(const char *name) { struct usb_function_instance *fi; int ret; fi = try_get_usb_function_instance(name); if (!IS_ERR(fi)) return fi; ret = PTR_ERR(fi); if (ret != -ENOENT) return fi; ret = request_module("usbfunc:%s", name); if (ret < 0) return ERR_PTR(ret); return try_get_usb_function_instance(name); }

这里分为两个部分，首先直接获取function_instance，如果失败了，可能对应的驱动没有加载进去，那么去搜索一下对应的module，然后继续再来一次。如果真的没有，那就还是不行了。以上代码就是这个逻辑，我们接着走成功的那条路 try_get_usb_function_instance。 list_for_each_entry(fd, &func_list, list)，通过这个函数从func_list中搜索对应的usb_function_driver。找到后，调用对应的alloc_inst()。函数还做了一些特殊操作，如果失败，还会去卸载module。

struct usb_function_driver *fd; struct usb_function_instance *fi; fi = fd->alloc_inst(); if (IS_ERR(fi)) module_put(fd->mod); else fi->fd = fd;

接着看一下put函数

void usb_put_function_instance(struct usb_function_instance *fi) { struct module *mod; if (!fi) return; mod = fi->fd->mod; fi->free_func_inst(fi); module_put(mod); }

这个函数调用的是usb_function_instance中的free_func_inst方式，如下所示给出一个结构体

struct usb_function_instance { struct config_group group; struct list_head cfs_list; struct usb_function_driver *fd; int (*set_inst_name)(struct usb_function_instance *inst, const char *name); void (*free_func_inst)(struct usb_function_instance *inst); };

usb_get/put_function

struct usb_function *usb_get_function(struct usb_function_instance *fi) { struct usb_function *f; f = fi->fd->alloc_func(fi); if (IS_ERR(f)) return f; f->fi = fi; return f; } void usb_put_function(struct usb_function *f) { if (!f) return; f->free_func(f); }

以上，函数逻辑比较清楚。

总结

从上面来看，functions.c中的函数就是用来作为usb_function_driver和configfs链接用的。大部分函数的调用口，都是从configfs.c上面下来的。这个文件和functions.c在同一个目录中，都是为了gadget服务。