小米座舱PC刷机鉴权工具v2.0 - 使用说明

智能客服

Mify智能客服：https://mify.mioffice.cn/chat/8kXJYqUSEAEdpmTC

下载

• 小米汽车PC刷机鉴权工具 - 下载地址

❕ 请注意： 解压路径不能存在特殊字符，包括中文、中文字符以及空格

登录

权限申请

• 小米汽车PC刷机鉴权工具 - 账号&权限申请说明
• 如遇到登录后提示登录失败，请检查是否内网环境（外网需连接小米人VPN）
• 登录失败请参考上方文档研发人员白名单申请

工具登录

工具已接入米盾，使用小米人登录

使用说明

产品选择

1. 工具登录后，请选择需要操作的设备产品名称

2. 产品可随时在左下角进行切换

SOC快速刷机

本地刷机

1. 将设备进入soc刷机模式（如高通9008、fastboot模式），连接至PC，确认PC设备管理器能正常发现该设备
2. 在工具中勾选需要刷写的设备

❗ 如上图中显示无权限，请先参考权限申请文档申请设备权限 EDL设备由于技术限制，无法提前获取设备权限

3. 选择需要刷写的版本

   1. 已解压的版本包：选择 package_info.xml 文件
   2. 2025/05/15之后的版本包会包含该文件，此前的版本包请复制一份该文件至rom包

   

   3. 未解压的版本包：选择压缩包即可，工具将自动进行解压（需稍等片刻）

   

   

4. 进行刷机选择确认

   

   1. 左侧将显示版本包信息，及当前设备是否可刷写该版本（efuse设备无法刷写debug版本，此处将进行检查）

   

   2. 右上方将显示已选择的设备列表

   

   3. 右下方为额外刷机选项，选项点击时将显示详细说明

   

5. 开始刷机

6. 刷机完成

在线刷机

1. 仅版本包选择时可选择在线版本，其余请参考本地刷机部分
2. 支持Rom交样平台与Grapple构建平台下载

3. 等待下载完成后继续刷机，剩余步骤请参考本地刷机部分

SOC自定义刷机

1. 与SOC快速刷机一致，仅在刷机确认步骤可自定义选择需要刷写的分区

SOC工具集

该选项卡中包含各类SOC调试管控项

诊断仪认证

1. 输入诊断仪认证数据

2. 点击生成，服务器将返回认证数据于下方，请将下方数据粘贴至诊断仪发送到设备

SSH登录（仅windows支持）

1. 请在目标设备通过诊断仪认证后使用
2. 填写目标设备的SN与IP地址

3. 等待MobaXterm启动，自动完成连接
4. MobaXterm将开启两个session窗口，分别为ssh、sftp，如需传输文件请使用sftp命令传输

修改研发状态

1. 此工具将改变设备Fastboot认证状态，认证后输入Fastboot命令将不受限制（非Fastboot Bootloader锁）
2. 分为单次有效（设备重启后失效）与永久有效
3. 清除状态将会在Fastboot重启后生效

MCU工具集

JTAG认证

1. 输入设备IMEI，查询MCU JTAG口密钥
2. 使用英飞凌Memtool或劳德巴赫，输入密钥进行连接

串口认证

1. 一键式串口认证，支持认证完成后自动执行可选操作
2. 认证后MCU串口可自由输入指令

设置

命令行模式

1. 本工具支持命令行模式（本地快速刷机/自定义刷机）

2. 必选参数：

-r        使用命令行模式启动
-m        刷机模式（fastboot或edl）
-f/c      指定刷机方式（快速刷机或自定义刷机）
-d        设备SN号（可同时输入多个，每个设备sn均需添加-d参数，例如 -d 设备1 -d 设备2）
-p        产品名
-P        版本包目录路径（package_info.xml所在目录的路径）
--user    用户名

3. 可选参数

--cookie  用户米盾登录cookie，保存在工具目录/tmp/webengine/user/下的.cookie.txt（隐藏文件），默认使用该路径下的cookie进行登录
-e        额外刷机选项，包含erase_userdata/efuse/reboot/unlock（可同时输入多个，每个选项均需添加-e参数，例如 -e 参数1 -e 参数2）

4. 命令示例

# 使用fastboot快速刷机命令示例：
MiCockpitAuth -r -f -m fastboot -d 0x12345678 -d 0x87654321 -p lemans -P <package dir path> -e reboot --user xxxxxx
 
# 使用edl快速刷机命令示例：
MiCockpitAuth -r -f -m edl -d COM45 -d COM46 -p lemans -P <package dir path> -e reboot --user xxxxxx

其它问题

Linux系统刷机Could not connect to /dev/ttyUSB1端口问题

该问题通常是usb端口所属的用户组为root，当前用户权限不足导致拒绝访问。

解决方法：

在 /etc/udev/rules.d/ 下新建 51-edl.rules，将下文中 GROUP="xxx" 字段替换成当前系统用户所属的group：

# Qualcomm EDL
SUBSYSTEMS=="usb", ATTRS{idVendor}=="05c6", ATTRS{idProduct}=="9008", MODE="0666", GROUP="xxx"
 
# Qualcomm Memory Debug
SUBSYSTEMS=="usb", ATTRS{idVendor}=="05c6", ATTRS{idProduct}=="9006", MODE="0666", GROUP="xxx"
 
# Qualcomm Memory Debug
SUBSYSTEMS=="usb", ATTRS{idVendor}=="05c6", ATTRS{idProduct}=="900E", MODE="0666", GROUP="xxx"
 
# LG Memory Debug
SUBSYSTEMS=="usb", ATTRS{idVendor}=="1004", ATTRS{idProduct}=="61a1", MODE="0666", GROUP="xxx"
 
# Sierra Wireless
SUBSYSTEMS=="usb", ATTRS{idVendor}=="1199", ATTRS{idProduct}=="9071", MODE="0666", GROUP="xxx"

修改完成后，执行 sudo service udev restart，重新插拔连接USB设备后可解决。

鉴权刷机失败

1. 失败后如需再次刷机，请将设备下电，重新进入9008端口后再开始刷机
2. 将工具所在目录下的 logs/ 文件夹下对应日志发给 林轩宇、袁野 初步分析

Linux版本过低（Ubuntu 18.04），GLibc ⇐2.27

由于Ubuntu 18.04版本对高通驱动的支持较差，且不满足工具运行的GLibc 2.28版本，因此不再单独维护Ubuntu 18.04版本的工具。

如有需要，可通过Ubuntu系统更新中升级至20.04以上版本，或选用Windows版本工具。

Windows / Linux系统工具无法登录，提示登录失败

检查账号信息是否正确，网络环境是否为小米办公内网（非内网环境需连接小米人VPN）。

如账号确认无误、确认为内网环境，依旧无法登录，请检查是否为本地PC环境的OpenSSL问题，工具仅支持OpenSSL 1.1.1系列版本，OpenSSL 3.0不受支持。

缺少高通驱动，端口无法识别、设备通信错误

1. Linux系统
   1. 执行 lsusb 查看是否存在9008端口
   2. 查看 /etc/modprobe.d/blacklist.conf 里是否存在qcserial
      1. 如黑名单中存在qcserial，请删除，并执行 sudo service udev restart，重新插拔usb
2. Windows系统
   1. 打开设备管理器，查看是否USB串行设备中是否有9008设备

如上述操作均无法解决，可以尝试高通QPM（https://qpm.qualcomm.com/#/main/tools/find），安装Qualcomm USB Driver

较早版本的rom 无 package_info.xml 或者 package_info 无效/不匹配

1. 手动修改对应的内容，和rom包保持一致

<?xml version="1.0" encoding="UTF-8"?>
<package>
    <platform>dcd</platform>
    <product>Modena</product>
    <device>watt</device>
    <soc>
        <platform>qualcomm</platform>
        <chipset>sa8295</chipset>
        <mode name="edl">
            <config ufs="0">ufs0/rawprogram_all.xml</config>
            <config ufs="1">ufs1/rawprogram_all.xml</config>
        </mode>
    </soc>
    <build_time>2025/05/16-17:48</build_time>
    <build_branch>s-watt-dev</build_branch>
    <build_type>user-root</build_type>
</package>

MCU串口认证接受消息超时

1. 如果mobaxterm可以正常连接mcu shell，但是鉴权工具接收消息超时
2. 则在设备管理器中尝试一下其他的驱动（不要选Enhanced Serial CH343）