Sensor Definities

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

📖 ESPHome SCD4x Documentatie

Lichtsensor (BH1750)

Entiteit	Beschrijving	Eenheid
`BH1750 Illuminance`	Omgevingslichtintensiteit	lux

Meet lichtniveaus van 1 tot 65.535 lux.

📖 ESPHome BH1750 Documentatie

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)

📖 ESPHome SGP4x Documentatie

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

PM2.5 Richtlijnen (WHO):

Niveau	Luchtkwaliteit
0-10 µg/m³	Goed
10-25 µg/m³	Matig
25-50 µg/m³	Ongezond voor gevoelige personen
50+ µg/m³	Ongezond

📖 ESPHome SPS30 Documentatie

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.

📖 ESPHome GPIO Binary Sensor

mmWave Radar (LD2450)

De LD2450 is een geavanceerde millimeter-golf radar die tot 3 personen gelijktijdig kan volgen, met positie, afstand, snelheid en hoekgegevens.

Aanwezigheidssensoren

Entiteit	Type	Beschrijving
`Occupancy`	Binary	Algehele ruimtebezetting
`Zone 1 Occupancy`	Binary	Zone 1 bezet
`Zone 2 Occupancy`	Binary	Zone 2 bezet
`Zone 3 Occupancy`	Binary	Zone 3 bezet
`Zone 4 Occupancy`	Binary	Zone 4 bezet

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	m/s
`Target X Distance`	Euclidische afstand	mm
`Target X Angle`	Hoek vanaf sensorcentrum	°
`Target X Resolution`	Detectieresolutie	mm
`Target X Active`	Target momenteel gedetecteerd	aan/uit

Zone Target Counts

Entiteit	Beschrijving
`Zone 1 Target Count`	Aantal personen in Zone 1
`Zone 2 Target Count`	Aantal personen in Zone 2
`Zone 3 Target Count`	Aantal personen in Zone 3
`Zone 4 Target Count`	Aantal personen in Zone 4

📖 Hi-Link LD2450 Datasheet

Zone Configuratie

Elke zone kan worden geconfigureerd met deze number entiteiten:

Entiteit	Beschrijving	Bereik
`Zone X Begin X`	Linkergrens	-4000 tot 4000 mm
`Zone X End X`	Rechtergrens	-4000 tot 4000 mm
`Zone X Begin Y`	Nabije grens	0 tot 6000 mm
`Zone X End Y`	Verre grens	0 tot 6000 mm
`Zone X Occupancy Off Delay`	Vertraging voor leeg melden	0-600 s

Het Coördinatensysteem Begrijpen

        Sensor (0,0)
           |
    -X <---+---> +X
           |
           v
          +Y (afstand van sensor)

X-as: Links (-4000mm) naar Rechts (+4000mm)
Y-as: Afstand van sensor (0 tot 6000mm)

Globale Instellingen

Entiteit	Beschrijving	Bereik
`Occupancy Off Delay`	Globale vertraging voor "geen aanwezigheid"	0-600 s
`Max Distance`	Maximale detectieafstand	0-600 cm

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 en kan niet worden bediend via Home Assistant.

📖 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.

📖 ESPHome NeoPixelBus Light

Apparaatbediening

Entiteit	Type	Beschrijving
`Restart UltimateSensor`	Button	Herstart het apparaat
`CO2 manual calibration`	Button	Trigger CO₂ kalibratie (buiten, 419 ppm)

Diagnostische Entiteiten

Entiteit	Beschrijving
`IP address`	Huidig IP-adres
`Connected SSID`	WiFi netwerknaam
`Connected BSSID`	WiFi access point MAC
`ESPHome Version`	ESPHome firmware versie
`Software Version`	UltimateSensor software versie
`Hardware Version`	Hardware variant (V1-Basic/Complete)
`Connection type`	WiFi of Ethernet

ESPHome Configuratie

De UltimateSensor gebruikt ESPHome met de volgende belangrijke substitutions:

yaml

substitutions:
  device_name: ultimatesensor
  friendly_name: "UltimateSensor"
  ultimatesensor_software_version: "1.2"
  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 Dashboard in Home Assistant
Klik op Adopt op het ontdekte apparaat
Bewerk de YAML configuratie
Deploy wijzigingen via OTA

Zie Gebruikshandleiding voor aanpassingsvoorbeelden.

Sensor Definities ​

Omgevingssensoren ​

CO₂, Temperatuur & Luchtvochtigheid (SCD41) ​

Lichtsensor (BH1750) ​

Luchtkwaliteit (SGP4x) ​

Fijnstof (SPS30) — Alleen Complete ​

Aanwezigheid & Bewegingsdetectie ​

PIR Bewegingssensor ​

mmWave Radar (LD2450) ​

Aanwezigheidssensoren ​

Target Tracking (3 Targets) ​

Zone Target Counts ​

Zone Configuratie ​

Het Coördinatensysteem Begrijpen ​

Globale Instellingen ​

Display ​

LED ​

Apparaatbediening ​

Diagnostische Entiteiten ​

ESPHome Configuratie ​

GitHub Broncode ​

Adopteren in ESPHome ​