Sensordefinities
Deze pagina legt alle sensorentiteiten uit die beschikbaar zijn op je UltimateSensor, hun betekenis en links naar ESPHome documentatie voor meer details.
Omgevingssensoren
CO₂, Temperatuur & Luchtvochtigheid (SCD41)
| Entiteit | Beschrijving | Eenheid |
|---|---|---|
SCD41 CO2 |
Koolstofdioxide concentratie | ppm |
SCD41 Temperature |
Omgevingstemperatuur | °C |
SCD41 Humidity |
Relatieve luchtvochtigheid | % |
De SCD41 is een zeer nauwkeurige foto-akoestische CO₂ sensor met ingebouwde temperatuur- en vochtigheidsmeting.
CO₂ Niveau Richtlijnen:
| Niveau | Betekenis |
|---|---|
| 400-450 ppm | Frisse buitenlucht |
| 600 ppm | Gezond binnenniveau |
| 800 ppm | Acceptabel binnen |
| 1.000 ppm | Ventilatie aanbevolen |
| 1.200 ppm | Ventilatie noodzakelijk |
| 2.000+ ppm | Slechte luchtkwaliteit, gezondheidseffecten |
Lichtsensor (BH1750)
| Entiteit | Beschrijving | Eenheid |
|---|---|---|
BH1750 Illuminance |
Omgevingslichtintensiteit | lux |
Meet lichtniveaus van 1 tot 65.535 lux.
Luchtkwaliteit (SGP4x)
| Entiteit | Beschrijving | Eenheid |
|---|---|---|
VOC Index |
Vluchtige Organische Stoffen index | index |
NOx Index |
Stikstofoxiden index | index |
De SGP4x biedt luchtkwaliteitsindices in plaats van ruwe ppm waarden:
- VOC Index: 0-500 (100 = gemiddelde baseline, hoger = meer VOC's)
- NOx Index: 0-500 (1 = schone lucht, hoger = meer NOx)
Fijnstof (SPS30): Alleen Complete
| Entiteit | Beschrijving | Eenheid |
|---|---|---|
PM <1µm Weight concentration |
Fijne deeltjes <1µm | µg/m³ |
PM <2.5µm Weight concentration |
Fijne deeltjes <2,5µm | µg/m³ |
PM <4µm Weight concentration |
Grove deeltjes <4µm | µg/m³ |
PM <10µm Weight concentration |
Grove deeltjes <10µm | µg/m³ |
PM <0.5µm Number concentration |
Deeltjesaantal <0,5µm | #/cm³ |
PM <1µm Number concentration |
Deeltjesaantal <1µm | #/cm³ |
PM <2.5µm Number concentration |
Deeltjesaantal <2,5µm | #/cm³ |
PM <4µm Number concentration |
Deeltjesaantal <4µm | #/cm³ |
PM <10µm Number concentration |
Deeltjesaantal <10µm | #/cm³ |
Typical Particle size |
Gemiddelde deeltjesgrootte | µm |
Bediening:
| Entiteit | Type | Beschrijving | Standaard |
|---|---|---|---|
PM Sensor |
Switch | Zet de SPS30 aan of uit | Aan |
SPS30 Update Interval |
Number | Hoe vaak de sensor leest terwijl hij actief is | 60 s |
SPS30 Idle Interval |
Number | Pauze tussen meetcycli; 0 houdt de sensor altijd aan | 5 min |
SPS30 Quiet Hours |
Switch | Stopt de ventilator en laser tijdens de uren hieronder | Uit |
SPS30 Quiet Start Hour, SPS30 Quiet End Hour |
Number | Begin en einde van de stille uren | 22, 7 |
SPS30 Quiet Hours Active |
Binary | Aan zolang de stille uren lopen | |
Night Mode |
Switch | Zet het OLED-display en de PM sensor samen uit | Uit |
PM2.5 Richtlijnen:
| Niveau | Luchtkwaliteit |
|---|---|
| 0-10 µg/m³ | Goed |
| 10-25 µg/m³ | Matig |
| 25-50 µg/m³ | Ongezond voor gevoelige personen |
| 50+ µg/m³ | Ongezond |
Aanwezigheid & Bewegingsdetectie
PIR Bewegingssensor
| Entiteit | Type | Beschrijving |
|---|---|---|
PIR Sensor |
Binary | Beweging gedetecteerd (aan/uit) |
Traditionele infrarood bewegingssensor voor snelle detectie van beweging. Heeft een ingebouwde 1-seconde uitschakelvertraging.
mmWave Radar (LD2450)
De LD2450 is een geavanceerde millimeter-golf radar die tot 3 personen gelijktijdig kan volgen, met positie, afstand, snelheid en hoekgegevens.
Let op: Hi-Link geeft de LD2450 op tot 6 meter. Detectie en zone-instellingen zijn tot dat bereik beperkt (6000 mm).
Aanwezigheidssensoren
| Entiteit | Type | Beschrijving |
|---|---|---|
Occupancy |
Binary | Algehele ruimtebezetting, volgt Tracking Presence |
Tracking Presence |
Binary | De radar ziet minstens één target |
Tracking Moving Target |
Binary | De radar ziet een bewegend target |
Tracking Still Target |
Binary | De radar ziet een stilstaand target |
Polygon Zone 1 Presence tot en met Polygon Zone 4 Presence |
Binary | Er is iemand in die polygonzone |
Target Tracking (3 Targets)
Voor elk target (1, 2, 3):
| Entiteit | Beschrijving | Eenheid |
|---|---|---|
Target X X |
Horizontale positie | mm |
Target X Y |
Afstand van sensor | mm |
Target X Speed |
Bewegingssnelheid | mm/s |
Target X Distance |
Euclidische afstand | mm |
Target X Angle |
Hoek vanaf sensorcentrum | ° |
Target X Resolution |
Detectieresolutie | mm |
Tellingen
| Entiteit | Beschrijving |
|---|---|
Radar Target Count |
Alle targets die de radar ziet |
Radar Moving Target Count |
Bewegende targets |
Radar Still Target Count |
Stilstaande targets |
Polygon Zone 1 Target Count tot en met Polygon Zone 4 Target Count |
Aantal personen in die polygonzone |
People Count |
Lopende telling van de kamer op basis van je tellijnen, blijft bewaard na een herstart |
Last Crossing Direction |
Richting van de laatste passage over een tellijn: in of out |
Zone Configuratie
Teken zones in de Room Designer van de SmartHomeShop-integratie. Die slaat ze op in deze entiteiten:
| Entiteit | Type | Beschrijving |
|---|---|---|
Polygon Zone 1 tot en met Polygon Zone 4 |
Text | Vorm van de zone, tot 20 punten |
Polygon Exclusion 1, Polygon Exclusion 2 |
Text | Gebied waar targets worden genegeerd |
Entry Line 1, Entry Line 2 |
Text | Lijn met een in- en uitrichting voor personentelling |
Polygon Zones Enabled |
Switch | Zet alle polygonzones aan of uit, standaard aan |
Reset People Count |
Button | Zet People Count terug naar nul |
De radar heeft ook drie eigen rechthoekige zones: Zone 1 X1, Y1, X2 en Y2, tot en met Zone 3. De tellingen daarvan zijn Zone 1 Target Count tot en met Zone 3 Target Count, elk ook als still- en moving-versie. Die heb je niet nodig als je polygonzones gebruikt.
Het Coördinatensysteem Begrijpen
Sensor (0,0)
|
-X <---+---> +X
|
v
+Y (afstand van sensor)
- X-as: Links (negatief) naar rechts (positief), in mm
- Y-as: Afstand van sensor, in mm. De Room Designer rekent met een bereik van 6000 mm
Globale Instellingen
| Entiteit | Beschrijving | Bereik |
|---|---|---|
Tracking Presence Timeout |
Tijd tot aanwezigheid vervalt na de laatste detectie | 1-600 s |
LD2450 Multi Target |
Volgt meerdere targets tegelijk | aan/uit |
LD2450 Bluetooth |
Bluetooth van de radar, voor de HLK Radar Tool app | aan/uit |
Display
De UltimateSensor heeft een ingebouwd SSD1306 OLED display (128x64 pixels) dat toont:
- CO₂ niveau (groot)
- Temperatuur
- Luchtvochtigheid
- Licht (lux)
- PIR indicator
Het display wordt automatisch bijgewerkt. Zet het uit met de schakelaar LCD Display. Op een Complete-apparaat zet Night Mode het display en de PM sensor samen uit.
📖 ESPHome SSD1306 Documentatie
LED
| Entiteit | Type | Beschrijving |
|---|---|---|
Back Light |
Light | RGB LED aan achterkant van apparaat |
De WS2812B LED kan worden bediend via Home Assistant voor statusindicatie of sfeerverlichting.
Automatische LED-verlichting
Sinds firmware 2.4 kan de LED ook zelfstandig werken. Dit staat allemaal standaard uit en blijft bewaard na een herstart. Zet eerst Automatic LED Lighting aan. Zolang die aan staat, bestuurt de firmware de LED. Op cloudfirmware stel je dit ook in via de SmartHomeShop-app.
| Entiteit | Wat het doet | Standaard |
|---|---|---|
Automatic LED Lighting |
Hoofdschakelaar | Uit |
Motion Light, Motion Light Brightness |
Wit licht bij beweging van de PIR of de radar | Uit, 70% |
Night Light, Night Light Brightness |
Warm licht als er iemand is tijdens de nachturen | Uit, 10% |
Night Light Start Hour, Night Light End Hour |
De nachturen | 22, 7 |
CO2 LED Warning |
Drie oranje flitsen bij het waarschuwingsniveau, drie rode flitsen bij het kritieke niveau | Uit |
CO2 Warning Threshold, CO2 Critical Threshold |
De twee CO₂-niveaus | 1000 ppm, 1500 ppm |
CO2 Alert Cooldown |
Wachttijd tussen waarschuwingen | 5 min |
Apparaatbediening
| Entiteit | Type | Beschrijving |
|---|---|---|
Restart UltimateSensor |
Button | Herstart het apparaat |
CO2 manual calibration |
Button | Trigger CO₂ kalibratie (buiten, 419 ppm) |
LCD Display |
Switch | Zet het OLED-display aan of uit |
UltimateSensor Firmware Variant |
Select | Kiest de firmwarevariant, zie de Firmware Handleiding |
LD2450 Restart |
Button | Herstart alleen de radar |
LD2450 Factory Reset |
Button | Zet de radar terug, standaard uitgeschakeld |
Diagnostische Entiteiten
| Entiteit | Beschrijving |
|---|---|
IP Address |
Huidig IP-adres, standaard uitgeschakeld |
ESP MAC |
MAC-adres van het apparaat, standaard uitgeschakeld |
Connected SSID |
WiFi netwerknaam |
Connected BSSID |
WiFi access point MAC, standaard uitgeschakeld |
CPU Temperature |
Interne temperatuur van de ESP32 |
ESPHome Version |
ESPHome firmware versie |
Software Version |
UltimateSensor software versie |
Hardware Version |
Hardware variant (V1-Basic/Complete) |
Connection type |
WiFi of Ethernet |
LD2450 Firmware, LD2450 Bluetooth MAC |
Firmware en Bluetooth-adres van de radar |
UltimateSensor Firmware |
Update-entiteit, standaard uitgeschakeld |
De entiteiten die met Radar beginnen, zoals Radar Model en Radar Mounting Mode, vertellen de Room Designer hoe de radar is gemonteerd. Die hoef je niet aan te passen. Ethernet firmware heeft geen WiFi-entiteiten.
ESPHome Configuratie
De UltimateSensor gebruikt ESPHome met de volgende belangrijke substitutions:
substitutions:
device_name: ultimatesensor
friendly_name: "UltimateSensor"
ultimatesensor_hardware_version: "V1-Complete" # of V1-Basic
ultimatesensor_connection_type: "WiFi" # of Ethernet
GitHub Broncode
Alle firmware configuraties zijn open source:
- WiFi Basic:
ultimatesensor-wifi-basic.yaml - WiFi Complete:
ultimatesensor-wifi-complete.yaml - Ethernet Basic:
ultimatesensor-ethernet-basic.yaml - Ethernet Complete:
ultimatesensor-ethernet-complete.yaml
👉 github.com/smarthomeshop/ultimatesensor
Adopteren in ESPHome
Om je UltimateSensor aan te passen:
- Open ESPHome Device Builder in Home Assistant
- Klik op Adopt op het ontdekte apparaat
- Bewerk de YAML configuratie
- Deploy wijzigingen via OTA
Zie Gebruikshandleiding voor aanpassingsvoorbeelden.