100ask roc-rk3399-pc
视频链接地址: | 开发板购买地址: |
资料光盘下载地址: | 配套视频wiki教程: |
裸机程序wiki | 驱动程序wiki |
目录
快速入门
准备工作 | 资料光盘简介 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
要使用你的roc-rk3399-pc开发板,请提前准备好以下资源:
|
|
如需自行安装配置vmware ubuntu开发环境请参考Ubuntu开发环境配置
编译100ask linux sdk系统
获取源码
git邮箱账号和用户名配置
git config --global user.email "you@example.com" git config --global user.name "Your Name"
初次使用,需要配置用户名和密码才可以进行代码同步,用户名和密码根据自己情况设定,也可以随意设定
- repo工具配置
考虑到代码仓库过多,特使用repo工具管理代码
book@100ask:~$ git clone https://git.dev.tencent.com/codebug8/repo.git book@100ask:~$ mkdir -p 100ask_roc-rk3399-pc && cd 100ask_roc-rk3399-pc book@100ask:~/100ask_roc-rk3399-pc $ ../repo/repo init -u https://dev.tencent.com/u/weidongshan/p/manifests/git -b linux-sdk -m rk3399/roc-rk3399-pc_linux_release.xml --no-repo-verify book@100ask:~/100ask_roc-rk3399-pc $ ../repo/repo sync -j4
上面使用的repo管理为国内coding仓库 http://wiki.t-firefly.com/zh_CN/ROC-RK3399-PC/
设置工具链
交叉编译工具链主要是用于在ubuntu主机上编译并声称可以在其它平台上运行的系统。设置交叉编译工具主要是设置PATH, ARCH和CROSS_COMPILE三个环境变量,下面介绍具体设置方法。
- 永久生效
如需永久修改,请修改用户配置文件, Ubuntu系统下,修改如下:
vim ~/.bashrc
在行尾添加或修改:
export ARCH=arm64 export CROSS_COMPILE=aarch64-linux-gnu- export PATH=$PATH:/home/book/100ask_roc-rk3399-pc/ToolChain-6.3.1/gcc-linaro-6.3.1-2017.05-x86_64_aarch64-linux-gnu/bin
- 临时生效
执行完“export”命令后,该设置只对当前终端有效
book@100ask:~$ export PATH=$PATH:/home/book/100ask_roc-rk3399-pc/ToolChain-6.3.1/gcc-linaro-6.3.1-2017.05-x86_64_aarch64-linux-gnu/bin book@100ask:~$ export ARCH=arm64 book@100ask:~$ export CROSS_COMPILE=aarch64-linux-gnu-
- 手动指定
Make编译时指定ARCH架构 CROSS_COMPILE交叉编译工具链
book@100ask:~$ export PATH=$PATH:/home/book/100ask_roc-rk3399-pc/ToolChain-6.3.1/gcc-linaro-6.3.1-2017.05-x86_64_aarch64-linux-gnu/bin book@100ask:~$ make ARCH=arm64 CROSS_COMPILE=aarch64-linux-gnu- [命令]
编译u-boot
不同的开发板对应不同的配置文件,配置文件位于 u-boot的configs/ 目录,下面以Roc-rk3399-pc开发板为例,说明u-boot的编译过程:
book@100ask:~$ cd ~/100ask_roc-rk3399-pc/uboot2019.01 book@100ask: ~/100ask_roc-rk3399-pc/uboot2019.01$ make distclean book@100ask: ~/100ask_roc-rk3399-pc/uboot2019.01$ make 100ask_roc-rk3399-pc_defconfig book@100ask: ~/100ask_roc-rk3399-pc/uboot2019.01$ make book@100ask: ~/100ask_roc-rk3399-pc/uboot2019.01$ ./make.sh trust book@100ask: ~/100ask_roc-rk3399-pc/uboot2019.01$ ./make.sh uboot book@100ask: ~/100ask_roc-rk3399-pc/uboot2019.01$ ./make.sh loader
- nfs启动系统
=> setenv serverip 192.168.1.132 => setenv ipaddr 192.168.1.112 => tftpboot 0x01f00000 rk3399-roc-pc.dtb; tftpboot 0x02080000 Image; setenv bootargs root=/dev/nfs nfsroot=192.168.1.132:/home/book/rootfs,vers=3 rw ip=192.168.1.120; booti 0x02080000 - 0x01f00000
编译linux kernel
book@100ask:~/100ask_roc-rk3399-pc$ cd linux-4.4 book@100ask:~/100ask_roc-rk3399-pc/linux-4.4$ make mrproper book@100ask:~/100ask_roc-rk3399-pc/linux-4.4$ make 100ask_roc-rk3399-pc_defconfig book@100ask:~/100ask_roc-rk3399-pc/linux-4.4$ make Image book@100ask:~/100ask_roc-rk3399-pc/linux-4.4$ make dtbs
- 编译内核模块
book@100ask:~/100ask_roc-rk3399-pc/linux-4.4$ make ARCH=arm64 CROSS_COMPILE=aarch64-linux-gnu- modules
- 安装内核模块到nfs根文件系统
book@100ask:~/100ask_roc-rk3399-pc/linux-4.4$ sudo make ARCH=arm64 INSTALL_MOD_PATH=/media/rootfs modules_install
编译根文件系统
配置文件 | 含义 |
---|---|
100ask_roc-rk3399-pc_defconfig | 默认文件系统版本 |
book@100ask:~/100ask_roc-rk3399-pc$ cd buildroot2018.02 book@100ask:~/100ask_roc-rk3399-pc/buildroot2018.02$ make clean book@100ask:~/100ask_roc-rk3399-pc/buildroot2018.02$ make 100ask_roc-rk3399-pc_defconfig book@100ask:~/100ask_roc-rk3399-pc/buildroot2018.02$ make menuconfig book@100ask:~/100ask_roc-rk3399-pc/buildroot2018.02$ make –jN /* N表示CPU的线程数,比如可以写4、8等以加快编译速度 */
编译后生成文件介绍
buildroot2018.02
├── output
├── images
├── idbloader.img <--u-boot镜像
├── nfs_rootfs <--打包并压缩的根文件系统,适用于NFSROOT启动
│ └── rootfs.tar.gz
├── rk3288-firefly.dtb <--设备树文件
├── rootfs.ext2
├── rootfs.ext4 -> rootfs.ext2 <--ext2格式根文件系统
├── rootfs.tar <--打包后的根文件系统
├── sdcard.img <--完整的SD卡系统镜像
├── trust.img <--u-boot镜像
├── u-boot.bin
├── u-boot-dtb.img
├── uboot.img <--u-boot镜像
└── zImage <--内核镜像
sd卡启动
1.安装资料光盘下01_tools/SD Card Formatter 5.0.1 Setup.exe软件,安装完成后打开!
2.使用SdCardFormatter格式化SD卡,格式化步骤如下如所示!
(1)选择要格式化的SD卡,选中Quick format,点击Format | (2)在弹出的对话框中点击是(Y) | (3)等待格式化完成,在弹出的对话框中点击确定 |
3.安装资料光盘下01_tools/ win32diskimager-1.0.0-install.exe软件,安装完成后打开!
4.使用wind32diskimage烧写编译后的系统镜像,烧写步骤如下所示!
(1)选中需要烧写的SD卡设备,点击文件图标选择系统镜像文件,最后点击写入按钮开始烧写 | (2)此时弹出烧写对话框,点击Yes按钮,继续烧写, 等待任务进度执行到100%) | 烧写成功后,弹出写入成功,此时点击OK |
编译firefly linux-sdk系统
编译前配置
- 配置文件 roc-rk3399-pc.mk:
./build.sh roc-rk3399-pc.mk
文件路径在device/rockchip/rk3399/roc-rk3399-pc.mk
如果配置文件生效会连接到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固件)请执行一下操作:
配置rootfs
- 1.下载ubuntu根文件系统镜像把得到的镜像放到sdk的指定目录:
- 2.解压
tar -xvf rk3399_ubuntu18.04_LXDE.img.tgz
- 3.sdk根目录下
mkdir ubunturootfs mv rk3399_ubuntu18.04_LXDE.img ubunturootfs/
- 4.修改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根文件系统镜像存放路径不能错
全自动编译
在配置和搭建环境的工作都做好的前提下:
./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
ubuntu18.04,可以通过云盘下载:
下载链接
把得到的镜像放到sdk的根目录处:
- 解压
tar -xvf rk3399_ubuntu18.04_LXDE.img.tgz
- sdk根目录下
mkdir ubunturootfs mv rk3399_ubuntu18.04_LXDE.img ubunturootfs/
- 修改roc-rk3399-pc.mk文件
vim device/rockchip/rk3399/roc-rk3399-pc.mk
- 把RK_ROOTFS_IMG属性改成ubuntu文件系统镜像得路径(也就是rk3399_ubuntu18.04_LXDE.img)
RK_ROOTFS_IMG=ubunturootfs/rk3399_ubuntu18.04_LXDE.img
注意:ubuntu根文件系统镜像存放路径不能错
运行./mkfirmware.sh会自动更新rockdev/rootfs.img的链接 固件打包 同步更新各部分镜像
每次打包固件前先确保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包含了固件的分区信息十分重要,你可以在device/rockchip/rk3399目录下找到一些parameter.txt文件,下面以parameter-debian.txt为例子做介绍:
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为例 0x00002000@0x00004000(uboot)中0x00004000为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保持一致,用于固件打包。可以在tools/linux/Linux_Pack_Firmware/rockdev下找到相关文件。以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文件。