Wiki source code of HP0D Full Hotspot for Helium

Version 86.1 by Xiaoye on 2022/05/31 17:01

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
51.1	252	[[image:1651828703680-156.png\|\|height="349" width="672"]]
	253
	254
78.1	255	== 3.3 Check Miner configuration ==
	256
	257
59.1	258	[[image:image-20220506181408-1.png\|\|height="451" width="513"]]
51.1	259
73.10	260	(((
78.1	261	//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.//
	262
	263
73.10	264	)))
51.1	265
78.1	266	= 4. Installation of Antenna =
51.1	267
78.1	268
59.1	269	(((
78.1	270	//HP0D uses Fiber Glass Antenna.//
59.1	271	)))
51.1	272
59.1	273	[[image:1651832158606-882.png]]
51.1	274
59.1	275	(((
	276
	277	)))
51.1	278
59.1	279	(((
78.1	280	//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	281	)))
51.1	282
59.1	283	(((
	284	[[image:1651832205608-998.png\|\|height="349" width="198"]]
78.1	285
	286
59.1	287	)))
51.1	288
78.1	289	= 5. SSH Access for Linux console =
51.1	290
78.1	291
59.1	292	(((
78.1	293	//IP address: IP address of HP0D or hostname of HP0D ((% class="mark" %)Such as dragino-63920a(%%))//
59.1	294	)))
51.1	295
59.1	296	(((
78.1	297	//Port: 22//
59.1	298	)))
51.1	299
59.1	300	(((
78.1	301	//User Name: (% style="color:green" %)root//
59.1	302	)))
51.1	303
59.1	304	(((
78.1	305	//Password: (% style="color:green" %)Randomly generated （found on device’s label）//
	306
	307
59.1	308	)))
51.1	309
59.1	310	(((
78.1	311	//After logging in, you will be in the Linux console and can enter commands as shown below.//
	312
	313
59.1	314	)))
51.1	315
74.3	316	[[image:1651832284160-991.png\|\|height="171" width="729"]]
51.1	317
78.1	318
74.3	319	= 6. How to change the Wireless function of HP0D =
51.1	320
78.1	321	//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.//
51.1	322
78.1	323
74.3	324	== 6.1 Access the Linux console. ==
51.1	325
78.1	326	//Follow the previous step of Step 5.//
67.1	327
	328
78.1	329	== 6.2 Install the package of network-manager ==
67.1	330
78.1	331
	332	//Run commands~://
	333
72.1	334	(% class="box infomessage" %)
	335	(((
73.8	336	apt update
	337	apt install network-manager
72.1	338	)))
67.1	339
74.3	340	[[image:image-20220507140730-1.png\|\|height="402" width="728"]]
67.1	341
	342
78.1	343	== 6.3 Reboot the device ==
72.1	344
78.1	345
	346	//Run command~://
	347
72.1	348	(% class="box infomessage" %)
	349	(((
73.8	350	reboot
72.1	351	)))
	352
	353	[[image:image-20220507140814-2.png]]
	354
74.1	355
78.1	356	== 6.4 Check the wireless type ==
72.1	357
78.1	358
	359	//Run command~://
	360
72.1	361	(% class="box infomessage" %)
	362	(((
73.8	363	iw dev
72.1	364	)))
	365
	366	[[image:image-20220507140941-3.png]]
	367
	368
78.1	369	== 6.5 Connect the WiFi ==
72.1	370
78.1	371
	372	//Run command~://
	373
72.1	374	(% class="box infomessage" %)
	375	(((
73.8	376	nmtui
72.1	377	)))
	378
	379	[[image:image-20220507140953-4.png]]
	380
	381
78.1	382	= 7. Trouble Shootings =
67.1	383
78.1	384	== 7.1 How to get a wallet address? ==
51.1	385
	386
78.1	387	//Download the helium Hotspots APP on the Apple or Google Play store to generate your own wallet.//
	388
	389
	390	== 7.2 Onboarding ~-~- Unable to access Web-UI ~-~-> Miner ==
	391
	392
59.1	393	(((
78.1	394	//Users can log in to the HP0D, able to access other Web Pages except for the miner page.//
59.1	395	)))
51.1	396
59.1	397	(((
78.1	398	//If you first boot the device where you need to wait for 10 mins for the initialization connection to the Helium server.//
	399
	400
59.1	401	)))
51.1	402
78.1	403	== 7.3 Onboarding ~-~- Some parameters on the miner page show timeout ==
51.1	404
78.1	405
59.1	406	[[image:image-20220506182042-2.png\|\|height="250" width="516"]]
51.1	407
59.1	408	[[image:1651832455372-647.png\|\|height="224" width="520"]]
51.1	409
	410
78.1	411	//HP0D is establishing a connection to the Helium server and is not finished. And you might see above.//
51.1	412
78.1	413	//It might relate to the network which might be up to 10mins.//
73.6	414
78.1	415
	416	== 7.4 Onboarding – Bad Gateway ==
	417
	418
59.1	419	[[image:1651832583790-633.png]]
51.1	420
	421
78.1	422	//This is caused by the process leading too long which just needs to refresh the page.//
51.1	423
78.1	424
	425	== 7.5 Onboarding ~-~- Why did QR Code generate aways fail? ==
	426
	427
65.1	428	[[image:image-20220506182424-3.png]]
51.1	429
78.1	430
73.6	431	(((
78.1	432	//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.//
	433
	434
73.6	435	)))
51.1	436
78.1	437	== 7.6 Onboarding ~-~- Why is the QR Code not quite the same as the manual? ==
51.1	438
65.1	439	[[image:1651832742262-209.png\|\|height="297" width="365"]]
51.1	440
78.1	441
73.8	442	(((
78.1	443	//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.//
	444
	445
73.8	446	)))
51.1	447
78.1	448	== 7.7 Onboarding – MAC address is ‘Unknown’ after scan QR Code ==
51.1	449
78.1	450
65.1	451	[[image:1651832811038-780.png\|\|height="462" width="216"]]
51.1	452
78.1	453
73.8	454	(((
78.1	455	//If you see the MAC Address shows the ‘Unknown’ where is due to the provisioning error, please contact us to help you solve it.//
	456
	457
73.8	458	)))
51.1	459
78.1	460	== 7.8 Onboarding – MAC address is being refreshed after scanning the QR Code ==
51.1	461
78.1	462
73.8	463	(((
78.1	464	//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.//
	465
	466
73.8	467	)))
51.1	468
73.8	469	(((
78.1	470	//If you don’t see the MAC address, make sure your mobile has a good internet connection.//
73.8	471	)))
51.1	472
65.1	473	[[image:1651832880009-473.png]]
51.1	474
	475
78.1	476	== //7.9 HP0D Web ~-~-> Miner ~-~-> Version shows ‘short’// ==
65.1	477
78.1	478
	479	//This is caused by the server connection delay, which does not affect the regular use.//
	480
65.1	481	[[image:1651832959907-357.png]]
	482
73.5	483
78.1	484	== 7.10 Mobile APP crash after scanning the QR Code? ==
65.1	485
51.1	486
78.1	487	* //Make sure you have input the correct Wallet address to generate QR Code.//
	488	* //Make sure your mobile app uses the same wallet address as the one to generate QR Code.//
	489	* //Make sure your mobile app’s relevant permission is enabled.//
	490	* //Known: The Android 11 version may cause this kind of issue.//
	491
	492	== 7.11 Why the frequency/region is not the same as what I purchased? ==
	493
	494
73.8	495	(((
78.1	496	//Each HP0D is inspected and configured prior to shipping.//
73.8	497	)))
51.1	498
73.8	499	(((
78.1	500	//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.//
	501
	502
73.8	503	)))
51.1	504
78.1	505	== 7.12 Can use the frequency to a region where is no support? ==
51.1	506
78.1	507
73.8	508	(((
78.1	509	//Please make sure that the region supports this frequency, you can confirm the appropriate frequency through this link://
73.8	510	)))
73.5	511
73.8	512	(((
51.1	513	[[https:~~/~~/docs.helium.com/lorawan-on-helium/frequency-plans>>url:https://docs.helium.com/lorawan-on-helium/frequency-plans]]
78.1	514
	515
73.8	516	)))
51.1	517
78.1	518	== 7.13 Can change the frequency of the HP0D Miner? ==
51.1	519
	520
78.1	521	//We do not recommend doing this, it may damage your device//
51.1	522
75.1	523
82.1	524	== 7.14 Low Reward and not transmit issue ==
81.1	525
	526
82.1	527	//We had released the 0524 version for the miner, Users can check the miner version in the HP0D web UI.//
81.1	528
82.1	529	//If it is lower than the 0524 version, users can manually upgrade it via the 'draginoups' command in the HP0D's CLI.//
81.1	530
	531	[[image:image-20220527114519-1.png\|\|height="579" width="851"]]
	532
	533
78.1	534	= 8. OTA Version Info =
76.1	535
78.1	536	== When does the OTA update happen? ==
76.1	537
75.1	538
78.1	539	//HP0D will check OTA update on a) Every Booting. b) Every Night. Below is the OTA update version info//
75.1	540
78.1	541	== # 2022/05/14 ==
75.1	542
78.1	543
	544	1. //Update to the latest miner version: miner-arm64_2022.05.13.0_GA//
	545	1. //Add postinst after auto-update//
	546	1. //Add Miner version mark.//
	547	1. //Add fast sync if miner GAP is large//
	548
79.1	549	== # 2022/05/24 ==
	550
	551	1. //Update to the latest miner version: miner-arm64_2022.05.24.0_GA//
	552
	553
78.1	554	= 9. Supports =
	555
73.8	556	(((
78.1	557	//If you are experiencing issues and can’t solve them, you can send mail to [[support@dragino.com>>mailto:support@dragino.com]].//
73.8	558	)))
51.1	559
73.8	560	(((
78.1	561	//With your question as detailed as possible. We will reply and help you in the shortest.//
75.1	562
	563
73.8	564	)))
51.1	565
78.1	566	= 10. Order Info =
51.1	567
74.9	568	(% style="color:#0000ff" %)HP0D-XXX
51.1	569
74.9	570	(% style="color:#0000ff" %)XXX(% style="color:black" %): Frequency Band
51.1	571
77.1	572	* AS923: LoRaWAN AS923 band
	573	* AU915: LoRaWAN AU915 band
	574	* EU868: LoRaWAN EU868 band
	575	* KR920: LoRaWAN KR920 band
	576	* US915: LoRaWAN US915 band
	577	* IN865: LoRaWAN IN865 band
51.1	578
78.1	579	= 11. Manufacturer Info =
75.1	580
73.10	581	(((
51.1	582	Shenzhen Dragino Technology Development co. LTD
73.10	583	)))
51.1	584
73.10	585	(((
51.1	586	Room 202, Block B, BCT Incubation Bases (BaoChengTai), No.8 CaiYunRoad
73.10	587	)))
51.1	588
73.10	589	(((
78.1	590	Longcheng Street, LongGang District; Shenzhen 518116, China
75.1	591
	592
	593
73.10	594	)))
51.1	595
78.4	596	= 12. FCC Warning =
51.1	597
73.10	598	(((
51.1	599	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	600	)))
51.1	601
73.10	602	(((
51.1	603	~-~- Reorient or relocate the receiving antenna.
73.10	604	)))
51.1	605
73.10	606	(((
51.1	607	~-~- Increase the separation between the equipment and receiver.
73.10	608	)))
51.1	609
73.10	610	(((
51.1	611	~-~- Connect the equipment into an outlet on a circuit different from that to which the receiver is connected.
73.10	612	)))
51.1	613
73.10	614	(((
51.1	615	~-~- Consult the dealer or an experienced radio/TV technician for help.
73.10	616	)))
51.1	617
73.10	618	(((
51.1	619	Changes or modifications not expressly approved by the party responsible for compliance could void the user's authority to operate the equipment.
73.10	620	)))
51.1	621
73.10	622	(((
51.1	623	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	624	)))

Wiki source code of HP0D Full Hotspot for Helium

Applications

Navigation