# Homey Sensors and Controls

**Common device capabilities exposed to Homey for Everything Presence Lite.**

| Capability | Type | What it shows |
|------------|------|---------------|
| alarm_motion | Alarm | Motion/presence state from the device. |
| onoff.esp32_led | Switch | Turn the board status LED on/off. |
| measure_luminance | Sensor | Light level (lux). |
| alarm_generic.zone1_occupancy | Alarm | Zone 1 occupancy (on when a target is inside Zone 1). |
| alarm_generic.zone2_occupancy | Alarm | Zone 2 occupancy. |
| alarm_generic.zone3_occupancy | Alarm | Zone 3 occupancy. |
| alarm_generic.zone4_occupancy | Alarm | Zone 4 occupancy. |
| measure_x.target1 | Sensor | Target 1 X position in millimetres (mm). |
| measure_y.target1 | Sensor | Target 1 Y position in millimetres (mm). |
| measure_distance.target1 | Sensor | Target 1 distance in millimetres (mm). |
| measure_angle.target1 | Sensor | Target 1 angle in degrees. |
| measure_speed.target1 | Sensor | Target 1 speed in mm/s. |
| measure_x.target2 | Sensor | Target 2 X position in millimetres (mm). |
| measure_y.target2 | Sensor | Target 2 Y position in millimetres (mm). |
| measure_distance.target2 | Sensor | Target 2 distance in millimetres (mm). |
| measure_angle.target2 | Sensor | Target 2 angle in degrees. |
| measure_speed.target2 | Sensor | Target 2 speed in mm/s. |
| measure_x.target3 | Sensor | Target 3 X position in millimetres (mm). |
| measure_y.target3 | Sensor | Target 3 Y position in millimetres (mm). |
| measure_distance.target3 | Sensor | Target 3 distance in millimetres (mm). |
| measure_angle.target3 | Sensor | Target 3 angle in degrees. |
| measure_speed.target3 | Sensor | Target 3 speed in mm/s. |


:::tip
* Zone occupancy depends on zones being configured on the device. Configure zones in Homey: open the EPL device > Settings > Zone 1-4 (set Begin/End X and Y in mm, and Off Delay as needed).
* Target positions (X/Y) and distance/angle/speed are optional advanced signals for custom Flows.

:::

## Zones and masks tips

* Coordinates and units (when looking at the device)
  * X: left (−) to right (+), Y: near (−) to far (+); values in millimetres (mm).
  * Start with a conservative rectangle, test, then expand.
* Overlap and order
  * Avoid overlapping zones to keep automations unambiguous.
  * Masks hide areas from occupancy; define masks first, then tune zones.
* Off delays
  * Use per‑zone Off Delay to keep a zone occupied briefly after movement stops.
* Enable additional zones
  * Zones 2–4 are available in Settings; set Begin/End X/Y and Off Delay for each.

 ![PLACEHOLDER  EPL zones and masks guide](../../../_assets/TODO/epl-zones-masks-guide.png)

## Advanced settings (device settings)

These controls appear under the EPL device → Settings in Homey.

| Setting (label) | ID  | Units | What it does |
|-----------------|-----|------:|--------------|
| Occupancy Off Delay (s) | epl_off_delay | s     | How long Occupancy stays on after no motion. |
| Maximum Detection Distance (cm) | epl_distance | cm    | Maximum detection range for presence. |
| Installation Angle (deg) | epl_installation_angle | deg   | Adjusts the sensor’s orientation virtually to match how it’s mounted. |
| Illuminance Offset (lx) | illuminance_offset | lx    | Fine-tune reported light level. |
| Zone 1 Begin/End X (mm) | zone1_begin_x / zone1_end_x | mm    | Left/right edges of Zone 1. |
| Zone 1 Begin/End Y (mm) | zone1_begin_y / zone1_end_y | mm    | Near/far edges of Zone 1. |
| Zone 1 Off Delay (s) | epl_zone1_off_delay | s     | How long Zone 1 stays on after no targets. |
| Zone 2 Begin/End X (mm) | zone2_begin_x / zone2_end_x | mm    | Left/right edges of Zone 2. |
| Zone 2 Begin/End Y (mm) | zone2_begin_y / zone2_end_y | mm    | Near/far edges of Zone 2. |
| Zone 2 Off Delay (s) | epl_zone2_off_delay | s     | How long Zone 2 stays on after no targets. |
| Zone 3 Begin/End X (mm) | zone3_begin_x / zone3_end_x | mm    | Left/right edges of Zone 3. |
| Zone 3 Begin/End Y (mm) | zone3_begin_y / zone3_end_y | mm    | Near/far edges of Zone 3. |
| Zone 3 Off Delay (s) | epl_zone3_off_delay | s     | How long Zone 3 stays on after no targets. |
| Zone 4 Begin/End X (mm) | zone4_begin_x / zone4_end_x | mm    | Left/right edges of Zone 4. |
| Zone 4 Begin/End Y (mm) | zone4_begin_y / zone4_end_y | mm    | Near/far edges of Zone 4. |
| Zone 4 Off Delay (s) | epl_zone4_off_delay | s     | How long Zone 4 stays on after no targets. |
| Mask 1 Begin/End X/Y (mm) | occupancy_mask_1_begin_x / _end_x / _begin_y / _end_y | mm    | Area to ignore for occupancy (mask 1). |
| Mask 2 Begin/End X/Y (mm) | occupancy_mask_2_begin_x / _end_x / _begin_y / _end_y | mm    | Area to ignore for occupancy (mask 2). |
| Stale Target Reset Timeout (s) | stale_target_reset_timeout | s     | Time before a “stuck” target is cleared. |
| Inverse Mounting (Upside-down) | inverse_mounting | On/Off | Flip orientation if installed upside down. |
| Aggressive Target Clearing | stale_target_reset | On/Off | Enable faster clearing of stuck targets. |
| mmWave Bluetooth | bluetooth_switch | On/Off | Toggle mmWave Bluetooth (for maintenance). |

---

**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)