diff --git a/docs/configuration/module-config/mqtt.mdx b/docs/configuration/module-config/mqtt.mdx index b4f70b72..c501ff0c 100644 --- a/docs/configuration/module-config/mqtt.mdx +++ b/docs/configuration/module-config/mqtt.mdx @@ -14,6 +14,7 @@ The MQTT module config options are: Enabled, Server Address, Username, Password, ## Settings + ## MQTT Module Config Values ### Enabled @@ -48,8 +49,8 @@ If true, we attempt to establish a secure connection using TLS. The root topic to use for MQTT messages. This is useful if you want to use a single MQTT server for multiple meshtastic networks and separate them via ACLs. -## MQTT Module Config Client Availability +## MQTT Module Config Client Availability + + + +## Connect to the Default Public Server + + + + + +

1. Enable the MQTT Module

+ +Navigate to: Vertical Ellipsis (3 dots top right) > Radio configuration > MQTT: Turn on the slider for **MQTT enabled** and tap **Send**. + +[![MQTT Settings](/img/modules/mqtt/android_mqtt_sm.png)](/img/modules/mqtt/android_mqtt.png) + +*Optional:* To use your phone's internet connection to send and receive packets over the web, also enable the slider for **MQTT Client Proxy** and skip the Configure Network Settings step below. + +[![Client Proxy](/img/modules/mqtt/android_mqtt_proxy_sm.png)](/img/modules/mqtt/android_mqtt_proxy.png) + +

2. Enable Channel Uplink & Downlink

+ +Navigate to: Vertical Ellipsis (3 dots top right) > Radio configuration > Channels > LongFast: Turn on the sliders for **Uplink enabled** and **Downlink enabled**, then tap **Save** and tap **Send**. + +[![Channel Settings](/img/modules/mqtt/android_channel_sm.png)](/img/modules/mqtt/android_channel.png) + +

3. Configure Network Settings

+ +Navigate to: Vertical Ellipsis (3 dots top right) > Radio configuration > Network: Turn on the slider for **WiFi enabled**, Enter the **SSID** and **PSK** for your network, then tap **Send**. + +[![Network Settings](/img/modules/mqtt/android_network_sm.png)](/img/modules/mqtt/android_network.png) + +
+ + +

1. Enable the MQTT Module

+ +Settings > MQTT - Turn on the slider for MQTT enabled - Tap **Save** + +[![MQTT Settings 1](/img/modules/mqtt/apple_mqtt_1_sm.png)](/img/modules/mqtt/apple_mqtt_1.png) +[![MQTT Settings 2](/img/modules/mqtt/apple_mqtt_2_sm.png)](/img/modules/mqtt/apple_mqtt_2.png) + +*Optional:* To use your phone's internet connection to send and receive packets over the web, also enable the slider for **MQTT Client Proxy** and skip the Configure Network Settings step below. + +[![Client Proxy](/img/modules/mqtt/apple_mqtt_1_proxy_sm.png)](/img/modules/mqtt/apple_mqtt_1_proxy.png) + +

2. Enable Channel Uplink & Downlink

+ +Settings > Channels > Primary Channel: Turn on the sliders for **Uplink enabled** and **Downlink enabled** - Tap **Save** + +[![Channel Settings](/img/modules/mqtt/apple_channel_sm.png)](/img/modules/mqtt/apple_channel.png) + +

3. Configure Network Settings

+ +Settings > Network: Turn on the slider for **WiFi enabled** - Enter your **SSID** and **PSK** for your network - Tap **Save** + +[![Network Settings](/img/modules/mqtt/apple_network_sm.png)](/img/modules/mqtt/apple_network.png) + +
+ + +

1. Enable the MQTT Module

+ +```shell +meshtastic --set mqtt.enabled true +``` + +

2. Enable Channel Uplink & Downlink

+ +```shell +meshtastic --ch-set uplink_enabled true --ch-index 0 +meshtastic --ch-set downlink_enabled true --ch-index 0 +``` + +or chained together: +```shell +meshtastic --ch-set uplink_enabled true --ch-index 0 --ch-set downlink_enabled true --ch-index 0 +``` + +

3. Configure Network Settings

+ +```shell +meshtastic --set network.wifi_enabled true +meshtastic --set network.wifi_ssid "your network" +meshtastic --set network.wifi_psk yourpassword +``` + +or chained together: +```shell +meshtastic --set network.wifi_enabled true --set network.wifi_ssid "your network" --set network.wifi_psk yourpassword +``` + +
+ + +

1. Enable the MQTT Module

+ +Config > Module Config > MQTT - Turn on the slider for MQTT enabled - Click the **Save** icon. + +[![MQTT Settings](/img/modules/mqtt/web_mqtt_sm.png)](/img/modules/mqtt/web_mqtt.png) + +*Optional:* To use your client's internet connection to send and receive packets over the web, also enable the slider for **Proxy to Client Enabled** and skip the Configure Network Settings step below. + +[![Client Proxy](/img/modules/mqtt/web_mqtt_proxy_sm.png)](/img/modules/mqtt/web_mqtt_proxy.png) + +

2. Enable Channel Uplink & Downlink

+ +Channels > Primary: Turn on the sliders for **Uplink Enabled** and **Downlink Enabled** - Click the **Save** icon. + +[![Channel Settings](/img/modules/mqtt/web_channel_sm.png)](/img/modules/mqtt/web_channel.png) + +

3. Configure Network Settings

+ +Config > Device Config > Network: Turn on the slider for **Enabled** - Enter your **SSID** and **PSK** for your network - Click the **Save** icon. + +[![Network Settings](/img/modules/mqtt/web_network_sm.png)](/img/modules/mqtt/web_network.png) + +
+
\ No newline at end of file