基本型串口HMI指令表.docxVIP

基本型串口HMI指令表 ?注 ： 1. 设备接受指令结束符为 ” 0XFF 0XFF 0XFF ” 三个字节 。2. 所有指令名以及参数全部使用ASCII 字符串格式 ， 非二进制数据 ， 便于阅读和调试 。3. 所有指令名使用小写字母(此处仅仅指的是指令名称为小写 ， 参数该大写的时候还是要大写) 。分类一: 对象及系统操作指令1.page 刷新页面page pageidpageid:页面 ID 或页面名称实例 1:page 0 (刷新页面 ID 为 0 的页面)实例 2:page main (刷新页面名称为 main 的页面)备注：设备上电自动刷新第 0 页。2.ref 重绘控件ref objnameobjname:控件名称实例:ref t0 (重绘控件 t0)备注：1. 为了防止连续改变多个属性的时候重复刷新产生闪烁感，所以每个控件只有一个属性修改的时候会自动重绘 (属性操作区里绿色加粗字体的属性修改时才会自动重绘)，其他属性修改的时候需要使用 ref 来手动重绘。2.上位界面编辑软件创建控件的时候默认加载方式为自动加载， 如果设置为手动加载， 就需要通过 ref 指令来加 载,或者当您的控件被你的 gui 指令绘图遮挡以后，或者被手动加载的别的控件遮挡以后，可以使用重绘指令来 重绘控件。3.get 带格式获取变量值/常量值get attatt:变量名称 实例1:get t0.txt (返回控件t0的txt属性值)?? 实例2:get j0.val(返回控件j0的val属性值)实例3:get “123”(返回常量字符串”123”)?? ??实例4:get 123(返回常量数值：”123”)备注： 1.使用get指令获取的变量为字符串类型时，返回的数据为0X70+字符串内码+结束符，如果是数值类型(如进度条的val属性)设备返回0X71+变量的4字节十六进制数据+结束符。数值的存放模式为小端模式（即低位在前，高位在后）。 2.get指令可以由串口发送，也可以在上位软件编辑界写进用户代码中实现屏幕主动发送变量(主动发送的时候可以配合printh指令在前面加一段自定义标示来告诉单片机此变量是属于哪个控件的)。 3.get指令和print指令很类似,唯一的区别是get返回的数据带了起始标示符（0x70或0x71）和结束符(0xff 0xff 0xff)，而print没有。 3..数据具体返回格式请查看本表格后面的”基本型串口HMI设备返回数据格式。4.print 无格式获取变量值/常量值print attatt:变量名称 实例1: print t0.txt (返回控件t0的txt属性值)?? 实例2: print j0.val(返回控件j0的val属性值)实例 3: print “123”(返回常量字符串”123”即：0x31 0x32 0x33)实例 4: print 123(返回常量数值：123 即: 0x7b 0x00 0x00 0x00)备注： 1.使用print指令获取的变量为字符串类型时，设备直接返回字符串内码，如果是数值类型(如进度条的val属性)设备直接返回变量的4字节十六进制数据，数值的存放模式为小端模式（即低位在前，高位在后）。 2.使用print指令获取数据的时候，设备仅仅只发送数据内容，没有起始标示符，也没有结束符。 3.print指令可以配合printh指令在前面加一段自定义标示来告诉单片机此变量是属于哪个控件的)。 4. print指令和get指令很类似,唯一的区别是get返回的数据带了起始标示符（0x70或0x71）和结束符(0xff 0xff 0xff)，而print没有。5.printh 让设备的串口发送自定义16进制byteprinth hexhex:需要发送的字符的16进制字符串表达式 实例:printh d0 a0(让设备发送0xd0 0xa0两个字节)备注： 1.使用printh指令发送数据的时候，设备仅仅只发送指定的字符，不会发起始符，不会发空格,不会发结束符。 2.参数中每组字符间必须有且只能有一个空格隔开，16进制的字符串表达式大小写均支持。6.add 往曲线控件添加数据add objid,ch,valobjid:曲线控件ID序号 ch:曲线控件通道号 val:数据 (最大255，最小0)实例1:add 1,0,30 (往曲线ID为1的曲线控件的0通道添加数据30)实例2:add 1,1,50 (往曲线ID为1的曲线控件的1通道添加数据50)备注： 1.每个page页面最多支持4个曲线控件,每个曲线控件最多支持4个通道。可以连续发送数据，控件会自动平推显示数据.在发送数据的过程中也可以随时修改控件属性，比如随时修改各个通道的前景色或背景色7.sendme 发送当前页面ID号到串口s