VisualHMI 键盘详解:默认键盘/10 个键盘管理/SysKB 系统寄存器/虚拟按键

freeFree Technical Resource

This content is free to read, suitable for basic learning and search traffic.

numerical value、Text、密码输入都会弹键盘。VisualHMI 的键盘是可编程的画面——键盘上的键是「虚拟按键」control,背后靠几个系统寄存器驱动。这篇把键盘管理和系统寄存器讲清楚,懂了这个,自定义键盘就不难。

1. 默认键盘

新建工程默认生成两个键盘:全键盘数字键盘。文本输入支持 GBK、UTF8 Coding。

VisualHMI 键盘详解:默认键盘/10 个键盘管理/SysKB 系统寄存器/虚拟按键插图

VisualHMI 键盘详解:默认键盘/10 个键盘管理/SysKB 系统寄存器/虚拟按键插图1

不同型号、不同旋转角度,默认生成的键盘布局不一样。2.4寸、2.8寸小尺寸屏幕默认只生成数字键盘。切换型号/角度后,在【工程】→【键盘】里点【恢复默认键盘】重新生成。

2. 键盘管理

HMI 最多支持 10 个键盘,在【工程】→【键盘】设置:

  • Enable:勾选后可用
  • 键盘画面:启用后选择对应画面作为键盘画面;键盘画面可以复用(如数字键盘和密码键盘共用一个画面)
  • 恢复默认键盘:按屏幕分辨率恢复默认键盘画面 100_digitxxxxxx、101_digitxxxxxx

VisualHMI 键盘详解:默认键盘/10 个键盘管理/SysKB 系统寄存器/虚拟按键插图2

⚠️ 如果把密码键盘删除,安全等级下将无法输入密码。删键盘前想清楚。

3. 键盘系统寄存器(自定义键盘的核心)

register作用
SysKBMax / SysKBMin数字键盘显示范围的最大值/minimum(跟随数值控件配置的范围)
SysKBSelect键盘模式:0=英文,1=数字符号,2=中文
SysKBPinyin / SysKBHanzi中文输入的拼音、预选汉字显示
SysKBText显示键盘录入的数据

VisualHMI 键盘详解:默认键盘/10 个键盘管理/SysKB 系统寄存器/虚拟按键插图3

3.1 SysKBMax/Min:范围限制显示

数值控件配置了范围(如 0~100),弹出数字键盘会显示限定的最大/minimum。键盘画面上用两个数值控件显示 SysKBMin/SysKBMax,用 SysKBStatus.1 控制显示/隐藏(1=配置了范围限定)。

VisualHMI 键盘详解:默认键盘/10 个键盘管理/SysKB 系统寄存器/虚拟按键插图4

3.2 SysKBSelect:模式切换

0=英文(a~z、A~Z)、1=数字符号(!?#123)、2=中文。键盘上放递增/递减按钮写 SysKBSelect(0~2 循环),配 3 个多状态指示灯显示当前模式。

VisualHMI 键盘详解:默认键盘/10 个键盘管理/SysKB 系统寄存器/虚拟按键插图5

3.3 SysKBPinyin/SysKBHanzi:中文输入

输入 「guang」,SysKBHanzi 预选汉字显示「光 广 逛 咣...」。键盘画面加两个文本控件分别关联这两个寄存器。

VisualHMI 键盘详解:默认键盘/10 个键盘管理/SysKB 系统寄存器/虚拟按键插图6

3.4 SysKBText:录入数据显示

显示键盘录入的内容,键盘画面加一个文本控件关联它。

VisualHMI 键盘详解:默认键盘/10 个键盘管理/SysKB 系统寄存器/虚拟按键插图7

4. 虚拟按键(键盘的「键」)

功能按钮的用途设为虚拟按键,就变成键盘上的键。支持的按键类型:

Type说明Type说明
characters0~9、a~z、可视化字符等Left预选汉字向左翻页
切换键盘切换到目标键盘Right预选汉字向右翻页
Enter回车Shitf字符切换(大小写/符号)
Space空格ESC退出
지우기删除所有输入Delete删除单个字符

VisualHMI 键盘详解:默认键盘/10 个键盘管理/SysKB 系统寄存器/虚拟按键插图8

characters键最多填 4 个字符,多字符切换靠 Shitf 或 SysKBSelect:

  • 填入 "q1":SysKBSelect=0(字母)时键码为 q;SysKBSelect=1(characters)时键码为 1
  • 填入 "a~^":字母模式下 Shitf=0 录 a、Shitf=1 录 A;字符模式下 Shitf=0 录 ~、Shitf=1 录 ^

VisualHMI 键盘详解:默认键盘/10 个键盘管理/SysKB 系统寄存器/虚拟按键插图9

还有 图库状态(关联弹起/按下图库)、裁剪使用文字(把字符栏内容直接显示出来)等属性。

5. 中文输入:Left/Right 翻页

中文键盘输入 「da」,预选汉字显示「大 打 达 答 搭...」。键盘画面上加两个功能按钮(虚拟按键→Left/Right)在预选汉字左右翻页。

VisualHMI 键盘详解:默认键盘/10 个键盘管理/SysKB 系统寄存器/虚拟按键插图10

VisualHMI 键盘详解:默认键盘/10 个键盘管理/SysKB 系统寄存器/虚拟按键插图11

6. 键盘切换

键盘画面可以用虚拟按键(Type=切换键盘)互相切换。例程中建 3 个画面 「105_abc」、「106_number」、「107_char」,用切换按键在各键盘间跳转。

VisualHMI 键盘详解:默认键盘/10 个键盘管理/SysKB 系统寄存器/虚拟按键插图12

自定义键盘调试顺序:先确认系统寄存器值对不对(模式/范围/录入),再查虚拟按键类型和字符栏——90% 的键盘问题出在「键的类型选错」或「字符栏填错」。

整理自 广州大彩科技 VisualHMI 开发文档(hmi-doc.gz-dc.com)Resource Introduction「键盘」,版权归大彩科技所有。

Put this resource to use in a real project?

Go to the Tool Center for message parsing, CRC 검증 and device debugging, or submit your requirements for selection and integration advice.

Engineer Membership

Turn this article into actionable debugging resources

After activation, you can use advanced message parsing, resource pack downloads, code examples, engineering cases and priority technical support, suitable for real project delivery.

Unlimited Advanced Tools
Resource & Code Packs
Complete Engineering Case Library
Priority Technical Support

Leave a Reply

Your email 주소 will not be published. Required fields are marked *.