OpenBMC

OpenBMC is a Linux distribution for management controllers used in devices such as servers, top of rack switches or RAID appliances. It uses Yocto, OpenEmbedded, systemd, and D-Bus to allow easy customization for your platform.

Setting up your OpenBMC project

1) Prerequisite

• Ubuntu 14.04

sudo apt-get install -y git build-essential libsdl1.2-dev texinfo gawk chrpath diffstat

• Fedora 28

sudo dnf install -y git patch diffstat texinfo chrpath SDL-devel bitbake rpcgen
sudo dnf groupinstall "C Development Tools and Libraries"

2) Download the source

git clone https://github.com/Nuvoton-Israel/openbmc.git
cd openbmc
git checkout -b runbmc origin/runbmc

3) Target your hardware

Any build requires an environment set up according to your hardware target. There is a special script in the root of this repository that can be used to configure the environment as needed. The script is called setup and takes the name of your hardware target as an argument.

The script needs to be sourced while in the top directory of the OpenBMC repository clone, and, if run without arguments, will display the list of supported hardware targets, see the following example:

$ . setup <machine> [build_dir]
Target machine must be specified. Use one of:

buv-runbmc              lanyang                 romulus
centriq2400-rep         mihawk                  s2600wf
dl360poc                msn                     stardragon4800-rep2
ethanolx                neptune                 swift
evb-zx3-pm3             nicole                  tiogapass
f0b                     olympus                 vesnin
fp5280g2                olympus-nuvoton         witherspoon
g220a                   on5263m5                witherspoon-tacoma
gbs                     palmetto                yosemitev2
gsj                     qemuarm                 zaius
hr630                   quanta-q71l
hr855xg2                rainier

Once you know the target, source the setup script as follows:

As an example target Olympus Nuvoton

. setup olympus-nuvoton

As an example target BUV RunBMC

. setup buv-runbmc

4) Build

bitbake obmc-phosphor-image

Additional details can be found in the docs repository.

5) build images

After building finished the built Images will found at: <OpenBMC_folder>/build/tmp/deploy/images/olympus-nuvoton/ The relevant images to use to upload the OpenBMC on the Olympus Nuvoton are:

1. image-bmc - The entire 32MB image including BootBlock, u-boot, linux kernel and file system, can be programmed into the beginning of flash
2. image-u-boot - Includes only BootBlock and u-boot and their headers can be programmed into the beginning of flash
3. image-kernel - FIT image that includes linux kernel, device tree and an initial file system, can be loaded to the linux area in flash
4. image-rofs - Main (and large) OpenBMC file system, can be loaded to the rofs area in flash

6) Programming the images

For programming the OpenBMC to the Olympus Nuvoton platform, there are two ways to update BMC firmware. First, update BMC firmware image via OpenBMC web interface or RESTful API. Second, flash image via UART. In normal case we suggest user use the first method to update BMC firmware. User can follow the firmware update readme to upgrade BMC firmware.

Or program BMC firmware via UART by following instructions:

1. Enable BMC program mode, set jump JPC6 to (2-3), and JPC7 to (1-2)
2. Connect UART to connector JP35
3. Follow the NPCM7xx_OpenBMC_Programming.pdf chapter 2.2.2 to program BMC firmware. Additionally, the step a should change to python UpdateInputsBinaries_RunBMC.py

7) OpenBMC user login

After the OpenBMC boot please enter the following login and password:

Phosphor OpenBMC (Phosphor OpenBMC Project Reference Distro) 0.1.0 olympus-nuvoton ttyS0

olympus-nuvoton login: root
Password: 0penBmc (first letter zero and not capital o)

8) More information

See the readme.txt, there are documents about RunBMC implementation, schematics, and BOM list.

For more info follow the readme.txt in: ftp://ftp.nuvoton.co.il/outgoing/Eval_Board at the section: "Loading to Evaluation Board and running instructions". In order to get a password for the ftp please contact [email protected]

9) Enabled features

Olympus RunBMC Platform https://github.com/Nuvoton-Israel/openbmc/tree/runbmc/meta-quanta/meta-olympus-nuvoton

BUV RunBMC Platform https://github.com/Nuvoton-Israel/openbmc/tree/runbmc/meta-evb/meta-evb-nuvoton/meta-buv-runbmc

Contact

• Mail: [email protected], [email protected] or [email protected]