STM32F103 Blue-Pill开发板的Arduino生态兼容说明

English | 中文

1 RTduino - RT-Thread的Arduino生态兼容层

STM32F103 Blue-Pill开发板已经完整适配了RTduino软件包，即RT-Thread的Arduino生态兼容层。用户可以按照Arduino的编程习惯来操作该BSP，并且可以使用大量Arduino社区丰富的库，是对RT-Thread生态的极大增强。更多信息，请参见RTduino软件包说明文档。

1.1 如何开启针对本BSP的Arduino生态兼容层

Env 工具下敲入 menuconfig 命令，或者 RT-Thread Studio IDE 下选择 RT-Thread Settings：

Hardware Drivers Config --->
    Onboard Peripheral Drivers --->
        [*] Compatible with Arduino Ecosystem (RTduino)

2 Arduino引脚排布

更多引脚布局相关信息参见 pins_arduino.c 和 pins_arduino.h。

注意：

1. 如果同时驱动舵机和调度analogWrite函数要选择不同定时器发生的PWM信号引脚，由于STM32的定时器4个通道需要保持相同的频率，如果采用相同的定时器发生的PWM分别驱动舵机和analogWrite，可能会导致舵机失效。

3 通信

3.1 I2C (Wire.h)

I2C总线是 D14 和 D15 引脚，这两个引脚默认是被RT-Thread I2C设备框架接管的，直接引用#include <Wire.h>（Arduino官方I2C头文件）即可使用。

3.2 SPI

SPI总线是 D24 、D25 和 D26 引脚，这三个引脚默认是被RT-Thread SPI设备框架接管的，直接引用#include <SPI.h>（Arduino官方SPI头文件）即可使用。此外，还使用到了片选引脚(SS)，默认为 D7。

3.3 串口

默认支持通过 Serial. 方法调用 uart1 串口设备；通过 Serial2. 方法调用 uart2 串口设备；通过 Serial3. 方法调用 uart3 串口设备。详见例程。

3.4 USB虚拟串口

本BSP支持USB虚拟串口，如果需要使用，可以手动使能。详见例程。

RT-Thread online packages --->
    Arduino libraries --->
        [*] RTduino: Arduino Ecological Compatibility Layer
            [*] Enable USB Serial