Wiki source code of HP0D

Version 73.17 by Xiaoling on 2022/05/07 17:36

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