Changes for page 01 Lua Functions

Last modified by Theodore Xu on 2023/10/26 10:51

From version 5.20
edited by Stone Wu
on 2022/07/12 10:05
Change comment: (Autosaved)
To version 5.36
edited by Stone Wu
on 2022/07/12 11:03
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -1689,105 +1689,359 @@
1689 1689  
1690 1690  Failure: multi, error code
1691 1691  
1692 -
1693 1693  (((
1694 -== **set_network(table config)** ==
1693 +|=Parameter model name|=poly|=init|=xorout|=refin|=refout
1694 +|crc8|0x07|0x00|0x00|false|false
1695 +|crc8_cdma2000|0x9B|0xFF|0x00|false|false
1696 +|crc8_darc|0x39|0x00|0x00|true|true
1697 +|crc8_dvb_s2|0xD5|0x00|0x00|false|false
1698 +|crc8_ebu|0x1D|0xFF|0x00|true|true
1699 +|crc8_i_code|0x1D|0xFD|0x00|false|false
1700 +|crc8_itu|0x07|0x00|0x55|false|false
1701 +|crc8_maxim|0x31|0x00|0x00|true|true
1702 +|crc8_rohc|0x07|0xFF|0x00|true|true
1703 +|crc8_wcdma|0x9B|0x00|0x00|true|true
1704 +|crc8_sae_j1850|0x1D|0xFF|0xFF|false|false
1705 +|crc8_opensafety|0x2F|0x00|0x00|false|false
1706 +|crc16_tms37157|0x1021|0x3791|0x0000|true|true
1707 +|crc16_a|0x1021|0x6363|0x0000|true|true
1708 +|crc16_riello|0x1021|0x554D|0x0000|true|true
1709 +|crc16_ccitt_false|0x1021|0xFFFF|0x0000|false|false
1710 +|crc16_arc|0x8005|0x0000|0x0000|true|true
1711 +|crc16_arc_ccitt|0x1021|0x1D0F|0x0000|false|false
1712 +|crc16_buypass|0x8005|0x0000|0x0000|false|false
1713 +|crc16_cdma2000|0xC867|0xFFFF|0x0000|false|false
1714 +|crc16_dds110|0x8005|0x800D|0x0000|false|false
1715 +|crc16_dect_r|0x0589|0x0000|0x0001|false|false
1716 +|crc16_dect_x|0x0589|0x0000|0x0000|false|false
1717 +|crc16_dnp|0x3D65|0x0000|0xFFFF|true|true
1718 +|crc16_en_13757|0x3D65|0x0000|0xFFFF|false|false
1719 +|crc16_genibus|0x1021|0xFFFF|0xFFFF|false|false
1720 +|crc16_maxim|0x8005|0x0000|0xFFFF|true|true
1721 +|crc16_mcrf4xx|0x1021|0xFFFF|0x0000|true|true
1722 +|crc16_t10_dif|0x8BB7|0x0000|0x0000|false|false
1723 +|crc16_teledisk|0xA097|0x0000|0x0000|false|false
1724 +|crc16_usb|0x8005|0xFFFF|0xFFFF|true|true
1725 +|crc16_kermit|0x1021|0x0000|0x0000|true|true
1726 +
1727 +(% class="wikigeneratedid" %)
1728 +Table 9-1
1729 +
1730 +== **crc:calc(string crcValue)** ==
1731 +
1732 +**Function:** Calculate CRC result
1733 +
1734 +**Parameter:**
1735 +
1736 +crcValue: the value to be calculated
1737 +
1738 +**Return:**
1739 +
1740 +Succeed: calculated result
1741 +
1742 +Failed: multi, error code
1695 1695  )))
1696 1696  
1697 -**Function:** Set V-BOX network, take effect after restart
1745 +Example:
1698 1698  
1699 -**parameter:**
1747 +{{code language="LUA"}}
1748 +function crcTest.main()
1700 1700  
1701 -//config~:// incoming network configuration table
1750 +local param = {
1702 1702  
1703 -1. connectMode: the way V-BOX connects to the server, 0: Ethernet, 1: WIFI, 2: 4G, 3: 2G, it is not allowed to be empty.
1704 -1. ethernetEnable: Whether to enable Ethernet, 1: enable, 0: disable, and it is not allowed to be empty.
1705 -1. ethernetLanIp: Set the LAN IP address. Only V-BOX with three network ports support this configuration, and other models of V-BOX do not support setting LAN IP. This item is allowed to be empty.
1706 -1. ethernetIpMode: Whether to enable Ethernet static IP, 1: Enable static IP, 0: DHCP, not allowed to be empty.
1707 -1. ethernetIp: The IP address needs to be configured when the Ethernet static IP is used, and it is not allowed to be empty.
1708 -1. ethernetNetmask: The subnet mask needs to be configured when Ethernet static IP is used, and it is not allowed to be empty.
1709 -1. ethernetGateway: The gateway can be configured when Ethernet static IP is used.
1752 +name = '',
1710 1710  
1711 -1. When using the Ethernet network, if the Gateway is empty, V-BOX will not connect to the server.
1712 -1. If you only use Ethernet to directly connect to the PLC for communication, you do not need to configure a gateway.
1754 +width = 64,
1713 1713  
1714 -1. ethernetFirstDns: You can configure the preferred DNS server when the Ethernet static IP is used, and it is allowed to be empty. If you use the Ethernet network and do not fill in the DNS server, V-BOX will not be connected to the server.
1715 -1. ethernetSpareDns: Alternate DNS server can be configured when the Ethernet static IP is used, and it is allowed to be empty.
1716 -1. wifiEnable: Whether to enable WIFI, 1: enable, 0: disable, it is not allowed to be empty. If it is a model that does not include WIFI, directly disable it.
1717 -1. wifiName: WIFI name, if WIFI is enabled, it is not allowed to be empty.
1718 -1. wifiPassword: WIFI password, it is allowed to be empty.
1719 -1. wifiIpMode: Whether to enable WIFI static IP, 1: Enable static IP, 0: DHCP, not allowed to be empty.
1720 -1. wifiIp: IP address needs to be configured when WIFI static IP is used, it is not allowed to be empty.
1721 -1. wifiNetmask: The subnet mask needs to be configured when WIFI static IP is used, and it is not allowed to be empty.
1722 -1. wifiGateway: The gateway can be configured when WIFI static IP is used, and it is not allowed to be empty.
1723 -1. wifiFirstDns: You can configure the preferred DNS server when the WIFI static IP is used, and it is allowed to be empty. If you use the WIFI network and do not fill in the DNS server, V-BOX will not be connected to the server.
1724 -1. wifiSpareDns: Alternate DNS server can be configured when the WIFI static IP is used, and it is allowed to be empty.
1725 -1. mobileEnable: Whether to enable the mobile network, 1: enable, 0: disable, it is not allowed to be empty, if it does not include 4G models, directly disable it.
1726 -1. mobileApnMode: Whether to manually configure the APN, 0: Use the default APN, 1: Manually configure the APN, it is not allowed to be empty.
1727 -1. apnName: APN name, if you choose to manually configure APN, it is not allowed to be empty.
1728 -1. apnPassword: APN username, it is allowed to be empty.
1729 -1. apnUserName: APN number, it is allowed to be empty.
1730 -1. apnNumber: APN number, it is allowed to be empty.
1756 +poly = 0x42F0E1EBA9EA3693,
1731 1731  
1758 +init = 0xFFFFFFFFFFFFFFFF,
1759 +
1760 +xorout = 0xFFFFFFFFFFFFFFFF,
1761 +
1762 +refin = 1,
1763 +
1764 +refout = 1
1765 +
1766 +}
1767 +
1768 +crc64,err = crc.init(param)
1769 +
1770 +if not crc64 then
1771 +
1772 +print("Crc init failed:", err)
1773 +else
1774 +
1775 +crcvalue = crc64:calc("123456789")
1776 +
1777 +print(string.format("crc64 calc :0X%16X", crcvalue))
1778 +
1779 +end
1780 +
1781 +end
1782 +{{/code}}
1783 +
1784 += **10 Special function for V-NET** =
1785 +
1786 +== **normal_get_alldata()** ==
1787 +
1788 +**Function: **Obtain the data of all the monitoring points
1789 +
1790 +**Parameter: None**
1791 +
1732 1732  **Return:**
1733 1733  
1734 -Succeed: true
1794 +Succeed: table two-dimensional arrays, as follows:
1735 1735  
1736 -Faied: multi
1796 +* Each item is a monitoring point and contains 4 attributes:
1797 +** 1: ID
1798 +** 2: status
1799 +** 3: tag name
1800 +** 4: value
1801 +* Status contains 3 enumerated values
1802 +** 0: offline
1803 +** 1: online
1804 +** 2: timeout
1805 +* Customization returns an empty table if there is no configuration, otherwise returns "field name/field content"
1737 1737  
1738 -(((
1739 -== **9.7 remote_com_start(string config)** ==
1740 -)))
1807 +For example:
1741 1741  
1742 -**Function:**
1809 +{
1743 1743  
1744 -start serial port pass-through
1811 +[1]= {[1]=1234, [2]=1, [3]='temp', [4]='23.5'},
1745 1745  
1813 +[2]= {[1]=1235, [2]=1, [3]='humi', [4]='67'},
1814 +
1815 +...
1816 +
1817 +[n]= {[1]=xxxx, [2]=x, [3]='xxxx', [4]='xx.x'},
1818 +
1819 +}
1820 +
1821 +Failed: table, empty table
1822 +
1823 +== **normal_setdata_byname(string name, string data)** ==
1824 +
1825 +**Function:** Write data to the monitoring point name
1826 +
1746 1746  **Parameter:**
1747 1747  
1748 -//config: //incoming serial port parameter configuration, JSON format
1829 +name: the name of monitoring point
1749 1749  
1750 -1. type:0, serial port pass-through
1751 -1. port: serial port number marked on the V-BOX
1752 -1. comtype:0-RS232, 1-RS485, 2-RS422
1753 -1. baudrate: Baud Rate
1754 -1. data_length: Data Bits
1755 -1. stop_bit: Stop Bit
1756 -1. check_bit: Check Bit
1831 +data: the data to be written
1757 1757  
1758 1758  **Return:**
1759 1759  
1760 -Succeed: true
1835 +Succeed: string: The value of the monitor point before it is written
1761 1761  
1762 -Failed: multi
1837 +Failed: mil
1763 1763  
1764 -(((
1765 -== **9.8 remote_com_stop()** ==
1766 -)))
1839 +== **normal_getdata_byname(string name)** ==
1767 1767  
1768 -**Function:**
1769 1769  
1770 -close serial port pass-through
1771 1771  
1843 +**Function:** Read the data of the monitoring point name
1844 +
1845 +**Parameter:**
1846 +
1847 +name: the name of monitoring point
1848 +
1772 1772  **Return:**
1773 1773  
1774 -Succeed: true
1851 +Succeed: string
1775 1775  
1853 +Failed: mil
1854 +
1855 += **11 MySQL database operation** =
1856 +
1857 +== **luaMySql.init(string sourcename, string username, string password, string host, number port, string character)** ==
1858 +
1859 +**Function:** Configure database connection parameters
1860 +
1861 +**Parameter:**
1862 +
1863 +sourcename: the name of database
1864 +
1865 +username: the username of the connection
1866 +
1867 +password: the password of the connection
1868 +
1869 +host: the host name of the connection
1870 +
1871 +port: the host port of the connection
1872 +
1873 +character: the character set of the connection
1874 +
1875 +**Return:**
1876 +
1877 +Succeed: string
1878 +
1776 1776  Failed: multi
1777 1777  
1778 -(((
1779 -== **9.9 remote_com_state()** ==
1780 -)))
1881 +== **luaMySql.exec(string statement)** ==
1781 1781  
1782 -**Function:**
1883 +**Function:** Execute the given SQL statement without returning the result set (add, delete, change)
1783 1783  
1784 -query the serial port pass-through status and pass-through server domain name and port
1885 +**Parameter:**
1785 1785  
1887 +statement: the given SQL statement
1888 +
1786 1786  **Return:**
1787 1787  
1788 -Succeed:
1891 +Succeed: status: returns the number of rows affected by SQL statement execution.
1789 1789  
1790 -1. number, current pass-through status: 0-none 1,2-starting pass-through 3-penetrating 4,5-finishing pass-through 6-pass-through error
1791 -1. string, pass-through server domain name and port number, xxxx (domain name): xxx (port number)
1893 +Failed: mil, errorString
1792 1792  
1793 -Failed: multi
1895 +== **luaMySql.execWithResult(string statement)** ==
1896 +
1897 +**Function:** Execute the given SQL statement returning the result set (check)
1898 +
1899 +**Parameter:**
1900 +
1901 +statement: the given SQL statement
1902 +
1903 +**Return:**
1904 +
1905 +Succeed: table: returns the result set
1906 +
1907 +Failed: mil, errorString
1908 +
1909 +For example:
1910 +
1911 +{{code language="LUA"}}
1912 +mysql = require"mysqlclient"
1913 +
1914 +function DataInitRight()
1915 +
1916 +local dbName = "db_lua1"
1917 +
1918 +local user = "root"
1919 +
1920 +local pwd = "123456"
1921 +
1922 +local host = "192.168.56.186"
1923 +
1924 +local port = 3306
1925 +local character = "UTF8"
1926 +
1927 +mysql.init(dbName, user, pwd, host, port, character)
1928 +
1929 +end
1930 +
1931 +function ExecFunc()
1932 +
1933 +status, errorString = mysql.exec("delete from tb_lua1 where mykey =
1934 +
1935 +10;")
1936 +
1937 +if nil == status then
1938 +
1939 +print("ExecFunc() error:", errorString)
1940 +
1941 +return -1
1942 +
1943 +else
1944 +
1945 +print("the number of rows affected by the command:", status)
1946 +
1947 +end
1948 +
1949 +return 0
1950 +
1951 +end
1952 +
1953 +function ExecWithResultFunc()
1954 +
1955 +status, errorString = mysql.execWithResult("select * from tb_lua1;")
1956 +
1957 +if nil == status then
1958 +
1959 +print("ExecWithResultFunc() error:", errorString)
1960 +
1961 +return -1
1962 +
1963 +else
1964 +
1965 +print("ExecWithResultFunc()
1966 +
1967 +success
1968 +
1969 +: status
1970 +
1971 +type
1972 +
1973 +=
1974 +
1975 +",
1976 +
1977 +type(status))
1978 +
1979 +print("ExecWithResultFunc() success : status len = ", #status)
1980 +
1981 +local num = #status
1982 +
1983 +local i = 1
1984 +
1985 +if num > 0 then
1986 +
1987 +for i = 1, num, 1 do
1988 +
1989 +local var = string.format("select result[%d] :mykey = %d,
1990 +
1991 +value = %s", i, status[i].mykey, status[i].value)
1992 +
1993 +print(var)
1994 +
1995 +end
1996 +
1997 +end
1998 +
1999 +print("---------------")
2000 +
2001 +end
2002 +
2003 +return 0
2004 +end
2005 +
2006 +function luaMysql_apiTest.main()
2007 +
2008 +print("script running ...")
2009 +
2010 +DataInitRight()
2011 +
2012 +--use exec demo
2013 +
2014 +if ExecFunc() < 0 then
2015 +
2016 +return
2017 +
2018 +end
2019 +
2020 +--use execWithResult demo
2021 +
2022 +if ExecWithResultFunc() < 0 then
2023 +
2024 +return
2025 +
2026 +end
2027 +
2028 +print("script running success")
2029 +
2030 +end
2031 +{{/code}}
2032 +
2033 += **12 Message ssummary algorithm** =
2034 +
2035 +== **hmac(string hash_func, string key, string message)** ==
2036 +
2037 +**Function:** Execute the given SQL statement returning the result set (check)
2038 +
2039 +**Parameter:**
2040 +
2041 +statement: the given SQL statement
2042 +
2043 +**Return:**
2044 +
2045 +Succeed: table: returns the result set
2046 +
2047 +Failed: mil, errorString