---
title: "Semtech UDP Packet Forwarder"
canonical: "https://docs.loriot.io/space/NMS/6033147/Semtech%20UDP%20Packet%20Forwarder"
format: markdown
---
![semtech-logo.png](media://e6634478-3d48-4585-b2f0-f5667874d5e9)

 

> ℹ️ Please note that any LoRaWAN® certified gateway can be connected through the Semtech Packet Forwarder with the LORIOT Network Management System (NMS). This makes LORIOT compatible with every  LoRaWAN® gateway on the market that supports the Semtech Packet Forwarder. In order to use it you need to register your gateway as Semtech Packet Forwarder.

### Installation packet contents

---

The Semtech Packet Forwarder is a software component provided by Semtech as part of the IoT Starter Kit. The source code can be found on **[GitHub](https://github.com/Lora-net/packet_forwarder)**. LORIOT do not provide the binary, or source code, nor specify the hardware it should run on.

LORIOT support both version 1 and version 2 of the protocols. LORIOT only provide the absolute minimum compatibility layer and do not implement the full protocol. LORIOT do not provide confirmations of the UDP frames.


### Configuration Steps

---

You will need to adjust the following parameters in the `global_conf.json` or `local_conf.js` file.

|  |  |
| --- | --- |
| `server_address` | **<**loriot_server_address**>** Adjust according to the server used (`eu1.loriot.io,ap1.loriot.io`) |
| `gateway_ID` | EUI (corresponds to GWEUI) generated from MAC according to [IEEE Guidelines](http://standards.ieee.org/develop/regauth/tut/eui64.pdf), see the conversion mechanism below |
| `serv_port_up` | `1780` |
| `serv_port_down` | `1780` |


### MAC to EUI conversion

---

- Retrieve the MAC address of your eth0 interface
- Add `FF:FF` between the first three and last three bytes
- Remove the colons
- Make all HEX digits capital

Example:

|  |  |
| --- | --- |
| ` aa:11:22:33:44:55` | is the MAC of your device |
| ` aa:11:22:FF:FF:33:44:55` | is the mac after extension with` FF:FF` |
| ` aa1122FFFF334455` | without colons |
| ` AA1122FFFF334455` | after capitalization |


### Final file example

---

Final `global_conf.json` or `local_conf.js` file:

```plaintext
}
"gateway_conf" : {
  "gateway_ID": "AA1122FFFF334455", /* change according to your MAC address!!! */
  "server_address" : "eu1.loriot.io", /* replace eu1.loriot.io with your server address, ... */
  "serv_port_up": 1780,
  "serv_port_down": 1780,

  "keepalive_interval": 10,
  "stat_interval": 30,
  "push_timeout_ms": 100,

  "forward_crc_valid": true,
  "forward_crc_error": false,
  "forward_crc_disabled": false
}
```


### Gateway Registration on the LORIOT NMS

---

> Macro (rw-ui-tabs-macro)
> 
> > Macro (rw-tab)
> 
> 1. Choose **UDP Semtech Packet Forwarder** as the gateway software when <u>[registering the gateway](https://docs-loriot.atlassian.net/wiki/spaces/NMS/pages/6031862)</u> in the LORIOT Network Management System, and then select the **Select** button.
> 2. In the next step, fill in the gateway's **Gateway EUI**. Optionally, you can define a **name **and add its **MAC Address**.
> 3. Select the **Region** where the gateway will operate.
>   
> 4. Optionally, define the **Gateway Location** by enabling the toggle. Its location can be set up in two different ways. Either by selecting a location on the map or by filling out the required information to register the address manually.
>   1. **Input **  
> Select the **Country** from the drop-down menu, and define the name of the **City**, **Address** and **ZIP Code**.
>   2. **Map pin **  
> Select any point on the map where you want to provision your gateway by dragging the marker to another place on the map to update its location. If you have allowed your browser to obtain your location, it will auto-populate on the map.
>     Additionally, users can change the **map layer** as shown above. The layer configuration for a given map is held within the ongoing user session on the NMS; when users log out and then log in again, a new session begins and all maps on the NMS UI are displayed in the default layer, which is *Map* (black, plain background).
> 5. Finalize the registration on the NMS.
> 
> 
> > Macro (rw-tab)
> 
> 1. Follow the steps from the [Register a Gateway](https://docs-loriot.atlassian.net/wiki/spaces/NMS/pages/6031862) article. Select the **Packet Forwarder Semtech** from the Gateway list.
> 2. Fill in the required fields.
> 3. Start the Semtech PF in the Gateway or from the Gateway webUI (depending on the manufacturer)