# LED Modes & Customization

# LED Modes & Customization

The Everything Presence Pro features an RGB LED that can indicate presence status, environmental conditions, or be controlled manually for custom automations.

## LED Modes

The Pro supports four LED modes, controlled via the **LED Mode** select entity in Home Assistant.

 ![](https://docs.everythingsmart.io/api/files.get?sig=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJrZXkiOiJ1cGxvYWRzL2U1MTYzNjNkLThhMWItNDI0Zi1hOTk5LTI0ZDFmMDUxZDNhZi9kZjZmM2RlZS1mYWMwLTQ2YTgtYTc3Zi1hZjMzZjNjMzE2Y2YvaW1hZ2UucG5nIiwidHlwZSI6ImF0dGFjaG1lbnQiLCJpYXQiOjE3OTM2ODExMDAsImV4cCI6MTc5Mzc2NzUwMH0.2bDgIP11BEWPy5hekeQsVMc4SGTV4N5p7KQliwY4Q-U " =504x429")

### Manual Control Mode

The LED only responds to direct control via the **LED** light entity. Use this for:

* Custom automations
* Turning the LED off completely
* Static colour indicators

### Presence Mode

The LED automatically indicates presence status:

| State | Colour |
|-------|--------|
| Room occupied | Purple/Magenta (soft glow) |
| Room empty | Off    |

### Environmental Mode

The LED displays air quality based on CO2 levels (requires CO2 module):

| CO2 Level | Colour | Effect |
|-----------|--------|--------|
| < 800 ppm | Green  | Steady glow (good) |
| 800-1200 ppm | Yellow | Slow pulse (moderate) |
| > 1200 ppm | Red    | Fast pulse (poor) |

Without a CO2 module installed, this mode has no effect.

### Environmental + Presence Mode

Combines both modes:

* Shows environmental colour when occupied
* Turns off when room is empty


---

## Controlling the LED

### Manual Control

When in Manual Control mode, control the LED via the **LED** light entity:

* Set any RGB colour
* Adjust brightness
* Turn on/off

```yaml
# Example: Turn LED blue
service: light.turn_on
target:
  entity_id: light.pro_led
data:
  rgb_color: [0, 0, 255]
  brightness: 128
```

### Brightness Adjustment

The **LED Brightness** number entity (0.1 to 1.0) acts as a multiplier for automatic modes:

* Higher values = brighter automatic colours
* Set to minimum (0.1) to dim the LED in automatic modes
* Does not affect manual mode brightness


---

## Common Use Cases

### Turn LED Off Completely


1. Set **LED Mode** to "Manual Control"
2. Turn off the **LED** light entity

Or use this automation:

```yaml
service: select.select_option
target:
  entity_id: select.pro_led_mode
data:
  option: "Manual Control"

service: light.turn_off
target:
  entity_id: light.pro_led
```

### Visual Doorbell/Alert

Flash the LED when someone rings the doorbell:

```yaml
automation:
  trigger:
    - platform: state
      entity_id: binary_sensor.doorbell
      to: "on"
  action:
    - repeat:
        count: 5
        sequence:
          - service: light.turn_on
            target:
              entity_id: light.pro_led
            data:
              rgb_color: [255, 165, 0]
              brightness: 255
          - delay:
              milliseconds: 200
          - service: light.turn_off
            target:
              entity_id: light.pro_led
          - delay:
              milliseconds: 200
```

### Room Status Indicator

Use different colors for different states:

```yaml
automation:
  trigger:
    - platform: state
      entity_id: binary_sensor.pro_occupancy
  action:
    - choose:
        - conditions:
            - condition: state
              entity_id: binary_sensor.pro_occupancy
              state: "on"
          sequence:
            - service: light.turn_on
              target:
                entity_id: light.pro_led
              data:
                rgb_color: [0, 255, 0]
        - conditions:
            - condition: state
              entity_id: binary_sensor.pro_occupancy
              state: "off"
          sequence:
            - service: light.turn_on
              target:
                entity_id: light.pro_led
              data:
                rgb_color: [255, 0, 0]
```


---

## LED Behaviour Reference

### During Boot

The LED shows a cyan colour briefly during device start-up while connecting to Home Assistant.


---

## Troubleshooting

### LED Not Responding


1. Check the **LED Mode** is set to "Manual Control" for direct control
2. Verify the entity is available in Home Assistant
3. Try restarting the device

### Automatic Colours Not Showing


1. Ensure **LED Mode** is set to an automatic mode
2. Check **LED Brightness** is not set to minimum
3. For Environmental mode, verify CO2 module is installed and working

### LED Too Bright/Dim

Adjust the **LED Brightness** entity (0.1 to 1.0) to set the intensity for automatic modes.

---

**Documents**

- [EP1 vs EPL: Which Sensor is Right for You?](https://docs.everythingsmart.io/s/products/doc/ep1-vs-epl-which-sensor-is-right-for-you-5B3RxiY3Kp)
- [Everything Presence One (EP1)](https://docs.everythingsmart.io/s/products/doc/everything-presence-one-ep1-3R178yZSUP)
- [Everything Presence Pro](https://docs.everythingsmart.io/s/products/doc/everything-presence-pro-nh3fIXmow9)
- [Everything Presence Lite (EPL)](https://docs.everythingsmart.io/s/products/doc/everything-presence-lite-epl-ZVnBzYzuX2)
- [Zone Configurator](https://docs.everythingsmart.io/s/products/doc/zone-configurator-93b9scGsa2)
- [Knowledge Base Articles](https://docs.everythingsmart.io/s/products/doc/knowledge-base-articles-KnRRmk4zvt)