meshtastic/docs/settings/config/device.mdx

104 lines
2.9 KiB
Plaintext
Raw Normal View History

2022-06-24 19:40:15 -07:00
---
id: device
title: Device Configuration
sidebar_label: Device
---
import Tabs from '@theme/Tabs';
import TabItem from '@theme/TabItem';
The device config options are: Role, Serial Output, Debug Log, NTP Server and Factory Reset. Device config uses an admin message sending a `Config.Device` protobuf.
## Device Config Values
### Role
Sets the role of node.
Acceptable values:
| Value | Description |
| :-------: | :---------------------------------------------------------------------------------------: |
| `Client` | Client (default) - App connected client. |
| `ClientMute` | Client Mute - Same as a client except packets will not hop over this node, does not contribute to routing packets for mesh. |
| `Router` | Router - Mesh packets will prefer to be routed over this node. This node will not be used by client apps. The wifi/ble radios and the oled screen will be put to sleep. |
| `RouterClient` | Router Client - Mesh packets will prefer to be routed over this node. The Router Client can be used as both a Router and an app connected Client. |
2022-06-24 19:40:15 -07:00
### Serial Console
Acceptable values: `true` or `false`
2022-09-22 15:41:16 -07:00
Disabling this will disable the SerialConsole by not initilizing the StreamAPI
2022-06-24 19:40:15 -07:00
### Debug Log
Acceptable values: `true` or `false`
By default we turn off logging as soon as an API client connects Set this to true to leave the debug log outputting even when API is active.
### NTP Server
Acceptable value: `string`
NTP server to use if WiFi is conneced, defaults to `0.pool.ntp.org`
## Device Config Client Availability
<Tabs
groupId="settings"
defaultValue="apple"
2022-06-24 19:40:15 -07:00
values={[
{label: 'Android', value: 'android'},
{label: 'Apple', value: 'apple'},
2022-06-29 22:33:26 -07:00
{label: 'CLI', value: 'cli'},
2022-06-24 19:40:15 -07:00
{label: 'Flasher', value: 'flasher'},
{label: 'Web', value: 'web'},
]}>
<TabItem value="android">
:::info
Device config is not available for Android.
:::
</TabItem>
<TabItem value="apple">
:::info
All device config options other than NTP Server are available on iOS, iPadOS and macOS at Settings > Radio Configuration > Device.
:::
</TabItem>
<TabItem value="cli">
2022-08-03 08:14:18 -07:00
All device config options are available in the python CLI. Example commands are below:
2022-06-24 19:40:15 -07:00
```shell title="Set the role to client"
meshtastic --set device.role Client
2022-06-24 19:40:15 -07:00
```
```shell title="Disable serial console"
2022-09-22 15:41:16 -07:00
meshtastic --set device.serial_enabled false
2022-06-24 19:40:15 -07:00
```
```shell title="Enable debug logging"
meshtastic --set device.debug_log_enabled true
2022-06-24 19:40:15 -07:00
```
```shell title="Factory reset your radio"
meshtastic --set device.factory_reset true
2022-06-24 19:40:15 -07:00
```
</TabItem>
<TabItem value="flasher">
2022-07-11 11:05:10 -07:00
:::danger
No device config options are available in the Flasher.
2022-06-24 19:40:15 -07:00
:::
</TabItem>
<TabItem value="web">
:::info
All device config options are available in the Web UI.
2022-06-24 19:40:15 -07:00
:::
</TabItem>
</Tabs>