Wiki source code of Notes for LORIOT

Version 76.1 by Kilight Cao on 2023/11/01 16:59
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
152 Enter the gateway ID into the Custom EUI
153
154 [[image:image-20231101162623-2.png||height="526" width="1024"]]
155
156
157 == 3.2  Step 2: Generate and Download TLS Certificate ==
158
159 [[image:image-20231101163647-3.png||height="529" width="1024"]]
160
161
162 Download LORIOT's three TLS certificates, which are:
163
164 (% style="color:red" %)**DigiCert_Global_Root_G2.crt , "Gateway EUI".gws.loriot.io.crt , "Gateway EUI".gws.loriot.io.key**
165
166 [[image:image-20231101163743-4.png||height="528" width="1024"]]
167
168
169
170 == 3.3  Step 3: Access the gateway GUI ==
171
172 User need to upload the TLS certificate and configure the LNS URI
173
174
175 == 3.4  Step 4: Configure Station ==
176
177 User need to input Server URI, Server CUPS Key and LNS Key, as well as install CUPS certificate.
178
179 (% style="color:blue" %)**just to clarify:**
180
181 Server URI  ~-~->  Server Address, Example: wss:~/~/ap2.loriot.io:717
182 TLS CA Certificate         ~-~-> 
183 TLS Key  ~-~-> 
184 TLS Certificate  ~-~->   
185
186
187 == 3.5  Start Station ==
188
189 When the user has finished the configuration, Please click "Save&Apply" to start station to connect LORIOT.
190
191
192 == 3.6  Check Connection ==
193
194 If user completes the above steps,which will see Log in the LORIOT.
195
196 [[image:image-20231101165306-5.png||height="542" width="1050"]]
197
198
199 == 3.7  Trouble Shooting ==
200
201 User can check the station log in the** LogRead ~-~-> System Log **page.
202
203 [[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"]]
204
205
206 and recode the station log in the** LogRead  ~-~->  Recode Log** page.
207
208 [[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"]]
209
210
211
212 = 4. Gateways are connected using LORIOT software =
213
214 == 4.1 Step 1: Get Gateway ETH0 MAC Address ==
215
216
217 (((
218 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.
219
220
221 )))
222
223 [[image:image-20220524175559-2.png]]
224
225 Get ETH0 MAC address
226
227
228 (((
229 (% style="color:red" %)**Note**: **To make set up more friendly, the ETH0 will show on the LORIOT page in a new firmware version.**
230
231
232 )))
233
234 == 4.2 Step 2: Choose LORIOT service ==
235
236
237 [[image:image-20220531182035-1.png]]
238
239 Choose to use LORIOT as LoRaWAN service provider
240
241
242
243 [[image:image-20220531182109-2.png]]
244
245 Install and choose the LORIOT server to be used
246
247
248 == 4.3 Step 3: Checking Connection Status ==
249
250
251 [[image:image-20220531182202-3.png]]
252
253 Click to Home page and check the connection status
254
255
256 == 4.4 Step 4: Setup Account in LORIOT ==
257
258
259 Login [[LORIOT>>url:https://www.loriot.io/]] and create account
260
261 [[image:image-20220531182253-4.png]]
262
263 Log in LORIOT portal
264
265
266
267 Choose to use the server same as the gateway setting
268
269 [[image:image-20220526111312-1.png||height="493" width="1098"]]
270
271 Choose server
272
273
274
275 Create a New Network
276
277 [[image:image-20220526111425-2.png||height="579" width="1378"]]
278
279 Create a New Network
280
281
282 [[image:image-20220526111500-3.png]]
283
284 Create a New Network
285
286
287 == 4.5 Step 5: Register the gateway ==
288
289
290 [[image:image-20220526111650-4.png]]
291
292 Register the Gateway in LORIOT
293
294
295
296 Choose LG308 as gateway model
297
298 [[image:image-20220526111742-5.png||height="496" width="1372"]]
299
300 Choose LG308 as gateway model
301
302
303
304 Input Gateway ETH0 address
305
306 [[image:image-20220526111918-6.png||height="744" width="1336"]]
307
308 Choose SX1301 Reference and use SPI protocol
309
310
311
312 Choose the right Frequency Band and input location
313
314 [[image:image-20220526112029-7.png||height="620" width="1306"]]
315
316 Set up regional settings.
317
318
319 == 4.6 Step 6: Check Connection ==
320
321
322 (((
323 LORIOT will show disconnect if Gateway doesn't connect
324 )))
325
326 (((
327 LORIOT will show connect if Gateway connect to LORIOT ok.
328
329
330 )))
331
332 [[image:image-20220526112143-8.png||height="654" width="1373"]]
333
334 Status: Connected
335
336
337 == 4.7 Debug If there is connection issue ==
338
339
340 User can check if loriot is running by checking the web ui
341
342
343 [[image:image-20220526112917-18.png]]
344
345 Status: Connected
346
347
348 (((
349 If user want to see more log, he can run below commands in Linux and see the full log:
350 )))
351
352 (% class="box" %)
353 (((
354 (((
355 ps | grep "loriot_dragino" | grep -v grep | awk '{print $1}' | xargs kill -s 9
356 /usr/bin/loriot_dragino_lg308_spi -f -s eu1.loriot.io
357 )))
358 )))
359
360 (((
361
362
363 Above two commands will first kill the loriot process and run it again to get more output.
364 )))
365
366 [[image:image-20220530145011-1.png]]
367
368 Get more debug info
369
370
371 = 5. End Device Note =
372
373 == 5.1 Downlink Setup ==
374
375
376 [[image:image-20220530145133-2.png]]
377
378
379 [[image:image-20220526112416-11.png]]
380
381
382 [[image:image-20220526112459-12.png]]
383
384
385 [[image:image-20220526112537-13.png]]
386
387
388 [[image:image-20220526112608-14.png||height="610" width="1382"]]
389
390
391 [[image:image-20220526112655-15.png]]
392
393
394 [[image:image-20220526112719-16.png]]
395
396
397 [[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