DOCUMENTATION CENTER

支持与文档中心

用户手册、固件升级、常见问题

分类
固件升级 产品手册 APP 指南 第三方对接
KNX Control4 D-Controls 世聪 CITRON RS-485 Home Assistant inSona 涂鸦 Tuya 苹果家庭 HomeKit
常见问题
设备 & APP 升级接口
设备与 APP 可调用以下接口自动检测最新版本。
生产环境建议配合白名单使用。
POST /api/device/upgrade
POST /api/app/upgrade
GET  /api/release/latest
HEAD /download/<product>/latest
桌面端安装包由本站托管：/api/release/latest?platform=windows 查版本，同名地址 GET 下载、HEAD 只取版本与校验和。
需要其它资料？
工程方案、二次开发接口、定制对接
联系我们

固件升级

设备出厂已预置固件，日常无需手动升级。系统损坏、降级或批量预置时，按下列流程用 Rockchip 烧录工具整机烧录。

整机烧录流程
适用型号：M100A · M210B · M310B · M320B · M330B · M500B
  1. 1
    安装烧录驱动
    解压 DriverAssitant，运行 DriverInstall.exe，点「驱动安装」。装完建议重启电脑。
  2. 2
    获取烧录镜像
    按设备型号向我们索取对应的 update.img 升级镜像。
  3. 3
    打开烧录工具
    解压 AndroidTool，运行 RKDevTool.exe，选择「升级固件」，点「固件」载入 update.img。
  4. 4
    让设备进入烧录模式
    顺序很重要：设备断电 → 按住 recovery 键不放 → 再插 micro USB。M100 的 recovery 键是「音量−」。
  5. 5
    执行升级
    工具提示发现 LOADER 设备后点「升级」。若始终发现不了，先换一根质量好的数据线。
  6. 6
    完成
    进度到 100% 后拔掉 USB 再重新供电，启动完成即可装回墙面。
需要对应型号的 update.img 烧录镜像？ 联系我们
刷机说明
完整流程、各型号 recovery 键位置、常见问题排查
阅读
米悦背景音乐刷机流程
原始 PDF，含实物照片
下载
烧录工具 AndroidTool / RKDevTool
Rockchip 烧录工具，解压后运行 RKDevTool.exe
下载
烧录驱动 DriverAssitant
烧录前必须先安装的 USB 驱动
下载

产品手册

M330B / M500B
快速安装使用指南
接线示意、安装方式、触摸按键说明、完整产品参数表
下载
M500B
M500B 说明书
8 寸屏双分区旗舰主机使用说明
下载
M210B
M210B 快速安装使用指南
86 型主机安装与使用说明（与 M320B 合订）
下载
M100B
米悦 M100B 使用说明
6P 导轨式主机安装、接线与使用说明
下载

APP 指南

iOS
App Store 搜索「米悦」即可安装。
前往 App Store
Android
应用宝搜索「米悦」，或在 APP 下载页获取安装包。
前往应用宝
HarmonyOS 鸿蒙
华为应用市场搜索「米悦」即可安装，当前版本 3.3.1。
前往华为应用市场
连接设备
  1. 1 把手机连到与主机同一个 WiFi（主机需已联网，2.4G / 5G 均可）。
  2. 2 打开米悦 APP 进入设备列表，APP 会通过局域网自动发现同网段的主机。
  3. 3 选中要控制的房间设备，即可播放、分区、组播与多房间对讲。

第三方对接指南

米悦主机开放控制协议，可接入主流智能家居系统。以下为各平台的对接文档与驱动。

KNX
支持接入 KNX 总线：KNX 面板可控制音箱播放、音量与音源，安卓音箱屏幕还能反过来控制 KNX 灯光、窗帘与空调。全部在米悦 APP 上配置。
KNX 对接说明
在线正文，随 git 更新
阅读
安卓设备 KNX 使用说明
手机 APP 配置音箱被控与屏幕主控，含实机截图
阅读
M100 KNX 对接说明
原始 PDF，备查
下载
KNX 组地址配置工具
下载
默认组地址表
下载
组地址配置示例
下载
Control4
提供官方 Control4 驱动（.c4z），在 Composer Pro 中加载后即可把米悦主机作为音源设备接入 Control4 系统。
Control4 驱动说明
在线正文，随 git 更新
阅读
Control4 驱动说明文件
原始 PDF，备查
下载
米悦 Control4 驱动
下载
D-Controls
D-Controls 已内置米悦设备驱动。接线、配置与可用指令以 D-Controls 官方文档为准，下面这个链接就是米悦设备那一页。
D-Controls 官方对接文档
docs.d-controls.com 上的米悦设备页
前往
世聪 CITRON
M100B 与世聪主机对接，实现背景音乐与世聪智能家居系统的场景联动。
世聪对接说明
在线正文，随 git 更新
阅读
米悦 M100B 世聪主机对接说明
原始 PDF，备查
下载
RS-485
开放 485 串口通讯协议，第三方主机可直接下发播放、音量、音源、场景等指令，适合无网络环境的工程集成。
M100 系列 485 对接说明
在线正文，随 git 更新
阅读
M320 485 通讯协议
M210B / M320B / M100B 通用协议，指令定义与 M100 系列有差异
阅读
米悦 M100B 485 对接说明
原始 PDF，备查
下载
M320 485 接口通讯协议
原始 PDF，备查
下载
Home Assistant
开源 Home Assistant 集成插件，把米悦主机接入 HA 作为媒体播放器实体，支持播放控制与状态回读。
MiYueHaPlugin 源码
前往
inSona
带屏主机（M210A / M330B / M500B）直接在屏幕上填 inSona 网关地址即可对接，不需要额外驱动。
  1. 1 在主机屏幕上进入 设置 → 智能家居 → inSona
  2. 2 填入 inSona 网关的 IP 地址和端口
  3. 3 点测试连接，显示正常后再点确认
  4. 4 重启主机，重启后进入即可使用
涂鸦 Tuya
带屏主机（M210A / M330B / M500B）接入涂鸦，全程在屏幕上完成，用涂鸦 App 扫码绑定。
  1. 1 在主机屏幕上进入 设置 → 智能家居 → 涂鸦，点确认
  2. 2 主机会直接重启，等它起来
  3. 3 用涂鸦 App 扫描屏幕上的二维码完成验证绑定
苹果家庭 HomeKit
带屏主机（M210A / M330B / M500B）可加入苹果家庭，并把 6 个场景关联到米悦的情景模式，之后用 iPhone 或 Siri 直接触发。
  1. 1 在主机屏幕上进入 设置 → 智能家居 → 苹果家庭，点确认
  2. 2 主机会重启，等它起来
  3. 3 用 iPhone 的家庭 App 扫描屏幕上的二维码，把主机添加进苹果家庭
  4. 4 可设置 6 个场景，分别关联米悦的情景模式

常见问题

米悦和其它背景音乐主机比，差别在哪？
主要差别在第三方对接的覆盖面和落地程度。米悦目前已对接 9 家系统：KNX、Control4、D-Controls、世聪 CITRON、RS-485、Home Assistant、inSona、涂鸦 Tuya、苹果家庭 HomeKit。并且每一家的对接文档、驱动或配置工具都在官网公开可下载 —— Control4 的 .c4z 驱动、KNX 的组地址表与配置 APK、485 通讯协议 PDF、Home Assistant 插件源码，不用找销售索取，集成商自己就能先评估能不能接、怎么接。M100K 型号还带原生 KNX 接口，不需要额外网关。另一处差别是情景模式：TTS 语音播报可以和歌单组合触发，播报内容能插入时间、日期等动态字段，闹钟也支持按周期重复并直接指定歌单。
对接需要另外买网关或者付授权费吗？
不需要。KNX、Control4、485、Home Assistant 等对接能力是主机固件自带的，驱动和文档官网免费下载，没有额外授权费。M100K 型号直接带原生 KNX 接口，连网关都省了；其余型号走网络或 485 接入。inSona、涂鸦、苹果家庭这三家在带屏主机上直接进设置里点几下就能配，不用工具。
情景模式和闹钟能做到什么程度？
情景模式可以把 TTS 语音播报和歌单组合起来一起触发：比如早上先播报一段问候语，紧接着自动播放指定歌单。TTS 的播报内容支持插入时间、日期等动态字段，不是只能念一段写死的文本。闹钟支持按周期重复，并且可以直接指定要播放的歌单，不用每次手动选。整套情景可以由 APP、主机屏幕触发，也可以由 KNX、Control4 等第三方系统的场景联动触发。
四款主机怎么选？
按安装方式和屏幕尺寸区分：M500B 8 寸屏、双分区独立音源、35W×4 功放，适合主控位置；M330B 5.5 寸屏、四核 A55 + 安卓 11；M210A 4 寸屏、86 型标准底盒安装；M100B 无屏、6P 导轨安装，适合弱电箱集中部署（同系列 M100K 带原生 KNX 接口）。
支持哪些音频格式和采样率？
全系列最大支持 192kHz / 24bit 音频解码，支持 FLAC、MP3 等主流格式，M100B 另支持 WAV。
能接入智能家居系统吗？
可以。已支持 KNX、Control4、D-Controls、世聪 CITRON、RS-485、Home Assistant、inSona、涂鸦 Tuya 与苹果家庭 HomeKit，文档和驱动见上方第三方对接指南。也支持通过自定义命令实现音乐场景与家居场景联动。
各型号的安装尺寸是多少？
M500B 面板 200×130×12mm，配 M-180 底盒；M330B 面板 146×86×10mm，配 M-146 底盒；M210A 面板 86×90×10mm，配 M-86 底盒；M100B 为 6P 导轨安装，外观尺寸 107×90×65mm。详见各型号产品页。
供电方式有什么区别？
M500B、M330B、M100B 为 220V 市电直接供电；M210A 为 DC 15V 供电（标配专用电源）。
手机怎么播放？多个房间能同步吗？
支持 AirPlay2 与 DLNA 推送，也可用米悦 APP 管理歌单和播放（见上方APP 指南）。多房间可用「同步组播」一键加入网络内正在播放的设备；M330B 支持设备间实时对讲。
设备烧录时找不到 Loader 设备怎么办？
先确认已安装 DriverAssitant 驱动，且设备是断电状态下按住 recovery 键再插 USB。两者都没问题时，绝大多数情况是数据线的问题 —— 换一根质量好的 micro USB 数据线再试。