SmartHomeShop Docs

Sensordefinities

Deze pagina komt overeen met de huidige ultimatesensor-mini-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 Mini v2 is het compacte ESP32-C6 model. Deze heeft geen microfoon, geen speaker, geen media player, geen local wake word en geen PIR-sensor. Gebruik de gewone UltimateSensor v2 als je die functies nodig hebt.

Standaard Hardware

Onderdeel Firmwarebron Aanwezig op Mini v2
Hoofdplatform base.yaml ESP32-C6, API, OTA, web server
Omgevingssensoren base.yaml SCD41, SGP41, BH1750
Aanwezigheidsfallback base.yaml LD2412
Standaard trackingradar tracking-ld2450.yaml LD2450 op fabrieks-hardware
Optionele trackingupgrade tracking-ld2460.yaml LD2460 alleen na vervangen/verwijderen van LD2450
Fijnstof complete.yaml SPS30 alleen op Complete varianten

Hoofdlogica voor Aanwezigheid

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

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. De zichtbare entiteitsnamen beginnen met Tracking.

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

LD2450 Target Entiteiten

Entiteitspatroon ESPHome ID-patroon Beschrijving
Tracking Target 1 X/Y/Speed/Angle/Distance/Resolution radar_target1_x, radar_target1_y, enz. Positie- en bewegingsdata van target 1.
Tracking Target 2 X/Y/Speed/Angle/Distance/Resolution radar_target2_x, radar_target2_y, enz. Positie- en bewegingsdata van target 2.
Tracking 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
Tracking Zone 1 Target Count Sensor Targets in zone 1.
Tracking Zone 1 Still Target Count Sensor Stilstaande targets in zone 1.
Tracking Zone 1 Moving Target Count Sensor Bewegende targets in zone 1.
Tracking Zone 1 X1/Y1/X2/Y2 Number Grenzen van zone 1.
Tracking Zone 2 Target Count Sensor Targets in zone 2.
Tracking Zone 2 Still Target Count Sensor Stilstaande targets in zone 2.
Tracking Zone 2 Moving Target Count Sensor Bewegende targets in zone 2.
Tracking Zone 2 X1/Y1/X2/Y2 Number Grenzen van zone 2.
Tracking Zone 3 Target Count Sensor Targets in zone 3.
Tracking Zone 3 Still Target Count Sensor Stilstaande targets in zone 3.
Tracking Zone 3 Moving Target Count Sensor Bewegende targets in zone 3.
Tracking Zone 3 X1/Y1/X2/Y2 Number Grenzen van zone 3.
Tracking Presence Timeout Number Timeout voordat tracking presence uitgaat.
Tracking Bluetooth Switch Zet LD2450 Bluetooth-configuratie aan.
Tracking Multi Target Switch Zet multi-target mode aan.
Tracking Restart Button Herstart de LD2450 module.
Tracking Factory Reset Button Factory reset voor LD2450; standaard uitgeschakeld.

Room Designer Polygon Zones

Mini 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. De huidige Mini v2 LD2450- en LD2460-pakketten bevatten beide deze gedeelde polygonzonelaag. 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 heeft de ID 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. Mini 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.

Lees LD2460-upgrade voordat je deze waarden of Room Designer instelt.

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 bovenop de ingebouwde SCD41-zelfopwarmingscompensatie.
Humidity Offset scd41_humidity_correction Number Correctie per apparaat voor de relatieve luchtvochtigheid van de SCD41.
Occupancy Off Delay occupancy_off_delay Number Vertraging voordat gecombineerde aanwezigheid uitschakelt.
${friendly_name} Firmware Variant firmware_selector Select WiFi- en Ethernet-builds: kiest Basic/Complete, WiFi/Ethernet en lokale/cloud-updatebron met behoud van de radarhardwarefamilie.
${friendly_name} Firmware firmware_update Update WiFi- en Ethernet-builds: controleert en installeert updates uit de gekozen manifest; standaard uitgeschakeld.

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
Status LED rgb_status_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 wifi_signal_sensor Alleen WiFi-varianten
WiFi IP Address wifi_ip_address Alleen WiFi-varianten
Connected SSID connected_ssid Alleen WiFi-varianten
Connected BSSID connected_bssid Alleen WiFi-varianten
WiFi MAC Address wifi_mac_address Alleen WiFi-varianten
WiFi DNS Address - Alleen WiFi-varianten
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 Mini v2

  • PIR bewegingssensor
  • Microfoon
  • Speaker
  • Media player
  • Voice assistant pipeline
  • Local wake word
  • Barometrische druksensor

Gerelateerd