Advertisement monitor in Home Assistant

[mik-laj]

Hello,

I'm wondering if it's possible to use the Adventised Monitor to find the token to turn on the projector.

The device appears in my instance, but I'm not sure how the values ​​that appear there are converted to the necessary token, but I thought I'd let you know that such a view exists in Home Assistant, since I personally haven't found a link to this tab anywhere other than the Home Assistant documentation.

The token seems to be in the manufacturer_data field and section 70, because 70 decimal is 0x46, and that was the value discussed in the documentation.

Best regards,
Kamil Breguła

[mik-laj]

I confirmed that HA correctly reads token as I sent a packet from ESPHome and it turned on the device.

esp32_ble:
  name: 'BLuetooth 4.0 RC'
  id: ble 

# Enable BLE Server
esp32_ble_server:
  services:
  - uuid: 00001812-0000-1000-8000-00805f9b34fb
    advertise: true

button:
  - platform: template
    name: XGIMI Projector Wakeup
    icon: "mdi:projector"
    on_press:
      - repeat:
          count: 3
          then:
            - lambda: |-
                std::vector<uint8_t> data = {0x46, 0x00, 0x55, 0xF5, 0x5A, 0x6D, 0x78, 0xE4, 0x50, 0xFF, 0xFF, 0xFF, 0x30, 0x43, 0x52, 0x4B, 0x54, 0x4D};
                id(ble).advertising_set_manufacturer_data(data);
            - delay: 1s
            - lambda: |-
                std::vector<uint8_t> data = {0x46, 0x00};
                id(ble).advertising_set_manufacturer_data(data);
            - delay: 1s

Manufacture data need to be prefixed 0x46, 0x00

[skidazzit]

I confirmed that HA correctly reads token as I sent a packet from ESPHome and it turned on the device.

esp32_ble:
name: 'BLuetooth 4.0 RC'
id: ble

Enable BLE Server

esp32_ble_server:
services:

• uuid: 00001812-0000-1000-8000-00805f9b34fb
  advertise: true

button:

• platform: template
  name: XGIMI Projector Wakeup
  icon: "mdi:projector"
  on_press:
  • repeat:
    count: 3
    then:
    - lambda: |-
    std::vector<uint8_t> data = {0x46, 0x00, 0x55, 0xF5, 0x5A, 0x6D, 0x78, 0xE4, 0x50, 0xFF, 0xFF, 0xFF, 0x30, 0x43, 0x52, 0x4B, 0x54, 0x4D};
    id(ble).advertising_set_manufacturer_data(data);
    - delay: 1s
    - lambda: |-
    std::vector<uint8_t> data = {0x46, 0x00};
    id(ble).advertising_set_manufacturer_data(data);
    - delay: 1s

hi can you please provide steps on how you achieved this? Im a noob at this. Also do any one know if this can be done with a intel ax210ngw https://a.co/d/fChERPh

[mik-laj]

Getting the token using the Bluetooth Advertisement Monitor

The xgimi-4-home-assistant integration requires a BLE token (manufacturer data) broadcast by the XGIMI remote control to turn on the device. This token can be obtained using Home Assistant's built-in Bluetooth Advertisement Monitor.

1. Open the Bluetooth Advertisement Monitor

You can access the monitor directly from your Home Assistant instance:

👉 Open Bluetooth Advertisement Monitor

Alternatively, navigate manually:

1. Go to Settings → Devices & Services → Bluetooth → Configure.
2. Select Advertisement Monitor.

This view displays all Bluetooth Low Energy (BLE) advertisement packets detected by your Bluetooth adapter.

2. Identify the Xgimi Remote MAC Address

Because the BLE environment may contain dozens of nearby devices, it’s helpful to filter results by MAC address.

If you don’t know the remote’s MAC address:

1. Pair your Xgimi remote temporarily with an Android phone.

   1. To pair the remote, turn off the projector completely or go to another room and simultaneously press and hold the Back and Home buttons until the indicator light flashes.
   2. Look for a device with the name “XGIMI RC” or “BLuetooth 4.0 RC” and pair with it.

2. In the Bluetooth settings, open Device details to find the MAC address.

3. Note down the first three bytes (the prefix). For example, in many cases XGIMI remotes begin with 1C:.

4. After that, pair the remote with the projector again.

You can later use this prefix to narrow down advertisements in the HA monitor.

3. Filter and Locate the Manufacturer Data

1. In the Advertisement Monitor, apply a MAC prefix filter (e.g., 1C:) to reduce noise.
2. Turn off your projector so that the remote control does not automatically connect to it.
3. Press the Power button on the remote to send a special BLE advertisement frame.
4. Look for entries where the Manufacturer data field is populated and has an entry with ID: 70. This data is a hexadecimal payload broadcast by the remote and contains the BLE token required by the integration.

Example frame data:

{
  "name": "BLuetooth 4.0 RC",
  "address": "1C:XX:XX:XX:XX:XX",
  "rssi": -66,
  "manufacturer_data": {
    "13": "383800000001",
    "70": "51f55a6d78e450ffffff0000000b000d"
  },
  "service_data": {},
  "service_uuids": [
    "00001812-0000-1000-8000-00805f9b34fb"
  ],
  "source": "30:24:XX:XX:XX:XX",
  "connectable": true,
  "time": 1761087659.0729098,
  "tx_power": null,
  "raw": "0000000000000c0000000f0f000000000e0000000000000000000d000000"
}

Copy the full value from the manufacturer data with ID 70 — this is the token required for integration configuration.

[mik-laj]

@manymuch I've written a short guide with ChatGPT support. If you find it valuable, you can copy it to the README.md. There's no need to install additional tools on your phone or computer, which I think will make the process easier for beginners.

[manymuch]

Thanks @mik-laj ! This is great, updated the README.