Bluetooth Settings
The Bluetooth config options are: Enabled, Pairing Mode and Fixed PIN Value. Bluetooth config uses an admin message sending a Config.Bluetooth protobuf.
ESP32 Devices: Bluetooth will be disabled if WiFi is enabled. The WiFi setting takes precedence.
Bluetooth Config Values
Enabled
Enables Bluetooth.
Pairing Mode
Specify pairing mode.
RANDOM_PIN generates a random PIN during runtime.
FIXED_PIN uses the fixed PIN that should then be additionally specified.
Finally, NO_PIN disables PIN authentication.
Default Pairing Mode
The default pairing mode will be determined based on whether the device has or does not have a screen attached to it during the first boot (or with a stale device state) unless manually configured via the Bluetooth config options.
- Screen Attached: If your device boots up for the first time (or with a stale device state), and a screen is detected, the default pairing mode will be set to
RANDOM_PIN. Should the attached screen be removed after the device has already been booted, the default pairing mode ofRANDOM_PINwill remain unless manually changed toFIXED_PINorNO_PIN. It is recommended the pairing mode be updated prior to removing the attached screen. - No Screen Attached: If your device boots up for the first time (or with a stale device state), and no screen is detected, the default paring mode will be set to
FIXED_PINwith the default value listed below unless manually configured to a custom value.
Fixed PIN
If your pairing mode is set to FIXED_PIN, the default value is 123456. For all other pairing modes, this number is ignored. A custom integer (6 digits) can be set via the Bluetooth config options.
It is strongly recommended that you change the default FIXED_PIN code on your device. Leaving the default code in place can pose a significant security risk.
Bluetooth Config Client Availability
- Android
- Apple
- CLI
- Web
Android
All Bluetooth config options are available for Android.
- Open the Meshtastic App
- Navigate to: Vertical Ellipsis (3 dots top right) > Radio Configuration > Bluetooth
Apple
All bluetooth config options are available on iOS, iPadOS and macOS at Settings > Device Configuration > Bluetooth.
CLI
All Bluetooth config options are available in the python CLI. Example commands are below:
| Setting | Acceptable Values | Default |
|---|---|---|
bluetooth.enabled | true, false | true |
bluetooth.mode | RANDOM_PIN, FIXED_PIN, NO_PIN | RANDOM_PIN |
bluetooth.fixed_pin | integer (6 digits) | 123456 |
Because the device will reboot after each command is sent via CLI, it is recommended when setting multiple values in a config section that commands be chained together as one.
meshtastic --set bluetooth.enabled true --set bluetooth.fixed_pin 111111
meshtastic --set bluetooth.enabled true
meshtastic --set bluetooth.enabled false
meshtastic --set bluetooth.mode FIXED_PIN
meshtastic --set bluetooth.fixed_pin 111111
Web
All Bluetooth module config options are available for the Web UI.
- Open the Meshtastic Web UI.
- Navigate to: Radio Config > Bluetooth