Keuze voor basis of geavanceerde configuratie.
De basisinstructie zorgt dat het apparaat gebruikt kan worden, maar onbeveiligd met Home Assistant communiceert en geen firmware updates kan ontvangen. Hiervan kan een aanvaller alleen misbruik maken als deze reeds toegang tot je thuisnetwerk heeft.
De geavanceerde instructie zorgt dat het apparaat van firmware updates kan worden voorzien en beveiligt de communicatie met Home Assistant.
Je kunt starten met de basisinstructie en op een later tijdstip alsnog de geavanceerde instructies volgen.
Basisconfiguratie Bluetooth Proxy
- Voorzie de Bluetooth Proxy via USB-C van stroom.
- Wacht totdat je de SSID “bluetooth-proxy-xxxxxx” (xxxxxx is willekeurig en verschilt per module) ziet en verbind daar mee. Het wachtwoord is 12345678. Het kan tot 1 minuut duren voordat deze SSID zichtbaar wordt.
- Nu kom je in een captive portal waar je gevraag wordt met welke Wifi de module moet verbinden. Klik het juiste SSID aan of vul handmatig de Wifi instellingen in en druk op Save.
- De module zal nu met deze Wifi gaan verbinden en door je Home Assistant gedetecteerd worden onder Meldingen, of je kunt hem vinden onder Instellingen, Apparaten en diensten als “Bluetooth Proxy xxxxxx”
- Druk op Toevoegen en in het volgende dialoogvenster op Verzenden.
Geavanceerde configuratie Bluetooth Proxy
Benodigdheden / aannames voor start configuratie
ESPHome Builder App dient geinstalleerd te zijn binnen Home Assistant.
Hier lees je hoe deze te installeren: https://esphome.io/guides/getting_started_hassio/
Wat doet het?
ESPHome Builder wordt gebruikt om instellingen van ESPHome apparaten bij te houden (YAML code met configuratiegegevens) en is nodig om Firmware updates uit te kunnen voeren op ESPHome gebaseerde apparaten. Zonder een YAML weet ESPHome niet wat de module moet doen en kan er ook geen update op geinstalleerd worden.
ESPHome Builder staat los van ESPHome apparaten binnen Home Assistant, een apparaat kan wel in ESPHome Builder staan maar niet in Home Assistant en vice versa.
Zie het alsof een ESPHome apparaat een laptop is, daar staan allerlei instellingen op, maar die heb je nergens opgeslagen behalve op je laptop.
ESPHome Builder bevat de configuratiegegevens (YAML) waarin staat beschreven welke instellingen op het apparaat moeten staan.
Bij het uitkomen van updates voor ESPHome, kan de ESPHome Builder met deze YAML een nieuwe firmware maken voor het apparaat en zo het ESPHome apparaat van een update voorzien zonder dat functionaliteit verloren gaat.
- Installeer indien nodig de juiste seriele drivers (CH9102, te downloaden via https://www.wch-ic.com/downloads/CH343SER_EXE.html).
- Sluit het apparaat met een USB-C kabel aan op je PC.
- Ga binnen Home Assistant naar de ESPHome Builder.
- Druk op “New Device”.
- Kies voor “New Device Setup”.
- Geef het apparaat een naam, bijvoorbeeld “Bluetooth Proxy 01”.
- Druk nu op Connect en selecteer de juiste COM poort (Naam zal iets met CH9102 bevatten) in het venster dat opent.
- Het zal nu enige tijd duren terwijl Home Assistant de installatie voorbereidt (Downloaden van software en compileren van firmware). Als het goed is eindigt het process met de melding “Configuration created!”.
- Zoek nu de Bluetooth Proxy 01 op binnen de ESPHome Builder zodat de Bluetooth Proxy functie aan de YAML kan worden toegevoegd. Hiervoor voegen we de volgende regel toe aan de bestaande code:
packages:
esphome.bluetooth-proxy: github://esphome/bluetooth-proxies/esp32-generic/esp32-generic.yaml@main
9. Hierdoor komt de totale configuratie er ongeveer als volgt uit te zien (Keys en passwords zullen afwijken:

10. Klik nu rechtsboven op SAVE en vervolgens op INSTALL.
11. Kies bij “How do you want to install…” voor “Plug into this computer”.
12. Nu opent er weer een venster waarbij je de USB poort moet kiezen waarna de installatie van start gaat. Na weer enige tijd geduld is de module voorzien van de juiste software.
13. Nu kun je de Bluetooth Proxy op een locatie naar wens plaatsenen van stroom voorzien. De verbinding met de computer is vanaf nu niet meer nodig
