Zelf een Bluetooth Proxy Bouwen

Je kunt een UltimateSensor Mini v2 Ethernet als ESPHome Bluetooth Proxy gebruiken door twee componenten aan de eigen ESPHome-configuratie toe te voegen en de firmware zelf te compileren.

Geavanceerde en niet-ondersteunde aanpassing: Bluetooth-scanning draait continu en gebruikt extra RAM, processortijd en netwerkcapaciteit. SmartHomeShop adviseert dit alleen voor UltimateSensor Mini v2 Ethernet Basic. Het is geen onderdeel van de standaardfirmware en geen gegarandeerde productfunctie.

Compatibiliteit

Ethernet heeft de voorkeur omdat WiFi en Bluetooth dan niet om radiotijd concurreren. In de Basic-firmware ontbreekt bovendien de SPS30-fijnstofcomponent, waardoor meer capaciteit beschikbaar blijft.

Mini v2 gebruikt een single-core ESP32-C6 zonder extern PSRAM. De Bluetooth-stack en continue tracker concurreren daardoor rechtstreeks met de gewone sensoren, radars, API en webserver om het beschikbare geheugen en de processortijd.

Voor Je Begint

Je hebt nodig:

• een UltimateSensor Mini v2 met Ethernet Basic firmware;
• een werkende Ethernet- of PoE-verbinding;
• de ESPHome Device Builder-app in Home Assistant;
• een back-up van de geadopteerde apparaat-YAML;
• fysieke toegang tot de USB-C-poort voor het geval een OTA-update mislukt.

Een Bluetooth Proxy kan niet na het compileren met alleen een Home Assistant-schakelaar worden toegevoegd. De proxycomponenten moeten aanwezig zijn wanneer ESPHome de firmware bouwt.

Bluetooth Proxy Toevoegen

1. Open Home Assistant -> Instellingen -> Apps.
2. Installeer en start ESPHome Device Builder als deze nog niet is geinstalleerd.
3. Open ESPHome Device Builder vanuit de Home Assistant-zijbalk.
4. Staat de Mini v2 daar nog niet als beheerd apparaat, klik dan Adopt.
5. Open het apparaatmenu, kies Edit en bewaar een kopie van de bestaande YAML.
6. Laat de bestaande onderdelen substitutions: en packages: ongewijzigd.
7. Voeg dit blok zonder inspringing op rootniveau toe:

esp32_ble_tracker:

bluetooth_proxy:
  active: true
  connection_slots: 1

Het einde van je configuratie hoort ongeveer deze structuur te hebben:

substitutions:
  # Bestaande apparaatsubstitutions blijven hier staan.

packages:
  # Bestaande SmartHomeShop-package-import blijft hier staan.

esp32_ble_tracker:

bluetooth_proxy:
  active: true
  connection_slots: 1

Maak geen tweede SmartHomeShop-package en vervang de bestaande firmware-import niet. ESPHome voegt de extra componenten op rootniveau tijdens het compileren samen met de geimporteerde Mini v2-configuratie.

Valideren en Installeren

1. Kies Validate in ESPHome Device Builder en los iedere fout op voordat je installeert.
2. Kies Install -> Wirelessly.
3. Wacht tot compileren, uploaden en herstarten zijn afgerond.
4. Controleer of de Mini v2 opnieuw via Ethernet verbindt en of de gewone sensorentiteiten blijven verversen.
5. Open Instellingen -> Apparaten en diensten in Home Assistant en controleer de Bluetooth-integratie. De ESPHome-proxy hoort automatisch beschikbaar te worden nadat het ESPHome-apparaat opnieuw is verbonden.

Gebruik installatie via USB-C wanneer de draadloze upload mislukt of het apparaat niet meer online komt.

Waarom Slechts Een Connection Slot?

connection_slots beperkt het aantal gelijktijdige actieve Bluetooth-verbindingen. ESPHome vermeldt ongeveer 1 KB RAM per slot, naast de belasting van de Bluetooth-stack en tracker. Een slot is de voorzichtige keuze voor een sensor die ook aanwezigheidsradars, luchtkwaliteitssensoren, een webserver, de ESPHome-API en diagnostiek uitvoert.

Passieve Bluetooth-advertenties gebruiken niet allemaal een eigen connection slot. Een slot is nodig wanneer Home Assistant actief verbinding moet maken met een Bluetooth-apparaat, bijvoorbeeld om een GATT-eigenschap uit te lezen.

Verhoog het aantal slots pas nadat de Mini v2 meerdere dagen betrouwbaar heeft gedraaid. Controleer:

• onverwachte herstarts of verbroken verbindingen;
• ESPHome-waarschuwingen over geheugen, API of Bluetooth;
• vertraagde aanwezigheids- of luchtkwaliteitsupdates;
• mislukte actieve Bluetooth-verbindingen;
• apparaattemperatuur en algemene reactiesnelheid.

Behoud de Standaard Scaninstellingen

Begin met een leeg esp32_ble_tracker:-blok zoals hierboven. Stel niet direct agressieve scan_parameters in. Sneller of langer scannen verhoogt CPU- en radiogebruik en kan een zwaar belast apparaat instabiel maken.

Wijzig scanparameters alleen wanneer je het advertentie-interval van het doelapparaat begrijpt en de volledige Mini v2 opnieuw kunt testen.

Probleemoplossing

ESPHome-validatie mislukt

Controleer of esp32_ble_tracker: en bluetooth_proxy: helemaal links in de YAML beginnen en niet onder packages: staan. Controleer ook of iedere component maar eenmaal in de uiteindelijke configuratie voorkomt.

De Mini v2 herstart of wordt onbetrouwbaar

Zet de back-up-YAML terug en verwijder beide Bluetooth-blokken. Bouw en installeer de configuratie opnieuw. Is OTA niet meer bereikbaar, flash dan via USB-C de normale Ethernet Basic-firmware.

Home Assistant ziet advertenties maar kan niet verbinden

Het ene actieve connection slot kan al bezet zijn. Wacht tot de huidige verbinding sluit en probeer opnieuw. Meer slots kunnen helpen, maar gebruiken ook meer capaciteit en zijn niet de geadviseerde standaard.

Een Bluetooth-apparaat wordt niet gevonden

Plaats de Mini v2 dichter bij het Bluetooth-apparaat, verwijder bronnen van radio-interferentie en test eerst met de standaard scaninstellingen van ESPHome. Sommige apparaten adverteren weinig of vereisen een actieve verbinding.

Terug Naar Standaardfirmware

De proxy verwijderen:

1. verwijder esp32_ble_tracker: en het volledige bluetooth_proxy:-blok uit de geadopteerde YAML;
2. valideer en installeer de configuratie opnieuw; of
3. flash via de SmartHomeShop-webflasher de normale Mini v2 Ethernet Basic-firmware.

De standaard SmartHomeShop-firmware blijft door deze handleiding ongewijzigd.

Technische Bronnen

• ESPHome Bluetooth Proxy
• ESPHome Bluetooth Low Energy Tracker
• Functieverzoek en discussie