Home Assistant Entities
Home Assistant Entities
After adding the Everything Presence Lite to Home Assistant, you may wonder which sensors you can use and what they do. Below is a list of the available sensors and controls, along with an explanation of how to configure them.
Viewing Entities in Home Assistant
In the Home Assistant UI, head to Settings > Devices and Services > ESPHome > Everything-Presence-Lite-xxxxxx.
Select your Everything Presence Lite device.
A dashboard will appear, listing all sensors and controls available for automations, similar to this:
The entities are located in 3 different sections, Controls, Sensors and Configuration.
Illuminance (Sensor)
The Everything Presence Lite has an on-board light sensor that measures illuminance in lux. Small slots on the top of the Lite case allow light to pass through. Make sure these aren’t obstructed for the most accurate readings.
Adjusting the Illuminance Offset (Configuration)
You can apply a calibration offset in the Home Assistant UI. Look for a control labelled Illuminance Offset under the device’s configuration section. This lets you raise or lower the reported illuminance value if you find it differs from a known, accurate reference.
Occupancy (Sensor)
You’ll find a sensor named Occupancy that indicates if motion/presence is detected anywhere within the sensor’s field of view. By default, the sensor will wait 15 seconds (the “blind time”) after detecting motion before resetting to an “Off” or “clear” state if no additional motion is detected.
Adjusting the Occupancy Off Delay (Control)
If you need to change how long the sensor remains “occupied” after detecting movement, you can do so via the Occupancy Off Delay control in the Home Assistant UI. The default is 15 seconds, but you can increase it (e.g., to 60–120 seconds) if you find it clears too quickly when you’re still in the room.
We do not recommend going lower than 15s on the off delay.
Distance (Control)
The Everything Presence Lite has a Distance slider in Home Assistant for adjusting the maximum detection range (up to 6m). This should be set to an appropriate size for your room and should not be larger than your room is otherwise it can cause detection in neighbouring rooms.
Note that 6m is the theoretical maximum range and might not catch the smallest of movements at that distance. Placement remains key for best results—consult How to Tune Your EPL Sensor for more information.
Ensure this value is set to the size of the room its in for accurate detection.
Installation Angle
For cases where the Lite cannot be installed parallel to a wall, you can set the Installation Angle parameter. This allows you to virtually reposition the sensor’s orientation so that its detection zones align more naturally with your room layout and is particularly important when Creating Zones
It’s a little tricky to understand this parameter without looking at the Everything Presence Zone Configurator, so recommend playing with this parameter while visually looking at the Zone Configurator for a greater explanation.
Zones (Control)
The Everything Presence Lite supports up to four zones, letting you define specific areas in a room. When a target (like a person) enters a defined zone, the sensor recognizes this and displays in the Zone sensors. Each zone is configured via four entities:
Zone X Begin
Zone Y Begin
Zone X End
Zone Y End
These controls are not intended to be set by hand, use the Everything Presence Zone Configurator to set these visually. See Creating Zones
Zones (Sensor)
These sensors consist of two entities:
Zone Occupancy
Zone Target Count
Zone Occupancy is a binary sensor that simply tells you if any target is present inside of the zone or not. Useful for automations.
Zone Target Count is a sensor that tells you how many targets are detected at present inside of the zone.
Enabling Additional Zones
Zone 1 is enabled by default. To enable Zones 2, 3, or 4:
Click Show disabled entities under the device.
Locate and select the zone entities.
Click the Settings icon in the top-right corner of the entity popup.
Enable the entity.
Wait 30 seconds and refresh the page. The zone entity will appear enabled.
For a visual method of zone setup, refer to Creating Zones
Targets (Sensor)
The sensor can track up to 3 targets in its field of view. A target is a source of movement, typically a person. Each target has properties such as:
X and Y coordinates (used to check if a target enters a zone)
Distance from the sensor
Angle relative to the sensor
Speed (movement speed)
Active or inactive status
Tracking Behaviour (Configuration)
By default, the Everything Presence Lite can be quite a chatty sensor since it has so many sensors and controls, and because of frequently it reports to be fast enough for automations. If you have multiple units, this can generate quite a lot of logging in Home Assistant.
The Tracking Behaviour option allows you to control which sensors will report and which won’t, in order to optimise the amount of traffic, since not all sensors may be useful to you, depending on your needs.
The dropdown consists of 6 options:
None - Disable all target tracking reporting. This will effectively leave you with just the main occupancy sensor working.
Targets Position - Enables X and Y coordinates for targets only. Required for zones to function.
Above + Zone Count - Enables the previous option, plus adds the zone count sensors.
Above + Targets Active - Enables the previous option, plus adds the target active binary sensor.
Above + Distance and Angle - Enables the previous option, plus adds distance and angle target sensors.
Above + Speed and Resolution - Enables the previous option, plus adds the speed and resolution target sensors.
The default option is Above + Speed and Resolution for compatibility.
Update Speed (Configuration)
Similar to the Tracking Behaviour option, this option allows you to slow down (or speed up) the mmwave sensors reporting period. This can be useful if you want to reduce the amount of logging at the cost of some speed, or increase the speed at the cost of logging.
The default is 0.3s which we find works well.
Extra Entities Update (Configuration)
Similarly to the Tracking Behaviour option, this option allows you to limit the update frequency for the tracking entities. Increasing the update frequency without removing or limiting the number of updates may result in worse performance than simply using a lower update frequency.
This can result in seemingly out of sync values, for example, an occupied zone reporting a target count of zero for a few updates. Test and use with caution.
The default behaviour is Every update.
Stale Target Reset (Configuration)
In some environments, the sensor may hold onto a detected target for too long (e.g., 30 seconds to a few minutes) if the target leaves through a blind spot. If that happens:
Enable the Stale Target Reset switch.
Adjust the Stale Target Timeout slider to define how long the sensor waits before it decides a target is stale and clears it.
Use this feature carefully. If enabled incorrectly, it could clear targets that are still present.
Inverse Mounting (Configuration)
This option should be used when the Everything Presence Lite is mounted upside down and the USB-C cable is pointed up.
Using this option will ensure that the tracking is the right way around in the Everything Presence Zone Configurator.
Only use this option when the USB-C cable is pointing up instead of the normal downwards position.
Turning Off LEDs (Control)
The Lite has an onboard LED you can toggle in Home Assistant. Look for the LED entity or switch under the device configuration. Turning this off helps reduce light pollution if the device is in a dark room.
mmWave Bluetooth (Configuration)
This setting enables or disables the bluetooth on the LD2450 sensor. Only useful for performing updates, keep disabled otherwise.
This is a hidden entity in Home Assistant
Factory Reset mmWave Sensor (Configuration)
This button allows you to factory reset the mmWave sensor directly, only useful if experiencing issues with tracking.
This is a hidden entity in Home Assistant
That covers all major sensors and entities the Everything Presence Lite exposes to Home Assistant. Use these in your automations to fine-tune motion detection, lighting, and more.