Appearance
通用串口外设模块
通用串口外设模块兼容以下设备,请注意命令细微区别
| 已知兼容列表 |
|---|
| KmBox B+ |
| Ferrum |
| Makcu |
| 通用串口外设 |
初始化串口外设
通用串口外设初始化
lua
local km = newCustomKM(com, btc,mod)功能:创建一个鼠标交互类的实例,用于后续所有鼠标操作。
参数:
com:string,串口路径btc:number,波特率 仅支持115200和4000000,其他硬件支持请反馈mod:number,工作模式,如下:- 0=即时单查询,调用稳定不推荐多次调用会增加耗时,推荐波特率设置4000000使用
- 1=顺序后台线程查询,调用稳定用这个缺点就说有时候会有响应延迟(推荐)
- 2=批量后台线程查询,调用最快目前只测试makcu没问题,用这个缺点就说有时候会有监控不了的清空
返回值:userdata,通用串口外设鼠标接收器实例。
注意:所有后续操作都需要使用这个实例变量来调用。makcu推荐将makcu改成4000000这样调用 工作模式0时更快
示例:
lua
local km = newCustomKM("/dev/ttyACM0", 115200,) --makcu的默认参数
local km = newCustomKM("/dev/ttyUSB0", 115200,) --makcu的默认参数
-- 后续操作都使用km变量取左键状态
获取鼠标左键当前状态
lua
local isPressed = km:Get_Mouse_Left()功能:检测鼠标左键当前是否被按下。
返回值:boolean,true表示按下,false表示松开。
示例:
lua
if km:Get_Mouse_Left() then
print("鼠标左键被按下")
end取右键状态
获取鼠标右键当前状态
lua
local isPressed = km:Get_Mouse_Right()功能:检测鼠标右键当前是否被按下。
返回值:boolean,true表示按下,false表示松开。
取中键状态
获取鼠标中键当前状态
lua
local isPressed = km:Get_Mouse_Middle()功能:检测鼠标中键(滚轮按键)当前是否被按下。
返回值:boolean,true表示按下,false表示松开。
取下侧键状态-Ferrum或kmb/+
获取鼠标下侧键当前状态
lua
local isPressed = km:Get_Mouse_kmSide1()功能:检测鼠标下侧键当前是否被按下。
返回值:boolean,true表示按下,false表示松开。
取上侧键状态-Ferrum或kmb/+
获取鼠标上侧键当前状态
lua
local isPressed = km:Get_Mouse_kmSide2()功能:检测鼠标上侧键当前是否被按下。
返回值:boolean,true表示按下,false表示松开。
取下侧键状态-makcu 后期会转成Ferrum或kmb/+
获取鼠标下侧键当前状态
lua
local isPressed = km:Get_Mouse_Side1()功能:检测鼠标下侧键当前是否被按下。
返回值:boolean,true表示按下,false表示松开。
取上侧键状态-makcu 后期会转成Ferrum或kmb/+
获取鼠标上侧键当前状态
lua
local isPressed = km:Get_Mouse_Side2()功能:检测鼠标上侧键当前是否被按下。
返回值:boolean,true表示按下,false表示松开。
取下侧键状态-Makcu
获取鼠标下侧键当前状态
lua
local isPressed = km:Get_Mouse_MakcuSide1()功能:检测鼠标下侧键当前是否被按下。
返回值:boolean,true表示按下,false表示松开。
取上侧键状态-Makcu
获取鼠标上侧键当前状态
lua
local isPressed = km:Get_Mouse_MakcuSide2()功能:检测鼠标上侧键当前是否被按下。
返回值:boolean,true表示按下,false表示松开。
鼠标相对移动
控制鼠标相对移动
lua
km:Mouse_MoreR(x, y)功能:使鼠标指针相对当前位置移动指定偏移量。
参数:
x:整数,水平方向偏移量(正数向右,负数向左)y:整数,垂直方向偏移量(正数向下,负数向上)
示例:
lua
-- 向右移动50像素,向下移动50像素
km:Mouse_MoreR(50, 50)鼠标点击
模拟鼠标按键动作
lua
km:Mouse_Click(button, press)功能:模拟鼠标按键的按下或释放动作。
参数:
button:整数,按钮编号(1=左键 2=右键 3=中键 6=上侧键 5=下侧键)press:boolean,true表示按下,false表示释放
示例:
lua
-- 模拟左键点击(按下并释放)
km:Mouse_Click(1, true)
km:Mouse_Click(1, false)异步鼠标点击
异步模拟鼠标点击动作
lua
km:Mouse_Click_Async(button, firstDelay, midDelay, waitDelay)功能:在多线程中模拟完整的鼠标点击动作(按下-保持-释放)。
参数:
button:整数,按钮编号(1=左键,2=右键 目前只支持左右键)firstDelay:整数(可选),初次延迟(毫秒),默认0midDelay:整数(可选),中间延迟(毫秒),默认30waitDelay:整数(可选),收尾延迟(毫秒),默认0
示例:
lua
-- 模拟带延迟的右键点击
km:Mouse_Click_Async(1, 100, 50, 100)关闭串口连接
关闭串口连接并释放资源
lua
km:close()功能:关闭与通用串口外设设备的串口连接并释放相关资源。
注意:在脚本结束时应调用此方法以确保正确释放资源。