Skip to content

Repository files navigation

Mimiracastplus

Mimiracastplus 是面向小米 11 Pro(代号 mars)的开源 Magisk 模块,用于启用高通厂商 Miracast/Wi-Fi Display R2 能力,并将厂商 WFD 编码配置的上限调整到 60 FPS。

已验证结果

  • 设备:小米 11 Pro(mars
  • 系统:Android 13 / MIUI 14
  • R2 属性:persist.vendor.setWFDInfo.R2=3
  • 接收端严格声明 VESA bit31 时,手机成功协商 H.265 2560×1440p60
  • 动态画面实测编码器输入和输出均达到约 60 FPS
  • 4K 在测试系统上仍由手机选择 3840×2160p30,本模块不保证 4K60

模块做了什么

  1. 使用非持久运行时覆盖启用 persist.vendor.setWFDInfo.R2=3
  2. 添加最小 SELinux 规则,允许 system_server 读取 ROM 已定义的 vendor_wfd_sys_prop
  3. 安装时复制设备自身的 /vendor/etc/wfdconfig.xml,再通过 Magisk systemless 挂载完成以下修改:
    • 三处 <VideoFps>30</VideoFps> 改为 60
    • 两处 H.264 <Level>6</Level>(Level 5.1)改为 7(Level 5.2)。

模块不会直接写入 /system/product/vendor 分区,也不包含闭源厂商文件。卸载并重启后,Magisk 挂载会消失,原始厂商 XML 自动恢复;卸载脚本同时恢复安装前的持久属性状态。

要求

  • 小米 11 Pro,设备代号必须为 mars
  • Magisk 及可用的 root 权限
  • ROM 中必须存在兼容布局的 /vendor/etc/wfdconfig.xml
  • 接收端必须正确声明对应的 Wi-Fi Display R2 分辨率和帧率能力

安装脚本会检查设备代号和 XML 结构,布局不符合预期时会终止安装,不会盲目改写其他机型。

安装

  1. 先在 Magisk 中记录现有模块列表并保留可恢复备份。
  2. 如果安装过旧的 Miracast Lite R2 CompatibilityMiracast Pro R2 Compatibility,先卸载旧模块并重启。
  3. Releases 下载 Mimiracastplus-v1.0.0.zip
  4. 在 Magisk 中选择“从本地安装”,安装 ZIP 后重启手机。
  5. 使用支持 R2 的接收端重新建立 Miracast 连接,并通过发送端日志确认最终协商模式。

卸载与恢复

在 Magisk 中卸载 Mimiracastplus 后重启。模块不会保留对厂商 XML 的直接修改。

如果设备无法正常启动,请使用 Magisk 安全模式或已有的救砖模块禁用 mimiracastplus。刷入前请自行确保有可用的恢复手段。

限制

  • 这是发送端兼容模块,不是 Miracast Sink,也不会在电脑上创建接收器。
  • 标准 Miracast/WFD 没有 2K90、2K120 这类通用时序;本模块不添加 90/120 FPS 私有协议。
  • 60 FPS 是编码上限,不代表静止页面或 30 FPS 视频会凭空生成 60 个不同画面。
  • 其他设备和 ROM 即使使用相同 SoC 也不在支持范围内。
  • DRM 内容仍可能拒绝投屏或显示黑屏。

从源码打包

在 Windows PowerShell 中运行:

powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\tools\package.ps1

产物生成到 dist/Mimiracastplus-v1.0.0.zip。打包器会检查版本字段、文件结构、UTF-8/LF shell 脚本和 ZIP 根目录。

许可证

MIT License © 2026 nwwsw

About

Open-source Magisk module for Qualcomm Miracast R2 and 2K60 on Xiaomi Mi 11 Pro (mars)

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages