v0.1.11

Changelog

Since v0.1.10

• Adds pin-pairing configuration support

Running

You can find the respective binary for your CPU architecture in the release assets. The UDP forwarder acts as a man-in-the-middle for any gateway that uses the UDP packet forwarder.

You can try the following quick instructions:

1. Adjust your current LoRa packet forwarder to send the data to 127.0.0.1 instead of your LoRaWAN server
2. Use both uplink and downlink port 1800
3. Create a configuration file (eg. kudzu-forwarder.conf with the following contents):

   # The following parameters are obtained from the Kudzu Analytics
   # platform https://analytics.v2.kudzu.gr/
   client-id=
   client-key=
   gateway=
   
   # Configure your LoRaWAN server
   connect-host=eu1.cloud.thethings.network
   connect-port-up=1700
   connect-port-down=1700
   
   # Make forwarder listen on localhost
   listen-host=127.0.0.1
   listen-port-up=1800
   listen-port-down=1800   

4. Start your kudzu forwarder:

   ./kudzu-forwarder --config=kudzu-forwarder.conf
   

Pairing

Through the pairing process, you can deliver configuration parameters to your gateway through a short-lived pairing PIN. This allows you to provision gateways quickly and securely.

To instruct kudzu-forwarder to download the configuration by PIN:

1. Go to https://eu1.cluster.kudzu.gr/ , click "Gateway Pairing" in your gateway and get the PIN number

2. Use the following command to download and write the configuration client ID & Key parameters:

   ./kudzu-forwarder --write  --config=./kudzu-forwrader.conf --pair-pin="123456789"

3. Note that additional parameters, such as connect-host, connect-port etc. are not defined by default, so you will have to modify the contents of the kudzu-forwarder.conf accordingly in order to include all the required fields.

• Alternatively, you can also provide the missing values through environment variables or command-line arguments and the --write argument will include them in the configuration file. For example:

  ./kudzu-forwarder --write  --config=./kudzu-forwrader.conf --pair-pin="123456789" \
     --connect-host=eu1.cloud.thethings.network --listen-host=127.0.0.1