Wiki source code of HP0D Full Hotspot for Helium

Version 78.1 by Xiaoye on 2022/05/24 14:34

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

Wiki source code of HP0D Full Hotspot for Helium

Applications

Navigation