Skip to Content
Version 123.1 by Kilight Cao on 2023/01/06 15:35
Show last authors
1 (% style="text-align:center" %)
2 [[image:image-20220620202334-2.png||height="467" width="809"]]
3
4
5 (((
6
7
8
9 )))
10
11 **Table of Contents：**
12
13 {{toc/}}
14
15
16
17
18
19 = 1. Introduction =
20
21 == 1.1 What is LPS8v2 ==
22
23
24 (((
25 (((
26 The LPS8v2 is an (% style="color:green" %)**open-source LoRaWAN Gateway**(%%). It lets you bridge LoRa wireless network to an IP network via (% style="color:green" %)**WiFi , Ethernet or Cellular Network**(%%) (via Optional 4G module). The LoRa wireless allows users to send data and reach extremely long ranges at low data rates.
27 )))
28
29 (((
30 The LPS8v2 is fully compatible with LoRaWAN protocol. It supports different kinds of LoRaWAN Network Connections such as: (% style="color:green" %)**Semtech UDP Packet Forwarder, LoRaWAN Basic Station, ChirpStack MQTT Bridge**(%%), and so on. This makes LPS8V2 work with most LoRaWAN platforms in the market.
31 )))
32
33 (((
34 LPS8v2 also includes a (% style="color:green" %)**built-in LoRaWAN Server and IoT server**(%%), which provide the possibility for the system integrator to deploy the IoT service without cloud service or 3rd servers.
35 )))
36
37 (((
38 Different countries use different LoRaWAN frequency bands. LPS8v2 has these bands pre-configured. Users can also customize the frequency bands to use in their own LoRa network.
39 )))
40
41 (((
42 LPS8v2 supports (% style="color:green" %)**remote management**(%%). System Integrator can easy to remote monitor the gateway and maintain it.
43 )))
44
45
46 == 1.2 Specifications ==
47
48
49 (% style="color:#037691" %)**Hardware System:**
50
51 * CPU: Quad-core Cortex-A7 1.2Ghz
52 * RAM: 512MB
53 * eMMC: 4GB
54
55 (% style="color:#037691" %)**Interface:**
56
57 * 10M/100M RJ45 Ports x 1
58 * Multi-Channel LoRaWAN Wireless
59 * WiFi 802.11 b/g/n
60
61 (% style="color:#037691" %)**Operating Condition:**
62
63 * Work Temperature: -20 ~~ 65°C
64 * Storage Temperature: -20 ~~ 65°C
65 * Power Input: 5V, 2A, DC
66
67 == 1.3 Features ==
68
69
70 * Open Source Debian system
71 * Managed by Web GUI, SSH via WAN or WiFi
72 * Remote Management
73 * Auto-provisioning for batch deployment and management
74 * LoRaWAN Gateway
75 * 10 programmable parallel demodulation paths
76 * Pre-configured to support different LoRaWAN regional settings.
77 * Allow customizing LoRaWAN regional parameters.
78 * Different kinds of LoRaWAN Connections such as
79 ** Semtech UDP Packet Forwarder
80 ** LoRaWAN Basic Station
81 ** ChirpStack-Gateway-Bridge (MQTT)
82 * Built-in (% style="color:#037691" %)//**The Things Network**//(%%) local LoRaWAN server
83 * Built-in  (% style="color:#037691" %)//**Node-Red**// (%%)local Application server
84
85
86 == 1.4 Block Diagram ==
87
88
89
90 == 1.5 LED Indicators ==
91
92
93 LPS8-V2 has totally four LEDs, They are:
94
95
96 (% style="color:blue" %)//**➢ Power LED**//(%%)//: This RED LED will be solid if the device is properly powered//
97
98 (% style="color:blue" %)//**➢ ETH LED**//(%%)//:  This RGB LED will blink GREEN when the ETH port is connecting//
99
100 (% style="color:blue" %)//**➢ SYS LED**//(%%)//:  This RGB LED will show different colors in different states~://
101
102 // ✓ **SOLID GREEN:** The device is alive with a LoRaWAN server connection.//
103
104 // ✓ **BLINKING GREEN:** a) Device has internet connection but no LoRaWAN Connection. or b) Device is in booting stage, in this stage, it will BLINKING GREEN for several seconds and then with BLINKING GREEN together//
105
106 // ✓** SOLID RED:** Device doesn't have an Internet connection.//
107
108 (% style="color:blue" %)//**➢ WIFI LED**//(%%)//: This LED shows the WIFI interface connection status.//
109
110
111 == 1.6 Button Intruction ==
112
113
114 LPS8-V2 has a black toggle button, which is:
115
116
117 (% style="color:blue" %)**//➢ //Long press 4-5s  : **(%%)the gateway will reload the Network and Initialize wifi configuration
118
119 // **LED status: ** ETH LED will BLINKIND BULE Until the reload is finished.//
120
121
122 (% style="color:blue" %)//**➢ **//**Long press more than 10s:**(%%)**    **//the gateway will restore the factory settings.//
123
124 //**LED status: ** ETH LED will SOLID BULE Until the restore is finished.//
125
126
127 = 2. Quick Start =
128
129
130 The LPS8-V2 supports network access via Ethernet or Wi-Fi connection and runs without a network.
131
132 In most cases, the first thing you need to do is make the lps8-v2 accessible to the network.
133
134
135 == 2.1 Connects to the network and accesses the gateway Web UI ==
136
137 == 2.1.1 connect the network ==
138
139
140 === (% style="color:blue" %)**Method 1**(%%):  Connect via Ethernet with DHCP IP from the router ===
141
142
143 (((
144 Connect the LPS8-V2 Ethernet port to your router and LPS8-V2 can 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 LPS8-V2.
145 )))
146
147 (((
148 You can also use this IP to connect.
149 )))
150
151 [[image:image-20220622100129-1.png||height="332" width="1263"]]
152
153
154
155 === (% style="color:blue" %)**Method 2**(%%):  Connect via WiFi with DHCP IP from the router ===
156
157
158 [[image:image-20220622100542-2.png||height="369" width="1256"]]
159
160
161 Fill in the WiFi information by checking the box and clicking (% style="color:red" %)**Save&Apply**
162
163
164 [[image:image-20220622102702-6.png]]
165
166
167
168 **Wi-Fi configuration successful**
169
170
171 [[image:image-20220622102847-7.png]]
172
173
174 [[image:image-20220622102901-8.png||height="476" width="938"]]
175
176
177 === 2.1.2 Access Configure Web UI ===
178
179
180 **Web Interface**
181
182 Open a browser on the PC and type the LPS8-V2 ip address (depends on your connect method)
183
184
185 **//http:~/~/IP_ADDRESS //**
186
187
188 You will see the login interface of LPS8-V2 as shown below.
189
190 The account details for Web Login are:
191
192 (% style="color:#4f81bd" %)**User Name: root**
193
194 (% style="color:#4f81bd" %)**Password:   dragino**
195
196
197 == 2.2 The LPS8-V2 is registered and connected to The Things Network ==
198
199 === 2.2.1 Select your area frequency ===
200
201
202 (((
203 First, you need to set the frequency plan in LPS8-V2 to match the end node we use, so to receive the LoRaWAN packets from the LoRaWAN sensor.
204
205
206 )))
207
208 [[image:image-20220622103332-9.png||height="485" width="938"]]
209
210
211 === 2.2.2 Get the only gateway EUI ===
212
213
214 Every LPS8-V2 has a unique gateway id. The ID can be found on LoRaWAN Semtech page:
215
216
217 [[image:image-20220622103355-10.png||height="698" width="949"]]
218
219
220 (% style="color:red" %)**Note: Choose the cluster that corresponds to a specific Gateway server address**
221
222
223 **➢ Europe 1:**  corresponding Gateway server address:  **eu1.cloud.thethings.network**
224
225 **➢ North America 1:**  corresponding Gateway server address:  **nam1.cloud.thethings.network**
226
227 **➢ Australia 1: ** corresponding Gateway server address:  **au1.cloud.thethings.network**
228
229 **➢ Legacy V2 Console:** TTN v2 shuts down in December 2021
230
231
232 [[image:image-20220622103956-12.png]]
233
234
235 == 2.2.3 Register the gateway to The Things Network ==
236
237
238 **Login to The Things Network**
239
240 [[https:~~/~~/console.cloud.thethings.network/>>https://console.cloud.thethings.network/]]
241
242
243 **Add the gateway**
244
245 [[image:image-20220622104252-13.png||height="511" width="953"]]
246
247
248 **Get it online**
249
250
251 = 3. Web Configure Pages =
252
253 == 3.1 Home ==
254
255
256 //Shows the system running status~://
257
258 [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20All%20Gateway%20models/HP0C/WebHome/image-20220622102901-8.png?rev=1.1||alt="image-20220622102901-8.png" height="476" width="939"]]
259
260
261 == 3.2 LoRa Settings ==
262
263 === 3.2.1 LoRa ~-~-> LoRa ===
264
265
266 //This page shows the LoRa Radio Settings. There is a set of default frequency bands according to LoRaWAN protocol, and users can customize the band* as well.//
267
268 //Different LPS8v2 hardware versions can support different frequency ranges~://
269
270 * (% style="color:#0000ff" %)//**868**//(% style="color:black" %)//: valid frequency: 863Mhz ~~ 870Mhz. for bands EU868, RU864, IN865, or KZ865.//
271 * (% style="color:#0000ff" %)//**915**//(% style="color:black" %)//: valid frequency: 902Mhz ~~ 928Mhz. for bands US915, AU915, AS923 or KR920//
272
273 (% class="wikigeneratedid" %)
274 //After the user choose the frequency plan,  the user can see the actual frequency is used by checking the page (% style="color:#037691" %)**LogRead ~-~-> LoRa Log**//
275
276
277 (% class="wikigeneratedid" %)
278 [[image:image-20220616110739-1.png||height="372" width="682"]]
279
280
281 (((
282 (% style="color:red" %)//**Note *: See this instruction for how to customize the frequency band: **//(%%)**//__[[How to customized LoRaWAN frequency band - DRAGINO>>doc:Main.How to customized LoRaWAN frequency band.WebHome]]__//**
283 )))
284
285
286 == 3.3 LoRaWAN Settings ==
287
288 === 3.3.1 LoRaWAN ~-~-> LoRaWAN Semtech UDP ===
289
290
291 //This page is for the connection set up to a general LoRaWAN Network server such as [[TTN>>url:http://www.thethingsnetwork.org/]], [[ChirpStack>>url:https://www.chirpstack.io/]], etc.//
292
293
294 [[image:image-20220616111932-2.png||height="516" width="672"]]
295
296
297 === 3.3.2 LoRaWAN ~-~-> LoRaWAN Basic Station ===
298
299
300 //This page is for the connection set up to the TTN Basic Station, AWS-IoT, etc.//
301
302
303 [[image:image-20220616113246-3.png||height="396" width="672"]]
304
305
306 (((
307 Please see this instruction to know more detail and a demo for how to use of LoRaWAN Basic Station: __[[Use of LoRaWAN Basic Station - DRAGINO>>doc:Main.Use of LoRaWAN Basic Station.WebHome]]__
308 )))
309
310
311 == 3.4 Network Settings ==
312
313 === 3.4.1 Network ~-~-> WiFi ===
314
315
316 [[image:image-20220616114756-4.png||height="251" width="669"]]
317
318
319 === 3.4.2 Network ~-~-> System Status ===
320
321
322 [[image:image-20220820134112-2.png||height="539" width="668"]]
323
324
325 === 3.4.3 Network ~-~-> Firewall ===
326
327
328 [[image:image-20220616115351-6.png||height="244" width="661"]]
329
330
331 == 3.5 System ==
332
333 === 3.5.1 System ~-~-> System Overview ===
334
335
336 Shows the system info:
337
338 [[image:image-20220917144512-5.png||height="618" width="853"]]
339
340
341 === 3.5.2 System ~-~-> Backup/Restore ===
342
343
344 [[image:image-20220917144725-6.png||height="208" width="869"]]
345
346
347 === 3.5.3 System ~-~-> Remoteit ===
348
349
350 In the System-> Remoteit interface, users can configure the gateway to be accessed remotely via Remote.it.
351
352
353 the users can refer to this link to configure them: **[[Monitor & Remote Access Gateway>>http://wiki.dragino.com/xwiki/bin/view/Main/Monitor%20%26%20Remote%20Access%20Gateway/?Remote%20Access#H2.1A0RemoteAccessviaRemote.it.]]**
354
355 [[image:image-20221230092303-2.png]]
356
357
358 = 4. Build-in Server =
359
360
361 The default factory version of LPS8-V2 is installed with the built-in Applicant server: (% style="color:blue" %)**Node-Red, and**(%%) LoRaWAN Server: (% style="color:blue" %)**The Things Network - Stack (Open Source 3.19 Version).**
362
363
364 [[image:image-20220820115644-1.png||height="217" width="778"]]
365
366
367 (% style="color:red" %)**Note:**
368
369 **Path**: System ~-~-> Built-in Server
370
371
372 **Troubleshooting:**
373
374
375 **~ 1. URL does not jump properly**
376
377 For the ttn-stack, you can click the update the URL which will update the configuration where change the hostname to the current local IP address as the URL.
378
379 For the Node-Red, you can use the local IP address and the port is 1880 to access it.
380
381
382 == 4.1 LoRaWAN Network  Server ~-~- The Things Network - Stack (TTN-V3) ==
383
384
385 You can access the gateway's built-in LNS server of (% style="color:blue" %)**The Things Network - Stack **(%%)via the URL( (% style="background-color:yellow" %)__**//http:~/~/<hostname>:8080 or http:~/~/<local-IPV4-address> //**__(%%)) in your browser.
386
387 Such as  (% style="background-color:yellow" %)__**//http:~/~/dragino-54ff12:8080  or http:~/~/<Local-IPV4-Address>//**__
388
389
390 Login account:
391
392 **User ID: ** ** (% style="background-color:yellow" %)admin(%%)**
393
394 **Password: ** ** (% style="background-color:yellow" %)dragino(%%)**
395
396
397 [[image:image-20220725171719-1.png||height="570" width="769"]]
398
399
400 == 4.2 Application Server ~-~- Node-Red ==
401
402
403 You can access the gateway's built-in AS server of (% style="color:blue" %)**Node-Red **(%%)via the URL((% style="background-color:yellow" %)__**//http:~/~/<hostname>:1880 or http:~/~/<local-IPV4-address>//**__(%%)) in your browser.
404
405
406 Such as (% style="background-color:yellow" %)__**//http:~/~/dragino-54ff12:1880  or http:~/~/<Local-IPV4-Address>//**__
407
408
409 [[image:image-20220725172124-3.png||height="610" width="843"]]
410
411
412
413 === **Using Node-Red, InfluxDB and Grafana** ===
414
415 The LPS8-V2 supports this combination, the default, Node-red is pre-installed but the InfluxDB and Grafana is not pre-installed.
416
417
418 the users can refer to this link to install them.
419
420 [[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/Armbian%20OS%20instruction/#H2.6HowtoinstallGrafanaandinfluxdb>>http://wiki.dragino.com/xwiki/bin/view/Main/Armbian%20OS%20instruction/#H2.6HowtoinstallGrafanaandinfluxdb]]
421
422
423 = 5. How users can access LPS8v2 using serial USB =
424
425
426 (% style="color:blue" %)**USB TTL to LPS8v2  Connection:**
427
428
429 Port 1 of the UART on the LPS8v2 is GND
430
431 (% class="box infomessage" %)
432 (((
433 **TXD  <~-~--> UART RXD (Gray line)**
434
435 **RXD  <~-~--> UART TXD (White line)**
436
437 **GND <~-~--> GND (Black line)**
438 )))
439
440
441 **LPS8v2 UART connection photo**
442
443 [[image:image-20220804163015-1.png||height="621" width="466"]]
444
445
446
447 In the PC,you can use the serial port tool(such as [[putty>>url:http://www.chiark.greenend.org.uk/~~sgtatham/putty/download.html]] in Windows), you need to set the serial baud rate to (% style="color:blue" %)**115200**(%%) to access the serial console for LPS8v2. LPS8v2 will output system info once power on as below:
448
449
450 [[image:image-20220804164928-3.png||height="320" width="332"]]
451
452
453 [[image:image-20220804164747-2.png||height="622" width="594"]]
454
455
456 = 6. Use the helium gateway-rs as the Data-only Hotspot =
457
458
459 == **Step 1: Configure Frequency Band** ==
460
461
462 //Each country has a requirement for frequency region. Choose the right one for your area.//
463
464 [[image:image-20220905164308-1.png]]
465
466
467
468 == **Step 2: Configure the forward address** ==
469
470
471 **Select one of the servers to configure.**
472
473 **For example:**
474
475 [[image:image-20220905164847-2.png]]
476
477
478
479 == **Step 3: Download and Install the Helium-gateway-rs** ==
480
481
482 **Access the gateway CLI via SSH.**
483
484 [[image:image-20220905165222-3.png]]
485
486
487 **Download gateway-rs.**
488
489 [[image:image-20220905165715-5.png]]
490
491 (% class="box infomessage" %)
492 (((
493 **Command: wget [[http:~~/~~/repo.dragino.com/release/tool/gateway-rs/helium-gateway-v1.0.0-alpha.31-raspi234.deb>>http://repo.dragino.com/release/tool/gateway-rs/helium-gateway-v1.0.0-alpha.31-raspi234.deb]]**
494 )))
495
496
497 **Install gateway-rs.**
498
499 [[image:image-20220905165917-7.png]]
500
501 (% class="box infomessage" %)
502 (((
503 **Command: dpkg -i helium-gateway-v1.0.0-alpha.31-raspi234.deb **
504 )))
505
506
507 **Modify configuration.**
508
509
510 [[image:image-20220905173847-12.png]]
511
512
513 (% class="box infomessage" %)
514 (((
515 **region=<Enter regional parameters> \
516 && sed -i '/region/d' /etc/helium_gateway/settings.toml && sed -i "1 i\region = \"$region\"" /etc/helium_gateway/settings.toml \
517 && sed -i '/region/d' /etc/helium_gateway/default.toml && sed -i "22 i\region = \"$region\"" /etc/helium_gateway/default.toml**
518 )))
519
520
521 **Restart the helium_gateway**
522
523 [[image:image-20220905170920-9.png]]
524
525
526 (% class="box infomessage" %)
527 (((
528 **systemctl restart helium_gateway**
529 )))
530
531
532 **Check the helium_gateway Log：**
533
534 [[image:image-20220905173952-13.png]]
535
536
537 (% class="box infomessage" %)
538 (((
539 **journalctl -u helium_gateway -f**
540 )))
541
542
543 (% style="color:red" %)**Note: if your device is not finished the onboarding, which is unable to connect to the Helium console.**
544
545 where the helium gateway log is shown:
546
547 [[image:image-20220905174534-14.png]]
548
549
550 So you have to finish the onboarding, ~-~--Please refer to [[Step 2.7>>doc:Main.Notes for Helium.WebHome||anchor="H2.7A0Step6:OnboardingData-OnlyHotspot"]] to onboarding your LPS8-V2.
551
552
553 = 7. OTA System Update =
554
555
556 LPS8v2 supports system auto update via OTA, please see **[[this URL>>url:http://wiki.dragino.com/xwiki/bin/view/OTA%20Update/]]** for the detail of this feature.
557
558
559 = 8. Trouble Shooting =
560
561 == 8.1  I can't log in to the built-in Server TTN Stack which shows '**Login failed**'. ==
562
563
564 [[image:image-20220920135918-1.png]]
565
566
567 This is caused by the inconsistency between the built-in TTN-Stack domain configuration and your login URL.
568
569 By default, ttn-stack uses the gateway's domain name for URL resolution, but in some networks, they prefer to resolve IP-v4 addresses.
570
571
572 So you can change the domain name of the TTN-Stack configuration to the IPv4 address.
573
574 **Click the update URL button to configure the URL with the current eth port address.**
575
576 [[image:image-20220920141936-2.png]]
577
578
579 = (% style="color:inherit; font-family:inherit; font-size:29px" %)9. Supports(%%) =
580
581
582 (((
583 **//If you are experiencing issues and can't solve them, you can send mail to [[support@dragino.com>>mailto:support@dragino.com]].//**
584 )))
585
586 (((
587 **//With your question as detailed as possible. We will reply and help you in the shortest.//**
588
589
590 = 10. Reference =
591
592
593 * Install Tago Core: Refer **Install Tago Core in LPS8v2** in[[ Instruction>>doc:Main.Tago\.IO.WebHome]].
594 * [[Advance OS Reference Guide for LPS8v2>>doc:Main.Armbian OS instruction.WebHome]].
595
596
597 )))
598
599 = 11. Order Info =
600
601
602 (% style="color:#0000ff" %)**LPS8v2-XXX-YYY**
603
604 (% style="color:#0000ff" %)**XXX**(% style="color:black" %): Frequency Band
605
606 * (% style="color:red" %)**AS923**(%%): LoRaWAN AS923 band
607 * (% style="color:red" %)**AU915**(%%): LoRaWAN AU915 band
608 * (% style="color:red" %)**EU868**(%%): LoRaWAN EU868 band
609 * (% style="color:red" %)**KR920**(%%): LoRaWAN KR920 band
610 * (% style="color:red" %)**US915**(%%): LoRaWAN US915 band
611 * (% style="color:red" %)**IN865**(%%):  LoRaWAN IN865 band
612
613 (% style="color:#0000ff" %)**YYY**(% style="color:black" %): 4G Cellular Option
614
615 * (% style="color:red" %)**E**(%%):  EMEA, Korea, Thailand, India.
616 * (% style="color:red" %)**A**(%%):  North America/ Rogers/AT&T/T-Mobile.
617 * (% style="color:red" %)**AU**(%%): Latin America, New Zeland, Taiwan
618 * (% style="color:red" %)**J**(%%):  Japan, DOCOMO/SoftBank/ KDDI
619
620 More info about valid bands, please see [[EC25-E product page>>url:https://www.quectel.com/product/ec25.htm]].
621
622
623 = 12. Manufacturer Info =
624
625
626 **Shenzhen Dragino Technology Development co. LTD**
627
628 Room 202, Block B, BCT Incubation Bases (BaoChengTai),  No.8 CaiYunRoad
629
630 LongCheng Street, LongGang District ; Shenzhen 518116,China
631
632
633 = 13. FCC Warning =
634
635
636 (((
637 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:
638 )))
639
640 (((
641 ~-~- Reorient or relocate the receiving antenna.
642 )))
643
644 (((
645 ~-~- Increase the separation between the equipment and receiver.
646 )))
647
648 (((
649 ~-~- Connect the equipment into an outlet on a circuit different from that to which the receiver is connected.
650 )))
651
652 (((
653 ~-~- Consult the dealer or an experienced radio/TV technician for help.
654 )))
655
656
657 (((
658 Changes or modifications not expressly approved by the party responsible for compliance could void the user's authority to operate the equipment.
659 )))
660
661
662 (((
663 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.
664
665
666 )))
667 )))