功能简介 在自定义驱动库中，你可以实现驱动程序的自定义添加与管理。 添加设备驱动程序 当所用设备未提供官方驱动时，你可以针对该设备自定义添加和管理驱动，实现设备与系统间的正常通信与控制。 进入自定义驱动库，点击新建添加驱动。 配置基础信息 为新建的驱动填写基本标识信息，以确保驱动在系统中的唯一性和准确分类。 参数 描述 驱动型号 设置驱动型号，用以标识特定设备型号。长度不能超过64个字符。 驱动分类 设置驱动所属的设备类别。 厂商品牌 设置设备制造商。你可以从Designer内置的制造商列表中选择。如无匹配的制造商，可点击下拉列表底部的添加选项，新增制造商。 版本 设置驱动版本号，用于区分和维护不同版本。长度不能超过64个字符。 2.配置通讯协议 配置驱动与目标设备之间的通信方式。系统支持多种通信协议。选择协议后，可填写相应的通信参数。 TCP TCP是一种面向连接的协议，能够提供可靠的数据传输，确保数据包按顺序且无丢失地送达。系统通过此协议与设备建立稳定连接，保证指令的准确传递。该协议常用于智能电视、IP控制系统等设备。 参数 描述 IP地址 输入设备的IP地址。 端口号 输入设备通信使用的TCP端口号。 用户名 输入设备鉴权所需的用户名。 密码 输入设备鉴权所需的密码。 UDP UDP是一种无连接协议，传输速度快，但不保证数据可靠性。适用于需要快速传输而对可靠性要求不高的场景。系统以无连接方式快速发送数据，不确保数据完全交付。若少量数据包丢失不影响整体功能，推荐使用该协议。 参数 描述 IP地址 输入设备的IP地址。 端口号 输入设备通信使用的UDP端口号。 账号 输入设备鉴权所需的用户名。 密码 输入设备鉴权所需的密码。 RS232 RS232 是一种用于短距离通信的串行协议，支持点对点连接，通过串口线缆连接传统设备。虽然传输距离有限，但兼容性强，常用于传统矩阵切换器、工业串口控制器等设备。 参数 描述 波特率 配置串行通信的波特率。 1200 2400 4800 9600 14400 19200 28800 38400 57600 76800 115200 数据位 配置每个通信字节中的有效数据位数。 8 7 6 5 奇偶校验 用于检测数据传输过程中发生的错误。 无：不进行校验，数据传输速度较快，但无法检测错误。适用于数据准确性要求不高或传输环境干扰极小的场景。 奇校验：通过调整校验位，使传输数据位与校验位中的“1”数量为奇数。可检测数据传输中的单个位错误。 偶校验：使传输数据位与校验位中的“1”数量为偶数，同样可用于检测单个数据错误。 停止位 用于标识一帧通信字节传输结束的结束位。 1 2 账号 输入设备鉴权所需的用户名。 密码 输入设备鉴权所需的密码。 RS422 RS422 提供长距离、高速的差分串行通信。其设计用于基于串口的长距离、抗干扰通信，配置参数与 RS232 类似。此外，RS422 支持多台设备串接。 参数 描述 波特率 配置串行通信的波特率。 1200 2400 4800 9600 14400 19200 28800 38400 57600 76800 115200 数据位 配置每个通信字节中的有效数据位数。 8 7 6 5 奇偶校验 用于检测数据传输过程中发生的错误。 无：不进行校验，数据传输速度较快，但无法检测错误。适用于数据准确性要求不高或传输环境干扰极小的场景。 奇校验：通过调整校验位，使传输数据位与校验位中的“1”数量为奇数。可检测数据传输中的单个位错误。 偶校验：使传输数据位与校验位中的“1”数量为偶数，同样可用于检测单个数据错误。 停止位 用于标识一帧通信字节传输结束的结束位。 1 2 账号 输入设备鉴权所需的用户名。 密码 输入设备鉴权所需的密码。 RS485 RS485是一种支持多点连接的串行通信协议，允许多个设备共享同一通信总线，实现并行组网。该协议采用半双工通信，非常适合多设备协同工作的场景，如智能照明控制系统和楼宇环境传感器。其传输距离和抗干扰能力介于RS232和RS422之间。 参数 描述 波特率 配置串行通信的波特率。 1200 2400 4800 9600 14400 19200 28800 38400 57600 76800 115200 数据位 配置每个通信字节中的有效数据位数。 8 7 6 5 奇偶校验 用于检测数据传输过程中发生的错误。 无：不进行校验，数据传输速度较快，但无法检测错误。适用于数据准确性要求不高或传输环境干扰极小的场景。 奇校验：通过调整校验位，使传输数据位与校验位中的“1”数量为奇数。可检测数据传输中的单个位错误。 偶校验：使传输数据位与校验位中的“1”数量为偶数，同样可用于检测单个数据错误。 停止位 用于标识一帧通信字节传输结束的结束位。 1 2 双工模式 选择半双工或全双工模式，影响数据传输的方向性。 半双工模式：设备在发送和接收数据之间交替切换。 全双工模式：设备可以同时发送和接收数据。 账号 输入设备鉴权所需的用户名。 密码 输入设备鉴权所需的密码。 GPIO GPIO是一种用于简单数字信号处理的接口，使设备能够与外部硬件直接交互。可通过硬件引脚实现设备的直接控制，免去复杂的网络配置。通过引脚电平（高/低）实现简单控制，非常适用于继电器开关、指示灯控制等基础硬件交互场景。 参数 描述 I/O 类型 配置GPIO接口的工作模式。 数字输入：接收数字信号，能够检测高或低电平状态。 数字输出：发送数字信号以控制外部设备的开关状态。 模拟输出：输出模拟信号，通常用于控制设备的可变输出，比如亮度或音量。 上拉 启用上拉电阻，可将未连接的输入引脚拉至高电平，防止因浮空状态导致的误触发。适用于需要稳定输入信号的场景。 阈值 启用后，可设置电平阈值。当设备对电平变化敏感时，可通过设置阈值，精确定义高低电平。 电压低端 电压高端 设置类型-电压 模拟输入的值表示设备的电压。 设置类型-自定义 配置阈值电压的上下限及对应的取值。 3. 配置新变量 变量用于参数传递和数据绑定功能操作，在控制过程中（如亮度等级、音量设定）存储和传递变量值。通过使用变量，可更加灵活驱动功能模块，实现动态参数调整，提升灵活性和可维护性。 添加新变量 参数 描述 变量名称 用于唯一标识局部变量，最大可输入64个字符。 数据类型 字符型：用于存储文本信息。 布尔型：用于存储布尔值。 数值型：用于存储数值信息。 数据输入类型 当数据类型设置为字符型或数值型时为必填项。 枚举：将参数值限制为预定义的固定选项，用户只能从列表内的值中进行选择。 自由输入：用户可自行输入参数值。 枚举值 当数据输入类型设置为枚举时必填。 为枚举类型参数定义可选值；点击添加以添加具体选项。可批量添加，支持自定义增加或删除操作。 字符串长度限制 当数据类型设置为字符型且数据输入类型为自由输入时必填。 限制输入字符串的最大长度。最多支持9,999字符。 数值类型 当数据类型设置为数值型时必填。 Int: 整数，适用于不需要小数精度的场景。 Float：浮点数，支持小数精度。 取值范围 当数据类型设置为数值型且数据输入类型为自由输入时必填。 限制自由输入的数值范围。整数取值范围为 -999,999 到 999,999，浮点数取值范围为 -999,999.9 到 999,999.9。 数值精度 当数据类型设置为数值型且数值类型为Float时必填。 定义数值的最小递增步长。 编辑/删除局部变量 在操作区域，你可以执行以下操作： 点击编辑局部变量的参数。 点击复制局部变量。 点击删除局部变量。 4.配置功能 在此步骤中，你可以配置设备可执行的操作及其通信逻辑。每个功能项可包含多个命令，按指定顺序依次执行，最终实现对设备的控制或状态查询。 点击新增分组按钮，在左侧创建多个功能分组，便于进行功能分类管理。 选择相应分组可创建新的功能项，添加至当前分组中。点击新建功能进入功能创建页面，并需配置下列参数。 配置功能信息 在左上角面板中，配置功能的基本信息，包括名称、功能类型及其他详细信息，以便识别该功能并确定其用途。 参数 描述 功能名称 自定义功能名称。 功能类型 设置功能类型。 控制：主动发送控制指令以驱动设备执行操作，适用于组件动作和场景执行。选择此类型后，你可以启用或禁用启用修改变量功能。启用后，变量值可以动态修改，你可以点击配置关联变量。 反馈（主动查询)：主动请求查询设备状态，可作为组件动作和场景执行的条件，也可用于自动化执行条件。 配置参数变量 在管理功能的左下方面板中，你可以找到所使用的输入和输出参数。 入参：配置功能所需数据（例如，对于“调整亮度”功能，需要指定目标亮度值）。 出参：执行功能后返回的数据（例如，对于“查询亮度”函数，会返回当前的亮度值）。 切换到输入参数/输出参数标签页，点击新建入参或新建出参，以添加相应的参数。需要配置的参数在下表列出。 参数 描述 名称 用于唯一标识局部变量，最大可输入64个字符。 数据类型 字符型：用于存储文本信息。 布尔型：用于存储布尔值。 数值型：用于存储数值信息。 数据输入类型 当数据类型设置为字符型或数值型时为必填项。 枚举: 将参数值限制为预定义的固定选项，用户只能从列表内的值中进行选择。 自由输入：用户可自行输入参数值。 枚举值 当数据输入类型设置为枚举时必填。 为枚举类型参数定义可选值；点击添加以添加具体选项。可批量添加，支持自定义增加或删除操作。 字符串长度限制 当数据类型设置为字符型且数据输入类型为自由输入时必填。 限制输入字符串的最大长度。最多支持9,999字符。 数值类型 当数据类型设置为数值型时必填。 Int: 整数，适用于不需要小数精度的场景。 Float：浮点数，支持小数精度。 取值范围 当数据类型设置为数值型且数据输入类型为自由输入时必填。 限制自由输入的数值范围。整数取值范围为 -999,999 到 999,999，浮点数取值范围为 -999,999.9 到 999,999.9。 数值精度 当数据类型设置为数值型且数值类型为Float时必填。 定义数值的最小递增步长。 配置指令 在中间面板中，添加并管理该功能下的所有指令。系统将按配置顺序依次执行这些指令。 在协议选择区域选择协议。此处可选协议将与第二步中选择的协议同步。 点击新建命令以新增指令，并在指令名称区域配置指令名称。新添加指令需配置的参数在下方表格中列出。 模块 参数 描述 指令重复次数 配置指令的重复发送次数，最多为 3 次。 指令间隔时间 配置首条指令发送后与后续重复发送之间的时间间隔（毫秒），最大限制为 2000 ms。 指令延迟时间 配置指令发送前的等待时间，最大限制为2000毫秒。 是否支持轮询？ 配置指令是否以轮询方式执行（即按指定时间间隔重复执行）。 轮询时间间隔 配置两次轮询执行之间的时间间隔，仅在启用轮询时适用，最大限制为10,000毫秒。 指令语法 命令语法类型 配置指令的编码格式。 ASCII: 适用于文本协议。 HEX: 适用于字节协议。 命令内容输入 填写设备可识别的命令内容（支持插入变量以实现动态命令）。可插入以下类型的变量： 功能的入参: 功能内部定义的输入参数。 之前指令的出参: 同一功能中前置指令返回的输出参数。 常量: 固定不变的值。 结束符 配置指令末尾的附加符号。 CR: 回车 LF: 换行 CRLF: 回车+换行 无: 无附加符号 出参提取 添加出参 配置输出参数提取方式。 自定义出参: 手动指定解析位置。 功能出参: 直接关联已定义的输出变量。需配置这两种方式所需参数，请参考本表下方内容。 变量名称 参数配置请参考配置参数变量模块中的参数说明。 数据类型 数据输入类型 枚举值 字符串长度上限 数值类型 数值精度 返回解析函数 在自定义输出参数流程中，为了从设备响应中提取有用信息，必须对返回值进行解析。系统支持两种解析方式，分别适用于不同的协议类型和返回格式： 应答匹配函数: 使用正则表达式从返回文本中提取目标值。 按位取值函数: 根据指定的起始位和结束位提取数值。 校验正则表达式 输入用于提取输出参数值的正则表达式。 低位/高位 低位: 起始位位置（从1开始计数）。 高位: 结束位位置。 选择功能的出参 在此功能中，定义输出参数。 编辑设备驱动程序 你可以在自定义驱动库中修改驱动程序。有关如何修改相关参数的信息，具体参阅添加设备驱动程序中的内容。 进入自定义驱动库，点击编辑驱动程序。 复制设备驱动程序 你可以从自定义驱动程序库中复制驱动。 进入自定义驱动库，点击复制驱动程序。 删除设备驱动程序 你可以从自定义驱动库中删除驱动程序。 进入自定义驱动库，点击删除驱动程序。 导入导出驱动程序 在你自定义了一个驱动程序后，你可以将其导出分享给其他同事或项目进行使用，提升工作效率。 导出 进入自定义驱动库，勾选需要导出的驱动程序，点击导出 > 驱动文件将驱动程序导出至本地。 导入 将本地的驱动文件导入至Designer中。 进入自定义驱动库，点击导入 > 本地文件将本地驱动程序导入至Deisgner。 使用设备驱动程序 驱动程序创建完成后，可以通过多种方式进行使用。你可以在链路设计或进行界面设计时使用它。 链路设计 进入链路设计，点击左侧工具栏中的第三方，然后切换到自定义设备标签页。在这里，你可以查看所有自定义的第三方设备，直接拖拽到工作区即可使用。 界面设计 按照上述步骤，将自定义设备添加到链路设计中。 进入界面设计，在底部操作命令区域点击设备驱动版块，找到第三方驱动中的对应设备，并将自定义命令添加到组件中。