Arduino Ecosystem Compatibility Layer for RT-Thread

Please Star this project if you like it. Thank you!

English | 中文

---

1 Introduction

RTduino is the Arduino ecosystem compatibility layer for RT-Thread RTOS. RTduino is the sub-community of RT-Thread community and the downstream project of Arduino. RTduino is an open source project which is compatible with Arduino APIs so that RT-Thread beginners can easily get start to use RT-Thread through Arduino APIs, which significantly reduces the difficulty of learning RT-Thread. Meanwhile, RT-Thread users also can directly run thousands of Arduino third party libraries on RT-Thread by using RTduino.

Using the RTduino and Arduino libraries will be very easy through the RT-Thread Studio integrate development environment (IDE) with GUI configurations.

1.1 RT-Thread BSPs which have supported RTduino

BSP List	BSP List
ES32F3696	DJI STM32F427 Robomaster Type A
STM32F103 BluePill	DJI STM32F407 Robomaster Type C
STM32F401 BlackPill	TM32L431 Bear Pi
STM32F411 BlackPill	STM32L475 Pandora
STM32F072 Nucleo	CH32V307V-R1
STM32F401 Nucleo
STM32F410 Nucleo
STM32F411 Nucleo
STM32F412 Nucleo
STM32F469 Discovery

RTduino also allows users to directly run without a specific BSP supporting. Please see Chapter 5

1.2 Terms Explanation

Software Package: is RT-Thread side third party extension, and belongs to RT-Thread ecosystem.

Library: is Arduino side third party extension, and belongs to Arduino ecosystem.

Software package and library are the same meaning, but different names for RT-Thread and Arduino communities.

2 How to use RTduino

We will use STM32F103 BluePill BSP as an example to show how to use RTduino.

RTduino requires the minimum version of RT-Thread is 4.1.1

2.1 References

• How to import a BSP project with latest code into RT-Thread Studio

2.2 Import and create a project

This vedio will also teach you how to import a BSP into RT-Thread Studio as a project

• Please go to the RT-Thread repository to download the latest code

• Download and install RT-Thread Studio IDE

• Unzip the RT-Thread source code file and open RT-Thread Studio

• In RT-Thread Studio IDE, select File -> Import, and select RT-Thread BSP Project into Workspace

• Click Browse button and select the Blue Pill BSP folder: rt-thread\bsp\stm32\stm32f103-blue-pill. This video also teaches you how to import a BSP project into RT-Thread Studio. Then, click Finish button to let RT-Thread Studio to import the Blue Pill BSP project.

• When importing finished, please click RT-Thread Settings. Then, click << button to show the configuration details.

• Click Hardware, and select Compatible with Arduino Ecosystem (RTduino). Then, click the "hammer" button to compile the project. RT-Thread Studio will automatically download the RTduino and other dependency software packages and compile the whole project.

• Up to now, this project has supported Arduino programming.

2.3 Where is the setup-loop framework

Now, you have successfully create a RT-Thread Blue Pill Board project and allow you to directly use Arduino APIs to drive this board. However, where is the setup-loop framework, which is very common seen in an Arduino sketch?

Actually, the Arduino sketch is located in bsp/stm32/stm32f103-blue-pill/applications/arduino_main.cpp, where is in the application folder.

2.4 Try to blink a LED!

#include <Arduino.h>

void setup(void)
{
    // put your setup code here, to run once:
    pinMode(LED_BUILTIN, OUTPUT);
}

void loop(void)
{
    // put your main code here, to run repeatedly:
    digitalWrite(LED_BUILTIN, !digitalRead(LED_BUILTIN));
    Serial.println("Hello Arduino!");
    delay(100);
}

You will see the LED is blinking and the serial terminal also shows "Hello Arduino!".

There are many other examples and demos at example folder

2.5 RTduino folder directory structure

There are two main folders in RTduino: core and libraries.

• core folder: contains all Arduino related APIs will be implemented in this folder, such as: digitalRead, analogWrite and so on.
• libraries folder
• buildin folder: contains Arduino build-in libraries such as SPI, Wire (I2C), servo and so on.
• user folder: this folder is empty by default and it prepares for users to import the Arduino Third Parity libraries. This operation will introduce and explain in the next chapter.

2.6 BSP Arduino IO Pinout

You will find more information related a specific BSP Arduino pinout at: applications/arduino folder. For Blue Pill BSP, it is located at here.

3 Arduino Libraries

Notice: if has any question related the Arduino (third-party) libraries, please open an issue and report in this repository.

3.1 Arduino Build-in Libraries

RTduino has supported most of Arduino build-in libraries, where is in the folder libraries/buildin. The following table will show the details:

Library	Enable Macro	Note
Servo	RTDUINO_USING_SERVO	Enable by default if PWM is available.
SPI	RTDUINO_USING_SPI	Enable by default if SPI is available.
Wire	RTDUINO_USING_WIRE	Enable by default if I2C is available.
USBSerial	RTDUINO_USING_USBSERIAL	Enable manually if is needed, and rely on the TinyUSB for RT-Thread software package automatically.

3.2 Enable Arduino Third Party libraries through RT-Thread software center

In RT-Thread software center, there is a specific category for Arduino. RTduino community will register some important and frequent to use Arduino third party libraries to RT-Thread software package center, so that users can directly use those libraries with GUI configuration in RT-Thread Studio.

The following example will show how to enable Arduino Adafruit AHTx0 sensor driver library with a few clicks:

• Please follow the previous chapter to import a project into RT-Thread Studio and select Compatible with Arduino Ecosystem (RTduino) in RT-Thread Settings.

• Please to go Software column, and select Arduino libraries category, and extend Sensors sub-category of Arduino library. Then, select and enable the Adafruit AHTx0 Arduino driver library. RT-Thread Studio will help you to enable other dependency libraries, such as Adafruit Unified Sensor library, Adafruit BusIO library and so on.

• Click hammer to compile the project. RT-Thread Studio will automatically download the software packages and libraries and compile the whole project.

• When the compiling finishes, you can copy the example code of AHTx0 library, where is in the example folder, and paste it into arduino_main.cpp file. Then, compile the project again and download the program into the board. You will see the current sensor data will show on the terminal. Now, we have successfully directly run Arduino library on RT-Thread.

3.3 Import Third Party Arduino Libraries Manually

You also can directly import an Arduino library manually, which has not been registered into RT-Thread software package center. This operation also is very easy.

• You need to download the library from github or other repository and directly drag the ZIP file into libraries\user folder, and you don't need to decompress the ZIP file.

• Then, go to RT-Thread Studio, right click the project, select Sync Sconscript to project and click hammer to compile the project again.

• When the compiling finishes, you will find the new library is shown on the project, where is in the libraries\user folder of the project group.