mudhorn/meshtastic
1
0
Fork 0
mirror of https://github.com/meshtastic/meshtastic.git synced 2025-02-02 08:42:11 -08:00
Code Issues Actions Packages Projects Releases Wiki Activity

Add a number of arguments and rearrange the python documentation file

Browse source
This commit is contained in:
Ian McEwen 2024-06-30 23:07:17 -07:00
parent f7f0c95da0
commit 92b8fe55c5
No known key found for this signature in database
GPG key ID: 55BFD6FCB698EC37
1 changed files with 115 additions and 48 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

163
docs/software/python-cli/index.mdx
View file

@ -29,7 +29,7 @@ The hostname/ipaddr of the device to connect to (over TCP). If a host is not pro
This argument can also be specified as `--tcp` or `-t`. This argument can also be specified as `--tcp` or `-t`.
```shell title="Usage" ```shell title="Usage"
meshtastic --host HOST --info meshtastic --host meshtastic.local --info
meshtastic --host --info meshtastic --host --info
``` ```
@ -92,10 +92,11 @@ meshtastic --configure example_config.yaml
### --seriallog SERIALLOG ### --seriallog SERIALLOG
Logs device serial output to either 'stdout', 'none' or a filename to append to. Logs device serial output to either 'stdout', 'none' or a filename to append to. Defaults to 'stdout' if no filename is specified.
```shell title="Usage" ```shell title="Usage"
meshtastic --port /dev/ttyUSB0 --seriallog meshtastic --port /dev/ttyUSB0 --seriallog
meshtastic -t meshtastic.local --seriallog log.txt
``` ```
### --info ### --info
@ -148,12 +149,20 @@ meshtastic --nodes
### --qr ### --qr
Displays the QR code that corresponds to the current channel. Displays the URL and QR code that corresponds to the current primary channel.
```shell title="Usage" ```shell title="Usage"
meshtastic --qr meshtastic --qr
``` ```
### --qr-all
Displays the URL and QR code that corresponds to all configured channels on the node.
```shell title="Usage"
meshtastic --qr-all
```
### --get [config_section] ### --get [config_section]
Gets a preferences field. Gets a preferences field.
@ -165,6 +174,12 @@ meshtastic --get lora
meshtastic --get lora.region meshtastic --get lora.region
``` ```
To see all valid values, pass an invalid value, such as `0`:
```shell title="Usage"
meshtastic --get 0
```
### --set [config_section].[option]  [value] ### --set [config_section].[option]  [value]
Sets a preferences field. Sets a preferences field.
@ -177,7 +192,7 @@ meshtastic --set lora.region Unset
### --seturl SETURL ### --seturl SETURL
Set a channel URL. Set the channel URL, which contains LoRa configuration plus the configuration of channels. Replaces your current configuration and channels completely.
```shell title="Usage" ```shell title="Usage"
meshtastic --seturl https://www.meshtastic.org/c/GAMiIE67C6zsNmlWQ-KE1tKt0fRKFciHka-DShI6G7ElvGOiKgZzaGFyZWQ= meshtastic --seturl https://www.meshtastic.org/c/GAMiIE67C6zsNmlWQ-KE1tKt0fRKFciHka-DShI6G7ElvGOiKgZzaGFyZWQ=
@ -185,7 +200,7 @@ meshtastic --seturl https://www.meshtastic.org/c/GAMiIE67C6zsNmlWQ-KE1tKt0fRKFci
### --ch-index CH_INDEX ### --ch-index CH_INDEX
Set the specified channel index. Act on the specified channel index. Applies to options that configure channels (such as `--ch-set` and `--ch-del`) as well as options that send messages to the mesh (such as `--sendtext` and `--traceroute`).
```shell title="Usage" ```shell title="Usage"
meshtastic --ch-index 1 --ch-disable meshtastic --ch-index 1 --ch-disable
@ -195,21 +210,25 @@ meshtastic --ch-index 1 --ch-disable
Add a secondary channel, you must specify a channel name. Add a secondary channel, you must specify a channel name.
Incompatible with `--ch-index`. If you pass `--ch-add`, any subsequent `--ch-set` and other commands that use a channel will use the index of the newly-added channel.
```shell title="Usage" ```shell title="Usage"
meshtastic --ch-add testing-channel meshtastic --ch-add testing-channel
``` ```
### --ch-del ### --ch-del
Delete the ch-index channel. Delete the channel specified by `--ch-index`.
```shell title="Usage" ```shell title="Usage"
meshtastic --ch-index 1 --ch-del meshtastic --ch-index 1 --ch-del
``` ```
### --ch-enable ### --ch-enable (deprecated)
Enable the specified channel. This option is deprecated. Using `--ch-add` is preferred in order to ensure there are no gaps in the channel list.
Enable the channel specified by `--ch-index`.
```shell title="Usage" ```shell title="Usage"
meshtastic --ch-index 1 --ch-enable meshtastic --ch-index 1 --ch-enable
@ -217,7 +236,9 @@ meshtastic --ch-index 1 --ch-enable
### --ch-disable ### --ch-disable
Disable the specified channel. This option is deprecated. Using `--ch-del` is preferred in order to ensure there are no gaps in the channel list.
Disable the channel specified by `--ch-index`.
```shell title="Usage" ```shell title="Usage"
meshtastic --ch-index 1 --ch-disable meshtastic --ch-index 1 --ch-disable
@ -225,7 +246,7 @@ meshtastic --ch-index 1 --ch-disable
### --ch-set CH_SET CH_SET ### --ch-set CH_SET CH_SET
Set a channel parameter. Set a channel parameter on the channel specified by `--ch-index`.
```shell title="Usage" ```shell title="Usage"
meshtastic --ch-set id 1234 --ch-index 0 meshtastic --ch-set id 1234 --ch-index 0
@ -289,7 +310,7 @@ meshtastic --ch-shortfast
### --set-owner SET_OWNER ### --set-owner SET_OWNER
Set device owner name. Set device owner name, sometimes called the long name.
```shell title="Usage" ```shell title="Usage"
meshtastic --set-owner "MeshyJohn" meshtastic --set-owner "MeshyJohn"
@ -305,7 +326,9 @@ meshtastic --set-owner-short "MJ"
### --set-ham SET_HAM ### --set-ham SET_HAM
Set licensed Ham ID and turn off encryption. Set licensed Ham ID (by setting the owner name) and turn off encryption on the primary channel.
To disable Ham mode, use `--set-owner` and `--set-owner-short` to reset the owner names, and use `--seturl` or `--ch-set` commands to configure channels with the name and encryption you wish them to have. Or, use `--factory-reset` to reset to default settings.
```shell title="Usage" ```shell title="Usage"
meshtastic --set-ham KI1345 meshtastic --set-ham KI1345
@ -313,7 +336,9 @@ meshtastic --set-ham KI1345
### --dest DEST ### --dest DEST
The destination node id for any sent commands. Used for [Remote Node Administration](/docs/configuration/remote-admin) The destination node id for any sent commands, if not passed to a command another way. Used for [Remote Node Administration](/docs/configuration/remote-admin).
On many shells, exclamation points trigger special behavior unless enclosed in single quotes.
```shell title="Usage" ```shell title="Usage"
meshtastic --dest '!28979058' --set-owner "MeshyJohn" meshtastic --dest '!28979058' --set-owner "MeshyJohn"
@ -321,15 +346,16 @@ meshtastic --dest '!28979058' --set-owner "MeshyJohn"
### --sendtext SENDTEXT ### --sendtext SENDTEXT
Send a text message. Can specify a channel index ('--ch-index') or a destination ('--dest'). Send a text message. Can specify a channel index (`--ch-index`) and/or a destination (`--dest`).
```shell title="Usage" ```shell title="Usage"
meshtastic --sendtext "Hello Mesh!" meshtastic --sendtext 'Hello Mesh!'
meshtastic --ch-index 1 --sendtext 'Hello secondary channel!'
``` ```
### --traceroute TRACEROUTE ### --traceroute TRACEROUTE
Traceroute from connected node to a destination. You need pass the destination ID as an argument. Only nodes that have the encryption key can be traced. Traceroute from connected node to a destination. You need pass the destination ID as an argument, and may pass `--ch-index` to specify a channel. The node you are tracing must have the same channel configured, and only nodes that share the channel will identify themselves within the response. With recent enough firmware, other nodes may be included as `!ffffffff` but not with their actual ID.
```shell title="Usage" ```shell title="Usage"
meshtastic --traceroute '!ba4bf9d0' meshtastic --traceroute '!ba4bf9d0'
@ -337,7 +363,7 @@ meshtastic --traceroute '!ba4bf9d0'
### --request-telemetry ### --request-telemetry
Request telemetry from a node. You need to pass the destination ID as an argument with '--dest'. For repeaters, the nodeNum is required. Request telemetry from a node. You need to pass the destination ID as an argument with `--dest`. For repeaters, using the node's decimal ID may be more effective, but a hexadecimal ID should work as well.
```shell title="Usage" ```shell title="Usage"
meshtastic --request-telemetry --dest '!ba4bf9d0' meshtastic --request-telemetry --dest '!ba4bf9d0'
@ -346,10 +372,10 @@ meshtastic --request-telemetry --dest 1828779180
### --ack ### --ack
Used in combination with --sendtext to wait for an acknowledgment. Used in combination with `--sendtext` and other commands to wait for an acknowledgment. Not all commands will be able to return an acknowledgment. Best used for commands that specify a single destination node.
```shell title="Usage" ```shell title="Usage"
meshtastic --sendtext "Hello Mesh!" --ack meshtastic --sendtext 'Hello Mesh!' --dest '!28979058' --ack
``` ```
### --reboot ### --reboot
@ -386,47 +412,41 @@ meshtastic --reset-nodedb
### --reply ### --reply
Reply to received messages. Listen for messages. When one is received, send a message to the primary channel repeating the message along with some information.
```shell title="Usage" ```shell title="Usage"
meshtastic --reply meshtastic --reply
``` ```
### --gpio-wrb GPIO_WRB GPIO_WRB
Set a particular GPIO # to 1 or 0.
```shell title="Usage"
meshtastic --port /dev/ttyUSB0 --gpio-wrb 4 1 --dest '!28979058'
```
### --gpio-rd GPIO_RD
Read from a GPIO mask.
```shell title="Usage"
meshtastic --port /dev/ttyUSB0 --gpio-rd 0x10 --dest '!28979058'
```
### --gpio-watch GPIO_WATCH
Start watching a GPIO mask for changes.
```shell title="Usage"
meshtastic --port /dev/ttyUSB0 --gpio-watch 0x10 --dest '!28979058'
```
### --no-time ### --no-time
Suppress sending the current time to the mesh. Suppress sending the current time to the mesh on startup. May improve reliability and startup time.
```shell title="Usage" ```shell title="Usage"
meshtastic --port /dev/ttyUSB0 --no-time meshtastic --port /dev/ttyUSB0 --no-time
``` ```
### --no-nodes
Instruct the node to not send nodeinfo from the NodeDB on startup. Requires firmware of sufficient version. Commands that use node information may behave unpredictably, since that information will not be populated, but this can improve efficiency for commands that don't.
```shell title="Usage"
meshtastic --no-nodes --no-time --sendtext "Firing off a quick message"
```
### --wait-to-disconnect WAIT_TO_DISCONNECT
After performing whatever actions are specified by other options, wait before disconnecting from the device. Some devices will reboot when the serial connection disconnects, so adding a wait time may improve reliability. Defaults to 5 seconds if not provided.
```shell title="Usage"
meshtastic --set lora.channel_num 20 --wait-to-disconnect 10
```
### --setalt SETALT ### --setalt SETALT
Set device altitude (allows use without GPS). Set device altitude (allows use without GPS), and enables fixed position mode.
Can only be used on locally-connected nodes and not along with `--dest`.
```shell title="Usage" ```shell title="Usage"
meshtastic --setalt 120 meshtastic --setalt 120
@ -434,7 +454,9 @@ meshtastic --setalt 120
### --setlat SETLAT ### --setlat SETLAT
Set device latitude (allows use without GPS). Set device latitude (allows use without GPS), and enables fixed position mode.
Can only be used on locally-connected nodes and not along with `--dest`.
```shell title="Usage" ```shell title="Usage"
meshtastic --setlat 25.2 meshtastic --setlat 25.2
@ -442,12 +464,24 @@ meshtastic --setlat 25.2
### --setlon SETLON ### --setlon SETLON
Set device longitude (allows use without GPS). Set device longitude (allows use without GPS), and enables fixed position mode.
Can only be used on locally-connected nodes and not along with `--dest`.
```shell title="Usage" ```shell title="Usage"
meshtastic --setlon -16.8 meshtastic --setlon -16.8
``` ```
### --remove-position
Clear the node's currently set fixed position and disable fixed position mode.
Can only be used on locally-connected nodes and not along with `--dest`.
```shell title="Usage"
meshtastic --remove-position
```
### --debug ### --debug
Show API library debug log messages. Show API library debug log messages.
@ -456,6 +490,14 @@ Show API library debug log messages.
meshtastic --debug --info meshtastic --debug --info
``` ```
### --listen
Stay open and listen to the stream of protocol buffer messages. This option enables `--debug` even if it is not provided alongside this argument.
```shell title="Usage"
meshtastic --listen
```
### --test ### --test
Run stress test against all connected Meshtastic devices. Run stress test against all connected Meshtastic devices.
@ -480,3 +522,28 @@ Don't start the API, just function as a dumb serial terminal. Probably not very
meshtastic --noproto meshtastic --noproto
``` ```
## Remote Hardware arguments
### --gpio-wrb GPIO_WRB GPIO_WRB
Set a particular GPIO # to 1 or 0.
```shell title="Usage"
meshtastic --port /dev/ttyUSB0 --gpio-wrb 4 1 --dest '!28979058'
```
### --gpio-rd GPIO_RD
Read from a GPIO mask.
```shell title="Usage"
meshtastic --port /dev/ttyUSB0 --gpio-rd 0x10 --dest '!28979058'
```
### --gpio-watch GPIO_WATCH
Start watching a GPIO mask for changes.
```shell title="Usage"
meshtastic --port /dev/ttyUSB0 --gpio-watch 0x10 --dest '!28979058'
```