T-Bao Quick Start
Required Tools
| Tool | Source |
|---|---|
| kflash_gui | GitHub |
| MaixPy IDE | GitHub |
| Arduino IDE | arduino.cc |
K210 Side (AI / Camera)
- Download MaixPy firmware from the MaixPy releases page
- Flash MaixPy to the K210 using kflash_gui (select the correct COM port and baud rate)
- Open MaixPy IDE, connect to the board, and run Python scripts for camera / face recognition / YOLOv3 tasks
ESP32 Side (Wi-Fi / BLE)
Board Settings
| Setting | Value |
|---|---|
| Board | ESP32 Dev Module |
| Upload Speed | 921600 |
| Flash Mode | QIO |
| Flash Size | 16MB (128Mb) |
| Partition Scheme | 16M Flash (3MB APP/9.9MB FATFS) |
| PSRAM | Enabled |
Steps
- Clone the repository:bash
git clone https://github.com/Xinyuan-LilyGO/LilyGo-K210-Script.git - Open an example sketch in Arduino IDE
- Select the board settings above and click Upload
Peripheral Examples
K210 — Camera + Face Detection (MaixPy)
python
# Run on K210 via MaixPy IDE
import sensor, image, lcd, KPU
lcd.init()
sensor.reset()
sensor.set_pixformat(sensor.RGB565)
sensor.set_framesize(sensor.QVGA)
sensor.run(1)
task = KPU.load(0x300000) # load face detection model from flash
KPU.init_yolo2(task, 0.5, 0.3, 5, [(1.889, 2.5245), (2.9465, 3.94056)])
while True:
img = sensor.snapshot()
code = KPU.run_yolo2(task, img)
if code:
for i in code:
img.draw_rectangle(i.rect())
lcd.display(img)K210 — Display (MaixPy)
T-Bao's 1.54-inch ST7789V display is connected to the K210 side. Use MaixPy's lcd module to draw images or text. ESP32 does not drive this display directly.
python
# Run on K210 via MaixPy IDE
import lcd
import image
lcd.init()
img = image.Image(size=(240, 240))
img.clear()
img.draw_string(48, 108, "T-Bao Ready", color=(255, 255, 255), scale=2)
lcd.display(img)ESP32 — UART Bridge to K210
cpp
// K210 communicates with ESP32 via UART: RX=3, TX=1
HardwareSerial k210(2);
void setup() {
Serial.begin(115200);
k210.begin(115200, SERIAL_8N1, 3, 1);
}
void loop() {
if (k210.available()) {
String msg = k210.readStringUntil('\n');
Serial.println("K210: " + msg);
}
}Notes
- Dual-chip: K210 (RISC-V, AI) communicates with ESP32 (Wi-Fi/BLE) via UART
- Camera: OV2640 2 MP with 180° rotation support
- Display: ST7789V display is driven by K210; ESP32 does not connect to the display directly
- K210 AI: ~0.5 TOPS KPU — capable of YOLOv3, face recognition, and image classification
- PMU: AXP202 power management — controls power rails for both chips
- IMU: MPU6050 6-axis (I²C)
FAQ
Q: K210 not detected by kflash_gui? A: Select the correct COM port and set baud rate to 115200 or 1500000. Ensure the board is in download mode (hold BOOT while connecting).
Q: ESP32 side not uploading? A: Confirm you are connecting to the ESP32 USB port (not the K210 port) and have selected ESP32 Dev Module.
