Add Dragino LPS8N Basics Station docs #1340
Merged
Conversation
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
nejraselimovic
suggested changes
May 26, 2024
|
|
||
| This section contains instructions for connecting the Dragino LPS8N LoRaWAN® gateway to {{% tts %}} using [{{% lbs %}}]({{< ref "/gateways/concepts/lora-basics-station" >}}). | ||
|
|
||
| If you have not yet registered your gateway, follow [Registering Gateway](#registering-gateway) |
There was a problem hiding this comment.
There is too many repetitive info in the whole page. You should restructure the doc such as:
- register the gateway, check the boxes for API keys ...
- if you have already registered your gateway and forgot to check the boxes, or you've been using UDP and want to switch to LBS, create API keys manually ...
- configure the gateway
There was a problem hiding this comment.
You can also use links from here https://www.thethingsindustries.com/docs/gateways/concepts/lora-basics-station/ to compress this even more. For example, for creating keys part you can say just follow this section https://www.thethingsindustries.com/docs/gateways/concepts/lora-basics-station/cups/#create-separate-cups-and-lns-api-keys
nejraselimovic
suggested changes
Jun 2, 2024
|
|
||
| ## Registering Gateway | ||
|
|
||
| In the The Things Stack 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: |
There was a problem hiding this comment.
Suggested change
| In the The Things Stack 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: | |
| 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". |
There was a problem hiding this comment.
Suggested change
| When the keys popup shows after registering, download the keys, and click "I have downloaded the keys". | |
| When the keys popup shows after registering, download the keys, and click **I have downloaded the keys**. |
| On this page, configure the following settings: | ||
|
|
||
| - **Service Provider**: `The Things Network -- Basic Station` | ||
| - **CUPS Server URI**: your server address with :443 (e.g. `https://eu1.cloud.thethings.network:443`) |
There was a problem hiding this comment.
Suggested change
| - **CUPS Server URI**: your server address with :443 (e.g. `https://eu1.cloud.thethings.network:443`) | |
| - **CUPS Server URI**: {{% tts %}} server address with port 443 (e.g. `https://eu1.cloud.thethings.network:443`) |
| - **Service Provider**: `The Things Network -- Basic Station` | ||
| - **CUPS Server URI**: your server address with :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. |
There was a problem hiding this comment.
Suggested change
| - **LNS Authorization Key**: the LNS key you just downloaded. | |
| - **LNS Authorization Key**: The LNS key you just downloaded. |
| - **CUPS Server URI**: your server address with :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. |
There was a problem hiding this comment.
Suggested change
| - **CUPS Certificate Authority**: Install a certificate by clicking on the `DEFAULT-CERTIFICATE` button. | |
| - **CUPS Certificate Authority**: Install a certificate by clicking on the `DEFAULT_CERTIFICATE` button. |
Comment on lines
10
to
14
| 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 |
There was a problem hiding this comment.
Since this seems to be a prerequisite for both LBS and UDP modes, put this in the main file as part of prerequisites
| On the LoRaWAN Configuration page, configure the following settings: | ||
|
|
||
| 1. **Service Provider**: `The Things Network V3` | ||
| 2. **Server Address**: `eu1.cloud.thethings.network` |
There was a problem hiding this comment.
Is it always this exact server address?
| 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 %}}." />}} |
There was a problem hiding this comment.
Suggested change
| {{< note "The LPS8N Web UI refers to Gateway EUI as the Gateway ID, which is the Gateway EUI for {{% tts %}}." />}} | |
| {{< note "The LPS8N Gateway ID is equivalent to {{% tts %}} Gateway EUI." />}} |
|
|
||
| ## 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. |
There was a problem hiding this comment.
Suggested change
| 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. | |
| 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. |
Comment on lines
+43
to
+45
| 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" >}} |
There was a problem hiding this comment.
Is this not available for connecting via LBS or?
There was a problem hiding this comment.
I wouldn't know for sure, but i would guess so. I'll add it
nejraselimovic
approved these changes
Jun 9, 2024
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Summary
Add documentation for setting up the Dragino LPS8N with Basic Station
Closes #1332
Screenshots
Changes
Notes for Reviewers
...
Checklist
make server, posted screenshots, verified external links. Test withHUGO_PARAMS_SEARCH_ENABLED=trueif style changes will affect the search bar.new-in-versionshortcode, according to the guidelines in CONTRIBUTING.