Uno-QClaw

Opinionated app components building on top of ./ui primitives

Arduino App Lab — the unified editor for the Uno Q that builds and runs projects on both the MPU and MCU at once. Read this when the user asks about App Lab, Bricks, Apps, deploying a project, "Run" button workflow, or how Python+sketch projects are structured. QClaw itself is a QClaw-customized alternative entry point, but understanding App Lab is essential context.

Wi-Fi and Bluetooth on the Uno Q — the WCN3980 module exposes dual-band Wi-Fi 5 (802.11a/b/g/n/ac) and Bluetooth 5.1 to the Linux MPU side. Read this BEFORE writing any project that says "connect to Wi-Fi", "send over the network", "HTTP request", "Bluetooth", or "send my sensor data to my phone". The wireless module is owned by Linux — sketches reach the network via Bridge.

Audio capture and playback on the Uno Q — the QRB2210 exposes analog Mic2 (INP/INM/BIAS), Headphone L/R + REF, LineOut P/M, Earpiece P/R, and HS_DET (headset detect) through the JMISC header. All audio runs through Linux ALSA on the MPU side. Read this BEFORE writing any project that records audio, plays sound, does voice recognition, or makes the board talk.

Arduino Bridge — software RPC layer that connects Python on the MPU (Linux side) with Arduino sketches on the MCU (STM32U585). Read this BEFORE writing any project that combines a Python program with an Arduino sketch, or that asks "how do I send data from my sketch to the Linux side?". The Uno Q is two processors on one board; Bridge is how they talk.

Arduino Uno Q built-in 12x8 LED matrix — scroll text, draw frames, play animations using Arduino_LED_Matrix + ArduinoGraphics libraries (bundled with arduino:zephyr core). Read this before writing any sketch that mentions the LED matrix, scrolling text, or drawing pixels.

Linux sysfs LED control — drive the Uno Q's MPU-side RGB LEDs (RGB LED 1 and RGB LED 2) from Python with no sketch involvement. Read this when the user wants to blink or color a board LED using only Python on the Linux side, or asks about the SoC LEDs / panic LED / WLAN LED / Bluetooth LED. The MCU-side RGB LEDs (LED 3 and LED 4) use a sketch instead — see `sketch-patterns/SKILL.md`.

Arduino Modulino nodes — plug-and-play I²C sensors and actuators that connect to the Qwiic connector on the Uno Q. Read this when the user mentions a Modulino by name (Buzzer, Distance, Knob, Movement, Pixels, Thermo, Touch) or says "I have a Qwiic-connected sensor". Each Modulino has a known I²C address and a published Arduino library.

Canonical Arduino sketch templates for Uno Q — scaffold, breathing/fading LED (analogWrite for-loops), blink, button with INPUT_PULLUP, potentiometer analogRead, Servo sweep. Read this before writing any .ino sketch.

Arduino Uno Q board pinout and voltage rules — JDIGITAL/JANALOG/Qwiic/JSPI pin tables, PWM pins, 3.3V ADC limits, MPU vs MCU split. Read this before answering any question that names a pin (D0–D21, A0–A5) or voltage.

Computer vision on the Uno Q — the QRB2210 has dual ISPs (up to 25 MP at 30 fps), a 4-lane MIPI-CSI-2 camera interface on JMEDIA, and an Adreno 702 GPU with hardware H.264/H.265/VP9 codecs. Read this BEFORE writing any project that captures camera frames, runs OpenCV, decodes video, or uses GStreamer. All vision processing happens in Python on the Linux MPU side — the MCU has no camera.