mudhorn/meshtastic
1
0
Fork 0
mirror of https://github.com/meshtastic/meshtastic.git synced 2025-02-21 03:25:51 -08:00
Code Issues Actions Packages Projects Releases Wiki Activity

Created Linux firmware flashing page. TODO add GUI section for ubuntu esphome-flasher release

Browse source
This commit is contained in:
Foster Irwin 2021-04-15 13:57:34 -06:00
parent 0ac9c9cd33
commit 334026ab1e
2 changed files with 70 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

69
website/docs/getting_started/flashing_firmware/linux.md Normal file
View file

@ -0,0 +1,69 @@
---
id: linux
title: Flashing Firmware – Linux
sidebar_label: Linux
---
:::note
To check if you have a data cable that will work, plug in your device and **then** navigate to `Apple Menu  > About This Mac > System Report... > Hardware > USB`
you should see something like `CP210X USB to UART Bridge Controller`.
:::
## Download Firmware
<!--- TODO add buttons to links --->
Download the [latest](https://github.com/meshtastic/meshtastic-device/releases/latest) firmware release. Unzip the file and locate the correct device and region within the list of prebuilt binaries.
## Command Line Instructions
Requires `Python` and `pip`
1. Install `esptool`
```bash
pip install --upgrade esptool
```
2. Connect your radio to your USB port
3. Confirm that your device is talking to your Mac by running the following command in Terminal
```bash title="Command"
esptool.py chip_id
```
```bash title="Expected Output"
# You should see a result similar to this:
mydir$ esptool.py chip_id
esptool.py v2.6
Found 2 serial ports
Serial port /dev/ttyUSB0
Connecting....
Detecting chip type... ESP32
Chip is ESP32D0WDQ6 (revision 1)
Features: WiFi, BT, Dual Core, 240MHz, VRef calibration in efuse, Coding Scheme None
MAC: 24:6f:28:b5:36:71
Uploading stub...
Running stub...
Stub running...
Warning: ESP32 has no Chip ID. Reading MAC instead.
MAC: 24:6f:28:b5:36:71
Hard resetting via RTS pin...
```
4. `cd` into the directory where you unzipped the latest release. For example:
```bash title="Example"
cd /Downloads/firmware/
```
5. Install the correct firmware for your board with
:::caution
Be very careful to install the correct load for your board. In particular the popular 'T-BEAM' radio from TTGO is not called 'TTGO-Lora' (that is a different board). So don't install the 'TTGO-Lora' build on a TBEAM, it won't work correctly.
:::
```bash title="Command"
device-install.sh -f firmware-BOARD-VERSION.bin
```
```bash title="Example"
./device-install.sh -f firmware-heltec-EU865-1.2.0.bin
```
6. To update a the firmware on an existing Meshtastic device, run
```bash title="Command"
device-update.sh -f firmware-BOARD-VERSION.bin
```
```bash title="Example"
./device-update.sh -f firmware-heltec-EU865-1.2.0.bin
```
## Graphical User Interface Instructions

1
website/sidebars.js
View file

@ -9,6 +9,7 @@ module.exports = {
"getting_started/flashing_firmware/flashing_firmware_cli", "getting_started/flashing_firmware/flashing_firmware_cli",
"getting_started/flashing_firmware/flashing_firmware_gui", "getting_started/flashing_firmware/flashing_firmware_gui",
"getting_started/flashing_firmware/flashing_firmware_ota", "getting_started/flashing_firmware/flashing_firmware_ota",
"getting_started/flashing_firmware/linux",
"getting_started/flashing_firmware/macos", "getting_started/flashing_firmware/macos",
"getting_started/flashing_firmware/windows", "getting_started/flashing_firmware/windows",
], ],