kopia lustrzana https://github.com/meshtastic/firmware
47 wiersze
3.3 KiB
Markdown
47 wiersze
3.3 KiB
Markdown
# Meshtastic-esp32
|
|
|
|
This is the device side code for the [meshtastic.org](https://www.meshtastic.org) project.
|
|
|
|
Meshtastic is a project that lets you use
|
|
inexpensive GPS mesh radios as an extensible, super long battery life 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.
|
|
|
|
Typical time between recharging the radios should be about eight days.
|
|
|
|
This project is currently pre-alpha, but if you have questions please join our chat: [](https://gitter.im/Meshtastic/community?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge).
|
|
|
|
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 chat.
|
|
|
|
## Meshtastic Android app
|
|
|
|
The source code for the Meshtastic Android app is [here](https://github.com/geeksville/Meshtastic-Android).
|
|
Soon our first alpha release of will be released here:
|
|
|
|
[](https://play.google.com/store/apps/details?id=com.geeksville.mesh&referrer=utm_source%3Dgithub%26utm_medium%3Desp32-readme%26utm_campaign%3Dmeshtastic-esp32%2520readme%26anid%3Dadmob&pcampaignid=pcampaignidMKT-Other-global-all-co-prtnr-py-PartBadge-Mar2515-1)
|
|
|
|
## Supported hardware
|
|
|
|
We currently support two brands ofradios. The [TTGO T-Beam](https://www.aliexpress.com/item/4000119152086.html) and the [Heltec LoRa 32](https://heltec.org/project/wifi-lora-32/). Most users 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.
|
|
|
|
We don't yet distribute prebuilt binaries. But soon (by Feb 22) we will have a file that you can fairly easilly install on your radio via USB. Once our software is installed, all future software updates happen over bluetooth from your phone.
|
|
|
|
For a nice 3D printable case see [this design](https://www.thingiverse.com/thing:3773717) by [bsiege](https://www.thingiverse.com/bsiege).
|
|
|
|
## Build instructions
|
|
|
|
This project uses the simple PlatformIO build system. You can use the IDE, but for brevity
|
|
in these instructions I describe use of their command line tool.
|
|
|
|
1. Purchase a suitable radio (about $30 from aliexpress)
|
|
2. Install [PlatformIO](https://platformio.org/).
|
|
3. Download this git repo and cd into it.
|
|
4. Plug the radio into your USB port.
|
|
4. Type "pio run -t upload" (This command will fetch dependencies, build the project and install it on the board via USB).
|
|
5. Platform IO also installs a very nice VisualStudio Code based IDE, see their tutorial if you'd like to use it.
|