移动机器人控制器二次开发指令集

移动机器人掌握器二次开发指令集

••・I

刖后

本文适用于熟识计算机高级语言编程或单片机编程的专业人士,使用二次开发指令集

调用掌握器的功能，还必需具备232串行通信或TCP网络编程和调试的阅历，以及熟识

ASCII码表的使用。

要使用自己电脑软件或单片机对掌握器进行二次开发，是采用掌握器的开放的二次开

发指令集，通过串口向掌握器发送指定格式的文本命令来调用掌握器功能的。

电脑系统与掌握器的通信仍可使用掌握器自带的USB转串口线；单片机开发板与掌握

器的连线需要连接四根杜邦线单片机的电源正极和地分别按掌握器的VCQ5V齐口GND,

单片机的串行口RX接掌握器的TXD，单片机的TX接掌握器的RXD，串行通信使用9600

波特率。

无论是用户使用自行开发的电脑软件还是单片机系统作为掌握器的上位机，其编程方

式都与一般的232串行通信完全全都，都是向掌握器发送符合指令格式的文本字符串，并

可接收掌握器反馈的文本字符串（假如用户需要这些反馈码对执行结果加以推断的话X用

户也可以使用常用的串口调试助手等串行通信软件来测试二次开发指令的详细功能。

为描述简便，以下将上位机发送给掌握器执行的文本字符串称为指令，而将掌握器反

馈给上位机的文本字符串称为反馈码。

指令和反馈码格式的常规商定：

•指令和反馈码都以字符S开头表示指令起始点，都以回生换行符\r\n作为结束符（留

意：回车换行符是不行见的掌握字符，在大多数单片机C语言里，不支持\r\n的表达，而

应明确地用单字节的ASCII码OxOd代替\r,用0x0a代替\n\

•指令和反馈码紧跟$是详细的指令类型字串。

•指令和反馈码都分为不带数据表的简洁指令（或反馈码）和带数据表的简单指令（或

反馈码X简洁指令和反馈码在指令类型字串后紧接着就是结束符；简单指令和反馈码在指

令类型字串后是数据表，然后才是结束符。

•数据表一般是以一个或多个#起头的字段序列，#后紧跟的是主体序号（例如舵机号、

AD接口号等），序号之后是该主体的数据类型，数据类型之后是详细数据。

•有的指令无反馈码，有的只有胜利的反馈码，有的既有胜利的反馈码也有失败的反

馈码，用户可以针对指令的反馈码特点，做这样处理：凡是没有反馈码的指令，单向发指

令不检验反馈码；凡是收到胜利的反馈码则说明指令被胜利执行，否则说明指令未被掌握

器正确接收或被掌握器拒绝（接收不正确可能是因物理连接、通信参数的错误设置等缘由

造成，被拒绝可能是因掌握器正在执行上一条指令，在上一条指令执行完毕或被中止前不

会响应新指令，用户应——排查之工

1状态采集类指令

1.1测试通信口连接

指令:$OPEN\r\n

反馈码：$OPEN\r\n

1.2同步

指令：$SAME\r\n

反馈码:$SAME#lP[pwl]#2P[pw2]……#16P[pwl6]\r\n

例句:$SAME#lP1230#2P2205….…#16P1500\r\n

说明：

[pwl].[pw2]......[pwl6]分别是1#、2#……16#舵机的当前实际脉宽字符串

1.3读取动作组数

指令：$COUNT\r\n

反馈码：$COUNT=[nGrpCnt]\r\n

例句:$C0UNT=4\r\n

说明：

[nGrpCnt]是当前掌握器中存在的动作组数字符串

1.4AD转换指令

指令:$ADC#[i]\r\n

例句:$ADC#2\r\n

胜利反馈码：$ADC=[value]\r\nM

例句：$ADC=233\r\n

失败反馈码：$STOP\r\n

说明：

•国是要采集的AD端口号，取值区间为字符串1~8

•[value]是采集到的AD数量级，取值区间为字符串0-1023,最大值字符串1023

代表5V

•若采集指令指定的AD端口号是有效的（即该端口已被设置为AD口），则返回胜利

反馈码；若该端口是舵机掌握口，则返回失败反馈码。

2电机即时拖动类指令

2.1掌握器启动和舵机复位

指令:$RESET\r\n

反馈码：$RESET\r\n

说明：

•掌握器只有在启动后才能接受其他电机掌握指令。

•掌握器接收到该指令时，若掌握器已启动则使全部舵机马上回归启动脉宽，未启动

则启动电机掌握并使全部舵机马上回归启动脉宽。

2.2单电机即时拖动

指令:$MOP#[i]P[pwi]\r\n

例句1:$MOP#lP1500\r\n

例句2:$MOP#17P100\r\n

反馈码：无

说明：

•#团表示第几号电机，[i]是电机号字串，取值区间1~18;[i]取值1~16时表示是舵

机，取值17表示车体直行，取值18表示车体转弯。

•当［i］取值1~16时，P表示舵机脉宽，［pwi］取值区间为500〜2500。

•当口］取值17时，P表示直行转速和方向/pwi］取值区间-100~100,无符号表示向

前，有负号表示是向后。

•当［i］取值18时，P表示转向转速和直行方向，［pwi］取值区间-100700,无符号表

示右转,有负号表示左转。

3执行动作/动作组/群组

3.1电机组动作

指令:$MOV#［i］P［pwi］......T［t］\r\n

例句:$MOV#lP1200#2P1250#17P-68T1000\r\n

胜利反馈码：$MOV\r\n

失败反馈码：$STOP\r\n

说明：

•指令含有0个或多个#［i］P［pwi］子串和一个T［t］子串。0个［pwi］子串表示纯等待延

时，期间电机不做任何运动维持现状；1个或多j#［i］P［pwi］子串表示相应电机运动，子串

的详细意义同第3,2节描述。

•T表示时间字段，田是执行时间ms数。

•假如指令被掌握器胜利樨析并执行完毕则返回胜利反馈码，否则返回失败反馈码。

3.2执行动作组/群组

指令:$GROUP#[i]C[ni]......\r\n

例句：$GROUP#lC3#2C2\r\n

胜利反馈码：$GROUP\r\n

失败反馈码：$STOP\r\n

说明：

•指令含有1个或多个#[口口川]子串表示第i动作组执行ni次川取值区间为1~225,

[ni]取值区间为1~9999.

•假如指令被掌握器胜利解析（被挨次调用的动作组存在于掌握器）并执行完毕则返

回