Changes for page Notes for ChirpStack

Last modified by Kilight Cao on 2024/09/24 15:23
<
From version < 111.1 >
edited by Edwin Chen
on 2022/10/10 19:36
To version < 86.22 >
edited by Xiaoling
on 2022/05/30 15:31
>
Change comment: There is no comment for this version

Summary

Details

Page properties
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.Edwin
1 +XWiki.Xiaoling
Content
... ... @@ -1,4 +1,4 @@
1 -**~ Table of Contents:**
1 +**~ Contents:**
2 2  
3 3  {{toc/}}
4 4  
... ... @@ -5,20 +5,17 @@
5 5  
6 6  
7 7  
8 -= 1.  Introduction =
8 += 1. Introduction =
9 9  
10 -
11 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/]]
12 12  
13 13  (((
14 14  (% style="color:black" %)The dragino gateway can connect the ChirpStack server via Semtech UDP or Semtech Basic Station.
15 -
16 -
17 17  )))
18 18  
19 -(% style="color:blue" %)**Prerequisite:**
16 +**Prerequisite**
20 20  
21 -**1) Have a Chirstack Server.**
18 +1) Have a Chirstack Server.
22 22  
23 23  [[image:image-20220525100058-1.png]]
24 24  
... ... @@ -25,60 +25,51 @@
25 25  ChirpStack home page
26 26  
27 27  
25 +2) Gateway model support
28 28  
29 -**2) Gateway model support**
30 -
31 31  (% class="box" %)
32 32  (((
33 33  (((
34 34  Semtech UDP : **All Model**
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
31 +Basic Station : , , 
32 +**Note** : the firmware needs >  if use the Bais station
37 37  )))
38 38  )))
39 39  
40 40  
41 41  
42 -= 2.  Semtech UDP =
38 += 2. Semtech UDP =
43 43  
44 -== 2.1  Step 1. Add the Network-servers ==
40 +== 2.1 Step 1. Add the Network-servers ==
45 45  
46 -
47 47  The network-Servers address varies depending on the ChirpStack server setup environment
48 48  
49 49  (% class="box" %)
50 50  (((
51 - Windows       ~-~->  Network-server server *  :  localhost:8000
52 - Linux  ~-~->  Network-server server *  :  chirpstack-network-server:8000
46 + Windows       ~-~->Network-server server * : localhost:8000
47 + Linux         ~-~->Network-server server * : chirpstack-network-server:8000
53 53  )))
54 54  
50 +If the user cannot add network-Servers, re-check the ChirpStack code or the server building process.
55 55  
56 -(% style="color:red" %)**If the user cannot add network-Servers, re-check the ChirpStack code or the server building process.**
52 +[[image:image-20220525100158-2.png]]
57 57  
58 -
59 -[[image:image-20220531171609-1.png]]
60 -
61 61  Add the Network-servers
62 62  
63 63  
57 +== 2.2 Step 2. Create Gateway-profiles ==
64 64  
65 -== 2.2  Step 2. Create Gateway-profiles ==
59 +[[image:image-20220525100255-3.png]]
66 66  
67 -
68 -[[image:image-20220531171651-2.png]]
69 -
70 70  Create Gateway-profiles
71 71  
72 72  
64 +== 2.3 Step 3. Create Service-profiles ==
73 73  
74 -== 2.3  Step 3. Create Service-profiles ==
66 +[[image:image-20220525100322-4.png]]
75 75  
76 -
77 -[[image:image-20220531171809-3.png]]
78 -
79 79  Create Service-profiles
80 80  
81 -
82 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 83  
84 84  (% style="color:red" %)**Note : Before add the gateway, the user needs to complete the preceding three steps.**
... ... @@ -86,86 +86,69 @@
86 86  If the user has completed the preceding steps, proceed to the next step.(% style="display:none" %)
87 87  
88 88  
77 +== 2.4 Step 4. Add the gateway ==
89 89  
90 -== 2.4  Step 4. Add the gateway ==
91 -
92 -
93 93  The example gateway id is: a840411e96744150
94 94  
95 95  (((
96 96  (% style="color:red" %)**Note : The Gateway EUI and server addresses must match the ChirpStack configuration.**
97 -
98 -
99 99  )))
100 100  
101 -[[image:image-20220531171923-4.png]](% style="display:none" %)
85 +[[image:image-20220525100350-5.png]](% style="display:none" %)
102 102  
87 +
103 103  Add the gateway
104 104  
90 +[[image:image-20220525100417-6.png]]
105 105  
106 -
107 -[[image:image-20220531172031-5.png]]
108 -
109 109  Configure the gateway
110 110  
111 111  
95 +== 2.5 Step 5. Checking gateway Status ==
112 112  
113 -== 2.5  Step 5. Checking gateway Status ==
97 +[[image:image-20220525100448-7.png]](% style="display:none" %)
114 114  
115 115  
116 -[[image:image-20220531172158-6.png]](% style="display:none" %)
117 -
118 -
119 -
120 120  gateway Status
121 121  
122 -[[image:image-20220531172304-7.png]]
102 +[[image:image-20220526090446-3.png||height="653" width="1218"]]
123 123  
124 124  gateway Status
125 125  
126 126  
107 += 3. Gateway Registration for Basics Station =
127 127  
128 -= 3.  Gateway Registration for Basics Station =
109 +== Introduction ==
129 129  
130 -
131 -== 3.1  Introduction ==
132 -
133 -
134 134  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.
135 135  
136 136  ChirpStack Open-Source LoRaWAN® Network Server needs to set up a configuration that can use Semtech BasicStation.
137 137  
115 +**Below list the support products and Requirements:**
138 138  
139 -(% style="color:blue" %)**Below list the support products and Requirements:**
140 -
141 141  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]]
142 142  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/]]
143 143  
144 -(% style="color:blue" %)**How to set up chirpStack Basic Station**
120 +**How to set up chirpStack Basic Station**
145 145  
146 146  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]]
147 147  
124 +**What do you need to prepare**
148 148  
149 -(% style="color:blue" %)**What do you need to prepare**
150 -
151 151  A gateway that can access the internet normally
152 152  
153 153  
129 +== 3.1 Add Gateway ==
154 154  
155 -== 3.2  Add Gateway ==
156 -
157 -
158 158  [[image:image-20220524164205-10.png]]
159 159  
160 160  
161 -== 3.3  Access the gateway GUI ==
134 +== 3.2 Access the gateway GUI ==
162 162  
163 -
164 164  Access the gateway GUI interface of LoRaWAN~-~->LoRaWAN ~-~- Basic Station
165 165  
166 166  [[image:image-20220524164319-11.png]]
167 167  
168 -
169 169  User need to Choose the ChirpStack/Senet ~-~- Basic Station , input Server URI and Upload the TLS Certificate
170 170  
171 171  (% class="box" %)
... ... @@ -181,62 +181,40 @@
181 181  [[image:image-20220524164341-12.png]]
182 182  
183 183  
184 -== 3.4  Start Station ==
155 +== 3.3 Start Station ==
185 185  
157 +When the user has finished the configuration, Please click Sace&Apply to start station to connect ChirpStack
186 186  
187 -When the user has finished the configuration, Please click **Sace&Apply** to start station to connect ChirpStack.
188 188  
160 +== 3.4 Successful Connection ==
189 189  
190 -== 3.5  Successful Connection ==
191 -
192 -
193 193  If user completes the above steps, which will see live date in the ChirpStack.
194 194  
195 195  [[image:image-20220524164448-13.png]]
196 196  
197 197  
167 +== 3.5 Trouble Shooting ==
198 198  
199 -== 3.6  Trouble Shooting ==
200 -
201 -
202 202  User can check the station log in the logread/system log page.
203 203  
204 -[[image:image-20220531172837-8.png]]
171 +[[image:image-20220524164514-14.png]]
205 205  
206 206  
207 207  and recode the station log in the system/Recode log page.
208 208  
209 -[[image:image-20220531172857-9.png]]
176 +[[image:image-20220524164541-15.png]]
210 210  
211 211  
179 += 4. Downlink =
212 212  
213 -= 4.  Downlink =
181 +== 4.1 Chirpstack Downlink Note ==
214 214  
215 -(% class="wikigeneratedid" %)
216 -== 4.1 Convert HEX to Base64 ==
183 +[[image:image-20220525101223-9.png]]
217 217  
218 -(% 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.**
219 -
220 -[[Online HEX to Base64 Converter>>https://base64.guru/converter/encode/hex]]:
221 -
222 -[[image:image-20221010193350-1.png]]
223 -
224 -
225 -[[Online Base64 to Hex converter>>https://base64.guru/converter/decode/hex]]
226 -
227 -[[image:image-20221010193621-2.png]]
228 -
229 -
230 -
231 -== 4.2  Chirpstack Downlink Note ==
232 -
233 -
234 -[[image:image-20220601102543-2.png]]
235 -
236 236  Convert the data to Base64
237 237  
238 238  
239 -[[image:image-20220531173236-10.png]]
188 +[[image:image-20220526090748-4.png]]
240 240  
241 241  Check ChripStack downlink DataRate
242 242  
... ... @@ -246,14 +246,12 @@
246 246  Make sure the RX2DR is the same in the end node
247 247  
248 248  
198 +== 4.2 Loraserver Downlink Note ==
249 249  
250 -== 4.3  Loraserver Downlink Note ==
251 -
252 -
253 253  User can use MQTT to send downlink payload to ChirpStack to perform downstream to LoRaWAN End
254 254  
255 255  (((
256 -**Below is examples:**
203 +Below is examples:
257 257  )))
258 258  
259 259  (% class="box" %)
... ... @@ -264,17 +264,16 @@
264 264  User name: User name Password: password
265 265  )))
266 266  
267 -[[image:image-20220531173419-11.png]]
214 +[[image:image-20220525101401-12.png]]
268 268  
269 269  (((
270 270  MQTT Connect to ChirpStack
271 271  
272 -
273 273  
274 274  )))
275 275  
276 276  (((
277 -**After connect**
223 +After connect
278 278  )))
279 279  
280 280  (% class="box" %)
... ... @@ -292,16 +292,24 @@
292 292  Payload: {"confirmed":true,"fPort":2,"data":"AwEB"}
293 293  )))
294 294  
295 -[[image:image-20220531173519-12.png]]
241 +[[image:image-20220525101436-13.png]]
296 296  
297 297  MQTT Connect to ChirpStack
298 298  
299 299  
300 -If we want to send downstream hex 030101 to end node, the BASE64 payload is AwEB
246 +(((
247 +(% 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/]]
248 +)))
301 301  
302 -[[image:image-20220531173658-14.png]]
250 +[[image:image-20220525101505-14.png]]
303 303  
252 +Choose to Use Hex for Encode
304 304  
254 +
255 +If we want send downstream hex 030101 to end node, the BASE64 payload is AwEB
256 +
257 +[[image:image-20220525104025-15.png]]
258 +
305 305  (((
306 306  Downlink payload encode javescript code: 可以在网站上运行以下Javsscript代码：
307 307  )))
... ... @@ -364,27 +364,22 @@
364 364  )))
365 365  
366 366  
321 +== 4.3 Add the decode function in Chirpstack for the payload ==
367 367  
368 -== 4.3  Add the decode function in Chirpstack for the payload ==
369 -
370 -
371 371  User enters the payload code according to the steps.
372 372  
373 -[[image:image-20220531173754-15.png]]
325 +[[image:image-20220525104051-16.png]]
374 374  
327 +[[image:image-20220525104155-17.png]]
375 375  
376 -[[image:image-20220531173856-16.png]]
377 377  
330 +[[image:image-20220526091602-5.png]]
378 378  
379 -[[image:image-20220531174120-20.png]]
332 +[[image:image-20220526091801-6.png]]
380 380  
381 -[[image:image-20220531174046-19.png]]
382 382  
335 += 5. Multiply Uplink in ChirpStack =
383 383  
384 -
385 -= 5.  Multiply Uplink in ChirpStack =
386 -
387 -
388 388  (((
389 389  nbtrans field is the value to determine the re-transmission time for unconfirmed uplink data.
390 390  )))
... ... @@ -391,17 +391,12 @@
391 391  
392 392  (((
393 393  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]]
394 -
395 -
396 396  )))
397 397  
398 398  [[image:image-20220526091912-7.png]]
399 399  
400 -
401 401  (((
402 402  nbtrans is a field of ADR message, in unconfirm mode, it tells end node how many time it needs to transmit for every frame.
403 -
404 -
405 405  )))
406 406  
407 407  [[image:image-20220525104359-21.png]]
... ... @@ -408,8 +408,6 @@
408 408  
409 409  (((
410 410  Above behaviour will cause the platform shows below two cases of error:
411 -
412 -
413 413  )))
414 414  
415 415  (((
... ... @@ -418,37 +418,26 @@
418 418  
419 419  [[image:image-20220525104437-22.png]]
420 420  
421 -
422 -
423 423  Duplicate transmission in short time
424 424  
425 -[[image:image-20220601102430-1.png]]
365 +[[image:image-20220525104502-23.png]]
426 426  
367 +== 5.1 Solution ==
427 427  
428 -
429 -== 5.1  Solution ==
430 -
431 -
432 432  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]]
433 433  
434 -
435 435  (((
436 -(% 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.**
437 -
438 -
372 +~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.
439 439  )))
440 440  
441 441  [[image:image-20220525104532-24.png]]
442 442  
377 +installation path:
443 443  
444 -**installation path:**
445 -
446 446  [[image:image-20220525104554-25.png]]
447 447  
448 -
449 -
450 450  (((
451 -(% style="color:blue" %)**2.  Environment variable settings:**
382 +2. Environment variable settings:.
452 452  )))
453 453  
454 454  (((
... ... @@ -456,25 +456,21 @@
456 456  )))
457 457  
458 458  (((
459 -2) Set the variable name GOROOT and the variable value C:\Go\ (installation directory)
390 +2)Set the variable name GOROOT and the variable value C:\Go\ (installation directory)
460 460  )))
461 461  
462 462  [[image:image-20220524165433-33.png]]
463 463  
395 +3)Modify the system variable Path and add C:\Go\bin\:
464 464  
465 -3) Modify the system variable Path and add C:\Go\bin\:
466 -
467 467  [[image:image-20220524165452-34.png]]
468 468  
469 -
470 470  User variable setting file generation directory: D:\go:
471 471  
472 472  [[image:image-20220524165517-35.png]]
473 473  
403 +3. Modify the ADR configuration file according to your own needs, adr.setting.go is an example of the ADR configuration file.
474 474  
475 -
476 -(% 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.**
477 -
478 478  The name of the plugin: Example ADR plugin:
479 479  
480 480  [[image:image-20220524165540-36.png]]
... ... @@ -483,10 +483,8 @@
483 483  
484 484  [[image:image-20220524165557-37.png]]
485 485  
413 +4. Compile the ADR configuration file and generate the exe file.
486 486  
487 -
488 -(% style="color:blue" %)**4.  Compile the ADR configuration file and generate the exe file.**
489 -
490 490  1) Create a folder named adr-setting
491 491  
492 492  2) Open the adr-setting folder
... ... @@ -509,10 +509,8 @@
509 509  
510 510  [[image:image-20220524165623-38.png]]
511 511  
437 +5. Add the plugin and run the plugin.
512 512  
513 -
514 -(% style="color:blue" %)**5.  Add the plugin and run the plugin.**
515 -
516 516  (((
517 517  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:
518 518  )))
... ... @@ -547,13 +547,10 @@
547 547  
548 548  Finish.
549 549  
473 += 6. Trouble Shooting =
550 550  
475 +== 6.1 MIC Mismatch or MIC Failed ==
551 551  
552 -= 6.  Trouble Shooting =
553 -
554 -== 6.1  MIC Mismatch or MIC Failed ==
555 -
556 -
557 557  (((
558 558  When the device is registered or the device is working normally, the problem of MIC mismatch and MIC failed occurs.
559 559  )))
image-20220531171609-1.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -79.4 KB
Content
image-20220531171651-2.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -86.3 KB
Content
image-20220531171809-3.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -126.4 KB
Content
image-20220531171923-4.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -113.1 KB
Content
image-20220531172031-5.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -62.4 KB
Content
image-20220531172158-6.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -108.7 KB
Content
image-20220531172304-7.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -162.5 KB
Content
image-20220531172837-8.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -67.9 KB
Content
image-20220531172857-9.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -36.6 KB
Content
image-20220531173236-10.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -160.2 KB
Content
image-20220531173419-11.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -104.3 KB
Content
image-20220531173519-12.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -63.9 KB
Content
image-20220531173601-13.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -67.6 KB
Content
image-20220531173658-14.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -59.3 KB
Content
image-20220531173754-15.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -41.7 KB
Content
image-20220531173856-16.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -46.7 KB
Content
image-20220531173939-17.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -41.4 KB
Content
image-20220531174015-18.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -27.4 KB
Content
image-20220531174046-19.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -27.2 KB
Content
image-20220531174120-20.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -41.4 KB
Content
image-20220601102430-1.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -139.4 KB
Content
image-20220601102543-2.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -51.5 KB
Content
image-20221010193350-1.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Edwin
Size
... ... @@ -1,1 +1,0 @@
1 -42.7 KB
Content
image-20221010193621-2.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Edwin
Size
... ... @@ -1,1 +1,0 @@
1 -34.2 KB
Content

Applications

Navigation

Copyright ©2010-2022 Dragino Technology Co., LTD. All rights reserved
Dragino Wiki v2.0