Wiki source code of HP0D

Version 65.2 by Edwin Chen on 2022/05/07 10:23
Show last authors
1
2
3 (% style="text-align:center" %)
4 [[image:1651802206983-860.png||height="645" width="602"]]
5
6
7 (((
8 **HP0D Full Hotspot for Helium User Manual**
9 )))
10
11
12
13
14
15 {{toc/}}
16
17
18 ==== 1. Introduction ====
19
20 ===== 1.1 What is HP0D =====
21
22 (((
23 (((
24 (((
25 The HP0D is an outdoor LoRaWAN Gateway. It lets you bridge LoRa wireless network to an IP network via WiFi,
26 )))
27 )))
28
29 (((
30 (((
31 Ethernet, optional 3G or 4G. The LoRa wireless allows users to send  data and reach extremely long ranges
32 )))
33 )))
34
35 (((
36 (((
37 at low data rates.
38 )))
39 )))
40 )))
41
42 (((
43 (((
44 (((
45
46 )))
47 )))
48 )))
49
50 (((
51 (((
52 (((
53 HP0D has passed Helium Full Hotspot Approval. It supports the **miner feature from Helium** and has a built-in
54 )))
55 )))
56
57 (((
58 (((
59 ATECC608 encryption chip. It can be used as a Helium Full Hotspot  for the project. It also supports Semtech
60 )))
61 )))
62
63 (((
64 (((
65 packet forwarder and LoRaWAN Station connection, it is fully compatible with LoRaWAN protocol.
66 )))
67 )))
68
69 (((
70 (((
71 HP0D supports two LoRaWAN servers  at the same time, **users can use HP0D for helium mining**
72 )))
73 )))
74 )))
75
76 (((
77 (((
78 (((
79 **~ and connects max 2 x LoRaWAN servers at the same time**.
80 )))
81 )))
82 )))
83
84 (((
85 (((
86 (((
87
88 )))
89 )))
90 )))
91
92 (((
93 (((
94 (((
95 **~ Dragino already paid HP0D $40 onboarding cost and $10 location cost for each HP0D**. It is ready to use
96 )))
97 )))
98
99 (((
100 (((
101 for Helium, user only needs to input HNT wallet address and use QR Code to onboarding HP0D when it arrives.
102 )))
103 )))
104 )))
105
106 (((
107 (((
108 (((
109
110 )))
111 )))
112 )))
113
114 (((
115 (((
116 (((
117 HP0D has pre-configured standard LoRaWAN frequency bands to use for different countries. Users can also
118 )))
119 )))
120
121 (((
122 (((
123 customize the frequency bands to use in their own LoRaWAN network.
124 )))
125 )))
126 )))
127
128
129 ===== 1.2 Specifications =====
130
131 (((
132 (((
133 **~ Hardware System:**
134 )))
135 )))
136
137 (((
138 (((
139 Linux Part:
140 )))
141 )))
142
143 * (((
144 (((
145 Raspberry Pi 4
146 )))
147 )))
148
149 (((
150 (((
151 **~ Interface:**
152 )))
153 )))
154
155 * (((
156 (((
157 10M/100M RJ45 Ports x 1
158 )))
159 )))
160 * (((
161 (((
162 LoRaWAN Wireless
163 )))
164 )))
165 * (((
166 (((
167 Power Input: 12V 2A, DC
168 )))
169 )))
170
171 (((
172 (((
173 **~ Operating Condition:**
174 )))
175 )))
176
177 * (((
178 (((
179 Work Temperature: -20 ~~ 65°C
180 )))
181 )))
182 * (((
183 (((
184 Storage Temperature: -20 ~~ 65°C
185 )))
186 )))
187 * (((
188 (((
189 Power Input: 12V 2A, DC
190 )))
191 )))
192
193 ===== 1.3 Features =====
194
195 * Open-Source Linux system
196 * RPi4 with 2G /4G or 8G RAM
197 * Managed by Web GUI, SSH via Internet
198 * Support Semtech UDP packet forwarder
199 * Support LoRaWAN Station Connection
200 * Support Helium Miner
201 * External fiberglass antenna
202 * Firmware OTA
203 * 802.3af PoE
204 * Lighting Protection
205 * Remote Monitoring
206 * Support Helium LoRaWAN server and secondary LoRaWAN server
207 * Include prepaid $40 onboarding cost and $10 location cost.
208 * [[Remote.it remote management>>url:https://wiki.dragino.com/index.php?title=Reverse_SSH_Access#Use_Remote.it_service]].
209
210 ===== 1.4 Label info and login name =====
211
212
213 [[image:1651803959860-394.png||height="500" width="375"]]
214
215
216
217 (((
218 (((
219 **~ Label information:**
220 )))
221 )))
222
223 (((
224 (((
225
226 )))
227 )))
228
229 (((
230 (((
231 **~ Device host name:**      (% class="mark" %)dragino-xxxxxx
232 )))
233 )))
234
235 (((
236 (((
237 **~ Band**:  US915/AU915/AS923_1-AS923_4/KR920/EU868/IN865/RU864
238 )))
239 )))
240
241 (((
242 (((
243 **~ Miner animal name**: xxx-xxx-xxx
244 )))
245 )))
246
247 (((
248 (((
249 **~ Miner address**:          112xxxxxx
250 )))
251 )))
252
253 (((
254 (((
255 **~ Eth MAC address**: A8: 40: 41: EF: FE: CD
256 )))
257 )))
258
259 (((
260 (((
261 **~ Login**:  root/d59f2d5b ((% class="mark" %)the root is the Login account for the Web-UI and SSH.(%%))
262 )))
263 )))
264
265 (((
266 (((
267 **~ SN**:  device serial number.
268 )))
269 )))
270
271
272 ==== 2. Quick Start & Onboarding ====
273
274 (((
275 (((
276 The HP0D is configured as a Wi-Fi Access Point by factory default. You can access and configure the HPD after
277 )))
278
279 (((
280 connecting to its Wi-Fi network, or via its WAN Ethernet port.
281 )))
282 )))
283
284 (% class="wikigeneratedid" id="H-2" %)
285 (((
286
287 )))
288
289 ===== 2.1  Connect HP0D Web UI =====
290
291 ====== 2.1.1 via HP0D’s Access Point. ======
292
293 (((
294 (((
295 At the first boot of HP0D, it will auto generate a Wi-Fi network
296
297 [[image:1651804327535-321.png||height="325" width="199"]]
298 )))
299 )))
300
301 (((
302 (((
303
304 )))
305 )))
306
307 (((
308 (((
309 (% class="box infomessage" %)
310 (((
311 called           : **//HPD-dragino-xxxxxx//**
312 )))
313 )))
314 )))
315
316 (((
317 (((
318 (% class="box infomessage" %)
319 (((
320 with password:  **//dragino+dragino//**
321 )))
322 )))
323 )))
324
325 (((
326 (((
327
328 )))
329 )))
330
331 (((
332 (((
333
334 )))
335 )))
336
337 (((
338 (((
339 You can use a PC to connect to this Wi-Fi network. The PC will
340 )))
341 )))
342
343 (((
344 (((
345 get an IP address 10.130.1.xxx and the HP0D has the default
346 )))
347 )))
348
349 (((
350 (((
351 IP 10.130.1.1
352 )))
353 )))
354
355
356
357 (% style="text-align:center" %)
358 [[image:1651804397792-591.png||height="402" width="763"]]
359
360
361
362 ====== 2.1.2 Connect via HP0D hostname ======
363
364 (((
365 Connect the HP0D Ethernet port to your router and HP0D will obtain an IP address. If your
366 )))
367
368 (((
369 PC(Windows/Mac/Ubuntu) connect the same network with the HP0D, you can access the HP0D
370 )))
371
372 (((
373 Web-UI via HP0D’s hostname.
374 )))
375
376
377 Like: __**//http:~/~/dragino-4ba54a//**__
378
379
380 (% style="text-align:center" %)
381 [[image:1651804629009-699.png]]
382
383
384 ====== 2.1.3 Connect via Ethernet Port ======
385
386 (((
387 (((
388 Connect the HP0D Ethernet port to your router and HP0D will obtain an IP address from your router. In the
389 )))
390 )))
391
392 (((
393 (((
394 router’s management portal, you should be able to find what IP address the router has assigned to the HP0D.
395 )))
396 )))
397
398 (((
399
400 )))
401
402 If you get the IP address form route, like~:// (% class="mark" %)**10.130.2.42**(%%),// you can use this IP address to connect the WEB UI
403
404 or SSH access of HP0D.
405
406 (% style="text-align:center" %)
407 [[image:1651804782523-623.png]]
408
409
410
411 ===== 2.2 Generate QR Code =====
412
413 (((
414 Go to **Miner** ~-~-> **QR Generate**, input your Helium Wallet Address, and click Generate.
415 )))
416
417 (((
418 Note: After onboarding, this wallet will become owner of this hotspot.
419 )))
420
421 (% style="text-align:center" %)
422 [[image:image-20220506140312-1.png||height="435" width="438"]]
423
424
425 ===== 2.3 Onboarding Hotspot =====
426
427 (((
428 ~1. Download the Helium Hotspot APP from the Apple or Google Play store.
429 )))
430
431 (((
432 Note: the APP version need to be greater than 3.11.
433 )))
434
435 (((
436
437 )))
438
439 (((
440 2. To add a hotspot, select “Hotspot”. On this tab, click the ‘+ Add Hotspot’ in the mid where choose
441 )))
442
443 (((
444 the ‘DRAGINO Miner HP0D’
445 )))
446
447 [[image:1651817186037-899.png||height="429" width="206"]] [[image:1651817194458-938.png||height="434" width="203"]]
448
449 3. Scan the QR Code you generated in the previous step.
450
451 (% style="text-align:center" %)
452 [[image:1651828211026-220.png||height="405" width="191"]]
453
454 4. Onboarding your device
455
456 Mobile APP will get info from onboarding server. If MAC address doesn’t appear, it means the network connection of
457
458 mobile to onboarding server might have issue.
459
460 [[image:image-20220506141159-2.png||height="426" width="204"]] [[image:1651817529289-461.png||height="423" width="199"]]
461
462 [[image:1651828250802-391.png||height="437" width="205"]] [[image:1651828262668-768.png||height="433" width="204"]]
463
464
465 5. Check onboarding status
466
467 You can check from mobile:
468
469 [[image:1651828391664-884.png||height="413" width="197"]] [[image:1651828401011-970.png||height="412" width="193"]]
470
471 You can also see the hotspot status in below link:
472
473 https:~/~/explorer.helium.com/hotspots/**//<(% class="mark" %)YOUR_HOTSPORT_KEY(%%)>//**
474
475 Example:
476
477 Green Synced means hotspot works normal.
478
479 (% style="text-align:center" %)
480 [[image:1651828427715-679.png||height="374" width="635"]]
481
482
483 ===== 2.4 Set the Port Forwarding =====
484
485 (((
486 Helium Hotspots may not work if the Hotspot is behind a firewall or uses an incompatible NAT type. Other times
487 )))
488
489 (((
490 it may be because of a router configuration or the internet is offline. This article aims to help resolve any issues
491 )))
492
493 (((
494 you may have.
495 )))
496
497 (% style="text-align:center" %)
498 [[image:1651828514449-658.png]]
499
500 (((
501
502 )))
503
504 (((
505 Note: Please refer to more detailed Settings
506 )))
507
508 (((
509 [[https:~~/~~/docs.helium.com/troubleshooting/network-troubleshooting/>>url:https://docs.helium.com/troubleshooting/network-troubleshooting/]]
510 )))
511
512 (((
513 [[https:~~/~~/www.youtube.com/watch?v=GKusVC7ovrE>>url:https://www.youtube.com/watch?v=GKusVC7ovrE]]
514 )))
515
516
517 ==== 3. Check the configuration of HP0D ====
518
519 ===== 3.1 LoRa frequency configuration =====
520
521 (% style="text-align:center" %)
522 [[image:1651828687205-178.png||height="323" width="657"]]
523
524
525
526 ===== 3.2 Check the LoRaWAN serveraddress =====
527
528
529 (% style="text-align:center" %)
530 [[image:1651828703680-156.png||height="349" width="672"]]
531
532
533 ===== 3.3 Check Miner configuration =====
534
535 (% style="text-align:center" %)
536 [[image:image-20220506181408-1.png||height="451" width="513"]]
537
538 **~ Note: Check the Region and Height, the default height is greater than 1, if it is 1 please Click the mid**
539
540 **~ button of Update, and then wait 10mins to check here,**
541
542
543 ==== 4. Installation of Antenna ====
544
545 (((
546 HP0D use Fiber Glass Antenna.
547 )))
548
549 (% style="text-align:center" %)
550 [[image:1651832158606-882.png]]
551
552 (((
553
554 )))
555
556 (((
557
558 )))
559
560 (((
561 User need to connect antenna cable’s SMA connector to the HP03 and connect N-Type connector
562 )))
563
564 (((
565 to antenna and install as below:
566 )))
567
568 (((
569 (% style="text-align:center" %)
570 [[image:1651832205608-998.png||height="349" width="198"]]
571 )))
572
573 ==== 5. SSH Access for Linux console ====
574
575 (((
576 IP address:  IP address of HP0D or hostname of HP0D (Such as dragino-63920a)
577 )))
578
579 (((
580 Port:         22
581 )))
582
583 (((
584 User Name:      **root**
585 )))
586
587 (((
588 Password:         **Randomly generated （(% class="mark" %)found on device’s label(%%) ）**
589 )))
590
591 (((
592
593 )))
594
595 (((
596 After logging in, you will be in the Linux console and can enter commands as shown below.
597 )))
598
599 (% style="text-align:center" %)
600 [[image:1651832284160-991.png]]
601
602
603
604
605 ==== 6. Trouble Shootings ====
606
607 ===== 6.1 How to get a wallet address? =====
608
609 // // Download the helium Hotspots APP on the Apple or Google Play store to generate own wallet.
610
611
612 ===== 6.2 Onboarding ~-~- Unable to access Web-UI ~-~-> Miner =====
613
614 (((
615 User can login the HP0D, able to access other Web Pages except miner page
616 )))
617
618 (((
619 If you first boot the device where you need to wait for 10 mins for initialization connection to Helium server.
620 )))
621
622
623 ===== 6.3 Onboarding ~-~- Some parameters in miner page show timeout =====
624
625 (% style="text-align:center" %)
626 [[image:image-20220506182042-2.png||height="250" width="516"]]
627
628 (% style="text-align:center" %)
629 [[image:1651832455372-647.png||height="224" width="520"]]
630
631
632 HP0D is establish connection to Helium server and not finished. And you might see above.
633
634 It might relate to the network where might up to 10mins
635
636
637 ===== 6.4 Onboarding – Bad Gaterway =====
638
639 (% style="text-align:center" %)
640 [[image:1651832583790-633.png]]
641
642 This is caused by the process leads too long which just need to refresh the page.
643
644
645 6.5 Onboarding ~-~- Why did QR Code generate is aways fail?
646
647 (% style="text-align:center" %)
648 [[image:image-20220506182424-3.png]]
649
650 This may be related to the current block height, if the device is synchronizing to the latest height or if the
651
652 device block height is much lower than the current height as the above picture like '1 1', the QR code
653
654 generation may fail.
655
656
657 ===== 6.6 Onboarding ~-~- Why is the QR Code not quite the same as the manual? =====
658
659 (% style="text-align:center" %)
660 [[image:1651832742262-209.png||height="297" width="365"]]
661
662 Please ensure that you enter the correct wallet address and that your network is up and running, the user can
663
664 click the button of ‘Clean’ to re-generate the QR Code.
665
666
667 ===== 6.7 Onboarding – MAC address is ‘Unknown’ after scan QR Code =====
668
669 (% style="text-align:center" %)
670 [[image:1651832811038-780.png||height="462" width="216"]]
671
672 If you see the MAC Address shows the ‘Unknown’ where is due to the provision error,
673
674 please contact us to help you solve.
675
676
677 ===== 6.8 Onboarding – MAC address is being refreshed after scan QR Code =====
678
679 // // After scan QR Code, Mobile APP will connect Helium onboarding server and provide the
680
681 public key/ wallet address to onboarding server. Server will return the match MAC address
682
683 for this hotspot.
684
685
686 If you don’t see MAC address, make sure your mobile has good internet connection.
687
688 (% style="text-align:center" %)
689 [[image:1651832880009-473.png]]
690
691
692 ===== 6.9 HP0D Web ~-~-> Miner ~-~-> Version shows ‘short’ =====
693
694 This is caused by the server connection delay, which does not affect the normal use.
695
696
697 (% style="text-align:center" %)
698 [[image:1651832959907-357.png]]
699
700 ===== 6.10 Mobile APP crash after scan the QR Code? =====
701
702 * Make sure you have input the correct Wallet address to generate QR Code.
703 * Make sure your mobile app uses the same wallet address as the one to generate QR Code.
704 * Make sure your mobile app’s relevant permission are enabled.
705 * Known: The Android 11 version may cause this kind of issue.
706
707 1.
708 11. Why the frequency/region is not the same what I purchased?
709
710 //Each HP0D is inspected and configured prior to shipping.//
711
712 //If your HP0D Web-UI – Miner region is not the same with the shell labels, please contact our support team that will solve this issue for you.//
713
714
715 1.
716 11. Can use the frequency to a region where is not support?
717
718 //Please make sure that the region supports this frequency, you can confirm the appropriate frequency through this link//
719
720 [[https:~~/~~/docs.helium.com/lorawan-on-helium/frequency-plans>>url:https://docs.helium.com/lorawan-on-helium/frequency-plans]]
721
722
723 1.
724 11. Can change the frequency of the HP0D Miner?
725
726 //We do not recommend doing this, it may damage your device//
727
728
729
730
731
732 1. Supports
733
734 //If you are experiencing issues and can’t solve, you can send mail to//
735
736 [[//support@dragino.com//>>mailto:support@dragino.com]]
737
738 //With your question as detail as possible. We will reply and help you in the shortest.//
739
740
741
742
743 1. Order Info
744
745 **HP0D-XXX**
746
747 **XXX**: Frequency Band
748
749 * 868: For Bands: EU868,IN865
750 * 915: For Bands: US915,AU915,AS923,KR920
751
752 1. Manufacturer Info
753
754 **Shenzhen Dragino Technology Development co. LTD**
755
756 Room 202, Block B, BCT Incubation Bases (BaoChengTai),  No.8 CaiYunRoad
757
758 LongCheng Street, LongGang District ; Shenzhen 518116,China
759
760
761 1. FCC Warning
762
763 This equipment has been tested and found to comply with the limits for a Class B digital device, pursuant to Part 15 of the FCC Rules. These limits are designed to provide reasonable protection against harmful interference in a residential installation. This equipment generates uses and can radiate radio frequency energy and, if not installed and used in accordance with the instructions, may cause harmful interference to radio communications. However, there is no guarantee that interference will not occur in a particular installation. If this equipment does cause harmful interference to radio or television reception, which can be determined by turning the equipment off and on, the user is encouraged to try to correct the interference by one or more of the following measures:
764
765 ~-~- Reorient or relocate the receiving antenna.
766
767 ~-~- Increase the separation between the equipment and receiver.
768
769 ~-~- Connect the equipment into an outlet on a circuit different from that to which the receiver is connected.
770
771 ~-~- Consult the dealer or an experienced radio/TV technician for help.
772
773
774 Changes or modifications not expressly approved by the party responsible for compliance could void the user's authority to operate the equipment.
775
776
777 The antenna(s) used for this transmitter must be installed to provide a separation distance of at least 20 cm from all persons and must not be co-located or operating in conjunction with any other antenna or transmitter.

Applications

Navigation

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