https://github.com/acidvegas/meshtastic

Experiments with Meshtastic 🛰️
https://github.com/acidvegas/meshtastic

decentralized esp32 lilygo lora lora-receiver lora-server lorawan meshtastic meshtastic-python mqtt radio

Last synced: about 1 month ago
JSON representation

Experiments with Meshtastic 🛰️

• Host: GitHub
• URL: https://github.com/acidvegas/meshtastic
• Owner: acidvegas
• License: isc
• Created: 2024-04-25T17:12:25.000Z (8 months ago)
• Default Branch: main
• Last Pushed: 2024-05-09T20:43:40.000Z (8 months ago)
• Last Synced: 2024-05-21T00:59:07.602Z (7 months ago)
• Topics: decentralized, esp32, lilygo, lora, lora-receiver, lora-server, lorawan, meshtastic, meshtastic-python, mqtt, radio
• Language: Python
• Homepage: https://meshtastic.org
• Size: 1.91 MB
• Stars: 8
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Meshtastic Utilities

This repository serves as a collection of resources created in my journey to learn & utilize [LoRa](https://en.wikipedia.org/wiki/LoRa) based communications with [Meshtastic](https://meshtastic.org).

The goal here is to create simple & clean modules to interface with the hardware in a way that can be used to expand the possibilities of the devices capabilities.

![](.screens/htpdeck.png)

## Documentation

- [Hardware Options](./docs/HARDWARE.md)

- [Setup Hardware](./Sdocs/ETUP.md)

- [Setup a T-Deck](./docs/T-DECK.md)

- [Firmware Hacks & Customization](./docs/FIRMWARE.md)

- [MQTT Notes](./docs/MQTT.md)

## Code

- [Meshtastic Serial/TCP Interface](./meshapi.py)

- [Meshtastic MQTT Interface](./meshmqtt.py)

- [Meshtastic IRC Relay / Bridge](./meshirc.py)

## Bugs & Issues

- Devices must have Wifi turned off when going mobile. Upon leaving my house with WiFi still enabled, the UI & connection was EXTREMELY laggy & poor. Couldn't even type well...

- Devices using a MQTT with TLS will reboot loop.

- A fix for the reboot loop is simply disabling MQTT over serial with `meshtastic --set mqtt.tls_enabled false`

- Enabling JSON with MQTT causes messages to not be encrypted in the MQTT server..

## Roadmap

- Asyncronous meshtastic interface

- Documentation on MQTT bridging for high availability

- Bridge for IRC to allow channel messages to relay over Meshtastic & all Meshtastic events to relay into IRC. *(IRC to Meshtastic will require a command like `!mesh ` to avoid overloading the traffic over LoRa)*

## Notes

- [Meshtastic PortNum List](https://buf.build/meshtastic/protobufs/docs/main:meshtastic#meshtastic.PortNum)

___

###### Mirrors for this repository: [acid.vegas](https://git.acid.vegas/meshtastic) • [SuperNETs](https://git.supernets.org/acidvegas/meshtastic) • [GitHub](https://github.com/acidvegas/meshtastic) • [GitLab](https://gitlab.com/acidvegas/meshtastic) • [Codeberg](https://codeberg.org/acidvegas/meshtastic)