Unsignedio
/
LoRaMon
mirror of https://github.com/markqvist/LoRaMon.git
1
0
Fork 0
Code Issues Releases Wiki Activity
LoRa packet sniffer for RNode hardware
48 Commits
1 Branch
5 Tags
169 KiB
Python 98.9%
Makefile 1.1%
 
 
Go to file
Alligitor 347e062026 Added an option on the UI for turn raw byte print on/off. 
The button on the UI sends a message to radio thread for changing the print_raw_data flag.
I could have also done this differently by doing the following:
change the log message type from RNode to UI to differentiate logs from raw data.
do the filtering of whether raw bytes are printed or not on the UI side.
 		2025-04-22 16:35:04 +00:00
loramon Added an option on the UI for turn raw byte print on/off. 2025-04-22 16:35:04 +00:00
.gitignore Initial commit 2018-06-27 11:48:49 +02:00
LICENSE Initial commit 2018-06-27 11:48:49 +02:00
Makefile Makefile 2022-01-11 02:45:10 +01:00
README.md Updated for -U. Added urwid as an install dependency. 2025-04-20 14:31:13 +00:00
setup.py Updated for -U. Added urwid as an install dependency. 2025-04-20 14:31:13 +00:00

README.md

LoRa packet sniffer for RNode hardware

Intro

This utility allows you to sniff LoRa networks with an RNode, and dump captured packets to the console or files.

usage: loramon [-h] [-C] [-W directory] [--freq Hz] [--bw Hz] [--txp dBm]
               [--sf factor] [--cr rate]
               [--duration seconds] [-Q]
               [-R]
               [-P]
               [-U]
               [port]

LoRa packet sniffer for RNode hardware.

positional arguments:
  port           Serial port where RNode is attached

optional arguments:
  -h, --help     show this help message and exit
  -C, --console  Print captured packets to the console
  -W directory   Write captured packets to a directory
  --freq Hz      Frequency in Hz
  --bw Hz        Bandwidth in Hze
  --txp dBm      TX power in dBm
  --sf factor    Spreading factor
  --cr rate      Coding rate
  --duration s   Duration to scan for in seconds
  -Q             Quite mode. Don't log any messages after start up
  -R             Print out raw bytes of the frame
  -P             Set promiscuous mode
  -U             Use a text based UI

Installation

If you already have Python3 and pip installed, you can easily install LoRaMon through pip:

pip3 install loramon

On Arch Linux it is also possible to install using the loramon package from the AUR.

If you want to install directly from this repository, first install the dependencies:

sudo apt install python3 python3-pip
sudo pip3 install pyserial

And then clone the repository and make LoRaMon executable:

git clone https://github.com/markqvist/LoRaMon.git
cd LoRaMon
chmod a+x loramon
./loramon --help

Usage Examples

Dump to console

Listens on a specified frequency and displays captured packets in the console.

loramon /dev/ttyUSB0 --freq 868000000 --bw 125000 --sf 7 --cr 5 -C

Dump to console and disk

Like above, but also writes all captured packets individually to a specified directory.

loramon /dev/ttyUSB0 --freq 868000000 --bw 125000 --sf 7 --cr 5 -C -W capturedir

Sniff implicit header mode packets

If you want to sniff LoRa packets with implicit header mode, use the --implicit option along with the length in bytes of the expected packet. This mode needs an RNode with a firmware version of at least 1.17.

loramon /dev/ttyUSB0 --freq 868000000 --bw 125000 --sf 7 --cr 5 -C -W capturedir --implicit 12