mirror of
https://github.com/meshtastic/meshtastic.git
synced 2024-11-11 16:14:24 -08:00
9dc879235f
* initial devices.json * initial hardware components * testing page at /docs/hardware/supported/template * WIP Changes * Home page work & updates * Fix build * Fix external link button * Setup linting * rename, cleanup & lint * seperate lint cmd for now Co-authored-by: Foster Irwin <foster@jfirwin.com> Co-authored-by: Sacha Weatherstone <sachaw100@hotmail..om>
29 lines
1.4 KiB
Plaintext
29 lines
1.4 KiB
Plaintext
---
|
|
id: build
|
|
title: Creating a build environment
|
|
sidebar_label: Building Meshtastic
|
|
---
|
|
|
|
Meshtastic uses the [PlatformIO](https://platformio.org) development environment, that enables easy multiplatform development and centralized tooling.
|
|
|
|
## Setup
|
|
|
|
1. Install PlatformIO, following the instructions available [here](https://platformio.org/platformio-ide).
|
|
|
|
2. Clone the `meshtastic-device` repository located [here](https://github.com/meshtastic/meshtastic-device). ([Instructions on cloning](https://docs.github.com/en/repositories/creating-and-managing-repositories/cloning-a-repository))
|
|
|
|
3. Clone the [Submodules](https://git-scm.com/book/en/v2/Git-Tools-Submodules)
|
|
|
|
```shell
|
|
git submodule update --init
|
|
```
|
|
|
|
4. Some utilities and scripts use the Python programming language, Downloads available [here](https://www.python.org/downloads).
|
|
|
|
## Building
|
|
|
|
1. Open the newly cloned folder in [Visual Studio Code](https://code.visualstudio.com).
|
|
1. To select the device you you wish to build for, first open your [command palette](https://code.visualstudio.com/docs/getstarted/userinterface#_command-palette) (`Ctrl + Shift + P`) and enter: `platformio: Switch Project Environment` and select your target.
|
|
1. To build the firmware, simply run `PlatformIO: Build` from your command palette.
|
|
1. Finally flashing the firmware to your device is as easy as running `PlatformIO: Upload`
|