updates to bluetooth.mdx

This commit is contained in:
rcarteraz 2022-11-27 13:05:40 -07:00
parent 018ebf5e51
commit aabf749a3a

View file

@ -11,7 +11,7 @@ import TabItem from '@theme/TabItem';
The Bluetooth config options are: Enabled, Pairing Mode and Fixed PIN Value. Bluetooth config uses an admin message sending a `Config.Bluetooth` protobuf. The Bluetooth config options are: Enabled, Pairing Mode and Fixed PIN Value. Bluetooth config uses an admin message sending a `Config.Bluetooth` protobuf.
:::info :::info
On ESP32 Bluetooth will be disabled if WiFi is enabled. The WiFi setting takes precedence. ESP32 Devices: Bluetooth will be disabled if WiFi is enabled. The WiFi setting takes precedence.
::: :::
## Bluetooth Config Values ## Bluetooth Config Values
@ -30,7 +30,14 @@ Finally, `NO_PIN` disables PIN authentication.
### Fixed PIN ### Fixed PIN
If your pairing mode is set to fixed PIN this is the value of that fixed 6 digit pin. Default value is 123456. For all other pairing modes, this number is ignored. 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.
### 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 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 of `RANDOM_PIN` will remain unless manually changed to `FIXED_PIN` or `NO_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 with a stale device state), and no screen is detected, the default paring mode will be set to `FIXED_PIN` with the aforementioned default value unless manually configured to a custom value.
## Configure Bluetooth Config ## Configure Bluetooth Config
@ -46,21 +53,28 @@ values={[
<TabItem value="android"> <TabItem value="android">
:::info :::info
Bluetooth config is not available for Android. All Bluetooth config values are available on Android.
1. Open the Meshtastic App
2. Navigate to: **⋮ > Advanced Settings > Bluetooth Config**
::: :::
</TabItem> </TabItem>
<TabItem value="apple"> <TabItem value="apple">
:::info
All Bluetooth config values are available on iOS, iPadOS and macOS. All Bluetooth config values are available on iOS, iPadOS and macOS.
1. Open the Meshtastic App 1. Open the Meshtastic App
2. Navigate to: **Settings > Radio Configuration > Position** 2. Navigate to: **Settings > Radio Configuration > Bluetooth (BLE)**
:::
</TabItem> </TabItem>
<TabItem value="cli"> <TabItem value="cli">
:::info
All Bluetooth module config options are available in the python CLI. Example commands are below: All Bluetooth module config options are available in the python CLI. Example commands are below:
:::
| Setting | Acceptable Values | Default | | Setting | Acceptable Values | Default |
| :-----------------------: | :-----------------: | :-----: | | :-----------------------: | :-----------------: | :-----: |
@ -82,6 +96,8 @@ meshtastic --set bluetooth.fixed_pin 111111
:::info :::info
All Bluetooth module config options are available for the Web UI. All Bluetooth module config options are available for the Web UI.
1. Open the Meshtastic Web Client
2. Navigate to: **Device Config > Bluetooth**
::: :::
</TabItem> </TabItem>