Are you happy with your logging solution? Would you help us out by taking a 30-second survey? Click here

openbmc

OpenBMC is an open software framework to build a complete Linux image for a Board Management Controller (BMC).

Subscribe to updates I use openbmc


Statistics on openbmc

Number of watchers on Github 305
Number of open issues 20
Average time to close an issue about 1 month
Main language C
Average time to merge a PR about 4 hours
Open pull requests 11+
Closed pull requests 5+
Last commit over 1 year ago
Repo Created over 4 years ago
Repo Last Updated over 1 year ago
Size 8.35 MB
Organization / Authorfacebook
Contributors1
Page Updated
Do you use openbmc? Leave a review!
View open issues (20)
View openbmc activity
View on github
Fresh, new opensource launches 🚀🚀🚀
Trendy new open source projects in your inbox! View examples

Subscribe to our mailing list

Evaluating openbmc for your project? Score Explanation
Commits Score (?)
Issues & PR Score (?)

OpenBMC

OpenBMC is an open software framework to build a complete Linux image for a Board Management Controller (BMC).

OpenBMC uses the Yocto Project as the underlying building and distro generation framework.

Board Status Description
Wedge Build Status A 40G OS-agnostic TOR switch
Yosemite Build Status An open source modular chassis for high-powered microservers
Lightning Build Status A flexible NVMe JBOF
Wedge100 Build Status A 32x100G TOR switch
Backpack LC/FC Build Status Linecard and fabric card in a 128x100G modular open switch
Backpack CMM Build Status Chassis management module in a 128x100G modular open switch
Tioga Pass Build Status A dual-socket compute platform
YosemiteV2 Build Status A refresh of Yosemite
Bryce Canyon Build Status Disk Storage platform

Contents

This repository includes 3 set of layers:

  • OpenBMC Common Layer - Common packages and recipes can be used in different types of BMC.
  • BMC System-on-Chip (SoC) Layer - SoC specific drivers and tools. This layer includes the bootloader (u-boot) and the Linux kernel. Both the bootloader and Linux kernel shall include the hardware drivers specific for the SoC.
  • Board Specific Layer - Board specific drivers, configurations, and tools. This layer defines how to configure the image. It also defines what packages to be installed for an OpenBMC image for this board. Any board specific initialization and tools are also included in this layer.

File structure

The Yocto naming pattern is used in this repository. A `meta-layer` is used to name a layer or a category of layers. And recipe-abc is used to name a recipe. The project will exist as a meta layer itself! Within the Yocto Project's distribution call this project meta-openbmc.

The recipes for OpenBMC common layer are found in common.

The BMC SoC layer and board specific layer are grouped together based on the vendor/manufacturer name. For example, all Facebook boards specific code should be in meta-facebook. Likewise, meta-aspeed includes source code for Aspeed SoCs.

How to build

Note: In the instruction set below, references to for some of the steps is an example only and need to be replaced with the respective platform when setting up for a different platform.

  1. Set up the build environment based on the Yocto Project's Quick Start Guide.

  2. Clone the OpenBMC repository and other open source repositories:

    $ git clone -b helium https://github.com/facebook/openbmc.git
    $ cd openbmc
    $ ./sync_yocto.sh
    
  3. Initialize a build directory for the platform to build. In the openbmc directory:

    $ source openbmc-init-build-env meta-facebook/meta-wedge
    

    Choose between meta-wedge, meta-wedge100, meta-yosemite, or any of the other platforms listed in the meta-facebook directory. After this step, you will be dropped into a build directory, openbmc/build.

  4. Start the build within the build directory: In general to build for the platform:

    $ bitbake <platform>-image
    

    The build process automatically fetches all necessary packages and builds the complete image. The final build results are in openbmc/build/tmp/deploy/images/<platform>. The root password will be 0penBmc, you may change this in the local configuration.

Build Artifacts

  • u-boot.bin - This is the u-boot image for the board.
  • uImage - This the Linux kernel for the board.
  • -image-.cpio.lzma.u-boot - This is the rootfs for the board
  • flash- - This is the complete flash image including u-boot, kernel, and the rootfs.

Kernel Development

By default, OpenBMC build process fetches and build Linux kernel directly from GitHub repository. To make local kernel changes and build with the modified kernel:

  1. Clone kernel source $ 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. Update build recipes to point to local kernel source directory in meta-aspeed/conf/machine/include/ast2520.inc, add these 2 lines below the PREFERRED_PROVIDER_virtual/kernel ?= "linux-aspeed line

(check meta-facebook/meta-<platfom>/conf/machine/<platfom>.conf for the correct astxxxx.inc file to modify)

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

How can I contribute

If you have an application that can be used by different BMCs, you can contribute your application to the OpenBMC common layer.

If you are a BMC SoC vendor, you can contribute your SoC specific drivers to the BMC SoC layer.

If you are a board vendor, you can contribute your board specific configurations and tools to the Board specific layer. If the board uses a new BMC SoC that is not part of the BMC SoC layer, the SoC specific driver contribution to the BMC SoC layer is also required.

openbmc open issues Ask a question     (View All Issues)
  • about 3 years perl-5.20.0-r1 package failing
  • over 3 years bitbake failure due to explicit protocol git in u-boot recipes not supported by firewall
  • over 3 years over lan
  • over 3 years Attempt build of HiKey for BSP alternative
  • over 3 years Identify list of Linux + Uboot drivers for upstreaming
  • over 3 years Setup Jenkins/Docker continuous build for Wedge/Wedge100/Yosemite images
  • over 4 years README and CONTRIBUTING docs say what you can contribute, but not how
  • over 4 years Won't compile: Makefile:442: *** mixed implicit and normal rules. Stop.
openbmc open pull requests (View All Pulls)
  • Add sample script to grab stats over the REST API.
  • Solve i2c-tools svn down and add fbutils dependancy to ipmbd
  • Change tabs to spaces in rest_*.py
  • Extended Application handler to support IPMI Cold and Warm reset comm…
  • fix make incompatibility
  • Fix a typo in a comment
  • Fix build instructions in README.md
  • Add missing pointer dereference in ipmid
  • Add FB code of conduct
  • Fixup build errors when the build dir is outside the OE root.
  • Fix some build issues
openbmc list of languages used
Other projects in C