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