meshtastic-firmware/docs/README.md

74 wiersze
5.6 KiB
Markdown
Czysty Zwykły widok Historia

2020-02-15 17:28:53 +00:00
# What is Meshtastic?
2020-02-12 18:32:20 +00:00
2020-02-15 17:28:53 +00:00
Meshtastic is a project that lets you use
2020-02-21 06:11:13 +00:00
inexpensive ($30 ish) GPS radios as an extensible, super long battery life mesh GPS communicator. These radios are great for hiking, skiing, paragliding -
2020-02-15 17:28:53 +00:00
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.
2020-02-20 22:05:18 +00:00
### Uses
2020-02-20 22:14:27 +00:00
* Outdoor sports where cellular coverage is limited. (Hiking, Skiing, Boating, Paragliding, Gliders etc..)
* Applications where closed source GPS communicators just won't cut it (it is easy to add features for glider pilots etc...)
2020-02-20 22:05:18 +00:00
* Secure long-range communication within groups without depending on cellular providers
2020-02-20 22:26:33 +00:00
* Finding your lost kids ;-)
2020-02-20 22:05:18 +00:00
2020-02-20 22:15:27 +00:00
[![Youtube video demo](desk-video-screenshot.png)](https://www.youtube.com/watch?v=WlNbMbVZlHI "Meshtastic early demo")
2020-02-20 22:05:18 +00:00
### Features
2020-03-03 21:37:01 +00:00
Not all of these features are fully implemented yet - see **important** disclaimers below. But they should be in by the time we decide to call this project beta (three months?)
2020-02-20 22:05:18 +00:00
2020-02-21 05:06:23 +00:00
* Very long battery life (should be about eight days with the beta software)
* Built in GPS and [LoRa](https://en.wikipedia.org/wiki/LoRa) radio, but we manage the radio automatically for you
2020-02-20 22:23:36 +00:00
* Long range - a few miles per node but each node will forward packets as needed
2020-02-20 22:05:18 +00:00
* Shows direction and distance to all members of your channel
2020-02-21 05:01:31 +00:00
* Directed or broadcast text messages for channel members
2020-02-20 22:05:18 +00:00
* Open and extensible codebase supporting multiple hardware vendors - no lock in to one vendor
2020-02-21 05:01:31 +00:00
* Communication API for bluetooth devices (such as our Android app) to use the mesh. So if you have some application that needs long range low power networking, this might work for you.
2020-02-20 22:05:18 +00:00
* Eventually (within a couple of months) we should have a modified version of Signal that works with this project.
2020-02-26 22:27:00 +00:00
* Very easy sharing of private secured channels. Just share a special link or QR code with friends and they can join your encrypted mesh
2020-02-20 22:05:18 +00:00
2020-03-13 22:06:51 +00:00
This project is currently in early alpha - if you have questions please [join our discussion forum](https://meshtastic.discourse.group/).
2020-02-15 17:28:53 +00:00
2020-03-13 22:06:51 +00:00
This software is 100% open source and developed by a group of hobbyist experimenters. No warranty is provided, if you'd like to improve it - we'd love your help. Please post in the [forum](https://meshtastic.discourse.group/).
2020-02-15 17:28:53 +00:00
# Updates
2020-02-20 20:49:34 +00:00
2020-03-03 21:37:01 +00:00
Note: Updates are happening almost daily, only major updates are listed below. For more details see our chat, github releases or the Android alpha tester emails.
* 03/03/2020 - 0.0.9 of the Android app and device code is released. Still an alpha but fairly functional.
2020-02-25 19:22:42 +00:00
* 02/25/2020 - 0.0.4 of the Android app is released. This is a very early alpha, see below to join the alpha-testers group.
* 02/23/2020 - 0.0.4 release. Still very bleeding edge but much closer to the final power management, a charged T-BEAM should run for many days with this load. If you'd like to try it, we'd love your feedback. Click [here](https://github.com/meshtastic/Meshtastic-esp32/blob/master/README.md) for instructions.
2020-02-26 22:27:00 +00:00
* 02/20/2020 - Our first alpha release (0.0.3) of the radio software is ready brave early people.
2020-02-20 20:49:34 +00:00
2020-02-15 17:28:53 +00:00
## Meshtastic Android app
2020-02-25 19:22:42 +00:00
Once out of alpha the companion Android application will be released here:
2020-02-15 17:37:22 +00:00
2020-02-15 17:28:53 +00:00
[![Download at https://play.google.com/store/apps/details?id=com.geeksville.mesh](https://play.google.com/intl/en_us/badges/static/images/badges/en_badge_web_generic.png)](https://play.google.com/store/apps/details?id=com.geeksville.mesh&referrer=utm_source%3Dhomepage%26anid%3Dadmob)
2020-02-25 19:22:42 +00:00
But if you want the bleeding edge app now, we'd love to have your help testing. Three steps to opt-in to the alpha- test:
2020-02-21 06:11:13 +00:00
2020-02-15 18:22:42 +00:00
1. Join [this Google group](https://groups.google.com/forum/#!forum/meshtastic-alpha-testers) with the account you use in Google Play.
2. Go to this [URL](https://play.google.com/apps/testing/com.geeksville.mesh) to opt-in to the alpha test.
2020-03-13 22:06:51 +00:00
3. If you encounter any problems or have questions, post in our [forum](https://meshtastic.discourse.group/) and we'll help.
2020-02-15 18:22:42 +00:00
If you'd like to help with development, the source code is [on github](https://github.com/meshtastic/Meshtastic-Android).
2020-02-20 22:14:27 +00:00
2020-02-15 17:28:53 +00:00
## Supported hardware
2020-02-26 22:27:00 +00:00
We currently support two brands of radios. The [TTGO T-Beam](https://www.aliexpress.com/item/4000119152086.html) and the [Heltec LoRa 32](https://heltec.org/project/wifi-lora-32/). Most people should buy the T-Beam and a 18650 battery (total cost less than $35). Make
sure to buy the frequency range which is legal for your country. For the USA, you should buy the 915MHz version. Getting a version that include a screen is optional, but highly recommended.
2020-02-15 17:28:53 +00:00
Instructions for installing prebuilt firmware can be found [here](https://github.com/meshtastic/Meshtastic-esp32/blob/master/README.md).
2020-02-15 17:28:53 +00:00
For a nice printable cases:
1. TTGO T-Beam V0 see this [design](https://www.thingiverse.com/thing:3773717) by [bsiege](https://www.thingiverse.com/bsiege).
2. TTGO T_Beam V1 see this [design](https://www.thingiverse.com/thing:3830711) by [rwanrooy](https://www.thingiverse.com/rwanrooy) or this [remix](https://www.thingiverse.com/thing:3949330) by [8ung](https://www.thingiverse.com/8ung)
3. Heltec Lora32 see this [design](https://www.thingiverse.com/thing:3125854) by [ornotermes](https://www.thingiverse.com/ornotermes).
2020-02-20 22:05:18 +00:00
2020-03-11 17:51:38 +00:00
# IMPORTANT DISCLAIMERS AND FAQ
2020-02-20 22:05:18 +00:00
2020-03-11 17:51:38 +00:00
For a listing of currently missing features and a FAQ click [here](faq.md).