查看“100ask roc-rk3399-pc”的源代码

{|  width="100%" style="text-align:left;  background-color: rgba(255,255,255,0.2)"
|-
| 视频链接地址:  ||  开发板购买地址:
|-
| 资料光盘下载地址:    ||配套视频wiki教程:
|-
| 裸机程序wiki  ||  驱动程序wiki
|}
==接口布局和尺寸==
{|  class="wikitable" width="100%" style="text-align: center;  background-color: rgba(255,255,255,0.2)"
|-
! 开发板!! 扩展板 
|-
|[[File:100ask_roc-rk3399-pc_02.png|1000px]] ||  
|}

=快速入门=
{| class="wikitable" style=" background-color: rgba(255,255,255,0.2)"
|-
! 准备工作 !! 资料光盘简介
|-
| 
要使用你的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
|| 
{| 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 sdk系统=

==获取源码==
{|  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_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工具管理代码<br>

 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

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

编译后生成文件介绍
<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 linux-sdk系统=

==编译前配置==

*配置文件 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===

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. 运行 ./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文件。