SmartHomeShop Docs

Troubleshooting

Each entry below gives the symptom, the likely cause and the fix. Start with the section that matches your problem.

Setup and Network

Device Not Found in Home Assistant

Cause: The device is not on your network yet, it is on a different network or VLAN, or discovery is blocked.

Fix:

  1. Check the power. The LED ring stays off at start, so a dark ring tells you nothing.
  2. Look for the device in your router's list of connected devices.
  3. Make sure the device and Home Assistant are on the same network or VLAN, with mDNS and port 6053 allowed.
  4. Add it by hand: go to Settings > Devices & services > Add integration, choose ESPHome and enter the IP address.

WiFi Setup Network Does Not Appear

Cause: The device has not finished starting, it is already connected to your WiFi, or it runs Ethernet firmware.

Fix:

  1. Wait 1 to 2 minutes after power-on.
  2. Check your router. If the device is there, it is already connected and needs no setup.
  3. Only WiFi firmware has a setup network. Ethernet firmware connects through the cable.
  4. Disconnect the power, wait a few seconds and connect it again.
  5. With USB-C, use a supply of 5 V and at least 1 A.

Captive Portal Does Not Open

Cause: Your phone or laptop stays on its other connection, or does not show the portal.

Fix:

  1. Turn off mobile data on your phone.
  2. Stay connected to CeilSense V2 Setup if your phone warns about no internet.
  3. Try a different phone or a laptop.

Device Is Offline

Cause: The power or network dropped, the WiFi signal at the ceiling is weak, or your network changed.

Fix:

  1. Check the power and, with Ethernet, the cable and the switch port.
  2. Check whether the device appears in your router.
  3. With WiFi, check the signal at the mounting spot. If it stays weak, consider Ethernet.
  4. Did your WiFi name or password change? See Network Configuration.
  5. Disconnect the power and connect it again. If the sensor is on mains, switch the circuit off and on.

Ethernet Does Not Connect

Cause: The device runs WiFi firmware, the cable or plug is not seated well, or the network gives no IP address.

Fix:

  1. Ethernet needs Ethernet firmware. See Firmware.
  2. Check the cable and try another switch port.
  3. Check that DHCP is enabled and that the device is on the same network or VLAN as Home Assistant.
  4. Look up the IP address in your router and add the device by hand.

PoE Does Not Power the Sensor

Cause: The switch or injector does not support IEEE 802.3af, PoE is off on that port, or the cable is at fault.

Fix:

  1. Check that your switch or injector supports IEEE 802.3af and that PoE is on for this port.
  2. Try another cable and another port.
  3. To rule out the sensor, test it with USB-C.

Presence

Presence Stays On in an Empty Room

Cause: The radar sees something: a moving object, a reflection, activity behind a thin wall, or a background it has not learned yet. An LD2412 can also stay on with a high still energy.

Fix with LD2412 + LD2450:

  1. Check which radar keeps Presence on: LD2412 Presence or LD2450 Presence.
  2. If LD2412 Still Energy stays high in an empty room, press LD2412 Restart.
  3. Remove or stop moving objects such as pets, fans and curtains, and check for reflections.
  4. Run the dynamic background correction with the room empty.
  5. Lower LD2412 Maximum Distance Gate to the size of the room and check LD2412 Presence Timeout.

Fix with LD2460:

  1. Look at Tracking Targets to see where the radar places the target.
  2. Check for mirrors, metal furniture and windows at that spot.
  3. Limit the detection range or draw an exclusion zone. See Calibration.

No Presence, or Someone Is Missed

Cause: The radar module is not fitted firmly, the person is outside the coverage, or the settings are too narrow.

Fix:

  1. Check that the firmware entity of the radar has a value: see the next entry.
  2. Disconnect all power and check that the module sits firmly in its socket. A loose module can miss someone.
  3. Check the coverage for your ceiling height. Sitting still has a smaller reach than moving.
  4. Raise LD2412 Maximum Distance Gate and check LD2412 Minimum Distance Gate.
  5. Check that your zones are not too small.

Radar Entities Are Empty

Cause: The module is not seen, or the firmware does not match the radar in the device.

Fix:

  1. Check LD2412 Firmware Version, LD2450 Firmware Version or Tracking Radar Firmware. Empty means the module is not seen.
  2. Disconnect all power and reseat the module.
  3. Check that the firmware matches the radar configuration. See Firmware.
  4. Never combine modules that cannot be combined. See Radar and Sensor Modules.

Detection Through a Wall or From the Next Room

Cause: mmWave can pass through thin walls and doors.

Fix:

  • With LD2412: lower LD2412 Maximum Distance Gate.
  • With LD2450: use zones with LD2450 Zone Type.
  • With LD2460: lower Tracking Radar Detection Distance or draw an exclusion zone.

Pets or Fans Trigger Presence

Cause: mmWave can notice small moving objects such as pets, fans and moving curtains.

Fix:

  • Aim for the area where people are, with zones if your radar has them.
  • Lower the maximum range to the part of the room you need.
  • With a ceiling fan that stays on, run the dynamic background correction with the fan at its usual speed.

Zones Do Not Match the Room

Cause: The zone coordinates do not match where the radar places people.

Fix:

  1. Walk through the room and watch the X and Y entities.
  2. Set the zone around the coordinates you see, not around what you measured with a tape.
  3. With an LD2460, do the walk test before you draw zones.

Readings

CO2 Shows Nothing

Cause: There is no SCD41 module in the device, the module is not fitted firmly, or the firmware has no SCD41 support.

Fix:

  1. Check that the SCD41 module is fitted. CO2, temperature and humidity are not available without it.
  2. Wait a moment after a start: new values come every 30 seconds.
  3. Disconnect all power and reseat the module.
  4. Check that the firmware includes the SCD41 module.

First Readings After a Start Look Wrong

Cause: This is normal. The first SCD41 readings after a start are not meaningful.

Fix: Wait until the sensor has stabilized. Give it at least 30 minutes before you judge temperature.

Temperature Reads Too High

Cause: Recessed mounting and heat from electronics influence the reading. A bright LED ring adds some heat too.

Fix:

  1. Dim the LED ring or use it briefly.
  2. Keep the cavity free of drafts.
  3. Compare with a reliable thermometer and set Temperature Offset. See Calibration.
  4. Use temperature mainly for trends.

Humidity Looks Wrong

Cause: The reading differs from your reference, or the sensor is still stabilizing.

Fix: Wait until the sensor has stabilized, compare with a reliable reference and set Humidity Offset.

CO2 Stays Too High

Cause: Automatic self-calibration needs fresh air, or the room really has too little ventilation.

Fix:

  1. Ventilate the room well and see whether the value drops.
  2. Give the sensor 1 to 2 weeks with regular fresh air.

BMP388 Temperature Is Much Higher Than the Room

Cause: This is normal. It is the temperature inside the device, not room temperature.

Fix: Nothing. For room temperature, use SCD41 Temperature.

Light Value Differs From a Lux Meter

Cause: Illuminance is the raw value and the sensor sits behind a light window.

Fix: Use Illuminance Calibrated for a corrected value, or pick automation thresholds from what the entity shows in your room. See Calibration.

LED Ring and Buzzer

LED Ring Stays Dark

Cause: The ring is off by default and off at every start.

Fix:

  1. Switch on LED Ring on the device page.
  2. Check the brightness.
  3. Check whether an automation turns the ring off.

LED Ring Does Not Show a Warning

Cause: The current firmware has no built-in motion light or CO2 warning.

Fix: Build it with an automation. See LED Ring and Buzzer.

Buzzer Stays Silent

Cause: The buzzer is silent unless you use it.

Fix:

  1. Press Buzzer Test under Diagnostic on the device page.
  2. Check that your automation uses button.press on the right entity. See Usage.

Entities and Firmware

An Entity Is Missing

Cause: The entity depends on your modules and firmware, or it is disabled by default.

Fix:

  1. Compare with Sensor Definitions for your radar configuration.
  2. Check that the firmware matches your network choice and modules.
  3. Look under Diagnostic and Configuration on the device page, and check hidden or disabled entities.

Your Automation Stopped After a Firmware Change

Cause: Entity names can change until release, and different radar configurations have different entities.

Fix: Check the entity IDs in your automation against the device page.

Still Stuck?

See Warranty and Support for what to include in your request.