Background RF Receiver Mode¶

Bond Bridge Pro can listen for incoming RF messages even when it is not transmitting. This behavior is controlled by the bgrx_mode setting—short for background receiver mode.

Because Bond Bridge Pro has a single sub-GHz radio, it can listen for only one background RF technology at a time. If the wrong mode is selected, pairing or state feedback may fail even when the remote is next to the Bridge and its LED indicates that it is transmitting.

One Background Receiver Mode at a Time

Breeze Pro and Bond Sidekick, third-party RF keypads, and Vertilux bidirectional motors use different receiver configurations. They cannot use background reception simultaneously on the same Bond Bridge Pro.

Available Modes¶

`bgrx_mode`	Web Interface Label	Used For
`0`	Bond Sidekick and Breeze Pro (BondSync)	Breeze Pro and Bond Sidekick
`1`	Third-Party RF Keypads	Compatible keypads such as Lutron Pico
`2`	Vertilux bidirectional motors	Vertilux Relion Bidirectional motors

Why Breeze Pro Pairing Can Fail¶

When a Vertilux Relion Bidirectional device is used, the firmware automatically changes bgrx_mode to 2 and saves the setting. The customer does not normally need to select this mode manually.

This automatic change applies specifically to Vertilux bidirectional devices using the RMS158 template. Unidirectional Vertilux Relion devices use a different template and do not trigger the change.

If a Breeze Pro is paired afterward, the Bridge is still listening for Vertilux RF traffic instead of BondSync traffic. Both QR-code and CAL pairing depend on the Bridge receiving BondSync messages from the Breeze Pro, so neither pairing method will succeed while the Bridge remains in mode 2.

Changing the Bridge to mode 0 allows it to receive Breeze Pro messages, but Vertilux bidirectional operation requires mode 2. Using a configured Vertilux bidirectional device may also cause the firmware to select and save mode 2 again.

Installations Using Both Technologies

If an installation requires both Vertilux Relion Bidirectional devices and Breeze Pro or Bond Sidekick, use two Bond Bridge Pros—one configured for each receiver mode.

Set the Mode Through the Bridge Web Interface¶

In the Bond Home app, go to Devices > Bridge Settings > Network.
Tap the Bridge’s IP address to copy it.
From a computer or mobile device on the same network, open:
```
http://<bridge-ip>/bridge
```
For example: http://192.168.1.42/bridge
Under Background RX Mode, select the appropriate option:
- Bond Sidekick and Breeze Pro (BondSync) for Breeze Pro or Bond Sidekick
- Third-Party RF Keypads for compatible RF keypads
- Vertilux bidirectional motors for Vertilux Relion Bidirectional devices
Select Save and confirm the change.

The Bridge will reboot to apply the new receiver configuration. This usually takes less than 10 seconds but may take up to 90 seconds.

Warning

Changing this setting affects the entire Bridge. Before changing it, confirm that another configured product does not require the currently selected mode.

Set the Mode Through the Local API¶

First, read the current setting:

curl \
  -H "BOND-Token: <token>" \
  http://<bridge-ip>/v2/bridge

The response includes the current value:

{
  "bgrx_mode": 2
}

To change the Bridge to BondSync mode for Breeze Pro or Bond Sidekick:

curl -X PATCH \
  -H "BOND-Token: <token>" \
  -H "Content-Type: application/json" \
  -d '{"bgrx_mode":0}' \
  http://<bridge-ip>/v2/bridge

Replace the value with the required mode:

Value	Receiver Configuration
`0`	Breeze Pro and Bond Sidekick
`1`	Third-party RF keypads
`2`	Vertilux bidirectional motors

Changing bgrx_mode causes the Bridge to reboot automatically. After it comes back online, repeat GET /v2/bridge to verify the setting.

Note

If a Vertilux Relion Bidirectional device remains configured and is used again, the firmware may automatically return the Bridge to mode 2.