Linux3.x——USB Gadget HID keyboard + Mass storage

本篇可能是全网第一个具体介绍板子做为usb device 设备同时实现HID keyboard + Mass storage 功能的（内核版本3.xx）。废话不多说，下面是具体操作。操作之后，你回头再看下usb20_spec 你会更明白。
一、内核选项

二、修改/linux/drivers/usb/gadget下的Makefile

把libcomposite改成默认编入

三、修改/linux/drivers/usb/gadget/acm_ms.c

以下是修改后的完整代码

/** acm_ms.c -- Composite driver, with ACM and mass storage support** Copyright (C) 2008 David Brownell* Copyright (C) 2008 Nokia Corporation* Author: David Brownell* Modified: Klaus Schwarzkopf <schwarzkopf@sensortherm.de>** Heavily based on multi.c and cdc2.c** This program is free software; you can redistribute it and/or modify* it under the terms of the GNU General Public License as published by* the Free Software Foundation; either version 2 of the License, or* (at your option) any later version.*/#include <linux/kernel.h>
#include <linux/module.h>
#include <linux/platform_device.h>#define DRIVER_DESC     "Composite Gadget (HID + MS)"
#define DRIVER_VERSION      "2020/1/21"/*-------------------------------------------------------------------------*//** DO NOT REUSE THESE IDs with a protocol-incompatible driver!!  Ever!!* Instead:  allocate your own, using normal USB-IF procedures.*/
#define ACM_MS_VENDOR_NUM   0x1d6b  /* Linux Foundation */
#define ACM_MS_PRODUCT_NUM  0x0106  /* Composite Gadget: ACM + MS*//*-------------------------------------------------------------------------*//** Kbuild is not very cooperative with respect to linking separately* compiled library objects into one module.  So for now we won't use* separate compilation ... ensuring init/exit sections work to shrink* the runtime footprint, and giving us at least some parts of what* a "gcc --combine ... part1.c part2.c part3.c ... " build would.*/
#include "f_mass_storage.c"
#include "f_hid.c"
static struct hidg_func_descriptor lt_keyboard_data = {.subclass        = 0, /* No subclass */.protocol        = 1, /* Keyboard */.report_length        = 8,.report_desc_length    = 63,.report_desc        = {0x05, 0x01,    /* USAGE_PAGE (Generic Desktop)     */0x09, 0x06,    /* USAGE (Keyboard) */0xa1, 0x01,    /* COLLECTION (Application) */0x05, 0x07,    /* USAGE_PAGE (Keyboard) */0x19, 0xe0,    /* USAGE_MINIMUM (Keyboard LeftControl) */0x29, 0xe7,    /* USAGE_MAXIMUM (Keyboard Right GUI) */0x15, 0x00,    /* LOGICAL_MINIMUM (0) */0x25, 0x01,    /* LOGICAL_MAXIMUM (1) */0x75, 0x01,    /* REPORT_SIZE (1) */0x95, 0x08,    /* REPORT_COUNT (8) */0x81, 0x02,    /* INPUT (Data,Var,Abs) */0x95, 0x01,    /* REPORT_COUNT (1) */0x75, 0x08,    /* REPORT_SIZE (8) */0x81, 0x03,    /* INPUT (Cnst,Var,Abs) */0x95, 0x05,    /* REPORT_COUNT (5) */0x75, 0x01,    /* REPORT_SIZE (1) */0x05, 0x08,    /* USAGE_PAGE (LEDs) */0x19, 0x01,    /* USAGE_MINIMUM (Num Lock) */0x29, 0x05,    /* USAGE_MAXIMUM (Kana) */0x91, 0x02,    /* OUTPUT (Data,Var,Abs) */0x95, 0x01,    /* REPORT_COUNT (1) */0x75, 0x03,    /* REPORT_SIZE (3) */0x91, 0x03,    /* OUTPUT (Cnst,Var,Abs) */0x95, 0x06,    /* REPORT_COUNT (6) */0x75, 0x08,    /* REPORT_SIZE (8) */0x15, 0x00,    /* LOGICAL_MINIMUM (0) */0x25, 0x65,    /* LOGICAL_MAXIMUM (101) */0x05, 0x07,    /* USAGE_PAGE (Keyboard) */0x19, 0x00,    /* USAGE_MINIMUM (Reserved) */0x29, 0x65,    /* USAGE_MAXIMUM (Keyboard Application) */0x81, 0x00,    /* INPUT (Data,Ary,Abs) */0xc0        /* END_COLLECTION */}
};
static struct platform_device lt_keyboard = {.name         = "hidg",.id             = 0,.num_resources = 0,.resource      = 0,.dev.platform_data = &lt_keyboard_data,
};
struct hidg_func_node {struct list_head node;struct hidg_func_descriptor *func;
};
static LIST_HEAD(hidg_func_list);
/*-------------------------------------------------------------------------*/
USB_GADGET_COMPOSITE_OPTIONS();static struct usb_device_descriptor device_desc = {.bLength =      sizeof device_desc,.bDescriptorType =  USB_DT_DEVICE,.bcdUSB =        cpu_to_le16(0x0200),.bDeviceClass =        USB_CLASS_MISC /* 0xEF */,.bDeviceSubClass =   2,.bDeviceProtocol =   1,/* .bMaxPacketSize0 = f(hardware) *//* Vendor and product id can be overridden by module parameters.  */.idVendor =     cpu_to_le16(FSG_VENDOR_ID),.idProduct =        cpu_to_le16(FSG_PRODUCT_ID),    /* .bcdDevice = f(hardware) *//* .iManufacturer = DYNAMIC *//* .iProduct = DYNAMIC *//* NO SERIAL NUMBER *//*.bNumConfigurations =  DYNAMIC*/
};static struct usb_otg_descriptor otg_descriptor = {.bLength =       sizeof otg_descriptor,.bDescriptorType =   USB_DT_OTG,/** REVISIT SRP-only hardware is possible, although* it would not be called "OTG" ...*/.bmAttributes =        USB_OTG_SRP | USB_OTG_HNP,
};static const struct usb_descriptor_header *otg_desc[] = {(struct usb_descriptor_header *) &otg_descriptor,NULL,
};/* string IDs are assigned dynamically */
static struct usb_string strings_dev[] = {[USB_GADGET_MANUFACTURER_IDX].s = "",[USB_GADGET_PRODUCT_IDX].s = DRIVER_DESC,[USB_GADGET_SERIAL_IDX].s = "",{  } /* end of list */
};static struct usb_gadget_strings stringtab_dev = {.language  = 0x0409,  /* en-us */.strings = strings_dev,
};static struct usb_gadget_strings *dev_strings[] = {&stringtab_dev,NULL,
};/****************************** Configurations ******************************/static struct fsg_module_parameters fsg_mod_data = { .stall = 1 };
FSG_MODULE_PARAMETERS(/* no prefix */, fsg_mod_data);static struct fsg_common fsg_common;/*-------------------------------------------------------------------------*/
static struct usb_function *f_acm;
static struct usb_function_instance *f_acm_inst;
/** We _always_ have both ACM and mass storage functions.*/
static int __init acm_ms_do_config(struct usb_configuration *c)
{int    status;struct hidg_func_node *e;int func = 0;if (gadget_is_otg(c->cdev->gadget)) {c->descriptors = otg_desc;c->bmAttributes |= USB_CONFIG_ATT_WAKEUP;}list_for_each_entry(e, &hidg_func_list, node) {    status = hidg_bind_config(c, e->func, func++);if (status < 0)goto err_fsg;}status = fsg_bind_config(c->cdev, c, &fsg_common);if (status < 0)goto err_fsg;return 0;
err_fsg:usb_remove_function(c, f_acm);
err_conf:usb_put_function(f_acm);
err_func:usb_put_function_instance(f_acm_inst);return status;
}static struct usb_configuration acm_ms_config_driver = {.label            = DRIVER_DESC,.bConfigurationValue = 1,/* .iConfiguration = DYNAMIC */.bmAttributes      = USB_CONFIG_ATT_SELFPOWER,
};/*-------------------------------------------------------------------------*/static int __init acm_ms_bind(struct usb_composite_dev *cdev)
{struct usb_gadget  *gadget = cdev->gadget;int          status;void         *retp;struct list_head *tmp;int  funcs = 0;list_for_each(tmp, &hidg_func_list)funcs++;if (!funcs)return -ENODEV;/* set up HID */status = ghid_setup(cdev->gadget, funcs);if (status < 0)return status;/* set up mass storage function */retp = fsg_common_from_params(&fsg_common, cdev, &fsg_mod_data);if (IS_ERR(retp)) {status = PTR_ERR(retp);return PTR_ERR(retp);}/** Allocate string descriptor numbers ... note that string* contents can be overridden by the composite_dev glue.*/status = usb_string_ids_tab(cdev, strings_dev);if (status < 0)goto fail1;device_desc.iManufacturer = strings_dev[USB_GADGET_MANUFACTURER_IDX].id;device_desc.iProduct = strings_dev[USB_GADGET_PRODUCT_IDX].id;/* register our configuration */status = usb_add_config(cdev, &acm_ms_config_driver, acm_ms_do_config);if (status < 0)goto fail1;usb_composite_overwrite_options(cdev, &coverwrite);dev_info(&gadget->dev, "%s, version: " DRIVER_VERSION "\n",DRIVER_DESC);fsg_common_put(&fsg_common);return 0;/* error recovery */
fail1:fsg_common_put(&fsg_common);return status;
}static int __exit acm_ms_unbind(struct usb_composite_dev *cdev)
{usb_put_function(f_acm);usb_put_function_instance(f_acm_inst);return 0;
}
static int __init hidg_plat_driver_probe(struct platform_device *pdev)
{struct hidg_func_descriptor *func = pdev->dev.platform_data;struct hidg_func_node *entry;if (!func) {dev_err(&pdev->dev, "Platform data missing\n");return -ENODEV;}entry = kzalloc(sizeof(*entry), GFP_KERNEL);if (!entry)return -ENOMEM;entry->func = func;list_add_tail(&entry->node, &hidg_func_list);return 0;
}
static int hidg_plat_driver_remove(struct platform_device *pdev)
{struct hidg_func_node *e, *n;list_for_each_entry_safe(e, n, &hidg_func_list, node) {list_del(&e->node);kfree(e);}return 0;
}
static __refdata struct usb_composite_driver acm_ms_driver = {.name        = "g_acm_ms",.dev        = &device_desc,//.max_speed    = USB_SPEED_SUPER,.max_speed   = USB_SPEED_HIGH,.strings  = dev_strings,.bind        = acm_ms_bind,.unbind      = __exit_p(acm_ms_unbind),
};
static struct platform_driver hidg_plat_driver = {.remove      = hidg_plat_driver_remove,.driver      = {.owner  = THIS_MODULE,.name    = "hidg",},
};
MODULE_DESCRIPTION(DRIVER_DESC);
MODULE_AUTHOR("Klaus Schwarzkopf <schwarzkopf@sensortherm.de>");
MODULE_LICENSE("GPL v2");static int __init init(void)
{int status; status = platform_device_register(&lt_keyboard);if (status < 0) {printk("keyboard device register failed!\n");return status;}    status = platform_driver_probe(&hidg_plat_driver,hidg_plat_driver_probe);if (status < 0){return status;}status = usb_composite_probe(&acm_ms_driver);return status;
}
module_init(init);static void __exit cleanup(void)
{usb_composite_unregister(&acm_ms_driver);
}
module_exit(cleanup);

四、制作虚拟磁盘

mkdir /testdisk
mkdir /testdisk/files
dd if=/dev/zero  of=/testdisk/disk.img  bs=1M  count=10 //生成10M的二进制镜像文件
mkdosfs  /testdisk/disk.img

然后记得把disk.img保存到可写目录，以后的挂载会用到。

五、挂载虚拟磁盘

mount -t vfat -o sync  /testdisk/disk.img   /testdisk/files

六、运行

insmod  g_acm_ms.ko file=/testdisk/disk.img  removable=1 stall=0

七、结果

八、USB Device Tree Viewer 信息

   ---------------------- Device Descriptor ----------------------
bLength                  : 0x12 (18 bytes)
bDescriptorType          : 0x01 (Device Descriptor)
bcdUSB                   : 0x200 (USB Version 2.00)
bDeviceClass             : 0xEF (Miscellaneous)
bDeviceSubClass          : 0x02
bDeviceProtocol          : 0x01 (IAD - Interface Association Descriptor)
bMaxPacketSize0          : 0x40 (64 bytes)
idVendor                 : 0x2345 (ZOWIE GEAR)
idProduct                : 0x5432
bcdDevice                : 0x0310
iManufacturer            : 0x02 (String Descriptor 2)Language 0x0409         : "Linux 3.10.49 with dwc_otg_pcd"
iProduct                 : 0x03 (String Descriptor 3)Language 0x0409         : "Composite Gadget (HID + MS)"
iSerialNumber            : 0x00 (No String Descriptor)
bNumConfigurations       : 0x01 (1 Configuration)
Data (HexDump)           : 12 01 00 02 EF 02 01 40 45 23 32 54 10 03 02 03   .......@E#2T....00 01                                             ..------------------ Configuration Descriptor -------------------
bLength                  : 0x09 (9 bytes)
bDescriptorType          : 0x02 (Configuration Descriptor)
wTotalLength             : 0x0040 (64 bytes)
bNumInterfaces           : 0x02 (2 Interfaces)
bConfigurationValue      : 0x01 (Configuration 1)
iConfiguration           : 0x00 (No String Descriptor)
bmAttributes             : 0xC0D7: Reserved, set 1     : 0x01D6: Self Powered        : 0x01 (yes)D5: Remote Wakeup       : 0x00 (no)D4..0: Reserved, set 0  : 0x00
MaxPower                 : 0x01 (2 mA)
Data (HexDump)           : 09 02 40 00 02 01 00 C0 01 09 04 00 00 02 03 00   ..@.............01 05 09 21 01 01 00 01 22 3F 00 07 05 81 03 08   ...!...."?......00 04 07 05 02 03 08 00 04 09 04 01 00 02 08 06   ................50 01 07 05 83 02 00 02 00 07 05 04 02 00 02 01   P...............---------------- Interface Descriptor -----------------
bLength                  : 0x09 (9 bytes)
bDescriptorType          : 0x04 (Interface Descriptor)
bInterfaceNumber         : 0x00
bAlternateSetting        : 0x00
bNumEndpoints            : 0x02 (2 Endpoints)
bInterfaceClass          : 0x03 (HID - Human Interface Device)
bInterfaceSubClass       : 0x00 (None)
bInterfaceProtocol       : 0x01 (Keyboard)
iInterface               : 0x05 (String Descriptor 5)Language 0x0409         : "HID Interface"
Data (HexDump)           : 09 04 00 00 02 03 00 01 05                        .........------------------- HID Descriptor --------------------
bLength                  : 0x09 (9 bytes)
bDescriptorType          : 0x21 (HID Descriptor)
bcdHID                   : 0x0101 (HID Version 1.01)
bCountryCode             : 0x00 (00 = not localized)
bNumDescriptors          : 0x01
Data (HexDump)           : 09 21 01 01 00 01 22 3F 00                        .!...."?.
Descriptor 1:
bDescriptorType          : 0x22 (Class=Report)
wDescriptorLength        : 0x003F (63 bytes)
Error reading descriptor : ERROR_INVALID_PARAMETER (due to a obscure limitation of the Win32 USB API, see UsbTreeView.txt)----------------- Endpoint Descriptor -----------------
bLength                  : 0x07 (7 bytes)
bDescriptorType          : 0x05 (Endpoint Descriptor)
bEndpointAddress         : 0x81 (Direction=IN EndpointID=1)
bmAttributes             : 0x03 (TransferType=Interrupt)
wMaxPacketSize           : 0x0008Bits 15..13             : 0x00 (reserved, must be zero)Bits 12..11             : 0x00 (0 additional transactions per microframe -> allows 1..1024 bytes per packet)Bits 10..0              : 0x08 (8 bytes per packet)
bInterval                : 0x04 (4 ms)
Data (HexDump)           : 07 05 81 03 08 00 04                              .......----------------- Endpoint Descriptor -----------------
bLength                  : 0x07 (7 bytes)
bDescriptorType          : 0x05 (Endpoint Descriptor)
bEndpointAddress         : 0x02 (Direction=OUT EndpointID=2)
bmAttributes             : 0x03 (TransferType=Interrupt)
wMaxPacketSize           : 0x0008Bits 15..13             : 0x00 (reserved, must be zero)Bits 12..11             : 0x00 (0 additional transactions per microframe -> allows 1..1024 bytes per packet)Bits 10..0              : 0x08 (8 bytes per packet)
bInterval                : 0x04 (4 ms)
Data (HexDump)           : 07 05 02 03 08 00 04                              .......---------------- Interface Descriptor -----------------
bLength                  : 0x09 (9 bytes)
bDescriptorType          : 0x04 (Interface Descriptor)
bInterfaceNumber         : 0x01
bAlternateSetting        : 0x00
bNumEndpoints            : 0x02 (2 Endpoints)
bInterfaceClass          : 0x08 (Mass Storage)
bInterfaceSubClass       : 0x06 (SCSI transparent command set)
bInterfaceProtocol       : 0x50 (Bulk-Only Transport)
iInterface               : 0x01 (String Descriptor 1)Language 0x0409         : "Mass Storage"
Data (HexDump)           : 09 04 01 00 02 08 06 50 01                        .......P.----------------- Endpoint Descriptor -----------------
bLength                  : 0x07 (7 bytes)
bDescriptorType          : 0x05 (Endpoint Descriptor)
bEndpointAddress         : 0x83 (Direction=IN EndpointID=3)
bmAttributes             : 0x02 (TransferType=Bulk)
wMaxPacketSize           : 0x0200 (max 512 bytes)
bInterval                : 0x00 (never NAKs)
Data (HexDump)           : 07 05 83 02 00 02 00                              .......----------------- Endpoint Descriptor -----------------
bLength                  : 0x07 (7 bytes)
bDescriptorType          : 0x05 (Endpoint Descriptor)
bEndpointAddress         : 0x04 (Direction=OUT EndpointID=4)
bmAttributes             : 0x02 (TransferType=Bulk)
wMaxPacketSize           : 0x0200 (max 512 bytes)
bInterval                : 0x01 (at most 1 NAK each 1 microframes)
Data (HexDump)           : 07 05 04 02 00 02 01                              .......----------------- Device Qualifier Descriptor -----------------
bLength                  : 0x0A (10 bytes)
bDescriptorType          : 0x06 (Device_qualifier Descriptor)
bcdUSB                   : 0x200 (USB Version 2.00)
bDeviceClass             : 0xEF (Miscellaneous)
bDeviceSubClass          : 0x02
bDeviceProtocol          : 0x01 (IAD - Interface Association Descriptor)
bMaxPacketSize0          : 0x40 (64 Bytes)
bNumConfigurations       : 0x01 (1 other-speed configuration)
bReserved                : 0x00
Data (HexDump)           : 0A 06 00 02 EF 02 01 40 01 00                     .......@..-------------------- String Descriptors ------------------------- String Descriptor 0 ------
bLength                  : 0x04 (4 bytes)
bDescriptorType          : 0x03 (String Descriptor)
Language ID[0]           : 0x0409 (English - United States)
Data (HexDump)           : 04 03 09 04                                       ....------ String Descriptor 1 ------
bLength                  : 0x1A (26 bytes)
bDescriptorType          : 0x03 (String Descriptor)
Language 0x0409          : "Mass Storage"
Data (HexDump)           : 1A 03 4D 00 61 00 73 00 73 00 20 00 53 00 74 00   ..M.a.s.s. .S.t.6F 00 72 00 61 00 67 00 65 00                     o.r.a.g.e.------ String Descriptor 2 ------
bLength                  : 0x3E (62 bytes)
bDescriptorType          : 0x03 (String Descriptor)
Language 0x0409          : "Linux 3.10.49 with dwc_otg_pcd"
Data (HexDump)           : 3E 03 4C 00 69 00 6E 00 75 00 78 00 20 00 33 00   >.L.i.n.u.x. .3.2E 00 31 00 30 00 2E 00 34 00 39 00 20 00 77 00   ..1.0...4.9. .w.69 00 74 00 68 00 20 00 64 00 77 00 63 00 5F 00   i.t.h. .d.w.c._.6F 00 74 00 67 00 5F 00 70 00 63 00 64 00         o.t.g._.p.c.d.------ String Descriptor 3 ------
bLength                  : 0x38 (56 bytes)
bDescriptorType          : 0x03 (String Descriptor)
Language 0x0409          : "Composite Gadget (HID + MS)"
Data (HexDump)           : 38 03 43 00 6F 00 6D 00 70 00 6F 00 73 00 69 00   8.C.o.m.p.o.s.i.74 00 65 00 20 00 47 00 61 00 64 00 67 00 65 00   t.e. .G.a.d.g.e.74 00 20 00 28 00 48 00 49 00 44 00 20 00 2B 00   t. .(.H.I.D. .+.20 00 4D 00 53 00 29 00                            .M.S.).------ String Descriptor 5 ------
bLength                  : 0x1C (28 bytes)
bDescriptorType          : 0x03 (String Descriptor)
Language 0x0409          : "HID Interface"
Data (HexDump)           : 1C 03 48 00 49 00 44 00 20 00 49 00 6E 00 74 00   ..H.I.D. .I.n.t.65 00 72 00 66 00 61 00 63 00 65 00               e.r.f.a.c.e.

Linux3.x——USB Gadget HID keyboard + Mass storage相关推荐

基于STM32F103的USB学习笔记35 - Mass Storage之SCSI命令
参考文档:UFI Command Specification.SCSI Reference Guide CBW包中CB部分(0FH-1EH)的第一个字节是操作码,对于Mass Storage来说,使用 ...
基于STM32F103的USB学习笔记38 - Mass Storage之SPI Flash做U盘
1. 将整个Flash作为U盘的空间 Flash大小为4MB,SPI NorFlash的Sector大小为4KB,所以MSC_MEMORY_BLOCK_SIZE设置为4096.. 3个函数的实现如下, ...
如何实现Linux下的U盘（USB Mass Storage）驱动
如何实现Linux下的U盘(USB Mass Storage)驱动版本:v0.7 How to Write LinuxUSB MSC (Mass Storage Class) Driver Crif ...
USB gadget设备驱动解析
利用Linux USB gadget设备驱动可以实现一些比较有意思的功能,举两个例子: 1.一个嵌入式产品中的某个存储设备,或是一个存储设备的某个分区,可以作为一个U盘被PC:设别,从而非常方便的完成 ...
USB Mass Storage Class
编辑博客时,回车的意思是切换段落,shift+回车才是换行. SCSI Interface Controller: AMD am5380 1 U盘量产工具 - 主控芯片私有的SCSI命令 ChipEa ...
USB Gadget Storage功能调试
由于工作的需要,实现板卡通过Micro USB线与PC连接,作为PC的外设存储,PC拷贝数据到板卡中,或者把板卡中的数据通过USB线拷贝到PC端,实现数据的交互,板卡采用Linux操作系统,笔者采用 ...
USB mass storage驱动分析
1. USB驱动代码在/drivers/usb/gadget下,有文件:android.c,其他驱动文件f_adb.c,f_mass_storage.c:其中android.c 依赖于f_adb.c ...
USB Mass Storage
参见:USB Mass StorageClass Bulk-Only Transport 1 规范概述和范围前提条件:熟悉USB协议规范和USB海量存储类规范概述. 本规范只描述块传输,也就是仅通过 ...
USB Mass Storage大容量存储 The Thirteen Class章节的理解
http://blog.csdn.net/xgbing/article/details/7002558 USB Mass Storage 6.7 The Thirteen Class章节的理解 Cas ...

Linux3.x——USB Gadget HID keyboard + Mass storage

Linux3.x——USB Gadget HID keyboard + Mass storage相关推荐

最新文章

热门文章