vpd

验证说明：本文档是 vpd 组件构建与测试的唯一指导文档，验证流程请严格按本文档执行。docs/ 目录下的文档为特性说明文档，不涉及构建流程。原始 README 内容已移至 docs/VPD概述.md。本组件仅支持 Ubuntu 24.04 LTS，openEuler、CentOS、Debian 等其他系统均不支持，不要尝试使用其他镜像替代。

重要产品数据(vital product data)。包含硬件PSR、硬件CSR、机型相关的软件配置、北向接口映射、白牌定制等信息。包含整机硬件配置(PSR)、整机类配置(非PSR配置)、特定产业专用组件配置、华为服务器通用组件配置、天池组件配置等

仓库地址

https://gitcode.com/openUBMC/vpd

系统要求

项目	要求
操作系统	Ubuntu 24.04 LTS（仅支持此版本）
芯片架构	x86-64（amd64）
Python	>= 3.10（init.py 运行依赖）

bingo、Conan 等构建工具由 init.py 自动安装，无需手动准备。推荐使用 Docker 容器进行构建，可使用以下镜像快速启动开发环境：
docker pull swr.cn-north-4.myhuaweicloud.com/openubmc/ubuntu:24.04.2

环境依赖

构建 vpd 前需完成 openUBMC 开发环境初始化（安装 bingo、Conan、Node.js、配置 Conan 远程仓库等）。完整初始化步骤和常见问题排查请参阅 openUBMC 构建指导书，该文档包含容器环境搭建、init.py 执行、Conan 登录验证等全部操作说明。

禁止手动安装 bingo 和 Conan：手动安装（如 pip install conan）会导致 Conan 远程仓库认证失败，bingo build 无法拉取依赖包。所有构建工具必须通过 manifest 仓库的 init.py 流程一键安装。

构建

获取组件代码

前提：已完成环境依赖中的 init.py 初始化流程，bingo 和 conan 命令可用。

cd /home/workspace
git clone https://gitcode.com/openUBMC/vpd.git

组件级构建

进入 vpd 组件目录后，使用 bingo 执行构建：

cd /home/workspace/vpd

# 默认 dev 阶段构建
bingo build --stage=dev

# 构建并发布到 stable 阶段
bingo build --stage=stable

# Release 类型构建
bingo build --stage=dev -bt release

构建参数说明

bingo build [-h] [-bt BUILD_TYPE] [--stage STAGE] [-u] [-r REMOTE] [--conan2] [-nc] [-o OPTIONS] [--user USER] [-wb] [--ccache]

参数	说明	默认值
`-bt` / `--build_type`	构建类型，可选 `debug`、`release`	`debug`
`--stage`	包发布阶段，可选 `dev`、`pre`、`rc`、`stable`	`dev`
`-u` / `--upload`	上传组件包到 Conan 仓库	—
`-r` / `--remote`	Conan 仓库别名	—
`--conan2`	强制使用 Conan2 构建组件	—
`-nc` / `--no_cache`	强制更新 Conan 缓存依赖	—
`-o` / `--options`	定义组件选项值	—
`--user`	指定 Conan 包的 user 字段	`openubmc`
`-wb` / `--without_build`	不强制源码构建组件自身	—
`--ccache`	使用 ccache 加速 C/C++ 编译	—

vpd 支持的组件选项（-o 参数）：

选项	说明	默认值
`board_name`	板卡名称(从ConanBase继承)	`common`

测试

当前组件暂无自动化测试，验证方式请参阅 docs/ 目录下的特性说明文档。

项目结构

vpd/
├ .pre-commit-config.yaml              # Git 钩子配置
├ CHANGELOG.md
├ CONTRIBUTING.md
├ LICENSE
├ README.md
├ SmcDfxInfo配置说明.md
├ conanfile.py
├ dist/              # 分发配置
├ docs/              # 文档
├ mds/              # MDS 模型定义
├ registry.py
├ vendor/              # 供应商数据
└ 硬盘、板卡兼容性说明.md