Wiki source code of HP0D

Version 74.1 by Xiaoye on 2022/05/12 15:16

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