SmartHomeShop Docs

Sensordefinities

Deze pagina komt overeen met de huidige ultimatesensor-v2 firmware in de SmartHomeShop GitHub repository.

Home Assistant entity IDs krijgen de apparaatnaam als prefix. De kolom ESPHome ID is de interne YAML id als die in de firmware is gedefinieerd.

UltimateSensor v2 is het volledige v2-model met ESP32-S3, PIR, microfoon, speaker, media player en local wake word. Voor het compacte ESP32-C6 model zonder voice-hardware of PIR gebruik je UltimateSensor Mini v2.

Standaard Hardware

Onderdeel Firmwarebron Aanwezig op UltimateSensor v2
Hoofdplatform base.yaml ESP32-S3, PSRAM, API, OTA, web server
Omgevingssensoren base.yaml SCD41, SGP41, BH1750
Aanwezigheidsfallback base.yaml LD2412 + PIR
Standaard trackingradar tracking-ld2450.yaml LD2450 op fabrieks-hardware
Optionele trackingupgrade tracking-ld2460.yaml LD2460 alleen na vervangen/verwijderen van LD2450
Voice assistant voice-assistant.yaml of cloud-voice.yaml In elke UltimateSensor v2 firmwarevariant: Home Assistant voice op lokale builds, Cloud Voice op cloudbuilds
Fijnstof complete.yaml SPS30 alleen op Complete varianten

Hoofdlogica voor Aanwezigheid

Entiteit ESPHome ID Beschrijving
Occupancy occupancy Gecombineerde aanwezigheid. Firmwarelogica: PIR Motion OR LD2412 Presence OR Tracking Presence.
Occupancy Off Delay occupancy_off_delay Vertraging in seconden voordat gecombineerde aanwezigheid uitgaat.

PIR

Entiteit ESPHome ID Beschrijving
PIR Motion pir_motion Snelle eerste bewegingstrigger op basis van warmtebeweging.

LD2412 Aanwezigheidsradar

Entiteit ESPHome ID Beschrijving
LD2412 Presence ld2412_presence Close-range/stilzitten fallback voor gecombineerde aanwezigheid.
LD2412 Moving Target - Bewegend target status.
LD2412 Still Target - Stil target status.
LD2412 Dynamic Background Correction - Diagnostiekstatus tijdens achtergrondcorrectie.
LD2412 Moving Distance - Afstand tot bewegend target.
LD2412 Still Distance - Afstand tot stil target.
LD2412 Moving Energy - Signaalsterkte voor beweging.
LD2412 Still Energy - Signaalsterkte voor stilzitten.
LD2412 Detection Distance - Dichtstbijzijnde gedetecteerde targetafstand.
LD2412 Light - Lichtwaarde uit de LD2412.

LD2412 Controls

Entiteit Type Beschrijving
LD2412 Presence Timeout Number Timeout voordat LD2412 presence uitgaat.
LD2412 Minimum Distance Gate Number Dichtstbijzijnde afstandsgate voor detectie.
LD2412 Maximum Distance Gate Number Verste afstandsgate voor detectie.
LD2412 Light Threshold Number Drempel voor LD2412 lichtgedrag.
LD2412 Engineering Mode Switch Toont tuningdata; standaard uitgeschakeld.
LD2412 Bluetooth Switch Zet LD2412 Bluetooth-configuratie aan.
LD2412 Output Pin Level Select Gedrag van de LD2412 output pin.
LD2412 Distance Resolution Select Afstandsresolutie van de LD2412.
LD2412 Light Function Select Lichtfunctie van de LD2412.
LD2412 Restart Button Herstart de LD2412 module.
LD2412 Factory Reset Button Zet LD2412 terug naar fabrieksinstellingen; standaard uitgeschakeld.
LD2412 Query Parameters Button Vraagt LD2412 parameters op; standaard uitgeschakeld.
LD2412 Dynamic Background Correction Button Start lege-ruimte achtergrondcorrectie; standaard uitgeschakeld.
LD2412 Firmware Text sensor LD2412 firmwareversie.
LD2412 Bluetooth MAC Text sensor LD2412 Bluetooth MAC-adres.

Standaard LD2450 Trackingradar

De fabrieksfirmware gebruikt LD2450. Dit zijn de entiteitsnamen die Home Assistant op UltimateSensor v2 toont.

Entiteit ESPHome ID Beschrijving
Tracking Presence tracking_presence Trackingradar aanwezigheid, gebruikt door gecombineerde occupancy.
Radar Target Count radar_target_count Aantal actieve targets.
Radar Still Target Count radar_still_target_count Stilstaande targets die worden gevolgd.
Radar Moving Target Count radar_moving_target_count Bewegende targets die worden gevolgd.
Tracking Moving Target tracking_moving_target Bewegende trackingstatus.
Tracking Still Target tracking_still_target Stilstaande trackingstatus.
LD2450 Firmware - LD2450 firmwareversie.
LD2450 Bluetooth MAC - LD2450 Bluetooth MAC-adres.

LD2450 Target Entiteiten

Entiteitspatroon ESPHome ID-patroon Beschrijving
Target 1 X/Y/Speed/Angle/Distance/Resolution radar_target1_x, radar_target1_y, enz. Positie- en bewegingsdata van target 1.
Target 2 X/Y/Speed/Angle/Distance/Resolution radar_target2_x, radar_target2_y, enz. Positie- en bewegingsdata van target 2.
Target 3 X/Y/Speed/Angle/Distance/Resolution radar_target3_x, radar_target3_y, enz. Positie- en bewegingsdata van target 3.

LD2450 Zones en Controls

Entiteit Type Beschrijving
Zone 1 Target Count Sensor Targets in zone 1.
Zone 1 Still Target Count Sensor Stilstaande targets in zone 1.
Zone 1 Moving Target Count Sensor Bewegende targets in zone 1.
Zone 1 X1/Y1/X2/Y2 Number Grenzen van zone 1.
Zone 2 Target Count Sensor Targets in zone 2.
Zone 2 Still Target Count Sensor Stilstaande targets in zone 2.
Zone 2 Moving Target Count Sensor Bewegende targets in zone 2.
Zone 2 X1/Y1/X2/Y2 Number Grenzen van zone 2.
Zone 3 Target Count Sensor Targets in zone 3.
Zone 3 Still Target Count Sensor Stilstaande targets in zone 3.
Zone 3 Moving Target Count Sensor Bewegende targets in zone 3.
Zone 3 X1/Y1/X2/Y2 Number Grenzen van zone 3.
Tracking Presence Timeout Number Timeout voordat tracking presence uitgaat.
LD2450 Bluetooth Switch Zet LD2450 Bluetooth-configuratie aan.
LD2450 Multi Target Switch Zet multi-target mode aan.
LD2450 Restart Button Herstart de LD2450 module.
LD2450 Factory Reset Button Factory reset voor LD2450; standaard uitgeschakeld.

Room Designer Polygon Zones

UltimateSensor v2-firmware voegt de gedeelde SmartHomeShop polygon-zone-laag toe bovenop de drie ingebouwde rechthoekige LD2450-zones.

Entiteit Type Beschrijving
Polygon Zone 1-4 Text Polygoncoördinaten voor vier detectiezones.
Polygon Exclusion 1-2 Text Polygonen waarvan targets worden genegeerd.
Entry Line 1-2 Text Richtingsgevoelige ingangslijnen.
Polygon Zones Enabled Switch Schakelt de polygon-zone-engine in.
Polygon Zone 1-4 Presence Binary sensor Aanwezigheid binnen iedere polygonzone.
Polygon Zone 1-4 Target Count Sensor Aantal targets binnen iedere polygonzone.
People Count Sensor Lopende kamertelling op basis van ingestelde lijnpassages.
Last Crossing Direction Text sensor Richting van de laatst gedetecteerde lijnpassage.
Reset People Count Button Zet de lopende personentelling terug op nul.

Met de Home Assistant-actions set_polygon_zone, set_polygon_exclusion, set_entry_line en reset_people_count kan de SmartHomeShop Room Designer deze configuratie naar het apparaat schrijven. Diagnose-entiteiten die met Radar beginnen, zoals Radar Model en Radar Mounting Mode, vertellen de Room Designer hoe de radar gemonteerd is. Die hoef je niet aan te passen.

Optionele LD2460 Upgrade

LD2460 firmware is alleen voor apparaten waarbij de LD2450 module is verwijderd/vervangen door de LD2460 upgrade. LD2412 blijft geplaatst en blijft de close-range fallback.

LD2460 gebruikt dezelfde hoofd-ID tracking_presence. Het aantal targets heet Tracking Target Count (tracking_target_count). De LD2450-specifieke zone-, speed- en resolution-entiteiten vervallen, maar de gedeelde Room Designer-polygonzonelaag blijft beschikbaar. LD2460 voegt toe:

Entiteit ESPHome ID Beschrijving
Tracking Targets tracking_summary Tekstsamenvatting van tracked targets.
Tracking Radar Firmware tracking_firmware LD2460 firmwarestring.
Tracking Radar Installation Mode tracking_installation_mode LD2460 installatiemodus.
Tracking Radar Installation Mode tracking_installation_mode_select Wijzigt side/top op de radar. UltimateSensor v2-firmware vereist side.
Tracking Radar Installation Height tracking_installation_height Opgeslagen wandhoogte in meters.
Tracking Radar Installation Angle tracking_installation_angle Opgeslagen neerwaartse montagehoek in graden.
Tracking Radar Detection Distance tracking_detection_distance Afstand van de hardwarematige detectiesector in meters.
Tracking Radar Detection Start Angle tracking_detection_start_angle Starthoek van de hardwaresector in graden.
Tracking Radar Detection End Angle tracking_detection_end_angle Eindhoek van de hardwaresector in graden.
Tracking Raw UART tracking_raw_uart Raw UART diagnose; standaard uitgeschakeld.
Tracking UART Bytes tracking_uart_bytes UART byte teller; standaard uitgeschakeld.
Tracking Target 1-5 X/Y/Distance/Angle tracking_target_1_x, enz. LD2460 targetcoordinaten. Targets 4 en 5 zijn standaard uitgeschakeld.

De huidige UltimateSensor v2 LD2450- en LD2460-pakketten bevatten beide de gedeelde Room Designer-polygonzones. Lees LD2460-upgrade voordat je montage- of bereikwaarden instelt.

Voice Assistant en Audio

Entiteit ESPHome ID Beschrijving
Media Player media_player_01 Speaker media player voor TTS, alarmen en assistant-antwoorden.
Microphone RMS - RMS geluidsniveau van de microfoon.
Microphone Peak - Piekgeluidsniveau van de microfoon.
Use Wake Word use_wake_word Lokale firmware: zet local wake word luisteren aan/uit. Standaard aan.
Voice Assistant Start voice_assistant_start_button Lokale firmware: start voice assistant handmatig.
Cloud Voice use_wake_word Cloudfirmware: zet luisteren voor Cloud Voice aan/uit. Standaard aan.
Cloud Voice Start cloud_voice_start_button Cloudfirmware: start Cloud Voice handmatig.
Voice Assistant Phase voice_assistant_phase_text Diagnostiektekst: idle, listening, thinking, replying, not_ready, error, muted.

Omgevingssensoren

Entiteit ESPHome ID Beschrijving
SCD41 CO2 scd41_co2 CO2-concentratie.
SCD41 Temperature scd41_temperature Temperatuur van de SCD41.
SCD41 Humidity scd41_humidity Relatieve luchtvochtigheid van de SCD41.
VOC Index voc_index SGP41 VOC-index.
NOx Index nox_index SGP41 NOx-index.
BH1750 Illuminance illuminance Omgevingslicht.

Configuratie- en Firmwarebediening

Entiteit ESPHome ID Type Beschrijving
Temperature Offset scd41_temperature_correction Number Correctie per apparaat, opgeteld bij SCD41 Temperature.
Humidity Offset scd41_humidity_correction Number Correctie per apparaat, opgeteld bij SCD41 Humidity.
Boot Sound & Animation boot_sound_switch Switch Zet het opstartgeluid en de led-animatie aan of uit. Standaard aan.
${friendly_name} Firmware Variant firmware_selector Select Kiest Basic/Complete, WiFi/Ethernet en lokale/cloud-updatebron met behoud van de radarhardwarefamilie.
${friendly_name} Firmware firmware_update Update Controleert en installeert updates uit de gekozen manifest; standaard uitgeschakeld.

De schakelaars en getallen voor automatische verlichting staan op Automatische LED-verlichting.

Optionele SPS30 Complete Variant

Complete firmware voegt SPS30 toe op I2C adres 0x69.

Entiteit ESPHome ID
PM <1um Weight concentration PM_1_0
PM <2.5um Weight concentration PM_2_5
PM <4um Weight concentration PM_4_0
PM <10um Weight concentration PM_10_0
PM <0.5um Number concentration PMC_0_5
PM <1um Number concentration PMC_1_0
PM <2.5um Number concentration PMC_2_5
PM <4um Number concentration PMC_4_0
PM <10um Number concentration PMC_10_0
Typical Particle size pm_size
SPS30 Update Interval sps30_update_interval
SPS30 Idle Interval sps30_idle_interval
PM Sensor pm_sensor_switch
SPS30 Quiet Hours sps30_quiet_hours_enabled
SPS30 Quiet Start Hour sps30_quiet_start_hour
SPS30 Quiet End Hour sps30_quiet_end_hour
SPS30 Quiet Hours Active sps30_quiet_hours_active_sensor

LEDs, Controls en Diagnostiek

Entiteit ESPHome ID Beschikbaarheid
Front LED rgb_front_led Alle varianten
API Connection api_connection Alle varianten
Uptime uptime_sensor Alle varianten
CPU Temperature cpu_temperature Alle varianten
Restart restart_button Alle varianten
Restart in Safe Mode safe_mode_button Alle varianten
Factory Reset factory_reset_button Alle varianten, standaard uitgeschakeld
CO2 Manual Calibration co2_calibration_button Alle varianten, standaard uitgeschakeld
ESPHome Version esphome_version Alle varianten
Software Version software_version Alle varianten
Hardware Version hardware_version Alle varianten
Connection type connection_type Alle varianten
WiFi Signal - Alleen WiFi-varianten
IP Address wifi_ip Alleen WiFi-varianten, standaard uitgeschakeld
ESP MAC wifi_mac Alleen WiFi-varianten, standaard uitgeschakeld
Connected SSID - Alleen WiFi-varianten
Connected BSSID - Alleen WiFi-varianten, standaard uitgeschakeld
Ethernet IP Address ethernet_ip_address Alleen Ethernet-varianten
Ethernet DNS Address - Alleen Ethernet-varianten
Ethernet MAC Address ethernet_mac_address Alleen Ethernet-varianten

Optionele Cloud Build Entiteiten

Alleen *-cloud.yaml firmwarevarianten tonen deze SmartHomeShop cloud diagnostiek:

Entiteit ESPHome ID Beschikbaarheid
${friendly_name} Reset Cloud cloud_reset_button Cloud varianten
${friendly_name} Cloud Connected cloud_connected Cloud varianten
${friendly_name} Cloud Sync Failures cloud_sync_failure_count Cloud varianten
${friendly_name} Cloud Device ID cloud_device_id_sensor Cloud varianten
${friendly_name} Cloud Status cloud_status_text Cloud varianten

Cloud zone sync bestaat op LD2450- en LD2460-cloudbuilds via cloud-zones.yaml.

Niet Aanwezig op UltimateSensor v2

  • Barometrische druksensor
  • ESP32-C6 hardware en Mini v2 firmware
  • Mini v2-only Status LED naam; gewone v2 gebruikt Front LED

Gerelateerd