Changes for page DS03A-LB/LS -- Outdoor LoRaWAN Door Sensor User Manual
Last modified by Mengting Qiu on 2025/01/10 09:53
Summary
-
Page properties (1 modified, 0 added, 0 removed)
Details
- Page properties
-
- Content
-
... ... @@ -22,41 +22,41 @@ 22 22 23 23 = 1. Introduction = 24 24 25 -== 1.1 What is DS03A-LB LoRaWAN Door Sensor ==25 +== 1.1 What is LoRaWAN Door Sensor == 26 26 27 27 28 28 ((( 29 -The Dragino DS03A-LB is a (% style="color:blue" %)**LoRaWAN Door Sensor**(%%) for Internet of Things solution. It detects door open/close status and uplinks to IoT server via LoRaWAN network. user can see the door status, open duration, open counts in the IoT Server. 29 +The Dragino DS03A-LB/LS is a (% style="color:blue" %)**LoRaWAN Door Sensor**(%%) for Internet of Things solution. It detects door open/close status and uplinks to IoT server via LoRaWAN network. user can see the door status, open duration, open counts in the IoT Server. 30 30 ))) 31 31 32 32 ((( 33 -The LoRa wireless technology used in DS03A-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. 33 +The LoRa wireless technology used in DS03A-LB/LS 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. 34 34 ))) 35 35 36 36 ((( 37 -The DS03A-LB will send periodically data every 2 hours as well as for each door open/close action. It also counts the door open times and calculates the last door open duration. Users can also disable the uplink for each open/close event, instead, DS03A-LB can count each open event and uplink periodically. 37 +The DS03A-LB/LS will send periodically data every 2 hours as well as for each door open/close action. It also counts the door open times and calculates the last door open duration. Users can also disable the uplink for each open/close event, instead, DS03A-LB/LS can count each open event and uplink periodically. 38 38 ))) 39 39 40 40 ((( 41 -DS03A-LB supports (% style="color:blue" %)**Datalog Feature,**(%%) it can save the data when there is no LoRaWAN network and uplink when network recover. 41 +DS03A-LB/LS supports (% style="color:blue" %)**Datalog Feature,**(%%) it can save the data when there is no LoRaWAN network and uplink when network recover. 42 42 ))) 43 43 44 44 ((( 45 -DS03A-LB has the (% style="color:blue" %)**Open Alarm Feature**(%%), user can set this feature so the device will send an alarm if the door has been open for a certain time. 45 +DS03A-LB/LS has the (% style="color:blue" %)**Open Alarm Feature**(%%), user can set this feature so the device will send an alarm if the door has been open for a certain time. 46 46 47 -DS03A-LB is designed for outdoor use. It has a weatherproof enclosure and industrial level battery to work in low to high temperatures 47 +DS03A-LB/LS is designed for outdoor use. It has a weatherproof enclosure and industrial level battery to work in low to high temperatures 48 48 ))) 49 49 50 50 ((( 51 -DS03A-LB (% style="color:blue" %)**supports BLE configure**(%%) and (% style="color:blue" %)**wireless OTA update**(%%) which make user easy to use. 51 +DS03A-LB/LS (% style="color:blue" %)**supports BLE configure**(%%) and (% style="color:blue" %)**wireless OTA update**(%%) which make user easy to use. 52 52 ))) 53 53 54 54 ((( 55 -DS03A-LB is powered by (% style="color:blue" %)**8500mAh Li-SOCI2 battery **(%%)or **solar powered + li-on battery**, it is designed for long term use up to 5 years. 55 +DS03A-LB/LS is powered by (% style="color:blue" %)**8500mAh Li-SOCI2 battery **(%%)or (% style="color:blue" %)**solar powered + li-on battery**(%%), it is designed for long term use up to 5 years. 56 56 ))) 57 57 58 58 ((( 59 -Each DS03A-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. 59 +Each DS03A-LB/LS 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. 60 60 ))) 61 61 62 62 ... ... @@ -129,7 +129,7 @@ 129 129 [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/RS485-LB_Waterproof_RS485UART_to_LoRaWAN_Converter/WebHome/image-20240103160425-4.png?rev=1.1||alt="image-20240103160425-4.png"]] 130 130 131 131 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %) 132 -|=(% style="width: 167px;background-color:#D9E2F3;color:#0070C0" %)**Behavior on ACT**|=(% style="width: 117px;background-color:#D9E2F3;color:#0070C0" %)**Function**|=(% style="width: 22 5px;background-color:#D9E2F3;color:#0070C0" %)**Action**132 +|=(% style="width: 167px;background-color:#D9E2F3;color:#0070C0" %)**Behavior on ACT**|=(% style="width: 117px;background-color:#D9E2F3;color:#0070C0" %)**Function**|=(% style="width: 226px;background-color:#D9E2F3;color:#0070C0" %)**Action** 133 133 |(% style="width:167px" %)Pressing ACT between 1s < time < 3s|(% style="width:117px" %)Send an uplink|(% style="width:225px" %)((( 134 134 If sensor is already Joined to LoRaWAN network, sensor will send an uplink packet, (% style="color:blue" %)**blue led** (%%)will blink once. 135 135 Meanwhile, BLE module will be active and user can connect via BLE to configure device. ... ... @@ -144,7 +144,7 @@ 144 144 == 1.7 BLE connection == 145 145 146 146 147 -DS03A-LB support BLE remote configure. 147 +DS03A-LB/LS support BLE remote configure. 148 148 149 149 150 150 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: ... ... @@ -188,12 +188,12 @@ 188 188 * Wood Door: 10mm ~~ 30mm 189 189 * Iron Door: 30 ~~ 45mm 190 190 191 -= 2. Configure DS03A-LB to connect to LoRaWAN network = 191 += 2. Configure DS03A-LB/LS to connect to LoRaWAN network = 192 192 193 193 == 2.1 How it works == 194 194 195 195 196 -The DS03A-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 DS03A-LB. It will automatically join the network via OTAA and start to send the sensor value. The default uplink interval is 2 hours. 196 +The DS03A-LB/LS 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 DS03A-LB/LS. It will automatically join the network via OTAA and start to send the sensor value. The default uplink interval is 2 hours. 197 197 198 198 199 199 == 2.2 Quick guide to connect to LoRaWAN server (OTAA) == ... ... @@ -206,9 +206,9 @@ 206 206 [[image:image-20230522092858-1.png||height="391" width="874"]] 207 207 208 208 209 -(% style="color:blue" %)**Step 1:**(%%) Create a device in TTN with the OTAA keys from DS03A-LB. 209 +(% style="color:blue" %)**Step 1:**(%%) Create a device in TTN with the OTAA keys from DS03A-LB/LS. 210 210 211 -Each DS03A-LB is shipped with a sticker with the default device EUI as below: 211 +Each DS03A-LB/LS is shipped with a sticker with the default device EUI as below: 212 212 213 213 [[image:image-20230426085205-1.png||height="238" width="512"]] 214 214 ... ... @@ -238,10 +238,10 @@ 238 238 [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/D20-LBD22-LBD23-LB_LoRaWAN_Temperature_Sensor_User_Manual/WebHome/1675144157838-392.png?rev=1.1||alt="1675144157838-392.png"]] 239 239 240 240 241 -(% style="color:blue" %)**Step 2:**(%%) Activate on DS03A-LB 241 +(% style="color:blue" %)**Step 2:**(%%) Activate on DS03A-LB/LS 242 242 243 243 244 -Press the button for 5 seconds to activate the DS03A-LB. 244 +Press the button for 5 seconds to activate the DS03A-LB/LS. 245 245 246 246 (% 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. 247 247 ... ... @@ -253,9 +253,9 @@ 253 253 === 2.3.1 Device Status, FPORT~=5 === 254 254 255 255 256 -Include device configure status. Once DS03A-LB Joined the network, it will uplink this message to the server. After that, DS03A-LB will uplink Device Status every 12 hours. 256 +Include device configure status. Once DS03A-LB/LS Joined the network, it will uplink this message to the server. After that, DS03A-LB/LS will uplink Device Status every 12 hours. 257 257 258 -Users can also use the downlink command**(0x26 01)** to ask DS03A-LB to resend this uplink. This uplink payload also includes the DeviceTimeReq to get time. 258 +Users can also use the downlink command**(0x26 01)** to ask DS03A-LB/LS to resend this uplink. This uplink payload also includes the DeviceTimeReq to get time. 259 259 260 260 261 261 The Payload format is as below. ... ... @@ -270,7 +270,7 @@ 270 270 [[image:image-20230630155406-1.png||height="190" width="873"]] 271 271 272 272 273 -(% style="color:#037691" %)**Sensor Model**(%%): For DS03A-LB, this value is 0x1B 273 +(% style="color:#037691" %)**Sensor Model**(%%): For DS03A-LB/LS, this value is 0x1B 274 274 275 275 (% style="color:#037691" %)**Firmware Version**(%%): 0x0100, Means: v1.0.0 version 276 276 ... ... @@ -326,7 +326,7 @@ 326 326 === 2.3.2 Sensor Configuration, FPORT~=4 === 327 327 328 328 329 -DS03A-LB will only send this command after getting the downlink command **(0x26 02)** from the server. 329 +DS03A-LB/LS will only send this command after getting the downlink command **(0x26 02)** from the server. 330 330 331 331 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %) 332 332 |(% colspan="8" style="background-color:#d9e2f3; color:#0070c0; width:515px" %)**Sensor Configuration FPORT=4** ... ... @@ -357,9 +357,9 @@ 357 357 (% style="color:blue" %)**Disalarm: (default: 0)** 358 358 ))) 359 359 360 - **If Disalarm = 1**, DS03A-LB will only send uplink at every TDC periodically. This is normally use for pulse meter application, in this application, there are many open/close event, and platform only care about the total number of pulse. 360 + **If Disalarm = 1**, DS03A-LB/LS will only send uplink at every TDC periodically. This is normally use for pulse meter application, in this application, there are many open/close event, and platform only care about the total number of pulse. 361 361 362 - **If Disalarm = 0**, DS03A-LB will send uplink at every TDC periodically and send data on each open/close event. This is useful for the application user need to monitor the open/close event in real-time. 362 + **If Disalarm = 0**, DS03A-LB/LS will send uplink at every TDC periodically and send data on each open/close event. This is useful for the application user need to monitor the open/close event in real-time. 363 363 364 364 365 365 (% style="color:red" %)** Note: When Disalarm=0, a high frequently open/close event will cause lots of uplink and drain battery very fast. ** ... ... @@ -383,7 +383,7 @@ 383 383 === 2.3.3 Real-Time Open/Close Status, Uplink FPORT~=2 === 384 384 385 385 386 -DS03A-LB will send this uplink **after** Device Status once join the LoRaWAN network successfully. And DS03A-LB will send uplinks when: 386 +DS03A-LB/LS will send this uplink **after** Device Status once join the LoRaWAN network successfully. And DS03A-LB/LS will send uplinks when: 387 387 388 388 * Every 2 hours, this interval [[can be changed>>||anchor="H3.3.1A0SetTransmitIntervalTime"]]. 389 389 * There is an Open/Close event. (This info can be disabled by AT+DISALARM=1) ... ... @@ -559,7 +559,7 @@ 559 559 === 2.3.4 Historical Door Open/Close Event, FPORT~=3 === 560 560 561 561 562 -DS03A-LB stores sensor values and users can retrieve these history values via the [[downlink command>>||anchor="H2.5DatalogFeature"]]. 562 +DS03A-LB/LS stores sensor values and users can retrieve these history values via the [[downlink command>>||anchor="H2.5DatalogFeature"]]. 563 563 564 564 The historical payload includes one or multiplies entries and every entry has the same payload as Real-Time open/close status. 565 565 ... ... @@ -587,7 +587,7 @@ 587 587 ))) 588 588 589 589 * ((( 590 -Each data entry is 11 bytes and has the same structure as [[Real-Time open/close status>>||anchor="H2.3.3A0Real-TimeOpen2FCloseStatus2CUplinkFPORT3D2"]], to save airtime and battery, DS03A-LB will send max bytes according to the current DR and Frequency bands. 590 +Each data entry is 11 bytes and has the same structure as [[Real-Time open/close status>>||anchor="H2.3.3A0Real-TimeOpen2FCloseStatus2CUplinkFPORT3D2"]], to save airtime and battery, DS03A-LB/LS will send max bytes according to the current DR and Frequency bands. 591 591 ))) 592 592 593 593 For example, in the US915 band, the max payload for different DR is: ... ... @@ -659,7 +659,7 @@ 659 659 == 2.5 Datalog Feature == 660 660 661 661 662 -(% style="color:blue" %)**Datalog Feature** (%%)is to ensure IoT Server can get all sampling data from Sensor even if the LoRaWAN network is down. For each sampling, DS03A-LB will store the reading for future retrieving purposes. 662 +(% style="color:blue" %)**Datalog Feature** (%%)is to ensure IoT Server can get all sampling data from Sensor even if the LoRaWAN network is down. For each sampling, DS03A-LB/LS will store the reading for future retrieving purposes. 663 663 664 664 (% style="color:red" %)**Note:After the device is reset,in cumulative counting mode,the last stored count value will be read as the initial value.** 665 665 ... ... @@ -667,10 +667,10 @@ 667 667 === 2.5.1 Ways to get datalog via LoRaWAN === 668 668 669 669 670 -Set PNACKMD=1, DS03A-LB will wait for ACK for every uplink, when there is no LoRaWAN network,DS03A-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. 670 +Set PNACKMD=1, DS03A-LB/LS will wait for ACK for every uplink, when there is no LoRaWAN network, DS03A-LB/LS 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. 671 671 672 -* a) DS03A-LB will do an ACK check for data records sending to make sure every data arrive server. 673 -* b) DS03A-LB will send data in **CONFIRMED Mode** when PNACKMD=1, but DS03A-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 DS03A-LB gets a ACK, DS03A-LB will consider there is a network connection and resend all NONE-ACK Message. 672 +* a) DS03A-LB/LS will do an ACK check for data records sending to make sure every data arrive server. 673 +* b) DS03A-LB/LS will send data in **CONFIRMED Mode** when PNACKMD=1, but DS03A-LB/LS 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 DS03A-LB/LS gets a ACK, DS03A-LB/LS will consider there is a network connection and resend all NONE-ACK Message. 674 674 675 675 Below is the typical case for the Datalog Feature (Set PNACKMD=1) 676 676 ... ... @@ -680,7 +680,7 @@ 680 680 === 2.5.2 Unix TimeStamp === 681 681 682 682 683 -DS03A-LB uses Unix TimeStamp format based on 683 +DS03A-LB/LS uses Unix TimeStamp format based on 684 684 685 685 [[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="image-20220523001219-11.png" height="97" width="627"]] 686 686 ... ... @@ -1152,7 +1152,7 @@ 1152 1152 = 7. Order Info = 1153 1153 1154 1154 1155 -Part Number: (% style="color:blue" %) **DS03A-LB-XX**1155 +**Part Number: (% style="color:blue" %)DS03A-LB-XX (%%)or (% style="color:blue" %)DS03A-LS-XX(%%)** 1156 1156 1157 1157 (% style="color:red" %)**XX**(%%): The default frequency band 1158 1158 ... ... @@ -1177,7 +1177,7 @@ 1177 1177 1178 1178 (% style="color:#037691" %)**Package Includes**: 1179 1179 1180 -* DS03A-LB LoRaWAN Temperature Sensor 1180 +* DS03A-LB or DS03A-LS LoRaWAN Temperature Sensor 1181 1181 1182 1182 (% style="color:#037691" %)**Dimension and weight**: 1183 1183