-
+:::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)
@@ -138,7 +126,7 @@ By default there is no long-term store-and-forward of messages, so messages not
The network list shows all the users (devices) that have connected to the same Channel. For each entry, it shows the last time they were active, their location and distance (when available), and their last known power status. In the example above, Monkey is the local user, Rabbit was last heard from 10 minutes ago and is 50m away, and Panda was last heard 11 minutes ago and 5m away.
-- Tap on a node from the list to start Direct Messaging, request a position update, request a [traceroute](/docs/settings/moduleconfig/traceroute) or add it to your [Ignore Incoming Array](/docs/settings/config/lora#ignore-incoming-array).
+- Tap on a node from the list to start Direct Messaging, request a position update, request a [traceroute](/docs/configuration/module/traceroute) or add it to your [Ignore Incoming Array](/docs/configuration/radio/lora#ignore-incoming-array).
- If you have an [Admin Channel](/docs/configuration/remote-admin) enabled on your devices, tapping on the node will also display an option to remotely configure the node.
### View the map
@@ -175,13 +163,13 @@ The debug panel allows you to see all packets sent between the application and t
[](/img/android/android-radio-configuration.png)
Radio Configuration opens a list of all radio and module configuration settings.
-- See [Device Config](/docs/settings/config) for radio settings.
-- See [Module Config](/docs/settings/moduleconfig) for module settings.
+- See [Device Config](/docs/configuration/radio) for radio settings.
+- See [Module Config](/docs/configuration/module) for module settings.
- At the end of this list are buttons for Reboot, Shutdown, Factory reset, and NodeDB reset.
### Export rangetest.csv
-Allows you to save all your network's position data with GPS coordinates into a .csv (comma separated value) file on your phone. This file can be imported into the spreadsheet application of your choice for easy viewing. This feature is similar but independent from the device [range test module](/docs/settings/moduleconfig/range-test), and results may differ.
+Allows you to save all your network's position data with GPS coordinates into a .csv (comma separated value) file on your phone. This file can be imported into the spreadsheet application of your choice for easy viewing. This feature is similar but independent from the device [range test module](/docs/configuration/module/range-test), and results may differ.
### Theme
diff --git a/docs/software/integrations/caltopo.mdx b/docs/software/integrations/caltopo.mdx
index 90ef51e1..651a6c28 100644
--- a/docs/software/integrations/caltopo.mdx
+++ b/docs/software/integrations/caltopo.mdx
@@ -15,7 +15,7 @@ Meshtastic can integrate with [CalTopo](https://caltopo.com/) Desktop edition qu
### Configuring the Meshtastic device
-To configure our Meshtastic device for this integration, we have a couple of different options, both of which utilize the [Serial module](/docs/settings/moduleconfig/serial):
+To configure our Meshtastic device for this integration, we have a couple of different options, both of which utilize the [Serial module](/docs/configuration/module/serial):
#### Enabling serial over the device's USB port
```shell title="Serial over USB"
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.
-[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. -
-
- - 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/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)
+
## 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)
+
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:
+
+
+
+### 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/docs/software/mqtt/index.mdx b/docs/software/mqtt/index.mdx
index f2640ac6..2150ca5d 100644
--- a/docs/software/mqtt/index.mdx
+++ b/docs/software/mqtt/index.mdx
@@ -11,7 +11,7 @@ Meshtastic networks in different locations beyond the reach of LoRa can be easil
You can also share channel settings with a remote network. If you use the default Meshtastic MQTT server, packets are always encrypted. If you use a custom MQTT broker (ie set `mqtt.address`), the `mqtt.encryption_enabled` setting applies, which by default is false. You can also specify your own private MQTT broker and specify authentication for that broker to bridge several mesh networks together, via the internet (or just a local IP network).
-You can find the settings available for MQTT [here](/docs/settings/moduleconfig/mqtt).
+You can find the settings available for MQTT [here](/docs/configuration/module/mqtt).
:::important
When MQTT is turned on, you are potentially broadcasting your entire mesh's traffic onto the public internet. This includes messages and position information.
@@ -25,7 +25,7 @@ When MQTT is enabled, the Meshtastic device simply uplinks and/or downlinks ever
### MQTT [Topics](https://www.hivemq.com/blog/mqtt-essentials-part-5-mqtt-topics-best-practices)
-If no specific [root topic](/docs/settings/moduleconfig/mqtt#root-topic) is configured, the default root topic will be `msh/`.
+If no specific [root topic](/docs/configuration/module/mqtt#root-topic) is configured, the default root topic will be `msh/`.
Each device that is connected to MQTT will publish its MQTT state (`online`/`offline`) to:
`msh/2/stat/USERID`, where `USERID` is the node ID of the gateway device (the one connected to MQTT).
@@ -47,10 +47,10 @@ The payload is a raw protobuf, whose definitions for Meshtastic can be found [he
ShortFast !937bed1c
```
-If [encryption_enabled](/docs/settings/moduleconfig/mqtt#encryption-enabled) is set to true, the payload of the MeshPacket will remain encrypted with the key for the specified channel.
+If [encryption_enabled](/docs/configuration/module/mqtt#encryption-enabled) is set to true, the payload of the MeshPacket will remain encrypted with the key for the specified channel.
#### JSON topic
-If [JSON is enabled](/docs/settings/moduleconfig/mqtt/#json-enabled), packets from the following [port numbers](/docs/development/firmware/portnum) are serialized to JSON: `TEXT_MESSAGE_APP`, `TELEMETRY_APP`, `NODEINFO_APP`, `POSITION_APP`, `WAYPOINT_APP`, and `NEIGHBORINFO_APP`. These are then forwarded to the topic:
+If [JSON is enabled](/docs/configuration/module/mqtt/#json-enabled), packets from the following [port numbers](/docs/development/firmware/portnum) are serialized to JSON: `TEXT_MESSAGE_APP`, `TELEMETRY_APP`, `NODEINFO_APP`, `POSITION_APP`, `WAYPOINT_APP`, and `NEIGHBORINFO_APP`. These are then forwarded to the topic:
`msh/2/json/CHANNELNAME/USERID`.
@@ -108,7 +108,7 @@ If the message received contains valid JSON in the payload, the JSON is deserial
### Basic Configuration
-Check out [MQTT Settings](/docs/settings/moduleconfig/mqtt) for full information. For quick start instructions, read on.
+Check out [MQTT Settings](/docs/configuration/module/mqtt) for full information. For quick start instructions, read on.
- Connect your gateway node to wifi, by setting the `network.wifi_ssid`, `network.wifi_psk` and `network.wifi_enabled` preferences.
- Alternatively use the RAK4631 with Ethernet Module RAK13800, by setting `network.eth_mode` and `network.eth_enabled`.
diff --git a/docs/software/python-cli/index.mdx b/docs/software/python-cli/index.mdx
index 417ebc07..5577fdee 100644
--- a/docs/software/python-cli/index.mdx
+++ b/docs/software/python-cli/index.mdx
@@ -124,7 +124,7 @@ meshtastic --qr
Gets a preferences field.
-Configuration values are described in: [Configuration](https://meshtastic.org/docs/settings).
+Configuration values are described in: [Configuration](https://meshtastic.org/docs/configuration).
```shell title="Usage"
meshtastic --get lora
@@ -135,7 +135,7 @@ meshtastic --get lora.region
Sets a preferences field.
-Configuration values are described in: [Configuration](https://meshtastic.org/docs/settings).
+Configuration values are described in: [Configuration](https://meshtastic.org/docs/configuration).
```shell title="Usage"
meshtastic --set lora.region Unset
diff --git a/docs/software/python-cli/usage.mdx b/docs/software/python-cli/usage.mdx
index 13bd32b0..65a765af 100644
--- a/docs/software/python-cli/usage.mdx
+++ b/docs/software/python-cli/usage.mdx
@@ -95,9 +95,9 @@ Toggling `set-ham` changes your device settings in the following ways.
| Setting | `set-ham` Default | Normal Default |
| :----------: | :---------------: | :------------------------------------------------------------------------: |
-| `IsLicensed` | `true` | See [User Config - IsLicensed](/docs/settings/config/user#is-licensed-ham) |
-| `LongName` | _Your CallSign_ | See [User Config - LongName](/docs/settings/config/user#long-name) |
-| `ShortName` | _Abrv CallSign_ | See [User Config - ShortName](/docs/settings/config/user#short-name) |
+| `IsLicensed` | `true` | See [User Config - IsLicensed](/docs/configuration/radio/user#is-licensed-ham) |
+| `LongName` | _Your CallSign_ | See [User Config - LongName](/docs/configuration/radio/user#long-name) |
+| `ShortName` | _Abrv CallSign_ | See [User Config - ShortName](/docs/configuration/radio/user#short-name) |
| `PSK` | `""` | See [Channel Settings - PSK](#changing-the-preshared-key) |
## Changing the preshared key
diff --git a/docs/software/web-client.mdx b/docs/software/web-client.mdx
index 8f50fa3e..2b984430 100644
--- a/docs/software/web-client.mdx
+++ b/docs/software/web-client.mdx
@@ -31,7 +31,7 @@ This can be found on the screen of the device, via your router's DHCP lease page
:::
-You can accessing your device over HTTP after you set up your [Network Connection](/docs/settings/config/network)
+You can accessing your device over HTTP after you set up your [Network Connection](/docs/configuration/radio/network)
### Bluetooth
diff --git a/static/img/configuration/qr-private-primary-example/private-primary-ANZ.png b/static/img/configuration/qr-private-primary-example/private-primary-ANZ.png
new file mode 100644
index 00000000..3579b1de
Binary files /dev/null and b/static/img/configuration/qr-private-primary-example/private-primary-ANZ.png differ
diff --git a/static/img/configuration/qr-private-primary-example/private-primary-CN.png b/static/img/configuration/qr-private-primary-example/private-primary-CN.png
new file mode 100644
index 00000000..42e003a1
Binary files /dev/null and b/static/img/configuration/qr-private-primary-example/private-primary-CN.png differ
diff --git a/static/img/configuration/qr-private-primary-example/private-primary-EU_433.png b/static/img/configuration/qr-private-primary-example/private-primary-EU_433.png
new file mode 100644
index 00000000..f8de765b
Binary files /dev/null and b/static/img/configuration/qr-private-primary-example/private-primary-EU_433.png differ
diff --git a/static/img/configuration/qr-private-primary-example/private-primary-EU_868.png b/static/img/configuration/qr-private-primary-example/private-primary-EU_868.png
new file mode 100644
index 00000000..cbb3f2e6
Binary files /dev/null and b/static/img/configuration/qr-private-primary-example/private-primary-EU_868.png differ
diff --git a/static/img/configuration/qr-private-primary-example/private-primary-IN.png b/static/img/configuration/qr-private-primary-example/private-primary-IN.png
new file mode 100644
index 00000000..29d5e826
Binary files /dev/null and b/static/img/configuration/qr-private-primary-example/private-primary-IN.png differ
diff --git a/static/img/configuration/qr-private-primary-example/private-primary-JP.png b/static/img/configuration/qr-private-primary-example/private-primary-JP.png
new file mode 100644
index 00000000..4ccda718
Binary files /dev/null and b/static/img/configuration/qr-private-primary-example/private-primary-JP.png differ
diff --git a/static/img/configuration/qr-private-primary-example/private-primary-KR.png b/static/img/configuration/qr-private-primary-example/private-primary-KR.png
new file mode 100644
index 00000000..6c813e4e
Binary files /dev/null and b/static/img/configuration/qr-private-primary-example/private-primary-KR.png differ
diff --git a/static/img/configuration/qr-private-primary-example/private-primary-LORA_24.png b/static/img/configuration/qr-private-primary-example/private-primary-LORA_24.png
new file mode 100644
index 00000000..9bb1571b
Binary files /dev/null and b/static/img/configuration/qr-private-primary-example/private-primary-LORA_24.png differ
diff --git a/static/img/configuration/qr-private-primary-example/private-primary-NZ_865.png b/static/img/configuration/qr-private-primary-example/private-primary-NZ_865.png
new file mode 100644
index 00000000..b0283429
Binary files /dev/null and b/static/img/configuration/qr-private-primary-example/private-primary-NZ_865.png differ
diff --git a/static/img/configuration/qr-private-primary-example/private-primary-RU.png b/static/img/configuration/qr-private-primary-example/private-primary-RU.png
new file mode 100644
index 00000000..982ca91c
Binary files /dev/null and b/static/img/configuration/qr-private-primary-example/private-primary-RU.png differ
diff --git a/static/img/configuration/qr-private-primary-example/private-primary-TH.png b/static/img/configuration/qr-private-primary-example/private-primary-TH.png
new file mode 100644
index 00000000..5a782ab0
Binary files /dev/null and b/static/img/configuration/qr-private-primary-example/private-primary-TH.png differ
diff --git a/static/img/configuration/qr-private-primary-example/private-primary-TW.png b/static/img/configuration/qr-private-primary-example/private-primary-TW.png
new file mode 100644
index 00000000..29e15e23
Binary files /dev/null and b/static/img/configuration/qr-private-primary-example/private-primary-TW.png differ
diff --git a/static/img/configuration/qr-private-primary-example/private-primary-UA_433.png b/static/img/configuration/qr-private-primary-example/private-primary-UA_433.png
new file mode 100644
index 00000000..c71d117f
Binary files /dev/null and b/static/img/configuration/qr-private-primary-example/private-primary-UA_433.png differ
diff --git a/static/img/configuration/qr-private-primary-example/private-primary-UA_868.png b/static/img/configuration/qr-private-primary-example/private-primary-UA_868.png
new file mode 100644
index 00000000..233a8a51
Binary files /dev/null and b/static/img/configuration/qr-private-primary-example/private-primary-UA_868.png differ
diff --git a/static/img/configuration/qr-private-primary-example/private-primary-US.png b/static/img/configuration/qr-private-primary-example/private-primary-US.png
new file mode 100644
index 00000000..bf3e6ea0
Binary files /dev/null and b/static/img/configuration/qr-private-primary-example/private-primary-US.png differ
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..02e1d424
Binary files /dev/null and b/static/img/software/mqtt/ha_input_text_helper.png differ
diff --git a/vercel.json b/vercel.json
new file mode 100644
index 00000000..9b29715d
--- /dev/null
+++ b/vercel.json
@@ -0,0 +1,24 @@
+{
+ "redirects": [
+ {
+ "source": "/docs/settings",
+ "destination": "/docs/configuration"
+ },
+ {
+ "source": "/docs/settings/moduleconfig",
+ "destination": "/docs/configuration/module"
+ },
+ {
+ "source": "/docs/settings/moduleconfig/:path*",
+ "destination": "/docs/configuration/module/:path*"
+ },
+ {
+ "source": "/docs/settings/config",
+ "destination": "/docs/configuration/radio"
+ },
+ {
+ "source": "/docs/settings/config/:path*",
+ "destination": "/docs/configuration/radio/:path*"
+ }
+ ]
+}
\ No newline at end of file