Setup Guide

Hardware Requirements

AmebaD BW16 (RTL8720DN) board
0.96-inch OLED display (128x64, SSD1306, I2C address 0x3C)
Three push buttons (UP: PA12, DOWN: PA27, OK: PA13)
RGB LED (blue channel: PA14)
USB cable for programming

Software Setup

Install Arduino IDE: Download and install the latest version from arduino.cc.
Add AmebaD Board: In Arduino IDE, go to File > Preferences, add the Realtek AmebaD board URL: https://github.com/ambiot/ambd_micropython/raw/main/Arduino/package_realtek.com_amebad_index.json. Then, in Tools > Board > Boards Manager, install AmebaD by Realtek (version 3.1.8).
Install Libraries: In Sketch > Include Library > Manage Libraries, install:
- Adafruit_GFX
- Adafruit_SSD1306
This fixes bugs that make Adafruit SSD1306 library incompatible with BW16 board, Go to RTL8720DN_SSD1306_FIX folder. You need to first backup any files that will be replaced, and then add this into your Arduino/libraries folder.

Place AmebaD WiFi libraries (wifi_conf.h, wifi_cust_tx.h, wifi_util.h, wifi_structures.h) in your project folder or library path.

Configure Board: Select Ameba RTL8720DN (BW16) in Tools > Board. Set port to your BW16’s USB port.

Upload Code

Copy the project code into Arduino IDE, save as oled_deauther.ino, and click Upload. Monitor progress in the Serial Monitor (115200 baud).

Troubleshooting

If the OLED is blank, verify I2C wiring and address (0x3C). For compilation errors, ensure libraries are installed and board package is up-to-date. The SPI_MODE0 warning is harmless but can be suppressed by commenting out #define SPI_MODE0 in Adafruit_SPIDevice.h.