ts3-quecpython

QuecPython device layer for the TS3-RTOS client on handheld PoC radios. The portable client core is a separate repo: https://github.com/cipheraenys/ts3-core

One folder per device under devices/. Every device implements the same small surface, so app code can stay device-agnostic.

Device contract

Each devices/<name>/ provides three modules with this surface:

display.py

• init() — power the panel, return the driver
• clear(color) — fill the screen (RGB565)
• lvgl_attach() — register as an LVGL display, return the active screen

sound.py

• say(text, volume=...) — on-chip TTS, returns 0 on success
• play_wav(path) — play a WAV through the speaker
• record(path, seconds) — record the mic to a WAV

keypad.py

• read() — raw key / PTT reading
• ptt_pressed() — True while PTT is held

Board-specific values are constants at the top of each module; a different LCD controller also needs a different driver.

Module names must not shadow a QuecPython built-in: audio is one, so the speaker/TTS module is named sound. A file named audio.py on the path never loads — the built-in wins.

Devices

• devices/bq280/ — BQ280 handheld (EC600M / ASR1606). Hardware map in its README.

Firmware

• firmware/ec600m/ — QuecPython for the EC600M built from the public HeliosSDK, so C modules can be added. Runs on the BQ280; the devices/bq280 drivers work on it.

Tools

• tools/upload.py — copy files to the device over the REPL, e.g. python tools/upload.py COM16 devices/bq280/display.py=/usr/display.py (in Git Bash, set MSYS_NO_PATHCONV=1 so /usr/... is not rewritten to a Windows path).

Add a device

Copy devices/bq280/ to devices/<name>/, keep the module surface, retune the constants for your board, and run each module's demo() on the device to confirm.