OpenBMC是一个开源的软件架构用于构建一个完整的基板管理控制器（BMC）的Linux image。
OpenBMC使用Yocto Project作为底层都见和发布框架。
| Board | Status | Description |
|---|---|---|
| Wedge100 | [图片上传失败...(image-86afde-1513756485912)] | 一个32x100G TOR交换机 |
| Lightning | [图片上传失败...(image-398e6f-1513756485912)] | 一个灵活的NVMe JBOF |
| Yosemite | [图片上传失败...(image-666213-1513756485912)] | 用于大功率微型服务器的开源的模块化机箱 |
| Wedge | [图片上传失败...(image-be31df-1513756485912)] | 任意操作系统的40G TOR交换机 |
内容
这个代码仓库包括三组图层：
- OpenBMC Common Layer - 可用于不同BMC的常见软件包和配置。
- BMC System-on-Chip (SoC) Layer - 特定于SoC的驱动和工具。这一层包括bootloader (u-boot)及Linux kernel。其中bootloader和Linux kernel都必须包含特定于SoC的硬件驱动。
- Board Specific Layer - 特定于电路板的驱动程序，配置和工具。这一层定义了如何配置image。它还定义了需要为该电路板OpenBMC image安装的软件包。任何特定于电路板的初始化和工具也包含在这层里。
文件结构
此代码库使用Yocto命名模式。使用 "meta-layer" 来定义图层或图层类别。使用 recipe-abc 用于配置一个recipe。项目本身作为一个meta layer。在Yocto项目的发行版中这个项目就是 meta-openbmc。
OpenBMC common layer的recipes位于 common目录。
BMC SoC layer 及 board specific layer根据 vendor/manufacturer名称组织在一起。例如，所有Facebook电路板特定的代码位于 meta-facebook。同样的，meta-aspeed包含了Aspeed SoCs的源码。
如何构建
注意：在下面的指令集中，某些步骤对 <platform> 的引用仅是一个示例，在设置不同平台时需要使用相应的平台替换。
根据Yocto 项目的 快速入门指南 建立构建环境。
Clone Yocto repository:
$ git clone -b krogoth https://git.yoctoproject.org/git/poky
- 在
poky目录中 Clone OpenEmbedded 和 OpenBMC 代码仓库：
$ cd poky
$ git clone -b krogoth https://github.com/openembedded/meta-openembedded.git
$ git clone -b krogoth https://git.yoctoproject.org/git/meta-security
$ git clone -b helium https://github.com/facebook/openbmc.git meta-openbmc
注意此项目不使用Yocto发行分支名称。
- 初始化构建目录，在
poky目录中：
$ export TEMPLATECONF=meta-openbmc/meta-facebook/meta-<platform>/conf
$ source oe-init-build-env
选择平台 meta-wedge， meta-wedge100， meta-yosemite或者其他在meta-openbmc/meta-facebook目录中列出的平台。
这一步之后，你将进入构建目录 poky/build。
- 在构建目录中开始构建：
一般来说，为了构建平台：
$ bitbake <platform>-image
构建过程自动获取所有必须的包，并构建完成的映象。最终的编译结果在poky/build/tmp/deploy/images/<platform>目录中。根用户密码初始化为 0penBmc， 你可以自行在本地配置文件中更改。
内核开发
默认情况下，OpenBMC构建过程自动从GitHub仓库中获取并构建Linux内核。
使用本地修改的内核并进行编译，参考一下步骤：
- Clone 内核源码
$ cd poky
$ git clone -b openbmc/helium/4.1 https://github.com/theopolis/linux.git meta-openbmc/meta-aspeed/recipes-kernel/linux/files/linux-aspeed-4.1
- 更新构建配置，指向本地内核源码目录
在文件meta-aspeed/conf/machine/include/ast2520.inc中，添加如下两行到PREFERRED_PROVIDER_virtual/kernel ?= "linux-aspeed行之后
(先检查 meta-facebook/meta-<platfom>/conf/machine/<platfom>.conf 以确定要修改的正确的 astxxxx.inc 文件)
INHERIT += "externalsrc"
EXTERNALSRC_pn-linux-aspeed = "<dir>/meta-openbmc/meta-aspeed/recipes-kernel/linux/files/linux-aspeed-4.1"
构建工作
- u-boot.bin - 这是电路板的 u-boot image。
- uImage - 这是电路板的Linux kernel。
- <platform>-image-<platform>.cpio.lzma.u-boot - 这是电路板的rootfs。
- flash-<platform> - 这是完整的flash image，包括上面三个部分。
Yocto 配置
建议设置一个新的Yocto发行版。初始化脚本 oe-init-build-env 可以读取包含的 TEMPLATECONF 并设置一个本地的 build/conf/local.conf 以及关联的层/构建配置。
如果您之前已经设置并构建poky，则可以更改您的本地配置：
当使用Wedge的例子时，./build/conf/templateconf.cfg:
meta-openbmc/meta-facebook/meta-<platform>/conf
Layers config ./build/conf/bblayers.conf将包含：
BBPATH = "${TOPDIR}"
BBFILES ?= ""
BBLAYERS ?= " \
/PREFIX/poky/meta \
/PREFIX/poky/meta-yocto \
/PREFIX/poky/meta-yocto-bsp \
/PREFIX/poky/meta-openembedded/meta-oe \
/PREFIX/poky/meta-openembedded/meta-networking \
/PREFIX/poky/meta-openembedded/meta-python \
/PREFIX/poky/meta-openbmc \
/PREFIX/poky/meta-openbmc/meta-aspeed \
/PREFIX/poky/meta-openbmc/meta-facebook/meta-<platform> \
"
BBLAYERS_NON_REMOVABLE ?= " \
/PREFIX/poky/meta \
/PREFIX/poky/meta-yocto \
"
并且，最终 ./build/config/local.conf 将包含重要的配置选项：
# Machine Selection
MACHINE ??= "<platform>"
# OpenBMC distro settings
DISTRO ?= "openbmc-fb"
如何贡献代码
如果您的应用程序可以由不同的BMC使用，则可以将您的应用程序提交给OpenBMC common layer。
如果您是BMC SoC供应商，则可以将您的SoC特定驱动程序提交给BMC SoC layer。
如果您是电路板供应商，则可以将电路板特定配置和工具提交给Board specific layer。如果电路板使用不属于BMC SoC层的新BMC SoC，则还需要SoC特定驱动程序对BMC SoC层的提交。
