Hide last authors
Xiaoling 151.2 1
2
Ellie Zhang 114.1 3 (% style="text-align:center" %)
Xiaoling 151.2 4 [[image:D2x.jpg||height="382" width="1535"]]
Xiaoling 6.2 5
6
Xiaoling 151.2 7 (% style="text-align:center" %)
8 [[image:image-20240104113827-6.png]]
Xiaoling 6.2 9
Xiaoling 151.2 10 [[image:image-20240104113457-1.png||height="349" width="289"]] (% style="display:none" %) (%%) [[image:image-20240104113523-2.png||height="346" width="316"]] (% style="display:none" %) (%%) [[image:image-20240104113548-3.png||height="359" width="330"]] (% style="display:none" %) (%%) [[image:image-20240104113631-5.png||height="365" width="400"]]
11
Xiaoling 150.2 12 (% style="display:none" %) (%%)
Ellie Zhang 115.1 13
Xiaoling 150.2 14 (% style="display:none" %) (%%)
15
16
kai 117.1 17 **Table of Contents:**
Ellie Zhang 110.1 18
Xiaoling 42.4 19 {{toc/}}
Xiaoling 6.2 20
21
22
Xiaoling 42.5 23
24
25
kai 116.1 26 = 1. Introduction =
Xiaoling 6.2 27
kai 116.1 28 == 1.1 What is D2x-LB LoRaWAN Temperature Sensor ==
Xiaoling 9.2 29
Xiaoling 121.3 30
Ellie Zhang 118.1 31 The Dragino D2x-LB is a (% style="color:blue" %)**LoRaWAN Temperature Sensor**(%%) for Internet of Things solution. D2x-LB has 1 ~~ 3 temperature probes. D2x-LB will convert the Temperature reading to LoRaWAN wireless data and send to IoT platform via LoRaWAN gateway.
Xiaoling 72.5 32
kai 116.1 33 The LoRa wireless technology used in D2x-LB allows device to send data and reach extremely long ranges at low data-rates. It provides ultra-long range spread spectrum communication and high interference immunity whilst minimizing current consumption.
Xiaoling 6.2 34
Ellie Zhang 118.1 35 The temperature sensor used in D2x-LB can (% style="color:blue" %)**measure -55°C ~~ 125°C with accuracy ±0.5°C (max ±2.0 °C)**(%%).
Xiaoling 6.2 36
Ellie Zhang 118.1 37 D2x-LB supports (% style="color:blue" %)**temperature alarm feature**(%%), user can set temperature alarm for instant notice. D2x-LB supports Datalog feature, it can save the data when there is no LoRaWAN network and uplink when network recover.
Edwin Chen 63.1 38
kai 116.1 39 D2x-LB has max 3 probes which measure maximum 3 temperature points.
Edwin Chen 63.1 40
Ellie Zhang 118.1 41 D2x-LB (% style="color:blue" %)**supports BLE configure**(%%) and (% style="color:blue" %)**wireless OTA update**(%%) which make user easy to use.
Edwin Chen 63.1 42
Ellie Zhang 118.1 43 D2x-LB is powered by (% style="color:blue" %)**8500mAh Li-SOCI2 battery**(%%), it is designed for long term use up to 5 years.
Xiaoling 6.2 44
kai 116.1 45 Each D2x-LB is pre-load with a set of unique keys for LoRaWAN registrations, register these keys to local LoRaWAN server and it will auto connect after power on.
Xiaoling 6.2 46
47
kai 116.1 48 == 1.2 ​Features ==
Edwin Chen 64.1 49
Xiaoling 121.3 50
kai 116.1 51 * LoRaWAN 1.0.3 Class A
52 * Ultra-low power consumption
53 * 1 ~~ 3 External Temperature Probes
54 * Measure range -55°C ~~ 125°C
55 * Temperature alarm
56 * Bands: CN470/EU433/KR920/US915/EU868/AS923/AU915/IN865
57 * Support Bluetooth v5.1 and LoRaWAN remote configure
Xiaoling 6.2 58 * Support wireless OTA update firmware
59 * Uplink on periodically
60 * Downlink to change configure
61 * 8500mAh Battery for long term use
62
Xiaoling 9.2 63 == 1.3 Specification ==
64
65
Xiaoling 42.17 66 (% style="color:#037691" %)**Common DC Characteristics:**
Xiaoling 6.2 67
Edwin Chen 64.1 68 * Supply Voltage: built in 8500mAh Li-SOCI2 battery , 2.5v ~~ 3.6v
Xiaoling 6.2 69 * Operating Temperature: -40 ~~ 85°C
70
Edwin Chen 64.1 71 (% style="color:#037691" %)**Temperature Sensor:**
72
73 * Dallas DS18B20
74 * Range: -55 to + 125°C
75 * Accuracy ±0.5°C (max ±2.0 °C).
76
Xiaoling 42.17 77 (% style="color:#037691" %)**LoRa Spec:**
Xiaoling 6.2 78
79 * Frequency Range,  Band 1 (HF): 862 ~~ 1020 Mhz
80 * Max +22 dBm constant RF output vs.
81 * RX sensitivity: down to -139 dBm.
82 * Excellent blocking immunity
83
Xiaoling 42.17 84 (% style="color:#037691" %)**Battery:**
Xiaoling 6.2 85
86 * Li/SOCI2 un-chargeable battery
87 * Capacity: 8500mAh
88 * Self-Discharge: <1% / Year @ 25°C
89 * Max continuously current: 130mA
90 * Max boost current: 2A, 1 second
91
Xiaoling 42.17 92 (% style="color:#037691" %)**Power Consumption**
Xiaoling 6.2 93
94 * Sleep Mode: 5uA @ 3.3v
95 * LoRa Transmit Mode: 125mA @ 20dBm, 82mA @ 14dBm
96
Edwin Chen 65.1 97 == 1.4 Sleep mode and working mode ==
Xiaoling 6.2 98
99
Xiaoling 42.17 100 (% style="color:blue" %)**Deep Sleep Mode: **(%%)Sensor doesn't have any LoRaWAN activate. This mode is used for storage and shipping to save battery life.
Xiaoling 6.2 101
Xiaoling 42.17 102 (% style="color:blue" %)**Working Mode:** (%%)In this mode, Sensor will work as LoRaWAN Sensor to Join LoRaWAN network and send out sensor data to server. Between each sampling/tx/rx periodically, sensor will be in IDLE mode), in IDLE mode, sensor has the same power consumption as Deep Sleep mode.
Xiaoling 6.2 103
104
Edwin Chen 65.1 105 == 1.5 Button & LEDs ==
Xiaoling 6.2 106
107
Xiaoling 14.2 108 [[image:1675071855856-879.png]]
Xiaoling 6.2 109
110
Xiaoling 98.3 111 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
Xiaoling 98.2 112 |=(% style="width: 167px;background-color:#D9E2F3;color:#0070C0" %)**Behavior on ACT**|=(% style="width: 117px;background-color:#D9E2F3;color:#0070C0" %)**Function**|=(% style="width: 225px;background-color:#D9E2F3;color:#0070C0" %)**Action**
Xiaoling 42.32 113 |(% style="width:167px" %)Pressing ACT between 1s < time < 3s|(% style="width:117px" %)Send an uplink|(% style="width:225px" %)(((
Xiaoling 42.17 114 If sensor is already Joined to LoRaWAN network, sensor will send an uplink packet, (% style="color:blue" %)**blue led** (%%)will blink once.
Xiaoling 6.2 115 Meanwhile, BLE module will be active and user can connect via BLE to configure device.
116 )))
Xiaoling 42.32 117 |(% style="width:167px" %)Pressing ACT for more than 3s|(% style="width:117px" %)Active Device|(% style="width:225px" %)(((
Xiaoling 42.17 118 (% style="color:green" %)**Green led**(%%) will fast blink 5 times, device will enter (% style="color:#037691" %)**OTA mode**(%%) for 3 seconds. And then start to JOIN LoRaWAN network.
119 (% style="color:green" %)**Green led**(%%) will solidly turn on for 5 seconds after joined in network.
Xiaoling 6.2 120 Once sensor is active, BLE module will be active and user can connect via BLE to configure device, no matter if device join or not join LoRaWAN network.
121 )))
Xiaoling 61.5 122 |(% style="width:167px" %)Fast press ACT 5 times.|(% style="width:117px" %)Deactivate Device|(% style="width:225px" %)(% style="color:red" %)**Red led**(%%) will solid on for 5 seconds. Means D2x-LB is in Deep Sleep Mode.
Xiaoling 6.2 123
Edwin Chen 65.1 124 == 1.6 BLE connection ==
Xiaoling 6.2 125
126
Xiaoling 61.5 127 D2x-LB support BLE remote configure.
Xiaoling 6.2 128
129
130 BLE can be used to configure the parameter of sensor or see the console output from sensor. BLE will be only activate on below case:
131
132 * Press button to send an uplink
133 * Press button to active device.
134 * Device Power on or reset.
135
136 If there is no activity connection on BLE in 60 seconds, sensor will shut down BLE module to enter low power mode.
137
Edwin Chen 69.1 138
Saxer Lin 124.2 139 == 1.7 Pin Definitions ==
Xiaoling 6.2 140
Saxer Lin 143.1 141 [[image:http://8.211.40.43/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/SN50v3-LB/WebHome/image-20230610163213-1.png?width=699&height=404&rev=1.1||alt="image-20230610163213-1.png"]]
Xiaoling 6.2 142
Saxer Lin 124.2 143
144 == 1.8 Hardware Variant ==
145
146
Xiaoling 136.4 147 (% border="1" cellspacing="5" style="width:510px" %)
Xiaoling 98.24 148 |=(% style="width: 102px;background-color:#D9E2F3;color:#0070C0" %)Model|=(% style="width: 190px;background-color:#D9E2F3;color:#0070C0" %)Photo|=(% style="width: 218px;background-color:#D9E2F3;color:#0070C0" %)Probe Info
Xiaoling 140.2 149 |(% style="width:102px" %)D20-LB|(% style="width:190px" %)(((
150 (% style="text-align:center" %)
151 [[image:image-20230526153320-2.jpeg]]
152 )))|(% style="width:297px" %)(((
Edwin Chen 68.1 153 1 x DS28B20 Probe
Xiaoling 6.2 154
Edwin Chen 68.1 155 Cable Length : 2 meters
Edwin Chen 70.1 156
Edwin Chen 71.1 157
Edwin Chen 70.1 158 )))
Xiaoling 140.2 159 |(% style="width:102px" %)D20S-LB|(% style="width:190px" %)(((
160 (% style="text-align:center" %)
161 [[image:image-20230526150859-1.jpeg]]
162 )))|(% style="width:297px" %)(((
Edwin Chen 119.1 163 1 x DS28B20 Probe (Suitable for bury in soil)
164
165 Material: TPE, Cable Length: 2meters
166 )))
Xiaoling 140.2 167 |(% style="width:102px" %)D22-LB|(% style="width:190px" %)(((
168 (% style="text-align:center" %)
169 [[image:image-20230526153345-3.jpeg]]
170 )))|(% style="width:297px" %)(((
Edwin Chen 68.1 171 2 x DS28B20 Probes
172
173 Cable lengths total 1.5meters per probe
174
175 Cable Drawing: [[See This Link>>url:https://www.dragino.com/downloads/index.php?dir=LoRa_End_Node/LSN50v2-D20/Cable_Drawing/&file=CAB0-35IC-K21G-210811.pdf]]
Edwin Chen 70.1 176 )))
Edwin Chen 71.1 177 |(% style="width:102px" %)(((
Xiaoling 98.3 178 (((
179 D23-LB
180 )))
181
182 (((
183
184 )))
Xiaoling 140.2 185 )))|(% style="width:190px" %)(((
186 (% style="text-align:center" %)
187 [[image:image-20230526153417-4.jpeg]]
188 )))|(% style="width:297px" %)(((
Edwin Chen 68.1 189 3 x DS28B20 Probes
190
191 Cable lengths total 1.5meters per probe
192
193 Cable Drawing: [[See This Link>>url:https://www.dragino.com/downloads/index.php?dir=LoRa_End_Node/LSN50v2-D20/Cable_Drawing/&file=CAB0-35IC-K31G-210811.pdf]]
Edwin Chen 70.1 194 )))
Edwin Chen 68.1 195
196 (% style="display:none" %)
197
198
Xiaoling 72.5 199
Saxer Lin 124.2 200 == 1.9 Mechanical ==
Edwin Chen 68.1 201
202
Xiaoling 17.2 203 [[image:1675143884058-338.png]]
Xiaoling 6.2 204
205
Xiaoling 26.2 206 [[image:1675143899218-599.png]]
Xiaoling 6.2 207
208
Xiaoling 26.2 209 [[image:1675143909447-639.png]]
Xiaoling 6.2 210
Xiaoling 26.2 211
Xiaoling 61.5 212 = 2. Configure D2x-LB to connect to LoRaWAN network =
Xiaoling 26.2 213
214 == 2.1 How it works ==
215
216
Edwin Chen 67.1 217 The D2x-LB is configured as (% style="color:#037691" %)**LoRaWAN OTAA Class A**(%%) mode by default. It has OTAA keys to join LoRaWAN network. To connect a local LoRaWAN network, you need to input the OTAA keys in the LoRaWAN IoT server and press the button to activate the D2x-LB. It will automatically join the network via OTAA and start to send the sensor value. The default uplink interval is 20 minutes.
Xiaoling 6.2 218
219
Xiaoling 26.2 220 == 2.2 ​Quick guide to connect to LoRaWAN server (OTAA) ==
221
222
Xiaoling 6.2 223 Following is an example for how to join the [[TTN v3 LoRaWAN Network>>url:https://console.cloud.thethings.network/]]. Below is the network structure; we use the [[LPS8v2>>url:https://www.dragino.com/products/lora-lorawan-gateway/item/228-lps8v2.html]] as a LoRaWAN gateway in this example.
224
225 The LPS8V2 is already set to connected to [[TTN network >>url:https://console.cloud.thethings.network/]], so what we need to now is configure the TTN server.
226
227
Xiaoling 61.5 228 (% style="color:blue" %)**Step 1:**(%%) Create a device in TTN with the OTAA keys from D2x-LB.
Xiaoling 6.2 229
Xiaoling 61.5 230 Each D2x-LB is shipped with a sticker with the default device EUI as below:
Xiaoling 6.2 231
Ellie Zhang 114.1 232 [[image:image-20230426084024-1.png||alt="图片-20230426084024-1.png" height="236" width="508"]]
Xiaoling 6.2 233
234
235 You can enter this key in the LoRaWAN Server portal. Below is TTN screen shot:
236
237
Xiaoling 42.17 238 (% style="color:blue" %)**Register the device**
Xiaoling 6.2 239
Xiaoling 26.2 240 [[image:1675144099263-405.png]]
Xiaoling 6.2 241
242
Xiaoling 42.17 243 (% style="color:blue" %)**Add APP EUI and DEV EUI**
Xiaoling 6.2 244
Xiaoling 26.2 245 [[image:1675144117571-832.png]]
Xiaoling 6.2 246
247
Xiaoling 42.17 248 (% style="color:blue" %)**Add APP EUI in the application**
Xiaoling 6.2 249
250
Xiaoling 26.2 251 [[image:1675144143021-195.png]]
Xiaoling 6.2 252
253
Xiaoling 42.17 254 (% style="color:blue" %)**Add APP KEY**
Xiaoling 6.2 255
Xiaoling 26.2 256 [[image:1675144157838-392.png]]
Xiaoling 6.2 257
Xiaoling 61.5 258 (% style="color:blue" %)**Step 2:**(%%) Activate on D2x-LB
Xiaoling 6.2 259
260
Xiaoling 61.5 261 Press the button for 5 seconds to activate the D2x-LB.
Xiaoling 6.2 262
Xiaoling 42.17 263 (% style="color:green" %)**Green led**(%%) will fast blink 5 times, device will enter (% style="color:blue" %)**OTA mode**(%%) for 3 seconds. And then start to JOIN LoRaWAN network. (% style="color:green" %)**Green led**(%%) will solidly turn on for 5 seconds after joined in network.
Xiaoling 6.2 264
265 After join success, it will start to upload messages to TTN and you can see the messages in the panel.
266
267
Xiaoling 27.2 268 == 2.3 ​Uplink Payload ==
Xiaoling 6.2 269
Xiaoling 27.2 270 === 2.3.1 Device Status, FPORT~=5 ===
Xiaoling 6.2 271
272
Edwin Chen 72.1 273 Users can use the downlink command(**0x26 01**) to ask D2x-LB to send device configure detail, include device configure status. D2x-LB will uplink a payload via FPort=5 to server.
Xiaoling 6.2 274
Edwin Chen 72.1 275 The Payload format is as below.
Xiaoling 6.2 276
Xiaoling 98.9 277 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
Xiaoling 98.5 278 |(% colspan="6" style="background-color:#d9e2f3; color:#0070c0" %)**Device Status (FPORT=5)**
Xiaoling 42.32 279 |(% style="width:103px" %)**Size (bytes)**|(% style="width:72px" %)**1**|**2**|(% style="width:91px" %)**1**|(% style="width:86px" %)**1**|(% style="width:44px" %)**2**
280 |(% style="width:103px" %)**Value**|(% style="width:72px" %)Sensor Model|Firmware Version|(% style="width:91px" %)Frequency Band|(% style="width:86px" %)Sub-band|(% style="width:44px" %)BAT
Xiaoling 6.2 281
282 Example parse in TTNv3
283
Saxer Lin 136.1 284 [[image:image-20230524160021-1.png||height="149" width="1193"]]
Xiaoling 6.2 285
286
Edwin Chen 72.1 287 (% style="color:#037691" %)**Sensor Model**(%%): For D2x-LB, this value is 0x19
Xiaoling 6.2 288
Xiaoling 42.17 289 (% style="color:#037691" %)**Firmware Version**(%%): 0x0100, Means: v1.0.0 version
Xiaoling 6.2 290
Xiaoling 42.17 291 (% style="color:#037691" %)**Frequency Band**:
Xiaoling 6.2 292
Xiaoling 144.2 293 0x01: EU868
Xiaoling 6.2 294
Xiaoling 144.2 295 0x02: US915
Xiaoling 6.2 296
Xiaoling 144.2 297 0x03: IN865
Xiaoling 6.2 298
Xiaoling 144.2 299 0x04: AU915
Xiaoling 6.2 300
Xiaoling 144.2 301 0x05: KZ865
Xiaoling 6.2 302
Xiaoling 144.2 303 0x06: RU864
Xiaoling 6.2 304
Xiaoling 144.2 305 0x07: AS923
Xiaoling 6.2 306
Xiaoling 144.2 307 0x08: AS923-1
Xiaoling 6.2 308
Xiaoling 144.2 309 0x09: AS923-2
Xiaoling 6.2 310
Xiaoling 144.2 311 0x0a: AS923-3
Xiaoling 6.2 312
Xiaoling 144.2 313 0x0b: CN470
Xiaoling 6.2 314
Xiaoling 144.2 315 0x0c: EU433
Xiaoling 6.2 316
Xiaoling 144.2 317 0x0d: KR920
Xiaoling 6.2 318
Xiaoling 144.2 319 0x0e: MA869
Xiaoling 6.2 320
321
Xiaoling 42.17 322 (% style="color:#037691" %)**Sub-Band**:
Xiaoling 6.2 323
324 AU915 and US915:value 0x00 ~~ 0x08
325
326 CN470: value 0x0B ~~ 0x0C
327
328 Other Bands: Always 0x00
329
330
Xiaoling 42.17 331 (% style="color:#037691" %)**Battery Info**:
Xiaoling 6.2 332
333 Check the battery voltage.
334
335 Ex1: 0x0B45 = 2885mV
336
337 Ex2: 0x0B49 = 2889mV
338
339
Edwin Chen 73.1 340 === 2.3.2  Sensor Data. FPORT~=2 ===
Xiaoling 6.2 341
342
Edwin Chen 73.1 343 D2x-LB will uplink below payload via FPORT=2 after Joined LoRaWAN Network.
Xiaoling 6.2 344
Xiaoling 140.3 345 (% border="1" cellspacing="5" style="background-color:#f2f2f2; width:520px" %)
Xiaoling 140.4 346 |=(% style="width: 60px;background-color:#D9E2F3;color:#0070C0" %)(((
Xiaoling 98.16 347 **Size(bytes)**
Xiaoling 140.8 348 )))|=(% style="width: 42px; background-color:#D9E2F3;color:#0070C0" %)2|=(% style="width: 118px; background-color:#D9E2F3;color:#0070C0;" %)2|=(% style="width: 42px; background-color:#D9E2F3;color:#0070C0" %)2|=(% style="width: 118px; background-color:#D9E2F3;color:#0070C0" %)1|=(% style="width: 70px; background-color:#D9E2F3;color:#0070C0" %)**2**|=(% style="width: 70px; background-color:#D9E2F3;color:#0070C0" %)2
Xiaoling 140.3 349 |(% style="width:65px" %)**Value**|(% style="width:66px" %)(((
Saxer Lin 124.2 350 Battery
Xiaoling 140.3 351 )))|(% style="width:108px" %)(((
Saxer Lin 124.2 352 Temp_ Red or Temp _White
Xiaoling 140.3 353 )))|(% style="width:62px" %)(((
Xiaoling 72.2 354 ignore
Xiaoling 140.3 355 )))|(% style="width:106px" %)(((
356 Alarm Flag & MOD& Level of PA8
357 )))|(% style="width:100px" %)(((
Saxer Lin 124.2 358 Temp_White
Xiaoling 140.3 359 )))|(% style="width:95px" %)(((
Saxer Lin 124.2 360 Temp_Black
Edwin Chen 90.1 361
362
Xiaoling 72.2 363 )))
Xiaoling 6.2 364
Edwin Chen 90.1 365 **Payload per each model.**
Bei Jinggeng 45.1 366
Ellie Zhang 114.1 367 [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LSN50v2-D20-D22-D23%20LoRaWAN%20Temperature%20Sensor%20User%20Manual/WebHome/image-20220916152530-2.png?rev=1.1||alt="图片-20220916152530-2.png" height="240" width="901"]]
Bei Jinggeng 45.1 368
Edwin Chen 90.1 369
Saxer Lin 136.1 370 [[image:image-20230524160233-2.png||height="184" width="1173"]]
Edwin Chen 90.1 371
372
Xiaoling 137.4 373 ==== (% style="color:blue" %)**Decode corresponding probe color:**(%%) ====
Edwin Chen 90.1 374
375 **D20:**
376
377 Red <~-~-> C1
378
Xiaoling 121.4 379
Edwin Chen 90.1 380 **D22:**
381
Saxer Lin 136.1 382 White <~-~-> C1 , Red <~-~-> C2
Edwin Chen 90.1 383
Xiaoling 121.4 384
Edwin Chen 90.1 385 **D23:**
386
Saxer Lin 136.1 387 White <~-~->C1  , Red <~-~-> C2  , Black <~-~-> C3
Edwin Chen 90.1 388
389
390
Xiaoling 137.4 391 ==== (% style="color:blue" %)**Battery:**(%%) ====
Xiaoling 6.2 392
Edwin Chen 73.1 393 Sensor Battery Level.
Xiaoling 72.2 394
Xiaoling 6.2 395 Ex1: 0x0B45 = 2885mV
396
397 Ex2: 0x0B49 = 2889mV
398
399
Bei Jinggeng 45.1 400
Xiaoling 137.4 401 ==== (% style="color:blue" %)**Temperature RED or Temperature White :**(%%) ====
Xiaoling 6.2 402
Xiaoling 121.4 403
Xiaoling 137.4 404 (% style="color:red" %)**This point to the Red probe in D20-LB or the probe of D22-LB/D23-LB White**
Xiaoling 6.2 405
Xiaoling 72.2 406 **Example**:
Xiaoling 6.2 407
Xiaoling 72.2 408 If payload is: 0105H:  (0105 & 8000 == 0), temp = 0105H /10 = 26.1 degree
Xiaoling 6.2 409
Xiaoling 72.2 410 If payload is: FF3FH :  (FF3F & 8000 == 1) , temp = (FF3FH - 65536)/10 = -19.3 degrees.
Xiaoling 37.2 411
Xiaoling 72.2 412 (FF3F & 8000:Judge whether the highest bit is 1, when the highest bit is 1, it is negative)
Bei Jinggeng 47.1 413
Xiaoling 6.2 414
415
Xiaoling 137.4 416 ==== (% style="color:blue" %)**Temperature White:**(%%) ====
Edwin Chen 50.1 417
418
Xiaoling 137.4 419 (% style="color:red" %)**This point to the Red probe in D22-LB/D23-LB.**
Edwin Chen 50.1 420
Xiaoling 137.4 421 (% style="color:red" %)**If it is D20-LB, the value is 0x7FFF, which is 327.67.**
Xiaoling 6.2 422
Saxer Lin 136.1 423
Xiaoling 72.2 424 **Example**:
Xiaoling 37.2 425
Xiaoling 72.2 426 If payload is: 0105H:  (0105 & 8000 == 0), temp = 0105H /10 = 26.1 degree
Xiaoling 6.2 427
Xiaoling 72.2 428 If payload is: FF3FH :  (FF3F & 8000 == 1) , temp = (FF3FH - 65536)/10 = -19.3 degrees.
Xiaoling 6.2 429
Xiaoling 72.2 430 (FF3F & 8000:Judge whether the highest bit is 1, when the highest bit is 1, it is negative)
Xiaoling 6.2 431
432
433
Xiaoling 137.4 434 ==== (% style="color:blue" %)**Temperature Black:**(%%) ====
Xiaoling 37.2 435
Xiaoling 6.2 436
Xiaoling 140.2 437 (% style="color:red" %)**This point to the BLACK probe in D23-LB**
Xiaoling 6.2 438
Xiaoling 140.2 439 (% style="color:red" %)**If it is D20-LB/D22-LB, the value is 0x7FFF, which is 327.67.**
Xiaoling 6.2 440
Saxer Lin 136.1 441
Xiaoling 72.2 442 **Example**:
Xiaoling 6.2 443
Xiaoling 72.2 444 If payload is: 0105H:  (0105 & 8000 == 0), temp = 0105H /10 = 26.1 degree
Xiaoling 6.2 445
Xiaoling 72.2 446 If payload is: FF3FH :  (FF3F & 8000 == 1) , temp = (FF3FH - 65536)/10 = -19.3 degrees.
Xiaoling 6.2 447
Xiaoling 72.2 448 (FF3F & 8000:Judge whether the highest bit is 1, when the highest bit is 1, it is negative)
Xiaoling 6.2 449
450
451
Xiaoling 137.4 452 ==== (% style="color:blue" %)**Alarm Flag & MOD & Level of PA8:**(%%) ====
Xiaoling 6.2 453
Xiaoling 50.2 454
Xiaoling 72.2 455 **Example:**
Xiaoling 6.2 456
Saxer Lin 136.1 457 If payload & 0x01 = 0x01  **~-~->** This is an Alarm Message.It means that the temperature exceed the alarm value or trigger an interrupt.
Bei Jinggeng 47.1 458
Saxer Lin 136.1 459 If payload & 0x01 = 0x00  **~-~->** This is a normal uplink message, no alarm.
Xiaoling 72.2 460
Saxer Lin 136.1 461 If payload & 0x80>>7 = 0x01  **~-~->** The PA8 is low level.
Xiaoling 72.2 462
Saxer Lin 136.1 463 If payload & 0x80>>7 =0x00  **~-~->** The PA8 is high level.
464
465 If payload >> 2 = 0x00  **~-~->**  means MOD=1, This is a sampling uplink message.
466
467 If payload >> 2 = 0x31  **~-~->**  means MOD=31, this message is a reply message for polling, this message contains the alarm settings. see [[this link>>url:http://8.211.40.43/xwiki/bin/view/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/S31-LB_S31B-LB/#HPolltheAlarmsettings:]] for detail. 
468
469
Edwin Chen 80.1 470 == 2.4 Payload Decoder file ==
Xiaoling 72.2 471
472
473 (((
474 In TTN, use can add a custom payload so it shows friendly. 
Bei Jinggeng 47.1 475 )))
476
Xiaoling 72.2 477 (((
Saxer Lin 122.1 478 In the page **Applications ~-~-> Payload Formats ~-~-> Custom ~-~-> decoder** to add the decoder from: 
Saxer Lin 122.4 479
480 [[https:~~/~~/github.com/dragino/dragino-end-node-decoder/tree/main/D20-LB%26D20S-LB%26D22-LB%26D23-LB>>https://github.com/dragino/dragino-end-node-decoder/tree/main/D20-LB%26D20S-LB%26D22-LB%26D23-LB]]
Saxer Lin 123.1 481
482
Xiaoling 72.2 483 )))
Bei Jinggeng 47.1 484
Edwin Chen 81.1 485 == 2.5 Datalog Feature ==
486
Xiaoling 84.2 487
Edwin Chen 81.1 488 Datalog Feature is to ensure IoT Server can get all sampling data from Sensor even if the LoRaWAN network is down. For each sampling, D2x-LB will store the reading for future retrieving purposes.
489
490
491 === 2.5.1 Ways to get datalog via LoRaWAN ===
492
Xiaoling 84.2 493
Xiaoling 98.9 494 Set [[PNACKMD=1>>||anchor="H2.5.4DatalogUplinkpayloadA028FPORT3D329"]], D2x-LB will wait for ACK for every uplink, when there is no LoRaWAN network,D2x-LB will mark these records with non-ack messages and store the sensor data, and it will send all messages (10s interval) after the network recovery.
Edwin Chen 81.1 495
496 * a) D2x-LB will do an ACK check for data records sending to make sure every data arrive server.
497 * b) D2x-LB will send data in **CONFIRMED Mode** when PNACKMD=1, but D2x-LB won't re-transmit the packet if it doesn't get ACK, it will just mark it as a NONE-ACK message. In a future uplink if D2x-LB gets a ACK, D2x-LB will consider there is a network connection and resend all NONE-ACK Message.
498
499 Below is the typical case for the auto-update datalog feature (Set PNACKMD=1)
500
Ellie Zhang 114.1 501 [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LHT65N%20LoRaWAN%20Temperature%20%26%20Humidity%20Sensor%20Manual/WebHome/image-20220703111700-2.png?width=1119&height=381&rev=1.1||alt="图片-20220703111700-2.png" height="381" width="1119"]]
Edwin Chen 81.1 502
Xiaoling 121.5 503
Edwin Chen 81.1 504 === 2.5.2 Unix TimeStamp ===
505
Xiaoling 84.2 506
Xiaoling 98.11 507 D2x-LB uses Unix TimeStamp format based on
Edwin Chen 81.1 508
Ellie Zhang 114.1 509 [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LHT65N%20LoRaWAN%20Temperature%20%26%20Humidity%20Sensor%20Manual/WebHome/image-20220523001219-11.png?width=627&height=97&rev=1.1||alt="图片-20220523001219-11.png" height="97" width="627"]]
Edwin Chen 81.1 510
511 User can get this time from link:  [[https:~~/~~/www.epochconverter.com/>>url:https://www.epochconverter.com/]] :
512
513 Below is the converter example
514
Ellie Zhang 114.1 515 [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LHT65N%20LoRaWAN%20Temperature%20%26%20Humidity%20Sensor%20Manual/WebHome/image-20220523001219-12.png?width=720&height=298&rev=1.1||alt="图片-20220523001219-12.png" height="298" width="720"]]
Edwin Chen 81.1 516
517 So, we can use AT+TIMESTAMP=1611889405 or downlink 3060137afd00 to set the current time 2021 – Jan ~-~- 29 Friday 03:03:25
518
519
520 === 2.5.3 Set Device Time ===
521
Xiaoling 84.2 522
Xiaoling 98.10 523 User need to set (% style="color:blue" %)**SYNCMOD=1**(%%) to enable sync time via MAC command.
Edwin Chen 81.1 524
525 Once D2x-LB Joined LoRaWAN network, it will send the MAC command (DeviceTimeReq) and the server will reply with (DeviceTimeAns) to send the current time to D2x-LB. If D2x-LB fails to get the time from the server, D2x-LB will use the internal time and wait for next time request (AT+SYNCTDC to set the time request period, default is 10 days).
526
Xiaoling 98.12 527 (% style="color:red" %)**Note: LoRaWAN Server need to support LoRaWAN v1.0.3(MAC v1.0.3) or higher to support this MAC command feature, Chirpstack,TTN V3 v3 and loriot support but TTN V3 v2 doesn't support. If server doesn't support this command, it will through away uplink packet with this command, so user will lose the packet with time request for TTN V3 v2 if SYNCMOD=1.**
Edwin Chen 81.1 528
529
Edwin Chen 95.1 530 === 2.5.4 Datalog Uplink payload  (FPORT~=3) ===
Edwin Chen 81.1 531
Xiaoling 84.2 532
Edwin Chen 81.1 533 The Datalog poll reply uplink will use below payload format.
534
535 **Retrieval data payload:**
536
Xiaoling 140.6 537 (% border="1" cellspacing="5" style="background-color:#f2f2f2; width:520px" %)
Xiaoling 140.10 538 |=(% style="width: 60px;background-color:#D9E2F3;color:#0070C0" %)(((
Edwin Chen 81.1 539 **Size(bytes)**
Xiaoling 140.7 540 )))|=(% style="width: 62px; background-color:#D9E2F3;color:#0070C0" %)**2**|=(% style="width: 62px; background-color:#D9E2F3;color:#0070C0" %)**2**|=(% style="width: 118px; background-color:#D9E2F3;color:#0070C0" %)**2**|=(% style="width: 118px; background-color:#D9E2F3;color:#0070C0" %)**1**|=(% style="width: 100px; background-color:#D9E2F3;color:#0070C0" %)**4**
Xiaoling 98.16 541 |(% style="width:93px" %)**Value**|(% style="width:54px" %)(((
Saxer Lin 136.1 542 Temp_Black
543 )))|(% style="width:54px" %)Temp_White|(% style="width:132px" %)Temp_ Red or Temp _White|(% style="width:158px" %)(((
Xiaoling 140.7 544 Poll message flag & Alarm Flag& Level of PA8
Saxer Lin 136.1 545 )))|(% style="width:111px" %)Unix Time Stamp
546
Edwin Chen 81.1 547 **Poll message flag & Ext:**
548
Saxer Lin 136.1 549 [[image:image-20230524160709-3.png]]
Edwin Chen 81.1 550
Xiaoling 140.9 551 (% style="color:blue" %)**No ACK Message**(%%):  1: This message means this payload is fromn Uplink Message which doesn't get ACK from the server before ( for **PNACKMD=1** feature)
Edwin Chen 81.1 552
Xiaoling 140.9 553 (% style="color:blue" %)**Poll Message Flag**(%%): 1: This message is a poll message reply.
Edwin Chen 81.1 554
555 * Poll Message Flag is set to 1.
556
557 * Each data entry is 11 bytes, to save airtime and battery, devices will send max bytes according to the current DR and Frequency bands.
558
559 For example, in US915 band, the max payload for different DR is:
560
Xiaoling 140.9 561 (% style="color:blue" %)**a) DR0:**(%%) max is 11 bytes so one entry of data
Edwin Chen 81.1 562
Xiaoling 140.9 563 (% style="color:blue" %)**b) DR1:**(%%) max is 53 bytes so devices will upload 4 entries of data (total 44 bytes)
Edwin Chen 81.1 564
Xiaoling 140.9 565 (% style="color:blue" %)**c) DR2:**(%%) total payload includes 11 entries of data
Edwin Chen 81.1 566
Xiaoling 140.9 567 (% style="color:blue" %)**d) DR3: **(%%)total payload includes 22 entries of data.
Edwin Chen 81.1 568
569 If devise doesn't have any data in the polling time. Device will uplink 11 bytes of 0   
570
Xiaoling 98.17 571
Edwin Chen 81.1 572 **Example:**
573
574 If D2x-LB has below data inside Flash:
575
576
Saxer Lin 136.1 577 [[image:image-20230524160736-4.png]]
Xiaoling 101.2 578
Saxer Lin 136.1 579 If user sends below downlink command: 31646DBAA0646DBB5405
Edwin Chen 81.1 580
Saxer Lin 136.1 581 Where : Start time: 646DBAA0 = time 23/5/24 07:20:00
Edwin Chen 81.1 582
Saxer Lin 136.1 583 Stop time: 646DBB54= time 23/5/24 07:23:00
Edwin Chen 81.1 584
Xiaoling 98.17 585
Edwin Chen 95.1 586 **D2x-LB will uplink this payload.**
Edwin Chen 81.1 587
588
Saxer Lin 136.1 589 [[image:image-20230524160755-5.png||height="368" width="1146"]]
Xiaoling 121.5 590
Xiaoling 140.13 591
Xiaoling 98.29 592 (((
Saxer Lin 136.1 593 01 08 01 05 01 08 40 64 6D BA A7 01 09 01 05 01 09 40 64 6D BA B6 01 09 01 05 01 09 40 64 6D BA C6 01 09 01 05 01 09 41 64 6D BA DD 01 09 01 05 01 09 43 64 6D BB 1E 01 09 01 06 01 09 41 64 6D BB 33 01 09 01 06 01 0A 40 64 6D BB 45 01 09 01 06 01 09 40 64 6D BB 51
Xiaoling 98.29 594 )))
Edwin Chen 81.1 595
Xiaoling 98.29 596 (((
Edwin Chen 81.1 597 Where the first 11 bytes is for the first entry:
Xiaoling 98.29 598 )))
Edwin Chen 81.1 599
Xiaoling 98.29 600 (((
Saxer Lin 136.1 601 01 08 01 05 01 08 40 64 6D BA A7
Xiaoling 98.29 602 )))
Edwin Chen 81.1 603
Xiaoling 98.29 604 (((
Saxer Lin 136.1 605 **Temp_Black**=0x0108/10=26.4
Xiaoling 98.29 606 )))
Edwin Chen 81.1 607
Xiaoling 98.29 608 (((
Saxer Lin 136.1 609 **Temp_White**=0x0105/10=26.1
Edwin Chen 81.1 610
Saxer Lin 136.1 611 **Temp_Red or White**=0x0108/10=26.4
Xiaoling 98.29 612 )))
Edwin Chen 81.1 613
Xiaoling 98.29 614 (((
Saxer Lin 136.1 615 **poll message flag & Alarm Flag & Level of PA8**=0x40,means reply data,sampling uplink message,the PA8 is low level.
Xiaoling 98.29 616 )))
Edwin Chen 81.1 617
Xiaoling 98.29 618 (((
Saxer Lin 136.1 619 **Unix time** is 0x646DBAA7=1684912807s=23/5/24 07:20:07
Xiaoling 98.29 620 )))
Edwin Chen 81.1 621
622
Ellie Zhang 114.1 623 (% aria-label="数据 URI 图像图像小部件" contenteditable="false" role="region" style="background-image:url(http://wiki1.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" tabindex="-1" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||alt="数据 URI 图片" data-widget="image" draggable="true" height="15" role="presentation" title="单击并拖动以移动" width="15"]](% aria-label="数据 URI 图像图像小部件" contenteditable="false" role="region" style="background-image:url(http://wiki1.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220, 220, 220, 0.5); display:none" tabindex="-1" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||alt="数据 URI 图片" draggable="true" height="15" role="presentation" title="单击并拖动以移动" width="15"]](% aria-label="数据 URI 图像图像小部件" contenteditable="false" role="region" style="background-image:url(http://wiki1.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" tabindex="-1" title="单击并拖动以调整大小" %)的(% aria-label="数据 URI 图像图像小部件" contenteditable="false" role="region" style="background-image:url(http://wiki1.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" tabindex="-1" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||alt="数据 URI 图片" data-widget="image" draggable="true" height="15" role="presentation" title="单击并拖动以移动" width="15"]](% aria-label="数据 URI 图像图像小部件" contenteditable="false" role="region" style="background-image:url(http://wiki1.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220, 220, 220, 0.5); display:none" tabindex="-1" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||alt="数据 URI 图片" draggable="true" height="15" role="presentation" title="单击并拖动以移动" width="15"]](% aria-label="数据 URI 图像图像小部件" contenteditable="false" role="region" style="background-image:url(http://wiki1.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" tabindex="-1" title="单击并拖动以调整大小" %)的
Bei Jinggeng 47.1 624
Edwin Chen 81.1 625 == 2.6 Temperature Alarm Feature ==
Xiaoling 6.2 626
627
Xiaoling 72.2 628 D2x-LB work flow with Alarm feature.
Xiaoling 6.2 629
630
Ellie Zhang 114.1 631 [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LSN50v2-D20-D22-D23%20LoRaWAN%20Temperature%20Sensor%20User%20Manual/WebHome/image-20220623090437-1.png?rev=1.1||alt="图片-20220623090437-1.png"]]
Xiaoling 6.2 632
633
Edwin Chen 81.1 634 == 2.7 Frequency Plans ==
Xiaoling 6.2 635
636
Xiaoling 61.5 637 The D2x-LB uses OTAA mode and below frequency plans by default. If user want to use it with different frequency plan, please refer the AT command sets.
Xiaoling 6.2 638
Xiaoling 37.3 639 [[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20Frequency%20Band/>>http://wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20Frequency%20Band/]]
Xiaoling 6.2 640
641
Edwin Chen 81.1 642 == 2.8 ​Firmware Change Log ==
Xiaoling 6.2 643
644
645 **Firmware download link:**
646
Xiaoling 121.4 647 [[https:~~/~~/www.dropbox.com/sh/tcpq06yl7rxrgcz/AACpAC7cy-tnGPqn6T6SUDEaa?dl=0>>https://www.dropbox.com/sh/tcpq06yl7rxrgcz/AACpAC7cy-tnGPqn6T6SUDEaa?dl=0]]
Xiaoling 6.2 648
649
Edwin Chen 74.1 650 = 3. Configure D2x-LB =
Xiaoling 37.4 651
Edwin Chen 75.1 652 == 3.1 Configure Methods: ==
Xiaoling 6.2 653
Xiaoling 84.2 654
Edwin Chen 74.1 655 D2x-LB supports below configure method:
Xiaoling 6.2 656
Edwin Chen 84.1 657 * AT Command via Bluetooth Connection (**Recommended**): [[BLE Configure Instruction>>http://wiki.dragino.com/xwiki/bin/view/Main/BLE%20Bluetooth%20Remote%20Configure/]].
Edwin Chen 97.1 658 * AT Command via UART Connection : See [[Connection>>http://wiki.dragino.com/xwiki/bin/view/Main/UART%20Access%20for%20LoRa%20ST%20v4%20base%20model/#H2.3UARTConnectionforSN50v3basemotherboard]].
Edwin Chen 74.1 659 * LoRaWAN Downlink.  Instruction for different platforms: See [[IoT LoRaWAN Server>>http://wiki.dragino.com/xwiki/bin/view/Main/]] section.
660
Edwin Chen 75.1 661 == 3.2 General Commands ==
Xiaoling 6.2 662
Xiaoling 84.2 663
Xiaoling 6.2 664 These commands are to configure:
665
666 * General system settings like: uplink interval.
667 * LoRaWAN protocol & radio related command.
668
Edwin Chen 75.1 669 They are same for all Dragino Devices which support DLWS-005 LoRaWAN Stack. These commands can be found on the wiki:
Xiaoling 6.2 670
Xiaoling 37.5 671 [[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20AT%20Commands%20and%20Downlink%20Command/>>http://wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20AT%20Commands%20and%20Downlink%20Command/]]
Xiaoling 6.2 672
673
Edwin Chen 75.1 674 == 3.3 Commands special design for D2x-LB ==
Xiaoling 6.2 675
Edwin Chen 75.1 676
Xiaoling 61.5 677 These commands only valid for D2x-LB, as below:
Xiaoling 6.2 678
679
Edwin Chen 79.1 680 === 3.3.1 Set Transmit Interval Time ===
Xiaoling 6.2 681
Xiaoling 37.5 682
Xiaoling 6.2 683 Feature: Change LoRaWAN End Node Transmit Interval.
684
Xiaoling 42.21 685 (% style="color:blue" %)**AT Command: AT+TDC**
Xiaoling 6.2 686
Xiaoling 98.22 687 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
Xiaoling 98.19 688 |=(% style="width: 156px;background-color:#D9E2F3" %)**Command Example**|=(% style="width: 137px;background-color:#D9E2F3" %)**Function**|=(% style="background-color:#D9E2F3" %)**Response**
Xiaoling 42.25 689 |(% style="width:156px" %)AT+TDC=?|(% style="width:137px" %)Show current transmit Interval|(((
Xiaoling 6.2 690 30000
691 OK
692 the interval is 30000ms = 30s
693 )))
Xiaoling 42.25 694 |(% style="width:156px" %)AT+TDC=60000|(% style="width:137px" %)Set Transmit Interval|(((
Xiaoling 6.2 695 OK
696 Set transmit interval to 60000ms = 60 seconds
697 )))
698
Xiaoling 42.21 699 (% style="color:blue" %)**Downlink Command: 0x01**
Xiaoling 6.2 700
701 Format: Command Code (0x01) followed by 3 bytes time value.
702
Xiaoling 43.2 703 If the downlink payload=0100003C, it means set the END Node's Transmit Interval to 0x00003C=60(S), while type code is 01.
Xiaoling 6.2 704
Xiaoling 43.2 705 * Example 1: Downlink Payload: 0100001E  ~/~/  Set Transmit Interval (TDC) = 30 seconds
706 * Example 2: Downlink Payload: 0100003C  ~/~/  Set Transmit Interval (TDC) = 60 seconds
Xiaoling 6.2 707
Edwin Chen 79.1 708 === 3.3.2 Get Device Status ===
Xiaoling 6.2 709
Edwin Chen 79.1 710
Edwin Chen 75.1 711 Send a LoRaWAN downlink to ask device send Alarm settings.
Xiaoling 6.2 712
Xiaoling 98.20 713 * (% style="color:blue" %)**Downlink Payload:  **(%%)0x26 01
Xiaoling 6.2 714
Edwin Chen 76.1 715 Sensor will upload Device Status via FPORT=5. See payload section for detail.
Xiaoling 6.2 716
717
Edwin Chen 79.1 718 === 3.3.3 Set Alarm Thredhold ===
Xiaoling 37.5 719
Xiaoling 84.2 720
Xiaoling 98.20 721 (% style="color:blue" %)**1.  Set for All Probes:**
Xiaoling 6.2 722
Edwin Chen 75.1 723 (% style="color:#037691" %)**AT+18ALARM=min,max**
Edwin Chen 57.1 724
Edwin Chen 75.1 725 * When min=0, and max≠0, Alarm trigger when higher than max
726 * When min≠0, and max=0, Alarm trigger when lower than min
727 * When min≠0 and max≠0, Alarm trigger when higher than max or lower than min
Edwin Chen 57.1 728
Edwin Chen 75.1 729 **Example:**
Edwin Chen 57.1 730
Edwin Chen 75.1 731 AT+18ALARM=-10,30  ~/~/ Alarm when < -10 or higher than 30.
Edwin Chen 57.1 732
Xiaoling 6.2 733
Xiaoling 98.20 734 * (% style="color:blue" %)**Downlink Payload:**
Xiaoling 6.2 735
Edwin Chen 75.1 736 0x(0B F6 1E)   ~/~/ Same as AT+18ALARM=-10,30
Xiaoling 6.2 737
Edwin Chen 75.1 738 (note: 0x1E= 30, 0xF6 means: 0xF6-0x100 = -10)
Xiaoling 6.2 739
740
Xiaoling 98.20 741 (% style="color:blue" %)**2.  Set for Separate Probe:**
Xiaoling 6.2 742
Edwin Chen 75.1 743 (% style="color:#037691" %)**AT+18ALARM=min,max,index**
Xiaoling 6.2 744
Edwin Chen 75.1 745 Index:
Xiaoling 6.2 746
Edwin Chen 75.1 747 * 1: Temperature_Red
748 * 2: Temperature_White
749 * 3: Temperature_Black
Xiaoling 6.2 750
Edwin Chen 75.1 751 **Example:**
Xiaoling 6.2 752
Edwin Chen 75.1 753 AT+18ALARM=-10,30,1   ~/~/ Alarm when temperature_red < -10 or higher than 30.
Xiaoling 37.5 754
755
Xiaoling 98.20 756 * (% style="color:blue" %)**Downlink Payload:**
Xiaoling 6.2 757
Edwin Chen 75.1 758 0x(0B F6 1E 01)   ~/~/ Same as AT+18ALARM=-10,30,1
Bei Jinggeng 47.1 759
Edwin Chen 75.1 760 (note: 0x1E= 30, 0xF6 means: 0xF6-0x100 = -10)
Bei Jinggeng 47.1 761
762
Edwin Chen 79.1 763 === 3.3.4 Set Alarm Interval ===
Bei Jinggeng 47.1 764
765
Edwin Chen 75.1 766 The shortest time of two Alarm packet. (unit: min)
Xiaoling 6.2 767
Xiaoling 98.20 768 * (% style="color:blue" %)**AT Command:**
Xiaoling 6.2 769
Edwin Chen 75.1 770 AT+ATDC=30  ~/~/ The shortest interval of two Alarm packets is 30 minutes, Means is there is an alarm packet uplink, there won't be another one in the next 30 minutes.
Bei Jinggeng 47.1 771
Xiaoling 6.2 772
Xiaoling 98.20 773 * (% style="color:blue" %)**Downlink Payload:**
Xiaoling 6.2 774
Edwin Chen 75.1 775 0x(0D 00 1E)     **~-~-->** Set AT+ATDC=0x 00 1E = 30 minutes
Xiaoling 43.3 776
Xiaoling 45.2 777
Xiaoling 100.2 778 === 3.3.5 Get Alarm settings ===
Bei Jinggeng 45.1 779
780
Edwin Chen 75.1 781 Send a LoRaWAN downlink to ask device send Alarm settings.
Bei Jinggeng 47.1 782
Edwin Chen 75.1 783 * (% style="color:#037691" %)**Downlink Payload:  **(%%)0x0E 01
Bei Jinggeng 47.1 784
Edwin Chen 75.1 785 **Example:**
Bei Jinggeng 47.1 786
Edwin Chen 75.1 787 [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LSN50v2-D20-D22-D23%20LoRaWAN%20Temperature%20Sensor%20User%20Manual/WebHome/1655948182791-225.png?rev=1.1||alt="1655948182791-225.png"]]
Bei Jinggeng 47.1 788
789
Edwin Chen 75.1 790 **Explain:**
791
792 * Alarm & MOD bit is 0x7C, 0x7C >> 2 = 0x31: Means this message is the Alarm settings message.
793
Edwin Chen 79.1 794 === 3.3.6 Set Interrupt Mode ===
795
Xiaoling 84.2 796
Saxer Lin 124.2 797 Feature, Set Interrupt mode for PA8 of pin.
Edwin Chen 75.1 798
Saxer Lin 124.2 799 When AT+INTMOD=0 is set, PA8 is used as a digital input port.
800
Edwin Chen 75.1 801 (% style="color:blue" %)**AT Command: AT+INTMOD**
802
Xiaoling 98.21 803 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
Xiaoling 140.11 804 |=(% style="width: 154px;background-color:#D9E2F3" %)**Command Example**|=(% style="width: 196px;background-color:#D9E2F3" %)**Function**|=(% style="width: 160px;background-color:#D9E2F3" %)**Response**
Edwin Chen 75.1 805 |(% style="width:154px" %)AT+INTMOD=?|(% style="width:196px" %)Show current interrupt mode|(% style="width:157px" %)(((
806 0
Bei Jinggeng 45.1 807 OK
Edwin Chen 75.1 808 the mode is 0 =Disable Interrupt
Bei Jinggeng 45.1 809 )))
Edwin Chen 75.1 810 |(% style="width:154px" %)AT+INTMOD=2|(% style="width:196px" %)(((
811 Set Transmit Interval
812 0. (Disable Interrupt),
813 ~1. (Trigger by rising and falling edge)
814 2. (Trigger by falling edge)
815 3. (Trigger by rising edge)
816 )))|(% style="width:157px" %)OK
Bei Jinggeng 45.1 817
Edwin Chen 75.1 818 (% style="color:blue" %)**Downlink Command: 0x06**
Bei Jinggeng 45.1 819
Edwin Chen 75.1 820 Format: Command Code (0x06) followed by 3 bytes.
Bei Jinggeng 45.1 821
Edwin Chen 75.1 822 This means that the interrupt mode of the end node is set to 0x000003=3 (rising edge trigger), and the type code is 06.
Bei Jinggeng 45.1 823
Edwin Chen 75.1 824 * Example 1: Downlink Payload: 06000000  ~/~/  Turn off interrupt mode
825 * Example 2: Downlink Payload: 06000003  ~/~/  Set the interrupt mode to rising edge trigger
826
Saxer Lin 130.1 827 === 3.3.7 Set Power Output Duration ===
Saxer Lin 124.2 828
Xiaoling 140.13 829
Saxer Lin 124.2 830 Control the output duration 5V . Before each sampling, device will
831
832 ~1. first enable the power output to external sensor,
833
834 2. keep it on as per duration, read sensor value and construct uplink payload
835
836 3. final, close the power output.
837
838 (% style="color:blue" %)**AT Command: AT+5VT**
839
840 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
Xiaoling 140.12 841 |=(% style="width: 154px;background-color:#D9E2F3" %)**Command Example**|=(% style="width: 196px;background-color:#D9E2F3" %)**Function**|=(% style="width: 160px;background-color:#D9E2F3" %)**Response**
Saxer Lin 124.2 842 |(% style="width:154px" %)AT+5VT=?|(% style="width:196px" %)Show 5V open time.|(% style="width:157px" %)0 (default)
843 OK
Saxer Lin 144.1 844 |(% style="width:154px" %)AT+5VT=1000|(% style="width:196px" %)Close after a delay of 1000 milliseconds.|(% style="width:157px" %)OK
Saxer Lin 124.2 845
846 (% style="color:blue" %)**Downlink Command: 0x07**
847
848
849 Format: Command Code (0x07) followed by 2 bytes.
850
851 The first and second bytes are the time to turn on.
852
853 * Example 1: Downlink Payload: 070000  **~-~-->**  AT+5VT=0
854 * Example 2: Downlink Payload: 0701F4  **~-~-->**  AT+5VT=500
855
Mengting Qiu 145.1 856 === 3.3.8 Multiple VDC collections in one uplink(Since firmware version 1.3.2) ===
Xiaoling 144.2 857
Mengting Qiu 144.3 858
859 Added AT+STDC command to collect the voltage of **VDC_INPUT** multiple times and upload it at one time.
860
861 (% style="color:blue" %)**AT Command: AT** **+STDC**
862
863 AT+STDC=aa,bb,bb
864
865 (% style="color:#037691" %)**aa:**(%%)
866 **0:** means disable this function and use TDC to send packets.
867 **1:** means enable this function, use the method of multiple acquisitions to send packets.
868 (% style="color:#037691" %)**bb:**(%%) Each collection interval (s), the value is 1~~65535
869 (% style="color:#037691" %)**cc:**(%%)** **the number of collection times, the value is 1~~120
870
871 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
Xiaoling 145.3 872 |(% style="background-color:#d9e2f3; width:160px" %)**Command Example**|(% style="background-color:#d9e2f3; width:215px" %)**Function**|(% style="background-color:#d9e2f3" %)**Response**
Mengting Qiu 144.3 873 |(% style="background-color:#f2f2f2; width:160px" %)AT+STDC=?|(% style="background-color:#f2f2f2; width:215px" %)Get the mode of multiple acquisitions and one uplink.|(% style="background-color:#f2f2f2" %)1,10,18
874 OK
875 |(% style="background-color:#f2f2f2; width:160px" %)AT+STDC=1,10,18|(% style="background-color:#f2f2f2; width:215px" %)Set the mode of multiple acquisitions and one uplink, collect once every 10 seconds, and report after 18 times.|(% style="background-color:#f2f2f2" %)(((
876 Attention:Take effect after ATZ
877
878 OK
879 )))
880 |(% style="background-color:#f2f2f2; width:160px" %)AT+STDC=0, 0,0|(% style="background-color:#f2f2f2; width:215px" %)(((
881 Use the TDC interval to send packets.(default)
882
883
884 )))|(% style="background-color:#f2f2f2" %)(((
885 Attention:Take effect after ATZ
886
887 OK
888 )))
889
890 (% style="color:blue" %)**Downlink Command: 0xAE**
891
892 Format: Command Code (0x08) followed by 5 bytes.
893
894 * Example 1: Downlink Payload: AE 01 02 58 12** ~-~-->**  AT+STDC=1,600,18
895
Edwin Chen 76.1 896 = 4. Battery & Power Consumption =
Xiaoling 6.2 897
Xiaoling 84.2 898
Edwin Chen 76.1 899 D2x-LB use ER26500 + SPC1520 battery pack. See below link for detail information about the battery info and how to replace.
Xiaoling 37.6 900
Xiaoling 84.2 901 [[**Battery Info & Power Consumption Analyze**>>http://wiki.dragino.com/xwiki/bin/view/Main/How%20to%20calculate%20the%20battery%20life%20of%20Dragino%20sensors%3F/]] .
Xiaoling 37.6 902
Xiaoling 6.2 903
Edwin Chen 77.1 904 = 5. OTA firmware update =
Xiaoling 6.2 905
906
kai 99.1 907 User can change firmware D2x-LB to:
Xiaoling 6.2 908
Edwin Chen 98.1 909 * Change Frequency band/ region.
910 * Update with new features.
911 * Fix bugs.
Xiaoling 6.2 912
Xiaoling 143.2 913 Firmware and changelog can be downloaded from : **[[Firmware download link>>https://www.dropbox.com/sh/tcpq06yl7rxrgcz/AACpAC7cy-tnGPqn6T6SUDEaa?dl=0]]**
Xiaoling 6.2 914
Edwin Chen 98.1 915 Methods to Update Firmware:
Xiaoling 6.2 916
Xiaoling 144.2 917 * (Recommanded way) OTA firmware update via wireless : **[[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/Firmware%20OTA%20Update%20for%20Sensors/>>url:http://wiki.dragino.com/xwiki/bin/view/Main/Firmware%20OTA%20Update%20for%20Sensors/]]**
918 * Update through UART TTL interface : **[[Instruction>>url:http://wiki.dragino.com/xwiki/bin/view/Main/UART%20Access%20for%20LoRa%20ST%20v4%20base%20model/#H1.LoRaSTv4baseHardware]]**.
Xiaoling 6.2 919
Edwin Chen 98.1 920 = 6. FAQ =
Xiaoling 6.2 921
922
923
Edwin Chen 77.1 924 = 7. Order Info =
Xiaoling 6.2 925
926
Xiaoling 145.4 927 Part Number: (% style="color:blue" %)**D20-LB-XX  / D20S-LB-xx(**(%%)** designed for used in Soil or Road(% style="color:blue" %))/D22-LB-XX / D23-LB-XX(%%)**
Xiaoling 6.2 928
Xiaoling 53.4 929 (% style="color:red" %)**XX**(%%): The default frequency band
Xiaoling 6.2 930
Xiaoling 53.4 931 * (% style="color:red" %)**AS923**(%%): LoRaWAN AS923 band
932
933 * (% style="color:red" %)**AU915**(%%): LoRaWAN AU915 band
934
935 * (% style="color:red" %)**EU433**(%%): LoRaWAN EU433 band
936
937 * (% style="color:red" %)**EU868**(%%): LoRaWAN EU868 band
938
939 * (% style="color:red" %)**KR920**(%%): LoRaWAN KR920 band
940
941 * (% style="color:red" %)**US915**(%%): LoRaWAN US915 band
942
943 * (% style="color:red" %)**IN865**(%%): LoRaWAN IN865 band
944
945 * (% style="color:red" %)**CN470**(%%): LoRaWAN CN470 band
946
Edwin Chen 77.1 947 = 8. ​Packing Info =
Xiaoling 53.4 948
949
Xiaoling 42.21 950 (% style="color:#037691" %)**Package Includes**:
Xiaoling 6.2 951
Xiaoling 61.5 952 * D2x-LB LoRaWAN Temperature Sensor
Xiaoling 6.2 953
Xiaoling 42.21 954 (% style="color:#037691" %)**Dimension and weight**:
Xiaoling 6.2 955
956 * Device Size: cm
Xiaoling 53.4 957
Xiaoling 6.2 958 * Device Weight: g
Xiaoling 53.4 959
Xiaoling 6.2 960 * Package Size / pcs : cm
Xiaoling 53.4 961
Xiaoling 6.2 962 * Weight / pcs : g
963
Edwin Chen 77.1 964 = 9. Support =
Xiaoling 6.2 965
Xiaoling 42.2 966
Xiaoling 6.2 967 * Support is provided Monday to Friday, from 09:00 to 18:00 GMT+8. Due to different timezones we cannot offer live support. However, your questions will be answered as soon as possible in the before-mentioned schedule.
Xiaoling 42.20 968
Xiaoling 121.3 969 * 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.cc>>mailto:Support@dragino.cc]].
Copyright ©2010-2022 Dragino Technology Co., LTD. All rights reserved
Dragino Wiki v2.0