Wiki source code of HP0D

Version 73.8 by Xiaoling on 2022/05/07 15:16

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