Changes for page 01 Lua Functions
Last modified by Theodore Xu on 2023/10/26 10:51
Summary
-
Page properties (3 modified, 0 added, 0 removed)
Details
- Page properties
-
- Parent
-
... ... @@ -1,1 +1,1 @@ 1 -V-BOX.V-Net. 1\.UserManual.04 Lua Script.WebHome1 +V-BOX.V-Net.Manual.04 Lua Script.WebHome - Author
-
... ... @@ -1,1 +1,1 @@ 1 -XWiki. Stone1 +XWiki.Hunter - Content
-
... ... @@ -140,7 +140,7 @@ 140 140 141 141 Table 2-1 142 142 143 -(% class="box errormessage" %)143 +(% class="box infomessage" %) 144 144 ((( 145 145 **✎Note: **If HLword enters any other value, it will be treated as invalid. 146 146 ))) ... ... @@ -608,11 +608,12 @@ 608 608 Attempting to use a script to open a serial port in an unsupported mode will result in an error directly, as below. 609 609 610 610 |((( 611 +{{code language="LUA"}} 611 611 local setup = { 612 612 613 613 name = "COM2", 614 614 615 -mode = 422, ~-~- COM2 does not support RS422616 +mode = 422, -- COM2 does not support RS422 616 616 617 617 ... 618 618 ... ... @@ -619,6 +619,7 @@ 619 619 } 620 620 621 621 serial.open(setup) 623 +{{/code}} 622 622 ))) 623 623 624 624 **Data bit:** ... ... @@ -1063,8 +1063,9 @@ 1063 1063 1064 1064 If there is no custom configuration, return an empty table, otherwise, return with "field name/field content" 1065 1065 1066 - E.g:1068 +**For example:** 1067 1067 1070 +{{code language="LUA"}} 1068 1068 { 1069 1069 1070 1070 [1]= {[1]=1234, [2]=1, [3]='temp', [4]='23.5', [5]={"fruit"="apple"}}, ... ... @@ -1077,7 +1077,8 @@ 1077 1077 1078 1078 } 1079 1079 1080 -Failed: //table// empty table 1083 +Failed: table empty table 1084 +{{/code}} 1081 1081 1082 1082 ((( 1083 1083 == **bns_get_config(string from)** == ... ... @@ -1157,13 +1157,15 @@ 1157 1157 1158 1158 Type (1: switch, 2: number, 3: string) 1159 1159 1160 -E.g: 1161 - { 1164 +**For example:** 1162 1162 1163 -[1]={~-~-The first communication port 1166 +{{code language="LUA"}} 1167 +{ 1164 1164 1165 -[1]={ ~-~-monitoring point array of the first communication port1169 +[1]={--The first communication port 1166 1166 1171 +[1]={--monitoring point array of the first communication port 1172 + 1167 1167 [1]={[1]=11,[2]='data1',[3]=3,[4]=2}, 1168 1168 1169 1169 [2]={[1]=12,[2]='data2',[3]=3,[4]=2}, ... ... @@ -1170,23 +1170,23 @@ 1170 1170 1171 1171 ... 1172 1172 1173 -[n]={[1]=xx,[2]='datan',[3]=x,[4]=x}, ~-~-n monitoring points1179 +[n]={[1]=xx,[2]='datan',[3]=x,[4]=x},--n monitoring points 1174 1174 1175 1175 }, 1176 1176 1177 -[2]=14, ~-~-ID1183 +[2]=14, --ID 1178 1178 1179 -[3]='Modbus TCP' ~-~-n monitoring points1185 +[3]='Modbus TCP' --n monitoring points 1180 1180 1181 1181 }, 1182 1182 1183 -[2]={ ~-~-The second communication port1189 +[2]={--The second communication port 1184 1184 1185 -[1]={}, ~-~-The monitoring point of the second communication port is not configured and is empty1191 +[1]={},--The monitoring point of the second communication port is not configured and is empty 1186 1186 1187 -[2]=15, ~-~-ID1193 +[2]=15, --ID 1188 1188 1189 -[3]='WECON' ~-~-communication protocol name1195 +[3]='WECON' --communication protocol name 1190 1190 1191 1191 }, 1192 1192 ... ... @@ -1193,6 +1193,7 @@ 1193 1193 ...n communication ports and so on 1194 1194 1195 1195 } 1202 +{{/code}} 1196 1196 1197 1197 Failed~:// table// empty table 1198 1198 ... ... @@ -1272,8 +1272,9 @@ 1272 1272 1273 1273 Succeed: //table// one-dimensional array 1274 1274 1275 - E.g:1282 +**For example:** 1276 1276 1284 +{{code language="LUA"}} 1277 1277 { 1278 1278 1279 1279 [1]="This is the oldest message", - the first is the oldest message ... ... @@ -1285,6 +1285,7 @@ 1285 1285 [n]="This is the latest message", - the last is the latest message 1286 1286 1287 1287 } 1296 +{{/code}} 1288 1288 1289 1289 Failede: nil 1290 1290 ... ... @@ -1302,7 +1302,7 @@ 1302 1302 1303 1303 == **https request** == 1304 1304 1305 - Example:1314 +**For example:** 1306 1306 1307 1307 {{code language="LUA"}} 1308 1308 local json = require("json") ... ... @@ -1358,7 +1358,7 @@ 1358 1358 1359 1359 **Access in bit mode, the prefix is @B_HDX, the number in front of "." indicates the number of the word, and the number behind is the bit number of the word.** 1360 1360 1361 -For example: @B_HDX1020.12, its meaning is to access the system data area in bit mode, the specific location is the 13th bit of the 1020th word. 1370 +**For example:** @B_HDX1020.12, its meaning is to access the system data area in bit mode, the specific location is the 13th bit of the 1020th word. 1362 1362 1363 1363 (% class="box infomessage" %) 1364 1364 ((( ... ... @@ -1380,7 +1380,7 @@ 1380 1380 1. Access in bit mode, the number range is: "@B_HDX0.0"-"@B_HDX299999.15". 1381 1381 1382 1382 ((( 1383 -== ** 8.2Special data area (HSW/HSX)** ==1392 +== **Special data area (HSW/HSX)** == 1384 1384 1385 1385 (% class="box infomessage" %) 1386 1386 ((( ... ... @@ -1498,6 +1498,14 @@ 1498 1498 ** addr_getstring("@W_HSW191",17) 1499 1499 * Obtaining ICCID (read only) 1500 1500 ** addr_getstring("@W_HSW225",15) 1510 +* ((( 1511 +TSAP settings of Siemens LOGO PLC* ((( 1512 +addr_setword("@W_0#HSW1200",8192) means set the Local TSAP as 20.00 1513 +))) 1514 +* ((( 1515 +addr_setword("@W_0#HSW1201",4096) means set the Remote TSAP as 10.00 1516 +))) 1517 +))) 1501 1501 1502 1502 ((( 1503 1503 == **Power-down storage area (HAW/HAX)** == ... ... @@ -1534,7 +1534,7 @@ 1534 1534 Failed: multi 1535 1535 1536 1536 ((( 1537 -== ** 9.2send_sms_ucs2(string number, string message)** ==1554 +== **send_sms_ucs2(string number, string message)** == 1538 1538 ))) 1539 1539 1540 1540 **Function:** ... ... @@ -1683,7 +1683,7 @@ 1683 1683 * number [prarm.refin]: whether each byte of the data to be measured is inverted by bit, true or false. 1684 1684 * number [prarm.refout]: after the calculation or before the heterodyning output, whether the whole data is inverted by bit, true or false. 1685 1685 1686 -Return: 1703 +**Return:** 1687 1687 1688 1688 Success: crc object 1689 1689 ... ... @@ -1742,7 +1742,7 @@ 1742 1742 Failed: multi, error code 1743 1743 ))) 1744 1744 1745 - Example:1762 +**For example:** 1746 1746 1747 1747 {{code language="LUA"}} 1748 1748 function crcTest.main() ... ... @@ -1804,8 +1804,9 @@ 1804 1804 ** 2: timeout 1805 1805 * Customization returns an empty table if there is no configuration, otherwise returns "field name/field content" 1806 1806 1807 -For example: 1824 +**For example:** 1808 1808 1826 +{{code language="LUA"}} 1809 1809 { 1810 1810 1811 1811 [1]= {[1]=1234, [2]=1, [3]='temp', [4]='23.5'}, ... ... @@ -1819,6 +1819,7 @@ 1819 1819 } 1820 1820 1821 1821 Failed: table, empty table 1840 +{{/code}} 1822 1822 1823 1823 == **normal_setdata_byname(string name, string data)** == 1824 1824 ... ... @@ -1834,11 +1834,10 @@ 1834 1834 1835 1835 Succeed: string: The value of the monitor point before it is written 1836 1836 1837 -Failed: mil1856 +Failed: nil 1838 1838 1839 1839 == **normal_getdata_byname(string name)** == 1840 1840 1841 - 1842 1842 **Function:** Read the data of the monitoring point name 1843 1843 1844 1844 **Parameter:** ... ... @@ -1849,10 +1849,262 @@ 1849 1849 1850 1850 Succeed: string 1851 1851 1852 -Failed: mil1870 +Failed: nil 1853 1853 1854 1854 = **11 MySQL database operation** = 1855 1855 1856 1856 == **luaMySql.init(string sourcename, string username, string password, string host, number port, string character)** == 1857 1857 1858 - 1876 +**Function:** Configure database connection parameters 1877 + 1878 +**Parameter:** 1879 + 1880 +sourcename: the name of database 1881 + 1882 +username: the username of the connection 1883 + 1884 +password: the password of the connection 1885 + 1886 +host: the host name of the connection 1887 + 1888 +port: the host port of the connection 1889 + 1890 +character: the character set of the connection 1891 + 1892 +**Return:** 1893 + 1894 +Succeed: string 1895 + 1896 +Failed: multi 1897 + 1898 +== **luaMySql.exec(string statement)** == 1899 + 1900 +**Function:** Execute the given SQL statement without returning the result set (add, delete, change) 1901 + 1902 +**Parameter:** 1903 + 1904 +statement: the given SQL statement 1905 + 1906 +**Return:** 1907 + 1908 +Succeed: status: returns the number of rows affected by SQL statement execution. 1909 + 1910 +Failed: nil, errorString 1911 + 1912 +== **luaMySql.execWithResult(string statement)** == 1913 + 1914 +**Function:** Execute the given SQL statement returning the result set (check) 1915 + 1916 +**Parameter:** 1917 + 1918 +statement: the given SQL statement 1919 + 1920 +**Return:** 1921 + 1922 +Succeed: table: returns the result set 1923 + 1924 +Failed: nil, errorString 1925 + 1926 +**For example:** 1927 + 1928 +{{code language="LUA"}} 1929 +mysql = require"mysqlclient" 1930 + 1931 +function DataInitRight() 1932 + 1933 +local dbName = "db_lua1" 1934 + 1935 +local user = "root" 1936 + 1937 +local pwd = "123456" 1938 + 1939 +local host = "192.168.56.186" 1940 + 1941 +local port = 3306 1942 +local character = "UTF8" 1943 + 1944 +mysql.init(dbName, user, pwd, host, port, character) 1945 + 1946 +end 1947 + 1948 +function ExecFunc() 1949 + 1950 +status, errorString = mysql.exec("delete from tb_lua1 where mykey = 1951 + 1952 +10;") 1953 + 1954 +if nil == status then 1955 + 1956 +print("ExecFunc() error:", errorString) 1957 + 1958 +return -1 1959 + 1960 +else 1961 + 1962 +print("the number of rows affected by the command:", status) 1963 + 1964 +end 1965 + 1966 +return 0 1967 + 1968 +end 1969 + 1970 +function ExecWithResultFunc() 1971 + 1972 +status, errorString = mysql.execWithResult("select * from tb_lua1;") 1973 + 1974 +if nil == status then 1975 + 1976 +print("ExecWithResultFunc() error:", errorString) 1977 + 1978 +return -1 1979 + 1980 +else 1981 + 1982 +print("ExecWithResultFunc() 1983 + 1984 +success 1985 + 1986 +: status 1987 + 1988 +type 1989 + 1990 += 1991 + 1992 +", 1993 + 1994 +type(status)) 1995 + 1996 +print("ExecWithResultFunc() success : status len = ", #status) 1997 + 1998 +local num = #status 1999 + 2000 +local i = 1 2001 + 2002 +if num > 0 then 2003 + 2004 +for i = 1, num, 1 do 2005 + 2006 +local var = string.format("select result[%d] :mykey = %d, 2007 + 2008 +value = %s", i, status[i].mykey, status[i].value) 2009 + 2010 +print(var) 2011 + 2012 +end 2013 + 2014 +end 2015 + 2016 +print("---------------") 2017 + 2018 +end 2019 + 2020 +return 0 2021 +end 2022 + 2023 +function luaMysql_apiTest.main() 2024 + 2025 +print("script running ...") 2026 + 2027 +DataInitRight() 2028 + 2029 +--use exec demo 2030 + 2031 +if ExecFunc() < 0 then 2032 + 2033 +return 2034 + 2035 +end 2036 + 2037 +--use execWithResult demo 2038 + 2039 +if ExecWithResultFunc() < 0 then 2040 + 2041 +return 2042 + 2043 +end 2044 + 2045 +print("script running success") 2046 + 2047 +end 2048 +{{/code}} 2049 + 2050 += **12 Message summary algorithm** = 2051 + 2052 +== **hmac(string hash_func, string key, string message)** == 2053 + 2054 +**Function:** HMAC calculate 2055 + 2056 +**Function name** 2057 + 2058 +hash_func: 2059 + 2060 +* [md5, sha1, sha224, sha256, sha384, sha512] 2061 +* [sha512_224, sha512_256, sha3_224, sha3_256] 2062 +* [sha3_384, sha3_512] 2063 + 2064 +**Parameter:** 2065 + 2066 +key: the key 2067 + 2068 +message: message content 2069 + 2070 +**Return:** 2071 + 2072 +Succeed: string, calculation result 2073 + 2074 +Failed: nil 2075 + 2076 +**For example:** 2077 + 2078 +{{code language="LUA"}} 2079 +local sha = require"sha2" 2080 + 2081 +function hmac_test.main() 2082 + 2083 +local hmac = sha.hmac 2084 + 2085 +print(hmac(sha.sha1, 2086 + 2087 +"your key", "your message")) 2088 + 2089 +end 2090 +{{/code}} 2091 + 2092 +== **sha(string message** == 2093 + 2094 +**Function:** SHA calculate 2095 + 2096 +**Function name:** 2097 + 2098 +sha: 2099 + 2100 +* sha1, sha224, sha256, sha384, sha512] 2101 +* [sha512_224, sha512_256, sha3_224, sha3_256] 2102 +* [sha3_384, sha3_512] 2103 + 2104 +**Parameter:** 2105 + 2106 +key: the key 2107 + 2108 +message: message content 2109 + 2110 +**Return:** 2111 + 2112 +Succeed: string, calculation result 2113 + 2114 +Failed: nil 2115 + 2116 +For example: 2117 + 2118 +{{code language="LUA"}} 2119 +local sha = require"sha2" 2120 + 2121 +function sha_test.main() 2122 + 2123 +local sha256 = sha.sha256 2124 + 2125 +print(sha256("your message")) 2126 + 2127 +end 2128 +{{/code}}