From c10a7f3f7d589319c4facd3431aed13472c57ec2 Mon Sep 17 00:00:00 2001 From: rcarteraz Date: Mon, 12 Dec 2022 21:37:18 -0700 Subject: [PATCH 1/4] updates to overview, android and apple sections --- docs/about/faq.mdx | 40 ++++++++++++++++++++++++++-------------- 1 file changed, 26 insertions(+), 14 deletions(-) diff --git a/docs/about/faq.mdx b/docs/about/faq.mdx index ec633739..1d967a4f 100644 --- a/docs/about/faq.mdx +++ b/docs/about/faq.mdx @@ -13,7 +13,7 @@ This site (which has a great search function) is the preferred place for up-to-d ### How can I contribute to Meshtastic? -Everyone contributes in a different way. Join the [Meshtastic Discord](https://discord.gg/ktMAKGBnBs) and introduce yourself. We're all very friendly. If you'd like to pitch in some code, check out the [Developers](/docs/developers) menu on the left. +Everyone contributes in a different way. Join the [Meshtastic Discord](https://discord.gg/ktMAKGBnBs) and introduce yourself. We're all very friendly. If you'd like to pitch in some code, check out the [Development](/docs/developers) menu on the left. @@ -21,34 +21,46 @@ Everyone contributes in a different way. Join the [Meshtastic Discord](https://d ### What versions of Android does the Meshtastic Android App require? -Minimum requirement is Android 5 (Lollipop 2014, first BLE support), however Android 6 (Marshmallow 2015) is recommended as Bluetooth is more stable. +Minimum requirement is Android 5 (Lollipop 2014, first BLE support), however at least Android 6 (Marshmallow 2015) is recommended as Bluetooth is more stable. While Android 5/6 are officially supported by Meshtastic, it is *not* recommended that you purchase devices with these versions due to their limited OS support and limited battery life due to age. Many newer models exist that are very affordable. A good resource to use when researching affordable devices is the [LineageOS Supported Devices List](https://wiki.lineageos.org/devices/). + +### Is location access required to use the Meshtastic App? + +Depending on which version of Android your device runs, you may have to enable location access to pair via Bluetooth. For Android 8+ we use [this API](https://developer.android.com/guide/topics/connectivity/companion-device-pairing) that does not require location access. However, each OS implements BLE differently and we have noticed some devices still require location access to scan for Bluetooth devices. ### What's the cloud icon next to the message? -- Empty Cloud - Queued on the app to be sent to your device. -- Up Arrow - Queued on the device to be sent over the mesh. -- Check Mark - At least one other device on the mesh confirmed it received the message. -- Cross Mark - No confirmation was received after the default three retransmissions. +- Empty Cloud - Queued on the device to be sent over the mesh. +- Up Arrow - Queued on the app to be sent to your device. +- Check Mark - At least one other node on the mesh acknowledged the message. +- Cross Mark - Not acknowledged or message error. ### How can I clear the message history? Long press any message to select and show the menu with "delete" and "select all" buttons. - +### After updating firmware, my node is not connecting via Bluetooth. What should I do? -## iOS Client +Try forgetting the Bluetooth connection from the Android Bluetooth Settings menu. Re-pair and try again. -### What version of iOS does the Meshtastic iOS App Require? + -The iOS app requires iOS v16. +## Apple Clients -### How do I get the Meshtastic iOS App? +### What version of iOS/iPadOS/macOS does the Meshtastic App Require? -See [iOS App](/docs/software/apple/installation) +The Meshtastic App on Apple Clients require the following minimum OS versions: iOS 16, iPadOS 16, and macOS 13. + +### How do I get the Apple Meshtastic App? + +See [Apple Apps](/docs/software/apple/installation) ### After updating firmware, my node is not connecting via Bluetooth. What should I do? -Try forgetting the Bluetooth connection from the iOS System Settings. Re-pair and try again. +Try forgetting the Bluetooth connection from the iOS/iPadOS/macOS System Settings. Re-pair and try again. + +### Do the Apple applications provide an indication if the message was acknowledged on the mesh? + +Yes, when the message is sent you will first see a `Waiting to be acknowledged...` status beneath the message. If the message is acknowledged by a node on the mesh this will update to `Acknowledged`, but if no nodes have responded it will indicate `Max Retransmission Reached`. If there is an error, the status will update to the appropriate error. Additionally, you can long press on the message and select `Message Details` to view the date/time sent, if ack was received and the time ack was received or the error (if there was one). @@ -70,7 +82,7 @@ Note: Currently only Chrome and Chromium based browsers offer reliable support f ### How do I share my Meshtastic Channel with other people? -Your Meshtastic client (Android, Web, or Python) will provide you a URL or QR code. You can email, text or print this URL or QR code and share it with people you want to join your Meshtastic Channel. Note: This feature is not yet available on the iOS app. +Your Meshtastic client (Android, Apple, Web, or Python) will provide you a URL or QR code. You can email, text or print this URL or QR code and share it with people you want to join your Meshtastic Channel. From f08309caf0bf717a0a5ddbee1db3b26df5ee649d Mon Sep 17 00:00:00 2001 From: rcarteraz Date: Mon, 12 Dec 2022 22:33:47 -0700 Subject: [PATCH 2/4] updating pairing wording --- docs/about/faq.mdx | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/about/faq.mdx b/docs/about/faq.mdx index 1d967a4f..1c9bca7f 100644 --- a/docs/about/faq.mdx +++ b/docs/about/faq.mdx @@ -38,9 +38,9 @@ Depending on which version of Android your device runs, you may have to enable l Long press any message to select and show the menu with "delete" and "select all" buttons. -### After updating firmware, my node is not connecting via Bluetooth. What should I do? +### After a fresh firmware install, my node is not connecting via Bluetooth. What should I do? -Try forgetting the Bluetooth connection from the Android Bluetooth Settings menu. Re-pair and try again. +Try forgetting the Bluetooth connection from the Android Bluetooth Settings menu. Re-pair and try again. This is a security measure and there is no workaround for it. It prevents apps and other accessories from spoofing an existing accessory by un-pairing and "re-pairing" themselves without the users' knowledge. @@ -54,9 +54,9 @@ The Meshtastic App on Apple Clients require the following minimum OS versions: i See [Apple Apps](/docs/software/apple/installation) -### After updating firmware, my node is not connecting via Bluetooth. What should I do? +### After a fresh firmware install, my node is not connecting via Bluetooth. What should I do? -Try forgetting the Bluetooth connection from the iOS/iPadOS/macOS System Settings. Re-pair and try again. +Try forgetting the Bluetooth connection from the iOS/iPadOS/macOS System Settings. Re-pair and try again. This is a security measure and there is no workaround for it. It prevents apps and other accessories from spoofing an existing accessory by un-pairing and "re-pairing" themselves without the users' knowledge. ### Do the Apple applications provide an indication if the message was acknowledged on the mesh? From 60de97abd61f7f45ff119cd8986685af1b949465 Mon Sep 17 00:00:00 2001 From: rcarteraz Date: Wed, 14 Dec 2022 20:13:56 -0700 Subject: [PATCH 3/4] remove web client for now --- docs/about/faq.mdx | 14 -------------- 1 file changed, 14 deletions(-) diff --git a/docs/about/faq.mdx b/docs/about/faq.mdx index 1c9bca7f..5c7b17a7 100644 --- a/docs/about/faq.mdx +++ b/docs/about/faq.mdx @@ -62,20 +62,6 @@ Try forgetting the Bluetooth connection from the iOS/iPadOS/macOS System Setting Yes, when the message is sent you will first see a `Waiting to be acknowledged...` status beneath the message. If the message is acknowledged by a node on the mesh this will update to `Acknowledged`, but if no nodes have responded it will indicate `Max Retransmission Reached`. If there is an error, the status will update to the appropriate error. Additionally, you can long press on the message and select `Message Details` to view the date/time sent, if ack was received and the time ack was received or the error (if there was one). - - -## Web Client - -### How do I access the network from my web browser? - -Visit http://meshtastic.local (Note: This is a work in progress.) - -### I've Flashed my device but I can't access the Web UI - -Ensure you have used the included `device-install` script to flash your device, and that the file `spiffs-*.bin` is present in the same folder as your firmware at the time of flashing. - -Note: Currently only Chrome and Chromium based browsers offer reliable support for the Web UI. - ## Channels From bd876f4fc79ee50abcc8041827983e9eee02ea82 Mon Sep 17 00:00:00 2001 From: rcarteraz Date: Wed, 14 Dec 2022 20:48:06 -0700 Subject: [PATCH 4/4] remove section --- docs/about/faq.mdx | 6 +----- 1 file changed, 1 insertion(+), 5 deletions(-) diff --git a/docs/about/faq.mdx b/docs/about/faq.mdx index 5c7b17a7..45c732ef 100644 --- a/docs/about/faq.mdx +++ b/docs/about/faq.mdx @@ -23,11 +23,7 @@ Everyone contributes in a different way. Join the [Meshtastic Discord](https://d Minimum requirement is Android 5 (Lollipop 2014, first BLE support), however at least Android 6 (Marshmallow 2015) is recommended as Bluetooth is more stable. While Android 5/6 are officially supported by Meshtastic, it is *not* recommended that you purchase devices with these versions due to their limited OS support and limited battery life due to age. Many newer models exist that are very affordable. A good resource to use when researching affordable devices is the [LineageOS Supported Devices List](https://wiki.lineageos.org/devices/). -### Is location access required to use the Meshtastic App? - -Depending on which version of Android your device runs, you may have to enable location access to pair via Bluetooth. For Android 8+ we use [this API](https://developer.android.com/guide/topics/connectivity/companion-device-pairing) that does not require location access. However, each OS implements BLE differently and we have noticed some devices still require location access to scan for Bluetooth devices. - -### What's the cloud icon next to the message? +### What is the cloud icon next to the message? - Empty Cloud - Queued on the device to be sent over the mesh. - Up Arrow - Queued on the app to be sent to your device.