semtech-loratool

This util sends encrypted lorapackets to the network server using the semtech udp-protocol.

Dependencies

• impacket
• adafruit-circuitpython-tinylora
• python-dotenv

Usage

1. Install the dependencies:

    pip3 install -r requirements.txt
   

2. Clone the repository

3. Set the required environment variables in the file src/example.env and rename it to ".env"

4. Execute main.py with command line parameters:

   usage: main.py [-h] [-v] [-d] message fcnt
   
   positional arguments:
     message          message to be sent as a hex string
     fcnt             current framecount
   
   optional arguments:
     -h, --help       show help message and exit
     -v, --verbosity  increase output verbosity
     -d, --dryrun     generate the UDP message without sending it
   

   Example usage:

   cd src
   ./main.py "01AB" 123 -v
   

The program will then:

1. encrypt the provided message/payload
2. calculate the MIC (Message Integrity Code),
3. construct the PHYPayload,
4. encode it to base64,
5. construct the UDP PUSH_DATA message,
6. send the UDP datagram to the specified IP address and port using UDP. (unless the command line parameter "-d" or "--dryrun" is passed)

Additional Info

• A lot of parameters that can be individually set in PHYPayload or the UDP message have been hardcoded to be equal to observed parameters in our testbed. Future versions of this tool might make this further customizable.

Resources

• LoraWAN specification
• Lora-net/packet_forwarder