Changes for page DS20L -- LoRaWAN Smart Distance Detector User Manual 01
Last modified by Mengting Qiu on 2023/12/14 11:15
Summary
-
Page properties (1 modified, 0 added, 0 removed)
Details
- Page properties
-
- Content
-
... ... @@ -102,8 +102,8 @@ 102 102 [[image:Main.User Manual for LoRaWAN End Nodes.D20-LBD22-LBD23-LB_LoRaWAN_Temperature_Sensor_User_Manual.WebHome@1675071855856-879.png]] 103 103 104 104 105 -(% border="1" cellspacing="4" style="background-color:# F2F2F2; width:510px" %)106 -|=(% style="width: 167px;color: blue" %)**Behavior on ACT**|=(% style="width: 117px;background-color:#D9E2F3;color:#0070C0" %)**Function**|=(% style="width: 225px;background-color:#D9E2F3;color:#0070C0" %)**Action**105 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %) 106 +|=(% 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** 107 107 |(% style="width:167px" %)Pressing ACT between 1s < time < 3s|(% style="width:117px" %)Send an uplink|(% style="width:225px" %)((( 108 108 If sensor is already Joined to LoRaWAN network, sensor will send an uplink packet, (% style="color:blue" %)**blue led** (%%)will blink once. 109 109 Meanwhile, BLE module will be active and user can connect via BLE to configure device. ... ... @@ -133,9 +133,9 @@ 133 133 == 1.7 Hardware Variant == 134 134 135 135 136 -(% border="1" cellspacing=" 10" style="background-color:#f7faff; width:510px" %)137 -|=(% style="width: 102px;" %)Model|=(% style="width: 190px;" %)Photo|=(% style="width: 297px;" %)Probe Info 138 -|(% style="width:102px" %) **S31-LB**|(% style="width:190px" %) |(% style="width:297px" %)(((136 +(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:510px" %) 137 +|=(% style="width: 102px;background-color:#D9E2F3;color:#0070C0" %)Model|=(% style="width: 190px;background-color:#D9E2F3;color:#0070C0" %)Photo|=(% style="width: 297px;background-color:#D9E2F3;color:#0070C0" %)Probe Info 138 +|(% style="width:102px" %)S31-LB|(% style="width:190px" %) |(% style="width:297px" %)((( 139 139 1 x SHT31 Probe 140 140 141 141 Cable Length : 2 meters ... ... @@ -142,7 +142,7 @@ 142 142 143 143 144 144 ))) 145 -|(% style="width:102px" %) **S31B-LB**|(% style="width:190px" %) |(% style="width:297px" %)(((145 +|(% style="width:102px" %)S31B-LB|(% style="width:190px" %) |(% style="width:297px" %)((( 146 146 1 x SHT31 Probe 147 147 148 148 Installed in device. ... ... @@ -178,7 +178,6 @@ 178 178 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. 179 179 180 180 181 -[[image:1675144005218-297.png]] 182 182 183 183 184 184 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. ... ... @@ -188,7 +188,7 @@ 188 188 189 189 Each S31x-LB is shipped with a sticker with the default device EUI as below: 190 190 191 -[[image:i mage-20230131134744-2.jpeg]]190 +[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LSN50v2-S31-S31B%20LoRaWAN%20Temperature%20%26%20Humidity%20Sensor%20User%20Manual/WebHome/image-20220607170145-1.jpeg?rev=1.1||alt="image-20220607170145-1.jpeg"]] 192 192 193 193 194 194 ... ... @@ -197,23 +197,23 @@ 197 197 198 198 (% style="color:blue" %)**Register the device** 199 199 200 -[[image:16 75144099263-405.png]]199 +[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LSN50v2-S31-S31B%20LoRaWAN%20Temperature%20%26%20Humidity%20Sensor%20User%20Manual/WebHome/1654935135620-998.png?rev=1.1||alt="1654935135620-998.png"]] 201 201 202 202 203 203 (% style="color:blue" %)**Add APP EUI and DEV EUI** 204 204 205 -[[image:16 75144117571-832.png]]204 +[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LSN50v2-S31-S31B%20LoRaWAN%20Temperature%20%26%20Humidity%20Sensor%20User%20Manual/WebHome/image-20220611161308-4.png?width=753&height=551&rev=1.1||alt="image-20220611161308-4.png"]] 206 206 207 207 208 208 (% style="color:blue" %)**Add APP EUI in the application** 209 209 210 210 211 -[[image:16 75144143021-195.png]]210 +[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LSN50v2-S31-S31B%20LoRaWAN%20Temperature%20%26%20Humidity%20Sensor%20User%20Manual/WebHome/image-20220611161308-5.png?width=742&height=601&rev=1.1||alt="image-20220611161308-5.png"]] 212 212 213 213 214 214 (% style="color:blue" %)**Add APP KEY** 215 215 216 -[[image:16 75144157838-392.png]]215 +[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LSN50v2-S31-S31B%20LoRaWAN%20Temperature%20%26%20Humidity%20Sensor%20User%20Manual/WebHome/image-20220611161308-6.png?width=744&height=485&rev=1.1||alt="image-20220611161308-6.png"]] 217 217 218 218 219 219 (% style="color:blue" %)**Step 2:**(%%) Activate on S31x-LB ... ... @@ -236,14 +236,14 @@ 236 236 The Payload format is as below. 237 237 238 238 239 -(% border="1" cellspacing="4" style="background-color:#f 7faff;color:black;width:510px" %)240 -|(% colspan="6" %)**Device Status (FPORT=5)** 238 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %) 239 +|(% colspan="6" style="background-color:#d9e2f3; color:#0070c0" %)**Device Status (FPORT=5)** 241 241 |(% style="width:103px" %)**Size (bytes)**|(% style="width:72px" %)**1**|**2**|(% style="width:91px" %)**1**|(% style="width:86px" %)**1**|(% style="width:44px" %)**2** 242 242 |(% 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 243 243 244 244 Example parse in TTNv3 245 245 246 -[[image:image-20230415153147-2.png ||height="220" width="1120"]]245 +[[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/image-20230415153147-2.png?width=1120&height=220&rev=1.1||alt="image-20230415153147-2.png"]] 247 247 248 248 249 249 (% style="color:#037691" %)**Sensor Model**(%%): For S31x-LB, this value is 0x0A ... ... @@ -304,19 +304,20 @@ 304 304 305 305 Sensor Data is uplink via FPORT=2 306 306 307 -|=((( 306 +(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:510px" %) 307 +|=(% style="width: 99px;background-color:#D9E2F3" %)((( 308 308 **Size(bytes)** 309 -)))|=2|=4|=1|=**2**|=2 310 -|**Value**|((( 311 -[[Battery>> path:#HBattery:]]312 -)))|((( 313 -[[Unix TimeStamp>> path:#H2.4.1UnixTimeStamp]]314 -)))|((( 315 -[[Alarm Flag>> path:#HAlarmFlag26MOD:]]316 -)))|((( 317 -[[Temperature>> path:#HTemperature:]]318 -)))|((( 319 -[[Humidity>> path:#HHumidity:]]309 +)))|=(% style="width: 69px;background-color:#D9E2F3" %)2|=(% style="width: 130px;background-color:#D9E2F3" %)4|=(% style="width: 91px;background-color:#D9E2F3" %)1|=(% style="width: 103px;background-color:#D9E2F3" %)**2**|=(% style="width: 80px;background-color:#D9E2F3" %)2 310 +|(% style="width:99px" %)**Value**|(% style="width:69px" %)((( 311 +[[Battery>>||anchor="HBattery:"]] 312 +)))|(% style="width:130px" %)((( 313 +[[Unix TimeStamp>>||anchor="H2.5.2UnixTimeStamp"]] 314 +)))|(% style="width:91px" %)((( 315 +[[Alarm Flag>>||anchor="HAlarmFlag26MOD:"]] 316 +)))|(% style="width:103px" %)((( 317 +[[Temperature>>||anchor="HTemperature:"]] 318 +)))|(% style="width:80px" %)((( 319 +[[Humidity>>||anchor="HHumidity:"]] 320 320 ))) 321 321 322 322 ==== (% style="color:#4472c4" %)**Battery:**(%%) ==== ... ... @@ -362,6 +362,7 @@ 362 362 363 363 == 2.4 Payload Decoder file == 364 364 365 + 365 365 In TTN, use can add a custom payload so it shows friendly reading 366 366 367 367 In the page (% style="color:#037691" %)**Applications ~-~-> Payload Formats ~-~-> Custom ~-~-> decoder**(%%) to add the decoder from: ... ... @@ -378,7 +378,7 @@ 378 378 === 2.5.1 Ways to get datalog via LoRaWAN === 379 379 380 380 381 -Set [[PNACKMD=1>> url:http://wiki.dragino.com/xwiki/bin/view/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LHT65N%20LoRaWAN%20Temperature%20%26%20Humidity%20Sensor%20Manual/#H4.13AutoSendNone-ACKmessages]], S31x-LB will wait for ACK for every uplink, when there is no LoRaWAN network,S31x-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.382 +Set [[PNACKMD=1>>||anchor="H2.5.4DatalogUplinkpayloadA028FPORT3D329"]], S31x-LB will wait for ACK for every uplink, when there is no LoRaWAN network,S31x-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. 382 382 383 383 * a) S31x-LB will do an ACK check for data records sending to make sure every data arrive server. 384 384 * b) S31x-LB will send data in **CONFIRMED Mode** when PNACKMD=1, but S31x-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 S31x-LB gets a ACK, S31x-LB will consider there is a network connection and resend all NONE-ACK messages. ... ... @@ -406,11 +406,11 @@ 406 406 === 2.5.3 Set Device Time === 407 407 408 408 409 -User need to set **SYNCMOD=1** to enable sync time via MAC command. 410 +User need to set (% style="color:blue" %)**SYNCMOD=1**(%%) to enable sync time via MAC command. 410 410 411 411 Once S31x-LB Joined LoRaWAN network, it will send the MAC command (DeviceTimeReq) and the server will reply with (DeviceTimeAns) to send the current time to S31x-LB. If S31x-LB fails to get the time from the server, S31x-LB will use the internal time and wait for next time request (AT+SYNCTDC to set the time request period, default is 10 days). 412 412 413 -**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.** 414 +(% 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.** 414 414 415 415 416 416 === 2.5.4 Datalog Uplink payload (FPORT~=3) === ... ... @@ -420,13 +420,13 @@ 420 420 421 421 **Retrieval data payload:** 422 422 423 -(% style="width: 858px" %)424 -|=(% style="width: 103px;" %)((( 424 +(% style="background-color:#f2f2f2; width:640.222px" %) 425 +|=(% style="width: 103px;background-color:#D9E2F3" %)((( 425 425 **Size(bytes)** 426 -)))|=(% style="width: 129px;" %)**2**|=(% style="width: 114px;" %)**2**|=(% style="width: 217px;" %)**2**|=(% style="width: 153px;" %)**1**|=(% style="width: 139px;" %)**4**427 -|(% style="width:103px" %)**Value**|(% style="width: 129px" %)(((427 +)))|=(% style="width: 54px; background-color: rgb(217, 226, 243);" %)**2**|=(% style="width: 51px; background-color: rgb(217, 226, 243);" %)**2**|=(% style="width: 89px; background-color: rgb(217, 226, 243);" %)**2**|=(% style="width: 103px; background-color: rgb(217, 226, 243);" %)**1**|=(% style="width: 148px; background-color: rgb(217, 226, 243);" %)**4** 428 +|(% style="width:103px" %)**Value**|(% style="width:54px" %)((( 428 428 [[Temp_Black>>||anchor="HTemperatureBlack:"]] 429 -)))|(% style="width:1 14px" %)[[Temp_White>>||anchor="HTemperatureWhite:"]]|(% style="width:217px" %)[[Temp_ Red or Temp _White>>||anchor="HTemperatureREDorTemperatureWhite:"]]|(% style="width:153px" %)Poll message flag & Ext|(% style="width:139px" %)[[Unix Time Stamp>>url:http://wiki.dragino.com/xwiki/bin/view/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LHT65N%20LoRaWAN%20Temperature%20%26%20Humidity%20Sensor%20Manual/#H2.6.2UnixTimeStamp]]430 +)))|(% style="width:51px" %)[[Temp_White>>||anchor="HTemperatureWhite:"]]|(% style="width:89px" %)[[Temp_ Red or Temp _White>>||anchor="HTemperatureREDorTemperatureWhite:"]]|(% style="width:103px" %)Poll message flag & Ext|(% style="width:148px" %)[[Unix Time Stamp>>||anchor="H2.5.2UnixTimeStamp"]] 430 430 431 431 **Poll message flag & Ext:** 432 432