rt-thread-official/bsp/stm32/stm32f103-blue-pill/applications/arduino_pinout
Meco Man d2c12e2da8 [RTduino] change the pinout group name 2024-03-29 21:49:13 +08:00
..
README.md [RTduino][readme] correct grammar 2023-01-13 11:40:57 +08:00
README_zh.md [rtduino][BSPs] translate readme to English (#6496) 2022-10-09 21:45:25 -04:00
SConscript [RTduino] change the pinout group name 2024-03-29 21:49:13 +08:00
blue-pill-f103-pinout.jpg [rtduino]重新整理pinout (#6445) 2022-09-18 22:14:35 -04:00
pins_arduino.c [stm32][rtduino] add drv_gpio.h for pins_arduino.c 2023-12-23 14:36:30 +08:00
pins_arduino.h [RTduino] pins_arduino.h add limit check 2024-03-08 09:39:57 +08:00

README.md

The Arduino Compatible for STM32F103 Blue Pill Board

English | 中文

1 RTduino - Arduino Ecosystem Compatibility Layer for RT-Thread

STM32 Blue Pill board has support RTduino. Users can use Arduino APIs, third party libraries and programming method to program on the board.

1.1 How to Enable RTduino

Please go to the RTduino repository to see the details.

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

2 Arduino Pinout

For more information, please see pins_arduino.c and pins_arduino.h.

blue-pill-f103-pinout

Arduino Pin STM32 Pin 5V Tolerate Note
0 (D0) PB7 Yes
1 (D1) PB6 Yes
2 (D2) PB5 No PWM3-CH2. Token over by RT-Thread PWM device by default
3 (D3) PB4 Yes PWM3-CH1. Token over by RT-Thread PWM device by default
4 (D4) PB3 Yes PWM2-CH2. Token over by RT-Thread PWM device by default
5 (D5) PA15 Yes PWM2-CH1. Token over by RT-Thread PWM device by default
6 (D6) PA8 Yes
7 (D7, SS) PB12 Yes SPI chip select by default
8 (D8, LED_BUILTIN) PC13 No USER LED
9 (D9) PC14 No
10 (D10) PC15 No
11 (D11) PA0 No
12 (D12) PB0 No PWM3-CH3. Token over by RT-Thread PWM device by default
13 (D13) PB1 No PWM3-CH4. Token over by RT-Thread PWM device by default
14 (D14) PB9 Yes I2C-SDA. Token over by RT-Thread I2C device by default
15 (D15) PB8 Yes I2C-SCL. Token over by RT-Thread I2C device by default
16 (D16) PA12 Yes USB-DP. Token over by TinyUSB software package by default.
17 (D17) PA11 Yes USB-DM. Token over by TinyUSB software package by default.
18 (D18) PA10 Yes Serial-Rx. Token over by RT-Thread UART device by default
19 (D19) PA9 Yes Serial-Tx. Token over by RT-Thread UART device by default
20 (D20) PA2 No Serial2-Tx. Token over by RT-Thread UART device by default
21 (D21) PA3 No Serial2-Rx. Token over by RT-Thread UART device by default
22 (D22) PB10 Yes Serial3-Tx. Token over by RT-Thread UART device by default
23 (D23) PB11 Yes Serial3-Rx. Token over by RT-Thread UART device by default
24 (D24) PB15 Yes SPI-MOSI. Token over by RT-Thread SPI device by default
25 (D25) PB14 Yes SPI-MISO. Token over by RT-Thread SPI device by default
26 (D26) PB13 Yes SPI-SCK. Token over by RT-Thread SPI device by default
27 (A0) PA1 No ADC1-CH1. Token over by RT-Thread ADC device by default
28 (A1) PA4 No ADC1-CH4. Token over by RT-Thread ADC device by default
29 (A2) PA5 No ADC1-CH5. Token over by RT-Thread ADC device by default
30 (A3) PA6 No ADC1-CH6. Token over by RT-Thread ADC device by default
31 (A4) PA7 No ADC1-CH7. Token over by RT-Thread ADC device by default
32 (A5) -- ADC of chip internal reference voltage. Token over by RT-Thread ADC device by default
33 (A6) -- ADC of chip internal temperature. Token over by RT-Thread ADC device by default

Notice:

  1. Don't use a same hardware timer to drive PWM (analogRead) and servos at same time, because hardware timers can only generate a same frequency for 4 PWM channels. Otherwise, it could cause a failure when drive servos.

3 Communication

3.1 I2C Bus

I2C bus is D14 and D15 pins. Users can directly include the #include <Wire.h>, which is the Arduino official I2C header file, to use the I2C bus.

3.2 SPI Bus

SPI bus is D24, D25 and D26 pins. Users can directly include the #include <SPI.h>, which is the Arduino official SPI header file, to use the SPI bus. In addition, chip select pin (SS) also is used, which is D7 by default.

3.3 Serial

This board supports to use Serial. method to operate uart1 device; use Serial2. method to use uart2 device; use Serial3. method to use uart3 device. See example.

3.4 USB Virtual Serial

This board supports USB virtual serial. See example. You may enable it if is needed.

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