# Troubleshooting

# Troubleshooting

Common issues and solutions for the Everything Presence Pro.

## Connection Issues

### Device Not Appearing in Home Assistant

**Symptoms:** The Pro doesn't show up in Home Assistant after setup.

**Solutions:**


1. **Check network connectivity**
   * For Ethernet: Verify the cable is connected and the switch port is active
   * For WiFi: Ensure the Pro is connected to your WiFi network
   * Check that the Pro and Home Assistant are on the same network/VLAN
2. **Verify ESPHome integration**
   * Go to Settings → Devices & Services → ESPHome
   * Click "Add Device" and enter the device IP if not auto-discovered
3. **Check for IP address**
   * Access your router's admin page to find the device IP
   * Try accessing `http://<device-ip>` in a browser
4. **Restart the device**
   * Unplug and replug power, or press the Restart button in Home Assistant

### Device Shows Offline/Unavailable

**Symptoms:** The device was working but now shows unavailable.

**Solutions:**


1. Check power connection (PoE or USB-C)
2. Verify network connectivity
3. Check if the IP address changed (assign a static IP in your router)
4. Restart the ESPHome integration in Home Assistant

### Can't Connect via Ethernet

**Solutions:**


1. Ensure you're using the Ethernet firmware variant (not WiFi-only)
2. Try a different ethernet cable
3. Test with a different switch port
4. Verify PoE is enabled on the port (if using PoE)
5. Try USB-C power temporarily to rule out PoE issues


---

## Detection Issues

### False Detections When Room Is Empty

**Causes:** The sensor detects movement or presence when no one is there.

**Solutions:**


1. **Check for moving objects:**
   * Ceiling fans
   * Curtains near vents
   * Pets
   * Moving objects visible through windows
2. **Reduce detection range:**
   * Lower Static Presence Max Range if detecting through walls
   * Reduce Tracking Detection Range
3. **Add exclusion zones:**
   * Use the [Zone Configurator](/doc/6640e98e-2d8f-4cbe-a705-5d215371b372) to create exclusion zones for problem areas
4. **Lower sensitivity:**
   * Reduce Static Trigger Sensitivity
   * Reduce Static Sustain Sensitivity

### Misses Stationary People

**Symptoms:** Detection turns off while someone is still in the room, sitting or standing still.

**Solutions:**


1. **Increase Static Sustain Sensitivity** (try 7-9)
2. **Extend timeouts:**
   * Increase Occupancy Timeout
   * Increase Static Presence Timeout
3. **Check line of sight** - Ensure no obstructions between sensor and person
4. **Verify range settings** - Ensure Max Range covers the seating area

### Slow to Detect Entry

**Symptoms:** Takes several seconds to detect someone entering the room.

**Solutions:**


1. **Increase Static Trigger Sensitivity**
2. **Reduce Static On Delay** to 0
3. **Check PIR Motion sensor** - It should provide instant motion detection
4. **Verify orientation** - Ensure sensor is pointing at the entry point

### Zones Not Working Correctly

**Solutions:**


1. Use the [Zone Configurator](/doc/6640e98e-2d8f-4cbe-a705-5d215371b372) to visualize real-time tracking
2. Verify zone coordinates are correct for your setup
3. Check that zones don't overlap with exclusion zones
4. Ensure targets are visible in the Zone Configurator when you're in the room
5. Enable Zone 2/3/4 entities in Home Assistant if needed (disabled by default)


---

## Relay Issues

### Relay Not Triggering

**Solutions:**


1. Check **Relay Trigger Mode** is not set to "Disabled"
2. Verify wiring connections at screw terminals
3. Test with manual control via **Relay Output** switch in Home Assistant
4. Check load is within relay specifications

### Relay Triggers Unexpectedly

**Solutions:**


1. Check the **Relay Trigger Mode** setting
2. Review detection settings (false positives cause false relay triggers)
3. Switch to "Disabled" mode and use Home Assistant automations for more control


---

## LED Issues

### LED Not Working

**Solutions:**


1. **Check LED Mode** - Set to "Manual Control" for direct control
2. **Check LED Brightness** - Ensure it's not set to minimum (0.1)
3. **Try Manual Control mode** and control via the LED light entity
4. **Restart the device**

### LED Shows Wrong Colors in Automatic Mode

**Solutions:**


1. For Environmental mode, ensure CO2 module is installed
2. Check LED Brightness setting
3. Verify sensor readings are accurate


---

## Environmental Sensor Issues

### Temperature/Humidity Reading Seems Wrong

This is expected behavior. See [Hardware Overview](/doc/ab2e2424-b596-4d68-8798-c0871b7287ef) for details on why these readings may be inaccurate.

**Mitigation:**


1. Use Temperature/Humidity Calibration offsets to adjust readings
2. Use an external sensor for climate control automations
3. Consider these readings as "indicative" rather than precise

### Illuminance Seems Off

**Solutions:**


1. Use the **Illuminance Calibration** offset to adjust
2. Ensure the light sensor isn't obstructed or facing a bright light source

### CO2 Not Working

**Solutions:**


1. Verify CO2 module is physically installed
2. Ensure you're using the CO2 firmware variant
3. Press the **Calibrate CO2** button (requires 400ppm reference air)
4. Wait several minutes after power-on for sensor warm-up


---

## Firmware Issues

### Can't Update Firmware

**Solutions:**


1. **Via Home Assistant:**
   * Go to Settings → Devices & Services → ESPHome
   * Find your device and click Update
2. **Via Web Interface:**
   * Navigate to `http://<device-ip>`
   * Upload the firmware file
3. **If device is unresponsive:**
   * Try a factory reset (hold boot button during power-on)
   * See [Restore or Update your Pro to factory settings using a computer](/doc/02d97031-2542-4c7f-8ef9-c43f51f2528e)

### Firmware Variant Switch Not Working

**Solutions:**


1. Change the variant settings (Network Type, CO2 Sensor, Bluetooth Proxy)
2. Press **Apply Update** button
3. Wait for the device to download and install the new firmware
4. Device will restart automatically


---

## Getting More Help

If you've tried the solutions above and still have issues:


1. **Check Home Assistant logs:**
   * Go to Settings → System → Logs
   * Filter by "esphome" or your device name
2. **Enable debug logging:**
   * Temporarily increase log level for more detail
3. **Community Support:**
   * Visit the Everything Smart Home Discord
   * Check the GitHub issues for known problems
4. **Contact Support:**
   * Email support with your device info and logs

---

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