Wiki source code of HP0D

Version 67.1 by Xiaoye on 2022/05/07 13:54

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
59.1	213	[[image:1651803959860-394.png\|\|height="500" width="375"]]
51.1	214
	215
	216
	217	(((
59.1	218	(((
51.1	219	~ Label information:
	220	)))
59.1	221	)))
51.1	222
	223	(((
59.1	224	(((
51.1	225
	226	)))
59.1	227	)))
51.1	228
	229	(((
59.1	230	(((
51.1	231	~ Device host name: (% class="mark" %)dragino-xxxxxx
	232	)))
59.1	233	)))
51.1	234
	235	(((
59.1	236	(((
51.1	237	~ Band: US915/AU915/AS923_1-AS923_4/KR920/EU868/IN865/RU864
	238	)))
59.1	239	)))
51.1	240
	241	(((
59.1	242	(((
51.1	243	~ Miner animal name: xxx-xxx-xxx
	244	)))
59.1	245	)))
51.1	246
	247	(((
59.1	248	(((
51.1	249	~ Miner address: 112xxxxxx
	250	)))
59.1	251	)))
51.1	252
	253	(((
59.1	254	(((
51.1	255	~ Eth MAC address: A8: 40: 41: EF: FE: CD
	256	)))
59.1	257	)))
51.1	258
	259	(((
59.1	260	(((
51.1	261	~ Login: root/d59f2d5b ((% class="mark" %)the root is the Login account for the Web-UI and SSH.(%%))
	262	)))
59.1	263	)))
51.1	264
	265	(((
59.1	266	(((
51.1	267	~ SN: device serial number.
	268	)))
59.1	269	)))
51.1	270
	271
	272	==== 2. Quick Start & Onboarding ====
	273
	274	(((
	275	(((
66.1	276	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	277	)))
	278	)))
	279
	280	(% class="wikigeneratedid" id="H-2" %)
	281	(((
	282
	283	)))
	284
	285	===== 2.1 Connect HP0D Web UI =====
	286
	287	====== 2.1.1 via HP0D’s Access Point. ======
	288
	289	(((
59.1	290	(((
65.2	291	At the first boot of HP0D, it will auto generate a Wi-Fi network
	292
	293	[[image:1651804327535-321.png\|\|height="325" width="199"]]
51.1	294	)))
59.1	295	)))
51.1	296
	297	(((
59.1	298	(((
51.1	299
	300	)))
59.1	301	)))
51.1	302
	303	(((
59.1	304	(((
65.2	305	(% class="box infomessage" %)
	306	(((
51.1	307	called : //HPD-dragino-xxxxxx//
	308	)))
59.1	309	)))
65.2	310	)))
51.1	311
	312	(((
59.1	313	(((
65.2	314	(% class="box infomessage" %)
	315	(((
51.1	316	with password: //dragino+dragino//
	317	)))
59.1	318	)))
65.2	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
	333	(((
59.1	334	(((
66.1	335	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
51.1	336	)))
59.1	337	)))
51.1	338
59.1	339	[[image:1651804397792-591.png\|\|height="402" width="763"]]
51.1	340
	341
	342
	343	====== 2.1.2 Connect via HP0D hostname ======
	344
59.1	345	(((
51.1	346	Connect the HP0D Ethernet port to your router and HP0D will obtain an IP address. If your
59.1	347	)))
51.1	348
59.1	349	(((
51.1	350	PC(Windows/Mac/Ubuntu) connect the same network with the HP0D, you can access the HP0D
59.1	351	)))
51.1	352
59.1	353	(((
51.1	354	Web-UI via HP0D’s hostname.
59.1	355	)))
51.1	356
	357
	358	Like: __//http:~/~/dragino-4ba54a//__
	359
	360
	361	(% style="text-align:center" %)
	362	[[image:1651804629009-699.png]]
	363
	364
	365	====== 2.1.3 Connect via Ethernet Port ======
	366
	367	(((
59.1	368	(((
51.1	369	Connect the HP0D Ethernet port to your router and HP0D will obtain an IP address from your router. In the
	370	)))
59.1	371	)))
51.1	372
	373	(((
59.1	374	(((
51.1	375	router’s management portal, you should be able to find what IP address the router has assigned to the HP0D.
	376	)))
59.1	377	)))
51.1	378
	379	(((
	380
	381	)))
	382
59.1	383	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	384
59.1	385	or SSH access of HP0D.
	386
51.1	387	(% style="text-align:center" %)
	388	[[image:1651804782523-623.png]]
	389
	390
	391
	392	===== 2.2 Generate QR Code =====
	393
	394	(((
	395	Go to Miner ~-~-> QR Generate, input your Helium Wallet Address, and click Generate.
	396	)))
	397
	398	(((
	399	Note: After onboarding, this wallet will become owner of this hotspot.
	400	)))
	401
	402	(% style="text-align:center" %)
59.1	403	[[image:image-20220506140312-1.png\|\|height="435" width="438"]]
51.1	404
	405
	406	===== 2.3 Onboarding Hotspot =====
	407
	408	(((
	409	~1. Download the Helium Hotspot APP from the Apple or Google Play store.
	410	)))
	411
	412	(((
	413	Note: the APP version need to be greater than 3.11.
	414	)))
	415
	416	(((
	417
	418	)))
	419
	420	(((
	421	2. To add a hotspot, select “Hotspot”. On this tab, click the ‘+ Add Hotspot’ in the mid where choose
	422	)))
	423
	424	(((
	425	the ‘DRAGINO Miner HP0D’
	426	)))
	427
	428	[[image:1651817186037-899.png\|\|height="429" width="206"]] [[image:1651817194458-938.png\|\|height="434" width="203"]]
	429
	430	3. Scan the QR Code you generated in the previous step.
	431
	432	(% style="text-align:center" %)
	433	[[image:1651828211026-220.png\|\|height="405" width="191"]]
	434
	435	4. Onboarding your device
	436
	437	Mobile APP will get info from onboarding server. If MAC address doesn’t appear, it means the network connection of
	438
	439	mobile to onboarding server might have issue.
	440
	441	[[image:image-20220506141159-2.png\|\|height="426" width="204"]] [[image:1651817529289-461.png\|\|height="423" width="199"]]
	442
	443	[[image:1651828250802-391.png\|\|height="437" width="205"]] [[image:1651828262668-768.png\|\|height="433" width="204"]]
	444
	445
	446	5. Check onboarding status
	447
	448	You can check from mobile:
	449
	450	[[image:1651828391664-884.png\|\|height="413" width="197"]] [[image:1651828401011-970.png\|\|height="412" width="193"]]
	451
	452	You can also see the hotspot status in below link:
	453
	454	https:~/~/explorer.helium.com/hotspots///<(% class="mark" %)YOUR_HOTSPORT_KEY(%%)>//
	455
	456	Example:
	457
	458	Green Synced means hotspot works normal.
	459
	460	(% style="text-align:center" %)
	461	[[image:1651828427715-679.png\|\|height="374" width="635"]]
	462
	463
	464	===== 2.4 Set the Port Forwarding =====
	465
	466	(((
	467	Helium Hotspots may not work if the Hotspot is behind a firewall or uses an incompatible NAT type. Other times
	468	)))
	469
	470	(((
	471	it may be because of a router configuration or the internet is offline. This article aims to help resolve any issues
	472	)))
	473
	474	(((
	475	you may have.
	476	)))
	477
	478	(% style="text-align:center" %)
	479	[[image:1651828514449-658.png]]
	480
	481	(((
	482
	483	)))
	484
	485	(((
	486	Note: Please refer to more detailed Settings
	487	)))
	488
	489	(((
	490	[[https:~~/~~/docs.helium.com/troubleshooting/network-troubleshooting/>>url:https://docs.helium.com/troubleshooting/network-troubleshooting/]]
	491	)))
	492
	493	(((
	494	[[https:~~/~~/www.youtube.com/watch?v=GKusVC7ovrE>>url:https://www.youtube.com/watch?v=GKusVC7ovrE]]
	495	)))
	496
	497
	498	==== 3. Check the configuration of HP0D ====
	499
	500	===== 3.1 LoRa frequency configuration =====
	501
	502	(% style="text-align:center" %)
	503	[[image:1651828687205-178.png\|\|height="323" width="657"]]
	504
	505
	506
	507	===== 3.2 Check the LoRaWAN serveraddress =====
	508
	509
	510	(% style="text-align:center" %)
	511	[[image:1651828703680-156.png\|\|height="349" width="672"]]
	512
	513
59.1	514	===== 3.3 Check Miner configuration =====
51.1	515
59.1	516	(% style="text-align:center" %)
	517	[[image:image-20220506181408-1.png\|\|height="451" width="513"]]
51.1	518
59.1	519	~ Note: Check the Region and Height, the default height is greater than 1, if it is 1 please Click the mid
51.1	520
59.1	521	~ button of Update, and then wait 10mins to check here,
51.1	522
	523
59.1	524	==== 4. Installation of Antenna ====
51.1	525
59.1	526	(((
	527	HP0D use Fiber Glass Antenna.
	528	)))
51.1	529
59.1	530	(% style="text-align:center" %)
	531	[[image:1651832158606-882.png]]
51.1	532
59.1	533	(((
	534
	535	)))
51.1	536
59.1	537	(((
	538
	539	)))
51.1	540
59.1	541	(((
	542	User need to connect antenna cable’s SMA connector to the HP03 and connect N-Type connector
	543	)))
51.1	544
59.1	545	(((
	546	to antenna and install as below:
	547	)))
51.1	548
59.1	549	(((
	550	(% style="text-align:center" %)
	551	[[image:1651832205608-998.png\|\|height="349" width="198"]]
	552	)))
51.1	553
59.1	554	==== 5. SSH Access for Linux console ====
51.1	555
59.1	556	(((
	557	IP address: IP address of HP0D or hostname of HP0D (Such as dragino-63920a)
	558	)))
51.1	559
59.1	560	(((
	561	Port: 22
	562	)))
51.1	563
59.1	564	(((
	565	User Name: root
	566	)))
51.1	567
59.1	568	(((
	569	Password: Randomly generated （(% class="mark" %)found on device’s label(%%) ）
	570	)))
51.1	571
59.1	572	(((
	573
	574	)))
51.1	575
59.1	576	(((
	577	After logging in, you will be in the Linux console and can enter commands as shown below.
	578	)))
51.1	579
59.1	580	(% style="text-align:center" %)
	581	[[image:1651832284160-991.png]]
51.1	582
	583
67.1	584	==== 6. How to change the Wireless function of HP0D ====
51.1	585
67.1	586	The wireless function is configured as AP by default and the web page does not support configuration,
51.1	587
67.1	588	if you want to configure it as client connection mode, you need to configure it manually in Linux CIL.
51.1	589
67.1	590	6.1 Access the Linux console.
51.1	591
67.1	592
	593	6.2 Install the package of network-manager.
	594
	595
	596	6.3 Reboot the device.
	597
	598
	599	6.4 Check the wireless type
	600
	601
	602	6.5 Connect the WiFi.
	603
	604
	605	==== 7. Trouble Shootings ====
	606
	607	===== 7.1 How to get a wallet address? =====
	608
59.1	609	// // Download the helium Hotspots APP on the Apple or Google Play store to generate own wallet.
51.1	610
	611
67.1	612	===== 7.2 Onboarding ~-~- Unable to access Web-UI ~-~-> Miner =====
51.1	613
59.1	614	(((
	615	User can login the HP0D, able to access other Web Pages except miner page
	616	)))
51.1	617
59.1	618	(((
	619	If you first boot the device where you need to wait for 10 mins for initialization connection to Helium server.
	620	)))
51.1	621
	622
67.1	623	===== 7.3 Onboarding ~-~- Some parameters in miner page show timeout =====
51.1	624
59.1	625	(% style="text-align:center" %)
	626	[[image:image-20220506182042-2.png\|\|height="250" width="516"]]
51.1	627
59.1	628	(% style="text-align:center" %)
	629	[[image:1651832455372-647.png\|\|height="224" width="520"]]
51.1	630
	631
59.1	632	HP0D is establish connection to Helium server and not finished. And you might see above.
51.1	633
59.1	634	It might relate to the network where might up to 10mins
51.1	635
	636
67.1	637	===== 7.4 Onboarding – Bad Gaterway =====
51.1	638
59.1	639	(% style="text-align:center" %)
	640	[[image:1651832583790-633.png]]
51.1	641
59.1	642	This is caused by the process leads too long which just need to refresh the page.
51.1	643
	644
67.1	645	7.5 Onboarding ~-~- Why did QR Code generate is aways fail?
51.1	646
65.1	647	(% style="text-align:center" %)
	648	[[image:image-20220506182424-3.png]]
51.1	649
65.1	650	This may be related to the current block height, if the device is synchronizing to the latest height or if the
51.1	651
65.1	652	device block height is much lower than the current height as the above picture like '1 1', the QR code
51.1	653
65.1	654	generation may fail.
51.1	655
	656
67.1	657	===== 7.6 Onboarding ~-~- Why is the QR Code not quite the same as the manual? =====
51.1	658
65.1	659	(% style="text-align:center" %)
	660	[[image:1651832742262-209.png\|\|height="297" width="365"]]
51.1	661
65.1	662	Please ensure that you enter the correct wallet address and that your network is up and running, the user can
51.1	663
65.1	664	click the button of ‘Clean’ to re-generate the QR Code.
51.1	665
	666
67.1	667	===== 7.7 Onboarding – MAC address is ‘Unknown’ after scan QR Code =====
51.1	668
65.1	669	(% style="text-align:center" %)
	670	[[image:1651832811038-780.png\|\|height="462" width="216"]]
51.1	671
65.1	672	If you see the MAC Address shows the ‘Unknown’ where is due to the provision error,
51.1	673
65.1	674	please contact us to help you solve.
51.1	675
	676
67.1	677	===== 7.8 Onboarding – MAC address is being refreshed after scan QR Code =====
51.1	678
65.1	679	// // After scan QR Code, Mobile APP will connect Helium onboarding server and provide the
51.1	680
65.1	681	public key/ wallet address to onboarding server. Server will return the match MAC address
51.1	682
65.1	683	for this hotspot.
51.1	684
	685
65.1	686	If you don’t see MAC address, make sure your mobile has good internet connection.
51.1	687
65.1	688	(% style="text-align:center" %)
	689	[[image:1651832880009-473.png]]
51.1	690
	691
67.1	692	===== 7.9 HP0D Web ~-~-> Miner ~-~-> Version shows ‘short’ =====
51.1	693
65.1	694	This is caused by the server connection delay, which does not affect the normal use.
	695
	696
	697	(% style="text-align:center" %)
	698	[[image:1651832959907-357.png]]
	699
67.1	700	===== 7.10 Mobile APP crash after scan the QR Code? =====
65.1	701
	702	* Make sure you have input the correct Wallet address to generate QR Code.
	703	* Make sure your mobile app uses the same wallet address as the one to generate QR Code.
	704	* Make sure your mobile app’s relevant permission are enabled.
	705	* Known: The Android 11 version may cause this kind of issue.
	706
67.1	707	1.
51.1	708	11. Why the frequency/region is not the same what I purchased?
	709
	710	//Each HP0D is inspected and configured prior to shipping.//
	711
	712	//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.//
	713
	714
67.1	715	1.
51.1	716	11. Can use the frequency to a region where is not support?
	717
	718	//Please make sure that the region supports this frequency, you can confirm the appropriate frequency through this link//
	719
	720	[[https:~~/~~/docs.helium.com/lorawan-on-helium/frequency-plans>>url:https://docs.helium.com/lorawan-on-helium/frequency-plans]]
	721
	722
67.1	723	1.
51.1	724	11. Can change the frequency of the HP0D Miner?
	725
	726	//We do not recommend doing this, it may damage your device//
	727
	728
	729
	730
	731
	732	1. Supports
	733
	734	//If you are experiencing issues and can’t solve, you can send mail to//
	735
	736	[[//support@dragino.com//>>mailto:support@dragino.com]]
	737
	738	//With your question as detail as possible. We will reply and help you in the shortest.//
	739
	740
	741
	742
	743	1. Order Info
	744
	745	HP0D-XXX
	746
	747	XXX: Frequency Band
	748
	749	* 868: For Bands: EU868,IN865
	750	* 915: For Bands: US915,AU915,AS923,KR920
	751
	752	1. Manufacturer Info
	753
	754	Shenzhen Dragino Technology Development co. LTD
	755
	756	Room 202, Block B, BCT Incubation Bases (BaoChengTai), No.8 CaiYunRoad
	757
	758	LongCheng Street, LongGang District ; Shenzhen 518116,China
	759
	760
	761	1. FCC Warning
	762
	763	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:
	764
	765	~-~- Reorient or relocate the receiving antenna.
	766
	767	~-~- Increase the separation between the equipment and receiver.
	768
	769	~-~- Connect the equipment into an outlet on a circuit different from that to which the receiver is connected.
	770
	771	~-~- Consult the dealer or an experienced radio/TV technician for help.
	772
	773
	774	Changes or modifications not expressly approved by the party responsible for compliance could void the user's authority to operate the equipment.
	775
	776
	777	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