Skip to content

Commit

Permalink
doc: Add server address for TTKG (#1038)
Browse files Browse the repository at this point in the history
  • Loading branch information
KrishnaIyer committed Feb 21, 2023
1 parent 4445e2e commit 15a5eca
Show file tree
Hide file tree
Showing 2 changed files with 19 additions and 9 deletions.
Expand Up @@ -8,7 +8,7 @@ This page guides you to connect The Things Kickstarter Gateway to {{% tts %}}.

<!--more-->

The Things Kickstarter Gateway is a LoRaWAN gateway, whose technical specifications can be found in [the official documentation](https://www.thethingsnetwork.org/docs/gateways/gateway/).
The Things Kickstarter Gateway is a LoRaWAN gateway, whose technical specifications can be found in [the official documentation](https://www.thethingsnetwork.org/docs/gateways/gateway/).

## Prerequisites

Expand Down Expand Up @@ -51,17 +51,17 @@ Please allow about 5 mins for the gateway to attempt connection before troublesh

If there are only 3 LEDs active for an extended period of time, unplug the gateway, wait for 10s and then reconnect. Also, try using an Ethernet connection as that improves the network connectivity.

### How can I open or close The Things Kickstarter Gateway?
### How can I open or close The Things Kickstarter Gateway?

To open the gateway, put it down with the antenna socket at the top and (gently) lift the left and right sides of the white shield.

To close the gateway, align the lid and push firmly at the sides so you can hear it snap in place.

### The second time I power my gateway, it takes time to start up. why?
### The second time I power my gateway, it takes time to start up. why?

Upon every power cycle and every 24 hours, the gateway checks for a new firmware. If the latest firmware is not downloaded yet, it will download the new image and perform a reboot in order to install the new image. This can take up to a few minutes. The process is indicated by a flashing power LED. Power cycling during this process is not dangerous, but this process will be restarted on the next start-up, so please be patient!

### What do the LED lights on the gateway indicate?
### What do the LED lights on the gateway indicate?

The LED lights are a great way of understanding the current state of the gateway. Visit the [official documentation page](https://www.thethingsnetwork.org/docs/gateways/gateway/ledstatus/) for a complete list of LED states.

Expand All @@ -71,7 +71,7 @@ To check the status of the gateway, go to {{% tts %}} Console &#8594; **Gateways

If you connect your phone/computer to the same network as your gateway, you can access some gateway information at http://things-gateway.local/info in your web browser.

### How can I reset my gateway?
### How can I reset my gateway?

There are few things you can do by pressing the reset button in different ways:

Expand All @@ -80,15 +80,15 @@ There are few things you can do by pressing the reset button in different ways:
- erase WiFi and activation settings by holding the button for 5 seconds
- erase the full serial flash by holding the button while powering the gateway on

### My gateway is in a reboot loop. How can I fix it?
### My gateway is in a reboot loop. How can I fix it?

A possible cause of this issue is that the LoRa board is not fully pushed in in the socket. Open the lid and push the LoRa board in the socket. If this fix does not work for you, check the [product repository](https://github.com/TheThingsProducts/gateway/issues), browse through issues to search for solution or file a new issue.

### My gateway stays in AP mode. What do I do?
### My gateway stays in AP mode. What do I do?

This behaviour occurs when there is a glitch in the WiFi connection of the gateway. When this happens, your gateway will turn into an AP and devices you used to set up the gateway can connect to it (your laptop or phone). To avoid this, you should remove the gateway from the list of APs from your laptop/phone (*Network Settings &#8594; Things-Gateway-XXXX &#8594; Forget this network*).

### I want to get in-depth insight/read debug messages of my gateway. Is that possible?
### I want to get in-depth insight/read debug messages of my gateway. Is that possible?

The gateway has a UART port on which it prints debug messages. To see these messages you need to connect a device between the gateway and your computer that can read out a UART (e.g. an FTDI cable/board).

Expand All @@ -100,7 +100,7 @@ Now, you need to start a terminal session to UART interface device with `115200@

{{< figure src="screen-macos.png" alt="Sample screen output" >}}

### What steps do I need to take if I want to relocate my gateway?
### What steps do I need to take if I want to relocate my gateway?

There is no need to reconfigure the gateway, however, it is recommended to update the [gateway location settings]({{< ref "/gateways/concepts/adding-gateways#set-gateway-location" >}}) in {{% tts %}} Console for a better accuracy.

Expand Down
10 changes: 10 additions & 0 deletions doc/content/getting-started/server-addresses/_index.md
Expand Up @@ -52,3 +52,13 @@ The CUPS gateway address is a combination of the **protocol** (https), the **ser
**Example 2**: The CUPS address for an `au1` Cloud tenant is `https://tenant.au1.cloud.thethings.industries:443`, where `tenant` should be replaced with your Tenant ID.

**Example 3**: If you installed {{% tts %}} Enterprise or Open Source, the CUPS address is the domain you used in configuration, for example `https://thethings.example.com:443`.

## The Things Kickstarter Gateway Account Server

The The Things Kickstarter Gateway Account Server address is a combination of the **scheme** (https) and the **server address**. The port is inferred from the scheme.

**Example 1**: For the `eu1` The Things Stack Community Edition cluster, the value is `https://eu1.cloud.thethings.network`. Replace `eu1` with the applicable cluster value (ex: `nam1`, `au1` etc).

**Example 2**: For The Things Stack Cloud cluster `au1` with tenant `tenant`, the value is `https://tenant.au1.cloud.thethings.industries`. Replace `tenant` with your Tenant ID and `au1` with the appropriate cluster value.

**Example 3**: If you installed {{% tts %}} Enterprise or Open Source, the address is the domain you used in configuration, for example `https://thethings.example.com`.

0 comments on commit 15a5eca

Please sign in to comment.