Quartz 4

🔍 搜索

ROM平台使用指南

8 min read

ROM平台使用指南

原文档为飞书 wiki,图片因空间鉴权无法下载(403),已将截图转为文字描述块,便于检索。

ROM平台网址（没有权限可以申请一下）

权限申请入口：

https://work.mioffice.cn/apps/uc-apply/permission-list/HgTATOmoJ4K0?appName=%E3%80%90MDCD%E3%80%91ROM%E5%B9%B3%E5%8F%B0

怎么找对应的包下载

找对应的包步骤

首先打开 ROM 平台网站，点击版本信息。

图片

左侧导航栏选中”版本信息”。右侧表格列出多个车型及对应字段：车型、代码名称、发布类型、签名、环境类型、地区、发布日期、版本号、最低可刷版本号、安装包、状态、创建人、交付状态、备注、操作。红框高亮了主要筛选项（车型、代码名称、发布类型、签名、环境类型、地区、发布日期、版本号、最低可刷版本号、安装包、状态、创建人、交付状态、备注）。

按照上述红框里的筛选项进行筛选（要选择跟你车机版本对应的 ROM 下载，否则可能出现刷机错误！）

  1. 车型：表示所下包的车型，对应你自己的机器。XCD 下载 suiren，DCD 下载 watt
  2. 版本类型：分为 Dev、Beta、Stable、Release-test、Release-user
  3. 代码分支名称：根据你自己的代码分支进行选择
  4. 签名类型：分为测试签名与正式签名；测试签名指 debug 版本，正式签名指 release 版本
  5. 地区：目前分为 native、cn 以及 global

其他还有版本名称、环境类型等，根据自己需求进行条件筛选即可。

例子

📌 一般常用的筛选项就是 车型——版本类型——签名类型——地区

比如作为研发人员，如果你的机器是 XCD 机器，将筛选条件的车型选为 suiren，将版本类型选择 dev，将签名类型选择测试签名，将地区选择 native[原生版]，这样就能筛选出国内的 XCD 的主线分支的 debug ROM 包。如下图所示。

车型 suiren、版本类型 Dev（主线）、地区 native（原生版）。版本名称 suiren - xcd - in8，版本号 24.10.30.1，打包时间 2024-10-30 14:02:00，状态”已打包”，创建人 auto_trigger。

点击对应日期的包的版本详情即可前往对应 ROM 包的界面。

版本管理界面，筛选条件车型 suiren / 版本类型 dev / 测试签名 / 地区 native。右侧红色箭头指向”操作”列中的图标，点击即可进入对应 ROM 包详情页下载。

左侧导航栏，右侧上方显示版本名称、版本类型、签名类型、地区等信息（如版本名称 suiren - native (原生版)，版本类型 Dev（主线），签名类型为测试签名）。下方列出文件信息：文件类型、文件名、Base 版本、大小、哈希值、状态及操作（下载 / 复制到本地 等）。

ROM包各个信息的含义

ROM 包的版本详情信息分为完整包（线刷包和卡刷包）、差分包、其他包三种 ROM 包。

文件信息部分含义：

  • 包类型：分为卡刷包和线刷包；5 种 OTA 升级方式都是使用卡刷包进行更新的，线刷包用于 flash 刷机等
  • 子类型：分为整包、外设包、流式 Soc 包；根据自己需求下载对应包，其中整包包括外设包和流式 Soc 包
  • 哈希值：用于包的校验
  • 大小：指包的文件大小
  • 操作：可以进行下载、复制、复制流式数据三种操作

完整包

表格字段：包类型、子类型、差分类型、文件名、Base 版本、大小、哈希值、状态、操作。 典型文件：suiren-24.10.29.D-full-images.zip（整包升级，由 hardware.zip 和 soc.zip 组成）、suiren-24.10.29.D-flash_package_preset.tgz（线刷包，约 16954.71MB）。

文件名用途
suiren-24.10.29.D-full-images.zip进行整包升级时使用，该包由 hardware.zip 和 soc.zip 组成。（推荐卡刷使用该包）
suiren-24.10.29.D-flash_package_preset.tgz带有 preset 分区的线刷包，用于工厂第一次刷机使用（非此场景勿用此包！）
hardware.zip硬件包，包含 brcm、dsp、ivi、mcu、phud、res 等硬件包
soc.zip流式 Soc 包，包含更新的 payload 数据（如果不用升级硬件时，可以单独刷此包）
suiren-24.10.29.D-flash_package.tgz线刷包，用于线刷升级

其中流式 Soc 包可以复制流式数据，下面为 S24.10.29.D 的流式数据：

{
  "versionCode": 272,                // 表示包的版本号
  "fileName": "soc.zip",             // 表示包名称
  "metaData": {
    "offset": 4161,                  // 表示下载偏移量
    "size": 3647699184,              // 表示 soc 包的大小
    "metaData": [
      "FILE_SIZE=3647699184",
      "METADATA_SIZE=147979",
      "FILE_HASH=NPMQKKT2dTns+mCa9iKffj1bLkvUyoGYn2ExTLM3l1I=",
      "METADATA_HASH=/8R+w0byC/wfKzbWoCjvfGhJ2z22We7pCGTdZoSIQLs="
    ]
  }
}

差分包

差分包在 ROM 平台一般只有近 5 天的差分包。

DCD 跟 XCD 的差分包命名也不相同。

XCD 差分包的命名直接用版本号 versionCode 当做包名（版本号就是上面 SOC 流式数据里的 versionCode）。

📌 比如 S24.10.29.D 的版本号为 272，那么 10.28.D 版本号就是 271。如果自身是 10.28.D 想升级到 10.29.D，就可以下载下图中的 271_update.zip 进行差分升级。同理自身是 10.27.D 就需要下载 270_update.zip。

差分类型均为”差分”。文件名如 265_update.zip 等，Base 版本从 265 到 271，大小在 135.39MB ~ 298.13MB 之间，状态”上传完成”，操作栏有下载 / 复制 / 复制流式数据。

DCD 差分包的命名是用”当前版本到最新版本”来命名的，更通俗易懂一些。

📌 比如 watt_S24.10.28.D_To_S24.10.29.D_update.zip 表示从 10.28.D 升级到 10.29.D 的差分包。同理 watt_S24.10.27.D_To_S24.10.29.D_update.zip 表示 DCD 从 10.27.D 版本升到 10.29.D 的差分包。

命名方式为”从当前版本到最新版本”，如 watt_S24.10.28.D_To_S24.10.29.D_update.zip = 从 10.28.D 升到 10.29.D 的差分包。

所以如果想下载 ROM 平台的差分包进行升级，首先要保证自己车机的当前版本是在最新版本 5 天内的，其次要根据差分包的包名选择正确的差分包进行升级。目前检测更新升级会自动判断下载差分包或者整包，如果是 ADB 升级或 U 盘升级需要自行在 ROM 平台下载正确的 ROM 包。

其他包

一般场景下用不上这些包，暂略。

Graph View

Backlinks