Sensor Definities

Deze pagina legt alle sensor entiteiten uit die beschikbaar zijn op je UltimateSensor Mini, hun betekenis en links naar ESPHome documentatie voor meer details.

---

Omgevingssensoren

CO₂, Temperatuur & Luchtvochtigheid (SCD41)

Entiteit	Beschrijving	Eenheid
SCD41 CO2	Kooldioxide concentratie	ppm
SCD41 Temperature	Omgevingstemperatuur	°C
SCD41 Humidity	Relatieve luchtvochtigheid	%

De SCD41 is een hoog-nauwkeurige foto-akoestische CO₂ sensor met ingebouwde temperatuur- en vochtigheidsmeting.

Ingebouwde Offsets:

• Temperatuur: -2,3°C offset toegepast
• Luchtvochtigheid: +3% offset toegepast

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. Update elke 60 seconden.

📖 ESPHome BH1750 Documentatie

---

Luchtkwaliteit (SGP41)

Entiteit	Beschrijving	Eenheid
VOC Index	Vluchtige Organische Stoffen index	index
NOx Index	Stikstofoxiden index	index

De SGP41 levert luchtkwaliteitsindices met temperatuur/vochtigheidscompensatie van de SCD41:

• VOC Index: 0-500 (100 = gemiddelde baseline, hoger = meer VOCs)
• NOx Index: 0-500 (1 = schone lucht, hoger = meer NOx)

📖 ESPHome SGP4x Documentatie

---

Aanwezigheid & Bewegingsdetectie (LD2450)

De LD2450 is een millimetergolf-radar die tot 3 personen tegelijk kan volgen.

Bezettingssensoren

Entiteit	Type	Beschrijving
Occupancy	Binary	Algemene kamerbezetting
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 (standaard uitgeschakeld)

Doeltracking (3 Doelen)

Voor elk doel (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	Doel momenteel gedetecteerd	aan/uit

Zone Doel Tellingen

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 (standaard uitgeschakeld)

📖 Hi-Link LD2450 Datasheet

---

Zone Configuratie

Elke zone kan geconfigureerd worden met deze number entiteiten:

Entiteit	Beschrijving	Bereik	Standaard
Zone X Begin X	Linkergrens	-4000 tot 4000 mm	-4000
Zone X End X	Rechtergrens	-4000 tot 4000 mm	4000
Zone X Begin Y	Dichtbijgrens	0 tot 6000 mm	0
Zone X End Y	Vergrens	0 tot 6000 mm	6000
Zone X Occupancy Off Delay	Vertraging voordat leeg gemeld wordt	0-600 s	15

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	Standaard
Occupancy Off Delay	Globale vertraging voordat "geen bezetting"	0-600 s	15
Max Distance	Maximale detectieafstand	0-600 cm	600

---

Voice Assistant & Audio

Media Player

Entiteit	Type	Beschrijving
US Mini Media Player	Media Player	Audio afspelen, TTS, mededelingen

De media player kan:

• MP3 bestanden afspelen van URLs
• Text-to-speech mededelingen
• Alarmgeluiden
• Volume regeling (0-100%)

📖 ESPHome I2S Audio Documentatie

Voice Assistant Bediening

Entiteit	Type	Beschrijving
Use wake word	Schakelaar	Wake word detectie in-/uitschakelen

Wanneer ingeschakeld, luistert het apparaat continu naar het geconfigureerde wake word en verwerkt spraakcommando's via Home Assistant.

📖 ESPHome Voice Assistant Documentatie

---

LEDs

Entiteit	Type	Beschrijving
Front light	Lamp	RGB LED aan voorkant van apparaat
Back light	Lamp	RGB LED aan achterkant van apparaat

Beide zijn WS2812B RGB LEDs bedienbaar via Home Assistant.

Voice Feedback:

• Front LED wordt rood wanneer wake word gedetecteerd wordt
• LED gaat uit wanneer spraakverwerking start

📖 ESPHome FastLED Light Documentatie

---

Apparaatbediening

Entiteit	Type	Beschrijving
Restart	Knop	Herstart het apparaat
CO2 manual calibration	Knop	Trigger CO₂ kalibratie (buiten, 420 ppm)
Factory Reset	Knop	Volledige factory reset (standaard uitgeschakeld)

---

Diagnostische Entiteiten

Entiteit	Beschrijving
IP address	Huidig IP-adres
Connected SSID	WiFi netwerknaam
Connected BSSID	WiFi access point MAC
MAC Address	Apparaat MAC-adres
WiFi Signal	Signaalsterkte (dBm)
CPU Temperature	ESP32-S3 interne temperatuur
ESPHome Version	ESPHome firmware versie
Software Version	UltimateSensor Mini software versie
Hardware Version	Hardware variant
API Connection	Home Assistant verbindingsstatus

---

ESPHome Configuratie

De UltimateSensor Mini gebruikt ESPHome met de volgende belangrijke substitutions:

substitutions:
  device_name: ultimatesensor-mini
  friendly_name: "UltimateSensor Mini"
  project_version: "2.15"
  ultimatesensor_mini_hardware_version: "V1"  # of specifieke variant

GitHub Broncode

Alle firmware configuraties zijn open source:

• Basic: ultimatesensor-mini-basic.yaml
• Complete: ultimatesensor-mini-complete.yaml
• Common: ultimatesensor-mini-common.yaml (gedeelde configuratie)

👉 github.com/smarthomeshop/ultimatesensor-mini

Adopteren in ESPHome

Om je UltimateSensor Mini aan te passen:

1. Open ESPHome Dashboard in Home Assistant
2. Het apparaat zou moeten verschijnen als "Discovered"
3. Klik Adopt om het toe te voegen aan je ESPHome
4. Bewerk de YAML configuratie
5. Deploy wijzigingen via OTA

---

Verschillen met UltimateSensor

Kenmerk	Mini	Regulier
PIR Sensor	❌	✅
OLED Display	❌	✅
PM Sensor	❌	✅ (Complete)
Voice Assistant	✅	❌
Ethernet/PoE	❌	✅
Status LED	GPIO19	GPIO14
ESP Chip	ESP32-S3	ESP32

Zie Gebruikershandleiding voor aanpassingsvoorbeelden.