From 5e2ec9180d1cac0275548e3055fb966578920a3e Mon Sep 17 00:00:00 2001 From: Foster Irwin Date: Mon, 12 Apr 2021 14:51:47 -0600 Subject: [PATCH 1/8] removed the "about" details from getting started details --- .../getting_started/{overview.md => about.md} | 8 +- .../docs/getting_started/getting_started.md | 163 ++++++++++++++++++ website/sidebars.js | 1 + 3 files changed, 168 insertions(+), 4 deletions(-) rename website/docs/getting_started/{overview.md => about.md} (98%) create mode 100644 website/docs/getting_started/getting_started.md diff --git a/website/docs/getting_started/overview.md b/website/docs/getting_started/about.md similarity index 98% rename from website/docs/getting_started/overview.md rename to website/docs/getting_started/about.md index 419ee2c0..707421ab 100644 --- a/website/docs/getting_started/overview.md +++ b/website/docs/getting_started/about.md @@ -1,10 +1,10 @@ --- -id: overview +id: about title: What is Meshtastic? -sidebar_label: Overview -slug: /getting_started +sidebar_label: About +slug: /about --- - + Meshtastic® is a project that lets you use inexpensive ($30 ish) GPS radios as an extensible, long battery life, secure, mesh GPS communicator. These radios are great for hiking, skiing, paragliding - essentially any hobby where you don't have reliable internet access. Each member of your private mesh can always see the location and distance of all other members and any text messages sent to your group chat. diff --git a/website/docs/getting_started/getting_started.md b/website/docs/getting_started/getting_started.md new file mode 100644 index 00000000..4bce7d49 --- /dev/null +++ b/website/docs/getting_started/getting_started.md @@ -0,0 +1,163 @@ +--- +id: overview +title: Overview +sidebar_label: Overview +slug: /getting_started +--- + +## Purchase a Radio + +The easiest way is to [buy a device with the software already installed](https://www.aliexpress.com/item/4001178678568.html) In the Americas get the 915mhz version, In Europe the 868Mhz or Asia 923Mhz see [here](https://www.thethingsnetwork.org/docs/lorawan/frequencies-by-country.html). + +## Setup the Radio + +When it arrives, install your antenna and make sure you install the battery correctly. Reversing the battery can damage your device. Make sure the antenna is on when you power up the board. + +:::caution +Make sure not to power the radio on without first attaching the antenna! You could damage the radio chip! +::: + +## Download Firmware + +Prebuilt binaries for the supported radios are available in our releases. Your initial installation has to happen over USB from your Mac, Windows or Linux PC. Once our software is installed, all future software updates happen over bluetooth from your phone. + +:::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. +::: + + +| [Current Firmware](https://github.com/meshtastic/meshtastic-device/releases/latest) | [List of Firmware Versions](https://github.com/meshtastic/meshtastic-device/releases/) | +| :--------------: | :-----------------------: | + +## Flashing Firmware + +If your device already has Meshtastic flashed to it, You can update over the air (OTA). Otherwise you'll need a computer and a **data** USB cable. + +- [Install using over-the-air (OTA)](/flashing-firmware-ota) +- [Install using a graphical user interface (GUI)](/flashing-firmware-gui) +- [Install using the command line interface (CLI)](/flashing-firmware-cli) + +## Connect to your Device + +There are many ways to connect to your new radio! Using the command line interface + +- Command line interface (CLI) +- Graphic user interface (GUI) +- Serial connection +- Bluetooth +- Web (in development) + +## Troubleshooting + +For any issues during setup, search [our forum](https://meshtastic.discourse.group) to find a solution. If you can't find one, please post your problem, providing as much detail as possible. + + diff --git a/website/sidebars.js b/website/sidebars.js index fa4bb594..ee399bf2 100644 --- a/website/sidebars.js +++ b/website/sidebars.js @@ -1,6 +1,7 @@ module.exports = { Sidebar: { "Getting Started": [ + "getting_started/about", "getting_started/overview", "getting_started/flashing_firmware", "getting_started/concepts", From 77594db6ee22a47f4520aade3dd4a5160d17dc48 Mon Sep 17 00:00:00 2001 From: Foster Irwin Date: Mon, 12 Apr 2021 14:52:39 -0600 Subject: [PATCH 2/8] reordered concepts in sidebar --- website/sidebars.js | 1 + 1 file changed, 1 insertion(+) diff --git a/website/sidebars.js b/website/sidebars.js index ee399bf2..a621f929 100644 --- a/website/sidebars.js +++ b/website/sidebars.js @@ -8,6 +8,7 @@ module.exports = { { "Howto's": [], }, + "getting_started/concepts", ], Software: [ "software/overview", From 2a2683b3515b07053a86488cb796dd02478c28d5 Mon Sep 17 00:00:00 2001 From: Foster Irwin Date: Mon, 12 Apr 2021 15:42:07 -0600 Subject: [PATCH 3/8] split methods of firmware installation --- .../docs/getting_started/flashing_firmware.md | 6 -- .../flashing_firmware_cli.md | 72 +++++++++++++++++++ .../flashing_firmware_gui.md | 19 +++++ .../flashing_firmware_ota.md | 6 ++ .../flashing_firmware_overview.md | 27 +++++++ website/sidebars.js | 13 +++- 6 files changed, 135 insertions(+), 8 deletions(-) delete mode 100644 website/docs/getting_started/flashing_firmware.md create mode 100644 website/docs/getting_started/flashing_firmware/flashing_firmware_cli.md create mode 100644 website/docs/getting_started/flashing_firmware/flashing_firmware_gui.md create mode 100644 website/docs/getting_started/flashing_firmware/flashing_firmware_ota.md create mode 100644 website/docs/getting_started/flashing_firmware/flashing_firmware_overview.md diff --git a/website/docs/getting_started/flashing_firmware.md b/website/docs/getting_started/flashing_firmware.md deleted file mode 100644 index ea2ccf4d..00000000 --- a/website/docs/getting_started/flashing_firmware.md +++ /dev/null @@ -1,6 +0,0 @@ ---- -id: flashing_firmware -title: Flashing Firmware -sidebar_label: Flashing -slug: /getting_started/flashing_firmware ---- diff --git a/website/docs/getting_started/flashing_firmware/flashing_firmware_cli.md b/website/docs/getting_started/flashing_firmware/flashing_firmware_cli.md new file mode 100644 index 00000000..cc34c55f --- /dev/null +++ b/website/docs/getting_started/flashing_firmware/flashing_firmware_cli.md @@ -0,0 +1,72 @@ +--- +id: flashing_firmware_cli +title: Flashing Firmware – CLI +sidebar_label: Command Line Interface +slug: /flashing_firmware_cli +--- +## Linux + +Requires `Python` and `pip` + +1. Download and unzip the latest Meshtastic firmware [release](https://github.com/meshtastic/Meshtastic-esp32/releases). +2. `pip install --upgrade esptool` - Installs esptool on your machine +3. Connect your radio to your USB port +4. `esptool.py chip_id` - Confirm that your device is talking to your PC by running +You should see something like: +``` +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... +``` +5. `cd` into the directory where you unzipped the latest release. +6. Install the correct firmware for your board with `device-install.sh -f firmware-BOARD-VERSION.bin` +``` +./device-install.sh -f firmware-heltec-1.2.x.bin +``` +7. To update a the firmware on an existing Meshtastic device, run `device-update.sh -f firmware-BOARD-VERSION.bin` +``` +./device-update.sh -f firmware-heltec-1.2.x.bin +``` + + + +## MacOS + +Installing on OS X through the commandline uses the same method as linux, but requires a slightly different method to install Python, pip and esptool. + +OS X (10.15.3/Catalina) comes with Python 2.7 installed, but not pip. + +:::note +If you don't know if Homebrew is installed on your Mac, open terminal and enter the command `brew -v` if it doesn't work [install Homebrew](https://brew.sh) before continuing. +::: + +1. `brew install pyenv` - Installs PyEnv +2. `pyenv install 3.7.7` - To install and select Python 3.7.7 +3. `pyenv global 3.7.7` - Selects the new version of Python +4. `brew install pip` - Installs pip3 +5. `pip3 install --upgrade esptool` - Installs esptool + +You may need to install a driver from Silicon Labs for the [CP210X USB to UART bridge](https://www.silabs.com/products/development-tools/software/usb-to-uart-bridge-vcp-drivers) + +6. Now install as per installing on the Linux commandline. Replace `pip` with `pip3` in your commands. + +## Windows + +Requires `Python`, `pip`, `Gitbash` + +1. Download and install [Python](https://www.python.org/) +2. If you have a recent version of Python, pip should be installed by default. Check using the command `py -m pip --version`. This will display the installed version of pip. If it returns an error, you will need to [install pip](https://pip.pypa.io/en/stable/installing/). +3. Download and install [Gitbash](https://gitforwindows.org/) (or other appropriate shell) +4. Run `gitbash` and complete the installation as per the instructions for linux commandline. diff --git a/website/docs/getting_started/flashing_firmware/flashing_firmware_gui.md b/website/docs/getting_started/flashing_firmware/flashing_firmware_gui.md new file mode 100644 index 00000000..91697263 --- /dev/null +++ b/website/docs/getting_started/flashing_firmware/flashing_firmware_gui.md @@ -0,0 +1,19 @@ +--- +id: flashing_firmware_gui +title: Flashing Firmware – GUI +sidebar_label: Graphic User Interface +slug: /flashing_firmware_gui +--- +### Windows & MacOS + +1. Download and unzip the latest Meshtastic firmware [release](https://github.com/meshtastic/meshtastic-device/releases/latest). +2. Download [ESPHome Flasher](https://github.com/esphome/esphome-flasher) following their installation instructions. +3. Connect your radio to your USB port and open ESPHome Flasher. +4. If your board is not showing under Serial Port then you likely need to install the drivers for the CP210X serial chip. In Windows you can check by searching “Device Manager” and ensuring the device is shown under “Ports”. +5. If there is an error, download the [drivers](https://www.silabs.com/products/development-tools/software/usb-to-uart-bridge-vcp-drivers), then unzip and run the Installer application. +6. In ESPHome Flasher, refresh the serial ports and select the port to which your board is connected. +7. Browse to the previously downloaded firmware and select the correct firmware based on the board type. +8. Select Flash ESP. +9. Once complete, “Done! Flashing is complete!” will be shown. +10. The board will boot and show the Meshtastic logo. +11. Debug messages sent from the Meshtastic device can be viewed with a terminal program such as PuTTY. Within PuTTY, click “Serial”, enter the “Serial line” com port (can be found at step 4), enter “Speed” as `921600`, then click “Open”. diff --git a/website/docs/getting_started/flashing_firmware/flashing_firmware_ota.md b/website/docs/getting_started/flashing_firmware/flashing_firmware_ota.md new file mode 100644 index 00000000..c85ed00c --- /dev/null +++ b/website/docs/getting_started/flashing_firmware/flashing_firmware_ota.md @@ -0,0 +1,6 @@ +--- +id: flashing_firmware_ota +title: Flashing Firmware – OTA +sidebar_label: Over The Air +slug: /flashing_firmware_ota +--- diff --git a/website/docs/getting_started/flashing_firmware/flashing_firmware_overview.md b/website/docs/getting_started/flashing_firmware/flashing_firmware_overview.md new file mode 100644 index 00000000..53b3b697 --- /dev/null +++ b/website/docs/getting_started/flashing_firmware/flashing_firmware_overview.md @@ -0,0 +1,27 @@ +--- +id: flashing_firmware_overview +title: Overview +sidebar_label: Overview +slug: /flashing_firmware_overview +--- +## Download Firmware + +Prebuilt binaries for the supported radios are available in our releases. Your initial installation has to happen over USB from your Mac, Windows or Linux PC. Once our software is installed, all future software updates happen over bluetooth from your phone. + +:::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. +::: + + + +| [Current Firmware](https://github.com/meshtastic/meshtastic-device/releases/latest) | [List of Firmware Versions](https://github.com/meshtastic/meshtastic-device/releases/) | +| :--------------: | :-----------------------: | + +Firmware Flashing Methods +- [Command line interface](flashing_firmware_cli) +- [Graphic user interface](flashing_firmware_gui) +- [Over the air](flashing_firmware_ota) + +## Troubleshooting + +For any issues during setup, search [our forum](https://meshtastic.discourse.group) to find a solution. If you can't find one, please post your problem, providing as much detail as possible. diff --git a/website/sidebars.js b/website/sidebars.js index a621f929..1813b0b8 100644 --- a/website/sidebars.js +++ b/website/sidebars.js @@ -3,9 +3,13 @@ module.exports = { "Getting Started": [ "getting_started/about", "getting_started/overview", - "getting_started/flashing_firmware", - "getting_started/concepts", { + "Flashing Firmware": [ + "getting_started/flashing_firmware/flashing_firmware_overview", + "getting_started/flashing_firmware/flashing_firmware_cli", + "getting_started/flashing_firmware/flashing_firmware_gui", + "getting_started/flashing_firmware/flashing_firmware_ota", + ], "Howto's": [], }, "getting_started/concepts", @@ -80,4 +84,9 @@ module.exports = { }, ], }, + Showcase: { + "Jungle Project": [ + "software/other/mesh-alg", + ] + }, }; From 8e4a57f9044c53a83f7242128f4658d6b58a2187 Mon Sep 17 00:00:00 2001 From: Foster Irwin Date: Mon, 12 Apr 2021 16:15:51 -0600 Subject: [PATCH 4/8] fixed links --- .../flashing_firmware/flashing_firmware_cli.md | 2 +- .../flashing_firmware/flashing_firmware_gui.md | 2 +- .../flashing_firmware/flashing_firmware_ota.md | 2 +- .../flashing_firmware/flashing_firmware_overview.md | 2 +- website/docs/getting_started/getting_started.md | 6 +++--- 5 files changed, 7 insertions(+), 7 deletions(-) diff --git a/website/docs/getting_started/flashing_firmware/flashing_firmware_cli.md b/website/docs/getting_started/flashing_firmware/flashing_firmware_cli.md index cc34c55f..a55f5bbf 100644 --- a/website/docs/getting_started/flashing_firmware/flashing_firmware_cli.md +++ b/website/docs/getting_started/flashing_firmware/flashing_firmware_cli.md @@ -2,7 +2,7 @@ id: flashing_firmware_cli title: Flashing Firmware – CLI sidebar_label: Command Line Interface -slug: /flashing_firmware_cli +slug: /getting_started/flashing_firmware/cli --- ## Linux diff --git a/website/docs/getting_started/flashing_firmware/flashing_firmware_gui.md b/website/docs/getting_started/flashing_firmware/flashing_firmware_gui.md index 91697263..ad95a99d 100644 --- a/website/docs/getting_started/flashing_firmware/flashing_firmware_gui.md +++ b/website/docs/getting_started/flashing_firmware/flashing_firmware_gui.md @@ -2,7 +2,7 @@ id: flashing_firmware_gui title: Flashing Firmware – GUI sidebar_label: Graphic User Interface -slug: /flashing_firmware_gui +slug: /getting_started/flashing_firmware/gui --- ### Windows & MacOS diff --git a/website/docs/getting_started/flashing_firmware/flashing_firmware_ota.md b/website/docs/getting_started/flashing_firmware/flashing_firmware_ota.md index c85ed00c..920ae159 100644 --- a/website/docs/getting_started/flashing_firmware/flashing_firmware_ota.md +++ b/website/docs/getting_started/flashing_firmware/flashing_firmware_ota.md @@ -2,5 +2,5 @@ id: flashing_firmware_ota title: Flashing Firmware – OTA sidebar_label: Over The Air -slug: /flashing_firmware_ota +slug: /getting_started/flashing_firmware/ota --- diff --git a/website/docs/getting_started/flashing_firmware/flashing_firmware_overview.md b/website/docs/getting_started/flashing_firmware/flashing_firmware_overview.md index 53b3b697..5f5f5883 100644 --- a/website/docs/getting_started/flashing_firmware/flashing_firmware_overview.md +++ b/website/docs/getting_started/flashing_firmware/flashing_firmware_overview.md @@ -2,7 +2,7 @@ id: flashing_firmware_overview title: Overview sidebar_label: Overview -slug: /flashing_firmware_overview +slug: /getting_started/flashing_firmware/overview --- ## Download Firmware diff --git a/website/docs/getting_started/getting_started.md b/website/docs/getting_started/getting_started.md index 4bce7d49..6cb260fe 100644 --- a/website/docs/getting_started/getting_started.md +++ b/website/docs/getting_started/getting_started.md @@ -33,9 +33,9 @@ Be very careful to install the correct load for your board. In particular the po If your device already has Meshtastic flashed to it, You can update over the air (OTA). Otherwise you'll need a computer and a **data** USB cable. -- [Install using over-the-air (OTA)](/flashing-firmware-ota) -- [Install using a graphical user interface (GUI)](/flashing-firmware-gui) -- [Install using the command line interface (CLI)](/flashing-firmware-cli) +- [Install using over-the-air (OTA)](getting_started/flashing_firmware/ota) +- [Install using a graphical user interface (GUI)](getting_started/flashing_firmware/gui) +- [Install using the command line interface (CLI)](getting_started/flashing_firmware/cli) ## Connect to your Device From 4b167e365b3885ed4da06d335afbc0ce665f3934 Mon Sep 17 00:00:00 2001 From: Foster Irwin Date: Mon, 12 Apr 2021 16:24:45 -0600 Subject: [PATCH 5/8] fixed links --- .../flashing_firmware/flashing_firmware_overview.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/website/docs/getting_started/flashing_firmware/flashing_firmware_overview.md b/website/docs/getting_started/flashing_firmware/flashing_firmware_overview.md index 5f5f5883..65d1f6e2 100644 --- a/website/docs/getting_started/flashing_firmware/flashing_firmware_overview.md +++ b/website/docs/getting_started/flashing_firmware/flashing_firmware_overview.md @@ -18,9 +18,9 @@ Be very careful to install the correct load for your board. In particular the po | :--------------: | :-----------------------: | Firmware Flashing Methods -- [Command line interface](flashing_firmware_cli) -- [Graphic user interface](flashing_firmware_gui) -- [Over the air](flashing_firmware_ota) +- [Command line interface](/getting_started/flashing_firmware/cli) +- [Graphic user interface](/getting_started/flashing_firmware/gui) +- [Over the air](/getting_started/flashing_firmware/ota) ## Troubleshooting From 295521ddfee4a8ce4785bb329f2228b6bfe00d90 Mon Sep 17 00:00:00 2001 From: Foster Irwin Date: Mon, 12 Apr 2021 16:57:30 -0600 Subject: [PATCH 6/8] fixed links --- .../flashing_firmware/flashing_firmware_overview.md | 6 +++--- website/docs/getting_started/getting_started.md | 4 ++-- 2 files changed, 5 insertions(+), 5 deletions(-) diff --git a/website/docs/getting_started/flashing_firmware/flashing_firmware_overview.md b/website/docs/getting_started/flashing_firmware/flashing_firmware_overview.md index 65d1f6e2..d45b9459 100644 --- a/website/docs/getting_started/flashing_firmware/flashing_firmware_overview.md +++ b/website/docs/getting_started/flashing_firmware/flashing_firmware_overview.md @@ -18,9 +18,9 @@ Be very careful to install the correct load for your board. In particular the po | :--------------: | :-----------------------: | Firmware Flashing Methods -- [Command line interface](/getting_started/flashing_firmware/cli) -- [Graphic user interface](/getting_started/flashing_firmware/gui) -- [Over the air](/getting_started/flashing_firmware/ota) +- [Command line interface](cli) +- [Graphic user interface](gui) +- [Over the air](ota) ## Troubleshooting diff --git a/website/docs/getting_started/getting_started.md b/website/docs/getting_started/getting_started.md index 6cb260fe..9da91739 100644 --- a/website/docs/getting_started/getting_started.md +++ b/website/docs/getting_started/getting_started.md @@ -33,9 +33,9 @@ Be very careful to install the correct load for your board. In particular the po If your device already has Meshtastic flashed to it, You can update over the air (OTA). Otherwise you'll need a computer and a **data** USB cable. -- [Install using over-the-air (OTA)](getting_started/flashing_firmware/ota) -- [Install using a graphical user interface (GUI)](getting_started/flashing_firmware/gui) - [Install using the command line interface (CLI)](getting_started/flashing_firmware/cli) +- [Install using a graphical user interface (GUI)](getting_started/flashing_firmware/gui) +- [Install using over-the-air (OTA)](getting_started/flashing_firmware/ota) ## Connect to your Device From 2af96da1a69f0fd2b362187625562c22311780ab Mon Sep 17 00:00:00 2001 From: Foster Irwin Date: Mon, 12 Apr 2021 17:07:46 -0600 Subject: [PATCH 7/8] removed sidebar addition --- website/sidebars.js | 5 ----- 1 file changed, 5 deletions(-) diff --git a/website/sidebars.js b/website/sidebars.js index 1813b0b8..0163ad20 100644 --- a/website/sidebars.js +++ b/website/sidebars.js @@ -84,9 +84,4 @@ module.exports = { }, ], }, - Showcase: { - "Jungle Project": [ - "software/other/mesh-alg", - ] - }, }; From fe2e4af5ccf0f876980b31351e330e15deb04ee6 Mon Sep 17 00:00:00 2001 From: Foster Irwin Date: Tue, 13 Apr 2021 07:07:35 -0600 Subject: [PATCH 8/8] added caution to firmware instructions and removed from overview --- .../flashing_firmware/flashing_firmware_cli.md | 5 +++++ .../flashing_firmware/flashing_firmware_gui.md | 7 ++++++- .../flashing_firmware/flashing_firmware_ota.md | 3 +++ .../flashing_firmware/flashing_firmware_overview.md | 1 - website/docs/getting_started/getting_started.md | 4 ---- 5 files changed, 14 insertions(+), 6 deletions(-) diff --git a/website/docs/getting_started/flashing_firmware/flashing_firmware_cli.md b/website/docs/getting_started/flashing_firmware/flashing_firmware_cli.md index a55f5bbf..d47164de 100644 --- a/website/docs/getting_started/flashing_firmware/flashing_firmware_cli.md +++ b/website/docs/getting_started/flashing_firmware/flashing_firmware_cli.md @@ -4,6 +4,11 @@ title: Flashing Firmware – CLI sidebar_label: Command Line Interface slug: /getting_started/flashing_firmware/cli --- + +:::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. +::: + ## Linux Requires `Python` and `pip` diff --git a/website/docs/getting_started/flashing_firmware/flashing_firmware_gui.md b/website/docs/getting_started/flashing_firmware/flashing_firmware_gui.md index ad95a99d..8e4cf887 100644 --- a/website/docs/getting_started/flashing_firmware/flashing_firmware_gui.md +++ b/website/docs/getting_started/flashing_firmware/flashing_firmware_gui.md @@ -4,7 +4,12 @@ title: Flashing Firmware – GUI sidebar_label: Graphic User Interface slug: /getting_started/flashing_firmware/gui --- -### Windows & MacOS + +:::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. +::: + +## Windows & MacOS 1. Download and unzip the latest Meshtastic firmware [release](https://github.com/meshtastic/meshtastic-device/releases/latest). 2. Download [ESPHome Flasher](https://github.com/esphome/esphome-flasher) following their installation instructions. diff --git a/website/docs/getting_started/flashing_firmware/flashing_firmware_ota.md b/website/docs/getting_started/flashing_firmware/flashing_firmware_ota.md index 920ae159..ec0ca102 100644 --- a/website/docs/getting_started/flashing_firmware/flashing_firmware_ota.md +++ b/website/docs/getting_started/flashing_firmware/flashing_firmware_ota.md @@ -4,3 +4,6 @@ title: Flashing Firmware – OTA sidebar_label: Over The Air slug: /getting_started/flashing_firmware/ota --- +:::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. +::: diff --git a/website/docs/getting_started/flashing_firmware/flashing_firmware_overview.md b/website/docs/getting_started/flashing_firmware/flashing_firmware_overview.md index d45b9459..bcde0976 100644 --- a/website/docs/getting_started/flashing_firmware/flashing_firmware_overview.md +++ b/website/docs/getting_started/flashing_firmware/flashing_firmware_overview.md @@ -12,7 +12,6 @@ Prebuilt binaries for the supported radios are available in our releases. Your i 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. ::: - | [Current Firmware](https://github.com/meshtastic/meshtastic-device/releases/latest) | [List of Firmware Versions](https://github.com/meshtastic/meshtastic-device/releases/) | | :--------------: | :-----------------------: | diff --git a/website/docs/getting_started/getting_started.md b/website/docs/getting_started/getting_started.md index 9da91739..e07a152a 100644 --- a/website/docs/getting_started/getting_started.md +++ b/website/docs/getting_started/getting_started.md @@ -21,10 +21,6 @@ Make sure not to power the radio on without first attaching the antenna! You cou Prebuilt binaries for the supported radios are available in our releases. Your initial installation has to happen over USB from your Mac, Windows or Linux PC. Once our software is installed, all future software updates happen over bluetooth from your phone. -:::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. -::: - | [Current Firmware](https://github.com/meshtastic/meshtastic-device/releases/latest) | [List of Firmware Versions](https://github.com/meshtastic/meshtastic-device/releases/) | | :--------------: | :-----------------------: |