Wiki source code of Notes for ChirpStack

Version 246.5 by Xiaoling on 2025/07/31 17:07

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