Skip to main content

Overview

Shiver is the BLEShark Nano's multi-device protocol. When two or more Nanos are paired together, they form a small wireless mesh and can share state, run commands in parallel, and sync files between each other, all without needing a phone or computer in the middle.

Most of the Nano's standalone features keep working on their own. Turning Shiver on just unlocks a second layer of features that span a group of paired devices.

What You Can Do With Shiver​

  • Execute - run a Wi-Fi, BLE, or IR command across every paired device at once, or a subset you pick.
  • Dashboard - see at a glance which paired Nanos are online, who each device can hear directly, and how long the mesh has been up.
  • Sync - copy captured handshakes, settings, submitted captive portal JSONs, or individual files between paired Nanos with a simple wizard.
  • Chat - send short text messages between Nanos on the mesh.
  • Pair - discover and add new Nanos to the group.
  • About - view the device's mesh identity, radio channel, role, and current rate.

The Shiver entry on the main menu is always available, even if you only own a single Nano. That way you can see what the mesh experience looks like before adding more devices.

Turning Shiver On​

  • Open the Config menu, then Settings, then Shiver.
  • Toggle the Shiver row on.
  • Optionally set a mesh name in the Name row. This is what other Nanos will show for you in their Dashboard and pickers. The name is limited to 8 characters. If you leave it blank, your device is identified on the mesh by the first four bytes of its eFuse ID (for example "E02E" or "B8FA").
BLE and Shiver share the radio

A few features rely on a persistent Bluetooth connection and cannot run while the mesh is active, because the mesh switches the radio back and forth too often for a stable connection to survive. Turn Shiver off before using Bad-BT, Mini Keypad, or Scroller.

BLE Spam is fine to use with Shiver on. Its advertising packets are short and it can share the radio with the mesh without issue.

Before Pairing​

For a clean pairing experience, make sure every Nano you want on the mesh:

  • Is powered on and running the latest firmware (see Updating).
  • Has BLE Adv turned on under Config -> Settings -> Shiver. Pairing itself runs over Bluetooth; the devices swap to the mesh automatically after they're paired.

Long Range mode is not a prerequisite for pairing. Pairing uses Bluetooth, which isn't affected by the Long Range setting. See Long Range Mode for when and why you'd turn it on.

When everything is ready, head to Pairing to add devices, then Dashboard to see your mesh in action.