注:所有变量名称使用小写字符
序号 | 名称 | 含义 | 示例/备注 |
当前页面ID | 1.dp=1 (设置当前页面为1,等同于page 1) 2.prints dp,0(发送当面页面ID到串口) 3.n0.val=dp (当前页面ID赋值给n0.val) | ||
当前背光亮度值(0-100) | 1.dim=50 2.dim=dim+10 3.dim=dim-10 | ||
上电默认背光亮度值(0-100) (掉电后保存,下次上电后继续有效) | 1.dims=50 2.dims=dims+10 3.dims=dims-10 | ||
当前波特率值 (本次修改,掉电后丢失) | baud=9600 备注: 设备支持的波特率有:2400 4800 9600 19200 38400 57600 115200 230400 256000 512000 921600 | ||
上电默认波特率值 (掉电后保存,下次上电后继续有效) | bauds=9600 | ||
字符显示横向间距(上电默认为0) | spax=2 备注: 仅对xstr指令写出来的字符有效,控件带的字符显示间距由控件内部的属性决定。 | ||
字符显示纵向间距(上电默认为0) | spay=2 备注: 仅对xstr指令写出来的字符有效,控件带的字符显示间距由控件内部的属性决定。 | ||
触摸绘图时的画笔色 | 1.thc=RED 2.thc=1024 | ||
触摸绘图功能开关 | thdra=0 (关闭) thdra=1(打开) | ||
无串口数据自动睡眠时间(单位:秒,最小3,最大65535,上电默认0[0为关闭串口数据超时自动睡眠]) | ussp=30(30秒无串口数据自动进入睡眠模式)
| ||
无触摸操作自动睡眠时间(单位:秒,最小3,最大65535,上电默认0[0为关闭触摸超时自动睡眠]) | thsp=30(30秒无触摸操作自动进入睡眠模式) | ||
睡眠模式下触摸自动唤醒开关(上电默认0) | thup=0(睡眠后触摸不会自动唤醒) thup=1(睡眠后触摸自动唤醒) 备注: 不管thup为0还是1,睡眠模式下有触摸操作的时候设备均会发送触摸坐标到串口。 | ||
睡眠模式下串口数据自动唤醒开关(上电默认0) | usup=0(睡眠后串口不会自动唤醒) usup=1(睡眠后串口自动唤醒) 备注: 上电默认为0,不会自定唤醒,需要发送sleep=0才能唤醒屏幕,如果设置为1,串口收到任何数据(需要加上结束符16进制3个ff)都会立刻自动唤醒。 | ||
睡眠唤醒后刷新页面设置 | wup=255(上电默认,睡眠唤醒后刷新睡眠前页面) wup=2 (睡眠唤醒后刷新页面指定页面:2) 备注: 设备已经在睡眠状态下,也可以执行串口传过来的wup=X赋值。 | ||
睡眠 | sleep=0 (退出睡眠) sleep=1 (进入睡眠) 备注: 睡眠状态下可以执行如下指令:get,prints, printh。 也可以 执行 sleep=1,wup=X 的赋值语句,并且支持上位软件联机,其他指令不会执行。如果是带扩展IO的硬件,IO配置为绑定控件事件时,睡眠模式下也不会产生中断事件。 | ||
16 | lowpower | 睡眠模式设定(上电默认为0) (仅t1系列支持) | lowpower=0 (普通睡眠) lowpower=1 (深度睡眠) 备注: 普通睡眠(电流较大,但不丢串口数据);深度睡眠(电流较小,睡眠之后如果有串口数据过来会丢失前面50ms左右的串口数据) |
设置串口指令执行成功或者失败的数据返回(上电默认为2) | bkcmd=0(不返回结果) bkcmd=1(只返回成功的结果) bkcmd=2(只返回失败的结果) bkcmd=3(成功或者失败都返回结果) 备注: 此设置只影响串口指令执行成功或者失败的结果返回,上位软件编辑界面时写入的指令执行错误的时候一定会返回错误结果,成功的时候一定不会返回执行结果。此设置也不会影响获取设备控件数据时的数据返回。 | ||
实时发送触摸坐标功能开关 | sendxy=0(关闭) sendxy=1(打开) 备注: 1打开发送功能以后,有触摸按下的时候设备会通过串口发送触摸坐标。 2.发送坐标的格式请参看本表格后面的”串口HMI设备返回数据格式”表格。 | ||
延时 | delay=10 (让设备停顿10ms) 低于50ms时可以使用delay,超过50ms时建议用定时器来延时 备注: 执行延时指令后,设备CPU不会执行任何指令,但是会继续接受串口指令保存到串口指令缓存区。 | ||
随机数 | dim=rand (把一个随机数赋值给背光亮度) n0.val=rand (把一个随机数赋值给n0.val变量) 备注: 1.使用随机数之前需要先使用randset指令设定一次随机数产生范围,如果不设置,默认是最小0,最大2147483647。设置完范围以后,每读取一次系统变量rand将会得到一个随机数。 2.使用randset指令每设定一次范围,将一直有效,直到重新上电或者设备复位才会恢复默认。 | ||
实时触摸坐标 | tch0:当前触摸坐标X tch1:当前触摸坐标Y tch2:上一次按下时的坐标X tch3:上一次按下时的坐标y 备注: 触摸坐标只能读取,不能赋值,没有按下时,实时坐标数据为0。 | ||
字符串写法:addr=256 HEX写法:addr=0x0100 以上两条写法是同一个意思,配置的是同一个地址,配置之后有断电保存功能。 备注: 1. 有效地址范围为256-2815 (即0x0100-0x0aff),0为无地址,65535为广播地址,广播地址只能用于广播数据,不能配置某个设备为广播地址,出厂默认地址为0,即没有地址。 2.向一个有地址的设备发送指令时,需要在指令前加上2字节的地址数据,以hex方式发送,2字节小端模式,比如设备配置的地址为addr=256,那么发送给他指令时需要在指令前面增加两个字节:0x00 0x01(注意,配置的时候是0x0100,发送指令的时候是低位在前,所以是0x00 0x01跟配置的写法是相反的)。 3.该配置只能在实物上有效,模拟器是无法测试的。 | |||
(只可获取不可设置,使用前请先用crcrest指令复位初始值) | n0.val=crcval (当前CRC校验结果赋值给n0.val) prints crcval,2 (当前CRC校验结果的低2位打印到串口) 备注: 1.先使用crcrest复位CRC值,复位之后,可使用crcputs或crcputh或crcputu校验指定数据,检验完毕读取系统变量crcval获得校验结果) 2.完整的CRC校验实例代码请参考:程序中使用CRC校验数据 | ||
RTC时钟变量 (仅x5 k0系列才支持) | n0.val=rtc5 (当前RTC的秒数值赋值给n0.val) rtc0=2016(RTC的年设置为2016) covx rtc5,t0.txt,0,0(当前RTC的秒数值转换给t0.txt) 备注: 1.rtc0-rtc6分别表示年,月,日,时,分,秒,星期。 2.rtc6(星期)为只读。根据当前的年月日自动计算生成。 | ||
扩展IO端口 (仅x5 k0系列才支持) | pio4=1 (IO4置为1) n0.val=pio2 (io2的电平状态赋值给n0.val) covx pio3,t0.txt,0,0 (io3的电平状态转换给t0.txt) 备注: 1.使用pio端口之前一定要先使用cfgpio指令配置好IO模式。 2.上电默认所有扩展IO模式为上拉输入(内部上拉电阻为50K)。 | ||
扩展IO占空比 (仅x5 k0系列才支持) K0系列仅io4-io7支持PWM X5系列仅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)。 | ||
PWM输出的频率 (仅x5 k0系列才支持) | pwmf=1024 (设置pwm的频率为1024HZ) n0.val=pwmf (将PWM频率赋值给n0.val) covx pwmf,t0.txt,0,0(将PWM频率转换给t0.txt) 备注: 1.频率单位为:HZ,范围为最小1,最大65535HZ,上电默认1000HZ。 2.所有PWM输出统一为一个频率,不可单独设置。 | ||
eql-低音衰减(31HZ-125HZ) eqm-中音衰减(250HZ-2000HZ) eqh-高音衰减(4000HZ-1600HZ) (仅x5 x3系列才支持) 上位模拟器不支持 | 设置范围0-15 0-6为衰减,数字越小衰减越大 8-15为提升,数字越大提升越大 7为平衡,无衰减,无提升 备注: 系统底层是按eq0-eq9的设置来操作的,如果分别修改eql,eqm,eqh等同于分别修改eq0-eq2, eq3-eq6, eq7-eq9;但是修改eq0-eq9并不会影响到eql,eqm,eqh的值。 | ||
独立频点衰减 (仅x5 x3系列才支持) 上位模拟器不支持 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的值。 | ||
系统音量 (最小0,最大100) (仅x5 x3系列才支持) | volume=60(设置音量60) 备注: 音量设置范围为0-100,每次设置会自动保存,断电后再开机依然有效。 | ||
音频通道控制 0-停止;1-播放;2-暂停 (仅x5 x3系列才支持) | 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 | 黄色 |