From fb17d2c3db1a59463c787fd6ce3f117017bcfc70 Mon Sep 17 00:00:00 2001 From: Michael Gillett <51103663+migillett@users.noreply.github.com> Date: Wed, 11 Mar 2026 22:01:04 -0400 Subject: [PATCH 1/2] move wehooper4's settings to new --- docs/config.md | 120 ++++++++++++++++++++++++++++++--------------- docs/config_new.md | 102 -------------------------------------- 2 files changed, 81 insertions(+), 141 deletions(-) delete mode 100644 docs/config_new.md diff --git a/docs/config.md b/docs/config.md index 65f55b7..eb4022c 100644 --- a/docs/config.md +++ b/docs/config.md @@ -1,60 +1,102 @@ # Recommended Configuration Settings -In order to maintain a healthy mesh network, we recommend the following configuration settings for your Meshtastic devices. +To maintain a healthy mesh network, we recommend the following configuration settings based on your node's purpose. These settings prioritize network stability by reducing unnecessary "chattiness" on our shared 3kbps bandwidth (under MediumFast). -These settings are intended to facilitate a stable and reliable mesh network. They are based on the collective experience of the Mountain Mesh community and are subject to change as the mesh grows and evolves. +!!! info + These settings are based on the collective experience of the Mountain Mesh community. Settings are subject to change as the mesh grows. -## Radio configuration +## 📱 1. Personal Mobile Nodes -### Device +*For handhelds, vehicle-mounted units, and typical end-user devices.* -| Option | Recommended Config | Notes | -| --------------------------: | :------------------------ | :-------------------------------------------------------------------------------------------------------------- | -| Role | `CLIENT` or `CLIENT_MUTE` | See :fontawesome-brands-youtube: [Meshtastic Deployment Scenarios](https://www.youtube.com/watch?v=htjwtnjQkkE) | -| NodeInfo broadcast interval | `10800` (3 hours) | | +Most users should use these settings for their everyday carry (EDC) nodes. -### Position +### Radio & LoRa -| Option | Recommended Config | Notes | -| --------------------------: | :------------------- | :---------------------------------------------- | -| Smart position enabled | `True` | | -| Position broadcast interval | `3600` (1 hour) | | -| GPS update interval | `900` (15 minutes) | | -| Position flags | Disable unused flags | Fixed nodes should disable almost all of these. | +| **Option** | **Recommended Config** | **Notes** | +| :--- | :--- | :--- | +| **Device Role** | `CLIENT` or `CLIENT_MUTE` | Use `CLIENT_MUTE` unless you have a specific need to retransmit. | +| **Modem Preset** | `MEDIUM_FAST` | Updated Oct 1, 2025. This is the new standard in N.GA. | +| **Frequency Slot** | `45` | Mediumfast Default (913.125 MHz). | +| **NodeInfo Interval** | `10800` (3 hours) | | +| **Hop Limit** | `5` | Please do not set this higher than `6`. 🙏 | +| **Ignore MQTT** | `True` | Prevents misconfigured nodes from spamming you. | +| **OK to MQTT** | `True` | Allows you to see your node on [view.MtnMe.sh](https://view.mtnme.sh). | -### LoRa +### Position & Telemetry -!!! warning -As of October 1, 2025, Mountain Mesh members flipped their nodes over to the MediumFast modem preset. For more information, see the [MediumFast Migration Page](/mediumfast) +| **Option** | **Recommended Config** | **Notes** | +| :--- | :--- | :--- | +| **Smart Position** | `True` | Updates more frequently while you are moving. | +| **Broadcast Interval** | `10800` (3 hours) | Base interval when stationary. | +| **Fixed Position** | `False` | Mobile nodes should use GPS/Phone location. | +| **Device Metrics** | `Disabled` | Others on the mesh don't need to know your battery level. | +| **Env. Metrics** | `Disabled` | Not useful for mobile nodes. | -| Option | Recommended Config | Notes | -| -------------: | :----------------- | :----------------------------------------------------------------------------------------------- | -| Modem Preset | MEDIUM_FAST | This is the new fast network | -| ^^Hop limit^^ | `5` | Please do not set this higher than `6`. :pray: | -| Frequency Slot | 45 | This is the default. It equates to 913.125 MHz | -| Ignore MQTT | `True` | This is enabled on most `ROUTER` nodes in our mesh. | -| OK to MQTT | `True` | Added in `2.5.0`. Enable to show up on online tools like [view.MtnMe.sh](https://view.mtnme.sh). | +--- +## 🏠 2. Personal/Local Infrastructure -## Module configuration +*For home base stations, attic nodes, backyard masts, and medium-height regional solar deployments.* -### Telemetry +As these nodes are stationary and always online, they don't need to be "chatty" about their location or status. -Please only enable on solar nodes where health data is useful. +### Radio & LoRa -| Option | Recommended Config | Notes | -| ----------------------------------: | :----------------- | :--------------------------------------------------------- | -| Device metrics update interval | `3600` (1 hour) | Change to `1800` when testing new nodes. | -| Environment metrics update interval | `3600` (1 hour) | | -| Power metrics module enabled | `False` | This is for I²C power monitors, not onboard battery stats. | +| **Option** | **Recommended Config** | **Notes** | +| :--- | :--- | :--- | +| **Device Role** | `CLIENT` or `CLIENT_BASE` | `CLIENT_BASE` helps ensure your EDC node messages get out. | +| **Is Un-Messagable** | `True` | Set on non-monitored nodes to prevents users from sending DMs and getting frustrated. | +| **Modem Preset** | `MEDIUM_FAST` | Updated Oct 1, 2025. This is the new standard in N.GA. | +| **Frequency Slot** | `45` | Mediumfast Default (913.125 MHz). | +| **NodeInfo Interval** | `21600` (6 hours) | Stationary nodes don't change info frequently. | +| **Hop Limit** | `3` | High hop count isn’t useful as not typically a messaged node | +| **Ignore MQTT** | `True` | Protects the mesh from internet flooding. | +| **OK to MQTT** | `True` | Allows monitoring the node from the MtnMesh web tools and helps with mesh coordination | -Consider disabling the `Environment metrics` / `Air Quality metrics` modules if you are not using the data. +### Position & Telemetry +| **Option** | **Recommended Config** | **Notes** | +| :--- | :--- | :--- | +| **Smart Position** | `False` | These aren’t moving, not needed. | +| **Broadcast Interval** | `21600` (6 hours) | It’s stationary; no need to reminded people that every hour. | +| **Fixed Position** | `True` | Manually set coordinates in the app if no hardware GPS. | +| **Device Metrics** | `10800` (3 hours) | Only for solar nodes, otherwise disable. | +| **Env. Metrics** | `10800` (3 hours) | Only if equipped; Used to checking for enclosure leaks or overheating, otherwise disable. | -### Neighbor Info +--- -| Option | Recommended Config | -| --------------------: | :----------------- | -| Neighbor Info enabled | `False` | +## 🏔️ 3. Coordinated Public Infrastructure -Neighbor Info's functionality has been greatly limited in newer firmware versions. We recommend disabling it for most deployments. +*For high-sites moving messages across the state. These are generally ham towers on actual mountains.* + +**Note:** Only coordinated infrastructure nodes should use the `ROUTER` role. Improperly configured routers can cause network-wide degradation. Please join the [Discord](https://discord.gg/4WN32RHGSs) to discuss your site before using these settings. + +### Radio & LoRa + +| **Option** | **Recommended Config** | **Notes** | +| :--- | :--- | :--- | +| **Device Role** | `ROUTER_LATE` | Better for mesh health 95% of the time than `ROUTER`. | +| **Modem Preset** | `MEDIUM_FAST` | Updated Oct 1, 2025. This is the new standard in N.GA. | +| **Frequency Slot** | `45` | Mediumfast Default (913.125 MHz). | +| **NodeInfo Interval** | `21600` (6 hours) | High-sites are constant; minimal updates needed. | +| **Rebroadcast Mode** | `CORE_PORTNUMS_ONLY` | Filters out non-essential traffic (e.g., ATAK and range test). | +| **Hop Limit** | `3` | Prevents telemetry from propagating further than useful | +| **Ignore MQTT** | `True` | **Crucial:** Protects the mesh from internet flooding. | +| **OK to MQTT** | `True` | Allows monitoring the node from the MtnMesh web tools and helps with mesh coordination. | + +### Position & Telemetry + +| **Option** | **Recommended Config** | **Notes** | +| :--- | :--- | :--- | +| **Smart Position** | `False` | Stationary high-site. | +| **Broadcast Interval** | `21600` (6 hours) | Stationary; updates every 6 hours is plenty. | +| **Fixed Position** | `True` | Manually set coordinates in the app if no hardware GPS. | +| **Device Metrics** | `10800` (3 hours) | Monitoring solar and mesh health. | +| **Env. Metrics** | `10800` (3 hours) | Only if equipped; Used to checking for enclosure leaks or overheating, otherwise disable. | + +--- + +## Why these settings matter? + +The Meshtastic network operates on a shared channel with roughly **3kbps** of usable bandwidth under MediumFast and just **1kbps** under LongFast. "Chatty" nodes—those sending updates more than necessary—can quickly saturate the network, preventing actual messages from getting through. By increasing intervals and limiting hops, we ensure the mesh remains usable for everyone. diff --git a/docs/config_new.md b/docs/config_new.md deleted file mode 100644 index 9db2658..0000000 --- a/docs/config_new.md +++ /dev/null @@ -1,102 +0,0 @@ -# Recommended Configuration Settings - -To maintain a healthy mesh network, we recommend the following configuration settings based on your node's purpose. These settings prioritize network stability by reducing unnecessary "chattiness" on our shared 3kbps bandwidth (under MediumFast). - -!!! info - These settings are based on the collective experience of the Mountain Mesh community. Settings are subject to change as the mesh grows. - -## 📱 1. Personal Mobile Nodes - -*For handhelds, vehicle-mounted units, and typical end-user devices.* - -Most users should use these settings for their everyday carry (EDC) nodes. - -### Radio & LoRa - -| **Option** | **Recommended Config** | **Notes** | -| :--- | :--- | :--- | -| **Device Role** | `CLIENT` or `CLIENT_MUTE` | Use `CLIENT_MUTE` unless you have a specific need to retransmit. | -| **Modem Preset** | `MEDIUM_FAST` | Updated Oct 1, 2025. This is the new standard in N.GA. | -| **Frequency Slot** | `45` | Mediumfast Default (913.125 MHz). | -| **NodeInfo Interval** | `10800` (3 hours) | | -| **Hop Limit** | `5` | Please do not set this higher than `6`. 🙏 | -| **Ignore MQTT** | `True` | Prevents misconfigured nodes from spamming you. | -| **OK to MQTT** | `True` | Allows you to see your node on [view.MtnMe.sh](https://view.mtnme.sh). | - -### Position & Telemetry - -| **Option** | **Recommended Config** | **Notes** | -| :--- | :--- | :--- | -| **Smart Position** | `True` | Updates more frequently while you are moving. | -| **Broadcast Interval** | `10800` (3 hours) | Base interval when stationary. | -| **Fixed Position** | `False` | Mobile nodes should use GPS/Phone location. | -| **Device Metrics** | `Disabled` | Others on the mesh don't need to know your battery level. | -| **Env. Metrics** | `Disabled` | Not useful for mobile nodes. | - ---- - -## 🏠 2. Personal/Local Infrastructure - -*For home base stations, attic nodes, backyard masts, and medium-height regional solar deployments.* - -As these nodes are stationary and always online, they don't need to be "chatty" about their location or status. - -### Radio & LoRa - -| **Option** | **Recommended Config** | **Notes** | -| :--- | :--- | :--- | -| **Device Role** | `CLIENT` or `CLIENT_BASE` | `CLIENT_BASE` helps ensure your EDC node messages get out. | -| **Is Un-Messagable** | `True` | Set on non-monitored nodes to prevents users from sending DMs and getting frustrated. | -| **Modem Preset** | `MEDIUM_FAST` | Updated Oct 1, 2025. This is the new standard in N.GA. | -| **Frequency Slot** | `45` | Mediumfast Default (913.125 MHz). | -| **NodeInfo Interval** | `21600` (6 hours) | Stationary nodes don't change info frequently. | -| **Hop Limit** | `3` | High hop count isn’t useful as not typically a messaged node | -| **Ignore MQTT** | `True` | Protects the mesh from internet flooding. | -| **OK to MQTT** | `True` | Allows monitoring the node from the MtnMesh web tools and helps with mesh coordination | - -### Position & Telemetry - -| **Option** | **Recommended Config** | **Notes** | -| :--- | :--- | :--- | -| **Smart Position** | `False` | These aren’t moving, not needed. | -| **Broadcast Interval** | `21600` (6 hours) | It’s stationary; no need to reminded people that every hour. | -| **Fixed Position** | `True` | Manually set coordinates in the app if no hardware GPS. | -| **Device Metrics** | `10800` (3 hours) | Only for solar nodes, otherwise disable. | -| **Env. Metrics** | `10800` (3 hours) | Only if equipped; Used to checking for enclosure leaks or overheating, otherwise disable. | - ---- - -## 🏔️ 3. Coordinated Public Infrastructure - -*For high-sites moving messages across the state. These are generally ham towers on actual mountains.* - -**Note:** Only coordinated infrastructure nodes should use the `ROUTER` role. Improperly configured routers can cause network-wide degradation. Please join the Discord to discuss your site before using these settings. - -### Radio & LoRa - -| **Option** | **Recommended Config** | **Notes** | -| :--- | :--- | :--- | -| **Device Role** | `ROUTER_LATE` | Better for mesh health 95% of the time than `ROUTER`. | -| **Modem Preset** | `MEDIUM_FAST` | Updated Oct 1, 2025. This is the new standard in N.GA. | -| **Frequency Slot** | `45` | Mediumfast Default (913.125 MHz). | -| **NodeInfo Interval** | `21600` (6 hours) | High-sites are constant; minimal updates needed. | -| **Rebroadcast Mode** | `CORE_PORTNUMS_ONLY` | Filters out non-essential traffic (e.g., ATAK and range test). | -| **Hop Limit** | `3` | Prevents telemetry from propagating further than useful | -| **Ignore MQTT** | `True` | **Crucial:** Protects the mesh from internet flooding. | -| **OK to MQTT** | `True` | Allows monitoring the node from the MtnMesh web tools and helps with mesh coordination. | - -### Position & Telemetry - -| **Option** | **Recommended Config** | **Notes** | -| :--- | :--- | :--- | -| **Smart Position** | `False` | Stationary high-site. | -| **Broadcast Interval** | `21600` (6 hours) | Stationary; updates every 6 hours is plenty. | -| **Fixed Position** | `True` | Manually set coordinates in the app if no hardware GPS. | -| **Device Metrics** | `10800` (3 hours) | Monitoring solar and mesh health. | -| **Env. Metrics** | `10800` (3 hours) | Only if equipped; Used to checking for enclosure leaks or overheating, otherwise disable. | - ---- - -## Why these settings matter? - -The Meshtastic network operates on a shared channel with roughly **3kbps** of usable bandwidth under MediumFast and just **1kbps** under LongFast. "Chatty" nodes—those sending updates more than necessary—can quickly saturate the network, preventing actual messages from getting through. By increasing intervals and limiting hops, we ensure the mesh remains usable for everyone. From b9e0df40a4f0a04fb954e501bb26cfffe6837f4f Mon Sep 17 00:00:00 2001 From: Michael Gillett <51103663+migillett@users.noreply.github.com> Date: Wed, 11 Mar 2026 22:12:39 -0400 Subject: [PATCH 2/2] add in smart interval and distance --- docs/config.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/config.md b/docs/config.md index eb4022c..40a2323 100644 --- a/docs/config.md +++ b/docs/config.md @@ -28,6 +28,8 @@ Most users should use these settings for their everyday carry (EDC) nodes. | **Option** | **Recommended Config** | **Notes** | | :--- | :--- | :--- | | **Smart Position** | `True` | Updates more frequently while you are moving. | +| **Smart Interval** | `15 minutes` | The fastest positions updates go out based on time | +| **Smart Distance** | `1 kilometer` | The minimum amount of distance required to re-transmit your position | | **Broadcast Interval** | `10800` (3 hours) | Base interval when stationary. | | **Fixed Position** | `False` | Mobile nodes should use GPS/Phone location. | | **Device Metrics** | `Disabled` | Others on the mesh don't need to know your battery level. |