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

v0.1.10

Changelog

Since v0.1.9

• Fixes a bug of analytics computation on the gateway mode

Since v0.1.8

• Adds support for running in front of a server (verified with Chirpstack)
• Adds detailed UDP-level analytics
• Fixes the UDP proxy implementation to support multiple input endpoints

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
   

v0.1.9

Changelog

• Adds support for running in front of a server (verified with Chirpstack)
• Adds detailed UDP-level analytics
• Fixes the UDP proxy implementation to support multiple input endpoints

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
   

v0.1.8

Changelog

• Fixes a bug when parsing LoRaWAN spreading factor
• Fixes a bug when connecting to LNS servers behind NAT

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
   

v0.1.6

Changelog

• Adds support for rsig field in the Semtech UDP protocol that some gateways use.

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
   

v0.1.5

First Public Release

This is the first public release of Kudzu Analytics Packet Forwarder and the respective API interfaces.

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