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