From e4e3b627b1b6987f4d25f0c4603b081e87eb2513 Mon Sep 17 00:00:00 2001 From: pdxlocations Date: Sat, 24 Jun 2023 21:50:02 -0700 Subject: [PATCH 01/19] updates and corrections --- docs/about/contributing.mdx | 24 +++++++++++++----------- 1 file changed, 13 insertions(+), 11 deletions(-) diff --git a/docs/about/contributing.mdx b/docs/about/contributing.mdx index 4aa6f41d..8140dbe7 100644 --- a/docs/about/contributing.mdx +++ b/docs/about/contributing.mdx @@ -4,14 +4,16 @@ sidebar_label: Contributing slug: /contributing sidebar_position: 3 --- +### Volunteer Based Development -Meshtastic is a team of volunteers, and as such there is always plenty of ways to help. This project gets great contributions from people in their off hours. Those contributors work on the features they are interested in. It is a very open and welcoming developer community, and we are always looking for help to improve Meshtastic. +Meshtastic is a team of volunteers, and as such there are always plenty of ways to help. This project gets great contributions from people in their off hours. Those contributors work on the features they are interested in. It is a very open and welcoming developer community, and we are always looking for help to improve Meshtastic. - If you're a developer, there's plenty stuff to do. Dig in! - If you're interacting with Meshtastic radios, we could use help with testing, documenting, and providing feedback. - If you're into Web Development, check out the different web repos. - If you're into Kotlin and Android, check out the link to the repo below. - If you're into Python, check out the link to the repo below +- If you're into SwiftUI, check out the link to the repo below - If you're into Ham Radio and LoRa, then this is a great project for you! - ... basically... we would love to have your help and feedback @@ -27,20 +29,20 @@ Most communication and interactions happen with protocol buffers. The [Meshtasti ### Device Firmware -The [firmware](https://github.com/meshtastic/firmware) is where all of the firmware development happens. This is where the code for the ESP32 and nRF52 based devices is developed. It is mainly C and C++ code. Think Arduino. It is where the first level of hardware interaction begins and ends. +The [firmware repo](https://github.com/meshtastic/firmware) is where all of the device firmware development happens. This is where the code for the ESP32 and nRF52 based devices is developed. It is mainly C and C++ code. Think Arduino. It is where the first level of hardware interaction begins and ends. ### Firmware Modules -[Modules](/docs/settings/moduleconfig) are also implemented mainly in the firmware repo above. Typically, you would add functionality in the protobufs repo and the device repo to implement module functionality. You probably also want to have some client/device use/interact with the module and that is where the Device support comes into play. +[Modules](/docs/settings/moduleconfig) extend device and mesh functionality beyond core functions. These are also implemented mainly in the firmware repo above. Typically, you would add definitions in the protobufs repo and the device repo to implement module functionality. You most likely also want to have some client or device, use or interact with the module. This is where Device Interface support comes into play. ### CLI Apps (Device Interface) -- **Meshtastic Python CLI** - The [meshtastic/Meshtastic-python](https://github.com/meshtastic/Meshtastic-python) repository is typically where the first device interaction takes place, but that is not a requirement. This repo has a command line utility that allows you to interact with most functionality with the devices. This python library can also be consumed for other applications. +- **Meshtastic Python CLI** - The [meshtastic/Meshtastic-python repository](https://github.com/meshtastic/Meshtastic-python) is a command line utility that allows you to interact with most of the device settings and functionality. This python library can also be consumed for other applications. See [Meshtastic Python Development](/docs/development/python/) for more details ### Web Apps (Device Interface) -- **Meshtastic Web** - The [meshtastic/web](https://github.com/meshtastic/web) repository is where the hosted web server on the ESP32 devices in Typescript is developed. See the [Web interface overview](/docs/software/web-client) for more details. -- **Meshtastic JS** - The [meshtastic/meshtastic.js](https://github.com/meshtastic/meshtastic.js) repository is a JavaScript library that provides an interface for Meshtastic devices. +- **Meshtastic Web** - The [meshtastic/web repository](https://github.com/meshtastic/web) is where the hosted web server on the ESP32 devices in Typescript is developed. See the [Web Development Overview](/docs/development/web/) for more details. +- **Meshtastic JS** - The [meshtastic/meshtastic.js](https://github.com/meshtastic/meshtastic.js) repository is a JavaScript library that provides an interface for Meshtastic devices. See [Javascript Development](/docs/development/js) for more details @sachaw has been making tons of progress on the web app and would love help with: @@ -49,13 +51,13 @@ The [firmware](https://github.com/meshtastic/firmware) is where all of the firmw - Chat scroll lock - Various module support -### Mobile Apps (Device Interface) +### Mobile and Desktop Apps (Device Interface) -There are two phone apps that interact with the Meshtastic devices: +There are Android, iOS, iPadOS, and macOS apps that interact with Meshtastic devices: -- **Android App** - The [meshtastic/Meshtastic-Android](https://github.com/meshtastic/Meshtastic-Android) repository repo contains the Kotlin code for Android based interactions with Meshtastic devices. See the [Android development instructions](/docs/development/android) on how to create a development environment and build the Meshtastic Android App. -- **Apple Apps** - The iOS applications are in the process of a complete re-write in Swift and will have the new repo published soon. Note: There are a couple of earlier implementations. +- **Android App** - The [meshtastic/Meshtastic-Android](https://github.com/meshtastic/Meshtastic-Android) repository contains the Kotlin code for Android based interactions with Meshtastic devices. See the [Android development instructions](/docs/development/android) on how to create a development environment and build the Meshtastic Android App. +- **Apple Apps** - The [meshtastic/Meshtastic-Apple](https://github.com/meshtastic/Meshtastic-Apple) repository contains the SwiftUI client applications code for iPhone, iPad and Mac. ### Documentation -This website is in the [Meshtastic](https://github.com/meshtastic/meshtastic) repository. +The Meshtastic website (the one you are looking at right now) is in the [meshtastic/Meshtastic](https://github.com/meshtastic/meshtastic) repository. See [Maintaining Documentation](docs/development/docs) for more details. From e8af249b4d872656be151c624c786136f5669437 Mon Sep 17 00:00:00 2001 From: pdxlocations Date: Sat, 24 Jun 2023 22:02:14 -0700 Subject: [PATCH 02/19] most likely back to probably --- docs/about/contributing.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/about/contributing.mdx b/docs/about/contributing.mdx index 8140dbe7..2778674d 100644 --- a/docs/about/contributing.mdx +++ b/docs/about/contributing.mdx @@ -33,7 +33,7 @@ The [firmware repo](https://github.com/meshtastic/firmware) is where all of the ### Firmware Modules -[Modules](/docs/settings/moduleconfig) extend device and mesh functionality beyond core functions. These are also implemented mainly in the firmware repo above. Typically, you would add definitions in the protobufs repo and the device repo to implement module functionality. You most likely also want to have some client or device, use or interact with the module. This is where Device Interface support comes into play. +[Modules](/docs/settings/moduleconfig) extend device and mesh functionality beyond core functions. These are also implemented mainly in the firmware repo above. Typically, you would add definitions in the protobufs repo and the device repo to implement module functionality. You probably also want to have some client or device, use or interact with the module. This is where Device Interface support comes into play. ### CLI Apps (Device Interface) From 1de2afa7904ce9f69a3e67e4c8cf33107d36af14 Mon Sep 17 00:00:00 2001 From: pdxlocations Date: Sat, 24 Jun 2023 22:07:52 -0700 Subject: [PATCH 03/19] change definitions to functions --- docs/about/contributing.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/about/contributing.mdx b/docs/about/contributing.mdx index 2778674d..94f77693 100644 --- a/docs/about/contributing.mdx +++ b/docs/about/contributing.mdx @@ -33,7 +33,7 @@ The [firmware repo](https://github.com/meshtastic/firmware) is where all of the ### Firmware Modules -[Modules](/docs/settings/moduleconfig) extend device and mesh functionality beyond core functions. These are also implemented mainly in the firmware repo above. Typically, you would add definitions in the protobufs repo and the device repo to implement module functionality. You probably also want to have some client or device, use or interact with the module. This is where Device Interface support comes into play. +[Modules](/docs/settings/moduleconfig) extend device and mesh functionality beyond core functions. These are also implemented mainly in the firmware repo above. Typically, you would add functions in the protobufs repo and the device repo to implement module functionality. You probably also want to have some client or device, use or interact with the module. This is where Device Interface support comes into play. ### CLI Apps (Device Interface) From e0f61ff343103daa2968899250b4d23746a23442 Mon Sep 17 00:00:00 2001 From: rcarteraz Date: Tue, 27 Jun 2023 18:40:10 -0700 Subject: [PATCH 04/19] move default before fixed as it references fixed --- docs/configuration/device-config/bluetooth.mdx | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/configuration/device-config/bluetooth.mdx b/docs/configuration/device-config/bluetooth.mdx index c0aecfd8..541e50e1 100644 --- a/docs/configuration/device-config/bluetooth.mdx +++ b/docs/configuration/device-config/bluetooth.mdx @@ -28,10 +28,6 @@ Specify pairing mode. `FIXED_PIN` uses the fixed PIN that should then be additionally specified. Finally, `NO_PIN` disables PIN authentication. -### Fixed PIN - -If your pairing mode is set to `FIXED_PIN`, the default value is 123456. For all other pairing modes, this number is ignored. A custom integer (6 digits) can be set via the Bluetooth config options. - ### Default Pairing Mode The default pairing mode will be determined based on whether the device has or does not have a screen attached to it during the first boot (or with a stale device state) unless manually configured via the Bluetooth config options. @@ -39,6 +35,10 @@ The default pairing mode will be determined based on whether the device has or d - **Screen Attached:** If your device boots up for the first time (or with a stale device state), and a screen is detected, the default pairing mode will be set to `RANDOM_PIN`. Should the attached screen be removed after the device has already been booted, the default pairing mode of `RANDOM_PIN` will remain unless manually changed to `FIXED_PIN` or `NO_PIN`. It is recommended the pairing mode be updated prior to removing the attached screen. - **No Screen Attached:** If your device boots up for the first time (or with a stale device state), and no screen is detected, the default paring mode will be set to `FIXED_PIN` with the aforementioned default value unless manually configured to a custom value. +### Fixed PIN + +If your pairing mode is set to `FIXED_PIN`, the default value is 123456. For all other pairing modes, this number is ignored. A custom integer (6 digits) can be set via the Bluetooth config options. + ## Configure Bluetooth Config Date: Tue, 27 Jun 2023 19:01:18 -0700 Subject: [PATCH 05/19] grammar --- docs/configuration/device-config/bluetooth.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/configuration/device-config/bluetooth.mdx b/docs/configuration/device-config/bluetooth.mdx index 541e50e1..a9b7f05d 100644 --- a/docs/configuration/device-config/bluetooth.mdx +++ b/docs/configuration/device-config/bluetooth.mdx @@ -33,7 +33,7 @@ Finally, `NO_PIN` disables PIN authentication. The default pairing mode will be determined based on whether the device has or does not have a screen attached to it during the first boot (or with a stale device state) unless manually configured via the Bluetooth config options. - **Screen Attached:** If your device boots up for the first time (or with a stale device state), and a screen is detected, the default pairing mode will be set to `RANDOM_PIN`. Should the attached screen be removed after the device has already been booted, the default pairing mode of `RANDOM_PIN` will remain unless manually changed to `FIXED_PIN` or `NO_PIN`. It is recommended the pairing mode be updated prior to removing the attached screen. -- **No Screen Attached:** If your device boots up for the first time (or with a stale device state), and no screen is detected, the default paring mode will be set to `FIXED_PIN` with the aforementioned default value unless manually configured to a custom value. +- **No Screen Attached:** If your device boots up for the first time (or with a stale device state), and no screen is detected, the default paring mode will be set to `FIXED_PIN` with the default value listed below unless manually configured to a custom value. ### Fixed PIN From 2ff8c8762418d8307dbe426aa2cea7e723ec472d Mon Sep 17 00:00:00 2001 From: pdxlocations Date: Wed, 28 Jun 2023 22:02:20 -0700 Subject: [PATCH 06/19] remove all traces of gui flasher --- docs/about/faq.mdx | 9 - docs/configuration/device-config/lora.mdx | 10 - docs/development/python/building.mdx | 4 - docs/development/web/partitions.mdx | 3 +- .../esp32/external-serial-adapter.mdx | 7 +- .../esp32/python-flasher.mdx | 11 - .../nrf52/python-flasher.mdx | 11 - docs/software/python-flasher.mdx | 218 ------------------ src/pages/index.tsx | 4 +- 9 files changed, 5 insertions(+), 272 deletions(-) delete mode 100644 docs/getting-started/flashing-firmware/esp32/python-flasher.mdx delete mode 100644 docs/getting-started/flashing-firmware/nrf52/python-flasher.mdx delete mode 100644 docs/software/python-flasher.mdx diff --git a/docs/about/faq.mdx b/docs/about/faq.mdx index d1f28ceb..df9c9728 100644 --- a/docs/about/faq.mdx +++ b/docs/about/faq.mdx @@ -157,15 +157,6 @@ If you use your HAM radio license with Meshtastic, consider both the privileges - On iPhone navigate to Settings -> User and set Long Name to your Ham Radio callsign, then activate the slider for 'Licensed Operator'. - Instructions for Enabling HAM License from the Python CLI can be found [here](/docs/software/python/cli/usage#ham-radio-support). - - - -## Flasher - -### Why does my operating system flag Meshtastic Flasher as having malware? - -The flasher contains no malware and completely passed the Microsoft malware scanning. It appears that a lot of file download services are using the Windows Defender data, so if you're seeing alerts of a detected trojan please [update your Windows Defender definitions](https://www.microsoft.com/en-us/wdsi/defenderupdates). - ### What if I'm still having issues on Windows 10? It's been reported that `App execution aliases` might conflict with one another and prevent python3 from being able to run properly. There is an example of a fix located [here](https://github.com/meshtastic/Meshtastic-gui-installer/issues/154). diff --git a/docs/configuration/device-config/lora.mdx b/docs/configuration/device-config/lora.mdx index a126936e..2a7d0581 100644 --- a/docs/configuration/device-config/lora.mdx +++ b/docs/configuration/device-config/lora.mdx @@ -128,7 +128,6 @@ values={[ {label: 'Android', value: 'android'}, {label: 'Apple', value: 'apple'}, {label: 'CLI', value: 'cli'}, -{label: 'Flasher', value: 'flasher'}, {label: 'Web', value: 'web'}, ]}> @@ -205,15 +204,6 @@ meshtastic --set lora.override_duty_cycle true meshtastic --set lora.override_duty_cycle false ``` - - - -:::info - -Only `lora.region` can be set via the GUI flasher. Refer to other clients for any other config. - -::: - diff --git a/docs/development/python/building.mdx b/docs/development/python/building.mdx index 33bbdb78..b194a91c 100644 --- a/docs/development/python/building.mdx +++ b/docs/development/python/building.mdx @@ -41,10 +41,6 @@ pytest -m smoke1 You need permissions in the GitHub project to make a build ::: -### Meshtastic-flasher - -A `meshtastic-flasher` release consists of publishing the release to PyPi https://pypi.org/project/meshtastic-flasher/ as well as producing single-executable files that are downloadable from Github https://github.com/meshtastic/Meshtastic-gui-installer/releases. - #### Instructions - automated - Go to Actions / Make Release / Run Workflow https://github.com/meshtastic/Meshtastic-gui-installer/actions/workflows/release.yml diff --git a/docs/development/web/partitions.mdx b/docs/development/web/partitions.mdx index 51d7f98a..17db326c 100644 --- a/docs/development/web/partitions.mdx +++ b/docs/development/web/partitions.mdx @@ -5,8 +5,7 @@ sidebar_label: ESP32 partitions --- :::caution -It has been reported that some of this information is out of date. Flashing the device with [Meshtastic-flasher](/docs/software/python/flasher) should fix these partition issues and update you to the current web interface. - +It has been reported that some of this information is out of date. FIXME - Investigate and rewrite document to reflect the current ESP32 Partition mitigation. ::: diff --git a/docs/getting-started/flashing-firmware/esp32/external-serial-adapter.mdx b/docs/getting-started/flashing-firmware/esp32/external-serial-adapter.mdx index 590985e5..08d6b2b7 100644 --- a/docs/getting-started/flashing-firmware/esp32/external-serial-adapter.mdx +++ b/docs/getting-started/flashing-firmware/esp32/external-serial-adapter.mdx @@ -10,7 +10,7 @@ import TabItem from "@theme/TabItem"; import Link from "@docusaurus/Link"; :::info -This information will likely only be helpful if you've already attempted to go through the prerequisites and processes outlined in [meshtastic flasher](/docs/software/python/flasher) or [manually flashing](/docs/getting-started/flashing-firmware/esp32/cli-script) +This information will likely only be helpful if you've already attempted to go through the prerequisites and processes outlined in [manually flashing](/docs/getting-started/flashing-firmware/esp32/cli-script) ::: :::caution @@ -55,10 +55,7 @@ Disconnect your USB to Serial Adapter from the computer before starting this pro ### Flashing -After following the steps above, your device should be in flash mode. You can flash your device using the [Meshtastic flasher](/docs/software/python/flasher) or [manual method](/docs/getting-started/flashing-firmware/esp32/cli-script) - -Example using the Meshtastic Flasher -![image](https://user-images.githubusercontent.com/9000580/168447086-313e0649-1bfe-4ccb-b891-0f56059d8063.png) +After following the steps above, your device should be in flash mode. You can flash your device using the [manual method](/docs/getting-started/flashing-firmware/esp32/cli-script) After flashing the device is complete, reset your device (via the RST button if available). If you have the Meshtastic Python CLI installed, you can run `meshtastic --noproto` to connect the device again over the adapter and view the serial output to confirm Meshtastic installed correctly. diff --git a/docs/getting-started/flashing-firmware/esp32/python-flasher.mdx b/docs/getting-started/flashing-firmware/esp32/python-flasher.mdx deleted file mode 100644 index f9bee5dd..00000000 --- a/docs/getting-started/flashing-firmware/esp32/python-flasher.mdx +++ /dev/null @@ -1,11 +0,0 @@ ---- -id: python-flasher -title: Using Meshtastic Python Flasher -sidebar_label: Python Flasher -sidebar_position: 2 ---- - -import MFlasher from "../../../software/python-flasher.mdx"; -import Link from "@docusaurus/Link"; - - diff --git a/docs/getting-started/flashing-firmware/nrf52/python-flasher.mdx b/docs/getting-started/flashing-firmware/nrf52/python-flasher.mdx deleted file mode 100644 index 375a9872..00000000 --- a/docs/getting-started/flashing-firmware/nrf52/python-flasher.mdx +++ /dev/null @@ -1,11 +0,0 @@ ---- -id: python-flasher -title: Using Meshtastic Python Flasher -sidebar_label: Python Flasher -sidebar_position: 2 ---- - -import Link from "@docusaurus/Link"; -import MFlasher from "../../../software/python-flasher.mdx"; - - diff --git a/docs/software/python-flasher.mdx b/docs/software/python-flasher.mdx deleted file mode 100644 index 68a0ab99..00000000 --- a/docs/software/python-flasher.mdx +++ /dev/null @@ -1,218 +0,0 @@ ---- -id: flasher -title: Using Meshtastic Python Flasher -sidebar_label: Python Flasher -slug: /software/python/flasher -sidebar_position: 5 ---- - -import Tabs from "@theme/Tabs"; -import TabItem from "@theme/TabItem"; -import Link from "@docusaurus/Link"; - -:::caution -This method is no longer supported. Please use a [supported method](/docs/getting-started/flashing-firmware). -::: - -*** - -:::caution -Make sure not to power the radio on without first attaching the antenna! You could damage the radio chip! -::: - -## Overview - -Meshtastic Flasher (aka m-flasher) is a graphical user interface for flashing [supported devices](/docs/hardware) with Meshtastic. -The following operating systems are currently supported: Windows, Mac, and Ubuntu. - -## Prerequisites - -### Verify that Python3 is installed - - - - -```shell title="Check python3 version" -python3 --version -# If version is less than v3.6, please update python3 -``` - - - - -```shell title="Check python3 version" -python3 --version -# If version is less than v3.6, please update python3 -``` - - - - -```shell title="Check python3 version" -python3 --version -# If version is less than v3.9+, please update python3 -``` - - - - -### Install or Update Python3 - - - - -```shell title="Install python3, pip, and venv" -sudo apt update -sudo apt upgrade -sudo apt install -y python3 python3-pip python3-venv -``` - - - - -- [Download directly from python.org](https://www.python.org/downloads/macos/) -- [Homebrew](https://brew.sh/): `brew install python@3.9` -- [MacPorts](https://www.macports.org/) - - - - -- [Download directly from python.org](https://www.python.org/downloads/windows/) - - - - -### Install or Upgrade App - -For **Windows**, the [installer](https://github.com/meshtastic/Meshtastic-gui-installer/releases/download/winapp1.0.3/meshtastic-flasher.zip) will manage installing python and flasher updates automatically. - -For **macOS** and **Linux**, it is recommended that you install using `pip`. - -Note: Update an existing installation using `pip install meshtastic-flasher -U` - - - - -```shell title="Install Meshtastic Flasher" -python3 --version -# ensure you are using at least python v3.6 -# change to a directory where you want to create a python virtual environment -mkdir some_dir -cd some_dir -# if the following command fails, it might tell you what package to install -python3 -m venv venv -# activate the python virtual environment -source venv/bin/activate -# your prompt should change - it should include "(venv) in the front -# upgrade pip -pip install --upgrade pip -pip install meshtastic-flasher -``` - -```shell title="Running Meshtastic Flasher" -meshtastic-flasher -``` - - - - -```shell title="Install Meshtastic Flasher" -python3 --version -# ensure you are using at least python v3.6 -# change to a directory where you want to create a python virtual environment -mkdir some_dir -cd some_dir -python3 -m venv venv -# activate the python virtual environment -source venv/bin/activate -# your prompt should change - it should include "(venv) in the front -# upgrade pip -pip install --upgrade pip -pip install meshtastic-flasher -``` - -```shell title="Running Meshtastic Flasher" -meshtastic-flasher -``` - - - - -```shell title="Install Meshtastic Flasher" -# open a command prompt -# create a new directory for the python virtual environment -cd c:\ -mkdir some_dir -cd some_dir -# check that python version is sufficient, must be at least v3.9+ -python -m venv venv -# activate the python virtual environment -venv\Scripts\activate -# your prompt should change - it should have (venv) at the beginning -pip install meshtastic-flasher -``` - -```shell title="Running Meshtastic Flasher" -meshtastic-flasher -``` - - - - -## Flashing the Device - -The Meshtastic Flasher will flash the latest firmware on esp32 and nrf52 devices. This is a newly developed application (as of February 1, 2022), so there may be some issues discovered as it is tested by users. - -There are three steps: - -1. Click the **GET VERSIONS** button to get the versions available (from GitHub). -2. Click the **DETECT DEVICE** button to determine the port and device variant connected. -3. Click the **FLASH** button to flash the version selected using the port selected to the device. - -## Issues? - -If you run into an issue, please create a ticket here: [Flasher Issues](https://github.com/meshtastic/Meshtastic-gui-installer/issues) - -The code can be found at the [Meshtastic-gui-installer repo](https://github.com/meshtastic/Meshtastic-gui-installer) - -## Known limitations - -The following are known limitations: - -- Raspberry Pi is not available, since it is arm-based and there are no pre-built libraries for [PySide](https://wiki.qt.io/Qt_for_Python) -- Ubuntu 20.04 is the version used for testing, it may work with other versions. -- See [README](https://github.com/meshtastic/Meshtastic-gui-installer/blob/master/README.md) for more details. - -## Connect and Configure Device - -After flashing the Meshtastic firmware to the device, you can proceed with the initial configuration. - -
- - Connect and Configure Device - -
diff --git a/src/pages/index.tsx b/src/pages/index.tsx index bc8a7cfa..44e26c01 100644 --- a/src/pages/index.tsx +++ b/src/pages/index.tsx @@ -284,8 +284,8 @@ function Home() { style={{ display: "flex", justifyContent: "center" }} >

- The Meshtastic Flasher application can assist you in flashing - the firmware and configuring settings. + The Meshtastic Web-Based Flasher & Clients can assist you in + flashing the firmware and configuring settings.

From a951ef5e6decec888225f7b6f38ebce6315e7bf3 Mon Sep 17 00:00:00 2001 From: pdxlocations Date: Thu, 29 Jun 2023 22:03:11 -0700 Subject: [PATCH 07/19] missed one --- .../flashing-firmware/esp32/external-serial-adapter.mdx | 7 +------ 1 file changed, 1 insertion(+), 6 deletions(-) diff --git a/docs/getting-started/flashing-firmware/esp32/external-serial-adapter.mdx b/docs/getting-started/flashing-firmware/esp32/external-serial-adapter.mdx index 08d6b2b7..57c59a9d 100644 --- a/docs/getting-started/flashing-firmware/esp32/external-serial-adapter.mdx +++ b/docs/getting-started/flashing-firmware/esp32/external-serial-adapter.mdx @@ -63,14 +63,9 @@ If you have the Meshtastic Python CLI installed, you can run `meshtastic --nopro ### Troubleshooting -In the Meshtastic Flasher, device detection may not work when using the external USB to Serial adapter. You might need to manually select the correct device type from the drop-down. - -![image](https://user-images.githubusercontent.com/9000580/168447197-206f7e14-debe-4b6a-bb2a-7647418075e4.png) - -Sometimes you might receive an error for COM port permission in the Meshtastic Flasher or the manual device install scripts, this can be caused by a number of different issues. +You might receive an error for COM port permission in the manual device install scripts, this can be caused by a number of different issues. You might need to run the process as an administrator, check to ensure software like Cura isn't monopolizing COM ports, or reboot. -![image](https://user-images.githubusercontent.com/9000580/168447232-1a3af39b-e3cc-44b9-bc3a-32843a9e6f1f.png) ## Connect and Configure Device From 0d2abb911d0d6167cf2bc424437d50ab69c6c390 Mon Sep 17 00:00:00 2001 From: Ben Meadors Date: Fri, 30 Jun 2023 14:30:56 -0500 Subject: [PATCH 08/19] Incorrect command --- docs/configuration/module-config/canned-message.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/configuration/module-config/canned-message.mdx b/docs/configuration/module-config/canned-message.mdx index 811c65c6..a040d13f 100644 --- a/docs/configuration/module-config/canned-message.mdx +++ b/docs/configuration/module-config/canned-message.mdx @@ -146,7 +146,7 @@ meshtastic --set canned_message.send_bell false ``` ```shell title="Set Messages" -meshtastic --set canned_message.messages "I need an alpinist!|Call Me|Roger Roger|Keep Calm|On my way" +meshtastic --set-canned-message "I need an alpinist!|Call Me|Roger Roger|Keep Calm|On my way" ``` ```shell title="Set Input Source" From 489c4fff115de5e5a40e4224650f1749f0ddf2e9 Mon Sep 17 00:00:00 2001 From: pdxlocations Date: Fri, 30 Jun 2023 21:44:39 -0700 Subject: [PATCH 09/19] Reformat nRF52 drivers documentation --- docs/getting-started/index.mdx | 2 +- .../serial-drivers/serial-drivers-nrf52.mdx | 22 ++++++++++++++----- 2 files changed, 18 insertions(+), 6 deletions(-) diff --git a/docs/getting-started/index.mdx b/docs/getting-started/index.mdx index 1caaa3e3..8676f0ab 100644 --- a/docs/getting-started/index.mdx +++ b/docs/getting-started/index.mdx @@ -59,7 +59,7 @@ Some cables only provide _charging_, verify that your cable is also capable of _ :::caution -With the latest versions of MacOS, USB Serial drivers are built-in. Do _NOT_ download the USB device drivers unless required. You may [test for installed serial drivers](/docs/getting-started/serial-drivers/test-serial-driver-installation) before continuing. +nRF52 devices typically do not require serial drivers. They use the UF2 bootloader which make the devices appear as flash drives. Do _NOT_ download the USB device drivers unless required. You may [test for installed serial drivers](/docs/getting-started/serial-drivers/test-serial-driver-installation) before continuing. ::: diff --git a/docs/getting-started/serial-drivers/serial-drivers-nrf52.mdx b/docs/getting-started/serial-drivers/serial-drivers-nrf52.mdx index 52ec415b..ce948445 100644 --- a/docs/getting-started/serial-drivers/serial-drivers-nrf52.mdx +++ b/docs/getting-started/serial-drivers/serial-drivers-nrf52.mdx @@ -11,6 +11,12 @@ import Link from "@docusaurus/Link"; ## Install nRF52 USB to Serial Drivers +:::caution + +nRF52 devices typically do not require serial drivers. They use the UF2 bootloader which make the devices appear as flash drives. Do _NOT_ download the USB device drivers unless required. + +::: + -- [CH9102 Driver - Linux Download](http://www.wch-ic.com/downloads/CH341SER_LINUX_ZIP.html) +- [CH34x Driver - Linux Download](http://www.wch-ic.com/downloads/CH341SER_LINUX_ZIP.html) -- [CH9102 Driver - macOS Download](https://github.com/WCHSoftGroup/ch34xser_macos) -:::caution +:::info -With the latest versions of MacOS, the USB Serial driver is built-in. Do _NOT_ download the USB device drivers unless required. If you downloaded/installed any already, please remove them. +With the latest versions of MacOS, the USB Serial driver is built-in. If you downloaded/installed any already, please remove them. ::: @@ -47,11 +52,18 @@ Uninstall the kernel extension: 3. `sudo rm -rf /Library/Extensions/usbserial.kext` 4. Reboot + +### Install the CH34x Driver + +- [CH34x Driver- macOS Download](https://github.com/WCHSoftGroup/ch34xser_macos) + + + -- [CH9102 Driver - Windows Download](http://www.wch-ic.com/downloads/CH341SER_EXE.html) +- [CH34x Driver - Windows Download](http://www.wch-ic.com/downloads/CH341SER_EXE.html) From 2a9ed852e013cbe3b0b43e8126a19c3733088b3b Mon Sep 17 00:00:00 2001 From: pdxlocations Date: Fri, 30 Jun 2023 22:06:02 -0700 Subject: [PATCH 10/19] clarify nRF drivers use case --- docs/getting-started/index.mdx | 2 +- docs/getting-started/serial-drivers/serial-drivers-nrf52.mdx | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/getting-started/index.mdx b/docs/getting-started/index.mdx index 8676f0ab..77e7c7fb 100644 --- a/docs/getting-started/index.mdx +++ b/docs/getting-started/index.mdx @@ -59,7 +59,7 @@ Some cables only provide _charging_, verify that your cable is also capable of _ :::caution -nRF52 devices typically do not require serial drivers. They use the UF2 bootloader which make the devices appear as flash drives. Do _NOT_ download the USB device drivers unless required. You may [test for installed serial drivers](/docs/getting-started/serial-drivers/test-serial-driver-installation) before continuing. +nRF52 devices typically do not require serial drivers. They use the UF2 bootloader which makes the devices appear as flash drives. Do _NOT_ download the USB device drivers unless required to install UF2 support. ::: diff --git a/docs/getting-started/serial-drivers/serial-drivers-nrf52.mdx b/docs/getting-started/serial-drivers/serial-drivers-nrf52.mdx index ce948445..fd85b48a 100644 --- a/docs/getting-started/serial-drivers/serial-drivers-nrf52.mdx +++ b/docs/getting-started/serial-drivers/serial-drivers-nrf52.mdx @@ -13,7 +13,7 @@ import Link from "@docusaurus/Link"; :::caution -nRF52 devices typically do not require serial drivers. They use the UF2 bootloader which make the devices appear as flash drives. Do _NOT_ download the USB device drivers unless required. +nRF52 devices typically do not require serial drivers. They use the UF2 bootloader which makes the devices appear as flash drives. Do _NOT_ download the USB device drivers unless required to install UF2 support. ::: From f617433eb93e958666cf61299176633f5745c030 Mon Sep 17 00:00:00 2001 From: pdxlocations Date: Fri, 30 Jun 2023 22:18:49 -0700 Subject: [PATCH 11/19] add references to factory erase and convert --- docs/getting-started/flashing-firmware/nrf52/index.mdx | 9 ++++++++- 1 file changed, 8 insertions(+), 1 deletion(-) diff --git a/docs/getting-started/flashing-firmware/nrf52/index.mdx b/docs/getting-started/flashing-firmware/nrf52/index.mdx index 837c5095..fc27d190 100644 --- a/docs/getting-started/flashing-firmware/nrf52/index.mdx +++ b/docs/getting-started/flashing-firmware/nrf52/index.mdx @@ -9,4 +9,11 @@ sidebar_position: 2 The nRF52 based devices have the easiest firmware upgrade process. No driver or software install is required on any platform. -1. The [Drag & Drop](/docs/getting-started/flashing-firmware/nrf52/drag-n-drop) firmware installation method is considered the "manual process" and recommended as the easiest solution. +### Drag & Drop +The [Drag & Drop](/docs/getting-started/flashing-firmware/nrf52/drag-n-drop) firmware installation method is considered the "manual process" and recommended as the easiest solution. + +### Factory Erase +You may wish to perform a [Factory Erase](/docs/getting-started/flashing-firmware/nrf52/nrf52-erase) prior to installing firmware to clear data that may change format and location between releases. + +### Convert RAK4631-R to RAK4631 +If your device did not come with the Arduino bootloader you will need to [perform the conversion](/docs/getting-started/flashing-firmware/nrf52/convert-rak4631r) \ No newline at end of file From 4f3e6a4562c1fbf7b0c9432a94328acda8425066 Mon Sep 17 00:00:00 2001 From: pdxlocations Date: Fri, 30 Jun 2023 22:19:30 -0700 Subject: [PATCH 12/19] add missing period --- docs/getting-started/flashing-firmware/nrf52/index.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/getting-started/flashing-firmware/nrf52/index.mdx b/docs/getting-started/flashing-firmware/nrf52/index.mdx index fc27d190..32f05c1e 100644 --- a/docs/getting-started/flashing-firmware/nrf52/index.mdx +++ b/docs/getting-started/flashing-firmware/nrf52/index.mdx @@ -16,4 +16,4 @@ The [Drag & Drop](/docs/getting-started/flashing-firmware/nrf52/drag-n-drop) fir You may wish to perform a [Factory Erase](/docs/getting-started/flashing-firmware/nrf52/nrf52-erase) prior to installing firmware to clear data that may change format and location between releases. ### Convert RAK4631-R to RAK4631 -If your device did not come with the Arduino bootloader you will need to [perform the conversion](/docs/getting-started/flashing-firmware/nrf52/convert-rak4631r) \ No newline at end of file +If your device did not come with the Arduino bootloader you will need to [perform the conversion](/docs/getting-started/flashing-firmware/nrf52/convert-rak4631r). \ No newline at end of file From d70bf8ab6e65eaf9a0cd8dd39d260209df28ebea Mon Sep 17 00:00:00 2001 From: pdxlocations Date: Fri, 30 Jun 2023 22:27:00 -0700 Subject: [PATCH 13/19] only one option to update firmware --- docs/getting-started/flashing-firmware/nrf52/index.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/getting-started/flashing-firmware/nrf52/index.mdx b/docs/getting-started/flashing-firmware/nrf52/index.mdx index 32f05c1e..e9ecd803 100644 --- a/docs/getting-started/flashing-firmware/nrf52/index.mdx +++ b/docs/getting-started/flashing-firmware/nrf52/index.mdx @@ -10,7 +10,7 @@ sidebar_position: 2 The nRF52 based devices have the easiest firmware upgrade process. No driver or software install is required on any platform. ### Drag & Drop -The [Drag & Drop](/docs/getting-started/flashing-firmware/nrf52/drag-n-drop) firmware installation method is considered the "manual process" and recommended as the easiest solution. +nRF52 devices use the [Drag & Drop](/docs/getting-started/flashing-firmware/nrf52/drag-n-drop) installation method to install firmware releases. ### Factory Erase You may wish to perform a [Factory Erase](/docs/getting-started/flashing-firmware/nrf52/nrf52-erase) prior to installing firmware to clear data that may change format and location between releases. From ff7da1168ca94aed85c802985f7863d01650c135 Mon Sep 17 00:00:00 2001 From: pdxlocations Date: Mon, 3 Jul 2023 22:25:02 -0700 Subject: [PATCH 14/19] fix typo --- docs/configuration/device-config/display.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/configuration/device-config/display.mdx b/docs/configuration/device-config/display.mdx index a05dfbfa..ea93e595 100644 --- a/docs/configuration/device-config/display.mdx +++ b/docs/configuration/device-config/display.mdx @@ -18,7 +18,7 @@ How long the screen remains on after the user button is pressed or messages are ### Auto Carousel Interval -Automatically toggles to the next page on the screen like a carousel, based the specified interval. +Automatically toggles to the next page on the screen like a carousel, based on the specified interval. ### Always Point North From 35450ba8f8660120e77827398900ef7c3bdd7dc7 Mon Sep 17 00:00:00 2001 From: pdxlocations Date: Mon, 3 Jul 2023 22:28:03 -0700 Subject: [PATCH 15/19] fix display modes --- docs/configuration/device-config/display.mdx | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/configuration/device-config/display.mdx b/docs/configuration/device-config/display.mdx index ea93e595..cc512ac9 100644 --- a/docs/configuration/device-config/display.mdx +++ b/docs/configuration/device-config/display.mdx @@ -62,7 +62,7 @@ Acceptable values: ### Display Mode -The display mode can be set to `NORMAL` (default), `TWOCOLOR` or `INVERTED`. The `TWOCOLOR` mode is intended for OLED displays with the first line of output being a different color than the rest of the display. The `INVERTED` mode will invert that bicolor area, resulting in a white background headline on monochrome displays. +The display mode can be set to `DEFAULT` (default), `TWOCOLOR`, `INVERTED` or `COLOR`. The `TWOCOLOR` mode is intended for OLED displays with the first line of output being a different color than the rest of the display. The `INVERTED` mode will invert that bicolor area, resulting in a white background headline on monochrome displays. ### Heading Bold @@ -119,7 +119,7 @@ All display config options are available in the python CLI. Example commands are | display.oled | `OLED_AUTO`, `OLED_SSD1306`, `OLED_SH1106`, `OLED_SH1107` | `OLED_AUTO` | | display.screen_on_secs | `integer` | Default of `0` is 10 minutes. | | display.units | `METRIC`, `IMPERIAL` | `METRIC` | -| display.displaymode | `NORMAL`, `TWOCOLOR`, `INVERTED` | `NORMAL` | +| display.displaymode | `DEFAULT`, `TWOCOLOR`, `INVERTED`, `COLOR` | `DEFAULT` | | display.heading_bold | `false`, `true` | `false` | | display.wake_on_tap_or_motion | `false`, `true` | `false` | From 2b170a49676cb42ad71c7f63e9b0d7518842341f Mon Sep 17 00:00:00 2001 From: pdxlocations Date: Mon, 3 Jul 2023 22:43:35 -0700 Subject: [PATCH 16/19] fix typo --- docs/configuration/device-config/display.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/configuration/device-config/display.mdx b/docs/configuration/device-config/display.mdx index cc512ac9..7effe1c6 100644 --- a/docs/configuration/device-config/display.mdx +++ b/docs/configuration/device-config/display.mdx @@ -39,7 +39,7 @@ Acceptable values: | `OLC` | Open Location Code (Plus Codes) | | `OSGR` | Ordnance Survey Grid Reference | -### Prefered display units +### Preferred display units switch between `METRIC` (default) and `IMPERIAL` units From 06b348fd369cc663f86ea7063d4af7eebaab3641 Mon Sep 17 00:00:00 2001 From: pdxlocations Date: Mon, 3 Jul 2023 22:48:15 -0700 Subject: [PATCH 17/19] fix typo, caps heading, add options to summary --- docs/configuration/device-config/display.mdx | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/configuration/device-config/display.mdx b/docs/configuration/device-config/display.mdx index 7effe1c6..6c11eb90 100644 --- a/docs/configuration/device-config/display.mdx +++ b/docs/configuration/device-config/display.mdx @@ -8,7 +8,7 @@ sidebar_label: Display import Tabs from "@theme/Tabs"; import TabItem from "@theme/TabItem"; -The display config options are: Screen On Duration, Auto Carousel Interval, Always Point North and GPS Format. Display config uses an admin message sending a `Config.Display` protobuf. +The display config options are: Screen On Duration, Auto Carousel Interval, Always Point North, GPS Format, Preferred Display Units, OLED Definition, Display Mode, Heading Bold, and Wake on Tap or Motion. Display config uses an admin message sending a `Config.Display` protobuf. ## Device Config Values @@ -39,7 +39,7 @@ Acceptable values: | `OLC` | Open Location Code (Plus Codes) | | `OSGR` | Ordnance Survey Grid Reference | -### Preferred display units +### Preferred Display Units switch between `METRIC` (default) and `IMPERIAL` units @@ -47,7 +47,7 @@ switch between `METRIC` (default) and `IMPERIAL` units If enabled, the screen will be rotated 180 degrees, for cases that mount the screen upside down -### OLED Defintion +### OLED Definition The type of OLED Controller is auto-detected by default, but can be defined with this setting if the auto-detection fails. For the SH1107, we assume a square display with 128x128 Pixels like the GME128128-1. From 1459f554a42329d13ea4a0896b948368ad518201 Mon Sep 17 00:00:00 2001 From: pdxlocations Date: Mon, 3 Jul 2023 22:51:32 -0700 Subject: [PATCH 18/19] Capital beginning sentence --- docs/configuration/device-config/display.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/configuration/device-config/display.mdx b/docs/configuration/device-config/display.mdx index 6c11eb90..f3c42bc8 100644 --- a/docs/configuration/device-config/display.mdx +++ b/docs/configuration/device-config/display.mdx @@ -41,7 +41,7 @@ Acceptable values: ### Preferred Display Units -switch between `METRIC` (default) and `IMPERIAL` units +Switch between `METRIC` (default) and `IMPERIAL` units ### Flip Screen From 21c2f06acc40805fb982960a3c2dd027c8d54e42 Mon Sep 17 00:00:00 2001 From: pdxlocations Date: Mon, 3 Jul 2023 22:58:38 -0700 Subject: [PATCH 19/19] fix typo --- docs/configuration/device-config/display.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/configuration/device-config/display.mdx b/docs/configuration/device-config/display.mdx index f3c42bc8..68a06058 100644 --- a/docs/configuration/device-config/display.mdx +++ b/docs/configuration/device-config/display.mdx @@ -114,7 +114,7 @@ All display config options are available in the python CLI. Example commands are | --------------------------------- | --------------------------------------------------------- | ----------------------------- | | display.auto_screen_carousel_secs | `integer` | Default of `0` is off. | | display.compass_north_top | `false`, `true` | `false` | -| display.flip_screen | `fasle`, `true` | `false` | +| display.flip_screen | `false`, `true` | `false` | | display.gps_format | `DEC`, `DMS`, `UTM`, `MGRS`, `OLC`, `OSGR` | `DEC` | | display.oled | `OLED_AUTO`, `OLED_SSD1306`, `OLED_SH1106`, `OLED_SH1107` | `OLED_AUTO` | | display.screen_on_secs | `integer` | Default of `0` is 10 minutes. |