First fixes

This commit is contained in:
apt105 2021-05-03 00:54:21 +01:00
parent 1144b1ad0e
commit 8384fb5de6
11 changed files with 78 additions and 63 deletions

View file

@ -1,14 +0,0 @@
---
id: supported-hardware
title: Supported Hardware
sidebar_label: Supported Hardware
---
| Vendor | Product line | Version | Board labels | Notes | URL |
| ------ | ------------ | ------- | ---------------- | --------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------- |
| TTGO | T-Beam | 0.7 | T22_V07 20180711 | LoRa 433/470MHz _OR_ LoRa 868/915MHz , <br/>GPS ublox NEO-6M , <br/>battery holder for Li-Ion 18650 | [buy](https://www.aliexpress.com/item/4000574335430.html) |
| TTGO | T-Beam | 1.0 | | | [buy](https://www.aliexpress.com/item/4001178678568.html) |
| TTGO | T-Beam | 1.1 | T22_V11 20191212 | LoRa 433/470MHz _OR_ LoRa 868/915MHz _OR_ LoRa 923MHz , <br/>GPS ublox NEO-M8N , <br/>battery holder for Li-Ion 18650 | [buy](https://www.aliexpress.com/item/4001178678568.html) |
| TTGO | Lora32 | 2.0 | _missing_ | LoRa 433/470MHz _OR_ LoRa 868/915MHz , <br/>OLED SSD1306 , <br/>SD card holder | [buy](https://www.aliexpress.com/item/4000211331316.html) |
| TTGO | Lora32 | 2.1 | T3_V1.6 20180606 | LoRa 32 (V2) , <br/>SD card holder | [buy](https://www.aliexpress.com/item/4000119208093.html) |
| Heltec | Lora 32 | V2 | V2 | LoRa 433/470MHz _OR_ LoRa 868/915MHz | [buy](https://heltec.org/project/wifi-lora-32/) |

View file

@ -7,8 +7,7 @@ slug: /about
<!--- TODO create new about page and remove it from the "documentation" section ---> <!--- TODO create new about page and remove it from the "documentation" section --->
Meshtastic® is a project that lets you use Meshtastic® is a project that lets you use inexpensive ($30 ish) LoRa radios as an extensible, long battery life, secure, mesh GPS communicator. These radios are great for hiking, skiing, paragliding - essentially any hobby where you don't have reliable internet access. Each member of your private mesh can always see the location and distance of all other members and any text messages sent to your group chat.
inexpensive ($30 ish) GPS radios as an extensible, long battery life, secure, mesh GPS communicator. These radios are great for hiking, skiing, paragliding - essentially any hobby where you don't have reliable internet access. Each member of your private mesh can always see the location and distance of all other members and any text messages sent to your group chat.
The radios automatically create a mesh to forward packets as needed, so everyone in the group can receive messages from even the furthest member. The radios will optionally work with your phone, but no phone is required. The radios automatically create a mesh to forward packets as needed, so everyone in the group can receive messages from even the furthest member. The radios will optionally work with your phone, but no phone is required.

View file

@ -7,7 +7,7 @@ slug: /getting-started
## Purchase a Radio ## Purchase a Radio
The easiest way is to [buy a device with the software already installed](https://www.aliexpress.com/item/4001178678568.html) In the Americas get the 915mhz version, In Europe the 868Mhz or Asia 923Mhz see [here](https://www.thethingsnetwork.org/docs/lorawan/frequencies-by-country.html). The easiest way is to [buy a device with the software already installed](https://www.aliexpress.com/item/4001178678568.html). Other devices are [available](/docs/hardware/tbeam-hardware). In the Americas get the 915mhz version, in Europe the 868Mhz, or Asia 923Mhz. See this listing by [The Things Network](https://www.thethingsnetwork.org/docs/lorawan/frequencies-by-country.html) for frequencies by specific countries.
## Setup the Radio ## Setup the Radio
@ -19,7 +19,7 @@ Make sure not to power the radio on without first attaching the antenna! You cou
## Download Firmware ## Download Firmware
Prebuilt binaries for the supported radios are available in our releases. Your initial installation has to happen over USB from your Mac, Windows or Linux PC. Once our software is installed, all future software updates happen over bluetooth from your phone. Prebuilt binaries for the supported radios are available in our releases. Your initial installation has to happen over USB from your Mac, Windows or Linux PC. Once our software is installed, all future software updates can happen over bluetooth from your phone.
<!--- TODO I'd like to create prettier buttons for this than just a table ---> <!--- TODO I'd like to create prettier buttons for this than just a table --->
| [Current Firmware](https://github.com/meshtastic/meshtastic-device/releases/latest) | [List of Firmware Versions](https://github.com/meshtastic/meshtastic-device/releases/) | | [Current Firmware](https://github.com/meshtastic/meshtastic-device/releases/latest) | [List of Firmware Versions](https://github.com/meshtastic/meshtastic-device/releases/) |
@ -27,7 +27,7 @@ Prebuilt binaries for the supported radios are available in our releases. Your i
## Flashing Firmware ## Flashing Firmware
If your device already has Meshtastic flashed to it, You can update over the air (OTA). Otherwise you'll need a computer and a **data** USB cable. If your device already has Meshtastic flashed to it, You can update it over the air (OTA). Otherwise you'll need a computer and a **data** USB cable. This can be done in the following ways:
- Install using the command line interface (CLI) - Install using the command line interface (CLI)
- Install using a graphical user interface (GUI) - Install using a graphical user interface (GUI)
@ -35,13 +35,13 @@ If your device already has Meshtastic flashed to it, You can update over the air
## Connect to your Device ## Connect to your Device
There are many ways to connect to your new radio! Using the command line interface There are many ways to connect to your new radio!
- Command line interface (CLI) - Command line interface (CLI)
- Graphic user interface (GUI) - Graphic user interface (GUI)
- Serial connection - Serial connection
- Bluetooth - Bluetooth
- Web (in development) - Web app over wifi (in development)
## Troubleshooting ## Troubleshooting

View file

@ -115,3 +115,36 @@ This can be done by utilising the [range test plugin](/docs/software/plugins/ran
To comment on / join in antenna range [Meshtastic discourse](https://meshtastic.discourse.group/t/antenna-improved-range/227/35?u=sens8tion) To comment on / join in antenna range [Meshtastic discourse](https://meshtastic.discourse.group/t/antenna-improved-range/227/35?u=sens8tion)
There, you will also find reference to Meshtastic range achievements, aerial recommendations (note we've stopped short of making specific supplier aerial recommendations in this wiki). There, you will also find reference to Meshtastic range achievements, aerial recommendations (note we've stopped short of making specific supplier aerial recommendations in this wiki).
## Resources
### Coverage prediction
* [Tower Coverage.com](https://www.towercoverage.com/)
* Commercial but has free options
* [HeyWhat'sThat](http://www.heywhatsthat.com/)
* Free with path profiling options
* [Radio Mobile Online](https://www.ve2dbe.com/rmonline_s.asp)
* Radio Mobile Online is a radio wave propagation prediction tool dedicated to amateur radio
### RF Tools
* [Times Microwave Systems](https://www.timesmicrowave.com/calculator/?Product=RG-6&RunLength=10&Frequency=868)
* Coaxial Cable Attenuation & Power Handling Calculator
* [Solwise Link Budget Calculator](https://www.solwise.co.uk/link-budget.htm)
* Predict the received signal strength
### Antenna designs
* [1/4 Wave Ground Plane Antenna Calculator](https://m0ukd.com/calculators/quarter-wave-ground-plane-antenna-calculator/)
* [Quadrifilar helicoidal antenna calculator](https://jcoppens.com/ant/qfh/calc.en.php)

View file

@ -79,4 +79,8 @@ sidebar_label: LILYGO® Lora
* Firmware file: `firmware-tlora-v2-1-1.6-1.x.x.bin` * Firmware file: `firmware-tlora-v2-1-1.6-1.x.x.bin`
* [Purchase link](https://www.aliexpress.com/item/32915894264.html) * [Purchase link](https://www.aliexpress.com/item/32915894264.html)
:::warning
Some of these boards contained the wrong component in the lipo battery charging circuit allowing the battery to be overcharged. While this does appear to have been fixed recently, please see the [warning](https://www.thethingsnetwork.org/community/berlin/post/warning-attention-users-of-ttgo21-v16-boards-labeled-t3_v16-on-pcb-battery-exploded-and-got-on-fire) on The Things Network for more information.
:::
[<img src="/img/hardware/lora-v2.1-1.6.png" alt="LILYGO® TTGO Lora V2.1-1.6" style={{zoom:'25%'}} />](/img/hardware/lora-v2.1-1.6.png) [<img src="/img/hardware/lora-v2.1-1.6.png" alt="LILYGO® TTGO Lora V2.1-1.6" style={{zoom:'25%'}} />](/img/hardware/lora-v2.1-1.6.png)

View file

@ -0,0 +1,19 @@
---
id: privacy
title: Meshtastic privacy policy
sidebar_label: Privacy
---
We don't collect any personal identifying information.
If you have opted-in to analytics on the Android app (thank you - that helps us know what things we need to improve), we will receive anonymized information about user behavior. This includes crash reports, which screens you used in the app etc... Analytics is provided by [Crashlytics](https://firebase.google.com/products/crashlytics).
We never capture usernames, the contents of your texts or your location.
Maps provided by Mapbox require analytics to work. For more information about what they collect, please see the [Mapbox privacy policy](https://www.mapbox.com/legal/privacy/).
The search engine for this website is provided by Algolia, please see their [privacy policy](https://www.algolia.com/policies/privacy/) for details of what information they collect.
This is an open-source project run by hobbyists and we try to be completely transparent. If you have questions on this policy, please post on the forum and we'll reply/clarify/correct.
Keep being awesome!

View file

@ -121,7 +121,7 @@ There is no long-term store-and-forward of messages, so messages not received wi
### View your network ### View your network
The network list shows all the users (devices) that have connected to the same Channel. For each entry, it shows the last time they were active, their distance, and their last known power status (battery & percentage, or external power). In the example below, Eddie is the local user, Mike is active and 29m away, and a third node has been inactive since 9:02pm. The network list shows all the users (devices) that have connected to the same Channel. For each entry, it shows the last time they were active, their distance, and their last known power status (battery & percentage, or external power). In the example below, Lora V2 is the local user, m8n was last heard from 3 minutes ago and is 29m away, and 25C is active and 498m away.
This is a list of network nodes, rather than users, so where there is a named user connected to the device, you will see the user name, otherwise the node is shown as `Unknown a3c9` (where `a3c9` is the last 4 hex digits from the MAC address.) This is a list of network nodes, rather than users, so where there is a named user connected to the device, you will see the user name, otherwise the node is shown as `Unknown a3c9` (where `a3c9` is the last 4 hex digits from the MAC address.)
@ -133,11 +133,13 @@ The Map tab will show a local map with an icon for each active mesh node that ha
[![Mapping provided by Mapbox](/img/android/android-map-sm.png)](/img/android/android-map.png) [![Mapping provided by Mapbox](/img/android/android-map-sm.png)](/img/android/android-map.png)
The map is not developed by the Meshtastic project, and the source of the maps is [Mapbox](https://docs.mapbox.com/help/how-mapbox-works/) (free-tier), and the map data is sourced from [OpenStreetMap OSM](https://www.openstreetmap.org/). Mapbox currently requires analytics to be enabled for you to use their mapping system. There is currently no off-line maps (phone needs mobile data), although this will be improved in the future. If you don't see the features that you'd expect on the map then head over to [OpenStreetMap OSM](https://www.openstreetmap.org/) where you can contribute new data to the map. The map is not developed by the Meshtastic project, and the source of the mapping system is [Mapbox](https://docs.mapbox.com/help/how-mapbox-works/) (free-tier), and the map data is sourced from [OpenStreetMap OSM](https://www.openstreetmap.org/). Mapbox currently requires analytics to be enabled for you to use their mapping system. There is currently no off-line maps (phone needs mobile data or wifi), although this will be improved in the future. If you don't see the features that you'd expect on the map then head over to [OpenStreetMap OSM](https://www.openstreetmap.org/) where you can contribute new data to the map.
## Configuration options ## Configuration options
Pressing the three verticle dots in the top right corner shows the configuration menu.
[![Meshtastic configuration options](/img/android/android-settings-options-c.png)](/img/android/android-settings-options.png) [![Meshtastic configuration options](/img/android/android-settings-options-c.png)](/img/android/android-settings-options.png)
### Advanced settings ### Advanced settings

View file

@ -1,27 +0,0 @@
---
id: remote-hardware-service
title: Remote Hardware Service
sidebar_label: Remote Hardware
---
FIXME - the following are a collection of notes moved from elsewhere. We need to refactor these notes into actual documentation on the remote-hardware/gpio service.
### 1.7.2. New 'no-code-IOT' mini-app
Add a new 'remote GPIO/serial port/SPI/I2C access' mini-app. This new standard app would use the MQTT messaging layer to let users (developers that don't need to write device code) do basic (potentially dangerous) operations remotely.
#### 1.7.2.1. Supported operations in the initial release
Initially supported features for no-code-IOT.
- Set any GPIO
- Read any GPIO
#### 1.7.2.2. Supported operations eventually
General ideas for no-code IOT.
- Subscribe for notification of GPIO input status change (i.e. when pin goes low, send my app a message)
- Write/read N bytes over I2C/SPI bus Y (as one atomic I2C/SPI transaction)
- Send N bytes out serial port Z
- Subscribe for notification for when regex X matches the bytes that were received on serial port Z

View file

@ -57,7 +57,7 @@ The channel settings can be changed similiarly. Either by using a standard (sha
The URL is constructed automatically based off of the current channel settings. So if you want to customize a channel you could do something like: The URL is constructed automatically based off of the current channel settings. So if you want to customize a channel you could do something like:
```bash ```bash
meshtastic --setchan name mychan --setchan channel_num 4 --info meshtastic --ch-set name mychan --ch-set channel_num 4 --info
``` ```
This will change some channel params and then show device info (which will include the current channel URL) This will change some channel params and then show device info (which will include the current channel URL)
@ -65,14 +65,14 @@ This will change some channel params and then show device info (which will inclu
You can even set the channel preshared key to a particular AES128 or AES256 sequence. You can even set the channel preshared key to a particular AES128 or AES256 sequence.
```bash ```bash
meshtastic --setchan psk 0x1a1a1a1a2b2b2b2b1a1a1a1a2b2b2b2b1a1a1a1a2b2b2b2b1a1a1a1a2b2b2b2b --info meshtastic --ch-set psk 0x1a1a1a1a2b2b2b2b1a1a1a1a2b2b2b2b1a1a1a1a2b2b2b2b1a1a1a1a2b2b2b2b --info
``` ```
Use `--setchan psk none` to turn off encryption. Use `--ch-set psk none` to turn off encryption.
Use `--setchan psk random` will assign a new (high quality) random AES256 key to the primary channel (similar to what the Android app does when making new channels). Use `--ch-set psk random` will assign a new (high quality) random AES256 key to the primary channel (similar to what the Android app does when making new channels).
Use `--setchan psk default` to restore the standard 'default' (minimally secure, because it is in the source code for anyone to read) AES128 key. Use `--ch-set psk default` to restore the standard 'default' (minimally secure, because it is in the source code for anyone to read) AES128 key.
### Ham radio support ### Ham radio support

View file

@ -12,17 +12,17 @@ This problem seems to occur when your board has the partitioning structure set i
There are a number of methods that essentially involve erasing the flash and then re-uploading the Meshtastic firmware. There are a number of methods that essentially involve erasing the flash and then re-uploading the Meshtastic firmware.
### Install Script ## Install Script
The most reliable way to fix this problem is to use the install script that is included in the meshtastic firmware zip. If that doesnt work, these other methods may work: The most reliable way to fix this problem is to use the install script that is included in the meshtastic firmware zip. If that doesnt work, these other methods may work:
### Alternative methods ## Alternative methods
#### Using the Arduino IDE: ### Using the Arduino IDE:
https://meshtastic.discourse.group/t/solved-help-installing-with-other-than-esphome-flasher/2214/9 https://meshtastic.discourse.group/t/solved-help-installing-with-other-than-esphome-flasher/2214/9
#### Using Pio in Windows ### Using Pio in Windows
```powershell ```powershell
pio run --target erase --environment tbeam pio run --target erase --environment tbeam
``` ```
@ -30,7 +30,7 @@ Then re-install the firmware ie using ESPHome Flasher
Requires: [Python](https://www.python.org/), [Pio](https://pypi.org/project/pio/), command to be run in the root directory of the meshtastic-device project once youve cloned it (this last requirement is an assumption based on pio not knowing what a tbeam is, may also require Visual Studio Code and PlatformIO as these were installed during use). Requires: [Python](https://www.python.org/), [Pio](https://pypi.org/project/pio/), command to be run in the root directory of the meshtastic-device project once youve cloned it (this last requirement is an assumption based on pio not knowing what a tbeam is, may also require Visual Studio Code and PlatformIO as these were installed during use).
#### Esptool.py ### Esptool.py
@1984 posted another method using the python based esptool.py to erase and re-flash the firmware: @1984 posted another method using the python based esptool.py to erase and re-flash the firmware:
```bash ```bash
esptool.py --baud 921600 erase_flash esptool.py --baud 921600 erase_flash
@ -41,7 +41,7 @@ esptool.py --baud 921600 write_flash 0x10000 firmware-tbeam-EU865-1.1.42.bin
Requires: [Python](https://www.python.org/) and [esptool.py](https://github.com/espressif/esptool) Requires: [Python](https://www.python.org/) and [esptool.py](https://github.com/espressif/esptool)
#### Visual Studio & PlatformIO ### Visual Studio & PlatformIO
There is also the method of using the Visual Studio IDE. This requires having Visual Studio and PlatformIO installed, along with having cloned the meshtastic-device code as per the [build instructions](https://github.com/meshtastic/Meshtastic-device/blob/master/docs/software/build-instructions.md)<!-- link to be changed once build page is completed -->. After loading the project in Visual Studio, select the PlatformIO alien icon, then find the appropriate device, and then click the Erase Flash command. There is also the method of using the Visual Studio IDE. This requires having Visual Studio and PlatformIO installed, along with having cloned the meshtastic-device code as per the [build instructions](https://github.com/meshtastic/Meshtastic-device/blob/master/docs/software/build-instructions.md)<!-- link to be changed once build page is completed -->. After loading the project in Visual Studio, select the PlatformIO alien icon, then find the appropriate device, and then click the Erase Flash command.
![Erasing the flash using PlatformIO in Visual Studio Code](/img/platformio-erase.png) ![Erasing the flash using PlatformIO in Visual Studio Code](/img/platformio-erase.png)

View file

@ -80,7 +80,6 @@ module.exports = {
{ {
Other: [ Other: [
"software/other/sw-design", "software/other/sw-design",
"software/other/remote-hardware-service",
"software/other/rak815", "software/other/rak815",
"software/other/power", "software/other/power",
"software/other/plugin-api", "software/other/plugin-api",
@ -120,7 +119,6 @@ module.exports = {
"developers/device/radio-settings", "developers/device/radio-settings",
"developers/device/encryption", "developers/device/encryption",
"developers/device/portnum", "developers/device/portnum",
"developers/device/supported-hardware",
"developers/device/http-api", "developers/device/http-api",
"developers/device/documents", "developers/device/documents",
], ],
@ -130,6 +128,7 @@ module.exports = {
"legal/overview", "legal/overview",
"legal/licensing", "legal/licensing",
"legal/trademark", "legal/trademark",
"legal/privacy",
], ],
}, },
}; };