简介

---

USB(Universal Serial Bus)是一种支持热插拔的通用串行总线。它使用差分信号来传输数据，在 USB 1.0和 USB 1.1 版本中，只支持 1.5Mb/s 的低速（low-speed）模式和 12Mb/s 的全速（full-speed）模式，在 USB 2.0 中，又加入了480Mb/s 的高速模式，USB 3.0(super speed)，传输速率最大5Gbps。
  O1 i  S2 _: N- ]* G' ~' H在 USB 体系中又包括 USB Host(主机)和USB Device(设备)USB Host任何USB系统中只有一个主机。主机系统的USB接口被称为主机控制器。主机控制器可以以硬件，固件或软件的组合来实现。根集线器集成在主机系统内以提供一个或多个连接点。USB Device 可以分为 USB Hub 和 USB FunctionUSB Hub 提供了一种低成本、低复杂度的 USB接口扩展方法。Hub 的上行端口面向 HOST，下行端口面向设备(Hub 或功能设备)。在下行端口上，Hub 提供了设备连接检测和设备移除检测的能力，并给各下行端口供电。Hub 可以单独使能各下行端口。不同端口可以工作在不同的速度等级(高速/全速/低速)。USB Function 能够通过总线传输或接收数据或控制信息的设备，在 USB2.0 标准中，别称为 Class
本文主要是基于正点原子 stm32f767-atk-apollo 开发板，给出了 USB Host 读写 U 盘的配置和使用示例。本文准备资料如下：

• RT-Thread 源码
• Env 工具
• U 盘
  
  

8 c% v  ~( S1 J, b/ g5 t

依赖

• RT-Thread 4.0.2+
• RT-Thread 设备驱动框架
  
  

硬件连接准备

本文是基于 U 盘的读写，所以需要准备好一个 U 盘，并插入开发板上的 U 盘接口。

ENV 配置

---

打开 USB Host

RT-Thread 可以很方便的通过 ENV 来配置和生成工程。在 rt-thread\bsp\stm32\stm32f767-atk-apollo 目录下打开 ENV 工具，使用 menuconfig 进入如下配置界面并选中。

1---- Hardware Drivers Config
2    ----On-Chip Peripheral Drivers
- D! @9 @  L, }/ w# r0 b3        ----Enable USH Host
. c7 b3 D5 x# c- w4 l" c+ N( Z" [4            ----Enable Udisk Drivers
9 d* B( k1 Y' m$ J( a

配置界面如下图所示

打开文件系统

本文使用的是 USB Host 读写 U 盘的功能，所以需要打开 RT-Thread 的虚拟文件系统功能，打开文件系统的操作如下

1---- RT-Thread Components
/ D- m0 R& C" F+ W+ `1 E; h' g0 g# D2    ----Device virtual file system
3        ----Using device virtual file system

配置界面如下图所示

生成工程并下载

在 ENV 中打开 USB Host 和虚拟文件系统的功能之后，工程配置就结束了，退出配置界面并保存。在 ENV 工具中使用 scons --target=mdk5 命令重新生成工程并打开。工程打开之后可以看到 USB Host 的框架代码和驱动代码都已经自动加入到工程里面了，如下图所示

在 main.c 文件中加入以下测试代码并下载

（向右滑动查看全部代码）
4 {, M  X) d/ X7 [" Y

1#include <dfs_posix.h>
  y0 ?$ z' q  X* M& B+ n 2#define TEST_FN     "/test_usbh.c"
3static char test_data[120], buffer[120];
8 H9 ?2 R$ W- ~ 4
5void readwrite(const char* filename)
/ L8 g3 X; l8 \9 L: F 6{
  Q: D5 F9 G6 A' j% O0 O 7    int fd;
8    int index, length;
0 S* R. w. T' a6 |" m 9
10    fd = open(TEST_FN, O_WRONLY | O_CREAT | O_TRUNC, 0);
' d( M* @1 q$ _9 n( k- L( B' C; ?11    if (fd < 0)
12    {
13        rt_kprintf("open file for write failed\n");
7 U8 n0 l+ @- a! ~14        return;
9 [5 T, D1 K" V/ E; `15    }
16
17    for (index = 0; index < sizeof(test_data); index ++)
' j. A8 J. g2 q% U6 l18    {
% h3 b2 C( x0 g19        test_data[index] = index + 27;
! }2 O+ |/ X6 O# l0 d# r9 k20    }
21
22    length = write(fd, test_data, sizeof(test_data));
6 c7 b# s$ s# [2 p4 d& d- v  Y23    if (length != sizeof(test_data))
24    {
25        rt_kprintf("write data failed\n");
26        close(fd);
27        return;
28    }
' }/ y7 L7 x7 [+ ]2 B29
30    close(fd);
) D! v( E7 d) O8 h31
# T$ q$ s5 m0 j6 h2 B! y" @' e32    fd = open(TEST_FN, O_RDONLY, 0);
33    if (fd < 0)
8 _* c5 P6 G- Q2 ?7 B( o34    {
35        rt_kprintf("check: open file for read failed\n");
36        return;
37    }
38
) N* z' o' B  C. @3 a39    length = read(fd, buffer, sizeof(buffer));
40    if (length != sizeof(buffer))
41    {
42        rt_kprintf("check: read file failed\n");
43        close(fd);
44        return;
1 f9 b" m  o- k/ c- i. e* d# ^5 K8 S45    }
0 g3 |3 K6 k1 O  L46
) P' I# I. ?- R( q' X$ N0 @47    for (index = 0; index < sizeof(test_data); index ++)
4 l) Y2 h3 G( R2 U1 a3 O48    {
49        if (test_data[index] != buffer[index])
50        {
( g& V8 L5 n; ~, U# Q0 Q51            rt_kprintf("check: check data failed at %d\n", index);
52            close(fd);
* D8 A/ c4 v/ c7 H+ P$ d- m53            return;
54        }
55    }
9 t( w  a% h' V! @* ~56
- `5 }7 \4 @7 t- E) u57    rt_kprintf("usb host read/write udisk successful\r\n");
58
59    close(fd);
60}
61
" r( ]8 P  G' I" m! E0 n62MSH_CMD_EXPORT(readwrite, usb host read write test);
# d1 P4 X7 p" y3 H. a" x& f, e" q0 z

运行测试程序
$ g' Y2 b3 c- H

将以上程序下载入开发板之后连接串口调试工具可以看到如下调试信息

这里可以看到 U 盘的大小约为 7.4G，说明 U 盘已经成功挂载到开发板上面的文件系统了。使用文件系统的 ls 命令查看 U 盘目录的结果如下图：

在串口运行导出的 readwrite 测试函数的结果如下图所示 再次使用 ls 命令可以看到在 U 盘的根目录下已经新建了一个 test_usbh.c 文件，并且大小为 120 个字节，如下图所示

我们可以将 U 盘拔出并插在电脑上验证一下我们刚才写入的文件。

从电脑上我们可以看到已经成功创建了一个 test_usbh.c 的文件。到这一步为止，在 STM32 上使用 USB Host 读写 U 盘的介绍就结束了