docs/development/dev-environment.md

15 walk you through utilizing bitbake to build OpenBMC firmware and boot it in
18 Bitbake is the build engine used by Yocto and OpenBMC to build its custom Linux
41    [VMware](https://www.vmware.com/products/workstation-player/workstation-player-evaluation.html)
49    OpenBMC continuous integration utilizes docker to build its images. This is
51    [build-setup.sh](https://github.com/openbmc/openbmc-build-scripts/blob/master/build-setup.sh)
52    for a reference on the script CI uses to build an appropriate docker
63    **VirtualBox Tips** - You'll want copy/paste working between your VM and
65    - Devices -> Insert Guest Additions CD Image (install)
66    - Devices -> Shared Clipboard -> Bidirectional
67    - reboot (the VM)
72    [Prerequisite](https://github.com/openbmc/openbmc/blob/master/README.md#1-prerequisite)
75    **Note** - In Ubuntu, a "sudo apt-get update" will probably be needed before
81 OpenBMC image. Future tutorials will build on this by having you customize the
84 …est-master/label=docker-builder,target=romulus/lastSuccessfulBuild/artifact/openbmc/build/tmp/depl…
86 [Download and Start QEMU Session](#download-and-start-qemu-session) section.
94 2. Build the Romulus OpenBMC Image (note this will take 30 - 120 minutes
99    bitbake obmc-phosphor-image
103 `build/tmp/deploy/images/romulus/obmc-phosphor-image-romulus.static.mtd`
111 …wget https://jenkins.openbmc.org/job/latest-qemu-x86/lastSuccessfulBuild/artifact/qemu/build/qemu-…
113    chmod u+x qemu-system-arm
116 2. Copy the image generated by the build to your current directory
119    cp ./tmp/deploy/images/romulus/obmc-phosphor-image-romulus.static.mtd ./
124    **Note** - For REST, SSH and IPMI to work into your QEMU session, you must
130    ./qemu-system-arm -m 256 -M romulus-bmc -nographic \
131       -drive file=./obmc-phosphor-image-romulus.static.mtd,format=raw,if=mtd \
132       -net nic \
133 …-net user,hostfwd=:127.0.0.1:2222-:22,hostfwd=:127.0.0.1:2443-:443,hostfwd=udp:127.0.0.1:2623-:623…
141    ./qemu-system-arm -m 256 -machine romulus-bmc -nographic \
142     -drive file=./obmc-phosphor-image-romulus.static.mtd,format=raw,if=mtd \
143     -net nic \
144     -net
145 …user,hostfwd=:127.0.0.1:22-:22,hostfwd=:127.0.0.1:443-:443,hostfwd=tcp:127.0.0.1:80-:80,hostfwd=tc…
149 4. Wait for your QEMU-based BMC to boot
173    ssh root@localhost -p 2222
193 - set up a bmc build environment
196 source setup romulus myBuild/build
199 - add the qemu x86 open embedded machine for testing
205 - Make the changes to the build (ie devtool modify bmcweb, devtool add gdb)
211 - build open bmc for the qemu x86 machine
214 MACHINE=qemux86 bitbake obmc-phosphor-image
217 - run qemu they way yocto provides
220 runqemu myBuild/build/tmp/deploy/images/qemux86/ nographic \
221     qemuparams="-m 2048"
224 - after that the all the a TAP network interface is added, and protocol like
227 ## Sharing Downloads and Build Cache
229 BitBake caches both fetched sources (DL_DIR) and reusable build outputs
231 re-downloading and re-building, saving time and disk.
236    mkdir -p "${XDG_CACHE_HOME}/bitbake/downloads" "${XDG_CACHE_HOME}/bitbake/sstate"
239 2. Add to build/conf/local.conf:
246 This makes every build reuse what was already downloaded and built, so you use