pohui_pohui/firmware
1
0
Fork 0
mirror of https://github.com/meshtastic/firmware.git synced 2025-08-19 19:53:18 +00:00
Code Issues Actions 5 Packages Projects Releases Wiki Activity
f5c939fb10
firmware/docs/software/build-instructions.md
Dafeman eda4862f0d
Update build-instructions.md
2020-09-03 08:34:52 +12:00

3.2 KiB
Raw Blame History

Build instructions

This project uses the simple PlatformIO build system. PlatformIO is an extension to Microsoft VSCode.

GUI

  1. Purchase a suitable radio.
  2. Install Python.
  3. Install Git.
  4. Reboot your computer.
  5. Install PlatformIO.
  6. Click the PlatformIO icon on the side bar. platformio icon
  7. Under Quick Access, Miscellaneous, Clone Git Project enter the URL of the Meshtastic repo found here. image
  8. Select a file location to save the repo.
  9. Once loaded, open the platformio.ini file.
  10. At the line default_envs you can change it to the board type you are building for ie. tlora-v2, tlora-v1, tlora-v2-1-1.6, tbeam, heltec, tbeam0.7 (boards are listed further down in the file).
  11. The hardware can be configured for different countries by adding a definition to the configuration.h file. #define HW_VERSION_US or HW_VERSION_EU433, HW_VERSION_EU865, HW_VERSION_CN, HW_VERSION_JP. Other country settings can be found in MeshRadio.h. The default is HW_VERSION_US.
  12. Click the PlatformIO icon on the side bar. Under Project Tasks you can now build or upload.

Note - To get a clean build you may have to delete the auto-generated file ./.vscode/c_cpp_properties.json, close and re-open Visual Studio and WAIT until the file is auto-generated before compiling again.

Command Line

  1. Purchase a suitable radio.
  2. Install PlatformIO
  3. Download this git repo and cd into it:
git clone https://github.com/meshtastic/Meshtastic-device.git
cd Meshtastic-device
  1. Run git submodule update --init --recursive to pull in dependencies this project needs.
  2. If you are outside the USA, run "export COUNTRY=EU865" (or whatever) to set the correct frequency range for your country. Options are provided for EU433, EU865, CN, JP and US (default). Pull-requests eagerly accepted for other countries.
  3. Plug the radio into your USB port
  4. 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 (either tlora-v2, tlora-v1, tlora-v2-1-1.6, tbeam, heltec, tbeam0.7).
  5. 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).