7.12.2. 参数配置

7.12.2.1. USB Host 配置

7.12.2.1.1. USB Host Controller 配置

首先需要配置好 USB Host Contoller ,M3/M4 在 1 个 USB Host 端口中提供了 2 类 Host Contoller:

  • 针对 USB 2.0 (High Speed) 的 EHCI 控制器

  • 针对 USB 1.0/1.1 (Low/Full Speed) 的 OHCI 控制器

../../../_images/usb_mode.jpg

在软件上需要需要分开配置。

以M4为例:

struct aic_pinmux aic_pinmux_config[] = {
    {1, PIN_PULL_UP, 3, "PF.0"},    //OTG_EN
}

void aic_board_pinmux_init(void)
{
    //usb   高电平(host)    低电平(Device)
    pin = hal_gpio_name2pin("PF.0");
    g = GPIO_GROUP(pin);
    p = GPIO_GROUP_PIN(pin);
    hal_gpio_direction_output(g, p);

    /*  hal_gpio_set_output(g, p);  //host
        hal_gpio_clr_output(g, p);  //Device
    */
}

7.12.2.1.1.1. EHCI 配置

  • 在 Menuconfig 中配置设备。使能 USB 端口,并且配置当前 USB 端口为 Host 模式:

Board options  --->
    [*] Using Usb0
        Select Usb0 mode (Host)  --->
  • 在 Menuconfig 中配置 CherryUSB 驱动。使能 CherryUSB 驱动,并且使能 Host 模式:

Local packages options  --->
Third-party packages options  --->
    [*] CherryUSB: tiny and portable USB host/device stack for embedded system with USB IP  --->
        [*]   Enable usb device mode  --->
            [*]   Enable usb host mode  --->

7.12.2.1.2. USB Interface 驱动配置

在配置好 USB Host Controller 以后,就能够正确识别插入 USB 总线的 Device 设备了。

但是 USB Device 有很多不同类型 (例如:U 盘、键盘鼠标、无线网卡 …) ,这些功能都是在 USB Device 中以 Interface 为单位提供的。所以要使用 USB Device 的具体功能,还需要配置不同类型 USB Interface 的驱动。

7.12.2.1.2.1. U 盘 配置

  • 在 Menuconfig 中使能 CherryUSB 中 msc 类型的 Host Class 驱动,并且使能对应实例模板:

Local packages options  --->
    Third-party packages options  --->
        [*] CherryUSB: tiny and portable USB host/device stack for embedded system with USB IP  --->
            [*]   Enable usb device mode  --->
                [*]   Enable usb host mode  --->
                    [*]   Enable usb msc driver  --->
                        [*]   Use msc template
  • 插入 U 盘,会自动挂载到 /udisk 目录:

ZXM47D0N />
ZXM47D0N /> [I/USB] New high-speed device on Bus 0, Hub 1, Port 1 connected
[I/USB] New device found,idVendor:0951,idProduct:1665,bcdDevice:0100
[I/USB] The device has 1 interfaces
[I/USB] Enumeration success, start loading class driver
[I/USB] Loading msc class driver
[I/USB] Get max LUN:1
[I/USB] Ep=81 Attr=02 Mps=512 Interval=00 Mult=00
[I/USB] Ep=02 Attr=02 Mps=512 Interval=00 Mult=00
[E/USB] csw bStatus 1

ZXM47D0N /> [I/USB] Capacity info:
[I/USB] Block num:30712320,block size:512
[I/USB] Register MSC Class:/dev/sda
found part[0], begin: 262144000, size: 13.784GB
[I] udisk_init()163 Found partition 0: type = 12, offet=0x7d000, size=0x1b88000
01-01 09:44:16 I/NO_TAG: try to mount file system!
01-01 09:44:16 I/DFS: mount fs[elm] device[udisk] to /udisk ok.


ZXM47D0N /> ls ud
ZXM47D0N /> ls udisk
Directory udisk:
System Volume Inform<DIR>
d211-doc-master.zip 87831525
ZXM3C3D95_rtt_defcon38728
filetest.c          819
ZXM47D0N_rtt_defconf41427
ZXM47D0N_bootloader_11622
image_cfg.json      2997
image_cfg.rar       12065
d13x-OneOS-V1.0.1.ra208099546
M3A-V0.3.0-OneOS.zip361168667
ZXM47D0N />

7.12.2.2. USB Device 配置

首先要配置好 USB Device Controller。

7.12.2.2.1. USB Device Controller 配置

  • 在 Menuconfig 中配置设备。使能 USB 端口,并且配置当前 USB 端口为 Device 模式:

Board options  --->
    [*] Using Usb0
        Select Usb0 mode (Device)  --->
  • 在 Menuconfig 中配置 CherryUSB 驱动。使能 CherryUSB 驱动,并且使能 Device 模式:

Local packages options  --->
    Third-party packages options  --->
        [*] CherryUSB: tiny and portable USB host/device stack for embedded system with USB IP  --->
            [*]   Enable usb device mode  --->
                [*]   Enable usb msc device  --->

7.12.2.2.2. USB Interface 配置

USB Device 可以模拟成各种功能的 USB 外设,例如:USB 串口、USB 网口、U 盘…

7.12.2.2.2.1. U 盘 配置

  • 在 Menuconfig 中使能 CherryUSB 中 msc 类型的 Device Class 驱动,并且使能对应实例模板:

> Local packages options
    > Third-party packages options
        [*] CherryUSB: tiny and portable USB host/device stack for embedded system with USB IP  --->
            [*]   Enable usb device mode  --->
                [*]   Enable usb msc device  --->
                    [*]   Use msc ram template
  • U 盘生成有两种方式,一种是通过开发板上的sdcard生成,一种是通过ram生成:

  1. sdcard(需先实现sdcard挂载 ref_rtt_sdcard)

Local packages options  --->
    Third-party packages options  --->
        [*] CherryUSB: tiny and portable USB host/device stack for embedded system with USB IP  --->
            [*]   Enable usb device mode  --->
                [*]   Enable usb msc device  --->
                    Use ram or storage template (msc storage)  --->
                    MSC Storage Parameter  --->
                        [*] USBDEV_MSC_THREAD
                        (/sdcard) MSC_STORAGE_PATH
                        (204800) USBDEV_MSC_MAX_BUFSIZE
Startup time: 0.679 sec
[ND]nftl start:240,51
[ND]nftl ok!
ZXM47D0N /> 01-01 09:33:52 I/SDMC: SDMC1 BW 1, sclk 50400 KHz, clk 400 KHz(406 KHz), div 2-62


01-01 09:33:52 I/SDIO: SD card capacity 7609344 KB.
01-01 09:33:52 I/SDMC: SDMC1 BW 1, sclk 50400 KHz, clk 50000 KHz(50400 KHz), div 1-0

[I] aic_sdmc_set_iocfg()437 SDMC1 Buswidth 4, DDR mode 0, Current clock: 50000 KHz
01-01 09:33:52 I/DFS: mount fs[elm] device[sd0] to /sdcard ok.

card insertion detected!
[I/USB] Open ep:0x02 type:2 mps:512
[I/USB] Open ep:0x81 type:2 mps:512
[I/USB] Unmount /sdcard
  • 用户使用:
    1. 将单板的 USB Device 端口和 Windows PC 的 USB Host 端口连接,在 Windows PC 上会看到一个新增的 U 盘,可以正常读写。

  • 如图所示:

../../../_images/usb_msc_device.jpg
  1. msc ram

Local packages options  --->
    Third-party packages options  --->
        [*] CherryUSB: tiny and portable USB host/device stack for embedded system with USB IP  --->
            [*]   Enable usb device mode  --->
                [*]   Enable usb msc device  --->
                    Use ram or storage template (msc ram)  --->
[ND]nftl start:240,51
[ND]nftl ok!
ZXM47D0N /> [I/USB] read MS OS 2.0 descriptor string
[E/USB] standard request error
[I/USB] Setup: bmRequestType 0x80, bRequest 0x06, wValue 0x03ee, wIndex 0x0000, wLength 0x0012
01-01 09:38:19 I/SDMC: SDMC1 BW 1, sclk 50400 KHz, clk 400 KHz(406 KHz), div 2-62

01-01 09:38:19[I/USB] Open ep:0x02 type:2 mps:512
[I/USB] Open ep:0x81 type:2 mps:512


ZXM47D0N />
ZXM47D0N /> [I/USB] Open ep:0x02 type:2 mps:512
[I/USB] Open ep:0x81 type:2 mps:512

ZXM47D0N />
ZXM47D0N />
  • 用户使用:
    1. 将单板的 USB Device 端口和 Windows PC 的 USB Host 端口连接,在 Windows PC 上会看到一个新增的 U 盘,可以正常读写。

  • 如图所示:

../../../_images/usb_msc_device2.jpg

7.12.2.2.2.2. HID 配置(鼠标、键盘…)

  • 在 Menuconfig 中使能 CherryUSB 中 hid 类型的 Device Class 驱动,并且使能对应实例模板:

Local packages options  --->
    Third-party packages options  --->
        [*] CherryUSB: tiny and portable USB host/device stack for embedded system with USB IP  --->
            [*]   Enable usb device mode  --->
                [*]   Enable usb hid device  --->
                    Use hid template (mouse)  --->
ZXM47D0N />
ZXM47D0N /> test_usbd_hid_mouse

7.12.2.2.2.3. CDC 配置(串口)

  • 在 Menuconfig 中使能 CherryUSB 中 cdc 类型的 Device Class 驱动,并且使能对应实例模板:

Local packages options  --->
    Third-party packages options  --->
        [*] CherryUSB: tiny and portable USB host/device stack for embedded system with USB IP  --->
            [*]   Enable usb device mode  --->
                [*]   Enable usb cdc acm device  --->
                    [*]   Use cdc acm template
Startup time: 0.684 sec
[ND]nftl start:240,51
[ND]nftl ok!
ZXM47D0N /> [I/USB] Open ep:0x83 type:3 mps:8
[I/USB] Open ep:0x02 type:2 mps:512
[I/USB] Open ep:0x81 type:2 mps:512

//PC端打开串口
ZXM47D0N />
ZXM47D0N />
ZXM47D0N /> Out len: 5
]0x0d [ [1]0x31 [2]0x32 [3]0x33 [
]0x0a

ZXM47D0N /> cdc_acm_data_send_with_dtr_test
In len: 2048
In len: 0
ZXM47D0N />
  • 用户使用:
    1. 将单板的 USB Device 端口和 Windows PC 的 USB Host 端口连接,在 Windows PC 上会看到一个新增的 串口,可以正常读写。

  • 如图所示:

../../../_images/usb_cdc_device.jpg

7.12.2.2.2.4. ADBD 配置

  • 在 Menuconfig 中使能 CherryUSB 中 msc 类型的 Device Class 驱动,并且使能对应实例模板:

> Local packages options
    > Third-party packages options
        [*] CherryUSB: tiny and portable USB host/device stack for embedded system with USB IP  --->
        [*] ADBD: Android Debug Bridge daemon implementation in RT-Thread  --->
            [*]   Enable Shell service
            [*]   Enable File service
  • 用户使用:
    1. 将单板的 USB Device 端口和 PC 的 USB Host 端口连接,在 PC 端运行 adb shell 命令即可进行 adb 操作。 进入 adb shell 以后,可以通过 exitas 命令退出:

C:\Users\xxx>adb shell

aic /> ls
Directory /:
ram                 <DIR>
data                <DIR>
rodata              <DIR>
sdcard              <DIR>
udisk               <DIR>
aic />
aic /> exit
exitas
aic /> exitas

C:\Users\xxx>