mirror of
https://github.com/meshtastic/meshtastic.git
synced 2025-03-05 21:00:08 -08:00
Merge branch 'master' into patch-1
This commit is contained in:
commit
ff138a42bd
|
@ -123,7 +123,7 @@ All Bluetooth config options are available in the python CLI. Example commands a
|
||||||
| :------------------: | :---------------------------------: | :----------: |
|
| :------------------: | :---------------------------------: | :----------: |
|
||||||
| `bluetooth.enabled` | `true`, `false` | `true` |
|
| `bluetooth.enabled` | `true`, `false` | `true` |
|
||||||
| `bluetooth.mode` | `RANDOM_PIN`, `FIXED_PIN`, `NO_PIN` | `RANDOM_PIN` |
|
| `bluetooth.mode` | `RANDOM_PIN`, `FIXED_PIN`, `NO_PIN` | `RANDOM_PIN` |
|
||||||
| `bluetooth.fixedPin` | `integer` (6 digits) | `123456` |
|
| `bluetooth.fixed_pin` | `integer` (6 digits) | `123456` |
|
||||||
|
|
||||||
:::tip
|
:::tip
|
||||||
|
|
||||||
|
|
|
@ -8,12 +8,18 @@ sidebar_position: 4
|
||||||
|
|
||||||
## Roles
|
## Roles
|
||||||
|
|
||||||
It is strongly recommended to keep your [ROLE](/docs/configuration/radio/device#roles) set to `CLIENT`. Only change this if you have a specific, well-understood reason to do so.
|
It is strongly recommended to keep your [ROLE](/docs/configuration/radio/device#roles) set to `CLIENT` or `CLIENT_MUTE`. Only use other roles if you have a specific, well-understood reason to do so. Read our [blog post about choosing the best role](/blog/choosing-the-right-device-role/).
|
||||||
|
|
||||||
### Why `CLIENT` is Recommended
|
### Recommended Roles
|
||||||
|
|
||||||
- `CLIENT` nodes efficiently repeat and route packets as needed.
|
- `CLIENT` nodes efficiently repeat and route packets as needed.
|
||||||
- They use smart delays for rebroadcasting, improving network stability.
|
- **Almost always the correct mode.**
|
||||||
|
- Uses smart delays for rebroadcasting, improving network stability.
|
||||||
|
- Use for "rooftop" or other nodes that enhance your mesh.
|
||||||
|
- Use during isolated activities such as hiking, skiing, or MTB where you're in an area with few nodes.
|
||||||
|
- `CLIENT_MUTE` nodes behave as above but do not repeat packets.
|
||||||
|
- Use for personal nodes that are in range of a higher-profile node in a dense or congested mesh.
|
||||||
|
- Use when you have multiple nodes in close proximity (set your "best-placed" node to `CLIENT`).
|
||||||
|
|
||||||

|

|
||||||
*One example of a 'Client' node. Photo credit: Cully@KBOXLABS*
|
*One example of a 'Client' node. Photo credit: Cully@KBOXLABS*
|
||||||
|
|
Loading…
Reference in a new issue