Version 121.1 by Kilight Cao on 2022/12/30 09:28

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