update android docs

This commit is contained in:
andrekir 2021-12-18 00:52:54 -03:00
parent 1aa0b43f09
commit 7fdf908bb9
5 changed files with 38 additions and 18 deletions

View file

@ -18,6 +18,10 @@ You will need a device with Meshtastic installed to go any further. See the [get
Open the Settings tab (last tab), and it should look similar to the screen below. It shows any Meshtastic devices that are found over Bluetooth.
:::note
Android requires location permission granted and location must be turned on to find new devices via bluetooth. You can turn it off again afterwards.
:::
[![Device available to select](/img/android/android-settings-deselected-c.png)](/img/android/android-settings-deselected.png)
1. Select the Device by name, "Meshtastic_c830" in the example below. (You will see any active devices within range, so make sure to get the right one.)
@ -68,25 +72,39 @@ The app will generate a new QR code on the screen, and this encodes the channel
### Join a channel
If another user shares a QR code, you should be able to scan it with your camera (phones with Android 9 or later will recognise QR codes).
If another user shares a QR code, you will be able to scan it with your camera. If the channel is shared as a file or link via the Share button, you can click on the file or link and follow similar steps.
1. You will see a message like Tap here to go to "www.meshtastic.org" in your browser.
2. Proceed and it will launch the Meshtastic app, and you should see a message like "Do you want to switch to the 'Owl Team' channel?".
3. Accept this, and the app will change to this new channel. You will lose any current channel setting!
You should see a message with the option "open with Meshtastic".
[![Open with Meshtastic](/img/android/android-open-with-c.png)](/img/android/android-open-with.png)
<details>
<summary>Troubleshooting: Can't "open with Meshtastic".</summary>
<div>
<div>
If you don't see "Meshtastic" as an option to open the file or link with:
<br />
<br />
1. Go to Android Settings > Apps > Default apps > Meshtastic > Opening links<br />
<br />
[![Links1](/img/android/android-open-links-sm1.png)](/img/android/android-open-links-sm1.png) [![Links2](/img/android/android-open-links-sm2.png)](/img/android/android-open-links-sm1.png)
<br />
2. Make sure you have in "links/web address": www.meshtastic.org/>
3. If you see the option "Open the supported links" make sure it is enabled.<br />
4. Try again!
</div>
</div>
</details>
Proceed and you should see a message like "Do you want to switch to the 'Owl Team' channel?".
Accept this, and the app will change to this new channel. You will lose any current channel setting!
[![Accept new channel](/img/android/android-accept-channel-c.png)](/img/android/android-accept-channel.png)
If the channel is shared as a link via a message, or email, you can click on the link and follow similar steps.
:::note
You must use a link or a QR Code to Join a Channel. Setting the Channel Settings to the same Name and Options will not work as there is also a shared key encoded in the link.
Setting the same Name and Options will not work as there is also a unique pre-shared key encoded in the channel.
:::
:::note
Your app must be connected to an active Meshtastic device for the link or QR Code to work.
:::
You can test changing channels with the QR code shown below.
![Meshtastic Default Channel](/img/android/default-channel.png)
@ -96,11 +114,13 @@ You can test changing channels with the QR code shown below.
Various data-rates are selectable when configuring a channel and are inversely proportional to the theoretical range of the devices:
| Channel setting | Data-rate |
|----------------------------|----------------------|
| Short range (but fast) | 21.875 kbps |
| Medium range (but fast) | 5.469 kbps |
| Long range (but slower) | 0.275 kbps |
| Very long range (but slow) | 0.183 kbps (default) |
|------------------------|----------------------|
| Short Range / Fast) | 19346.94 bps |
| Short Range / Slow) | 4800.00 bps |
| Medium Range / Fast) | 1227.18 bps |
| Medium Range / Slow) | 763.29 bps |
| Long Range / Fast) | 196.74 bps |
| long Range / Slow) | 136.71 bps (default) |
### Send a message

Binary file not shown.

After

Width:  |  Height:  |  Size: 12 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 10 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 22 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 85 KiB