Merge branch 'master' into tips-and-tricks

This commit is contained in:
rcarteraz 2023-09-25 14:57:04 -07:00 committed by GitHub
commit 2b5ec15b80
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
5 changed files with 68 additions and 23 deletions

View file

@ -17,7 +17,7 @@ Download and unzip the latest firmware from [Meshtastic Downloads](https://mesht
2. Double click the reset button on your device (this will put it into bootloader mode)
3. Notice a new drive will be mounted on your computer (Windows, Mac, or Linux)
4. Open this drive and you should see three files: `CURRENT.UF2`, `INDEX.HTM`, and `INFO_UF2.TXT`
5. Drop the appropriate firmware file (`firmware-DEVICE_NAME-vx.x.x-xxxxxxx.uf2`) from the release onto this drive.
5. Drop the appropriate firmware file (`firmware-DEVICE_NAME-x.x.x-xxxxxxx.uf2`) from the release onto this drive.
Once the file has finished copying onto the drive, the device will reboot and install the Meshtastic firmware.

View file

@ -34,7 +34,7 @@ values={[
- [Android App](/docs/category/android-app)
- [Web Client](https://client.meshtastic.org)
- [iOS App](/docs/category/apple-apps)
- [iOS/iPadOS/macOS App](/docs/category/apple-apps)
</TabItem>
<TabItem value="network">

View file

@ -82,23 +82,11 @@ The app will generate a new QR code on the screen. This encodes the channel det
2. If the channel is shared from a file or link using the `Share` button, you can click on the file or link and you need to choose "Open with Meshtastic".
<details>
<summary>Troubleshooting shared links: 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 />
1. Go to Android Settings > Apps > Default apps > Meshtastic > Opening
links
<br />
2. Make sure you have in "links/web address": www.meshtastic.org
<br />
3. If you see the option "Open the supported links", make sure it is
enabled.
<br />
</div>
</div>
</details>
:::info If a QR or URL opens a webpage instead of the APP or "Open with Meshtastic" is not an option:
1. Go to Android Settings > Apps > Default apps > Meshtastic > Opening links
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.
:::
[![Accept new channel](/img/android/android-accept-channel-c.png)](/img/android/android-accept-channel.png)

View file

@ -206,13 +206,13 @@ Always Check Configuration before reloading YAML or restarting Home Assistant to
Create a new Entities Card and select the entities you have created.
[<img src="/img/software/mqtt/ha_entities_card.png" style={{zoom: '40%'}} />](/img/software/mqtt/ha_entities_card.png)
![HA Entities Card](/img/software/mqtt/ha_entities_card.png)
### Logbook Card for Messaging
The logbook card is useful to keep a record of incoming messages from the mesh. Below is an example of how the logbook card would be set up.
[<img src="/img/software/mqtt/ha_logbook_card.png" style={{zoom: '40%'}} />](/img/software/mqtt/ha_logbook_card.png)
![HA Logbook Card](/img/software/mqtt/ha_logbook_card.png)
## Trigger HA Automations
@ -223,7 +223,7 @@ It is possible to have Home Assistant trigger automations based on messages or e
This example waits for a message containing @Tropho and then sends a pop-up notification to his flip phone with the message. Optionally you can have ALL messages from the mesh sent as HA notifications to your phone.
[<img src="/img/software/mqtt/ha_at_tropho.png" style={{zoom: '50%'}} />](/img/software/mqtt/ha_at_tropho.png)
![HA At Tropho Message](/img/software/mqtt/ha_at_tropho.png)
Add the following code to your automations.yaml file. Be sure to modify the `topic`, `regex_search`, and `service` for your configuration.
```yaml
@ -253,4 +253,61 @@ Add the following code to your automations.yaml file. Be sure to modify the `to
mode: single
```
This same type of automation is very useful to trigger other actions in Home Assistant. For example, you could turn on a fan when the temperature reaches a certain value, or a play a sound on a speaker when a new message is received.
This same type of automation is very useful to trigger other actions in Home Assistant. For example, you could turn on a fan when the temperature reaches a certain value, or a play a sound on a speaker when a new message is received.
## Create a Send Message Entity
It is possible to create an input text box to send messages to your mesh from within Home Assistant.
### Input Text Helper Entity
First, create an input text helper entity. The preferred way to configure an input text is via the HA interface at Settings > Devices & Services > Helpers. Click the add button and then choose the Text option. Make a text input helper with a max length of 190 to be on the safe side. See example below:
![HA Input Text Helper](/img/software/mqtt/ha_input_text_helper.png)
### Create a Send Message Automation
This automation will check the send box for changes. After typing a message, either hit enter or click off the box and the automation will send a text string in JSON to the mqtt broker. Make sure to update the channel name and device ID in the example below.
```yaml
- alias: Meshtastic - Send Automation
description: ""
trigger:
- platform: state
entity_id:
- input_text.meshtastic_send_box
condition: []
action:
- delay:
hours: 0
minutes: 0
seconds: 1
milliseconds: 0
- service: mqtt.publish
data:
qos: 0
retain: false
topic: msh/2/json/LongFast/!67ea9400
payload: >-
{"channel":"0","sender":"broker","type":"sendtext","payload":"{{
states('input_text.meshtastic_send_box') }}"}
- delay:
hours: 0
minutes: 0
seconds: 1
milliseconds: 0
- service: input_text.set_value
data:
value: " "
target:
entity_id: input_text.meshtastic_send_box
- delay:
hours: 0
minutes: 0
seconds: 2
milliseconds: 0
mode: single
```
Add this card to your dashboard by going to Edit Dashboard -> + ADD CARD. Then search BY ENTITY for Meshtastic Send Box and check the box next to the entry. Click CONTINUE, then ADD TO DASHBOARD.

Binary file not shown.

After

Width:  |  Height:  |  Size: 61 KiB