设备通信
功能与入口
从主导航进入“设备通信”,入口位于文件传输下方。顶部切换按钮提供网络设备、串口设备和协议管理三个视图。
本功能负责发送 TCP、UDP 和串口数据,不接收或解析外设的业务应答。设备、协议和指令保存在当前播控设备中。
| 平台 | 发送方式 |
|---|---|
| 桌面端 | 由运行应用的电脑执行网络和串口发送。 |
| 安卓端 | 由安卓设备执行网络发送,支持已适配的 USB 串口及固件允许访问的原生串口。 |
| 网页管理端 | 调用所连接播控设备的接口,由目标设备发送,不直接访问浏览器所在电脑的串口或网络套接字。 |
一.添加网络设备
切换到网络设备视图,点击顶部新增图标,填写:
- 设备名称。
- 主机地址:填写地址或主机名,不带网址协议前缀和路径。
- 端口。
- 权重。
TCP 或 UDP 在关联协议中选择,不需要为同一设备重复维护一份发送内容。
二.添加串口设备
切换到串口设备视图,点击新增图标,填写设备名称、串口名称、波特率、数据位、校验方式、停止位和权重。
“可用串口”下拉框内部右侧提供“扫描串口”文字按钮,用于查找当前可用端口。尚无扫描结果时仍可点击扫描或手动填写串口名称。校验位等下拉选项会在当前选中项右侧显示勾选标识。
- 桌面端选择系统已识别的串口,并确认驱动已安装、端口未被其他程序占用。
- 安卓 USB 串口需要设备与驱动适配,首次发送时可能弹出系统 USB 授权;设备拔出后需要重新确认连接和端口。
- 安卓原生串口使用固件提供的读写权限,应用不会自行提权或修改设备节点权限。扫描到端口不代表已获得访问权限。
三.添加协议
切换到协议管理,点击新增图标,配置以下内容:
协议列表顶部可按通信方式筛选“全部、TCP、UDP、串口”。筛选后分页总数只统计匹配的协议,并返回第一页;在筛选状态下新增协议,通信方式默认跟随当前筛选项。
| 字段 | 说明 |
|---|---|
| 协议名称 | 便于识别发送内容,例如灯光开启、投影关闭。 |
| 通信方式 | TCP、UDP 或串口。 |
| 数据编码 | 十六进制、中文文本或英文文本,对应十六进制字节、UTF-8、ASCII。 |
| 发送内容 | 按外设协议填写数据。 |
| 行结束符 | 无、回车、换行或回车换行。 |
| 权重 | 数值越大越靠前;相同权重按编号稳定排列,默认零。 |
十六进制内容按字节填写,例如 AA 01 01 FF。文本内容和行结束符应与外设协议保持一致。
四.为设备关联协议
- 返回网络设备或串口设备列表。
- 点击设备名称后单独列出的“关联协议”按钮。
- 在右侧面板中点击新增图标,填写指令名称、选择协议并设置权重。
- 保存后,当前设备的指令显示在表格中。
网络设备只选择网络协议,串口设备只选择串口协议。每条指令关联一台设备和一个协议,执行时使用当前保存的设备地址、端口、串口参数及协议内容。
侧板遮罩覆盖侧边导航栏、内容和底部区域,点击遮罩或关闭按钮可返回。新增、编辑和删除后列表自动更新,不需要刷新按钮。
五.指令操作
关联协议列表的操作栏提供:
- 发送指令:立即进行一次发送测试。
- 复制控制命令:复制当前指令的完整控制报文,不会执行发送;复制后短暂显示勾选图标。
- 编辑:调整指令名称、关联协议或权重。
- 删除:删除这条设备指令。
复制结果示例:
{"type":"send_command","data":{"id":12}}
其中 12 是这条已保存指令的编号。界面不需要额外显示编号列,也无需手工拼接报文。
被指令引用的设备或协议不能直接删除,应先删除或修改关联指令。修改协议的通信方式也需满足现有指令的设备类型约束。
六.相册标记联动
在相册详情编辑中,选中标记,将“触发动作”设置为“指令”,再选择“设备通信”来源和已有指令。
标记只保存指令引用,不复制一份设备配置。发送时读取当前指令;原有后台单条、组合联动保持兼容。
操作步骤见媒体文件中的相册说明。
七.外部调用与发送结果
外部系统通过现有控制通道发送复制的报文,由接收报文的播控设备执行。完整格式见控制指令接入。
请区分:
- 已接收:播控设备接收了控制指令。
- 数据已发送:数据已写给对应网络或串口发送器。
- 外设已执行:需要通过外设实际状态确认,本功能不根据业务应答判断。
不存在的指令、连接失败、串口无权限等错误会进入运行日志。失败不自动重试,避免重复执行外设动作。
网页配置通过接口读取和写入,当前不提供其他客户端修改后的主动推送同步;需要确认其他客户端的修改时,可重新进入页面获取配置。
验证范围
设备通信配置还可通过“设置 → 基本设置 → 备份与导入”整体备份和恢复,包括设备、协议与关联指令,不包含外设驱动或系统权限。导入采用覆盖所选类别的方式,并保留备份编号。
已验证控制报文解析、数据库保存、界面操作、队列执行及真实 TCP 控制报文接收。真实外设的业务效果、安卓 USB 授权与拔插、原生串口固件权限仍需结合现场设备联调,不能把“测试发送成功”当作外设执行确认。