Wiki source code of Notes for ChirpStack

Last modified by Xiaoling on 2025/03/22 09:21

Hide last authors
Xiaoling 108.4 1 **~ Table of Contents:**
Xiaoling 1.2 2
Xiaoling 1.1 3 {{toc/}}
4
Xiaoling 86.4 5
6
7
Xiaoling 108.4 8 = 1.  Introduction =
Xiaoling 1.1 9
Xiaoling 108.4 10
Kilight Cao 53.1 11 (% style="color:black" %)The ChirpStack open-source LoRaWAN Network Server stack provides open-source components for LoRaWAN networks And the Chirpstack supports the users in building a private LoRaWAN Server. For more info please refer to this [[link>>url:https://www.chirpstack.io/]]
Xiaoling 1.1 12
Xiaoling 1.5 13 (((
Kilight Cao 51.1 14 (% style="color:black" %)The dragino gateway can connect the ChirpStack server via Semtech UDP or Semtech Basic Station.
Xiaoling 108.4 15
16
Xiaoling 1.5 17 )))
Xiaoling 1.1 18
Xiaoling 108.4 19 (% style="color:blue" %)**Prerequisite:**
Xiaoling 1.1 20
Xiaoling 108.4 21 **1) Have a Chirstack Server.**
Xiaoling 1.1 22
Bei Jinggeng 172.1 23 [[image:image-20230821114047-4.png||height="524" width="990"]]
Xiaoling 1.1 24
Xiaoling 1.2 25 ChirpStack home page
Xiaoling 1.1 26
Xiaoling 54.2 27
Xiaoling 1.1 28
Xiaoling 108.4 29 **2) Gateway model support**
30
Xiaoling 1.2 31 (% class="box" %)
32 (((
Xiaoling 1.5 33 (((
Xiaoling 1.2 34 Semtech UDP : **All Model**
Xiaoling 108.4 35 Basic Station : [[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]]
36 (% style="color:red" %)**Note** (%%): the firmware needs >[[lgw~~-~~-build-v5.4.1640315898>>url:https://www.dragino.com/downloads/index.php?dir=LoRa_Gateway/LPS8/Firmware/Release/]]  if use the Bais station
Xiaoling 1.2 37 )))
Xiaoling 1.5 38 )))
Xiaoling 1.1 39
Xiaoling 176.2 40
Bei Jinggeng 164.1 41 = 2.  Node usage introduction =
Xiaoling 86.5 42
Bei Jinggeng 164.1 43 == 2.1 Register Node ==
Xiaoling 1.1 44
45
Xiaoling 176.2 46 **Step 1: Add application**
47
Kilight Cao 220.1 48 [[image:image-20240831154333-1.png||height="553" width="1074"]]
Xiaoling 108.4 49
Bei Jinggeng 164.1 50
Xiaoling 176.2 51 **Step 2:Fill name**
52
Bei Jinggeng 164.1 53 [[image:image-20230702094852-2.png]]
54
55
Xiaoling 176.2 56 **Step3 :Add device profile**
57
Bei Jinggeng 164.1 58 [[image:image-20230702095114-4.png||height="448" width="1061"]]
59
60
Xiaoling 176.2 61 **Step4 :Configure your device profile**
Bei Jinggeng 164.1 62
63 [[image:image-20230702095557-5.png||height="648" width="1121"]]
64
65 Does node support class-c
66
67 [[image:image-20230702095641-6.png||height="349" width="1114"]]
68
69 Add node's decoder
70
71 [[image:image-20230702095827-7.png||height="490" width="1138"]]
72
73
Xiaoling 176.2 74 **Step5 :add device**
Bei Jinggeng 164.1 75
76 [[image:image-20230702094944-3.png||height="439" width="1153"]]
77
78
Xiaoling 176.2 79 [[image:image-20230702100312-8.png||height="550" width="1106"]]
Bei Jinggeng 164.1 80
81
82 [[image:image-20230702100543-10.png||height="313" width="1099"]]
83
Xiaoling 176.2 84
Bei Jinggeng 164.1 85 [[image:image-20230702100930-11.png||height="613" width="1098"]]
86
87
Kilight Cao 176.1 88 = 3.  Semtech UDP for ChirpStack v3 =
Bei Jinggeng 164.1 89
90 == 3.1  Step 1. Add the Network-servers ==
91
92
Xiaoling 1.2 93 The network-Servers address varies depending on the ChirpStack server setup environment
Xiaoling 1.1 94
Xiaoling 1.3 95 (% class="box" %)
96 (((
Xiaoling 108.5 97 Windows       ~-~->  Network-server server *  :  localhost:8000
98 Linux  ~-~->  Network-server server *  :  chirpstack-network-server:8000
Xiaoling 1.3 99 )))
Xiaoling 1.1 100
Xiaoling 108.4 101
Xiaoling 108.6 102 (% style="color:red" %)**If the user cannot add network-Servers, re-check the ChirpStack code or the server building process.**
Xiaoling 1.1 103
Xiaoling 151.2 104 [[image:image-20220531171609-1.png||height="638" width="1268"]](% style="display:none" %)
Xiaoling 1.2 105
106 Add the Network-servers
107
Xiaoling 84.2 108
Bei Jinggeng 164.1 109 == 3.2  Step 2. Create Gateway-profiles ==
Xiaoling 1.2 110
Xiaoling 108.6 111
Xiaoling 151.2 112 [[image:image-20220531171651-2.png||height="632" width="1264"]](% style="display:none" %)
Xiaoling 1.2 113
114 Create Gateway-profiles
115
Xiaoling 84.2 116
Bei Jinggeng 164.1 117 == 3.3  Step 3. Create Service-profiles ==
Xiaoling 108.6 118
119
Xiaoling 151.2 120 [[image:image-20220531171809-3.png||height="761" width="1265"]]
Xiaoling 1.2 121
122 Create Service-profiles
123
Xiaoling 89.3 124
Xiaoling 1.2 125 In Step 3. Create Service-profiles, the above parameters can be set. If necessary, you can set them by yourself. This is only an example.
126
Xiaoling 1.4 127 (% style="color:red" %)**Note : Before add the gateway, the user needs to complete the preceding three steps.**
Xiaoling 1.2 128
Xiaoling 84.2 129 If the user has completed the preceding steps, proceed to the next step.(% style="display:none" %)
Xiaoling 1.2 130
Xiaoling 84.2 131
Bei Jinggeng 164.1 132 == 3.4  Step 4. Add the gateway ==
Xiaoling 1.2 133
Xiaoling 108.7 134
Xiaoling 1.2 135 The example gateway id is: a840411e96744150
136
Xiaoling 1.5 137 (((
Xiaoling 1.4 138 (% style="color:red" %)**Note : The Gateway EUI and server addresses must match the ChirpStack configuration.**
Xiaoling 1.5 139 )))
Xiaoling 1.2 140
Xiaoling 151.2 141 [[image:image-20220531171923-4.png||height="745" width="1253"]](% style="display:none" %)
Xiaoling 1.2 142
143 Add the gateway
144
Xiaoling 108.7 145
Xiaoling 91.2 146 [[image:image-20220531172031-5.png]]
Xiaoling 1.2 147
148 Configure the gateway
149
Xiaoling 84.2 150
Bei Jinggeng 164.1 151 == 3.5  Step 5. Checking gateway Status ==
Xiaoling 108.8 152
153
Xiaoling 151.2 154 [[image:image-20220531172158-6.png||height="704" width="1167"]](% style="display:none" %)
Xiaoling 1.2 155
Xiaoling 84.2 156
Xiaoling 108.8 157
Xiaoling 1.2 158 gateway Status
159
Xiaoling 151.2 160 [[image:image-20220531172304-7.png||height="628" width="1165"]]
Xiaoling 1.2 161
162 gateway Status
163
Xiaoling 176.2 164
Kilight Cao 176.1 165 = 4.  Semtech UDP for ChirpStack v4 =
Xiaoling 86.6 166
Kilight Cao 176.1 167 == 4.1  Step 1. Add the gateway ==
Kilight Cao 9.1 168
Xiaoling 176.2 169
Kilight Cao 176.1 170 [[image:image-20230926092907-1.png||height="598" width="1007"]]
Xiaoling 108.8 171
Kilight Cao 176.1 172
173 [[image:image-20230926093057-2.png||height="541" width="1002"]]
174
175
176 == 4.2  Step 2. Checking gateway Status ==
177
178 [[image:image-20230926093233-3.png||height="581" width="1018"]]
179
180 = 5.  Gateway Registration for Basics Station =
181
182 == 5.1  Introduction ==
183
184
Kilight Cao 9.1 185 The [[Semtech Basic Station>>url:https://doc.sm.tc/station/]] backend implements the [[LNS protocol>>url:https://doc.sm.tc/station/tcproto.html]]. It exposes a WebSocket handler to which Basic Station powered gateways can connect.
186
187 ChirpStack Open-Source LoRaWAN® Network Server needs to set up a configuration that can use Semtech BasicStation.
188
189
Xiaoling 108.8 190 (% style="color:blue" %)**Below list the support products and Requirements:**
191
Kilight Cao 9.1 192 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]]
193 1. Firmware version since :[[lgw~~-~~-build-v5.4.1651822913>>url:https://www.dragino.com/downloads/index.php?dir=LoRa_Gateway/LPS8/Firmware/Test_Firmware/lgw--build-v5.4.1651822913-20220506-1543/]]
194
Xiaoling 108.8 195 (% style="color:blue" %)**How to set up chirpStack Basic Station**
196
Kilight Cao 9.1 197 Users can check out the ChirpStack Basic Station [[link>>https://www.chirpstack.io/gateway-bridge/backends/basic-station/]] and [[forum>>https://forum.chirpstack.io/search?q=basic%20station]]
198
199
Xiaoling 108.8 200 (% style="color:blue" %)**What do you need to prepare**
201
Kilight Cao 9.1 202 A gateway that can access the internet normally
203
Xiaoling 86.7 204
Kilight Cao 176.1 205 == 5.2  Add Gateway ==
Kilight Cao 9.1 206
Xiaoling 108.9 207
Xiaoling 20.2 208 [[image:image-20220524164205-10.png]]
Kilight Cao 9.1 209
Xiaoling 86.8 210
Kilight Cao 176.1 211 == 5.3  Access the gateway GUI ==
Kilight Cao 9.1 212
Xiaoling 108.9 213
Kilight Cao 9.1 214 Access the gateway GUI interface of LoRaWAN~-~->LoRaWAN ~-~- Basic Station
215
Xiaoling 20.2 216 [[image:image-20220524164319-11.png]]
Kilight Cao 9.1 217
Xiaoling 108.9 218
Kilight Cao 9.1 219 User need to Choose the ChirpStack/Senet ~-~- Basic Station , input Server URI and Upload the TLS Certificate
220
221 (% class="box" %)
222 (((
223 Service Provider  ~-~->  Choose the ChirpStack/Senet ~-~- Basic Station
224
Kilight Cao 165.1 225 LNS URI  ~-~->  Enter the LNS URI address, For example : wss:~/~/xxxx.chirpstack.com:443 or ws:~/~/xxxx.chirpstack.com:3001
Kilight Cao 9.1 226
227 LNS TLS trust  ~-~->  Upload the TLS Certificate
228 )))
229
230 (% class="wikigeneratedid" %)
Xiaoling 20.2 231 [[image:image-20220524164341-12.png]]
Kilight Cao 9.1 232
Xiaoling 86.9 233
Kilight Cao 176.1 234 == 5.4  Start Station ==
Kilight Cao 9.1 235
Xiaoling 108.9 236
Xiaoling 108.14 237 When the user has finished the configuration, Please click **Sace&Apply** to start station to connect ChirpStack.
Kilight Cao 9.1 238
Xiaoling 86.10 239
Kilight Cao 176.1 240 == 5.5  Successful Connection ==
Kilight Cao 9.1 241
Xiaoling 108.9 242
Kilight Cao 9.1 243 If user completes the above steps, which will see live date in the ChirpStack.
244
Xiaoling 23.2 245 [[image:image-20220524164448-13.png]]
Kilight Cao 9.1 246
Xiaoling 86.11 247
Kilight Cao 176.1 248 == 5.6  Trouble Shooting ==
Xiaoling 108.9 249
250
Kilight Cao 9.1 251 User can check the station log in the logread/system log page.
252
Xiaoling 95.2 253 [[image:image-20220531172837-8.png]]
Kilight Cao 9.1 254
Xiaoling 86.13 255
Kilight Cao 9.1 256 and recode the station log in the system/Recode log page.
257
Xiaoling 95.2 258 [[image:image-20220531172857-9.png]]
Kilight Cao 9.1 259
Xiaoling 86.12 260
Kilight Cao 176.1 261 = 6.  How the gateway connects to Chirpstack v3 via gateway-bridge =
Xiaoling 108.9 262
Xiaoling 1.2 263
Kilight Cao 128.1 264 (% style="color:blue" %)**Below list the support products and Requirements:**
265
266 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]],[[LPS8N>>url:https://www.dragino.com/products/lora-lorawan-gateway/item/200-lps8n.html]],[[LG308N>>url:https://www.dragino.com/products/lora-lorawan-gateway/item/229-lg308n.html]],[[DLOS8N>>url:https://www.dragino.com/products/lora-lorawan-gateway/item/225-dlos8n.html]]
Kilight Cao 138.1 267 1. Firmware version since: [[Chirpstack-Bridge-V3.14.6>>https://www.dragino.com/downloads/index.php?dir=LoRa_Gateway/LPS8/Firmware/Release/Chirpstack-gateway-bridge/Chirpstack-Bridge-V3.14.6-Bridge--build-v5.4.1679487778-20230322-2024/]]
Kilight Cao 128.1 268
269 (% style="color:blue" %)**What do you need to prepare**
270
271 A gateway that can access the internet normally
272
Xiaoling 1.2 273
Kilight Cao 138.1 274 The following example does not have configuration certificates:
275
Xiaoling 138.2 276
Kilight Cao 176.1 277 == 6.1  Configure Packet Forwarder ==
Xiaoling 131.2 278
279
Kilight Cao 124.1 280 In the Dragino gateway web interface, you need to configure the Packet Forwarder so that it forwards its data to the port. localhost:1700 or 127.0.0.1:1700
Xiaoling 121.2 281
Xiaoling 138.3 282 * In the (% style="color:blue" %)**LoRaWAN** (%%)menu, click on (% style="color:blue" %)**LoRaWAN ~-~- Semtech UDP**
Xiaoling 138.2 283
Kilight Cao 124.1 284 * Make sure the following settings are set:
Xiaoling 138.4 285 ** **Service Provider:** //~-~-Custom/Private LoRaWAN~-~-//
286 ** **LoRaWAN Server Address:** //localhost or 127.0.0.1//
287 ** **Server port for upstream:** //1700//
288 ** **Server port for downstream:** //1700//
Xiaoling 138.2 289
Xiaoling 138.3 290 Click (% style="color:blue" %)**Save & Apply**.
Kilight Cao 124.1 291
292 [[image:image-20221222114220-2.png||height="748" width="931"]]
293
294
Kilight Cao 176.1 295 == 6.2  Configuring gateway frequency ==
Kilight Cao 124.1 296
Kilight Cao 127.1 297
Xiaoling 131.2 298 (% style="color:red" %)**Note: Gateway frequencies must match**
299
Kilight Cao 127.1 300 [[image:image-20221222134830-3.png||height="408" width="923"]]
301
302
Kilight Cao 176.1 303 == 6.3  Generate and modify the gateway-bridge configuration file ==
Kilight Cao 127.1 304
305
Kilight Cao 138.1 306 **1)Generate the gateway-bridge configuration file**
307
308 By default, the configuration file is not up-to-date,so the user needs to rebuild the gateway-bridge configuration file.
309
310 Users need to access the command line of the gateway through SSH,Then type the following command:
311
312 (% class="box infomessage" %)
313 (((
Xiaoling 138.5 314 **/opt/chirpstack-gateway-bridge/chirpstack-gateway-bridge configfile > /etc/chirpstack-gateway-bridge/chirpstack-gateway-bridge.toml **
Kilight Cao 138.1 315 )))
316
317
318 **2)modify the gateway-bridge configuration file**
319
320 The user needs to modify the server address in line 252 in the configuration file
321
322 (% class="box infomessage" %)
323 (((
Xiaoling 138.5 324 **vim /etc/chirpstack-gateway-bridge/chirpstack-gateway-bridge.toml **
Kilight Cao 138.1 325 )))
326
327 [[image:image-20230415165254-1.png||height="583" width="956"]]
328
329
Kilight Cao 176.1 330 == 6.4  Debug ==
Kilight Cao 138.1 331
332
333 After the above configuration is completed, the user can enter the command to debug the gateway-bridge connection
334
335 (% class="box infomessage" %)
336 (((
Xiaoling 138.5 337 **/opt/chirpstack-gateway-bridge/chirpstack-gateway-bridge ~-~-config /etc/chirpstack-gateway-bridge/chirpstack-gateway-bridge.toml**
Kilight Cao 138.1 338 )))
339
340 If the gateway-bridge connection is normal, the debug log displays **"connected to mqtt broker"**.
341
342 [[image:image-20230415170404-2.png]]
343
344
345 If the debug log shows "**connection error**", check that the server port or server is correct
346
347 [[image:image-20230415170854-3.png]]
348
349
350 More information can be found on the **[[ChirpStack website>>https://www.chirpstack.io/docs/]]**or **[[Forum>>url:https://forum.chirpstack.io/]]**
351
352
Kilight Cao 176.1 353 == 6.5  (Re)start and stop gateway-bridge ==
Kilight Cao 138.1 354
355
356 Use the following commands to (re)start and stop the ChirpStack Gateway Bridge Service:
357
358 (% class="box infomessage" %)
359 (((
360 **# start**
361
362 /etc/init.d/chirpstack-gateway-bridge start
363
364 **# stop**
365
366 /etc/init.d/chirpstack-gateway-bridge stop
367
368 **# restart**
369
370 /etc/init.d/chirpstack-gateway-bridge restart
371 )))
372
373
Kilight Cao 176.1 374 = 7.  How the gateway connects to Chirpstack v4 via gateway-bridge =
Kilight Cao 138.1 375
376
377 (% style="color:blue" %)**Below list the support products and Requirements:**
378
379 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]],[[LPS8N>>url:https://www.dragino.com/products/lora-lorawan-gateway/item/200-lps8n.html]],[[LG308N>>url:https://www.dragino.com/products/lora-lorawan-gateway/item/229-lg308n.html]],[[DLOS8N>>url:https://www.dragino.com/products/lora-lorawan-gateway/item/225-dlos8n.html]]
380 1. Firmware version since: [[Chirpstack-Bridge-V4>>https://www.dragino.com/downloads/index.php?dir=LoRa_Gateway/LPS8/Firmware/Release/Chirpstack-gateway-bridge/Chirpstack-Bridge-V4--build-v5.4.1670655072-20221210-1452/]]
381
382 (% style="color:blue" %)**What do you need to prepare**
383
384 A gateway that can access the internet normally
385
386
Kilight Cao 176.1 387 == 7.1  Configure Packet Forwarder ==
Kilight Cao 138.1 388
389
390 In the Dragino gateway web interface, you need to configure the Packet Forwarder so that it forwards its data to the port. localhost:1700 or 127.0.0.1:1700
391
Xiaoling 138.5 392 * In the (% style="color:blue" %)**LoRaWAN**(%%) menu, click on (% style="color:blue" %)**LoRaWAN ~-~- Semtech UDP**
393
Kilight Cao 138.1 394 * Make sure the following settings are set:
395 ** **Service Provider:** //~-~-Custom/Private LoRaWAN~-~-//
396 ** **LoRaWAN Server Address:** //localhost or 127.0.0.1//
397 ** **Server port for upstream:** //1700//
398 ** **Server port for downstream:** //1700//
399
Xiaoling 138.5 400 Click (% style="color:blue" %)**Save & Apply**.
Kilight Cao 138.1 401
402 [[image:image-20221222114220-2.png||height="748" width="931"]]
403
404
Kilight Cao 176.1 405 == 7.2  Configuring gateway frequency ==
Kilight Cao 138.1 406
407
408 (% style="color:red" %)**Note: Gateway frequencies must match**
409
410 [[image:image-20221222134830-3.png||height="408" width="923"]]
411
412
Kilight Cao 176.1 413 == 7.3  Modify the gateway-bridge configuration file ==
Kilight Cao 138.1 414
415
Kilight Cao 127.1 416 Run the gateway command line command to modify the gateway-bridge configuration file:
417
418 (% class="box infomessage" %)
419 (((
Xiaoling 138.5 420 **root@dragino-1d27d4:~~#  vim /etc/chirpstack-gateway-bridge/chirpstack-gateway-bridge.toml **
Kilight Cao 127.1 421 )))
422
Kilight Cao 124.1 423 [[image:image-20221222113302-1.png]]
424
Xiaoling 131.2 425
Kilight Cao 127.1 426 [[image:image-20221222140203-4.png||height="875" width="806"]]
427
Xiaoling 176.2 428
Kilight Cao 211.1 429 Configure the server address to which the gateway needs to be connected,"tcp:~/~/chirpstack_address:1883"
430
Kilight Cao 133.1 431 [[image:image-20221230094246-1.png||height="768" width="783"]]
Kilight Cao 127.1 432
433 (% class="wikigeneratedid" id="H" %)
434 After the modification, run the following command: **/etc/init.d/chirpstack-gateway-bridge restart**
435
436
Kilight Cao 176.1 437 == 7.4  (Re)start and stop gateway-bridge ==
Xiaoling 131.2 438
439
Kilight Cao 127.1 440 Use the following commands to (re)start and stop the ChirpStack Gateway Bridge Service:
441
442 (% class="box infomessage" %)
443 (((
444 **# start**
445
446 /etc/init.d/chirpstack-gateway-bridge start
447
448 **# stop**
449
450 /etc/init.d/chirpstack-gateway-bridge stop
451
452 **# restart**
453
454 /etc/init.d/chirpstack-gateway-bridge restart
455 )))
456
Kilight Cao 131.1 457
Kilight Cao 176.1 458 == 7.5  Successful Connection ==
Kilight Cao 131.1 459
Xiaoling 131.2 460
Kilight Cao 131.1 461 [[image:image-20221222141754-5.png||height="488" width="1150"]]
462
Xiaoling 131.2 463
Kilight Cao 131.1 464 [[image:image-20221222141830-6.png||height="582" width="1153"]]
465
Xiaoling 131.2 466
Kilight Cao 176.1 467 = 8.  Downlink =
Kilight Cao 124.1 468
Edwin Chen 245.1 469 == 8.1 Schedule Downlink via Web UI ==
Kilight Cao 124.1 470
471
Xiaoling 245.2 472 === Select HEX format for downlink ===
Xiaoling 108.9 473
Mengting Qiu 183.1 474
Mengting Qiu 177.2 475 (% style="color:red" %)**Note: The end node user manual provides HEX format of the downlink commands, so users can directly select HEX format downlink.**
Edwin Chen 111.1 476
477
Mengting Qiu 183.1 478 [[image:image-20231108171112-5.png||height="629" width="1117"]]
Edwin Chen 111.1 479
480
Mengting Qiu 183.1 481 [[image:image-20231108171145-6.png||height="497" width="1101"]]
Xiaoling 121.2 482
Edwin Chen 111.1 483
484
485
Xiaoling 1.2 486
Xiaoling 121.2 487 [[image:image-20220531173236-10.png||height="597" width="1215"]]
Xiaoling 1.2 488
Xiaoling 121.2 489 **Check ChripStack downlink DataRate**
Xiaoling 86.15 490
Xiaoling 121.2 491
492
Xiaoling 65.2 493 [[image:image-20220525101326-11.png]]
Xiaoling 1.2 494
Xiaoling 121.2 495 **Make sure the RX2DR is the same in the end node**
Xiaoling 1.2 496
Xiaoling 86.16 497
Edwin Chen 245.1 498 == 8.2 Schedule Downlink via API ==
Xiaoling 108.9 499
500
Edwin Chen 245.1 501 User can use MQTT to send downlink payload to ChirpStack to perform downstream to LoRaWAN End Node
Xiaoling 1.2 502
Xiaoling 1.5 503 (((
Xiaoling 108.9 504 **Below is examples:**
Xiaoling 1.5 505 )))
Xiaoling 1.2 506
Xiaoling 1.4 507 (% class="box" %)
508 (((
509 Connect to your server via MQTT:
510 MQTT Client ID: Any   
511 Protocol:mqtt/tcp   Server IP:loraserver_ip:1883
Xiaoling 1.2 512 User name: User name Password: password
Xiaoling 1.4 513 )))
Xiaoling 1.2 514
Xiaoling 97.2 515 [[image:image-20220531173419-11.png]]
Xiaoling 1.2 516
Xiaoling 1.5 517 (((
Xiaoling 121.2 518 **MQTT Connect to ChirpStack**
Xiaoling 86.17 519
520
Xiaoling 1.5 521 )))
Xiaoling 1.2 522
Xiaoling 1.5 523 (((
Xiaoling 108.9 524 **After connect**
Xiaoling 1.5 525 )))
Xiaoling 1.2 526
Xiaoling 1.4 527 (% class="box" %)
528 (((
529 Subscribe : Format:application/ID/device/ Device EUI/rx
Xiaoling 1.2 530 Example: application/7/device/00aedb3da649cb23/rx
Xiaoling 1.4 531 )))
Xiaoling 1.2 532
Xiaoling 1.4 533 (% class="box" %)
534 (((
535 Publish:
Xiaoling 1.2 536 Format: Top: application/ID/device/ Device EUI/tx
537 Payload: {"confirmed":true or false,"fPort":XX,"data":"xxxx"}
538 Example: Top: application/7/device/00aedb3da649cb23/tx
539 Payload: {"confirmed":true,"fPort":2,"data":"AwEB"}
Xiaoling 1.4 540 )))
Xiaoling 1.2 541
Xiaoling 98.2 542 [[image:image-20220531173519-12.png]]
Xiaoling 1.2 543
Xiaoling 121.2 544 **MQTT Connect to ChirpStack**
Xiaoling 1.2 545
Xiaoling 86.18 546
Xiaoling 1.2 547
Mengting Qiu 177.2 548 (((
549 Downlink payload encode javescript code.
Xiaoling 1.2 550
Mengting Qiu 177.2 551 We can run the following Javsscript code on the site:
Xiaoling 1.5 552 )))
Xiaoling 1.2 553
Xiaoling 1.4 554 (% class="box" %)
555 (((
556 function sha1_to_base64(sha1)
Xiaoling 1.2 557 {
558 var digits="ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/";
559 var base64_rep = "";
560 var cnt = 0;
561 var bit_arr = 0;
562 var bit_num = 0;
Xiaoling 1.5 563 \\ for(var n = 0; n < sha1.length; ++n)
Xiaoling 1.2 564 {
565 if(sha1[n] >= 'A' && sha1[n] <= 'Z')
566 {
Jean-Philippe Gagné 121.1 567 ascv = sha1.charCodeAt( n ) - 55;
Xiaoling 1.2 568 }
569 else if(sha1[n] >= 'a' && sha1[n] <= 'z')
570 {
Jean-Philippe Gagné 121.1 571 ascv = sha1.charCodeAt( n ) - 87;
Xiaoling 1.2 572 }
573 else
574 {
Jean-Philippe Gagné 121.1 575 ascv = sha1.charCodeAt( n ) - 48;
Xiaoling 1.2 576 }
Xiaoling 1.5 577 \\ bit_arr = (bit_arr << 4) | ascv;
Xiaoling 1.2 578 bit_num += 4;
579 if(bit_num >= 6)
580 {
Xiaoling 1.4 581 bit_num -= 6;        
Xiaoling 1.2 582 base64_rep += digits[bit_arr >>> bit_num];
Xiaoling 1.4 583 bit_arr &= ~~(-1 << bit_num);
Xiaoling 1.2 584 }
585 }
Xiaoling 1.5 586 \\ if(bit_num > 0)
Xiaoling 1.2 587 {
588 bit_arr <<= 6 - bit_num;
589 base64_rep += digits[bit_arr];
590 }
Xiaoling 1.5 591 \\ var padding = base64_rep.length % 4;   
592 \\ if(padding > 0)
Xiaoling 1.2 593 {
594 for(var n = 0; n < 4 - padding; ++n)
595 {
596 base64_rep += "=";
597 }
598 }
599 return base64_rep;
600 }
Xiaoling 1.5 601 \\console.log(sha1_to_base64("data"));
602 \\data is downlink payload required by end node.
Xiaoling 1.4 603 e.g console.log(sha1_to_base64("030101"));
604 ​result: AwEB     
Xiaoling 1.2 605 AwEB is the 0x030101's base 64 Encode.
Xiaoling 1.5 606 \\​e.g console.log(sha1_to_base64("030000"));
Xiaoling 1.4 607 ​result: AwAA     
608 AwAA is 0x030000's base 64 Encode.
609 )))
Xiaoling 1.2 610
Xiaoling 86.21 611
Edwin Chen 245.1 612 == 8.3  Add decoder function in Chirpstack for downlink message ==
Xiaoling 108.9 613
614
Xiaoling 1.2 615
Kilight Cao 221.1 616 = 9.  Chirpstack Multicast Configuration =
617
618
619 == 9.1  Introduction ==
620
621 ChirpStack has support for creating multicast-groups to which devices can be assigned. When enqueueing a downlink payload for a multicast-group, ChirpStack will analyze which gateways must be used for broadcasting to cover the complete multicast-group. This means that potentially, a single multicast downlink payload will be emitted multiple times.
622
623 Multicast can be used for the following device-classes:
624
625 * Class-B
626 * Class-C
627
Kilight Cao 223.1 628 == 9.2  Example to configure chirpstack Multicast ==
Kilight Cao 221.1 629
630
Kilight Cao 240.1 631 This section illustrates how to configure ChirpStack Multicast. Below is the network structure, we use our LPS8v2 as the LoRaWAN gateway and two SN50v3-LB as the LoRaWAN end-node here.
Kilight Cao 221.1 632
Kilight Cao 223.1 633 [[image:image-20240923105725-1.png]]
Kilight Cao 221.1 634
635
Kilight Cao 244.1 636 This example assumes that the user already has the prerequisites:
Kilight Cao 221.1 637
Kilight Cao 244.1 638 * (% style="color:blue" %)**SN50v3-LB Software Location:   **(%%)**[[SN50v3-LB_protocol_008(AU915).bin>>attach:https://wiki.dragino.com/xwiki/bin/view/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/SN50v3-LB/#H3.ConfigureSN50v3-LB2FLS||target="_blank"]] .**Users need to flash them with the firmware support Multicast.
639 * (% style="color:blue" %)**SN50v3-LB Configure:   **(%%)Enable CLASS C and DISFCNTCHECK(The downlink fcnt is not compared with the fcnt of the node).
Kilight Cao 240.1 640
641 (% class="wikigeneratedid" %)
Kilight Cao 244.1 642 **AT command:** (% style="color:blue" %)**AT+CLASS=C**
Kilight Cao 240.1 643
644 (% class="wikigeneratedid" %)
Kilight Cao 244.1 645 (% style="color:blue" %)**AT+DISFCNTCHECK=1**
Kilight Cao 240.1 646
647 (% class="wikigeneratedid" %)
Kilight Cao 244.1 648 For details on how to configure the SN50v3-LB, please refer to the link:** [[Configure SN50v3-LB>>https://wiki.dragino.com/xwiki/bin/view/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/SN50v3-LB/#H3.ConfigureSN50v3-LB2FLS]]**
Kilight Cao 240.1 649
Kilight Cao 244.1 650 * (% style="color:blue" %)**Chirpstack Configuration: **(%%)LPS8v2 gateway and SN50v3-LB register on ChirpStack server already
Kilight Cao 240.1 651
Kilight Cao 244.1 652 Register LPS8v2 gateway to Chirpstack. See section :[[https:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/Notes%20for%20ChirpStack/#H4.A0SemtechUDPforChirpStackv4>>https://wiki.dragino.com/xwiki/bin/view/Main/Notes%20for%20ChirpStack/#H4.A0SemtechUDPforChirpStackv4]]
653
654 Register SN50v3-LB to Chirpstack. See section :[[https:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/Notes%20for%20ChirpStack/#H2.A0Nodeusageintroduction>>https://wiki.dragino.com/xwiki/bin/view/Main/Notes%20for%20ChirpStack/#H2.A0Nodeusageintroduction]]
655
656
Kilight Cao 223.1 657 === Step 1. Create the multicast group ===
658
659
Kilight Cao 240.1 660 Create the multicast group on the corresponding **Application~-~->multicast groups~-~->Add multicast-group** interface, For example, multicast_test01_au915
Kilight Cao 223.1 661
Kilight Cao 240.1 662 [[image:image-20240923141847-3.png||height="620" width="1207"]]
663
664
665 Enter the Multicast address,Multicast network session key,Multicast application session key.
666
667 Use the default LoRaWAN settings, as below:
668
669 * EU868: 869525000hz, DR0
670
671 * US915: 923300000hz, DR8
672
673 * CN470: 505300000hz, DR0
674
675 * AU915: 923300000hz, DR8
676
677 * AS923: 923200000hz, DR2
678
679 * KR920: 921900000hz, DR0
680
681 * IN865: 866550000hz, DR2
682
683 * RU864: 869100000hz, DR0
684
685 Group type: **Class-C**
686
687 Class-C scheduling type : **Delay**
688
689 [[image:image-20240923142446-5.png||height="720" width="1208"]]
690
691
692 === Step 2. Add gateways and devices to the multicast group ===
693
694
695 Select a gateway on the "**Gateways**" screen, click "**selected gateways"**, and click "**Add to multicast-group**" to add the gateway to the corresponding multicast group, for example, **multicast_test01_au915**.
696
697 [[image:image-20240923144335-6.png||height="619" width="1209"]]
698
699 [[image:image-20240923144418-7.png||height="572" width="1206"]]
700
701
702 On the **Application->Devices** interface, select two SN50v3-LB nodes registered with multicast support, and then click "**Selected devices**". and click "**Add to multicast-group**" to add the node to the corresponding multicast group
703
Kilight Cao 241.1 704 [[image:image-20240923144749-9.png||height="623" width="1211"]]
Kilight Cao 240.1 705
706
707 Access the multicast group to check whether two SN50V3-LBs and gateways are added successfully
708
709 [[image:image-20240923145148-10.png||height="601" width="1218"]]
710
711
712 === Step 3. Use the API for multicast Downlink ===
713
714
715 To use API Downlink, user first need to generate an API key
716
717 [[image:image-20240923145624-18.png||height="429" width="1211"]]
718
Kilight Cao 241.1 719 [[image:image-20240923145520-16.png||height="422" width="1212"]]
Kilight Cao 240.1 720
721
722 For example:**[[https:~~/~~/www.chirpstack.io/docs/chirpstack/api/index.html>>url:https://www.chirpstack.io/docs/chirpstack/api/index.html]]**
723
Kilight Cao 241.1 724 [[image:image-20240923145953-21.png||height="808" width="1222"]]
Kilight Cao 240.1 725
726
727 Users can access the Linux console of the gateway via SSH, and then use the curl command to multicast Downlink
728
729 The format is as follows:
730
731 (% class="box infomessage" %)
732 (((
733 curl -X POST 'http:~/~/**Chirpstack_Server_Address**:8090/api/multicast-groups/**Multicast_Groups_ID**/queue' -H "Content-Type: application/json" -H "Authorization: Bearer **eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJhdWQiOiJjaGlycHN0YWNrIiwiaXNzIjoiY2hpcnBzdGFjayIsInN1YiI6IjM3YmRiNzBjLTNjODgtNDFjMi04YmQ2LTgyMDI4ZjdkNzY3NyIsInR5cCI6ImtleSJ9.p1xvRP1PAdwLnLAJn9w6ef612KM8oPZSa_2v4UYPV0w**" -d '{
734 "queueItem": {
735 "data": "EjRWeA==",
736 "fCnt": 0,
737 "fPort": 123
738 }
739 }'
740 )))
741
742 In the command,eyJ........._2v4UYPV0w is the API key, which can be obtained from the Chirpstack server and the data format is base64,
743
744
745 === Result ===
746
747 Connecting to the SN50v3-LB using the serial USB-TTL port can check that two SN50v3-LBs are receiving Downlink at the same time
748
749 [[image:image-20240923151814-23.png||height="563" width="1255"]]
750
751
Kilight Cao 242.1 752 = 10.  Multiply Uplink in ChirpStack =
Xiaoling 108.9 753
754
Xiaoling 1.4 755 (((
Xiaoling 1.2 756 nbtrans field is the value to determine the re-transmission time for unconfirmed uplink data.
Xiaoling 1.4 757 )))
Xiaoling 1.2 758
Xiaoling 1.4 759 (((
Xiaoling 1.2 760 ChirpStack will auto adjust nbtrans according to uplink rssi. [[link to source>>url:https://github.com/brocaar/chirpstack-network-server/blob/master/internal/adr/adr.go]]
Xiaoling 108.9 761
762
Xiaoling 1.4 763 )))
Xiaoling 1.2 764
Xiaoling 121.2 765 [[image:image-20220526091912-7.png||height="241" width="1336"]]
Xiaoling 1.2 766
Xiaoling 108.9 767
Xiaoling 1.5 768 (((
Xiaoling 1.2 769 nbtrans is a field of ADR message, in unconfirm mode, it tells end node how many time it needs to transmit for every frame.
Xiaoling 108.9 770
771
Xiaoling 1.5 772 )))
Xiaoling 1.2 773
Xiaoling 76.2 774 [[image:image-20220525104359-21.png]]
Xiaoling 1.2 775
Xiaoling 1.4 776 (((
Xiaoling 1.2 777 Above behaviour will cause the platform shows below two cases of error:
Xiaoling 108.9 778
779
Xiaoling 1.4 780 )))
Xiaoling 1.2 781
Xiaoling 1.4 782 (((
Xiaoling 1.2 783 Error of duplicate Frame Counter
Xiaoling 1.4 784 )))
Xiaoling 1.2 785
Xiaoling 76.2 786 [[image:image-20220525104437-22.png]]
Xiaoling 1.2 787
Xiaoling 86.23 788
Xiaoling 108.9 789
Xiaoling 121.2 790 **Duplicate transmission in short time**
Xiaoling 1.2 791
Xiaoling 176.2 792 [[image:image-20220601102430-1.png||height="508" width="1120"]]
Xiaoling 1.2 793
Xiaoling 86.24 794
Kilight Cao 242.1 795 == 10.1  Solution ==
Xiaoling 108.9 796
797
Xiaoling 1.2 798 This example uses the Windows version as a template, other versions can refer to this. Similiar reference: [[https:~~/~~/confluence.alitecs.de/plugins/servlet/mobile?contentId=79790102#content/view/79790102>>url:https://confluence.alitecs.de/plugins/servlet/mobile?contentId=79790102#content/view/79790102]]
799
Xiaoling 1.5 800 (((
Xiaoling 108.11 801 (% style="color:blue" %)**1.  Install the GO compilation environment: Download the corresponding version of the Go compiler at [[https:~~/~~/go.dev/dl/>>url:https://go.dev/dl/]] and install it.**
Xiaoling 1.5 802 )))
Xiaoling 1.2 803
Xiaoling 79.2 804 [[image:image-20220525104532-24.png]]
Xiaoling 1.2 805
Xiaoling 86.25 806
Xiaoling 108.9 807 **installation path:**
Xiaoling 1.2 808
Xiaoling 79.2 809 [[image:image-20220525104554-25.png]]
Xiaoling 1.2 810
Xiaoling 86.25 811
Xiaoling 108.9 812
Xiaoling 1.5 813 (((
Xiaoling 108.11 814 (% style="color:blue" %)**2.  Environment variable settings:**
Xiaoling 1.5 815 )))
Xiaoling 1.2 816
Xiaoling 1.5 817 (((
Xiaoling 1.2 818 1) Open Computer -> Properties -> Advanced System Settings -> Environment Variables and add a "new" system variable:
Xiaoling 1.5 819 )))
Xiaoling 1.2 820
Xiaoling 1.5 821 (((
Xiaoling 108.9 822 2) Set the variable name GOROOT and the variable value C:\Go\ (installation directory)
Xiaoling 1.5 823 )))
Xiaoling 1.2 824
Xiaoling 43.2 825 [[image:image-20220524165433-33.png]]
Xiaoling 1.2 826
Xiaoling 86.26 827
Xiaoling 108.9 828 3) Modify the system variable Path and add C:\Go\bin\:
Xiaoling 1.2 829
Xiaoling 43.2 830 [[image:image-20220524165452-34.png]]
Xiaoling 1.2 831
Xiaoling 106.3 832
Xiaoling 1.2 833 User variable setting file generation directory: D:\go:
834
Xiaoling 43.2 835 [[image:image-20220524165517-35.png]]
Xiaoling 1.2 836
Xiaoling 86.27 837
Xiaoling 1.2 838
Xiaoling 108.11 839 (% style="color:blue" %)**3.  Modify the ADR configuration file according to your own needs, adr.setting.go is an example of the ADR configuration file.**
Xiaoling 108.9 840
Xiaoling 1.2 841 The name of the plugin: Example ADR plugin:
842
Xiaoling 48.2 843 [[image:image-20220524165540-36.png]]
Xiaoling 1.2 844
845 Set Nbtrans: Nbtrans=1 (Nbtrans is the number of retransmissions, if it is 1, no retransmission, it is recommended to be 1). To enable it, you need to uncomment.
846
Xiaoling 48.2 847 [[image:image-20220524165557-37.png]]
Xiaoling 1.2 848
Xiaoling 86.28 849
Xiaoling 1.2 850
Xiaoling 108.11 851 (% style="color:blue" %)**4.  Compile the ADR configuration file and generate the exe file.**
Xiaoling 108.9 852
Xiaoling 1.2 853 1) Create a folder named adr-setting
854
855 2) Open the adr-setting folder
856
857 3) Put adr.setting.go in this folder.
858
859 4) Open the computer cmd and run the following commands in sequencecd adr-setting
860
861 go mod init adr-setting
862
863 go get github.com/brocaar/chirpstack-network-server/v3/adr
864
865 go get github.com/hashicorp/go-plugin
866
867 go get adr-setting
868
869 go build
870
871 5) Finally generate this file:
872
Xiaoling 48.2 873 [[image:image-20220524165623-38.png]]
Xiaoling 1.2 874
Xiaoling 86.29 875
Xiaoling 1.2 876
Xiaoling 108.11 877 (% style="color:blue" %)**5.  Add the plugin and run the plugin.**
Xiaoling 108.9 878
Xiaoling 1.5 879 (((
Xiaoling 1.2 880 The exe file generated in the previous step is placed in the same root directory as chirpstack-network-server.toml, and the ADR plugin is added to the toml file. The location of the addition is as follows:
Xiaoling 1.5 881 )))
Xiaoling 1.2 882
Xiaoling 48.2 883 [[image:image-20220524165641-39.png]]
Xiaoling 1.2 884
Xiaoling 1.4 885 (((
Xiaoling 1.5 886 (((
Xiaoling 1.2 887 For example: adr_plugins=[“adr-setting”]
Xiaoling 1.4 888 )))
Xiaoling 1.5 889 )))
Xiaoling 1.2 890
Xiaoling 1.4 891 * (((
Xiaoling 1.5 892 (((
Xiaoling 1.4 893 Adding a single plugin format is adr_plugins=["filename"]
894 )))
Xiaoling 1.5 895 )))
Xiaoling 1.2 896
Xiaoling 1.4 897 * (((
Xiaoling 1.5 898 (((
Xiaoling 1.4 899 Adding multiple plugins The format is adr_plugins=["file name 1", "file name 2",...]
900 )))
Xiaoling 1.5 901 )))
Xiaoling 1.2 902
Xiaoling 1.4 903 (((
Xiaoling 1.5 904 (((
Xiaoling 1.2 905 Finally, re-run chirpstack-network-server.exe, and then select the plugin you just compiled in Device-profiles,
Xiaoling 1.4 906 )))
Xiaoling 1.5 907 )))
Xiaoling 1.2 908
Xiaoling 79.2 909 [[image:image-20220525104647-26.png]]
Xiaoling 1.2 910
911 Finish.
912
Xiaoling 86.30 913
Kilight Cao 242.1 914 = 11.  How to store/get all data traffic for a specific sensor, including raw payload, and uplink/ downlink history. =
Xiaoling 108.9 915
Xiaoling 1.2 916
Xiaoye 115.1 917 All data is published to the MQTT topics. if you want to store/get the data, you would have to create an MQTT handler and store the data yourself.
Xiaoling 1.2 918
Xiaoye 115.1 919 This example will be shown how to store/get all the data in two ways:
Xiaoling 108.9 920
Xiaoling 138.5 921 (% style="color:blue" %)**//1). Chirpstack ~-~-> Node-red//**
Xiaoye 115.1 922
923
Xiaoling 176.2 924 [[image:image-20221012184501-1.png||height="608" width="1041"]]
Xiaoye 115.1 925
Xiaoling 121.2 926
Xiaoye 120.1 927 Use MQTT in Nore-red to subscribe to topics published by the chirpstack-application and then continuously write to a file
Xiaoye 115.1 928
929 [[image:image-20221012174220-2.png]]
930
931
Xiaoye 120.1 932 [[image:image-20221012184655-3.png||height="395" width="1049"]]
933
934
Xiaoling 121.2 935 **Each message is continuously logged to a specified file**
Xiaoye 115.1 936
937 [[image:image-20221012174352-3.png]]
938
939
Xiaoling 138.5 940 (% style="color:blue" %)**//2). MQTT  Sub//**
Xiaoye 115.1 941
942 If you don't want to store the information via node-red, you can get the output via the subscribe command.
943
944
945 **If connecting from the same machine, you can use the following command to receive data:**
946
947 (% class="box infomessage" %)
Xiaoling 1.4 948 (((
Xiaoling 138.5 949 **mosquitto_sub -h localhost -t "application/#" -v**
Xiaoye 115.1 950 )))
951
952
Xiaoling 138.5 953 (% style="color:blue" %)**Different host**
Xiaoye 115.1 954
955 (% class="box infomessage" %)
956 (((
Xiaoling 138.5 957 **mosquitto_sub -h IPADDRESS -p 8883 ~-~-insecure ~-~-cafile ca.pem ~-~-cert cert.pem ~-~-key key.pem -t "application/#" -v**
Xiaoye 115.1 958 )))
959
Xiaoling 176.2 960 [[image:image-20221012173639-1.png||height="273" width="1206"]]
Xiaoye 115.1 961
Xiaoling 176.2 962
Kilight Cao 242.1 963 = 12.  How to use Chirpstack API to batch register Sensor Node/Gateway in Chistapstack Server =
Xiaoye 184.1 964
965 The following example is based on the built-in ChirpStack server for LPS8V2
966
Kilight Cao 189.1 967 [[image:image-20231201174640-1.png||height="584" width="1148"]]
Xiaoye 184.1 968
Xiaoye 115.1 969
Kilight Cao 242.1 970 == **12.1 Generate API Tokens** ==
Xiaoye 115.1 971
Kilight Cao 204.1 972 Access the built-in chirpstack , click "**API Key**" and "**Add API Key**".
Kilight Cao 189.1 973
974 [[image:image-20231201175118-2.png||height="597" width="1156"]]
975
Kilight Cao 204.1 976 **Save the generated API Tokens**
Kilight Cao 189.1 977
978 [[image:image-20231201175648-3.png||height="596" width="1155"]]
979
Kilight Cao 200.1 980 [[image:image-20231204104802-1.png]]
Kilight Cao 189.1 981
Kilight Cao 200.1 982
Kilight Cao 242.1 983 == **12.2 Template file** ==
Kilight Cao 200.1 984
985
986 Click on **"Template File Download"**, the user will download a **register.csv** template file,
987
988 [[image:image-20231204105201-2.png]]
989
990
991 Before registering in batches, the user needs to add an **Application** and **Device profile**, If  you have already added them, you do not need to add them again,
992
Kilight Cao 204.1 993 Open the corresponding **Application** and **Device profile** and copy their IDs
Kilight Cao 200.1 994
995 [[image:image-20231204110902-5.png||height="618" width="1197"]]
996
997 [[image:image-20231204111116-7.png||height="619" width="1199"]]
998
999 [[image:image-20231204111834-9.png||height="273" width="1205"]]
1000
1001 [[image:image-20231204112107-10.png||height="621" width="1203"]]
1002
1003
1004
Kilight Cao 242.1 1005 == **12.3 Batch Register** ==
Kilight Cao 204.1 1006
1007 [[image:image-20231204113136-11.png||height="362" width="1062"]]
1008
1009
1010 **Check whether the batch registration is successful**
1011
1012 [[image:image-20231204113212-12.png]]
1013
1014 [[image:image-20231204113237-13.png||height="558" width="1081"]]
1015
1016
1017
Kilight Cao 242.1 1018 = 13.  Example: Use Local Server ChirpStack and Node-Red in LPS8v2 =
Kilight Cao 189.1 1019
1020
Kilight Cao 151.1 1021 LPS8v2 includes a local ChirpStack Server and Node-Red. This example shows how to configure LHT65N to use with the local Node-Red server. This example assumes users already have:
Xiaoye 115.1 1022
Kilight Cao 141.1 1023 * LHT65N register on LPS8v2 Built-In ChirpStack server already
1024 * The user is able to see the data on the built-in ChirpStack server device page.
Xiaoye 115.1 1025
Kilight Cao 141.1 1026 Below are the steps to plot the sensor data on LPS8v2 Node-Red.
1027
Xiaoling 147.2 1028
Kilight Cao 242.1 1029 == 13.1 Link Node-Red to Local ChirpStack ==
Kilight Cao 141.1 1030
Xiaoling 147.2 1031
Kilight Cao 145.1 1032 Users can download the Node-Red decoder from this link and import it into the Node-Red platform:  **[[attach:LHT65N-ChirpStack-node-red.json||target="_blank"]]**
Kilight Cao 141.1 1033
1034 For more information on importing Input Flow, check out this link: **[[Import Input Flow for Dragino Sensors>>url:http://wiki.dragino.com/xwiki/bin/view/Main/Node-RED/#H3.A0ImportInputFlowforDraginoSensors]]**
1035
1036 After importing the Input Flow is complete, the user needs to edit the MQTT in the node
1037
1038
Kilight Cao 145.1 1039 (% style="color:blue" %)**1. Change the Topic**
1040
Kilight Cao 141.1 1041 Topic modifies it to the following format:
1042
Kilight Cao 145.1 1043 **application/(% style="color:red" %)Application ID(%%)/device/(% style="color:red" %)End device ID(%%)/event/up**
Kilight Cao 141.1 1044
Kilight Cao 152.1 1045 Reference link: [[**Node-RED integration** >>https://www.chirpstack.io/docs/guides/node-red-integration.html]]
1046
Kilight Cao 145.1 1047 [[image:image-20230527143923-1.png||height="588" width="1132"]]
Kilight Cao 141.1 1048
1049
Kilight Cao 145.1 1050
1051 (% style="color:blue" %)**2. Enter the MQTT configuration information**
1052
1053 [[image:image-20230527144206-2.png||height="590" width="1136"]]
1054
1055
Xiaoling 176.2 1056 (% style="color:blue" %)**3.** **Finally, click "Update" and Deploy**
Kilight Cao 147.1 1057
1058 "Connected" indicates that the Link Node-red to Local Chirpstack is normal.
1059
1060 [[image:http://wiki.dragino.com/xwiki/bin/download/Main/Notes%20for%20TTN/WebHome/image-20220914140918-5.png?width=1121&height=602&rev=1.1||alt="image-20220914140918-5.png"]]
1061
1062
Kilight Cao 242.1 1063 == 13.2 Check result. ==
Kilight Cao 147.1 1064
Xiaoling 147.2 1065
Kilight Cao 147.1 1066 Users can check logs by adding debug.
1067
1068 Browser access: **Node-Red-Server-Address:1880/ui**
1069
1070 [[image:image-20230529150923-1.png||height="424" width="1118"]]
1071
Xiaoling 147.2 1072
Kilight Cao 242.1 1073 = 14.  Trouble Shooting =
Kilight Cao 141.1 1074
Kilight Cao 242.1 1075 == 14.1  MIC Mismatch or MIC Failed ==
Kilight Cao 141.1 1076
1077
Xiaoye 115.1 1078 (((
Xiaoling 1.2 1079 When the device is registered or the device is working normally, the problem of MIC mismatch and MIC failed occurs.
Xiaoling 1.4 1080 )))
Xiaoling 1.2 1081
Xiaoling 1.4 1082 (((
Xiaoling 1.2 1083 Under normal circumstances, users need to change the APPKEY to solve this problem.
Xiaoling 131.2 1084
Bei Jinggeng 169.1 1085
Kilight Cao 242.1 1086 == 14.2  The node is very close to the gateway, but the signal is poor ==
Bei Jinggeng 169.1 1087
Xiaoling 176.2 1088
Bei Jinggeng 169.1 1089 If you are using US915 or AU915, you found the frequency points of different subband ranges in your uplink
1090
1091 Like that:Both 905.1Mhz and 902.3Mhz appear on uplink
1092 But they belong to Subband1 and Subband2 of US915 respectively
1093
1094 Cause: The server and the gateway use different frequency bands (the server uses Subband1, and the gateway uses Subband2)
1095
1096 In server side, it shows the frequency is 905.1Mhz, which is sub-band2. But the RSSI is very low, Because this is not a signal in 905.1Mhz, it is on 902.3Mhz, the signal is too strong and appear a noise in 905.1Mhz.
1097
1098 How to check the frequency band used by the server:
1099
1100 You can view the information sent by the server: ch_mask in Unconfirmdedatadown
1101
1102 [[image:image-20230821113255-1.png]]
1103
1104 According to lorawan's protocol, your first ch_mask is 7 for ChMaskCntl = 7 then 125 kHz channels are disabled. Simultaneously the channels 64 to 71 are set according to the ChMask bit mask.
1105
Bei Jinggeng 170.1 1106 [[image:image-20230821113539-2.png]]
Bei Jinggeng 169.1 1107
1108 In the second message, the channel 0~~7 is true, which means that your server is using subband2.
1109
Bei Jinggeng 170.1 1110 [[image:image-20230821113618-3.png]]
Bei Jinggeng 169.1 1111
Xiaoling 176.2 1112 **Note: lorawan's protocol link——[[LoRaWAN® Regional Parameters v1.0.3revA (lora-alliance.org)>>url:https://resources.lora-alliance.org/document/lorawan-regional-parameters-v1-0-3reva]]**
1113
Mengting Qiu 210.1 1114
Kilight Cao 242.1 1115 == 14.3  ChirpStackv4 node device displays "UPLINK_F_CNT_RETRANSMISSION" ==
Mengting Qiu 210.1 1116
1117
Kilight Cao 216.1 1118 This is because the node's packets are retransmitted, and the Fcnt of these packets is the same.
Mengting Qiu 210.1 1119
Kilight Cao 216.1 1120 The user can Disable frame-counter validation on the chirpstack node and this warning message will not appear in the logs.
Mengting Qiu 210.1 1121
Kilight Cao 216.1 1122
Kilight Cao 218.1 1123 The packet is retransmitted because the node device has enabled the acknowledgment uplink packet mode and the node cannot receive the ACK acknowledgment packet delivered by the gateway.
Kilight Cao 216.1 1124
1125
Kilight Cao 218.1 1126 **The possible reasons are: **
1127
1128 ~1. The signal of the node device and the gateway is not good
1129
1130 2. Too many node devices affect the downlink of the gateway
1131
1132
1133 [[image:image-20240717085339-1.jpeg]]
1134
1135
1136 * **Disable frame-counter validation**
1137
1138 [[image:image-20240717102613-5.png||height="803" width="1211"]]
1139
1140
1141 * **Result**
1142
Kilight Cao 216.1 1143 [[image:image-20240717092428-4.jpeg]]
1144
Kilight Cao 218.1 1145
Kilight Cao 242.1 1146 == 14.4  How to get the log information of the node? ==
Kilight Cao 216.1 1147
1148
Mengting Qiu 210.1 1149 ~1. Get information about a single node.
1150
1151 * Download this file in the node's live data interface.
1152
1153 [[image:image-20240117173123-1.png||height="526" width="1086"]]
1154
1155 * The LoRaWAN frames download gateway receives real-time data from the current node.
1156
1157 [[image:image-20240117174452-2.png||height="525" width="1081"]]
1158
1159
1160 2. Get information about the entire Gateway.
1161
1162 * Click to select the online gateway of the current node.
1163
1164 [[image:image-20240117175058-4.png||height="532" width="1077"]]
1165
1166
1167 * Download this file on the LoRaWAN frames interface.
1168
1169 [[image:image-20240117175009-3.png||height="524" width="1076"]]
1170
1171
1172
1173 After the data collection is completed, you can send this file directly to our technical support personnel for analysis.
1174
1175
1176 You can also use the packet analysis tool developed by our company to check it yourself. Please refer to the following [[link>>http://wiki.dragino.com/xwiki/bin/view/Main/User%20Manual%20of%20Dragino%20LoRaWAN%20Packet%20Analyze%20Tool/#H4.Chirpstack]] to use this tool.
1177
1178 [[image:image-20240117175738-5.png]]
1179
Kilight Cao 216.1 1180 (% class="wikigeneratedid" id="H" %)
1181
Xiaoling 1.4 1182 )))