Skip to content

Commit 085c00e

Browse files
author
Donatien Garnier
authored
Merge pull request #1453 from laurensslats/development
Update outdated LoRaWAN tutorial
2 parents bfa7be4 + 83b9c46 commit 085c00e

File tree

14 files changed

+15
-39
lines changed

14 files changed

+15
-39
lines changed

docs/api/connectivity/tutorials/intro-to-lora.md

Lines changed: 15 additions & 39 deletions
Original file line numberDiff line numberDiff line change
@@ -82,7 +82,7 @@ You now need to configure the gateway by installing software to scan the spectru
8282

8383
#### Kerlink Wirnet stations
8484

85-
Follow the instructions in [this document](https://www.thethingsnetwork.org/docs/gateways/kerlink/config.html).
85+
Follow the instructions in [this document](https://www.thethingsnetwork.org/docs/devices-and-gateways/).
8686

8787
#### MultiTech Conduit
8888

@@ -115,34 +115,20 @@ Follow the instructions in [this document](https://github.com/ttn-zh/ic880a-gate
115115

116116
### Registering the gateway
117117

118-
1. [Sign up](https://console.thethingsnetwork.org) for an account at The Things Network.
119-
1. You're redirected to the dashboard page.
118+
1. [Sign up](https://account.thethingsnetwork.org/users/login) for an account at The Things Network.
119+
1. Visit the [Development Console](https://console.cloud.thethings.network/) and select the cluster closest to you.
120120
1. Click **Gateways**.
121121

122122
<span class="images">![](../../../images/ttn1.png)</span>
123123

124-
1. Click **Register gateway**.
125-
126-
<span class="images">![](../../../images/ttn2.png)</span>
127-
124+
1. Click **Add Gateway**.
128125
1. Fill in the details of your gateway.
129-
130-
<span class="images">![](../../../images/ttn3.png)<span>Gateway details: The Things Network uses the gateway location to create coverage maps, so make sure the location is set correctly.</span></span>
131-
132-
1. If you use the Kerlink Wirnet station:
133-
- Tick **I'm using the legacy packet forwarder**.
134-
- Under **Gateway EUI**, enter the EUI of the gateway (printed on the box).
135-
136-
1. If you use the Raspberry Pi:
137-
- Tick **I'm using the legacy packet forwarder**.
138-
- Under **Gateway EUI**, enter the EUI that printed when you called `install.sh` in step 2.1.
139-
140-
1. Click **Register gateway**.
126+
1. Click **Create gateway**.
141127
1. You have created the gateway.
142128

143-
If you use the MultiTech conduit, you need the 'Gateway key' to authenticate the gateway to the network. Copy it.
129+
If you use the MultiTech conduit, you need the 'Gateway key' to authenticate the gateway to the network. Click on **API Keys** and **Add API Key**
144130

145-
<span class="images">![](../../../images/ttn4.png)</span>
131+
<span class="images">![](../../../images/ttn2.png)</span>
146132

147133
### Installing the packet forwarder
148134

@@ -208,32 +194,22 @@ The device EUI and application EUI are globally unique identifiers. You can buy
208194
209195
Register the device in The Things Network, and generate some keys:
210196
211-
1. Go to [The Things Network console](https://console.thethingsnetwork.org).
197+
1. Go to [The Things Network console](https://console.cloud.thethings.network/).
212198
1. Click **Applications**.
213199
1. Click **Add application**.
214-
215-
<span class="images">![](../../../images/ttn8.png)</span>
216-
217200
1. Fill in the details of your application, and click **Add application**.
218201
219202
<span class="images">![](../../../images/ttn9.png)<span>Filling in the application details in The Things Network.</span></span>
220203
221-
1. You're redirected to the application page. Under **Devices**, click **Register device**.
222-
223-
<span class="images">![](../../../images/ttn10.png)</span>
204+
1. You're redirected to the application page. Under **Devices**, click **Add end device**.
205+
1. Search for your device using the tab **From The LoRaWAN Device Repository**, if your device is not in the overview, select the option **Manually**
206+
<span class="images">![](../../../images/ttn12.png)</span>
224207
225208
1. If your device has an EUI printed on it, enter this in **Device EUI**.
226209
227210
<span class="images">![](../../../images/ttn11.png)<span>The device EUI is often printed on the module or on the box.</span></span>
228211
229-
1. If your device does not have an EUI printed on it, press the **generate** button to allocate an EUI from a block owned by The Things Network. Do **not** make an EUI up; it must be globally unique.
230-
231-
<span class="images">![](../../../images/ttn12.png)</span>
232-
233-
1. Fill in the rest of the details, and click **Register**.
234-
235-
<span class="images">![](../../../images/ttn13.png)</span>
236-
212+
1. Fill in the rest of the details, and click **Register end device**.
237213
1. The device page opens. It contains the keys that your device uses when authenticating with the network. Click the `<>` button to get the keys as a byte array. This makes it easy to copy the keys into code.
238214
239215
<span class="images">![](../../../images/ttn14.png)</span>
@@ -305,7 +281,7 @@ Now you can verify whether the setup works by flashing this application to your
305281
306282
1. When compilation succeeds, the compiler sends a file to your computer.
307283
1. Plug your development board into the computer (over micro-USB) to mount it as a USB mass storage device.
308-
1. Once the device mounts, drag the compiled file onto the board. This causes the device to boot. You can then see the device joining and then sending messages in the The Things Network console, under the **Data** tab:
284+
1. Once the device mounts, drag the compiled file onto the board. This causes the device to boot. You can then see the device joining and then sending messages in the The Things Network console, under the **Live data** tab:
309285
310286
<span class="images">![](../../../images/ttn19.png)<span>We've got data!</span></span>
311287
@@ -356,7 +332,7 @@ You can toggle the LED on your development board over LoRa. In the Online Compil
356332
<span class="notes">**Note:** On some development boards, writing `0` to the LED turns them on. On others, writing `1` does this. It depends on the wiring of the board.</span>
357333

358334
1. Compile, and flash the application.
359-
1. When the device is back online, use the The Things Network console to queue a message. Go to your device page, and under **Downlink**, select port **21** and data `01`. Then press **Send**.
335+
1. When the device is back online, use the The Things Network console to queue a message. Go to your device page, and under **Messaging**, select **Downlink** and add port **21** and data `01`. Then press **Schedule downlink**.
360336

361337
<span class="images">![](../../../images/ttn16.png)<span>Queuing a downlink message over port 21</span></span>
362338

@@ -377,7 +353,7 @@ To build this application, first grab an access key from The Things Network:
377353

378354
<span class="images">![](../../../images/ttn17.png)</span>
379355

380-
1. Locate your **Access Key**, click the **show** button and make note of it, as well.
356+
1. Create a new API key via **API Keys** and **Add API key**.
381357

382358
<span class="images">![](../../../images/ttn18.png)</span>
383359

docs/images/.DS_Store

6 KB
Binary file not shown.

docs/images/ttn1.png

20.6 KB
Loading

docs/images/ttn12.png

77.3 KB
Loading

docs/images/ttn14.png

113 KB
Loading

docs/images/ttn16.png

37.5 KB
Loading

docs/images/ttn17.png

17.4 KB
Loading

docs/images/ttn18.png

69 KB
Loading

docs/images/ttn19.png

-85.5 KB
Loading

docs/images/ttn2.png

67.7 KB
Loading

0 commit comments

Comments
 (0)