About

LoRthon is a Python wrapper for the LoRa Gateway project from Lora-net/lora_gateway/libloragw/

1. Tested on:

   • Raspberry Pi with a RHF0M301 from SeeedStudio.

   • BeagleBoneBlack with a RHF0M301 from SeeedStudio.

Features

- Transmit
- Receive
- Set TX and RX settings.

Installation

Prerequisites: pip install cython Compiling: git clone https://github.com/galalmounir/lorthon.git Run make to to compile and generate the python library.

Usage

Once compiled, the library will be generated inside the output folder. Copy the lorthon.so file to your python project directory.

Example

Import the library

import lorthon

Initializing

lorthon.py_LoRaInit("global_conf.json")

Transmission

py_LoRaTx(freq: int, tx_mode: int, rf_chain: int, rf_power: int, bandwidth: int, datarate: int, coderate: int, preamble: int, no_crc: bool, no_header: bool, payload: bytes, size: int)

lorthon.py_LoRaTx(915000000, 0, 0, 22, 0x03, 0x02, 1, 15, False, False, "HELLO WORLD", 11)

Receiption

The py_LoRaRx() function returns a list of packets received in JSON format. packets = lorthon.py_LoRaRx()

{
    "packets": [
        {
            "frequency": 914800000,
            "if_chain": 1,
            "status": 16,
            "count_us": 2689979,
            "rf_chain": 0,
            "modulation": 16,
            "bandwidth": 3,
            "datarate": 2,
            "coderate": 1,
            "rssi": -66,
            "snr": 9.5,
            "snr_min": 7.75,
            "snr_max": 12.75,
            "crc": 34481,
            "size": 25,
            "payload": "030020000048454C4C4F20574F524C4400140000380C002031"
        }
    ],
    "number_of_pkts": 1
}

Test.py

import lorthon
lorthon.py_LoRaInit("global_conf.json")
lorthon.py_LoRaTx(915000000, 0, 0, 22, 0x03, 0x02, 1, 15, False, False, "HELLO WORLD", 11)
lorthon.py_LoRaStop();	

Next Steps

• python 3 support

Contribution

I am continuously improving on lorthon. I will always merge working bug fixes. However, if you want to add something new to the library, please create an "issue" on github for this first so we can discuss if it should end up in the library before you start implementing it.