Skip to Content

Changes for page Notes for ChirpStack

Last modified by Xiaoling on 2025/07/31 17:18
From version 86.11
edited by Xiaoling
on 2022/05/30 15:28
Change comment: There is no comment for this version
To version 108.12
edited by Xiaoling
on 2022/07/23 14:29
Change comment: There is no comment for this version

Summary

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,51 +22,60 @@
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** : the firmware needs >  if use the Bais station
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         ~-~->Network-server server * : chirpstack-network-server:8000
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  
52 -[[image:image-20220525100158-2.png]]
56 +(% style="color:red" %)**If the user cannot add network-Servers, re-check the ChirpStack code or the server building process.**
53 53  
58 +
59 +[[image:image-20220531171609-1.png]]
60 +
54 54  Add the Network-servers
55 55  
56 56  
57 -== 2.2 Step 2. Create Gateway-profiles ==
58 58  
59 -[[image:image-20220525100255-3.png]]
65 +== 2.2  Step 2. Create Gateway-profiles ==
60 60  
67 +
68 +[[image:image-20220531171651-2.png]]
69 +
61 61  Create Gateway-profiles
62 62  
63 63  
64 -== 2.3 Step 3. Create Service-profiles ==
65 65  
66 -[[image:image-20220525100322-4.png]]
74 +== 2.3  Step 3. Create Service-profiles ==
67 67  
76 +
77 +[[image:image-20220531171809-3.png]]
78 +
68 68  Create Service-profiles
69 69  
81 +
70 70  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.
71 71  
72 72  (% style="color:red" %)**Note : Before add the gateway, the user needs to complete the preceding three steps.**
... ... @@ -74,69 +74,86 @@
74 74  If the user has completed the preceding steps, proceed to the next step.(% style="display:none" %)
75 75  
76 76  
77 -== 2.4 Step 4. Add the gateway ==
78 78  
90 +== 2.4  Step 4. Add the gateway ==
91 +
92 +
79 79  The example gateway id is: a840411e96744150
80 80  
81 81  (((
82 82  (% style="color:red" %)**Note : The Gateway EUI and server addresses must match the ChirpStack configuration.**
97 +
98 +
83 83  )))
84 84  
85 -[[image:image-20220525100350-5.png]](% style="display:none" %)
101 +[[image:image-20220531171923-4.png]](% style="display:none" %)
86 86  
87 -
88 88  Add the gateway
89 89  
90 -[[image:image-20220525100417-6.png]]
91 91  
106 +
107 +[[image:image-20220531172031-5.png]]
108 +
92 92  Configure the gateway
93 93  
94 94  
95 -== 2.5 Step 5. Checking gateway Status ==
96 96  
97 -[[image:image-20220525100448-7.png]](% style="display:none" %)
113 +== 2.5  Step 5. Checking gateway Status ==
98 98  
99 99  
116 +[[image:image-20220531172158-6.png]](% style="display:none" %)
117 +
118 +
119 +
100 100  gateway Status
101 101  
102 -[[image:image-20220526090446-3.png||height="653" width="1218"]]
122 +[[image:image-20220531172304-7.png]]
103 103  
104 104  gateway Status
105 105  
106 106  
107 -= 3. Gateway Registration for Basics Station =
108 108  
109 -== Introduction ==
128 += 3.  Gateway Registration for Basics Station =
110 110  
130 +
131 +== 3.1  Introduction ==
132 +
133 +
111 111  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.
112 112  
113 113  ChirpStack Open-Source LoRaWAN® Network Server needs to set up a configuration that can use Semtech BasicStation.
114 114  
115 -**Below list the support products and Requirements:**
116 116  
139 +(% style="color:blue" %)**Below list the support products and Requirements:**
140 +
117 117  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]]
118 118  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/]]
119 119  
120 -**How to set up chirpStack Basic Station**
144 +(% style="color:blue" %)**How to set up chirpStack Basic Station**
121 121  
122 122  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]]
123 123  
124 -**What do you need to prepare**
125 125  
149 +(% style="color:blue" %)**What do you need to prepare**
150 +
126 126  A gateway that can access the internet normally
127 127  
128 128  
129 -== 3.1 Add Gateway ==
130 130  
155 +== 3.2  Add Gateway ==
156 +
157 +
131 131  [[image:image-20220524164205-10.png]]
132 132  
133 133  
134 -== 3.2 Access the gateway GUI ==
161 +== 3.3  Access the gateway GUI ==
135 135  
163 +
136 136  Access the gateway GUI interface of LoRaWAN~-~->LoRaWAN ~-~- Basic Station
137 137  
138 138  [[image:image-20220524164319-11.png]]
139 139  
168 +
140 140  User need to Choose the ChirpStack/Senet ~-~- Basic Station , input Server URI and Upload the TLS Certificate
141 141  
142 142  (% class="box" %)
... ... @@ -152,50 +152,63 @@
152 152  [[image:image-20220524164341-12.png]]
153 153  
154 154  
155 -== 3.3 Start Station ==
184 +== 3.4  Start Station ==
156 156  
186 +
157 157  When the user has finished the configuration, Please click Sace&Apply to start station to connect ChirpStack
158 158  
159 159  
160 -== 3.4 Successful Connection ==
190 +== 3.5  Successful Connection ==
161 161  
192 +
162 162  If user completes the above steps, which will see live date in the ChirpStack.
163 163  
164 164  [[image:image-20220524164448-13.png]]
165 165  
166 166  
167 -== 3.5 Trouble Shooting ==
168 168  
199 +== 3.6  Trouble Shooting ==
200 +
201 +
169 169  User can check the station log in the logread/system log page.
170 170  
171 -[[image:image-20220524164514-14.png]]
204 +[[image:image-20220531172837-8.png]]
172 172  
206 +
173 173  and recode the station log in the system/Recode log page.
174 174  
175 -[[image:image-20220524164541-15.png]]
209 +[[image:image-20220531172857-9.png]]
176 176  
177 -= 4. Downlink =
178 178  
179 -== 4.1 Chirpstack Downlink Note ==
180 180  
181 -[[image:image-20220525101223-9.png]]
213 += 4.  Downlink =
182 182  
215 +== 4.1  Chirpstack Downlink Note ==
216 +
217 +
218 +[[image:image-20220601102543-2.png]]
219 +
183 183  Convert the data to Base64
184 184  
185 -[[image:image-20220526090748-4.png]]
186 186  
223 +[[image:image-20220531173236-10.png]]
224 +
187 187  Check ChripStack downlink DataRate
188 188  
227 +
189 189  [[image:image-20220525101326-11.png]]
190 190  
191 191  Make sure the RX2DR is the same in the end node
192 192  
193 -== 4.2 Loraserver Downlink Note ==
194 194  
233 +
234 +== 4.2  Loraserver Downlink Note ==
235 +
236 +
195 195  User can use MQTT to send downlink payload to ChirpStack to perform downstream to LoRaWAN End
196 196  
197 197  (((
198 -Below is examples:
240 +**Below is examples:**
199 199  )))
200 200  
201 201  (% class="box" %)
... ... @@ -206,14 +206,17 @@
206 206  User name: User name Password: password
207 207  )))
208 208  
209 -[[image:image-20220525101401-12.png]]
251 +[[image:image-20220531173419-11.png]]
210 210  
211 211  (((
212 212  MQTT Connect to ChirpStack
255 +
256 +
257 +
213 213  )))
214 214  
215 215  (((
216 -After connect
261 +**After connect**
217 217  )))
218 218  
219 219  (% class="box" %)
... ... @@ -231,22 +231,26 @@
231 231  Payload: {"confirmed":true,"fPort":2,"data":"AwEB"}
232 232  )))
233 233  
234 -[[image:image-20220525101436-13.png]]
279 +[[image:image-20220531173519-12.png]]
235 235  
236 236  MQTT Connect to ChirpStack
237 237  
283 +
238 238  (((
239 -(% 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/]]
285 +(% 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/]]**
240 240  )))
241 241  
242 -[[image:image-20220525101505-14.png]]
288 +[[image:image-20220531173601-13.png]]
243 243  
244 244  Choose to Use Hex for Encode
245 245  
292 +
293 +
246 246  If we want send downstream hex 030101 to end node, the BASE64 payload is AwEB
247 247  
248 -[[image:image-20220525104025-15.png]]
296 +[[image:image-20220531173658-14.png]]
249 249  
298 +
250 250  (((
251 251  Downlink payload encode javescript code: 可以在网站上运行以下Javsscript代码：
252 252  )))
... ... @@ -308,21 +308,28 @@
308 308   AwAA is 0x030000's base 64 Encode.
309 309  )))
310 310  
311 -== 4.3 Add the decode function in Chirpstack for the payload ==
312 312  
361 +
362 +== 4.3  Add the decode function in Chirpstack for the payload ==
363 +
364 +
313 313  User enters the payload code according to the steps.
314 314  
315 -[[image:image-20220525104051-16.png]]
367 +[[image:image-20220531173754-15.png]]
316 316  
317 -[[image:image-20220525104155-17.png]]
318 318  
370 +[[image:image-20220531173856-16.png]]
319 319  
320 -[[image:image-20220526091602-5.png]]
321 321  
322 -[[image:image-20220526091801-6.png]]
373 +[[image:image-20220531174120-20.png]]
323 323  
324 -= 5. Multiply Uplink in ChirpStack =
375 +[[image:image-20220531174046-19.png]]
325 325  
377 +
378 +
379 += 5.  Multiply Uplink in ChirpStack =
380 +
381 +
326 326  (((
327 327  nbtrans field is the value to determine the re-transmission time for unconfirmed uplink data.
328 328  )))
... ... @@ -329,12 +329,17 @@
329 329  
330 330  (((
331 331  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]]
388 +
389 +
332 332  )))
333 333  
334 334  [[image:image-20220526091912-7.png]]
335 335  
394 +
336 336  (((
337 337  nbtrans is a field of ADR message, in unconfirm mode, it tells end node how many time it needs to transmit for every frame.
397 +
398 +
338 338  )))
339 339  
340 340  [[image:image-20220525104359-21.png]]
... ... @@ -341,6 +341,8 @@
341 341  
342 342  (((
343 343  Above behaviour will cause the platform shows below two cases of error:
405 +
406 +
344 344  )))
345 345  
346 346  (((
... ... @@ -349,26 +349,37 @@
349 349  
350 350  [[image:image-20220525104437-22.png]]
351 351  
415 +
416 +
352 352  Duplicate transmission in short time
353 353  
354 -[[image:image-20220525104502-23.png]]
419 +[[image:image-20220601102430-1.png]]
355 355  
356 -== 5.1 Solution ==
357 357  
422 +
423 +== 5.1  Solution ==
424 +
425 +
358 358  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]]
359 359  
428 +
360 360  (((
361 -~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.
430 +(% 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.**
431 +
432 +
362 362  )))
363 363  
364 364  [[image:image-20220525104532-24.png]]
365 365  
366 -installation path:
367 367  
438 +**installation path:**
439 +
368 368  [[image:image-20220525104554-25.png]]
369 369  
442 +
443 +
370 370  (((
371 -2. Environment variable settings:.
445 +(% style="color:blue" %)**2.  Environment variable settings:**
372 372  )))
373 373  
374 374  (((
... ... @@ -376,21 +376,25 @@
376 376  )))
377 377  
378 378  (((
379 -2)Set the variable name GOROOT and the variable value C:\Go\ (installation directory)
453 +2) Set the variable name GOROOT and the variable value C:\Go\ (installation directory)
380 380  )))
381 381  
382 382  [[image:image-20220524165433-33.png]]
383 383  
384 -3)Modify the system variable Path and add C:\Go\bin\:
385 385  
459 +3) Modify the system variable Path and add C:\Go\bin\:
460 +
386 386  [[image:image-20220524165452-34.png]]
387 387  
463 +
388 388  User variable setting file generation directory: D:\go:
389 389  
390 390  [[image:image-20220524165517-35.png]]
391 391  
392 -3. Modify the ADR configuration file according to your own needs, adr.setting.go is an example of the ADR configuration file.
393 393  
469 +
470 +(% 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.**
471 +
394 394  The name of the plugin: Example ADR plugin:
395 395  
396 396  [[image:image-20220524165540-36.png]]
... ... @@ -399,8 +399,10 @@
399 399  
400 400  [[image:image-20220524165557-37.png]]
401 401  
402 -4. Compile the ADR configuration file and generate the exe file.
403 403  
481 +
482 +(% style="color:blue" %)**4.  Compile the ADR configuration file and generate the exe file.**
483 +
404 404  1) Create a folder named adr-setting
405 405  
406 406  2) Open the adr-setting folder
... ... @@ -423,8 +423,10 @@
423 423  
424 424  [[image:image-20220524165623-38.png]]
425 425  
426 -5. Add the plugin and run the plugin.
427 427  
507 +
508 +(% style="color:blue" %)**5.  Add the plugin and run the plugin.**
509 +
428 428  (((
429 429  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:
430 430  )))
... ... @@ -459,10 +459,13 @@
459 459  
460 460  Finish.
461 461  
462 -= 6. Trouble Shooting =
463 463  
464 -== 6.1 MIC Mismatch or MIC Failed ==
465 465  
546 += 6.  Trouble Shooting =
547 +
548 +== 6.1  MIC Mismatch or MIC Failed ==
549 +
550 +
466 466  (((
467 467  When the device is registered or the device is working normally, the problem of MIC mismatch and MIC failed occurs.
468 468  )))
image-20220531171609-1.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +79.4 KB
Content
image-20220531171651-2.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +86.3 KB
Content
image-20220531171809-3.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +126.4 KB
Content
image-20220531171923-4.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +113.1 KB
Content
image-20220531172031-5.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +62.4 KB
Content
image-20220531172158-6.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +108.7 KB
Content
image-20220531172304-7.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +162.5 KB
Content
image-20220531172837-8.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +67.9 KB
Content
image-20220531172857-9.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +36.6 KB
Content
image-20220531173236-10.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +160.2 KB
Content
image-20220531173419-11.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +104.3 KB
Content
image-20220531173519-12.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +63.9 KB
Content
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