# 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 |