sforkowany z mirror/meshtastic-firmware
1.6 KiB
1.6 KiB
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.
- Purchase a suitable radio (see above)
- Install PlatformIO
- Download this git repo and cd into it
- Run
git submodule update --init --recursive
to pull in dependencies this project needs. - If you are outside the USA, edit platformio.ini to set the correct frequency range for your country. The line you need to change starts with
hw_version
and instructions are provided above that line. Options are provided forEU433
,EU835
,CN
,JP
andUS
(default). Pull-requests eagerly accepted for other countries. - Plug the radio into your USB port
- Type
pio run --environment XXX -t upload
(This command will fetch dependencies, build the project and install it on the board via USB). For XXX, use the board type you have (eithertbeam
,heltec
,ttgo-lora32-v1
,ttgo-lora32-v2
). - Platform IO also installs a very nice VisualStudio Code based IDE, see their tutorial if you'd like to use it.
Decoding stack traces
If you get a crash, you can decode the addresses from the Backtrace:
line:
- Save the
Backtrace: 0x....
line to a file, e.g.,backtrace.txt
. - Run
bin/exception_decoder.py backtrace.txt
(this uses symbols from the lastfirmware.elf
, so you must be running the same binary that's still in your.pio/build
directory).