Wiki source code of Notes for LORIOT

Version 75.1 by Kilight Cao on 2023/11/01 16:57
Show last authors
1 (% class="wikigeneratedid" %)
2 **~ Table of Contents:**
3
4 {{toc/}}
5
6
7
8
9 = 1. Introduction =
10
11
12 (((
13 (((
14 The Dragino LoRaWAN gateway can communicate with [[LORIOT>>url:https://www.loriot.io/]] LoRaWAN Network Server:
15 )))
16 )))
17
18 (((
19 (((
20 Below list the products and requirements that support communication with LORIOT using Semtech UDP:
21 )))
22 )))
23
24 (((
25 (((
26 ~1. LoRaWAN Gateway model: [[LPS8>>url:http://www.dragino.com/products/lora-lorawan-gateway/item/148-lps8.html]], [[LG308>>url:http://www.dragino.com/products/lora-lorawan-gateway/item/140-lg308.html]], [[DLOS8>>url:http://www.dragino.com/products/lora-lorawan-gateway/item/160-dlos8.html]],[[LPS8N>>https://www.dragino.com/products/lora-lorawan-gateway/item/228-lps8v2.html]],[[LG308N>>https://www.dragino.com/products/lora-lorawan-gateway/item/229-lg308n.html]]
27
28 (((
29 (((
30 2. Firmware version since : [[lgw~~-~~-build-v5.4.1661158991-20220822-1704>>https://www.dragino.com/downloads/index.php?dir=LoRa_Gateway/LPS8/Firmware/Release/]]
31
32
33 )))
34 )))
35
36 Below list the products and requirements that support the use of LORIOT software:
37 )))
38 )))
39
40 ~1. LoRaWAN Gateway model: [[LPS8>>url:http://www.dragino.com/products/lora-lorawan-gateway/item/148-lps8.html]], [[LG308>>url:http://www.dragino.com/products/lora-lorawan-gateway/item/140-lg308.html]], [[DLOS8>>url:http://www.dragino.com/products/lora-lorawan-gateway/item/160-dlos8.html]]
41
42 (((
43 (((
44 2. Firmware version since :[[dragino-LORIOT~~-~~-v5.4.1676942123-squashfs-sysupgrade.bin>>http://repo.dragino.com/release/openwrt-firmware/lgw/dragino-LORIOT--v5.4.1676942123-squashfs-sysupgrade.bin]]
45
46
47 )))
48 )))
49
50 = 2. Gateway Registration for Semtech UDP =
51
52 == 2.1 Step 1: Get Gateway ETH0 MAC Address ==
53
54
55 Dragino LoRaWAN gateway uses ETH0 MAC address to generate Gateway EUI to communicate with LORIOT, The user needs to find the ETH0 MAC in the "(% style="color:blue" %)**System -> System Overview**" (%%)menu.
56
57
58 [[image:image-20220831110558-1.png||height="595" width="909"]]
59
60
61 == 2.2 Step 2: Register Gateway ==
62
63
64 [[image:image-20220831111032-2.png||height="617" width="1263"]]
65
66
67 (% style="color:blue" %)**Choose gateway model**
68
69 [[image:image-20220831111132-3.png||height="596" width="1223"]]
70
71
72 (% style="color:red" %)**Special reminder: **(%%)If the user does not find the gateway Model, then (% style="color:blue" %)**git ~-~-> Packet Forwarder Semtech**(%%)  can be selected
73
74 [[image:image-20220831115222-11.png||height="596" width="1221"]]
75
76
77 (% style="color:blue" %)**Enter the ETH0 MAC of the gateway**
78
79 [[image:image-20220831111307-4.png||height="850" width="1237"]]
80
81
82 [[image:image-20220831111821-5.png||height="604" width="1239"]]
83
84
85 == 2.3 Step 3: Back to Semtech UDP page ==
86
87
88 Back to the page of Semtech UDP check the secondary server settings and click the button of (% style="color:blue" %)**Save&Apply.**
89
90 (% class="box infomessage" %)
91 (((
92 Server Address:  ~-~-> LORIOT Different servers use different addresses, Such as: **next.loriot.io**
93
94 Uplink /Downlink Port :  ~-~-> 1780
95 )))
96
97 [[image:image-20220831112553-7.png]]
98
99
100 == 2.4 Step 4: Check Connection ==
101
102
103 (((
104 LORIOT will show disconnect if Gateway doesn't connect
105 )))
106
107 (((
108 LORIOT will show connect if Gateway connect to LORIOT ok.
109 )))
110
111 [[image:image-20220831114125-8.png||height="561" width="1150"]]
112
113
114 == 2.5  Trouble Shooting ==
115
116
117 User can check the station log in the(% style="color:blue" %)** LogRead ~-~-> System Log **(%%)page.
118
119 [[image:image-20220831114647-9.png||height="706" width="894"]]
120
121
122 and recode the station log in the (% style="color:blue" %)** LogRead  ~-~->  Recode Log**(%%) page.
123
124 [[image:image-20220831114746-10.png||height="292" width="972"]]
125
126
127
128 = 3. Gateway Registration for Basics Station =
129
130
131 The LoRa Basics™ Station protocol simplifies the management of large-scale LoRaWAN networks. LoRa Basics™ Station is the preferred way of connecting Gateways to LORIOT. [[The LoRa Basics Station doc>>url:https://www.thethingsindustries.com/docs/gateways/lora-basics-station/]]
132
133 (((
134 (% style="color:blue" %)**Below list the support products and Requirements:**
135 )))
136
137 1. LoRaWAN Gateway model:  [[LIG16>>url:http://www.dragino.com/products/lora-lorawan-gateway/item/171-lig16.html]], [[LG308>>url:http://www.dragino.com/products/lora-lorawan-gateway/item/140-lg308.html]], [[DLOS8>>url:http://www.dragino.com/products/lora-lorawan-gateway/item/160-dlos8.html]] ,[[LPS8>>url:http://www.dragino.com/products/lora-lorawan-gateway/item/148-lps8.html]]
138
139 2.  Firmware version since :       
140
141
142 (% style="color:blue" %)**What do you need to prepare?**
143
144 A gateway that can access the internet normally
145
146
147 === 3.1 Step 1: Register Gateway ===
148
149 [[image:image-20231101162122-1.png||height="528" width="1022"]]
150
151 Enter the gateway ID into the Custom EUI
152
153 [[image:image-20231101162623-2.png||height="526" width="1024"]]
154
155
156 == 3.2  Step 2: Generate and Download TLS Certificate ==
157
158 [[image:image-20231101163647-3.png||height="529" width="1024"]]
159
160
161 Download LORIOT's three TLS certificates, which are:
162
163 (% style="color:red" %)**DigiCert_Global_Root_G2.crt , "Gateway EUI".gws.loriot.io.crt , "Gateway EUI".gws.loriot.io.key**
164
165 [[image:image-20231101163743-4.png||height="528" width="1024"]]
166
167
168
169 == 3.3  Step 3: Access the gateway GUI ==
170
171 User need to upload the TLS certificate and configure the LNS URI
172
173
174 == 3.4  Step 4: Configure Station ==
175
176 User need to input Server URI, Server CUPS Key and LNS Key, as well as install CUPS certificate.
177
178 (% style="color:blue" %)**just to clarify:**
179
180 Server URI  ~-~->  Server Address, Example: wss:~/~/ap2.loriot.io:717
181 TLS CA Certificate         ~-~-> 
182 TLS Key  ~-~-> 
183 TLS Certificate  ~-~->   
184
185
186 == 3.5  Start Station ==
187
188 When the user has finished the configuration, Please click "Save&Apply" to start station to connect LORIOT.
189
190
191 == 3.6  Check Connection ==
192
193 If user completes the above steps,which will see Log in the LORIOT.
194
195 [[image:image-20231101165306-5.png||height="542" width="1050"]]
196
197
198 == 3.7  Trouble Shooting ==
199
200 User can check the station log in the** LogRead ~-~-> System Log **page.
201
202 [[image:http://wiki.dragino.com/xwiki/bin/download/Main/Notes%20for%20TTN/WebHome/image-20220526135845-15.png?rev=1.1||alt="image-20220526135845-15.png"]]
203
204
205 and recode the station log in the** LogRead  ~-~->  Recode Log** page.
206
207 [[image:http://wiki.dragino.com/xwiki/bin/download/Main/Notes%20for%20TTN/WebHome/image-20220526135940-16.png?rev=1.1||alt="image-20220526135940-16.png"]]
208
209
210
211 = 4. Gateways are connected using LORIOT software =
212
213 == 4.1 Step 1: Get Gateway ETH0 MAC Address ==
214
215
216 (((
217 Dragino LoRaWAN gateway use ETH0 MAC address to generate Gateway ID to communicate with LORIOT, User can get the ETH0 MAC address from SSH access and run **ifconfig** command.
218
219
220 )))
221
222 [[image:image-20220524175559-2.png]]
223
224 Get ETH0 MAC address
225
226
227 (((
228 (% style="color:red" %)**Note**: **To make set up more friendly, the ETH0 will show on the LORIOT page in a new firmware version.**
229
230
231 )))
232
233 == 4.2 Step 2: Choose LORIOT service ==
234
235
236 [[image:image-20220531182035-1.png]]
237
238 Choose to use LORIOT as LoRaWAN service provider
239
240
241
242 [[image:image-20220531182109-2.png]]
243
244 Install and choose the LORIOT server to be used
245
246
247 == 4.3 Step 3: Checking Connection Status ==
248
249
250 [[image:image-20220531182202-3.png]]
251
252 Click to Home page and check the connection status
253
254
255 == 4.4 Step 4: Setup Account in LORIOT ==
256
257
258 Login [[LORIOT>>url:https://www.loriot.io/]] and create account
259
260 [[image:image-20220531182253-4.png]]
261
262 Log in LORIOT portal
263
264
265
266 Choose to use the server same as the gateway setting
267
268 [[image:image-20220526111312-1.png||height="493" width="1098"]]
269
270 Choose server
271
272
273
274 Create a New Network
275
276 [[image:image-20220526111425-2.png||height="579" width="1378"]]
277
278 Create a New Network
279
280
281 [[image:image-20220526111500-3.png]]
282
283 Create a New Network
284
285
286 == 4.5 Step 5: Register the gateway ==
287
288
289 [[image:image-20220526111650-4.png]]
290
291 Register the Gateway in LORIOT
292
293
294
295 Choose LG308 as gateway model
296
297 [[image:image-20220526111742-5.png||height="496" width="1372"]]
298
299 Choose LG308 as gateway model
300
301
302
303 Input Gateway ETH0 address
304
305 [[image:image-20220526111918-6.png||height="744" width="1336"]]
306
307 Choose SX1301 Reference and use SPI protocol
308
309
310
311 Choose the right Frequency Band and input location
312
313 [[image:image-20220526112029-7.png||height="620" width="1306"]]
314
315 Set up regional settings.
316
317
318 == 4.6 Step 6: Check Connection ==
319
320
321 (((
322 LORIOT will show disconnect if Gateway doesn't connect
323 )))
324
325 (((
326 LORIOT will show connect if Gateway connect to LORIOT ok.
327
328
329 )))
330
331 [[image:image-20220526112143-8.png||height="654" width="1373"]]
332
333 Status: Connected
334
335
336 == 4.7 Debug If there is connection issue ==
337
338
339 User can check if loriot is running by checking the web ui
340
341
342 [[image:image-20220526112917-18.png]]
343
344 Status: Connected
345
346
347 (((
348 If user want to see more log, he can run below commands in Linux and see the full log:
349 )))
350
351 (% class="box" %)
352 (((
353 (((
354 ps | grep "loriot_dragino" | grep -v grep | awk '{print $1}' | xargs kill -s 9
355 /usr/bin/loriot_dragino_lg308_spi -f -s eu1.loriot.io
356 )))
357 )))
358
359 (((
360
361
362 Above two commands will first kill the loriot process and run it again to get more output.
363 )))
364
365 [[image:image-20220530145011-1.png]]
366
367 Get more debug info
368
369
370 = 5. End Device Note =
371
372 == 5.1 Downlink Setup ==
373
374
375 [[image:image-20220530145133-2.png]]
376
377
378 [[image:image-20220526112416-11.png]]
379
380
381 [[image:image-20220526112459-12.png]]
382
383
384 [[image:image-20220526112537-13.png]]
385
386
387 [[image:image-20220526112608-14.png||height="610" width="1382"]]
388
389
390 [[image:image-20220526112655-15.png]]
391
392
393 [[image:image-20220526112719-16.png]]
394
395
396 [[image:image-20220526112759-17.png||height="483" width="1386"]]

Applications

Navigation

Copyright ©2010-2022 Dragino Technology Co., LTD. All rights reserved
Dragino Wiki v2.0