Wiki source code of HP0D Full Hotspot for Helium

Version 78.2 by Xiaoling on 2022/05/24 15:45

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
75 [[image:1651803959860-394.png||height="500" width="375"]]
76
77 ===
78 **1.4.1 Label information:** ===
79
80
81 **Device hostname:**  (% class="mark" %)dragino-xxxxxx(%%)
82 **Band**:  (% class="mark" %)US915/AU915/AS923_1-AS923_4/KR920/EU868/IN865/RU864(%%)
83 **Miner animal name**: (% class="mark" %)xxx-xxx-xxx(%%)
84 **Miner address**:  (% class="mark" %)12xxxxxx(%%)
85 **Eth MAC address**:  (% class="mark" %)A8: 40: 41: EF: FE: CD(%%)
86 **Login**:  (% class="mark" %)root/d59f2d5b (the root is the Login account for the Web-UI and SSH.)(%%)
87 **SN**:  (% class="mark" %)device serial number.
88
89
90 = **2. Quick Start & Onboarding** =
91
92 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.
93
94
95 == **2.1  Connect HP0D Web UI** ==
96
97 === **2.1.1 via HP0D’s Access Point** ===
98
99 At the first boot of HP0D, it will auto-generate a Wi-Fi network
100
101
102 [[image:1651804327535-321.png||height="325" width="199"]]
103
104
105 (% class="box infomessage" %)
106 (((
107 called  : **//HPD-dragino-xxxxxx//**
108 )))
109
110 (% class="box infomessage" %)
111 (((
112 with password:  **//dragino+dragino//**
113 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
114 )))
115
116
117 [[image:1651804397792-591.png||height="386" width="733"]]
118
119
120 === **2.1.2 Connect via HP0D hostname** ===
121
122 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.
123
124 Like: (% class="mark" %)__**//http:~/~/dragino-4ba54a//**__
125
126
127 [[image:1651804629009-699.png]]
128
129 === **2.1.3 Connect via Ethernet Port** ===
130
131 //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.//
132
133
134 //**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.**//
135
136
137 [[image:1651804782523-623.png]]
138
139
140 == **2.2 Generate QR Code** ==
141
142
143 (((
144 //Go to **Miner** ~-~-> **QR Generate**, input your Helium Wallet Address, and click Generate.//
145 )))
146
147 (((
148 //Note: After onboarding, this wallet will become the owner of this hotspot.//
149
150
151 )))
152
153 [[image:image-20220506140312-1.png||height="435" width="438"]]
154
155
156 == **2.3 Onboarding Hotspot** ==
157
158
159 (((
160 //**1.** Download the Helium Hotspot APP from the Apple or Google Play store.//
161 )))
162
163 (((
164 **//Note: the APP version needs to be greater than 3.11.//**
165
166
167 )))
168
169 (((
170 //**2. **To add a hotspot, select “Hotspot”. On this tab, click the ‘+ Add Hotspot’ in the mid where choose the ‘DRAGINO Miner HP0D’//
171
172
173 )))
174
175 [[image:1651817186037-899.png||height="429" width="206"]] [[image:1651817194458-938.png||height="434" width="203"]]
176
177
178 //**3. **Scan the QR Code you generated in the previous step.//
179
180 [[image:1651828211026-220.png||height="405" width="191"]]
181
182
183 (((
184 //**4. **Onboarding your device//
185 )))
186
187 (((
188 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.  
189
190
191 )))
192
193 [[image:image-20220506141159-2.png||height="422" width="202"]] [[image:1651817529289-461.png||height="423" width="199"]]
194
195 [[image:1651828250802-391.png||height="421" width="197"]] [[image:1651828262668-768.png||height="416" width="196"]](% style="display:none" %)
196
197
198 **5. **//Check onboarding status where you can check from mobile~://
199
200 [[image:1651828391664-884.png||height="413" width="197"]] [[image:1651828401011-970.png||height="412" width="193"]](% style="display:none" %)
201
202
203 //You can also see the hotspot status in the below link~://
204
205 //https:~/~/explorer.helium.com/hotspots/**<(% class="mark" %)YOUR_HOTSPORT_KEY(%%)>**//
206
207 //Example~://
208
209
210 **//Green Synced means hotspot works normally.//**
211
212 [[image:1651828427715-679.png||height="374" width="635"]]
213
214
215 == **2.4 Set the Port Forwarding** ==
216
217
218 (((
219 //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.//
220 )))
221
222 [[image:1651828514449-658.png]]
223
224 (((
225
226 )))
227
228 (((
229 Note: Please refer to more detailed Settings
230 )))
231
232 (((
233 [[https:~~/~~/docs.helium.com/troubleshooting/network-troubleshooting/>>url:https://docs.helium.com/troubleshooting/network-troubleshooting/]]
234 )))
235
236 (((
237 [[https:~~/~~/www.youtube.com/watch?v=GKusVC7ovrE>>url:https://www.youtube.com/watch?v=GKusVC7ovrE]]
238
239
240 )))
241
242 = **3. Check the configuration of HP0D** =
243
244 == **3.1 LoRa frequency configuration** ==
245
246
247 [[image:1651828687205-178.png||height="323" width="657"]]
248
249
250 == **3.2 Check the LoRaWAN Server Address** ==
251
252
253 [[image:1651828703680-156.png||height="349" width="672"]]
254
255
256 == **3.3 Check Miner configuration** ==
257
258
259 [[image:image-20220506181408-1.png||height="451" width="513"]]
260
261 (((
262 //**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.**//
263
264
265 )))
266
267 = **4. Installation of Antenna** =
268
269
270 (((
271 //HP0D uses Fiber Glass Antenna.//
272 )))
273
274 [[image:1651832158606-882.png]]
275
276 (((
277
278 )))
279
280 (((
281 //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~://
282 )))
283
284 (((
285 [[image:1651832205608-998.png||height="349" width="198"]]
286
287
288 )))
289
290 = **5. SSH Access for Linux console** =
291
292
293 (((
294 **//IP address:  IP address of HP0D or hostname of HP0D ((% class="mark" %)Such as dragino-63920a(%%))//**
295 )))
296
297 (((
298 //Port:  22//
299 )))
300
301 (((
302 //User Name:      (% style="color:green" %)**root**//
303 )))
304
305 (((
306 //Password:         (% style="color:green" %)**Randomly generated (found on device’s label)**//
307
308
309 )))
310
311 (((
312 //After logging in, you will be in the Linux console and can enter commands as shown below.//
313
314
315 )))
316
317 [[image:1651832284160-991.png||height="171" width="729"]]
318
319
320 = **6. How to change the Wireless function of HP0D** =
321
322 //The wireless function is configured as AP by default and the web page does not support configuration, if you want to configure it as client connection mode, you need to configure it manually in Linux CIL.//
323
324
325 == **6.1 Access the Linux console.** ==
326
327 //Follow the previous step of Step 5.//
328
329
330 == **6.2 Install the package of network-manager** ==
331
332
333 //Run commands~://
334
335 (% class="box infomessage" %)
336 (((
337 apt update
338 apt install network-manager
339 )))
340
341 [[image:image-20220507140730-1.png||height="402" width="728"]]
342
343
344 == **6.3 Reboot the device** ==
345
346
347 //Run command~://
348
349 (% class="box infomessage" %)
350 (((
351 reboot
352 )))
353
354 [[image:image-20220507140814-2.png]]
355
356
357 == **6.4 Check the wireless type** ==
358
359
360 //Run command~://
361
362 (% class="box infomessage" %)
363 (((
364 iw dev
365 )))
366
367 [[image:image-20220507140941-3.png]]
368
369
370 == **6.5 Connect the WiFi** ==
371
372
373 //Run command~://
374
375 (% class="box infomessage" %)
376 (((
377 nmtui
378 )))
379
380 [[image:image-20220507140953-4.png]]
381
382
383 = **7. Trouble Shootings** =
384
385 == **7.1 How to get a wallet address?** ==
386
387
388 **//Download the helium Hotspots APP on the Apple or Google Play store to generate your own wallet.//**
389
390
391 == **7.2 Onboarding ~-~- Unable to access Web-UI ~-~-> Miner** ==
392
393
394 (((
395 //Users can log in to the HP0D, able to access other Web Pages except for the miner page.//
396 )))
397
398 (((
399 //If you first boot the device where you need to wait for 10 mins for the initialization connection to the Helium server.//
400
401
402 )))
403
404 == **7.3 Onboarding ~-~- Some parameters on the miner page show timeout** ==
405
406
407 [[image:image-20220506182042-2.png||height="250" width="516"]]
408
409 [[image:1651832455372-647.png||height="224" width="520"]]
410
411
412 **//HP0D is establishing a connection to the Helium server and is not finished. And you might see above.//**
413
414 **//It might relate to the network which might be up to 10mins.//**
415
416
417 == **7.4 Onboarding – Bad Gateway** ==
418
419
420 [[image:1651832583790-633.png]]
421
422
423 //**This is caused by the process leading too long which just needs to refresh the page.**//
424
425
426 == **7.5 Onboarding ~-~- Why did QR Code generate aways fail?** ==
427
428
429 [[image:image-20220506182424-3.png]]
430
431
432 (((
433 //**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.**//
434
435
436 )))
437
438 == **7.6 Onboarding ~-~- Why is the QR Code not quite the same as the manual?** ==
439
440 [[image:1651832742262-209.png||height="297" width="365"]]
441
442
443 (((
444 //**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.**//
445
446
447 )))
448
449 == **7.7 Onboarding – MAC address is ‘Unknown’ after scan QR Code** ==
450
451
452 [[image:1651832811038-780.png||height="462" width="216"]]
453
454
455 (((
456 //**If you see the MAC Address shows the ‘Unknown’ where is due to the provisioning error, please contact us to help you solve it.**//
457
458
459 )))
460
461 == 7.8 Onboarding – MAC address is being refreshed after scanning the QR Code ==
462
463
464 (((
465 //**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.**//
466
467
468 )))
469
470 (((
471 //**If you don’t see the MAC address, make sure your mobile has a good internet connection.**//
472 )))
473
474 [[image:1651832880009-473.png]]
475
476
477 == //**7.9 HP0D Web ~-~-> Miner ~-~-> Version shows ‘short’**// ==
478
479
480 **//This is caused by the server connection delay, which does not affect the regular use.//**
481
482 [[image:1651832959907-357.png]]
483
484
485 == **7.10 Mobile APP crash after scanning the QR Code?** ==
486
487
488 * //**Make sure you have input the correct Wallet address to generate QR Code.**//
489 * //**Make sure your mobile app uses the same wallet address as the one to generate QR Code.**//
490 * //**Make sure your mobile app’s relevant permission is enabled.**//
491 * //**Known: The Android 11 version may cause this kind of issue.**//
492
493 == **7.11 Why the frequency/region is not the same as what I purchased?** ==
494
495
496 (((
497 //**Each HP0D is inspected and configured prior to shipping.**//
498 )))
499
500 (((
501 //**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.**//
502
503
504 )))
505
506 == **7.12 Can use the frequency to a region where is no support?** ==
507
508
509 (((
510 //**Please make sure that the region supports this frequency, you can confirm the appropriate frequency through this link:**//
511 )))
512
513 (((
514 [[https:~~/~~/docs.helium.com/lorawan-on-helium/frequency-plans>>url:https://docs.helium.com/lorawan-on-helium/frequency-plans]]
515
516
517 )))
518
519 == **7.13 Can change the frequency of the HP0D Miner?** ==
520
521
522 //We do not recommend doing this, it may damage your device//
523
524
525 = **8. OTA Version Info** =
526
527 == **When does the OTA update happen?** ==
528
529
530 **//HP0D will check OTA update on a) Every Booting. b) Every Night. Below is the OTA update version info//**
531
532 == **# 2022/05/14** ==
533
534
535 1. //Update to the latest miner version: miner-arm64_2022.05.13.0_GA//
536 1. //Add postinst after auto-update//
537 1. //Add Miner version mark.//
538 1. //Add fast sync if miner GAP is large//
539
540 = **9. Supports** =
541
542 (((
543 **//If you are experiencing issues and can’t solve them, you can send mail to [[support@dragino.com>>mailto:support@dragino.com]].//**
544 )))
545
546 (((
547 **//With your question as detailed as possible. We will reply and help you in the shortest.//**
548
549
550 )))
551
552 = **10. Order Info** =
553
554 (% style="color:#0000ff" %)**HP0D-XXX**
555
556 (% style="color:#0000ff" %)**XXX**(% style="color:black" %): Frequency Band
557
558 * **AS923**: LoRaWAN AS923 band
559 * **AU915**: LoRaWAN AU915 band
560 * **EU868**: LoRaWAN EU868 band
561 * **KR920**: LoRaWAN KR920 band
562 * **US915**: LoRaWAN US915 band
563 * **IN865**: LoRaWAN IN865 band
564
565 = **11. Manufacturer Info** =
566
567 (((
568 **Shenzhen Dragino Technology Development co. LTD**
569 )))
570
571 (((
572 Room 202, Block B, BCT Incubation Bases (BaoChengTai),  No.8 CaiYunRoad
573 )))
574
575 (((
576 Longcheng Street, LongGang District; Shenzhen 518116, China
577
578
579
580 )))
581
582 = 12. FCC Warning =
583
584 (((
585 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:
586 )))
587
588 (((
589 ~-~- Reorient or relocate the receiving antenna.
590 )))
591
592 (((
593 ~-~- Increase the separation between the equipment and receiver.
594 )))
595
596 (((
597 ~-~- Connect the equipment into an outlet on a circuit different from that to which the receiver is connected.
598 )))
599
600 (((
601 ~-~- Consult the dealer or an experienced radio/TV technician for help.
602 )))
603
604 (((
605 Changes or modifications not expressly approved by the party responsible for compliance could void the user's authority to operate the equipment.
606 )))
607
608 (((
609 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.
610 )))