100ask firefly-rk3288

来自百问网嵌入式Linux wiki
Wiki（讨论 | 贡献）2019年7月26日 (五) 18:23的版本

接口布局和尺寸

开发板 扩展版板
100ask firefly-rk3288 02.png 100ask firefly-rk3288 03.png

快速入门

准备工作 资料光盘内容简介

要使用你的firefly-rk3288开发板，请提前准备好以下资源：

  • 一台可以上网的windows电脑
  • firefly-rk3288开发板
  • microSD卡/TF卡: Class10或以上的 8GB SDHC卡
  • 一个12v/3A的电源是配置
  • 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系统

简介:以下资源仅限于在百问网官方购买及百问网授权店铺购买的开发板上使用，我们在官方的基础上做了大量的定制化修改，精简了系统，简化下载以及编译流程，更大的提升开发效率，系统不同于firefly官方。如需为firefly-rk3288编译ubuntu 以及Android系统请参考编译firefly系统章节。

获取源码

类别 国内coding仓库 国外github仓库
u-boot https://dev.tencent.com/u/weidongshan/p/100ask_firefly-rk3288_uboot https://github.com/100askTeam/100ask_firefly-rk3288_uboot
linux kernel https://dev.tencent.com/u/weidongshan/p/100ask_firefly-rk3288_kernel https://github.com/100askTeam/100ask_firefly-rk3288_kernel
根文件系统 https://dev.tencent.com/u/weidongshan/p/100ask_firefly-rk3288_buildroot https://github.com/100askTeam/100ask_firefly-rk3288_buildroot

git邮箱账号和用户名配置 

book@100ask:~$  git config --global user.email "you@example.com"
book@100ask:~$  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_firefly-rk3288 && cd 100ask_firefly-rk3288
book@100ask:~/100ask_firefly-rk3288$  ../repo/repo init -u https://dev.tencent.com/u/weidongshan/p/manifests/git -b linux-sdk -m rk3288/firefly-rk3288_linux_release.xml --no-repo-verify
book@100ask:~/100ask_firefly-rk3288$  ../repo/repo sync -j4

上面使用的repo管理为国内coding仓库

设置工具链

交叉编译工具链主要是用于在ubuntu主机上编译并声称可以在其它平台上运行的系统。设置交叉编译工具主要是设置PATH， ARCH和CROSS_COMPILE三个环境变量，下面介绍具体设置方法。

  • 永久生效

如需永久修改，请修改用户配置文件, Ubuntu系统下，修改如下： 

vim ~/.bashrc

在行尾添加或修改： 

export ARCH=arm
export CROSS_COMPILE=arm-linux-gnueabihf-
export PATH=$PATH:/home/book/100ask_firefly-rk3288/ToolChain/gcc-linaro-6.2.1-2016.11-x86_64_arm-linux-gnueabihf/bin
  • 临时生效

执行完“export”命令后，该设置只对当前终端有效 

book@100ask:~$ export PATH=$PATH:/home/book/100ask_firefly-rk3288/ToolChain/gcc-linaro-6.2.1-2016.11-x86_64_arm-linux-gnueabihf/bin
book@100ask:~$ export ARCH=arm
book@100ask:~$ export CROSS_COMPILE=arm-linux-gnueabihf-
  • 手动指定

Make编译时指定ARCH架构 CROSS_COMPILE交叉编译工具链 

book@100ask:~$ export PATH=$PATH:/home/book/100ask_firefly-rk3288/ToolChain/gcc-linaro-6.2.1-2016.11-x86_64_arm-linux-gnueabihf/bin
book@100ask:~$ make ARCH=arm CROSS_COMPILE=arm-linux-gnueabihf-

编译uboot 

book@100ask:~$  cd ~/100ask_firefly-rk3288/uboot2017.09
book@100ask: ~/100ask_firefly-rk3288/uboot2017.09 $ make distclean
book@100ask: ~/100ask_firefly-rk3288/uboot2017.09 $ make 100ask_firefly-rk3288_defconfig
book@100ask: ~/100ask_firefly-rk3288/uboot2017.09 $ make
book@100ask: ~/100ask_firefly-rk3288/uboot2017.09 $ ./make.sh trust
book@100ask: ~/100ask_firefly-rk3288/uboot2017.09 $ ./make.sh uboot
book@100ask: ~/100ask_firefly-rk3288/uboot2017.09 $ ./make.sh loader
  • 单独烧写uboot

使用dd命令烧写img镜像文件到TF卡中。 

book@100ask:~/100ask_firefly-rk3288/uboot2017.09$  sudo dd if=idbloader.img of=/dev/sdb seek=64
book@100ask:~/100ask_firefly-rk3288/uboot2017.09$  sudo dd if=uboot.img of=/dev/sdb seek=16384
book@100ask:~/100ask_firefly-rk3288/uboot2017.09$  sudo dd if=trust.img of=/dev/sdb seek=24576
  • nfs启动系统
=> setenv ipaddr 192.168.1.112
=> ping 192.168.1.111
=> setenv serverip 192.168.1.132
=> tftpboot 0x01f00000 rk3288-firefly.dtb; tftpboot 0x02000000 zImage; setenv bootargs root=/dev/nfs nfsroot=192.168.1.132:/work/rootfs_rk3288 rw ip=192.168.1.120; bootz 0x02000000 - 0x01f00000

编译linux kernel 

book@100ask:~/100ask_firefly-rk3288$ cd linux-kernel
book@100ask:~/100ask_firefly-rk3288/linux-4.4$ make mrproper
book@100ask:~/100ask_firefly-rk3288/linux-4.4$ make 100ask_firefly-rk3288_defconfig
book@100ask:~/100ask_firefly-rk3288/linux-4.4$ make zImage
book@100ask:~/100ask_firefly-rk3288/linux-4.4$ make dtbs
  • 编译内核模块
book@100ask:~/100ask_firefly-rk3288/linux-4.4$ make ARCH=arm CROSS_COMPILE=arm-linux-gnueabihf- modules

安装内核模块到nfs根文件系统 

book@100ask:~/100ask_firefly-rk3288/linux-4.4$ sudo make ARCH=arm INSTALL_MOD_PATH=/media/rootfs  modules_install

编译根文件系统

配置文件 含义
100ask_firefly-rk3288_defconfig 文件系统版本(再默认版本支持了qt)
  • 编译步骤
book@100ask:~/100ask_firefly-rk3288$ cd buildroot2018.02
book@100ask:~/100ask_firefly-rk3288/buildroot2018.02$ make clean
book@100ask:~/100ask_firefly-rk3288/buildroot2018.02$ make 100ask_firefly-rk3288_defconfig
book@100ask:~/100ask_firefly-rk3288/buildroot2018.02$ make menuconfig
book@100ask:~/100ask_firefly-rk3288/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系统

编译前配置：

在device/rockchip/rk3288/目录下，选择对应的板型的配置文件

本文例子：确定选用rk3288/firefly-rk3288.mk

  • firefly-rk3288.mk 相关配置介绍：
  • Target arch
export RK_ARCH=arm                                      32位ARM架构
  • Uboot defconfig
export RK_UBOOT_DEFCONFIG=firefly-rk3288                u-boot配置文件
  • Kernel defconfig
export RK_KERNEL_DEFCONFIG=firefly_linux_defconfig      kernel配置文件
  • Kernel dts
export RK_KERNEL_DTS=rk3288-firefly                     dts文件
  • parameter for GPT table
export RK_PARAMETER=parameter-ubuntu.txt                分区表（关键）
  • rootfs image path
export RK_ROOTFS_IMG=buildroot/output/$RK_CFG_BUILDROOT/images/rootfs.$RK_ROOTFS_TYPE  根文件系统路径

配置Rootfs

源码中默认的Linux rootfs是buildroot，如果rootfs使用buildroot，跳过此步，如果用户需要使用Ubuntu，需要通过以下步骤来配置：

  1. 下载根文件系统：ubuntu16.04 根文件系统(32位)，放到SDK路径下;
  2. 该文件为7z压缩包，解压该文件；
7z x ubuntu1604armhf-rootfs.7z
  1. 完成上述后，得到ubuntu1604armhf-rootfs.img(2.6G),拷贝根文件系统到rootfs目录下；
cp ubuntu1604armhf-rootfs.img rootfs/
  1. 在device/rockchip/rk3288/firefly-rk3288.mk中， 将“# rootfs image path”修改为：
export RK_ROOTFS_IMG=rootfs/ubuntu1604armhf-rootfs.img

配置板型

根据各个板型和配件的差别，内核中使用的DTS也有差别，如果是标配板型，跳过此步，如果板型有VGA或者LCD等支持，需要在.BoardConfig.mk中做对应的修改。 Firefly-rk3288

  • 标配：
export RK_KERNEL_DTS=rk3288-firefly
  • 带VGA：
export RK_KERNEL_DTS=rk3288-firefly-vga


编译配置文件： 

./build.sh firefly-rk3288.mk

运行完上述脚本后，在device/rockchip/目录下，生成.BoardConfig.mk 软链接 device/rockchip/rk3288/firefly-rk3288.mk

  • 完全编译

完全编译运行如下命令，包含 kernel 、uboot、buildroot、recovery。 如果用户使用buildroot，可以使用完全编译。如果用户使用Ubuntu系统，则不需要使用完全编译。 

./build.sh

注意：该脚本默认编译buildroot根文件系统，若用户需要用的根文件系统是Debian或者Ubuntu16.04时，请！先！将！对应的根文件系统准备好，不然在执行该build.sh脚本时，会在整理分区镜像、打包固件时出错，这部分操作在以下的“部分编译”中“编译rootfs”有详细说明，按照操作执行即可！

build.sh脚本运行完成后，会将分区镜像和统一固件update.img放在rockdev/目录下，同时创建IMAGE/目录备份。

模块化编译：

编译u-boot: 

./build.sh uboot

编译kernel: 

./build.sh kernel

编译rootfs:

本SDK支持三种根文件系统，分别是buildroot、Debian、Ubuntu;

编译Buildroot系统镜像

编译 Buildroot 环境搭建所依赖的软件包安装命令如下: 

sudo apt-get install repo git-core gitk git-gui gcc-arm-linux-gnueabihf u-boot-tools device-tree-compiler \
gcc-aarch64-linux-gnu mtools parted libudev-dev libusb-1.0-0-dev python-linaro-image-tools linaro-image-tools \
autoconf autotools-dev libsigsegv2 m4 intltool libdrm-dev curl sed make binutils build-essential gcc g++ bash \
patch gzip bzip2 perl tar cpio python unzip rsync file bc wget libncurses5 libqt4-dev libglib2.0-dev libgtk2.0-dev \
libglade2-dev cvs git mercurial rsync openssh-client subversion asciidoc w3m dblatex graphviz python-matplotlib \
libc6:i386 libssl-dev texinfo liblz4-tool genext2fs

搭建环境完成后，编译buildroot，执行如下命令： 

 ./build.sh rootfs

编译Ubuntu16.04

  • 1.下载根文件系统：ubuntu16.04 根文件系统(32位)，放到SDK路径下;
  • 2.该文件为7z压缩包，解压该文件；
7z x ubuntu1604armhf-rootfs.7z
  • 3.完成上述后，得到ubuntu1604armhf-rootfs.img(2.6G),拷贝根文件系统到rootfs目录下；
cp ubuntu1604armhf-rootfs.img rootfs/

补充说明： 

./build.sh --help

====USAGE: build.sh modules====
uboot              -build uboot
kernel             -build kernel
rootfs             -build default rootfs, currently build buildroot as default
buildroot          -build buildroot rootfs
yocto              -build yocto rootfs, currently build ros as default
ros                -build ros rootfs
debian             -build debian rootfs
pcba               -build pcba
recovery           -build recovery
all                -build uboot, kernel, rootfs, recovery image
cleanall           -clean uboot, kernel, rootfs, recovery
firmware           -pack all the image we need to boot up system
updateimg          -pack update image
sdbootimg          -pack sdboot image
save               -save images, patches, commands used to debug
default            -build all modules
BoardConfig        -select the corresponding BoardConfig.mk file

recovery分区在Ubuntu系统中不会用到，若有需要,可运行如下命令： 

./build.sh recovery

打包固件

parameter分区表

parameter.txt文件中包含了固件的重要信息，如以rk3288为例： 路径：device/rockchip/rk3288/parameter-ubuntu.txt 

FIRMWARE_VER: 8.1           固件版本
MACHINE_MODEL:rk3288        固件板型
MACHINE_ID:007
MANUFACTURER:RK3288
MAGIC: 0x5041524B
ATAG: 0x00200800
MACHINE: 3288
CHECK_MASK: 0x80
PWR_HLD: 0,0,A,0,1
TYPE: GPT                   分区类型
CMDLINE: mtdparts=rk29xxnand:0x00002000@0x00004000(uboot),0x00002000@0x00006000(trust),0x00010000@0x0000a000(boot),0x00010000@0x0002a000(backup),-@0x0005a000(rootfs:grow)      
uuid:rootfs=614e0000-0000-4b53-8000-1d28000054a9

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

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

在parameter.txt文件中，仅仅保留了5个不可缺少的分区。

注意：若发现根文件分区大小异常时，执行如下命令： 

resize2fs /dev/mmcblk2p5

package-file

package-file文件用于打包统一固件时确定需要的分区镜像和镜像路径，同时它需要与parameter.txt文件保持一致。 路径tools/linux/Linux_Pack_Firmware/rockdev/目录下，以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

打包 

   整理分区镜像到rockdev/目录下

./mkfirmware.sh

提示：在运行./mkfirmware时，可能会遇到如下报错： 

error: /home/ljh/proj/linux-sdk/buildroot/output/rockchip_rk3288_recovery/images/recovery.img not found!

表示recovery分区没有找到，类似的如oem.img、userdata.img，上文提到，这些属于可省略分区镜像，可以不用理会。

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

注意：每次打包固件前，需要运行mkfirmware.sh脚本更新rockdev/下的分区镜像

编译android-5.1系统

注意：编译此系统需要使用ubuntu16.04，开发环境请自行配置或者使用我们提供的系统镜像文件

官方脚本编译 

 ./FFTools/make.sh -d firefly-rk3288 -j8 -l rk3288_box-userdebug
 ./FFTools/mkupdate/mkupdate.sh -l rk3288_box-userdebug

手动编译

手动编译firefly-rk3288和firefly-rk3288-reload,编译内核时，所用的资源文件不同

编译uboot 

cd ~/proj/firefly-rk3288-lollipop/u-boot
make rk3288_defconfig
make -j8

内核编译使用Firefly-RK3288 编译内核： 

cd ~/proj/firefly-rk3288-lollipop/kernel
make firefly_defconfig
make -j8 firefly-rk3288.img

编译Android 

cd ~/proj/firefly-rk3288-lollipop
source build.sh
lunch rk3288_box-userdebug
make -j8
./mkimage.sh

构建变体说明

  • 默认的目标构建变体(TARGET_BUILD_VARIANT)为 userdebug。常用变体有三种，分别是用户(user)、用户调试(userdebug)和工程模式(eng)，其区别如下：
   user
       仅安装标签为 user 的模块
       设定属性 ro.secure=1，打开安全检查功能
       设定属性 ro.debuggable=0，关闭应用调试功能
       默认关闭 adb 功能
       打开 Proguard 混淆器
       打开 DEXPREOPT 预先编译优化
   userdebug
       安装标签为 user、debug 的模块
       设定属性 ro.secure=1，打开安全检查功能
       设定属性 ro.debuggable=1，启用应用调试功能
       默认打开 adb 功能
       打开 Proguard 混淆器
       打开 DEXPREOPT 预先编译优化
   eng
       安装标签为 user、debug、eng 的模块
       设定属性 ro.secure=0，关闭安全检查功能
       设定属性 ro.debuggable=1，启用应用调试功能
       设定属性 ro.kernel.android.checkjni=1，启用 JNI 调用检查
       默认打开 adb 功能
       关闭 Proguard 混淆器
       关闭 DEXPREOPT 预先编译优化

如果目标构建变体为 user，则 adb 无法获取 root 权限。 要选择目标构建变体，可以在 make 命令行加入参数，例如： 

make -j8 PRODUCT-rk3288_box-user
make -j8 PRODUCT-rk3288_box-userdebug
make -j8 PRODUCT-rk3288_box-eng

烧写分区映像

上一步骤的 ./mkimage.sh 会重新打包 boot.img 和 system.img, 并将其它相关的映像文件拷贝到目录 rockdev/Image-rk3288_box/ 中。

以下列出一般固件用到的映像文件：

  • boot.img ：Android 的初始文件映像，负责初始化并加载 system 分区。
  • kernel.img ：内核映像。
  • misc.img ：misc 分区映像，负责启动模式切换和急救模式的参数传递。
  • recovery.img ：急救模式映像。
  • resource.img ：资源映像，内含开机图片和内核的设备树信息。
  • system.img ：Android 的 system 分区映像，ext4 文件系统格式。

请参照 如何Android 升级固件 一文来烧写分区映像文件。 如果使用的是 Windows 系统，将上述映像文件拷贝到 AndroidTool （Windows 下的固件升级工具）的 rockdev\Image 目录中，之后参照升级文档烧写分区映像即可，这样的好处是使用默认配置即可，不用修改文件的路径。

编译完可以使用Firefly的脚本打包成统一固件，执行如下命令： 

./FFTools/mkupdate/mkupdate.sh -l rk3288_box-userdebug

打包完成后固件会生成在rockdev/Image-rk3288_box/ 目录

在 Windows 下打包统一固件 update.img 很简单，按上一步骤将文件拷贝到 AndroidTool 的 rockdev\Image 目录中，然后运行 rockdev 目录下的 mkupdate.bat 批处理文件即可创建 update.img 并存放到 rockdev\Image 目录里。 update.img 方便固件的发布，供终端用户升级系统使用。一般开发时使用分区映像比较方便。 打包成统一固件

参考链接：http://wiki.t-firefly.com/zh_CN/Firefly-RK3288/compile_android.html 参考链接：http://wiki.t-firefly.com/zh_CN/Firefly-RK3288/custom_firmware.html 参考链接：http://wiki.t-firefly.com/zh_CN/Firefly-RK3288/adb_debug.html

取自“http://wiki.100ask.org/index.php?title=100ask_firefly-rk3288&oldid=3619”