Changes for page Notes for ChirpStack
Last modified by Edwin Chen on 2025/01/30 09:53
Summary
-
Page properties (1 modified, 0 added, 0 removed)
Details
- Page properties
-
- Content
-
... ... @@ -1,4 +1,4 @@ 1 -**~ Contents:** 1 +**~ Table of Contents:** 2 2 3 3 {{toc/}} 4 4 ... ... @@ -5,17 +5,20 @@ 5 5 6 6 7 7 8 -= 1. Introduction = 8 += 1. Introduction = 9 9 10 + 10 10 (% 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/]] 11 11 12 12 ((( 13 13 (% style="color:black" %)The dragino gateway can connect the ChirpStack server via Semtech UDP or Semtech Basic Station. 15 + 16 + 14 14 ))) 15 15 16 -**Prerequisite** 19 +(% style="color:blue" %)**Prerequisite:** 17 17 18 -1) Have a Chirstack Server. 21 +**1) Have a Chirstack Server.** 19 19 20 20 [[image:image-20220525100058-1.png]] 21 21 ... ... @@ -22,47 +22,55 @@ 22 22 ChirpStack home page 23 23 24 24 25 -2) Gateway model support 26 26 29 +**2) Gateway model support** 30 + 27 27 (% class="box" %) 28 28 ((( 29 29 ((( 30 30 Semtech UDP : **All Model** 31 -Basic Station : , , 32 -**Note** 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 33 33 ))) 34 34 ))) 35 35 36 36 37 37 38 -= 2. Semtech UDP = 42 += 2. Semtech UDP = 39 39 40 -== 2.1 Step 1. Add the Network-servers == 44 +== 2.1 Step 1. Add the Network-servers == 41 41 46 + 42 42 The network-Servers address varies depending on the ChirpStack server setup environment 43 43 44 44 (% class="box" %) 45 45 ((( 46 - Windows ~-~->Network-server server * : localhost:8000 47 - Linux 51 + Windows ~-~-> Network-server server * : localhost:8000 52 + Linux ~-~-> Network-server server * : chirpstack-network-server:8000 48 48 ))) 49 49 50 -If the user cannot add network-Servers, re-check the ChirpStack code or the server building process. 51 51 56 +(% style="color:red" %)**If the user cannot add network-Servers, re-check the ChirpStack code or the server building process.** 57 + 58 + 52 52 [[image:image-20220531171609-1.png]] 53 53 54 54 Add the Network-servers 55 55 56 56 57 -== 2.2 Step 2. Create Gateway-profiles == 58 58 65 +== 2.2 Step 2. Create Gateway-profiles == 66 + 67 + 59 59 [[image:image-20220531171651-2.png]] 60 60 61 61 Create Gateway-profiles 62 62 63 63 64 -== 2.3 Step 3. Create Service-profiles == 65 65 74 +== 2.3 Step 3. Create Service-profiles == 75 + 76 + 66 66 [[image:image-20220531171809-3.png]] 67 67 68 68 Create Service-profiles ... ... @@ -75,29 +75,37 @@ 75 75 If the user has completed the preceding steps, proceed to the next step.(% style="display:none" %) 76 76 77 77 78 -== 2.4 Step 4. Add the gateway == 79 79 90 +== 2.4 Step 4. Add the gateway == 91 + 92 + 80 80 The example gateway id is: a840411e96744150 81 81 82 82 ((( 83 83 (% style="color:red" %)**Note : The Gateway EUI and server addresses must match the ChirpStack configuration.** 97 + 98 + 84 84 ))) 85 85 86 86 [[image:image-20220531171923-4.png]](% style="display:none" %) 87 87 88 - 89 89 Add the gateway 90 90 105 + 106 + 91 91 [[image:image-20220531172031-5.png]] 92 92 93 93 Configure the gateway 94 94 95 95 96 -== 2.5 Step 5. Checking gateway Status == 97 97 113 +== 2.5 Step 5. Checking gateway Status == 114 + 115 + 98 98 [[image:image-20220531172158-6.png]](% style="display:none" %) 99 99 100 100 119 + 101 101 gateway Status 102 102 103 103 [[image:image-20220531172304-7.png]] ... ... @@ -105,39 +105,49 @@ 105 105 gateway Status 106 106 107 107 108 -= 3. Gateway Registration for Basics Station = 109 109 110 -= =3.1Introduction ==128 += 3. Gateway Registration for Basics Station = 111 111 130 + 131 +== 3.1 Introduction == 132 + 133 + 112 112 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. 113 113 114 114 ChirpStack Open-Source LoRaWAN® Network Server needs to set up a configuration that can use Semtech BasicStation. 115 115 116 -**Below list the support products and Requirements:** 117 117 139 +(% style="color:blue" %)**Below list the support products and Requirements:** 140 + 118 118 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]] 119 119 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/]] 120 120 121 -**How to set up chirpStack Basic Station** 122 122 145 +(% style="color:blue" %)**How to set up chirpStack Basic Station** 146 + 123 123 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]] 124 124 125 -**What do you need to prepare** 126 126 150 +(% style="color:blue" %)**What do you need to prepare** 151 + 127 127 A gateway that can access the internet normally 128 128 129 129 130 -== 3.2 Add Gateway == 131 131 156 +== 3.2 Add Gateway == 157 + 158 + 132 132 [[image:image-20220524164205-10.png]] 133 133 134 134 135 -== 3.3 Access the gateway GUI == 162 +== 3.3 Access the gateway GUI == 136 136 164 + 137 137 Access the gateway GUI interface of LoRaWAN~-~->LoRaWAN ~-~- Basic Station 138 138 139 139 [[image:image-20220524164319-11.png]] 140 140 169 + 141 141 User need to Choose the ChirpStack/Senet ~-~- Basic Station , input Server URI and Upload the TLS Certificate 142 142 143 143 (% class="box" %) ... ... @@ -153,20 +153,24 @@ 153 153 [[image:image-20220524164341-12.png]] 154 154 155 155 156 -== 3.4 Start Station == 185 +== 3.4 Start Station == 157 157 187 + 158 158 When the user has finished the configuration, Please click Sace&Apply to start station to connect ChirpStack 159 159 160 160 161 -== 3.5 Successful Connection == 191 +== 3.5 Successful Connection == 162 162 193 + 163 163 If user completes the above steps, which will see live date in the ChirpStack. 164 164 165 165 [[image:image-20220524164448-13.png]] 166 166 167 167 168 -== 3.6 Trouble Shooting == 169 169 200 +== 3.6 Trouble Shooting == 201 + 202 + 170 170 User can check the station log in the logread/system log page. 171 171 172 172 [[image:image-20220531172837-8.png]] ... ... @@ -177,10 +177,12 @@ 177 177 [[image:image-20220531172857-9.png]] 178 178 179 179 213 + 180 180 = 4. Downlink = 181 181 182 182 == 4.1 Chirpstack Downlink Note == 183 183 218 + 184 184 [[image:image-20220601102543-2.png]] 185 185 186 186 Convert the data to Base64 ... ... @@ -196,12 +196,14 @@ 196 196 Make sure the RX2DR is the same in the end node 197 197 198 198 199 -== 4.2 Loraserver Downlink Note == 200 200 235 +== 4.2 Loraserver Downlink Note == 236 + 237 + 201 201 User can use MQTT to send downlink payload to ChirpStack to perform downstream to LoRaWAN End 202 202 203 203 ((( 204 -Below is examples: 241 +**Below is examples:** 205 205 ))) 206 206 207 207 (% class="box" %) ... ... @@ -217,11 +217,12 @@ 217 217 ((( 218 218 MQTT Connect to ChirpStack 219 219 257 + 220 220 221 221 ))) 222 222 223 223 ((( 224 -After connect 262 +**After connect** 225 225 ))) 226 226 227 227 (% class="box" %) ... ... @@ -245,7 +245,7 @@ 245 245 246 246 247 247 ((( 248 -(% style="color:red" %)Note: Chirpstack use base64 to downlink, so need to convert the downlink payload from HEX to base64 [[https:~~/~~/base64.us/>>url:https://base64.us/]] 286 +(% style="color:red" %)**Note: Chirpstack use base64 to downlink, so need to convert the downlink payload from HEX to base64 [[https:~~/~~/base64.us/>>url:https://base64.us/]]** 249 249 ))) 250 250 251 251 [[image:image-20220531173601-13.png]] ... ... @@ -253,10 +253,12 @@ 253 253 Choose to Use Hex for Encode 254 254 255 255 294 + 256 256 If we want send downstream hex 030101 to end node, the BASE64 payload is AwEB 257 257 258 258 [[image:image-20220531173658-14.png]] 259 259 299 + 260 260 ((( 261 261 Downlink payload encode javescript code: 可以在网站上运行以下Javsscript代码: 262 262 ))) ... ... @@ -319,8 +319,10 @@ 319 319 ))) 320 320 321 321 322 -== 4.3 Add the decode function in Chirpstack for the payload == 323 323 363 +== 4.3 Add the decode function in Chirpstack for the payload == 364 + 365 + 324 324 User enters the payload code according to the steps. 325 325 326 326 [[image:image-20220531173754-15.png]] ... ... @@ -334,8 +334,10 @@ 334 334 [[image:image-20220531174046-19.png]] 335 335 336 336 337 -= 5. Multiply Uplink in ChirpStack = 338 338 380 += 5. Multiply Uplink in ChirpStack = 381 + 382 + 339 339 ((( 340 340 nbtrans field is the value to determine the re-transmission time for unconfirmed uplink data. 341 341 ))) ... ... @@ -342,12 +342,17 @@ 342 342 343 343 ((( 344 344 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]] 389 + 390 + 345 345 ))) 346 346 347 347 [[image:image-20220526091912-7.png]] 348 348 395 + 349 349 ((( 350 350 nbtrans is a field of ADR message, in unconfirm mode, it tells end node how many time it needs to transmit for every frame. 398 + 399 + 351 351 ))) 352 352 353 353 [[image:image-20220525104359-21.png]] ... ... @@ -354,6 +354,8 @@ 354 354 355 355 ((( 356 356 Above behaviour will cause the platform shows below two cases of error: 406 + 407 + 357 357 ))) 358 358 359 359 ((( ... ... @@ -363,29 +363,36 @@ 363 363 [[image:image-20220525104437-22.png]] 364 364 365 365 417 + 366 366 Duplicate transmission in short time 367 367 368 368 [[image:image-20220601102430-1.png]] 369 369 370 370 371 -== 5.1 Solution == 372 372 424 +== 5.1 Solution == 425 + 426 + 373 373 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]] 374 374 429 + 375 375 ((( 376 -~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. 431 +(% 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.** 432 + 433 + 377 377 ))) 378 378 379 379 [[image:image-20220525104532-24.png]] 380 380 381 381 382 -installation path: 439 +**installation path:** 383 383 384 384 [[image:image-20220525104554-25.png]] 385 385 386 386 444 + 387 387 ((( 388 -2. Environment variable settings: .446 +(% style="color:blue" %)**2. Environment variable settings:** 389 389 ))) 390 390 391 391 ((( ... ... @@ -393,13 +393,13 @@ 393 393 ))) 394 394 395 395 ((( 396 -2)Set the variable name GOROOT and the variable value C:\Go\ (installation directory) 454 +2) Set the variable name GOROOT and the variable value C:\Go\ (installation directory) 397 397 ))) 398 398 399 399 [[image:image-20220524165433-33.png]] 400 400 401 401 402 -3)Modify the system variable Path and add C:\Go\bin\: 460 +3) Modify the system variable Path and add C:\Go\bin\: 403 403 404 404 [[image:image-20220524165452-34.png]] 405 405 ... ... @@ -409,8 +409,9 @@ 409 409 [[image:image-20220524165517-35.png]] 410 410 411 411 412 -3. Modify the ADR configuration file according to your own needs, adr.setting.go is an example of the ADR configuration file. 413 413 471 +(% 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.** 472 + 414 414 The name of the plugin: Example ADR plugin: 415 415 416 416 [[image:image-20220524165540-36.png]] ... ... @@ -420,8 +420,9 @@ 420 420 [[image:image-20220524165557-37.png]] 421 421 422 422 423 -4. Compile the ADR configuration file and generate the exe file. 424 424 483 +(% style="color:blue" %)**4. Compile the ADR configuration file and generate the exe file.** 484 + 425 425 1) Create a folder named adr-setting 426 426 427 427 2) Open the adr-setting folder ... ... @@ -445,8 +445,9 @@ 445 445 [[image:image-20220524165623-38.png]] 446 446 447 447 448 -5. Add the plugin and run the plugin. 449 449 509 +(% style="color:blue" %)**5. Add the plugin and run the plugin.** 510 + 450 450 ((( 451 451 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: 452 452 ))) ... ... @@ -482,10 +482,12 @@ 482 482 Finish. 483 483 484 484 546 + 485 485 = 6. Trouble Shooting = 486 486 487 487 == 6.1 MIC Mismatch or MIC Failed == 488 488 551 + 489 489 ((( 490 490 When the device is registered or the device is working normally, the problem of MIC mismatch and MIC failed occurs. 491 491 )))