meshtastic

- Experiments with Meshtastic 🛰️
git clone git://git.acid.vegas/meshtastic.git
Log | Files | Refs | Archive | README | LICENSE

SETUP.md (2013B)

      1 # Setup Hardware
      2 
      3 It is recommended that you provision your hardware using the serial interface over USB by using the [Meshtastic CLI Tool](https://pypi.org/project/meshtastic/). This is very specific because currently, at the time of writing this repository, changes made via the [web interface](https://client.meshtastic.org) 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.
      4 
      5 - `pip install meshtastic` to install the CLI tool
      6 - Plug in your device *(Make sure the USB cable you are using allows data transfer & not just power)*
      7 - Run the commands below *(Each command will make the device reboot after setting it)*
      8 
      9 ###### NAME
     10 ```
     11 meshtastic --set-owner 'CHANGEME' --set-owner-short 'CHNG'
     12 ```
     13 
     14 **Note:** Short name can only be 4 alphanumeric characters.
     15 
     16 ###### LORA
     17 ```
     18 meshtastic --set lora.region US 
     19 ```
     20 
     21 ###### GPS
     22 ```
     23 meshtastic --set position.gps_enabled true
     24 ```
     25 
     26 or for a fixed position...
     27 
     28 ```
     29 meshtastic --set position.fixed_position true --setlat 37.8651 --setlon -119.5383
     30 ```
     31 
     32 ###### POWER
     33 ```
     34 meshtastic --set power.is_power_saving false
     35 ```
     36 
     37 ###### CHANNEL
     38 ```
     39 meshtastic --ch-set name "SUPERNETS" --ch-set psk "CHANGEME" --ch-set uplink_enabled true --ch-set downlink_enabled true --ch-index 0
     40 ```
     41 
     42 ###### WIFI
     43 ```
     44 meshtastic --set network.wifi_enabled true --set network.wifi_ssid "CHANGEME" --set network.wifi_psk "CHANGEME"
     45 ```
     46 
     47 ###### MQTT
     48 ```
     49 meshtastic --set mqtt.enabled true --set mqtt.address changeme --set mqtt.username changeme --set mqtt.password changeme --set mqtt.encryption_enabled true --set mqtt.tls_enabled false --set mqtt.root msh --set mqtt.map_reporting_enabled true --set mqtt.json_enabled true
     50 ```
     51 
     52 ###### BLUETOOTH
     53 ```
     54 meshtastic --set bluetooth.enabled true
     55 ```
     56 
     57 **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.