Wiki source code of HP0D Full Hotspot for Helium User Manual
Show last authors
| author | version | line-number | content |
|---|---|---|---|
| 1 | (% style="text-align:center" %) | ||
| 2 | [[image:1651802206983-860.png||height="427" width="398"]] | ||
| 3 | |||
| 4 | |||
| 5 | ((( | ||
| 6 | |||
| 7 | |||
| 8 | |||
| 9 | ))) | ||
| 10 | |||
| 11 | **Table of Contents：** | ||
| 12 | |||
| 13 | {{toc/}} | ||
| 14 | |||
| 15 | |||
| 16 | = **1. Introduction** = | ||
| 17 | |||
| 18 | == **1.1 What is HP0D** == | ||
| 19 | |||
| 20 | |||
| 21 | ((( | ||
| 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. | ||
| 23 | ))) | ||
| 24 | |||
| 25 | ((( | ||
| 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**. | ||
| 27 | ))) | ||
| 28 | |||
| 29 | ((( | ||
| 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. | ||
| 31 | ))) | ||
| 32 | |||
| 33 | ((( | ||
| 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. | ||
| 35 | |||
| 36 | |||
| 37 | ))) | ||
| 38 | |||
| 39 | == **1.2 Specifications** == | ||
| 40 | |||
| 41 | **~ Hardware System:** | ||
| 42 | Linux Part: | ||
| 43 | |||
| 44 | * Raspberry Pi 4 | ||
| 45 | |||
| 46 | **~ Interface:** | ||
| 47 | |||
| 48 | * 10M/100M RJ45 Ports x 1 | ||
| 49 | * LoRaWAN Wireless | ||
| 50 | * Power Input: 12V 2A, DC | ||
| 51 | |||
| 52 | **~ Operating Condition:** | ||
| 53 | |||
| 54 | * Work Temperature: -20 ~~ 65°C | ||
| 55 | * Storage Temperature: -20 ~~ 65°C | ||
| 56 | * Power Input: 12V 2A, DC | ||
| 57 | |||
| 58 | |||
| 59 | |||
| 60 | == **1.3 Features** == | ||
| 61 | |||
| 62 | * Open-Source Linux system | ||
| 63 | * RPi4 with 2G /4G or 8G RAM | ||
| 64 | * Managed by Web GUI, SSH via Internet | ||
| 65 | * Support Semtech UDP packet forwarder | ||
| 66 | * Support LoRaWAN Station Connection | ||
| 67 | * Support Helium Miner | ||
| 68 | * External fiberglass antenna | ||
| 69 | * Firmware OTA | ||
| 70 | * 802.3af PoE | ||
| 71 | * Lighting Protection | ||
| 72 | * Remote Monitoring | ||
| 73 | * Support Helium LoRaWAN server and secondary LoRaWAN server | ||
| 74 | * Include prepaid $40 onboarding cost and $10 location cost. | ||
| 75 | * [[Remote.it remote management>>url:https://wiki.dragino.com/index.php?title=Reverse_SSH_Access#Use_Remote.it_service]]. | ||
| 76 | |||
| 77 | |||
| 78 | |||
| 79 | == **1.4 Label info and login name** == | ||
| 80 | |||
| 81 | |||
| 82 | [[image:1651803959860-394.png||height="500" width="375"]] | ||
| 83 | |||
| 84 | |||
| 85 | |||
| 86 | === 1.4.1 Label information: === | ||
| 87 | |||
| 88 | |||
| 89 | **Device hostname:** (% class="mark" %)dragino-xxxxxx(%%) | ||
| 90 | **Band**: (% class="mark" %)US915/AU915/AS923_1-AS923_4/KR920/EU868/IN865/RU864(%%) | ||
| 91 | **Miner animal name**: (% class="mark" %)xxx-xxx-xxx(%%) | ||
| 92 | **Miner address**: (% class="mark" %)12xxxxxx(%%) | ||
| 93 | **Eth MAC address**: (% class="mark" %)A8: 40: 41: EF: FE: CD(%%) | ||
| 94 | **Login**: (% class="mark" %)root/d59f2d5b (the root is the Login account for the Web-UI and SSH.)(%%) | ||
| 95 | **SN**: (% class="mark" %)device serial number. | ||
| 96 | |||
| 97 | |||
| 98 | |||
| 99 | = **2. Quick Start & Onboarding** = | ||
| 100 | |||
| 101 | |||
| 102 | 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. | ||
| 103 | |||
| 104 | |||
| 105 | == **2.1 Connect HP0D Web UI** == | ||
| 106 | |||
| 107 | |||
| 108 | === **2.1.1 via HP0D's Access Point** === | ||
| 109 | |||
| 110 | |||
| 111 | At the first boot of HP0D, it will auto-generate a Wi-Fi network | ||
| 112 | |||
| 113 | |||
| 114 | [[image:1651804327535-321.png||height="325" width="199"]] | ||
| 115 | |||
| 116 | |||
| 117 | (% class="box infomessage" %) | ||
| 118 | ((( | ||
| 119 | called : **//HPD-dragino-xxxxxx//** | ||
| 120 | ))) | ||
| 121 | |||
| 122 | (% class="box infomessage" %) | ||
| 123 | ((( | ||
| 124 | with password: **//dragino+dragino//** | ||
| 125 | 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 | ||
| 126 | ))) | ||
| 127 | |||
| 128 | |||
| 129 | [[image:1651804397792-591.png||height="386" width="733"]] | ||
| 130 | |||
| 131 | |||
| 132 | |||
| 133 | === **2.1.2 Connect via HP0D hostname** === | ||
| 134 | |||
| 135 | |||
| 136 | Connect the HP0D Ethernet port to your router and HP0D will obtain an IP address. If your PC(Windows/Mac/Ubuntu) connects to the same network with the HP0D, you can access the HP0D Web-UI via HP0D’s hostname. | ||
| 137 | |||
| 138 | Like: (% class="mark" %)__**//http:~/~/dragino-4ba54a//**__ | ||
| 139 | |||
| 140 | |||
| 141 | [[image:1651804629009-699.png]] | ||
| 142 | |||
| 143 | |||
| 144 | |||
| 145 | === **2.1.3 Connect via Ethernet Port** === | ||
| 146 | |||
| 147 | |||
| 148 | //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.// | ||
| 149 | |||
| 150 | |||
| 151 | //**If you get the IP address from the router, like: (% class="mark" %)10.130.2.42(%%), you can use this IP address to connect the WEB UI or SSH access of HP0D.**// | ||
| 152 | |||
| 153 | |||
| 154 | [[image:1651804782523-623.png]] | ||
| 155 | |||
| 156 | |||
| 157 | |||
| 158 | == **2.2 Generate QR Code** == | ||
| 159 | |||
| 160 | |||
| 161 | ((( | ||
| 162 | //Go to (% style="color:#037691" %)**Miner** ~-~-> **QR Generate**(%%), input your Helium Wallet Address, and click Generate.// | ||
| 163 | ))) | ||
| 164 | |||
| 165 | ((( | ||
| 166 | (% style="color:red" %)**//Note: After onboarding, this wallet will become the owner of this hotspot.//** | ||
| 167 | |||
| 168 | |||
| 169 | ))) | ||
| 170 | |||
| 171 | [[image:image-20220506140312-1.png||height="435" width="438"]] | ||
| 172 | |||
| 173 | |||
| 174 | |||
| 175 | == **2.3 Onboarding Hotspot** == | ||
| 176 | |||
| 177 | |||
| 178 | ((( | ||
| 179 | //**1.** Download the Helium Hotspot APP from the Apple or Google Play store.// | ||
| 180 | ))) | ||
| 181 | |||
| 182 | ((( | ||
| 183 | (% style="color:red" %)**//Note: the APP version needs to be greater than 3.11.//** | ||
| 184 | |||
| 185 | |||
| 186 | ))) | ||
| 187 | |||
| 188 | ((( | ||
| 189 | //**2. **To add a hotspot, select (% style="color:blue" %)**“Hotspot”**(%%). On this tab, click the** (% style="color:blue" %)“+ Add Hotspot"(%%)** in the mid where choose the (% style="color:blue" %)**"DRAGINO Miner HP0D"**// | ||
| 190 | |||
| 191 | |||
| 192 | ))) | ||
| 193 | |||
| 194 | [[image:1651817186037-899.png||height="429" width="206"]] [[image:1651817194458-938.png||height="434" width="203"]] | ||
| 195 | |||
| 196 | |||
| 197 | |||
| 198 | //**3. **Scan the QR Code you generated in the previous step.// | ||
| 199 | |||
| 200 | [[image:1651828211026-220.png||height="405" width="191"]] | ||
| 201 | |||
| 202 | |||
| 203 | |||
| 204 | ((( | ||
| 205 | //**4. **Onboarding your device// | ||
| 206 | ))) | ||
| 207 | |||
| 208 | ((( | ||
| 209 | Mobile APP will get info from the onboarding server. If the MAC address doesn’t appear, it means the network connection of the mobile to the onboarding server might have an issue. | ||
| 210 | |||
| 211 | |||
| 212 | ))) | ||
| 213 | |||
| 214 | [[image:image-20220506141159-2.png||height="422" width="202"]] [[image:1651817529289-461.png||height="423" width="199"]] | ||
| 215 | |||
| 216 | [[image:1651828250802-391.png||height="421" width="197"]] [[image:1651828262668-768.png||height="416" width="196"]](% style="display:none" %) | ||
| 217 | |||
| 218 | |||
| 219 | **5. **//Check onboarding status where you can check from mobile~:// | ||
| 220 | |||
| 221 | [[image:1651828391664-884.png||height="413" width="197"]] [[image:1651828401011-970.png||height="412" width="193"]](% style="display:none" %) | ||
| 222 | |||
| 223 | |||
| 224 | //You can also see the hotspot status in the below link~:// | ||
| 225 | |||
| 226 | //https:~/~/explorer.helium.com/hotspots/**<(% class="mark" %)YOUR_HOTSPORT_KEY(%%)>**// | ||
| 227 | |||
| 228 | //Example~:// | ||
| 229 | |||
| 230 | |||
| 231 | **//Green Synced means hotspot works normally.//** | ||
| 232 | |||
| 233 | [[image:1651828427715-679.png||height="374" width="635"]] | ||
| 234 | |||
| 235 | |||
| 236 | == **2.4 Set the Port Forwarding** == | ||
| 237 | |||
| 238 | |||
| 239 | ((( | ||
| 240 | //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.// | ||
| 241 | ))) | ||
| 242 | |||
| 243 | [[image:1651828514449-658.png]] | ||
| 244 | |||
| 245 | ((( | ||
| 246 | |||
| 247 | ))) | ||
| 248 | |||
| 249 | ((( | ||
| 250 | Note: Please refer to more detailed Settings | ||
| 251 | ))) | ||
| 252 | |||
| 253 | ((( | ||
| 254 | [[https:~~/~~/docs.helium.com/troubleshooting/network-troubleshooting/>>url:https://docs.helium.com/troubleshooting/network-troubleshooting/]] | ||
| 255 | ))) | ||
| 256 | |||
| 257 | ((( | ||
| 258 | [[https:~~/~~/www.youtube.com/watch?v=GKusVC7ovrE>>url:https://www.youtube.com/watch?v=GKusVC7ovrE]] | ||
| 259 | |||
| 260 | |||
| 261 | ))) | ||
| 262 | |||
| 263 | = **3. Check the configuration of HP0D** = | ||
| 264 | |||
| 265 | == **3.1 LoRa frequency configuration** == | ||
| 266 | |||
| 267 | |||
| 268 | [[image:1651828687205-178.png||height="323" width="657"]] | ||
| 269 | |||
| 270 | |||
| 271 | == **3.2 Check the LoRaWAN Server Address** == | ||
| 272 | |||
| 273 | |||
| 274 | [[image:image-20220607160428-1.png||height="472" width="654"]] | ||
| 275 | |||
| 276 | |||
| 277 | == **3.2.1 Configure the Secondary LoRaWAN Server** == | ||
| 278 | |||
| 279 | [[image:image-20220607161130-2.png||height="501" width="1112"]] | ||
| 280 | |||
| 281 | |||
| 282 | [[image:image-20220607161603-3.png||height="557" width="1113"]] | ||
| 283 | |||
| 284 | |||
| 285 | [[image:image-20220607161812-4.png||height="699" width="1115"]] | ||
| 286 | |||
| 287 | |||
| 288 | |||
| 289 | |||
| 290 | == **3.3 Check Miner configuration** == | ||
| 291 | |||
| 292 | |||
| 293 | [[image:image-20220506181408-1.png||height="451" width="513"]] | ||
| 294 | |||
| 295 | ((( | ||
| 296 | //**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.**// | ||
| 297 | |||
| 298 | |||
| 299 | == **//3.4 Check the Miner state//** == | ||
| 300 | |||
| 301 | |||
| 302 | [[image:image-20220531171836-9.png||height="776" width="1155"]] | ||
| 303 | |||
| 304 | |||
| 305 | //**Note: Absorption status can show whether the hotspot is working properly**// | ||
| 306 | |||
| 307 | //** The p2p network can see how your hotspot is interacting with the surrounding hotspots**// | ||
| 308 | |||
| 309 | //usually, the nat_type should be '**none'**// | ||
| 310 | |||
| 311 | |||
| 312 | ))) | ||
| 313 | |||
| 314 | = **4. Installation of Antenna** = | ||
| 315 | |||
| 316 | |||
| 317 | ((( | ||
| 318 | //HP0D uses Fiber Glass Antenna.// | ||
| 319 | ))) | ||
| 320 | |||
| 321 | [[image:1651832158606-882.png]] | ||
| 322 | |||
| 323 | ((( | ||
| 324 | |||
| 325 | ))) | ||
| 326 | |||
| 327 | ((( | ||
| 328 | //The user needs to connect the antenna cable’s SMA connector to the HP03 and connect the N-Type connector to the antenna and install it as below~:// | ||
| 329 | ))) | ||
| 330 | |||
| 331 | ((( | ||
| 332 | [[image:1651832205608-998.png||height="349" width="198"]] | ||
| 333 | |||
| 334 | |||
| 335 | ))) | ||
| 336 | |||
| 337 | = **5. SSH Access for Linux console** = | ||
| 338 | |||
| 339 | |||
| 340 | //Connect the HP0D Ethernet port to your router and HP0D will obtain an IP address from your router.// | ||
| 341 | |||
| 342 | //In the router's management portal, you should be able to find what IP address the router has assigned to the HP0D.// | ||
| 343 | |||
| 344 | //You can use this IP or hostname of HP0D to connect the WEB UI or SSH access of HP0D.// | ||
| 345 | |||
| 346 | //Make sure your PC and the HP0D are in the same network, the use an SSH tool (such as **[[putty>>url:http://www.chiark.greenend.org.uk/~~sgtatham/putty/download.html]]**) to access it.// | ||
| 347 | |||
| 348 | |||
| 349 | Below are screenshots: | ||
| 350 | |||
| 351 | [[image:image-20220608202027-1.png]] | ||
| 352 | |||
| 353 | ((( | ||
| 354 | **//IP address: IP address of HP0D or hostname of HP0D ((% class="mark" %)Such as dragino-7df4af(%%))//** | ||
| 355 | ))) | ||
| 356 | |||
| 357 | ((( | ||
| 358 | //Port: 22// | ||
| 359 | ))) | ||
| 360 | |||
| 361 | ((( | ||
| 362 | //User Name: (% style="color:green" %)**root**// | ||
| 363 | ))) | ||
| 364 | |||
| 365 | ((( | ||
| 366 | //Password: (% style="color:green" %)**Randomly generated （found on device’s label）**// | ||
| 367 | |||
| 368 | |||
| 369 | ))) | ||
| 370 | |||
| 371 | ((( | ||
| 372 | //After logging in, you will be in the Linux console and can enter commands as shown below.// | ||
| 373 | |||
| 374 | |||
| 375 | ))) | ||
| 376 | |||
| 377 | [[image:image-20220608202118-2.png]] | ||
| 378 | |||
| 379 | |||
| 380 | = **6. How to change the Wireless function of HP0D** = | ||
| 381 | |||
| 382 | //The wireless function is configured as AP by default and the web page does not support configuration,// | ||
| 383 | |||
| 384 | //if you want to configure it as STA(client)connection mode,// | ||
| 385 | |||
| 386 | //you can configure your WiFi info on the** /Network/WiFi **page.// | ||
| 387 | |||
| 388 | |||
| 389 | **//Note: the wireless state is as AP//** | ||
| 390 | |||
| 391 | [[image:image-20220531170243-5.png||height="469" width="967"]] | ||
| 392 | |||
| 393 | |||
| 394 | == **6.1 Access WiFi configuration page** == | ||
| 395 | |||
| 396 | |||
| 397 | [[image:image-20220531165803-2.png]] | ||
| 398 | |||
| 399 | |||
| 400 | == **6.2 Enter your WiFi information and save** == | ||
| 401 | |||
| 402 | |||
| 403 | [[image:image-20220531165958-3.png]] | ||
| 404 | |||
| 405 | |||
| 406 | == **6.3 Change the WiFi mode.** == | ||
| 407 | |||
| 408 | |||
| 409 | [[image:image-20220531170131-4.png]] | ||
| 410 | |||
| 411 | == **6.4 Wait system to restart** == | ||
| 412 | |||
| 413 | |||
| 414 | [[image:image-20220531170501-7.png]] | ||
| 415 | |||
| 416 | |||
| 417 | //**Note: When the time remaining is finished it will turn to the home page.**// | ||
| 418 | |||
| 419 | |||
| 420 | == **6.5 Check the STA state** == | ||
| 421 | |||
| 422 | |||
| 423 | [[image:image-20220531170705-8.png||height="484" width="990"]] | ||
| 424 | |||
| 425 | |||
| 426 | = **7. Trouble Shootings** = | ||
| 427 | |||
| 428 | == **7.1 How to get a wallet address?** == | ||
| 429 | |||
| 430 | |||
| 431 | **//Download the helium Hotspots APP on the Apple or Google Play store to generate your own wallet.//** | ||
| 432 | |||
| 433 | |||
| 434 | == **7.2 Onboarding ~-~- Unable to access Web-UI ~-~-> Miner** == | ||
| 435 | |||
| 436 | |||
| 437 | ((( | ||
| 438 | //Users can log in to the HP0D, able to access other Web Pages except for the miner page.// | ||
| 439 | ))) | ||
| 440 | |||
| 441 | ((( | ||
| 442 | //If you first boot the device where you need to wait for 10 mins for the initialization connection to the Helium server.// | ||
| 443 | |||
| 444 | |||
| 445 | ))) | ||
| 446 | |||
| 447 | == **7.3 Onboarding ~-~- Some parameters on the miner page show timeout** == | ||
| 448 | |||
| 449 | |||
| 450 | [[image:image-20220506182042-2.png||height="250" width="516"]] | ||
| 451 | |||
| 452 | [[image:1651832455372-647.png||height="224" width="520"]] | ||
| 453 | |||
| 454 | |||
| 455 | **//HP0D is establishing a connection to the Helium server and is not finished. And you might see above.//** | ||
| 456 | |||
| 457 | **//It might relate to the network which might be up to 10mins.//** | ||
| 458 | |||
| 459 | |||
| 460 | == **7.4 Onboarding – Bad Gateway** == | ||
| 461 | |||
| 462 | |||
| 463 | [[image:1651832583790-633.png]] | ||
| 464 | |||
| 465 | |||
| 466 | //**This is caused by the process leading too long which just needs to refresh the page.**// | ||
| 467 | |||
| 468 | |||
| 469 | == **7.5 Onboarding ~-~- Why did QR Code generate aways fail?** == | ||
| 470 | |||
| 471 | |||
| 472 | [[image:image-20220506182424-3.png]] | ||
| 473 | |||
| 474 | |||
| 475 | ((( | ||
| 476 | //**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.**// | ||
| 477 | |||
| 478 | |||
| 479 | ))) | ||
| 480 | |||
| 481 | == **7.6 Onboarding ~-~- Why is the QR Code not quite the same as the manual?** == | ||
| 482 | |||
| 483 | [[image:1651832742262-209.png||height="297" width="365"]] | ||
| 484 | |||
| 485 | |||
| 486 | ((( | ||
| 487 | //**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.**// | ||
| 488 | |||
| 489 | |||
| 490 | ))) | ||
| 491 | |||
| 492 | == **7.7 Onboarding – MAC address is ‘Unknown’ after scan QR Code** == | ||
| 493 | |||
| 494 | |||
| 495 | [[image:1651832811038-780.png||height="462" width="216"]] | ||
| 496 | |||
| 497 | |||
| 498 | ((( | ||
| 499 | //**If you see the MAC Address shows the ‘Unknown’ where is due to the provisioning error, please contact us to help you solve it.**// | ||
| 500 | |||
| 501 | |||
| 502 | ))) | ||
| 503 | |||
| 504 | == 7.8 Onboarding – MAC address is being refreshed after scanning the QR Code == | ||
| 505 | |||
| 506 | |||
| 507 | ((( | ||
| 508 | //**After scanning the QR Code, Mobile APP will connect to the Helium onboarding server and provide the public key/ wallet address to the onboarding server. The server will return the match MAC address for this hotspot.**// | ||
| 509 | |||
| 510 | |||
| 511 | ))) | ||
| 512 | |||
| 513 | ((( | ||
| 514 | //**If you don’t see the MAC address, make sure your mobile has a good internet connection.**// | ||
| 515 | ))) | ||
| 516 | |||
| 517 | [[image:1651832880009-473.png]] | ||
| 518 | |||
| 519 | |||
| 520 | == //**7.9 HP0D Web ~-~-> Miner ~-~-> Version shows ‘short’**// == | ||
| 521 | |||
| 522 | |||
| 523 | **//This is caused by the server connection delay, which does not affect the regular use.//** | ||
| 524 | |||
| 525 | [[image:1651832959907-357.png]] | ||
| 526 | |||
| 527 | |||
| 528 | == **7.10 Mobile APP crash after scanning the QR Code?** == | ||
| 529 | |||
| 530 | |||
| 531 | * //**Make sure you have input the correct Wallet address to generate QR Code.**// | ||
| 532 | * //**Make sure your mobile app uses the same wallet address as the one to generate QR Code.**// | ||
| 533 | * //**Make sure your mobile app’s relevant permission is enabled.**// | ||
| 534 | * //**Known: The Android 11 version may cause this kind of issue.**// | ||
| 535 | |||
| 536 | == **7.11 Why the frequency/region is not the same as what I purchased?** == | ||
| 537 | |||
| 538 | |||
| 539 | ((( | ||
| 540 | //**Each HP0D is inspected and configured prior to shipping.**// | ||
| 541 | ))) | ||
| 542 | |||
| 543 | ((( | ||
| 544 | //**If your HP0D Web-UI – Miner region is not the same as the shell labels, please contact our support team that will solve this issue for you.**// | ||
| 545 | |||
| 546 | |||
| 547 | ))) | ||
| 548 | |||
| 549 | == **7.12 Can use the frequency to a region where is no support?** == | ||
| 550 | |||
| 551 | |||
| 552 | ((( | ||
| 553 | //**Please make sure that the region supports this frequency, you can confirm the appropriate frequency through this link:**// | ||
| 554 | ))) | ||
| 555 | |||
| 556 | ((( | ||
| 557 | [[https:~~/~~/docs.helium.com/lorawan-on-helium/frequency-plans>>url:https://docs.helium.com/lorawan-on-helium/frequency-plans]] | ||
| 558 | |||
| 559 | |||
| 560 | ))) | ||
| 561 | |||
| 562 | == **7.13 Can change the frequency of the HP0D Miner?** == | ||
| 563 | |||
| 564 | |||
| 565 | //We do not recommend doing this, it may damage your device// | ||
| 566 | |||
| 567 | |||
| 568 | == **7.14 Low Reward and not transmit issue** == | ||
| 569 | |||
| 570 | |||
| 571 | //We had released the 0524 version for the miner, Users can check the miner version in the HP0D web UI.// | ||
| 572 | |||
| 573 | //If it is lower than the 0524 version, users can manually upgrade it via the 'draginoups' command in the HP0D's CLI.// | ||
| 574 | |||
| 575 | [[image:image-20220527114519-1.png||height="579" width="851"]] | ||
| 576 | |||
| 577 | |||
| 578 | == **7.15 Why is my miner version not the latest** == | ||
| 579 | |||
| 580 | |||
| 581 | //By default, as soon as a new version of helium is released, we will push the upgrade the same day.// | ||
| 582 | |||
| 583 | //However, the download and upgrade may fail due to the network.// | ||
| 584 | |||
| 585 | You can reboot your hotspot where the hotspot will try to upgrade when per booting. | ||
| 586 | |||
| 587 | |||
| 588 | //and **We offer manual check methods:**// | ||
| 589 | |||
| 590 | **// Use the "draginoups" command to check//** | ||
| 591 | |||
| 592 | |||
| 593 | **//Note: How to access the hotspot CLI refer to ( Such as //**//[[Step 5.>>url:http://8.211.40.43/xwiki/bin/view/Main/User%20Manual%20for%20All%20Gateway%20models/HP0D#H5.SSHAccessforLinuxconsole]]** )**// | ||
| 594 | |||
| 595 | [[image:image-20220601101358-1.png]] | ||
| 596 | |||
| 597 | |||
| 598 | |||
| 599 | == **7.16 Why is my miner running down?** == | ||
| 600 | |||
| 601 | //the default, the Miner is managed by docker.// | ||
| 602 | |||
| 603 | //If you find the miner is offline where the miner is running down.// | ||
| 604 | |||
| 605 | |||
| 606 | **What You can do?** | ||
| 607 | |||
| 608 | **~1. Reboot the hotspot and check again.** | ||
| 609 | |||
| 610 | //Usually, if the miner is just down, then a reboot is the quickest way// | ||
| 611 | |||
| 612 | |||
| 613 | **2. Reinstall the Miner manually.** | ||
| 614 | |||
| 615 | //If rebooting does not solve the problem you can reinstall MINER by one of the following methods// | ||
| 616 | |||
| 617 | **1). There is an update button in the middle of the miner page, click this button and then the miner will be reinstalled.** | ||
| 618 | |||
| 619 | |||
| 620 | **2). Run the "//minerup updat//e" command to reinstall the miner** | ||
| 621 | |||
| 622 | |||
| 623 | |||
| 624 | [[image:image-20220610094825-2.png||height="457" width="835"]] | ||
| 625 | |||
| 626 | [[image:image-20220610094755-1.png||height="706" width="834"]] | ||
| 627 | |||
| 628 | |||
| 629 | == **7.17 More commands for debugging.** == | ||
| 630 | |||
| 631 | |||
| 632 | **I'm trapped somewhere, what can I do first?** | ||
| 633 | |||
| 634 | |||
| 635 | //dragino provides a method of self-testing// | ||
| 636 | |||
| 637 | //1.) Is Hotspot's Miner running?// | ||
| 638 | |||
| 639 | //2). Is the miner version up to date?// | ||
| 640 | |||
| 641 | //3). Is the height gap between local height and remote height kept within 100// | ||
| 642 | |||
| 643 | |||
| 644 | **//Note: You can find the above three points on the Miner page, and //** | ||
| 645 | |||
| 646 | **//If you are familiar with the Linux command line you can use the following command//** | ||
| 647 | |||
| 648 | |||
| 649 | (% class="box infomessage" %) | ||
| 650 | ((( | ||
| 651 | minerup update #~-~-> reinstall miner but not clearing memory | ||
| 652 | minerup flush #~-~-> reinstall miner and clear memory | ||
| 653 | minerup snap #~-~-> load a snap_short to sync the block height | ||
| 654 | minerup gap #~-~-> check the height between local and remote. | ||
| 655 | draginoup #~-~-> check the miner version gap between local and remote. | ||
| 656 | |||
| 657 | |||
| 658 | doker ps #~-~-> show the miner running state | ||
| 659 | miner versions #~-~-> show the miner version | ||
| 660 | ))) | ||
| 661 | |||
| 662 | |||
| 663 | == **7.18 Why does my hotspot not have some of the features described in this WiKi** == | ||
| 664 | |||
| 665 | |||
| 666 | //**This is the result of the OTA not being updated in time**// | ||
| 667 | |||
| 668 | //**You can reboot your hotspot or upgrade these packages manually.**// | ||
| 669 | |||
| 670 | |||
| 671 | (% class="box infomessage" %) | ||
| 672 | ((( | ||
| 673 | **apt update** | ||
| 674 | **apt install dragino*** | ||
| 675 | ))) | ||
| 676 | |||
| 677 | |||
| 678 | = **8. How to flash a new OS for the hotspot, the hotspot's setting will be factory settings** = | ||
| 679 | |||
| 680 | The hotspot is based on the Rpi-4B so the OS has been installed on the SD card. | ||
| 681 | |||
| 682 | So you have to re-flash the image into the SD card. | ||
| 683 | |||
| 684 | **Warning: Do not reset unless necessary** | ||
| 685 | |||
| 686 | |||
| 687 | //**Preparations:**// | ||
| 688 | |||
| 689 | 1. //Open the HP0D shell, and take out the SD card from the Raspberry PI 4B (Make sure the SD card is empty )// | ||
| 690 | |||
| 691 | 2. //Download the OS image~: ( Such as **[[draginohp0d-1.9img>>url:http://repo.dragino.com/release/hp0d-image/draginohp0d-1.9.img]]** )// | ||
| 692 | |||
| 693 | 3. //A card reader device// | ||
| 694 | |||
| 695 | 4. //A Flash software tool ( Such as **[[balenaEtcher>>url:https://www.balena.io/etcher/]]** )// | ||
| 696 | |||
| 697 | 5. //SD Card **[[formatter>>url:http://repo.dragino.com/release/tool/PanasonicSDFormatter.zip]]**// | ||
| 698 | |||
| 699 | |||
| 700 | **HP0D's enclosure** | ||
| 701 | |||
| 702 | |||
| 703 | [[image:image-20220615204902-1.png||height="633" width="918"]] | ||
| 704 | |||
| 705 | |||
| 706 | [[image:image-20220615204917-2.png||height="1038" width="922"]] | ||
| 707 | |||
| 708 | |||
| 709 | |||
| 710 | === **Step 1. Formatting the SD Card** === | ||
| 711 | |||
| 712 | |||
| 713 | [[image:image-20220609111027-9.png]] | ||
| 714 | |||
| 715 | |||
| 716 | === **Step 2. Select the OS image ** === | ||
| 717 | |||
| 718 | |||
| 719 | [[image:image-20220609104907-8.png]] | ||
| 720 | |||
| 721 | |||
| 722 | === **Step 3. Select the target ** === | ||
| 723 | |||
| 724 | |||
| 725 | [[image:image-20220609104637-2.png]] | ||
| 726 | |||
| 727 | [[image:image-20220609104701-3.png]] | ||
| 728 | |||
| 729 | |||
| 730 | === **Step 4. Flash start** === | ||
| 731 | |||
| 732 | |||
| 733 | [[image:image-20220609104727-4.png]] | ||
| 734 | |||
| 735 | [[image:image-20220609104741-5.png]] | ||
| 736 | |||
| 737 | |||
| 738 | === **Flash Complete** === | ||
| 739 | |||
| 740 | |||
| 741 | [[image:image-20220609104415-1.png]] | ||
| 742 | |||
| 743 | |||
| 744 | == **Step 4. Re-install the SD card into the hotspot and boot it** == | ||
| 745 | |||
| 746 | |||
| 747 | == **Step 5. Configure the correct region for the miner** == | ||
| 748 | |||
| 749 | **by the default, the factory settings apply to the US915.** | ||
| 750 | |||
| 751 | **if your region is not the US915, you have to configure the correct region for the miner.** | ||
| 752 | |||
| 753 | |||
| 754 | **Access the hotspot CLI, and run these Linux commands** | ||
| 755 | |||
| 756 | |||
| 757 | (% class="box infomessage" %) | ||
| 758 | ((( | ||
| 759 | ~#~##update the software of dragino | ||
| 760 | |||
| 761 | apt update | ||
| 762 | |||
| 763 | apt install dragino* | ||
| 764 | ))) | ||
| 765 | |||
| 766 | [[image:image-20220609150452-2.png||height="348" width="909"]] | ||
| 767 | |||
| 768 | |||
| 769 | |||
| 770 | (% class="box infomessage" %) | ||
| 771 | ((( | ||
| 772 | ~#~##configure the correct region for the miner and update it | ||
| 773 | |||
| 774 | uci set miner.general.region=<Region; Such as AS923_1/AU915/US915/EU868/IN865> | ||
| 775 | |||
| 776 | uci commit miner | ||
| 777 | |||
| 778 | minerup update | ||
| 779 | ))) | ||
| 780 | |||
| 781 | [[image:image-20220609151513-5.png]] | ||
| 782 | |||
| 783 | |||
| 784 | (% class="box infomessage" %) | ||
| 785 | ((( | ||
| 786 | ~#~##check the miner version | ||
| 787 | |||
| 788 | draginoups | ||
| 789 | ))) | ||
| 790 | |||
| 791 | [[image:image-20220609151419-3.png]] | ||
| 792 | |||
| 793 | |||
| 794 | (% class="box infomessage" %) | ||
| 795 | ((( | ||
| 796 | ~#~##unblock the function of wireless | ||
| 797 | rfkill unblock wlan | ||
| 798 | uci set wireless.general.mode=ap | ||
| 799 | uci commit wireless | ||
| 800 | ))) | ||
| 801 | |||
| 802 | [[image:image-20220609161204-1.png]] | ||
| 803 | |||
| 804 | |||
| 805 | |||
| 806 | = **9. How does the HP0D access to the network via a USB 4G Dongle** = | ||
| 807 | |||
| 808 | We have reserved enough space inside the HP0D to use a USB 4G Dongle, | ||
| 809 | |||
| 810 | so you can install a USB 4G Dongle in order for the hotspot to access the network via 4G. | ||
| 811 | |||
| 812 | |||
| 813 | //**Preparations:**// | ||
| 814 | |||
| 815 | //**1). A USB 4G Dongle, Such as HUAWEI E3327,ZTE...**// | ||
| 816 | |||
| 817 | //**2). A Sim card that can access the 4g network.**// | ||
| 818 | |||
| 819 | //**3). open the hotspot's shell.**// | ||
| 820 | |||
| 821 | |||
| 822 | == **9.1. Open the HP0D shell and access the USB 4G Dongle into the Rpi.** == | ||
| 823 | |||
| 824 | [[image:image-20220627153334-2.png]] | ||
| 825 | |||
| 826 | |||
| 827 | == **9.2. Checking the USB 4G Dongle network** == | ||
| 828 | |||
| 829 | We have installed drivers for common USB 4G Dongle, | ||
| 830 | |||
| 831 | and managed by NetworkManager, once hp0d detects an available USB 4G Dongle it will try to dial up the range network | ||
| 832 | |||
| 833 | |||
| 834 | //HUAWEI-E3327// | ||
| 835 | |||
| 836 | [[image:image-20220627154526-9.png||height="762" width="725"]] | ||
| 837 | |||
| 838 | |||
| 839 | //ZTE// | ||
| 840 | |||
| 841 | [[image:image-20220627154201-5.png]] | ||
| 842 | |||
| 843 | |||
| 844 | |||
| 845 | = **10. PoE introduction** = | ||
| 846 | |||
| 847 | |||
| 848 | //The HP0D is use the **IEEE 802.3 af compliant PoE port** (input 44 ~~ 57 v, output 12V)// | ||
| 849 | |||
| 850 | //So you can use the PoE //switches// or PoE injector to power the device.// | ||
| 851 | |||
| 852 | |||
| 853 | **Note: The RJ45 Indicator light only represents the PoE power supply, ** | ||
| 854 | |||
| 855 | **so when you use DC to power the hotspot and the RJ45 indicator light is off ~-~--> this is normal** | ||
| 856 | |||
| 857 | |||
| 858 | **Wiring schematic:** | ||
| 859 | |||
| 860 | [[image:image-20220616143347-1.png]] | ||
| 861 | |||
| 862 | |||
| 863 | |||
| 864 | |||
| 865 | = **11. OTA Version Info** = | ||
| 866 | |||
| 867 | == **When does the OTA update happen?** == | ||
| 868 | |||
| 869 | |||
| 870 | **//HP0D will check OTA update on a) Every Booting. b) Every Night. Below is the OTA update version info//** | ||
| 871 | |||
| 872 | == **# 2022/05/14** == | ||
| 873 | |||
| 874 | |||
| 875 | 1. //Update to the latest miner version: miner-arm64_2022.05.13.0_GA// | ||
| 876 | 1. //Add postinst after auto-update// | ||
| 877 | 1. //Add Miner version mark.// | ||
| 878 | 1. //Add fast sync if miner GAP is large// | ||
| 879 | |||
| 880 | == **# 2022/05/18** == | ||
| 881 | |||
| 882 | |||
| 883 | 1. //Update minerup to speed up synchronized blocks// | ||
| 884 | |||
| 885 | == **# 2022/05/24** == | ||
| 886 | |||
| 887 | |||
| 888 | 1. //Update to the latest miner version: miner-arm64_2022.05.24.0_GA// | ||
| 889 | |||
| 890 | == **# 2022/05/31** == | ||
| 891 | |||
| 892 | 1. //Add WiFi STA icon display// | ||
| 893 | 1. //Optimize AP icon display// | ||
| 894 | 1. //Optimize home icon display// | ||
| 895 | 1. //Fix for Miner icon URL bug// | ||
| 896 | 1. //Add the secondary server configuration// | ||
| 897 | |||
| 898 | = **12. Supports** = | ||
| 899 | |||
| 900 | ((( | ||
| 901 | **//If you are experiencing issues and can’t solve them, you can send mail to [[support@dragino.com>>mailto:support@dragino.com]].//** | ||
| 902 | ))) | ||
| 903 | |||
| 904 | ((( | ||
| 905 | **//With your question as detailed as possible. We will reply and help you in the shortest.//** | ||
| 906 | |||
| 907 | |||
| 908 | ))) | ||
| 909 | |||
| 910 | = **13. Order Info** = | ||
| 911 | |||
| 912 | (% style="color:#0000ff" %)**HP0D-XXX** | ||
| 913 | |||
| 914 | (% style="color:#0000ff" %)**XXX**(% style="color:black" %): Frequency Band | ||
| 915 | |||
| 916 | * **AS923**: LoRaWAN AS923 band | ||
| 917 | * **AU915**: LoRaWAN AU915 band | ||
| 918 | * **EU868**: LoRaWAN EU868 band | ||
| 919 | * **KR920**: LoRaWAN KR920 band | ||
| 920 | * **US915**: LoRaWAN US915 band | ||
| 921 | * **IN865**: LoRaWAN IN865 band | ||
| 922 | |||
| 923 | = **14. Manufacturer Info** = | ||
| 924 | |||
| 925 | ((( | ||
| 926 | **Shenzhen Dragino Technology Development co. LTD** | ||
| 927 | ))) | ||
| 928 | |||
| 929 | ((( | ||
| 930 | Room 202, Block B, BCT Incubation Bases (BaoChengTai), No.8 CaiYunRoad | ||
| 931 | ))) | ||
| 932 | |||
| 933 | ((( | ||
| 934 | Longcheng Street, LongGang District; Shenzhen 518116, China | ||
| 935 | |||
| 936 | |||
| 937 | |||
| 938 | ))) | ||
| 939 | |||
| 940 | = **15. FCC Warning** = | ||
| 941 | |||
| 942 | ((( | ||
| 943 | 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: | ||
| 944 | ))) | ||
| 945 | |||
| 946 | ((( | ||
| 947 | ~-~- Reorient or relocate the receiving antenna. | ||
| 948 | ))) | ||
| 949 | |||
| 950 | ((( | ||
| 951 | ~-~- Increase the separation between the equipment and receiver. | ||
| 952 | ))) | ||
| 953 | |||
| 954 | ((( | ||
| 955 | ~-~- Connect the equipment into an outlet on a circuit different from that to which the receiver is connected. | ||
| 956 | ))) | ||
| 957 | |||
| 958 | ((( | ||
| 959 | ~-~- Consult the dealer or an experienced radio/TV technician for help. | ||
| 960 | ))) | ||
| 961 | |||
| 962 | ((( | ||
| 963 | Changes or modifications not expressly approved by the party responsible for compliance could void the user's authority to operate the equipment. | ||
| 964 | ))) | ||
| 965 | |||
| 966 | ((( | ||
| 967 | 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. | ||
| 968 | ))) |