Merge pull request #65 from migillett/feature/mediumfast-test

mediumfast Draft

Author: wehooper4

README.md

@@ -2,3 +2,19 @@
 MtnMesh GitHub Pages
 
 Edit the content in `docs/`, PR's welcomed!
+
+## Running Locally
+
+You have to build the docker container for serving the website to include a few plugins. [See this website for more details.](https://squidfunk.github.io/mkdocs-material/getting-started/#with-docker)
+
+```bash
+docker build -t mtnmesh:latest .
+```
+
+To run, use the following command:
+
+```bash
+docker run --rm -it -p 8000:8000 -v ${PWD}:/docs mtnmesh:latest
+```
+
+[View Local Dev Site Here](http://localhost:8000/)

dockerfile

@@ -0,0 +1,3 @@
+FROM squidfunk/mkdocs-material
+COPY ./requirements.txt ./requirements.txt
+RUN pip install -r ./requirements.txt

docs/builds/rak_solar.md

@@ -1,6 +1,6 @@
 # RAK Wireless Solar Build
 
-![RAK Wireless Solar Tree](/static/guides/builds/solar_tree.jpg) { width="30%" }
+![RAK Wireless Solar Tree](/static/guides/builds/solar_tree.jpg){ width="50%" }
 
 There are many builds out there for solar Meshtastic nodes, but many require unique modifications and potentially specialized tools. This build is essentially a copy of the build from [The Comms Channel](https://www.youtube.com/watch?v=d2vQ87Th8DI). Highly recommend watching this video if you haven't already. This page offers anecdotal commentary on a duplicate of this build and how it performs.
 
@@ -37,8 +37,8 @@ The build process was pretty painless. There are no instructions on how to assem
 
 Here's a look inside of the node with all parts assembled prior to deployment.
 
-![Node Internals](/static/guides/builds/solar_internals.jpg){ width="60% }
+![Node Internals](/static/guides/builds/solar_internals.jpg){ width="30% }
 
 And here is the current deployment of the node. As of April 19, 2025, the node has been in the wild for more than 2 weeks. It has been steadily charging during the day with the charge not dropping below 80%.
 
-![Node Deployed](/static/guides/builds/solar_deployed.jpg){ width="60% }
+![Node Deployed](/static/guides/builds/solar_deployed.jpg){ width="30% }

docs/index.md

@@ -4,6 +4,10 @@
 
 Mountain Mesh is a community group building a mesh network in the southern Appalachian Mountains. We are a group of makers, tech enthusiasts, and amateur radio operators who are passionate about building a resilient, decentralized, and community-owned communications network. You can learn more about us on our [About page](/about/).
 
+## [MediumFast Test](/mediumfast)
+!!! warning
+    On October 1, 2025, Mountain Mesh members are flipping their nodes over to the MediumFast modem preset. For more information on how to set your node to work with the modem test, see our [MediumFast setup guide](/mediumfast).
+
 ## Discord
 
 Come chat with us! We are active on [Discord](https://discord.gg/4WN32RHGSs). This is also where we post events such as meetups.

docs/mediumfast.md

@@ -0,0 +1,55 @@
+# Migration to MediumFast
+
+We're flipping our mesh from the default LongFast to MediumFast on October 1, 2025.
+
+[Click here for a configuration link if you don't feel like reading.](https://meshtastic.org/e/#CgcSAQE6AggNCg0SAQEaCExvbmdGYXN0EhQIARAEOAFAA0gBUB5oAcAGAcgGAQ)
+
+!!! warning
+    If you have a filter on your node, make sure it's compatible with the new MediumFast frequency before continuing. LongFast (slot 20) operates at `906.875 MHz`. MediumFast (slot 45) operates at `913.125 MHz`.
+
+## Why We're Moving Modem Presets
+
+All Meshtastic devices default to LongFast out of the box. That's a great preset for getting a small mesh off the ground, but once you get more than 60 nodes chatting in an area, you start getting message collisions. More collisions means dropped packets, network congestion and decreased performance. Considering that some node DBs have more than 200 nodes and channel usage above 45%, we're well past that threshold for migration.
+
+The good news is that this isn't uncharted territory by any means. There are several meshes that have already flipped modem presets. Meshtastic also [posted a post on their blog](https://meshtastic.org/blog/why-your-mesh-should-switch-from-longfast/) detailing when and why a mesh should flip presets.
+
+## Migrating Your Node to MediumFast
+
+### Backing Up Your Node Settings
+
+Backing up your node settings before any big changes is always a good idea. Thankfully it's easy to do with the [Meshtastic apps](https://meshtastic.org/docs/software/) or the [Meshtastic CLI](https://meshtastic.org/docs/software/python/cli/). Below is a quick way of backing up your node's settings using the CLI:
+
+```bash
+meshtastic -t {NODE_IP_HERE} --export-config > node_settings.yml
+```
+
+To restore your settings, run the following command:
+
+```bash
+meshtastic -t {NODE_IP_HERE} --configure node_settings.yml
+```
+
+!!! note
+    One sneaky trick with this configuration YAML is that you can delete specific lines that you don't want copied over. For instance, if you don't want to migrate your channel URL settings, just delete that line from the configuration. Just be careful and always keep a backup of your original config before making any modifications.
+
+### Quick Configure Link
+
+[If you want a quick easy-button configuration, use this URL](https://meshtastic.org/e/#CgcSAQE6AggNCg0SAQEaCExvbmdGYXN0EhQIARAEOAFAA0gBUB5oAcAGAcgGAQ)
+
+This link will set the following settings:
+
+- MediumFast LoRa modem preset with frequency slot of 45
+
+- 3 Hops (feel free to bump this up as you see fit, but please be gentle)
+
+- MediumFast as primary channel (0) with default PSK of `AQ==`
+
+- LongFast as secondary channel (1) with default PSK of `AQ==`
+
+This will NOT change your node's network role (Client, Client_Mute, etc.)
+
+[See our guide on recommended configurations for additional node settings.](/config)
+
+## Setting up a LongFast Bridge Network
+
+It's totally possible to create a network bridge between the 2 modem presets. You can have 2 radios on the same local area network (LAN) or even have a single linux box connected to 2 radios at once. Check out [this blog post](https://kr4ccz.net/posts/meshtastic/bridge/) for an example on how to run 2 meshtasticd interfaces at the same time using a docker network.