开始本篇实验前,需要搭建RT-Thread开发环境 在HPM6750上使用RT-Thread驱动SD卡实现文件读写只需要三步: 配置FATFS和SDIO功能 编译项目代码 PS:本篇内容特点——实操性强,异常简单,有手就行。 准备工作 准备好开发板和SD卡 开始本篇实验之前,需要准备一个MicroSD卡,我这里准备的是一个32G的铠侠蓝卡: 创建RT-Thread项目 首先,使用RT-Thread Studio创建名为hpm_sdio_test的项目:
注:如果已有RT-Thread项目,则可以跳过此步骤。 配置RT-Thread 这里仅以RT-Thread Studio为例,对RT-Thread进行配置。除此之外,使用RT-Thread的Env工具,在命令行环境下进行相关配置也是可以的。 打开FATFS和SDIO组件 创建项目后,打开RT-Thread Settings,开启FATFS和SDIO配置:
可以看到,打开的组件,图标显示为彩色。这里的SDIO属于RT-Thead驱动框架的SDIO部分。 为了方便观察实验现象,这里最好再打开SDIO组件的调试日志:
图中顶栏的几个部分,对于RT-Thread Studio创建的RT-Thread项目,通常而言: 内核栏中的属于内核组件配置,相关源码位于rt-thread子目录; 组件栏中的属于系统组件配置,相关源码位于rt-thread/components子目录; 软件包栏中的属于三方组件配置,相关源码默认不在项目中;在打开相应配置并保存后,才会下载到项目的packages子目录; 硬件栏中的属于BSP配置,相关源码通常在board子目录; 2.2 打开SDIO驱动 前面打开的仅是SDIO驱动框架,要使用SDIO功能,还需要打开HPM开发板的SDXC驱动:
修改完成,Ctrl+S保存修改。 三、编译、烧录、运行 3.1 编译项目代码 完成上面的配置工作后,Ctrl+B编译项目:
编译完成后,可以在控制台看到Flash和RAM占用情况。 3.2 烧录程序 编译成功后,我们需要将生成的二进制程序代码文件烧录到开发板上。 开始测试之前,我们需要先将MicroSD卡插入开发板(RT-Thread目前还不支持SD卡热插拔)。
插入SD卡后,将开发板通过USB线连接到PC。 此时,我们可以看到,正面的SD卡指示灯已经亮起了。 3.3 运行程序 接着,回到RT-Thread Studio,用Ctrl+Alt+D快捷键,将编译好的程序烧录到开发板上。 烧录完成后,我们就可以在串口终端看到——已经检查到sd卡了:
可以看到,RT-Thread版本信息已经打印出来了,同时看到了熟悉的msh提示符。 基于RT-Thread的项目默认情况下开启了msh,并且将UART0串口初始化为console输入输出。因此,我们可以在串口中断软件中,输入msh支持的命令,查看命令的输出。 四、在msh中操作SD卡 烧录完成后,我们就可以在RT-Thread的msh环境中愉快地操作SD卡了。本节我将在串口终端中演示——如何在HPM6750开发板上使用RT-Thread提供的文件系统、目录、文件操作相关命令。 首先,我们可以通过help命令查看此时msh中支持哪些命令:
可以看到,这里有很多命令,我们接下将会使用到的有: 文件操作命令——ls/cp/mv/cat/rm 可以写文件的命令——echo 目录操作命令——cd/pwd/mkdir 文件系统操作命名——mkfs/mount/umount/df 使用过Linux的朋友应该会对上面这些命令感到熟悉。 接下来,我将会在msh中演示——如何通过这些命令对SD卡进行一些操作。 4.1 查看块设备 我们可以在串口终端内使用list_device命令查看设备:
此时,我们可以看到已经有了一个名为“sd0”的块设备。 4.2 格式化SD卡 初次使用的SD卡,可能没有文件系统,或者文件系统不是FAT格式的,需要将SD卡格式化为FAT文件系统,RT-Thread后续才能挂载成功。 注意:格式化操作会导致SD卡上已有数据全部丢失;因此,在执行格式化操作前,请确认SD卡上没有重要数据,或者你已对SD卡上的重要数据进行了备份。 接下来,我们可以通过mkfs命令对SD卡进行格式化:
mkfs执行会持续一段时间,请耐心等待(具体因不同SD卡容量和速度等级而异,我的32GB卡消耗了几秒钟)。 4.3 挂载文件系统 接下来,我们可以在串口终端内使用mount命令将SD卡挂载到根目录:
这里,我先使用了mount -h查看了mount命令的用法。 另外需要注意的是,fstype参数使用的是elm(这里的elm实际就是FATFS)。 4.4 简单的文件读写测试 前面提到echo命令比较特殊,可以写文件,接下来使用echo写文件,cat读文件,ls查看文件:
这里使用了ls、echo、cat命令,进行了文件读写操作。 4.5 简单的目录操作测试 接下来,进行简单的目录操作演示。
这里首先使用了pwd查看当前工作目录,然后演示了ls、mkdir、cd命令; 如果你是对RT-Thread了解不多的朋友,看到这里可能会非常惊奇——在一个可以运行在单片机的RTOS上,居然可以这么方便的进行文件系统、目录、文件操作。 五、业务代码中使用SD卡 前面都是使用命令进行相关操作的,实际项目中往往需要在业务代码中使用前面的那些功能,包括文件系统、目录、文件操作。 5.1 使用代码进行相关操作 所谓“授人以鱼不如授人以渔”,这里不准备展开介绍前面所有命令行操作如何用代码实现,只介绍如何找到前面那些操作的源码实现。总体来说,主要有两个方法: grep大法 grep结合正则表达式进行搜索 使用其他你熟悉的工具也是可以的 RTFSC(read the f**king source code) 根据搜索到的位置打开文件并阅读源码 对,会这两招就可以了(找到之后该干什么不用我说了吧)。 下面以搜索mount命令的实现代码为例进行演示。我们知道RT-Thread的msh命令是通过MSH_开头的宏注册到命令列表中的。因此可以搜索:
接下来,就可以打开./rt-thread/components/finsh/msh_file.c文件,跳转到526进行查看了: 可以看到这里调用了dfs_munt实现了文件系统挂载功能。 六、完善细节 绝大部分文件系统都有文件的创建、修改时间信息,FATFS也不例外。因此,为了能够让SD卡上文件具有正确的创建、修改时间信息正常,建议使用SD卡的同时启用RTC(Real Time Clock)以及NTP(Network Time Protocol)对时功能。本节主要介绍如何开启RT-Thread的RTC和NTP对时功能。 6.1 使能RTC 在RT-Thread系统中,RTC的实现有两种,一种是纯软件方式,另一种是硬件方式。 软件方式的RTC,RT-Thread内核已经有了完整的实现,一般用于没有硬件RTC的设备上(或者硬件RTC驱动还没有支持的情况下)。RT-Thread的硬件RTC,和其他硬件功能类似,有RTC驱动框架和RTC硬件驱动两部分。其中,RTC驱动框架已有RT-Thread内核实现,RTC硬件驱动由厂商实现(一般通过BSP或者CSP提供出来)。 软件模拟RTC以及RTC驱动框架的配置项可以通过RT-Thread Settings进行设置:
HPM6750的BSP中已经实现了RTC硬件驱动,我们可以在RT-Thread Settings中设置硬件RTC功能:
6.2 使能网络和NTP——实现联网自动对时 使能WiFi联网, RT-Thread的netutils软件包种包含了NTP功能,使能NTP功能可以参考帖子中使能netutils软件包中ifconfig相关的介绍。 七、本篇小结 可以看到,在基于RT-Thread系统的项目中,我们没有添加任何代码,就可以实现对HPM6750开发板上的SD卡进行文件系统、目录、文件相关操作。这是因为RT-Thread系统本身已经积累了大量优秀开发者的工作成果,其中包括SDIO驱动框架、FATFS支持、芯片厂的SDXC驱动。所谓的“站在巨人的肩膀上”,大概就是这种体验吧。 本篇就到这里了,感谢你的阅读,下次再会。
原作者:xusiwei1236
|