Sensor Definitions

This page explains the entities commonly available on UltimateSensor Mini v1.

The names below are those of firmware 3.0 and newer.

Environmental Sensors

Entity	Description	Unit
`CO2`	Carbon dioxide concentration	ppm
`Temperature`	Ambient temperature	°C
`Humidity`	Relative humidity	%
`Illuminance`	Ambient light intensity	lux
`VOC Index`	Volatile Organic Compounds index	index
`NOx Index`	Nitrogen Oxides index	index

If your Mini v1 includes the optional SPS30 module, the entities PM <1µm Weight concentration up to PM <10µm Weight concentration, the matching Number concentration entities and Typical Particle size are also available. Control the sensor with PM Sensor, SPS30 Update Interval (default 60 s), SPS30 Idle Interval (default 5 min, 0 keeps it always on) and SPS30 Quiet Hours with SPS30 Quiet Start Hour and SPS30 Quiet End Hour.

Voice Assistant Entities

Entity	Description
`Media Player`	Speaker output for TTS and voice responses
`Enable Voice Assistant`	Switch for local wake word and voice control, on by default
`Voice Assistant Start`	Button that starts listening without a wake word
`Voice Assistant Phase`	Current phase: `idle`, `listening`, `thinking`, `replying`, `not_ready`, `error` or `muted`
`Microphone RMS`, `Microphone Peak`	Microphone level

Presence Entities

Entity	Type	Description
`Occupancy`	Binary	Overall room occupancy, follows `Tracking Presence`
`Tracking Presence`, `Tracking Moving Target`, `Tracking Still Target`	Binary	The radar sees a target, a moving target or a still target
`Polygon Zone 1 Presence` to `Polygon Zone 4 Presence`	Binary	Someone is inside that polygon zone
`Polygon Zone 1 Target Count` to `Polygon Zone 4 Target Count`	Sensor	Number of people in that polygon zone
`Radar Target Count`, `Radar Moving Target Count`, `Radar Still Target Count`	Sensor	Number of targets
`Target 1 X` to `Target 3 X`, also `Y`, `Speed`, `Angle`, `Distance` and `Resolution`	Sensor	Position and movement per target, in mm and mm/s
`People Count`, `Last Crossing Direction`	Sensor	Room count from your entry lines and the last direction
`Reset People Count`	Button	Sets `People Count` back to zero
`Polygon Zones Enabled`	Switch	Turns all polygon zones on or off, on by default
`Tracking Presence Timeout`	Number	Time before presence clears after the last detection, 1 to 600 s

Draw zones, exclusion zones and entry lines in the Room Designer of the SmartHomeShop integration.

Device Controls

Entity	Type	Description
`Restart`	Button	Restart the device
`CO2 Manual Calibration`	Button	Force SCD41 calibration to 420 ppm; only use after at least 10 minutes in fresh air
`Temperature Offset`	Number	Correction on the temperature reading, default 2.3
`Humidity Offset`	Number	Correction on the humidity reading, default -1
`Boot Sound`	Switch	Enables or disables the startup sound and front LED animation; the setting is retained after a restart
`Restart in Safe Mode`	Button	Restarts in safe mode
`Factory Reset`	Button	Erases all settings, including WiFi
`Front Light`, `Back Light`	Light	RGB LEDs on the front and back

Automatic LED Lighting

Since firmware 3.6 the back LED can also work by itself. All of this is off by default and stays saved after a restart. Turn on Automatic LED Lighting first. On cloud firmware you can also set this in the SmartHomeShop App.

Entity	What it does	Default
`Automatic LED Lighting`	Main switch	Off
`Motion Light`, `Motion Light Brightness`	White light on motion from the radar	Off, 70%
`Night Light`, `Night Light Brightness`	Warm light when someone is present during the night hours	Off, 10%
`Night Light Start Hour`, `Night Light End Hour`	The night hours	22, 7
`CO2 LED Warning`	Three orange flashes at the warning level, three red flashes at the critical level	Off
`CO2 Warning Threshold`, `CO2 Critical Threshold`	The two CO2 levels	1000 ppm, 1500 ppm
`CO2 Alert Cooldown`	Wait time between alerts	5 min

Firmware Controls

The device name is added in front of these entity names in Home Assistant.

Entity suffix	Type	Description
`Firmware Variant`	Select	Selects WiFi Basic/Complete and local/SmartHomeShop App cloud firmware
`Firmware`	Update	Checks the manifest for the selected firmware; disabled by default

Diagnostic Entities

Entity	Description
`IP Address`	Current IP address
`Connected SSID`	WiFi network name
`WiFi MAC Address`	MAC address
`WiFi Signal`	Signal strength
`Uptime`	Time since the last restart
`CPU Temperature`	Internal ESP32-S3 diagnostic temperature
`ESPHome Version`	ESPHome firmware version
`Hardware Version`	Hardware variant, `V1-Basic` or `V1-Complete`
`Status`	Home Assistant API connection status

The firmware version of your Mini v1 is shown on the device page in Home Assistant.