大彩讲堂：VisualHMI软件如何使用RTC时间控件

发布人：大彩科技发布日期：2026-03-23

一、概述

本文档适合于 M 系列（固件版本 >= V10.0.7.0）串口屏，在 VisualHMI 平台上开发。

时间可以通过数值或钟表形式来显示。用户还可以通过 MCU 读写对应寄存器来同步时间。也可以通过设置弹出系统键盘，对时间进行输入编辑，然后显示在串口屏上。

本文档介绍时间的显示方式：

1. RTC 控件→文字显示，12小时/24小时制切换显示

2. 钟表控件→钟表显示

PS:虚拟屏不支持修改 RTC

二、开发环境

2.1 VisualHMI 软件版本
需安装V1.0.270.0及以上的版本进行开发。打开VisualHMI软件，在工程→帮助→关于，可查看到当前安装的软件版本，如图2-1所示；

图2-1 VisualHMI软件版本

2.2 串口屏固件版本

版本查看，可通过屏幕背面的贴纸查看。

三、RTC控件

3.1 属性说明

选中菜单栏→控件→【RTC控件】，如图3-1所示。

图3-1 RTC控件

3.1.1显示属性

RTC的显示属性如图3-2所示。

图3-2 显示属性

1. 日期：显示格式可设置为“YYYY/MM/DD”、 “MM/DD/YYYY”、 “DD/MM/YYYY”、“不显示”
2. 星期：显示格式可设置为：显示、不显示。默认显示为英文（SUM、MON、TUE、WED、THU、FRI、STA、AM、PM）
3. 时间：显示格式可设置为：“HH/MM/SS”、“HH/MM”

·12小时制：勾选，显示00：00~11：59；未勾选：显示00：00~23：59

·显示AM：可设置为“不显示”、“左侧”、“右侧”

4. 设置时间：弹出键盘，键值输入修改时间，可设置为“禁止”、“长按3S进入”、“点击进入”

·模式：可设置修改的类型，分别有“日期和时间”、“日期”、“时间”

·键盘画面：弹出键盘的位置。可设置“点击出”、“自定义”

4.1.2 字体属性

RTC控件字体属性如图3-3所示。

图3-3 RTC控件字体属性

1. 字体：字库选择

2. 字体大小：字号设置

3. 字体颜色：字体颜色设置

4. 水平对齐：可设置“左”、“居中”、“右”。

四、钟表控件

4.1 属性说明
选中菜单栏→控件→【RTC控件】，如图4-1所示。

图4-1 钟表控件

4.1.1 功能属性
钟表控件的显示属性如图4-2所示。

图4-2 显示属性

1. 指针：类型有时针、分针、秒针

4.1.2 外观属性
钟表控件字体属性如图4-3所示。

图4-3 钟表外观属性

1. 字体：指针图库
2. 旋转中心：X、Y，表示为指针旋转的位置
X一般为图片控件宽度一半；Y为控件的高度

五、应用案例

5.1 工程配置
5.1.1 RTC控件配置

RTC控件，用于演示时间、日期分开时显示；12小时制、24小时制的切换显示在画面中添加一个【RTC控件】，只显示“年月日 星期”，RTC 控件配置如图5- 1所示：

1. 日期：选择“YYYY/MM/DD”；

2. 星期：显示；

3. 时间：不显示；

4. 设置时间：长按 3S 进入；

·模式：设置修改类型为“日期和时间”；

·键盘画面：选择自带的键盘画面；

·键盘位置：点击处；

5. 启动多语言： 将星期设置为中文；

6. 字体颜色： 白色（255,255,255）

图5-1 RTC属性设置

在画面中添加两个【RTC控件】显示“时：分：秒”，一个12小时制显示，另外一个显示24小时显示。

12小时制的 RTC 控件配置如图5-2所示：

1. 12小时制：开启

    ·显示 AM：右侧

2. 控制权限：

    ·条件地址：LW1001

    ·比较：等于

    ·值：1

当0x1001 寄存器的值为1的时候，显示该控件。当0x1001寄存器的值不为1，该RTC控件不显示。

图5-2 RTC 12小时制属性设置

24小时制的RTC控件配置如图5-3所示：

1. 12 小时制：不勾选

2. 控制权限：

    ·条件地址：LW1001

    ·比较：等于

    ·值：0

当0x1001寄存器的值为0的时候，显示该控件。当0x1001寄存器的值不为0，该RTC控件不显示。

图5-3 RTC 24小时制属性设置

添加一个【位状态指示灯】控件，用于控制12小时、24小时制的RTC控件显示隐藏，配置如图5-4所示：

1. 读取地址为：LW1001

2. 切换开关：勾选

3. 开关类型：切换开关

4. 使用图库：选择按下的图片

图5-4 位状态指示灯属性设置

5.1.2 钟表显示

画面中添加3个钟表控件，关联对应的图库文件。分别用于时针、分针、秒针显示。如“秒针”的配置如图5-5所示

1. 指针：秒针

2. 指针图库：

    ·旋转中心： X = 1， Y = 122。

图5-5 钟表控件属性设置

5.2 运行预览

运行虚拟屏显示的时间是电脑系统时间。虚拟屏不支持弹出键盘修改，或串口指令修改。下载到实体屏后，支持键盘输入、指令修改。运行虚拟屏，12小时制如图5-6所示：

图5-6 12小时制显示

24小时制如图5-7所示：

图5-7 24小时制显示

MCU指令读写RTC，相关寄存器如下所示：

5.2.1 MCU写RTC

MCU写0x0160~0x0167寄存器， 其中对0x0167设置日期时间寄存器，写固定0x5501值，如下所示：

5.2.2 MCU读RTC

MCU读RTC，寄存器为0x0170~0x0176，如下所示：

屏幕应MCU请求，如下所示：