命令通讯返回值介绍,包含执行错误

通讯指令返回值介绍 1

条件

只有当系统变量bkcmd为非0的时候才会返回指令执行成功或者失败数据。

格式

返回指令格式为 命令码(1字节)+参数(长度随命令码而不同)+结束符(2字节,“\r\n”)

数据

所有指令名以及参数全部16进制数据,非ASCII数据,便于软件解析。

通讯指令返回值介绍 2

命令码

含义

格式

参数说明

0x00

指令执行结果

执行结果代码 +返回数据 +结束符(\r\n)

执行结果代码:1字节 0x00 指令执行成功 0x01 命令码无效(指令第一个字符串无效) 0x02 指令参数1无效(指令第二个字符串无效) 0x03 指令参数2无效(指令第三个字符串无效) 0x04 指令参数3无效(指令第四个字符串无效) 0x05 指令参数4无效(指令第五个字符串无效) 0x06 指令参数5无效(指令第六个字符串无效) 0x07 指令参数个数fa 0x08 串口接收超时

说明: 命令执行结果返回值,主要用于客户取得串口屏控件的属性值,响应客户发送的命令,如果客户发送的指令有错,例如命令码拼写错误,属性名称拼写错误,属性名称拼写错误等,造成串口屏不能解析,将返回不同的错误码,方便客户查错。 只有当系统变量bkcmd为非0的时候才会返回指令执行成功或者失败数据。 这个命令提供了一种客户的调试命令的方式,大部分情况下,在调试完毕后,都会把系统变量bkcmd置0,不会收到此命令。 举例:如果客户发送指令的命令码拼写错误,返回:“00010d0a”。解释:从左到右,00 表示返回的命令码,01表示命令码无效,0d表示 \r,0a表示 \n。

0x01

整数返回

0x01+4字节整数+结束符

4字节整数:4字节小端模式存储,低字节在前

0x02

小数返回

0x02+4字节小数+结束符

4字节小数:4字节小端模式存储,低字节在前

0x03

字符串返回

0x03+字符串+结束符

字符串:GBK编码

返回结果包括客户发起的命令执行情况和需要返回的数据。执行情况即执行结果,需要返回的数据主要是取串口屏控件属性的值。值的类型为整数,小数,字符串。 举例:获取按钮1的x坐标。发送指令“wget button1 x\r\n”,返回为:“01880000000d0a” 解释:01 表示返回值为整数;88000000表示位buttton1的 x坐标,低字节在前的格式;0D0A是命令结束符。 如果系统变量bkcmd没有设置为0,这个指令会接收到两个返回指令,“00000d0a”,和“01880000000d0a”,第一个指令表示命令执行成功,第二个指令是用户需要的结果。如果系统变量bkcmd设置为0,则只返回第二个指令(默认不返回执行成功或失败)。