Files
examples/ping_pong.py
T
swaits 978553e5ac feat!: examples on donglora 1.0 async API with shared _common helpers
Rewrite all scripts against the DongLoRa Protocol v2 async Dongle surface, and extract the shared MeshCore US preset into a single module.

* _common.py: MESHCORE_US preset (910.525 MHz / BW 62.5 / SF 7 / CR 4/5 / sync 0x1424 / 20 dBm) plus small helpers, imported by every example.

* New: explore.py, which prints the device capabilities and runs a single TX + RX roundtrip for quick hardware validation.

* simple_rx.py, simple_tx.py, ping_pong.py, lora_bridge.py all switch to donglora.Dongle and the new Modulation / LoRaConfig types.

* all_commands.py removed; it was an index of the old v0.1 command enum that no longer exists after the Protocol v2 split.

* justfile: drop stale recipes that referenced removed scripts.
2026-04-22 09:59:16 -06:00

41 lines
1.3 KiB
Python
Executable File

#!/usr/bin/env python3
"""Two-dongle demo on the MeshCore US/Canada channel: one TX, one RX.
Usage:
python examples/ping_pong.py --role tx [PORT]
python examples/ping_pong.py --role rx [PORT]
"""
import argparse
import time
import donglora as dl
from _common import MESHCORE_US
parser = argparse.ArgumentParser(description="DongLoRa ping-pong demo")
parser.add_argument("--role", choices=["tx", "rx"], required=True)
parser.add_argument("port", nargs="?", help="Serial port (auto-detect if omitted)")
args = parser.parse_args()
with dl.connect(args.port, config=MESHCORE_US) as d:
if args.role == "tx":
print("Transmitting every 2 seconds (Ctrl+C to stop)...\n")
try:
seq = 0
while True:
msg = f"ping #{seq}"
td = d.tx(msg.encode())
print(f" TX: {msg!r} ({td.airtime_us} µs)")
seq += 1
time.sleep(2)
except KeyboardInterrupt:
print("\nDone.")
else:
print("Receiving (Ctrl+C to stop)...\n")
try:
for pkt in d.rx():
text = pkt.data.decode("utf-8", errors="replace")
print(f" RX: {text!r} RSSI:{pkt.rssi_dbm:.1f}dBm SNR:{pkt.snr_db:.1f}dB")
except KeyboardInterrupt:
print("\nDone.")