SmartHomeShop Docs

Sensor Definitions

This page lists every entity in the current WallSense firmware, a WiFi test build.

Note: Entity names can change until release.

Home Assistant builds entity IDs from your device name and the entity name, for example sensor.wallsense_scd41_co2. Your IDs can differ per installation.

All entities are enabled by default. Config and Diagnostic in the tables below refer to the sections on the device page in Home Assistant where these entities appear.

Presence

Entity Type Description
Occupancy Binary sensor On when LD2412 Presence or LD2450 Presence is on. The best choice for most automations.

LD2412 Radar

The LD2412 detects presence and small movements. It does not report X/Y positions.

Entity Type Unit Description
LD2412 Presence Binary sensor Someone is detected, moving or still
LD2412 Moving Target Binary sensor A moving target is detected
LD2412 Still Target Binary sensor A still target is detected
LD2412 Moving Distance Sensor cm Distance to the moving target
LD2412 Still Distance Sensor cm Distance to the still target
LD2412 Moving Energy Sensor % Signal strength of the moving target
LD2412 Still Energy Sensor % Signal strength of the still target
LD2412 Detection Distance Sensor cm Distance of the detected target
Entity Type Category Description
LD2412 Restart Button Diagnostic Restarts the LD2412 module
LD2412 Query Parameters Button Diagnostic Reads the settings from the module
LD2412 Firmware Version Text sensor Diagnostic Firmware of the module
LD2412 MAC Text sensor Diagnostic MAC address of the module

LD2450 Radar

The LD2450 tracks up to three people with X/Y coordinates.

Entity Type Unit Description
LD2450 Presence Binary sensor At least one target is tracked
LD2450 Moving Target Binary sensor At least one target is moving
LD2450 Still Target Binary sensor At least one target is still
LD2450 Target Count Sensor Number of tracked targets, 0 to 3
LD2450 Still Target Count Sensor Number of still targets
LD2450 Moving Target Count Sensor Number of moving targets
LD2450 Target 1 X Sensor mm Position left or right of the sensor
LD2450 Target 1 Y Sensor mm Position straight ahead of the sensor
LD2450 Target 1 Speed Sensor mm/s Speed, positive when moving away, negative when approaching
LD2450 Target 1 Distance Sensor mm Distance to the target
LD2450 Target 1 Angle Sensor ° Angle to the target, 0° is straight ahead

LD2450 Target 2 X to LD2450 Target 2 Angle and LD2450 Target 3 X to LD2450 Target 3 Angle work the same way. The target entities are unknown when that target is gone.

Entity Type Category Description
LD2450 Firmware Version Text sensor Diagnostic Firmware of the module
LD2450 MAC Text sensor Diagnostic MAC address of the module

Air Quality and Climate

Both the SHT45 and the SCD41 report temperature and humidity. The SHT45 is the primary climate sensor, the SCD41 gives CO2.

Entity Type Unit Description
SCD41 CO2 Sensor ppm CO2 concentration, new value every 30 seconds
SHT45 Temperature Sensor °C Temperature, primary climate sensor
SHT45 Humidity Sensor % Relative humidity, primary climate sensor
SCD41 Temperature Sensor °C Temperature from the SCD41
SCD41 Humidity Sensor % Relative humidity from the SCD41
SGP41 VOC Index Sensor VOC index, 1 to 500
SGP41 NOx Index Sensor NOx index, 1 to 500

The SGP41 values are indices, not ppm. The SGP41 uses the SHT45 readings for compensation.

Calibration Settings

Entity Type Category Description
SHT45 Temperature Offset Number Config Correction in °C
SHT45 Humidity Offset Number Config Correction in %
SCD41 Extra Temperature Offset Number Config Correction in °C
SCD41 Humidity Offset Number Config Correction in %
CO2 Manual Calibration Button Config Forces the CO2 reading to 426 ppm in fresh air. Use with care

The four offsets run from -20 to +20 in steps of 0.1, start at 0 and are kept after a restart. See Calibration.

Ambient Light

Entity Type Unit Category Description
Illuminance Sensor lx Ambient light, new value about every 10 seconds
VEML7700 Actual Gain Sensor Diagnostic Gain the sensor is using
VEML7700 Integration Time Sensor ms Diagnostic Integration time the sensor is using

The light sensor is a Vishay VEML6030. The two diagnostic entities carry VEML7700 in their name in the current firmware.

Touch and LEDs

Entity Type Category Description
Touch Button Binary sensor On while you touch the front
Rear LED Effects Light Color, brightness and effect of the sixteen rear LEDs
Rear LED Effects Enabled Switch Config On starts Rainbow, off turns the rear LEDs off
Rear LED Scene Select Config Off, Aurora Flow, Rainbow, Radar Sweep, Sparkle, Fireworks, Color Wipe, Breathing Blue

Device and Network

Entity Type Unit Category Description
Status Binary sensor Diagnostic Connection status of the device
Uptime Sensor s Diagnostic Time since the last start
CPU Temperature Sensor °C Diagnostic Temperature of the processor, not of the room
WiFi Signal Sensor dBm Diagnostic WiFi signal strength
WiFi IP Address Text sensor Diagnostic IP address on your network
Connected SSID Text sensor Diagnostic WiFi network WallSense is connected to
Connected BSSID Text sensor Diagnostic Access point WallSense is connected to
ESPHome Version Text sensor Diagnostic ESPHome version of the firmware
Restart Button Config Restarts WallSense
Restart in Safe Mode Button Diagnostic Restarts WallSense in safe mode

With the Thread firmware, WiFi Signal, WiFi IP Address, Connected SSID and Connected BSSID are gone.

Not in the Current Firmware

These functions have no entities yet:

  • the front LED, which is internal and only gives touch feedback;
  • radar settings such as presence timeout and sensitivity per distance gate;
  • radar zones;
  • Ethernet information, which follows with the Ethernet firmware.

Related