Skip to Content
Version 18.1 by Xiaoling on 2022/07/22 11:52
Hide last authors
Xiaoling 15.2 1 **Table of Contents:**
Xiaoling 1.1 2
Xiaoling 1.5 3 {{toc/}}
Xiaoling 1.1 4
Xiaoling 1.5 5
Xiaoling 14.8 6
Xiaoling 1.3 7 = 1. Introduction =
8
Xiaoling 14.8 9
Xiaoling 1.2 10 The Dragino LoRaWAN gateway can commuicate with LoRaWAN ABP End Node without the need of LoRaWAN server. It can be used in some cases such as:
Xiaoling 1.1 11
Xiaoling 1.2 12 * No internet connection.
Xiaoling 14.2 13 * User wants to get data forward in gateway and forward to their server base on MQTT/HTTP, etc. (Combine ABP communication method and [[MQTT forward together>>MQTT Forward Instruction]]).
Xiaoling 1.1 14
Xiaoling 1.7 15 (((
Xiaoling 1.13 16 The basic of this feature is the decoding of (% style="color:red" %)**LoRaWAN ABP End Node**(%%). Requirements:
Xiaoling 1.7 17 )))
Xiaoling 1.1 18
Xiaoling 1.2 19 1. LoRaWAN End Node in ABP mode. Make sure your end node works in this mode. End node most are default set to OTAA mode
20 1. LoRaWAN Gateway model: [[LPS8>>url:http://www.dragino.com/products/lora-lorawan-gateway/item/148-lps8.html]], [[LG308>>url:http://www.dragino.com/products/lora-lorawan-gateway/item/140-lg308.html]], [[DLOS8>>url:http://www.dragino.com/products/lora-lorawan-gateway/item/160-dlos8.html]] ,[[LIG16>>url:http://www.dragino.com/products/lora-lorawan-gateway/item/171-lig16.html]]
Xiaoling 1.13 21 1. Firmware version for below instruction:**[[(% style="color:purple" %)Since LG02_LG08~~-~~-build-v5.4.1593400722-20200629-1120>>url:http://www.dragino.com/downloads/index.php?dir=LoRa_Gateway/LPS8/Firmware/Release/]](%%)**
Xiaoling 1.1 22
Xiaoling 16.8 23
24
Xiaoling 1.4 25 = 2. How it works =
Xiaoling 1.1 26
Xiaoling 1.4 27
Xiaoling 1.13 28 (% style="color:#037691" %)**Video Instruction**(%%): **[[https:~~/~~/youtu.be/ZBjXwmp7rwM>>url:https://youtu.be/ZBjXwmp7rwM]]**
Xiaoling 1.4 29
Xiaoling 1.14 30
Xiaoling 1.2 31 Assume we have the LoRaWAN tracker LGT92 which works in ABP mode and US915 band. It has below keys:
Xiaoling 1.1 32
Xiaoling 1.8 33 (% class="box infomessage" %)
34 (((
Xiaoling 14.8 35 **AT+NWKSKEY=72 32 63 95 dd 8f e2 b2 13 66 e4 35 93 8f 55 df
Xiaoling 1.2 36 AT+APPSKEY=b3 17 f8 14 7a 43 27 8a 6a 31 c4 47 3d 55 5d 33
Xiaoling 14.8 37 AT+DADDR=2602111D**
Xiaoling 1.8 38 )))
Xiaoling 1.1 39
Xiaoling 1.8 40 (((
Xiaoling 1.2 41 and we have the LG308 works and US915 band and support ABP decryption. User can input these keys in LG308 so the LG308 can communicate with LGT92.
Xiaoling 14.8 42
43
Xiaoling 1.8 44 )))
Xiaoling 1.2 45
46 We need to input above keys in LG308 and enable ABP decryption.
47
Xiaoling 3.2 48 [[image:image-20220527161119-1.png]]
Xiaoling 1.2 49
50 Input the ABP keys in LG308
51
52
Xiaoling 1.3 53 == 2.1 Upstream ==
Xiaoling 1.2 54
Xiaoling 14.8 55
Xiaoling 1.2 56 Now when this End Node (Dev Addr=2602111D) send a uplink packet. When this packet arrive LG308, LG308 will decode it and put the decode data on the file /var/iot/channels/2602111D . So we have this data for further process with other applications in LG308.
57
Xiaoling 1.8 58 (((
Xiaoling 1.2 59 We can see the log of LG308 to know this packet arrive
Xiaoling 1.8 60 )))
Xiaoling 1.2 61
Xiaoling 3.2 62 [[image:image-20220527161149-2.png]]
Xiaoling 1.2 63
Xiaoling 14.8 64 LG308 log by "(% style="color:red" %)**logread -f**" (%%)command
Xiaoling 1.2 65
66
67 The data of End Node is stored in the file /var/iot/channels/2602111D. We can use hexdump command to check it.
68
Xiaoling 1.8 69 (% class="box" %)
70 (((
71 root@dragino-1d25dc:~~# hexdump /var/iot/channels/2602111D
Xiaoling 3.3 72 0000000 (% style="color:#037691" %)**4646 4646 4646 3946 3030 3030 3030 3546**(%%)      ~-~-> Got RSSI and SNR    
73 0000010 (% style="color:#037691" %)**cc0c 0b63 0266 017f ff7f ff00 **(%%) ~-~-> Payload
Xiaoling 1.2 74 000001c
Xiaoling 1.8 75 )))
Xiaoling 1.2 76
Xiaoling 14.8 77 * **RSSI**: 4646 4646 4646 3946 = 0xFFFF FF9F : So RSSI = (0xFFFF FF9F - 0x100000000) = -97
78 * **SNR**: 3030 3030 3030 3546 = 0x0000 005F = 95, need to divide 10 so SNR is 9.5
79 * **Payload**: 0xcc0c 0b63 0266 017f ff7f ff00
Xiaoling 1.2 80
Xiaoling 16.9 81
82
Xiaoling 1.8 83 (% class="box" %)
84 (((
Xiaoling 3.3 85 (% style="color:red" %)**Notice 1**(%%): The data file stored in LG308 for the end node is bin file. If the end node sends ASCII string to gateway, the output will as below:
Xiaoling 3.6 86 in LGT92, use (% style="color:#037691" %)**AT+SEND=12:hello world** (%%)to send ASCII string
Xiaoling 1.8 87 root@dragino-1d25dc:~~# hexdump /var/iot/channels/2602111D
Xiaoling 1.2 88 0000000 4646 4646 4646 3946 3030 3030 3030 3546
Xiaoling 1.8 89 0000010 6865 6c6c 6f20 776f 726c 6400      ~-~-> Got ASCII code "hello world"    
Xiaoling 1.2 90 000001c
Xiaoling 1.8 91 )))
Xiaoling 1.2 92
Xiaoling 1.8 93 (% class="box" %)
94 (((
Xiaoling 14.8 95 (% style="color:red" %)**Notice 2**(%%): The upstream payload length should match the LoRaWAN length requirement (max length depends on Frequency and DR), otherwise the gateway can't decode the payload.
Xiaoling 1.8 96 )))
Xiaoling 1.2 97
Xiaoling 3.4 98
Xiaoling 1.3 99 === 2.2.1 Decode Method ===
Xiaoling 1.2 100
Xiaoling 14.8 101
Xiaoling 3.6 102 The decode methods: (% style="color:#037691" %)**ASCII String, Decode_LHT65**(%%) doesn't affect how the sensor data is stored, they are to define how should the sensor data to be sent.
Xiaoling 1.2 103
104 For example we have a LHT65 , works in ABP mode and gateway successful get the data, which are:
105
Xiaoling 1.8 106 (% class="box" %)
107 (((
108 root@dragino-1baf44:~~# hexdump /var/iot/channels/01826108
Xiaoling 1.2 109 0000000 4646 4646 4646 4537 3030 3030 3030 3438
Xiaoling 1.8 110 0000010 ccd1 7fff 7fff 017f ff7f ff00         
Xiaoling 1.2 111 000001c
Xiaoling 1.8 112 )))
Xiaoling 1.2 113
Xiaoling 14.8 114
Xiaoling 1.2 115 If we choose ASCII decoder, the MQTT process will send out with mqtt-data:
116
Xiaoling 1.8 117 (% class="box" %)
118 (((
119 Sun Sep 27 04:33:16 2020 user.notice root: [IoT.MQTT]:pub_topic[-t]: dragino-1baf44/01826108/data
Xiaoling 1.2 120 Sun Sep 27 04:33:16 2020 user.notice root: [IoT.MQTT]:decoder: ASCII
Xiaoling 3.6 121 Sun Sep 27 04:33:16 2020 user.notice root: [IoT.MQTT]:mqtt_data[-m]: (% style="color:#037691" %)**ffffffe700000048ccd17fff7fff017fff7fff00**
Xiaoling 1.8 122 )))
Xiaoling 1.2 123
Xiaoling 14.8 124
Xiaoling 1.2 125 If we choose Decode_LHT65, the MQTT process will send out with mqtt-data
126
Xiaoling 1.8 127 (% class="box" %)
128 (((
129 Sun Sep 27 04:36:45 2020 user.notice root: [IoT.MQTT]:pub_topic[-t]: dragino-1baf44/01826108/data
Xiaoling 1.2 130 Sun Sep 27 04:36:45 2020 user.notice root: [IoT.MQTT]:decoder: Dragino_LHT65
Xiaoling 3.6 131 Sun Sep 27 04:36:45 2020 user.notice root: [IoT.MQTT]:mqtt_data[-m]:** (% style="color:#037691" %){"Hum_SHT":32.7,"BatV":3.281,"TempC_DS":32.9,
132 "EXT":"Temperature Sensor","RSSI":-24,"TempC_SHT":85.0,"SNR":8.2,"ext_sensor":0}(%%)**
Xiaoling 1.8 133 )))
Xiaoling 1.2 134
135 Above scripts are store in /etc/lora/decoder/. User can put their scripts here and select it in the UI.
136
137
Xiaoling 15.2 138
Xiaoling 1.3 139 === 2.2.2 How to Decode My End Node ===
Xiaoling 1.2 140
Xiaoling 14.8 141
Xiaoling 16.2 142 **1.** Configure the ABP keys for your end node in the gateway. enable ABP decode in Web UI
Xiaoling 1.2 143
Xiaoling 16.2 144 **2. **Don't choose MQTT service, use LoRaWAN.
Xiaoling 1.2 145
Xiaoling 16.2 146 **3.** When your end node send a message to the gateway, there will be a file store in /var/iot/channels. full path should be /var/iot/channels/END_NODE_DEV_ADDR
Xiaoling 1.2 147
Xiaoling 16.2 148 **4.** Use the /etc/lora/decoder/Dragino_LHT65 as template to decode your payload. This script is written in Lua language. User can manually call this script when you see the data file in /var/iot/channels by running:
Xiaoling 1.2 149
150 {{{/etc/lora/decoder/Dragino_LHT65 END_NODE_DEV_ADDR
151 }}}
152
Xiaoling 16.2 153 **5.** What you see as output is the MQTT data device will upload, user's end node has different payload compare with LHT65, most properly this file will report with error. User need to modify to match the actual payload.
Xiaoling 1.2 154
Xiaoling 16.2 155
156 (% style="color:red" %)
157 **Some notice:**
158
Xiaoling 1.2 159 * RSSI and SNR are added when gateway receive the packet, so there is always this field.
160 * If you rename the file, please make it executable.
161 * See this link for lua.bit module: [[http:~~/~~/luaforge.net/projects/bit/>>url:http://luaforge.net/projects/bit/]]
162 * Lua json module: [[http:~~/~~/json.luaforge.net/>>url:http://json.luaforge.net/]]
163 * the last line return is what will be used for MQTT
164 * User can use other language ,not limited to Lua, just make sure the return is what you want to send.
165
Xiaoling 16.9 166
167
168
Xiaoling 1.3 169 == 2.2 Downstream ==
Xiaoling 1.2 170
Xiaoling 14.8 171
Xiaoling 1.2 172 In LG308, we can create a file in the directory /var/iot/push for downstream purpose. We recommend using each command to generate this file. This file will be used for transmission and auto-deleted after used
173
174 The file should use below format:
175
Xiaoling 3.7 176 (% style="color:#037691" %)**dev_addr,imme/time,txt/hex,payload**
Xiaoling 1.2 177
178 Since fimware > Dragino-v2 lgw-5.4.1608518541 . Support more option
179
Xiaoling 3.7 180 (% style="color:#037691" %)**dev_addr,imme/time,txt/hex,payload,txpw,txbw,SF,frequency,rxwindow**
Xiaoling 1.2 181
Xiaoling 14.8 182 * **dev_addr:** Inptu the device address
183 * **imme/time:**
Xiaoling 1.2 184 ** imme: send downstream immediately,For Class C end node.
185 ** time: send downstream after receive device's uplink. For Class A end node
Xiaoling 14.8 186 * **txt/hex:**
Xiaoling 1.2 187 ** txt: send payload in ASCII
188 ** hex: send payload in HEX
Xiaoling 14.8 189 * **payload: **payload to be sent, payload lenght should match the LoRaWAN protocol requirement.
190 * **txpw:** Transmit Power. example: 20
191 * **txbw:** bandwidth:
Xiaoling 1.2 192 ** 1: 500 kHz
193 ** 2: 250 kHz
194 ** 3: 125 kHz
195 ** 4: 62.5 kHz
Xiaoling 14.8 196 * **SF:** Spreading Factor : SF7/SF8/SF9/SF10/SF11/SF12
197 * **Frequency:** Transmit Frequency: example: 923300000
198 * **rxwindow:** transmit on Rx1Window or Rx2Window.
Xiaoling 1.2 199
Xiaoling 16.3 200
Xiaoling 16.10 201
202
Xiaoling 14.8 203 (% style="color:blue" %)**Completely exmaple:**
Xiaoling 1.2 204
Xiaoling 14.8 205 * **Old version:** echo 018193F4,imme,hex,0101 > /var/iot/push/test
206 * **New version:** echo 018193F4,imme,hex,0101,20,1,SF12,923300000,2 > /var/iot/push/test
Xiaoling 14.6 207
Xiaoling 16.3 208
Xiaoling 16.10 209
210
Xiaoling 3.7 211 (% style="color:#037691" %)**Downstream Frequency**
212
Xiaoling 1.2 213 The LG308 will use the RX2 window info to send the downstream payload, use the default LoRaWAN settings, as below:
214
215 * EU868: 869.525Mhz, DR0(SF12BW125)
216 * US915: 923.3Mhz, SF12 BW500
217 * CN470: 505.3Mhz, SF12 BW125
218 * AU915: 923.3Mhz, SF12 BW500
219 * AS923: 923.2Mhz, SF10 BW125
220 * KR920: 921.9Mhz, SF12 BW125
221 * IN865: 866.55Mhz, SF10 BW125
222 * RU864: 869.1Mhz, SF12 BW125
223
Xiaoling 16.3 224
Xiaoling 16.10 225
226
Xiaoling 3.6 227 (% style="color:#037691" %)**Examples:**
Xiaoling 1.2 228
Xiaoling 1.10 229 (% class="box" %)
230 (((
231 we can use echo command to create files in LG308 for downstream.
232 root@dragino-1d25dc:~~# echo 2602111D,time,hex,12345678 > /var/iot/push/test
Xiaoling 1.2 233
Xiaoling 16.4 234
Xiaoling 14.8 235 **1)** From logread -f of gateway, we can see it has been added as pedning.
Xiaoling 1.10 236 lora_pkt_fwd[4286]: INFO~~ [DNLK]Looking file : test
237 lora_pkt_fwd[4286]: INFO~~ [DNLK]devaddr:2602111D, txmode:time, pdfm:hex, size:4, payload1:4Vx,payload_hex:77C1BB90
238 lora_pkt_fwd[4286]: INFO~~ [DNLK] DNLINK PENDING!(1 elems).
Xiaoling 1.2 239
Xiaoling 16.4 240
Xiaoling 14.8 241 **2)** When there is an upstrea from end node, this downstream will be sent and shows:
Xiaoling 1.2 242 lora_pkt_fwd[4286]: INFO: tx_start_delay=1497 (1497.000000) - (1497, bw_delay=0.000000, notch_delay=0.000000)
243 lora_pkt_fwd[4286]: [LGWSEND]lgw_send done: count_us=3537314420, freq=923300000, size=17
244
Xiaoling 16.4 245
Xiaoling 14.8 246 **3)** and the end node will got:
Xiaoling 1.10 247 [5764825]~*~*~*~** UpLinkCounter= 98 ~*~*~*~**
Xiaoling 1.2 248 [5764827]TX on freq 905300000 Hz at DR 0
249 Update Interval: 60000 ms
250 [5765202]txDone
251 [5766193]RX on freq 927500000 Hz at DR 10
252 [5766225]rxTimeOut
253 [5767205]RX on freq 923300000 Hz at DR 8
254 [5767501]rxDone
255 Rssi= -41
256 Receive data
Xiaoling 3.8 257 (% style="color:#037691" %)**2:12345678**  (%%) ~-~-> Hex
Xiaoling 1.2 258
Xiaoling 16.4 259
Xiaoling 14.8 260 **4) **If we use the command "echo 2602111D,time,txt,12345678 > /var/iot/push/test" for downstream, the end node will got:
Xiaoling 1.10 261 [5955877]~*~*~*~** UpLinkCounter= 102 ~*~*~*~**
Xiaoling 1.2 262 [5955879]TX on freq 904100000 Hz at DR 0
263 Update Interval: 60000 ms
264 [5956254]txDone
265 [5957246]RX on freq 923900000 Hz at DR 10
266 [5957278]rxTimeOut
267 [5958257]RX on freq 923300000 Hz at DR 8
268 [5958595]rxDone
269 Rssi= -37
270 Receive data
Xiaoling 3.8 271 (% style="color:#037691" %)**2:3132333435363738**(%%) ~-~-> ASCII string "12345678"
Xiaoling 1.10 272 )))
Xiaoling 1.2 273
Xiaoling 3.8 274
Xiaoling 1.3 275 = 3. Example 1: Communicate with LT-22222-L =
Xiaoling 1.2 276
Xiaoling 14.8 277
Xiaoling 1.2 278 Script can be download from: [[Example Script 1>>url:http://www.dragino.com/downloads/index.php?dir=LoRa_Gateway/LPS8/Firmware/customized_script/&file=talk_to_lt-22222-l_v0.1.sh]]
279
Xiaoling 1.10 280 (% class="box" %)
281 (((
Xiaoling 14.8 282 //#!/bin/sh
Xiaoling 1.2 283 # This scripts shows how to use LPS8/LG308/DLOS8 to communicate with two LoRaWAN End Nodes, without the use of internet or LoRaWAN server
284 #
Xiaoling 1.10 285 # Hardware Prepare:
286 # 1. LT-22222-L x 2, both are configured to work in
287 #   a) Class C ;
288 # b) ABP Mode ;
Xiaoling 1.2 289 # c) AT+Mod=1
Xiaoling 1.10 290 # 2. LPS8,
291 #   a) Firmware version >
292 #   b) Input the LT-22222-L keys in LPS so LPS8 can talk with them.
293 #   c) Lorawan server choose built-in
294 #   d) in Custom page, select custom script to point to this script. (put this script in /etc/iot/scripts directory)
Xiaoling 1.2 295 #
Xiaoling 1.10 296 # How it works?
297 #   a) Devices 1 sends a uplink payload to LPS8. LPS8 will get the DI1 and DI2 info from the payload
298 #   b) LPS8 will send a message to Device 2 to set the Device2 DO1 = Device1 DI1, and Device DO2 = Device DI2.
299 #   c) Device2 will change DO1 and DO2 to according to the message from LPS8, and send back a message to LPS8 with the its DO1
300 #   and DO2 value. LPS8 will ask Device1 to change its DO1 to same as Device 2, and change the DO2 to the same as Device 2.
301 #   ( The purpose of this step is to show that the Device2 has already do the change there).
302 #
303 #  For example: If current status of Device1 and Device2 leds shows:
304 #  Device1: DI1: ON, DI2: ON , DO1: OFF,  DO2: OFF
305 #  Device2: DI1: OFF, DI2: OFF , DO1: OFF,  DO2: OFF
306 #
307 #  Step2  will cause below change:
308 #  Device1: DI1: ON, DI2: ON , DO1: OFF,  DO2: OFF
309 #  Device2: DI1: OFF, DI2: OFF , DO1: ON,  DO2: ON
310 # 
311 #  Step3 will cause below change:
312 #  Device1: DI1: ON, DI2: ON , DO1: ON,  DO2: ON
313 #  Device2: DI1: OFF, DI2: OFF , DO1: ON,  DO2: ON
314 #  So if a person is in the Device 1 location, he can check if the DO LED match DI LEDs on Device 1 to confirm
Xiaoling 14.8 315 #  whether the Device 2 has been changed.//
Xiaoling 1.10 316 )))
Xiaoling 1.2 317
Xiaoling 16.6 318
Xiaoling 14.8 319 **~1. Input keys**
Xiaoling 1.2 320
Xiaoling 5.2 321 [[image:image-20220527162450-3.png]]
Xiaoling 1.2 322
323 Input Keys in LPS8
324
Xiaoling 5.2 325
Xiaoling 14.8 326 **2. Make sure the LPS8 and LT use the same frequency bands, choose EU868 in this test.**
Xiaoling 1.2 327
Xiaoling 16.6 328
Xiaoling 14.8 329 **3. Choose Built-in server**
Xiaoling 1.2 330
Xiaoling 5.2 331 [[image:image-20220527162518-4.png]]
Xiaoling 1.2 332
333 Choose Built-in server
334
Xiaoling 5.2 335
Xiaoling 14.8 336 **4. Run the script.**
Xiaoling 1.2 337
Xiaoling 7.2 338 [[image:image-20220527162552-5.png]]
Xiaoling 1.2 339
340 Run the script
341
Xiaoling 7.2 342
Xiaoling 14.8 343 **5. Output:**
Xiaoling 1.2 344
Xiaoling 7.2 345 [[image:image-20220527162619-6.png]]
Xiaoling 1.2 346
347 Output from LPS8
348
349
Xiaoling 1.3 350 = 4. Example 2: Communicate to TCP Server =
Xiaoling 1.2 351
Xiaoling 14.8 352
Xiaoling 10.2 353 [[image:image-20220527162648-7.png]]
Xiaoling 1.2 354
355 Network Structure
356
357
358 Full instruction video inlcude how to write scripts to fit server needed is here:
359
360
Xiaoling 10.2 361 (% style="color:#037691" %)**Video Instruction**(%%): **[[https:~~/~~/youtu.be/-nevW6U2TsE>>url:https://youtu.be/-nevW6U2TsE]]**
Xiaoling 1.2 362
363
Xiaoling 10.2 364 (% style="color:red" %)**Note: Firmware version must be higher than lgw-5.4.1607519907**
365
Xiaoling 14.8 366
Xiaoling 1.2 367 Assume we already set up ABP keys in the gateway:
368
Xiaoling 10.2 369 [[image:image-20220527162852-8.png]]
Xiaoling 1.2 370
371 Input Keys in LPS8
372
Xiaoling 10.2 373
Xiaoling 1.2 374
Xiaoling 14.8 375 **run socket tool in PC**
376
Xiaoling 10.2 377 [[image:image-20220527163028-9.png]]
Xiaoling 1.2 378
Xiaoling 10.2 379
Xiaoling 1.2 380 Socket tool
381
382
383
Xiaoling 14.8 384 **Input Server address and port**
385
Xiaoling 11.2 386 [[image:image-20220527163106-10.png]]
Xiaoling 1.2 387
388 Input Server address and port
389
390
391
Xiaoling 14.8 392 **See value receive in socket tool:**
393
Xiaoling 12.2 394 [[image:image-20220527163144-11.png]]
Xiaoling 1.2 395
396 value receive in socket tool
397
Xiaoling 14.8 398
Xiaoling 1.2 399 If user want to modify the TCP connection method. He can refer: [[https:~~/~~/github.com/dragino/dragino-packages/blob/lg02/haserl-ui/root/usr/bin/tcp_process.sh>>url:https://github.com/dragino/dragino-packages/blob/lg02/haserl-ui/root/usr/bin/tcp_process.sh]]. Same script is on /usr/bin of gateway.