meshtastic/website/docs/getting-started/faq.md

143 lines
6 KiB
Markdown
Raw Normal View History

2021-11-18 10:48:38 -08:00
---
id: faq
2021-11-19 09:40:29 -08:00
title: Frequenty Asked Questions (FAQ)
2021-11-18 10:48:38 -08:00
sidebar_label: Frequenty Asked Questions
slug: /getting-started/faq
---
import Tabs from '@theme/Tabs';
import TabItem from '@theme/TabItem';
2021-11-18 11:31:19 -08:00
<!--
**** FAQ Contributors, README ***
*
* Best Practices for the FAQ:
*
* - Keep the answers Non-Technical. The FAQ should be targeted to non-geeks.
* - This FAQ is not the authoritative document. Provide a short answer and a link to learn more.
*
****
-->
2021-11-18 10:48:38 -08:00
## General
2021-11-18 11:15:50 -08:00
Q: What is Meshtastic?
2021-11-19 19:25:56 -08:00
* Meshtastic is most awesome long range, low power communications service on the planet earth! That's not even an exageration!
2021-11-18 11:15:50 -08:00
2021-11-19 09:40:29 -08:00
Q: Where can I get additional help, ask questions or bond with the Meshtastic community?
2021-11-20 19:30:54 -08:00
* After reading this FAQ and checking out the links on the left, there are two places ... The preferred place is to check out the [Fourm](https://meshtastic.discourse.group). There you can be part of our growing community and search for previosly posts that may be similar to what you're looking for. We also have the [Meshtastic Discord](https://discord.com/invite/UQJ5QuM7vq) server where you may connect with like minded people.
2021-11-18 10:48:38 -08:00
2021-11-19 09:40:29 -08:00
Q: How can I contribute to Meshtastic?
2021-11-19 19:25:56 -08:00
* Everyone contributes in a different way. Join the [Fourm](https://meshtastic.discourse.group) and/or the [Meshtastic Discord](https://discord.com/invite/UQJ5QuM7vq) and introduce yourself. We're all very friendly. If you'd like to pitch in some code, check out the [Developers](https://meshtastic.org/docs/developers) menu on the left.
2021-11-18 11:31:19 -08:00
2021-11-19 09:16:24 -08:00
## Device (aka Node)
2021-11-18 10:48:38 -08:00
Q: Where do I purchase the device hardware?
2021-11-22 19:24:18 -08:00
* Each [supported device](https://meshtastic.org/docs/hardware/tbeam-hardware) has a "Purchase Link".
2021-11-21 09:31:51 -08:00
Q: I have my hardware. How do I install the firmware and any required drivers?
* See: https://meshtastic.org/docs/getting-started/flashing-esp32
2021-11-18 11:15:50 -08:00
Q: How do I update the firmware to the latest version?
2021-11-22 19:24:18 -08:00
* If the device is running Meshtastic firmware, you might be able to update over-the-air like via the Android app.
2021-11-19 09:40:29 -08:00
Q: My device has gone to sleep. Are received messages lost?
2021-11-22 19:24:18 -08:00
* The LoRa radio on the node is still active and will wake up the CPU when the device is sleeping. If your phone is in range, the node will relay any messages your phone may have missed. If you're in range and your device is active, messages have not been lost.
2021-11-19 09:16:24 -08:00
Q: My device has gone to sleep and I can't send any messages.
* Once the node wakes up from sleep, your phone will relay any delayed messages through your node and to the mesh network. Give it a few minutes and it'll do the right thing.
2021-11-22 19:24:18 -08:00
Q: How do I turn off an esp32 t-beam based device?
2021-11-21 09:31:51 -08:00
* Hold down the middle button for about 10 seconds.
2021-11-22 19:24:18 -08:00
Q: How do I turn on an esp32 t-beam based device?
2021-11-21 09:31:51 -08:00
* Push the power button for about 1 second.
2021-11-19 09:16:24 -08:00
Q: How can I tell the device not to sleep?
* Android instructions see: [Android Usage](https://meshtastic.org/docs/software/android/android-usage#configuration-options)
* Python CLI instructions see: [Python Usage](https://meshtastic.org/docs/software/python/python-cli#changing-device-settings)
2021-11-18 11:15:50 -08:00
### Plugins
Q: What are Plugins?
2021-11-19 09:40:29 -08:00
* Plugins are features that expand the basic device functionalty and/or integrations with other services.
2021-11-18 11:15:50 -08:00
Q: What plugins do we have available?
2021-11-18 11:15:50 -08:00
* To see the list of available plugins, please go to: https://meshtastic.org/docs/software/plugins/plugins
2021-11-18 10:48:38 -08:00
2021-11-19 09:40:29 -08:00
Q: I'd like to write a plugin. How do I get started?
* See: https://meshtastic.org/docs/developers/device/plugin-api
2021-11-18 10:48:38 -08:00
## Android
2021-11-18 11:15:50 -08:00
Q: What versions of Android does the Meshtastic Android App require?
* Answer TBD
2021-11-18 10:48:38 -08:00
2021-11-18 19:11:27 -08:00
Q: What's the cloud icon next to the message?
* Empty Cloud - In route to your device.
* Up Arrow - Queued to be sent over the mesh.
* Check Mark - Delivered over the mesh.
* Cross Mark - Error
Q: How can I clear the message history?
* Clear the storage from Android Settings > App
2021-11-18 10:48:38 -08:00
## iOS
2021-11-18 11:15:50 -08:00
Q: What version of iOS does the Meshtastic iOS App Require?
2021-11-22 19:24:18 -08:00
* The now-in-beta iOS app requires iOS v15.
2021-11-18 11:15:50 -08:00
Q: How do I get the Meshtastic iOS App?
2021-11-22 19:24:18 -08:00
* See [iOS App](https://meshtastic.org/docs/software/ios/ios-development)
2021-11-18 10:48:38 -08:00
## Bluetooth
Q: How do I pair my phone to the device if my device doesn't have a screen?
2021-11-22 19:24:18 -08:00
* Answer TBD (perhaps consider using web if esp32)
Q: Can I have Bluetooth enabled and use WiFi radio?
* No. Only one method will work at a time.
Q: How do I disable WiFi so Bluetooth will work?
* Ensure the wifi_ssid and wifi_password values are blank.
2021-11-18 20:00:53 -08:00
## WiFi / Web Browser
2021-11-18 10:48:38 -08:00
2021-11-18 20:00:53 -08:00
Q: How do I turn on the WiFI radio?
2021-11-18 19:11:27 -08:00
* See: https://meshtastic.org/docs/software/device/device-wifi
2021-11-18 20:00:53 -08:00
Q: When I turn on WiFi, Bluetooth turns off. Why is this?
2021-11-18 19:11:27 -08:00
* Currently WiFi and Bluetooth can be turned on at the same time.
2021-11-18 11:15:50 -08:00
2021-11-18 20:00:53 -08:00
Q: How do I access the network from my web browser?
2021-11-22 19:24:18 -08:00
* Visit http://meshtastic.local (Note: This is a work in progress.)
2021-11-18 10:48:38 -08:00
2021-11-19 09:16:24 -08:00
## Channels
Q: What is a Meshtastic Channel?
* This is the LoRa channel you're broadcasting on, the modem configuration (spreading factor, bandwidth and error correction), along with a special identifier for your group and optional encryption.
Q: What is a LoRa channel?
* This is the LoRa frequency within the Frequency band your device is configured to use.
Q: How do I share my Meshtastic Channel with other people?
* Your Meshtastic client (Android, iOS, Web or Python) will provide you a URL or QR code. You can email, text or print this URL or QR code and share it with people you want to join your Meshtastic Channel.
Q: What is a Primary Channel?
* This is the first channel that's created for you when you initially setup your Meshtastic Channel.
Q: What is a Secondary Channel?
* As this is a new feature, secondary Channels work on the device and the Python Script. Support for secondary channels by other clients are pending. For more information: https://meshtastic.org/docs/software/device/device-channels#how-to-use-secondary-channels
2021-11-18 10:48:38 -08:00
## Commmand Line / Python
2021-11-22 19:24:18 -08:00
Q: How do I find out more about installing (and using) Meshtastic via command line?
* See https://meshtastic.org/docs/software/python/python-installation
Q: How do I find out more about using python to interact?
* See https://meshtastic.org/docs/software/python/python-usage