mirror of
https://github.com/meshtastic/meshtastic.git
synced 2024-09-20 16:17:33 -07:00
Merge pull request #339 from meshtastic/external-serial-adapter
Create flashing-external-serial-adapter.mdx
This commit is contained in:
Ben Meadors
GitHub
commit
01c85da13b
|
|
@ -0,0 +1,84 @@
|
|||
---
|
||||
id: flashing-external-serial-adapter
|
||||
title: Flashing ESP32 Devices with an External Serial Adapter
|
||||
sidebar_label: Flashing with External Serial Adapter - ESP32 Devices
|
||||
pagination_prev: getting-started/flashing-firmware/flashing-firmware
|
||||
pagination_next: getting-started/flashing-firmware/meshtastic-flasher
|
||||
sidebar_position: 1
|
||||
---
|
||||
|
||||
import Tabs from '@theme/Tabs';
|
||||
import TabItem from '@theme/TabItem';
|
||||
|
||||
:::info
|
||||
This information will likely only be helpful if you've already attempted to go through the prerequisites and processes outlined in [meshtastic flasher](https://meshtastic.org/docs/getting-started/flashing-firmware/meshtastic-flasher) or [manually flashing](https://meshtastic.org/docs/getting-started/flashing-firmware/flashing-esp32)
|
||||
:::
|
||||
|
||||
:::caution
|
||||
Make sure not to power the radio on without first attaching the antenna! You could damage the radio chip!
|
||||
:::
|
||||
|
||||
## Background
|
||||
|
||||
Situations that may require usage an external USB to Serial Adapter:
|
||||
* Due to the chip shortage, recently purchased devices such as the TTGO T-Beam may come with legacy or non-standard USB to Serial adapter chips that are unreliable in some cases.
|
||||
* Certain devices might have defective USB to Serial chip.
|
||||
* Certain devices, such as the [Hydra](https://github.com/Hydra-Designs/project-hydra-meshtastic-pcb) (Meshtastic-diy target).
|
||||
|
||||
### USB Serial Adapters
|
||||
|
||||
There are many options on the marketplace. It is recommended to purchase an adapter featuring the Silicon Labs CP2102 chip, as it is a reliable industry standard.
|
||||
|
||||
The adapter featured in this document can be purchased from:
|
||||
https://www.amazon.com/gp/product/B078W5L8W1/
|
||||
|
||||
Plug the adapter into your computer without connecting it to any devices yet. Ensure that your computer has drivers installed for the adapter. On Windows, the correct drivers should install automatically.
|
||||
|
||||
|
||||
### Connecting Adapter to the Device
|
||||
|
||||
:::info
|
||||
There are multiple ways to connect the pins of the adapter to the target device: pressing jumpers against contacts, using pogo pin jigs, etc. This tutorial features offset dupont headers soldered onto the operative gpio pins and connected via jumpers.
|
||||
:::
|
||||
Disconnect your USB to Serial Adapter from the computer before starting this process.
|
||||
|
||||
1) Connect the RX pin of the adapter to the TX pin of the device
|
||||
2) Connect the TX pin of the adapter to the RX pin of the device
|
||||
3) Connect a GND pin of the adapter to the GND pin of the device
|
||||
4) Connect either the 5V pin of the adapter to the 5V pin of the device (illustrated) or the 3.3V pin of the adapter to the 3.3V pin of device.
|
||||
5) Bridge GPIO 0 to GND on the device with a jumper. (This places the device into flash mode when the device is powered up)
|
||||
|
||||
Example wiring featuring a T-Beam
|
||||
|
||||
|
||||
6) Connect the device to a USB port on the computer
|
||||
7) Remove the jumper bridging GPIO 0 to GND
|
||||
|
||||
|
||||
|
||||
### Flashing
|
||||
|
||||
After following the steps above, your device should be in flash mode. You can flash your device using the [Meshtastic flasher](https://meshtastic.org/docs/getting-started/flashing-firmware/meshtastic-flasher) or [manual method](https://meshtastic.org/docs/getting-started/flashing-firmware/flashing-esp32)
|
||||
|
||||
Example using the Meshtastic Flasher
|
||||
|
||||
|
||||
After flashing the device is complete, reset your device (via the RST button if available).
|
||||
If you have the meshastic python cli installed, you can run `meshatstic --noproto` to connect the device again over the adapter and view the serial output to confirm meshtastic installed correctly.
|
||||
|
||||
|
||||
|
||||
### Troubleshooting
|
||||
|
||||
In the Mesthastic Flasher, device detection may not work when using the external USB to Serial adapter. You might need to manually select the correct device type from the dropdown.
|
||||
|
||||
|
||||
|
||||
Sometimes you might receive an error for COM port permission in the Mestastic Flasher or the manual device install scripts, this can be caused by a number of different issues.
|
||||
|
||||
You might need to run the process as an administrator, check to ensure software like Cura isn't monopolizing COM ports, or reboot.
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
|
@ -2,6 +2,7 @@
|
|||
id: flashing-firmware
|
||||
title: Firmware Flashing Prerequisites
|
||||
sidebar_label: Flashing Firmware
|
||||
pagination_next: getting-started/flashing-firmware/meshtastic-flasher
|
||||
sidebar_position: 1
|
||||
---
|
||||
|
||||
|
|
|
|||
|
|
@ -3,6 +3,7 @@ id: meshtastic-flasher
|
|||
title: Using Meshtastic Flasher
|
||||
sidebar_label: Meshtastic Flasher Method
|
||||
pagination_next: getting-started/first-steps/first-steps
|
||||
pagination_prev: getting-started/flashing-firmware/flashing-firmware
|
||||
sidebar_position: 1
|
||||
---
|
||||
|
||||
|
|
|
|||
Loading…
Reference in a new issue