Wiki source code of HP0D Full Hotspot for Helium

Version 74.16 by Xiaoling on 2022/05/14 17:17

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

Wiki source code of HP0D Full Hotspot for Helium

Applications

Navigation