100ask roc-rk3399-pc

来自百问网嵌入式Linux wiki
视频链接地址: 开发板购买地址:
资料光盘下载地址: 配套视频wiki教程:
裸机程序wiki 驱动程序wiki

接口布局和尺寸

开发板 扩展板
100ask roc-rk3399-pc 02.png

快速入门

准备工作 资料光盘简介

要使用你的roc-rk3399-pc开发板,请提前准备好以下资源:

  • 一台可以上网的windows电脑
  • roc-rk3399-pc开发板
  • microSD卡/TF卡: Class10或以上的 8GB SDHC卡
  • 一个12v/2A的TYPE C接口电源适配器
  • VMware-player-15.1.5.exe
  • Vmware ubuntu 18.04 64位虚拟机镜像
  • win32diskimager-1.0.0-install.exe
  • MobaXterm_Portable_v11.0.zip
00_UserManual
二级目录
100ask_am335x硬件手册.pdf
100ask_am335x初级用户手册.pdf
100ask_am335x高级用户开发手册_v1.pdf
01_tools
二级目录
100ask-vmware_ubuntu18.04.7z Windows下编译开发环境,主要适用模块应用开发
FileZilla_3.22.1_win32-setup.exe Windows下ftp工具,传输文件到Ubuntu系统中
HP USB Disk Storage Format Tool 2.0.6.EXE
MobaXterm_Portable_v11.0.zip
npp.7.6.1.Installer.exe
qt-creator-opensource-linux-x86_64-4.8.0.run
SD Card Formatter 5.0.1 Setup.exe
VMware-workstation-full-15.1.0-13591040.exe
win32diskimager-1.0.0-install.exe
02_images
二级目录
nandflash_system 三级目录
100ask-am335x.dtb
MLO
rootfs.ubi
u-boot.img
uEnv.txt
zImage
sdcard sdcard.img
03_examples
二级目录
001_hello 三级目录
05_hardware
二级目录
Bottom plate 三级目录
100ask_am335x_v12.pdf
100ask_am335x__顶层元件图.pdf
Core board ET-som335X原理图.pdf
Extend_modules ET-som335X原理图.pdf
06_datasheet
二级目录
Bottom plate 三级目录
ADM2483.pdf
ADuM1201.pdf
AO4485.PDF
AR8035.pdf
B0505S-1WR3.pdf
MMSZ5242BT1中文资料.pdf
MP1470GJ-Z.PDF
S8550.PDF
sn74lvc1g08.pdf
SP3232EEN-L.PDF
TJA1050T.pdf
tlv320aic3106.pdf
USB2514B.pdf 四级目录
Core board CPU AM335x ARM Cortex-A8 Microprocessors (MPUs) Silicon Errata (Revs 2.0, 1.0).pdf
AM335x ARM Cortex-A8 Microprocessors (MPUs) Technical Reference Manual.pdf
AM335x ARM Cortex-A8 Microprocessors (MPUs)中文版.pdf
AM335x Sitara Processors.pdf
DDR3L SDRAM MT41K256M16HA-125E_Micron.pdf
Nand Flash H27U4G8F2DTR-BC.pdf
PMU tps65217.pdf
RTC RX8025.pdf
07_bsp_sdk
二级目录
100ask_am335x 三级目录
buildroot2018.tar.gz
linux-4.9.168.tar.gz
ToolChain.tar.gz
uboot2016.06.tar.gz

如需自行安装配置vmware ubuntu开发环境请参考Ubuntu开发环境配置

编译100ask linux sdk系统

获取源码

类别 国内coding仓库 国外github仓库
u-boot https://dev.tencent.com/u/weidongshan/p/100ask_roc-rk3399_uboot https://github.com/100askTeam/roc-rk3399-uboot
linux kernel https://dev.tencent.com/u/weidongshan/p/100ask_roc-rk3399_kernel https://github.com/100askTeam/roc-rk3399-kernel
根文件系统 https://dev.tencent.com/u/weidongshan/p/100ask_roc-rk3399_buildroot https://github.com/100askTeam/roc-rk3399-buildroot

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卡,格式化步骤如下如所示!

100ask am335x SD P 004.png 100ask am335x SD P 005.png 100ask am335x SD P 006.png
(1)选择要格式化的SD卡,选中Quick format,点击Format (2)在弹出的对话框中点击是(Y) (3)等待格式化完成,在弹出的对话框中点击确定

3.安装资料光盘下01_tools/ win32diskimager-1.0.0-install.exe软件,安装完成后打开!
4.使用wind32diskimage烧写编译后的系统镜像,烧写步骤如下所示!

100ask am335x SD p 001.png 100ask am335x SD p 002.png 100ask am335x SD p 003.png
(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固件)请执行一下操作:

全自动编译

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

./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的根目录处:

  1. 解压
tar -xvf rk3399_ubuntu18.04_LXDE.img.tgz
  1. sdk根目录下
mkdir ubunturootfs
mv rk3399_ubuntu18.04_LXDE.img ubunturootfs/
  1. 修改roc-rk3399-pc.mk文件
vim device/rockchip/rk3399/roc-rk3399-pc.mk
  1. 把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为例介绍:

  1. NAME Relative path
  2. 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文件。