update docs to reflect new --ch-index arg requirement

This commit is contained in:
Mike Kinney 2021-12-10 20:04:10 -08:00
parent 682cfe2fe7
commit 9ea05a9a4b
2 changed files with 14 additions and 14 deletions

View file

@ -69,22 +69,22 @@ Meshtastic encodes the radio channel and PSK in the channel's URL. All nodes mus
::: :::
```bash ```bash
meshtastic --ch-set name mychan --ch-set channel_num 4 --info meshtastic --ch-set name mychan --ch-index 1 --ch-set channel_num 4 --info
``` ```
You can even set the channel preshared key to a particular AES128 or AES256 sequence. You can even set the channel preshared key to a particular AES128 or AES256 sequence.
```bash ```bash
meshtastic --ch-set psk 0x1a1a1a1a2b2b2b2b1a1a1a1a2b2b2b2b1a1a1a1a2b2b2b2b1a1a1a1a2b2b2b2b --info meshtastic --ch-index 1 --ch-set psk 0x1a1a1a1a2b2b2b2b1a1a1a1a2b2b2b2b1a1a1a1a2b2b2b2b1a1a1a1a2b2b2b2b --info
``` ```
Use `--ch-set psk none` to turn off encryption. Use `--ch-set psk none --ch-index 0` to turn off encryption.
Use `--ch-set psk random` will assign a new (high quality) random AES256 key to the primary channel (similar to what the Android app does when making new channels). Use `--ch-set psk random --ch-index 0` will assign a new (high quality) random AES256 key to the primary channel (similar to what the Android app does when making new channels).
Use `--ch-set psk default` to restore the standard 'default' (minimally secure, because it is in the source code for anyone to read) AES128 key. Use `--ch-set psk default --ch-index 0` to restore the standard 'default' (minimally secure, because it is in the source code for anyone to read) AES128 key.
All `ch-set` commands will default to the primary channel at index 0, but can be applied to other channels with the `ch-index` parameter: All `ch-set` commands need to have the `ch-index` parameter specified:
```bash ```bash
meshtastic --ch-index 1 --ch-set name mychan --ch-set channel_num 4 --info meshtastic --ch-index 1 --ch-set name mychan --ch-set channel_num 4 --info

View file

@ -109,8 +109,8 @@ If `true`, messages on the mesh will be sent to the public internet by any gatew
]}> ]}>
<TabItem value="cli"> <TabItem value="cli">
```bash title="Set channel ID" ```bash title="Set the PRIMARY channel ID"
meshtastic --ch-set id 1234 meshtastic --ch-set id 1234 --ch-index 0
``` ```
</TabItem> </TabItem>
@ -135,12 +135,12 @@ The channel `id` must be an integer.
]}> ]}>
<TabItem value="cli"> <TabItem value="cli">
```bash title="Set channel name" ```bash title="Set channel name for the PRIMARY channel"
meshtastic --ch-set name MyChannel meshtastic --ch-set name MyChannel --ch-index 0
``` ```
```bash title="Set channel name with spaces" ```bash title="Set channel name for the PRIMARY channel with spaces"
meshtastic --ch-set name "My Channel" meshtastic --ch-set name "My Channel" --ch-index 0
``` ```
</TabItem> </TabItem>
<TabItem value="android"> <TabItem value="android">
@ -165,7 +165,7 @@ A channel `id` must be set in order to name a channel.
<TabItem value="cli"> <TabItem value="cli">
```bash title="Set psk" ```bash title="Set psk"
meshtastic --ch-set psk default meshtastic --ch-set psk default --ch-index 0
``` ```
<!--- TODO random and none ---> <!--- TODO random and none --->
@ -192,7 +192,7 @@ See [`psk`](#psk) for details.
<TabItem value="cli"> <TabItem value="cli">
```bash title="Set Modem - LongSlow" ```bash title="Set Modem - LongSlow"
meshtastic --ch-set modem_config Bw125Cr48Sf4096 meshtastic --ch-set modem_config Bw125Cr48Sf4096 --ch-index 0
``` ```
</TabItem> </TabItem>
<TabItem value="android"> <TabItem value="android">