抓娃娃机串口通信协议（初稿）
[if !supportLists]一、[endif]文档说明：
此文档用于PC主机（以下简称“上位机”）与抓娃娃机控制板（以下简称“下位机”）之间串口通信协议说明。
串口使用RS232标准进行通信，波特率：9600，校验位：无；数据位：8
协议使用“请求/应答”模式完成通讯任务；
输出：特指从“上位机”到“下位机”的数据传输；
输入：特指从“下位机”到“上位机”的数据传输；
校验：数据累加和方式。
数据长度：未特殊说明数据长度均为1个字节。
[if !supportLists]二、[endif]协议格式：
上位机到下位机指令格式：
数据1：开始码（0x8A）
数据2：数据长度，表示该次通讯字节个数(不包括开始码)
数据3：指令ID
数据4：指令类型
数据5：指令数据
数据6：校验位，存储指令数据累加和（数据2+数据3+数据4+。。。。数据7之累加和,不包括开始码，只保留8位）
数据7：结束码(0x55)
下位机到上位机指令格式：
数据1：开始码（0x8A）
数据2：数据长度，该次通讯字节个数(不包括开始码)
数据3：指令ID
数据4：指令类型
数据5：游戏局数数据
数据6：运行状态数据
数据7：礼物感应状态
数据8：指令数据累加和（数据2+数据3+数据4+。。。。数据8之累加和,不包括开始码，只保留8位）
数据9：结束码（0x55）
指令ID说明：
01：连接到下位机
02：游戏开始
03：向左移动抓机
04：向右移动抓机
05：向前移动抓机
06：向后移动抓机
07：停止移动抓机
08：执行抓取动作
09：悬空收拢抓机
0A：悬空张开抓机
0B：下位机发送状态
0C：上位机请求当前状态
0D：下位机发送错误码
指令类型说明：
01：上位机发送到下位机的指令
02：下位机对上位机指令的应答指令
03：下位机发送到上位机的指令
04：上位机对下位机指令的应答指令
超时异常：
1000ms
[if !supportLists]三、[endif]协议指令格式说明：
[if !supportLists]1、[endif]连接到下位机（指令ID：01）
开始码数据长度指令ID指令类型指令数据校验位结束码
8A030101无0555
示例：下位机接收到8A0301010555表示请求上位机连接到下位机
下位机应答：
开始码数据长度指令ID指令类型指令数据校验位结束码
8A0A01027位ID
（F4 06 01 55 70 62 05）
3455
示例：上位机接收到8A 0A 01 02 F4 06 01 55 70 62 05 34 55表示与下位机连接功,其中7位数据（F4 06 01 55 70 62 05）为下位机唯一码。
[if !supportLists]2、[endif]游戏开始（指令ID：02）
开始码数据长度指令ID指令类型指令数据校验位结束码
8A030201无0655
示例：下位机接收到8A 03 02 01 06 55表示开始游戏，启动游戏倒计时
下位机应答
开始码数据长度指令ID指令类型指令数据校验位结束码
8A030202无0755
示例：上位机接收到8A 03 02 02 07 55表示游戏开始成功，已开始倒计时
[if !supportLists]3、[endif]向左移动机械抓（指令ID：03）
开始码数据长度指令ID指令类型指令数据校验位结束码
8A030301无0755
示例：8A03 03 01 07 55
下位机应答：
开始码数据长度指令ID指令类型指令数据校验位结束码
8A030302无0855
示例：8A03 03 02 08 55
[if !supportLists]4、[endif]向右移动机械抓（指令ID：04）
开始码数据长度指令ID指令类型指令数据校验位结束码
8A030401无0855
示例：8A03 04 01 08 55
下位机应答：
开始码数据长度指令ID指令类型指令数据校验位结束码
8A030402无0955
示例：8A03 04 02 09 55
[if !supportLists]5、[endif]向前移动机械抓（指令ID：05）
开始码数据长度指令ID指令类型指令数据校验位结束码
8A030501无0955
示例：8A03 05 01 09 55
下位机应答：
开始码数据长度指令ID指令类型指令数据校验位结束码
8A030502无0A55
示例：8A03 05 02 0A 55
[if !supportLists]6、[endif]向后移动机械抓（指令ID：06）
开始码数据长度指令ID指令类型指令数据校验位结束码
8A030601无0A55
示例：8A03 06 01 0A 55
下位机应答：
开始码数据长度指令ID指令类型指令数据校验位结束码
8A030602无0B55
示例：8A03 06 02 0B 55
[if !supportLists]7、[endif]停止移动机械抓（指令ID：07）
开始码数据长度指令ID指令类型指令数据校验位结束码
8A030701无0B55
示例：8A03 07 01 0B 55
下位机应答：
开始码数据长度指令ID指令类型指令数据校验位结束码
8A030702无0C55
示例：8A03 07 02 0C 55
[if !supportLists]8、[endif]机械抓执行抓取（指令ID：08）
开始码数据长度指令ID指令类型指令数据校验位结束码
8A040801抓力累加和55
示例：8A04 08 01 C8D5 55表示要求机械抓执行抓力为C8（200）的抓取动作
如果抓力数据为FF表示本次抓取的抓力为机器的内部默认值
抓力：0-200之间的整数，数值越大抓力越大
下位机应答：
开始码数据长度指令ID指令类型指令数据校验位结束码
8A030802无0D55
示例：8A03 08 02 0D 55
[if !supportLists]9、[endif]悬空收拢机械抓（指令ID：09）
开始码数据长度指令ID指令类型指令数据校验位结束码
8A040901抓力0D55
示例：8A04 09 01 A0 AE 55表示要求抓机执行抓力为160（A0）的悬空抓取动作
抓力：0-200之间的整数，数值越大抓力越大
下位机应答：
开始码数据长度指令ID指令类型指令数据校验位结束码
8A030902无0E55
示例：8A03 09 02 0E 55
[if !supportLists]10、[endif]悬空张开机械抓（指令ID：0A）
开始码数据长度指令ID指令类型指令数据校验位结束码
8A030A01无0E55
示例：8A03 0A 01 0E 55
下位机应答：
开始码数据长度指令ID指令类型指令数据校验位结束码
8A030A02无0F55
示例：8A03 0A 02 0F 55
[if !supportLists]11、[endif]下位机发送状态数据（指令ID：0B）
开始码长度ID类型局数状态礼物校验结束码
8A060B03
局数：
03表示还能进行3次游戏；
00表示不可以进行游戏，需要投币
状态：
00等待游戏开始
01游戏开始
02爪子开始向下移动下抓
03爪子到达下抓限定位置
04爪子开始上移
05爪子到达上限定位置，并向礼品出口移动
06爪子到达礼品出口，并松爪
礼物：
[if !supportLists]00[endif]没有抓到礼品
[if !supportLists]01[endif]抓到一次礼品
示例：8A
06 0B 03 05 01 00 1A 55表示下位机向上位机发送了一次状态数据，告诉上位机还可以进行5次游戏，当前游戏已开始，没有抓到礼品。
上位机应答
开始码数据长度指令ID指令类型指令数据校验位结束码
8A030B04无1255
示例：
[if !supportLists]12、[endif]上位机请求当前状态（指令ID：0C）
开始码数据长度指令ID指令类型指令数据校验位结束码
8A030C01无1055
示例：8A 03 0C 01 10 55表示上位机向下位机请求状态信息
下位机应答：
开始码长度ID类型局数状态礼物校验结束码
8A060C0255
局数，状态，礼物数据参照“下位机发送状态数据”。
[if !supportLists]13、[endif]下位机发送错误码（指令ID：0D）
开始码长度ID类型错误码校验结束码
8A040D0355
示例：8A04 0D 03 01 14 55表示下位机告诉上位机发生了编码为01的错误。
[if !supportLists]14、[endif]上位机发送币数（指令ID：0F）
开始码数据长度指令ID指令类型指令数据校验位结束码
8A040F0101（币数）1555
下位机应答：
开始码数据长度指令ID指令类型指令数据校验位结束码
8A040F0201（接收到的币数）1655
备注：上位机通知设备支付的金额。举例说明：上位机先发送支
付命令，如果设备三秒内没收到设备的应答，视为这次的支付失
败，
错误码：（请电子工程师补充）
错误码：
00正常状态
01前限位故障
[if !supportLists]02[endif]后限位故障
03左限位故障
04右限位限位故障
05上限位故障
06下限位故障
07赠送错误
08爪子过热
09光眼故障
[if !supportLists]四、[endif]通讯机制
下位机在状态（局数，状态，礼物）改变时主动向上位机发送状态数据；
下位机在发生错误时主动向上位机发送错误码；
其它指令均由上位机向下位机主动发出，下位机只做应答。
添加设置查询命令
[if !supportLists]一、[endif]基础数据设置命令：（由上位机发送到控制板）
例子：8A 13 10 01 01 01
00 01 01 01 14 02 0A 00 01 01 01 01 01 01 4F 55
命令字节数据说明数据取值范围
8A开始码固定为8A
13该次通讯字节个数不包括开始码共19个字节
10指令ID固定为10
01指令类型固定为1
01语言取值范围（0-1）0为英文，1为中文
01广告音乐开关取值范围（0-1）0音乐无，1音乐有
00广告音乐间隔时间取值范围（0-30）当广告音乐开关为1有效
01币数取值范围（1-10）币数设置
01局数取值范围（1-10）局数设置
01币数保留取值范围（0-1）0关机不保留，1关机保留
14游戏时间取值范围（5-60）
02游戏模式取值范围（1-6）
0A出奖概率取值范围（1-250）
00礼品出口位置取值范围（0-1）0左后角，1左前角
01空中抓物取值范围（0-1）0为关，1为开
01背景音乐
01游戏音乐
01光眼电平取值范围（0-1）0为常开，1为常闭
01摇晃清分取值范围（0-1）
01保留取值范围（0-1）
4F累加和从通讯字节个数到赠送票币数量所有字节的累加和
55结束码
下位机基础数据如果设置成功，下位机返回命令：
8A 04 10 02 01 17 55
8A是开始码，04数据个数，10指令ID，02指令类型，01数据表示设置成功，17是累加和。
下位机如果设置失败，控制板返回命令：
8A 04 10 02 00 16 55
8A是开始码，04数据个数，10指令ID，02指令类型，00数据表示设置失败，16是累加和。
[if !supportLists]二、[endif]爪力电压设置命令：（由上位机发送到控制板）
例子：8A 13 11 01 01 0E 00 41 00 41 010E 08 08 00 0C 02 01 00 01 E5 55
命令字节数据说明数据取值范围
8A开始码固定为8A
13该次通讯字节个数不包括开始码共19个字节
11指令ID固定为11
01指令类型固定为1
01强爪电压高八位取值范围十进制（130-475），由高八位和低八位组合，010E十进制为270即27V
0E强爪电压低八位
00弱爪电压高八位取值范围十进制（20-200），由高八位和低八位组合，0041十进制为65即6.5V
41弱爪电压低八位
00弱抓后电压高八位取值范围十进制（20-400），由高八位和低八位组合，0041十进制为65即6.5V
41弱抓后电压低八位
01中奖电压高八位取值范围十进制（45-480），由高八位和低八位组合，010E十进制为270即27V
0E中奖电压低八位
08强力维持时间取值范围（1-30）08表示0.8秒
08弱力维持时间取值范围（1-30）08表示0.8秒
00强变弱方式取值范围（0-1）0强爪时间后变弱抓1碰到微动后变弱抓
0C放线长度时间取值范围（5-100）0C表示1.2秒
02收爪速度取值范围（0-20）
01上升延时取值范围（1-30）
00掉落延时比例取值范围（0-99）
01掉落延时时间取值范围（1-30）
E5累加和13+ 11+ 01 +01 +0E +00 +41 +00 +41+ 01 +0E +08+ 08 +00 +0C+ 02+ 00 +00 +01
55结束码
下位机爪力如果设置成功，控制板返回命令：
8A 04 11 02 01 18 55
8A是开始码，04数据个数，11指令ID，02指令类型，01数据表示设置成功，18是累加和。
下位机如果设置失败，控制板返回命令：
8A 04 11 02 00 17 55
8A是开始码，04数据个数，11指令ID，02指令类型，，00数据表示设置失败，17是累加和。
[if !supportLists]三、[endif]马达速度设置命令：（由上位机发送到控制板）
例子：8A 06 12 01 02 02 02 1F 55
命令字节数据说明数据取值范围
8A开始码固定为8A
06该次通讯字节个数不包括开始码共6个字节
12指令ID固定为12
01指令类型固定为1
02前后马达速度取值范围（1-10）
02左右马达速度取值范围（1-10）
02上下马达速度取值范围（1-10）
1F累加和06+12+ 01+ 02+ 02+ 02
55结束码
下位机速度如果设置成功，控制板返回命令：
8A 04 12 02 01 19 55
8A是开始码，04数据个数，12指令ID，02指令类型，01数据表示设置成功，19是累加和。
下位机如果设置失败，控制板返回命令：
8A 04 12 02 00 18 55
8A是开始码，04数据个数，12指令ID，02指令类型，00数据表示设置失败，18是累加和。
[if !supportLists]四、[endif]资料清除命令：（由上位机发送到控制板）
例子：8A 06 13 01 00 00 00 1A 55
命令字节数据说明数据取值范围
8A开始码固定为8A
06该次通讯字节个数不包括开始码共7个字节
13指令ID固定为13
01指令类型固定为01
00帐目清除取值范围（0-1）0为不清除，1为清除
00当前局数清除取值范围（0-1）0为不清除，1为清除
00概率结算清除取值范围（0-1）0为不清除，1为清除
1A累加和07+ 02+ 04 +00+ 00 +00
55结束码
下位机资料清除如果成功，控制板返回命令：
8A 04 13 02 01 1A 55
8A是开始码，04数据个数，13指令ID，02指令类型，01数据表示设置成功，1A是累加和。
下位机如果清除失败，控制板返回命令：
8A 04 13 02 00 19 55
8A是开始码，04数据个数，13指令ID，02指令类型，00数据表示设置失败，19是累加和。
[if !supportLists]五、[endif]恢复工厂设置和免费模式命令：（由上位机发送到控制板）
例子：8A 05 14 01 00 00 1A 55
命令字节数据说明数值取值范围
8A开始码固定为8A
05该次通讯字节个数不包括开始码共6个字节
14指令ID固定为14
01指令类型固定为01
00免费游戏字节取值范围（0-1）0正常模式，1免费模式
00恢复设置字节取值范围（0-1）0保持原有设置，1恢复工厂设置
1A累加和05 +14+ 01+ 00+ 00
55结束码
下位机恢复工厂设置命令如果设置成功，控制板返回命令：
8A 04 14 02 01 1B 55
8A是开始码，04数据个数，14指令ID，02指令类型，01数据表示设置成功，1B是累加和。
下位机恢复工厂设置命令如果设置失败，控制板返回命令：
8A 04 14 02 00 1A 55
8A是开始码，04数据个数，14指令ID，02指令类型，00数据表示设置失败，1A是累加和。
[if !supportLists]六、[endif]查账命令：（由上位机发送到控制板）
例子：8A 03 15 01 19 55
命令字节数据说明数值取值范围
8A开始码固定为8A
03该次通讯字节个数不包括开始码共4个字节
15指令ID固定为15
01指令类型固定为01
19累加和03 +15+ 01
55结束码
下位机返回数据如下。
例子：8A 17 15 02 00 00 01 02 00 00 0001 00 00 00 00 00 00 00 00 00 00 00 03 35 55
命令字节数据说明数值取值范围
8A开始码固定为8A
17该次通讯字节个数不包括开始码共23个字节
15指令ID固定为15
02指令类型固定为02
00总投币记录最高位总投币记录为32位无符号数据，00000102十进制为258，表示总共投了258个币。
00总投币记录高位
01总投币记录次高位
02总投币记录低位
00出礼品记录最高位礼品记录为32位无符号数据，00000001十进制为1，表示总共出了一个礼品。
00出礼品记录高位
00出礼品记录次高位
01出礼品记录低位
00本次投币记录最高位记录为32位无符号数据，
00本次投币记录高位
00本次投币记录次高位
00本次投币记录低位
00本次出礼品记录最高位记录为32位无符号数据，
00本次出礼品记录次高位
00本次出礼品记录高位
00本次出礼品记录低位
00概率结算最高位概率结算为32位有符号数据。概率结算=概率内入币–概率内出礼品*出奖概率
00概率结算高位
00概率结算次高位
03概率结算低位
35累加和
55结束码
[if !supportLists]七、[endif]查询当前基础数据：（由上位机发送到控制板）
示例：8A 03 16 01 1A 55
命令字节数据说明数据取值范围
8A开始码固定为8A
03该次通讯字节个数不包括开始码共4个字节
16指令ID固定为16
01指令类型固定为01
1A累加和03 +16+ 01
55结束码
下位机返回命令示例：
例子：8A 13 16 02 01 01
00 01 01 01 14 02 0A 00 01 01 01 01 01 01 56 55
命令字节数据说明数据取值范围
8A开始码固定为8A
13该次通讯字节个数不包括开始码共19个字节
16指令ID固定为16
02指令类型固定为2
01语言取值范围（0-1）0为英文，1为中文
01广告音乐开关取值范围（0-1）0音乐无，1音乐有
00广告音乐间隔时间取值范围（0-30）当广告音乐开关为1有效
01币数取值范围（1-10）币数设置
01局数取值范围（1-10）局数设置
01币数保留取值范围（0-1）0关机不保留，1关机保留
14游戏时间取值范围（5-60）
02游戏模式取值范围（1-6）
0A出奖概率取值范围（1-250）
00礼品出口位置取值范围（0-1）0左后角，1左前角
01空中抓物取值范围（0-1）0为关，1为开
01背景音乐
01游戏音乐
01光眼电平取值范围（0-1）0为常开，1为常闭
01摇晃清分取值范围（0-1）
01保留取值范围（0-1）
56累加和从通讯字节个数到赠送票币数量所有字节的累加和
55结束码
[if !supportLists]八、[endif]查询爪力电压命令：（由上位机发送到控制板）
示例：8A 03 17 01 1B 55
命令字节数据说明数据取值范围
8A开始码固定为8A
03该次通讯字节个数不包括开始码共3个字节
17指令ID固定为17
01指令类型固定为01
1B累加和03 +17+ 01
55结束码
下位机返回命令示例：
例子：8A 13 17 02 01 0E 00 41 00 41 010E 08 08 00 0C 02 00 00 01 EB 55
命令字节数据说明数据取值范围
8A开始码固定为8A
13该次通讯字节个数不包括开始码共19个字节
17指令ID固定为17
02指令类型固定为2
01强爪电压高八位取值范围十进制（130-475），由高八位和低八位组合，010E十进制为270即27V
0E强爪电压低八位
00弱爪电压高八位取值范围十进制（20-200），由高八位和低八位组合，0041十进制为65即6.5V
41弱爪电压低八位
00弱抓后电压高八位取值范围十进制（20-400），由高八位和低八位组合，0041十进制为65即6.5V
41弱抓后电压低八位
01中奖电压高八位取值范围十进制（45-480），由高八位和低八位组合，010E十进制为270即27V
0E中奖电压低八位
08强力维持时间取值范围（1-30）08表示0.8秒
08弱力维持时间取值范围（1-30）08表示0.8秒
00强变弱方式取值范围（0-1）0强爪时间后变弱抓1碰到微动后变弱抓
0C放线长度时间取值范围（5-100）0C表示1.2秒
02收爪速度取值范围（0-20）
00上升延时取值范围（1-30）
00掉落延时比例取值范围（0-99）
01掉落延时时间取值范围（1-30）
EB累加和13+ 17+ 02 +01+ 0E +00+ 41 +01 +0E +08+ 08 +0C+ 02 +00+ 00 +01
55结束码
[if !supportLists]九、[endif]查询马达速度命令：
示例：8A 03 18 01 1C 55
命令字节数据说明数据取值范围
8A开始码固定为8A
03该次通讯字节个数不包括开始码共3个字节
18指令ID固定为18
01指令类型固定为01
1C累加和03 +18+ 01
55结束码
下位机返回命令示例：
8A 06 18 02 02 02 02 25 55
命令字节数据说明数据取值范围
8A开始码固定为8A
06该次通讯字节个数不包括开始码共6个字节
18指令ID固定为18
02指令类型固定为02
02前后马达速度取值范围（1-10）
02左右马达速度取值范围（1-10）
02上下马达速度取值范围（1-10）
26累加和06 +18+ 02+ 02+ 02+ 02
55结束码