Wiki source code of HP0D

Version 73.13 by Xiaoling on 2022/05/07 17:29

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