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]
[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
Installation
If you already have Python3 and pip installed, you can easily install LoRaMon through pip:
pip3 install loramon
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
Metadata
Release files for loramon 0.9.7
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| loramon-0.9.7.tar.gz | 8.2 kB | Without provenance | Details for loramon-0.9.7.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| loramon-0.9.7-py3-none-any.whl | Python 3 | none | any | Details for loramon-0.9.7-py3-none-any.whl |
Total release size: 16.1 kB
Release files / loramon-0.9.7.tar.gz
| Download URL | loramon-0.9.7.tar.gz |
|---|---|
| Size | 8.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
d21c3692836b3870da9625f403288d55c9ab4aa59f6c235b98382ee2f3d36338
|
|
BLAKE2b-256 checksum How to use checksums |
d4108393699b031824f23735bc9cc793b2375146257f6e44fbf58ebcd78d0058
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/3.4.2 importlib_metadata/4.8.1 pkginfo/1.7.0 requests/2.25.1 requests-toolbelt/0.9.1 tqdm/4.59.0 CPython/3.8.10
|
Release files / loramon-0.9.7-py3-none-any.whl
| Download URL | loramon-0.9.7-py3-none-any.whl |
|---|---|
| Size | 7.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
5726718be49906b1938bfe589d1ea9ed0aed10ce26597b2c744538a4357efdda
|
|
BLAKE2b-256 checksum How to use checksums |
1ad817dd435adeecb21f2993d5dd5285b456e4d63978d6a8efac308effb58afb
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/3.4.2 importlib_metadata/4.8.1 pkginfo/1.7.0 requests/2.25.1 requests-toolbelt/0.9.1 tqdm/4.59.0 CPython/3.8.10
|
Security for loramon 0.9.7
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.