Wiki source code of HP0D

Version 73.15 by Xiaoling on 2022/05/07 17:32

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