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)
|
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)
|
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`
|
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.
|
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)
|
- [Android App](/docs/category/android-app)
|
||||||
- [Web Client](https://client.meshtastic.org)
|
- [Web Client](https://client.meshtastic.org)
|
||||||
- [iOS App](/docs/category/apple-apps)
|
- [iOS/iPadOS/macOS App](/docs/category/apple-apps)
|
||||||
|
|
||||||
</TabItem>
|
</TabItem>
|
||||||
<TabItem value="network">
|
<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".
|
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>
|
:::info If a QR or URL opens a webpage instead of the APP or "Open with Meshtastic" is not an option:
|
||||||
<summary>Troubleshooting shared links: Can't "open with Meshtastic".</summary>
|
1. Go to Android Settings > Apps > Default apps > Meshtastic > Opening links
|
||||||
<div>
|
2. Make sure you have in "links/web address": www.meshtastic.org
|
||||||
<div>
|
3. If you see the option "Open the supported links", make sure it is enabled.
|
||||||
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>
|
|
||||||
|
|
||||||
[](/img/android/android-accept-channel.png)
|
[](/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.
|
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
|
### 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.
|
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
|
## 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.
|
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.
|
Add the following code to your automations.yaml file. Be sure to modify the `topic`, `regex_search`, and `service` for your configuration.
|
||||||
```yaml
|
```yaml
|
||||||
|
@ -254,3 +254,60 @@ Add the following code to your automations.yaml file. Be sure to modify the `to
|
||||||
```
|
```
|
||||||
|
|
||||||
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