RT-thread应用讲解——U盘（usb host）

U盘是一个很常用的存储设备，它是通过usb实现数据传输的，那么在stm32上面，我们要怎么接入U盘，并实现文件读写呢？这一讲基于RT-thread操作系统，我来介绍一下如何使用usb host实现U盘的读写。

RT-thread也有关于U盘的使用，可以先看一下，我这边主要讲一下重点。

STM32上使用USB Host读写U盘：https://www.rt-thread.org/document/site/#/rt-thread-version/rt-thread-standard/application-note/driver/usb/an0046-rtthread-driver-usbh

特别说明：本教程的配置如下：

一、STM32CubeMX配置

使用STM32CubeMX配置底层接口（路径一般在工程目录下boardCubeMX_Config文件夹里面）

不懂的同学可以看下我之前的博客。

RT-Thread零基础快速入门第1讲——新建工程

打开USB_OTG_FS，配置模式为Host_Only，使能中断，其他按默认即可。

二、ENV配置

1、使能USB Host

如果你不知道env怎么使用，可以在下面这个链接查看。

env使用方法：https://www.rt-thread.org/document/site/programming-manual/env/env/#bsp-menuconfig

用env打开工程，进入menuconfig配置页面，打开USB Host，配置挂载目录。

提示：除了U盘，如果没有挂载其他存储设备，这里直接挂载到根目录即可，如果有其他设备已经挂载到根目录了，这里就要选择其他目录。

2、使能文件系统

USB Host读写U盘的功能需要依赖RT-Thread的虚拟文件系统，所以这里要打开文件系统，不然会报错。

3、重新生成工程

在env输入下面的命令，重新生成新的工程。

提示：会使用env的话应该都知道这个操作。

scons --target=mdk5

三、运行测试

启动设备，插入U盘，正常识别到U盘的话会提示找到一个设备并显示该设备的内存大小（如下图所示）。输入ls命令，可以查看U盘里面的文件（文件的操作命令跟linux系统是一样的）。

正常到这里其实就已经完成了U盘的挂载和读写了。如果还不放心，可以按照官网给的测试用例再跑一遍。

测试用例如下：

#include <dfs_posix.h>
#define TEST_FN     "/test_usbh.c"
static char test_data[120], buffer[120];

void readwrite(const char* filename)
{
    int fd;
    int index, length;

    fd = open(TEST_FN, O_WRONLY | O_CREAT | O_TRUNC, 0);
    if (fd < 0)
    {
        rt_kprintf("open file for write failedn");
        return;
    }

    for (index = 0; index < sizeof(test_data); index ++)
    {
        test_data[index] = index + 27;
    }

    length = write(fd, test_data, sizeof(test_data));
    if (length != sizeof(test_data))
    {
        rt_kprintf("write data failedn");
        close(fd);
        return;
    }

    close(fd);

    fd = open(TEST_FN, O_RDONLY, 0);
    if (fd < 0)
    {
        rt_kprintf("check: open file for read failedn");
        return;
    }

    length = read(fd, buffer, sizeof(buffer));
    if (length != sizeof(buffer))
    {
        rt_kprintf("check: read file failedn");
        close(fd);
        return;
    }

    for (index = 0; index < sizeof(test_data); index ++)
    {
        if (test_data[index] != buffer[index])
        {
            rt_kprintf("check: check data failed at %dn", index);
            close(fd);
            return;
        }
    }

    rt_kprintf("usb host read/write udisk successfulrn");

    close(fd);
}

MSH_CMD_EXPORT(readwrite, usb host read write test);

上面这段测试代码运行结果如下：

这段代码的作用是新建一个test_usbh.c文件，并写入一些数据，运行完之后可以拔出u盘，然后在电脑上查看test_usbh.c文件的内容来验证读写的数据是否正常。
test_usbh.c文件的内容如下：

四、常见问题解答

1、ENV配置里面没有USB Host怎么办？

原因：RT-thread的源码不是4.0.2以上版本的

解决办法：使用新版的源码，或者在旧版的基础上移植USB Host的代码，USB Host的代码结构很清晰，把驱动代码和框架代码这两部分移植过来即可。

2、USB Host的配置都对了，但是U盘识别不出来。

如果USB Host的配置和硬件电路都确认没问题的话，有可能是挂载的问题，比如挂载的目录已经有其他设备挂载了，或者设备最大挂载数量不够，RT-thread挂载设备是有限制挂载数量的，可以在ENV配置里面修改，如果你挂载的设备数量大于最大挂载数，大于那部分设备就挂载不上了。

3、能识别到U盘的内存，但是读不到U盘里面的文件。

跟U盘的文件系统格式有关系，我试了几个U盘，FAT或FAT32格式都是可以的，NTFS格式有些可以，有些不行，这个就有点奇怪了，原因还不确定。

五、结束语

好了，关于U盘读写的介绍就到这里，如果还有什么问题，欢迎在评论区留言。如果这篇文章能够帮到你，就给我点个赞吧，如果想了解更多RT-thread和单片机的内容，可以关注一下博主，后续我还会继续分享更多的经验给大家。

教程相关源码：https://pan.baidu.com/s/1N2D8dM31deKIqNqaIQfPiA
提取码：7nsx

RT-thread相关教程汇总：https://blog.csdn.net/ShenZhen_zixian/article/details/120563891