查看“Roc-rk3399-pc build linux”的源代码

=编译firefly linux-sdk系统=
*参考网址 http://wiki.t-firefly.com/zh_CN/ROC-RK3399-PC/
==编译前配置==
===配置sdk===
*下载源码
使用浏览器打开 https://pan.baidu.com/s/1yjc9aMB-ds7Xixifgov0Gg 保存资料光盘中的 Firefly-sdk_v1 到自己的网盘中，让后进行下载。 
*解压源码
使用FileZilla或其它软件上传下载后的<code>linux-sdk</code>源码包，让后通过7z工具进行解压。
 7z x linux-rk3399-sdk.7z.001
*同步源码
 repo sync -c
如果提示<code>repo</code>命令不存在，请使用手动下载安装，或者使用我们已经上传到仓库中的。

===配置 roc-rk3399-pc===
*配置文件 roc-rk3399-pc.mk:

 ./build.sh roc-rk3399-pc.mk
文件路径在<code>device/rockchip/rk3399/roc-rk3399-pc.mk</code>

如果配置文件生效会连接到device/rockchip/.BoardConfig.mk,检查该文件可以验证是否配置成功

注意:roc-rk3399-pc.mk为编译生成buildroot固件的配置文件.同时用户也可以通过参考该配置生成新的配置文件来适配自己所需要的固件。

*重要配置介绍:(如果需要diy固件，可能需要修改下列配置信息)

 # Uboot defconfig
 export RK_UBOOT_DEFCONFIG=roc-rk3399-pc   编译uboot配置文件

 # Kernel defconfig
 export RK_KERNEL_DEFCONFIG=firefly_linux_defconfig   编译kernel配置文件

 # Kernel dts
 export RK_KERNEL_DTS=rk3399-roc-pc   编译kernel用到的dts

 # parameter for GPT table
 export RK_PARAMETER=parameter-ubuntu.txt   分区信息(十分重要)

 # packagefile for make update image 
 export RK_PACKAGE_FILE=rk3399-ubuntu-package-file   打包配置文件

 # rootfs image path
 export RK_ROOTFS_IMG=xxxx/xxxx.img   根文件系统镜像路径

注意,十分重要！！

默认配置编译buildroot固件，如果想编译其他固件(如ubuntu固件)请执行一下操作:

==全自动编译==

在配置和搭建环境的工作都做好的前提下:

 ./build.sh

全自动编译的固件默认会编译一遍buildroot根文件系统。生成固件目录rockdev/,同时会在IMAGE中备份。

==部分编译==
===编译kernel===

 ./build.sh kernel

===编译u-boot===

 ./build.sh uboot

===生成recovery===
recovery分区可省略，若有需要： 编译recovery:

 ./build.sh recovery

==编译rootfs==
===编译buildroot===

 ./build.sh rootfs

===编译ubuntu18.04===
把从网盘下载得到的镜像放到sdk的根目录处:

*1. 解压ubuntu18.04系统镜像
 tar -xvf rk3399_ubuntu18.04_LXDE.img.tgz

*2. 解压后的文件放到sdk根目录下
 mkdir ubunturootfs
 mv rk3399_ubuntu18.04_LXDE.img ubunturootfs/

*3. 修改roc-rk3399-pc.mk文件
 vim device/rockchip/rk3399/roc-rk3399-pc.mk

*4. 把RK_ROOTFS_IMG属性改成ubuntu文件系统镜像得路径(也就是rk3399_ubuntu18.04_LXDE.img)
 RK_ROOTFS_IMG=ubunturootfs/rk3399_ubuntu18.04_LXDE.img

注意:ubuntu根文件系统镜像存放路径不能错

*5. 运行<code> ./mkfirmware.sh</code> 会自动更新<code> rockdev/rootfs.img </code>的链接

==固件打包==

===同步更新各部分镜像===
每次打包固件前先确保rockdev/目录下文件链接是否正确:
ls -l

 ├── boot.img -> ~/project/linux_sdk/kernel/boot.img
 ├── idbloader.img -> ~/project/linux_sdk/u-boot/idbloader.img
 ├── linaro-rootfs.img
 ├── MiniLoaderAll.bin -> ~/project/linux_sdk/u-boot/rk3399_loader_v1.14.115.bin
 ├── misc.img -> ~/project/linux_sdk/device/rockchip/rockimg/wipe_all-misc.img
 ├── oem.img
 ├── parameter.txt -> ~/project/linux_sdk/device/rockchip/rk3399/parameter-ubuntu.txt
 ├── recovery.img -> ~/project/linux_sdk/buildroot/output/rockchip_rk3399_recovery/images/recovery.img
 ├── rootfs.img -> ~/project/linux_sdk/ubunturootfs/rk3399_ubuntu18.04_LXDE.img
 ├── trust.img -> ~/project/linux_sdk/u-boot/trust.img
 ├── uboot.img -> ~/project/linux_sdk/u-boot/uboot.img
 └── userdata.img

可以运行./mkfirmware.sh更新链接

 ./mkfirmware.sh

提示：若不是编译全部的分区镜像，在运行./mkfirmware时，会遇到如下类似情况：
error: /home/ljh/proj/linux-sdk/buildroot/output/rockchip_rk3399_recovery/images/recovery.img not found!
表示recovery分区没有编译出镜像，其他的情况类似，如oem.img、userdata.img
上文提到，这些属于可省略分区镜像，可以不用理会。

===打包统一固件===

注意：打包前请确认tools/linux/Linux_Pack_Firmware/rockdev/package-file是否正确。打包会根据此文件进行分区打包。此文件链接会在./build.sh roc-rk3399-pc.mk 命令时更新，如果配置不对请返回[配置]一节重新配置一次。

===整合统一固件===
 ./build.sh updateimg

==分区介绍==
===parameter===

parameter.txt包含了固件的分区信息十分重要,你可以在<code>device/rockchip/rk3399</code>目录下找到一些parameter.txt文件,下面以<code>parameter-debian.txt</code>为例子做介绍:

 FIRMWARE_VER: 8.1                                                                                                                             
 MACHINE_MODEL: RK3399
 MACHINE_ID: 007 
 MANUFACTURER: RK3399
 MAGIC: 0x5041524B
 ATAG: 0x00200800
 MACHINE: 3399
 CHECK_MASK: 0x80
 PWR_HLD: 0,0,A,0,1
 TYPE: GPT 
 CMDLINE:   mtdparts=rk29xxnand:0x00002000@0x00004000(uboot),0x00002000@0x00006000(trust),0x00002000@0x00008000(misc),0x00010000@0x0000a000(boot),0x00010000@0x0001a000(recovery),0x00010000@0x0002a000(backup),0x00020000@0x0003a000(oem),0x00700000@0x0005a000(rootfs),-@0x0075a000(userdata:grow)
 uuid:rootfs=614e0000-0000-4b53-8000-1d28000054a9

CMDLINE属性是我们关注的地方。以uboot为例<code> 0x00002000@0x00004000(uboot)</code>中<code>0x00004000</code>为uboot分区的起始位置0x00002000为分区的大小。后面的分区规则相同。用户可以根据自己需要增减或者修改分区信息，但是请最少保留uboot,trust,boot,rootfs分区，这是机器能正常启动的前提条件。parameter-ubuntu.txt中使用的就是这样的最简分区方案。

===分区介绍:===

 uboot 分区: 烧写 uboot 编译出来的 uboot.img.
 trust 分区: 烧写 uboot 编译出来的 trust.img
 misc 分区: 烧写 misc.img。开机检测进入recovery模式.（可省略）
 boot 分区: 烧写 kernel 编译出来的 boot.img.包含kernel和设备树信息
 recovery 分区: 烧写 recovery.img.（可省略）
 backup 分区: 预留,暂时没有用。后续跟 android 一样作为 recovery 的 backup 使用.（可省略）
 oem 分区: 给厂家使用,存放厂家的 app 或数据。只读。代替原来音箱的 data 分区。挂载在/oem 目录.（可省略）
 rootfs 分区: 存放 buildroot 或者 debian 编出来的 rootfs.img,只读.
 userdata 分 区 : 存 放 app 临 时 生 成 的 文 件 或 者 是 给 最 终 用 户 使 用 。 可 读 写 , 挂 载 在
 /userdata 目录下.（可省略）

===package-file===

此文件应当与parameter保持一致，用于固件打包。可以在<code>tools/linux/Linux_Pack_Firmware/rockdev</code>下找到相关文件。以rk3399-ubuntu-package-file为例介绍:

 # NAME          Relative path
 #
 #HWDEF          HWDEF
 package-file    package-file
 bootloader      Image/MiniLoaderAll.bin
 parameter    Image/parameter.txt  
 trust           Image/trust.img
 uboot           Image/uboot.img
 boot            Image/boot.img
 rootfs:grow     Image/rootfs.img
 backup          RESERVED

以上是SDK编译后生成的镜像文件。根据parameter.txt只打包自己用到的img文件。