Updated "tips" page with client_mute advice.

This commit is contained in:
David Andrzejewski 2025-02-16 17:36:10 -05:00
parent 58b731c761
commit d34c8a1e21

View file

@ -8,12 +8,23 @@ sidebar_position: 4
## 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.
### Why `CLIENT` is Recommended
- `CLIENT` nodes efficiently repeat and route packets as needed.
- They use smart delays for rebroadcasting, improving network stability.
:::tip
For details on choosing a role, read [this blog post](/blog/choosing-the-right-device-role/).
:::
### `CLIENT` and `CLIENT_MUTE` are Recommended
- `CLIENT` nodes efficiently repeat and route packets as needed.
- **Almost always the correct mode.**
- They use 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:
- Personal nodes that are in range of a higher-profile node in a dense or congested mesh.
- Enthusiasts with multiple nodes (set your "best-placed" node to `CLIENT`)
![Client Node Example](/img/configuration/client.webp)
*One example of a 'Client' node. Photo credit: Cully@KBOXLABS*
@ -33,6 +44,7 @@ Remember: A network of `CLIENT` nodes with a small number of well-placed `ROUTER
![Router Node Example](/img/configuration/router.webp)
*One example of a 'Router' node. Photo credit: Cully@KBOXLABS*
## (Not) Sharing Your Location
Telemetry is shared over your [PRIMARY channel](/docs/configuration/radio/channels#role). This means that if your node has acquired GPS coordinates from an integrated GPS chip, or from your mobile device, your coordinates will be sent to the mesh over this channel, using its defined encryption (if any).