Version 113.1 by Xiaoye on 2022/09/20 14:21

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 (((
167 The LPS8-V2 has a fall-back IP address on its WAN port. you have to access the gateway Web-UI to configure the WiFi connection via the fallback IP address.
168 )))
169
170
171
172 (% style="color:#037691" %)**Steps to connect via fallback IP:**
173
174 ~1. Connect PC's Ethernet port to LPS8-V2's WAN port
175
176 2. Configure PC's Ethernet port has  IP: 172.31.255.253 and Netmask: 255.255.255.252
177
178
179 [[image:image-20220622101433-4.png]]
180
181
182 and then On the PC, use the IP address **http:~/~/172.31.255.254** to access the LPS8-V2 via Web or Console.
183
184
185 [[image:image-20220622102210-5.png||height="504" width="919"]]
186
187
188 Fill in the WiFi information by checking the box and clicking (% style="color:red" %)**Save&Apply**
189
190
191 [[image:image-20220622102702-6.png]]
192
193
194
195 **Wi-Fi configuration successful**
196
197
198 [[image:image-20220622102847-7.png]]
199
200
201 [[image:image-20220622102901-8.png||height="476" width="938"]]
202
203
204
205 == **2.2 The LPS8-V2 is registered and connected to The Things Network** ==
206
207
208 === **2.2.1 Select your area frequency** ===
209
210
211 (((
212 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.
213
214
215 )))
216
217 [[image:image-20220622103332-9.png||height="485" width="938"]]
218
219
220
221 === **2.2.2 Get the only gateway EUI** ===
222
223
224 Every LPS8-V2 has a unique gateway id. The ID can be found on LoRaWAN Semtech page:
225
226
227 [[image:image-20220622103355-10.png||height="698" width="949"]]
228
229
230 (% style="color:red" %)**Note: Choose the cluster that corresponds to a specific Gateway server address**
231
232
233 **➢ Europe 1:**  corresponding Gateway server address:  **eu1.cloud.thethings.network**
234
235 **➢ North America 1:**  corresponding Gateway server address:  **nam1.cloud.thethings.network**
236
237 **➢ Australia 1: ** corresponding Gateway server address:  **au1.cloud.thethings.network**
238
239 **➢ Legacy V2 Console:** TTN v2 shuts down in December 2021
240
241
242 [[image:image-20220622103956-12.png]]
243
244
245
246 == **2.2.3 Register the gateway to The Things Network** ==
247
248
249 **Login to The Things Network**
250
251 [[https:~~/~~/console.cloud.thethings.network/>>https://console.cloud.thethings.network/]]
252
253
254 **Add the gateway**
255
256 [[image:image-20220622104252-13.png||height="511" width="953"]]
257
258
259 **Get it online**
260
261
262
263 = **3. Web Configure Pages** =
264
265
266 == **3.1 Home** ==
267
268
269 //Shows the system running status~://
270
271 [[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"]]
272
273
274
275 == **3.2 LoRa Settings** ==
276
277
278 === **3.2.1 LoRa ~-~-> LoRa** ===
279
280
281 //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.//
282
283 //Different LPS8v2 hardware versions can support different frequency ranges~://
284
285 * (% style="color:#0000ff" %)//**868**//(% style="color:black" %)//: valid frequency: 863Mhz ~~ 870Mhz. for bands EU868, RU864, IN865, or KZ865.//
286 * (% style="color:#0000ff" %)//**915**//(% style="color:black" %)//: valid frequency: 902Mhz ~~ 928Mhz. for bands US915, AU915, AS923 or KR920//
287
288 (% class="wikigeneratedid" %)
289 //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**//
290
291
292 (% class="wikigeneratedid" %)
293 [[image:image-20220616110739-1.png||height="372" width="682"]]
294
295
296 (((
297 (% 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]]__//**
298 )))
299
300
301
302 == **3.3 LoRaWAN Settings** ==
303
304
305 === **3.3.1 LoRaWAN ~-~-> LoRaWAN Semtech UDP** ===
306
307
308 //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.//
309
310
311 [[image:image-20220616111932-2.png||height="516" width="672"]]
312
313
314
315 === **3.3.2 LoRaWAN ~-~-> LoRaWAN Basic Station** ===
316
317
318 //This page is for the connection set up to the TTN Basic Station, AWS-IoT, etc.//
319
320
321 [[image:image-20220616113246-3.png||height="396" width="672"]]
322
323
324 (((
325 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]]__
326 )))
327
328
329
330 == **3.4 Network Settings** ==
331
332
333 === **3.4.1 Network ~-~-> WiFi** ===
334
335
336 [[image:image-20220616114756-4.png||height="251" width="669"]]
337
338
339
340 === **3.4.2 Network ~-~-> System Status** ===
341
342
343 [[image:image-20220820134112-2.png||height="539" width="668"]]
344
345
346
347 === **3.4.3 Network ~-~-> Firewall** ===
348
349
350 [[image:image-20220616115351-6.png||height="244" width="661"]]
351
352
353
354 == **3.5 System** ==
355
356
357 === **3.5.1  System ~-~-> System Overview** ===
358
359
360 Shows the system info:
361
362 [[image:image-20220917144512-5.png||height="618" width="853"]]
363
364
365
366 === **3.5.2 System ~-~-> Backup/Restore** ===
367
368
369 [[image:image-20220917144725-6.png||height="208" width="869"]]
370
371
372
373 = **4. Build-in Server** =
374
375
376 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).**
377
378
379 [[image:image-20220820115644-1.png||height="217" width="778"]]
380
381
382 (% style="color:red" %)**Note:**
383
384 **Path**: System ~-~-> Built-in Server
385
386
387 **Troubleshooting:**
388
389
390 **~ 1. URL does not jump properly**
391
392 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.
393
394 For the Node-Red, you can use the local IP address and the port is 1880 to access it.
395
396
397
398 == **4.1 LoRaWAN Network  Server ~-~- The Things Network - Stack (TTN-V3)** ==
399
400
401 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.
402
403 Such as  (% style="background-color:yellow" %)__**//http:~/~/dragino-54ff12:8080  or http:~/~/<Local-IPV4-Address>//**__
404
405
406 Login account:
407
408 **User ID: ** ** (% style="background-color:yellow" %)admin(%%)**
409
410 **Password: ** ** (% style="background-color:yellow" %)dragino(%%)**
411
412
413 [[image:image-20220725171719-1.png||height="570" width="769"]]
414
415
416
417 == **4.2 Application Server ~-~- Node-Red** ==
418
419
420 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.
421
422
423 Such as (% style="background-color:yellow" %)__**//http:~/~/dragino-54ff12:1880  or http:~/~/<Local-IPV4-Address>//**__
424
425
426 [[image:image-20220725172124-3.png||height="610" width="843"]]
427
428
429
430 = **5. How users can access LPS8v2 using serial USB** =
431
432
433 (% style="color:blue" %)**USB TTL to LPS8v2  Connection:**
434
435
436 Port 1 of the UART on the LPS8v2 is GND
437
438 (% class="box infomessage" %)
439 (((
440 **TXD  <~-~--> UART RXD (Gray line)**
441
442 **RXD  <~-~--> UART TXD (White line)**
443
444 **GND <~-~--> GND (Black line)**
445 )))
446
447
448 **LPS8v2 UART connection photo**
449
450 [[image:image-20220804163015-1.png||height="621" width="466"]]
451
452
453
454 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:
455
456
457 [[image:image-20220804164928-3.png||height="320" width="332"]]
458
459
460 [[image:image-20220804164747-2.png||height="622" width="594"]]
461
462
463
464 = **6. Use the helium gateway-rs as the Data-only Hotspot** =
465
466
467 == **Step 1: Configure Frequency Band** ==
468
469
470 //Each country has a requirement for frequency region. Choose the right one for your area.//
471
472 [[image:image-20220905164308-1.png]]
473
474
475
476 == **Step 2: Configure the forward address** ==
477
478
479 **Select one of the servers to configure.**
480
481 **For example:**
482
483 [[image:image-20220905164847-2.png]]
484
485
486
487 == **Step 3: Download and Install the Helium-gateway-rs** ==
488
489
490 **Access the gateway CLI via SSH.**
491
492 [[image:image-20220905165222-3.png]]
493
494
495 **Download gateway-rs.**
496
497 [[image:image-20220905165715-5.png]]
498
499 (% class="box infomessage" %)
500 (((
501 **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]]**
502 )))
503
504
505 **Install gateway-rs.**
506
507 [[image:image-20220905165917-7.png]]
508
509 (% class="box infomessage" %)
510 (((
511 **Command: dpkg -i helium-gateway-v1.0.0-alpha.31-raspi234.deb **
512 )))
513
514
515 **Modify configuration.**
516
517
518 [[image:image-20220905173847-12.png]]
519
520
521 (% class="box infomessage" %)
522 (((
523 **region=<Enter regional parameters> \
524 && sed -i '/region/d' /etc/helium_gateway/settings.toml && sed -i "1 i\region = \"$region\"" /etc/helium_gateway/settings.toml \
525 && sed -i '/region/d' /etc/helium_gateway/default.toml && sed -i "22 i\region = \"$region\"" /etc/helium_gateway/default.toml**
526 )))
527
528
529 **Restart the helium_gateway**
530
531 [[image:image-20220905170920-9.png]]
532
533
534 (% class="box infomessage" %)
535 (((
536 **systemctl restart helium_gateway**
537 )))
538
539
540 **Check the helium_gateway Log:**
541
542 [[image:image-20220905173952-13.png]]
543
544
545 (% class="box infomessage" %)
546 (((
547 **journalctl -u helium_gateway -f**
548 )))
549
550
551 (% style="color:red" %)**Note: if your device is not finished the onboarding, which is unable to connect to the Helium console.**
552
553 where the helium gateway log is shown:
554
555 [[image:image-20220905174534-14.png]]
556
557
558 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.
559
560
561
562 = **7. Trouble Shooting** =
563
564
565 == 1). I can't log in to the built-in Server TTN Stack which shows '**Login failed**'. ==
566
567
568 [[image:image-20220920135918-1.png]]
569
570 This is caused by the inconsistency between the built-in TTN-Stack domain configuration and your login URL.
571
572 By default, ttn-stack uses the gateway's domain name for URL resolution, but in some networks, they prefer to resolve IP-v4 addresses.
573
574
575 So you can change the domain name of the TTN-Stack configuration to the IPv4 address.
576
577 **Click the update URL button to configure the URL with the current eth port address.**
578
579 [[image:image-20220920141936-2.png]]
580
581
582
583
584 = (% style="color:inherit; font-family:inherit; font-size:29px" %)**8. Supports**(%%) =
585
586
587 (((
588 **//If you are experiencing issues and can't solve them, you can send mail to [[support@dragino.com>>mailto:support@dragino.com]].//**
589 )))
590
591 (((
592 **//With your question as detailed as possible. We will reply and help you in the shortest.//**
593
594
595
596 = **9. Reference** =
597
598
599 * Install Tago Core: Refer **Install Tago Core in LPS8v2** in[[ Instruction>>doc:Main.Tago\.IO.WebHome]].
600 * [[Advance OS Reference Guide for LPS8v2>>doc:Main.Armbian OS instruction.WebHome]].
601
602
603 )))
604
605 = **10. Order Info** =
606
607
608 (% style="color:#0000ff" %)**LPS8v2-XXX-YYY**
609
610 (% style="color:#0000ff" %)**XXX**(% style="color:black" %): Frequency Band
611
612 * (% style="color:red" %)**AS923**(%%): LoRaWAN AS923 band
613 * (% style="color:red" %)**AU915**(%%): LoRaWAN AU915 band
614 * (% style="color:red" %)**EU868**(%%): LoRaWAN EU868 band
615 * (% style="color:red" %)**KR920**(%%): LoRaWAN KR920 band
616 * (% style="color:red" %)**US915**(%%): LoRaWAN US915 band
617 * (% style="color:red" %)**IN865**(%%):  LoRaWAN IN865 band
618
619 (% style="color:#0000ff" %)**YYY**(% style="color:black" %): 4G Cellular Option
620
621 * (% style="color:red" %)**E**(%%):  EMEA, Korea, Thailand, India.
622 * (% style="color:red" %)**A**(%%):  North America/ Rogers/AT&T/T-Mobile.
623 * (% style="color:red" %)**AU**(%%): Latin America, New Zeland, Taiwan
624 * (% style="color:red" %)**J**(%%):  Japan, DOCOMO/SoftBank/ KDDI
625
626 More info about valid bands, please see [[EC25-E product page>>url:https://www.quectel.com/product/ec25.htm]].
627
628
629
630 = **10. Manufacturer Info** =
631
632
633 **Shenzhen Dragino Technology Development co. LTD**
634
635 Room 202, Block B, BCT Incubation Bases (BaoChengTai),  No.8 CaiYunRoad
636
637 LongCheng Street, LongGang District ; Shenzhen 518116,China
638
639
640
641 = **11. FCC Warning** =
642
643
644 (((
645 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:
646 )))
647
648 (((
649 ~-~- Reorient or relocate the receiving antenna.
650 )))
651
652 (((
653 ~-~- Increase the separation between the equipment and receiver.
654 )))
655
656 (((
657 ~-~- Connect the equipment into an outlet on a circuit different from that to which the receiver is connected.
658 )))
659
660 (((
661 ~-~- Consult the dealer or an experienced radio/TV technician for help.
662 )))
663
664
665 (((
666 Changes or modifications not expressly approved by the party responsible for compliance could void the user's authority to operate the equipment.
667 )))
668
669
670 (((
671 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.
672
673
674 )))
675 )))