Ameba ARDUINO: Getting Started with AMB23 (RTL8722DM MINI)


Ameba is an easy-to-program platform for developing all kind of IoT applications. AMB23 is equipped with various peripheral interfaces, including WiFi, GPIO INT, I2C, UART, SPI, PWM, ADC. Through these interfaces, AMB23 can connect with electronic components such as LED, switches, manometer, hygrometer, PM2.5 dust sensors, …etc.

The collected data can be uploaded via WiFi and be utilized by applications on smart devices to realize IoT implementation.


AMB23 uses Micro USB to supply power, which is common in many smart devices.
Please refer to the following figure and table for the pin diagram and function.


0PB0    I2C_SDA (a)   
1PB1A4 SERIAL2_TX (a)     
2PB2A5 SERIAL2_RX (a)     
3PB3A6      SWD_CLK
4PB4A0 SPI_MOSI (b)    
5PB5A1 SPI_MISO (b)I2C_SCL (b)   
6PB6A2  SPI_SCLK (b)I2C_SDA (b)   
7PB7A3 SPI_SS (b)    
9PA12 SERIAL2_TX (b)SPI_MOSI (a)    
10PA13 SERIAL2_RX (b)SPI_MISO (a)    
11PA14   SPI_SCLK (a)    
12PA15   SPI_SS (a)    
15PA18  SERIAL1_TX (b)     
16PA19  SERIAL1_RX (b)     
18PA21  SERIAL1_TX (a)     
19PA22  SERIAL1_RX (a)     
20PA23   I2C1_SCL   
21PA24   I2C1_SDA   
22PA31    I2C_SCL (a)   

Setting up Development Environment

Step 1. OS environment

AMB23 (RTL8722DM MINI) board currently supports Windows OS 32-bits or 64-bits, Linux OS (Ubuntu) and macOS. To have the best experiences, please use the latest version of OS.

For any Linux OS (Ubuntu) related issues, refer to

For any macOS related issues, refer to

Step 2. Installing the Driver

First, connect AMB23 to the computer via Micro USB:


If this is the first time connects AMB23 to computer, the USB driver for AMB23 will be automatically installed.
If you have driver issue of connect board to computer please go to for USB driver.
Check the COM port number in Device Manager of computer:


Step 2. Set up Arduino IDE

From version 1.6.5, Arduino IDE supports third-party hardware. Therefore, we can use Arduino IDE to develop applications, and the Arduino basic examples can run on AMB23 too. Refer to basic example link.

Arduino IDE can be downloaded in the Arduino website:
When the installation is finished, open Arduino IDE. To set up AMB23 correctly in Arduino IDE, go to “File” -> “Preferences”.


And paste the following URL into “Additional Boards Manager URLs” field:

Next, go to “Tools” -> “Board” -> “Boards Manager”:


The “Boards Manager” requires about 10~20 seconds to refresh all hardware files (if the network is in bad condition, it may take longer). Every time the new hardware is connected, we need to reopen the Board Manager. Find “Realtek Ameba Boards (32-bits ARM Cortex-M33 @200MHz)” in the list, click “Install”, then the Arduino IDE starts to download required files.


If there is GitHub downloading issue, please refer to the following link at “Download/Software Development Kit”. There are 3 sections.
1. “AMB23_Arduino_patch1_SDK”, please select at least 1 of the SDKs. There are 5 latest released SDK options.
2. “AMB23_Arduino_patch2_Tools”, please select according to your operation system. There are Windows, Linux and MacOS.
3. “AMB23_Arduino_Source_Code”, this section is optional download only wants to refer the latest source code.

Download the files selected, then unzip (patch1 and patch2 are compulsory). There are “Install.doc”/“Install.pdf” for you to refer installation steps. According to your system, please run the installation tool in the “Offline_SDK_installation_tool” folder.

After the installation tool running successfully, you may open Arduino IDE and proceed to “tools” -> “Board“ -> “Boards Manager…”. Try to find “Realtek Ameba Boards (32-bits ARM Cortex-M33 @200MHz)” in the list, click “Install”, then the Arduino IDE starts to download required files for AMB23.

Finally, we select board in “tools” -> “Board” -> “Ameba ARM (32-bits) Boards” -> “AMB23 (RTL8722DM_MINI)”


Try the First Example

Step 1. Compile & Upload

Arduino IDE provides many built-in examples, which can be compiled, uploaded and run directly on the boards. Here, we take the “Blink” example as the first try.
Open “File” -> “Examples” -> “01.Basics” -> “Blink”:


Arduino IDE opens a new window with the complete sample code. There are onboard LED of AMB23, the default “LED_BUILTIN” is blue onboard LED. Change “LED_BUILTIN” to “LED_B” or “LED_G” for different colours (blue and green).


Next, we compile the sample code directly; click “Sketch” -> “Verify/Compile”


Arduino IDE prints the compiling messages in the bottom area of the IDE window. When the compilation is finished, you will get the message as following.


Afterwards, we will upload the compiled code to board.
Please make sure the board is connected to computer, then click “Sketch” -> “Upload”.

The Arduino IDE will compile first then upload. Users are required to enter the upload mode of the board.To enter upload mode, first press and hold the UART_DOWNLOAD button, then press and release the RESET button, lastly release the UART_DOWNLOAD button. There is a 5-seconds count down set as a reminder to enter the upload mode.



It is optional for users to check if the board entered the upload mode. Open serial monitor/terminal and look for “#Flash Download Start”. Note, it is normal that some serial terminals may show characters as following.


Again, during the uploading procedure the IDE prints messages. Uploading procedure takes considerably longer time (about 30 seconds to 1 minute). When upload completed, the “Done uploading” message is printed.

Run the Blink example

In each example, Arduino not only provides sample code, but also detailed documentation, including wiring diagram, sample code explanation, technical details, …etc. These examples can be directly used on AMB23.
So, we find the detailed information of the Blink example:

In short, the example can be run on both onboard LEDs (green or blue) or external LED (use any GPIO pins for signal output).
Finally, press the RESET button, and you can see the LED blinking.
If you encounter any problem, please refer to Q&A.

Tool Feature

Erase Flash


• Enable: erase the image in the flash memory without uploading the current image.
• Disable: upload the user code upon compilation is finished.

“Erase Flash” is default selected as “Disable” to upload the user code.

Standard Lib Enable


• Arduino_STD_PRTINF: enable the usage of Arduino avr “stdio.h” and “#include ” when using printf
• NA: printf() is using based on standard sdk _rtl_printf()

“Standard Lib Enable” is default selected as “NA”.

Upload Speed


Selection of uploading baud rate at 1,500,000 or 921,600.

Please confirm that QQ communication software is installed