Firmwarehandleiding

Lokale werking en GitHub-updatecontrole

De lokale Home Assistant-firmware houdt de metingen van UltimateSensor Mini v2 op je eigen netwerk. Sensorwaarden gaan rechtstreeks naar Home Assistant en worden niet naar GitHub of de SmartHomeShop-cloud gestuurd.

WiFi- en Ethernetfirmware bevat een ESPHome-update-entiteit. Deze leest periodiek een klein firmwaremanifest vanaf SmartHomeShop GitHub Pages om de geïnstalleerde versie met de nieuwste release te vergelijken. Alleen firmwaremetadata wordt opgevraagd; het firmwarebestand wordt pas gedownload wanneer je een update installeert.

Cloudfirmware communiceert voor de cloudfuncties bewust met de SmartHomeShop-app. Het uitschakelen van de GitHub-controle verandert cloudfirmware niet in lokale firmware. Thread-firmware heeft geen updatecontrole.

UltimateSensor Mini v2 zonder internettoegang gebruiken

Je mag internettoegang voor UltimateSensor Mini v2 blokkeren; de lokale metingen en Home Assistant-verbinding blijven werken. De stille uren van de SPS30 halen de tijd bij openbare NTP-servers, dus sta NTP toe als je die gebruikt. Wil je voorkomen dat een geblokkeerde controle de rode status-led activeert? Neem het apparaat dan over in de ESPHome Device Builder-app/add-on, open de YAML en voeg dit onderaan toe:

update:
  - id: !extend firmware_update
    update_interval: never

Sla de YAML op, kies Validate en installeer de build met Install > Wirelessly. Hiermee schakel je alleen geplande controles uit; het updatecomponent en alle UltimateSensor Mini v2-sensoren blijven aanwezig.

De geadopteerde YAML bevat nog steeds een packages:-verwijzing naar de SmartHomeShop GitHub-repository. ESPHome gebruikt die verwijzing op de Home Assistant-host tijdens het compileren. Nadat de aangepaste build is geïnstalleerd, vraagt het apparaat zelf niet meer periodiek de firmwareversie op.

Wil je automatische controles herstellen? Verwijder dan het toegevoegde update:-blok en installeer de firmware opnieuw. Kan ESPHome het ID firmware_update niet vinden, werk UltimateSensor Mini v2 dan eerst bij via de SmartHomeShop-webflasher.

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

Mini v2 gebruikt de gedeelde SmartHomeShop LD2450- en LD2460-radarpakketten. De webinterface van het apparaat groepeert Air Quality en Presence, cloudtelemetrie bevat CPU-temperatuur en alle WiFi-builds bevatten de SmartHomeShop-setupportal.

UltimateSensor Mini v2 is gebaseerd op ESP32-C6 en elke Mini v2 firmwarevariant bevat:

• SCD41 CO2 / temperatuur / luchtvochtigheid
• SGP41 VOC / NOx
• BH1750 verlichtingssterkte
• LD2412 aanwezigheidsradar
• LD2450 target tracking op standaard hardware
• WiFi of Ethernet als aparte firmwarebuilds

Mini v2 firmware bevat geen microfoon, speaker, media player, PIR, voice assistant of local wake word ondersteuning.

GitHub Bron

• Firmware repository: github.com/smarthomeshop/ultimatesensor-mini
• Mini v2 map: ultimatesensor-mini-v2

Package Indeling

Standaard Firmwarevarianten

Deze zijn voor het product zoals geleverd met LD2412 + LD2450.

LD2460 Upgrade Varianten

Gebruik deze alleen nadat de LD2450 module fysiek is vervangen/verwijderd en de optionele LD2460 upgrade is geplaatst. Laat de LD2412 geplaatst.

Lees voor montage de Mini v2 LD2460-upgradehandleiding.

Cloud Build Varianten

Cloud varianten voegen SmartHomeShop cloud registratie/sync entiteiten toe bovenop de bijbehorende standaard- of LD2460-build.

Variantregels

• Basic gebruikt geen complete.yaml; er zijn geen SPS30 PM entiteiten.
• Complete gebruikt complete.yaml; SPS30 PM entiteiten en PM Sensor controls zijn aanwezig.
• WiFi en Ethernet zijn aparte firmwarebuilds. ESPHome draait niet tegelijk op WiFi en Ethernet.
• LD2450 is de fabrieksstandaard.
• LD2460 is alleen upgradefirmware. Flash dit niet tenzij LD2460 hardware is geplaatst.
• Mini v2 heeft geen voice firmwarevariant.

Firmwarebediening in Home Assistant

Elke WiFi- en Ethernet-build toont:

• UltimateSensor Mini V2 Firmware Variant om Basic/Complete, WiFi/Ethernet en lokale/cloudfirmware te kiezen, waarbij de geplaatste LD2450- of LD2460-hardwarefamilie behouden blijft;
• UltimateSensor Mini V2 Firmware, een standaard uitgeschakelde update-entiteit die de gekozen manifest controleert en installeert.

Schakel de update-entiteit eerst in. De selector wijzigt alleen de updatebron. De andere firmware wordt pas geïnstalleerd wanneer je de update via de Firmware-entiteit uitvoert. Thread-builds hebben deze entiteiten niet: die werk je bij via de ESPHome Device Builder.

Flashen

Web Flasher

Let op: De webflasher zet het apparaat terug naar de fabrieksinstellingen. WiFi-gegevens en op het apparaat bewaarde instellingen, zoals offsets, worden gewist.

1. Verbind UltimateSensor Mini v2 met een USB-C-kabel die data doorgeeft met je computer en gebruik Chrome of Edge.
2. Open smarthomeshop.io/firmware?product=ultimatesensor-mini.
3. Kies V2 (hardwareversie 2) en hoe je het apparaat gebruikt: Lokaal met Home Assistant of SmartHomeShop-app + lokaal gebruik.
4. Selecteer de juiste Mini v2 variant:
   • WiFi of Ethernet
   • Basic of Complete
   • LD2450 standaard of LD2460 upgrade
5. Klik op Firmware installeren en kies de USB-poort van je apparaat.

ESPHome Device Builder

Na adoptie importeert het apparaat een Mini v2 package URL, bijvoorbeeld:

dashboard_import:
  package_import_url: github://smarthomeshop/ultimatesensor-mini/ultimatesensor-mini-v2/ultimatesensor-mini-v2-wifi-complete.yaml@main

Wijzig alleen naar een andere ultimatesensor-mini-v2/... package die klopt met de hardware.

Aanpassen via ESPHome Device Builder

Gebruik dit wanneer je een permanente YAML wijziging wilt doen, zoals het aanpassen van scd41_temperature_offset.

Belangrijk verschil:

• ESPHome integratie in Home Assistant is hoe de Mini v2 communiceert met Home Assistant.
• ESPHome Device Builder-app is de tool waarmee je YAML bewerkt, firmware buildt en naar het apparaat uploadt.

Alleen de integratie hebben is dus niet genoeg voor YAML wijzigingen. Installeer en gebruik de ESPHome Device Builder-app.

1. Open Home Assistant -> Instellingen -> Apps.
2. Installeer en start de ESPHome Device Builder-app als die nog niet is geïnstalleerd.
3. Open ESPHome Device Builder vanuit de Home Assistant zijbalk.
4. Verschijnt de Mini v2 als ontdekt apparaat, klik dan Adopt.
5. Klik na adoptie op Edit op de Mini v2 kaart.
6. Laat de packages: import staan en wijzig alleen de nodige substitutions.
7. Klik Save.
8. Klik Install -> Wirelessly om de aangepaste firmware te builden en uploaden.
9. Wacht tot de Mini v2 herstart en opnieuw verbindt.

Voor temperatuurkalibratie gaat het om dit stuk:

substitutions:
  scd41_temperature_offset: "10.2"

Als je temperatuur via deze substitution afstelt, laat de Home Assistant Temperature Offset entiteit op 0 staan om dubbele correctie te voorkomen. Lukt draadloos uploaden niet, flash dan via USB-C met de web flasher.

Bekijk voor de geavanceerde, zelfgebouwde Ethernet Basic-configuratie Zelf een Bluetooth Proxy bouwen. Dit zit niet in de standaardfirmware.

WiFi en Ethernet

• WiFi varianten houden de W5500 Ethernet hardware uitgeschakeld en in reset.
• Ethernet varianten zetten de W5500 aan en tonen Ethernet netwerkinfo entiteiten.
• Mini v2 WiFi-firmware gebruikt de SmartHomeShop-setupportal bovenop de captive portal. Hiermee stel je WiFi in, kies je Home Assistant en/of SmartHomeShop-app-cloudgebruik en kies je de WiFi/Ethernet- plus Basic/Complete-firmwarefamilie.
• BLE Improv blijft beschikbaar als alternatieve onboardingmethode.
• Serial Improv is niet inbegrepen omdat beide hardware UARTs nodig zijn voor LD2412 en LD2450/LD2460.
• Sluit eerst de netwerkkabel aan voordat je van WiFi naar Ethernet wisselt, en houd USB-C aangesloten tot de Ethernet-firmware draait. PoE werkt alleen met Ethernet-firmware.
• Terug van Ethernet naar WiFi doe je via USB-C flashing. Reken niet op OTA, omdat de netwerkverbinding kan wegvallen voordat WiFi firmware is geinstalleerd.

Firmware Entiteitsnamen

Zie Sensor Definities voor de exacte entiteitsnamen en ESPHome IDs uit de huidige firmware.

Hulp Nodig?

• Support portaal
• Discord
• GitHub repository

Thread-firmware

De UltimateSensor Mini v2 kan in plaats van WiFi of Ethernet ook een Thread-netwerk joinen, voor lokaal gebruik met Home Assistant via een Thread border router. Zie UltimateSensor Mini v2 verbinden via Thread.