Lichee（一）­­ lichee目录结构介绍和编译命令

经过繁琐的环境搭建和漫长的代码下载的等待，我们终于可以开始我们的lichee之旅了，由于内容很繁杂，涉及面比较广，接下来就针对linux uboot modules等是如何被打包到固件这条主线来分析，先理清树干，再慢慢理清枝叶吧！

先认识一下什么是Lichee： Lichee表示全志科技A10芯片的开发代号，英 [,laɪ'tʃiː]  美 [,laɪ'tʃi] 荔枝的意思, 跟魔兽里面的巫妖lich没有关系哈  ^_^！

目录结构

.

├── boot

├── buildroot

├── build.sh

├── linux-3.0

├── out

├── README

├── tools

└── u-boot

  buildroot

它的主要作用是

1. 管理包之间的依赖关系
2. 生成ARM交叉工具链
3. 生成U-Boot
4. 制作根文件系统，可以包含strace, directfb, oprofile等非常丰富的应用软件和测试软件
5. 生成最终用于烧写的固件包

它的目录结构如下

buildroot/ 

|-- board 

|-- boot 

|-- CHANGES 

|-- Config.in 

|-- configs 

|-- COPYING 

|-- dl 

|-- docs 

|-- fs 

|-- linux 

|-- Makefile 

|-- package 

|-- readme.txt 

|-- scripts 

|-- target 

|-- tools 

`-- toolchain 

其中，boot目录里存放Boot代码，config目录里存放预定义好的配置文件，比如我们的sun4i_defconfig，dl目录里存放已经下载好的软件包，scripts目录里存放buildroot运作的代码，target目录里存放用于生成根文件系统的一些规则文件，在tools目录中存放的是用于打包和量产的pc工具。对于我们来说最为重要的是package目录，里面存放了将近3000个软件包的生成规则，我们可以在里面添加我们自己的软件包或者是中间件。更多关于buildroot的介绍，可以到buildroot的官方网站http://buildroot.uclibc.org/获取。

linux-3.0

目录结构如下，

linux-3.0/ 

|-- arch 

|-- block 

|-- build 

|-- COPYING 

|-- CREDITS 

|-- crypto 

|-- Documentation 

|-- drivers 

|-- firmware 

|-- fs 

|-- include 

|-- init 

|-- ipc 

|-- Kbuild 

|-- kernel 

|-- lib 

|-- MAINTAINERS 

|-- Makefile 

|-- mm 

|-- modules 

|-- net 

|-- output 

|-- README 

|-- REPORTING-BUGS 

|-- rootfs 

|-- samples 

|-- scripts 

|-- security 

|-- sound 

|-- tools 

|-- usr 

`-- virt 

以上目录结构跟标准的Linux内核是一致的，除了多一个modules目录。modules目录是我们扩展用来存放没有跟内核的menuconfig集成的外部模块的地方。我们目前放了example, mali和wifi这3个外部模块，其中example是示例用的，mali是我们的3D GPU驱动。

linux-3.0/modules/ 

├── cedarx

├── example

├── gps

├── mali

├── nand

└── wifi

tools 基本作用： 1.  不同芯片不同产品的集成打包功能 2.  不同产品的特殊配置，例如分区、各种外设的配置、CPU频率电压等，基本上涵盖了配置一款产品的所有功能 3.  制作固件包时可能用到的工具和脚本

目录结构 tools 

├── daily_build 

├── pack 

└── tools_win

tools目录是非常重要的，daily_build存放的是各种版本各种型号的自动化脚本

目录结构  tools/daily_build/ 

├── android_clean.sh 

├── auto_crane_2.6.sh 

├── auto_crane_3.0.sh 

├── auto_linux_2.6.sh 

├── auto_linux_3.0.sh 

├── auto_linux_3.0_sun5i_a12.sh 

├── auto_linux_3.0_sun5i_a13.sh 

├── build_android4.0.sh 

└── clean.sh

这些脚本目前仅仅作为参考，因为在当前的sun4i这个版本中，没有用到其中任何一个脚本

目录结构 tools/pack/ 

├── chips 

├── out 

├── pack 

├── pack.bat 

├── pctools 

├── sun4i_crane_test1.img 

└── sun4i_crane_test2.img

pack是一个非常关键的目录，chips存放着各种制造商的配置，当然后面的移植过程中将会重点提到，out目录是打包过程中产生的各种bin、cfg、fex文件，为最终的img打包文件做准备；pack脚本是将out目录中的各种文件打包的脚本，后面也会专门探讨，pack.bat很显然是windows平台下打包的批处理脚本，pctools是windows linux2种平台中打包过程中可能用到的小工具，暂时还没有用到；sun4i_crane_xxx.img就是我们通过pack打包生成的固件，可以直接烧写到目标板，其中sun4i代表是芯片版本（还有sun5i sun6i等） crane代表是android的固件，xxx代表是产品名，都是自己起的

u-boot

目录结构 u-boot/ 

├── api 

├── arch 

├── board 

├── boards.cfg 

├── build.sh 

├── common 

├── config.mk 

├── COPYING 

├── CREDITS 

├── disk 

├── doc 

├── drivers 

├── examples 

├── fs 

├── include 

├── lib 

├── MAINTAINERS 

├── MAKEALL 

├── Makefile 

├── mkconfig 

├── mmc_spl 

├── nand_spl 

├── nand_sunxi 

├── net 

├── onenand_ipl 

├── post 

├── README 

├── rules.mk 

├── snapshot.commit 

├── spl 

├── System.map 

├── tools 

├── u-boot 

├── u-boot.bin 

├── u-boot.lds 

├── u-boot.map 

└── u-boot.srec

其中build.sh就是用来编译u-boot

build.sh

打包的脚本，细心的人应该已经观察到，在buildroot linux3.0 u-boot目录中都存在一个build.sh的脚本文件,这个文件就是我们实现自动化一步打包的脚本 具体过程如下图

编译代码

首先，我们来看看build.sh的usage

NAME

    build - The top level build script for Lichee Linux BSP

SYNOPSIS

    build [-h] | [-p platform] [-k kern_version] [-m module] | pack

OPTIONS

    -h Display help message

    -p [platform] platform, e.g. sun4i, sun4i-lite, sun4i-debug, sun4i_crane

                   sun4i: full linux bsp

                   sun4i-lite: linux bsp with less packages

                   sun4i-debug: linux bsp for debug

                   sun4i_crane: android kernel

    -k [kern_ver] 2.6.36(default), or 3.0 [OPTIONAL]

    -m [module] Use this option when you dont want to build all. [OPTIONAL]

                   e.g. kernel, buildroot, uboot, all(default)...

    pack To start pack program

Examples:

    ./build.sh -p sun4i

    ./build.sh -p sun4i_crane

    ./build.sh -p sun4i-lite

    ./build.sh pack

我们当前的平台是android，所以platform 要选 sun4i_crane 当前的内核版本是linux3.0 ，所以kern_ver 是3.0 如果不带-k参数，当然就是默认的2.6.36

所以我们的编译命令就是

$./build.sh -p sun4i-crane -k 3.0 

太方便了！ 一条命令把linux uboot 自定义的modules和configs等全部搞定啦