mirror of
https://github.com/meshtastic/meshtastic.git
synced 2024-11-17 11:04:13 -08:00
125 lines
2.6 KiB
Plaintext
125 lines
2.6 KiB
Plaintext
---
|
|
id: user
|
|
title: User Configuration
|
|
sidebar_label: User
|
|
description: Details on Long Name, Short Name, and Licensed operation.
|
|
---
|
|
|
|
import Tabs from "@theme/Tabs";
|
|
import TabItem from "@theme/TabItem";
|
|
|
|
The user config options are: Long Name, Short Name, and Is Licensed. User config uses an admin message sending a `User` protobuf.
|
|
|
|
## User Config Values
|
|
|
|
### Long Name
|
|
|
|
A personalized name for your device.
|
|
|
|
Auto-generated by default.
|
|
|
|
If you are a licensed HAM operator and have enabled `IsLicensed`, this should be set to your HAM operator call sign.
|
|
|
|
### Short Name
|
|
|
|
A personalized short identifier for your device.
|
|
|
|
Auto-generated by default.
|
|
|
|
### Is Licensed (HAM)
|
|
|
|
If you are a licensed HAM operator and have considered the [privileges and restrictions](/docs/faq/#amateur-radio-ham) of using Meshtastic with a HAM license, enable this flag.
|
|
|
|
Disabled by default.
|
|
|
|
By enabling `IsLicensed`, you should also review the following related configurations:
|
|
|
|
- **User:** `LongName` (Should be your Call Sign)
|
|
- **Channel:** `PSK` (Should be Empty, removing encryption)
|
|
|
|
## User Config Client Availability
|
|
|
|
<Tabs
|
|
groupId="settings"
|
|
defaultValue="cli"
|
|
values={[
|
|
{label: 'Android', value: 'android'},
|
|
{label: 'Apple', value: 'apple'},
|
|
{label: 'CLI', value: 'cli'},
|
|
{label: 'Web', value: 'web'},
|
|
]}>
|
|
|
|
<TabItem value="android">
|
|
|
|
#### Android
|
|
|
|
:::info
|
|
|
|
All User config options are available for Android.
|
|
|
|
1. Open the Meshtastic App
|
|
2. Navigate to: **Vertical Ellipsis (3 dots top right) > Radio Configuration > User**
|
|
|
|
:::
|
|
|
|
</TabItem>
|
|
|
|
<TabItem value="apple">
|
|
|
|
#### Apple
|
|
|
|
:::info
|
|
|
|
All User config options are available on iOS, iPadOS and macOS at Settings > Device Configuration > User.
|
|
|
|
:::
|
|
|
|
</TabItem>
|
|
|
|
<TabItem value="cli">
|
|
|
|
#### CLI
|
|
|
|
:::info
|
|
|
|
All User config options are available in the python CLI. Example commands are below:
|
|
|
|
:::
|
|
|
|
Please see instructions for [Enabling HAM License](/docs/software/python/cli/usage#ham-radio-support)
|
|
|
|
:::tip
|
|
|
|
Because the device will reboot after each command is sent via CLI, it is recommended when setting multiple values in a config section that commands be chained together as one.
|
|
|
|
```shell title="Example:"
|
|
meshtastic --set-owner 'your node name' --set-owner-short 'NODE'
|
|
```
|
|
|
|
:::
|
|
|
|
```shell title="Set the LongName Value"
|
|
meshtastic --set-owner 'your node name'
|
|
```
|
|
|
|
```shell title="Set the ShortName Value"
|
|
meshtastic --set-owner-short 'NODE'
|
|
```
|
|
|
|
```shell title="Enable Ham Mode, set name to license, disable encryption"
|
|
meshtastic --set-ham 'CALLSIGN'
|
|
```
|
|
|
|
</TabItem>
|
|
|
|
<TabItem value="web">
|
|
|
|
#### Web
|
|
|
|
:::info
|
|
All User config options are available in the Web UI.
|
|
:::
|
|
|
|
</TabItem>
|
|
</Tabs>
|