coreboot学习2：项目源码的初步了解

本文主要介绍coreboot源码的目录结构和其它一些东西。

一、目录结构

1、一级目录

coreboot的一级目录比较少，现分别简单。

src：源码目录，后文再介绍。

util：工具目录，编译使用到的命令，一些脚本，等等。比如sconfig根据代码生成static.c文件，该文件在枚举设备时十分重要。而romcc则是在编译中使用到的命令。另外，还有一些有用的工具，如读写msr寄存器的msrtool。

payloads：该目录存储的是当前支持的payload。在子目录external中，就有GRUB2、SeaBIOS、U-Boot等其名的bootloader。

3rdparty：第三方库目录，里面有vboot、arm-trusted-firmware。注意，coreboot的git仓库上这几个是引用其它的仓库，所以clone下来是暂时没有内容的，只有要编译时才会去clone，之后就不会再执行了。

build：编译专用目录，生成的最终文件coreboot.rom便位于此目录。

Documentation：文档目录。在ubuntu下使用doxygen可以生成代码html文档，使用命令安装：$ sudo apt-get install  doxygen graphviz。进入该目录，执行doxygen Doxyfile.coreboot即可生成。

下面是用tree命令打印的二级目录，如下：

latelee@latelee:~/bios/coreboot-master/coreboot_m$ tree -L 2
.
├── 3rdparty
│   ├── arm-trusted-firmware
│   ├── blobs
│   ├── chromeec
│   └── vboot
├── COPYING
├── MAINTAINERS
├── Makefile
├── Makefile.inc
├── payloads
│   ├── bayou
│   ├── coreinfo
│   ├── external
│   ├── Kconfig
│   ├── libpayload
│   ├── Makefile.inc
│   └── nvramcui
├── README
├── src
│   ├── acpi
│   ├── arch
│   ├── commonlib
│   ├── console
│   ├── cpu
│   ├── device
│   ├── drivers
│   ├── ec
│   ├── include
│   ├── Kconfig
│   ├── lib
│   ├── mainboard
│   ├── northbridge
│   ├── soc
│   ├── southbridge
│   ├── superio
│   └── vendorcode
├── toolchain.inc
└── util
├── abuild
├── acpi
├── amdfwtool
├── amdtools
├── archive
├── arm_boot_tools
├── autoport
├── bimgtool
├── board_status
├── broadcom
├── cbfstool
├── cbmem
├── chromeos
├── crossgcc
├── dtd_parser
├── ectool
├── exynos
├── futility
├── fuzz-tests
├── genbuild_h
├── genprof
├── gitconfig
├── ifdfake
├── ifdtool
├── inteltool
├── intelvbttool
├── ipqheader
├── k8resdump
├── kconfig
├── lint
├── marvell
├── mma
├── msrtool
├── mtkheader
├── nvidia
├── nvramtool
├── optionlist
├── post
├── release
├── rockchip
├── romcc
├── sconfig
├── scripts
├── showdevicetree
├── spkmodem_recv
├── superiotool
├── uio_usbdebug
├── vgabios
├── viatool
└── xcompile

2、src目录

下面简单说说src目录的子目录。

arch：平台架构代码。当前支持的有arm、arm64、mips、x86，等等。

commonlib：共用库。如cbfs。

console：终端代码，比如printk实现，还有终端初始化。

cpu：该目录包括了allwinner、amd、intel、x86模拟器qemu-x86。其中x86目录包含了入口函数(即上电启动第一条指令)。

device：设备目录。比如重要的文件有device.c、pci_device.c，等。

drivers：驱动目录。

mainboard：主板目录。里面包含了各式各样的主板。比如qemu使用的“主板”代码位于emulation目录。

northbridge：北桥芯片目录。

southbridge：南桥芯片目录。

soc：一些“平台”的代码目录。比如大名鼎鼎的英特尔(Intel)的baytrail、braswell、skylake、quark，等(注：感觉coreboot对英特尔还是很到位的，新出的平台很快能支持)。还有英伟达(nvidia)的tegra。

vendorcode：厂商微码目录。比如英特尔(Intel)的固件支持包(fsp)。可搜索一下处理器“微码”方面的资料。

二、编译配置

coreboot配置使用make menuconfig进行，与大部分的大型开源项目(比如Linux内核、openwrt，等)类似。

在实践中推荐使用qemu，因为qemu拥有快速、便捷性。在没有实物情况下可以调试跟踪。像Intel、AMD或其它的芯片平台，还需要烧写到开发板上才能验证。另外，使用qemu并不会对coreboot的整体流程跟踪产生影响。

至此，万事俱备，接下来就可以一边在代码添加打印信息(方便观察跟踪)，并使用qemu模拟环境启动以便验证。

李迟 2016.3.13 周日 晚