OpenBMC是一個(gè)開(kāi)源的軟件架構(gòu)用于構(gòu)建一個(gè)完整的基板管理控制器（BMC）的Linux image。

OpenBMC使用Yocto Project作為底層都見(jiàn)和發(fā)布框架。

內(nèi)容

這個(gè)代碼倉(cāng)庫(kù)包括三組圖層：

• OpenBMC Common Layer - 可用于不同BMC的常見(jiàn)軟件包和配置。
• BMC System-on-Chip (SoC) Layer - 特定于SoC的驅(qū)動(dòng)和工具。這一層包括bootloader (u-boot)及Linux kernel。其中bootloader和Linux kernel都必須包含特定于SoC的硬件驅(qū)動(dòng)。
• Board Specific Layer - 特定于電路板的驅(qū)動(dòng)程序，配置和工具。這一層定義了如何配置image。它還定義了需要為該電路板OpenBMC image安裝的軟件包。任何特定于電路板的初始化和工具也包含在這層里。

文件結(jié)構(gòu)

此代碼庫(kù)使用Yocto命名模式。使用 "meta-layer" 來(lái)定義圖層或圖層類別。使用 recipe-abc 用于配置一個(gè)recipe。項(xiàng)目本身作為一個(gè)meta layer。在Yocto項(xiàng)目的發(fā)行版中這個(gè)項(xiàng)目就是 meta-openbmc。

OpenBMC common layer的recipes位于 common目錄。

BMC SoC layer 及 board specific layer根據(jù) vendor/manufacturer名稱組織在一起。例如，所有Facebook電路板特定的代碼位于 meta-facebook。同樣的，meta-aspeed包含了Aspeed SoCs的源碼。

如何構(gòu)建

注意：在下面的指令集中，某些步驟對(duì) <platform> 的引用僅是一個(gè)示例，在設(shè)置不同平臺(tái)時(shí)需要使用相應(yīng)的平臺(tái)替換。

1. 根據(jù)Yocto 項(xiàng)目的 快速入門(mén)指南 建立構(gòu)建環(huán)境。

2. Clone Yocto repository:

$ git clone -b krogoth https://git.yoctoproject.org/git/poky

3. 在 poky 目錄中 Clone OpenEmbedded 和 OpenBMC 代碼倉(cāng)庫(kù)：

$ 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

注意此項(xiàng)目不使用Yocto發(fā)行分支名稱。

4. 初始化構(gòu)建目錄，在 poky 目錄中：

$ export TEMPLATECONF=meta-openbmc/meta-facebook/meta-<platform>/conf
$ source oe-init-build-env

選擇平臺(tái) meta-wedge， meta-wedge100， meta-yosemite或者其他在meta-openbmc/meta-facebook目錄中列出的平臺(tái)。
這一步之后，你將進(jìn)入構(gòu)建目錄 poky/build。

5. 在構(gòu)建目錄中開(kāi)始構(gòu)建：
   一般來(lái)說(shuō)，為了構(gòu)建平臺(tái)：

$ bitbake <platform>-image

構(gòu)建過(guò)程自動(dòng)獲取所有必須的包，并構(gòu)建完成的映象。最終的編譯結(jié)果在poky/build/tmp/deploy/images/<platform>目錄中。根用戶密碼初始化為 0penBmc， 你可以自行在本地配置文件中更改。

內(nèi)核開(kāi)發(fā)

默認(rèn)情況下，OpenBMC構(gòu)建過(guò)程自動(dòng)從GitHub倉(cāng)庫(kù)中獲取并構(gòu)建Linux內(nèi)核。
使用本地修改的內(nèi)核并進(jìn)行編譯，參考一下步驟：

1. Clone 內(nèi)核源碼

$ 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

2. 更新構(gòu)建配置，指向本地內(nèi)核源碼目錄
   在文件 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"

構(gòu)建工作

• u-boot.bin - 這是電路板的 u-boot image。
• uImage - 這是電路板的Linux kernel。
• <platform>-image-<platform>.cpio.lzma.u-boot - 這是電路板的rootfs。
• flash-<platform> - 這是完整的flash image，包括上面三個(gè)部分。

Yocto 配置

建議設(shè)置一個(gè)新的Yocto發(fā)行版。初始化腳本 oe-init-build-env 可以讀取包含的 TEMPLATECONF 并設(shè)置一個(gè)本地的 build/conf/local.conf 以及關(guān)聯(lián)的層/構(gòu)建配置。

如果您之前已經(jīng)設(shè)置并構(gòu)建poky，則可以更改您的本地配置：

當(dāng)使用Wedge的例子時(shí)，./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 將包含重要的配置選項(xiàng)：

# Machine Selection
MACHINE ??= "<platform>"

# OpenBMC distro settings
DISTRO ?= "openbmc-fb"

如何貢獻(xiàn)代碼

如果您的應(yīng)用程序可以由不同的BMC使用，則可以將您的應(yīng)用程序提交給OpenBMC common layer。

如果您是BMC SoC供應(yīng)商，則可以將您的SoC特定驅(qū)動(dòng)程序提交給BMC SoC layer。

如果您是電路板供應(yīng)商，則可以將電路板特定配置和工具提交給Board specific layer。如果電路板使用不屬于BMC SoC層的新BMC SoC，則還需要SoC特定驅(qū)動(dòng)程序?qū)MC SoC層的提交。