AMMB is a flexible and robust software bridge designed by Akita Engineering to facilitate seamless, bidirectional communication between Meshtastic LoRa mesh networks and external systems via Serial or MQTT.

This bridge enables interoperability, allowing messages, sensor data (with appropriate translation), and potentially other information to flow between Meshtastic and devices connected via Serial (like MeshCore) or platforms integrated with MQTT.

Features

Bidirectional Message Forwarding: Relays messages originating from Meshtastic nodes to the configured external system (Serial or MQTT), and vice-versa.
Multiple External Transports: Supports connecting to the external system via:
- Direct Serial: Interfaces directly with devices (like MeshCore) via standard RS-232/USB serial ports.
- MQTT: Connects to an MQTT broker to exchange messages with IoT platforms or other MQTT clients.
Configurable Serial Protocol: Supports different serial communication protocols via config.ini. Includes a raw_serial handler specifically for MeshCore Companion Mode (Binary).
Robust Connection Management: Automatically attempts to reconnect if connections are lost.

Installation & Usage

Clone the Repository

git clone https://github.com/AkitaEngineering/akita-meshtastic-meshcore-bridge.git
cd akita-meshtastic-meshcore-bridge

Set up Environment

python -m venv venv
source venv/bin/activate  # or .\venv\Scripts\activate on Windows
pip install -r requirements.txt

Configure

Copy examples/config.ini.example to config.ini and edit it.

For MeshCore (Binary):
Set EXTERNAL_TRANSPORT = serial and SERIAL_PROTOCOL = raw_serial.
For MQTT:
Set EXTERNAL_TRANSPORT = mqtt and configure broker details.

Run

python run_bridge.py

Maintainer / Contact

This project is maintained by Akita Engineering.

Website: www.akitaengineering.com
Contact: info@akitaengineering.com

License

This project is licensed under the GNU General Public License v3.0.
(See the LICENSE file for the full license text.)