From 99cbfc6456cc537247bd5bddeddc7ef7167cb770 Mon Sep 17 00:00:00 2001 From: Foster Irwin Date: Wed, 2 Mar 2022 11:08:58 -0700 Subject: [PATCH] removed connectivity details and added link to prerequisite page --- docs/getting-started/flashing-esp32.md | 42 ++---------------- docs/getting-started/flashing-nrf52.md | 61 ++++---------------------- 2 files changed, 12 insertions(+), 91 deletions(-) diff --git a/docs/getting-started/flashing-esp32.md b/docs/getting-started/flashing-esp32.md index 5f1ccfae..8aa83d59 100644 --- a/docs/getting-started/flashing-esp32.md +++ b/docs/getting-started/flashing-esp32.md @@ -9,49 +9,13 @@ import TabItem from '@theme/TabItem'; ## Prerequisites -### Check Data Cable +### Device connectivity -Plug your device into your computer using a USB cable and then do the following: -:::important -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) - -Some newer boards may require the drivers for the [CH9102 Windows](http://www.wch.cn/downloads/CH343SER_ZIP.html) or [Direct Download](https://github.com/Xinyuan-LilyGO/CH9102_Driver) for Windows 7. For [CH9102 Mac](http://www.wch.cn/downloads/CH34XSER_MAC_ZIP.html). Click the big blue button with the down arrow. Be sure to open up the application and click "Install" after the package is installed. Also, reboot. -::: - - - - -Connect your Meshtastic device to your USB port, open a `Terminal` and enter the following command: - -```bash -lsusb -``` - -You should see something like: `ID 10c4:ea60 Silicon Labs CP210x UART Bridge` for CP210X or `ID 1a86:55d4 QinHeng Electronics USB Single Serial` for CH9102 - - - - -Navigate to `Apple Menu  > About This Mac > System Report... > Hardware > USB`. You should see something like `CP210X USB to UART Bridge Controller`. If not download the appropriate drivers - - - - -Navigate to `Device Manager > Ports (COM & LPT)`. You should see something like `Silicon Labs CP210X USB to UART Bridge (COM5)`. If not download the appropriate drivers - - - +Ensure your computer is communicating with the device correctly by following [these instructions](flashing-firmware). ### Download Latest Firmware -Firmware can be downloaded from the [Downloads](/downloads) page. 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. +Firmware can be downloaded from the [Downloads](/downloads) page. Your initial installation has to happen over USB from your Mac, Windows, or Linux computer. Over the air updates are currently only available using the Android application after this initial installation. :::note The [T-Beam 0.7](/docs/hardware/supported/tbeam#t-beam---v07) board is an earlier version of the T-Beam board, and due to changes in the design in subsequent iterations this board uses a specific firmware file different from the other T-Beam boards. diff --git a/docs/getting-started/flashing-nrf52.md b/docs/getting-started/flashing-nrf52.md index 9b04d5a5..4122c127 100644 --- a/docs/getting-started/flashing-nrf52.md +++ b/docs/getting-started/flashing-nrf52.md @@ -7,66 +7,23 @@ sidebar_label: nRF52 devices import Tabs from '@theme/Tabs'; import TabItem from '@theme/TabItem'; -## Pre-requisites +## Prerequisites -:::tip -Please ensure that you use a data USB-C cable, as many USB-C cables provide power only and not the data lines. -::: +### Device connectivity -### T-Echo +Ensure your computer is communicating with the device correctly by following [these instructions](flashing-firmware). -:::tip -The USB-C to USB-A cable from LILYGO is _NOT_ a "data cable", and can only be used for charging. -::: +### Download Latest Firmware -#### Windows: +Firmware can be downloaded from the [Downloads](/downloads) page. Your initial installation has to happen over USB from your Mac, Windows, or Linux computer. Over the air updates are currently only available using the Android application after this initial installation. -You may need to install the [USB device drivers](http://www.wch-ic.com/search?q=ch340&t=downloads) if your device does not show up when connected. - -#### Mac OS - -Last Verified T-Echo nRF52840 on: Mac OS Monterey v12.0.1 (Intel chipset) - -:::tip -You can use the latest [Apple USB-C Charge cables](https://www.apple.com/shop/product/MLL82AM/A/usb-c-charge-cable-2-m). The cable that is provided with the iPad Pro works. Older Laptop USB-C Power cables will _NOT_ work, as they are missing the data lines. -::: - -:::caution -With the latest versions of MacOS, the USB Serial driver is built-in. Do _NOT_ download any USB device drivers - this will actually prevent you from connecting to your T-Echo from your Mac. If you downloaded/installed any already, please Remove them. -::: - -
- Removing the CH34x (CH340/CH341) USB Drivers -
-
- If you have already downloaded/installed the MacOS WCH-IC CH340 ("CH341SER_MAC") drivers via the CH34x_Install_V1.5.pkg, you will have to Uninstall the kernel extension: -
-
- 1. Unplug your T-Echo
- 2. Open the Terminal and run:
- 3. sudo -rf /Library/Extensions/usbserial.kext
- 4. Reboot -
-
-
- -Verify successful connections with: - -- Plug in your T-Echo -- Open the Terminal -- `ls -l /dev/tty.usbmodem*` - -If the device file exists, you will also notice a "TECHOBOOT" volume in the Finder, or in the Terminal after double-clicking the Reset Button (see below) - -- `ls /Volumes/TECHOBOOT` - -### WisBlock RAK4631 +### WisBlock RAK4631 Bootloader Please ensure that you have updated the bootloader to the latest version using the information on the [RAK Documentation Center](https://docs.rakwireless.com/Product-Categories/WisBlock/RAK4631/Quickstart/#how-to-check-if-you-have-the-updated-rak4631-bootloader) website. -## Download Latest Firmware - -Firmware can be downloaded from the [Downloads](/downloads) page. 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. +:::tip +[Meshtastic Flasher](meshtastic-flasher) can assist you in updating the bootloader to the latest version. +::: ## Install/Update Firmware