Setup Hardware

It is recommended that you provision your hardware using the serial interface over USB by using the Meshtastic CLI Tool. This is very specific because currently, at the time of writing this repository, changes made via the web interface do not work sometimes. When you "save" your settings, the device will reboot with the old settings still. I have had zero issues making changes over serial with the CLI interface.

pip install meshtastic to install the CLI tool
Plug in your device (Make sure the USB cable you are using allows data transfer & not just power)
Run the commands below (Each command will make the device reboot after setting it)

NAME

meshtastic --set-owner 'CHANGEME' --set-owner-short 'CHNG'

Note: Short name can only be 4 alphanumeric characters.

LORA

meshtastic --set lora.region US

GPS

meshtastic --set position.gps_enabled true

or for a fixed position...

meshtastic --set position.fixed_position true --setlat 37.8651 --setlon -119.5383

CHANNEL

meshtastic --ch-set name "SUPERNETS" --ch-set psk "CHANGEME" --ch-set uplink_enabled true --ch-set downlink_enabled true --ch-index 0

WIFI

meshtastic --set network.wifi_enabled true --set network.wifi_ssid "CHANGEME" --set network.wifi_psk "CHANGEME"

MQTT

meshtastic --set mqtt.enabled true --set mqtt.address "CHANGEME" --set mqtt.username "CHANGEME" --set mqtt.password "CHANGEME" --set mqtt.tls_enabled true --set mqtt.root "msh/CHANGEME" --set mqtt.encryption_enabled true

BLUETOOTH

meshtastic --set bluetooth.enabled true

Note: Only enable this on devices are not using Wifi (mobile devices) because with ESP32 chips, I don't think Wifi & Bluetooth can function side-by-side together.

1.9 KiB Raw Blame History