混合关键性系统（MCS）镜像构建指导

本章主要介绍 openEuler Embedded 中 MCS 镜像的构建方法。

构建包含 MCS 的 openEuler Embedded 镜像

MCS 特性目前支持在 qemu-arm64, 树莓派4B, Hi3093, ok3568, x86工控机 等多个平台上运行。 构建 MCS 镜像，需要在执行 oebuild generate 时，添加 -f openeuler-mcs。具体的步骤如下：

1. 根据 oebuild安装介绍 ，安装好oebuild，并初始化oebuild工作目录；

   $ oebuild init <directory>
   $ cd <directory>
   $ oebuild update
   

2. 进入oebuild工作目录，创建编译配置文件 compile.yaml：

   $ oebuild generate -p <platform> -f openeuler-mcs -d <build_mcs>
   
   # 以 qemu-arm64 为例，platform 可以指定为 qemu-aarch64
   # 其它平台请运行 oebuild generate -l 查看
   
   $ oebuild generate -p qemu-aarch64 -f openeuler-mcs -d <build_mcs>
   

   之后，在 <build_mcs> 目录下，会生成编译配置文件 compile.yaml。

   Note

   MCS 支持在 bare-metal 和 jailhouse 两种不同的环境上运行，默认构建 bare-metal。

   若需要支持 jailhouse，请修改编译配置文件 compile.yaml，把 MCS_FEATURES 中的 openamp 改成 jailhouse。

3. 进入 <build_mcs> 目录，编译 openeuler-image 或 openeuler-image-mcs，两个镜像都会安装 mcs 组件，但 openeuler-image-mcs 仅包含少量的基础软件包：

   # 进入构建容器
   $ oebuild bitbake
   
   # 构建完整镜像
   $ bitbake openeuler-image
   
   # 构建SDK
   $ bitbake openeuler-image -c do_populate_sdk
   
   
   # 或者，构建只覆盖基础软件包的裁剪镜像
   $ bitbake openeuler-image-mcs
   

---

• 构建完成后，在 <build_mcs>/output 目录下可以看到镜像，如：

  $ tree
  .
  └── 20230315093436
      ├── Image-5.10.0-openeuler
      ├── openeuler-image-mcs-qemu-aarch64-20230920084840.rootfs.cpio.gz
      ├── vmlinux-5.10.0-openeuler
      └── zImage-5.10.0-openeuler
  

单独构建mica_main以及mcs_km.ko

如果我们希望不使用oebuild进行构建， 参考 mcs 构建安装指导 。

如果使用oebuild，则操作如下：

# 启动构建容器
$ oebuild bitbake

# 构建mica_main
$ bitbake mcs-linux

# 构建mcs_km.ko
$ bitbake mcs-km

这种方式构建出来的二进制文件在当前构建目录的 tmp/work 目录下。

mica_main的路径在 tmp/work/x86_64-openeuler-linux/mcs-linux/1.0-r0/image/usr/bin/mica_main 。

mcs_km.ko的路径在 tmp/work/generic_x86_64-openeuler-linux/mcs-km/0.0.1-r0/image/lib/modules/5.10.0-openeuler/extra/mcs_km.ko 。