Serial设备用户开发

基础BSP配置--以STM32为例

建立工程文件

如果在提供的 oneos 源码中已经有适合的工程 DEMO 工程，则可以直接使用；如果没有请参照快速上手中的操作指南，新建一个适合的工程。

使用STM32CUBEMX配置硬件

1. 打开 oneos\projects\xxxxx(project文件夹)\board\CubeMX_Config 下 的 CUBE 工程文件；
2. 在 CUBE 工程中进行 Serial 配置，如下图所示，选中 UART，配置工作模式，分配引脚；
3. 配置UART的接收中断功能；
4. 若需要使用DMA功能，配置DMA功能；
5. 点击 GENARATE CODE 生成代码。

使用 Menuconfig 配置工程选项

1. 在对应的 oneos\projects\xxxxx(project文件夹) 目录下打开 OneOS-Cube 工具，在命令行输入 menuconfig 打开可视化配置界面；

2. 如下图所示，通过空格或向右方向键选择 Drivers->Serial 下的 Enable serial drivers 选项；

(Top) → Drivers→ Serial
                                                       OneOS Configuration
[*] Enable serial drivers
(64) Set RX buffer size
(64) Set TX buffer size

1. 如下图所示，通过空格或向右方向键选择 Drivers->HAL 选项，“ Configure base hal in STM32CubeMX ”提示在STM32CubeMX中配置HAL，因前面已完成硬件配置，此处无需操作；

   (Top) → Drivers→ HAL  
                                                       OneOS Configuration
   [ ] Enable Ethernet  ----
   [ ] default system clock config
    *** Configure base hal in STM32CubeMX ***
   

2. 若是没有配置工具的芯片工程，则Drivers->HAL选项显示如下图所示，通过空格键选中Enable UART --->；

   (Top) → Drivers→ HAL
                                                       OneOS Configuration
   -*- Enable GPIO
   [*] Enable LED
   [*] Enable UART  --->
   [ ] Enable on-chip FLASH
   [ ] Enable SPI BUS  ----
   [ ] Enable I2C BUS  ----
   [ ] Enable timer  ----
   [ ] Enable pwm  ----
   [ ] Enable ADC  ----
   [ ] Enable RTC  ----
   [ ] Enable Watchdog Timer
   

3. 在上一菜单中，通过向右方向键进入Drivers→ HAL→ Enable UART选项，如下图所示，选中需要开启的串口；

   (Top) → Drivers→ HAL→ Enable UART
                                                       OneOS Configuration
   [*] Enable UART0
   [ ] Enable UART1
   

4. Esc键退出menuconfig，注意保存所修改的设置。

使用 Scons 构建工程

在上一步打开的 OneOS-Cube 工具命令行输入 scons --ide=mdk5 构建工程。

工程编译及实现

1. 打开对应的 oneos\projects\xxxxx(project文件夹) 目录下的 project.uvprojx 工程文件；

2. 在工程中将原有或自己编写的serial_test文件加入到application子文件夹中；

3. 编译并下载工程，运行程序；

4. 打开串口工具如xshell、SecureCRT等，通信成功后，即可通过serial_int_tx_test,sereial_test,serial_rx_test命令测试serial的数据接收和发送功能；

5. 通过修改serial_test.c中serial的波特率，发送数据值等，查看运行效果；

6. 如不再使用serial设备，可再次使用STM32CubeMX配置工具，或者OneOS-Cube工具取消，在Drivers->HAL 下取消Enable UART的选择，保存设置后重新生成工程即可。