Skip to Content

Wiki source code of HP0D

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