Bluetooth range extensions

• Use a Shelly device to extend the Bluetooth sensors range of your GX. Ie the distance between a compatible device that is being read out over bluetooth and the GX itself. This was already possible by using bluetooth USB dongles on a long USB extension cable, which was nice, but this new option adds a lot of value and flexibility. The Shelly will work as the Bluetooth data receiver and then transmits all data to the GX over either wired ethernet or WiFi.
• Works for all devices supported by the Bluetooth sensors integration
  • all supported BLE sensors, (Ruuvis, Mopekas, Safiery, Gobius, Garnet)
  • the Victron SolarSense,
  • the Victron NG products mentioned above
• Requires Shelly firmware version >= 1.15.0 on a compatible Shelly device, which are:
  • Plus 1, Plus 1PM, Plus 2PM, Plus Plug S, Plus i4
  • Pro 1, Pro 1PM, Pro 2, Pro 2PM, Pro 3, Pro 4PM
  • 1 Gen3, 1PM Gen3, 1 Mini Gen3, 1PM Mini Gen3, Plug S Gen3
  • 1 Gen4, 1PM Gen4, Mini Gen4 - (When not in zigbee mode)
  • BLU Gateway, BLU Gateway Gen3

• To configure a Shello Gen2 Pro, Gen3, Gen4 or BLU device:

  1. Open the web interface of the Shelly device
  2. Click “Matter” on the left and disable Matter (and reboot)
  3. Click “Scripts” on the left
  4. Click “Library”
  5. Click “Configure URL”
  6. Fill in https://raw.githubusercontent.com/victronenergy/dbus-ble-sensors/refs/heads/master/tools/shelly/manifest.json and press Save
  7. Press “Import code” under “Victron BLE Bridge”
  8. Click “Save”
  9. Click “Scripts” on the left
  10. Enable “Run on startup” and start the script using the ▶ button
  11. Click “Home” on the left. New UI elements will appear here.
  12. When necessary, fill in the correct address under “Venus Host” and press “Save”
  13. Activate pairing mode on the Venus device under Settings -> Integrations -> Bluetooth Sensors -> Advanced
  14. Press the “Authenticate” button on the Shelly home page
  15. The Status on the Shelly home page should change to “BLE Bridge operational”

• To configure a Shelly Gen2 Plus device:

  1. Open the web interface of the Shelly device
  2. Click “Scripts” on the left
  3. Click “Library”
  4. Click “Configure URL”
  5. Fill in https://raw.githubusercontent.com/victronenergy/dbus-ble-sensors/refs/heads/master/tools/shelly/manifest.json and press Save
  6. Press “Import code” under “Victron BLE Bridge”
  7. Click “Save”
  8. Expand “Advanced” on the left and click “KVS”
  9. Click “Add key-value”
  10. Type “venus-host” under Key
  11. Type “venus.local” (or the applicable ip address) under Value
  12. Click “Save entry”
  13. Activate pairing mode on the Venus device under Settings -> Integrations -> Bluetooth Sensors -> Advanced
  14. Click “Scripts” on the left on the Shelly web page
  15. Enable “Run on startup” and start the script using the ▶ button
  16. The status of the script should become and stay “Running"!

• To configure the GX device:

  • Via VictronConnect >= v6.40:
    1. Connect to the GX device via Bluetooth
    2. Go to Settings -> Bluetooth Sensors
    3. Enable the desired devices
       When a device cannot be enabled and shows a lock, it means that VictronConnect does not have the necessary encryption key. To solve this, first connect with VictronConnect to the device via Bluetooth. VictronConnect will then fetch and store the key.
  • Via the New UI:
    1. Go the New UI of the GX device (via its screen or via Remote console)
    2. Go to Settings -> Integrations -> Bluetooth Sensors
    3. Enable the desired devices or provide the required encryption key.
       Most Victron products, with the exception of the SolarSense 750, require an Encryption key that can be found in VictronConnect by connecting to the product, go to Settings -> Product Info -> Encryption Data.