Show last authors
1 (% style="text-align:center" %)
2 [[image:D2x.jpg]]
3
4
5
6
7 **Table of Contents:**
8
9 {{toc/}}
10
11
12
13
14
15
16 = 1. Introduction =
17
18 == 1.1 What is D2x-LB LoRaWAN Temperature Sensor ==
19
20
21 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.
22
23 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.
24
25 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)**(%%).
26
27 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.
28
29 D2x-LB has max 3 probes which measure maximum 3 temperature points.
30
31 D2x-LB (% style="color:blue" %)**supports BLE configure**(%%) and (% style="color:blue" %)**wireless OTA update**(%%) which make user easy to use.
32
33 D2x-LB is powered by (% style="color:blue" %)**8500mAh Li-SOCI2 battery**(%%), it is designed for long term use up to 5 years.
34
35 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.
36
37
38 == 1.2 ​Features ==
39
40
41 * LoRaWAN 1.0.3 Class A
42 * Ultra-low power consumption
43 * 1 ~~ 3 External Temperature Probes
44 * Measure range -55°C ~~ 125°C
45 * Temperature alarm
46 * Bands: CN470/EU433/KR920/US915/EU868/AS923/AU915/IN865
47 * Support Bluetooth v5.1 and LoRaWAN remote configure
48 * Support wireless OTA update firmware
49 * Uplink on periodically
50 * Downlink to change configure
51 * 8500mAh Battery for long term use
52
53 == 1.3 Specification ==
54
55
56 (% style="color:#037691" %)**Common DC Characteristics:**
57
58 * Supply Voltage: built in 8500mAh Li-SOCI2 battery , 2.5v ~~ 3.6v
59 * Operating Temperature: -40 ~~ 85°C
60
61 (% style="color:#037691" %)**Temperature Sensor:**
62
63 * Dallas DS18B20
64 * Range: -55 to + 125°C
65 * Accuracy ±0.5°C (max ±2.0 °C).
66
67 (% style="color:#037691" %)**LoRa Spec:**
68
69 * Frequency Range,  Band 1 (HF): 862 ~~ 1020 Mhz
70 * Max +22 dBm constant RF output vs.
71 * RX sensitivity: down to -139 dBm.
72 * Excellent blocking immunity
73
74 (% style="color:#037691" %)**Battery:**
75
76 * Li/SOCI2 un-chargeable battery
77 * Capacity: 8500mAh
78 * Self-Discharge: <1% / Year @ 25°C
79 * Max continuously current: 130mA
80 * Max boost current: 2A, 1 second
81
82 (% style="color:#037691" %)**Power Consumption**
83
84 * Sleep Mode: 5uA @ 3.3v
85 * LoRa Transmit Mode: 125mA @ 20dBm, 82mA @ 14dBm
86
87 == 1.4 Sleep mode and working mode ==
88
89
90 (% 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.
91
92 (% 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.
93
94
95 == 1.5 Button & LEDs ==
96
97
98 [[image:1675071855856-879.png]]
99
100
101 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
102 |=(% 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**
103 |(% style="width:167px" %)Pressing ACT between 1s < time < 3s|(% style="width:117px" %)Send an uplink|(% style="width:225px" %)(((
104 If sensor is already Joined to LoRaWAN network, sensor will send an uplink packet, (% style="color:blue" %)**blue led** (%%)will blink once.
105 Meanwhile, BLE module will be active and user can connect via BLE to configure device.
106 )))
107 |(% style="width:167px" %)Pressing ACT for more than 3s|(% style="width:117px" %)Active Device|(% style="width:225px" %)(((
108 (% 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.
109 (% style="color:green" %)**Green led**(%%) will solidly turn on for 5 seconds after joined in network.
110 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.
111 )))
112 |(% 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.
113
114 == 1.6 BLE connection ==
115
116
117 D2x-LB support BLE remote configure.
118
119
120 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:
121
122 * Press button to send an uplink
123 * Press button to active device.
124 * Device Power on or reset.
125
126 If there is no activity connection on BLE in 60 seconds, sensor will shut down BLE module to enter low power mode.
127
128
129 == 1.7 Pin Definitions ==
130
131 [[image:image-20230524141809-1.png]]
132
133
134 == 1.8 Hardware Variant ==
135
136
137 (% border="1" cellspacing="5" style="background-color:#f2f2f2; width:510px" %)
138 |=(% 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
139 |(% style="width:102px" %)D20-LB|(% style="width:190px" %)[[image:D20.jpg]]|(% style="width:297px" %)(((
140 1 x DS28B20 Probe
141
142 Cable Length : 2 meters
143
144
145 )))
146 |(% style="width:102px" %)D20S-LB|(% style="width:190px" %)[[image:data:image/jpeg;base64,/9j/4AAQSkZJRgABAAEBLAEsAAD//gAfTEVBRCBUZWNobm9sb2dpZXMgSW5jLiBWMS4wMQD/2wCEAAUFBQgFCAwHBwwMCQkJDA0MDAwMDQ0NDQ0NDQ0NDQ0NDQ0NDQ0NDQ0NDQ0NDQ0NDQ0NDQ0NDQ0NDQ0NDQ0NDQ0BBQgICgcKDAcHDA0MCgwNDQ0NDQ0NDQ0NDQ0NDQ0NDQ0NDQ0NDQ0NDQ0NDQ0NDQ0NDQ0NDQ0NDQ0NDQ0NDQ0NDf/EAaIAAAEFAQEBAQEBAAAAAAAAAAABAgMEBQYHCAkKCwEAAwEBAQEBAQEBAQAAAAAAAAECAwQFBgcICQoLEAACAQMDAgQDBQUEBAAAAX0BAgMABBEFEiExQQYTUWEHInEUMoGRoQgjQrHBFVLR8CQzYnKCCQoWFxgZGiUmJygpKjQ1Njc4OTpDREVGR0hJSlNUVVZXWFlaY2RlZmdoaWpzdHV2d3h5eoOEhYaHiImKkpOUlZaXmJmaoqOkpaanqKmqsrO0tba3uLm6wsPExcbHyMnK0tPU1dbX2Nna4eLj5OXm5+jp6vHy8/T19vf4+foRAAIBAgQEAwQHBQQEAAECdwABAgMRBAUhMQYSQVEHYXETIjKBCBRCkaGxwQkjM1LwFWJy0QoWJDThJfEXGBkaJicoKSo1Njc4OTpDREVGR0hJSlNUVVZXWFlaY2RlZmdoaWpzdHV2d3h5eoKDhIWGh4iJipKTlJWWl5iZmqKjpKWmp6ipqrKztLW2t7i5usLDxMXGx8jJytLT1NXW19jZ2uLj5OXm5+jp6vLz9PX29/j5+v/AABEIAlgCWAMBEQACEQEDEQH/2gAMAwEAAhEDEQA/APsugAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAwdR8UaXpD+Vd3McUn93JLDPqFBI/HFK47GjY6lbaknm2kqTJ6owOPY45B9jigLWLtMQUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFAHMeMtXk0PSLi8h4lRMIfRnIUH6jOR7ijyDY+N7YNqTPcXLsWYkkk5PPOc1rZLQzuafg7xNc+HtVjkhYmIuFdM8OhOCpHTp09DgjpSaKTPtwHNZlBQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAeefFM7fD8/u0f/AKEKa3Ez5S0s7YmFamZn2PN6n++P50DPv9Puj6CsTQWgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoA88+KUTyeH59gztKM3QYG7GefcimtxM+SrGQpGRt/HitSBujwvc38UUQLO8iqFHUktgAfU0DPvkcAViWLQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAec/FXyx4fn8wsPmj27e7buh9sZP1AprcR8mWSM8ZKkgfh/VTWpA7QhGdRhEzMieagZ15ZRuGWAG3kdQKT2Gfe4rIsKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgDzH4uHGgSf9dY/wD2amtxM+WdOGID+NakFTSjm+j/AOui/wA6Q0ff4rIsKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgDzD4vf8gB/+usf8mprcTPlvT/8AUH8f5VqQUtJ/4/4h/wBNF/nSY0foBWRYUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFAHlnxh40Bv8ArtH/ACemtxM+XtO4gP4/yrUgqaMP+JjF/wBdF/8AQhSew0ff9ZFhQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAeWfGH/kAN/12j/9BemtxM+XNP4gNakFfR/+QhEOn71f/QhSZWx9/VkUFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQB5Z8Yf+QC3/AF2j/k9NAfLtjxCf89q0IK2jf8hCI/8ATRf/AEIUhn39WZQUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFAHlvxg/5ADf8AXaP+T01uI+W7IfuT+Nak7FbRR/p8Wf8Anov/AKEKkZ9/1mUFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQB5b8Yf8AkAN/12j/AJPTW4j5aseITWpJX0U4v4v+ui/+hCpKPv8ArMYUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFAHl3xf/5AD/8AXaP+T00I+WbL/VGtSSto4xfxenmL/wChCpY0foAKzKCgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoA8v8Ai9/yAH/66x/yamtxM+V7P/VGtCStpXF7GfSQfzFJjR+gI6VmUFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQB5j8XB/wASCT/rrH/7NTQj5Vs/9Uf89q1JK2nfLdof9sfzpDP0AXoKyKFoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKAPM/i2P8Ain5faSP+ZpoD5Ss+Ij2rUgrWB/0pPZx/OpKP0AT7o+grMY6gAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoA81+LQ/4p+X/rpH/M00B8oWI/dnH+eK0IKdlxdL/vj+dIo/QKLlF+g/lWYx9ABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQB5l8XG2eH5B6yRj+Z/pTQHyxpvEZ/z2rQgzIG23Sn0b+tA9j7+sn8y3jf+9Gh/NQayKLNABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQB5T8Y226CR6zxj/x2Q00I+YNOz5R/wA9q0EY6HbcD/epDPvjQZPN061f+9bwn841rMZq0AFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFAHkHxpfboiL63C/oklNAfM+m8xGtCDFPyz/8CoGfd3g+TzdGs2/6d4x/3yNv9KyKOjoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKAPFvje+3SYV9ZifyQ/401uI+cNL4iNaCMSQ4mP+9QB9w/D2XzdAsz6Iw/75kcf0rMo7KkAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAFABQAUAeG/HJsafbL6ySH8lX/GmtxHz1po/dH2qxGFOMSnHr/WmGx9p/C6XzPD9uP7pkH/j5P9azZR6DSAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKAPBfjq2LW0X/AGpj+kdUhHgWnEeWasnYw7gfvTj1pDPsD4Py79CA/uTuP/HUP9ahlHqdIAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoA+fvjv8A6mzH/Xb/ANp1SEeC6e2xCOtWIzJ8s5JoA+rfgu+dJlX+7Nn80X/Cs2Uew0gCgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgDwD47LmGz+s3/tKqQjwCy4T0qxGfMMMaAPqX4Jt/xLZx6Sr+q//WrNlHtNIAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoA8E+Oq/6NZn/AGpv/aVUhHz5a8Jj2qxMoSD5iKAPp/4IH/iX3I9JE/8AQWrNjPbqQwoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoA8P+OMUbadbuz7JVkcIm0neCF3ncCAu3C9eu7jpTQj5ptncLxtH1XP8A7PWgipMX3HofoMf+zUDPqX4ILEumzlXLSGRN6bSoQYbaQ2SG3c5xjGPes2M9spAFABQAUAFABQAUAFABQAUAFABQAUAFABQA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sk8q1ijt4/7saKi/koApWtsBOtkO9MC3HAsfQU7ATdKYgoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKAEIBGD0oA5y/wDB+i6kSbqytpGPVvKQN/32oDfrSsh3OXuPhB4YuORamI+sc0w/Quw/Si1tm/69QuZb/BDw63T7Sn0lH/s0Zo17v8P8g+Q1Pgd4fT+K7P1lT+kQo17v8P8AIPl+Zci+DHhuPrFM/wDvTN/7Lto17v8AAPka1v8ACzwzbcrYoxH9+SZ/0aQj9KLev3hc6Sz8MaTp+DbWdtER3WGMH/vrbn9aLILs2wAowOBTEL0oAKADGKQBTAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgD//2Q==]]|(% style="width:297px" %)(((
147 1 x DS28B20 Probe (Suitable for bury in soil)
148
149 Material: TPE, Cable Length: 2meters
150 )))
151 |(% style="width:102px" %)D22-LB|(% style="width:190px" %)[[image:D22.jpg]]|(% style="width:297px" %)(((
152 2 x DS28B20 Probes
153
154 Cable lengths total 1.5meters per probe
155
156 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]]
157 )))
158 |(% style="width:102px" %)(((
159 (((
160 D23-LB
161 )))
162
163 (((
164
165 )))
166 )))|(% style="width:190px" %)[[image:D23.jpg]]|(% style="width:297px" %)(((
167 3 x DS28B20 Probes
168
169 Cable lengths total 1.5meters per probe
170
171 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]]
172 )))
173
174 (% style="display:none" %)
175
176
177
178 == 1.9 Mechanical ==
179
180
181 [[image:1675143884058-338.png]]
182
183
184 [[image:1675143899218-599.png]]
185
186
187 [[image:1675143909447-639.png]]
188
189
190 = 2. Configure D2x-LB to connect to LoRaWAN network =
191
192 == 2.1 How it works ==
193
194
195 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.
196
197
198 == 2.2 ​Quick guide to connect to LoRaWAN server (OTAA) ==
199
200
201 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.
202
203 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.
204
205
206 (% style="color:blue" %)**Step 1:**(%%) Create a device in TTN with the OTAA keys from D2x-LB.
207
208 Each D2x-LB is shipped with a sticker with the default device EUI as below:
209
210 [[image:image-20230426084024-1.png||alt="图片-20230426084024-1.png" height="236" width="508"]]
211
212
213 You can enter this key in the LoRaWAN Server portal. Below is TTN screen shot:
214
215
216 (% style="color:blue" %)**Register the device**
217
218 [[image:1675144099263-405.png]]
219
220
221 (% style="color:blue" %)**Add APP EUI and DEV EUI**
222
223 [[image:1675144117571-832.png]]
224
225
226 (% style="color:blue" %)**Add APP EUI in the application**
227
228
229 [[image:1675144143021-195.png]]
230
231
232 (% style="color:blue" %)**Add APP KEY**
233
234 [[image:1675144157838-392.png]]
235
236 (% style="color:blue" %)**Step 2:**(%%) Activate on D2x-LB
237
238
239 Press the button for 5 seconds to activate the D2x-LB.
240
241 (% 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.
242
243 After join success, it will start to upload messages to TTN and you can see the messages in the panel.
244
245
246 == 2.3 ​Uplink Payload ==
247
248 === 2.3.1 Device Status, FPORT~=5 ===
249
250
251 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.
252
253 The Payload format is as below.
254
255
256 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
257 |(% colspan="6" style="background-color:#d9e2f3; color:#0070c0" %)**Device Status (FPORT=5)**
258 |(% style="width:103px" %)**Size (bytes)**|(% style="width:72px" %)**1**|**2**|(% style="width:91px" %)**1**|(% style="width:86px" %)**1**|(% style="width:44px" %)**2**
259 |(% 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
260
261 Example parse in TTNv3
262
263 [[image:image-20230415153147-2.png||alt="图片-20230415153147-2.png" height="220" width="1120"]]
264
265
266 (% style="color:#037691" %)**Sensor Model**(%%): For D2x-LB, this value is 0x19
267
268 (% style="color:#037691" %)**Firmware Version**(%%): 0x0100, Means: v1.0.0 version
269
270 (% style="color:#037691" %)**Frequency Band**:
271
272 *0x01: EU868
273
274 *0x02: US915
275
276 *0x03: IN865
277
278 *0x04: AU915
279
280 *0x05: KZ865
281
282 *0x06: RU864
283
284 *0x07: AS923
285
286 *0x08: AS923-1
287
288 *0x09: AS923-2
289
290 *0x0a: AS923-3
291
292 *0x0b: CN470
293
294 *0x0c: EU433
295
296 *0x0d: KR920
297
298 *0x0e: MA869
299
300
301 (% style="color:#037691" %)**Sub-Band**:
302
303 AU915 and US915:value 0x00 ~~ 0x08
304
305 CN470: value 0x0B ~~ 0x0C
306
307 Other Bands: Always 0x00
308
309
310 (% style="color:#037691" %)**Battery Info**:
311
312 Check the battery voltage.
313
314 Ex1: 0x0B45 = 2885mV
315
316 Ex2: 0x0B49 = 2889mV
317
318
319 === 2.3.2  Sensor Data. FPORT~=2 ===
320
321
322 D2x-LB will uplink below payload via FPORT=2 after Joined LoRaWAN Network.
323
324 (% border="1" cellspacing="5" style="background-color:#f2f2f2; width:668px" %)
325 |=(% style="width: 62.5px;background-color:#D9E2F3" %)(((
326 **Size(bytes)**
327 )))|=(% style="width: 69px; background-color: rgb(217, 226, 243);" %)2|=(% style="width: 116px; background-color: rgb(217, 226, 243);" %)2|=(% style="width: 69px; background-color: rgb(217, 226, 243);" %)2|=(% style="width: 89px; background-color: rgb(217, 226, 243);" %)1|=(% style="width: 113px; background-color: rgb(217, 226, 243);" %)**2**|=(% style="width: 116px; background-color: rgb(217, 226, 243);" %)2
328 |(% style="width:65px" %)**Value**|(% style="width:69px" %)(((
329 Battery
330 )))|(% style="width:116px" %)(((
331 Temp_ Red or Temp _White
332 )))|(% style="width:69px" %)(((
333 ignore
334 )))|(% style="width:89px" %)(((
335 Alarm Flag
336 )))|(% style="width:113px" %)(((
337 Temp_White
338 )))|(% style="width:116px" %)(((
339 Temp_Black
340
341
342 )))
343
344 **Payload per each model.**
345
346 [[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"]]
347
348
349 [[image:image-20230415154139-3.png||alt="图片-20230415154139-3.png" height="215" width="1179"]]
350
351
352 ==== (% style="color:#4472c4" %)**Decode corresponding probe color:**(%%) ====
353
354 **D20:**
355
356 Red <~-~-> C1
357
358
359 **D22:**
360
361 White <~-~-> C1 Red <~-~-> C2
362
363
364 **D23:**
365
366 White <~-~->C1 Red <~-~-> C2 Black <~-~-> C3
367
368
369
370 ==== (% style="color:#4472c4" %)**Battery:**(%%) ====
371
372 Sensor Battery Level.
373
374 Ex1: 0x0B45 = 2885mV
375
376 Ex2: 0x0B49 = 2889mV
377
378
379
380 ==== (% style="color:#4472c4" %)**Temperature RED or Temperature White :**(%%) ====
381
382
383 **This point to the Red probe in D20-LB or the probe of D22-LB/D23-LB White**
384
385 **Example**:
386
387 If payload is: 0105H:  (0105 & 8000 == 0), temp = 0105H /10 = 26.1 degree
388
389 If payload is: FF3FH :  (FF3F & 8000 == 1) , temp = (FF3FH - 65536)/10 = -19.3 degrees.
390
391 (FF3F & 8000:Judge whether the highest bit is 1, when the highest bit is 1, it is negative)
392
393
394
395 ==== (% style="color:#4472c4" %)**Temperature White:**(%%) ====
396
397
398 **This point to the Red probe in D22-LB/D23-LB**
399
400
401 **Example**:
402
403 If payload is: 0105H:  (0105 & 8000 == 0), temp = 0105H /10 = 26.1 degree
404
405 If payload is: FF3FH :  (FF3F & 8000 == 1) , temp = (FF3FH - 65536)/10 = -19.3 degrees.
406
407 (FF3F & 8000:Judge whether the highest bit is 1, when the highest bit is 1, it is negative)
408
409
410
411 ==== (% style="color:#4472c4" %)**Temperature Black:**(%%) ====
412
413
414 **This point to the BLACK probe in D23-LB**
415
416
417 **Example**:
418
419 If payload is: 0105H:  (0105 & 8000 == 0), temp = 0105H /10 = 26.1 degree
420
421 If payload is: FF3FH :  (FF3F & 8000 == 1) , temp = (FF3FH - 65536)/10 = -19.3 degrees.
422
423 (FF3F & 8000:Judge whether the highest bit is 1, when the highest bit is 1, it is negative)
424
425
426
427 ==== (% style="color:#4472c4" %)**Alarm Flag& MOD:**(%%) ====
428
429
430 **Example:**
431
432 If payload & 0x01 = 0x01  **~-~->** This is an Alarm Message
433
434 If payload & 0x01 = 0x00  **~-~->** This is a normal uplink message, no alarm
435
436
437 == 2.4 Payload Decoder file ==
438
439
440 (((
441 In TTN, use can add a custom payload so it shows friendly. 
442 )))
443
444 (((
445 In the page **Applications ~-~-> Payload Formats ~-~-> Custom ~-~-> decoder** to add the decoder from: 
446
447 [[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]]
448
449
450 )))
451
452 == 2.5 Datalog Feature ==
453
454
455 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.
456
457
458 === 2.5.1 Ways to get datalog via LoRaWAN ===
459
460
461 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.
462
463 * a) D2x-LB will do an ACK check for data records sending to make sure every data arrive server.
464 * 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.
465
466 Below is the typical case for the auto-update datalog feature (Set PNACKMD=1)
467
468 [[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"]]
469
470
471 === 2.5.2 Unix TimeStamp ===
472
473
474 D2x-LB uses Unix TimeStamp format based on
475
476 [[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"]]
477
478 User can get this time from link:  [[https:~~/~~/www.epochconverter.com/>>url:https://www.epochconverter.com/]] :
479
480 Below is the converter example
481
482 [[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"]]
483
484 So, we can use AT+TIMESTAMP=1611889405 or downlink 3060137afd00 to set the current time 2021 – Jan ~-~- 29 Friday 03:03:25
485
486
487 === 2.5.3 Set Device Time ===
488
489
490 User need to set (% style="color:blue" %)**SYNCMOD=1**(%%) to enable sync time via MAC command.
491
492 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).
493
494 (% 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.**
495
496
497 === 2.5.4 Datalog Uplink payload  (FPORT~=3) ===
498
499
500 The Datalog poll reply uplink will use below payload format.
501
502 **Retrieval data payload:**
503
504 (% border="1" cellspacing="5" style="background-color:#f2f2f2; width:510px" %)
505 |=(% style="width: 90px;background-color:#D9E2F3" %)(((
506 **Size(bytes)**
507 )))|=(% style="width: 60px; background-color: rgb(217, 226, 243);" %)**2**|=(% style="width: 60px; background-color: rgb(217, 226, 243);" %)**2**|=(% style="width: 115px; background-color: rgb(217, 226, 243);" %)**2**|=(% style="width: 104px; background-color: rgb(217, 226, 243);" %)**1**|=(% style="width: 80px; background-color: rgb(217, 226, 243);" %)**4**
508 |(% style="width:93px" %)**Value**|(% style="width:54px" %)(((
509 [[Temp_Black>>||anchor="HTemperatureBlack:"]]
510 )))|(% style="width:54px" %)[[Temp_White>>||anchor="HTemperatureWhite:"]]|(% style="width:87px" %)[[Temp_ Red or Temp _White>>||anchor="HTemperatureREDorTemperatureWhite:"]]|(% style="width:104px" %)Poll message flag & Ext|(% style="width:55px" %)[[Unix Time Stamp>>||anchor="H2.5.2UnixTimeStamp"]]
511
512 **Poll message flag & Ext:**
513
514 [[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-20221006192726-1.png?width=754&height=112&rev=1.1||alt="图片-20221006192726-1.png" height="112" width="754"]]
515
516 **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)
517
518 **Poll Message Flag**: 1: This message is a poll message reply.
519
520 * Poll Message Flag is set to 1.
521
522 * Each data entry is 11 bytes, to save airtime and battery, devices will send max bytes according to the current DR and Frequency bands.
523
524 For example, in US915 band, the max payload for different DR is:
525
526 **a) DR0:** max is 11 bytes so one entry of data
527
528 **b) DR1:** max is 53 bytes so devices will upload 4 entries of data (total 44 bytes)
529
530 **c) DR2:** total payload includes 11 entries of data
531
532 **d) DR3: **total payload includes 22 entries of data.
533
534 If devise doesn't have any data in the polling time. Device will uplink 11 bytes of 0   
535
536
537 **Example:**
538
539 If D2x-LB has below data inside Flash:
540
541 [[image:1682646331023-772.png]]
542
543
544 If user sends below downlink command: 3160065F9760066DA705
545
546 Where : Start time: 60065F97 = time 21/1/19 04:27:03
547
548 Stop time: 60066DA7= time 21/1/19 05:27:03
549
550
551 **D2x-LB will uplink this payload.**
552
553 [[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-13.png?width=727&height=421&rev=1.1||alt="图片-20220523001219-13.png" height="421" width="727"]]
554
555
556 (((
557 __**7FFF089801464160065F97**__ **__7FFF__ __088E__ __014B__ __41__ __60066009__** 7FFF0885014E41600660667FFF0875015141600662BE7FFF086B015541600665167FFF08660155416006676E7FFF085F015A41600669C67FFF0857015D4160066C1E
558 )))
559
560 (((
561 Where the first 11 bytes is for the first entry:
562 )))
563
564 (((
565 7FFF089801464160065F97
566 )))
567
568 (((
569 **Ext sensor data**=0x7FFF/100=327.67
570 )))
571
572 (((
573 **Temp**=0x088E/100=22.00
574 )))
575
576 (((
577 **Hum**=0x014B/10=32.6
578 )))
579
580 (((
581 **poll message flag & Ext**=0x41,means reply data,Ext=1
582 )))
583
584 (((
585 **Unix time** is 0x60066009=1611030423s=21/1/19 04:27:03
586 )))
587
588
589 (% 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="单击并拖动以调整大小" %)的
590
591 == 2.6 Temperature Alarm Feature ==
592
593
594 D2x-LB work flow with Alarm feature.
595
596
597 [[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"]]
598
599
600 == 2.7 Frequency Plans ==
601
602
603 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.
604
605 [[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20Frequency%20Band/>>http://wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20Frequency%20Band/]]
606
607
608 == 2.8 ​Firmware Change Log ==
609
610
611 **Firmware download link:**
612
613 [[https:~~/~~/www.dropbox.com/sh/tcpq06yl7rxrgcz/AACpAC7cy-tnGPqn6T6SUDEaa?dl=0>>https://www.dropbox.com/sh/tcpq06yl7rxrgcz/AACpAC7cy-tnGPqn6T6SUDEaa?dl=0]]
614
615
616 = 3. Configure D2x-LB =
617
618 == 3.1 Configure Methods: ==
619
620
621 D2x-LB supports below configure method:
622
623 * AT Command via Bluetooth Connection (**Recommended**): [[BLE Configure Instruction>>http://wiki.dragino.com/xwiki/bin/view/Main/BLE%20Bluetooth%20Remote%20Configure/]].
624 * 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]].
625 * LoRaWAN Downlink.  Instruction for different platforms: See [[IoT LoRaWAN Server>>http://wiki.dragino.com/xwiki/bin/view/Main/]] section.
626
627 == 3.2 General Commands ==
628
629
630 These commands are to configure:
631
632 * General system settings like: uplink interval.
633 * LoRaWAN protocol & radio related command.
634
635 They are same for all Dragino Devices which support DLWS-005 LoRaWAN Stack. These commands can be found on the wiki:
636
637 [[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/]]
638
639
640 == 3.3 Commands special design for D2x-LB ==
641
642
643 These commands only valid for D2x-LB, as below:
644
645
646 === 3.3.1 Set Transmit Interval Time ===
647
648
649 Feature: Change LoRaWAN End Node Transmit Interval.
650
651 (% style="color:blue" %)**AT Command: AT+TDC**
652
653 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
654 |=(% style="width: 156px;background-color:#D9E2F3" %)**Command Example**|=(% style="width: 137px;background-color:#D9E2F3" %)**Function**|=(% style="background-color:#D9E2F3" %)**Response**
655 |(% style="width:156px" %)AT+TDC=?|(% style="width:137px" %)Show current transmit Interval|(((
656 30000
657 OK
658 the interval is 30000ms = 30s
659 )))
660 |(% style="width:156px" %)AT+TDC=60000|(% style="width:137px" %)Set Transmit Interval|(((
661 OK
662 Set transmit interval to 60000ms = 60 seconds
663 )))
664
665 (% style="color:blue" %)**Downlink Command: 0x01**
666
667 Format: Command Code (0x01) followed by 3 bytes time value.
668
669 If the downlink payload=0100003C, it means set the END Node's Transmit Interval to 0x00003C=60(S), while type code is 01.
670
671 * Example 1: Downlink Payload: 0100001E  ~/~/  Set Transmit Interval (TDC) = 30 seconds
672 * Example 2: Downlink Payload: 0100003C  ~/~/  Set Transmit Interval (TDC) = 60 seconds
673
674 === 3.3.2 Get Device Status ===
675
676
677 Send a LoRaWAN downlink to ask device send Alarm settings.
678
679 * (% style="color:blue" %)**Downlink Payload:  **(%%)0x26 01
680
681 Sensor will upload Device Status via FPORT=5. See payload section for detail.
682
683
684 === 3.3.3 Set Alarm Thredhold ===
685
686
687 (% style="color:blue" %)**1.  Set for All Probes:**
688
689 (% style="color:#037691" %)**AT+18ALARM=min,max**
690
691 * When min=0, and max≠0, Alarm trigger when higher than max
692 * When min≠0, and max=0, Alarm trigger when lower than min
693 * When min≠0 and max≠0, Alarm trigger when higher than max or lower than min
694
695 **Example:**
696
697 AT+18ALARM=-10,30  ~/~/ Alarm when < -10 or higher than 30.
698
699
700 * (% style="color:blue" %)**Downlink Payload:**
701
702 0x(0B F6 1E)   ~/~/ Same as AT+18ALARM=-10,30
703
704 (note: 0x1E= 30, 0xF6 means: 0xF6-0x100 = -10)
705
706
707 (% style="color:blue" %)**2.  Set for Separate Probe:**
708
709 (% style="color:#037691" %)**AT+18ALARM=min,max,index**
710
711 Index:
712
713 * 1: Temperature_Red
714 * 2: Temperature_White
715 * 3: Temperature_Black
716
717 **Example:**
718
719 AT+18ALARM=-10,30,1   ~/~/ Alarm when temperature_red < -10 or higher than 30.
720
721
722 * (% style="color:blue" %)**Downlink Payload:**
723
724 0x(0B F6 1E 01)   ~/~/ Same as AT+18ALARM=-10,30,1
725
726 (note: 0x1E= 30, 0xF6 means: 0xF6-0x100 = -10)
727
728
729 === 3.3.4 Set Alarm Interval ===
730
731
732 The shortest time of two Alarm packet. (unit: min)
733
734 * (% style="color:blue" %)**AT Command:**
735
736 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.
737
738
739 * (% style="color:blue" %)**Downlink Payload:**
740
741 0x(0D 00 1E)     **~-~-->** Set AT+ATDC=0x 00 1E = 30 minutes
742
743
744 === 3.3.5 Get Alarm settings ===
745
746
747 Send a LoRaWAN downlink to ask device send Alarm settings.
748
749 * (% style="color:#037691" %)**Downlink Payload:  **(%%)0x0E 01
750
751 **Example:**
752
753 [[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"]]
754
755
756 **Explain:**
757
758 * Alarm & MOD bit is 0x7C, 0x7C >> 2 = 0x31: Means this message is the Alarm settings message.
759
760 === 3.3.6 Set Interrupt Mode ===
761
762
763 Feature, Set Interrupt mode for PA8 of pin.
764
765 When AT+INTMOD=0 is set, PA8 is used as a digital input port.
766
767 (% style="color:blue" %)**AT Command: AT+INTMOD**
768
769 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
770 |=(% style="width: 154px;background-color:#D9E2F3" %)**Command Example**|=(% style="width: 196px;background-color:#D9E2F3" %)**Function**|=(% style="width: 157px;background-color:#D9E2F3" %)**Response**
771 |(% style="width:154px" %)AT+INTMOD=?|(% style="width:196px" %)Show current interrupt mode|(% style="width:157px" %)(((
772 0
773 OK
774 the mode is 0 =Disable Interrupt
775 )))
776 |(% style="width:154px" %)AT+INTMOD=2|(% style="width:196px" %)(((
777 Set Transmit Interval
778 0. (Disable Interrupt),
779 ~1. (Trigger by rising and falling edge)
780 2. (Trigger by falling edge)
781 3. (Trigger by rising edge)
782 )))|(% style="width:157px" %)OK
783
784 (% style="color:blue" %)**Downlink Command: 0x06**
785
786 Format: Command Code (0x06) followed by 3 bytes.
787
788 This means that the interrupt mode of the end node is set to 0x000003=3 (rising edge trigger), and the type code is 06.
789
790 * Example 1: Downlink Payload: 06000000  ~/~/  Turn off interrupt mode
791 * Example 2: Downlink Payload: 06000003  ~/~/  Set the interrupt mode to rising edge trigger
792
793 (% class="wikigeneratedid" %)
794 === 3.3.8 Set Power Output Duration ===
795
796 Control the output duration 5V . Before each sampling, device will
797
798 ~1. first enable the power output to external sensor,
799
800 2. keep it on as per duration, read sensor value and construct uplink payload
801
802 3. final, close the power output.
803
804 (% style="color:blue" %)**AT Command: AT+5VT**
805
806 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
807 |=(% style="width: 154px;background-color:#D9E2F3" %)**Command Example**|=(% style="width: 196px;background-color:#D9E2F3" %)**Function**|=(% style="width: 157px;background-color:#D9E2F3" %)**Response**
808 |(% style="width:154px" %)AT+5VT=?|(% style="width:196px" %)Show 5V open time.|(% style="width:157px" %)0 (default)
809 OK
810 |(% style="width:154px" %)AT+5VT=500|(% style="width:196px" %)Close after a delay of 1000 milliseconds.|(% style="width:157px" %)OK
811
812 (% style="color:blue" %)**Downlink Command: 0x07**
813
814
815 Format: Command Code (0x07) followed by 2 bytes.
816
817 The first and second bytes are the time to turn on.
818
819 * Example 1: Downlink Payload: 070000  **~-~-->**  AT+5VT=0
820 * Example 2: Downlink Payload: 0701F4  **~-~-->**  AT+5VT=500
821
822 = 4. Battery & Power Consumption =
823
824
825 D2x-LB use ER26500 + SPC1520 battery pack. See below link for detail information about the battery info and how to replace.
826
827 [[**Battery Info & Power Consumption Analyze**>>http://wiki.dragino.com/xwiki/bin/view/Main/How%20to%20calculate%20the%20battery%20life%20of%20Dragino%20sensors%3F/]] .
828
829
830 = 5. OTA firmware update =
831
832
833 User can change firmware D2x-LB to:
834
835 * Change Frequency band/ region.
836 * Update with new features.
837 * Fix bugs.
838
839 Firmware and changelog can be downloaded from : **[[Firmware download link>>http://wiki.dragino.com/xwiki/bin/view/Main/Firmware%20OTA%20Update%20for%20Sensors/]]**
840
841
842 Methods to Update Firmware:
843
844 * (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/]]
845 * 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]]**.
846
847 = 6. FAQ =
848
849
850
851 = 7. Order Info =
852
853
854 Part Number: (% style="color:blue" %)**D20-LB-XX  / D20S-LB(**(%%)** designed for used in Soil or Road(% style="color:blue" %))/D22-LB-XX / D23-LB-XX(%%)**
855
856 (% style="color:red" %)**XX**(%%): The default frequency band
857
858 * (% style="color:red" %)**AS923**(%%): LoRaWAN AS923 band
859
860 * (% style="color:red" %)**AU915**(%%): LoRaWAN AU915 band
861
862 * (% style="color:red" %)**EU433**(%%): LoRaWAN EU433 band
863
864 * (% style="color:red" %)**EU868**(%%): LoRaWAN EU868 band
865
866 * (% style="color:red" %)**KR920**(%%): LoRaWAN KR920 band
867
868 * (% style="color:red" %)**US915**(%%): LoRaWAN US915 band
869
870 * (% style="color:red" %)**IN865**(%%): LoRaWAN IN865 band
871
872 * (% style="color:red" %)**CN470**(%%): LoRaWAN CN470 band
873
874 = 8. ​Packing Info =
875
876
877 (% style="color:#037691" %)**Package Includes**:
878
879 * D2x-LB LoRaWAN Temperature Sensor
880
881 (% style="color:#037691" %)**Dimension and weight**:
882
883 * Device Size: cm
884
885 * Device Weight: g
886
887 * Package Size / pcs : cm
888
889 * Weight / pcs : g
890
891 = 9. Support =
892
893
894 * 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.
895
896 * 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