Changes for page LHT52 - LoRaWAN Temperature & Humidity Sensor User Manual
Last modified by Mengting Qiu on 2024/04/30 14:27
Change comment:
There is no comment for this version
Summary
-
Page properties (1 modified, 0 added, 0 removed)
-
Attachments (0 modified, 0 added, 3 removed)
Details
- Page properties
-
- Content
-
... ... @@ -260,7 +260,7 @@ 260 260 [[Time Stamp>>path:#Unix_Time_Stamp]] 261 261 ))) 262 262 263 -* **Battery status & **[[(% class="wikiinternallink wikiinternallink wikiinternallink" %)**Built-in Humidity**>>path:#SHT20_Humidity]]263 +* **Battery status & **[[(% class="wikiinternallink" %)**Built-in Humidity**>>path:#SHT20_Humidity]] 264 264 265 265 (% style="width:587px" %) 266 266 |Bit(bit)|(% style="width:280px" %)[15:14]|(% style="width:136px" %)[11:0] ... ... @@ -294,6 +294,7 @@ 294 294 * Sync time OK: 1: Set time ok,0: N/A. After time SYNC request is sent, LHT65N will set this bit to 0 until got the time stamp from the application server. 295 295 * Unix Time Request:1: Request server downlink Unix time, 0 : N/A. In this mode, LHT65N will set this bit to 1 every 10 days to request a time SYNC. (AT+SYNCMOD to set this) 296 296 297 + 297 297 == Show data on Datacake == 298 298 299 299 Datacake IoT platform provides a human-friendly interface to show the sensor data, once we have sensor data in TTN V3, we can use Datacake to connect to TTN V3 and see the data in Datacake. Below are the steps: ... ... @@ -323,182 +323,7 @@ 323 323 [[image:image-20220523000825-10.png||height="432" width="762"]] 324 324 325 325 326 -== Datalog Feature == 327 327 328 -This feature is always enabled. When user wants to retrieve the sensor value, he can send a poll command from the IoT platform to ask LHT65N to send the value in the required time slot. 329 - 330 -=== Unix TimeStamp === 331 - 332 -LHT65N uses Unix TimeStamp format based on 333 - 334 -[[image:image-20220523001219-11.png||height="97" width="627"]] 335 - 336 - 337 -User can get this time from link: [[https:~~/~~/www.epochconverter.com/>>url:https://www.epochconverter.com/]] : 338 - 339 -Below is the converter example 340 - 341 -[[image:image-20220523001219-12.png||height="353" width="853"]] 342 - 343 -So, we can use AT+TIMESTAMP=1611889405 or downlink 3060137afd00 to set the current time 2021 – Jan ~-~- 29 Friday 03:03:25 344 - 345 - 346 -=== Set Device Time === 347 - 348 -There are two ways to set device’s time: 349 - 350 -**~1. Through LoRaWAN MAC Command (Default settings)** 351 - 352 -User need to set SYNCMOD=1 to enable sync time via MAC command. 353 - 354 -Once LHT65N Joined LoRaWAN network, it will send the MAC command (DeviceTimeReq) and the server will reply with (DeviceTimeAns) to send the current time to LHT65N. If LHT65N fails to get the time from the server, LHT65N will use the internal time and wait for next time request (AT+SYNCTDC to set the time request period, default is 10 days). 355 - 356 -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. 357 - 358 - 359 -**2. Manually Set Time** 360 - 361 -User needs to set SYNCMOD=0 to manual time, otherwise, the user set time will be overwritten by the time set by the server. 362 - 363 - 364 -=== Poll sensor value === 365 - 366 -User can poll sensor value based on timestamps from the server. Below is the downlink command. 367 - 368 - 369 -(% style="width:454px" %) 370 -|(% style="width:69px" %)1byte|(% style="width:129px" %)4bytes|(% style="width:134px" %)4bytes|(% style="width:119px" %)1byte 371 -|(% style="width:69px" %)31|(% style="width:129px" %)Timestamp start|(% style="width:134px" %)Timestamp end|(% style="width:119px" %)Uplink Interval 372 - 373 -Timestamp start and Timestamp end use Unix TimeStamp format as mentioned above. Devices will reply with all data log during this time period, use the uplink interval. 374 - 375 - 376 -For example, downlink command 31 5FC5F350 5FC6 0160 05 377 - 378 -Is to check 2020/12/1 07:40:00 to 2020/12/1 08:40:00’s data 379 - 380 -Uplink Internal =5s,means LHT65N will send one packet every 5s. range 5~~255s. 381 - 382 - 383 -=== Datalog Uplink payload === 384 - 385 -The Datalog poll reply uplink will use below payload format. 386 - 387 - 388 -Retrieval data payload 389 - 390 -|**Size(bytes)**|**2**|**2**|**2**|**1**|**4** 391 -|**Value**|[[External sensor data>>path:#Extension_sensor_value]]|((( 392 -[[Built-In>>path:#SHT20_Temperature]] 393 - 394 -[[Temperature>>path:#SHT20_Temperature]] 395 -)))|((( 396 -[[Built-in>>path:#SHT20_Humidity]] 397 - 398 -[[Humidity>>path:#SHT20_Humidity]] 399 -)))|[[Poll message flag & Ext>>path:#Poll_EXT]]|((( 400 -[[Unix Time Stamp>>path:#Unix_Time_Stamp]] 401 - 402 - 403 -))) 404 - 405 -Poll message flag & Ext 406 - 407 - 408 -|**Bits**|**7**|**6**|**5**|**4**|**[3:0]** 409 -|**Status & Ext**|Not Defined|Poll Message Flag|Sync time OK|Unix Time Request|((( 410 -Ext: 411 - 412 -0b(1001) 413 -))) 414 - 415 -Poll Message Flag: 1: This message is a poll message reply. 416 - 417 -* Poll Message Flag is set to 1. 418 -* Each data entry is 11 bytes, to save airtime and battery, devices will send max bytes according to the current DR and Frequency bands. 419 - 420 -For example, in US915 band, the max payload for different DR is: 421 - 422 -a) DR0: max is 11 bytes so one entry of data 423 - 424 -b) DR1: max is 53 bytes so devices will upload 4 entries of data (total 44 bytes) 425 - 426 -c) DR2: total payload includes 11 entries of data 427 - 428 -d) DR3: total payload includes 22 entries of data. 429 - 430 -If devise doesn’t have any data in the polling time. Device will uplink 11 bytes of 0 431 - 432 - 433 -**Example:** 434 - 435 -If LHT65N has below data inside Flash: 436 - 437 -Flash Addr |Unix Time | Ext | BAT voltage| Value 438 - 439 -80196E0 21/1/19 04:27:03 1 3145 sht_temp=22.00 sht_hum=32.6 ds_temp=327.67 440 - 441 -80196F0 21/1/19 04:28:57 1 3145 sht_temp=21.90 sht_hum=33.1 ds_temp=327.67 442 - 443 -8019700 21/1/19 04:30:30 1 3145 sht_temp=21.81 sht_hum=33.4 ds_temp=327.67 444 - 445 -8019710 21/1/19 04:40:30 1 3145 sht_temp=21.65 sht_hum=33.7 ds_temp=327.67 446 - 447 -8019720 21/1/19 04:50:30 1 3147 sht_temp=21.55 sht_hum=34.1 ds_temp=327.67 448 - 449 -8019730 21/1/19 05:00:30 1 3149 sht_temp=21.50 sht_hum=34.1 ds_temp=327.67 450 - 451 -8019740 21/1/19 05:10:30 1 3149 sht_temp=21.43 sht_hum=34.6 ds_temp=327.67 452 - 453 -8019750 21/1/19 05:20:30 1 3151 sht_temp=21.35 sht_hum=34.9 ds_temp=327.67 454 - 455 - 456 -If user sends below downlink command: 457 - 458 -3160065F9760066DA705 459 - 460 - Where : Start time: 60065F97 = time 21/1/19 04:27:03 461 - 462 - Stop time 60066DA7= time 21/1/19 05:27:03 463 - 464 - 465 -LHT65N will uplink this payload. 466 - 467 -[[image:image-20220523001219-13.png]] 468 - 469 -7FFF089801464160065F977FFF088E014B41600660097FFF0885014E41600660667FFF0875015141600662BE7FFF086B015541600665167FFF08660155416006676E7FFF085F015A41600669C67FFF0857015D4160066C1E 470 - 471 -Where the first 11 bytes is for the first entry: 472 - 473 -7FFF089801464160065F97 474 - 475 -Ext sensor data=0x7FFF/100=327.67 476 - 477 -Temp=0x0898/100=22.00 478 - 479 -Hum=0x0146/10=32.6 480 - 481 -poll message flag & Ext=0x41,means reply data,Ext=1 482 - 483 -Unix time is 0x60065F97=1611030423s=21/1/19 04:27:03 484 - 485 - 486 -== Alarm Mode == 487 - 488 -Alarm mode feature is added since firmware v1.5. When device is in Alarm mode, it will check the built-in sensor temperature in a short interval. If the temperature exceeds the pre-configure range, it will send an uplink immediately. 489 - 490 - 491 -Note: Alarm mode will increase a little big the power consumption, we recommend extending the normal reading time when enabling this feature. 492 - 493 - 494 -AT Commands for Alarm mode: 495 - 496 -**AT+WMOD=1**: Enable/Disable Alarm Mode. (0:Disable, 1: Enable) 497 - 498 -**AT+CITEMP=1**: The interval to check the temperature for Alarm. (Unit: minute) 499 - 500 - 501 - 502 502 == LED Indicator == 503 503 504 504 The LHT65N has a triple color LED which for easy shows different stage. ... ... @@ -516,7 +516,7 @@ 516 516 517 517 == Installation == 518 518 519 -[[image:image-20220516231650-1.png||height=" 436" width="428"]]345 +[[image:image-20220516231650-1.png||height="632" width="620"]] 520 520 521 521 522 522 ... ... @@ -536,348 +536,8 @@ 536 536 * Operating Range: -40 ~~ 125 °C 537 537 * -55°C to 125°C 538 538 * Working voltage 2.35v ~~ 5v 365 + 539 539 540 -= Configure LHT65N via AT Command or LoRaWAN Downlink = 541 - 542 -Use can configure LHT65N via AT Command or LoRaWAN Downlink. 543 - 544 -* AT Command Connection: See [[FAQ>>path:#AT_COMMAND]]. 545 -* LoRaWAN Downlink instruction for different platforms: 546 - 547 -[[http:~~/~~/wiki.dragino.com/index.php?title=Main_Page#Use_Note_for_Server>>url:http://wiki.dragino.com/index.php?title=Main_Page#Use_Note_for_Server]] 548 - 549 - 550 -There are two kinds of commands to configure LHT65N, they are: 551 - 552 -* **General Commands**. 553 - 554 -These commands are to configure: 555 - 556 -* General system settings like: uplink interval. 557 -* LoRaWAN protocol & radio-related commands. 558 - 559 -They are the same for all Dragino Devices which supports DLWS-005 LoRaWAN Stack(Note~*~*). These commands can be found on the wiki: 560 - 561 -[[http:~~/~~/wiki.dragino.com/index.php?title=End_Device_Downlink_Command>>url:http://wiki.dragino.com/index.php?title=End_Device_Downlink_Command]] 562 - 563 - 564 - 565 -* **Commands special design for LHT65N** 566 - 567 -These commands are only valid for LHT65N, as below: 568 - 569 - 570 -== Set Transmit Interval Time == 571 - 572 -Feature: Change LoRaWAN End Node Transmit Interval. 573 - 574 -**AT Command: AT+TDC** 575 - 576 -|**Command Example**|**Function**|**Response** 577 -|AT+TDC?|Show current transmit Interval|((( 578 -30000 579 - 580 -OK 581 - 582 -the interval is 30000ms = 30s 583 -))) 584 -|AT+TDC=60000|Set Transmit Interval|((( 585 -OK 586 - 587 -Set transmit interval to 60000ms = 60 seconds 588 -))) 589 - 590 - 591 -**Downlink Command: 0x01** 592 - 593 -Format: Command Code (0x01) followed by 3 bytes time value. 594 - 595 -If the downlink payload=0100003C, it means set the END Node’s Transmit Interval to 0x00003C=60(S), while type code is 01. 596 - 597 -* Example 1: Downlink Payload: 0100001E ~/~/ Set Transmit Interval (TDC) = 30 seconds 598 -* Example 2: Downlink Payload: 0100003C ~/~/ Set Transmit Interval (TDC) = 60 seconds 599 - 600 - 601 -== Set External Sensor Mode == 602 - 603 -Feature: Change External Sensor Mode. 604 - 605 -**AT Command: AT+EXT** 606 - 607 -|**Command Example**|**Function**|**Response** 608 -|AT+EXT?|Get current external sensor mode|((( 609 -1 610 - 611 -OK 612 - 613 -External Sensor mode =1 614 -))) 615 -|AT+EXT=1|(% colspan="2" %)Set external sensor mode to 1 616 -|AT+EXT=9|(% colspan="2" %)Set to external DS18B20 with timestamp 617 - 618 - 619 -**Downlink Command: 0xA2** 620 - 621 -Total bytes: 2 ~~ 5 bytes 622 - 623 -Example: 624 - 625 -* 0xA201: Set external sensor type to E1 626 -* 0xA209: Same as AT+EXT=9 627 -* 0xA20702003c,Same as AT+SETCNT=60 628 - 629 - 630 -== Enable/Disable uplink Temperature probe ID == 631 - 632 -Feature: If PID is enabled, device will send the temperature probe ID on: 633 - 634 -* First Packet after OTAA Join 635 -* Every 24 hours since the first packet. 636 - 637 -PID is default set to disable (0) 638 - 639 - 640 -**AT Command:** 641 - 642 -|**Command Example**|**Function**|**Response** 643 -|AT+PID=1|Enable PID uplink|OK 644 - 645 - 646 -**Downlink Command:** 647 - 648 -* 0xA800 à AT+PID=0 649 -* 0xA801 à AT+PID=1 650 - 651 - 652 - 653 -== Set Password == 654 - 655 -Feature: Set device password, max 9 digits 656 - 657 -**AT Command: AT+PWORD** 658 - 659 -|**Command Example**|**Function**|**Response** 660 -|AT+PWORD=?|Show password|((( 661 -123456 662 - 663 - 664 -OK 665 -))) 666 -|AT+PWORD=999999|Set password|OK 667 - 668 - 669 -**Downlink Command:** 670 - 671 -No downlink command for this feature. 672 - 673 - 674 -== Quit AT Command == 675 - 676 -Feature: Quit AT Command mode, so user needs to input password again before use AT Commands. 677 - 678 -**AT Command: AT+DISAT** 679 - 680 -|**Command Example**|**Function**|**Response** 681 -|AT+DISAT|Quit AT Commands mode|OK 682 - 683 - 684 -**Downlink Command:** 685 - 686 -No downlink command for this feature. 687 - 688 - 689 -== Set to sleep mode == 690 - 691 -Feature: Set device to sleep mode 692 - 693 -**AT Command: AT+SLEEP** 694 - 695 -| | | 696 -|**Command Example**|**Function**|**Response** 697 -|AT+SLEEP|Set to sleep mode|((( 698 -Clear all stored sensor data… 699 - 700 -OK 701 -))) 702 - 703 - 704 -**Downlink Command:** 705 - 706 -* There is no downlink command to set to Sleep mode. 707 - 708 - 709 - 710 -== Set system time == 711 - 712 -Feature: Set system time, unix format. [[See here for format detail.>>path:#TimeStamp]] 713 - 714 -**AT Command:** 715 - 716 -|**Command Example**|**Function** 717 -|AT+TIMESTAMP=1611104352|((( 718 -OK 719 - 720 -Set System time to 2021-01-20 00:59:12 721 -))) 722 - 723 - 724 -**Downlink Command:** 725 - 726 -0x306007806000 ~/~/ Set timestamp to 0x(6007806000),Same as AT+TIMESTAMP=1611104352 727 - 728 - 729 -== Set Time Sync Mode == 730 - 731 -Feature: Enable/Disable Sync system time via LoRaWAN MAC Command (DeviceTimeReq), LoRaWAN server must support v1.0.3 protocol to reply this command. 732 - 733 - 734 -SYNCMOD is set to 1 by default. If user want to set a different time from LoRaWAN server, user need to set this to 0. 735 - 736 - 737 -**AT Command:** 738 - 739 -|**Command Example**|**Function** 740 -|AT+SYNCMOD=1|Enable Sync system time via LoRaWAN MAC Command (DeviceTimeReq) 741 - 742 - 743 -**Downlink Command:** 744 - 745 -0x28 01 ~/~/ Same As AT+SYNCMOD=1 746 - 747 -0x28 00 ~/~/ Same As AT+SYNCMOD=0 748 - 749 - 750 -== Set Time Sync Interval == 751 - 752 -Feature: Define System time sync interval. SYNCTDC default value: 10 days. 753 - 754 -**AT Command:** 755 - 756 -|**Command Example**|**Function** 757 -|AT+SYNCTDC=0x0A|Set SYNCTDC to 10 (0x0A), so the sync time is 10 days. 758 - 759 - 760 -**Downlink Command:** 761 - 762 -0x29 0A ~/~/ Same as AT+SYNCTDC=0x0A 763 - 764 - 765 -== Print data entries base on page. == 766 - 767 -Feature: Print the sector data from start page to stop page (max is 416 pages). 768 - 769 -**AT Command: AT+PDTA** 770 - 771 -|**Command Example**|**Response** 772 -|((( 773 -AT+PDTA=1,3 774 - 775 - 776 - 777 -Print page 1 to 3 778 -)))|((( 779 -8019500 19/6/26 16:48 1 2992 sht_temp=28.21 sht_hum=71.5 ds_temp=27.31 780 - 781 -8019510 19/6/26 16:53 1 2994 sht_temp=27.64 sht_hum=69.3 ds_temp=26.93 782 - 783 -8019520 19/6/26 16:58 1 2996 sht_temp=28.39 sht_hum=72.0 ds_temp=27.06 784 - 785 -8019530 19/6/26 17:03 1 2996 sht_temp=27.97 sht_hum=70.4 ds_temp=27.12 786 - 787 -8019540 19/6/26 17:08 1 2996 sht_temp=27.80 sht_hum=72.9 ds_temp=27.06 788 - 789 -8019550 19/6/26 17:13 1 2998 sht_temp=27.30 sht_hum=72.4 ds_temp=26.68 790 - 791 -8019560 19/6/26 17:22 1 2992 sht_temp=26.27 sht_hum=62.3 ds_temp=26.56 792 - 793 -8019570 794 - 795 -8019580 796 - 797 -8019590 798 - 799 -80195A0 800 - 801 -80195B0 802 - 803 -80195C0 804 - 805 -80195D0 806 - 807 -80195E0 808 - 809 -80195F0 810 - 811 - 812 -OK 813 -))) 814 - 815 - 816 -**Downlink Command:** 817 - 818 -No downlink commands for feature 819 - 820 - 821 - 822 -== Print last few data entries. == 823 - 824 -Feature: Print the last few data entries 825 - 826 -**AT Command: AT+PLDTA** 827 - 828 -|**Command Example**|**Response** 829 -|((( 830 -AT+PLDTA=5 831 - 832 - 833 - 834 -Print last 5 entries 835 -)))|((( 836 -Stop Tx and RTP events when read sensor data 837 - 838 -1 19/6/26 13:59 1 3005 sht_temp=27.09 sht_hum=79.5 ds_temp=26.75 839 - 840 -2 19/6/26 14:04 1 3007 sht_temp=26.65 sht_hum=74.8 ds_temp=26.43 841 - 842 -3 19/6/26 14:09 1 3007 sht_temp=26.91 sht_hum=77.9 ds_temp=26.56 843 - 844 -4 19/6/26 14:15 1 3007 sht_temp=26.93 sht_hum=76.7 ds_temp=26.75 845 - 846 -5 19/6/26 14:20 1 3007 sht_temp=26.78 sht_hum=76.6 ds_temp=26.43 847 - 848 -Start Tx and RTP events 849 - 850 -OK 851 -))) 852 - 853 - 854 -**Downlink Command:** 855 - 856 -No downlink commands for feature 857 - 858 - 859 - 860 -== Clear Flash Record == 861 - 862 -Feature: Clear flash storage for data log feature. 863 - 864 -**AT Command: AT+CLRDTA** 865 - 866 -|**Command Example**|**Function**|**Response** 867 -|AT+CLRDTA|Clear date record|((( 868 -Clear all stored sensor data… 869 - 870 -OK 871 -))) 872 - 873 - 874 -**Downlink Command: 0xA3** 875 - 876 -* Example: 0xA301 ~/~/Same as AT+CLRDTA 877 - 878 - 879 - 880 - 881 881 = Battery & How to replace = 882 882 883 883 == Battery Type ==
- image-20220523001219-11.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Edwin - Size
-
... ... @@ -1,1 +1,0 @@ 1 -18.8 KB - Content
- image-20220523001219-12.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Edwin - Size
-
... ... @@ -1,1 +1,0 @@ 1 -86.2 KB - Content
- image-20220523001219-13.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Edwin - Size
-
... ... @@ -1,1 +1,0 @@ 1 -35.6 KB - Content