meshtastic/docs/getting-started/serial-drivers/serial-drivers-nrf52.mdx

92 lines
2.2 KiB
Plaintext
Raw Normal View History

---
2022-11-07 20:53:52 -08:00
id: nrf52
2023-01-21 09:32:24 -08:00
title: nRF52 Serial Drivers
sidebar_label: nRF52 Drivers
sidebar_position: 2
---
2023-01-19 05:01:57 -08:00
import Tabs from "@theme/Tabs";
import TabItem from "@theme/TabItem";
2023-01-21 09:32:24 -08:00
import Link from "@docusaurus/Link";
2022-10-31 10:27:04 -07:00
2023-01-21 09:32:24 -08:00
## Install nRF52 USB to Serial Drivers
2023-06-30 21:44:39 -07:00
:::caution
2023-06-30 22:06:02 -07:00
nRF52 devices typically do not require serial drivers. They use the UF2 bootloader which makes the devices appear as flash drives. Do _NOT_ download the USB device drivers unless required to install UF2 support.
2023-06-30 21:44:39 -07:00
:::
<Tabs
groupId="operating-system"
2023-01-21 09:32:24 -08:00
defaultValue="windows"
values={[
{label: 'Linux', value: 'linux'},
{label: 'macOS', value: 'macos'},
{label: 'Windows', value: 'windows'},
]}>
2022-10-31 10:27:04 -07:00
<TabItem value="linux">
2023-06-30 21:44:39 -07:00
- [CH34x Driver - Linux Download](http://www.wch-ic.com/downloads/CH341SER_LINUX_ZIP.html)
2022-10-31 10:27:04 -07:00
</TabItem>
2022-10-31 10:27:04 -07:00
<TabItem value="macos">
2023-06-30 21:44:39 -07:00
:::info
2023-01-21 09:32:24 -08:00
2023-06-30 21:44:39 -07:00
With the latest versions of MacOS, the USB Serial driver is built-in. If you downloaded/installed any already, please remove them.
2023-01-21 09:32:24 -08:00
:::
### Remove the CH34x USB Driver (macOS)
If you have already downloaded/installed the macOS WCH-IC CH340/CH341
("CH341SER_MAC") drivers via the CH34x_Install_V1.5.pkg, you will have to
Uninstall the kernel extension:
1. Unplug your device
2. Open the Terminal and run:
3. `sudo rm -rf /Library/Extensions/usbserial.kext`
4. Reboot
2023-06-30 21:44:39 -07:00
### Install the CH34x Driver
- [CH34x Driver- macOS Download](https://github.com/WCHSoftGroup/ch34xser_macos)
</TabItem>
<TabItem value="windows">
2023-06-30 21:44:39 -07:00
- [CH34x Driver - Windows Download](http://www.wch-ic.com/downloads/CH341SER_EXE.html)
2023-01-21 09:32:24 -08:00
</TabItem>
</Tabs>
:::important
2023-01-21 09:32:24 -08:00
After installing the driver, make sure to reboot your computer to finish the installation process.
You can also [test your serial driver installation](/docs/getting-started/serial-drivers/test-serial-driver-installation) at this step if required.
:::
2023-01-21 09:32:24 -08:00
### Flash Firmware
2023-01-21 09:32:24 -08:00
After installing the serial drivers, you can now flash the Meshtastic firmware onto your device. To proceed, select the appropriate device type for your device.
<div className="indexCtasBody">
<Link
className={"button button--outline button--lg cta--button"}
to={"/docs/getting-started/flashing-firmware/nrf52/"}
>
Flash nRF52 Firmware
</Link>
</div>