RS-485 通讯协议

适用型号 M210B · M320B · M100B　固件要求 V2.0 及以上　协议版本 1.1（2020-10-26）

第三方主机通过 RS-485 串口下发指令控制米悦背景音乐播放器，支持播放控制、音量、音源切换、播放模式与自定义场景。适合无网络环境的工程集成。

注意　485 接口不能用于开关机。如需实现开关机效果，见 6. 伪开关机。

1. 串口参数

参数	值
工作方式	485 从机
波特率	9600 bps
数据位	8
停止位	1
校验位	无
数据格式	HEX

2. 帧格式

2.1 下行帧（主机 → 播放器）

FA   01   02   10   01   186C   FE
│    │    │    │    │    │      └── 结束符
│    │    │    │    │    └───────── CRC 校验（2 字节）
│    │    │    └────┴────────────── 数据段
│    │    └─────────────────────── 数据长度
│    └──────────────────────────── 地址码
└───────────────────────────────── 起始符

字段	说明
起始符	下行 `FA`
地址码	每台设备一个 ID。收到数据后先比对 ID，一致才处理。`00` 为广播地址，所有设备都执行
数据长度	其后数据段的字节数
数据段	长度由「数据长度」决定。本协议固定用 2 字节：数据1 = 指令，数据2 = 参数
CRC 校验	对「地址码 + 数据长度 + 数据段」计算 CRC-16/MODBUS
结束符	`FE`

2.2 上行帧（播放器 → 主机）

FC   01   02   11   08   8EAD   FD
                              └──── 结束符 FD

字段	说明
起始符	上行 `FC`
地址码	本机 485 ID
CRC 校验	对「地址码 + 数据长度 + 数据段」计算 CRC-16/MODBUS
结束符	`FD`

重要　FA–FF 为特殊字符。当 CRC 计算结果的后两位大于 F9 时，改写为 F9。

3. 指令速查

数据1	功能	数据2 取值
`10`	播放控制	`00` 查询／`01` 播放／`02` 暂停／`06` 上一首／`07` 下一首
`11`	设置音量	`00`–`64`（十进制 0–100）
`12`	音量增减	`00` 查询／`01` 音量−／`02` 音量+
`13`	蓝牙开关	`00` 查询／`01` 关／`02` 开
`14`	音源切换	`00` 查询／`01` 内部音源／`02` SPDIF／`03` AUX
`15`	播放模式	`00` 查询／`01` 单曲循环／`02` 随机／`03` 顺序／`04` 列表循环

所有指令的 数据2 = 00 均为只查询不动作，设备会返回当前状态。

4. 指令详解

4.1 播放控制 `10`

前提　蓝牙、AUX、SPDIF 全部关闭时才可使用。

数据2	动作
`00`	不动作，返回当前播放／暂停状态
`01`	播放
`02`	暂停
`06`	上一首
`07`	下一首

返回　FC + 本机地址 + 02 + 11 + 播放状态 + CRC + FD

4.2 音量 `11` / `12`

数据1	数据2	动作
`11`	`00`–`64`	直接指定音量（0–100）
`12`	`00`	不动作，返回当前音量
`12`	`01`	音量 −
`12`	`02`	音量 +

返回　FC + 本机地址 + 02 + 11 + 当前音量 + CRC + FD

4.3 蓝牙 `13`

数据2	动作
`00`	不动作，返回蓝牙开关状态
`01`	关闭蓝牙
`02`	打开蓝牙

返回　FC + 本机地址 + 02 + 13 + 蓝牙状态（01 开／00 关）+ CRC + FD

4.4 音源切换 `14`

数据2	动作
`00`	不动作，返回当前音源
`01`	内部音源
`02`	SPDIF 输入
`03`	AUX 音频输入

返回　FC + 本机地址 + 02 + 14 + 音源 + CRC + FD

4.5 播放模式 `15`

数据2	动作
`00`	不动作，返回当前播放模式
`01`	单曲循环
`02`	随机
`03`	顺序播放（播完列表即停）
`04`	列表循环

返回　FC + 本机地址 + 02 + 14 + 播放模式 + CRC + FD

待确认　原始文档此处返回帧的指令字节写作 14，与下发指令 15 不一致，疑为笔误。集成前请以实际抓包为准。

5. 自定义音乐场景

米悦播放器支持自定义音乐场景：485 接口收到任意数据都可以触发场景，场景内容预先配置到设备内即可。

支持天气预报、语音提示、时间播报、指定曲目播放。

限制　场景中不支持播放 Voice 目录内的小文件。

6. 伪开关机

485 无法真正控制电源，用指令组合模拟：

伪关机

切到内部音源（14 01）
关闭蓝牙（13 01）
发送暂停（10 02）

伪开机

查询蓝牙状态（13 00）
查询音源（14 00）
唤醒屏幕

时序要求　关闭蓝牙后需间隔 500 ms 再发下一条指令；其余指令之间间隔 100 ms。

7. 集成注意事项

涉及设置的指令必须指定 ID，不能用广播地址 00
CRC 后两位大于 F9 时改写为 F9（见 2.2）
蓝牙处于连接状态时，直接发播放指令不会生效。若不便判断蓝牙状态，可先强制发送一次关闭蓝牙再播放