|
|
LUA脚本的好处是用户可以根据自己注册的一批API（当前TOOL已经提供了几百个函数供大家使用），实现各种小程序，不再限制Flash里面已经下载的程序，就跟手机安装APP差不多，所以在H7-TOOL里面被广泛使用，支持在线调试运行，支持离线运行。
TOOL的LUA教程争取做到大家可以无痛调用各种功能函数，不需要学习成本。
注事项放在前面说：
TOOL配套了两个硬件串口，LUA使用串口1没有什么要注意的，而串口7使用的D0 D1, 缺省GPIO模式。 使用前需要配置GPIO模式为UART。
gpio_cfg(1, 5) --配置模式D1 = 5-UART
gpio_cfg(0, 5) --配置模式D0 = 5-UART
Lua Uart API 函数说明
目录:
uart_cfg(port, BaudRate, Parity, WordLength, StopBits)
uart_send(port, bin)
len, bin_str = uart_recive(prot, maxlen, TotalTimeout, ByteTimeout)
uart_clear_rx(prot)
err = modbus_write_u16(port, timeout, addr485, regaddr, value0, value1, value2 ...)
err = modbus_write_u32(port, timeout, addr485, regaddr, value0, value1, value2 ...)
err = modbus_write_float(port, timeout, addr485, regaddr, value0, value1, value2 ...)
err, data1, data2 ... = modbus_read_u16(port, timeout, addr485, regaddr, regnum)
err, data1, data2 ... = modbus_read_s16(port, timeout, addr485, regaddr, regnum)
err, data1, data2 ... = modbus_read_u32(port, timeout, addr485, regaddr, regnum)
err, data1, data2 ... = modbus_read_s32(port, timeout, addr485, regaddr, regnum)
err, data1, data2 ... = modbus_read_float(port, timeout, addr485, regaddr, regnum)
err = modbus_write_do(port, timeout, addr485, regaddr, value0, value1 ...)
err, data1, data2 ... = modbus_read_do(port, timeout, addr485, regaddr, regnum)
err, data1, data2 ... = modbus_read_di(port, timeout, addr485, regaddr, regnum)
详细说明:
----------------------------------------------------------
uart_cfg(port, BaudRate, Parity, WordLength, StopBits)
功能: 配置串口硬件参数
参数:
- port : 串口号, 1 或 7
- BaudRate : 波特率
- Parity : 0-无校验 1-奇校验 2-偶校验
- WordLength : 字长 8或9
- StopBits : 停止位 1,2
返回: 无
范例: uart_cfg(1, 115200, 0, 8, 1)
----------------------------------------------------------
uart_send(port, bin)
功能: 发送数据
参数:
- port : 串口号, 1 或 7
- bin : 二进制字符串
返回: 无
范例:
uart_send(1, "12345678")
uart_send(1, "\x04\x00\0x12")
bin = "\x00\x12\x34\x56"
uart_send(1, bin)
----------------------------------------------------------
uart_recive(prot, maxlen, TotalTimeout, ByteTimeout)
功能: 接收串口数据。退出条件满足任意1条:
(1)读到指定个数
(2)没有收到字节，总超时到达 TotalTimeout
(3)收到字节后，字符间超时到达 ByteTimeout
参数:
- port : 串口号, 1 或 7
- maxlen : 最长长度
- TotalTimeout : 总超时，ms
- ByteTimeout : 字节间超时, ms。不提供该参数时，字节间超时等于总超时
返回: 长度, 读取到的二进制字符串
范例:
local str
local len
len, str = uart_recive(1, 200, 2000, 10) --读最大200字节, 总超时2秒, 字符间超时10ms
len, str = uart_recive(1, 200, 2000) --读最大200字节, 总超时2秒，字符间超时2秒
----------------------------------------------------------
uart_clear_rx(prot)
功能: 清空接收缓冲区
参数:
- port : 串口号, 1 或 7
返回: 无
范例:
uart_clear_rx(1)
----------------------------------------------------------
int modbus_write_u16(port, timeout, addr485, regaddr, value0, value1, value2 ...)
功能: 发0x06功能码写1个寄存器或者发0x10功能码多个写寄存器，函数收到应答或等待超时才会返回
参数:
- port : 串口号, 1 或 7
- timeout : 超时
- addr485 ：485地址 0-255
- regaddr : 寄存器地址
- value0 : 寄存器值，可以罗列多个寄存器，函数自动识别寄存器个数
返回: err_code 错误代码
0x00 OK
0x01 不支持的功能码
0x02 寄存器地址错误
0x03 数据值域错误
0x04 写入失败
0x05 自己定义错误包应答
0x06 超时 自定义的 */
范例:
local re
re = modbus_write_u16(1, 100, 1, 0x0000, 0x1234, 0x4567, 0x8888)
local port = 1
local timeout = 100
local addr485 = 1
local regaddr = 0
re = modbus_write_u16(port, timeout, addr485, regaddr, 0x1234, 0x4567, 0x8888)
print(re)
beep()
----------------------------------------------------------
int modbus_write_u32(port, timeout, addr485, regaddr, value0, value1, value2 ...)
功能: 发0x10功能码写32位整数寄存器, 2个16位寄存器组合为1个32位寄存器，大端模式
参数:
- port : 串口号, 1 或 7
- timeout : 超时
- addr485 ：485地址 0-255
- regaddr : 寄存器地址
- value0 : 寄存器值，可以罗列多个寄存器，函数自动识别寄存器个数
返回: err_code 错误代码
0x00 OK
0x01 不支持的功能码
0x02 寄存器地址错误
0x03 数据值域错误
0x04 写入失败
0x05 自己定义错误包应答
0x06 超时 自定义的 */
范例:
local re
re = modbus_write_u32(1, 100, 1, 0x0000, 0x12345678, 0x45678888)
local port = 1
local timeout = 100
local addr485 = 1
local regaddr = 0
re = modbus_write_u16(port, timeout, addr485, regaddr, 0x12345678, 0x45678888)
print(re)
beep()
----------------------------------------------------------
int modbus_write_float(port, timeout, addr485, regaddr, value0, value1, value2 ...)
功能: 发0x10功能码写单精度浮点寄存器, 2个16位寄存器组合为1个32位浮点寄存器，大端模式 float_ABCD
参数:
- port : 串口号, 1 或 7
- timeout : 超时
- addr485 ：485地址 0-255
- regaddr : 寄存器地址
- value0 : 寄存器值，可以罗列多个寄存器，函数自动识别寄存器个数
返回: err_code 错误代码
0x00 OK
0x01 不支持的功能码
0x02 寄存器地址错误
0x03 数据值域错误
0x04 写入失败
0x05 自己定义错误包应答
0x06 超时 自定义的 */
范例:
local re
re = modbus_write_float(1, 100, 1, 0x0000, -0.1234, 789.123)
local port = 1
local timeout = 100
local addr485 = 1
local regaddr = 0
re = modbus_write_u16(port, timeout, addr485, regaddr, -0.1234, 789.123)
print(re)
beep()
----------------------------------------------------------
modbus_read_u16(port, timeout, addr485, regaddr, regnum)
功能: 发0x03功能码读16位无符号整数寄存器
参数:
- port : 串口号, 1 或 7
- timeout : 超时
- addr485 ：485地址 0-255
- regaddr : 寄存器地址
- regnum : 寄存器个数
返回: err_code, value0, value1 ...
err_code 错误代码
0x00 OK
0x01 不支持的功能码
0x02 寄存器地址错误
0x03 数据值域错误
0x04 写入失败
0x05 自己定义错误包应答
0x06 超时 自定义的 */
范例:
local re
local data1
local data2
local port = 1
local timeout = 100
local addr485 = 1
local regaddr = 0
local value = {}
value = {modbus_read_u16(port, timeout, addr485, regaddr, 2)}
-- value[1] : 错误代码
-- value[2] : 第1个寄存器的值
-- value[3] : 第3个寄存器的值
re. data1, data2 = modbus_read_u16(port, timeout, addr485, regaddr, 2)
-- re : 错误代码
-- data1 : 第1个寄存器的值
-- data2 : 第2个寄存器的值
----------------------------------------------------------
modbus_read_s16(port, timeout, addr485, regaddr, regnum)
功能: 读16位有符号整数寄存器，用法同 modbus_read_u16()
----------------------------------------------------------
modbus_read_u32(port, timeout, addr485, regaddr, regnum)
功能: 读32位无符号整数寄存器，用法同 modbus_read_u16()
2个16位寄存器组合为1个32位寄存器
----------------------------------------------------------
modbus_read_s32(port, timeout, addr485, regaddr, regnum)
功能: 读32位有符号整数寄存器，用法同 modbus_read_u16()
2个16位寄存器组合为1个32位寄存器
----------------------------------------------------------
modbus_read_float(port, timeout, addr485, regaddr, regnum)
功能: 读32位单精度浮点寄存器，用法同 modbus_read_u16()
2个16位寄存器组合为1个32位寄存器
----------------------------------------------------------
modbus_write_do(port, timeout, addr485, regaddr, value0, value1 ...)
功能: 发0x10功能码写1个或多个DO寄存器(控制继电器)
参数:
- port : 串口号, 1 或 7
- timeout : 超时
- addr485 ：485地址 0-255
- regaddr : 寄存器地址
- value0 : 寄存器值，0或1. 可以罗列多个寄存器，函数自动识别寄存器个数
返回: err_code 错误代码
0x00 OK
0x01 不支持的功能码
0x02 寄存器地址错误
0x03 数据值域错误
0x04 写入失败
0x05 自己定义错误包应答
0x06 超时 自定义的 */
范例:
local port = 1
local timeout = 100
local addr485 = 1
local regaddr = 0
re = modbus_write_do(port, timeout, addr485, regaddr, 1, 0, 1, 1, 0) --写0开始的5个寄存器
print(re)
----------------------------------------------------------
modbus_read_do(port, timeout, addr485, regaddr, regnum)
功能: 发0x01功能码读DO寄存器
参数:
- port : 串口号, 1 或 7
- timeout : 超时
- addr485 ：485地址 0-255
- regaddr : 寄存器地址，起始地址
- regnum : 寄存器个数
返回: err_code, value0, value1 ...
err_code 错误代码
0x00 OK
0x01 不支持的功能码
0x02 寄存器地址错误
0x03 数据值域错误
0x04 写入失败
0x05 自己定义错误包应答
0x06 超时 自定义的 */
范例:
local re
local data1
local data2
local port = 1
local timeout = 100
local addr485 = 1
local regaddr = 0
local value = {}
value = {modbus_read_do(port, timeout, addr485, regaddr, 2)}
-- value[1] : 错误代码
-- value[2] : 第1个寄存器的值
-- value[3] : 第3个寄存器的值
re. data1, data2 = modbus_read_u16(port, timeout, addr485, regaddr, 2)
-- re : 错误代码
-- data1 : 第1个寄存器的值
-- data2 : 第2个寄存器的值
----------------------------------------------------------
modbus_read_di(port, timeout, addr485, regaddr, regnum)
功能: 发0x02功能码读DI寄存器
参数:
- port : 串口号, 1 或 7
- timeout : 超时
- addr485 ：485地址 0-255
- regaddr : 寄存器地址，起始地址
- regnum : 寄存器个数
返回: err_code, value0, value1 ...
err_code 错误代码
0x00 OK
0x01 不支持的功能码
0x02 寄存器地址错误
0x03 数据值域错误
0x04 写入失败
0x05 自己定义错误包应答
0x06 超时 自定义的 */
范例:
local re
local data1
local data2
local port = 1
local timeout = 100
local addr485 = 1
local regaddr = 0
local value = {}
value = {modbus_read_do(port, timeout, addr485, regaddr, 2)}
-- value[1] : 错误代码
-- value[2] : 第1个寄存器的值
-- value[3] : 第3个寄存器的值
re. data1, data2 = modbus_read_u16(port, timeout, addr485, regaddr, 2)
-- re : 错误代码
-- data1 : 第1个寄存器的值
-- data2 : 第2个寄存器的值
举例说明：
我们这里简单做一个回环测试，大家仅需将TOOL的TTLTX和TTLRX短接即可。
测试代码：
- uart_cfg(1, 115200, 0, 8, 1)
- uart_send(1, "12345678www.armbbs.cn")
- len, str = uart_recive(1, 200, 1000, 10)
- print(str)
执行效果如下：
参考案例：
串口Bootloader案例下载和文字版操作说明
https://www.armbbs.cn/forum.php?mod=viewthread&tid=113456
|
|
发表于 2022-1-16 11:32:53
楼主
