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 firmware¶

Select your product below to see the full walkthrough.

AIR-1MSR-1MSR-2MTR-1R-PRO-1PUMP-1PLT-1PLT-1BTEMP-1TEMP-1BBTN-1

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.AIR-1:
    url: https://github.com/ApolloAutomation/AIR-1
    ref: main
    files: [Integrations/ESPHome/AIR-1_BLE.yaml]
    refresh: 1min

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!

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.MSR-1:
    url: https://github.com/ApolloAutomation/MSR-1
    ref: main
    files: [Integrations/ESPHome/MSR-1_BLE.yaml]
    refresh: 1min

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!

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.MSR-2:
    url: https://github.com/ApolloAutomation/MSR-2
    ref: main
    files: [Integrations/ESPHome/MSR-2_BLE.yaml]
    refresh: 1min

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!

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:
    url: https://github.com/ApolloAutomation/MTR-1
    ref: main
    files: [Integrations/ESPHome/MTR-1_BLE.yaml]
    refresh: 1min

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!

This product needs Method 2

This product does not have a prebuilt _BLE.yaml firmware, so Method 1 does not apply. Scroll down and follow Method 2 to add the BLE proxy yaml to your existing config by hand.

This product needs Method 2

This product does not have a prebuilt _BLE.yaml firmware, so Method 1 does not apply. Scroll down and follow Method 2 to add the BLE proxy yaml to your existing config by hand.

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.PLT-1:
    url: https://github.com/ApolloAutomation/PLT-1
    ref: main
    files: [Integrations/ESPHome/PLT-1_BLE.yaml]
    refresh: 1min

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!

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.PLT-1:
    url: https://github.com/ApolloAutomation/PLT-1
    ref: main
    files: [Integrations/ESPHome/PLT-1B_BLE.yaml]
    refresh: 1min

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!

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.TEMP-1:
    url: https://github.com/ApolloAutomation/TEMP-1
    ref: main
    files: [Integrations/ESPHome/TEMP-1_BLE_R2.yaml]
    refresh: 1min

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!

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.TEMP-1:
    url: https://github.com/ApolloAutomation/TEMP-1
    ref: main
    files: [Integrations/ESPHome/TEMP-1B_BLE_R2.yaml]
    refresh: 1min

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!

This product needs Method 2

This product does not have a prebuilt _BLE.yaml firmware, so Method 1 does not apply. Scroll down and follow Method 2 to add the BLE proxy yaml to your existing config by hand.

Sleep must be disabled for the BTN-1 to work as a Bluetooth Proxy. See the Prevent Sleep guide.

Method 2: Manually enter the BLE proxy yaml¶

This method works the same on every product.

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

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.

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

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

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