Skip to Content

Changes for page Notes for ChirpStack

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