Skip to content
CANShiftCANShift Docs
ESC

Type to search the docs.

↑↓ navigate↵ openesc closePagefind

Pairing over BLE

How the phone finds and bonds with the dash — permissions, scan, and reconnect.

UPD 03.08.2026

Bluetooth is the mobile companion’s link to the dash. (The desktop Tuner uses Web Serial instead — see the Tuner tour.) Pairing only works when the firmware was built with BLE compiled in; see Transports.

The flow

Section titled “The flow”
  1. Grant Bluetooth permission. On first launch the app asks for the OS Bluetooth permission (src/services/ble-permissions.ios.ts / .android.ts); scanning does nothing until it’s granted.
  2. Scan. The scan screen (src/screens/ScanScreen.tsx) lists nearby dashes. If Bluetooth is off it prompts you to turn it on rather than sitting blank.
  3. Connect and bond. Select your dash to connect (src/services/ble.service.ts). The dash shows a six-digit passkey on its screen to confirm the bond — that’s the firmware’s PASSKEY GATT characteristic, covered in BLE transport.

Staying connected

Section titled “Staying connected”

The app remembers the last dash it bonded with (src/services/last-device.ts) and reconnects to it automatically on the next launch. If the link drops, a reconnect banner (components/ReconnectBanner.tsx) retries in the background (src/services/ble-reconnect.ts); if it can’t recover, a dialog offers to scan again.