mirror of
https://github.com/meshtastic/meshtastic.git
synced 2025-02-21 03:25:51 -08:00
Merge branch 'master' into tips-and-tricks
This commit is contained in:
commit
2b5ec15b80
|
@ -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.
|
||||
|
||||
|
|
|
@ -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">
|
||||
|
|
|
@ -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.
|
||||
:::
|
||||
|
||||
[](/img/android/android-accept-channel.png)
|
||||
|
||||
|
|
|
@ -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)
|
||||

|
||||
|
||||
### 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)
|
||||

|
||||
|
||||
|
||||
## 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)
|
||||

|
||||
|
||||
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:
|
||||
|
||||

|
||||
|
||||
### 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.
|
BIN
static/img/software/mqtt/ha_input_text_helper.png
Normal file
BIN
static/img/software/mqtt/ha_input_text_helper.png
Normal file
Binary file not shown.
After Width: | Height: | Size: 61 KiB |
Loading…
Reference in a new issue