mirror of
https://github.com/meshtastic/meshtastic.git
synced 2025-02-21 03:25:51 -08:00
3a6cd3b2cc
* added revised site planner announcement blog post and corrected screenshot images Checked spelling, grammar in the .mdx blog post and removed repeated language. Cropped screenshots and changed them so they now reflect the openstreetmap background instead of the dark mode, which was removed. * Create index.mdx * Update meshtastic-site-planner-introduction.mdx update PR to include author file, change author name * Update authors.yml try again to update authors.yaml * update authors yaml and fix broken link * Update authors.yml prevent ben from editing the css by using a title. ensured it was spelled correctly. * remove bold in intro --------- Co-authored-by: rcarteraz <robert.l.carter2@gmail.com>
46 lines
3.8 KiB
Plaintext
46 lines
3.8 KiB
Plaintext
---
|
|
id: siteplanner
|
|
title: Meshtastic Site Planner
|
|
sidebar_label: Meshtastic Site Planner
|
|
sidebar_position: 5
|
|
description: Overview of Meshtasticator Site Planner - for making predictions of radio range which account for physics and terrain
|
|
---
|
|
|
|
The Meshtastic Site Planner is a open-source web utility for predicting node range and coverage. It can be found on site.meshtastic.org, and the source code is maintained at https://github.com/meshtastic/meshtastic-site-planner.
|
|
|
|
|
|
## Getting Started
|
|
|
|
1. Go to the [official version](https://site.meshtastic.org) or run a development copy and open the tool in a web browser.
|
|
2. In `Site Parameters > Site / Transmitter`, enter a name for the site, the geographic coordinates, and the antenna height above ground. Refer to the Meshtastic regional parameters (https://meshtastic.org/docs/configuration/region-by-country/) and input the transmit power, frequency, and antenna gain for your device.
|
|
3. In `Site Parameters > Receiver`, enter the receiver sensitivity (`-130 dBm` for the default `LongFast` channel), the receiver height, and the receiver antenna gain.
|
|
4. In `Site Parameters > Receiver`, enter the maximum range for the simulation in kilometers. Selecting long ranges (> 50 kilometers) will result in longer computation times.
|
|
5. Press "Run Simulation." The coverage map will be displayed when the calculation completes.
|
|
|
|
Multiple radio sites can be added to the simulation by repeating these steps. The other adjustable parameters default to sensible choices for meshtastic radios, but you can change them if your project uses different hardware.
|
|
|
|
## Understanding Results
|
|
|
|
The Meshtastic Site Planner creates a color-coded map of where your radio signal will reach, given the terrian and simulation parameters. The expected signal strength (RSSI) can be read from the colorbar. Regions with a strong signal (predicted RSSI > -110 dBm) have a stronger chance of sucessfully receiving and sending signals. In areas with a low RSSI (< 125 dBm), obstacles may limit communication reliability. You can adjust the signal cutoff threshold under `Receiver > Sensitivity Limit`. Minimum signal thresholds depend on the radio chipset and presets, and are approximately as follows:
|
|
|
|
| **Preset** | **Bandwidth (kHz)** | **Spreading Factor (SF)** | **Coding Rate** | **Sensitivity (dBm)** |
|
|
|-------------------|---------------------|---------------------------|-----------------|-----------------------|
|
|
| **ShortTurbo** | 500 | 7 | 4/5 | -117 |
|
|
| **ShortFast** | 250 | 7 | 4/5 | -121 |
|
|
| **ShortSlow** | 250 | 8 | 4/5 | -124 |
|
|
| **MediumFast** | 250 | 9 | 4/5 | -127 |
|
|
| **MediumSlow** | 250 | 10 | 4/5 | -130 |
|
|
| **LongFast** | 125 | 11 | 4/5 | -133 |
|
|
| **LongModerate** | 125 | 11 | 4/8 | -136 |
|
|
| **LongSlow** | 125 | 12 | 4/8 | -137 |
|
|
| **VeryLongSlow** | 62.5 | 12 | 4/8 | -141 |
|
|
|
|
|
|
## Limitations
|
|
|
|
The Site Planner uses terrain data from the NASA SRTM (Shuttle Radar Topography) mission. This elevation dataset is accurate to around 90 meters, and does not account for obstructions such as buildings or trees. You can estimate the effect of random obstructions by entering their average height in `Environment > Clutter Height`. It is a good idea to always verify predictions from this tool using real-world testing.
|
|
|
|
|
|
|
|
|