<
From version < 94.1 >
edited by Edwin Chen
on 2022/09/05 20:07
To version < 88.4 >
edited by Xiaoling
on 2022/07/23 14:37
>
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
... ... @@ -23,13 +23,16 @@
23 23  [[LPS8>>url:https://www.dragino.com/products/lora-lorawan-gateway/item/148-lps8.html]], [[DLOS8>>url:https://www.dragino.com/products/lora-lorawan-gateway/item/160-dlos8.html]],
24 24  
25 25  [[LG308>>url:https://www.dragino.com/products/lora-lorawan-gateway/item/140-lg308.html]],[[LIG16>>url:https://www.dragino.com/products/lora-lorawan-gateway/item/171-lig16.html]]
26 -)))|(% style="color:#4f81bd; width:126px" %)**Data-Only Hotspot**|(% style="width:121px" %)[[Helium Link>>url:https://docs.helium.com/mine-hnt/data-only-hotspots]]|(% style="width:203px" %)[[Data-Only Hotspot Instruction>>||anchor="H2.A0ConnectData-OnlyHotspottoHelium"]]
26 +)))|(% style="color:#4f81bd; width:126px" %)**Data-Only Hotspot**|(% style="width:121px" %)[[Helium Link>>url:https://docs.helium.com/mine-hnt/data-only-hotspots]]|(% style="width:203px" %)[[Data-Only Hotspot Instruction>>||anchor="H2.ConnectData-OnlyHotspottoHelium"]]
27 27  |(% style="width:132px" %)[[HP0D>>url:https://www.dragino.com/products/lora-lorawan-gateway/item/195-hp0d.html]]|(% style="color:#4f81bd; width:126px" %)**Full Hotspo**t|(% style="width:121px" %)[[Helium Link>>url:https://docs.helium.com/mine-hnt/full-hotspots]]|(% style="color:green; width:203px" %)[[Full Hotspot Instuction-Not Finish>>doc:Main.User Manual for All Gateway models.HP0D.WebHome]]
28 28  
29 -(% style="color:blue" %)**Frequencies on the Helium Network**
30 30  
30 +**Frequencies on the Helium Network**
31 +
31 31  * //The frequencies currently available are CN470/EU868/US915/AU915//
32 32  
34 +
35 +
33 33  (% style="color:red" %)**Note: more information refer to this link [[Helium Frequency plan>>url:https://docs.helium.com/lorawan-on-helium/frequency-plans/]]**
34 34  
35 35  
... ... @@ -41,6 +41,9 @@
41 41  
42 42  * //Firmware Requirement: > [[lgw~~-~~-build-v5.4.1640315898>>url:https://www.dragino.com/downloads/index.php?dir=LoRa_Gateway/LPS8/Firmware/Release/]]//
43 43  
47 +
48 +
49 +
44 44  == **2.2  Step 1: Configure Frequency Band** ==
45 45  
46 46  
... ... @@ -70,7 +70,6 @@
70 70  [[image:image-20220615150717-3.png||height="605" width="1039"]]
71 71  
72 72  
73 -
74 74  == **2.4  Step 3: Install the Helium-gateway-rs** ==
75 75  
76 76  
... ... @@ -80,30 +80,25 @@
80 80  
81 81  Install the Helium gateway-rs
82 82  
83 -
84 84  (% style="color:red" %)**Note: User will see the echo characters of Helium gateway-rs have been installed successfully.**
85 85  
86 86  
91 +== **2.5 Step 4: Save&start the Helium Server** ==
87 87  
88 -== **2.5  Step 4: Save&start the Helium Server** ==
89 89  
90 -
91 91  //By default, Region is US915, After configuring the Configure Frequency Band, click Save&Apply on the Helium IoT screen to modify the Region.//
92 92  
93 -
94 94  [[image:image-20220615150903-5.png||height="592" width="1031"]]
95 95  
96 96  
99 +//Click **Save&Apply** and gateway will start to connect the Helium. The UI shows the connect status.//
97 97  
98 -//Click (% style="color:red" %)**Save&Apply**(%%) and gateway will start to connect the Helium. The UI shows the connect status.//
99 -
100 100  [[image:image-20220615151057-6.png||height="580" width="1026"]]
101 101  
102 102  
104 +== **2.6 Step 5: Check Gateway Connection before onboarding** ==
103 103  
104 -== **2.6  Step 5: Check Gateway Connection before onboarding** ==
105 105  
106 -
107 107  //A hotspot can transfer data to Helium after finishing step4. We can add a device to Helium and see if the device can join Helium. For example, we add an LGT92 sensor and see below info.//
108 108  
109 109  (((
... ... @@ -116,13 +116,10 @@
116 116  (% style="color:red" %)**Note: The hotspot is not valid for search in Helium Console before onboarding.**
117 117  
118 118  
119 +== 2.7 Step 6: Onboarding Data-Only Hotspot ==
119 119  
120 -== **2.7  Step 6: Onboarding Data-Only Hotspot** ==
121 -
122 -
123 123  (% style="color:red" %)**Note: Onboarding a Data-Only hotspot is necessary for downlink to work. otherwise, the downlink message for LoRa won't work .**
124 124  
125 -
126 126  //User can refer [[this link>>url:https://docs.helium.com/mine-hnt/data-only-hotspots]] for how to onboarding a data-only hotspot. After onboarding the data-only hotspot, user can see the hotspot on Helium Console.//
127 127  
128 128  //Below are the steps we do as per above link here.//
... ... @@ -129,7 +129,7 @@
129 129  
130 130  
131 131  (((
132 -(% style="color:blue" %)//**1. Set up Helium-Wallet in my computer. [[https:~~/~~/docs.helium.com/wallets/cli-wallet>>url:https://docs.helium.com/wallets/cli-wallet]]. and funds this wallet. From this step, we got the wallet info as below.**//
129 +//**1. Set up Helium-Wallet in my computer. [[https:~~/~~/docs.helium.com/wallets/cli-wallet>>url:https://docs.helium.com/wallets/cli-wallet]]. and funds this wallet. From this step, we got the wallet info as below.**//
133 133  )))
134 134  
135 135  (% class="box" %)
... ... @@ -156,15 +156,13 @@
156 156  +~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-+~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~--+
157 157  )))
158 158  
159 -
160 160  (((
161 161  (% style="color:red" %)**Note: The wallet Address is 13oLxfjxcYajvfkxxxxxxxxxxxxxxxxxxxxxfY3yp4cz8r1NNux. and have about 18 HNT balance.**
162 162  )))
163 163  
164 164  
165 -
166 166  (((
167 -(% style="color:blue" %)//**2. Get txn. In the data-only hotspot. run below command to add a hotspot, owner is the owner wallet of this hotspot, payer is the payer to pay transaction cost.**//
162 +//**2. Get txn. In the data-only hotspot. run below command to add a hotspot, owner is the owner wallet of this hotspot, payer is the payer to pay transaction cost.**//
168 168  )))
169 169  
170 170  (% class="box" %)
... ... @@ -197,15 +197,11 @@
197 197  
198 198  (((
199 199  //We got the txn info from this step.//
195 +\\//**3. Add Hotspot. In the computer with helium wallet. run below command, replace the txn with the txn you got in above step.**//
200 200  
201 201  
202 -
203 -(% style="color:blue" %)//**3. Add Hotspot. In the computer with helium wallet. run below command, replace the txn with the txn you got in above step.**//
204 -
205 -
206 206  (% style="color:red" %)**Note: below are two commands, the command without ~-~-commit is the preview mode.**
207 207  
208 -
209 209  //Check every detail in this mode and run the command with ~-~-commit to commit to the Helium Blockchain.//
210 210  )))
211 211  
... ... @@ -249,9 +249,7 @@
249 249  )))
250 250  
251 251  (((
252 -
253 -
254 -(% style="color:blue" %)//**4. Assert Location. In helium Wallet. run below command, note, the ~-~-gateway should input gateway address from step 2.**//
243 +//**4. Assert Location. In helium Wallet. run below command, note, the ~-~-gateway should input gateway address from step 2.**//
255 255  )))
256 256  
257 257  (% class="box" %)
... ... @@ -305,21 +305,19 @@
305 305  +~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-+~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-+
306 306  )))
307 307  
308 -
309 309  (((
310 -(% style="color:red" %)**Note: The add hotspot and assert location step might need some time to be effect.**
298 +**Note: The add hotspot and assert location step might need some time to be effect.**
311 311  )))
312 312  
313 313  (((
314 314  //After above steps finish, the mobile helium wallet should be able to show that this hotspot has been added to the helium blockchain.//
315 315  
316 -
317 317  
318 318  )))
319 319  
320 -== **2.8  Debug Connection** ==
307 +== **2.8 Debug Connection** ==
321 321  
322 -=== **2.8.1  Check pkt-fwd running Log** ===
309 +=== **2.8.1 Check pkt-fwd running Log** ===
323 323  
324 324  
325 325  //This command can check if the LoRa Radio part runs correctly and if the gateway receives LoRa packets from LoRaWAN sensors.//
... ... @@ -350,22 +350,20 @@
350 350  )))
351 351  
352 352  
340 +=== **2.8.2 Check gateway-rs Log** ===
353 353  
354 -=== **2.8.2  Check gateway-rs Log** ===
355 355  
356 -
357 357  //SSH to gateway and run **logread | grep helium_gateway** to check Gateway-rs running log.//
358 358  
359 359  [[image:image-20220531175809-7.png]]
360 360  
361 361  
362 -(% style="color:red" %)**Note**: **logread is dynamic and FIFO, so helium log might be overwritten by other processes info in system.**
348 +**Note**: logread is dynamic and FIFO, so helium log might be overwritten by other processes info in system.
363 363  
364 364  
351 +=== **2.8.3 View the public key address and animal name** ===
365 365  
366 -=== **2.8.3  View the public key address and animal name** ===
367 367  
368 -
369 369  (% class="box" %)
370 370  (((
371 371  (((
... ... @@ -387,10 +387,8 @@
387 387  Hostpot key and animal name
388 388  
389 389  
375 +=== **2.8.4 Backup/Restor gateway-rs key** ===
390 390  
391 -=== **2.8.4  Backup/Restor gateway-rs key** ===
392 -
393 -
394 394  (((
395 395  //For the date-only hotspots, the key is the only unique identifier, the users can backup the key by the button of Download. And once the uses upgrade the gateway or the gateway lose the key, the gateway-rs will generate a new key for which the data-only hotspot is the new unit. so if the user would restore to last time which can upload your backup key to the gateway by the button of upload.//
396 396  )))
... ... @@ -399,9 +399,9 @@
399 399  
400 400  
401 401  
402 -== **2.9  Forward the data to the other server** ==
385 +== **2.9 Forward the data to the other server** ==
403 403  
404 -=== **2.9.1  Introduction** ===
387 +=== **2.9.1 Introduction** ===
405 405  
406 406  
407 407  (((
... ... @@ -411,29 +411,26 @@
411 411  (((
412 412  //Users can back to the page of Semtech UDP to configure other server settings.//
413 413  
414 -
415 415  
416 416  )))
417 417  
418 -=== **2.9.2  Example** ===
400 +=== **2.9.2 Example** ===
419 419  
420 420  
421 421  //The following takes The Things Network as another LoRaWAN server as an example.//
422 422  
423 423  
406 +==== **2.9.2.1 Step 1: Back to Semtech UDP page** ====
424 424  
425 -==== (% style="color:blue" %)**Step 1: Back to Semtech UDP page**(%%) ====
426 426  
427 -
428 428  [[image:image-20220531180002-10.png]]
429 429  
430 430  Back to Semtech UDP page
431 431  
432 432  
414 +==== **2.9.2.2 Step 2: Configure the double server forwarding** ====
433 433  
434 -==== (% style="color:blue" %)**Step 2: Configure the double server forwarding**(%%) ====
435 435  
436 -
437 437  [[image:image-20220531180048-11.png]]
438 438  
439 439  
... ... @@ -440,20 +440,17 @@
440 440  //The user can configure the secondary server and then click the button of **Save&Apply**.//
441 441  
442 442  
423 +== **2.10 Connect Full Hotspot to Helium** ==
443 443  
444 -== **2.10  Connect Full Hotspot to Helium** ==
425 += **3. Use Dragino Sensors with Helium** =
445 445  
446 446  
428 +== **3.1 How to add up user's end-node with Helium console** ==
447 447  
448 -= **3.  Use Dragino Sensors with Helium** =
449 449  
431 +=== **3.1.1 Step 1: Login the Helium console** ===
450 450  
451 -== **3.1  How to add up user's end-node with Helium console** ==
452 452  
453 -
454 -=== **3.1.1  Step 1: Login the Helium console** ===
455 -
456 -
457 457  //User can Login the [[Helium Console>>url:https://staging-console.helium.wtf/]]//
458 458  
459 459  [[image:image-20220531180150-12.png]]
... ... @@ -461,10 +461,9 @@
461 461  login Helium console
462 462  
463 463  
441 +=== **3.1.2 Step 2: Add up your end-node's key** ===
464 464  
465 -=== **3.1.2  Step 2: Add up your end-node's key** ===
466 466  
467 -
468 468  //User add up end-node's key from console ~-~->dervice//
469 469  
470 470  [[image:image-20220531180224-13.png]]
... ... @@ -472,10 +472,9 @@
472 472  To add a device
473 473  
474 474  
451 +=== **3.1.3 Step 3:Activate the end-node** ===
475 475  
476 -=== **3.1.3  Step 3: Activate the end-node** ===
477 477  
478 -
479 479  (((
480 480  //Users can activate the end-node with OTAA in which the end-node will Join the network from the Helium server **Eventually you will see traffic**//
481 481  )))
... ... @@ -485,21 +485,19 @@
485 485  end-node traffic.
486 486  
487 487  
463 +== **3.2 How to use decoder** ==
488 488  
489 -== **3.2  How to use decoder** ==
465 +=== **3.2.1 Step 1:Users can create decoders on functions** ===
490 490  
491 -=== **3.2.1  Step 1: Users can create decoders on functions** ===
492 492  
493 -
494 494  [[image:image-20220531105325-3.png]]
495 495  
496 496  Decoder.
497 497  
498 498  
473 +=== **3.2.2 Step 2:Add a decoder in functions and apply it to the specified label** ===
499 499  
500 -=== **3.2.2  Step 2: Add a decoder in functions and apply it to the specified label** ===
501 501  
502 -
503 503  [[image:image-20220526095629-6.png]]
504 504  
505 505  
... ... @@ -508,22 +508,18 @@
508 508  
509 509  [[image:image-20220526100057-8.png||height="352" width="1133"]]
510 510  
484 +
511 511  **//Add decoder complete.//**
512 512  
487 +=== **3.2.3 Where is the decoder?** ===
513 513  
514 -
515 -=== **3.2.3  Where is the decoder?** ===
516 -
517 -
518 518  [[console-decoders/Dragino at master · helium/console-decoders · GitHub>>url:https://github.com/helium/console-decoders/tree/master/Dragino]]
519 519  
520 520  [[image:image-20220617140118-1.png||height="550" width="883"]]
521 521  
493 +== **3.3 How to send a downlink to end device from Helium** ==
522 522  
523 523  
524 -== **3.3  How to send a downlink to end device from Helium** ==
525 -
526 -
527 527  (((
528 528  //The Helium server needs to convert to Base64 format when sending the downlink command. Please refer to the following example~://
529 529  )))
... ... @@ -538,7 +538,7 @@
538 538  
539 539  (% class="box" %)
540 540  (((
541 -**01 00 00 3C ~-~-> AQAAPA==**
510 +01 00 00 3C ~-~-> AQAAPA==
542 542  )))
543 543  
544 544  [[image:image-20220524171341-21.png]]
... ... @@ -546,12 +546,11 @@
546 546  Downlink
547 547  
548 548  
518 +== **3.4 How to add integration to different IoT Servers** ==
549 549  
550 -== **3.4  How to add integration to different IoT Servers** ==
520 +=== **3.4.1 TagoIO** ===
551 551  
552 -=== **3.4.1  TagoIO** ===
553 553  
554 -
555 555  **//The steps to add integration are very simple. Please see the following process.//**
556 556  
557 557  
... ... @@ -592,10 +592,9 @@
592 592  TagoIO.
593 593  
594 594  
563 +=== **3.4.2 Cayenne** ===
595 595  
596 -=== **3.4.2  Cayenne** ===
597 597  
598 -
599 599  //The process of creating devices is similar to Tago.//
600 600  
601 601  [[image:image-20220526101616-18.png||height="456" width="1097"]]
... ... @@ -628,34 +628,11 @@
628 628  Cayenne.
629 629  
630 630  
598 +== **3.5 Trouble Shooting** ==
631 631  
632 -== **3.5  Trouble Shooting** ==
600 +=== **3.5.1 Trouble to Join Helium** ===
633 633  
634 634  
635 -=== **3.5.1 Data-Only Hotspot is not connecting to Helium console** ===
636 -
637 -
638 -//**The Data-only hotspot has finished the software installation and confirmation, But it is not connecting to Helium Console. The possibility is:**//
639 -
640 -
641 -1). The hotspot does not finish the onboarding to the helium blockchain.
642 -
643 - after the 23 version of the gateway-rs, Helium requests the user to onboarding the devices to the blockchain, otherwise, your devices can't connect to the helium console. ~-~--> Please refer to [[Step 2.7>>http://wiki.dragino.com/xwiki/bin/view/Main/Notes%20for%20Helium/#H2.7A0Step6:OnboardingData-OnlyHotspot]] to do it.
644 -
645 -
646 -=== **3.5.2 End Device can't join Helium via hotspot, stuck in cycle of Joining-Accept. ** ===
647 -
648 -
649 -Make sure your blockchain region is the same as your hotspot settings. For example, as below, the blockchain is CN region, and software is configure to EU. The hotspot is able to get the OTAA Join Request from End Device on EU region. but due to block chain is CN region, Server will send the Join -Accept in CN region, so end device can't get the OTAA Join Accept.
650 -
651 -
652 -For example, if you are in USA, you have to use the US915 frequency plan. More frequency plans details on the helium network: [[https:~~/~~/docs.helium.com/lorawan-on-helium/frequency-plans>>url:https://docs.helium.com/lorawan-on-helium/frequency-plans]]
653 -
654 -
655 -
656 -=== **3.5.3  Trouble to Join Helium** ===
657 -
658 -
659 659  (((
660 660  **//Assume the device is powered correctly. If you don't see data in Helium. The possibilities are~://**
661 661  
... ... @@ -676,7 +676,7 @@
676 676  
677 677  )))
678 678  
679 -=== **3.5. Packet Loss for AU915 / US915 Band** ===
623 +=== **3.5.2 Packet Loss for AU915 / US915 Band** ===
680 680  
681 681  
682 682  (((
... ... @@ -685,12 +685,10 @@
685 685  
686 686  (((
687 687  //The reason for this problem is that the node does not lock the channel after joining the network.//
688 -
689 -
690 690  )))
691 691  
692 692  (((
693 -(% style="color:red" %)**Solution:**
635 +**Solution:**
694 694  
695 695  
696 696  )))
... ... @@ -700,17 +700,15 @@
700 700  )))
701 701  
702 702  * (((
703 -(% style="color:blue" %)**//AT Command: AT+CHE//**
645 +//AT Command: AT+CHE//
704 704  )))
705 705  
706 706  * (((
707 -//**Example: ** (% style="color:#037691" %)**AT+CHE=2**(%%)  ~/~/set channel mode to 1//
649 +//Example:**AT+CHE=2** ~/~/set channel mode to 1//
708 708  )))
709 709  
710 710  * (((
711 -(% style="color:blue" %)**//Downlink Command: 0x24//**
712 -
713 -
653 +//Downlink Command: 0x24//
714 714  )))
715 715  
716 716  (((
... ... @@ -717,14 +717,14 @@
717 717  //Format: Command Code (0x24) followed by 1 bytes channel value.//
718 718  )))
719 719  
720 -
721 721  (((
722 722  //If the downlink payload=0x2402, it means set channel mode to use sub-band 2, while type code is 24.//
723 723  )))
724 724  
725 725  * (((
726 -//**Example 1**: Downlink Payload: (% style="color:#037691" %)**0x2402** (%%) ~/~/ set channel mode to 2//
665 +//Example 1: Downlink Payload: **0x2402** ~/~/ set channel mode to 2//
727 727  
667 +
728 728  
729 729  )))
730 730  
... ... @@ -734,12 +734,4 @@
734 734  
735 735  (((
736 736  //The latest firmware for end node will have this bug fixed.//
737 -
738 -
739 -=== **3.5.5  ADR doesn't work in EU868 band.** ===
740 -
741 -See possibility reason from this link: [[https:~~/~~/github.com/helium/router/issues/858 >>https://github.com/helium/router/issues/858]]
742 -
743 -
744 -
745 745  )))
Copyright ©2010-2024 Dragino Technology Co., LTD. All rights reserved
Dragino Wiki v2.0