How to make your own SD-bootable ROM/zh

From FriendlyELEC WiKi
Revision as of 02:03, 18 November 2018 by Wuweidong (Talk | contribs)

Jump to: navigation, search

English


1 Change the files in rootfs.img and boot.img

simg2img rootfs.img r.img
mount -t ext4 -o loop r.img /mnt
… To Change Something …
umount /mnt
img2simg r.img rootfs.img

2 制作4418/6818平台文件系统映象文件

这里介绍如何将一个目录制作成映像文件,例如:
将boot目录制作成 boot.img
将rootfs目录制作成 rootfs.img
这些文件被用于 eflasher,烧写到eMMC。
1) 下载 https://github.com/friendlyarm/debian_nanopi2 ;
2) 复制 SD卡中的 boot 分区下的文件到debian_nanopi2/boot ; 复制SD卡中的 rootfs分区下的文件到 debian_nanopi2/rootfs ;
根据自己的需要可以再修改 boot 和 rootfs 目录下的文件。
建议删除rootfs 目录下的文件 etc/fs.resized 否则将不会自动扩展分区。
3) 使用 debian_nanopi2 下的 make_ext4fs 来制作 img:

./tools/make_ext4fs -s -l 67108864 -a root -L boot boot.img boot
./tools/make_ext4fs -s -l 3670016000 -a root -L rootfs rootfs.img rootfs

有一点需要注意的是rootfs.img的大小需要大于rootfs目录的大小,我们默认提供的各个系统的rom,用的是以下值:
lubuntu: 5368709120
debian: 3670016000
friendlycore: 3670016000

4) 复制新生成的 boot.img 和 rootfs.img 替换 eflasher 的FAT分区 core-qte 目录下的文件,然后即可烧写;

3 制作H3/H5系列板子的Linux ROM文件

如果您定制了U-boot、Linux内核、文件系统,并且想基于自己定制的文件制作Linux ROM文件,可以参考如下操作:
下载脚本工具rom-maker-lite: 点击下载,然后在PC机 Ubuntu系统里解压。
该脚本工具目前支持为 H3/H5 系列的开发板制作Linux平台的ROM文件,执行./mkimage.sh可以查看帮助信息:

$ ./mkimage.sh 
Usage:
	 ./mkimage.sh <prepare type> <image size> <partmap> <misc dir> <partition1 dir> <partition2 dir>
		 prepare type: 
			 p1: prepare misc(bootloader) + partition1.img(fat32 boot) + partition2.img(ext4 rootfs)
			 p2: prepare misc(bootloader) + partition1.img(ext4 boot) + partition2.img(ext4 rootfs)
		 image size: 
			 size of SD-bootable.img
 p1 example:
	 H3_Linux-4.14:
		 ./mkimage.sh p1 3900 partmap/h3_linux-4.14/partmap.txt misc/uboot-2017_h3/ partition1/boot_linux-4.14_h3/ partition2/rootfs_demo/
	 H3_Eflasher-4.14:
		 ./mkimage.sh p1 7800 partmap/h3_eflasher-4.14/partmap.txt misc/uboot-2017_h3/ partition1/boot_linux-4.14_h3/ partition2/rootfs_demo/
	 M1_Linux-3.4:
		 ./mkimage.sh p1 3900 partmap/h3_linux-3.4/partmap.txt misc/uboot-2011_m1/ partition1/boot_linux-3.4_m1/ partition2/rootfs_demo/
	 M1-Plus_Linux-3.4:
		 ./mkimage.sh p1 3900 partmap/h3_linux-3.4/partmap.txt misc/uboot-2011_m1-plus/ partition1/boot_linux-3.4_m1-plus/ partition2/rootfs_demo/
	 H5_Linux-4.14:
		 ./mkimage.sh p1 3900 partmap/h5_linux-4.14/partmap.txt misc/uboot-2017_h5/ partition1/boot_linux-4.14_h5/ partition2/rootfs_demo/
	 NEO2_Linux-3.10:
		 ./mkimage.sh p1 3900 partmap/h5_linux-3.10/partmap.txt misc/uboot-2014_neo2/ partition1/boot_linux-3.10_neo2/ partition2/rootfs_demo/
参数 说明
<prepare type> 用于指定做ROM前的准备方式,对于H3/H5系列的开发板,用户只需固定选择p1即可。
<image size> 用于指定最终生成的ROM Image的大小,单位是MByte,用户可以根据实际需求来调整该值。
<partmap> 用于指定制作ROM时需要的partmap文件,partmap文件用于指定ROM Image的布局方式和组成文件,不同的板子或者是同一板子不同版本的BSP使用的partmap文件是不一样的。
<misc dir> 对于H3/H5系列的开发板,用于指定bootloader所在的目录路径。
<partition1 dir> 对于H3/H5系列的开发板,用于指定boot分区的目录路径。
<partition2 dir> 对于H3/H5系列的开发板,用于指定rootfs分区的目录路径。


  • 为H3 系列的板子制作基于Uboot-2017 + Linux-4.14 的ROM

执行命令:

$ ./mkimage.sh p1 3900 partmap/h3_linux-4.14/partmap.txt misc/uboot-2017_h3/ partition1/boot_linux-4.14_h3/ partition2/rootfs_demo/

请将对应目录(misc/uboot-2017_h3/ partition1/boot_linux-4.14_h3/ partition2/rootfs_demo/)下的文件替换为您自己的定制文件,当然您也可以使用目录里预编译好的系统文件,我们会不定期更新预编译好的系统文件,但是rootfs_demo只是一个空目录,请务必用您自己定制的rootfs代替rootfs_demo,通过tree命令可查看有哪些可替换的系统文件,例如:

$ tree misc/uboot-2017_h3/ partition1/boot_linux-4.14_h3/
misc/uboot-2017_h3/
└── u-boot-sunxi-with-spl.bin
partition1/boot_linux-4.14_h3/
├── boot.cmd
├── boot.scr
├── rootfs.cpio.gz
├── sun8i-h2-plus-nanopi-duo.dtb
├── sun8i-h3-nanopi-duo2.dtb
├── sun8i-h3-nanopi-m1.dtb
├── sun8i-h3-nanopi-m1-plus.dtb
├── sun8i-h3-nanopi-neo-air.dtb
├── sun8i-h3-nanopi-neo-core.dtb
├── sun8i-h3-nanopi-neo.dtb
└── zImage

对于所有使用Linux-4.14 BSP的H3板子,使用的都是同一个partmap文件partmap/h3_linux-4.14/partmap.txt。
mkimage.sh执行成功后,会生成一个out目录,其内容如下:

$ tree out/
out/
├── boot.img
├── partmap.txt
├── rootfs.img
├── SD-bootable.img
└── u-boot-sunxi-with-spl.bin

partition1/boot_linux-4.14_h3/目录被制作成了boot.img,partition2/rootfs_demo/被制作成了rootfs.img,而SD-bootable.img则为最终的ROM Image文件,您可以通过如下命令迅速将其烧写到SD卡中以进行测试:

$ ./tools/sd_update -d /dev/sdX -p /root/rom-maker-lite/out/partmap.txt

注意: 请将/dev/sdX替换为实际的SD卡设备节点。


  • 为H3 系列的板子制作基于Uboot-2011 + Linux-3.4 的ROM

以NanoPi M1为例,执行命令:

$ ./mkimage.sh p1 3900 partmap/h3-linux-3.4/partmap.txt misc/uboot-2011_m1/ partition1/boot_linux-3.4_m1/ partition2/rootfs_demo/

请将对应目录下的文件替换为您自己的定制文件。
对于所有使用Linux-3.4 BSP的H3板子,使用的都是同一个partmap文件partmap/h3-linux-3.4/partmap.txt。


  • 为H5 系列的板子制作基于Uboot-2017 + Linux-4.14 的ROM

执行命令:

$ ./mkimage.sh p1 3900 partmap/h5-linux-4.14/partmap.txt misc/uboot-2017_h5/ partition1/boot_linux-4.14_h5/ partition2/rootfs_demo/

请将对应目录下的文件替换为您自己的定制文件。
对于所有使用Linux-4.14 BSP的H5板子,使用的都是同一个partmap文件partmap/h5-linux-4.14/partmap.txt。


  • 为H5 系列的板子制作基于Uboot-2014 + Linux-3.10 的ROM

以NanoPi NEO2为例,执行命令:

$ ./mkimage.sh p1 3900 partmap/h5-linux-3.10/partmap.txt misc/uboot-2014_neo2/ partition1/boot_linux-3.10_neo2/ partition2/rootfs_demo/

请将对应目录下的文件替换为您自己的定制文件。
对于所有使用Linux-3.10 BSP的H5板子,使用的都是同一个partmap文件partmap/h5-linux-3.10/partmap.txt。


4 用自制系统制作可启动的SD卡或者SD卡映象

在产品量产阶段,通常需要为自已的定制过的产品制作专用的系统映象,这里的系统映象是指 Android编译生成的 boot.img、system.img,或者Ubuntu的根文件系统 rootfs.img 等等。
这个章节将介绍如何用自已编译的系统映象,制作一张可以启动的SD卡,或者,制作一个完整的系统映象文件,完整的系统映象可用于产品量产时批量生成SD卡。
下面以制作S5P4418 Android 启动卡为例,命令如下:

git clone https://github.com/friendlyarm/sd-fuse_nanopi2.git
cd sd-fuse_nanopi2
wget http://112.124.9.243/dvdfiles/S5P4418/images-for-eflasher/android-lollipop-images.tgz
tar xvzf android-lollipop-images.tgz

注:如果是S5P6818,你需要将sd-fuse_nanopi2.git改为sd-fuse_nanopi3.git,S5P4418改为S5P6818。
现在,请将自已编译生成的 Android映象替换掉Android目录下的同名文件,然后用以下命令制作一张可以启动的SD卡:

sudo ./fusing.sh /dev/sde android

注:请将/dev/sde替换为真实的SD卡设备名称。

如果要制成一个完整的系统映象文件,命令改为:

sudo ./mkimage.sh android