Changes for page 01 Lua Functions

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

From 5.10 to 5.9 From 5.20 to 5.19

From version 5.19

edited by Stone Wu
on 2022/07/12 10:01

Change comment: There is no comment for this version

To version 5.10

edited by Stone Wu
on 2022/07/12 09:30

Change comment: (Autosaved)

Raw
Rendered

Summary

Page properties (1 modified, 0 added, 0 removed)

Details

Page properties

Content

@@ -958,17 +958,20 @@
  Parameter:
--* //Topic//, topic name
--* //Message//, content
++//Topic//, topic name
--**2."arrived" is published by publish, this function will be called after the publication arrives**
++//Message//, content
++**2.**"arrived" is published by publish, this function will be called after the publication arrives
++
  //Callback// prototype~:// function ()//
--Parameter: None
++Parameter:
--**3.This function will be called after the "offline" connection is lost**
++None
++**3.**This function will be called after the "offline" connection is lost
++
  //Callback// prototype~:// function (string cause)//
  Parameter:
@@ -982,13 +982,17 @@
  Failed: multi
  (((
--== **mqtt:setup_cfg()** ==
++== **4.11 mqtt:setup_cfg()** ==
  )))
--**Function:** Cloud mode interface, to obtain MQTT information configured by the cloud platform
++**Function:**
--**Parameters:** None
++Cloud mode interface, to obtain MQTT information configured by the cloud platform
++**Parameters:**
++
++None
++
  **Return:**
  //serverurl, clientid, conn, lwt, cart //(5 returns, respectively, server address, client ID, connection table, last word table, certificate table)
@@ -1006,27 +1006,39 @@
  Lua only has a table data structure, so all arrays and key-value objects of json will be returned as a table.
  (((
--== **json.encode( lua_object )** ==
++== **5.1 json.encode( lua_object )** ==
  )))
--**Function: **Convert lua data type to json string
++**Function:**
--**Parameters: **Lua data type (including boolean, number, string, table)
++Convert lua data type to json string
--**Return：** Json format string
++**Parameters:**
++Lua data type (including boolean, number, string, table)
++
++**Return：**
++
++Json format string
++
  (((
--== **json.decode(string json_string)** ==
++== **5.2 json.decode(string json_string)** ==
  )))
--**Function:** Convert json string to lua data type
++**Function:**
--**Parameters: **//json_string//, string of json data structure
++Convert json string to lua data type
--**Return: **Lua data type
++**Parameters:**
++//json_string//, string of json data structure
++
++**Return：**
++
++Lua data type
++
  (((
--== **json.null** ==
++== **5.3 json.null** ==
  )))
  **Function:**
@@ -1033,24 +1033,32 @@
  This method is used when assembling json data, which is equivalent to null in json. If the user directly uses json.null() to return the address of the function, it must be valid with the use of encode.
--**Parameters:** None
++**Parameters:**
--**Return: **None
++None
++**Return：**
++
++None
++
  = **6 Cloud mode** =
  The cloud interface is only used in cloud mode, and V-NET mode is not available.
  (((
--== **bns_get_alldata()** ==
++== **6.1 bns_get_alldata()** ==
  )))
--**Function:** Obtain all monitoring points (point table) data configured by the end user
++**Function:**
--**✎Note: **Assuming there are timing scripts A and B with a period of 1 second, if this function is called in script A, the data will not be obtained if called in script B
++Obtain all monitoring points (point table) data configured by the end user
--**Parameters:** None
++Note: Assuming there are timing scripts A and B with a period of 1 second, if this function is called in script A, the data will not be obtained if called in script B
++**Parameters:**
++
++None
++
  **Return:**
  Succeed: table two-dimensional array, the structure is as follows
@@ -1080,11 +1080,13 @@
  Failed: //table// empty table
  (((
--== **bns_get_config(string from)** ==
++== **6.2 bns_get_config(string from)** ==
  )))
--**Function:** Obtain custom configuration parameters with the specified from type
++**Function:**
++Obtain custom configuration parameters with the specified from type
++
  **parameter:**
  from type, there are the following two categories, the string must be all lowercase
@@ -1102,11 +1102,13 @@
  Failed~:// table// empty table
  (((
--== **bns_get_data(string name, string data)** ==
++== **6.3 bns_get_data(string name, string data)** ==
  )))
--**Function:**write data to the name of the monitoring point
++**Function:**
++write data to the name of the monitoring point
++
  **parameter:**
  //name //The name of the monitoring point
@@ -1120,7 +1120,7 @@
  Failed: nil
  (((
--== **bns_get_data(string name)** ==
++== **6.4 bns_get_data(string name)** ==
  )))
  **Function:**
@@ -1138,13 +1138,17 @@
  Failed: nil
  (((
--== **bns_get_datadesc()** ==
++== **6.5 bns_get_datadesc()** ==
  )))
--**Function: **Obtain all configured communication ports and monitoring point information
++**Function:**
--**Parameters:** None
++Obtain all configured communication ports and monitoring point information
++**Parameters:**
++
++None
++
  **Return:**
  Succeed: table three-dimensional array, the structure is as follows
@@ -1197,13 +1197,17 @@
  Failed~:// table// empty table
  (((
--== **bns_get_machineinfo()** ==
++== **6.6 bns_get_machineinfo()** ==
  )))
--**Function:** get machine information
++**Function:**
--**Parameters:** None
++get machine information
++**Parameters:**
++
++None
++
  **Return:**
  Succeed: 3 string type results (model, machine code, software version)
@@ -1211,11 +1211,13 @@
  Failed: nil
  (((
--== **bns_get_groupdata(string name)** ==
++== **6.7 bns_get_groupdata(string name)** ==
  )))
--**Function:** Get all monitoring point data under the specified group name
++**Function:**
++Get all monitoring point data under the specified group name
++
  **parameter:**
  //Name  // group name
@@ -1227,13 +1227,17 @@
  Failed: //table// empty table
  (((
--== **bns_get_groupdesc()** ==
++== **6.8 bns_get_groupdesc()** ==
  )))
--**Function:** Get all group information
++**Function:**
--**Parameters:** None
++Get all group information
++**Parameters:**
++
++None
++
  **Return:**
  Succeed: //table// two-dimensional array, the structure is as follows
@@ -1247,13 +1247,17 @@
  Failed: //table  // empty table
  (((
--== **bns_get_onecache(string msg)** ==
++== **6.9 bns_get_onecache(string msg)** ==
  )))
--**Function:** Save a message to the cache file, which can be stored after power failure. Store up to 2000 items, delete the old and save the new in a rolling manner when it is full.
++**Function:**
--**Parameters: **//msg// String
++Save a message to the cache file, which can be stored after power failure. Store up to 2000 items, delete the old and save the new in a rolling manner when it is full.
++**Parameters:**
++
++//msg// String
++
  **Return:**
  Succeed: true
@@ -1261,13 +1261,17 @@
  Failed: nil
  (((
--== **bns_get_allcache()** ==
++== **6.10 bns_get_allcache()** ==
  )))
--**Function:** Get all the cached content (once the internal cache file will be emptied)
++**Function:**
--**Parameters:** None
++Get all the cached content (once the internal cache file will be emptied)
++**Parameters:**
++
++None
++
  **Return:**
  Succeed: //table// one-dimensional array
@@ -1295,232 +1295,194 @@
  Network communication includes Http request interface, this document does not provide interface description, please refer to the online document for how to use it.
  (((
--== **http request** ==
++== **7.1 http request** ==
  )))
  [[http:~~/~~/w3.impa.br/~~~~diego/software/luasocket/http.html#request>>url:http://w3.impa.br/~~diego/software/luasocket/http.html#request]]
--== **https request** ==
++(((
++= **8 Internal register** =
++)))
--Example：
++The internal registers of the box are divided into bit addresses and word addresses, which can be accessed in two ways (taking HDW as an example):
--{{code language="LUA"}}
--local json = require("json")
++**~1. **Access by word, prefix @W_HDW,
--local https = require("https")
++For example: @W_HDW0 represents the first word of the system data area, @W_HDW1 represents the second word of the system data area.
--functions https_demo.main()
++**2. **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.
--local url = "https://XXXXXXXXXXXXXXXXXXXXXXXXXX"
++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.
--local body = {}
++**✎Note: **
--body["XXXXXX"] = "XXXXX"
++**~1. **The address in @B_HDX is taken from the word in @W_HDW, so pay special attention when using the address.
--body["XXXXXXX"] = "XXXXXXXXXXX"
++For example, @B_HDX1020.12 is to access the 13th bit of the 1020th word. The value of this bit is the same as the word obtained by @W_HDW001020. The 13th bit of this word is actually the same bit as @B_HDX1020.12.
--local bodyJson = json.encode(body)
++**2.**The address of the bit address @B_HDX has a decimal point, while the word address is an integer.
--local header = {}
++(((
++== **8.1 Data storage area（HDW/HDX）** ==
++)))
--header["content-type"] = "application/json"
++The system storage area (HDW) of the V-BOX is used to store temporary data:
--local result_table, code, headers, status = https.request(url,
++~1. Access by word, the number range is: "@W_HDW0"-"@W_HDW299999".
--bodyJson)
++2. Access in bit mode, the number range is: "@B_HDX0.0"-"@B_HDX299999.15".
--if code == 200 then
++(((
++== **8.2 Special data area (HSW/HSX)** ==
++)))
--print("https suc")
++**✎Note: **
--return true
++//HSW// is a system special register, so please refer to the system special register table during use. Do not use addresses that are not mentioned in the table, and use the addresses stated in the table with caution (example: restart ("@W_HSW0") Writing a value of 1 will cause V-BOX to restart).
--else
++//Without any conditions. Direct use ("@W_HSW0") will cause the V-BOX to restart continuously.// When using ("@W_HSW0") address, please add judgment conditions, such as: connection to MQTT fails, there is no network, the value of a PLC address meets the condition or counts to a certain value.
--print("https fail")
++1.The system data area (HSW) of the box is used for system special registers (system reserved). Use //addr_getword// to obtain the following register information:
--return nil
++(% class="table-bordered" %)
++|address|function|Read and write status: read only, write only, read and write
++|@W_HSW0|restart|read and write
++|@W_HSW1|Box time: year|read and write
++|@W_HSW2|Box time: month|read and write
++|@W_HSW3|Box time: day|read and write
++|@W_HSW4|Box time: hour|read and write
++|@W_HSW5|Box time: minute|read and write
++|@W_HSW6|Box time: second|read and write
++|@W_HSW7|Box time: week|read and write
++|@W_HSW8|Ethernet IP1|read only
++|@W_HSW9|Ethernet IP2|read only
++|@W_HSW10|Ethernet IP3|read only
++|@W_HSW11|Ethernet IP4|read only
++|@W_HSW12|Ethernet Mask 1|read only
++|@W_HSW13|Ethernet Mask 2|read only
++|@W_HSW14|Ethernet Mask 3|read only
++|@W_HSW15|Ethernet Mask 4|read only
++|@W_HSW16|Ethernet Gateway 1|read only
++|@W_HSW17|Ethernet Gateway 2|read only
++|@W_HSW18|Ethernet Gateway 3|read only
++|@W_HSW19|Ethernet Gateway 4|read only
++|@W_HSW21|Ethernet MAC1|read only
++|@W_HSW22|Ethernet MAC2|read only
++|@W_HSW23|Ethernet MAC3|read only
++|@W_HSW24|Ethernet MAC4|read only
++|@W_HSW25|Ethernet MAC3|read only
++|@W_HSW26|Ethernet MAC4|read only
++|@W_HSW128|WIFI IP1|read only
++|@W_HSW129|WIFI IP2|read only
++|@W_HSW130|WIFI IP3|read only
++|@W_HSW131|WIFI IP4|read only
++|@W_HSW132|WIFI Mask 1|read only
++|@W_HSW133|WIFI Mask 2|read only
++|@W_HSW134|WIFI Mask 3|read only
++|@W_HSW135|WIFI Mask 4|read only
++|@W_HSW136|WIFI Gateway 1|read only
++|@W_HSW137|WIFI Gateway 2|read only
++|@W_HSW138|WIFI Gateway 3|read only
++|@W_HSW139|WIFI Gateway 4|read only
++|@W_HSW140|WIFI MAC1|read only
++|@W_HSW141|WIFI MAC2|read only
++|@W_HSW142|WIFI MAC3|read only
++|@W_HSW143|WIFI MAC4|read only
++|@W_HSW144|WIFI MAC5|read only
++|@W_HSW145|WIFI MAC6|read only
++|@W_HSW146|WIFI Signal value|read only
++|@W_HSW148|4G IP1|read only
++|@W_HSW149|4G IP2|read only
++|@W_HSW150|4G IP3|read only
++|@W_HSW151|4G IP4|read only
++|@W_HSW152|4G Mask 1|read only
++|@W_HSW153|4G Mask 2|read only
++|@W_HSW154|4G Mask 3|read only
++|@W_HSW155|4G Mask 4|read only
++|@W_HSW156|4G Gateway 1|read only
++|@W_HSW157|4G Gateway 2|read only
++|@W_HSW158|4G Gateway 3|read only
++|@W_HSW159|4G Gateway 4|read only
++|@W_HSW160|4G MAC1|read only
++|@W_HSW161|4G MAC2|read only
++|@W_HSW162|4G MAC3|read only
++|@W_HSW163|4G MAC4|read only
++|@W_HSW164|4G MAC5|read only
++|@W_HSW165|4G MAC6|read only
++|@W_HSW166|4G Signal value|read only
--end
++2. Other
--end
--{{/code}}
++2.1 Access password: addr_getstring("@W_HSW27", 16)
--(((
--= **8 Internal register** =
--)))
++2.2 Machine code: addr_getstring("@W_HSW60", 64)
--The internal registers of the box are divided into bit addresses and word addresses, which can be accessed in two ways (taking HDW as an example):
++2.3 Positioning method (@W_HSW167): (read only)
--**Access by word, prefix @W_HDW.**
++~1. Latitude and longitude
--For example: @W_HDW0 represents the first word of the system data area, @W_HDW1 represents the second word of the system data area.
++Longitude: addr_getdouble("@W_HSW168") (read only)
--**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.**
++Latitude: addr_getdouble("@W_HSW172") (read only)
--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.
++2. Base station positioning
--(% class="box infomessage" %)
--(((
--**✎Note: **
++LAC: addr_getdword("@W_HSW168") (read only)
--* The address in @B_HDX is taken from the word in @W_HDW, so pay special attention when using the address.
--** For example, @B_HDX1020.12 is to access the 13th bit of the 1020th word. The value of this bit is the same as the word obtained by @W_HDW001020. The 13th bit of this word is actually the same bit as @B_HDX1020.12.
--* The address of the bit address @B_HDX has a decimal point, while the word address is an integer.
--)))
++CI: addr_getdword("@W_HSW172") (read only)
++2.4 Convert base station to latitude and longitude via API
--(((
--== **Data storage area（HDW/HDX）** ==
--)))
++Longitude: addr_getdouble("@W_HSW187") (read only)
--The system storage area (HDW) of the V-BOX is used to store temporary data:
++Latitude: addr_getdouble("@W_HSW183") (read only)
--1. Access by word, the number range is: "@W_HDW0"-"@W_HDW299999".
--1. Access in bit mode, the number range is: "@B_HDX0.0"-"@B_HDX299999.15".
++2.5 Operator information: addr_getdword("@W_HSW181") (read only)
--(((
--== **8.2 Special data area (HSW/HSX)** ==
++2.6 Networking mode: addr_getword("@W_HSW177") (read only)
--(% class="box infomessage" %)
--(((
--**✎Note: **
++0: Ethernet, 1: WIFI, 2: 4G, 3: 2G
--* //HSW// is a system special register, so please refer to the system special register table during use. Do not use addresses that are not mentioned in the table, and use the addresses stated in the table with caution (example: restart ("@W_HSW0") Writing a value of 1 will cause V-BOX to restart).
--* //Without any conditions. Direct use ("@W_HSW0") will cause the V-BOX to restart continuously.// When using ("@W_HSW0") address, please add judgment conditions, such as: connection to MQTT fails, there is no network, the value of a PLC address meets the condition or counts to a certain value.
--)))
--)))
++2.7 Map fence flag: addr_getword("@W_HSW178") (read only)
--The system data area (HSW) of the box is used for system special registers (system reserved). Use //addr_getword// to obtain the following register information:
++0: No map fence is drawn
--(% class="table-bordered" %)
--|=(% style="width: 151px;" %)address|=(% style="width: 169px;" %)function|=(% style="width: 456px;" %)Read and write status: read only, write only, read and write
--|(% style="width:151px" %)@W_HSW0|(% style="width:169px" %)restart|(% style="width:456px" %)read and write
--|(% style="width:151px" %)@W_HSW1|(% style="width:169px" %)Box time: year|(% style="width:456px" %)read and write
--|(% style="width:151px" %)@W_HSW2|(% style="width:169px" %)Box time: month|(% style="width:456px" %)read and write
--|(% style="width:151px" %)@W_HSW3|(% style="width:169px" %)Box time: day|(% style="width:456px" %)read and write
--|(% style="width:151px" %)@W_HSW4|(% style="width:169px" %)Box time: hour|(% style="width:456px" %)read and write
--|(% style="width:151px" %)@W_HSW5|(% style="width:169px" %)Box time: minute|(% style="width:456px" %)read and write
--|(% style="width:151px" %)@W_HSW6|(% style="width:169px" %)Box time: second|(% style="width:456px" %)read and write
--|(% style="width:151px" %)@W_HSW7|(% style="width:169px" %)Box time: week|(% style="width:456px" %)read and write
--|(% style="width:151px" %)@W_HSW8|(% style="width:169px" %)Ethernet IP1|(% style="width:456px" %)read only
--|(% style="width:151px" %)@W_HSW9|(% style="width:169px" %)Ethernet IP2|(% style="width:456px" %)read only
--|(% style="width:151px" %)@W_HSW10|(% style="width:169px" %)Ethernet IP3|(% style="width:456px" %)read only
--|(% style="width:151px" %)@W_HSW11|(% style="width:169px" %)Ethernet IP4|(% style="width:456px" %)read only
--|(% style="width:151px" %)@W_HSW12|(% style="width:169px" %)Ethernet Mask 1|(% style="width:456px" %)read only
--|(% style="width:151px" %)@W_HSW13|(% style="width:169px" %)Ethernet Mask 2|(% style="width:456px" %)read only
--|(% style="width:151px" %)@W_HSW14|(% style="width:169px" %)Ethernet Mask 3|(% style="width:456px" %)read only
--|(% style="width:151px" %)@W_HSW15|(% style="width:169px" %)Ethernet Mask 4|(% style="width:456px" %)read only
--|(% style="width:151px" %)@W_HSW16|(% style="width:169px" %)Ethernet Gateway 1|(% style="width:456px" %)read only
--|(% style="width:151px" %)@W_HSW17|(% style="width:169px" %)Ethernet Gateway 2|(% style="width:456px" %)read only
--|(% style="width:151px" %)@W_HSW18|(% style="width:169px" %)Ethernet Gateway 3|(% style="width:456px" %)read only
--|(% style="width:151px" %)@W_HSW19|(% style="width:169px" %)Ethernet Gateway 4|(% style="width:456px" %)read only
--|(% style="width:151px" %)@W_HSW21|(% style="width:169px" %)Ethernet MAC1|(% style="width:456px" %)read only
--|(% style="width:151px" %)@W_HSW22|(% style="width:169px" %)Ethernet MAC2|(% style="width:456px" %)read only
--|(% style="width:151px" %)@W_HSW23|(% style="width:169px" %)Ethernet MAC3|(% style="width:456px" %)read only
--|(% style="width:151px" %)@W_HSW24|(% style="width:169px" %)Ethernet MAC4|(% style="width:456px" %)read only
--|(% style="width:151px" %)@W_HSW25|(% style="width:169px" %)Ethernet MAC3|(% style="width:456px" %)read only
--|(% style="width:151px" %)@W_HSW26|(% style="width:169px" %)Ethernet MAC4|(% style="width:456px" %)read only
--|(% style="width:151px" %)@W_HSW128|(% style="width:169px" %)WIFI IP1|(% style="width:456px" %)read only
--|(% style="width:151px" %)@W_HSW129|(% style="width:169px" %)WIFI IP2|(% style="width:456px" %)read only
--|(% style="width:151px" %)@W_HSW130|(% style="width:169px" %)WIFI IP3|(% style="width:456px" %)read only
--|(% style="width:151px" %)@W_HSW131|(% style="width:169px" %)WIFI IP4|(% style="width:456px" %)read only
--|(% style="width:151px" %)@W_HSW132|(% style="width:169px" %)WIFI Mask 1|(% style="width:456px" %)read only
--|(% style="width:151px" %)@W_HSW133|(% style="width:169px" %)WIFI Mask 2|(% style="width:456px" %)read only
--|(% style="width:151px" %)@W_HSW134|(% style="width:169px" %)WIFI Mask 3|(% style="width:456px" %)read only
--|(% style="width:151px" %)@W_HSW135|(% style="width:169px" %)WIFI Mask 4|(% style="width:456px" %)read only
--|(% style="width:151px" %)@W_HSW136|(% style="width:169px" %)WIFI Gateway 1|(% style="width:456px" %)read only
--|(% style="width:151px" %)@W_HSW137|(% style="width:169px" %)WIFI Gateway 2|(% style="width:456px" %)read only
--|(% style="width:151px" %)@W_HSW138|(% style="width:169px" %)WIFI Gateway 3|(% style="width:456px" %)read only
--|(% style="width:151px" %)@W_HSW139|(% style="width:169px" %)WIFI Gateway 4|(% style="width:456px" %)read only
--|(% style="width:151px" %)@W_HSW140|(% style="width:169px" %)WIFI MAC1|(% style="width:456px" %)read only
--|(% style="width:151px" %)@W_HSW141|(% style="width:169px" %)WIFI MAC2|(% style="width:456px" %)read only
--|(% style="width:151px" %)@W_HSW142|(% style="width:169px" %)WIFI MAC3|(% style="width:456px" %)read only
--|(% style="width:151px" %)@W_HSW143|(% style="width:169px" %)WIFI MAC4|(% style="width:456px" %)read only
--|(% style="width:151px" %)@W_HSW144|(% style="width:169px" %)WIFI MAC5|(% style="width:456px" %)read only
--|(% style="width:151px" %)@W_HSW145|(% style="width:169px" %)WIFI MAC6|(% style="width:456px" %)read only
--|(% style="width:151px" %)@W_HSW146|(% style="width:169px" %)WIFI Signal value|(% style="width:456px" %)read only
--|(% style="width:151px" %)@W_HSW148|(% style="width:169px" %)4G IP1|(% style="width:456px" %)read only
--|(% style="width:151px" %)@W_HSW149|(% style="width:169px" %)4G IP2|(% style="width:456px" %)read only
--|(% style="width:151px" %)@W_HSW150|(% style="width:169px" %)4G IP3|(% style="width:456px" %)read only
--|(% style="width:151px" %)@W_HSW151|(% style="width:169px" %)4G IP4|(% style="width:456px" %)read only
--|(% style="width:151px" %)@W_HSW152|(% style="width:169px" %)4G Mask 1|(% style="width:456px" %)read only
--|(% style="width:151px" %)@W_HSW153|(% style="width:169px" %)4G Mask 2|(% style="width:456px" %)read only
--|(% style="width:151px" %)@W_HSW154|(% style="width:169px" %)4G Mask 3|(% style="width:456px" %)read only
--|(% style="width:151px" %)@W_HSW155|(% style="width:169px" %)4G Mask 4|(% style="width:456px" %)read only
--|(% style="width:151px" %)@W_HSW156|(% style="width:169px" %)4G Gateway 1|(% style="width:456px" %)read only
--|(% style="width:151px" %)@W_HSW157|(% style="width:169px" %)4G Gateway 2|(% style="width:456px" %)read only
--|(% style="width:151px" %)@W_HSW158|(% style="width:169px" %)4G Gateway 3|(% style="width:456px" %)read only
--|(% style="width:151px" %)@W_HSW159|(% style="width:169px" %)4G Gateway 4|(% style="width:456px" %)read only
--|(% style="width:151px" %)@W_HSW160|(% style="width:169px" %)4G MAC1|(% style="width:456px" %)read only
--|(% style="width:151px" %)@W_HSW161|(% style="width:169px" %)4G MAC2|(% style="width:456px" %)read only
--|(% style="width:151px" %)@W_HSW162|(% style="width:169px" %)4G MAC3|(% style="width:456px" %)read only
--|(% style="width:151px" %)@W_HSW163|(% style="width:169px" %)4G MAC4|(% style="width:456px" %)read only
--|(% style="width:151px" %)@W_HSW164|(% style="width:169px" %)4G MAC5|(% style="width:456px" %)read only
--|(% style="width:151px" %)@W_HSW165|(% style="width:169px" %)4G MAC6|(% style="width:456px" %)read only
--|(% style="width:151px" %)@W_HSW166|(% style="width:169px" %)4G Signal value|(% style="width:456px" %)read only
++1: Draw a map fence and the box is in the fence
--**Others**
++2: Draw a map fence and the box is not in the fence
--* Access password: addr_getstring("@W_HSW27", 16)
--* Machine code: addr_getstring("@W_HSW60", 64)
--* Positioning method (@W_HSW167): (read only)
--** Latitude and longitude
--*** Longitude: addr_getdouble("@W_HSW168") (read only)
--*** Latitude: addr_getdouble("@W_HSW172") (read only)
--** Base station positioning
--*** LAC: addr_getdword("@W_HSW168") (read only)
--*** CI: addr_getdword("@W_HSW172") (read only)
--* Convert base station to latitude and longitude via API
--** Longitude: addr_getdouble("@W_HSW187") (read only)
--** Latitude: addr_getdouble("@W_HSW183") (read only)
--* Operator information: addr_getdword("@W_HSW181") (read only)
--* Networking mode: addr_getword("@W_HSW177") (read only)
--** 0: Ethernet
--** 1: WIFI
--** 2: 4G
--** 3: 2G
--* Map fence flag: addr_getword("@W_HSW178") (read only)
--** 0: No map fence is drawn
--** 1: Draw a map fence and the box is in the fence
--** 2: Draw a map fence and the box is not in the fence
--* SIM card status addr_getword("@W_HSW179") (read only)
--** 1: No card detected
--** 2: Card insertion detected
--** 3: The card status is abnormal
--* MQTT status addr_getword("@W_HSW180") (read only)
--** 1: online, 2: offline
--* IO interface, X is read only, Y is read and write (H series)
--** addr_getbit(addr1), addr_setbit(addr2)
--** addr1:"@B_Y0" "@B_Y1" "@B_X0" "@B_X1"
--** addr2:"@B_Y0" "@B_Y1"
--* Obtaining IMEI (read only)
--** addr_getstring("@W_HSW191",17)
--* Obtaining ICCID (read only)
--** addr_getstring("@W_HSW225",15)
++2.8 SIM card status addr_getword("@W_HSW179") (read only)
--(((
--== **Power-down storage area (HAW/HAX)** ==
++1: No card detected
--The system storage area (HAW) is used for the system power-down hold registers:
++2: Card insertion detected
--1. Accessed as a word, numbered in the range: "@W_HAW0"-"@W_HAW199999".
--1. Accessed by bit, the numbering range is: "@B_HAX0.0"-"@B_HAX199999.15".
++3: The card status is abnormal
--(% class="box infomessage" %)
--(((
--**✎Note:** HAW/HAX is a power-down hold, that is, the registers of this type can retain the data before power-down in case of power-down.
--)))
++2.9 MQTT status addr_getword("@W_HSW180") (read only)
++1: online, 2: offline
++
++2.10 IO interface, X is read only, Y is read and write (H series)
++
++addr_getbit(addr1), addr_setbit(addr2)
++
++addr1:"@B_Y0" "@B_Y1" "@B_X0" "@B_X1"
++
++addr2:"@B_Y0" "@B_Y1"
++
++(((
  = **9 General Functions** =
  )))
  (((
--== **send_sms_ira(string number, string message)** ==
++== **9.1 send_sms_ira(string number, string message)** ==
  )))
--**Function:** Use IRA character set to send English text messages
++**Function:**
++Use IRA character set to send English text messages
++
  **Parameters:**
  //number: //number (up to 32 characters, the excess will be discarded)
@@ -1554,11 +1554,13 @@
  Failed: multi
  (((
--== **sms_get_state(number id)** ==
++== **9.3 sms_get_state(number id)** ==
  )))
--**Function:** Get the status of the SMS
++**Function:**
++Get the status of the SMS
++
  **parameter:**
  //id~:// SMS corresponding id
@@ -1570,11 +1570,13 @@
  Failed: multi
  (((
--== **jwt_encode(table head, table payload, string aud, number iat, number exp, string key, int jwttype)** ==
++== **9.4 jwt_encode(table head, table payload, string aud, number iat, number exp, string key, int jwttype)** ==
  )))
--**Function:** Convert data to JWT format
++**Function:**
++Convert data to JWT format
++
  **parameter:**
  //aud: //project name
@@ -1619,20 +1619,19 @@
  //key~:// the private key required for encryption
--**For example:**
++For example:
--{{code language="LUA"}}
  function jwt.main()
--local PRIVATE_KEY = [[-- Please enter the secret key--]]
++local PRIVATE_KEY = ~[~[~-~- Please enter the secret key~-~-]]
  local JWTType=0
--local payload = {{key="test1",value="test1",type="0"},
++local payload = ~{~{key="test1",value="test1",type="0"},
  {key="test",value="123122131",type="1"}}
--local head = {{ key="name",value="data",type="0"},
++local head = ~{~{ key="name",value="data",type="0"},
  {key="test2",value="test2",type="0"}}
@@ -1647,14 +1647,15 @@
  print(en)
  End
--{{/code}}
  (((
--== **convertohex(number type, number value)** ==
++== **9.5 convertohex(number type, number value)** ==
  )))
--**Function:** Convert data into hexadecimal data
++**Function:**
++Convert data into hexadecimal data
++
  **parameter:**
  //type~:// incoming data type 0:word 1:dword 2:float
@@ -1667,28 +1667,14 @@
  Failed: multi
--== **crc.init(table prarm)** ==
--
--**Function:** Initialize the CRC
--
--**Parameters:**
--
--prarm is a Lua table and needs to contain the following fields.
--
--* string prarm name, see table 9-1 for details of the parameter model name When this parameter is passed in, the default table parameters are used and the poly,init,xorout,refin,and refout passed in are invalid.
--* number prarm.width: the width, i.e. the number of CRC bits.
--* number [prarm.poly]: short for the generated item in hexadecimal. For example, CRC-32 is 0x04C11DB7, ignoring the highest bit "1", i.e., the complete generation item is 0x104C11DB7.
--* number [prarm.init]: the initialization preset value of the register (crc) at the beginning of the algorithm in hexadecimal.
--* number [prarm.xorout], the final CRC value obtained after heterodyning the calculation result with this parameter.
--* number [prarm.refin], whether each byte of the data to be measured is inverted by bit, true or false.
--* number [prarm.refout], after the calculation and before the heterodyning output, whether the whole data is inverted by bit, true or false. Return: success: crc object Failure: multi, error code
--
  (((
--== **set_network(table config)** ==
++== **9.6 set_network(table config)** ==
  )))
--**Function:** Set V-BOX network, take effect after restart
++**Function:**
++Set V-BOX network, take effect after restart
++
  **parameter:**
  //config~:// incoming network configuration table

Changes for page 01 Lua Functions

Summary

Details

Navigation

Table of Contents