恒域威串口屏F系列指令集_V1.0.docx

PAGE2/NUMPAGES2

指令集

恒域威F系列串口屏指令集

类别

内容

关键词

F系列-指令集

摘要

版本

日期

原因

V1.0

2021/09/01

创建文档

销售与服务

深圳市恒域威电子有限公司

销售热线：0755咨询电话售后电话Email：hywdz@126.com

网站：

公司地址：深圳市宝安区西乡固戍钜鑫科技产业园E栋5层

TOC\o1-2\h\z\u指令集 1

销售与服务 3

本文档适合F系列串口屏产品。 6

1.指令格式和指令集 7

1.1指令格式 7

1.2颜色格式 7

1.3组态指令集与基本指令集区别 8

1.4如何快速熟悉指令集 8

1.5指令速查表 9

2.组态指令集详述 22

2.1页面元素 22

2.2按钮元素 23

2.3文本元素 24

2.4进度条元素 30

2.5滑块元素 33

2.6动画元素 35

2.7图标元素 36

2.8实时曲线元素 37

2.9菜单元素 38

2.10滑动选择元素 39

2.11二维码元素 40

2.12RTC元素 41

2.13列表元素 43

2.14历史曲线元素 47

2.15旋转控件 49

2.16圆形进度条元素 49

2.17视频控件 51

2.18音频控件 51

2.19控件通用指令 53

3.系统屏指令集详述 56

4.基本图形指令集详述 63

本文档适合F系列串口屏产品。

1.指令格式和指令集

1.1指令格式

一条完整的串口指令帧格式如表1.1所示。命令、子命令为1个字节，页面ID、元素ID各占2个字节，命令参数长度为2个字节，大于1个字节的字段，高字节在前、低字节在后（例如01的双字节表示为0x000x01）。数值均为十六进制。串口格式：8位数据位、1位停止位、无效验位。

表1.1无CRC校验指令帧格式

指令

E7

XX

XX

XXXX

XXXX

XXXX

XXXX…XXX

AA55E7

说明

帧头

命令

子命令

页面ID

元素ID

命令参数长度

命令参数

帧尾

若用户需要指令支持CRC格式效验，则指令帧格如表1.2所示。CRC校验不含帧头和帧尾（2个字节）。

表1.2带CRC校验的指令帧格式

指令

E7

XX

XX

XXXX

XXXX

XXXX

XXXX…XXX

XXXX

AA55E7

说明

帧头

命令

子命令

页面ID

元素ID

命令参数长度

命令参数

校验位

帧尾

指令信息大的结构由帧头+消息体+校验+帧尾组成。详细规定如下：

1）帧头：1个字节，E7（固定）

2）消息体：

（1）命令：1个字节

（2）子命令：1个字节

（3）页面ID：2个字节（高字节在前）

（4）元素ID：2个字节（高字节在前）

（5）命令参数长度：2个字节（高字节在前）

（6）命令参数：n字节（大于1个字节，高字节在前）

3）校验位：2个字节，消息体数据的CRC16校验

4）帧尾：3个字节AA55E7（固定）

1.2颜色格式

设备支持24真彩色，RGB占3个字节，其高低字节分配如表1.3所示。

表1.3RGB颜色分配格式

位数(Bit)

16-23

8-15

0-7

颜色分配

R

G

B

举例说明：纯红色=FF0000，纯蓝色=0000FF

1.3组态指令集与基本指令集区别

指令集分两部分：组态控件指令集和系统指令集。

系统指令集可以理解为串口屏系统基本指令集，大部分对应串口屏的系统、网络等参数信息；组态指令集直接是面向对象ID操作，而这些对象的相关参数全部预先在上位机软件中进行了配置，与图片一起下载到了屏的存储器中。

1.4如何快速熟悉指令集

串口屏指令集众多，用户可以利用配套的串口调试板进行屏与上位机联机调试。通过上位机内置的指令助手下发串口命令，模拟用户单片机主机，即可快速熟悉指令功能。屏幕与上位机联机和指令助手分别如图1-1、图1-2所示。

图1-1屏幕与上位机联机接线图

图1-2指令助手

1.5指令速查表

类别

指令名称

指令ID

参数

参数说明

指令说明

元素指令

设置前景色

0xB00x01

Page_id+Control_id+RGB

RGB（3个字节）

设置控件的前景色（支持前景色的控件可用，例如文本进度条控件）

设置背景色

0xB00x02

Page_id+C