Vibe documents

DEBUG.md

@@ -0,0 +1,40 @@
+# Debug Commands
+
+Development/test commands exposed via the Zephyr shell. Not intended for end users.
+
+### `debug mode` — Mode thread control
+
+| Command | Description |
+|---|---|
+| `debug mode start` | Start the mode thread |
+| `debug mode stop` | Stop the mode thread |
+| `debug mode restart` | Stop then start the mode thread |
+
+### `debug led` — PWM bar
+
+| Command | Args | Description |
+|---|---|---|
+| `debug led fade` | `<ms>` | Fade the PWM bar over `ms` milliseconds |
+| `debug led progress` | `<0-100>` | Set PWM bar to a percentage |
+
+### `debug leds` — Addressable LED strip
+
+| Command | Args | Description |
+|---|---|---|
+| `debug leds all` | `<r> <g> <b>` | Set all LEDs to an RGB value (0–255) |
+| `debug leds clear` | — | Clear all LEDs |
+| `debug leds fade` | `<ms> <r> <g> <b>` | Fade in/out to color over `ms` ms (0–255) |
+| `debug leds fade_to` | `<ms> <r> <g> <b>` | Fade to color over `ms` ms; pass `-1` to keep a channel unchanged |
+| `debug leds color` | `<name>` | Set strip to a named color (e.g. `yellow`) |
+
+### `debug imu` — IMU
+
+| Command | Description |
+|---|---|
+| `debug imu read` | Read and print raw accelerometer X/Y/Z axes |
+
+### `debug light` — Ambient light sensor
+
+| Command | Description |
+|---|---|
+| `debug light read` | Read and print the ambient light sensor value |