Skip to content

Commit

Permalink
Add Dragino LPS8N Basics Station docs (#1340)
Browse files Browse the repository at this point in the history
* doc: Initial files

* doc: Further document

* doc: Add feedback

* doc: Add even more feedback
  • Loading branch information
LDannijs authored Jun 9, 2024
1 parent e2a36ce commit 5b8aace
Show file tree
Hide file tree
Showing 10 changed files with 95 additions and 36 deletions.
42 changes: 6 additions & 36 deletions doc/content/gateways/models/dragino-lps8/_index.md
Original file line number Diff line number Diff line change
Expand Up @@ -23,7 +23,10 @@ This page guides you on how to configure the Dragino LPS8N for adding on {{% tts
1. A user account on {{% tts %}} with user rights to add gateways.
2. A computer on the same network as the LPS8N.
3. The latest version of firmware running on the Dragino LPS8N. Read the Dragino LPS8N [user manual](http://wiki.dragino.com/xwiki/bin/view/Main/User%20Manual%20for%20All%20Gateway%20models/LPS8N%20-%20LoRaWAN%20Gateway%20User%20Manual/#H8.A0UpgradeLinuxFirmware) for instructions on firmware upgrade.

4. Internet access setup for the LPS8N using one of the following methods:
- Using the WAN port of the LPS8N
- As a WiFi client
- Using the built-in 4G modem

## Configuring the LPS8N

Expand All @@ -40,39 +43,6 @@ After signing in, you will be directed to the LPS8N's Web UI.

{{< figure src="web-ui-home-lps8n.png" alt="Web UI hime" >}}

Before proceeding with the next step, we assume you have set up internet access for the LPS8N using one of the following methods:

- Using the WAN port of the LPS8N
- As a WiFi client
- Using the built-in 4G modem

On the Web UI, navigate to **LoRaWAN > LoRaWAN** in the menu.

On the LoRaWAN Configuration page, configure the following settings:

1. **Service Provider**: `The Things Network V3`
2. **Server Address**: `eu1.cloud.thethings.network`
3. **Gateway ID**: This is the default Gateway EUI for LPS8N. You can keep it as is.
4. **Uplink Port**: `1700`
5. **Downlink Port**: `1700`

Copy the **Gateway ID** which you will need in the next step.
{{< note "The LPS8N Web UI refers to Gateway EUI as the Gateway ID, which is the Gateway EUI for {{% tts %}}." />}}

Select **Save & Apply**.

{{< figure src="lorawan-config.png" alt="LoRaWAN Configuration" >}}

## Adding LPS8N to {{% tts %}}

You can add the LPS8N gateway to {{% tts %}} by following the instructions on the [ Adding Gateways]({{< ref "/gateways/concepts/adding-gateways" >}}) page. The **Gateway EUI** should be the **Gateway ID** that you have copied from the LPS8N's Web UI.

{{< figure src="add-gateway.png" alt="Add Gateway" >}}

Finally, test your connection by going to the LPS8N's **Overview** page. You should see the gateway status changed to **connected** (indicated by a blue dot) or observe the frequently updating **Last seen** time. Also, see the **Live data** section for various gateway related activities.

{{< figure src="gateway-add-ok.png" alt="Gateway add OK" >}}

You can also verify the presence of a green tick on the LoRa icon in the Web UI.
## Connect to {{% tts %}}

{{< figure src="lorawan-ok.png" alt="LoRaWAN OK" >}}
After completing the basic configuration, follow the instructions to [Connect Dragino LPS8N with {{< lbs >}}]({{< relref "lbs" >}}) or to [Connect Dragino LPS8N with {{% udp-pf %}}]({{< relref "udp" >}}).
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
50 changes: 50 additions & 0 deletions doc/content/gateways/models/dragino-lps8/lbs.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,50 @@
---
title: "Connect Dragino LPS8N with Lora Basics™ Station"
description: ""
---

This section contains instructions for connecting the Dragino LPS8N LoRaWAN® gateway to {{% tts %}} using [{{% lbs %}}]({{< ref "/gateways/concepts/lora-basics-station" >}}).

<!--more-->

## Registering Gateway

In the {{% tts %}} console, go to the **Gateways** tab and click the **Register Gateway** button to register the gateway and make sure to select these three settings below:

{{< figure src="../register-lbs.png" alt="" width="80%">}}

When the keys popup shows after registering, download the keys, and click **I have downloaded the keys**.

{{< figure src="../register-lbs-keys.png" alt="" >}}

{{< note >}}
If you have already registered your gateway and forgot to check the boxes, or if you have been using UDP and want to switch to {{% lbs %}}, [create API keys manually](https://www.thethingsindustries.com/docs/gateways/concepts/lora-basics-station/cups/#create-separate-cups-and-lns-api-keys).
{{< /note >}}

### Configuring Gateway

In the Gateway's Web UI, navigate to **LoRaWAN > LoRaWAN** in the top menu.

On this page, configure the following settings:

- **Service Provider**: `The Things Network -- Basic Station`
- **CUPS Server URI**: {{% tts %}} server address with port 443 (e.g. `https://eu1.cloud.thethings.network:443`)
- **CUPS Authorization Key**: The CUPS key you just downloaded.
- **LNS Authorization Key**: The LNS key you just downloaded.
- **CUPS Certificate Authority**: Install a certificate by clicking on the `DEFAULT_CERTIFICATE` button.

**Note**: When entering the keys, the **"Authorization: Bearer"** field should not be entered in the TTN Basics Station configuration of the gateway.

{{< figure src="../lbs-key.png" alt="" >}}

{{< figure src="../lbs-config.png" alt="" >}}

Once you've done all that, click **Save & Apply**.

Finally, test your connection by going to the LPS8N's **Overview** page. You should see the gateway status changed to **connected** (indicated by a blue dot) or observe the frequently updating **Last seen** time. Also, see the **Live data** section for various gateway related activities.

{{< figure src="../gateway-add-ok.png" alt="Gateway add OK" >}}

You can also verify the presence of a green tick on the LoRa icon in the Web UI.

{{< figure src="../lorawan-ok.png" alt="LoRaWAN OK" >}}
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
39 changes: 39 additions & 0 deletions doc/content/gateways/models/dragino-lps8/udp.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,39 @@
---
title: "Connect Dragino LPS8N with UDP Packet Forwarder"
description: ""
---

This section contains instructions for connecting the Dragino LPS8N LoRaWAN® gateway to {{% tts %}} using the [{{% udp-pf %}}]({{< ref "/gateways/concepts/udp" >}}).

<!--more-->

On the Web UI, navigate to **LoRaWAN > LoRaWAN** in the menu.

On the LoRaWAN Configuration page, configure the following settings:

1. **Service Provider**: `The Things Network V3`
2. **Server Address**: {{% tts %}} server address (e.g. `eu1.cloud.thethings.network`)
3. **Gateway ID**: This is the default Gateway EUI for LPS8N. You can keep it as is.
4. **Uplink Port**: `1700`
5. **Downlink Port**: `1700`

Copy the **Gateway ID** which you will need in the next step.
{{< note "The LPS8N Gateway ID is equivalent to {{% tts %}} Gateway EUI." />}}

Select **Save & Apply**.

{{< figure src="../lorawan-config.png" alt="LoRaWAN Configuration" >}}

## Adding LPS8N to {{% tts %}}

You can add the LPS8N gateway to {{% tts %}} by following the instructions on the [ Adding Gateways]({{< ref "/gateways/concepts/adding-gateways" >}}) page. Use the **Gateway ID** value that you previously copied for the **Gateway EUI** field.

{{< figure src="../add-gateway.png" alt="Add Gateway" >}}

Finally, test your connection by going to the LPS8N's **Overview** page. You should see the gateway status changed to **connected** (indicated by a blue dot) or observe the frequently updating **Last seen** time. Also, see the **Live data** section for various gateway related activities.

{{< figure src="../gateway-add-ok.png" alt="Gateway add OK" >}}

You can also verify the presence of a green tick on the LoRa icon in the Web UI.

{{< figure src="../lorawan-ok.png" alt="LoRaWAN OK" >}}

0 comments on commit 5b8aace

Please sign in to comment.