1# The Arduino Compatible for STM32F072 Nucleo Board
2
3**English** | [中文](README_zh.md)
4
5## 1 RTduino - Arduino Ecosystem Compatibility Layer for RT-Thread
6
7STM32F072 Nucleo board has support [RTduino](https://github.com/RTduino/RTduino). Users can use Arduino APIs, third party libraries and programming method to program on the board.
8
9### 1.1 How to Enable RTduino
10
11Please go to the [RTduino repository](https://github.com/RTduino/RTduino) to see the details.
12
13```Kconfig
14Hardware Drivers Config --->
15    Onboard Peripheral Drivers --->
16        [*] Compatible with Arduino Ecosystem (RTduino)
17```
18
19## 2 Arduino Pinout
20
21![nucleo-f072-pinout](nucleo-f072-pinout.png)
22
23This board complies with Arduino UNO pins layout. For more details, please take a look at: [pins_arduino.c](pins_arduino.c) and [pins_arduino.h](pins_arduino.h).
24
25| Arduino Pin           | STM32 Pin | 5V Tolerate | Note                                                                                          |
26| --------------------- | --------- | ----------- | --------------------------------------------------------------------------------------------- |
27| 0 (D0)                | PA3       | No          | Serial-Rx. Token over by RT-Thread UART device by default                                     |
28| 1 (D1)                | PA2       | No          | Serial-Tx. Token over by RT-Thread UART device by default                                     |
29| 2 (D2)                | PA10      | Yes         |                                                                                               |
30| 3 (D3)                | PB3       | Yes         | PWM2-CH2. Token over by RT-Thread PWM device by default                                       |
31| 4 (D4)                | PB5       | Yes         |                                                                                               |
32| 5 (D5)                | PB4       | Yes         | PWM3-CH1. Token over by RT-Thread PWM device by default                                       |
33| 6 (D6)                | PB10      | Yes         | PWM2-CH3. Token over by RT-Thread PWM device by default                                       |
34| 7 (D7)                | PA8       | Yes         |                                                                                               |
35| 8 (D8)                | PA9       | Yes         |                                                                                               |
36| 9 (D9)                | PC7       | Yes         | PWM3-CH2. Token over by RT-Thread PWM device by default                                       |
37| 10 (D10)              | PB6       | Yes         | PWM16-CHN1. Token over by RT-Thread PWM device by default                                     |
38| 11 (D11)              | PA7       | No          | PWM17-CH1. Token over by RT-Thread PWM device by default                                      |
39| 12 (D12)              | PA6       | No          |                                                                                               |
40| 13 (D13, LED_BUILTIN) | PA5       | No          | USER LED                                                                                      |
41| 14 (D14)              | PB9       | Yes         | I2C-SDA. Token over by RT-Thread I2C device by default                                        |
42| 15 (D15)              | PB8       | Yes         | I2C-SCL. Token over by RT-Thread I2C device by default                                        |
43| 16 (D16)              | PC13      | No          | USER Button                                                                                   |
44| A0                    | PA0       | No          | ADC1-CH0. Token over by RT-Thread ADC device by default                                       |
45| A1                    | PA1       | No          | ADC1-CH1. Token over by RT-Thread ADC device by default                                       |
46| A2                    | PA4       | No          | ADC1-CH4. Token over by RT-Thread ADC device by default                                       |
47| A3                    | PB0       | No          | ADC1-CH8. Token over by RT-Thread ADC device by default                                       |
48| A4                    | PC1       | No          | ADC1-CH11. Token over by RT-Thread ADC device by default                                      |
49| A5                    | PC0       | No          | ADC1-CH10. Token over by RT-Thread ADC device by default                                      |
50| A6                    | --        |             | On-chip internal voltage sensor. ADC1-CH17. Token over by RT-Thread ADC device by default     |
51| A7                    | --        |             | On-chip internal temperature sensor. ADC1-CH16. Token over by RT-Thread ADC device by default |
52
53> Notice:
54>
55> 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.
56
57> References
58>
59> 1. [STM32 Nucleo-64 user manual](https://www.st.com/resource/en/user_manual/um1724-stm32-nucleo64-boards-mb1136-stmicroelectronics.pdf)
60
61## 3 Communication
62
63### 3.1 I2C Bus
64
65I2C bus is `SCL/D15` and `SDA/D14` pins. Users can directly include the `#include <Wire.h>`, which is the Arduino official I2C header file, to use the I2C bus.
66
67### 3.2 SPI Bus
68
69This board doesn't support Arduino SPI header file and functions.
70
71### 3.3 Serial
72
73This board supports to use `Serial.` method to operate `uart2` device. See [example](https://github.com/RTduino/RTduino/blob/master/examples/Basic/helloworld.cpp).
74