Wiki source code of LPS8N - LoRaWAN Gateway User Manual
Version 178.1 by Kilight Cao on 2023/11/16 11:29
Show last authors
author | version | line-number | content |
---|---|---|---|
1 | (% style="text-align:center" %) | ||
2 | [[image:1656917428377-954.png||height="475" width="475"]] | ||
3 | |||
4 | |||
5 | |||
6 | |||
7 | **Table of Contents:** | ||
8 | |||
9 | {{toc/}} | ||
10 | |||
11 | |||
12 | |||
13 | |||
14 | |||
15 | |||
16 | = 1. Introduction = | ||
17 | |||
18 | == 1.1 What is the LPS8N == | ||
19 | |||
20 | |||
21 | ((( | ||
22 | The LPS8N is an (% style="color:blue" %)**open source LoRaWAN Indoor Gateway**(%%). It lets you bridge LoRa wireless network to an IP network via WiFi, Ethernet, 3G or 4G cellular network. The LoRa wireless allows users to send data and reach extremely long ranges at low data-rates. | ||
23 | ))) | ||
24 | |||
25 | ((( | ||
26 | The LPS8N uses (% style="color:blue" %)**Semtech packet forwarder**(%%) & (% style="color:blue" %)**LoRaWAN Station connection**(%%) and fully compatible with LoRaWAN protocol. It includes a (% style="color:blue" %)**SX1302 LoRaWAN concentrator**(%%), which provides 10 programmable parallel demodulation paths. | ||
27 | ))) | ||
28 | |||
29 | ((( | ||
30 | LPS8N has (% style="color:blue" %)**pre-configured standard LoRaWAN frequency bands**(%%) to use for different countries. User can also (% style="color:blue" %)**customized the frequency bands** (%%)to use in their own LoRa network. | ||
31 | ))) | ||
32 | |||
33 | ((( | ||
34 | LPS8N can communicate with ABP LoRaWAN end node without LoRaWAN server. System integrator can use it to integrate with their existing IoT Service without set up own LoRaWAN server or use 3rd party LoRaWAN service. | ||
35 | ))) | ||
36 | |||
37 | |||
38 | [[image:image-20220826090251-1.png]] | ||
39 | |||
40 | |||
41 | == 1.2 Specifications == | ||
42 | |||
43 | |||
44 | (% style="color:#037691" %)**Hardware System:** | ||
45 | |||
46 | ((( | ||
47 | Linux Part: | ||
48 | ))) | ||
49 | |||
50 | * 400Mhz ar9331 processor | ||
51 | * 64MB RAM | ||
52 | * 16MB Flash | ||
53 | |||
54 | (% style="color:#037691" %)**Interface:** | ||
55 | |||
56 | * 10M/100M RJ45 Ports x 1 | ||
57 | * WiFi : 802.11 b/g/n | ||
58 | * LoRaWAN Wireless | ||
59 | * Power Input: 5V DC, 2A, Type C | ||
60 | * USB 2.0 host connector x 1 | ||
61 | * Mini-PCI E connector x 1 | ||
62 | * SX1302 + 2 x SX1250 | ||
63 | |||
64 | (% style="color:#037691" %)**WiFi Spec:** | ||
65 | |||
66 | * IEEE 802.11 b/g/n | ||
67 | * Frequency Band: 2.4 ~~ 2.462GHz | ||
68 | * Tx power: | ||
69 | ** 11n tx power : mcs7/15: 11db mcs0 : 17db | ||
70 | ** 11b tx power: 18db | ||
71 | ** 11g 54M tx power: 12db | ||
72 | ** 11g 6M tx power: 18db | ||
73 | * Wifi Sensitivity | ||
74 | ** 11g 54M : -71dbm | ||
75 | ** 11n 20M : -67dbm | ||
76 | |||
77 | (% style="color:#037691" %)**LoRa Spec:** | ||
78 | |||
79 | * Up to -140 dBm sensitivity | ||
80 | * 70 dB CW interferer rejection at 1 MHz offset | ||
81 | * Able to operate with negative SNR, CCR up to 9dB | ||
82 | * Emulates 49 x LoRa demodulators and 1 x (G)FSK demodulator | ||
83 | * Dual digital TX & RX radio front-end interfaces | ||
84 | * 10 programmable parallel demodulation paths | ||
85 | * Dynamic data-rate (DDR) adaptation | ||
86 | * True antenna diversity or simultaneous dual-band operation | ||
87 | |||
88 | (% style="color:#037691" %)**Cellular 4G LTE (optional):** | ||
89 | |||
90 | * Quectel [[**EC25 LTE module**>>url:https://www.quectel.com/product/ec25minipcie.htm]] | ||
91 | * Micro SIM Slot | ||
92 | * External 4G Sticker Antenna. | ||
93 | * Up to 150Mbps downlink and 50Mbps uplink data rates | ||
94 | * Worldwide LTE,UMTS/HSPA+ and GSM/GPRS/EDGE coverage | ||
95 | * MIMO technology meets demands for data rate and link reliability in modem wireless communication systems | ||
96 | |||
97 | |||
98 | |||
99 | == 1.3 Features == | ||
100 | |||
101 | |||
102 | * Open Source OpenWrt system | ||
103 | * Managed by Web GUI, SSH via WAN or WiFi | ||
104 | * Remote access with Reverse-SSH or remote.it | ||
105 | * Emulates 49x LoRa demodulators | ||
106 | * LoRaWAN Gateway | ||
107 | * 10 programmable parallel demodulation paths | ||
108 | * Pre-configure to support different LoRaWAN regional settings. | ||
109 | * Allow to customize LoRaWAN regional parameters. | ||
110 | * Support Local decode ABP end node info and transfer to MQTT server | ||
111 | * Support different level log in. | ||
112 | * Support Semtech Packet Forwarder | ||
113 | * Support LoRaWAN basic station. | ||
114 | * Optional 3G/4G cellular connection | ||
115 | |||
116 | |||
117 | |||
118 | == 1.4 Hardware System Structure == | ||
119 | |||
120 | |||
121 | [[image:image-20220830153228-1.png]] | ||
122 | |||
123 | |||
124 | == 1.5 LPS8N Applications == | ||
125 | |||
126 | |||
127 | [[image:1657079055940-721.png]] | ||
128 | |||
129 | |||
130 | == 1.6 LED Indicators == | ||
131 | |||
132 | |||
133 | LPS8N has totally four LEDs, They are: | ||
134 | |||
135 | * **Power LED **[[image:image-20220706115518-1.png||height="15" width="16"]] : This (% style="color:red" %)**RED LED**(%%) will be **solid on** if the device is properly powered. | ||
136 | * **Wireless LED** [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20All%20Gateway%20models/LG308N%20-%20LoRaWAN%20Gateway%20User%20Manual/WebHome/image-20220705165446-6.png?width=15&height=15&rev=1.1||alt="image-20220705165446-6.png" height="15" width="15"]]: No function yet. | ||
137 | * **SYS LED ** [[image:image-20220706115518-3.png||height="16" width="16"]] : This **RGB LED** will shows different colors on different state: | ||
138 | ** (% style="color:blue" %)**SOLID BLUE**(%%): Device is alive with LoRaWAN server connection. | ||
139 | ** (% style="color:blue" %)**BLINKING BLUE**(%%): a) Device has internet connection but no LoRaWAN Connection. or b) Device is in booting stage, in this stage, it will (% style="color:blue" %)**BLINKING BLUE**(%%) for several seconds and then with (% style="color:red" %)**SOLID RED**(%%) and (% style="color:blue" %)**BLINKING BLUE**(%%) together | ||
140 | ** (% style="color:red" %)**SOLID RED**(%%): Device doesn't have Internet connection. | ||
141 | |||
142 | * **ETH LED **[[image:image-20220706115518-4.png||height="15" width="17"]] : This LED shows the ETH interface connection status. | ||
143 | |||
144 | |||
145 | |||
146 | == 1.7 Button Instruction == | ||
147 | |||
148 | |||
149 | LPS8N has a black toggle button, which is: | ||
150 | |||
151 | |||
152 | (% style="color:blue" %)**//➢ //Long press 4-5s: **(%%)the gateway will reload the Network and Initialize wifi configuration | ||
153 | |||
154 | **LED status: ** SYS LED will BLINKING BLUE Until the reload is finished. | ||
155 | |||
156 | |||
157 | (% style="color:blue" %)**➢ Long press more than 30s: **(%%)the gateway will restart and restore factory settings. | ||
158 | |||
159 | **LED status: ** When the user releases the button, the LED will TURN OFF. | ||
160 | |||
161 | |||
162 | = 2. Access and Configure LPS8N = | ||
163 | |||
164 | |||
165 | ((( | ||
166 | The LPS8N is configured as a WiFi Access Point by factory default. You can access and configure the LPS8N after connecting to its WiFi network, or via its WAN Ethernet port. | ||
167 | ))) | ||
168 | |||
169 | |||
170 | == 2.1 Find IP address of LPS8N == | ||
171 | |||
172 | === 2.1.1 Connect via WiFi === | ||
173 | |||
174 | |||
175 | [[image:1657085974260-168.png]] | ||
176 | |||
177 | |||
178 | At the first boot of LPS8N, it will auto generate a WiFi network called (% style="color:green" %)**//dragino-xxxxxx //**(% style="color:black" %)with password: (% style="background-color:yellow" %)dragino+dragino | ||
179 | |||
180 | |||
181 | [[image:1652413127647-377.png]] | ||
182 | |||
183 | |||
184 | ((( | ||
185 | User can use a PC to connect to this WiFi network. The PC will get an IP address 10.130.1.xxx and the DLOS8N has the default IP (% style="color:green" %)10.130.1.1 | ||
186 | |||
187 | |||
188 | ))) | ||
189 | |||
190 | === 2.1.2 Connect via Ethernet with DHCP IP from router === | ||
191 | |||
192 | |||
193 | [[image:1657086105922-299.png]] | ||
194 | |||
195 | |||
196 | ((( | ||
197 | Alternatively, connect the LPS8N Ethernet port to your router and LPS8N will 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 LPS8N. You can also use this IP to connect. | ||
198 | |||
199 | |||
200 | ))) | ||
201 | |||
202 | === 2.1.3 Connect via WiFi with DHCP IP from router === | ||
203 | |||
204 | |||
205 | [[image:1657086192720-649.png]] | ||
206 | |||
207 | |||
208 | If the LPS8N already connect to the router via WiFi, use can use the WiFi IP to connect to LPS8N. | ||
209 | |||
210 | |||
211 | === 2.1.4 Connect via Ethernet with fall back ip === | ||
212 | |||
213 | |||
214 | The WAN port also has a [[fall back ip address>>||anchor="H10.3A0IconfiguredLPS8NforWiFiaccessandlostitsIP.Whattodonow3F"]] for access if user doesn't connect to uplink router. Click [[here>>||anchor="H10.3A0IconfiguredLPS8NforWiFiaccessandlostitsIP.Whattodonow3F"]] to see how to configure. | ||
215 | |||
216 | |||
217 | == 2.2 Access Configure Web UI == | ||
218 | |||
219 | |||
220 | **Web Interface** | ||
221 | |||
222 | Open a browser on the PC and type the LPS8N ip address (depends on your connect method) | ||
223 | |||
224 | [[http:~~/~~/10.130.1.1/>>url:http://10.130.1.1/]] (Access via WiFi AP network) | ||
225 | |||
226 | or | ||
227 | |||
228 | http:~/~/IP_ADDRESS or [[http:~~/~~/ IP_ADDRESS:8000>>url:http://192.168.1.xx:8000]] | ||
229 | |||
230 | |||
231 | You will see the login interface of LPS8N as shown below. | ||
232 | |||
233 | The account details for Web Login are: | ||
234 | |||
235 | (% style="color:blue" %)**User Name: root** | ||
236 | |||
237 | (% style="color:blue" %)**Password: dragino** | ||
238 | |||
239 | [[image:1652414287022-223.png]] | ||
240 | |||
241 | |||
242 | = 3. Typical Network Setup = | ||
243 | |||
244 | == 3.1 Overview == | ||
245 | |||
246 | |||
247 | The LPS8N supports flexible network set up for different environments. This section describes the typical network topology. The network set up includes: | ||
248 | |||
249 | * **WAN Port Internet Mode** | ||
250 | * **WiFi Client Mode** | ||
251 | * **WiFi AP Mode** | ||
252 | |||
253 | |||
254 | |||
255 | == 3.2 Use WAN port to access Internet == | ||
256 | |||
257 | |||
258 | By default, the LPS8N is set to use the WAN port to connect to an upstream network. When you connect the LPS8N's WAN port to an upstream router, LPS8N will get an IP address from the router and have Internet access via the upstream router. The network status can be checked in the (% style="color:#4f81bd" %)**home page**: | ||
259 | |||
260 | |||
261 | [[image:1657088560833-398.png]] | ||
262 | |||
263 | |||
264 | == 3.3 Access the Internet as a WiFi Client == | ||
265 | |||
266 | |||
267 | In the WiFi Client Mode, LPS8N acts as a WiFi client and gets DHCP from an upstream router via WiFi. | ||
268 | |||
269 | ((( | ||
270 | The settings for WiFi Client is under page (% style="color:#4f81bd" %)**System~-~-> WiFi ~-~-> WiFi WAN Client Settings** | ||
271 | |||
272 | |||
273 | [[image:1657088818095-182.png]] | ||
274 | ))) | ||
275 | |||
276 | |||
277 | ((( | ||
278 | In the WiFi Survey Choose the WiFi AP, and input the Passphrase then click Save & Apply to connect. | ||
279 | |||
280 | |||
281 | ))) | ||
282 | |||
283 | == 3.4 Use built-in 4G modem for internet access == | ||
284 | |||
285 | |||
286 | ((( | ||
287 | ((( | ||
288 | If the LPS8N has 3G/4G Cellular modem, user can use it as main internet connection or back up. | ||
289 | ))) | ||
290 | |||
291 | |||
292 | ((( | ||
293 | First, install the Micro SIM card as below direction | ||
294 | ))) | ||
295 | |||
296 | ((( | ||
297 | Second, Power off/ ON LPS8N to let it detect the SIM card. | ||
298 | ))) | ||
299 | ))) | ||
300 | |||
301 | |||
302 | [[image:1657090855037-497.png]] | ||
303 | |||
304 | ((( | ||
305 | |||
306 | ))) | ||
307 | |||
308 | ((( | ||
309 | The set up page is (% style="color:#4f81bd" %)**System ~-~-> Cellular** | ||
310 | ))) | ||
311 | |||
312 | ((( | ||
313 | While use the cellular as Backup WAN, device will use Cellular for internet connection while WAN port or WiFi is not valid and switch back to WAN port or WiFi after they recover. | ||
314 | |||
315 | |||
316 | ))) | ||
317 | |||
318 | ((( | ||
319 | [[image:1657090932270-444.png]] | ||
320 | ))) | ||
321 | |||
322 | |||
323 | == 3.5 Check Internet connection == | ||
324 | |||
325 | |||
326 | In the (% style="color:#4f81bd" %)**home**(%%) page, we can check the Internet connection. | ||
327 | |||
328 | * GREEN Tick [[image:1652436675869-206.png||height="14" width="15"]] : This interface has Internet connection. | ||
329 | * Yellow Tick [[image:1652436705761-420.png||height="15" width="15"]] : This interface has IP address but don't use it for internet connection. | ||
330 | * RED Cross [[image:1652436787176-950.png||height="14" width="15"]] : This interface doesn't connected. | ||
331 | |||
332 | [[image:1657091099235-452.png]] | ||
333 | |||
334 | |||
335 | = 4. Example: Configure as a LoRaWAN gateway = | ||
336 | |||
337 | |||
338 | LPS8N is fully compatible with LoRaWAN protocol. It uses the legacy Semtech Packet forwarder to forward the LoRaWAN packets to server. The structure is as below. | ||
339 | |||
340 | |||
341 | ((( | ||
342 | [[image:image-20220826090251-1.png]] | ||
343 | ))) | ||
344 | |||
345 | ((( | ||
346 | This chapter describes how to use the LPS8N to work with (TTN v3)[[ LoRaWAN Server>>url:https://www.thethingsnetwork.org/]] ([[www.thethingsnetwork.org>>url:http://www.thethingsnetwork.org/]]) | ||
347 | ))) | ||
348 | |||
349 | |||
350 | == 4.1 Create a gateway in TTN V3 Server == | ||
351 | |||
352 | |||
353 | (% style="color:blue" %)**Step 1: Get a Unique gateway ID.** | ||
354 | |||
355 | |||
356 | ((( | ||
357 | Every LPS8N has a unique gateway id. The ID can be found at LoRaWAN page: | ||
358 | |||
359 | |||
360 | ))) | ||
361 | |||
362 | ((( | ||
363 | [[image:1657091583941-544.png]] | ||
364 | |||
365 | |||
366 | ))) | ||
367 | |||
368 | The example gateway id is: (% style="color:green" %)**a840411e96744154** | ||
369 | |||
370 | |||
371 | |||
372 | (% style="color:blue" %)**Step 2: Sign up a user account in TTN server** | ||
373 | |||
374 | |||
375 | [[**https:~~/~~/account.thethingsnetwork.org/register**>>url:https://account.thethingsnetwork.org/register]] | ||
376 | |||
377 | |||
378 | [[image:1657091739530-531.png]] | ||
379 | |||
380 | |||
381 | |||
382 | (% style="color:blue" %)**Step 3: Choose the TTNv3 Cluster Picker** | ||
383 | |||
384 | |||
385 | ((( | ||
386 | [[image:1657091719947-297.png]] | ||
387 | |||
388 | |||
389 | ))) | ||
390 | |||
391 | (% style="color:red" %)**Note: Choose the cluster corresponds to a specific Gateway server address** | ||
392 | |||
393 | |||
394 | * Europe 1** (% style="color:red" %)corresponding Gateway server address:(%%)**(% style="color:red" %) (% style="color:black" %)eu1.cloud.thethings.network | ||
395 | * North America 1 (% style="color:red" %)**corresponding Gateway server address: **(% style="color:black" %)nam1.cloud.thethings.network | ||
396 | * Australia 1 (% style="color:red" %)**corresponding Gateway server address: **(% style="color:black" %)au1.cloud.thethings.network | ||
397 | * Legacy V2 Console : (% style="color:red" %)**TTN v2 shuts down in December 2021** | ||
398 | |||
399 | (% style="color:blue" %)**Step 4: Create a Gateway** | ||
400 | |||
401 | |||
402 | [[image:1657091941182-367.png]] | ||
403 | |||
404 | Click the Gateway icon and then click Add gateway. | ||
405 | |||
406 | |||
407 | Open the following page: | ||
408 | |||
409 | |||
410 | [[image:image-20220706155323-5.png||height="579" width="1060"]] | ||
411 | |||
412 | |||
413 | [[image:image-20220706155323-6.png||height="582" width="1066"]] | ||
414 | |||
415 | |||
416 | ((( | ||
417 | (% style="color:red" %)**Notice: Gateway Server address must match the gateway configuration, otherwise you will have problem for End Node to join the network.** | ||
418 | |||
419 | |||
420 | ))) | ||
421 | |||
422 | After creating the gateway, you can see the gateway info, as below. | ||
423 | |||
424 | [[image:1657094130908-567.png]](% style="display:none" %) | ||
425 | |||
426 | |||
427 | == 4.2 Configure LPS8N to connect to TTN v3 == | ||
428 | |||
429 | |||
430 | ((( | ||
431 | You can now configure the LPS8N to let it connect to TTN network V3. | ||
432 | ))) | ||
433 | |||
434 | ((( | ||
435 | Make sure your LPS8N has a working Internet Connection first. | ||
436 | ))) | ||
437 | |||
438 | ((( | ||
439 | Choose the right server provider and click (% style="color:#4f81bd" %)**Save&Apply.** | ||
440 | |||
441 | |||
442 | ))) | ||
443 | |||
444 | [[image:1657094183213-301.png]] | ||
445 | |||
446 | |||
447 | (% style="color:red" %)**Note: The server address must match the Gateway server address you choose in TTN V3.** | ||
448 | |||
449 | |||
450 | In the home page, we can see the LoRaWAN connection is ready now. | ||
451 | |||
452 | |||
453 | [[image:1657094202420-798.png]] | ||
454 | |||
455 | |||
456 | |||
457 | In TTN v3 portal, we can also see the gateway is connected. | ||
458 | |||
459 | [[image:1657094221515-510.png]] | ||
460 | |||
461 | |||
462 | == 4.3 Configure frequency == | ||
463 | |||
464 | |||
465 | We also need to set the frequency plan in LPS8N to match the end node we use, so to receive the LoRaWAN packets from the LoRaWAN sensor. | ||
466 | |||
467 | |||
468 | [[image:1657094249818-468.png]] | ||
469 | |||
470 | |||
471 | |||
472 | In logread page, user can check the frequency actually used. | ||
473 | |||
474 | [[image:1657094333704-207.png]] | ||
475 | |||
476 | |||
477 | == 4.4 Add a LoRaWAN End Device == | ||
478 | |||
479 | |||
480 | ((( | ||
481 | This section shows how to add a LoRaWAN End device to a LoRaWAN network and see the data from TTN web site. | ||
482 | ))) | ||
483 | |||
484 | ((( | ||
485 | We use [[LT-22222-L>>url:http://www.dragino.com/products/lora-lorawan-end-node/item/156-lt-22222-l.html]] IO Controller as a reference device - the setup for other LoRaWAN devices will be similar. | ||
486 | ))) | ||
487 | |||
488 | [[image:1652422794767-871.png]] | ||
489 | |||
490 | |||
491 | ((( | ||
492 | (% style="color:blue" %)**Step 1**: (%%)Create a Device definition in TTN v3 with the OTAA keys from the example LT-22222-L IO Controller device. | ||
493 | |||
494 | |||
495 | ))) | ||
496 | |||
497 | ((( | ||
498 | Three codes are required to define the device in TTN v3: | ||
499 | ))) | ||
500 | |||
501 | * DEV EUI - Unique ID code for a particular device. | ||
502 | * APP EUI - ID code for an Application defined in TTN v3. | ||
503 | * APP Key - Unique key to secure communications with a particular device. | ||
504 | |||
505 | ((( | ||
506 | A set of these codes are stored in each device by the manufacturer as the default codes for that particular device. Each device is shipped with a sticker with the default Device EUI as shown below. | ||
507 | |||
508 | |||
509 | ))) | ||
510 | |||
511 | [[image:1657094382177-591.png]] | ||
512 | |||
513 | |||
514 | ((( | ||
515 | (% style="color:red" %)**Note: You may be able to change these codes in a device by using a configuration facility on the device e.g. the LT-22222 uses a serial port access and a series of AT commands. Changing the codes may be necessary in the case where you have to use codes assigned by a LoRa WAN server.** | ||
516 | |||
517 | |||
518 | ))) | ||
519 | |||
520 | ((( | ||
521 | For the TTN v3 server, you can use the codes set in the device as in the following example. | ||
522 | ))) | ||
523 | |||
524 | ((( | ||
525 | Select **Add Application** to open the screen below. | ||
526 | |||
527 | |||
528 | ))) | ||
529 | |||
530 | [[image:1657094417175-831.png]] | ||
531 | |||
532 | Open the **Application **select** Add end device** | ||
533 | |||
534 | |||
535 | Start Register the end device | ||
536 | |||
537 | [[image:1657094444802-101.png]] | ||
538 | |||
539 | ((( | ||
540 | Select OTAA activation mode | ||
541 | |||
542 | |||
543 | ))) | ||
544 | |||
545 | ((( | ||
546 | The LoRaWAN version for your device should be provided by the manufacturer in a datasheet as LoRaWAN version or LoRaWAN specification. The most commonly used LoRaWAN versions are v1.0.2 and v1.0.3. | ||
547 | ))) | ||
548 | |||
549 | [[image:1657094475730-208.png]] | ||
550 | |||
551 | First, input the End device ID, AppEUI and DevEUI. | ||
552 | |||
553 | |||
554 | [[image:1657094646429-966.png]] | ||
555 | |||
556 | Secondly, choose the corresponding frequency and LoRaWAN class capabilities. | ||
557 | |||
558 | |||
559 | [[image:1657094674045-755.png]] | ||
560 | |||
561 | ((( | ||
562 | Finally, Application layer settings input the corresponding AppKey. Before saving the configuration, check that the data matches the device. | ||
563 | |||
564 | |||
565 | ))) | ||
566 | |||
567 | ((( | ||
568 | (% style="color:blue" %)**Step 2**: (%%)Power on LT-22222-L device and it will automatically join the TTN network. After joining successfully, it will start to upload messages to the TTN v3. Select the Live data tab and you will see the data appearing in the panel. | ||
569 | |||
570 | |||
571 | ))) | ||
572 | |||
573 | ((( | ||
574 | (% style="color:red" %)**Note that it may take some time for the device data to appear in the TTN v3 display.** | ||
575 | |||
576 | |||
577 | ))) | ||
578 | |||
579 | [[image:1657094791060-639.png]] | ||
580 | |||
581 | |||
582 | = 5. Web Configure Pages = | ||
583 | |||
584 | == 5.1 Home == | ||
585 | |||
586 | |||
587 | Shows the system running status. | ||
588 | |||
589 | |||
590 | [[image:1657094893942-726.png]] | ||
591 | |||
592 | |||
593 | == 5.2 LoRa Settings == | ||
594 | |||
595 | === 5.2.1 LoRa ~-~-> LoRa === | ||
596 | |||
597 | |||
598 | ((( | ||
599 | This page shows the LoRa Radio Settings. There are a set of default frequency band according to LoRaWAN protocol, and user can customized the band* as well. | ||
600 | ))) | ||
601 | |||
602 | ((( | ||
603 | Different LPS8N hardware version can support different frequency range: | ||
604 | ))) | ||
605 | |||
606 | * (% style="color:blue" %)**868**(%%): valid frequency: 863Mhz ~~ 870Mhz. for bands EU868, RU864, IN865 or KZ865. | ||
607 | * (% style="color:blue" %)**915**(%%): valid frequency: 902Mhz ~~ 928Mhz. for bands US915, AU915, AS923 or KR920 | ||
608 | |||
609 | ((( | ||
610 | |||
611 | |||
612 | ((( | ||
613 | After user choose the frequency plan, he can see the actually frequency in used by checking the page (% style="color:green" %)**LogRead ~-~-> LoRa Log** | ||
614 | |||
615 | |||
616 | ))) | ||
617 | ))) | ||
618 | |||
619 | [[image:1657094930903-357.png]] | ||
620 | |||
621 | (% style="color:red" %)**Note *:** **[[See this instruction for how to customize frequency band>>doc:Main.How to customized LoRaWAN frequency band.WebHome]]** | ||
622 | |||
623 | |||
624 | === 5.2.2 LoRa ~-~-> ABP Decryption === | ||
625 | |||
626 | |||
627 | The LPS8N can communicate with LoRaWAN ABP End Node without the need of LoRaWAN server. It can be used in some cases such as: | ||
628 | |||
629 | * No internet connection. | ||
630 | * User wants to get data forward in gateway and forward to their server based on MQTT/HTTP, etc. (Combine ABP communication method and [[MQTT forward together>>doc:Main.MQTT Forward Instruction.WebHome]]). | ||
631 | |||
632 | ((( | ||
633 | Detail of this feature: **[[Communication with ABP End Node>>doc:Main.Communicate with ABP End Node without LoRaWAN Network Server --- LG308.WebHome]]** | ||
634 | |||
635 | |||
636 | ))) | ||
637 | |||
638 | [[image:1657095412271-942.png]] | ||
639 | |||
640 | |||
641 | == 5.3 LoRaWAN Settings == | ||
642 | |||
643 | === 5.3.1 LoRaWAN ~-~-> LoRaWAN === | ||
644 | |||
645 | |||
646 | 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. | ||
647 | |||
648 | |||
649 | [[image:1652423628833-467.png||height="357" width="755"]] | ||
650 | |||
651 | |||
652 | (% style="color:red" %)**Note:** | ||
653 | |||
654 | ~*: User can ignore the latitude and longitude settings here, LPS8N will use the actually value from GPS module. | ||
655 | |||
656 | ~**: Packet filter is to drop the unwanted LoRaWAN packet, instruction see here: | ||
657 | |||
658 | **See:** **[[Filter unwanted LoRaWAN packets>>doc:Main.Filter unwanted LoRaWAN packets.WebHome]]** | ||
659 | |||
660 | |||
661 | === 5.3.2 LoRaWAN ~-~-> LoRaWAN ~-~- Basic Station === | ||
662 | |||
663 | |||
664 | [[image:image-20230406172421-1.png]] | ||
665 | |||
666 | |||
667 | ((( | ||
668 | Please see this instruction to know more detail and a demo of how to connect to **[[AWS-IoT LoRaWAN Core>>doc:Main.AWS IoT Core for LoRaWAN.WebHome]].** | ||
669 | |||
670 | |||
671 | The basic station mode support **TTN/AWS/Chirpstack/ThingPark/Senet** Platform. | ||
672 | |||
673 | Instruction: | ||
674 | |||
675 | [[The Thing Network>>http://wiki.dragino.com/xwiki/bin/view/Main/Notes%20for%20TTN/#H3.A0GatewayRegistrationforBasicsStation]] | ||
676 | |||
677 | [[AWS-IoT LoRaWAN Core>>http://wiki.dragino.com/xwiki/bin/view/Main/AWS%20IoT%20Core%20for%20LoRaWAN/]] | ||
678 | |||
679 | [[Chirpstack>>http://wiki.dragino.com/xwiki/bin/view/Main/Notes%20for%20ChirpStack/#H3.A0GatewayRegistrationforBasicsStation]] | ||
680 | |||
681 | ThingPark | ||
682 | |||
683 | [[Senet>>http://wiki.dragino.com/xwiki/bin/view/Main/Connection%20to%20Senet/#H3.A0SemtechBasicStation]] | ||
684 | |||
685 | |||
686 | |||
687 | ))) | ||
688 | |||
689 | === 5.3.3 LoRaWAN ~-~-> LORIOT === | ||
690 | |||
691 | |||
692 | ((( | ||
693 | Settings to communicate to LORIOT LoRaWAN Network Server: [[https:~~/~~/www.loriot.io/>>url:https://www.loriot.io/]] | ||
694 | ))) | ||
695 | |||
696 | ((( | ||
697 | Instruction: **[[Notes for LORIOT>>doc:Main.Notes for LORIOT.WebHome]]** | ||
698 | |||
699 | |||
700 | ))) | ||
701 | |||
702 | [[image:1652428648903-878.png||height="266" width="731"]] | ||
703 | |||
704 | |||
705 | == 5.4 MQTT Settings == | ||
706 | |||
707 | |||
708 | ((( | ||
709 | If end nodes works in ABP mode, user can configure LPS8N to transfer the data to MQTT broker, | ||
710 | ))) | ||
711 | |||
712 | ((( | ||
713 | Instruction: **[[MQTT Forward Instruction>>doc:Main.MQTT Forward Instruction.WebHome]]** | ||
714 | ))) | ||
715 | |||
716 | |||
717 | [[image:1652428705046-212.png||height="417" width="733"]] | ||
718 | |||
719 | |||
720 | == 5.5 System == | ||
721 | |||
722 | === 5.5.1 System ~-~-> System Overview === | ||
723 | |||
724 | |||
725 | Shows the system info: | ||
726 | |||
727 | |||
728 | [[image:image-20220826091810-6.png]] | ||
729 | |||
730 | |||
731 | === 5.5.2 System ~-~-> General ( login settings) === | ||
732 | |||
733 | |||
734 | [[image:1657155183982-792.png]] | ||
735 | |||
736 | |||
737 | ((( | ||
738 | (% style="color:#037691" %)**__System Password:__** | ||
739 | ))) | ||
740 | |||
741 | ((( | ||
742 | There are two login for LPS8N: (% style="color:blue" %)**root /dragino** (%%)or (% style="color:blue" %)**admin /dragino**. (%%)Both root and admin has the same right for WEB access. But root user has also the right to access via SSH to Linux system. admin only able to access WEB interface. | ||
743 | ))) | ||
744 | |||
745 | ((( | ||
746 | This page can be used to set the password for them. | ||
747 | ))) | ||
748 | |||
749 | ((( | ||
750 | (% style="color:#037691" %)**__Timezone: __**(%%)Set device timezone. | ||
751 | ))) | ||
752 | |||
753 | ((( | ||
754 | (% style="color:#037691" %)**__Port forwarding: __**(%%)Enable/Disable the HTTP and SSH access via WAN interface. | ||
755 | |||
756 | |||
757 | ))) | ||
758 | |||
759 | === 5.5.3 System ~-~-> Network === | ||
760 | |||
761 | |||
762 | [[image:1657155288223-566.png]] | ||
763 | |||
764 | |||
765 | ((( | ||
766 | (% style="color:#037691" %)**__LAN Settings: __**(%%)When the LPS8N has the AP enable, LAN settings specify the network info for LPS8N's own network. | ||
767 | ))) | ||
768 | |||
769 | ((( | ||
770 | (% style="color:#037691" %)__**WAN Settings: **__(%%)Setting for LPS8N WAN port | ||
771 | ))) | ||
772 | |||
773 | ((( | ||
774 | (% style="color:#037691" %)__**WiFi Settings: **__** **(%%)Setting for LPS8N WiFi IP when use it as WiFi Client | ||
775 | |||
776 | |||
777 | ))) | ||
778 | |||
779 | === 5.5.4 System ~-~-> WiFi === | ||
780 | |||
781 | |||
782 | LPS8N WiFi Settings. | ||
783 | |||
784 | |||
785 | [[image:1657155457089-430.png]] | ||
786 | |||
787 | |||
788 | === 5.5.5 System ~-~-> Cellular === | ||
789 | |||
790 | |||
791 | While use the cellular as Backup WAN, device will use Cellular for internet connection while WAN port or WiFi is not valid and switch back to WAN port or WiFi after they recover. | ||
792 | |||
793 | |||
794 | [[image:1657155507672-204.png]] | ||
795 | |||
796 | |||
797 | (% style="color:red" %)**Note *: For LPS8N which doesn't have the cellular module, this page will shows Cellular not detected.** | ||
798 | |||
799 | |||
800 | === 5.5.6 System ~-~-> Network Status === | ||
801 | |||
802 | |||
803 | [[image:1657155554265-721.png]] | ||
804 | |||
805 | |||
806 | === 5.5.7 System ~-~-> Remote Mgnt & Auto Provision === | ||
807 | |||
808 | |||
809 | Auto Provision is the feature for batch configure and remote management. It can be used in below two cases: | ||
810 | |||
811 | |||
812 | [[image:image-20220707112053-4.png||height="451" width="995"]] | ||
813 | |||
814 | [[image:image-20220707112053-5.png||height="453" width="1004"]] | ||
815 | |||
816 | (% style="display:none" %) | ||
817 | |||
818 | (% style="display:none" %) [[image:1657157402578-508.png||height="450" width="992"]] | ||
819 | |||
820 | (% id="cke_bm_589629S" style="display:none" %) [[image:image-20220707092040-2.png||height="452" width="1002"]] | ||
821 | |||
822 | [[image:image-20220826091725-5.png||height="479" width="1004"]] | ||
823 | |||
824 | |||
825 | ((( | ||
826 | Please see this document for detail: [[http:~~/~~/www.dragino.com/downloads/index.php?dir=LoRa_Gateway/LPS8N/Firmware/Application_Note/&file=Auto-update-feature.pdf>>url:http://www.dragino.com/downloads/index.php?dir=LoRa_Gateway/LPS8/Firmware/Application_Note/&file=Auto-update-feature.pdf]] | ||
827 | ))) | ||
828 | |||
829 | (% style="display:none" %) (%%) | ||
830 | |||
831 | ((( | ||
832 | R-SSH is for remote access device and management, introduction for how to use: [[Remote Access Gateway>>doc:Main.Monitor & Remote Access Gateway.WebHome]] | ||
833 | |||
834 | |||
835 | ))) | ||
836 | |||
837 | [[image:1652429624400-864.png||height="432" width="716"]] | ||
838 | |||
839 | |||
840 | === 5.5.8 System ~-~-> Firmware Upgrade === | ||
841 | |||
842 | |||
843 | We keep improving the LPS8N Linux side firmware for new features and bug fixes. Below are the links for reference. | ||
844 | |||
845 | * **Latest firmware**: [[LoRa Gateway Firmware>>url:http://www.dragino.com/downloads/index.php?dir=LoRa_Gateway/LG02-OLG02/Firmware/]], | ||
846 | |||
847 | ( [[http:~~/~~/www.dragino.com/downloads/index.php?dir=LoRa_Gateway/LPS8N/Firmware>>url:http://www.dragino.com/downloads/index.php?dir=LoRa_Gateway/LIG16/Firmware]]) | ||
848 | |||
849 | * **Change Log**: [[Firmware Change Log>>url:http://www.dragino.com/downloads/downloads/LoRa_Gateway/LG02-OLG02/Firmware/ChangeLog]]. | ||
850 | |||
851 | ( [[http:~~/~~/www.dragino.com/downloads/downloads/LoRa_Gateway/LPS8N/Firmware/ChangeLog>>url:http://www.dragino.com/downloads/downloads/LoRa_Gateway/LIG16/Firmware/ChangeLog]] ) | ||
852 | |||
853 | |||
854 | ((( | ||
855 | The file named as (% style="color:green" %)**xxxxx–xxxxx-squashfs-sysupgrade.bin **(% style="color:black" %)is the upgrade Image. There are different methods to upgrade, as below. | ||
856 | ))) | ||
857 | |||
858 | ((( | ||
859 | (% style="color:green" %)**Web~-~-> System~-~-> Firmware Upgrade** | ||
860 | |||
861 | |||
862 | ))) | ||
863 | |||
864 | [[image:1657156052651-770.png]] | ||
865 | |||
866 | |||
867 | ((( | ||
868 | Select the required image and click (% style="color:blue" %)**Flash Image.**(%%) The image will be uploaded to the device, and then click (% style="color:blue" %)**Process Update**(%%) to upgrade. | ||
869 | ))) | ||
870 | |||
871 | |||
872 | ((( | ||
873 | (% style="color:red" %)**NOTE**: (%%)You normally need to (% style="color:blue" %)**//uncheck//**(%%) the (% style="color:blue" %)**Preserve Settings**(%%) checkbox when doing an upgrade to ensure that there is no conflict between the old settings and the new firmware. The new firmware will start up with its default settings. | ||
874 | |||
875 | |||
876 | ))) | ||
877 | |||
878 | ((( | ||
879 | The system will automatically boot into the new firmware after upgrade. | ||
880 | |||
881 | |||
882 | ))) | ||
883 | |||
884 | [[image:1657156094153-520.png]] | ||
885 | |||
886 | |||
887 | (% style="color:red" %)**NOTE***(%%): User can also upgrade firmware via Linux console | ||
888 | |||
889 | SCP the firmware to the system(% style="color:green" %)**/var**(%%)** **directory and then run | ||
890 | |||
891 | (% style="color:#4f81bd" %)**//root@OpenWrt:~~# /sbin/sysupgrade –n /var/Your_Image//** | ||
892 | |||
893 | |||
894 | (% style="color:red" %)**NOTE**(%%) : it is important to transfer the image in the /var directory, otherwise it may exceed the available flash size. | ||
895 | |||
896 | |||
897 | === 5.5.9 System ~-~-> Reboot/Reset === | ||
898 | |||
899 | |||
900 | [[image:1652430197132-330.png||height="256" width="724"]] | ||
901 | |||
902 | ((( | ||
903 | |||
904 | ))) | ||
905 | |||
906 | === 5.5.10 System ~-~-> Package Maintain === | ||
907 | |||
908 | |||
909 | [[image:1657156199070-491.png]] | ||
910 | |||
911 | |||
912 | Place to show what package has installed and possible to upgrade packages. | ||
913 | |||
914 | |||
915 | == 5.6 LogRead == | ||
916 | |||
917 | === 5.6.1 LogRead ~-~-> LoRa Log === | ||
918 | |||
919 | |||
920 | Show the frequency for LoRa Radio and traffics. | ||
921 | |||
922 | |||
923 | [[image:1657156300781-933.png]] | ||
924 | |||
925 | |||
926 | === 5.6.2 LogRead ~-~-> System Log === | ||
927 | |||
928 | |||
929 | Show the system log | ||
930 | |||
931 | |||
932 | [[image:1657156341198-226.png]] | ||
933 | |||
934 | |||
935 | = 6. More features = | ||
936 | |||
937 | == 6.1 Packet Filtering == | ||
938 | |||
939 | |||
940 | ((( | ||
941 | Drop unwanted packets. | ||
942 | ))) | ||
943 | |||
944 | ((( | ||
945 | See: [[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/Filter%20unwanted%20LoRaWAN%20packets/>>url:http://wiki.dragino.com/xwiki/bin/view/Main/Filter%20unwanted%20LoRaWAN%20packets/]] | ||
946 | ))) | ||
947 | |||
948 | |||
949 | == 6.2 Remote Access == | ||
950 | |||
951 | |||
952 | ((( | ||
953 | Remote Access Devices for management. | ||
954 | ))) | ||
955 | |||
956 | ((( | ||
957 | Instruction: [[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/Monitor%20%26%20Remote%20Access%20Gateway/?Remote%20Access>>http://wiki.dragino.com/xwiki/bin/view/Main/Monitor%20%26%20Remote%20Access%20Gateway/?Remote%20Access]] | ||
958 | ))) | ||
959 | |||
960 | |||
961 | == 6.3 How to decode ABP LoRaWAN node == | ||
962 | |||
963 | |||
964 | ((( | ||
965 | Decode ABP: | ||
966 | ))) | ||
967 | |||
968 | ((( | ||
969 | [[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/Communicate%20with%20ABP%20End%20Node%20without%20LoRaWAN%20Network%20Server%20~~-~~--%20LG308/>>url:http://wiki.dragino.com/xwiki/bin/view/Main/Communicate%20with%20ABP%20End%20Node%20without%20LoRaWAN%20Network%20Server%20---%20LG308/]] | ||
970 | ))) | ||
971 | |||
972 | |||
973 | == 6.4 How to set data to MQTT broker == | ||
974 | |||
975 | |||
976 | ((( | ||
977 | Only support ABP LoRaWAN End Node | ||
978 | ))) | ||
979 | |||
980 | ((( | ||
981 | Instruction: [[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/MQTT%20Forward%20Instruction/>>url:http://wiki.dragino.com/xwiki/bin/view/Main/MQTT%20Forward%20Instruction/]] | ||
982 | |||
983 | |||
984 | == 6.5 How the gateway connects to Chirpstack v3/v4 via gateway-bridge == | ||
985 | |||
986 | |||
987 | If the Chirpstack v3 Gateway-bridge is used, the corresponding gateway firmware must be used : | ||
988 | |||
989 | [[Chirpstack-gateway-bridge/Chirpstack-Bridge-V3.14.6-Bridge~~-~~-build-v5.4.1679487778-20230322-2024/>>https://www.dragino.com/downloads/index.php?dir=LoRa_Gateway/LPS8/Firmware/Release/Chirpstack-gateway-bridge/Chirpstack-Bridge-V3.14.6-Bridge--build-v5.4.1679487778-20230322-2024/]] | ||
990 | |||
991 | Chirpstack v3 via gateway-bridge Instruction: [[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/Notes%20for%20ChirpStack/#H4.A0A0HowthegatewayconnectstoChirpstackv3viagateway-bridge>>http://wiki.dragino.com/xwiki/bin/view/Main/Notes%20for%20ChirpStack/#H4.A0A0HowthegatewayconnectstoChirpstackv3viagateway-bridge]] | ||
992 | |||
993 | |||
994 | If the Chirpstack v4 Gateway-bridge is used, the corresponding gateway firmware must be used : | ||
995 | |||
996 | [[Chirpstack-gateway-bridge/Chirpstack-Bridge-V4~~-~~-build-v5.4.1670655072-20221210-1452/>>https://www.dragino.com/downloads/index.php?dir=LoRa_Gateway/LPS8/Firmware/Release/Chirpstack-gateway-bridge/Chirpstack-Bridge-V4--build-v5.4.1670655072-20221210-1452/]] | ||
997 | |||
998 | Chirpstack v4 via gateway-bridge Instruction: [[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/Notes%20for%20ChirpStack/#H4.A0HowthegatewayconnectstoChirpstackv4viagateway-bridge>>http://wiki.dragino.com/xwiki/bin/view/Main/Notes%20for%20ChirpStack/#H4.A0HowthegatewayconnectstoChirpstackv4viagateway-bridge]] | ||
999 | |||
1000 | |||
1001 | ))) | ||
1002 | |||
1003 | (% style="color:red" %)**Note**(%%): Different chirpstack versions use different gateway-bridge configurations. | ||
1004 | |||
1005 | After updating the Chirpstack gateway-bridge firmware, there is no need to re-download and install the Chirpstack gateway-bridge package | ||
1006 | |||
1007 | |||
1008 | == 6.6 How to extend the gateway size of memory with USB device (SD/TF card, USB flash drive). == | ||
1009 | |||
1010 | |||
1011 | USB card reader plugged into the USB port of the gateway | ||
1012 | |||
1013 | |||
1014 | Access the gateway Linux Command Line | ||
1015 | |||
1016 | |||
1017 | Check the USB device | ||
1018 | |||
1019 | [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20All%20Gateway%20models/DLOS8N/WebHome/image-20230425165308-2.png?rev=1.1||alt="image-20230425165308-2.png" height="274" width="718"]] | ||
1020 | |||
1021 | |||
1022 | **Mount the USB device** | ||
1023 | |||
1024 | (% class="box infomessage" %) | ||
1025 | ((( | ||
1026 | **mount /dev/sda1 /mnt/** | ||
1027 | ))) | ||
1028 | |||
1029 | (% class="wikigeneratedid" %) | ||
1030 | [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20All%20Gateway%20models/DLOS8N/WebHome/image-20230425174131-4.png?rev=1.1||alt="image-20230425174131-4.png"]] | ||
1031 | |||
1032 | |||
1033 | (% class="wikigeneratedid" %) | ||
1034 | **Set up the automatic mount on boot** | ||
1035 | |||
1036 | (% class="box infomessage" %) | ||
1037 | ((( | ||
1038 | **sed -i '3cmount \/dev\/sda1 \/mnt\/' /etc/rc.local ** | ||
1039 | ))) | ||
1040 | |||
1041 | (% class="wikigeneratedid" %) | ||
1042 | [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20All%20Gateway%20models/DLOS8N/WebHome/image-20230425173831-3.png?width=833&height=105&rev=1.1||alt="image-20230425173831-3.png"]] | ||
1043 | |||
1044 | |||
1045 | == 6.7 More instructions == | ||
1046 | |||
1047 | |||
1048 | [[LoRaWAN Gateway Instruction>>doc:Main.WebHome]](LoRaWAN Gateway) | ||
1049 | |||
1050 | |||
1051 | == 6.8 Auto-Provision == | ||
1052 | |||
1053 | |||
1054 | Auto Provision is the feature for batch configure and remote management. It can be used in below two cases: | ||
1055 | |||
1056 | [[image:image-20220707092040-1.png||height="451" width="995"]] | ||
1057 | |||
1058 | [[image:image-20220707092040-2.png||height="452" width="1002"]] | ||
1059 | |||
1060 | [[image:image-20220826091546-4.png]](% style="display:none" %) | ||
1061 | |||
1062 | |||
1063 | ((( | ||
1064 | Please see this document for detail: [[http:~~/~~/www.dragino.com/downloads/index.php?dir=LoRa_Gateway/LPS8N/Firmware/Application_Note/&file=Auto-update-feature.pdf>>url:http://www.dragino.com/downloads/index.php?dir=LoRa_Gateway/LPS8/Firmware/Application_Note/&file=Auto-update-feature.pdf]] | ||
1065 | ))) | ||
1066 | |||
1067 | (% style="display:none" %) (%%) | ||
1068 | |||
1069 | = 7. (% style="display:none" %) (%%)Linux System = | ||
1070 | |||
1071 | |||
1072 | The LPS8N is based on the OpenWrt Linux system. It is open source, and users are free to configure and modify the Linux settings. | ||
1073 | |||
1074 | (% style="display:none" %) (%%) | ||
1075 | |||
1076 | == 7.1 SSH Access for Linux console == | ||
1077 | |||
1078 | |||
1079 | User can access the Linux console via the SSH protocol. Make sure your PC and the LPS8N are connected to the same network, then use a SSH tool (such as [[putty>>url:http://www.chiark.greenend.org.uk/~~sgtatham/putty/download.html]] in Windows) to access it. | ||
1080 | |||
1081 | IP address: IP address of LPS8N | ||
1082 | |||
1083 | Port: 22 (via WiFi AP mode) or 2222 (via WAN Interface) | ||
1084 | |||
1085 | User Name: (% style="color:green" %)**root** | ||
1086 | |||
1087 | Password: (% style="color:green" %)**dragino** (% style="color:black" %)(default) | ||
1088 | |||
1089 | After logging in, you will be in the Linux console and can enter commands as shown below. | ||
1090 | |||
1091 | |||
1092 | [[image:1657158198733-338.png]] | ||
1093 | |||
1094 | |||
1095 | The “** (% style="background-color:yellow" %)logread -f(%%)**(% style="background-color:yellow" %)” (%%)command can be used to debug how system runs. | ||
1096 | |||
1097 | |||
1098 | [[image:1657158190234-805.png]] | ||
1099 | |||
1100 | |||
1101 | == 7.2 Edit and Transfer files == | ||
1102 | |||
1103 | |||
1104 | ((( | ||
1105 | The LPS8N supports the (% style="color:green" %)**SCP protocol** (% style="color:black" %)and has a built-in (% style="color:green" %)**SFTP server**. (% style="color:black" %)There are many ways to edit and transfer files using these protocols. | ||
1106 | ))) | ||
1107 | |||
1108 | ((( | ||
1109 | In Windows, one of the easiest methods is using the [[WinSCP>>url:https://winscp.net/eng/index.php]] utility. | ||
1110 | ))) | ||
1111 | |||
1112 | ((( | ||
1113 | After establishing access via WinSCP to the device, you can use an FTP style window to drag / drop files to the LPS8N, or edit the files directly in the windows. | ||
1114 | ))) | ||
1115 | |||
1116 | ((( | ||
1117 | Screenshot is as below: | ||
1118 | ))) | ||
1119 | |||
1120 | [[image:1652431650755-450.png]] | ||
1121 | |||
1122 | |||
1123 | == 7.3 File System == | ||
1124 | |||
1125 | |||
1126 | ((( | ||
1127 | The LPS8N has a 16MB flash and a 64MB RAM. The /var and /tmp directories are in the RAM, so contents stored in /tmp and /var will be erased after rebooting the device. Other directories are in the flash and will remain after reboot. | ||
1128 | ))) | ||
1129 | |||
1130 | ((( | ||
1131 | The Linux system uses around 8MB ~~10MB flash size which means there is not much room for user to store data in the LPS8N flash. | ||
1132 | ))) | ||
1133 | |||
1134 | ((( | ||
1135 | You can use an external USB flash memory device to extend the size of flash memory for storage. | ||
1136 | ))) | ||
1137 | |||
1138 | |||
1139 | == 7.4 Package maintenance system == | ||
1140 | |||
1141 | |||
1142 | LPS8N uses the OpenWrt [[**OPKG package maintenance system**>>https://oldwiki.archive.openwrt.org/doc/techref/opkg]]. There are more than 3000+ packages available in our package server for users to install for their applications. For example, if you want to add the **//iperf //** tool, you can install the related packages and configure LPS8N to use **//iperf //**. | ||
1143 | |||
1144 | ((( | ||
1145 | Below are some example **//opkg //** commands. For more information please refer to the [[OPKG package maintain system>>https://oldwiki.archive.openwrt.org/doc/techref/opkg]]** **([[https:~~/~~/oldwiki.archive.openwrt.org/doc/techref/opkg>>https://oldwiki.archive.openwrt.org/doc/techref/opkg]]) | ||
1146 | ))) | ||
1147 | |||
1148 | ((( | ||
1149 | **In Linux Console run:** | ||
1150 | ))) | ||
1151 | |||
1152 | ((( | ||
1153 | (% style="color:green" %)**root@dragino-169d30:~~# opkg update** (% style="color:black" %)~/~/ to get the latest packages list | ||
1154 | ))) | ||
1155 | |||
1156 | ((( | ||
1157 | (% style="color:green" %)**root@dragino-169d30:~~# opkg list** (% style="color:black" %) ~/~/shows the available packages | ||
1158 | ))) | ||
1159 | |||
1160 | ((( | ||
1161 | (% style="color:green" %)**root@dragino-169d30:~~# opkg install iperf ** (% style="color:black" %)~/~/ install iperf | ||
1162 | ))) | ||
1163 | |||
1164 | The system will automatically install the required packages as shown below. | ||
1165 | |||
1166 | |||
1167 | ((( | ||
1168 | (% style="background-color:#dcdcdc" %)//root@dragino-169d30:/etc/opkg# opkg install iperf// | ||
1169 | ))) | ||
1170 | |||
1171 | ((( | ||
1172 | (% style="background-color:#dcdcdc" %)//Installing iperf (2.0.12-1) to root…// | ||
1173 | ))) | ||
1174 | |||
1175 | ((( | ||
1176 | (% style="background-color:#dcdcdc" %)//Downloading //[[(% style="background-color: rgb(220, 220, 220); background-color: rgb(220, 220, 220)" %)//http:~~/~~/downloads.openwrt.org/snapshots/packages/mips_24kc/base/iperf_2.0.12-1_mips_24kc.ipk//>>url:http://downloads.openwrt.org/snapshots/packages/mips_24kc/base/iperf_2.0.12-1_mips_24kc.ipk]] | ||
1177 | ))) | ||
1178 | |||
1179 | ((( | ||
1180 | (% style="background-color:#dcdcdc" %)//Installing uclibcxx (0.2.4-3) to root…// | ||
1181 | ))) | ||
1182 | |||
1183 | ((( | ||
1184 | (% style="background-color:#dcdcdc" %)//Downloading //[[(% style="background-color: rgb(220, 220, 220); background-color: rgb(220, 220, 220)" %)//http:~~/~~/downloads.openwrt.org/snapshots/packages/mips_24kc/base/uclibcxx_0.2.4-3_mips_24kc.ipk//>>url:http://downloads.openwrt.org/snapshots/packages/mips_24kc/base/uclibcxx_0.2.4-3_mips_24kc.ipk]] | ||
1185 | ))) | ||
1186 | |||
1187 | ((( | ||
1188 | (% style="background-color:#dcdcdc" %)//Configuring uclibcxx.// | ||
1189 | ))) | ||
1190 | |||
1191 | ((( | ||
1192 | (% style="background-color:#dcdcdc" %)//Configuring iperf.// | ||
1193 | |||
1194 | |||
1195 | ))) | ||
1196 | |||
1197 | = 8. Upgrade Linux Firmware = | ||
1198 | |||
1199 | |||
1200 | We keep improving the LPS8N Linux side firmware for new features and bug fixes. Below are the links for reference. | ||
1201 | |||
1202 | * **Latest firmware**: [[LoRa Gateway Firmware>>url:http://www.dragino.com/downloads/index.php?dir=LoRa_Gateway/LG02-OLG02/Firmware/]], | ||
1203 | |||
1204 | ( [[http:~~/~~/www.dragino.com/downloads/index.php?dir=LoRa_Gateway/LPS8N/Firmware>>url:http://www.dragino.com/downloads/index.php?dir=LoRa_Gateway/LIG16/Firmware]]) | ||
1205 | |||
1206 | * **Change Log**: [[Firmware Change Log>>url:http://www.dragino.com/downloads/downloads/LoRa_Gateway/LG02-OLG02/Firmware/ChangeLog]]. | ||
1207 | |||
1208 | ( [[http:~~/~~/www.dragino.com/downloads/downloads/LoRa_Gateway/LPS8N/Firmware/ChangeLog>>url:http://www.dragino.com/downloads/downloads/LoRa_Gateway/LIG16/Firmware/ChangeLog]] ) | ||
1209 | |||
1210 | |||
1211 | ((( | ||
1212 | The file named as (% style="color:green" %)** xxxxx–xxxxx-squashfs-sysupgrade.bin **(%%)is the upgrade Image. There are different methods to upgrade, as below. | ||
1213 | ))) | ||
1214 | |||
1215 | |||
1216 | == 8.1 Upgrade via Web UI == | ||
1217 | |||
1218 | |||
1219 | ((( | ||
1220 | Go to the page: (% style="color:green" %)**Web ~-~-> System ~-~-> Firmware Upgrade** | ||
1221 | ))) | ||
1222 | |||
1223 | ((( | ||
1224 | Select the required image and click (% style="color:red" %)**Flash Image.**(%%) The image will be uploaded to the device, and then click (% style="color:red" %)**Process Update**(%%) to upgrade. | ||
1225 | ))) | ||
1226 | |||
1227 | |||
1228 | ((( | ||
1229 | (% style="color:red" %)**NOTE**(%%): You normally need to (% style="color:blue" %)**//uncheck//**(%%) the (% style="color:blue" %)//**Preserve Settings**//(%%) checkbox when doing an upgrade to ensure that there is no conflict between the old settings and the new firmware. The new firmware will start up with its default settings. | ||
1230 | ))) | ||
1231 | |||
1232 | |||
1233 | ((( | ||
1234 | The system will automatically boot into the new firmware after upgrade. | ||
1235 | |||
1236 | |||
1237 | ))) | ||
1238 | |||
1239 | [[image:1657158986600-386.png]] | ||
1240 | |||
1241 | |||
1242 | == 8.2 Upgrade via Linux console == | ||
1243 | |||
1244 | |||
1245 | ((( | ||
1246 | SCP the firmware to the system** (% style="color:green" %)/var(%%)** directory and then run | ||
1247 | ))) | ||
1248 | |||
1249 | ((( | ||
1250 | (% style="color:#4472c4" %)** //root@OpenWrt:~~# /sbin/sysupgrade –n /var/Your_Image//** | ||
1251 | ))) | ||
1252 | |||
1253 | |||
1254 | ((( | ||
1255 | (% style="color:red" %)**NOTE**(%%): it is important to transfer the image in the /var directory, otherwise it may exceed the available flash size. | ||
1256 | ))) | ||
1257 | |||
1258 | |||
1259 | = 9. OTA System Update = | ||
1260 | |||
1261 | |||
1262 | LPS8N 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. | ||
1263 | |||
1264 | |||
1265 | = 10. FAQ = | ||
1266 | |||
1267 | == 10.1 How can I configure for a customized frequency band? == | ||
1268 | |||
1269 | |||
1270 | ((( | ||
1271 | See below link for how to customize frequency band: [[How to customized LoRaWAN frequency band>>doc:Main.How to customized LoRaWAN frequency band.WebHome]] | ||
1272 | ))) | ||
1273 | |||
1274 | ((( | ||
1275 | |||
1276 | ))) | ||
1277 | |||
1278 | == 10.2 Can I make my own firmware for the gateway, where can I find the source code? == | ||
1279 | |||
1280 | |||
1281 | ((( | ||
1282 | Yes, You can make your own firmware for the LPS8N for branding purposes or to add customized applications. | ||
1283 | ))) | ||
1284 | |||
1285 | ((( | ||
1286 | The source code and compile instructions can be found at: [[https:~~/~~/github.com/dragino/openwrt_lede-18.06>>url:https://github.com/dragino/openwrt_lede-18.06]] | ||
1287 | ))) | ||
1288 | |||
1289 | ((( | ||
1290 | |||
1291 | ))) | ||
1292 | |||
1293 | == 10.3 Can I use 868Mhz version for 915Mhz bands? == | ||
1294 | |||
1295 | |||
1296 | It is possible but the distance will be very short, you can select US915 frequency band in 868Mhz version hardware. It will work but you will see the performance is greatly decreased because the 868Mhz version has an RF filter for band 863~~870Mhz, all other frequencies will have high attenuation. | ||
1297 | |||
1298 | |||
1299 | = 11. Trouble Shooting = | ||
1300 | |||
1301 | == 11.1 I get kernel error when install new package, how to fix? == | ||
1302 | |||
1303 | |||
1304 | In some cases, when installing a package with **//opkg//**, it will generate a kernel error such as below due to a mismatch I the kernel ID: | ||
1305 | |||
1306 | (% style="background-color:yellow" %)root@dragino-16c538:~~# opkg install kmod-dragino2-si3217x_3.10.49+0.2-1_ar71xx.ipk | ||
1307 | |||
1308 | (% style="background-color:yellow" %)Installing kmod-dragino2-si3217x (3.10.49+0.2-1) to root… | ||
1309 | |||
1310 | (% style="background-color:yellow" %)Collected errors: | ||
1311 | |||
1312 | (% style="background-color:yellow" %)* satisfy_dependencies_for: Cannot satisfy the following dependencies for kmod-dragino2-si3217x: | ||
1313 | |||
1314 | (% style="background-color:yellow" %)* kernel (= 3.10.49-1-4917516478a753314254643facdf360a) * | ||
1315 | |||
1316 | (% style="background-color:yellow" %)* opkg_install_cmd: Cannot install package kmod-dragino2-si3217x. | ||
1317 | |||
1318 | ((( | ||
1319 | In this case, you can use the –force-depends option to install such package as long as the actual kernel version is the same. | ||
1320 | ))) | ||
1321 | |||
1322 | (% style="background-color:yellow" %)Opkg install kmod-dragino2-si3217x_3.10.49+0.2-1_ar71xx.ipk –force-depends | ||
1323 | |||
1324 | |||
1325 | == 11.2 How to recover the LPS8N if the firmware crashes == | ||
1326 | |||
1327 | |||
1328 | ((( | ||
1329 | Please follow this instruction to recover your gateway: [[Recover Gateway>>doc:Main.How to Recover Gateway if can't access it.WebHome]] | ||
1330 | ))) | ||
1331 | |||
1332 | ((( | ||
1333 | |||
1334 | ))) | ||
1335 | |||
1336 | == 11.3 I configured LPS8N for WiFi access and lost its IP. What to do now? == | ||
1337 | |||
1338 | |||
1339 | [[image:1657159323292-776.png]] | ||
1340 | |||
1341 | |||
1342 | ((( | ||
1343 | The LPS8N has a fall-back IP address on its WAN port. This IP is always enabled so you can use the fall-back IP to access LPS8N no matter what the WiFi IP is. The fall back IP is useful for connecting and debug the unit. | ||
1344 | ))) | ||
1345 | |||
1346 | (% style="color:red" %)**Note: fallback IP can be disabled in the WAN and DHCP page.** | ||
1347 | |||
1348 | |||
1349 | **Steps to connect via fall back IP:** | ||
1350 | |||
1351 | ~1. Connect PC's Ethernet port to LG01's WAN port | ||
1352 | |||
1353 | 2. Configure PC's Ethernet port has | ||
1354 | IP: 172.31.255.253 and | ||
1355 | Netmask: 255.255.255.252 | ||
1356 | |||
1357 | |||
1358 | As below photo: | ||
1359 | |||
1360 | [[image:1652435256286-879.png]] | ||
1361 | |||
1362 | |||
1363 | 3. In the PC, use IP address 172.31.255.254 to access the LPS8N via Web or Console. | ||
1364 | |||
1365 | Please note the latest firmware uses port 8000 for http and 2222 for ssh access. | ||
1366 | |||
1367 | |||
1368 | == 11.4 I connect to the LPS8N's SSID but LPS8N didn't assign DHCP IP to my laptop? == | ||
1369 | |||
1370 | |||
1371 | ((( | ||
1372 | This is a known bug for the firmware version before 2019-09-23 for LPS, the issue was fixed since version: LG02_LG08~-~-build-v5.2.1569218466-20190923-1402. | ||
1373 | ))) | ||
1374 | |||
1375 | ((( | ||
1376 | In the old version, user can use the [[fall back ip method >>||anchor="H10.3A0IconfiguredLPS8NforWiFiaccessandlostitsIP.Whattodonow3F"]]to access and configure the device. | ||
1377 | ))) | ||
1378 | |||
1379 | |||
1380 | = 12. Order Info = | ||
1381 | |||
1382 | |||
1383 | **PART: (% style="color:blue" %)LPS8N-XXX-YYY: (%%)** | ||
1384 | |||
1385 | (% style="color:blue" %) **XXX:**(%%)** Frequency Band** | ||
1386 | |||
1387 | * (% style="color:red" %)** 868**(% style="color:black" %) : valid frequency: 863Mhz ~~ 870Mhz. for bands EU868, RU864, IN865 or KZ865. | ||
1388 | * (% style="color:red" %)** 915**(% style="color:black" %): valid frequency: 902Mhz ~~ 928Mhz. for bands US915, AU915, AS923 or KR920 | ||
1389 | |||
1390 | (% style="color:blue" %) **YYY:**(%%)** 4G Cellular Option** | ||
1391 | |||
1392 | * (% style="color:red" %)**EC25-E**(% style="color:black" %): EMEA, Korea, Thailand, India. | ||
1393 | * (% style="color:red" %)**EC25-AFX**(% style="color:black" %): America:Verizon, AT&T(FirstNet), U.S.Cellular; Canada:Telus | ||
1394 | * (% style="color:red" %)**EC25-AUX**(% style="color:black" %): Latin America, New Zeland, Taiwan | ||
1395 | * (% style="color:red" %)**EC25-J**(% style="color:black" %): Japan, DOCOMO, SoftBank, KDDI | ||
1396 | |||
1397 | More info about valid bands, please see [[EC25-E product page>>url:https://www.quectel.com/product/ec25.htm]]. | ||
1398 | |||
1399 | |||
1400 | = 13. Packing Info = | ||
1401 | |||
1402 | |||
1403 | ((( | ||
1404 | **Package Includes**: | ||
1405 | ))) | ||
1406 | |||
1407 | * LPS8N LoRaWAN Gateway x 1 | ||
1408 | * Stick Antenna for LoRa RF part. Frequency is one of 470 or 868 or 915Mhz depends the model ordered | ||
1409 | * Packaging with environmental protection paper box | ||
1410 | |||
1411 | ((( | ||
1412 | **Dimension and weight**: | ||
1413 | ))) | ||
1414 | |||
1415 | * Device Size: 12 x 12 x 3 cm | ||
1416 | * Weight: 187g | ||
1417 | * Package Size: 14.5 x 13.5 x 6 cm | ||
1418 | * Weight: 300g | ||
1419 | |||
1420 | |||
1421 | |||
1422 | = 14. Support = | ||
1423 | |||
1424 | |||
1425 | * Try to see if your questions already answered in the [[wiki>>doc:Main.WebHome]]. | ||
1426 | * Support is provided Monday to Friday, from 09:00 to 18:00 GMT+8. | ||
1427 | Due to different timezones we cannot offer live support. However, your questions will be answered as soon as possible in the before mentioned schedule. | ||
1428 | * Provide as much information as possible regarding your enquiry (product models, accurately describe your problem and steps to replicate it etc) and send a mail to:[[support@dragino.com>>url:file:///C:/Users/11315/Documents/D:/Projects/LoRa%20Product%20Line/LG308%20Picocell%20Gateway/LG308/LG308%20%25E8%25AF%25B4%25E6%2598%258E%25E4%25B9%25A6/support@dragino.com]] | ||
1429 | |||
1430 |