meshtastic-firmware/docs/software/build-instructions.md

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 (see above)
2. Install PlatformIO
3. Download this git repo and cd into it
4. Edit configuration.h and comment out one of the following two lines (depending on which board you are using):

// #define T_BEAM_V10  
#define HELTEC_LORA32

5. Plug the radio into your USB port
6. Type "pio run -t upload" (This command will fetch dependencies, build the project and install it on the board via USB)
7. 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:

1. Save the Backtrace: 0x.... line to a file, e.g., backtrace.txt.
2. Run bin/exception_decoder.py backtrace.txt (this uses symbols from the last firmware.elf, so you must be running the same binary that's still in your .pio/build directory).