meshtastic/docs/getting-started/index.mdx

122 lines
3.7 KiB
Plaintext
Raw Normal View History

---
2022-11-07 20:53:52 -08:00
id: getting-started
title: Getting Started
sidebar_label: Getting Started
slug: /getting-started
2022-04-24 15:32:31 -07:00
sidebar_position: 2
---
2022-03-08 23:51:46 -08:00
2023-01-19 05:01:57 -08:00
import Link from "@docusaurus/Link";
import Tabs from "@theme/Tabs";
import TabItem from "@theme/TabItem";
2022-11-02 11:46:54 -07:00
## Identify Hardware
2023-01-21 09:32:24 -08:00
:::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
2023-01-21 09:32:24 -08:00
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
2023-01-21 09:32:24 -08:00
- Heltec V3 and Wireless Stick Lite V3
2023-01-21 09:32:24 -08:00
### nRF52
2023-01-21 09:32:24 -08:00
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
2023-01-21 09:32:24 -08:00
2022-11-07 20:53:52 -08:00
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.
2023-01-21 09:32:24 -08:00
:::
2023-01-21 09:32:24 -08:00
:::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.
2023-01-21 09:32:24 -08:00
### Verify Data Cable
2023-01-21 09:32:24 -08:00
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.
2023-01-21 09:32:24 -08:00
### Install Serial Drivers
2023-01-21 09:32:24 -08:00
If you don't have serial drivers installed on your computer, please choose one of the options below and install it before continuing.
2022-03-03 09:53:57 -08:00
<div className="indexCtasBody">
2023-01-21 09:32:24 -08:00
<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>
2022-11-07 20:53:52 -08:00
</div>
2022-03-03 09:53:57 -08:00
</div>
2022-03-02 10:10:10 -08:00
2023-01-21 09:32:24 -08:00
### Flash Firmware
2023-01-19 05:01:57 -08:00
2023-01-21 09:32:24 -08:00
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.
2022-03-03 14:29:52 -08:00
2022-03-03 09:53:57 -08:00
<div className="indexCtasBody">
2023-01-21 09:32:24 -08:00
<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>
2022-11-07 20:53:52 -08:00
</div>
2022-03-03 09:53:57 -08:00
</div>
2022-03-02 10:10:10 -08:00
### Connect and Configure Device
2023-01-21 09:32:24 -08:00
After flashing the Meshtastic firmware onto your device, you can now move on to initial configuration.
<div className="indexCtasBody">
2023-01-19 05:01:57 -08:00
<Link
className={"button button--outline button--lg cta--button"}
to={"/docs/getting-started/initial-config"}
>
2022-11-07 20:53:52 -08:00
Connect and Configure Device
</Link>
</div>