Ameba FAQ

Please find the Ameba Frequently Asked Questions (FAQ) in this post!

Content


General

General

What is Ameba Arduino?

Answer: It’s third-party Arduino SDK for Ameba development boards.


What is Ameba MicroPython?

Answer: It is an officially supported MicroPython port for Ameba development boards.


What is the main difference between Ameba Arduino and Ameba MicroPython?

Answer: They used different programming languages. Ameba Arduino uses C++ while Ameba MicroPython uses Python.


What are the official open-source Ameba development boards?

Answer: AMB21/22, AMB23, AMB01, AMB02


Where can I buy the Ameba development boards?

Answer: You can get the Ameba development boards from Buy Ameba Boards – Realtek IoT/Wi-Fi MCU Solutions.


Where can I find the open-source SDK for Ameba development boards?

Answer: You can find the open-source SDK at ambiot · GitHub.


Who should I contact if I encounter an issue while using Ameba development boards?

Answer: You can ask your questions on our forum here: https://forum.amebaiot.com/. Alternatively, you can raise an issue in the corresponding GitHub repositories.


Software_ IDE

Software/ IDE

Is the COM port number different for all boards/computers?

Answer: Yes.


In order to use Ameba development boards, what software do I need to download?

Answer: To determine which software to download, by depending on the SDK and IDE you intend to use, you can visit Realtek IoT/Wi-Fi MCU Solutions and refer to the “Getting Started” page based on the Ameba development board you are using.


Can I use Ameba development boards without using Arduino IDE?

Answer: Yes.


What tools can I use to view the log console?

Answer: Make use of any terminal tools, such as SecureCRT/teraterm/putty etc.


Can I still run Ameba development boards if I am using Windows 11?

Answer: Yes.


I cannot find Ameba development boards in the Arduino IDE “Boards Manager”, what should I do?

Answer: Check that the json link is added to “Preferences” in Arduino IDE (find the respective json link from “Getting Started” page for each Ameba development boards at Realtek IoT/Wi-Fi MCU Solutions ). If you are still unable to find the Ameba development board in the Arduino IDE’s “Boards Manager”, you can download the offline packages from Ameba ARDUINO – Realtek IoT/Wi-Fi MCU Solutions.


What is the baud rate I have to set in Serial Monitor to prevent getting junk symbols?

Answer: To set the serial terminal baud rate value, it should be same as the baud rate set in the ino file. Eg, " Serial.begin(9600);"


Where can I find Serial Monitor in Arduino IDE?

Answer: You can find the Serial Monitor at the top right-hand corner of the Arduino IDE by clicking on
image.


Where can I find Serial Plotter in the Arduino IDE?

Answer: You can find it at “Tool” → “Serial Plotter”.


Do I always have to compile before uploading in Arduino IDE?

Answer: No, because the upload command includes compiling and uploading.


Can I have .cpp and .h file together with .ino files in sketches to run in Arduino IDE?

Answer: Yes.


How to add a file on Arduino IDE?

Answer: Shortcut to add a file is “Ctrl+Shift+N” and rename the file accordingly.


How to install Ameba libraries on Arduino IDE?

Answer: Download libraries from ambiot · GitHub and follow the instruction at https://docs.arduino.cc/software/ide-v1/tutorials/installing-libraries to install.


Can I connect my circuit to my board before uploading sketches on Arduino IDE?

Answer: Yes.


AboutAmebaBoard

About Ameba development boards

What is the difference between upload and download modes?

Answer: They are the same, they burn the bin file into the Ameba development boards.


Where can I find the pin diagrams for Ameba development boards?

Answer: Navigate to the “Getting started” page for each Ameba development board to see the pin diagram via Ameba ARDUINO – Realtek IoT/Wi-Fi MCU Solutions.
[AMB21/22] Ameba ARDUINO: Getting Started with RTL8722 – Realtek IoT/Wi-Fi MCU Solutions
[AMB23] Ameba ARDUINO: Getting Started with RTL8722DM MINI​ – Realtek IoT/Wi-Fi MCU Solutions
[AMB01] Ameba ARDUINO: Getting Started with RTL8195 – Realtek IoT/Wi-Fi MCU Solutions
[BW16] Ameba ARDUINO: Getting Started with BW16/RTL8720DN – Realtek IoT/Wi-Fi MCU Solutions


What are A0, A1, A2, A3, A4, A5 and A6 and where can I find them on Ameba development boards?

Answer: A0, A1, A2, etc refers to the pins where ADC function is available. For example, on AMB23, connect to D1 to D7 for ADC function.


For other boards, please refer to their pin table respectively.
[AMB21/22] Ameba ARDUINO: Getting Started with RTL8722 – Realtek IoT/Wi-Fi MCU Solutions
[AMB23] Ameba ARDUINO: Getting Started with RTL8722DM MINI​ – Realtek IoT/Wi-Fi MCU Solutions
[AMB01] Ameba ARDUINO: Getting Started with RTL8195 – Realtek IoT/Wi-Fi MCU Solutions
[BW16] Ameba ARDUINO: Getting Started with BW16/RTL8720DN – Realtek IoT/Wi-Fi MCU Solutions


How do I know if my board successfully enters upload mode?

Answer: [AMB21/22, AMB23, BW16] First, open the Serial Monitor and enter download mode. If you have successfully enter download mode, you will see “#Flash Download Start” in the Serial Monitor.


Where to find the RX TX pin on Ameba development boards?

Answer: Please refer to the pin table respectively.
[AMB21/22] Ameba ARDUINO: Getting Started with RTL8722 – Realtek IoT/Wi-Fi MCU Solutions
[AMB23] Ameba ARDUINO: Getting Started with RTL8722DM MINI​ – Realtek IoT/Wi-Fi MCU Solutions
[AMB01] Ameba ARDUINO: Getting Started with RTL8195 – Realtek IoT/Wi-Fi MCU Solutions
[BW16] Ameba ARDUINO: Getting Started with BW16/RTL8720DN – Realtek IoT/Wi-Fi MCU Solutions


AMB21/22, AMB23

What is the main difference between AMB21/22 and AMB23?

Answer: They uses the same chip; however, the PCB are different in size and offer different number of pins and functions. For more information, please refer to Realtek IoT/Wi-Fi MCU Solutions.


Does AMB21/22 and AMB23 have user-configurable push buttons and LEDs?

Answer: AMB21/22 does not have any user-configurable push buttons and LEDs.
AMB23 has 1 user-configurable push buttons and 2 user-configurable LEDs.


During download mode, for AMB21/22, what is the function of the flashing green and red LEDs?

Answer: When the green LED flashes, it indicates that the board is waiting in download mode. When the red LED flashes, it indicates that the sketch’s code is being downloaded to the board.


AMB01

How do I use the NFC function on AMB01?

Answer: To use the NFC function on AMB01, you need to first weld the NFC antenna on the board. Please refer to one of the NFC examples for more information. Ameba Arduino: [RTL8195AM] NFC – Open a webpage on smartphone using NFC connection – Realtek IoT/Wi-Fi MCU Solutions .


BW16

Do I have to permanently connect D1 ––– D5 and D0 ––– D4 on BW16?

Answer: No. You only have to connect it if you wish to use the onboard USB port to upload sketches into BW16.


Why can't I enter upload mode even after following all of the steps?

image
Ensure that you have followed all the instructions to enter download mode. If issue still persist, please raise the question in forum https://forum.amebaiot.com/.


Does BW16 have user-configurable push buttons and LED?

Answer: BW16 has 1 user-configurable RGB LED.


Does BW16 support 5GHz Network?

Answer: Yes.


MicroPython

Ameba MicroPython

How can I avoid indentation errors while copying code from examples to Tera Term?

Answer: Please refer to https://ttssh2.osdn.jp/ for more information.


Common Errors

Common Errors

What should I do when I get "ERR: Cannot find ameba on mbed driver! Please replug Ameba." while using AMB01?


Answer:
Check that you have updated the DAP firmware. You can refer to How to update DAP Firmware? – Realtek IoT/Wi-Fi MCU Solutions to learn how to update DAP firmware.


What should I do when I am getting "failed to open COM port" error?

image

Answer:

  1. Check that you have correctly selected the board and COM port number on Arduino IDE.
  2. Check if it’s a hardware issue.
  3. If issue still persist, please raise the issue in the forum https://forum.amebaiot.com/.

I have an error when running Cygwin, "The program can't start because cygwin1.dll is missing from your computer. Try reinstalling the program to fix this problem.”.

Answer: Look for cygwin folder in C drive, then look for cygwin1.dll in the bin folder and add cygwin1.dll to “C:\windows” directory.


Why is there an error “RuntimeException: Error opening serial port COM3: port busy“ in processing software?

Answer: At any given time, only 1 Serial Monitor can access 1 particular COM port. There are two Serial Monitors trying to open the same COM port in the above example.


Ameba Arduino Examples

Ameba Arduino Examples

(Array) When connecting to D7, why didn't the LED light up on AMB21?

Answer: D7 is NC on AMB21. NC is “Not Connected”.


Given that the instructions are all for the Arduino boards, how do I know which pin on the Ameba board to connect to for all the basic examples?

Answer:
Answer: Refer to the respective link for each board.
[AMB23] Ameba ARDUINO: [RTL8722DM MINI] Supported ARDUINO built-in example list – Realtek IoT/Wi-Fi MCU Solutions
[AMB21/22] Ameba ARDUINO: [RTL8722CSM][RTL8722DM] Supported ARDUINO built-in example list – Realtek IoT/Wi-Fi MCU Solutions
[AMB01] Ameba ARDUINO: [RTL8195AM][RTL8710AF][RTL8711AM] Supported ARDUINO built-in example list – Realtek IoT/Wi-Fi MCU Solutions
[BW16] BW16 (RTL8720DN) Supported ARDUINO built-in example table – Realtek IoT/Wi-Fi MCU Solutions
If there are any changes to the pin number or code, it will be noted in the “Remarks”/“Comments” section.


For networking examples, does my SSID and password have to be the same as what my laptop/computer is connecting to?

Answer: It is suggested to connected to the same network as the laptop/computer.


What does D13 refer to?

Answer: D13 refers to Pin 13 on Ameba development board. You can refer to the pin diagram for each board under “Getting Started” via Ameba ARDUINO – Realtek IoT/Wi-Fi MCU Solutions.
image


How do I connect the LED to pin 13?

Answer: Follow the example in “Getting Started” via Ameba ARDUINO – Realtek IoT/Wi-Fi MCU Solutions.


(BLEBatteryServiceAfter) scanning, I could not find the device name in the BLE app. What should I do?

Answer: Make sure that your Bluetooth and Location Service are both turned on.


(Tensorflow Lite) Why can't I get my board compiled?

Answer: Do remember to install the patches from ambd_arduino/Ameba_misc at master · ambiot/ambd_arduino · GitHub and necessary Arduino library in Arduino IDE. Installation instructions can be found in the readme file.


(mDNS) I could not see the network port even after restarting the Arduino IDE. What should I do?

Answer: Same network should be used on your computer and development board.


Can I use other Arduino boards other than the mentioned Arduino Uno in examples?

Answer: Yes, however, the wiring connection will be different from using Arduino Uno. Suggest referring to the pin diagram of the Arduino board you will be using.


3 Likes