Skip to Content
Last modified by Mengting Qiu on 2025/07/01 15:58
From version 14.14
edited by Xiaoling
on 2023/04/17 09:33
Change comment: There is no comment for this version
To version 14.28
edited by Xiaoling
on 2023/04/17 10:44
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -235,14 +235,14 @@
235 235  The Payload format is as below.
236 236  
237 237  
238 -(% border="1" cellspacing="4" style="background-color:#F2F2F2; width:510px" %)
239 -|(% colspan="6" style="background-color:#D9E2F3;color:#0070C0" %)**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)**
240 240  |(% style="width:103px" %)**Size (bytes)**|(% style="width:72px" %)**1**|**2**|(% style="width:91px" %)**1**|(% style="width:86px" %)**1**|(% style="width:44px" %)**2**
241 241  |(% 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
242 242  
243 243  Example parse in TTNv3
244 244  
245 -[[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"]]
246 246  
247 247  
248 248  (% style="color:#037691" %)**Sensor Model**(%%): For S31x-LB, this value is 0x0A
... ... @@ -303,19 +303,20 @@
303 303  
304 304  Sensor Data is uplink via FPORT=2
305 305  
306 -|=(((
306 +(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:510px" %)
307 +|=(% style="width: 99px;background-color:#D9E2F3" %)(((
307 307  **Size(bytes)**
308 -)))|=2|=4|=1|=**2**|=2
309 -|**Value**|(((
310 -[[Battery>>path:#HBattery:]]
311 -)))|(((
312 -[[Unix TimeStamp>>path:#H2.4.1UnixTimeStamp]]
313 -)))|(((
314 -[[Alarm Flag>>path:#HAlarmFlag26MOD:]]
315 -)))|(((
316 -[[Temperature>>path:#HTemperature:]]
317 -)))|(((
318 -[[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:"]]
319 319  )))
320 320  
321 321  ==== (% style="color:#4472c4" %)**Battery:**(%%) ====
... ... @@ -361,6 +361,7 @@
361 361  
362 362  == 2.4 Payload Decoder file ==
363 363  
365 +
364 364  In TTN, use can add a custom payload so it shows friendly reading
365 365  
366 366  In the page (% style="color:#037691" %)**Applications ~-~-> Payload Formats ~-~-> Custom ~-~-> decoder**(%%) to add the decoder from:
... ... @@ -377,7 +377,7 @@
377 377  === 2.5.1 Ways to get datalog via LoRaWAN ===
378 378  
379 379  
380 -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.
381 381  
382 382  * a) S31x-LB will do an ACK check for data records sending to make sure every data arrive server.
383 383  * 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.
... ... @@ -405,11 +405,11 @@
405 405  === 2.5.3 Set Device Time ===
406 406  
407 407  
408 -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.
409 409  
410 410  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).
411 411  
412 -**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.**
413 413  
414 414  
415 415  === 2.5.4 Datalog Uplink payload (FPORT~=3) ===
... ... @@ -419,19 +419,19 @@
419 419  
420 420  **Retrieval data payload:**
421 421  
422 -(% style="width:858px" %)
423 -|=(% style="width: 103px;" %)(((
424 +(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:510px" %)
425 +|=(% style="width: 103px;background-color:#D9E2F3" %)(((
424 424  **Size(bytes)**
425 -)))|=(% style="width: 129px;" %)**2**|=(% style="width: 114px;" %)**2**|=(% style="width: 217px;" %)**2**|=(% style="width: 153px;" %)**1**|=(% style="width: 139px;" %)**4**
426 -|(% 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: 54px; background-color: rgb(217, 226, 243);" %)**4**
428 +|(% style="width:103px" %)**Value**|(% style="width:54px" %)(((
427 427  [[Temp_Black>>||anchor="HTemperatureBlack:"]]
428 -)))|(% style="width:114px" %)[[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:54px" %)[[Unix Time Stamp>>||anchor="H2.5.2UnixTimeStamp"]]
429 429  
430 430  **Poll message flag & Ext:**
431 431  
432 432  [[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="image-20221006192726-1.png" height="112" width="754"]]
433 433  
434 -**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>>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]] feature)
436 +**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)
435 435  
436 436  **Poll Message Flag**: 1: This message is a poll message reply.
437 437  
... ... @@ -451,6 +451,7 @@
451 451  
452 452  If devise doesn't have any data in the polling time. Device will uplink 11 bytes of 0   
453 453  
456 +
454 454  **Example:**
455 455  
456 456  If D2x-LB has below data inside Flash:
... ... @@ -463,6 +463,7 @@
463 463  
464 464   Stop time: 60066DA7= time 21/1/19 05:27:03
465 465  
469 +
466 466  **S31x-LB will uplink this payload.**
467 467  
468 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-20220523001219-13.png?width=727&height=421&rev=1.1||alt="image-20220523001219-13.png" height="421" width="727"]]
... ... @@ -473,15 +473,15 @@
473 473  
474 474  7FFF089801464160065F97
475 475  
476 -Ext sensor data=0x7FFF/100=327.67
480 +**Ext sensor data**=0x7FFF/100=327.67
477 477  
478 -Temp=0x088E/100=22.00
482 +**Temp**=0x088E/100=22.00
479 479  
480 -Hum=0x014B/10=32.6
484 +**Hum**=0x014B/10=32.6
481 481  
482 -poll message flag & Ext=0x41,means reply data,Ext=1
486 +**poll message flag & Ext**=0x41,means reply data,Ext=1
483 483  
484 -Unix time is 0x60066009=1611030423s=21/1/19 04:27:03
488 +**Unix time** is 0x60066009=1611030423s=21/1/19 04:27:03
485 485  
486 486  
487 487  (% aria-label="Data URI image image widget" 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==||data-widget="image" draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]](% aria-label="Data URI image image widget" 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==||draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]](% aria-label="Data URI image image widget" 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="Click and drag to resize" %)​(% aria-label="Data URI image image widget" 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==||data-widget="image" draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]](% aria-label="Data URI image image widget" 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==||draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]](% aria-label="Data URI image image widget" 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="Click and drag to resize" %)​
... ... @@ -495,7 +495,6 @@
495 495  [[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="image-20220623090437-1.png"]]
496 496  
497 497  
498 -
499 499  == 2.7 Frequency Plans ==
500 500  
501 501  
... ... @@ -541,8 +541,8 @@
541 541  
542 542  (% style="color:blue" %)**AT Command: AT+TDC**
543 543  
544 -(% border="1" cellspacing="4" style="background-color:#f7faff; color:black; width:510px" %)
545 -|=(% style="width: 156px;" %)**Command Example**|=(% style="width: 137px;" %)**Function**|=**Response**
547 +(% border="1" cellspacing="4" style="background-color:#F2F2F2; width:510px" %)
548 +|=(% style="width: 156px;background-color:#D9E2F3" %)**Command Example**|=(% style="width: 137px;background-color:#D9E2F3" %)**Function**|=(% style="background-color:#D9E2F3" %)**Response**
546 546  |(% style="width:156px" %)AT+TDC=?|(% style="width:137px" %)Show current transmit Interval|(((
547 547  30000
548 548  OK
... ... @@ -567,7 +567,7 @@
567 567  
568 568  Send a LoRaWAN downlink to ask device send Alarm settings.
569 569  
570 -* (% style="color:#037691" %)**Downlink Payload:  **(%%)0x26 01
573 +*(% style="color:blue" %)**Downlink Payload:  **(%%)0x26 01
571 571  
572 572  Sensor will upload Device Status via FPORT=5. See payload section for detail.
573 573  
... ... @@ -574,9 +574,9 @@
574 574  
575 575  === 3.3.3 Set Temperature Alarm Threshold: ===
576 576  
577 -* **AT Command:**
580 +* **(% style="color:blue" %)AT Command:**
578 578  
579 -**AT+SHTEMP=min,max**
582 +**(% style="color:#037691" %)AT+SHTEMP=min,max**
580 580  
581 581  * When min=0, and max≠0, Alarm higher than max
582 582  * When min≠0, and max=0, Alarm lower than min
... ... @@ -586,18 +586,18 @@
586 586  
587 587   AT+SHTEMP=0,30   ~/~/ Alarm when temperature higher than 30.
588 588  
589 -* **Downlink Payload:**
592 +* **(% style="color:blue" %)Downlink Payload:**
590 590  
591 -**0x(0C 01 00 1E)**  ~/~/Set AT+SHTEMP=0,30
594 +**(% style="color:#037691" %)0x(0C 01 00 1E)**  (%%) ~/~/Set AT+SHTEMP=0,30
592 592  
593 -**(note: 3^^rd^^ byte= 0x00 for low limit(not set), 4^^th^^ byte = 0x1E for high limit: 30)**
596 +**(% style="color:red" %)(note: 3^^rd^^ byte= 0x00 for low limit(not set), 4^^th^^ byte = 0x1E for high limit: 30)**
594 594  
595 595  
596 596  === 3.3.4 Set Humidity Alarm Threshold: ===
597 597  
598 -* **AT Command:**
601 +* **(% style="color:blue" %)AT Command:**
599 599  
600 -**AT+SHHUM=min,max**
603 +**(% style="color:#037691" %)AT+SHHUM=min,max**
601 601  
602 602  * When min=0, and max≠0, Alarm higher than max
603 603  * When min≠0, and max=0, Alarm lower than min
... ... @@ -607,11 +607,11 @@
607 607  
608 608   AT+SHHUM=70,0   ~/~/ Alarm when humidity lower than 70%.
609 609  
610 -* **Downlink Payload:**
613 +* **(% style="color:blue" %)Downlink Payload:**
611 611  
612 -**0x(0C 02 46 00)**  ~/~/Set AT+SHTHUM=70,0
615 +**(% style="color:#037691" %)0x(0C 02 46 00)**(%%)  ~/~/Set AT+SHTHUM=70,0
613 613  
614 -**(note: 3^^rd^^ byte= 0x46 for low limit (70%), 4^^th^^ byte = 0x00 for high limit (not set))**
617 +**(% style="color:red" %)(note: 3^^rd^^ byte= 0x46 for low limit (70%), 4^^th^^ byte = 0x00 for high limit (not set))**
615 615  
616 616  
617 617  === 3.3.5 Set Alarm Interval: ===
... ... @@ -618,13 +618,13 @@
618 618  
619 619  The shortest time of two Alarm packet. (unit: min)
620 620  
621 -* **AT Command:**
624 +* **(% style="color:blue" %)AT Command:**
622 622  
623 -**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.
626 +**(% style="color:#037691" %)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.
624 624  
625 -* **Downlink Payload:**
628 +* **(% style="color:blue" %)Downlink Payload:**
626 626  
627 -**0x(0D 00 1E)**     **~-~--> ** Set AT+ATDC=0x 00 1E = 30 minutes
630 +**(% style="color:#037691" %)0x(0D 00 1E)**(%%)     **~-~--> ** Set AT+ATDC=0x 00 1E = 30 minutes
628 628  
629 629  
630 630  === 3.3.6 Get Alarm settings  （什么FPORT?） ===