Skip to Content

Wiki source code of Notes for LORIOT

Version 76.1 by Kilight Cao on 2023/11/01 16:59
Hide last authors
Xiaoling 1.4 1 (% class="wikigeneratedid" %)
Xiaoling 52.4 2 **~ Table of Contents:**
Xiaoling 1.1 3
Xiaoling 1.6 4 {{toc/}}
Xiaoling 1.4 5
Xiaoling 48.4 6
7
8
Xiaoling 1.4 9 = 1. Introduction =
10
Xiaoling 52.5 11
Xiaoling 1.4 12 (((
Xiaoling 1.7 13 (((
Kilight Cao 63.1 14 The Dragino LoRaWAN gateway can communicate with [[LORIOT>>url:https://www.loriot.io/]] LoRaWAN Network Server:
Xiaoling 1.4 15 )))
Xiaoling 1.7 16 )))
Xiaoling 1.1 17
Xiaoling 1.4 18 (((
Xiaoling 1.7 19 (((
Kilight Cao 67.1 20 Below list the products and requirements that support communication with LORIOT using Semtech UDP:
Xiaoling 1.4 21 )))
Xiaoling 1.7 22 )))
Xiaoling 1.1 23
Xiaoling 1.7 24 (((
Kilight Cao 67.1 25 (((
Xiaoling 68.2 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]]
Kilight Cao 67.1 27
28 (((
29 (((
Xiaoling 68.2 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/]]
Kilight Cao 67.1 31
32
Xiaoling 1.4 33 )))
Xiaoling 1.7 34 )))
Kilight Cao 67.1 35
36 Below list the products and requirements that support the use of LORIOT software:
37 )))
38 )))
39
Xiaoling 68.2 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]]
Kilight Cao 67.1 41
Xiaoling 1.7 42 (((
Kilight Cao 67.1 43 (((
Kilight Cao 69.1 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]]
Xiaoling 32.2 45
46
Xiaoling 1.4 47 )))
Xiaoling 1.7 48 )))
Xiaoling 1.1 49
Kilight Cao 63.1 50 = 2. Gateway Registration for Semtech UDP =
Xiaoling 1.1 51
Xiaoling 1.4 52 == 2.1 Step 1: Get Gateway ETH0 MAC Address ==
Xiaoling 1.1 53
Xiaoling 52.6 54
Xiaoling 68.2 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.
Kilight Cao 63.1 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
Xiaoling 68.2 67 (% style="color:blue" %)**Choose gateway model**
Kilight Cao 63.1 68
Kilight Cao 65.1 69 [[image:image-20220831111132-3.png||height="596" width="1223"]]
Kilight Cao 63.1 70
71
Xiaoling 68.2 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
Kilight Cao 65.1 73
74 [[image:image-20220831115222-11.png||height="596" width="1221"]]
75
76
Xiaoling 68.2 77 (% style="color:blue" %)**Enter the ETH0 MAC of the gateway**
Kilight Cao 63.1 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" %)
Xiaoling 1.4 91 (((
Kilight Cao 63.1 92 Server Address:  ~-~-> LORIOT Different servers use different addresses, Such as: **next.loriot.io**
Xiaoling 52.6 93
Kilight Cao 63.1 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
Kilight Cao 66.1 127
Kilight Cao 75.1 128 = 3. Gateway Registration for Basics Station =
Kilight Cao 63.1 129
130
Kilight Cao 75.1 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
Kilight Cao 63.1 133 (((
Kilight Cao 75.1 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
Kilight Cao 76.1 147 == 3.1 Step 1: Register Gateway ==
Kilight Cao 75.1 148
149 [[image:image-20231101162122-1.png||height="528" width="1022"]]
150
Kilight Cao 76.1 151
Kilight Cao 75.1 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 (((
Kilight Cao 63.1 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
Xiaoling 52.6 220
Xiaoling 1.4 221 )))
Xiaoling 1.1 222
Xiaoling 4.2 223 [[image:image-20220524175559-2.png]]
Xiaoling 1.1 224
Xiaoling 1.2 225 Get ETH0 MAC address
Xiaoling 1.1 226
Xiaoling 52.7 227
Xiaoling 1.4 228 (((
Xiaoling 52.7 229 (% style="color:red" %)**Note**: **To make set up more friendly, the ETH0 will show on the LORIOT page in a new firmware version.**
Xiaoling 32.2 230
231
Xiaoling 1.4 232 )))
Xiaoling 1.1 233
Kilight Cao 75.1 234 == 4.2 Step 2: Choose LORIOT service ==
Xiaoling 1.1 235
Xiaoling 52.10 236
Xiaoling 49.3 237 [[image:image-20220531182035-1.png]]
Xiaoling 1.1 238
Xiaoling 1.2 239 Choose to use LORIOT as LoRaWAN service provider
Xiaoling 1.1 240
Xiaoling 49.3 241
Xiaoling 52.8 242
Xiaoling 50.2 243 [[image:image-20220531182109-2.png]]
Xiaoling 1.1 244
Xiaoling 1.2 245 Install and choose the LORIOT server to be used
246
Xiaoling 32.2 247
Kilight Cao 75.1 248 == 4.3 Step 3: Checking Connection Status ==
Xiaoling 1.2 249
Xiaoling 52.10 250
Xiaoling 51.2 251 [[image:image-20220531182202-3.png]]
Xiaoling 1.2 252
253 Click to Home page and check the connection status
254
Xiaoling 32.2 255
Kilight Cao 75.1 256 == 4.4 Step 4: Setup Account in LORIOT ==
Xiaoling 1.2 257
Xiaoling 52.9 258
Xiaoling 1.2 259 Login [[LORIOT>>url:https://www.loriot.io/]] and create account
260
Xiaoling 52.2 261 [[image:image-20220531182253-4.png]]
Xiaoling 1.2 262
263 Log in LORIOT portal
264
265
Xiaoling 52.9 266
Xiaoling 1.4 267 Choose to use the server same as the gateway setting
268
Xiaoling 32.2 269 [[image:image-20220526111312-1.png||height="493" width="1098"]]
Xiaoling 1.2 270
271 Choose server
272
273
Xiaoling 52.9 274
Xiaoling 1.4 275 Create a New Network
276
Xiaoling 32.2 277 [[image:image-20220526111425-2.png||height="579" width="1378"]]
Xiaoling 1.2 278
279 Create a New Network
280
281
Xiaoling 32.2 282 [[image:image-20220526111500-3.png]]
Xiaoling 1.5 283
Xiaoling 1.2 284 Create a New Network
285
Xiaoling 32.2 286
Kilight Cao 75.1 287 == 4.5 Step 5: Register the gateway ==
Xiaoling 1.2 288
Xiaoling 52.9 289
Xiaoling 32.2 290 [[image:image-20220526111650-4.png]]
Xiaoling 1.2 291
292 Register the Gateway in LORIOT
293
294
Xiaoling 52.9 295
Xiaoling 1.2 296 Choose LG308 as gateway model
297
Xiaoling 32.2 298 [[image:image-20220526111742-5.png||height="496" width="1372"]]
Xiaoling 1.2 299
300 Choose LG308 as gateway model
301
302
Xiaoling 52.9 303
Xiaoling 1.2 304 Input Gateway ETH0 address
305
Xiaoling 35.2 306 [[image:image-20220526111918-6.png||height="744" width="1336"]]
Xiaoling 1.2 307
308 Choose SX1301 Reference and use SPI protocol
309
310
Xiaoling 52.9 311
Xiaoling 1.2 312 Choose the right Frequency Band and input location
313
Xiaoling 35.2 314 [[image:image-20220526112029-7.png||height="620" width="1306"]]
Xiaoling 1.2 315
316 Set up regional settings.
317
Xiaoling 45.2 318
Kilight Cao 75.1 319 == 4.6 Step 6: Check Connection ==
Xiaoling 1.2 320
Xiaoling 52.9 321
Xiaoling 1.5 322 (((
Xiaoling 1.2 323 LORIOT will show disconnect if Gateway doesn't connect
Xiaoling 1.5 324 )))
Xiaoling 1.2 325
Xiaoling 1.5 326 (((
Xiaoling 1.2 327 LORIOT will show connect if Gateway connect to LORIOT ok.
Xiaoling 52.9 328
329
Xiaoling 1.5 330 )))
Xiaoling 1.2 331
Xiaoling 36.2 332 [[image:image-20220526112143-8.png||height="654" width="1373"]]
Xiaoling 1.2 333
334 Status: Connected
335
Xiaoling 45.2 336
Kilight Cao 75.1 337 == 4.7 Debug If there is connection issue ==
Xiaoling 1.2 338
Xiaoling 52.9 339
Xiaoling 1.2 340 User can check if loriot is running by checking the web ui
341
Xiaoling 52.9 342
Xiaoling 45.2 343 [[image:image-20220526112917-18.png]]
Xiaoling 1.2 344
345 Status: Connected
346
Xiaoling 52.9 347
Xiaoling 1.11 348 (((
Xiaoling 1.2 349 If user want to see more log, he can run below commands in Linux and see the full log:
Xiaoling 1.11 350 )))
Xiaoling 1.2 351
Xiaoling 1.5 352 (% class="box" %)
353 (((
Xiaoling 1.8 354 (((
Xiaoling 1.11 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
Xiaoling 1.5 357 )))
Xiaoling 1.8 358 )))
Xiaoling 1.2 359
Xiaoling 1.11 360 (((
Xiaoling 52.9 361
362
Xiaoling 1.2 363 Above two commands will first kill the loriot process and run it again to get more output.
Xiaoling 1.11 364 )))
Xiaoling 1.2 365
Xiaoling 47.2 366 [[image:image-20220530145011-1.png]]
Xiaoling 1.2 367
368 Get more debug info
369
Xiaoling 45.2 370
Kilight Cao 75.1 371 = 5. End Device Note =
Xiaoling 1.2 372
Kilight Cao 75.1 373 == 5.1 Downlink Setup ==
Xiaoling 1.2 374
Xiaoling 52.9 375
Xiaoling 48.2 376 [[image:image-20220530145133-2.png]]
Xiaoling 1.2 377
Xiaoling 45.2 378
Xiaoling 41.2 379 [[image:image-20220526112416-11.png]]
Xiaoling 1.2 380
Xiaoling 45.2 381
Xiaoling 41.2 382 [[image:image-20220526112459-12.png]]
Xiaoling 1.2 383
Xiaoling 45.2 384
Xiaoling 41.2 385 [[image:image-20220526112537-13.png]]
Xiaoling 1.2 386
Xiaoling 45.2 387
Xiaoling 41.2 388 [[image:image-20220526112608-14.png||height="610" width="1382"]]
Xiaoling 1.2 389
Xiaoling 45.2 390
Xiaoling 44.2 391 [[image:image-20220526112655-15.png]]
Xiaoling 1.2 392
Xiaoling 45.2 393
Xiaoling 44.2 394 [[image:image-20220526112719-16.png]]
Xiaoling 1.2 395
Xiaoling 45.2 396
Xiaoling 44.2 397 [[image:image-20220526112759-17.png||height="483" width="1386"]]