Wiki source code of HP0D

Version 15.1 by Xiaoling on 2022/05/06 10:39

Hide last authors
Xiaoling 6.1 1
Xiaoling 1.1 2
3
Xiaoling 6.1 4 (% style="text-align:center" %)
Xiaoling 15.1 5 [[image:1651802206983-860.png||height="645" width="602"]]
Xiaoling 1.1 6
7
8
9
Xiaoling 6.1 10 **HP0D Full Hotspot for Helium User Manual**
Xiaoling 1.1 11
Xiaoling 6.1 12 [[image:1651802187690-980.png]]
Xiaoling 1.1 13
Xiaoling 6.1 14 Document Version: 1.1
Xiaoling 1.1 15
16
Xiaoling 6.1 17 |**Version**|**Description**|**Date**
18 |1.0|Release|2022-Apr-8
19 |1.1|Add trouble shootings|2022-Apr-24
20 | | |
21 | | |
22 | | |
23 | | |
Xiaoling 1.1 24
25
26
27
28
Xiaoling 6.1 29 ~1. Introduction
30
31 1.1 What is HP0D
32
33 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.
34
35 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**.
36
37 **~ 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.
38
39 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.
40
41
Xiaoling 15.1 42 1.2 Specifications
Xiaoling 6.1 43
Xiaoling 15.1 44 **~ Hardware System:**
Xiaoling 6.1 45
46 Linux Part:
47
48 * Raspberry Pi 4
49
Xiaoling 15.1 50 **~ Interface:**
Xiaoling 6.1 51
52 * 10M/100M RJ45 Ports x 1
53 * LoRaWAN Wireless
54 * Power Input: 12V 2A, DC
55
Xiaoling 15.1 56 **~ Operating Condition:**
Xiaoling 6.1 57
58 * Work Temperature: -20 ~~ 65°C
59 * Storage Temperature: -20 ~~ 65°C
60 * Power Input: 12V 2A, DC
61
62
Xiaoling 15.1 63 1.3 Features
Xiaoling 6.1 64
65 * Open-Source Linux system
66 * RPi4 with 2G /4G or 8G RAM
67 * Managed by Web GUI, SSH via Internet
68 * Support Semtech UDP packet forwarder
69 * Support LoRaWAN Station Connection
70 * Support Helium Miner
71 * External fiberglass antenna
72 * Firmware OTA
73 * 802.3af PoE
74 * Lighting Protection
75 * Remote Monitoring
76 * Support Helium LoRaWAN server and secondary LoRaWAN server
77 * Include prepaid $40 onboarding cost and $10 location cost.
78 * [[Remote.it remote management>>url:https://wiki.dragino.com/index.php?title=Reverse_SSH_Access#Use_Remote.it_service]].
79
80
Xiaoling 15.1 81 1.4 Label info and login name
Xiaoling 6.1 82
83
Xiaoling 15.1 84 (% style="text-align:center" %)
85 [[image:1651803959860-394.png||height="653" width="490"]]
Xiaoling 6.1 86
87
88
Xiaoling 15.1 89 **~ Label information:**
Xiaoling 6.1 90
91
Xiaoling 15.1 92 **~ Device host name//~://**// dragino-xxxxxx//
Xiaoling 6.1 93
Xiaoling 15.1 94 **~ Band**//:  US915/AU915/AS923_1-AS923_4/KR920/EU868/IN865/RU864//
Xiaoling 6.1 95
Xiaoling 15.1 96 **// Miner animal name//**//: xxx-xxx-xxx//
Xiaoling 6.1 97
Xiaoling 15.1 98 **// Miner address//**//:          112xxxxxx//
Xiaoling 6.1 99
Xiaoling 15.1 100 **~ Eth MAC address**//: A8: 40: 41: EF: FE: CD//
Xiaoling 6.1 101
Xiaoling 15.1 102 **~ Login**//:  root/d59f2d5b (the root is the Login account for the Web-UI and SSH.)//
Xiaoling 6.1 103
Xiaoling 15.1 104 **~ SN**//:  device serial number.//
Xiaoling 6.1 105
106
Xiaoling 15.1 107 2. Quick Start & Onboarding
Xiaoling 6.1 108
Xiaoling 15.1 109 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.
Xiaoling 6.1 110
Xiaoling 15.1 111 2.1  Connect HP0D Web UI
Xiaoling 6.1 112
Xiaoling 15.1 113 2.1.1 via HP0D’s Access Point.[[image:1651804327535-321.png||height="325" style="float:right" width="199"]]
Xiaoling 6.1 114
Xiaoling 15.1 115 At the first boot of HP0D, it will auto generate a Wi-Fi network
Xiaoling 6.1 116
117
Xiaoling 15.1 118 called           : **//HPD-dragino-xxxxxx//**
Xiaoling 6.1 119
Xiaoling 15.1 120 with password:  **//dragino+dragino//**
Xiaoling 6.1 121
122
123
Xiaoling 15.1 124 You can use a PC to connect to this Wi-Fi network. The PC will
Xiaoling 6.1 125
Xiaoling 15.1 126 get an IP address 10.130.1.xxx and the HP0D has the default
Xiaoling 6.1 127
Xiaoling 15.1 128 IP 10.130.1.1
Xiaoling 6.1 129
130
Xiaoling 15.1 131 (% style="text-align:center" %)
132 [[image:1651804397792-591.png]]
Xiaoling 6.1 133
134
135
136
Xiaoling 15.1 137 2.1.2 Connect via HP0D hostname
Xiaoling 6.1 138
Xiaoling 15.1 139 Connect the HP0D Ethernet port to your router and HP0D will obtain an IP address. If your
Xiaoling 6.1 140
Xiaoling 15.1 141 PC(Windows/Mac/Ubuntu) connect the same network with the HP0D, you can access the HP0D
Xiaoling 6.1 142
Xiaoling 15.1 143 Web-UI via HP0D’s hostname.
Xiaoling 6.1 144
145
Xiaoling 15.1 146 Like: __ **//http:~/~/dragino-4ba54a//**__
Xiaoling 6.1 147
148
Xiaoling 15.1 149 (% style="text-align:center" %)
150 [[image:1651804629009-699.png]]
Xiaoling 6.1 151
152
Xiaoling 15.1 153 2.1.3 Connect via Ethernet Port
Xiaoling 6.1 154
155 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.
156
157
158 If you get the IP address form route, like~:// **10.130.2.42**,// you can use this IP address to connect the WEB UI or SSH access of HP0D.
159
Xiaoling 15.1 160 (% style="text-align:center" %)
161 [[image:1651804782523-623.png]]
Xiaoling 6.1 162
163
164
Xiaoling 15.1 165 1.
Xiaoling 6.1 166 11. Generate QR Code
167
168 Go to **Miner** ~-~-> **QR Generate**, input your Helium Wallet Address, and click Generate.
169
170 Note: After onboarding, this wallet will become owner of this hotspot.
171
172 [[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image007.png]]
173
174
175
176
Xiaoling 15.1 177 1.
Xiaoling 6.1 178 11. Onboarding Hotspot
179 1. Download the Helium Hotspot APP from the Apple or Google Play store.
180
181 Note: the APP version need to be greater than 3.11.
182
183
184 1. [[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image008.jpg]] [[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image009.jpg]]
185 To add a hotspot, select “Hotspot”. On this tab, click the ‘+ Add Hotspot’ in the mid where choose the ‘DRAGINO Miner HP0D’
186
187 1. Scan the QR Code you generated in the previous step.
188
189 [[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image010.jpg]]
190
191
192 1. Onboarding your device
193
194 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.
195
196 [[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image011.jpg]] [[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image012.jpg]]
197
198
199 [[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image013.jpg]] [[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image014.jpg]]
200
201
202
203
204 1. Check onboarding status
205
206 You can check from mobile:
207
208 [[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image015.png]] [[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image016.jpg]]
209
210 You can also see the hotspot status in below link:
211
212 https:~/~/explorer.helium.com/hotspots/**//<YOUR_HOTSPORT_KEY>//**
213
214 Example:
215
216 Green Synced means hotspot works normal.
217
218 [[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image017.png]]
219
220
221
222
223
Xiaoling 15.1 224 1.
Xiaoling 6.1 225 11. Set the Port Forwarding
226
227 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.
228
229 [[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image018.png]]
230
231
232 Note: Please refer to more detailed Settings
233
234 [[https:~~/~~/docs.helium.com/troubleshooting/network-troubleshooting/>>url:https://docs.helium.com/troubleshooting/network-troubleshooting/]]
235
236 [[https:~~/~~/www.youtube.com/watch?v=GKusVC7ovrE>>url:https://www.youtube.com/watch?v=GKusVC7ovrE]]
237
238
239
240
241
242 1. Check the configuration of HP0D
243 11. LoRa frequency configuration
244
245 [[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image019.png]]
246
Xiaoling 15.1 247 1.
Xiaoling 6.1 248 11. Check the LoRaWAN serveraddress.
249
250 [[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image020.png]]
251
252
253
254
255
256
257
258
259
Xiaoling 15.1 260 1.
Xiaoling 6.1 261 11. Check Miner configuration
262
263 [[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image021.png]]
264
265 **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,**
266
267
268
269
270
271 1. Installation of Antenna
272
273 HP0D use Fiber Glass Antenna.
274
275 [[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image022.png]]
276
277 User need to connect antenna cable’s SMA connector to the HP03 and connect N-Type connector to antenna and install as below:
278
279
280 [[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image023.png]]
281
282
283
284
285
286 1. SSH Access for Linux console
287
288 IP address:  IP address of HP0D or hostname of HP0D (Such as dragino-63920a)
289
290 Port:         22
291
292 User Name:      **root**
293
294 Password:         **Randomly generated (found on device’s label )**
295
296
297 After logging in, you will be in the Linux console and can enter commands as shown below.
298
299 [[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image024.png]]
300
301
302
303
304 1. Trouble Shootings
305 11. How to get a wallet address?
306
307 //Download the helium Hotspots APP on the Apple or Google Play store to generate own wallet.//
308
309
Xiaoling 15.1 310 1.
Xiaoling 6.1 311 11. Onboarding ~-~- Unable to access Web-UI ~-~-> Miner
312
313 //User can login the HP0D, able to access other Web Pages except miner page//
314
315
316 //If you first boot the device where you need to wait for 10 mins for initialization connection to Helium server.//
317
318
Xiaoling 15.1 319 1.
Xiaoling 6.1 320 11. Onboarding ~-~- Some parameters in miner page show timeout
321
322 [[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image025.png]]
323
324 [[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image026.png]]
325
326 //HP0D is establish connection to Helium server and not finished. And you might see above.//
327
328 //It might relate to the network where might up to 10mins//
329
330
Xiaoling 15.1 331 1.
Xiaoling 6.1 332 11. Onboarding – Bad Gaterway
333
334 [[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image027.png]]
335
336 //This is caused by the process leads too long which just need to refresh the page.//
337
338
Xiaoling 15.1 339 1.
Xiaoling 6.1 340 11. Onboarding ~-~- Why did QR Code generate is aways fail?
341
342 [[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image028.png]]
343
344 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
345
346
Xiaoling 15.1 347 1.
Xiaoling 6.1 348 11. Onboarding ~-~- Why is the QR Code not quite the same as the manual?
349
350 [[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image029.png]]
351
352 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.
353
354
Xiaoling 15.1 355 1.
Xiaoling 6.1 356 11. Onboarding – MAC address is ‘Unknown’ after scan QR Code
357
358 [[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image030.png]]
359
360 If you see the MAC Address shows the ‘Unknown’ where is due to the provision error, please contact us to help you solve.
361
362
Xiaoling 15.1 363 1.
Xiaoling 6.1 364 11. Onboarding – MAC address is being refreshed after scan QR Code
365
366 //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.//
367
368
369 //If you don’t see MAC address, make sure your mobile has good internet connection.//
370
371 [[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image031.png]]
372
373
374
375
Xiaoling 15.1 376 1.
Xiaoling 6.1 377 11. HP0D Web ~-~-> Miner ~-~-> Version shows ‘short’
378
379 //This is caused by the server connection delay, which does not affect the normal use.//
380
381 [[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image032.png]]
382
383
Xiaoling 15.1 384 *
Xiaoling 6.1 385 *1. Mobile APP crash after scan the QR Code?
386 * //Make sure you have input the correct Wallet address to generate QR Code.//
387 * //Make sure your mobile app uses the same wallet address as the one to generate QR Code.//
388 * //Make sure your mobile app’s relevant permission are enabled.//
389 * //Known: The Android 11 version may cause this kind of issue.//
390
Xiaoling 15.1 391 1.
Xiaoling 6.1 392 11. Why the frequency/region is not the same what I purchased?
393
394 //Each HP0D is inspected and configured prior to shipping.//
395
396 //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.//
397
398
Xiaoling 15.1 399 1.
Xiaoling 6.1 400 11. Can use the frequency to a region where is not support?
401
402 //Please make sure that the region supports this frequency, you can confirm the appropriate frequency through this link//
403
404 [[https:~~/~~/docs.helium.com/lorawan-on-helium/frequency-plans>>url:https://docs.helium.com/lorawan-on-helium/frequency-plans]]
405
406
Xiaoling 15.1 407 1.
Xiaoling 6.1 408 11. Can change the frequency of the HP0D Miner?
409
410 //We do not recommend doing this, it may damage your device//
411
412
413
414
415
416 1. Supports
417
418 //If you are experiencing issues and can’t solve, you can send mail to//
419
420 [[//support@dragino.com//>>mailto:support@dragino.com]]
421
422 //With your question as detail as possible. We will reply and help you in the shortest.//
423
424
425
426
427 1. Order Info
428
429 **HP0D-XXX**
430
431 **XXX**: Frequency Band
432
433 * 868: For Bands: EU868,IN865
434 * 915: For Bands: US915,AU915,AS923,KR920
435
436
437 1. Manufacturer Info
438
439 **Shenzhen Dragino Technology Development co. LTD**
440
441 Room 202, Block B, BCT Incubation Bases (BaoChengTai),  No.8 CaiYunRoad
442
443 LongCheng Street, LongGang District ; Shenzhen 518116,China
444
445
446 1. FCC Warning
447
448 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:
449
450 ~-~- Reorient or relocate the receiving antenna.
451
452 ~-~- Increase the separation between the equipment and receiver.
453
454 ~-~- Connect the equipment into an outlet on a circuit different from that to which the receiver is connected.
455
456 ~-~- Consult the dealer or an experienced radio/TV technician for help.
457
458
459 Changes or modifications not expressly approved by the party responsible for compliance could void the user's authority to operate the equipment.
460
461
462 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.
463
464