# RGB Button Guide

The button on the DAQ-A contains a color-changing RGB LED inside it to show the user the current system state. The LED is daylight-readable from afar and can be adjusted for brightness.

## Button Click Modes

| Button Mode            | Action                   |
| ---------------------- | ------------------------ |
| Short Press            | Start/Stop Image Capture |
| Long Press (5 seconds) | Start/Stop Data Logging  |

{% hint style="success" %}
Press the button for 5 or more seconds to perform the long press
{% endhint %}

## RGB LED Modes

The DAQ-A features a comprehensive LED status system that provides visual feedback for both system state and GPS readiness.

### System Status LEDs

| LED Color                                                         | Mode       | Status                                                                        |
| ----------------------------------------------------------------- | ---------- | ----------------------------------------------------------------------------- |
| ⚫**BLACK (OFF)**                                                  | Solid      | <ul><li>No Power</li><li>System Booting</li></ul>                             |
| 🔴<mark style="background-color:red;">**RED**</mark>              | Solid      | <ul><li>System Starting</li><li>Data Logging OFF</li></ul>                    |
| 🟢<mark style="background-color:green;">**GREEN**</mark>          | Solid      | <ul><li>Data Logging ON</li><li>Image Capture OFF</li><li>GPS Ready</li></ul> |
| 🟢<mark style="background-color:green;">**GREEN**</mark>          | Fade/Pulse | <ul><li>Data Logging ON</li><li>Image Capture ON</li></ul>                    |
| 🟣<mark style="background-color:purple;">**PURPLE/INDIGO**</mark> | Flash      | <ul><li>Trigger Pulse (momentary flash during image capture)</li></ul>        |
| 🔵<mark style="background-color:blue;">**BLUE**</mark>            | Flashing   | <ul><li>Firmware Updating</li></ul>                                           |

### GPS Readiness Status LEDs (NEW in v1.03)

The v1.03 firmware introduces GPS readiness checking with intuitive color progression from searching to ready:

| LED Color                                                  | Pattern                  | GPS Status | Description                                |
| ---------------------------------------------------------- | ------------------------ | ---------- | ------------------------------------------ |
| 🟠<mark style="background-color:orange;">**ORANGE**</mark> | Slow Flash (1s on/off)   | Searching  | Searching for GPS signal                   |
| 🟡<mark style="background-color:yellow;">**YELLOW**</mark> | Fast Flash (0.3s on/off) | Acquiring  | Getting GPS lock (partial signal)          |
| 🟢<mark style="background-color:green;">**GREEN**</mark>   | Solid                    | Ready      | GPS locked and ready for capture           |
| ⚪**WHITE/PINK**                                            | Fast Flash (0.3s on/off) | Error      | GPS error or malfunction                   |
| 🔴**ORANGE-RED**                                           | Fast Flash (0.3s on/off) | Timeout    | GPS readiness timeout (exceeded wait time) |

### Typical GPS Startup Sequence

When powering on the DAQ-A, you will see this LED progression as the GPS acquires a signal:

```
🔴 RED (solid) → 🟠 ORANGE (slow flash) → 🟡 YELLOW (fast flash) → 🟢 GREEN (solid)
System Boot     → GPS Searching        → GPS Acquiring          → Ready for Capture
```

### During Capture Session

Once capture begins, the LED will pulse and flash to indicate activity:

```
🟢 GREEN (solid) → 🟢 GREEN (pulsing) → 🟣 PURPLE (flash) → 🟢 GREEN (pulsing)
Ready            → PWM Active         → Trigger Pulse    → PWM Active
```

## Dimming or Turning OFF the Button LED

Most of the time you will probably not need to adjust the LED brightness. For the times you do need to dim the LED or turn it off you just need to edit the "led\_brightness" parameter.

```
"led_brightness": 10
```

To turn the LED off, edit parameter "led\_brightness" to a value of 0.

The brightness value range is 1-10, with 1 being the dimmest and 10 the brightest.

When the image capture sequence is on, the LED will fade between the max brightness set by the "led\_brightness" parameter and a value of 1 (lowest but not off). For example, if "led\_brightness" is set to 10 (default), it will fade between 10 and 1 (10-1-10-1...).