mirror of
https://github.com/geoffwhittington/meshtastic-bridge.git
synced 2026-05-03 03:52:27 +02:00
37 lines
1.2 KiB
Markdown
37 lines
1.2 KiB
Markdown
# Meshtastic Bridge
|
|
|
|
Connect two distinct radio [Meshtastic](https://meshtastic.org) networks using TCP.
|
|
|
|
## Requirements
|
|
|
|
- Python3
|
|
- Two Meshtastic devices:
|
|
- Local `LOCAL_NODE_ADDR` The IP address or Serial devPath (micro USB cable needed for serial access) of a local Meshtastic device
|
|
- Remote `REMOTE_NODE_ADDR` The IP address of a remote Meshtastic device
|
|
|
|
Refer to <https://meshtastic.org/docs/settings/config/wifi#wifi-client> to configure a Meshtastic device to use wifi and expose a TCP address
|
|
|
|
## Setup
|
|
|
|
Run the following steps to download and install the software locally
|
|
|
|
```
|
|
$ git clone https://github.com/geoffwhittington/meshtastic-bridge.git
|
|
$ python3 -m venv meshtastic-bridge
|
|
$ cd meshtastic-bridge
|
|
$ source bin/activate
|
|
$ pip install -r requirements.txt
|
|
```
|
|
|
|
## Turn on the Bridge
|
|
|
|
In the `meshtastic-bridge` directory run the following - replacing `BRIDGE_DISTANCE_KM`, `LOCAL_NODE_ADDR` and `REMOTE_NODE_ADDR` with the proper values:
|
|
|
|
```
|
|
BRIDGE_DISTANCE_KM=0 LOCAL_NODE_ADDR=/dev/ttyUSB0 REMOTE_NODE_ADDR=182.168.86.123 python main.py
|
|
```
|
|
|
|
## Bridge Options
|
|
|
|
* `BRIDGE_DISTANCE_KM` Do not bridge messages from nodes that more than BRIDGE_DISTANCE_KM kilometers from the local Meshtastic device. Default `0` (no limit)
|