# Troubleshooting # Troubleshooting # Troubleshooting Common issues and solutions for Everything Presence One. ## ESP32 LED Flashing The LED on the main EP1 board will flash if: * The device is **not connected to WiFi**, OR * The device is connected to WiFi but **Home Assistant has not connected** to the EP1 :::tip This is normal during initial setup. The LED will stop flashing once Home Assistant successfully connects to the device. ::: ## Sensor Not Appearing in Home Assistant ### Check WiFi Connection 1. Ensure the EP1 is powered (LED behaviour explained above) 2. Verify your WiFi network is 2.4GHz (EP1 doesn't support 5GHz) 3. Check that the EP1 is within range of your router 4. **Try a different power supply** - poor quality or noisy USB power supplies can cause WiFi connectivity issues ### Re-adopt the Device 1. Go to **Settings > Devices & Services > ESPHome** 2. Look for a new device to configure 3. If not visible, try power cycling the EP1 ### Check ESPHome Logs 1. In Home Assistant, go to your EP1 device 2. Click the three dots menu > **Logs** 3. Look for connection errors or WiFi issues ## Entity Shows "Unavailable" This usually indicates a connection issue between Home Assistant and the EP1. **Solutions:** * Power cycle the EP1 (unplug and replug) * **Try a different power supply** - noisy power supplies can cause intermittent disconnections * Check your WiFi router for connection issues * Restart Home Assistant * Check ESPHome logs for errors ## Sensor Stuck on "Detected" The sensor reports presence continuously even when the room is empty. **Common causes and fixes:** | Cause | Solution | |-------|----------| | Poor quality power supply | Try a different USB power adapter | | Ceiling fan in detection range | Reduce max distance or reposition sensor | | Detecting through thin walls | Reduce max distance setting | | HVAC vents causing movement | Aim sensor away from vents | | Reflective surfaces | Reposition to avoid mirrors/glass | | Vibrating mount surface | Mount on a stable, solid surface | **Tuning steps:** 1. Reduce **Max Distance** to match your room size 2. Lower **Sustain Sensitivity** (try 4-5) 3. Increase **On Latency** to filter brief triggers ## Sensor Stuck on "Clear" / Not Detecting The sensor doesn't detect presence when someone is in the room. **Solutions:** 1. **Check your power supply** - noisy power can affect mmWave sensor performance 2. Increase **Max Distance** to cover the full room 3. Increase **Sustain Sensitivity** (try 7-8) 4. Reduce **On Latency** to 0 for fastest response 5. Check sensor placement - avoid obstructions 6. Ensure the sensor is pointed at the detection area ## False Positives from Pets The EP1 will detect pets that move within its range. **Options:** * Reduce **Max Distance** to exclude floor level * Mount higher and angle downward * Adjust **Trigger Distance** for initial detection threshold * Use **On Latency** to filter brief movements ## Detecting Through Walls mmWave can penetrate thin walls and detect movement in adjacent rooms. **Solutions:** 1. Reduce **Max Distance** to stop before the wall 2. Reposition the sensor to aim away from thin walls 3. Use **Trigger Distance** as a secondary threshold ## Temperature/Humidity Readings Incorrect **Calibration:** * Use the **Temperature Offset** and **Humidity Offset** controls * Compare readings with a known accurate thermometer * Allow 24 hours for the sensor to acclimate after installation ## mmWave LED Flashing Constantly This is normal - the LED indicates the sensor is actively scanning. **To disable:** 1. Find the **mmWave LED** entity in Home Assistant 2. Turn it off ## Settings Don't Take Effect For EP1, you must press the apply buttons after changing settings. **Remember to press:** * **Set Distance** after changing distance values * **Set Sensitivity** after changing sensitivity values :::warning **Wait 10 seconds between changes.** The mmWave sensor needs time to apply each setting. If you change multiple settings too quickly, some may not be saved correctly. ::: ## Reset WiFi Settings Using the Boot Button If you need to reset the WiFi settings (for example, to connect to a different network), you can use the boot button on the EP1 board: 1. Locate the **BOOT** button on the EP1 PCB 2. Perform this sequence: * Press and hold for **1 second**, then release * Press and hold for **1 second**, then release * Press and hold for **at least 5 seconds** 3. The LED will flash **5 times** to confirm the reset 4. The device will restart with WiFi settings cleared After resetting, follow the [Set up your EP1 device in Home Assistant](/doc/4b6082c4-cff2-4b2e-a563-374c976974b1) guide to reconfigure your device. ## Still Need Help? * [Home Assistant Entities Overview](/doc/b5e0e5b8-82ab-488f-856f-ce5fa1643637) - All sensors and controls * [How to Tune Your EP1 Sensor](/doc/c35cc882-bdcb-4c4d-b665-6394255673ab) - Placement and sensitivity guide * [Automation Examples](/doc/305b9344-f59a-4f03-a682-d75f5dd117c6) - Create automations with your sensor * [Technical Entity Reference](/doc/e4ff833e-ef42-4368-a1ac-9dfbd98c284a) - All settings and defaults * Join the [Discord community](https://discord.gg/Bgfvy2f) for support ## Factory Reset If all else fails, you can restore factory settings: [Restore or Update your EP1 to factory settings using a computer](/doc/824ac47f-a429-4e19-afa3-e1b76012fd5c) --- **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)