Merge branch 'master' into patch-1

This commit is contained in:
pdxlocations 2025-02-16 22:19:49 -08:00 committed by GitHub
commit ff138a42bd
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
2 changed files with 11 additions and 5 deletions

View file

@ -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

View file

@ -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`).
![Client Node Example](/img/configuration/client.webp) ![Client Node Example](/img/configuration/client.webp)
*One example of a 'Client' node. Photo credit: Cully@KBOXLABS* *One example of a 'Client' node. Photo credit: Cully@KBOXLABS*