Before a gateway can forward your devices’ frames, you register it in Hermetry by its EUI. Hermetry then gives you a token and the configuration values for the gateway. This page covers gateways that use the Basics Station protocol. Licensed routers are added differently: see Licensed routers as LoRaWAN gateways.
You need the permission to add, edit, disable and delete LoRaWAN gateways (administrators by default).
Before you start
- Find the gateway EUI. It is 16 hexadecimal digits, printed on the gateway’s label or shown on its own web page. Some makers call it the Gateway ID.
- Make sure your plan has room for one more device. A gateway counts as one device toward your device limit.
- Have access to the gateway’s own configuration page; you will put the values on it right after adding it.
Add the gateway
- Open Devices and select New device.
- Choose LoRaWAN gateway (“A Basics Station gateway, by its EUI; its token is shown once.”).
- Fill in the form:
| Field | What to enter | Rules |
|---|---|---|
| Name | A name you recognise, for example “Roof, north side”. | Required, at most 128 characters. |
| Gateway EUI | The gateway’s 16-digit EUI. | 16 hexadecimal digits. Spaces, - and : are removed. Letters are stored in upper case. All zeros and all F are refused. |
| Region | Fixed to Europe 863–870 MHz (EU868). | EU868 is the only region. |
- Select Add gateway.
The drawer now says The gateway was added. Put these values on it now: the token is shown only here. It shows the Connect the gateway steps with your LNS address, the Discovery address, and the Token header, plus buttons to download tc.uri, tc.trust and tc.key.
Warning
The token is shown only once. Copy the token header or download the files before you close the drawer or select Add another. Hermetry stores only a fingerprint of the token and cannot show it again. If you lose it, rotate the token (see Gateway credentials, disable and delete).
- Configure the gateway with these values. See Connect a Basics Station gateway.
- Select Open the device to watch the gateway come online on its LoRaWAN tab.
What Hermetry creates
| Created | Details |
|---|---|
| A device | Named as you entered, on the built-in LoRaWAN gateway profile. The profile marks the gateway online while its connection is open. |
| A gateway record | EUI, protocol Basics Station, cloud mode, region EU868, status active. |
| A platform-wide EUI claim | The EUI is now reserved for your organisation. |
| Default health alarm rules | When alarms are available in your organisation, the built-in gateway profile gets default rules (offline for 10 minutes, slow round trip, failed downlinks, duty cycle, temperature). See Gateway status, health and the map. |
The gateway form does not ask for a location. Place the gateway on the map later; see Gateway status, health and the map.
Errors
| Message | Cause | What to do |
|---|---|---|
| The gateway EUI is 16 hexadecimal digits. | The EUI is too short, too long or has other characters. | Copy the EUI again from the label. |
| Give the gateway a name. | The name is empty. | Enter a name. |
This EUI is already registered. (eui_taken) | Another gateway on the platform, in your organisation or another one, has this EUI. Hermetry does not say which. | Check the EUI. If the gateway was registered before in another organisation, it must be removed there first. |
| The device limit of your plan is reached. | Your plan has no room for one more device. | Remove unused devices or change your plan. |
Add a gateway through the API
POST /tenant/<tenantId>/api/iot/lorawan/gateways
Content-Type: application/json
{ "name": "Roof, north side", "eui": "AA555A0000000101" }The answer (201) holds gateway, the token in the clear (once) and stationConfig, the three files with their contents. Optional fields: latitude (−90 to 90), longitude (−180 to 180), altitude (−1,000 to 100,000 m). Unknown fields are refused. See the LoRaWAN API.