meshtastic/docs/settings/overview.md

78 lines
3.5 KiB
Markdown
Raw Normal View History

2021-04-20 12:28:37 -07:00
---
id: overview
title: Device Settings
sidebar_label: Device Settings
2021-04-20 12:28:37 -07:00
slug: /settings
---
2021-05-05 09:18:44 -07:00
import Tabs from '@theme/Tabs';
import TabItem from '@theme/TabItem';
2021-04-20 12:28:37 -07:00
Customization of your settings is vital to configuring your own mesh. Changing settings is currently most reliably done using the command line interface available within `Meshtastic-python`. Setting support is being added to all other methods of interfacing with your device.
2021-04-20 12:28:37 -07:00
2021-05-18 19:28:32 -07:00
## Settings
Below are some of the most common settings that a new user will want to become acquainted with, but it isn't an exhaustive list. Make sure to take a look at the sidebar for additional settings. If you find something missing or incorrect, please help us improve our docs by filing an issue, creating a pull request, or mentioning it in our forum.
2021-05-18 19:28:32 -07:00
### Channel Settings
2022-02-21 13:08:55 -08:00
Channel settings are very important, if channels are misconfigured between devices they won't be able to communicate! A freshly flashed device will use the default channel settings. Depending on your use case you may want to change your encryption using `psk`, your range of communication by setting one of the four pre-set bands using `modem_config`, or even just the name of your channel! Before you begin, don't forget to set your `region` correctly! Take a look at the [basic channel configuration](settings/channel) and if you're tech savvy or a radio head check out the [advanced channel settings](settings/channel-advanced).
2021-05-18 19:28:32 -07:00
:::note
It is very important that you set your device's `region` setting. This will ensure that you are operating within the legal limits for your area.
:::
### GPS Settings
2022-02-21 13:08:55 -08:00
For most, GPS is a really cool, desirable feature. Knowing where everyone on your local mesh is has some major advantages. However, it's possible you want to hide the location of a particular device (like a router mounted on your home). All of the settings related to GPS are located [here](settings/gps).
2021-05-18 19:28:32 -07:00
### WiFi Settings
2022-02-21 13:08:55 -08:00
Whether you're using the upcoming [web interface](software/web/web-app-software) or you're interested in broadcasting messages to/from the internet using [MQTT](settings/mqtt), the [WiFi settings](settings/wifi) are your first stop towards an IoT radio.
2021-05-05 09:18:44 -07:00
## Examples
2021-05-05 09:25:42 -07:00
At the bottom of each setting page, examples will be available displaying how to adjust settings using the various platforms available to interface with your device. The examples will look like this:
2021-05-05 09:18:44 -07:00
### Introducing Examples
<Tabs
groupId="settings"
defaultValue="cli"
values={[
{label: 'CLI', value: 'cli'},
{label: 'Android', value: 'android'},
{label: 'iOS', value: 'iOS'},
{label: 'Web', value: 'web'},
2021-05-05 09:18:44 -07:00
]}>
<TabItem value="cli">
:::note
The CLI examples will require you to utilize the Command line Interface that is available through Meshtastic-python. Installation instructions can be found [here](software/python/python-installation).
2021-05-05 09:18:44 -07:00
:::
2021-05-18 19:28:32 -07:00
```bash title="Example - Set Region (an important first step!)"
2021-05-05 09:18:44 -07:00
meshtastic --set region Unset
```
</TabItem>
<TabItem value="android">
:::info
Configuring this setting is not yet available for the selected platform. If this is incorrect please update the documentation for this page.
:::
</TabItem>
<TabItem value="iOS">
:::info
Configuring this setting is not yet available for the selected platform. If this is incorrect please update the documentation for this page.
:::
</TabItem>
<TabItem value="web">
:::info
Configuring this setting is not yet available for the selected platform. If this is incorrect please update the documentation for this page.
:::
2021-05-05 09:18:44 -07:00
</TabItem>
</Tabs>