查看“100ask firefly-rk3288”的源代码

==接口布局和尺寸==
{|  class="wikitable" width="100%" style="text-align: center;  background-color: rgba(255,255,255,0.2)"
|-
! 开发板!! 扩展版板
|-
|[[File:100ask_firefly-rk3288_02.png|1000px ]]|| [[File:100ask_firefly-rk3288_03.png|300px]] 
|}

=快速入门=
{| class="wikitable" style=" background-color: rgba(255,255,255,0.2)"
|-
! 准备工作 !! 资料光盘内容简介
|-
| 
要使用你的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
||
{| class="wikitable  toccolours  mw-collapsible mw-collapsed" style="text-align:left; width:auto; overflow:auto;"
!colspan="3"|00_UserManual  
|-
|style=" text-align:center;" colspan="3"| 二级目录
|-
|100ask_am335x硬件手册.pdf
|
|-
|100ask_am335x初级用户手册.pdf 
|
|-
|100ask_am335x高级用户开发手册_v1.pdf
|
|}
{| class="wikitable  toccolours  mw-collapsible mw-collapsed" style="text-align:left; width:auto; overflow:auto; "
!colspan="3"|01_tools
|-
|style="text-align:center;" colspan="3"| 二级目录
|-
|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
|
|}
{| class="wikitable  toccolours  mw-collapsible mw-collapsed" style="text-align:left; width:auto; overflow:auto; "
!colspan="5"|02_images
|-
|colspan="5"| 二级目录 
|-
| rowspan="7" | nandflash_system
| colspan="4" | 三级目录
|-
| colspan="3"  | 100ask-am335x.dtb
|-
| colspan="3"  |MLO
|-
| colspan="3"  |rootfs.ubi
|-
| colspan="3"  |u-boot.img
|-
| colspan="3"  | uEnv.txt
|-
| colspan="3"  |zImage
|-
| rowspan="1" | sdcard
| colspan="3" | sdcard.img
|}
{| class="wikitable  toccolours  mw-collapsible mw-collapsed" style="text-align:left; width:auto; overflow:auto; "
!colspan="5"|03_examples
|-
|colspan="5"| 二级目录 
|-
| rowspan="7" | 001_hello
| colspan="4" | 三级目录
|}
{| class="wikitable  toccolours  mw-collapsible mw-collapsed" style="text-align:left; width:auto; overflow:auto; "
!colspan="5"|05_hardware
|-
|colspan="5"| 二级目录 
|-
| rowspan="3" | Bottom plate
| colspan="4" | 三级目录
|-
| colspan="3"  |100ask_am335x_v12.pdf
|-
| colspan="3"  |100ask_am335x__顶层元件图.pdf
|-
| rowspan="1" | Core board
| colspan="3" | ET-som335X原理图.pdf
|-
| rowspan="1" | Extend_modules
| colspan="3" | ET-som335X原理图.pdf
|}
{| class="wikitable  toccolours  mw-collapsible mw-collapsed" style="text-align:left;"
!  rowspan="1"  colspan="5" |  06_datasheet
|-
|colspan="4" | 二级目录 
|-
| rowspan="14" | Bottom plate
| colspan="3" | 三级目录
|-
| colspan="3"  | ADM2483.pdf
|-
| colspan="3"  | ADuM1201.pdf
|-
| colspan="3"  | AO4485.PDF
|-
| colspan="3"  | AR8035.pdf
|-
| colspan="3"  |B0505S-1WR3.pdf
|-
| colspan="3"  |MMSZ5242BT1中文资料.pdf
|-
| colspan="3"  |MP1470GJ-Z.PDF
|-
| colspan="3"  |S8550.PDF
|-
| colspan="3"  |sn74lvc1g08.pdf
|-
| colspan="3"  | SP3232EEN-L.PDF
|-
| colspan="3"  | TJA1050T.pdf
|-
| colspan="3"  | tlv320aic3106.pdf
|-
| colspan="3"  | USB2514B.pdf 
| 四级目录
|-
| rowspan="9" | Core board
| rowspan="4" | CPU
| colspan="4" | AM335x ARM Cortex-A8 Microprocessors (MPUs) Silicon Errata (Revs 2.0, 1.0).pdf
|-
| colspan="4" | AM335x ARM Cortex-A8 Microprocessors (MPUs) Technical Reference Manual.pdf
|-
| colspan="4" | AM335x ARM Cortex-A8 Microprocessors (MPUs)中文版.pdf
|-
| colspan="4" |  AM335x Sitara Processors.pdf
|-
| rowspan="1" | DDR3L SDRAM
| colspan="4" | MT41K256M16HA-125E_Micron.pdf
|-
| rowspan="1" | Nand Flash
| colspan="4" | H27U4G8F2DTR-BC.pdf
|-
| rowspan="1" | PMU
| colspan="4" | tps65217.pdf
|-
| rowspan="1" | RTC
| colspan="4" | RX8025.pdf
|}
{| class="wikitable  toccolours  mw-collapsible mw-collapsed" style="text-align:left; width:auto; overflow:auto; "
!colspan="5"|07_bsp_sdk
|-
|colspan="5"| 二级目录 
|-
| rowspan="5" | 100ask_am335x
| colspan="4" | 三级目录
|-
| colspan="3"  | buildroot2018.tar.gz
|-
| colspan="3"  |linux-4.9.168.tar.gz
|-
| colspan="3"  |ToolChain.tar.gz
|-
| colspan="3"  |uboot2016.06.tar.gz
|}
|}
如需自行安装配置vmware ubuntu开发环境请参考[[Configuring_ubuntu ]]

=编译100ask linux系统=
简介:以下资源仅限于在百问网官方购买及百问网授权店铺购买的开发板上使用，我们在官方的基础上做了大量的定制化修改，精简了系统，简化下载以及编译流程，更大的提升开发效率，系统不同于firefly官方。如需为firefly-rk3288编译ubuntu 以及Android系统请参考编译firefly系统章节。
==获取源码==
{|  class="wikitable" width="100%" style="text-align: center;  background-color: rgba(255,255,255,0.2)"
|-
! 类别 !! 国内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工具管理代码<br>
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

==编译根文件系统==
{| class="wikitable"
|-
! 配置文件	!! 含义
|-
| 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等以加快编译速度 */

*编译后生成文件介绍
<syntaxhighlight lang="c" > 
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					<--内核镜像

 </syntaxhighlight>

==sd卡启动==
1.安装资料光盘下01_tools/SD Card Formatter 5.0.1 Setup.exe软件，安装完成后打开！<br>
2.使用SdCardFormatter格式化SD卡，格式化步骤如下如所示!
{| class="wikitable" width="100%" style="text-align: center"
|-
| style="width: 33%;" | [[image:100ask_am335x_SD_P_004.png | 300px]]
| style="width: 33%;" | [[image:100ask_am335x_SD_P_005.png | 300px]]
| style="width: 33%;" | [[image:100ask_am335x_SD_P_006.png | 300px]]
|-
| (1)选择要格式化的SD卡，选中Quick format，点击Format	|| (2)在弹出的对话框中点击是(Y)	|| (3)等待格式化完成，在弹出的对话框中点击确定	
|}

3.安装资料光盘下01_tools/ win32diskimager-1.0.0-install.exe软件，安装完成后打开！<br>
4.使用wind32diskimage烧写编译后的系统镜像，烧写步骤如下所示！<br>
{| class="wikitable" width="100%" style="text-align: center"
|-
| style="width: 33%;" | [[image:100ask_am335x_SD_p_001.png | 300px]]
| style="width: 33%;" | [[image:100ask_am335x_SD_p_002.png | 300px]]
| style="width: 33%;" | [[image:100ask_am335x_SD_p_003.png ]]
|-
| (1)选中需要烧写的SD卡设备，点击文件图标选择系统镜像文件，最后点击写入按钮开始烧写	|| (2)此时弹出烧写对话框，点击Yes按钮,继续烧写, 等待任务进度执行到100%)	|| 烧写成功后，弹出写入成功，此时点击OK	
|}

=编译firefly系统=
==编译ubuntu-18.04系统==
==编译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<br>
 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