Wiki source code of HP0D

Version 59.1 by Xiaoling on 2022/05/06 18:23

version	line-number	content
51.1	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
	15	{{toc/}}
	16
	17
	18	==== 1. Introduction ====
	19
	20	===== 1.1 What is HP0D =====
	21
	22	(((
	23	(((
59.1	24	(((
51.1	25	The HP0D is an outdoor LoRaWAN Gateway. It lets you bridge LoRa wireless network to an IP network via WiFi,
	26	)))
59.1	27	)))
51.1	28
	29	(((
59.1	30	(((
51.1	31	Ethernet, optional 3G or 4G. The LoRa wireless allows users to send data and reach extremely long ranges
	32	)))
59.1	33	)))
51.1	34
	35	(((
59.1	36	(((
51.1	37	at low data rates.
	38	)))
	39	)))
59.1	40	)))
51.1	41
	42	(((
	43	(((
59.1	44	(((
51.1	45
	46	)))
	47	)))
59.1	48	)))
51.1	49
	50	(((
	51	(((
59.1	52	(((
51.1	53	HP0D has passed Helium Full Hotspot Approval. It supports the miner feature from Helium and has a built-in
	54	)))
59.1	55	)))
51.1	56
	57	(((
59.1	58	(((
51.1	59	ATECC608 encryption chip. It can be used as a Helium Full Hotspot for the project. It also supports Semtech
	60	)))
59.1	61	)))
51.1	62
	63	(((
59.1	64	(((
51.1	65	packet forwarder and LoRaWAN Station connection, it is fully compatible with LoRaWAN protocol.
	66	)))
59.1	67	)))
51.1	68
	69	(((
59.1	70	(((
51.1	71	HP0D supports two LoRaWAN servers at the same time, users can use HP0D for helium mining
	72	)))
	73	)))
59.1	74	)))
51.1	75
	76	(((
	77	(((
59.1	78	(((
51.1	79	~ and connects max 2 x LoRaWAN servers at the same time.
	80	)))
	81	)))
59.1	82	)))
51.1	83
	84	(((
	85	(((
59.1	86	(((
51.1	87
	88	)))
	89	)))
59.1	90	)))
51.1	91
	92	(((
	93	(((
59.1	94	(((
51.1	95	~ Dragino already paid HP0D $40 onboarding cost and $10 location cost for each HP0D. It is ready to use
	96	)))
59.1	97	)))
51.1	98
	99	(((
59.1	100	(((
51.1	101	for Helium, user only needs to input HNT wallet address and use QR Code to onboarding HP0D when it arrives.
	102	)))
	103	)))
59.1	104	)))
51.1	105
	106	(((
	107	(((
59.1	108	(((
51.1	109
	110	)))
	111	)))
59.1	112	)))
51.1	113
	114	(((
	115	(((
59.1	116	(((
51.1	117	HP0D has pre-configured standard LoRaWAN frequency bands to use for different countries. Users can also
	118	)))
59.1	119	)))
51.1	120
	121	(((
59.1	122	(((
51.1	123	customize the frequency bands to use in their own LoRaWAN network.
	124	)))
	125	)))
59.1	126	)))
51.1	127
	128
	129	===== 1.2 Specifications =====
	130
	131	(((
59.1	132	(((
51.1	133	~ Hardware System:
	134	)))
59.1	135	)))
51.1	136
	137	(((
59.1	138	(((
51.1	139	Linux Part:
	140	)))
59.1	141	)))
51.1	142
	143	* (((
59.1	144	(((
51.1	145	Raspberry Pi 4
	146	)))
59.1	147	)))
51.1	148
	149	(((
59.1	150	(((
51.1	151	~ Interface:
	152	)))
59.1	153	)))
51.1	154
	155	* (((
59.1	156	(((
51.1	157	10M/100M RJ45 Ports x 1
	158	)))
59.1	159	)))
51.1	160	* (((
59.1	161	(((
51.1	162	LoRaWAN Wireless
	163	)))
59.1	164	)))
51.1	165	* (((
59.1	166	(((
51.1	167	Power Input: 12V 2A, DC
	168	)))
59.1	169	)))
51.1	170
	171	(((
59.1	172	(((
51.1	173	~ Operating Condition:
	174	)))
59.1	175	)))
51.1	176
	177	* (((
59.1	178	(((
51.1	179	Work Temperature: -20 ~~ 65°C
	180	)))
59.1	181	)))
51.1	182	* (((
59.1	183	(((
51.1	184	Storage Temperature: -20 ~~ 65°C
	185	)))
59.1	186	)))
51.1	187	* (((
59.1	188	(((
51.1	189	Power Input: 12V 2A, DC
	190	)))
59.1	191	)))
51.1	192
	193	===== 1.3 Features =====
	194
	195	* Open-Source Linux system
	196	* RPi4 with 2G /4G or 8G RAM
	197	* Managed by Web GUI, SSH via Internet
	198	* Support Semtech UDP packet forwarder
	199	* Support LoRaWAN Station Connection
	200	* Support Helium Miner
	201	* External fiberglass antenna
	202	* Firmware OTA
	203	* 802.3af PoE
	204	* Lighting Protection
	205	* Remote Monitoring
	206	* Support Helium LoRaWAN server and secondary LoRaWAN server
	207	* Include prepaid $40 onboarding cost and $10 location cost.
	208	* [[Remote.it remote management>>url:https://wiki.dragino.com/index.php?title=Reverse_SSH_Access#Use_Remote.it_service]].
	209
	210	===== 1.4 Label info and login name =====
	211
	212
	213	(% style="text-align:center" %)
59.1	214	[[image:1651803959860-394.png\|\|height="500" width="375"]]
51.1	215
	216
	217
	218	(((
59.1	219	(((
51.1	220	~ Label information:
	221	)))
59.1	222	)))
51.1	223
	224	(((
59.1	225	(((
51.1	226
	227	)))
59.1	228	)))
51.1	229
	230	(((
59.1	231	(((
51.1	232	~ Device host name: (% class="mark" %)dragino-xxxxxx
	233	)))
59.1	234	)))
51.1	235
	236	(((
59.1	237	(((
51.1	238	~ Band: US915/AU915/AS923_1-AS923_4/KR920/EU868/IN865/RU864
	239	)))
59.1	240	)))
51.1	241
	242	(((
59.1	243	(((
51.1	244	~ Miner animal name: xxx-xxx-xxx
	245	)))
59.1	246	)))
51.1	247
	248	(((
59.1	249	(((
51.1	250	~ Miner address: 112xxxxxx
	251	)))
59.1	252	)))
51.1	253
	254	(((
59.1	255	(((
51.1	256	~ Eth MAC address: A8: 40: 41: EF: FE: CD
	257	)))
59.1	258	)))
51.1	259
	260	(((
59.1	261	(((
51.1	262	~ Login: root/d59f2d5b ((% class="mark" %)the root is the Login account for the Web-UI and SSH.(%%))
	263	)))
59.1	264	)))
51.1	265
	266	(((
59.1	267	(((
51.1	268	~ SN: device serial number.
	269	)))
59.1	270	)))
51.1	271
	272
	273	==== 2. Quick Start & Onboarding ====
	274
	275	(((
	276	(((
	277	The HP0D is configured as a Wi-Fi Access Point by factory default. You can access and configure the HPD after
	278	)))
	279
	280	(((
	281	connecting to its Wi-Fi network, or via its WAN Ethernet port.
	282	)))
	283	)))
	284
	285	(% class="wikigeneratedid" id="H-2" %)
	286	(((
	287
	288	)))
	289
	290	===== 2.1 Connect HP0D Web UI =====
	291
	292	====== 2.1.1 via HP0D’s Access Point. ======
	293
	294	(((
59.1	295	(((
	296	At the first boot of HP0D, it will auto generate a Wi-Fi network[[image:1651804327535-321.png\|\|height="325" style="float:right" width="199"]]
51.1	297	)))
59.1	298	)))
51.1	299
	300	(((
59.1	301	(((
51.1	302
	303	)))
59.1	304	)))
51.1	305
	306	(((
59.1	307	(((
51.1	308	called : //HPD-dragino-xxxxxx//
	309	)))
59.1	310	)))
51.1	311
	312	(((
59.1	313	(((
51.1	314	with password: //dragino+dragino//
	315	)))
59.1	316	)))
51.1	317
	318	(((
59.1	319	(((
51.1	320
	321	)))
59.1	322	)))
51.1	323
	324	(((
59.1	325	(((
51.1	326
	327	)))
59.1	328	)))
51.1	329
	330	(((
59.1	331	(((
51.1	332	You can use a PC to connect to this Wi-Fi network. The PC will
	333	)))
59.1	334	)))
51.1	335
	336	(((
59.1	337	(((
51.1	338	get an IP address 10.130.1.xxx and the HP0D has the default
	339	)))
59.1	340	)))
51.1	341
	342	(((
59.1	343	(((
51.1	344	IP 10.130.1.1
	345	)))
59.1	346	)))
51.1	347
	348
	349
	350	(% style="text-align:center" %)
59.1	351	[[image:1651804397792-591.png\|\|height="402" width="763"]]
51.1	352
	353
	354
	355	====== 2.1.2 Connect via HP0D hostname ======
	356
59.1	357	(((
51.1	358	Connect the HP0D Ethernet port to your router and HP0D will obtain an IP address. If your
59.1	359	)))
51.1	360
59.1	361	(((
51.1	362	PC(Windows/Mac/Ubuntu) connect the same network with the HP0D, you can access the HP0D
59.1	363	)))
51.1	364
59.1	365	(((
51.1	366	Web-UI via HP0D’s hostname.
59.1	367	)))
51.1	368
	369
	370	Like: __//http:~/~/dragino-4ba54a//__
	371
	372
	373	(% style="text-align:center" %)
	374	[[image:1651804629009-699.png]]
	375
	376
	377	====== 2.1.3 Connect via Ethernet Port ======
	378
	379	(((
59.1	380	(((
51.1	381	Connect the HP0D Ethernet port to your router and HP0D will obtain an IP address from your router. In the
	382	)))
59.1	383	)))
51.1	384
	385	(((
59.1	386	(((
51.1	387	router’s management portal, you should be able to find what IP address the router has assigned to the HP0D.
	388	)))
59.1	389	)))
51.1	390
	391	(((
	392
	393	)))
	394
59.1	395	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
51.1	396
59.1	397	or SSH access of HP0D.
	398
51.1	399	(% style="text-align:center" %)
	400	[[image:1651804782523-623.png]]
	401
	402
	403
	404	===== 2.2 Generate QR Code =====
	405
	406	(((
	407	Go to Miner ~-~-> QR Generate, input your Helium Wallet Address, and click Generate.
	408	)))
	409
	410	(((
	411	Note: After onboarding, this wallet will become owner of this hotspot.
	412	)))
	413
	414	(% style="text-align:center" %)
59.1	415	[[image:image-20220506140312-1.png\|\|height="435" width="438"]]
51.1	416
	417
	418	===== 2.3 Onboarding Hotspot =====
	419
	420	(((
	421	~1. Download the Helium Hotspot APP from the Apple or Google Play store.
	422	)))
	423
	424	(((
	425	Note: the APP version need to be greater than 3.11.
	426	)))
	427
	428	(((
	429
	430	)))
	431
	432	(((
	433	2. To add a hotspot, select “Hotspot”. On this tab, click the ‘+ Add Hotspot’ in the mid where choose
	434	)))
	435
	436	(((
	437	the ‘DRAGINO Miner HP0D’
	438	)))
	439
	440	[[image:1651817186037-899.png\|\|height="429" width="206"]] [[image:1651817194458-938.png\|\|height="434" width="203"]]
	441
	442	3. Scan the QR Code you generated in the previous step.
	443
	444	(% style="text-align:center" %)
	445	[[image:1651828211026-220.png\|\|height="405" width="191"]]
	446
	447	4. Onboarding your device
	448
	449	Mobile APP will get info from onboarding server. If MAC address doesn’t appear, it means the network connection of
	450
	451	mobile to onboarding server might have issue.
	452
	453	[[image:image-20220506141159-2.png\|\|height="426" width="204"]] [[image:1651817529289-461.png\|\|height="423" width="199"]]
	454
	455	[[image:1651828250802-391.png\|\|height="437" width="205"]] [[image:1651828262668-768.png\|\|height="433" width="204"]]
	456
	457
	458	5. Check onboarding status
	459
	460	You can check from mobile:
	461
	462	[[image:1651828391664-884.png\|\|height="413" width="197"]] [[image:1651828401011-970.png\|\|height="412" width="193"]]
	463
	464	You can also see the hotspot status in below link:
	465
	466	https:~/~/explorer.helium.com/hotspots///<(% class="mark" %)YOUR_HOTSPORT_KEY(%%)>//
	467
	468	Example:
	469
	470	Green Synced means hotspot works normal.
	471
	472	(% style="text-align:center" %)
	473	[[image:1651828427715-679.png\|\|height="374" width="635"]]
	474
	475
	476	===== 2.4 Set the Port Forwarding =====
	477
	478	(((
	479	Helium Hotspots may not work if the Hotspot is behind a firewall or uses an incompatible NAT type. Other times
	480	)))
	481
	482	(((
	483	it may be because of a router configuration or the internet is offline. This article aims to help resolve any issues
	484	)))
	485
	486	(((
	487	you may have.
	488	)))
	489
	490	(% style="text-align:center" %)
	491	[[image:1651828514449-658.png]]
	492
	493	(((
	494
	495	)))
	496
	497	(((
	498	Note: Please refer to more detailed Settings
	499	)))
	500
	501	(((
	502	[[https:~~/~~/docs.helium.com/troubleshooting/network-troubleshooting/>>url:https://docs.helium.com/troubleshooting/network-troubleshooting/]]
	503	)))
	504
	505	(((
	506	[[https:~~/~~/www.youtube.com/watch?v=GKusVC7ovrE>>url:https://www.youtube.com/watch?v=GKusVC7ovrE]]
	507	)))
	508
	509
	510	==== 3. Check the configuration of HP0D ====
	511
	512	===== 3.1 LoRa frequency configuration =====
	513
	514	(% style="text-align:center" %)
	515	[[image:1651828687205-178.png\|\|height="323" width="657"]]
	516
	517
	518
	519	===== 3.2 Check the LoRaWAN serveraddress =====
	520
	521
	522	(% style="text-align:center" %)
	523	[[image:1651828703680-156.png\|\|height="349" width="672"]]
	524
	525
59.1	526	===== 3.3 Check Miner configuration =====
51.1	527
59.1	528	(% style="text-align:center" %)
	529	[[image:image-20220506181408-1.png\|\|height="451" width="513"]]
51.1	530
59.1	531	~ Note: Check the Region and Height, the default height is greater than 1, if it is 1 please Click the mid
51.1	532
59.1	533	~ button of Update, and then wait 10mins to check here,
51.1	534
	535
59.1	536	==== 4. Installation of Antenna ====
51.1	537
59.1	538	(((
	539	HP0D use Fiber Glass Antenna.
	540	)))
51.1	541
59.1	542	(% style="text-align:center" %)
	543	[[image:1651832158606-882.png]]
51.1	544
59.1	545	(((
	546
	547	)))
51.1	548
59.1	549	(((
	550
	551	)))
51.1	552
59.1	553	(((
	554	User need to connect antenna cable’s SMA connector to the HP03 and connect N-Type connector
	555	)))
51.1	556
59.1	557	(((
	558	to antenna and install as below:
	559	)))
51.1	560
59.1	561	(((
	562	(% style="text-align:center" %)
	563	[[image:1651832205608-998.png\|\|height="349" width="198"]]
	564	)))
51.1	565
59.1	566	==== 5. SSH Access for Linux console ====
51.1	567
59.1	568	(((
	569	IP address: IP address of HP0D or hostname of HP0D (Such as dragino-63920a)
	570	)))
51.1	571
59.1	572	(((
	573	Port: 22
	574	)))
51.1	575
59.1	576	(((
	577	User Name: root
	578	)))
51.1	579
59.1	580	(((
	581	Password: Randomly generated （(% class="mark" %)found on device’s label(%%) ）
	582	)))
51.1	583
59.1	584	(((
	585
	586	)))
51.1	587
59.1	588	(((
	589	After logging in, you will be in the Linux console and can enter commands as shown below.
	590	)))
51.1	591
59.1	592	(% style="text-align:center" %)
	593	[[image:1651832284160-991.png]]
51.1	594
	595
	596
	597
59.1	598	==== 6. Trouble Shootings ====
51.1	599
59.1	600	===== 6.1 How to get a wallet address? =====
51.1	601
59.1	602	// // Download the helium Hotspots APP on the Apple or Google Play store to generate own wallet.
51.1	603
	604
59.1	605	===== 6.2 Onboarding ~-~- Unable to access Web-UI ~-~-> Miner =====
51.1	606
59.1	607	(((
	608	User can login the HP0D, able to access other Web Pages except miner page
	609	)))
51.1	610
59.1	611	(((
	612	If you first boot the device where you need to wait for 10 mins for initialization connection to Helium server.
	613	)))
51.1	614
	615
59.1	616	===== 6.3 Onboarding ~-~- Some parameters in miner page show timeout =====
51.1	617
59.1	618	(% style="text-align:center" %)
	619	[[image:image-20220506182042-2.png\|\|height="250" width="516"]]
51.1	620
59.1	621	(% style="text-align:center" %)
	622	[[image:1651832455372-647.png\|\|height="224" width="520"]]
51.1	623
	624
59.1	625	HP0D is establish connection to Helium server and not finished. And you might see above.
51.1	626
59.1	627	It might relate to the network where might up to 10mins
51.1	628
	629
59.1	630	===== 6.4 Onboarding – Bad Gaterway =====
51.1	631
59.1	632	(% style="text-align:center" %)
	633	[[image:1651832583790-633.png]]
51.1	634
59.1	635	This is caused by the process leads too long which just need to refresh the page.
51.1	636
	637
59.1	638	1.
51.1	639	11. Onboarding ~-~- Why did QR Code generate is aways fail?
	640
	641	[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image028.png]]
	642
	643	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
	644
	645
59.1	646	1.
51.1	647	11. Onboarding ~-~- Why is the QR Code not quite the same as the manual?
	648
	649	[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image029.png]]
	650
	651	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.
	652
	653
59.1	654	1.
51.1	655	11. Onboarding – MAC address is ‘Unknown’ after scan QR Code
	656
	657	[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image030.png]]
	658
	659	If you see the MAC Address shows the ‘Unknown’ where is due to the provision error, please contact us to help you solve.
	660
	661
59.1	662	1.
51.1	663	11. Onboarding – MAC address is being refreshed after scan QR Code
	664
	665	//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.//
	666
	667
	668	//If you don’t see MAC address, make sure your mobile has good internet connection.//
	669
	670	[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image031.png]]
	671
	672
	673
	674
	675	1.
	676	11. HP0D Web ~-~-> Miner ~-~-> Version shows ‘short’
	677
	678	//This is caused by the server connection delay, which does not affect the normal use.//
	679
	680	[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image032.png]]
	681
	682
	683	*
	684	*1. Mobile APP crash after scan the QR Code?
	685	* //Make sure you have input the correct Wallet address to generate QR Code.//
	686	* //Make sure your mobile app uses the same wallet address as the one to generate QR Code.//
	687	* //Make sure your mobile app’s relevant permission are enabled.//
	688	* //Known: The Android 11 version may cause this kind of issue.//
	689
59.1	690	1.
51.1	691	11. Why the frequency/region is not the same what I purchased?
	692
	693	//Each HP0D is inspected and configured prior to shipping.//
	694
	695	//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.//
	696
	697
59.1	698	1.
51.1	699	11. Can use the frequency to a region where is not support?
	700
	701	//Please make sure that the region supports this frequency, you can confirm the appropriate frequency through this link//
	702
	703	[[https:~~/~~/docs.helium.com/lorawan-on-helium/frequency-plans>>url:https://docs.helium.com/lorawan-on-helium/frequency-plans]]
	704
	705
59.1	706	1.
51.1	707	11. Can change the frequency of the HP0D Miner?
	708
	709	//We do not recommend doing this, it may damage your device//
	710
	711
	712
	713
	714
	715	1. Supports
	716
	717	//If you are experiencing issues and can’t solve, you can send mail to//
	718
	719	[[//support@dragino.com//>>mailto:support@dragino.com]]
	720
	721	//With your question as detail as possible. We will reply and help you in the shortest.//
	722
	723
	724
	725
	726	1. Order Info
	727
	728	HP0D-XXX
	729
	730	XXX: Frequency Band
	731
	732	* 868: For Bands: EU868,IN865
	733	* 915: For Bands: US915,AU915,AS923,KR920
	734
	735	1. Manufacturer Info
	736
	737	Shenzhen Dragino Technology Development co. LTD
	738
	739	Room 202, Block B, BCT Incubation Bases (BaoChengTai), No.8 CaiYunRoad
	740
	741	LongCheng Street, LongGang District ; Shenzhen 518116,China
	742
	743
	744	1. FCC Warning
	745
	746	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:
	747
	748	~-~- Reorient or relocate the receiving antenna.
	749
	750	~-~- Increase the separation between the equipment and receiver.
	751
	752	~-~- Connect the equipment into an outlet on a circuit different from that to which the receiver is connected.
	753
	754	~-~- Consult the dealer or an experienced radio/TV technician for help.
	755
	756
	757	Changes or modifications not expressly approved by the party responsible for compliance could void the user's authority to operate the equipment.
	758
	759
	760	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.

Wiki source code of HP0D

Applications

Navigation