DOCSEARCHbyAlgolia
Submit Docs

Everything Presence Lite

repository·main·Indexed 43 days ago

https://github.com/everythingsmarthome/everything-presence-lite

A hardware presence sensor featuring mmWave technology and an illuminance sensor, designed for seamless integration with Home Assistant via ESPHome. The device supports various mmWave sensors including HiLink LD2450, LD2410C, and DFRobot SEN0395, and includes a dedicated Zone Configurator for visual mapping of presence zones.

Tokens
5.4K
Snippets
3
Records
38
Agent score
54%

What's inside Everything Presence Lite

  3. Identify Everything Presence Lite Board components

    main

    The Everything Presence Lite (EPL) board is the main PCB containing the ESP32 microcontroller for Wi-Fi connectivity and sensor management. If you purchased the board only, you must provide a compatible mmWave sensor.

    Key components labeled on the board include:

    • ESP32-WROOM-32E: 4MB flash version (the device controller).
    • BH1750: Light Illuminance sensor.
    • mmWave Sensor Header Slots: Dedicated slots for DFRobot SEN0395, HiLink LD2450, HiLink LD2410C, and various Seeed mmWave sensors.
    • USB-C: For power and programming.
    • 5v Header input: For optional power.
    • GPIO pins: 4 additional pins available for expansion.

  4. How the web installer manifest URL is constructed

    main

    The web installer uses a specific manifest URL pattern to target the correct firmware based on your hardware configuration. The URL is constructed using the base path https://everythingsmarthome.github.io/everything-presence-lite/ followed by a filename following this pattern:

    everything-presence-lite-ha[sensorSuffix][optionSuffix][moduleSuffix]-manifest.json

    Suffix Mapping

    Sensor Suffixes:

    • LD2410C $\rightarrow$ -ld2410
    • DFRobot SEN0395 $\rightarrow$ -sen0395
    • Seeed 24Ghz Lite $\rightarrow$ -mr24hpc1
    • SEN0609 $\rightarrow$ -sen0609

    Firmware Options:

    • No-Bluetooth $\rightarrow$ -no-ble

    Module Options:

    • CO2 Module $\rightarrow$ -co2
    // Example of a constructed manifest URL for an LD2410C sensor with No-Bluetooth and a CO2 Module:
// https://everythingsmarthome.github.io/everything-presence-lite/everything-presence-lite-ha-ld2410-no-ble-co2-manifest.json

  7. Getting started with Everything Presence Lite

    main

    Depending on your hardware configuration, follow one of these two paths to begin:

    1. Unassembled Kit: If you have the Everything Presence Lite Kit with a 3D printed case, you must first complete the assembly process.
    2. Fully Assembled: If your device arrived fully assembled in an injection moulded case, you can skip assembly and proceed directly to connecting the device to WiFi.

  9. Optimize EPL placement to avoid false detections

    main

    Because mmWave sensors are significantly more sensitive than standard PIR sensors, physical placement is critical to prevent false occupancy triggers.

    Mounting Requirements

    • Stability is key: Mount the EPL on a wall or a very sturdy object (e.g., a shelf or cabinet).
    • Avoid vibrations: Do not mount the sensor on objects that vibrate, such as air-conditioning units, as these vibrations will be interpreted as genuine movement.

    Environmental Triggers to Avoid

    Avoid placing the sensor directly in front of or near objects that move frequently. Common mmWave triggers include:

    • AC units
    • Plants moving in the wind
    • Curtains moving in the wind
    • Water droplets (e.g., in a bathroom)
    • Ceiling fans
    • Fans inside of a laptop or TV

    Wall Penetration

    Note that mmWave can "see through" objects, including very thin walls. Movement in an adjacent room may be detected if the wall is thin enough.

  10. Configure and enable Zones

    main

    Zones allow you to define specific areas within a room to trigger automations based on a target's location. The Lite supports up to 4 individual zones.

    Creating a Zone

    A zone is defined using 5 entities:

    1. Zone X Begin
    2. Zone Y Begin
    3. Zone X End
    4. Zone Y End
    5. (Implicitly required to activate the zone)

    Enabling additional zones (2, 3, or 4)

    Zones 2-4 are disabled by default. To enable them:

    1. Find the disabled entities in the Home Assistant device menu.
    2. Click the entity to open the popup.
    3. Click the settings icon in the right-hand corner of the popup.
    4. Toggle the entity to enabled.
    5. Wait 30 seconds, then refresh the page.
    6. Repeat for all 5 entities required for that specific zone.

  11. Install ESPHome firmware on Everything Presence Lite

    main

    To integrate the Everything Presence Lite directly with Home Assistant, you can flash the latest ESPHome firmware using a web-based installer.

    Prerequisites

    • Connect the Lite device to a USB port on your computer.
    • Use a supported web browser like Google Chrome.
    • If you cannot see a USB Serial port or receive a "Failed to open serial port" error, you may need to install the CH340 driver.

    Installation Steps

    1. Select Home Assistant as your Smart Home Platform.
    2. Choose one of the following Home Assistant options:
      • Bluetooth Proxy: Enables Bluetooth Proxy and Improv. Note: This may cause WiFi connectivity issues.
      • No Bluetooth: Disables Bluetooth Proxy and Improv. This is recommended for improved WiFi stability if you do not need Bluetooth Proxy functionality.
    3. Click the Connect button and select the appropriate USB port from the list.
    4. Click the Install button to begin the process.

    Once the installation is complete, you can connect the device to your WiFi.

  12. Install the Everything Presence Zone Configurator Add-on

    main

    The Zone Configurator is a visual tool for creating and managing zones in Home Assistant with real-time tracking.

    To install via the Home Assistant Add-on Store:

    1. Add the following repository URL to your Add-on Store: https://github.com/EverythingSmartHome/everything-presence-addons
    2. Refresh the Add-on Store page.
    3. Find and install the Everything Presence Zone Configurator add-on.
    4. Once installed, click Start and then Open Web UI to access the dashboard.