USART HMI 资料中心

官方技术交流QQ群:916560014

站点工具


目录索引

6.指令集:3.系统变量

串口HMI系统变量列表


注:所有变量名称使用小写字符

序号

名称

含义

示例/备注

1

dp

当前页面ID

1.dp=1 (设置当前页面为1,等同于page 1)

2.prints dp,0(发送当面页面ID到串口)

3.n0.val=dp (当前页面ID赋值给n0.val)

2

dim

当前背光亮度值(0-100)

1.dim=50   2.dim=dim+10   3.dim=dim-10

3

dims

上电默认背光亮度值(0-100)

1.dims=50   2.dims=dims+10   3.dims=dims-10

4

baud

当前波特率值

(本次修改,掉电后丢失)

baud=9600

备注:

设备支持的波特率有:2400 4800 9600 19200 38400 57600 115200

230400 256000 512000 921600

5

bauds

上电默认波特率值

(掉电后保存,下次上电后继续有效)

bauds=9600

6

spax

字符显示横向间距(上电默认为0)

spax=2

备注:

仅对xstr指令写出来的字符有效,控件带的字符显示间距由控件内部的属性决定。

7

spay

字符显示纵向间距(上电默认为0)

spay=2

备注:

仅对xstr指令写出来的字符有效,控件带的字符显示间距由控件内部的属性决定。

8

thc

触摸绘图时的画笔色

1.thc=RED   2.thc=1024

9

thdra

触摸绘图功能开关

thdra=0   (关闭)   thdra=1(打开)

10

ussp

无串口数据自动睡眠时间(单位:秒,最小3,最大65535,上电默认0[0为关闭串口数据超时自动睡眠])

ussp=30(30秒无串口数据自动进入睡眠模式)

 

11

thsp

无触摸操作自动睡眠时间(单位:秒,最小3,最大65535,上电默认0[0为关闭触摸超时自动睡眠])

thsp=30(30秒无触摸操作自动进入睡眠模式)

12

thup

睡眠模式下触摸自动唤醒开关(上电默认0)

thup=0(睡眠后触摸不会自动唤醒)

thup=1(睡眠后触摸自动唤醒)

备注:

不管thup为0还是1,睡眠模式下有触摸操作的时候设备均会发送触摸坐标到串口。

13

usup

睡眠模式下串口数据自动唤醒开关(上电默认0)

usup=0(睡眠后串口不会自动唤醒)

usup=1(睡眠后串口自动唤醒)

备注:

上电默认为0,不会自定唤醒,需要发送sleep=0才能唤醒屏幕,如果设置为1,串口收到任何数据都会立刻自动唤醒。

14

wup

睡眠唤醒后刷新页面设置

wup=255(上电默认,睡眠唤醒后刷新睡眠前页面)

wup=2   (睡眠唤醒后刷新页面指定页面:2)

备注:

设备已经在睡眠状态下,也可以执行串口传过来的wup=X赋值。

15

sleep

睡眠

sleep=0   (退出睡眠)

sleep=1   (进入睡眠)

备注:

睡眠状态下可以执行如下指令:get,print, printh。 也可以 执行 sleep=1,wup=X 的赋值语句,并且支持上位软件联机,其他指令不会执行。如果是带扩展IO的硬件,IO配置为绑定控件事件时,睡眠模式下也不会产生中断事件。

16

bkcmd

设置串口指令执行成功或者失败的数据返回(上电默认为2)

bkcmd=0(不返回结果)

bkcmd=1(只返回成功的结果)

bkcmd=2(只返回失败的结果)

bkcmd=3(成功或者失败都返回结果)

备注:

此设置只影响串口指令执行成功或者失败的结果返回,上位软件编辑界面时写入的指令执行错误的时候一定会返回错误结果,成功的时候一定不会返回执行结果。此设置也不会影响获取设备控件数据时的数据返回。

17

sendxy

实时发送触摸坐标功能开关

sendxy=0(关闭)   sendxy=1(打开)

备注:

1打开发送功能以后,有触摸按下的时候设备会通过串口发送触摸坐标。

2.发送坐标的格式请参看本表格后面的”串口HMI设备返回数据格式”表格。

18

delay

延时

delay=100   (让设备停顿100ms)

备注:

执行延时指令后,设备CPU不会执行任何指令,但是会继续接受串口指令保存到串口指令缓存区。

19

rand

随机数

dim=rand (把一个随机数赋值给背光亮度)

n0.val=rand (把一个随机数赋值给n0.val变量)

备注:

1.使用随机数之前需要先使用randset指令设定一次随机数产生范围,如果不设置,默认是最小0,最大2147483647。设置完范围以后,每读取一次系统变量rand将会得到一个随机数。

2.使用randset指令每设定一次范围,将一直有效,直到重新上电或者设备复位才会恢复默认。

20

tch0-tch3

实时触摸坐标

tch0:当前触摸坐标X

tch1:当前触摸坐标Y

tch2:上一次按下时的坐标X

tch3:上一次按下时的坐标y

备注:

触摸坐标只能读取,不能赋值,没有按下时,实时坐标数据为0。

21

addr

设备地址

字符串写法:addr=256

HEX写法:addr=0x0100

以上两条写法是同一个意思,配置的是同一个地址,配置之后有断电保存功能。

备注:

1.  有效地址范围为256-2815

(即0x0100-0x0aff),0为无地址,65535为广播地址,广播地址只能用于广播数据,不能配置某个设备为广播地址,出厂默认地址为0,即没有地址。

2.向一个有地址的设备发送指令时,需要在指令前加上2字节的地址数据,以hex方式发送,2字节小端模式,比如设备配置的地址为addr=256,那么发送给他指令时需要在指令前面增加两个字节:0x00 0x01(注意,配置的时候是0x0100,发送指令的时候是低位在前,所以是0x00 0x01跟配置的写法是相反的)。

22

crcval

crc校验结果

(只可获取不可设置,使用前请先用crcrest指令复位初始值)

n0.val=crcval    (当前CRC校验结果赋值给n0.val)

prints crcval,2  (当前CRC校验结果的低2位打印到串口)

备注:

1.先使用crcrest复位CRC值,复位之后,可使用crcputs或crcputh或crcputu校验指定数据,检验完毕读取系统变量crcval获得校验结果)

2.完整的CRC校验实例代码请参考:程序中使用CRC校验数据

23

rtc0-rtc6

RTC时钟变量

(带RTC的硬件才支持)

n0.val=rtc5 (当前RTC的秒数值赋值给n0.val)

rtc0=2016(RTC的年设置为2016)

cov rtc5,t0.txt,0(当前RTC的秒数值转换给t0.txt)

备注:

1.rtc0-rtc6分别表示年,月,日,时,分,秒,星期。

2.rtc6(星期)为只读。根据当前的年月日自动计算生成。

24

pio0-pio7

扩展IO端口

(带扩展IO的硬件才支持)

pio4=1        (IO4置为1)

n0.val=pio2 (io2的电平状态赋值给n0.val)

cov pio3,t0.txt,0 (io3的电平状态转换给t0.txt)

备注:

1.使用pio端口之前一定要先使用cfgpio指令配置好IO模式。

2.上电默认所有扩展IO模式为上拉输入(内部上拉电阻为50K)。

25

pwm4-pwm7

扩展IO占空比

(带扩展IO的硬件才支持)

K0系列仅io4-io7支持PWM

X5系列仅io6-io7支持PWM

pwm6=30  (设置pwm6占空比为30)

pwm7=90  (设置pwm7占空比为90)

备注:

1. 占空比最小值0最大值100,上电默认50。

2.pwm4-pwm7依次对应扩展IO中的io4-io7,

3.设置好PWM占空比以后,需要使用cfgpio指令配置此IO的模式为PWM输出模式,相应IO才会开始输出PWM,配置完PWM模式后在PWM输出的过程中可以随时修改占空比,不用重新配置。

4. 上电默认所有扩展IO模式为上拉输入(内部上拉电阻为50K)。

26

pwmf

PWM输出的频率

(带扩展IO的硬件才支持)

pwmf=1024 (设置pwm的频率为1024HZ)

n0.val=pwmf (将PWM频率赋值给n0.val)

cov pwmf,t0.txt(将PWM频率转换给t0.txt)

备注:

1.频率单位为:HZ,范围为最小1,最大65535HZ,上电默认1000HZ。

2.所有PWM输出统一为一个频率,不可单独设置。

27

eql

eqm

eqh

eql-低音衰减(31HZ-125HZ)

eqm-中音衰减(250HZ-2000HZ)

eqh-高音衰减(4000HZ-1600HZ)

(带音频的硬件才支持)

上位模拟器不支持

设置范围0-15

0-6为衰减,数字越小衰减越大

8-15为提升,数字越大提升越大

7为平衡,无衰减,无提升

备注:

系统底层是按eq0-eq9的设置来操作的,如果分别修改eql,eqm,eqh等同于分别修改eq0-eq2, eq3-eq6, eq7-eq9;但是修改eq0-eq9并不会影响到eql,eqm,eqh的值。

28

eq0-eq9

独立频点衰减

(带音频的硬件才支持)

上位模拟器不支持

eq0@31HZ   eq1@62HZ     eq2@125HZ

eq3@250HZ  eq4@500HZ    eq5@1000HZ

eq6@2000HZ   eq7@4000HZ eq8@8000HZ

eq9@16000HZ

设置范围0-15

0-6为衰减,数字越小衰减越大

8-15为提升,数字越大提升越大

7为平衡,无衰减,无提升

备注:

系统底层是按eq0-eq9的设置来操作的,如果分别修改eql,eqm,eqh等同于分别修改eq0-eq2, eq3-eq6, eq7-eq9;但是修改eq0-eq9并不会影响到eql,eqm,eqh的值。

29

volume

系统音量  (最小0,最大100)

(带音频的硬件才支持)

volume=60(设置音量60)

备注:

音量设置范围为0-100,每次设置会自动保存,断电后再开机依然有效。

30

audio0

audio1

音频通道控制

0-停止;1-播放;2-暂停

(带音频的硬件才支持)

audio0=2      (暂停0通道的音频播放)

audio0=0      (停止0通道的音频播放)

audio1=1      (继续1通道的音频播放)

备注:

1.play指令用于配置和启动音频播放

系统变量audio0,audio1用于控制通道状态。

2.只有当通道状态在暂停的时候,才能配置为继续播放。如果通道状态为停止,将不能配置为继续播放,需要使用play指令来配置并启动播放。

3.音频播放功能是全局的,不属于某个页面,因此play指令启动播放后,即便是跳转页面,音频依然会继续播放,如果希望离开页面后停止播放,可以在页面的离开事件中使用audio0

/audio1系统变量来关闭或暂停指定通道的音频播放状态。



串口HMI颜色代号表

注:所有代号的书写均为大写

代号

10进制

所表示的颜色

RED

63488

红色

BLUE

31

蓝色

GRAY

33840

灰色

BLACK

0

黑色

WHITE

65535

白色

GREEN

2016

绿色

BROWN

48192

橙色

YELLOW

65504

黄色

 


6.指令集/3.系统变量.txt · 最后更改: 2020/04/08 13:35 由 admin        浏览次数:48578/1822370(本页/全站)