qemu_mockup:基于 QEMU 的硬件器件仿真项目

Manage qemu simulation data

分支1Tags64
文件最后提交记录最后更新时间
1 个月前
11 天前
1 个月前
2 个月前
21 天前
21 天前
1 个月前
2 个月前
2 个月前
2 个月前
2 个月前
21 天前
10 个月前
2 个月前
10 个月前
2 个月前
3 个月前
10 个月前
9 个月前

qemu_mockup

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

存放底层硬件如eeprom/smc/lm75等器件的仿真数据,存放qemu专属驱动代码。在src/lualib/mock/data/mockdata中存在以板卡为颗粒度的仿真数据,在src/lualib/mock/drivers中存放驱动如hisport/mctp等


目录


仓库地址

https://gitcode.com/openUBMC/qemu_mockup


系统要求

项目 要求
操作系统 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

环境依赖

构建 qemu_mockup 前需完成 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/qemu_mockup.git

组件级构建

进入 qemu_mockup 组件目录后,使用 bingo 执行构建:

cd /home/workspace/qemu_mockup

# 默认 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++ 编译 —

测试

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


项目结构

qemu_mockup/
├ .pre-commit-config.yaml              # Git 钩子配置
├ CHANGELOG.md
├ CMakeLists.txt
├ CONTRIBUTING.md
├ Makefile
├ README.md
├ conanfile.py
├ config.cfg
├ docs/              # 文档
├ mds/              # MDS 模型定义
├ permissions.ini
├ src/              # 源码实现
└ user_conf/              # 用户配置

许可证

本项目基于 Mulan PSL v2 许可证开源。详情请参阅:https://license.coscl.org.cn/MulanPSL2

项目介绍

Manage qemu simulation data

定制我的领域