M100 系列 485 对接说明

适用型号 M100A · M100B · M100K　固件要求 V2.8 及以上

M100 系列通过 RS-485 接入第三方主机，支持播放控制、音量、蓝牙、SPDIF、播放模式，以及指定提示音文件播放和自定义场景触发。

总线容量　每台机器已内置 120 Ω 终端电阻。为保证稳定性， 单条 485 总线上的 M100 建议不超过 4 台；超过 4 台请提前验证上位机的驱动能力。

1. 网络准备

485 控制本身不依赖网络，但 APP 配置、场景编排都需要设备联网。

1.1 接入方式

以太网和 WiFi 只能二选一，禁止同时使用。

以太网：直接插网线，DHCP 分配 IP
WiFi：用米悦 APP 右上角的配网功能配置。已进入设备页面时，点右下角「其他」也能找到配网入口

配网时搜索不到设备，长按蓝牙按钮至蓝灯闪烁后再配。

配网入口

配网界面

1.2 IP 地址

只支持 DHCP，不支持静态 IP。 接入智能家居主机时必须在路由器内绑定 MAC 地址固定 IP。

2. 串口参数

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

3. 帧格式

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

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

字段	说明
起始符	下行 `FA`
地址码	每台设备一个 ID。`00` 为广播地址，所有设备都执行
数据长度	其后数据段的字节数
数据段	数据1 = 指令，数据2 = 参数
CRC 校验	对「地址码 + 数据长度 + 数据段」计算 CRC-16/MODBUS
结束符	`FE`

字节序　CRC 高字节在前。例：03 02 10 01 的校验结果是 A0 6D。

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

FC   01   02   11   08   8EAD   FD

起始符 FC，地址码为本机 485 ID，校验规则同下行，结束符 FD。

4. 控制指令

前提　播放控制需在蓝牙、AUX、SPDIF 全部关闭时使用。

4.1 播放控制 `10`

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

返回　FC + 地址 + 02 + 10 + 播放状态 + CRC + FD

4.2 音量 `11` / `12`

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

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

4.3 蓝牙 `13`

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

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

4.4 SPDIF `14`

数据2	动作
`00`	不动作，返回当前状态
`01`	关闭 SPDIF
`02`	打开 SPDIF

返回　FC + 地址 + 02 + 14 + SPDIF 状态（01 关／02 开）+ CRC + FD

4.5 播放模式 `15`

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

返回　FC + 地址 + 02 + 15 + 播放模式 + CRC + FD

与 M320 协议的差异　M100 系列的音量范围是 00–FF（M320 为 00–64），蓝牙返回值为 01 关 / 02 开（M320 为 01 开 / 00 关），且 14 仅控制 SPDIF 开关（M320 为三路音源切换）。 两份协议不可混用，详见 M320 485 通讯协议。

5. 播放 Voice 目录内的提示音

M100 设备内有一个固定的 voice 目录用于存放提示音， 该目录内的音频不会被扫描进曲库，可由 485 指令单独触发播放。

5.1 上传音频文件

通过文件管理的远程管理功能，用 FTP 工具上传。

M100 的 FTP 直接输入 IP 即可连接，不需要用户名、密码和端口。

FTP 上传

工具与素材

内容	链接	提取码
FTP 工具	https://pan.baidu.com/s/16RNrObaWxQsanmp0BdwEJQ	`hsby`
常用语音文件	https://pan.baidu.com/s/1DRH46VXQoHPStOehcRQ5wQ	`awdd`

5.2 配置触发命令

上传音频后重启设备，同目录下会自动生成 485voiceplayList.xml，其中 485command 字段为空，需要手工填写。

字段	说明
`id`	不要修改
`loop`	循环次数，默认 `1`，可改为 2/3/4/5
`volume`	音量，默认 `45`，可填 0–99
`path`	绝对路径。默认只列出 `voice` 目录内的文件，也可手工添加其它目录，如 U 盘 `/udisk/***.mp3`、FTP 上传目录 `/userdata/ftp/pub/testmusic/晚秋.mp3`
`485command`	HEX 格式的 485 命令，只能填在引号中间，命令内部和前后都不能有空格

5.3 维护须知

voice 目录内没有 485voiceplayList.xml 时，重启会按目录内容自动生成；目录为空则不生成
已存在该文件时，每次重启都会把 XML 数据写入数据库，程序按配置工作
目录内音频文件的增删不会自动同步到 XML —— 新增音频后需手工修改，或删掉 XML 重建。重建后 485command 内已填的数据不会保留

务必为每个客户、每台设备的 485voiceplayList.xml 做好备份。

6. 自定义场景

打开米悦 APP → 选择设备 → 右下角**「更多」→「场景配置」→ 右上角「新增」**。

命令格式为自定义 16 进制数字，例如 FE02010A2BE2A9FA。

中间不能有空格，有空格会识别不到。

命令可以自己计算，也可以直接接串口工具，观察某个开关执行后串口里实际收到什么。

6.1 场景可编排的内容

自定义时间播报、文字播报、天气预报的顺序，各项可单独开关
自定义曲目播放

6.2 TTS 播放结束后的行为

模式	行为
保持原状	播报前在播放就继续播放，原来暂停就保持暂停
强制暂停	无论播报前状态如何，播报结束一律暂停
继续播放	无论播报前状态如何，播报结束继续播放当前队列；队列为空则播放本地存储的音乐
替换队列	播报结束后用指定的歌单、电台或榜单替换播放队列

6.3 感应延时

设置场景的持续时长，到时自动停止。

延时期间再次触发不会响应，但会把延时顺延
设为 00 表示无延时，可连续触发

场景配置

场景效果