OpenBMC

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的源码。

如何构建

注意：在下面的指令集中，某些步骤对的引用仅是一个示例，在设置不同平台时需要使用相应的平台替换。

根据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-/conf
$ source oe-init-build-env

选择平台 meta-wedge， meta-wedge100， meta-yosemite或者其他在meta-openbmc/meta-facebook目录中列出的平台。
这一步之后，你将进入构建目录 poky/build。

在构建目录中开始构建：
一般来说，为了构建平台：

$ bitbake -image

构建过程自动获取所有必须的包，并构建完成的映象。最终的编译结果在poky/build/tmp/deploy/images/目录中。根用户密码初始化为 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-/conf/machine/.conf 以确定要修改的正确的 astxxxx.inc 文件)

INHERIT += "externalsrc"
EXTERNALSRC_pn-linux-aspeed = "/meta-openbmc/meta-aspeed/recipes-kernel/linux/files/linux-aspeed-4.1"

构建工作

u-boot.bin - 这是电路板的 u-boot image。
uImage - 这是电路板的Linux kernel。
-image-.cpio.lzma.u-boot - 这是电路板的rootfs。
flash- - 这是完整的flash image，包括上面三个部分。

Yocto 配置

建议设置一个新的Yocto发行版。初始化脚本 oe-init-build-env 可以读取包含的 TEMPLATECONF 并设置一个本地的 build/conf/local.conf 以及关联的层/构建配置。

如果您之前已经设置并构建poky，则可以更改您的本地配置：

当使用Wedge的例子时，./build/conf/templateconf.cfg:

meta-openbmc/meta-facebook/meta-/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- \
  "
BBLAYERS_NON_REMOVABLE ?= " \
  /PREFIX/poky/meta \
  /PREFIX/poky/meta-yocto \
  "

并且，最终 ./build/config/local.conf 将包含重要的配置选项：

# Machine Selection
MACHINE ??= ""

# 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层的提交。