Wiki source code of Notes for ChirpStack

Version 129.1 by Kilight Cao on 2022/12/22 14:17

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
Xiaoling 54.2 23 [[image:image-20220525100058-1.png]]
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 86.5 40
41
Xiaoling 108.4 42 = 2.  Semtech UDP =
Xiaoling 1.1 43
Xiaoling 108.4 44 == 2.1  Step 1. Add the Network-servers ==
Xiaoling 1.1 45
Xiaoling 108.4 46
Xiaoling 1.2 47 The network-Servers address varies depending on the ChirpStack server setup environment
Xiaoling 1.1 48
Xiaoling 1.3 49 (% class="box" %)
50 (((
Xiaoling 108.5 51 Windows       ~-~->  Network-server server *  :  localhost:8000
52 Linux  ~-~->  Network-server server *  :  chirpstack-network-server:8000
Xiaoling 1.3 53 )))
Xiaoling 1.1 54
Xiaoling 108.4 55
Xiaoling 108.6 56 (% style="color:red" %)**If the user cannot add network-Servers, re-check the ChirpStack code or the server building process.**
Xiaoling 1.1 57
Xiaoling 108.4 58
Xiaoling 87.2 59 [[image:image-20220531171609-1.png]]
Xiaoling 1.2 60
61 Add the Network-servers
62
Xiaoling 84.2 63
Xiaoling 108.4 64
Xiaoling 108.6 65 == 2.2  Step 2. Create Gateway-profiles ==
Xiaoling 1.2 66
Xiaoling 108.6 67
Xiaoling 88.2 68 [[image:image-20220531171651-2.png]]
Xiaoling 1.2 69
70 Create Gateway-profiles
71
Xiaoling 84.2 72
Xiaoling 1.2 73
Xiaoling 108.6 74 == 2.3  Step 3. Create Service-profiles ==
75
76
Xiaoling 89.2 77 [[image:image-20220531171809-3.png]]
Xiaoling 1.2 78
79 Create Service-profiles
80
Xiaoling 89.3 81
Xiaoling 1.2 82 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.
83
Xiaoling 1.4 84 (% style="color:red" %)**Note : Before add the gateway, the user needs to complete the preceding three steps.**
Xiaoling 1.2 85
Xiaoling 84.2 86 If the user has completed the preceding steps, proceed to the next step.(% style="display:none" %)
Xiaoling 1.2 87
Xiaoling 84.2 88
Xiaoling 108.6 89
Xiaoling 108.7 90 == 2.4  Step 4. Add the gateway ==
Xiaoling 1.2 91
Xiaoling 108.7 92
Xiaoling 1.2 93 The example gateway id is: a840411e96744150
94
Xiaoling 1.5 95 (((
Xiaoling 1.4 96 (% style="color:red" %)**Note : The Gateway EUI and server addresses must match the ChirpStack configuration.**
Xiaoling 108.7 97
98
Xiaoling 1.5 99 )))
Xiaoling 1.2 100
Xiaoling 90.2 101 [[image:image-20220531171923-4.png]](% style="display:none" %)
Xiaoling 1.2 102
103 Add the gateway
104
Xiaoling 108.7 105
106
Xiaoling 91.2 107 [[image:image-20220531172031-5.png]]
Xiaoling 1.2 108
109 Configure the gateway
110
Xiaoling 84.2 111
Xiaoling 1.2 112
Xiaoling 108.8 113 == 2.5  Step 5. Checking gateway Status ==
114
115
Xiaoling 92.2 116 [[image:image-20220531172158-6.png]](% style="display:none" %)
Xiaoling 1.2 117
Xiaoling 84.2 118
Xiaoling 108.8 119
Xiaoling 1.2 120 gateway Status
121
Xiaoling 93.2 122 [[image:image-20220531172304-7.png]]
Xiaoling 1.2 123
124 gateway Status
125
Xiaoling 86.6 126
Xiaoling 108.8 127
Xiaoling 108.9 128 = 3.  Gateway Registration for Basics Station =
Xiaoling 1.2 129
Xiaoling 108.9 130 == 3.1  Introduction ==
Kilight Cao 9.1 131
Xiaoling 108.8 132
Kilight Cao 9.1 133 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.
134
135 ChirpStack Open-Source LoRaWAN® Network Server needs to set up a configuration that can use Semtech BasicStation.
136
137
Xiaoling 108.8 138 (% style="color:blue" %)**Below list the support products and Requirements:**
139
Kilight Cao 9.1 140 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]]
141 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/]]
142
Xiaoling 108.8 143 (% style="color:blue" %)**How to set up chirpStack Basic Station**
144
Kilight Cao 9.1 145 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]]
146
147
Xiaoling 108.8 148 (% style="color:blue" %)**What do you need to prepare**
149
Kilight Cao 9.1 150 A gateway that can access the internet normally
151
Xiaoling 86.7 152
Xiaoling 108.9 153 == 3.2  Add Gateway ==
Kilight Cao 9.1 154
Xiaoling 108.9 155
Xiaoling 20.2 156 [[image:image-20220524164205-10.png]]
Kilight Cao 9.1 157
Xiaoling 86.8 158
Xiaoling 108.9 159 == 3.3  Access the gateway GUI ==
Kilight Cao 9.1 160
Xiaoling 108.9 161
Kilight Cao 9.1 162 Access the gateway GUI interface of LoRaWAN~-~->LoRaWAN ~-~- Basic Station
163
Xiaoling 20.2 164 [[image:image-20220524164319-11.png]]
Kilight Cao 9.1 165
Xiaoling 108.9 166
Kilight Cao 9.1 167 User need to Choose the ChirpStack/Senet ~-~- Basic Station , input Server URI and Upload the TLS Certificate
168
169 (% class="box" %)
170 (((
171 Service Provider  ~-~->  Choose the ChirpStack/Senet ~-~- Basic Station
172
173 LNS URI  ~-~->  Enter the LNS URI address, For example : wss:~/~/xxxx.chirpstack.com:433 or ws:~/~/xxxx.chirpstack.com:3001
174
175 LNS TLS trust  ~-~->  Upload the TLS Certificate
176 )))
177
178 (% class="wikigeneratedid" %)
Xiaoling 20.2 179 [[image:image-20220524164341-12.png]]
Kilight Cao 9.1 180
Xiaoling 86.9 181
Xiaoling 108.9 182 == 3.4  Start Station ==
Kilight Cao 9.1 183
Xiaoling 108.9 184
Xiaoling 108.14 185 When the user has finished the configuration, Please click **Sace&Apply** to start station to connect ChirpStack.
Kilight Cao 9.1 186
Xiaoling 86.10 187
Xiaoling 108.9 188 == 3.5  Successful Connection ==
Kilight Cao 9.1 189
Xiaoling 108.9 190
Kilight Cao 9.1 191 If user completes the above steps, which will see live date in the ChirpStack.
192
Xiaoling 23.2 193 [[image:image-20220524164448-13.png]]
Kilight Cao 9.1 194
Xiaoling 86.11 195
Xiaoling 108.9 196 == 3.6  Trouble Shooting ==
197
198
Kilight Cao 9.1 199 User can check the station log in the logread/system log page.
200
Xiaoling 95.2 201 [[image:image-20220531172837-8.png]]
Kilight Cao 9.1 202
Xiaoling 86.13 203
Kilight Cao 9.1 204 and recode the station log in the system/Recode log page.
205
Xiaoling 95.2 206 [[image:image-20220531172857-9.png]]
Kilight Cao 9.1 207
Xiaoling 86.12 208
Kilight Cao 124.1 209 = 4. How the gateway connects to Chirpstack v4 via gateway-bridge =
Xiaoling 108.9 210
Xiaoling 1.2 211
Kilight Cao 128.1 212 (% style="color:blue" %)**Below list the support products and Requirements:**
213
214 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]]
215 1. Firmware version since: [[Chirpstack-gateway-bridge>>url:https://www.dragino.com/downloads/index.php?dir=LoRa_Gateway/LPS8/Firmware/Release/Chirpstack-gateway-bridge/]]
216
217 (% style="color:blue" %)**How to set up chirpStack Gateway-bridge**
218
219 Users can check out the ChirpStack gateway-bridge v4 [[link>>https://www.chirpstack.io/docs/chirpstack-gateway-bridge/install/dragino.html]]
220
221
222 (% style="color:blue" %)**What do you need to prepare**
223
224 A gateway that can access the internet normally
225
Kilight Cao 127.1 226 == 4.1 Configure Packet Forwarder ==
Xiaoling 1.2 227
Kilight Cao 124.1 228 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 229
Kilight Cao 124.1 230 * In the **LoRaWAN** menu, click on **LoRaWAN ~-~- Semtech UDP**
231 * Make sure the following settings are set:
232 ** **Service Provider:** //~-~-Custom/Private LoRaWAN~-~-//
233 ** **LoRaWAN Server Address:** //localhost or 127.0.0.1//
234 ** **Server port for upstream:** //1700//
235 ** **Server port for downstream:** //1700//
236
237 Click **Save & Apply**.
238
239 [[image:image-20221222114220-2.png||height="748" width="931"]]
240
241
Kilight Cao 127.1 242 == 4.2 Configuring gateway frequency ==
Kilight Cao 124.1 243
Kilight Cao 127.1 244 Note: Gateway frequencies must match
245
246 [[image:image-20221222134830-3.png||height="408" width="923"]]
247
248
249 == 4.3 Modify the gateway-bridge configuration file ==
250
251
252 Run the gateway command line command to modify the gateway-bridge configuration file:
253
254 (% class="box infomessage" %)
255 (((
256 root@dragino-1d27d4:~~#  vim /etc/chirpstack-gateway-bridge/chirpstack-gateway-bridge.toml
257 )))
258
Kilight Cao 124.1 259 [[image:image-20221222113302-1.png]]
260
Kilight Cao 127.1 261 [[image:image-20221222140203-4.png||height="875" width="806"]]
262
263
264 (% class="wikigeneratedid" id="H" %)
265 After the modification, run the following command: **/etc/init.d/chirpstack-gateway-bridge restart**
266
267 == 4.3 (Re)start and stop gateway-bridge ==
268
269 Use the following commands to (re)start and stop the ChirpStack Gateway Bridge Service:
270
271 (% class="box infomessage" %)
272 (((
273 **# start**
274
275 /etc/init.d/chirpstack-gateway-bridge start
276
277 **# stop**
278
279 /etc/init.d/chirpstack-gateway-bridge stop
280
281 **# restart**
282
283 /etc/init.d/chirpstack-gateway-bridge restart
284 )))
285
Kilight Cao 124.1 286 = 5.  Downlink =
287
288 == 5.1 Convert HEX to Base64 ==
289
290
Edwin Chen 111.1 291 (% style="color:red" %)**Note: Chirpstack uses base64 to downlink, the end node user manual provides HEX format of the downlink commands. So user needs to convert the HEX to Base64.**
Xiaoling 108.9 292
Xiaoling 121.2 293 **[[Online HEX to Base64 Converter>>https://base64.guru/converter/encode/hex]]:**
Edwin Chen 111.1 294
295 [[image:image-20221010193350-1.png]]
296
297
298
Xiaoling 121.2 299 **[[Online Base64 to Hex converter>>https://base64.guru/converter/decode/hex]]**
300
Edwin Chen 111.1 301 [[image:image-20221010193621-2.png]]
302
303
Kilight Cao 124.1 304 == 5.2  Chirpstack Downlink Note ==
Edwin Chen 111.1 305
306
Xiaoling 108.2 307 [[image:image-20220601102543-2.png]]
Xiaoling 1.2 308
Xiaoling 121.2 309 **Convert the data to Base64**
Xiaoling 1.2 310
Xiaoling 121.2 311 (% style="display:none" %) (%%)
Xiaoling 86.14 312
Xiaoling 1.2 313
Xiaoling 121.2 314 [[image:image-20220531173236-10.png||height="597" width="1215"]]
Xiaoling 1.2 315
Xiaoling 121.2 316 **Check ChripStack downlink DataRate**
Xiaoling 86.15 317
Xiaoling 121.2 318
319
Xiaoling 65.2 320 [[image:image-20220525101326-11.png]]
Xiaoling 1.2 321
Xiaoling 121.2 322 **Make sure the RX2DR is the same in the end node**
Xiaoling 1.2 323
Xiaoling 86.16 324
Kilight Cao 124.1 325 == 5.3  Loraserver Downlink Note ==
Xiaoling 108.9 326
327
Xiaoling 1.2 328 User can use MQTT to send downlink payload to ChirpStack to perform downstream to LoRaWAN End
329
Xiaoling 1.5 330 (((
Xiaoling 108.9 331 **Below is examples:**
Xiaoling 1.5 332 )))
Xiaoling 1.2 333
Xiaoling 1.4 334 (% class="box" %)
335 (((
336 Connect to your server via MQTT:
337 MQTT Client ID: Any   
338 Protocol:mqtt/tcp   Server IP:loraserver_ip:1883
Xiaoling 1.2 339 User name: User name Password: password
Xiaoling 1.4 340 )))
Xiaoling 1.2 341
Xiaoling 97.2 342 [[image:image-20220531173419-11.png]]
Xiaoling 1.2 343
Xiaoling 1.5 344 (((
Xiaoling 121.2 345 **MQTT Connect to ChirpStack**
Xiaoling 86.17 346
Xiaoling 108.9 347
Xiaoling 86.17 348
Xiaoling 1.5 349 )))
Xiaoling 1.2 350
Xiaoling 1.5 351 (((
Xiaoling 108.9 352 **After connect**
Xiaoling 1.5 353 )))
Xiaoling 1.2 354
Xiaoling 1.4 355 (% class="box" %)
356 (((
357 Subscribe : Format:application/ID/device/ Device EUI/rx
Xiaoling 1.2 358 Example: application/7/device/00aedb3da649cb23/rx
Xiaoling 1.4 359 )))
Xiaoling 1.2 360
Xiaoling 1.4 361 (% class="box" %)
362 (((
363 Publish:
Xiaoling 1.2 364 Format: Top: application/ID/device/ Device EUI/tx
365 Payload: {"confirmed":true or false,"fPort":XX,"data":"xxxx"}
366 Example: Top: application/7/device/00aedb3da649cb23/tx
367 Payload: {"confirmed":true,"fPort":2,"data":"AwEB"}
Xiaoling 1.4 368 )))
Xiaoling 1.2 369
Xiaoling 98.2 370 [[image:image-20220531173519-12.png]]
Xiaoling 1.2 371
Xiaoling 121.2 372 **MQTT Connect to ChirpStack**
Xiaoling 1.2 373
Xiaoling 86.18 374
Xiaoling 121.2 375 **If we want to send downstream hex 030101 to end node, the BASE64 payload is AwEB**
Xiaoling 1.2 376
Xiaoling 100.2 377 [[image:image-20220531173658-14.png]]
Xiaoling 1.2 378
Xiaoling 108.9 379
Xiaoling 1.5 380 (((
Xiaoling 1.2 381 Downlink payload encode javescript code: 可以在网站上运行以下Javsscript代码:
Xiaoling 1.5 382 )))
Xiaoling 1.2 383
Xiaoling 1.4 384 (% class="box" %)
385 (((
386 function sha1_to_base64(sha1)
Xiaoling 1.2 387 {
388 var digits="ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/";
389 var base64_rep = "";
390 var cnt = 0;
391 var bit_arr = 0;
392 var bit_num = 0;
Xiaoling 1.5 393 \\ for(var n = 0; n < sha1.length; ++n)
Xiaoling 1.2 394 {
395 if(sha1[n] >= 'A' && sha1[n] <= 'Z')
396 {
Jean-Philippe Gagné 121.1 397 ascv = sha1.charCodeAt( n ) - 55;
Xiaoling 1.2 398 }
399 else if(sha1[n] >= 'a' && sha1[n] <= 'z')
400 {
Jean-Philippe Gagné 121.1 401 ascv = sha1.charCodeAt( n ) - 87;
Xiaoling 1.2 402 }
403 else
404 {
Jean-Philippe Gagné 121.1 405 ascv = sha1.charCodeAt( n ) - 48;
Xiaoling 1.2 406 }
Xiaoling 1.5 407 \\ bit_arr = (bit_arr << 4) | ascv;
Xiaoling 1.2 408 bit_num += 4;
409 if(bit_num >= 6)
410 {
Xiaoling 1.4 411 bit_num -= 6;        
Xiaoling 1.2 412 base64_rep += digits[bit_arr >>> bit_num];
Xiaoling 1.4 413 bit_arr &= ~~(-1 << bit_num);
Xiaoling 1.2 414 }
415 }
Xiaoling 1.5 416 \\ if(bit_num > 0)
Xiaoling 1.2 417 {
418 bit_arr <<= 6 - bit_num;
419 base64_rep += digits[bit_arr];
420 }
Xiaoling 1.5 421 \\ var padding = base64_rep.length % 4;   
422 \\ if(padding > 0)
Xiaoling 1.2 423 {
424 for(var n = 0; n < 4 - padding; ++n)
425 {
426 base64_rep += "=";
427 }
428 }
429 return base64_rep;
430 }
Xiaoling 1.5 431 \\console.log(sha1_to_base64("data"));
432 \\data is downlink payload required by end node.
Xiaoling 1.4 433 e.g console.log(sha1_to_base64("030101"));
434 ​result: AwEB     
Xiaoling 1.2 435 AwEB is the 0x030101's base 64 Encode.
Xiaoling 1.5 436 \\​e.g console.log(sha1_to_base64("030000"));
Xiaoling 1.4 437 ​result: AwAA     
438 AwAA is 0x030000's base 64 Encode.
439 )))
Xiaoling 1.2 440
Xiaoling 86.21 441
Xiaoling 1.2 442
Xiaoling 108.9 443 == 4.3  Add the decode function in Chirpstack for the payload ==
444
445
Xiaoling 1.2 446 User enters the payload code according to the steps.
447
Xiaoling 121.2 448 [[image:image-20220531173754-15.png||height="474" width="1334"]]
Xiaoling 1.2 449
450
Xiaoling 102.2 451 [[image:image-20220531173856-16.png]]
Xiaoling 1.2 452
Xiaoling 102.2 453
Xiaoling 106.2 454 [[image:image-20220531174120-20.png]]
Xiaoling 84.2 455
Xiaoling 105.2 456 [[image:image-20220531174046-19.png]]
Xiaoling 1.2 457
Xiaoling 86.22 458
Kilight Cao 124.1 459 = 6.  Multiply Uplink in ChirpStack =
Xiaoling 108.9 460
461
Xiaoling 1.4 462 (((
Xiaoling 1.2 463 nbtrans field is the value to determine the re-transmission time for unconfirmed uplink data.
Xiaoling 1.4 464 )))
Xiaoling 1.2 465
Xiaoling 1.4 466 (((
Xiaoling 1.2 467 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 468
469
Xiaoling 1.4 470 )))
Xiaoling 1.2 471
Xiaoling 121.2 472 [[image:image-20220526091912-7.png||height="241" width="1336"]]
Xiaoling 1.2 473
Xiaoling 108.9 474
Xiaoling 1.5 475 (((
Xiaoling 1.2 476 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 477
478
Xiaoling 1.5 479 )))
Xiaoling 1.2 480
Xiaoling 76.2 481 [[image:image-20220525104359-21.png]]
Xiaoling 1.2 482
Xiaoling 1.4 483 (((
Xiaoling 1.2 484 Above behaviour will cause the platform shows below two cases of error:
Xiaoling 108.9 485
486
Xiaoling 1.4 487 )))
Xiaoling 1.2 488
Xiaoling 1.4 489 (((
Xiaoling 1.2 490 Error of duplicate Frame Counter
Xiaoling 1.4 491 )))
Xiaoling 1.2 492
Xiaoling 76.2 493 [[image:image-20220525104437-22.png]]
Xiaoling 1.2 494
Xiaoling 86.23 495
Xiaoling 108.9 496
Xiaoling 121.2 497 **Duplicate transmission in short time**
Xiaoling 1.2 498
Xiaoling 121.2 499 [[image:image-20220601102430-1.png||height="598" width="1319"]]
Xiaoling 1.2 500
Xiaoling 86.24 501
Xiaoling 1.2 502
Kilight Cao 124.1 503 == 6.1  Solution ==
Xiaoling 108.9 504
505
Xiaoling 1.2 506 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]]
507
Xiaoling 108.9 508
Xiaoling 1.5 509 (((
Xiaoling 108.11 510 (% 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 108.9 511
512
Xiaoling 1.5 513 )))
Xiaoling 1.2 514
Xiaoling 79.2 515 [[image:image-20220525104532-24.png]]
Xiaoling 1.2 516
Xiaoling 86.25 517
Xiaoling 108.9 518 **installation path:**
Xiaoling 1.2 519
Xiaoling 79.2 520 [[image:image-20220525104554-25.png]]
Xiaoling 1.2 521
Xiaoling 86.25 522
Xiaoling 108.9 523
Xiaoling 1.5 524 (((
Xiaoling 108.11 525 (% style="color:blue" %)**2.  Environment variable settings:**
Xiaoling 1.5 526 )))
Xiaoling 1.2 527
Xiaoling 1.5 528 (((
Xiaoling 1.2 529 1) Open Computer -> Properties -> Advanced System Settings -> Environment Variables and add a "new" system variable:
Xiaoling 1.5 530 )))
Xiaoling 1.2 531
Xiaoling 1.5 532 (((
Xiaoling 108.9 533 2) Set the variable name GOROOT and the variable value C:\Go\ (installation directory)
Xiaoling 1.5 534 )))
Xiaoling 1.2 535
Xiaoling 43.2 536 [[image:image-20220524165433-33.png]]
Xiaoling 1.2 537
Xiaoling 86.26 538
Xiaoling 108.9 539 3) Modify the system variable Path and add C:\Go\bin\:
Xiaoling 1.2 540
Xiaoling 43.2 541 [[image:image-20220524165452-34.png]]
Xiaoling 1.2 542
Xiaoling 106.3 543
Xiaoling 1.2 544 User variable setting file generation directory: D:\go:
545
Xiaoling 43.2 546 [[image:image-20220524165517-35.png]]
Xiaoling 1.2 547
Xiaoling 86.27 548
Xiaoling 1.2 549
Xiaoling 108.11 550 (% 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 551
Xiaoling 1.2 552 The name of the plugin: Example ADR plugin:
553
Xiaoling 48.2 554 [[image:image-20220524165540-36.png]]
Xiaoling 1.2 555
556 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.
557
Xiaoling 48.2 558 [[image:image-20220524165557-37.png]]
Xiaoling 1.2 559
Xiaoling 86.28 560
Xiaoling 1.2 561
Xiaoling 108.11 562 (% style="color:blue" %)**4.  Compile the ADR configuration file and generate the exe file.**
Xiaoling 108.9 563
Xiaoling 1.2 564 1) Create a folder named adr-setting
565
566 2) Open the adr-setting folder
567
568 3) Put adr.setting.go in this folder.
569
570 4) Open the computer cmd and run the following commands in sequencecd adr-setting
571
572 go mod init adr-setting
573
574 go get github.com/brocaar/chirpstack-network-server/v3/adr
575
576 go get github.com/hashicorp/go-plugin
577
578 go get adr-setting
579
580 go build
581
582 5) Finally generate this file:
583
Xiaoling 48.2 584 [[image:image-20220524165623-38.png]]
Xiaoling 1.2 585
Xiaoling 86.29 586
Xiaoling 1.2 587
Xiaoling 108.11 588 (% style="color:blue" %)**5.  Add the plugin and run the plugin.**
Xiaoling 108.9 589
Xiaoling 1.5 590 (((
Xiaoling 1.2 591 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 592 )))
Xiaoling 1.2 593
Xiaoling 48.2 594 [[image:image-20220524165641-39.png]]
Xiaoling 1.2 595
Xiaoling 1.4 596 (((
Xiaoling 1.5 597 (((
Xiaoling 1.2 598 For example: adr_plugins=[“adr-setting”]
Xiaoling 1.4 599 )))
Xiaoling 1.5 600 )))
Xiaoling 1.2 601
Xiaoling 1.4 602 * (((
Xiaoling 1.5 603 (((
Xiaoling 1.4 604 Adding a single plugin format is adr_plugins=["filename"]
605 )))
Xiaoling 1.5 606 )))
Xiaoling 1.2 607
Xiaoling 1.4 608 * (((
Xiaoling 1.5 609 (((
Xiaoling 1.4 610 Adding multiple plugins The format is adr_plugins=["file name 1", "file name 2",...]
611 )))
Xiaoling 1.5 612 )))
Xiaoling 1.2 613
Xiaoling 1.4 614 (((
Xiaoling 1.5 615 (((
Xiaoling 1.2 616 Finally, re-run chirpstack-network-server.exe, and then select the plugin you just compiled in Device-profiles,
Xiaoling 1.4 617 )))
Xiaoling 1.5 618 )))
Xiaoling 1.2 619
Xiaoling 79.2 620 [[image:image-20220525104647-26.png]]
Xiaoling 1.2 621
622 Finish.
623
Xiaoling 86.30 624
Kilight Cao 124.1 625 = 7.  How to store/get all data traffic for a specific sensor, including raw payload, and uplink/ downlink history. =
Xiaoling 108.9 626
Xiaoling 1.2 627
Xiaoye 115.1 628 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 629
Xiaoye 115.1 630 This example will be shown how to store/get all the data in two ways:
Xiaoling 108.9 631
Xiaoye 115.1 632 **//1). Chirpstack ~-~-> Node-red//**
633
634
Xiaoye 117.1 635 [[image:image-20221012184501-1.png]]
Xiaoye 115.1 636
Xiaoling 121.2 637
Xiaoye 120.1 638 Use MQTT in Nore-red to subscribe to topics published by the chirpstack-application and then continuously write to a file
Xiaoye 115.1 639
640 [[image:image-20221012174220-2.png]]
641
642
Xiaoye 120.1 643 [[image:image-20221012184655-3.png||height="395" width="1049"]]
644
645
Xiaoling 121.2 646 **Each message is continuously logged to a specified file**
Xiaoye 115.1 647
648 [[image:image-20221012174352-3.png]]
649
650
651 **//2). MQTT  Sub//**
652
653 If you don't want to store the information via node-red, you can get the output via the subscribe command.
654
655
656 **If connecting from the same machine, you can use the following command to receive data:**
657
658 (% class="box infomessage" %)
Xiaoling 1.4 659 (((
Xiaoye 115.1 660 mosquitto_sub -h localhost -t "application/#" -v
661 )))
662
663
664 **Different host**
665
666 (% class="box infomessage" %)
667 (((
668 mosquitto_sub -h IPADDRESS -p 8883 ~-~-insecure ~-~-cafile ca.pem ~-~-cert cert.pem ~-~-key key.pem -t "application/#" -v
669 )))
670
671 [[image:image-20221012173639-1.png]]
672
673
Kilight Cao 124.1 674 = 8.  Trouble Shooting =
Xiaoye 115.1 675
Kilight Cao 124.1 676 == 8.1  MIC Mismatch or MIC Failed ==
Xiaoye 115.1 677
678
679 (((
Xiaoling 1.2 680 When the device is registered or the device is working normally, the problem of MIC mismatch and MIC failed occurs.
Xiaoling 1.4 681 )))
Xiaoling 1.2 682
Xiaoling 1.4 683 (((
Xiaoling 1.2 684 Under normal circumstances, users need to change the APPKEY to solve this problem.
Xiaoling 1.4 685 )))