ESP32<\/a><\/strong> is a MCU with integrated WiFi and Bluetooth (successor of popular ESP8266). ESP32 a very powerful and has low power consumption. In theory, it can be battery operated if put on a deep sleep, but with casual use cases a permanent power connection is required. ESP32 software can be developed with easy to learn Arduino<\/a>, but is not excluded to only that.<\/p>\n\n\n\n ESPHome<\/a><\/strong> is a platform developed for ESP32\/ESP8266 and is mainly used for Smart Home devices. ESPHome has tons of ready made configurations, libraries and examples. In 2021 Nabu Casa (Home Assistant developer company) acquired ESPHome<\/a> and integrated the whole ESPHome system more deep into the Home Assistant Core. These days ESPHome can be installed directly from Home Assistant Add-On store and configured from Home Assistant UI!<\/p>\n\n\n\n Bluetooth Proxy<\/strong><\/a> is a gateway software that listens for ‘all’<\/em> Bluetooth traffic and forwards them to the Home Assistant instance. Basically BLE to WiFi gateway.<\/p>\n\n\n\n In this project we are going to need few items: <\/p>\n\n\n\n Note: I’ve tested this with two different development boards, ESP32 Wroom devkit v1<\/strong> and ESP32 Wroom devkit v2<\/strong>, but for some odd reason the devkit v2 did not work properly with flashing esp-idf type of framework. You can find the exact device I’ve used from Amazon using these links: Amazon.de<\/a>, Amazon.com<\/a><\/strong>. Most probably other ESP32 dev kits works as well, but I’ve not tested them my self, so can’t say 100% sure that others works the same.<\/p>\n\n\n\n ESPHome<\/a> is now days hosted within the Official Home Assistant Add-On Store and can be installed to the Home Assistant without any problems. Just head over to Home Assistant Settings -> Add-On Store -> Select ESPHome and press the install<\/strong><\/em>.<\/p>\n\n\n\n Once installed I’d suggest to set on the Watchdog switch in order for ESPHome to restart it if crashing at anytime for any reason. Also press ‘start’ button to start the ESPHome container in your environment. <\/p>\n\n\n\n Now the ESPHome service should be fully running and can be opened from “Open Web UI<\/em><\/strong>” -button bottom of the ESPHome Add-on page. <\/p>\n\n\n\n Now it’s time to get really things started and setup the proper configurations for the ESP32! Open ESPHome UI<\/strong> from ESPHome Add-on page and connect the ESP32 device to your PC using a micro USB cable.<\/p>\n\n\n\n First initial configuration is needed to be created. Let’s start by pressing the plus-button<\/em><\/strong> in the bottom right corner and let’s name the device as “Bluetooth Proxy<\/em><\/strong>“. Next select a Generic ESP32<\/strong> as a device (unless you have some other specific ESP32 dev board that is in the list). <\/p>\n\n\n\n Generated encryption key should be now shown, but you can safely ignore it. It will be automatically added to the configuration once finished. So just press “Skip<\/em><\/strong>” button and we continue editing in the edit view.<\/p>\n\n\n\n After finished and initial config is created, open the newly created configuration by pressing “edit<\/em><\/strong>” from the Bluetooth Proxy<\/em> device at ESPHome WEB UI.<\/p>\n\n\n\n Now we need to add the Bluetooth Proxy support for our configuration. Fill in the missing parts of the configuration from the code below (esp32_ble_tracker<\/strong> and bluetooth_proxy<\/strong> -blocks). Also remember to change the framework type<\/strong> to esp-idf<\/em><\/strong>! This is important, since the bluetooth proxy performance is quite poor on default Arduino framework. Don’t copy the below configuration totally, since the encryption key and other password should be unique to your device and environment. I’ve altered those values in my configuration shown here.<\/p>\n\n\n\n Once modifications are in place, we just need to flash it on the ESP32 device. For this, Google Chrome<\/strong> or Microsoft Edge<\/strong> browser is required. So using Google Chrome press the “install<\/em><\/strong>” button in the current view and select the corresponding com port the device is connected to using USB cable. Port name should be something like: ‘CP2102 USB to UART Bridge Controller (Com 4)<\/em><\/strong>‘<\/p>\n\n\n\n After this step the programming should begin processing and will take couple of minutes until completed. <\/p>\n\n\n\n After the first time flashing the device, it can be re-flashed wirelessly. In fact, Home Assistant will notify if ESPHome is updated and will ask you to update the device (wirelessly) when a new ESPHome update is pushed out.<\/p>\n\n\n\n Once done, move to the next step.<\/p>\n\n\n\n After installation, when ESP32 has properly started up, a notification of a new device should appear in the Home Assistant notification center. Clicking this notification will take you to the Home Assistant devices & integrations -view and will kindly ask you to configure the Bluetooth Proxy device. So click it, add an area you are planning to place the device and you’re all done! The proxy is now ready for use!<\/p>\n\n\n\n You can now disconnect the device from PC and connect it to the power supply using a micro USB cable.<\/p>\n\n\n\n Proxy should now start and automatically discover all nearby supported Bluetooth devices in range. All of those devices will be notified in the same Home Assistant notification area and clicking those notifications will take you to the Home Assistant devices & integrations page once again.. and again kindly ask you to configure the bluetooth devices.<\/p>\n\n\n\n In my case, the SwitchBot Meter Plus<\/a> was discovered as should and configuration was to just add the device area. Once that was done the device started sending values for the Home Assistant immediately! <\/p>\n\n\n\n It’s not a good practice to install electrical devices exposed to dust, so it’s nice to have an enclosure for the device. If you have a 3D Printer available, I’d suggest to find a 3D model for the ESP32 case (depending on your dev board) from e.g. Thingiverse<\/a>. As said earlier, I’m using a Wroom32 devkit v1 and found this<\/a> specific case to fit for my needs. That enclosure does require a bit glue to close the lid tight, but otherwise it’s a perfect fit.<\/p>\n\n\n\n If you don’t have a 3D printer available, you can use any plastic case. Just add some hot glue to the bottom of the enclosure and glue the ESP32 device on it so it won’t move inside accidentally. Also create a hole for the USB power cable.<\/p>\n\n\n\n Everything is now ready and the proxy device should be passing ‘all’<\/em> bluetooth device data directly to your Home Assistant instance. I’ve been using this for about week now and I’ve had zero connection drops and everything has been working as great as expected. It’s very easy now to expand Bluetooth range by just placing more of these proxy devices in the house!<\/p>\n\n\n\nRequired Hardware<\/h2>\n\n\n\n
\n
\n
Installing ESPHome into Home Assistant<\/h2>\n\n\n\n
![\"\"](\"https:\/\/www.creatingsmarthome.com\/wp-content\/uploads\/2023\/03\/Screenshot-2023-03-27-at-13.23.57.png\")
<\/figure>\n\n\n\nFlashing Bluetooth Proxy<\/h2>\n\n\n\n
Create a new config<\/h3>\n\n\n\n
![\"\"](\"https:\/\/www.creatingsmarthome.com\/wp-content\/uploads\/2023\/03\/Screenshot-2023-03-27-at-9.50.34.png\")
<\/figure>\n\n\n\n![\"\"](\"https:\/\/www.creatingsmarthome.com\/wp-content\/uploads\/2023\/03\/Screenshot-2023-03-27-at-9.50.39.png\")
<\/figure>\n\n\n\n![\"\"](\"https:\/\/www.creatingsmarthome.com\/wp-content\/uploads\/2023\/03\/Screenshot-2023-03-27-at-9.50.53.png\")
<\/figure>\n<\/figure>\n\n\n\nesphome:\n name: bluetooth-proxy\n friendly_name: Bluetooth Proxy\n\nesp32:\n board: esp32dev\n framework:\n type: esp-idf\n\n# Enable logging\nlogger:\n\n# Enable Home Assistant API\napi:\n encryption:\n key: \"REMOVED\"\n\nota:\n password: \"REMOVED\"\n platform: esphome\n\nwifi:\n ssid: !secret wifi_ssid\n password: !secret wifi_password\n\n # Enable fallback hotspot in case wifi connection fails\n ap:\n ssid: \"Bluetooth-Proxy Fallback Hotspot\"\n password: \"REMOVED\"\n\nesp32_ble_tracker:\n scan_parameters:\n interval: 1100ms\n window: 1100ms\n active: true\n\nbluetooth_proxy:\n active: true<\/code><\/pre>\n\n\n\nFlashing the device<\/h3>\n\n\n\n
![\"\"](\"https:\/\/www.creatingsmarthome.com\/wp-content\/uploads\/2023\/03\/esphome_install.png\")
<\/figure>\n\n\n\n![\"\"](\"https:\/\/www.creatingsmarthome.com\/wp-content\/uploads\/2023\/03\/esphome_select_port.png\")
<\/figure>\n\n\n\n![\"\"](\"https:\/\/www.creatingsmarthome.com\/wp-content\/uploads\/2023\/03\/esphome_installing.png\")
<\/figure>\n\n\n\n![\"\"](\"https:\/\/www.creatingsmarthome.com\/wp-content\/uploads\/2023\/03\/esphome_install_completed.png\")
<\/figure>\n<\/figure>\n\n\n\nAdding the proxy to Home Assistant<\/h3>\n\n\n\n
![\"\"](\"https:\/\/www.creatingsmarthome.com\/wp-content\/uploads\/2023\/03\/Screenshot-2023-03-27-at-10.41.53.png\")
<\/figure>\n\n\n\n![\"\"](\"https:\/\/www.creatingsmarthome.com\/wp-content\/uploads\/2023\/03\/Screenshot-2023-03-27-at-10.41.58.png\")
<\/figure>\n\n\n\n![\"\"](\"https:\/\/www.creatingsmarthome.com\/wp-content\/uploads\/2023\/03\/Screenshot-2023-03-27-at-10.42.03.png\")
<\/figure>\n\n\n\n![\"\"](\"https:\/\/www.creatingsmarthome.com\/wp-content\/uploads\/2023\/03\/Screenshot-2023-03-27-at-10.42.11.png\")
<\/figure>\n<\/figure>\n\n\n\nDiscovering Bluetooth devices<\/h3>\n\n\n\n
![\"\"](\"https:\/\/www.creatingsmarthome.com\/wp-content\/uploads\/2023\/03\/Screenshot-2023-03-27-at-10.42.18.png\")
<\/figure>\n\n\n\n![\"\"](\"https:\/\/www.creatingsmarthome.com\/wp-content\/uploads\/2023\/03\/Screenshot-2023-03-27-at-10.42.22.png\")
<\/figure>\n\n\n\n![\"\"](\"https:\/\/www.creatingsmarthome.com\/wp-content\/uploads\/2023\/03\/Screenshot-2023-03-27-at-10.42.31.png\")
<\/figure>\n\n\n\n![\"\"](\"https:\/\/www.creatingsmarthome.com\/wp-content\/uploads\/2023\/03\/Screenshot-2023-03-27-at-10.42.37.png\")
<\/figure>\n\n\n\n![\"\"](\"https:\/\/www.creatingsmarthome.com\/wp-content\/uploads\/2023\/03\/Screenshot-2023-03-22-at-8.18.53.png\")
<\/figure>\n<\/figure>\n\n\n\nCreating an enclosure (optional)<\/h2>\n\n\n\n
![\"\"](\"https:\/\/www.creatingsmarthome.com\/wp-content\/uploads\/2023\/03\/20230327_100341.jpg\")
<\/figure>\n\n\n\n![\"\"](\"https:\/\/www.creatingsmarthome.com\/wp-content\/uploads\/2023\/03\/20230327_122907.jpg\")
<\/figure>\n\n\n\n![\"\"](\"https:\/\/www.creatingsmarthome.com\/wp-content\/uploads\/2023\/03\/20230327_122918.jpg\")
<\/figure>\n<\/figure>\n\n\n\nThe end<\/h2>\n\n\n\n
\n\n\nDid you find this guide helpful? You can keep the blog going by bidding me a coffee!<\/h5>\r\n