Wiki source code of HP0D Full Hotspot for Helium

Version 74.15 by Xiaoling on 2022/05/14 15:29

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

Wiki source code of HP0D Full Hotspot for Helium

Applications

Navigation