Version 122.3 by Xiaoling on 2023/01/03 15:53

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