恒域威F系列串口屏指令集速查：帧格式、常用指令与联机调试

发布日期： 2026-11-04

给串口屏做上位机对接，第一步就是吃透指令集。本文把恒域威 F 系列串口屏指令集（V1.0）中最常用的部分整理成速查版：指令帧格式、常用控制指令、以及快速上手的联机调试方法。完整 66 页文档可在恒域威官网下载中心获取。

一、指令帧格式：E7 开头、AA 55 E7 结尾

F 系列一条完整的串口指令帧结构为：帧头 + 消息体 + 校验位 + 帧尾。

串口格式为 8 位数据位、1 位停止位、无校验位。数值均为十六进制，例如 01 的双字节表示为 0x00 0x01。设备支持 24 位真彩色，RGB 占 3 个字节（纯红 FF0000、纯蓝 0000FF）。

F 系列指令分两部分：系统指令集对应串口屏系统与网络等参数信息；组态指令集直接面向页面/控件 ID 操作，控件参数已在上位机软件中预先配置并与图片一起下载到屏存储器。日常业务开发绝大多数时间在与组态指令集打交道。

子命令	功能	参数要点
0x01 / 0x02	设置控件前景色 / 背景色	Page_id + Control_id + RGB（3 字节）
0x04 / 0x05	设置控件区域 / 位置	X、Y、W、H 各 2 字节，屏幕左上角为 (0,0)
0x06	设置控件数据值	适用于进度条、文本、仪表盘、滑块、二维码等
0x07	读取控件数据值	Page_id + Control_id，无附加参数
0x08	批量更新控件数值	一次更新指定页面内多个控件，适合高频刷新
0x09 / 0x0A	设置 / 读取控件启用禁用	Enable：0x00 禁止、0x01 可用
0x0B / 0x0C	设置 / 读取控件显示隐藏	Enable：0x00 隐藏、0x01 显示
0x20 / 0x21	切换页面 / 获取当前页面 ID	page_id 与 control_id 填 0x0000
0x30	控件变化报告（屏→MCU）	上报哪个画面第几个按钮被按下，含按钮子类型与状态
0x35 / 0x36	文本闪烁周期 / 滚动速度	闪烁周期以 10 毫秒为单位，滚动速度为每秒像素
0x38	格式化文本显示	支持 Unsigned int / int / float / double，可指定小数位补 0
0x40~0x44	动画控制（GIF）	启动 / 停止 / 暂停 / 指定帧播放 / 上一帧下一帧
0x50~0x52	曲线数据通道	共 8 个数据通道（0~7），支持指定通道添加数据

指令条目多，不建议死记。推荐用配套的指令助手 + 串口调试板联机调试：通过上位机内置的指令助手下发串口命令，模拟用户单片机主机，点哪个指令就发哪条帧，屏的响应一目了然。配合《指令助手与虚拟串口屏联机通信》文档，半天即可把常用指令跑通一遍。

完整文档下载：恒域威开发者资料库（下载中心），含《恒域威串口屏F系列指令集 V1.0》全文 66 页。

配套资料下载

本文涉及的指令帧格式与常用指令，均整理自恒域威官方指令集文档（PDF 原件已收录下载中心，可按分类获取）。