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 networks 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
- Configure your node as described below, based on how you use it:
Personal node configuration
These are nodes that you send messages from. Either fixed or mobile.
Handheld node config
These are nodes that you carry with you, in your pocket, bag, belt, mounted on your car, and so on.
- Role: CLIENT_MUTE
- Position: disabled, or
- enable smart position
- smart interval 30 minutes or more
- update distance 100 m 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: 7
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. The next-gen MediumSlow network relies on this being the maximum of 7 because the network adopts packet-level resiliency instead of link-level, and needs the additional hops to allow for retries and path diversity.
Stationary personal node config
These are your base station nodes that live on your desk or your roof, that you also send messages from. They are nodes you connect directly to, rather than use as a relay. (If you do not send messages directly from the roof node, see below.)
- Role: CLIENT
- 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.
- Device info: 18 hour interval or longer
- LoRa hop limit: 7
Explanation of the settings
CLIENT is the preferred starting point for fixed personal nodes because they are likely to provide useful conditional relay.
Position is optional, but helpful to understand the physical realities of the mesh. Smart position is not recommended, since the node is not moving. It can have trouble with variations from a GPS fix so it’s best to set an explicit fixed position. Altitude is helpful for understanding coverage.
Telemetry is preferred disabled because others generally don’t need to know your battery level or channel utilization on a regular basis. Neither are meaningful to the rest of the mesh. The node will still relay its battery info regularly when you connect your app to it.
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. The next-gen MediumSlow network relies on this being the maximum of 7 because the network adopts packet-level resiliency instead of link-level, and needs the additional hops to allow for retries and path diversity.
Infrastructure node configuration
Nodes that are in a fixed location and intended solely for relay purposes. These nodes are not used to send messages directly. They typically are solar builds in remote locations. (If you do send messages from the node, see above.)
- Role: CLIENT_BASE*
- Is Unmessagable: true
- Position:
- disable smart position
- enable altitude
- fixed position recommended
- GPS polling interval (if applicable): 24 hours
- broadcast interval: 24 hour interval or longer
- Telemetry: at least 6 hour interval
- Device info: 48 hour interval
- LoRa hop limit: 2
- (Optional, strongly recommended) Enable remote admin
Explanation of the settings
CLIENT_BASE helps differentiate the infrastructure nodes from personal 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. CLIENT_BASE is also the recommended starting point even if the node is well sited.
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.
Position is highly recommended for infrastructure nodes so users can understand which nodes provide coverage for them. (It doesn’t have to be exact, but should be a useful approximation.) 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. 24 hours is sufficient to maintain the clock without a meaningful drain on the battery of solar nodes.
Telemetry broadcasts are useful to monitor the health of the node, but more frequent than 6 hours is excessive and takes up useful airtime.
Device info is significantly curtailed because it’s not necessary for the nodes to route packets, and takes up airtime.
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
There are currently two different Meshtastic networks operating in the NYC area. Joining a network requires configuring your radio to use the same LoRa settings. You are free to join whichever one you can reach, or both if you have multiple devices.
Be a good mesh citizen: Please ensure your node follows the above configuration before connecting to the network. Please do not use high-traffic applications like Reticulum or TAK on this network; they saturate the mesh and make it unusable for everyone. Sustained encrypted traffic will be detected and blocked by the infrastructure to protect the limited airtime.
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.)
This network is actively forming. 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==
These settings are the default, out-of-the-box Meshtastic settings. A bit of infrastructure is maintained on these settings to catch newcomers, travelers, and stragglers. Some users continue with this network since it provides the greater range that they need (at the expense of severe congestion).
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 is on the latest firmware
MeshCore radio settings:
- Preset
- US/Canada
- 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:
- Ensure your repeater is on the latest firmware
- Set zero-hop auto advert interval to 360 minutes or more
- Set flood auto advert interval to 24 hours or more