Getting Started
Hardware
You will need at least a personal, handheld node that will be your direct connection to the mesh. Additionally, most people need a “roof” node to create a reliable first hop to the area infrastructure.
If you don’t already have a device, see our list of recommended complete nodes.
Meshtastic
To connect to the wide-area Meshtastic network in the NYC area…
- Ensure your node is on the latest Beta or Alpha firmware
- (optional) Enable LoRa > Ok To MQTT to show on the map/chat
Personal/handheld/mobile node configuration
- Role: CLIENT_MUTE
- Position: disabled, or
- enable smart position
- smart interval 30 minutes or more
- update distance 100 or more
- disable altitude
- GPS polling interval: 30 minutes or longer
- enable smart position
- Telemetry: off
- Device info: 18 hour interval or longer
- LoRa hop limit: 5
Explanation of the settings
CLIENT_MUTE is the preferred starting point for mobile nodes because it avoids unexpected relay behavior in an infrastructure-based mesh. Personal or mobile nodes often experience worse SNRs than fixed nodes, which causes them to relay first and potentially stop a better-placed node from relaying. It’s also important if you have two nodes in close proximity, avoiding the “false ack” problem that can hide connection issues.
Smart position is preferred because it reduces the broadcasts if position hasn’t changed. However, it has trouble with altitude so it’s best to disable this—altitude is usually not helpful for mobile nodes. Generally, position doesn’t need to be sent more frequently than 30 minutes.
Telemetry is disabled because we don’t need to know your battery level or channel utilization on a regular basis. Neither are meaningful to the rest of the mesh.
Reducing automatic device info broadcasts avoids the throttling that inhibits the request user info features, and it makes room for more useful packets generally. Also, nodes have the ability to send node info on-demand if the operator needs to advertise their info.
Personal nodes usually need more hops to work through the infill to get to and from the network backbone. On the next-gen MediumSlow network (see below) this changes to the maximum of 7 because the network adopts packet-level resliency instead of link-level, and needs the additional hops to allow for retries.
Stationary/fixed node configuration
- Role: CLIENT_BASE*
- Position: disabled, or
- disable smart position
- enable altitude
- fixed position recommended
- GPS polling interval (if applicable): 24 hours
- broadcast interval: 24 hour interval or longer
- Telemetry: off, or at least 6 hour interval if remote
- Device info: 24 hour interval
- LoRa hop limit: 3
- (Optional) Enable remote admin
Explanation of the settings
CLIENT_BASE helps differentiate the fixed nodes from mobile nodes. It also enables handy infrastructure behaviors through favoriting adjacent routers and personal nodes, features that work best when the node is in a static position.
Altitude is useful for line-of-sight estimates. But smart position has trouble with altitude if it changes due to GPS variation and can spam position unnecessarily. 24 hours is sufficient to stay on the map.
Fixed position is recommended even if there is GPS present. The GPS is still useful for keeping the node's clock accurate, but it can cause unexpected position variations due to errant GPS signal reception.
Telemetry broadcasts on a local node are unnecessary. If the node is remote, 6 hours or longer is sufficient to know its health.
Hop limit: fixed nodes should focus on advertising to their immediate vicinity. They also should be within direct or single-hop range of infrastructure, and don’t need as many hops to reach through the infill — they are the infill.
Radio settings
Please ensure your node follows the above configuration before connecting to the network.
Current primary mesh radio settings:
- Preset
- Medium Range - Slow
- Frequency slot
- 48
- Public channel name
- MediumSlow or blank
- Public channel key
- 1 byte,
AQ==
Personal nodes: increase LoRa hop limit to 7. (Yes, really.)
The network is actively migrating to MediumSlow. Not all infrastructure has moved yet. You may find it difficult to reach some parts of the network during the transition. Network status and help is available in the Discord chat.
Legacy network settings (LongFast):
- Preset
- Long Range - Fast
- Frequency slot
- 20 or 0
- Public channel name
- LongFast or blank
- Public channel key
- 1 byte,
AQ==
Explanation of the settings
The above settings are necessary to keep the network in a high-performing state. The Meshtastic default settings are oriented toward small-scale meshes that require frequent background packets to be effective. However, on large meshes these defaults are unnecessary and quickly create congestion that compromises the utility of the network for everyone. Reducing this extraneous background traffic as much as possible is essential for preserving the usefulness of the mesh.
MeshCore
To connect to the wide-area MeshCore network in the NYC area:
- Ensure your companion node or repeater is on the latest firmware
MeshCore radio settings:
- Preset
- US/Canada recommended
- Frequency
- 910.525 MHz
- Bandwidth
- 62.5 kHz
- Spread Factor
- 7
- Coding Rate
- 5
Increase coding rate if you find your messages are not getting received. This setting is cross-compatible.
For repeaters:
- Set zero-hop auto advert interval to 180 minutes or more
- Set flood auto advert interval to 12 hours or more