Skip to content

Bluetooth Proxy

This guide shows you how to make your Apollo device act as a "BLE Proxy" which lets Bluetooth devices talk back to home assistant using Apollo devices as the "next hop"!

Method 1: Switch to _BLE.yaml fork

1. Open the Esphome Device Builder.

2. If you do not have it installed, go here and then move on to step 3.

3. Click "Edit" as shown below.

4. Add a # before the packages line and the line after it as shown in the image below.

5. Copy the code inside the codeblock below.

packages:
  ApolloAutomation.MTR-1: # name of package/project
    url: https://github.com/ApolloAutomation/MTR-1 # url of the repository
    ref: main # branch, tag or commit SHA
    files: [Integrations/ESPHome/MTR-1_BLE.yaml] # Path to config from base repo URL
    refresh: 1min # how often to sync updates from the remote url

6. Paste the code as shown below directly below the yaml you just edited above. Make sure the spaces look the same and there are no red lines under any of the code.

7. Click save then Install in the top right.

8. Click "Wirelessly" and let it finish compiling then installing.

9. When you see this "OTA Successful" it has finished and you can click "Close" in the bottom right.

10. You are finished and your Apollo device is now acting as a Bluetooth Proxy!

Method 2: Manually enter the BLE proxy yaml

1. Open the Esphome Device Builder.

2. If you do not have it installed, go here and then move on to step 3.

3. Click "Edit" as shown below.

4. Copy the code inside the codeblock below.

  power_save_mode: LIGHT

5. Paste the code as shown below - make sure the spaces look the same and there are no red lines under any of the code.

6. Copy the code inside the codeblock below.

bluetooth_proxy:
  active: true
esp32_ble_tracker:
  scan_parameters:
    active: false
#we are required to use this old esp-idf framework that uses less space
esp32:
  framework:
    type: esp-idf
    version: 4.4.8
    platform_version: 5.4.0

7. Paste the code on a new line at the very bottom of the file as shown below.

8. Click save then Install in the top right.

8. Click "Wirelessly" and let it finish compiling then installing.

9. When you see this "OTA Successful" it has finished and you can click "Close" in the bottom right.

10. You are finished and your Apollo device is now acting as a Bluetooth Proxy!