PLT-1 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"!

Select a method below. Method 1 switches your PLT-1 to the prebuilt PLT-1_BLE.yaml firmware. Method 2 adds the BLE proxy yaml to your existing config by hand.

Method 1: PLT-1_BLE.yaml firmwareMethod 2: Manually enter the BLE proxy yaml

You'll swap your device's firmware package for its prebuilt Bluetooth proxy version in ESPHome Device Builder, then install it over the network.

1. Open the ESPHome Device Builder app from your Home Assistant sidebar. The button below opens the app's page, or offers to install it if you don't have it yet. Click Open Web UI there to reach your devices.

2. Find your device and click Edit.

3. Replace the packages: line and the line directly below it with the code below.

packages:
  ApolloAutomation.PLT-1:
    url: https://github.com/ApolloAutomation/PLT-1
    ref: main
    files: [Integrations/ESPHome/PLT-1_BLE.yaml]
    refresh: 1min

4. Click Save then Install in the bottom right. Click On the network when prompted.

5. When you see the purple lines the device has booted successfully and the logs will show the Bluetooth Proxy section. Click Stop in the bottom right and you're finished!

Verify it works

Once the device reboots, Home Assistant picks it up as a Bluetooth proxy automatically. Open the Bluetooth advertisement monitor with the button below to watch nearby BLE devices roll in through it. Anything that shows up is ready to add under Settings → Devices & Services → Bluetooth like any other device.

The easiest way is to let ESPHome Device Builder add the component for you. You can also paste the single line by hand.

1. Open the ESPHome Device Builder app from your Home Assistant sidebar and click Edit on your device. The button below opens the app's page, or offers to install it if you don't have it yet. Click Open Web UI there to reach your devices.

2. Click Add Component in the editor toolbar, search for Bluetooth Proxy, and click Add.

Device Builder drops a single line into your config:

bluetooth_proxy:

That's all it needs. Active connections are on by default, and bluetooth_proxy automatically pulls in the ESP32 BLE Tracker it depends on, so there's nothing else to add. Prefer to type it? Paste that one line at the top level of your YAML instead of using Add Component.

3. Click Save, then Install, and choose On the Network to flash the new firmware over Wi-Fi.

Verify it works

Once the device reboots, Home Assistant picks it up as a Bluetooth proxy automatically. Open the Bluetooth advertisement monitor with the button below to watch nearby BLE devices roll in through it. Anything that shows up is ready to add under Settings → Devices & Services → Bluetooth like any other device.