Wiki source code of HP0D

Version 73.2 by Xiaoling on 2022/05/07 14:26

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