命令通讯返回值介绍,包含执行错误
通讯指令返回值介绍 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,则只返回第二个指令(默认不返回执行成功或失败)。 |