TPOD — Capture It Before You Forget It

TPOD is a wearable voice-first task device built around the M5Stack M5StampS3 BAT. Pull it from a key reel, press a physical button, speak, confirm the task on its round display, and let it return to your belt or bag.

Pull. Speak. Confirm. Return.

The project reduces the time and attention required to capture a thought. It is an assistive productivity tool, not a medical device and not a diagnostic or treatment product for ADHD.

日本語の概要 · Hackster draft · BLE protocol

Repository Contents

• firmware/ — PlatformIO firmware for M5StampS3 BAT, GC9A01 display, PDM microphone, physical buttons, BLE task sync, and battery telemetry.
• mobile/tpod_flutter/ — Android Flutter app with English/Japanese UI, offline English/Japanese speech recognition, local task parsing, BLE sync, calendar, and widget support.
• hardware/electronics/ — KiCad PCB layout, JLCPCB Gerbers, BOM, CPL, readable circuit documentation, and manufacturing notes.
• docs/ — architecture, assembly, safety, manufacturing, and Hackster copy.

Hardware Revision Warning

The included JLCPCB package is the adjusted Rev.B manufacturing snapshot. The physical board data and the active firmware pin configuration were produced at different points in development. Do not order boards until you compare the PCB nets against the selected PlatformIO environment and the actual assembled prototype.

See hardware/electronics/REVISION-NOTICE.md.

Android App

Requirements:

• Flutter compatible with Dart ^3.11.1
• Android SDK and Java 17
• An arm64 Android device running Android 8.0/API 26 or later

The speech model is intentionally not committed. Install it from the upstream sherpa-onnx release, then build:

cd mobile/tpod_flutter
./tool/install_sensevoice_model.sh
flutter pub get
flutter analyze
flutter test
flutter build apk --debug

Use the 日 / EN control in the header to switch languages. The selection is saved on Android and changes UI copy, the SenseVoice recognition language, local parsing, and the BLE display language suffix (write:ja or write:en).

The public release uses deterministic local parsing. The experimental third-party LLM AAR from the development workspace is deliberately excluded.

Firmware

cd firmware
python3 -m pip install -r requirements.txt
platformio run -e m5stack-stamps3-bat-ble-adpcm-mic

The contest/demo environment uses M5StampS3 BAT as the main controller for the display, buttons, microphone audio transport, BLE communication, UI state, and battery operation.

PCB Manufacturing Data

The exact files supplied for JLCPCB are under:

hardware/electronics/fabrication/jlcpcb/
hardware/electronics/bom/bom_jlc.csv
hardware/electronics/assembly/pick-and-place/cpl_jlc.csv
hardware/electronics/pcb/

The original upload ZIP is retained together with extracted Gerber/drill files. Verify orientation, footprints, substitutions, connector pin order, and pin mapping before purchase.

Licenses

• Software and firmware: MIT
• Hardware design: CERN-OHL-P-2.0
• Documentation: CC BY 4.0
• Third-party models and native libraries: their respective upstream licenses

See LICENSES/README.md and NOTICE.