Version 117.1 by Kilight Cao on 2022/12/28 11:03

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