Version 122.1 by Kilight Cao on 2022/12/30 09:40

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