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