通用插件-通道说明
通道类型说明
通道对应app中可操作的功能,通道拥有多种类型,不同类型的写法有
通道类型 | 通道示例 | 通道说明 |
---|---|---|
Number | AA BB XX DD | 其中XX代表通道输入的值 |
Switch | on/AA BB CC DD+off/DD CC BB AA | on/xxx代表开关为开之后发送的值,off/xxx代表开关关闭之后发送的值 |
Button | AA BB CC DD | 该通道触发之后直接发送的值 |
Enum | cold/AA BB CC+heat/DD EE FF+fan/AB CD EF | 该通道会在app界面形成一个选项,按下对应的则发送对应的值,例如示例中会出现cold,heat,fan这三个选项 |
协议种类说明
协议有不同的类型,本插件兼容不同的种类
hex型
顾名思义,hex型允许用户直接发送当前填写的值
button1=(对应通道(Value)说明)
例1 button1=AA BB CC DD
button1=on/AA BB CC DD+off/BB CC DD EE
例2 button1=hex:AA BB CC DD
button1=hex:on/AA BB CC DD+off/BB CC DD EE
例1和例2没有区别
modbus型
此类型支持自定义modbus的功能操作
通道名称=modbus:寄存器:功能码:值:格式:精度:单位:scale:offset:最小值:最大值
通道名称 | 指令类型 | 寄存器号 | 功能码 | 值 | 格式 | 精度 | 单位 | scale | offset | 最小值 | 最大值 |
---|---|---|---|---|---|---|---|---|---|---|---|
通道名称 | modbus | 协议所注明的寄存器号 | 支持的标准modbus功能码 | 3钟格式见例1~例4 | 见下方当前支持类型 | app显示的精度 | app显示的单位 | 所能显示和输入数值的最大值 | 所能显示和输入数值的最小值 |
例1,modbus空调开关,寄存器号码为1,支持读写功能码,开对应值为1,关对应值为0(on/off类型) switch=modbus:1:3/6:on/1+off/0
例2,modbus空调当前温度,寄存器号码为2,温度单位0.1,支持读功能码(Number类型) switch=modbus:2:3/6:::0.1
例3,modbus空调模式,寄存器号码为3,支持读写功能码,制热对应1,制冷对应2(enum类型) switch=modbus:3:3/6:heat/1+cold/2
例4,modbus空调当前设置温度,设置温度范围为5-35,寄存器号码为4,支持读写功能码,floatABCD类型(Number类型) 则 switch=modbus:4:4/16::floatABCD::°C::::5:35
当前支持类型
类型 | 说明 | byte个数 |
---|---|---|
formatDefault | 默认不变,可不填写 | 2 |
floatABCD | modbus标准 | 4 |
floatCDAB | modbus标准 | 4 |
floatBADC | modbus标准 | 4 |
floatDCBA | modbus标准 | 4 |
longABCD | modbus标准 | 4 |
longBADC | modbus标准 | 4 |
longCDAB | modbus标准 | 4 |
longDCBA | modbus标准 | 4 |
doubleABCDEFGH | modbus标准 | 8 |
doubleBADCFEHG | modbus标准 | 8 |
doubleGHEFCDAB | modbus标准 | 8 |
doubleHGFEDCBA | modbus标准 | 8 |
short | 有符号short | 2 |
2byteDivide10 | 传回值为实际值的10%,如0x01 02=25.8 | 2 |
i_d_separation | 第一个byte为个位,第二个byte为小数点,如0x01 02=1.2 | 2 |
string型
当协议是中文时,如开机=open,则可使用此类型
此类型支持智能识别
<CR>
button1=(对应通道(Value)说明)
例如 button=str#open
switch=on/str#open<CR>+off/str#close<CR>