T-Display-K230

Bring-up work for the LILYGO T-Display-K230 — a Kendryte K230D (dual RISC-V C908 + KPU NPU) board with a 4.1" 568x1232 AMOLED, GT9895 touch, RTL8189FTV Wi-Fi, and an SX1262/LR2021 LoRa radio.

Current goal: a usable NixOS touchscreen handheld with a Sway shell, on-screen keyboard, installed-app launcher, persistent Wi-Fi, and reproducible video playback. AtomVM and the Dozer core are later work.

See work status and next steps and the contribution and landing workflow.

Shell demonstrations

The feature gallery and evidence index contain native screen clips, screenshots, and FFmpeg camera recordings for ten shell workflows. They distinguish injected touch events, IPC launches, and recorded physical interaction. Accepted keyboard and Home checks are recorded with their evidence; newly added interactions need their own proof. The handheld site publishes short device-focused demonstrations.

Connecting to the board

The board has two USB-C ports. The one that also charges (J2 on the schematic) carries a CH342 dual USB-UART bridge, giving two CDC-ACM consoles. No driver is needed — the in-kernel cdc-acm handles it.

115200 8N1, no flow control. Enumerates as 1a86:55d2 “USB Dual_Serial”.

Use a known-good USB-C data cable. A charge-only cable produces complete silence (no kernel events at all); a marginal one produces error -71 enumeration failures. Both look identical from the board’s side — the red charge LED lights either way.

Tools

./tools/console.py /dev/ttyACM0 --wait=3 "uname -a"

Camera evidence clips

Record one feature at a time from the host camera. The default is a 15-second raw-orientation H.264 MP4 suitable for the site; a JSON manifest next to it records the camera, timestamp, operator-declared touch provenance, description, and exact FFmpeg command. That metadata does not prove a real touch happened.

./tools/capture-feature.py keyboard-show --provenance real-touch \