mirror of
https://github.com/meshtastic/meshtastic.git
synced 2024-12-26 22:19:46 -08:00
128 lines
4 KiB
Plaintext
128 lines
4 KiB
Plaintext
---
|
|
id: getting-started
|
|
title: Getting Started
|
|
sidebar_label: Getting Started
|
|
slug: /getting-started
|
|
sidebar_position: 2
|
|
---
|
|
|
|
import Link from "@docusaurus/Link";
|
|
import Tabs from "@theme/Tabs";
|
|
import TabItem from "@theme/TabItem";
|
|
|
|
## Identify Hardware
|
|
|
|
:::note
|
|
|
|
This guide assumes that you have already purchased the devices you will be using with Meshtastic. If you haven't, you can check out our list of [supported hardware](/docs/supported-hardware/)
|
|
to see your options.
|
|
:::
|
|
|
|
Before you begin, it's important to determine which kind of hardware you're using. Meshtastic works with devices that have either of these two types of Micro-Controller Units (MCU):
|
|
|
|
### ESP32
|
|
|
|
The ESP32 chip is older and consumes more power than the nRF52 chip, but is equipped with both WiFi and Bluetooth. Supported ESP32 devices:
|
|
|
|
- LILYGO® TTGO T-Beam
|
|
- LILYGO® TTGO Lora
|
|
- Nano G1
|
|
- Station G1
|
|
- Heltec V3 and Wireless Stick Lite V3
|
|
|
|
### nRF52
|
|
|
|
The nRF52 chip is much more power efficient than the ESP32 chip and easier to update, but is only equipped with Bluetooth. Supported nRF52 devices:
|
|
|
|
- RAK WisBlock
|
|
- LILYGO® TTGO T-Echo
|
|
|
|
:::info
|
|
|
|
If your device is not listed above, please review our [supported devices](/docs/supported-hardware) to determine which MCU your device has or contact us in [Discord](https://discord.gg/ktMAKGBnBs) with any questions.
|
|
|
|
:::
|
|
|
|
:::danger STOP! Put The Power Cable Down!
|
|
|
|
Never power on the radio without attaching an antenna! _It_ could damage the radio chip.
|
|
|
|
:::
|
|
|
|
Prior to connecting your Meshtastic device to the computer, you should perform the following basic checks.
|
|
|
|
### Verify Data Cable
|
|
|
|
Some cables only provide _charging_, verify that your cable is also capable of _transferring data_ before proceeding. To check if your cable can also transfer data, try connecting it to another device (like a phone) and see if you can copy a file to or from it. If the file transfer works, then your cable is also able to transfer data and you can continue.
|
|
|
|
### Install Serial Drivers
|
|
|
|
:::caution
|
|
|
|
With the latest versions of MacOS, USB Serial drivers are built-in. Do _NOT_ download the USB device drivers unless required. You may [test for installed serial drivers](/docs/getting-started/serial-drivers/test-serial-driver-installation) before continuing.
|
|
|
|
:::
|
|
|
|
If you require serial drivers installed on your computer, please choose one of the options below and install it before continuing.
|
|
|
|
<div className="indexCtasBody">
|
|
<div className="split-container">
|
|
<div className="split-item">
|
|
<Link
|
|
className={'button button--outline button--lg cta--button'}
|
|
to={'/docs/getting-started/serial-drivers/esp32'}
|
|
>
|
|
Install ESP32 Drivers
|
|
</Link>
|
|
</div>
|
|
|
|
<div className="split-item">
|
|
<Link
|
|
className={'button button--outline button--lg cta--button'}
|
|
to={'/docs/getting-started/serial-drivers/nrf52'}
|
|
>
|
|
Install NRF52 Drivers
|
|
</Link>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
|
|
### Flash Firmware
|
|
|
|
After completing the previous steps, you can now flash the Meshtastic firmware onto your device. To proceed, select the appropriate device type for your device.
|
|
|
|
<div className="indexCtasBody">
|
|
<div className="split-container">
|
|
<div className="split-item">
|
|
<Link
|
|
className={"button button--outline button--lg cta--button"}
|
|
to={"/docs/getting-started/flashing-firmware/esp32/"}
|
|
>
|
|
Flash ESP32 Firmware
|
|
</Link>
|
|
</div>
|
|
|
|
<div className="split-item">
|
|
<Link
|
|
className={"button button--outline button--lg cta--button"}
|
|
to={"/docs/getting-started/flashing-firmware/nrf52/"}
|
|
>
|
|
Flash nRF52 Firmware
|
|
</Link>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
|
|
### Connect and Configure Device
|
|
|
|
After flashing the Meshtastic firmware onto your device, you can now move on to initial configuration.
|
|
|
|
<div className="indexCtasBody">
|
|
<Link
|
|
className={"button button--outline button--lg cta--button"}
|
|
to={"/docs/getting-started/initial-config"}
|
|
>
|
|
Connect and Configure Device
|
|
</Link>
|
|
</div>
|