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