rt-thread/bsp/stm32/docs/STM32系列BSP外设驱动使用教程.md

87 lines
3.3 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# BSP 外设驱动使用教程
## 简介
本文档是为需要在 RT-Thread 操作系统上使用更多开发板资源的开发者准备的。通过使用 ENV 工具对 BSP 进行配置,可以开启更多板载资源,实现更多高级功能。
主要包括以下内容:
1. 如何使用开发板上更多的板载资源
2. 如何使用更多的片上资源
3. 如何添加更多片上资源选项
## 前提要求
- 学会如何使用 ENV 工具,参考:[RT-Thread env 工具用户手册](https://www.rt-thread.org/document/site/rtthread-development-guide/rtthread-tool-manual/env/env-user-manual/)
## 如何使用更多的板载资源
开发板上一般有很多板载资源,如 Flash、SD卡、以太网等但是 BSP 工程默认没有开启这些外设驱动。RT-Thread 提供了 ENV 工具来开启或关闭 BSP 的外设驱动。下面以在正点原子阿波罗 F429 开发板上开启 SPI Flash 驱动为例,一步步的展示如何使用 ENV 工具对 BSP 进行配置。
### 1打开配置工具
在目录 `rt-thread\bsp\stm32\stm32f429-atk-apollo` 下打开 menuconfig 配置界面。
![打开 menuconfig](figures/menuconfig_apolo.png)
打开的配置工具界面如下所示:
![RT-Thread 配置菜单](figures/config1.png)
通过键盘上的上下键移动光标,选中 `Hardware Drivers Config`然后按回车键进入硬件驱动配置菜单。
### 2进入硬件驱动配置菜单
在硬件配置菜单里有三个选项,分别是 **板载外设配置菜单**、**片上外设配置菜单**和**扩展模块配置菜单**,按回车键进入板载外设配置菜单。
![硬件驱动 配置菜单](figures/config2.png)
### 3在板载外设配置菜单里开启 SPI Flash 选项
![板载外设 配置菜单](figures/spi_flash.png)
### 4保存退出
然后右移光标选中 Save 按回车键保存,然后按 Esc 键退出配置工具。
![保存退出](figures/save.png)
### 5更新软件包
输入命令 `pkgs --update` 使软件包配置生效。
![1543477036034](figures/update.png)
### 6生成 MDK5 工程
输入命令 `scons --target=mdk5 -s` 重新生成 MDK5 的工程。
![1543477194829](figures/scons_mdk5.png)
### 7编译下载
打开生成的 MDK5 工程文件,编译并下载。
![1543478492157](figures/complise.png)
### 8查看运行结果
程序运行后,输入命令 `list_device` 可以看到名为 W25Q256 的块设备,此时 `SPI Flash` 设备已经可以使用了。
![1543478742034](figures/run_flash.png)
## 如何使用更多的片上资源
如果想要使用除了当前支持的片上资源GPIO 和 UART1又不想开启板载资源的支持可以通过直接配置 **片上外设配置菜单** 的方式,使用更多片上资源。
配置方法和上一章节介绍的 **如何使用更多的板载资源的配置方法** 一样,只是本次需要进入 `片上外设配置菜单`
![1543481275711](figures/on_chip_config.png)
配置完成后重新生成工程,编译下载,在 FinSH 控制台输入 `list_device` 命令,可以看到 I2C1 总线已经启用。
![i2c_device](figures/i2c_device.png)
## 总结
当开发者需要使用未开启的外设时,只要在 ENV 工具中使能相关的外设即可,重新生成的工程中就会添加对应的驱动文件。开发者就可以利用 RT-Thread 提供的驱动开快速开发应用了。