Skip to main content

LoRa packet sniffer for RNode hardware

Project description

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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

loramon-0.9.7.tar.gz (8.2 kB view details)

Uploaded Source

Built Distribution

loramon-0.9.7-py3-none-any.whl (7.9 kB view details)

Uploaded Python 3

File details

Details for the file loramon-0.9.7.tar.gz.

File metadata

  • Download URL: loramon-0.9.7.tar.gz
  • Upload date:
  • Size: 8.2 kB
  • Tags: Source
  • Uploaded using 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

File hashes

Hashes for loramon-0.9.7.tar.gz
Algorithm Hash digest
SHA256 d21c3692836b3870da9625f403288d55c9ab4aa59f6c235b98382ee2f3d36338
MD5 e38db5b362269219e425465f205c230e
BLAKE2b-256 d4108393699b031824f23735bc9cc793b2375146257f6e44fbf58ebcd78d0058

See more details on using hashes here.

File details

Details for the file loramon-0.9.7-py3-none-any.whl.

File metadata

  • Download URL: loramon-0.9.7-py3-none-any.whl
  • Upload date:
  • Size: 7.9 kB
  • Tags: Python 3
  • Uploaded using 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

File hashes

Hashes for loramon-0.9.7-py3-none-any.whl
Algorithm Hash digest
SHA256 5726718be49906b1938bfe589d1ea9ed0aed10ce26597b2c744538a4357efdda
MD5 3696ab257b7aa14e622593ccf7186252
BLAKE2b-256 1ad817dd435adeecb21f2993d5dd5285b456e4d63978d6a8efac308effb58afb

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page