The Bluetooth configuration options include Enabled, Pairing Mode, and Fixed PIN Value. The Bluetooth config utilizes an admin message to send a Config.Bluetooth protobuf.
NOTE: For ESP32 Devices, Bluetooth will be disabled when WiFi is enabled, as the WiFi setting takes priority.
Bluetooth Configuration Options
Enabled
Enables Bluetooth.
Pairing Mode
Specify the pairing mode as follows:
-
RANDOM_PIN generates a random PIN at runtime.
-
FIXED_PIN uses a fixed PIN that should be specified separately.
-
NO_PIN disables PIN authentication altogether.
Default Pairing Mode
The default pairing mode will be determined by whether the device has a screen attached during the initial boot (or when in a stale device state) unless it's manually configured through the Bluetooth settings.
Screen Attached: When the device boots up for the first time (or with a stale state) and a screen is detected, the default pairing mode will be set to RANDOM_PIN. If the screen is removed after the device has booted, the default pairing mode will remain RANDOM_PIN unless it is manually changed to FIXED_PIN or NO_PIN. It is advisable to update the pairing mode before disconnecting the attached screen.
No Screen Attached: If the device boots up for the first time (or with a stale state) and no screen is detected, the default pairing mode will be set to FIXED_PIN with the default value specified below, unless it has been manually configured to a custom value.
Fixed PIN
If your pairing mode is set to FIXED_PIN, the default value will be 123456. This number will be ignored for all other pairing modes. You can configure a custom integer (6 digits) through the Bluetooth settings.
Tip: It is highly advisable to change the default FIXED_PIN code on your device. Retaining the default code may present a significant security risk.
Bluetooth Client Availability Status
Android
All Bluetooth configuration options are accessible on Android.
-
Open the Meshtastic App.
-
Navigate to: Vertical Ellipsis (three dots in the top right corner) > Radio Configuration > Bluetooth.
Apple
All Bluetooth configuration options are available on iOS, iPadOS, and macOS by navigating to Settings > Device Configuration > Bluetooth.
CLI
All Bluetooth configuration options can be accessed using the Python CLI. Below are some example commands:
| 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 |
-
Enable/Disable Bluetooth Module
| meshtastic --set bluetooth.enabled true meshtastic--set bluetooth.enabled false |
-
Set a fixed pin
| meshtastic --set bluetooth.mode FIXED_PIN meshtastic --set bluetooth.fixed_pin 111111 |
Tip: Since the device will reboot after each command is sent via the CLI, it is advisable to chain commands together as a single command when setting multiple values in a configuration section.
meshtastic --set bluetooth.enabled true --set bluetooth.fixed_pin 111111
|
Web
All Bluetooth module configuration options are accessible through the Web UI.
-
Open the Meshtastic Web UI.
-
Navigate to: Radio Config > Bluetooth.
