Wiki source code of HP0D Full Hotspot for Helium

Version 96.1 by Xiaoye on 2022/06/07 15:55

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

Wiki source code of HP0D Full Hotspot for Helium

Applications

Navigation