Wiki source code of HP0D

Version 59.1 by Xiaoling on 2022/05/06 18: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 (% style="text-align:center" %)
214 [[image:1651803959860-394.png||height="500" width="375"]]
215
216
217
218 (((
219 (((
220 **~ Label information:**
221 )))
222 )))
223
224 (((
225 (((
226
227 )))
228 )))
229
230 (((
231 (((
232 **~ Device host name:**      (% class="mark" %)dragino-xxxxxx
233 )))
234 )))
235
236 (((
237 (((
238 **~ Band**:  US915/AU915/AS923_1-AS923_4/KR920/EU868/IN865/RU864
239 )))
240 )))
241
242 (((
243 (((
244 **~ Miner animal name**: xxx-xxx-xxx
245 )))
246 )))
247
248 (((
249 (((
250 **~ Miner address**:          112xxxxxx
251 )))
252 )))
253
254 (((
255 (((
256 **~ Eth MAC address**: A8: 40: 41: EF: FE: CD
257 )))
258 )))
259
260 (((
261 (((
262 **~ Login**:  root/d59f2d5b ((% class="mark" %)the root is the Login account for the Web-UI and SSH.(%%))
263 )))
264 )))
265
266 (((
267 (((
268 **~ SN**:  device serial number.
269 )))
270 )))
271
272
273 ==== 2. Quick Start & Onboarding ====
274
275 (((
276 (((
277 The HP0D is configured as a Wi-Fi Access Point by factory default. You can access and configure the HPD after
278 )))
279
280 (((
281 connecting to its Wi-Fi network, or via its WAN Ethernet port.
282 )))
283 )))
284
285 (% class="wikigeneratedid" id="H-2" %)
286 (((
287
288 )))
289
290 ===== 2.1  Connect HP0D Web UI =====
291
292 ====== 2.1.1 via HP0D’s Access Point. ======
293
294 (((
295 (((
296 At the first boot of HP0D, it will auto generate a Wi-Fi network[[image:1651804327535-321.png||height="325" style="float:right" width="199"]]
297 )))
298 )))
299
300 (((
301 (((
302
303 )))
304 )))
305
306 (((
307 (((
308 called           : **//HPD-dragino-xxxxxx//**
309 )))
310 )))
311
312 (((
313 (((
314 with password:  **//dragino+dragino//**
315 )))
316 )))
317
318 (((
319 (((
320
321 )))
322 )))
323
324 (((
325 (((
326
327 )))
328 )))
329
330 (((
331 (((
332 You can use a PC to connect to this Wi-Fi network. The PC will
333 )))
334 )))
335
336 (((
337 (((
338 get an IP address 10.130.1.xxx and the HP0D has the default
339 )))
340 )))
341
342 (((
343 (((
344 IP 10.130.1.1
345 )))
346 )))
347
348
349
350 (% style="text-align:center" %)
351 [[image:1651804397792-591.png||height="402" width="763"]]
352
353
354
355 ====== 2.1.2 Connect via HP0D hostname ======
356
357 (((
358 Connect the HP0D Ethernet port to your router and HP0D will obtain an IP address. If your
359 )))
360
361 (((
362 PC(Windows/Mac/Ubuntu) connect the same network with the HP0D, you can access the HP0D
363 )))
364
365 (((
366 Web-UI via HP0D’s hostname.
367 )))
368
369
370 Like: __**//http:~/~/dragino-4ba54a//**__
371
372
373 (% style="text-align:center" %)
374 [[image:1651804629009-699.png]]
375
376
377 ====== 2.1.3 Connect via Ethernet Port ======
378
379 (((
380 (((
381 Connect the HP0D Ethernet port to your router and HP0D will obtain an IP address from your router. In the
382 )))
383 )))
384
385 (((
386 (((
387 router’s management portal, you should be able to find what IP address the router has assigned to the HP0D.
388 )))
389 )))
390
391 (((
392
393 )))
394
395 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
396
397 or SSH access of HP0D.
398
399 (% style="text-align:center" %)
400 [[image:1651804782523-623.png]]
401
402
403
404 ===== 2.2 Generate QR Code =====
405
406 (((
407 Go to **Miner** ~-~-> **QR Generate**, input your Helium Wallet Address, and click Generate.
408 )))
409
410 (((
411 Note: After onboarding, this wallet will become owner of this hotspot.
412 )))
413
414 (% style="text-align:center" %)
415 [[image:image-20220506140312-1.png||height="435" width="438"]]
416
417
418 ===== 2.3 Onboarding Hotspot =====
419
420 (((
421 ~1. Download the Helium Hotspot APP from the Apple or Google Play store.
422 )))
423
424 (((
425 Note: the APP version need to be greater than 3.11.
426 )))
427
428 (((
429
430 )))
431
432 (((
433 2. To add a hotspot, select “Hotspot”. On this tab, click the ‘+ Add Hotspot’ in the mid where choose
434 )))
435
436 (((
437 the ‘DRAGINO Miner HP0D’
438 )))
439
440 [[image:1651817186037-899.png||height="429" width="206"]] [[image:1651817194458-938.png||height="434" width="203"]]
441
442 3. Scan the QR Code you generated in the previous step.
443
444 (% style="text-align:center" %)
445 [[image:1651828211026-220.png||height="405" width="191"]]
446
447 4. Onboarding your device
448
449 Mobile APP will get info from onboarding server. If MAC address doesn’t appear, it means the network connection of
450
451 mobile to onboarding server might have issue.
452
453 [[image:image-20220506141159-2.png||height="426" width="204"]] [[image:1651817529289-461.png||height="423" width="199"]]
454
455 [[image:1651828250802-391.png||height="437" width="205"]] [[image:1651828262668-768.png||height="433" width="204"]]
456
457
458 5. Check onboarding status
459
460 You can check from mobile:
461
462 [[image:1651828391664-884.png||height="413" width="197"]] [[image:1651828401011-970.png||height="412" width="193"]]
463
464 You can also see the hotspot status in below link:
465
466 https:~/~/explorer.helium.com/hotspots/**//<(% class="mark" %)YOUR_HOTSPORT_KEY(%%)>//**
467
468 Example:
469
470 Green Synced means hotspot works normal.
471
472 (% style="text-align:center" %)
473 [[image:1651828427715-679.png||height="374" width="635"]]
474
475
476 ===== 2.4 Set the Port Forwarding =====
477
478 (((
479 Helium Hotspots may not work if the Hotspot is behind a firewall or uses an incompatible NAT type. Other times
480 )))
481
482 (((
483 it may be because of a router configuration or the internet is offline. This article aims to help resolve any issues
484 )))
485
486 (((
487 you may have.
488 )))
489
490 (% style="text-align:center" %)
491 [[image:1651828514449-658.png]]
492
493 (((
494
495 )))
496
497 (((
498 Note: Please refer to more detailed Settings
499 )))
500
501 (((
502 [[https:~~/~~/docs.helium.com/troubleshooting/network-troubleshooting/>>url:https://docs.helium.com/troubleshooting/network-troubleshooting/]]
503 )))
504
505 (((
506 [[https:~~/~~/www.youtube.com/watch?v=GKusVC7ovrE>>url:https://www.youtube.com/watch?v=GKusVC7ovrE]]
507 )))
508
509
510 ==== 3. Check the configuration of HP0D ====
511
512 ===== 3.1 LoRa frequency configuration =====
513
514 (% style="text-align:center" %)
515 [[image:1651828687205-178.png||height="323" width="657"]]
516
517
518
519 ===== 3.2 Check the LoRaWAN serveraddress =====
520
521
522 (% style="text-align:center" %)
523 [[image:1651828703680-156.png||height="349" width="672"]]
524
525
526 ===== 3.3 Check Miner configuration =====
527
528 (% style="text-align:center" %)
529 [[image:image-20220506181408-1.png||height="451" width="513"]]
530
531 **~ Note: Check the Region and Height, the default height is greater than 1, if it is 1 please Click the mid**
532
533 **~ button of Update, and then wait 10mins to check here,**
534
535
536 ==== 4. Installation of Antenna ====
537
538 (((
539 HP0D use Fiber Glass Antenna.
540 )))
541
542 (% style="text-align:center" %)
543 [[image:1651832158606-882.png]]
544
545 (((
546
547 )))
548
549 (((
550
551 )))
552
553 (((
554 User need to connect antenna cable’s SMA connector to the HP03 and connect N-Type connector
555 )))
556
557 (((
558 to antenna and install as below:
559 )))
560
561 (((
562 (% style="text-align:center" %)
563 [[image:1651832205608-998.png||height="349" width="198"]]
564 )))
565
566 ==== 5. SSH Access for Linux console ====
567
568 (((
569 IP address:  IP address of HP0D or hostname of HP0D (Such as dragino-63920a)
570 )))
571
572 (((
573 Port:         22
574 )))
575
576 (((
577 User Name:      **root**
578 )))
579
580 (((
581 Password:         **Randomly generated （(% class="mark" %)found on device’s label(%%) ）**
582 )))
583
584 (((
585
586 )))
587
588 (((
589 After logging in, you will be in the Linux console and can enter commands as shown below.
590 )))
591
592 (% style="text-align:center" %)
593 [[image:1651832284160-991.png]]
594
595
596
597
598 ==== 6. Trouble Shootings ====
599
600 ===== 6.1 How to get a wallet address? =====
601
602 // // Download the helium Hotspots APP on the Apple or Google Play store to generate own wallet.
603
604
605 ===== 6.2 Onboarding ~-~- Unable to access Web-UI ~-~-> Miner =====
606
607 (((
608 User can login the HP0D, able to access other Web Pages except miner page
609 )))
610
611 (((
612 If you first boot the device where you need to wait for 10 mins for initialization connection to Helium server.
613 )))
614
615
616 ===== 6.3 Onboarding ~-~- Some parameters in miner page show timeout  =====
617
618 (% style="text-align:center" %)
619 [[image:image-20220506182042-2.png||height="250" width="516"]]
620
621 (% style="text-align:center" %)
622 [[image:1651832455372-647.png||height="224" width="520"]]
623
624
625 HP0D is establish connection to Helium server and not finished. And you might see above.
626
627 It might relate to the network where might up to 10mins
628
629
630 ===== 6.4 Onboarding – Bad Gaterway =====
631
632 (% style="text-align:center" %)
633 [[image:1651832583790-633.png]]
634
635 This is caused by the process leads too long which just need to refresh the page.
636
637
638 1.
639 11. Onboarding ~-~- Why did QR Code generate is aways fail?
640
641 [[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image028.png]]
642
643 This may be related to the current block height, if the device is synchronizing to the latest height or if the device block height is much lower than the current height as the above picture like '1 1', the QR code generation may fail
644
645
646 1.
647 11. Onboarding ~-~- Why is the QR Code not quite the same as the manual?
648
649 [[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image029.png]]
650
651 Please ensure that you enter the correct wallet address and that your network is up and running, the user can click the button of ‘Clean’ to re-generate the QR Code.
652
653
654 1.
655 11. Onboarding – MAC address is ‘Unknown’ after scan QR Code
656
657 [[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image030.png]]
658
659 If you see the MAC Address shows the ‘Unknown’ where is due to the provision error, please contact us to help you solve.
660
661
662 1.
663 11. Onboarding – MAC address is being refreshed after scan QR Code
664
665 //After scan QR Code, Mobile APP will connect Helium onboarding server and provide the public key/ wallet address to onboarding server. Server will return the match MAC address for this hotspot.//
666
667
668 //If you don’t see MAC address, make sure your mobile has good internet connection.//
669
670 [[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image031.png]]
671
672
673
674
675 1.
676 11. HP0D Web ~-~-> Miner ~-~-> Version shows ‘short’
677
678 //This is caused by the server connection delay, which does not affect the normal use.//
679
680 [[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image032.png]]
681
682
683 *
684 *1. Mobile APP crash after scan the QR Code?
685 * //Make sure you have input the correct Wallet address to generate QR Code.//
686 * //Make sure your mobile app uses the same wallet address as the one to generate QR Code.//
687 * //Make sure your mobile app’s relevant permission are enabled.//
688 * //Known: The Android 11 version may cause this kind of issue.//
689
690 1.
691 11. Why the frequency/region is not the same what I purchased?
692
693 //Each HP0D is inspected and configured prior to shipping.//
694
695 //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.//
696
697
698 1.
699 11. Can use the frequency to a region where is not support?
700
701 //Please make sure that the region supports this frequency, you can confirm the appropriate frequency through this link//
702
703 [[https:~~/~~/docs.helium.com/lorawan-on-helium/frequency-plans>>url:https://docs.helium.com/lorawan-on-helium/frequency-plans]]
704
705
706 1.
707 11. Can change the frequency of the HP0D Miner?
708
709 //We do not recommend doing this, it may damage your device//
710
711
712
713
714
715 1. Supports
716
717 //If you are experiencing issues and can’t solve, you can send mail to//
718
719 [[//support@dragino.com//>>mailto:support@dragino.com]]
720
721 //With your question as detail as possible. We will reply and help you in the shortest.//
722
723
724
725
726 1. Order Info
727
728 **HP0D-XXX**
729
730 **XXX**: Frequency Band
731
732 * 868: For Bands: EU868,IN865
733 * 915: For Bands: US915,AU915,AS923,KR920
734
735 1. Manufacturer Info
736
737 **Shenzhen Dragino Technology Development co. LTD**
738
739 Room 202, Block B, BCT Incubation Bases (BaoChengTai),  No.8 CaiYunRoad
740
741 LongCheng Street, LongGang District ; Shenzhen 518116,China
742
743
744 1. FCC Warning
745
746 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:
747
748 ~-~- Reorient or relocate the receiving antenna.
749
750 ~-~- Increase the separation between the equipment and receiver.
751
752 ~-~- Connect the equipment into an outlet on a circuit different from that to which the receiver is connected.
753
754 ~-~- Consult the dealer or an experienced radio/TV technician for help.
755
756
757 Changes or modifications not expressly approved by the party responsible for compliance could void the user's authority to operate the equipment.
758
759
760 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