From 7973d868fee32758af041916f1b11453728c4d41 Mon Sep 17 00:00:00 2001 From: apt105 <73254487+apt105@users.noreply.github.com> Date: Thu, 15 Jul 2021 23:09:15 +0100 Subject: [PATCH 1/2] Add Go CLI page --- website/docs/software/community/go.md | 15 +++++++++++++++ website/sidebars.js | 1 + 2 files changed, 16 insertions(+) create mode 100644 website/docs/software/community/go.md diff --git a/website/docs/software/community/go.md b/website/docs/software/community/go.md new file mode 100644 index 00000000..816f52e0 --- /dev/null +++ b/website/docs/software/community/go.md @@ -0,0 +1,15 @@ +--- +id: community-go +title: Go command line interface +sidebar_label: Go CLI +--- + +:::note +This is a community project maintained by @lmatte7. +Development can be followed on [GitHub](https://github.com/lmatte7/meshtastic-go). +Support should be sought from the respective authors. +::: + +This is a command line interface for Meshtastic devices that has been built using the Go programming language developed by Google. This allows for an executable file to be downloaded for your operating system and run without installing other pre-requisits. + +The latest executables can be downloaded from [GitHub](https://github.com/lmatte7/meshtastic-go/releases/latest). diff --git a/website/sidebars.js b/website/sidebars.js index 245fdbc8..c98c5507 100644 --- a/website/sidebars.js +++ b/website/sidebars.js @@ -82,6 +82,7 @@ module.exports = { "software/community/community-overview", "software/community/community-atak", "software/community/community-pygui", + "software/community/community-go", ], }, { From ad07164811e9631e4d6040a974f15628f9099185 Mon Sep 17 00:00:00 2001 From: apt105 <73254487+apt105@users.noreply.github.com> Date: Thu, 15 Jul 2021 23:18:56 +0100 Subject: [PATCH 2/2] update --- website/docs/software/community/go.md | 35 ++++++++++++++++++++- website/docs/software/community/overview.md | 1 + 2 files changed, 35 insertions(+), 1 deletion(-) diff --git a/website/docs/software/community/go.md b/website/docs/software/community/go.md index 816f52e0..07f77c2a 100644 --- a/website/docs/software/community/go.md +++ b/website/docs/software/community/go.md @@ -10,6 +10,39 @@ Development can be followed on [GitHub](https://github.com/lmatte7/meshtastic-go Support should be sought from the respective authors. ::: -This is a command line interface for Meshtastic devices that has been built using the Go programming language developed by Google. This allows for an executable file to be downloaded for your operating system and run without installing other pre-requisits. +This is a command line interface for Meshtastic devices that has been built using the Go programming language developed by Google. This allows for an executable file to be downloaded for your operating system and run without installing other pre-requisits. The only requirement is for the [CP210x USB to UART bridge drivers](https://www.silabs.com/developers/usb-to-uart-bridge-vcp-drivers) to be installed. A selection of executables for different operating systems are available, and further operating systems can be supported as required. +### Command syntax + +A full list of commands can be viewed by running `--help`. Each command also has its own `--help` flag that provides more information on its subcommands and flags. + +Every command requires the `--port` flag to be set to the port the radio is attached to. This can be set to a serial port (like `/dev/cu.SLAB_USBtoUART`) or an IP address depending on which communication method should be used to communicate with the radio. The CLI will automatically determine if TCP or serial communications should be used depending on what value is provided to `--port`. + +``` +NAME: + meshtastic-go - Interface with meshtastic radios + +USAGE: + meshtastic-go [global options] command [command options] [arguments...] + +VERSION: + v0.2 + +AUTHOR: + Lucas Matte + +COMMANDS: + info Show radio information + message Interact with radio messaging functionality + channel Update channel information + prefs Update user preferences + location Set location + help, h Shows a list of commands or help for one command + +GLOBAL OPTIONS: + --port value, -p value specify a port + --help, -h show help (default: false) + --version, -v print the version (default: false) +``` +Further information is available on the project's GitHub [Readme.md](https://github.com/lmatte7/meshtastic-go/blob/main/README.md). The latest executables can be downloaded from [GitHub](https://github.com/lmatte7/meshtastic-go/releases/latest). diff --git a/website/docs/software/community/overview.md b/website/docs/software/community/overview.md index fd349a64..ea131f02 100644 --- a/website/docs/software/community/overview.md +++ b/website/docs/software/community/overview.md @@ -9,5 +9,6 @@ The Meshtastic ecosystem is highly extensible, and a number of community project Current community projects: * Meshtastic plugin for ATAK (Android Team Awareness Kit) * PyGUI - Platform independant graphical user interface for Meshtastic devices + * Go CLI - A command line interface using Go that requires no pre-requisits to be installed Support for these projects should be sought from their respective authors. \ No newline at end of file