diff --git a/docs/getting-started/flashing-firmware/nrf52/drag-n-drop.mdx b/docs/getting-started/flashing-firmware/nrf52/drag-n-drop.mdx index 9d0b47b5..ce6f4af5 100644 --- a/docs/getting-started/flashing-firmware/nrf52/drag-n-drop.mdx +++ b/docs/getting-started/flashing-firmware/nrf52/drag-n-drop.mdx @@ -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. diff --git a/docs/getting-started/initial-config.mdx b/docs/getting-started/initial-config.mdx index 140c7c0c..4ab135ad 100644 --- a/docs/getting-started/initial-config.mdx +++ b/docs/getting-started/initial-config.mdx @@ -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) diff --git a/docs/software/android/usage.mdx b/docs/software/android/usage.mdx index e01be522..d25878a3 100644 --- a/docs/software/android/usage.mdx +++ b/docs/software/android/usage.mdx @@ -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". -
- Troubleshooting shared links: Can't "open with Meshtastic". -
-
- If you don't see "Meshtastic" as an option to open the file or link with: -
- 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. -
-
-
-
+:::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) diff --git a/docs/software/mqtt/home-assistant.mdx b/docs/software/mqtt/home-assistant.mdx index 8693bafe..28854a66 100644 --- a/docs/software/mqtt/home-assistant.mdx +++ b/docs/software/mqtt/home-assistant.mdx @@ -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/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/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/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. \ No newline at end of file +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. \ No newline at end of file diff --git a/static/img/software/mqtt/ha_input_text_helper.png b/static/img/software/mqtt/ha_input_text_helper.png new file mode 100644 index 00000000..80f56453 Binary files /dev/null and b/static/img/software/mqtt/ha_input_text_helper.png differ