Version 102.1 by Xiaoling on 2022/07/06 13:39

Show last authors
1 (% style="text-align:center" %)
2 [[image:1656917428377-954.png||height="475" width="475"]]
3
4
5
6
7 **Table of Contents:**
8
9
10
11
12
13
14
15
16
17
18
19
20
21 (% style="color:inherit; font-family:inherit; font-size:29px" %)1.  Introduction
22
23 == 1.1  What is the LPS8N ==
24
25
26
27 (((
28 The LPS8N is an (% style="color:#4f81bd" %)**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.
29 )))
30
31 (((
32 The LPS8N uses (% style="color:#4f81bd" %)**Semtech packet forwarder**(%%) & (% style="color:#4f81bd" %)**LoRaWAN Station connection**(%%) and fully compatible with LoRaWAN protocol. It includes a (% style="color:#4f81bd" %)**SX1302 LoRaWAN concentrator**(%%), which provides 10 programmable parallel demodulation paths.
33 )))
34
35 (((
36 LPS8N has (% style="color:#4f81bd" %)**pre-configured standard LoRaWAN frequency bands**(%%) to use for different countries. User can also (% style="color:#4f81bd" %)**customized the frequency bands** (%%)to use in their own LoRa network.
37 )))
38
39 (((
40 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.
41 )))
42
43 (((
44
45 )))
46
47 [[image:1656918270059-192.png]]
48
49
50 == 1.2  Specifications ==
51
52
53 (% style="color:#037691" %)**Hardware System:**
54
55 (((
56 Linux Part:
57 )))
58
59 * 400Mhz ar9331 processor
60 * 64MB RAM
61 * 16MB Flash
62
63
64 (% style="color:#037691" %)**Interface:**
65
66 * 10M/100M RJ45 Ports x 1
67 * WiFi : 802.11 b/g/n
68 * LoRaWAN Wireless
69 * Power Input: 5V DC, 2A, Type C
70 * USB 2.0 host connector x 1
71 * Mini-PCI E connector x 1
72 * SX1302 + 2 x SX1250
73
74
75 (% style="color:#037691" %)**WiFi Spec:**
76
77 * IEEE 802.11 b/g/n
78 * Frequency Band: 2.4 ~~ 2.462GHz
79 * Tx power:
80 ** 11n tx power : mcs7/15: 11db     mcs0 : 17db
81 ** 11b tx power: 18db
82 ** 11g 54M tx power: 12db
83 ** 11g 6M tx power: 18db
84 * Wifi Sensitivity
85 ** 11g 54M : -71dbm
86 ** 11n 20M : -67dbm
87
88
89 (% style="color:#037691" %)**LoRa Spec:**
90
91 * Up to -140 dBm sensitivity
92 * 70 dB CW interferer rejection at 1 MHz offset
93 * Able to operate with negative SNR, CCR up to 9dB
94 * Emulates 49 x LoRa demodulators and 1 x (G)FSK demodulator
95 * Dual digital TX & RX radio front-end interfaces
96 * 10 programmable parallel demodulation paths
97 * Dynamic data-rate (DDR) adaptation
98 * True antenna diversity or simultaneous dual-band operation
99
100
101 (% style="color:#037691" %)**Cellular 4G LTE (optional):**
102
103 * Quectel [[**EC25 LTE module**>>url:https://www.quectel.com/product/ec25minipcie.htm]]
104 * Micro SIM Slot
105 * External 4G Sticker Antenna.
106 * Up to 150Mbps downlink and 50Mbps uplink data rates
107 * Worldwide LTE,UMTS/HSPA+ and GSM/GPRS/EDGE coverage
108 * MIMO technology meets demands for data rate and link reliability in modem wireless communication systems
109
110
111
112 == 1.3  Features ==
113
114
115 * Open Source OpenWrt system
116 * Managed by Web GUI, SSH via WAN or WiFi
117 * Remote access with Reverse-SSH or remote.it
118 * Emulates 49x LoRa demodulators
119 * LoRaWAN Gateway
120 * 10 programmable parallel demodulation paths
121 * Pre-configure to support different LoRaWAN regional settings.
122 * Allow to customize LoRaWAN regional parameters.
123 * Support Local decode ABP end node info and transfer to MQTT server
124 * Support different level log in.
125 * Support Semtech Packet Forwarder
126 * Support LoRaWAN basic station.
127 * Optional 3G/4G cellular connection
128
129
130
131 == 1.4  Hardware System Structure ==
132
133 [[image:1657079015096-949.png]]
134
135
136 == 1.5  LPS8N Applications ==
137
138 [[image:1657079055940-721.png]]
139
140
141 == 1.6  LED Indicators ==
142
143
144 LPS8N has totally four LEDs, They are:
145
146 * **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.
147 * **LoRa LED   **[[image:image-20220706115518-2.png||height="15" width="15"]] : This **RGB LED** will** (% style="color:green" %)blink GREEN(%%)** when LoRaWAN module starts or transmit a packet.
148 * **SYS LED    ** [[image:image-20220706115518-3.png||height="16" width="16"]] : This **RGB LED** will shows different colors on different state:
149 ** (% style="color:blue" %)**SOLID BLUE**(%%): Device is alive with LoRaWAN server connection.
150 ** (% 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
151 ** (% style="color:red" %)**SOLID RED**(%%): Device doesn't have Internet connection.
152
153 * **ETH LED    **[[image:image-20220706115518-4.png||height="15" width="17"]] :  This LED shows the ETH interface connection status.
154
155
156
157
158 = 2. Access and Configure DLOS8N =
159
160 The DLOS8N is configured as a WiFi Access Point by default. User can access and configure the DLOS8N after connecting to its WiFi network, or via its Ethernet port.
161
162 == 2.1 Find IP address of DLOS8N ==
163
164 === 2.1.1 Connect via WiFi ===
165
166 [[image:1652412985720-934.png]]
167
168 At the first boot of DLOS8N, it will auto generate a WiFi network called (% style="color:green" %)**//dragino-xxxxxx //**(% style="color:black" %)with password:
169
170 [[image:1652413127647-377.png]]
171
172 (% style="background-color:#ffffcc" %)dragino+dragino
173
174 (((
175 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
176 )))
177
178 === 2.1.2 Connect via Ethernet with DHCP IP from router ===
179
180 [[image:1652414114583-532.png]]
181
182
183 (((
184 Alternatively, connect the DLOS8N Ethernet port to your router and DLOS8N 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 DLOS8N. You can also use this IP to connect.
185 )))
186
187 === 2.1.3 Connect via WiFi with DHCP IP from router ===
188
189 [[image:1652414137639-956.png]]
190
191
192 If the DLOS8N already connect to the router via WiFi, use can use the WiFi IP to connect to DLOS8N.
193
194 === 2.1.4 Connect via Ethernet with fall back ip ===
195
196 The WAN port also has a [[fall back ip address>>path:#_I_configured_LPS8]] for access if user doesn’t connect to uplink router. Click [[here>>path:#_I_configured_LPS8]] to see how to configure.
197
198 == 2.2 Access Configure Web UI ==
199
200 **Web Interface**
201
202 Open a browser on the PC and type the DLOS8N ip address (depends on your connect method)
203
204 [[http:~~/~~/10.130.1.1/>>url:http://10.130.1.1/]] (Access via WiFi AP network)
205
206 or
207
208 http:~/~/IP_ADDRESS or [[http:~~/~~/ IP_ADDRESS:8000>>url:http://192.168.1.xx:8000]]
209
210
211 You will see the login interface of DLOS8N as shown below.
212
213 The account details for Web Login are:
214
215 (% style="color:#4f81bd" %)**User Name: root**
216
217 (% style="color:#4f81bd" %)**Password:   dragino**
218
219 [[image:1652414287022-223.png]]
220
221 = 3. Typical Network Setup =
222
223 == 3.1 Overview ==
224
225 The DLOS8N supports flexible network set up for different environments. This section describes the typical network topology. The network set up includes:
226
227 * **WAN Port Internet Mode**
228 * **WiFi Client Mode**
229 * **WiFi AP Mode**
230 * **Cellular Mode**
231
232 == 3.2 Use WAN port to access Internet ==
233
234 By default, the DLOS8N is set to use the WAN port to connect to an upstream network. When you connect the DLOS8N’s WAN port to an upstream router, DLOS8N 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**:
235
236 [[image:1652420169255-959.png]]
237
238 == 3.3 Access the Internet as a WiFi Client ==
239
240 In the WiFi Client Mode, DLOS8N acts as a WiFi client and gets DHCP from an upstream router via WiFi.
241
242 (((
243 The settings for WiFi Client is under page (% style="color:#4f81bd" %)**System~-~-> WiFi ~-~-> WiFi WAN Client Settings**
244 )))
245
246 [[image:1652420327792-211.png]]
247
248 (((
249 In the WiFi Survey Choose the WiFi AP, and input the Passphrase then click Save & Apply to connect.
250 )))
251
252 == 3.4 Access the Internet via Cellular ==
253
254 If the DLOS8N support 3G/4G Cellular modem option, When the label on the shell is displayed as Model : DLOS8N-EC25, it indicates that DLOS8 already has EC25 3G/4G modules,user can use it as main internet connection or back up.
255
256 (((
257 First, release the four screws of DLOS8N, pull out PCB and install SIM card as below:
258 )))
259
260 [[image:1652420606018-181.png]]
261
262
263 (((
264 [[image:1652420718132-929.png||height="427" width="727"]]
265 )))
266
267 (((
268 The set up page is (% style="color:#4f81bd" %)**System ~-~-> Cellular**
269 )))
270
271 (((
272 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.
273 )))
274
275 (((
276 [[image:1652421032117-341.png||height="329" width="752"]]
277 )))
278
279 (% style="color:red" %)**Note** *: For DLOS8N which doesn’t have the cellular module, this page will shows Cellular not detected.
280
281 == 3.5 Check Internet connection ==
282
283 In the (% style="color:#4f81bd" %)**home**(%%) page, we can check the Internet connection.
284
285 * GREEN Tick ​​​​ [[image:1652436675869-206.png||height="14" width="15"]] : This interface has Internet connection.
286 * Yellow  Tick  [[image:1652436705761-420.png||height="15" width="15"]] : This interface has IP address but don’t use it for internet connection.
287 * RED Cross    [[image:1652436787176-950.png||height="14" width="15"]] : This interface doesn’t connected.
288
289 [[image:1652421351382-793.png||height="339" width="765"]]
290
291 = 4. Example: Configure as a LoRaWAN gateway =
292
293 DLOS8N 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.
294
295 (((
296 [[image:image-20220513140429-1.png||height="565" width="824"]]
297 )))
298
299 This chapter describes how to use the DLOS8Nto work with
300
301 TheThingsNetwork v3(TTN v3)[[ LoRaWAN Server>>url:https://www.thethingsnetwork.org/]]  ([[www.thethingsnetwork.org>>url:http://www.thethingsnetwork.org/]])
302
303 == 4.1 Create a gateway in TTN V3 Server ==
304
305 (% style="color:#4f81bd" %)**Step 1: Get a Unique gateway ID.**
306
307 (((
308 Every DLOS8N has a unique gateway id. The ID can be found at LoRaWAN page:
309 )))
310
311 (((
312 [[image:1652421929753-168.png||height="403" width="739"]]
313 )))
314
315 The example gateway id is: **a840411e96744154**
316
317 (% style="color:#4f81bd" %)**Step 2: Sign up a user account in TTN server**
318
319 [[**https:~~/~~/account.thethingsnetwork.org/register**>>url:https://account.thethingsnetwork.org/register]]
320
321 [[image:1652422127479-258.png||height="346" width="738"]]
322
323 (% style="color:#4f81bd" %)**Step 3: Choose the TTNv3 Cluster Picker**
324
325 (((
326 [[image:1652422142236-792.png||height="356" width="737"]]
327 )))
328
329 (% style="color:red" %)**Note: Choose the cluster corresponds to a specific Gateway server address**
330
331 * Europe 1 (% style="color:red" %)corresponding Gateway server address: (% style="color:black" %)eu1.cloud.thethings.network
332 * North America 1 (% style="color:red" %)corresponding Gateway server address:** **(% style="color:black" %)nam1.cloud.thethings.network
333 * Australia 1 (% style="color:red" %)corresponding Gateway server address:** **(% style="color:black" %)au1.cloud.thethings.network
334 * Legacy V2 Console : (% style="color:red" %)TTN v2 shuts down in December 2021
335
336 (% style="color:#4f81bd" %)**Step 4: Create a Gateway**
337
338 [[image:1652422440891-514.png||height="360" width="747"]]
339
340 Click the Gateway icon and then click Add gateway.
341
342 Open the following page:
343
344 [[image:1652422470352-518.png||height="391" width="716"]]
345
346 [[image:1652422479876-297.png||height="398" width="729"]]
347
348 (((
349 (% style="color:red" %)**Notice: **Gateway Server address must match the gateway configuration, otherwise you will have problem for End Node to join the network.
350 )))
351
352 After creating the gateway, you can see the gateway info, as below.
353
354 [[image:1652422509034-682.png||height="299" width="739"]]
355
356 == 4.2 Configure DLOS8N to connect to TTN v3 ==
357
358 (((
359 You can now configure the DLOS8N to let it connect to TTN network V3.
360 )))
361
362 (((
363 Make sure your DLOS8N has a working Internet Connection first.
364 )))
365
366 (((
367 Choose the right server provider and click (% style="color:#4f81bd" %)**Save&Apply**
368 )))
369
370 [[image:1652422624783-580.png||height="327" width="729"]]
371
372 (% style="color:red" %)**Note: **The server address must match the Gateway server address you choose in TTN V3.
373
374 In the home page, we can see the LoRaWAN connection is ready now.
375
376 [[image:1652422685063-596.png||height="327" width="729"]]
377
378 In TTN v3 portal, we can also see the gateway is connected.
379
380 [[image:1652422703020-955.png||height="343" width="730"]]
381
382 == 4.3 Configure frequency ==
383
384 We also need to set the frequency plan in DLOS8N to match the end node we use, so to receive the LoRaWAN packets from the LoRaWAN sensor.
385
386 [[image:1652422737399-529.png||height="362" width="737"]]
387
388
389 In logread page, user can check the frequency actually used.
390
391 [[image:1652422763536-750.png||height="514" width="730"]]
392
393 == 4.4 Add a LoRaWAN End Device ==
394
395 (((
396 This section shows how to add a LoRaWAN End device to a LoRaWAN network and see the data from TTN web site.
397 )))
398
399 (((
400 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.
401 )))
402
403 [[image:1652422794767-871.png]]
404
405 (((
406 (% style="color:#4f81bd" %)**Step 1**: (% style="color:black" %)Create a Device definition in TTN v3 with the OTAA keys from the example LT-22222-L IO Controller device.
407 )))
408
409 (((
410 Three codes are required to define the device in TTN v3:
411 )))
412
413 * DEV EUI - Unique ID code for a particular device.
414 * APP EUI - ID code for an Application defined in TTN v3.
415 * APP Key - Unique key to secure communications with a particular device.
416
417 (((
418 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.
419 )))
420
421 [[image:1652422840936-838.png]]
422
423 (((
424 (% 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.
425 )))
426
427 (((
428 For the TTN v3 server, you can use the codes set in the device as in the following example.
429 )))
430
431 (((
432 Select **Add Application** to open the screen below.
433 )))
434
435 [[image:1652422946999-255.png||height="356" width="744"]]
436
437 Open the **Application **select** Add end device**
438
439 Start Register the end device
440
441 [[image:1652422975885-591.png||height="359" width="726"]]
442
443 (((
444 Select OTAA activation mode
445 )))
446
447 (((
448 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.
449 )))
450
451 [[image:1652422998005-968.png||height="352" width="744"]]
452
453 First, input the End device ID, AppEUI and DevEUI.
454
455 [[image:1652423022781-339.png||height="365" width="741"]]
456
457 Secondly, choose the corresponding frequency and LoRaWAN class capabilities.
458
459 [[image:1652423046741-467.png||height="355" width="736"]]
460
461 (((
462 Finally, Application layer settings input the corresponding AppKey. Before saving the configuration, check that the data matches the device.
463 )))
464
465 (((
466 (% style="color:#4f81bd" %)**Step 2**: (% style="color:black" %)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.
467 )))
468
469 (((
470 (% style="color:red" %)Note that it may take some time for the device data to appear in the TTN v3 display.
471 )))
472
473 [[image:1652423277549-324.png||height="273" width="745"]]
474
475 = 5. Web Configure Pages =
476
477 == 5.1 Home ==
478
479 Shows the system running status.
480
481 [[image:1652423418568-752.png||height="329" width="724"]]
482
483 == 5.2 LoRa Settings ==
484
485 === 5.2.1 LoRa ~-~-> LoRa ===
486
487 (((
488 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.
489 )))
490
491 (((
492 Different DLOS8N hardware version can support different frequency range:
493 )))
494
495 * **868**: valid frequency: 863Mhz ~~ 870Mhz. for bands EU868, RU864, IN865 or KZ865.
496 * **915**: valid frequency: 902Mhz ~~ 928Mhz. for bands US915, AU915, AS923 or KR920
497
498 (((
499 After user choose the frequency plan, he can see the actually frequency in used by checking the page **LogRead ~-~-> LoRa Log**
500 )))
501
502 [[image:1652423554776-574.png||height="380" width="740"]]
503
504 Note *: **[[See this instruction for how to customize frequency band>>doc:Main.How to customized LoRaWAN frequency band.WebHome]]**
505
506
507 === 5.2.2 LoRa ~-~-> ABP Decryption ===
508
509 The DLOS8N can communicate with LoRaWAN ABP End Node without the need of LoRaWAN server. It can be used in some cases such as:
510
511 * No internet connection.
512 * 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]]).
513
514 (((
515 Detail of this feature: **[[Communication with ABP End Node>>doc:Main.Communicate with ABP End Node without LoRaWAN Network Server --- LG308.WebHome]]**
516 )))
517
518 [[image:1652423628833-467.png||height="357" width="755"]]
519
520 == 5.3 LoRaWAN Settings ==
521
522 === 5.3.1 LoRaWAN ~-~-> LoRaWAN ===
523
524 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
525
526 [[image:1652423628833-467.png||height="357" width="755"]]
527
528 (% style="color:red" %)**Note:**
529
530 ~*: User can ignore the latitude and longitude settings here, DLOS8N will use the actually value from GPS module.
531
532 ~**: Packet filter is to drop the unwanted LoRaWAN packet, instruction see here:
533
534 **See:** **[[Filter unwanted LoRaWAN packets>>doc:Main.Filter unwanted LoRaWAN packets.WebHome]]**
535
536 === 5.3.2 LoRaWAN ~-~-> Amazon AWS-IoT ===
537
538 [[image:1652428499323-384.png||height="275" width="723"]]
539
540 (((
541 Please see this instruction to know more detail and demo for how to connect to **[[AWS-IoT LoRaWAN Core>>doc:Main.AWS IoT Core for LoRaWAN.WebHome]].**
542 )))
543
544 === 5.3.3 LoRaWAN ~-~-> LORIOT ===
545
546 (((
547 Settings to communicate to LORIOT LoRaWAN Network Server: [[https:~~/~~/www.loriot.io/>>url:https://www.loriot.io/]]
548 )))
549
550 (((
551 Instruction: **[[Notes for LORIOT>>doc:Main.Notes for LORIOT.WebHome]]**
552 )))
553
554 [[image:1652428648903-878.png||height="266" width="731"]]
555
556 == 5.4 MQTT Settings ==
557
558 If end nodes works in ABP mode, user can configure DLOS8N to transfer the data to MQTT broker,
559
560 Instruction: **[[MQTT Forward Instruction>>doc:Main.MQTT Forward Instruction.WebHome]]**
561
562
563 [[image:1652428705046-212.png||height="417" width="733"]]
564
565 == 5.5 System ==
566
567 === 5.5.1 System ~-~-> System Overview ===
568
569 Shows the system info:
570
571 [[image:1652428773760-580.png||height="408" width="728"]]
572
573 === 5.5.2 System ~-~-> General ( login settings) ===
574
575 [[image:1652428861256-300.png||height="354" width="724"]]
576
577 (((
578 **__System Password:__**
579 )))
580
581 (((
582 There are two login for DLOS8N: (% style="color:#4f81bd" %)root /dragino (% style="color:black" %)or (% style="color:#4f81bd" %)admin /dragino. (% style="color:black" %)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.
583 )))
584
585 (((
586 This page can be used to set the password for them.
587 )))
588
589 (((
590 **__Timezone:__**Set device timezone.
591 )))
592
593 (((
594 **__Port forwarding:__**Enable/Disable the HTTP and SSH access via WAN interface.
595 )))
596
597 === 5.5.3 System ~-~-> Network ===
598
599 [[image:1652429149053-824.png||height="467" width="725"]]
600
601 (((
602 **__LAN Settings:__**When the DLOS8N has the AP enable, LAN settings specify the network info for DLOS8N’s own network.
603 )))
604
605 (((
606 __**WAN Settings:**__Setting for DLOS8N WAN port
607 )))
608
609 (((
610 __**WiFi Settings:**__Setting for DLOS8N WiFi IP when use it as WiFi Client
611
612
613 )))
614
615 === 5.5.4 System ~-~-> WiFi ===
616
617 DLOS8N WiFi Settings.
618
619 [[image:1652429430767-921.png||height="367" width="723"]]
620
621 === 5.5.5 System ~-~-> Cellular ===
622
623 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.
624
625 [[image:1652429309615-825.png||height="320" width="732"]]
626
627 (% style="color:red" %)Note *: For DLOS8N which doesn’t have the cellular module, this page will shows Cellular not detected.
628
629 === 5.5.6 System ~-~-> Network Status ===
630
631 [[image:1652429486609-208.png||height="415" width="728"]]
632
633 === 5.5.7 System ~-~-> Remote Mgnt & Auto Provision ===
634
635 Auto Provision is the feature for batch configure and remote management. It can be used in below two cases:
636
637 [[image:1652429518191-846.png||height="332" width="733"]]
638
639 [[image:1652429527544-247.png||height="327" width="724"]]
640
641 [[image:1652429537849-154.png||height="339" width="722"]]
642
643 Please see this document for detail:
644
645 (((
646 [[http:~~/~~/www.dragino.com/downloads/index.php?dir=LoRa_Gateway/LPS8/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]]
647 )))
648
649
650 R-SSH is for remote access device and management, introduction for how to use: **[[Remote Access Gateway>>doc:Main.Remote Access Gateway.WebHome]]**
651
652 [[image:1652429624400-864.png||height="432" width="716"]]
653
654
655 === 5.5.8 System ~-~-> Firmware Upgrade ===
656
657 We keep improving the DLOS8N Linux side firmware for new features and bug fixes. Below are the links for reference.
658
659 * **Latest firmware**: [[LoRa Gateway Firmware>>url:http://www.dragino.com/downloads/index.php?dir=LoRa_Gateway/LG02-OLG02/Firmware/]],
660
661 ( [[http:~~/~~/www.dragino.com/downloads/index.php?dir=LoRa_Gateway/LG02-OLG02/Firmware>>url:http://www.dragino.com/downloads/index.php?dir=LoRa_Gateway/LG02-OLG02/Firmware/]] )
662
663 * **Change Log**: [[Firmware Change Log>>url:http://www.dragino.com/downloads/downloads/LoRa_Gateway/LG02-OLG02/Firmware/ChangeLog]].
664
665 ( [[http:~~/~~/www.dragino.com/downloads/downloads/LoRa_Gateway/LG02-OLG02/Firmware/ChangeLog>>url:http://www.dragino.com/downloads/downloads/LoRa_Gateway/LG02-OLG02/Firmware/ChangeLog]] )
666
667 (((
668 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.
669 )))
670
671 (((
672 (% style="color:green" %)**Web~-~-> System~-~-> Firmware Upgrade**
673 )))
674
675 [[image:1652429711145-862.png||height="270" width="737"]]
676
677 Select the required image and click **Flash Image.** The image will be uploaded to the device, and then click **Process Update** to upgrade.
678
679 (% style="color:red" %)**NOTE**: (% style="color:black" %)You normally need to **//uncheck//** the **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.
680
681 The system will automatically boot into the new firmware after upgrade.
682
683 [[image:1652429962190-224.png||height="358" width="729"]]
684
685 (% style="color:red" %)**NOTE***(%%): User can also upgrade firmware via Linux console
686
687 SCP the firmware to the system(% style="color:green" %)**/var**(%%)** **directory and then run
688
689 (% style="color:#4f81bd" %)**//root@OpenWrt:~~# /sbin/sysupgrade –n /var/Your_Image//**
690
691 (% style="color:red" %)**NOTE**(%%) : it is important to transfer the image in the /var directory, otherwise it may exceed the available flash size.
692
693 === 5.5.9 System ~-~-> Reboot/Reset ===
694
695 [[image:1652430197132-330.png||height="256" width="724"]]
696
697 (((
698
699 )))
700
701 === 5.5.10 System ~-~-> Package Maintain ===
702
703 [[image:1652430243826-126.png||height="289" width="723"]]
704
705 Place to show what package has installed and possible to upgrade packages.
706
707 == 5.6 LogRead ==
708
709 === 5.6.1 LogRead ~-~-> LoRa Log ===
710
711
712 Show the frequency for LoRa Radio and traffics.
713
714 [[image:image-20220615204306-1.png||height="575" width="733"]]
715
716
717 Show the IoT Server Connection State and FWD State
718
719 [[image:image-20220616083933-1.png||height="556" width="729"]]
720
721 DLOS8 can view GPS location in the Logread FWD State
722
723
724 Show the Error logs, RxTxJson lorawan packages, and PULL State
725
726 [[image:image-20220615205416-6.png||height="442" width="884"]]
727
728
729 === 5.6.2 LogRead ~-~-> System Log ===
730
731 Show the system log
732
733 [[image:1652430369760-511.png||height="373" width="730"]]
734
735 = 6. More features =
736
737 == 6.1 More instructions ==
738
739 [[LoRaWAN Gateway Instruction>>doc:Main.WebHome]](LoRaWAN Gateway)
740
741
742 = 7. Linux System =
743
744 The DLOS8N is based on the OpenWrt Linux system. It is open source, and users are free to configure and modify the Linux settings.
745
746 == 7.1 SSH Access for Linux console ==
747
748 User can access the Linux console via the SSH protocol. Make sure your PC and the DLOS8N 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.
749
750 IP address:  IP address of DLOS8N
751
752 Port:         22 (via WiFi AP mode) or 2222 (via WAN Interface)
753
754 User Name:      (% style="color:green" %)**root**
755
756 Password:         (% style="color:green" %)**dragino** (% style="color:black" %)(default)
757
758 After logging in, you will be in the Linux console and can enter commands as shown below.
759
760 [[image:1652431588565-830.png]]
761
762 The “(% class="mark" %)**logread -f**(%%)” command can be used to debug how system runs.
763
764 [[image:1652431609193-637.png||height="214" width="732"]]
765
766
767 == 7.2 Edit and Transfer files ==
768
769 (((
770 The DLOS8N 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.
771 )))
772
773 (((
774 In Windows, one of the easiest methods is using the [[WinSCP>>url:https://winscp.net/eng/index.php]] utility.
775 )))
776
777 (((
778 After establishing access via WinSCP to the device, you can use an FTP style window to drag / drop files to the DLOS8N, or edit the files directly in the windows.
779 )))
780
781 (((
782 Screenshot is as below:
783 )))
784
785 [[image:1652431650755-450.png]]
786
787
788 == 7.3 File System ==
789
790 (((
791 The DLOS8N 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.
792 )))
793
794 (((
795 The Linux system uses around 8MB ~~10MB flash size which means there is not much room for user to store data in the DLOS8N flash.
796 )))
797
798 (((
799 You can use an external USB flash memory device to extend the size of flash memory for storage.
800 )))
801
802
803 == 7.4 Package maintenance system ==
804
805 DLOS8N 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 DLOS8N to use **//iperf //**.
806
807 (((
808 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]])
809 )))
810
811 (((
812 **In Linux Console run:**
813 )))
814
815 (((
816 (% style="color:green" %)**root@dragino-169d30:~~# opkg update**           (% style="color:black" %)~/~/ to get the latest packages list
817 )))
818
819 (((
820 (% style="color:green" %)**root@dragino-169d30:~~# opkg list**    (% style="color:black" %) ~/~/shows the available packages
821 )))
822
823 (((
824 (% style="color:green" %)**root@dragino-169d30:~~# opkg install iperf ** (% style="color:black" %)~/~/ install iperf
825 )))
826
827 The system will automatically install the required packages as shown below.
828
829
830 (((
831 (% style="background-color:#dcdcdc" %)//root@dragino-169d30:/etc/opkg# opkg install iperf//
832 )))
833
834 (((
835 (% style="background-color:#dcdcdc" %)//Installing iperf (2.0.12-1) to root…//
836 )))
837
838 (((
839 (% 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]]
840 )))
841
842 (((
843 (% style="background-color:#dcdcdc" %)//Installing uclibcxx (0.2.4-3) to root…//
844 )))
845
846 (((
847 (% 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]]
848 )))
849
850 (((
851 (% style="background-color:#dcdcdc" %)//Configuring uclibcxx.//
852 )))
853
854 (((
855 (% style="background-color:#dcdcdc" %)//Configuring iperf.//
856 )))
857
858 = 8. Upgrade Linux Firmware =
859
860
861 = 9. FAQ =
862
863 == 9.1 How can I configure for a customized frequency band? ==
864
865 (((
866 See below link for how to customize frequency band: **[[How to customized LoRaWAN frequency band>>doc:Main.How to customized LoRaWAN frequency band.WebHome]]**
867 )))
868
869 (((
870
871 )))
872
873 == 9.2 Can I connect DLOS8N to LORIOT? ==
874
875 Yes, the set up instruction is here: **[[Notes for LORIOT>>doc:Main.Notes for LORIOT.WebHome]]**
876
877
878 == 9.3 Can I make my own firmware for the gateway, where can I find the source code? ==
879
880 (((
881 Yes, You can make your own firmware for the DLOS8N for branding purposes or to add customized applications.
882 )))
883
884 (((
885 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]]
886 )))
887
888
889 == 9.4 Can I use 868Mhz version for 915Mhz bands? ==
890
891 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.
892
893
894 = 10. Trouble Shooting =
895
896 == 10.1 I get kernel error when install new package, how to fix? ==
897
898 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:
899
900 (% style="background-color:yellow" %)root@dragino-16c538:~~# opkg install kmod-dragino2-si3217x_3.10.49+0.2-1_ar71xx.ipk
901
902 (% style="background-color:yellow" %)Installing kmod-dragino2-si3217x (3.10.49+0.2-1) to root…
903
904 (% style="background-color:yellow" %)Collected errors:
905
906 (% style="background-color:yellow" %)* satisfy_dependencies_for: Cannot satisfy the following dependencies for kmod-dragino2-si3217x:
907
908 (% style="background-color:yellow" %)*      kernel (= 3.10.49-1-4917516478a753314254643facdf360a) *
909
910 (% style="background-color:yellow" %)* opkg_install_cmd: Cannot install package kmod-dragino2-si3217x.
911
912 (((
913 In this case, you can use the –force-depends option to install such package as long as the actual kernel version is the same.
914 )))
915
916 (% style="background-color:yellow" %)Opkg install kmod-dragino2-si3217x_3.10.49+0.2-1_ar71xx.ipk –force-depends
917
918
919 == 10.2 How to recover the DLOS8N if the firmware crashes ==
920
921 (((
922 Please follow this instruction to recover your gateway:  **[[Recover Gateway>>doc:Main.How to Recover Gateway if can't access it.WebHome]]**
923 )))
924
925 (((
926
927 )))
928
929 == 10.3 I configured DLOS8N for WiFi access and lost its IP. What to do now? ==
930
931 [[image:1652435238615-272.png||height="247" width="727"]]
932
933 (((
934 The DLOS8N 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 DLOS8N no matter what the WiFi IP is. The fall back IP is useful for connecting and debug the unit.
935 )))
936
937 (% style="color:red" %)Note: fallback IP can be disabled in the WAN and DHCP page.
938
939
940 Steps to connect via fall back IP:
941
942 ~1. Connect PC’s Ethernet port to DLOS8N’s WAN port
943
944 2. Configure PC’s Ethernet port has
945 IP: 172.31.255.253 and
946 Netmask: 255.255.255.252
947
948 As below photo:
949
950 [[image:1652435256286-879.png]]
951
952 3. In the PC, use IP address 172.31.255.254 to access the DLOS8N via Web or Console.
953
954 Please note the latest firmware uses port 8000 for http and 2222 for ssh access.
955
956
957 = 11. Order Info =
958
959 (% style="color:#4f81bd" %) **//PART: DLOS8N-XXX-YYY//: **
960
961 (% style="color:#4f81bd" %) **//XXX: Frequency Band//**
962
963 * (% style="color:#4f81bd" %)** 868**(% style="color:black" %) : valid frequency: 863Mhz ~~ 870Mhz. for bands EU868, RU864, IN865 or KZ865.
964 * (% style="color:#4f81bd" %)** 915**(% style="color:black" %): valid frequency: 902Mhz ~~ 928Mhz. for bands US915, AU915, AS923 or KR920
965
966 (% style="color:#4f81bd" %) **//YYY: 4G Cellular Option//**
967
968 * (% style="color:#4f81bd" %)** E**(% style="color:black" %): EMEA, Korea, Thailand, India.
969 * (% style="color:#4f81bd" %)** A**(% style="color:black" %): North America/ Rogers/AT&T/T-Mobile.
970 * (% style="color:#4f81bd" %)** AU**(% style="color:black" %): Latin America, New Zeland, Taiwan
971 * (% style="color:#4f81bd" %)** J**(% style="color:black" %): Japan, DOCOMO/SoftBank/ KDDI
972
973 More info about valid bands, please see [[EC25-E product page>>url:https://www.quectel.com/product/ec25.htm]].
974
975
976 = 12. Packing Info =
977
978 (((
979 **Package Includes**:
980 )))
981
982 * DLOS8N LoRaWAN Gateway x 1
983 * Stick Antenna for LoRa RF part. Frequency is one of 470 or 868 or 915Mhz depends the model ordered
984 * Packaging with environmental protection paper box
985
986 (((
987 **Dimension and weight**:
988 )))
989
990 * Device Size: 12 x 12 x 3 cm
991 * Weight: 187g
992 * Package Size: 14.5 x 13.5 x 6 cm
993 * Weight: 300g
994
995 = 13. Support =
996
997 * Try to see if your questions already answered in the [[wiki>>doc:Main.WebHome]].
998 * Support is provided Monday to Friday, from 09:00 to 18:00 GMT+8.
999 Due to different timezones we cannot offer live support. However, your questions will be answered as soon as possible in the before mentioned schedule.
1000 * 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]]