Skip to Content
Last modified by Xiaoling on 2025/04/23 15:57
From version 30.2
edited by Xiaoling
on 2022/06/02 09:18
Change comment: There is no comment for this version
To version 33.2
edited by Xiaoling
on 2022/06/02 09:54
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -743,8 +743,6 @@
743 743  
744 744  * (% style="color:#4f81bd" %)**Sensor Related Commands**(%%): These commands are special designed for RS485-BL.  User can see these commands below:
745 745  
746 -
747 -
748 748  === 3.5.1 Common Commands: ===
749 749  
750 750  They should be available for each of Dragino Sensors, such as: change uplink interval, reset device. For firmware v1.3, user can find what common commands it supports: [[End Device AT Commands and Downlink Command>>doc:Main.End Device AT Commands and Downlink Command.WebHome]]
... ... @@ -760,9 +760,15 @@
760 760  
761 761  * **AT Command**
762 762  
761 +(% class="box infomessage" %)
762 +(((
763 763  **AT+MOD=1** ~/~/ Set to support RS485-MODBUS type sensors. User can connect multiply RS485 , Modbus sensors to the A / B pins.
764 +)))
764 764  
766 +(% class="box infomessage" %)
767 +(((
765 765  **AT+MOD=2** ~/~/ Set to support TTL Level sensors, User can connect one TTL Sensor to the TXD/RXD/GND pins.
769 +)))
766 766  
767 767  
768 768  * **Downlink Payload**
... ... @@ -777,7 +777,10 @@
777 777  
778 778  * **AT Command**
779 779  
780 -AT+CFGDEV=xx xx xx xx xx xx xx xx xx xx xx xx,m
784 +(% class="box infomessage" %)
785 +(((
786 +**AT+CFGDEV=xx xx xx xx xx xx xx xx xx xx xx xx,m**
787 +)))
781 781  
782 782  m: 0: no CRC; 1: add CRC-16/MODBUS in the end of this command.
783 783  
... ... @@ -818,44 +818,56 @@
818 818  
819 819  
820 820  
828 +==== **Set Payload version** ====
821 821  
822 -==== Set Payload version ====
823 -
824 824  This is the first byte of the uplink payload. RS485-BL can connect to different sensors. User can set the PAYVER field to tell server how to decode the current payload.
825 825  
826 -* AT Command:
832 +* **AT Command:**
827 827  
828 -AT+PAYVER: Set PAYVER field = 1
834 +(% class="box infomessage" %)
835 +(((
836 +**AT+PAYVER: Set PAYVER field = 1**
837 +)))
829 829  
830 830  
831 -* Downlink Payload:
840 +* **Downlink Payload:**
832 832  
833 -0xAE 01   à Set PAYVER field =  0x01
842 +**0xAE 01**  ~-~-> Set PAYVER field =  0x01
834 834  
835 -0xAE 0F   à Set PAYVER field =  0x0F
844 +**0xAE 0F**   ~-~-> Set PAYVER field =  0x0F
836 836  
837 837  
838 -==== Set RS485 Sampling Commands ====
839 839  
848 +==== **Set RS485 Sampling Commands** ====
849 +
840 840  AT+COMMANDx, AT+DATACUTx and AT+SEARCHx
841 841  
842 -These three commands are used to configure how the RS485-BL polling data from Modbus device. Detail of usage please see : [[polling RS485 device>>path:#polling_485]].
852 +These three commands are used to configure how the RS485-BL polling data from Modbus device. Detail of usage please see : [[polling RS485 device>>||anchor="H3.3.3Configurereadcommandsforeachsampling"]].
843 843  
844 844  
845 -* AT Command:
855 +* **AT Command:**
846 846  
847 -AT+COMMANDx: Configure RS485 read command to sensor.
857 +(% class="box infomessage" %)
858 +(((
859 +**AT+COMMANDx: Configure RS485 read command to sensor.**
860 +)))
848 848  
849 -AT+DATACUTx: Configure how to handle return from RS485 devices.
862 +(% class="box infomessage" %)
863 +(((
864 +**AT+DATACUTx: Configure how to handle return from RS485 devices.**
865 +)))
850 850  
851 -AT+SEARCHx: Configure search command
867 +(% class="box infomessage" %)
868 +(((
869 +**AT+SEARCHx: Configure search command**
870 +)))
852 852  
853 853  
854 -* Downlink Payload:
873 +* **Downlink Payload:**
855 855  
856 -0xAF downlink command can be used to set AT+COMMANDx or AT+DATACUTx.
875 +**0xAF** downlink command can be used to set AT+COMMANDx or AT+DATACUTx.
857 857  
858 -Note: if user use AT+COMMANDx to add a new command, he also need to send AT+DATACUTx downlink.
877 +(% style="color:red" %)**Note**(%%): if user use AT+COMMANDx to add a new command, he also need to send AT+DATACUTx downlink.
859 859  
860 860  Format: AF MM NN LL XX XX XX XX YY
861 861  
... ... @@ -862,23 +862,23 @@
862 862  Where:
863 863  
864 864  * MM: the ATCOMMAND or AT+DATACUT to be set. Value from 01 ~~ 0F,
865 -* NN: 0: no CRC; 1: add CRC-16/MODBUS ; 2: set the AT+DATACUT value.
866 -* LL: The length of AT+COMMAND or AT+DATACUT command
884 +* NN:  0: no CRC; 1: add CRC-16/MODBUS ; 2: set the AT+DATACUT value.
885 +* LL:  The length of AT+COMMAND or AT+DATACUT command
867 867  * XX XX XX XX: AT+COMMAND or AT+DATACUT command
868 -* YY: If YY=0, RS485-BL will execute the downlink command without uplink; if YY=1, RS485-BL will execute an uplink after got this command.
887 +* YY:  If YY=0, RS485-BL will execute the downlink command without uplink; if YY=1, RS485-BL will execute an uplink after got this command.
869 869  
870 -Example:
889 +**Example:**
871 871  
872 -**AF 03 01 06 0A 05 00 04 00 01 00**: Same as AT+COMMAND3=0A 05 00 04 00 01,1
891 +(% style="color:#037691" %)**AF 03 01 06 0A 05 00 04 00 01 00**(%%): Same as AT+COMMAND3=0A 05 00 04 00 01,1
873 873  
874 -**AF 03 02 06 10 01 05 06 09 0A 00**: Same as AT+DATACUT3=**16**,**1**,**5+6+9+10**
893 +(% style="color:#037691" %)**AF 03 02 06**(% style="color:orange" %)** 10 **(% style="color:red" %)**01 **(% style="color:green" %)**05 06 09 0A**(% style="color:#037691" %)** 00**(%%): Same as AT+DATACUT3=(% style="color:orange" %)**16**(%%),(% style="color:red" %)**1**(%%),(% style="color:green" %)**5+6+9+10**
875 875  
876 -**AF 03 02 06 0B 02 05 07 08 0A 00**: Same as AT+DATACUT3=**11**,**2**,**5~~7+8~~10**
895 +(% style="color:#037691" %)**AF 03 02 06 **(% style="color:orange" %)**0B**(% style="color:red" %)** 02 **(% style="color:green" %)**05 07 08 0A **(% style="color:#037691" %)**00**(%%): Same as AT+DATACUT3=(% style="color:orange" %)**11**(%%),(% style="color:red" %)**2**(%%),(% style="color:green" %)**5~~7+8~~10**
877 877  
878 878  
879 -0xAB downlink command can be used for set AT+SEARCHx
898 +**0xAB** downlink command can be used for set AT+SEARCHx
880 880  
881 -Example: **AB aa 01 03 xx xx xx** (03 here means there are total 3 bytes after 03) So
900 +**Example:** **AB aa 01 03 xx xx xx** (03 here means there are total 3 bytes after 03) So
882 882  
883 883  * AB aa 01 03 xx xx xx  same as AT+SEARCHaa=1,xx xx xx
884 884  * AB aa 02 03 xx xx xx 02 yy yy(03 means there are 3 bytes after 03, they are xx xx xx;02 means there are 2 bytes after 02, they are yy yy) so the commands
... ... @@ -886,145 +886,164 @@
886 886  **AB aa 02 03 xx xx xx 02 yy yy**  same as **AT+SEARCHaa=2,xx xx xx+yy yy**
887 887  
888 888  
889 -==== Fast command to handle MODBUS device ====
890 890  
909 +==== **Fast command to handle MODBUS device** ====
910 +
891 891  AT+MBFUN is valid since v1.3 firmware version. The command is for fast configure to read Modbus devices. It is only valid for the devices which follow the [[MODBUS-RTU protocol>>url:https://www.modbustools.com/modbus.html]].
892 892  
893 893  This command is valid since v1.3 firmware version
894 894  
895 895  
896 -AT+MBFUN has only two value:
916 +**AT+MBFUN has only two value:**
897 897  
898 -* AT+MBFUN=1: Enable Modbus reading. And get response base on the MODBUS return
918 +* **AT+MBFUN=1**: Enable Modbus reading. And get response base on the MODBUS return
899 899  
900 900  AT+MBFUN=1, device can auto read the Modbus function code: 01, 02, 03 or 04. AT+MBFUN has lower priority vs AT+DATACUT command. If AT+DATACUT command is configured, AT+MBFUN will be ignore.
901 901  
902 -* AT+MBFUN=0: Disable Modbus fast reading.
922 +* **AT+MBFUN=0**: Disable Modbus fast reading.
903 903  
904 -Example:
924 +**Example:**
905 905  
906 906  * AT+MBFUN=1 and AT+DATACUT1/AT+DATACUT2 are not configure (0,0,0).
907 907  * AT+COMMAND1= 01 03 00 10 00 08,1 ~-~-> read slave address 01 , function code 03, start address 00 01, quantity of registers 00 08.
908 908  * AT+COMMAND2= 01 02 00 40 00 10,1 ~-~-> read slave address 01 , function code 02, start address 00 40, quantity of inputs 00 10.
909 909  
910 -[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image025.png]]
930 +[[image:1654133913295-597.png]]
911 911  
912 912  
913 -[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image026.png]]
933 +[[image:1654133954153-643.png]]
914 914  
915 915  
916 -* Downlink Commands:
936 +* **Downlink Commands:**
917 917  
918 -A9 aa -à Same as AT+MBFUN=aa
938 +**A9 aa** ~-~-> Same as AT+MBFUN=aa
919 919  
920 920  
921 -==== RS485 command timeout ====
922 922  
942 +==== **RS485 command timeout** ====
943 +
923 923  Some Modbus device has slow action to send replies. This command is used to configure the RS485-BL to use longer time to wait for their action.
924 924  
925 925  Default value: 0, range:  0 ~~ 5 seconds
926 926  
927 927  
928 -* AT Command:
949 +* **AT Command:**
929 929  
930 -AT+CMDDLaa=hex(bb cc)
951 +(% class="box infomessage" %)
952 +(((
953 +**AT+CMDDLaa=hex(bb cc)**
954 +)))
931 931  
932 -Example:
956 +**Example:**
933 933  
934 934  **AT+CMDDL1=1000** to send the open time to 1000ms
935 935  
936 936  
937 -* Downlink Payload:
961 +* **Downlink Payload:**
938 938  
939 939  0x AA aa bb cc
940 940  
941 941  Same as: AT+CMDDLaa=hex(bb cc)
942 942  
943 - Example:
967 + **Example:**
944 944  
945 - 0xAA 01 03 E8  à Same as **AT+CMDDL1=1000 ms**
969 + **0xAA 01 03 E8**  ~-~-> Same as **AT+CMDDL1=1000 ms**
946 946  
947 947  
948 -==== [[Uplink>>path:#downlink_A8]] payload mode ====
949 949  
973 +==== **Uplink payload mode** ====
974 +
950 950  Define to use one uplink or multiple uplinks for the sampling.
951 951  
952 -The use of this command please see: [[Compose Uplink payload>>path:#DataUP]]
977 +The use of this command please see: [[Compose Uplink payload>>||anchor="H3.3.4Composetheuplinkpayload"]]
953 953  
954 -* AT Command:
979 +* **AT Command:**
955 955  
956 -AT+DATAUP=0
981 +(% class="box infomessage" %)
982 +(((
983 +**AT+DATAUP=0**
984 +)))
957 957  
958 -AT+DATAUP=1
986 +(% class="box infomessage" %)
987 +(((
988 +**AT+DATAUP=1**
989 +)))
959 959  
960 960  
961 -* Downlink Payload:
992 +* **Downlink Payload:**
962 962  
963 -0xAD 00   à Same as AT+DATAUP=0
994 +**0xAD 00**  **~-~->** Same as AT+DATAUP=0
964 964  
965 -0xAD 01   à Same as AT+DATAUP=1
996 +**0xAD 01**  **~-~->** Same as AT+DATAUP=1
966 966  
967 967  
968 -==== Manually trigger an Uplink ====
969 969  
1000 +==== **Manually trigger an Uplink** ====
1001 +
970 970  Ask device to send an uplink immediately.
971 971  
972 -* Downlink Payload:
1004 +* **Downlink Payload:**
973 973  
974 -0x08 FF, RS485-BL will immediately send an uplink.
1006 +**0x08 FF**, RS485-BL will immediately send an uplink.
975 975  
976 976  
977 -==== Clear RS485 Command ====
978 978  
1010 +==== **Clear RS485 Command** ====
1011 +
979 979  The AT+COMMANDx and AT+DATACUTx settings are stored in special location, user can use below command to clear them.
980 980  
981 981  
982 -* AT Command:
1015 +* **AT Command:**
983 983  
984 -**AT+CMDEAR=mm,nn**   mm: start position of erase ,nn: stop position of erase
1017 +(% style="color:#037691" %)**AT+CMDEAR=mm,nn** (%%) mm: start position of erase ,nn: stop position of erase Etc. AT+CMDEAR=1,10 means erase AT+COMMAND1/AT+DATACUT1 to AT+COMMAND10/AT+DATACUT10
985 985  
986 -Etc. AT+CMDEAR=1,10 means erase AT+COMMAND1/AT+DATACUT1 to AT+COMMAND10/AT+DATACUT10
987 -
988 988  Example screen shot after clear all RS485 commands. 
989 989  
990 990  
991 -
992 992  The uplink screen shot is:
993 993  
994 -[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image023.png]]
1024 +[[image:1654134704555-320.png]]
995 995  
996 996  
997 -* Downlink Payload:
1027 +* **Downlink Payload:**
998 998  
999 -0x09 aa bb same as AT+CMDEAR=aa,bb
1029 +**0x09 aa bb** same as AT+CMDEAR=aa,bb
1000 1000  
1001 1001  
1002 -==== Set Serial Communication Parameters ====
1003 1003  
1033 +==== **Set Serial Communication Parameters** ====
1034 +
1004 1004  Set the Rs485 serial communication parameters:
1005 1005  
1006 -* AT Command:
1037 +* **AT Command:**
1007 1007  
1008 1008  Set Baud Rate:
1009 1009  
1010 -AT+BAUDR=9600    ~/~/ Options: (1200,2400,4800,14400,19200,115200)
1041 +(% class="box infomessage" %)
1042 +(((
1043 +**AT+BAUDR=9600**    ~/~/ Options: (1200,2400,4800,14400,19200,115200)
1044 +)))
1011 1011  
1046 +Set UART Parity
1012 1012  
1013 -Set UART parity
1048 +(% class="box infomessage" %)
1049 +(((
1050 +**AT+PARITY=0**    ~/~/ Option: 0: no parity, 1: odd parity, 2: even parity
1051 +)))
1014 1014  
1015 -AT+PARITY=0    ~/~/ Option: 0: no parity, 1: odd parity, 2: even parity
1016 -
1017 -
1018 1018  Set STOPBIT
1019 1019  
1020 -AT+STOPBIT=0    ~/~/ Option: 0 for 1bit; 1 for 1.5 bit ; 2 for 2 bits
1055 +(% class="box infomessage" %)
1056 +(((
1057 +**AT+STOPBIT=0**    ~/~/ Option: 0 for 1bit; 1 for 1.5 bit ; 2 for 2 bits
1058 +)))
1021 1021  
1022 1022  
1023 -* Downlink Payload:
1061 +* **Downlink Payload:**
1024 1024  
1025 -A7 01 aa bb: Same  AT+BAUDR=hex(aa bb)*100
1063 +**A7 01 aa bb**: Same  AT+BAUDR=hex(aa bb)*100
1026 1026  
1027 -Example:
1065 +**Example:**
1028 1028  
1029 1029  * A7 01 00 60   same as AT+BAUDR=9600
1030 1030  * A7 01 04 80  same as AT+BAUDR=115200
... ... @@ -1034,8 +1034,9 @@
1034 1034  A7 03 aa: Same as  AT+STOPBIT=aa  (aa value: 00 , 01 or 02)
1035 1035  
1036 1036  
1037 -==== Control output power duration ====
1038 1038  
1076 +==== **Control output power duration** ====
1077 +
1039 1039  User can set the output power duration before each sampling.
1040 1040  
1041 1041  * AT Command:
1654133913295-597.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +116.2 KB
Content
1654133954153-643.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +91.2 KB
Content
1654134704555-320.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +91.4 KB
Content