Building U-boot and Linux for H5/H3/H2+/zh
Contents
1 Linux Mainline简介
Mainline即主线的意思，Linux内核的开发分为Linus维护的主线、其他开发分支以及各种稳定版本。开发分支最终都会统一提交到Linus维护的主线中。
最新版本的U-boot和主线Linux内核已经支持了全志的H3/H5 CPU，我们在最新版本的的U-boot和主线Linux内核的基础上进行了定制开发，使其能支持上NanoPi H5/H3/H2+系列的开发板。
注意: 本维基的内容仅适用于基于Linux-4.14内核的系统固件，请不要在基于全志原厂H5-Linux-3.10/H3-Linux-3.4内核的系统固件上执行本维基里描述的操作。
2 特性
3 制作一张带运行系统的SD卡
3.1 下载系统固件
开发板型号 CPU型号 固件下载地址 固件名称 NanoPi Duo H2+ 下载 official-ROMs/nanopi-duo_sd_friendlycore-xenial_4.14_armhf_YYYYMMDD.img.zip NanoPi NEO H3 下载 official-ROMs/nanopi-neo_sd_friendlycore-xenial_4.14_armhf_YYYYMMDD.img.zip NanoPi NEO Air H3 下载 official-ROMs/nanopi-neo-air_sd_friendlycore-xenial_4.14_armhf_YYYYMMDD.img.zip NanoPi M1 H3 下载 official-ROMs/nanopi-m1_sd_friendlycore-xenial_4.14_armhf_YYYYMMDD.img.zip NanoPi M1 Plus H3 下载 official-ROMs/nanopi-m1-plus_sd_friendlycore-xenial_4.14_armhf_YYYYMMDD.img.zip NanoPi NEO Core H3 下载 official-ROMs/nanopi-neo-core_sd_friendlycore-xenial_4.14_armhf_YYYYMMDD.img.zip NanoPi Duo2 H3 下载 official-ROMs/nanopi-duo2_sd_friendlycore-xenial_4.14_armhf_YYYYMMDD.img.zip NanoPi NEO2 H5 下载 official-ROMs/nanopi-neo2_sd_friendlycore-xenial_4.14_armhf_YYYYMMDD.img.zip NanoPi NEO Plus2 H5 下载 official-ROMs/nanopi-neo-plus2_sd_friendlycore-xenial_4.14_arm64_YYYYMMDD.img.zip NanoPi NEO Core2 H5 下载 official-ROMs/nanopi-neo-core2_sd_friendlycore-xenial_4.14_arm64_YYYYMMDD.img.zip NanoPi K1 Plus H5 下载 official-ROMs/nanopi-k1-plus_sd_friendlycore-xenial_4.14_arm64_YYYYMMDD.img.zip
3.2 制作FriendlyCore with Qt-Embedded系统TF卡
将固件和烧写工具 win32diskimager.rar 分别解压，在 Windows 下插入TF卡（限4G及以上的卡)，以管理员身份运行 win32diskimager 工具，
在 win32diskimager 工具的界面上，选择你的SD卡盘符，选择系统固件，点击 Write 按钮烧写即可。烧写完成后，将制作好SD卡插入 NanoPi H3/H5/H2+ 开发板，使用USB供电(5V/2A)，看到板上的蓝色LED闪烁，这说明系统已经开始启动了。
4 为H3/H2+编译Linux-4.14 BSP
4.1 安装交叉编译器
访问此处下载地址的toolchain目录，下载交叉编译器arm-cortexa9-linux-gnueabihf-4.9.3.tar.xz，然后解压编译器:
$ mkdir -p /opt/FriendlyARM/toolchain $ tar xf arm-cortexa9-linux-gnueabihf-4.9.3.tar.xz -C /opt/FriendlyARM/toolchain/
然后将编译器的路径加入到PATH中，用vi编辑vi ~/.bashrc，在末尾加入以下内容：
$ export PATH=/opt/FriendlyARM/toolchain/4.9.3/bin:$PATH $ export GCC_COLORS=auto
执行一下~/.bashrc脚本让设置立即在当前shell窗口中生效，注意"."后面有个空格：
$ . ~/.bashrc
这个编译器是64位的，不能在32位的Linux系统上运行，安装完成后，你可以快速的验证是否安装成功：
$ arm-linux-gcc -v gcc version 4.9.3 (ctng-1.21.0-229g-FA)
4.2 编译U-boot
下载U-boot源码，并切换分支:
$ git clone https://github.com/friendlyarm/u-boot.git -b sunxi-v2017.x --depth 1
编译U-boot:
$ apt-get install swig python-dev python3-dev $ cd u-boot $ make nanopi_h3_defconfig ARCH=arm CROSS_COMPILE=arm-linux- $ make ARCH=arm CROSS_COMPILE=arm-linux-
这里使用的配置文件nanopi_h3_defconfig可以支持友善电子所有的H3/H2+的开发板。
编译成功后会生成文件u-boot-sunxi-with-spl.bin。
更新SD上的U-boot:
将SD卡插入PC中，然后执行如下命令:
$ cd u-boot $ dd if=u-boot-sunxi-with-spl.bin of=/dev/sdX bs=1024 seek=8 $ sync && eject /dev/sdX
/dev/sdx请替换为实际的TF卡设备文件名。
sync命令可以确保数据成功写到TF卡中，eject命令用于弹出TF卡。
当正在使用SD卡运行系统时，也可以先用scp命令拷贝u-boot-sunxi-with-spl.bin到开发板上，然后用dd命令更新SD卡上的U-boot:
$ scp u-boot-sunxi-with-spl.bin root@192.168.1.230:/root/ $ dd if=/root/u-boot-sunxi-with-spl.bin of=/dev/mmcblk0 bs=1024 seek=8
如果是带有eMMC的开发板，当正在使用eMMC运行系统时，也可以先用scp命令拷贝u-boot-sunxi-with-spl.bin到开发板上，然后用dd命令更新eMMC上的U-boot:
$ scp u-boot-sunxi-with-spl.bin root@192.168.1.230:/root/ $ dd if=/root/u-boot-sunxi-with-spl.bin of=/dev/mmcblk0 bs=1024 seek=8
NanoPi H3/H2+开发板的启动设备的设备节点总是/dev/mmcblk0。
4.3 编译Linux内核
下载Linux内核源码，并切换分支:
$ git clone https://github.com/friendlyarm/linux.git -b sunxi-4.14.y --depth 1
编译和更新Linux内核:
$ cd linux $ touch .scmversion $ make sunxi_defconfig ARCH=arm CROSS_COMPILE=arm-linux- $ make zImage dtbs ARCH=arm CROSS_COMPILE=arm-linux-
编译完成后会在arch/arm/boot/目录下生成zImage，并且在arch/arm/boot/dts/目录下生成dtb文件。
假设SD卡的boot分区挂载在/media/SD/boot/，更新SD卡上的zImage和dtb文件:
$ cp arch/arm/boot/zImage /media/SD/boot/ $ cp arch/arm/boot/dts/sun8i-*-nanopi-*.dtb /media/SD/boot/
编译和更新驱动模块:
$ cd linux $ make modules ARCH=arm CROSS_COMPILE=arm-linux-
假设SD卡的rootfs分区挂载在/media/SD/rootfs/，更新SD卡上rootfs的驱动模块:
$ cd linux $ make modules_install INSTALL_MOD_PATH=/media/SD/rootfs/ ARCH=arm CROSS_COMPILE=arm-linux-
5 为H5编译Linux-4.14 BSP
5.1 安装交叉编译器
访问此处下载地址的toolchain目录，下载交叉编译器gcc-linaro-6.3.1-2017.02-x86_64_aarch64-linux-gnu.tar.xz，然后解压编译器:
$ mkdir -p /opt/FriendlyARM/toolchain $ tar xf gcc-linaro-6.3.1-2017.02-x86_64_aarch64-linux-gnu.tar.xz -C /opt/FriendlyARM/toolchain/
然后将编译器的路径加入到PATH中，用vi编辑vi ~/.bashrc，在末尾加入以下内容：
$ export PATH=/opt/FriendlyARM/toolchain/gcc-linaro-6.3.1-2017.02-x86_64_aarch64-linux-gnu/bin:$PATH $ export GCC_COLORS=auto
执行一下~/.bashrc脚本让设置立即在当前shell窗口中生效，注意"."后面有个空格：
$ . ~/.bashrc
安装完成后，你可以快速的验证是否安装成功：
$ aarch64-linux-gnu-gcc -v gcc version 6.3.1 20170109 (Linaro GCC 6.3-2017.02)
5.2 编译U-boot
下载U-boot源码，并切换分支:
$ git clone https://github.com/friendlyarm/u-boot.git -b sunxi-v2017.x --depth 1
编译U-boot:
$ apt-get install swig python-dev python3-dev $ cd u-boot $ make nanopi_h5_defconfig CROSS_COMPILE=aarch64-linux-gnu- $ make CROSS_COMPILE=aarch64-linux-gnu-
这里使用的配置文件nanopi_h5_defconfig可以支持友善电子所有的H5的开发板。
更新SD上的U-boot:
将SD卡插入PC中，然后执行如下命令:
$ cd u-boot $ dd if=spl/sunxi-spl.bin of=/dev/sdX bs=1024 seek=8 $ dd if=u-boot.itb of=/dev/sdX bs=1024 seek=40
/dev/sdx请替换为实际的TF卡设备文件名。
当正在使用SD卡运行系统时，也可以先用scp命令拷贝sunxi-spl.bin和u-boot.itb到开发板上，然后用dd命令更新SD卡上的U-boot:
$ scp spl/sunxi-spl.bin root@192.168.1.230:/root/ $ scp u-boot.itb root@192.168.1.230:/root/ $ dd if=/root/sunxi-spl.bin of=/dev/mmcblk0 bs=1024 seek=8 $ dd if=/root/u-boot.itb of=/dev/mmcblk0 bs=1024 seek=8
如果是带有eMMC的开发板，当正在使用eMMC运行系统时，也可以先用scp命令拷贝sunxi-spl.bin和u-boot.itb到开发板上，然后用dd命令更新eMMC上的U-boot:
$ scp spl/sunxi-spl.bin root@192.168.1.230:/root/ $ scp u-boot.itb root@192.168.1.230:/root/ $ dd if=/root/u-boot-sunxi-with-spl.bin of=/dev/mmcblk0 bs=1024 seek=8
NanoPi H5开发板的启动设备的设备节点总是/dev/mmcblk0。
5.3 编译Linux内核
下载Linux内核源码，并切换分支:
$ git clone https://github.com/friendlyarm/linux.git -b sunxi-4.x.y --depth 1
编译和更新Linux内核:
$ cd linux $ touch .scmversion $ make sunxi_arm64_defconfig ARCH=arm64 CROSS_COMPILE=aarch64-linux-gnu- $ make Image dtbs ARCH=arm64 CROSS_COMPILE=aarch64-linux-gnu-
编译完成后会在arch/arm64/boot/目录下生成Image，并且在arch/arm64/boot/dts/allwinner/目录下生成dtb文件。
假设SD卡的boot分区挂载在/media/SD/boot/，更新SD卡上的Image和dtb文件:
$ cp arch/arm64/boot/Image /media/SD/boot/ $ cp arch/arm64/boot/dts/allwinner/sun50i-h5-nanopi*.dtb /media/SD/boot/
编译和更新驱动模块:
$ cd linux $ make modules ARCH=arm64 CROSS_COMPILE=aarch64-linux-gnu-
假设SD卡的rootfs分区挂载在/media/SD/rootfs/，更新SD卡上rootfs的驱动模块:
$ cd linux $ make modules_install INSTALL_MOD_PATH=/media/SD/rootfs/ ARCH=arm64 CROSS_COMPILE=aarch64-linux-gnu-
