Changes for page Notes for ChirpStack
Last modified by Kilight Cao on 2024/09/24 15:23
Summary
-
Page properties (1 modified, 0 added, 0 removed)
-
Attachments (0 modified, 10 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,12 +177,14 @@ 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 184 -[[image:image-20220525101223-9.png]] 185 185 219 +[[image:image-20220601102543-2.png]] 220 + 186 186 Convert the data to Base64 187 187 188 188 ... ... @@ -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,18 +245,20 @@ 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 -[[image:image-202205 25101505-14.png]]289 +[[image:image-20220531173601-13.png]] 252 252 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 -[[image:image-202205 25104025-15.png]]297 +[[image:image-20220531173658-14.png]] 259 259 299 + 260 260 ((( 261 261 Downlink payload encode javescript code: 可以在网站上运行以下Javsscript代码: 262 262 ))) ... ... @@ -319,22 +319,27 @@ 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 -[[image:image-202205 25104051-16.png]]368 +[[image:image-20220531173754-15.png]] 327 327 328 -[[image:image-20220525104155-17.png]] 329 329 371 +[[image:image-20220531173856-16.png]] 330 330 331 -[[image:image-20220526091602-5.png]] 332 332 333 -[[image:image-202205 26091801-6.png]]374 +[[image:image-20220531174120-20.png]] 334 334 376 +[[image:image-20220531174046-19.png]] 335 335 336 -= 5. Multiply Uplink in ChirpStack = 337 337 379 + 380 += 5. Multiply Uplink in ChirpStack = 381 + 382 + 338 338 ((( 339 339 nbtrans field is the value to determine the re-transmission time for unconfirmed uplink data. 340 340 ))) ... ... @@ -341,12 +341,17 @@ 341 341 342 342 ((( 343 343 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 + 344 344 ))) 345 345 346 346 [[image:image-20220526091912-7.png]] 347 347 395 + 348 348 ((( 349 349 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 + 350 350 ))) 351 351 352 352 [[image:image-20220525104359-21.png]] ... ... @@ -353,6 +353,8 @@ 353 353 354 354 ((( 355 355 Above behaviour will cause the platform shows below two cases of error: 406 + 407 + 356 356 ))) 357 357 358 358 ((( ... ... @@ -362,29 +362,36 @@ 362 362 [[image:image-20220525104437-22.png]] 363 363 364 364 417 + 365 365 Duplicate transmission in short time 366 366 367 -[[image:image-20220 525104502-23.png]]420 +[[image:image-20220601102430-1.png]] 368 368 369 369 370 -== 5.1 Solution == 371 371 424 +== 5.1 Solution == 425 + 426 + 372 372 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]] 373 373 429 + 374 374 ((( 375 -~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 + 376 376 ))) 377 377 378 378 [[image:image-20220525104532-24.png]] 379 379 380 380 381 -installation path: 439 +**installation path:** 382 382 383 383 [[image:image-20220525104554-25.png]] 384 384 385 385 444 + 386 386 ((( 387 -2. Environment variable settings: .446 +(% style="color:blue" %)**2. Environment variable settings:** 388 388 ))) 389 389 390 390 ((( ... ... @@ -392,23 +392,25 @@ 392 392 ))) 393 393 394 394 ((( 395 -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) 396 396 ))) 397 397 398 398 [[image:image-20220524165433-33.png]] 399 399 400 400 401 -3)Modify the system variable Path and add C:\Go\bin\: 460 +3) Modify the system variable Path and add C:\Go\bin\: 402 402 403 403 [[image:image-20220524165452-34.png]] 404 404 464 + 405 405 User variable setting file generation directory: D:\go: 406 406 407 407 [[image:image-20220524165517-35.png]] 408 408 409 409 410 -3. Modify the ADR configuration file according to your own needs, adr.setting.go is an example of the ADR configuration file. 411 411 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 + 412 412 The name of the plugin: Example ADR plugin: 413 413 414 414 [[image:image-20220524165540-36.png]] ... ... @@ -418,8 +418,9 @@ 418 418 [[image:image-20220524165557-37.png]] 419 419 420 420 421 -4. Compile the ADR configuration file and generate the exe file. 422 422 483 +(% style="color:blue" %)**4. Compile the ADR configuration file and generate the exe file.** 484 + 423 423 1) Create a folder named adr-setting 424 424 425 425 2) Open the adr-setting folder ... ... @@ -443,8 +443,9 @@ 443 443 [[image:image-20220524165623-38.png]] 444 444 445 445 446 -5. Add the plugin and run the plugin. 447 447 509 +(% style="color:blue" %)**5. Add the plugin and run the plugin.** 510 + 448 448 ((( 449 449 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: 450 450 ))) ... ... @@ -480,10 +480,12 @@ 480 480 Finish. 481 481 482 482 546 + 483 483 = 6. Trouble Shooting = 484 484 485 485 == 6.1 MIC Mismatch or MIC Failed == 486 486 551 + 487 487 ((( 488 488 When the device is registered or the device is working normally, the problem of MIC mismatch and MIC failed occurs. 489 489 )))
- image-20220531173601-13.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Xiaoling - Size
-
... ... @@ -1,0 +1,1 @@ 1 +67.6 KB - Content
- image-20220531173658-14.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Xiaoling - Size
-
... ... @@ -1,0 +1,1 @@ 1 +59.3 KB - Content
- image-20220531173754-15.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Xiaoling - Size
-
... ... @@ -1,0 +1,1 @@ 1 +41.7 KB - Content
- image-20220531173856-16.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Xiaoling - Size
-
... ... @@ -1,0 +1,1 @@ 1 +46.7 KB - Content
- image-20220531173939-17.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Xiaoling - Size
-
... ... @@ -1,0 +1,1 @@ 1 +41.4 KB - Content
- image-20220531174015-18.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Xiaoling - Size
-
... ... @@ -1,0 +1,1 @@ 1 +27.4 KB - Content
- image-20220531174046-19.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Xiaoling - Size
-
... ... @@ -1,0 +1,1 @@ 1 +27.2 KB - Content
- image-20220531174120-20.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Xiaoling - Size
-
... ... @@ -1,0 +1,1 @@ 1 +41.4 KB - Content
- image-20220601102430-1.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Xiaoling - Size
-
... ... @@ -1,0 +1,1 @@ 1 +139.4 KB - Content
- image-20220601102543-2.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Xiaoling - Size
-
... ... @@ -1,0 +1,1 @@ 1 +51.5 KB - Content