# 1. 源码编译 RK3568的 Linux SDK 或 Android 源码编译对服务器要求比较高，其中： * 系统依赖 Ubuntu20 及以上； * CPU 8核+、内存32GB+ 以上； * 硬盘空间 1TB+； 推荐在凌云实验室的编译服务器上编译，IGKBoard-RK3568开发板请选择使用 ***sdkv1.3.0_linux4.19*** 版本。 ## 1.1 安装交叉编译环境 首先安装交叉编译所需要的系统命令。 ``` guowenxue@ubuntu22:~$ sudo apt install -y git ssh make gcc libssl-dev liblz4-tool \ expect g++ patchelf chrpath gawk texinfo chrpath diffstat binfmt-support unzip \ qemu-user-static live-build bison flex fakeroot cmake gcc-multilib g++-multilib \ device-tree-compiler python*-pip libncurses-dev libmpc-dev ``` 如果是 ***sdkv1.3.0_linux4.19*** 则需要将 python 的版本设置为 **python2**， 而 ***sdkv1.4.0_linux5.10*** 则需要选择 **python3**。 ``` guowenxue@ubuntu22:~$ sudo update-alternatives --install /usr/bin/python python /usr/bin/python2 1 guowenxue@ubuntu22:~$ sudo update-alternatives --install /usr/bin/python python /usr/bin/python3 2 guowenxue@ubuntu22:~$ sudo update-alternatives --config python There are 2 choices for the alternative python (providing /usr/bin/python). Selection Path Priority Status ------------------------------------------------------------ * 0 /usr/bin/python3 2 auto mode 1 /usr/bin/python2 1 manual mode 2 /usr/bin/python3 2 manual mode Press to keep the current choice[*], or type selection number: 1 guowenxue@ubuntu22:~$ python --version Python 2.7.18 ``` ## 1.2 解压缩获取SDK源码 首先创建 RK3568 开发板的项目工作路径。 ``` guowenxue@ubuntu20:~$ mkdir rk3568 && cd rk3568 ``` 如果选择 ***sdkv1.3.0_linux4.19*** 版本SDK，则可以使用下面命令从凌云实验室文件服务器上下载并解压缩。 ``` guowenxue@ubuntu22:~/rk3568$ mkdir sdkv1.3.0_linux4.19 && cd sdkv1.3.0_linux4.19 guowenxue@ubuntu22:~/rk3568/sdkv1.3.0_linux4.19$ wget http://192.168.0.2:2211/rockchip/bsp/rk3568_linuxSDK/sdkV1.3.0_linux4.19/rk356x_linux_release_v1.3.0_20220925.tgz guowenxue@ubuntu22:~/rk3568/sdkv1.3.0_linux4.19$ tar -xzf rk356x_linux_release_v1.3.0_20220925.tgz guowenxue@ubuntu22:/build/rk3568/sdkv1.3.0_linux4.19$ rm -f *.tgz ``` 如果选择 ***sdkv1.4.0_linux5.10*** 版本SDK，则可以使用下面命令从凌云实验室文件服务器上下载并解压缩。 ```bash guowenxue@ubuntu22:~/rk3568$ mkdir sdkv1.4.0_linux5.10 && cd sdkv1.4.0_linux5.10 guowenxue@ubuntu22:~/rk3568/sdkv1.4.0_linux5.10$ wget http://192.168.0.2:2211/rockchip/bsp/rk3568_linuxSDK/sdkV1.4.0_linux5.10/rk356x_linux5.10_release_v1.4.0_20231220.tgz guowenxue@ubuntu22:~/rk3568/sdkv1.4.0_linux5.10$ tar -xzf rk356x_linux5.10_release_v1.4.0_20231220.tgz guowenxue@ubuntu22:~/rk3568/sdkv1.4.0_linux5.10$ rm -f *.tgz ``` 解压缩出来的源码都在隐藏的 ***.repo*** 文件夹下，接下来我们使用 **repo** 命令将源码 checkout 出来。 ``` guowenxue@ubuntu22:/build/rk3568/sdkv1.3.0_linux4.19$ ls -a . .. .repo guowenxue@ubuntu22:/build/rk3568/sdkv1.3.0_linux4.19$ ls .repo/ manifests manifests.git manifest.xml project.list project-objects projects repo guowenxue@ubuntu22:/build/rk3568/sdkv1.3.0_linux4.19$ .repo/repo/repo sync -l Updating files: 100% (17139/17139), done./app/rkaiq_tool_serverUpdating files: 51% (8839/17139) Updating files: 100% (779/779), done.inux/buildrootUpdating files: 41% (322/779) Updating files: 100% (1171/1171), done.ux/debianUpdating files: 72% (844/1171) Updating files: 100% (248/248), done.inux/device/rockchipUpdating files: 10% (25/248) Updating files: 100% (247/247), done.inux/bsp/docsUpdating files: 45% (112/247) Updating files: 100% (1493/1493), done.ux/bsp/external/broadcom_bsaUpdating files: 41% (622/1493) Updating files: 100% (127/127), done.inux/external/libglCompositorUpdating files: 44% (56/127) Updating files: 100% (118/118), done.inux/external/rkfacialUpdating files: 29% (35/118) Updating files: 100% (921/921), done.k/rknn-toolkit2Updating files: 5% (52/921) Updating files: 100% (368/368), done.inux/external/rkupdateUpdating files: 22% (84/368) Updating files: 100% (186/186), done.inux/external/rkwifibtUpdating files: 59% (110/186) Updating files: 100% (2109/2109), done.ux/security/binUpdating files: 15% (332/2109) Updating files: 100% (33/33), done. android/rk/platform/system/rk_tee_userUpdating files: 93% (31/33) Updating files: 100% (72280/72280), done./external/uvc_appUpdating files: 3% (2631/72280) Updating files: 100% (17900/17900), done.rnelUpdating files: 34% (6102/17900) Updating files: 100% (7165/7165), done.prebuilts/gcc-buildroot-9.3.0-2020.03-x86_64_aarch64-rockchip-linux-gnuUpdating files: 13% (949/7165) Updating files: 100% (236/236), done.k/rkbinUpdating files: 46% (109/236) Updating files: 100% (13576/13576), done./toolsUpdating files: 88% (12076/13576) Checking out projects: 100% (65/65), done. repo sync has finished successfully. guowenxue@ubuntu22:/build/rk3568/sdkv1.3.0_linux4.19$ ls app buildroot build.sh debian device docs envsetup.sh external kernel Makefile mkfirmware.sh prebuilts rkbin rkflash.sh tools u-boot yocto ``` SDK 相关文档都存放 **docs** 文件夹下。 ``` guowenxue@ubuntu22:/build/rk3568/sdkv1.3.0_linux4.19$ ls docs/ Common docs_list.txt Linux Others RK356X RK_Linux_SDK_Supported_System_Kernel_Version_and_ISP_Version_List.png Rockchip_Developer_Guide_Linux_Software_CN.pdf ``` 如果选择 ***sdkv1.3.0_linux4.19*** 版本SDK，还需要从凌云实验室文件服务器上下载buildroot源码并解压缩。 ```bash guowenxue@ubuntu22:/build/rk3568/sdkv1.3.0_linux4.19$ cd buildroot/ guowenxue@ubuntu22:/build/rk3568/sdkv1.3.0_linux4.19/buildroot$ wget http://192.168.0.2:2211/rockchip/bsp/rk3568_linuxSDK/sdkV1.3.0_linux4.19/buildroot_DL/dl.zip guowenxue@ubuntu22:/build/rk3568/sdkv1.3.0_linux4.19/buildroot$ unzip dl.zip && rm -f dl.zip guowenxue@ubuntu22:/build/rk3568/sdkv1.3.0_linux4.19/buildroot$ cd .. ``` ## 1.3 Linux SDK源码编译 首先使用下面命令选择要编译的目标开发板，SDK版本不一样，该选项的名字不一样。 ``` guowenxue@ubuntu22:/build/rk3568/sdkv1.3.0_linux4.19$ ./build.sh lunch 5. BoardConfig-rk3568-evb1-ddr4-v10.mk # sdkv1.3.0_linux4.19 选择该选项 5. rockchip_rk3568_evb1_ddr4_v10_defconfig # sdkv1.4.0_linux5.10 选择该选项 Which would you like? [0]: 5 ``` 如果需要，可以使用下面命令来彻底清除之前的编译。 ``` guowenxue@ubuntu22:~/rk3568/sdk$ ./build.sh cleanall ``` ***sdkv1.3.0_linux4.19*** 和 ***sdkv1.4.0_linux5.10*** 版本SDK 都需要修改 IO Domain 电压如下。 ``` guowenxue@ubuntu22:/build/rk3568/sdkv1.3.0_linux4.19$ vim kernel/arch/arm64/boot/dts/rockchip/rk3568-evb.dtsi ... ... ... &pmu_io_domains { status = "okay"; pmuio2-supply = <&vcc3v3_pmu>; vccio1-supply = <&vccio_acodec>; vccio3-supply = <&vccio_sd>; vccio4-supply = <&vcc_1v8>; vccio5-supply = <&vcc_3v3>; vccio6-supply = <&vcc_1v8>; vccio7-supply = <&vcc_3v3>; }; ``` 接下来运行 build.sh 脚本开始编译SDK，默认是 Buildroot 系统镜像。 ``` guowenxue@ubuntu22:/build/rk3568/sdkv1.3.0_linux4.19$ ./build.sh ``` 也可以通过设置坏境变量 **RK_ROOTFS_SYSTEM** 指定不同 rootfs。 **RK_ROOTFS_SYSTEM** ⽬前可设定三种系统：***buildroot、debian、 yocto***。 ```bash guowenxue@ubuntu22:/build/rk3568/sdkv1.3.0_linux4.19$ RK_ROOTFS_SYSTEM=yocto ./build.sh ``` 如果是 ***sdkv1.3.0_linux4.19*** 在编译 Linux内核时需要做如下选择。 ``` 编译内核过程弹窗的电压选择如下： 3300000 PMUIO2 Supply Power Voltage(uV) 3300000 VCCIO1 Supply Power Voltage(uV) 3300000 VCCIO3 Supply Power Voltage(uV) 1800000 VCCIO4 Supply Power Voltage(uV) 3300000 VCCIO5 Supply Power Voltage(uV) 1800000 VCCIO6 Supply Power Voltage(uV) 3300000 VCCIO7 Supply Power Voltage(uV) ... ... ... ``` 编译生成的文件将放在 **rockdev** 文件夹下。 ``` guowenxue@ubuntu22:/build/rk3568/sdkv1.3.0_linux4.19$ ls rockdev/ boot.img linux-headers.tar MiniLoaderAll.bin misc.img oem.img parameter.txt recovery.img rootfs.img uboot.img update.img userdata.img ``` # 2. 系统烧录 ## 2.1 开发板烧录连接 如下图所示： ![Board_Connect](images/Board_Connect.png) * 使用 12V/1A 的电源给开发板供电； * 使用两端都是 TypeA接口的USB线连接开发板上的USB3.0接口到自己的PC上，该USB接口为系统烧录口； * 使用 TypeB 接口的USB线连接开发板上的 Console 调试串口到自己的PC上； ***注： 开发板上电时，可以听到继电器上电后的咔嚓切换声音。*** ## 2.2 烧录软件下载 将编译SDK生成的镜像文件(rockdev文件夹)下载到 Windwos下的相应路径下，如： ![image_files](images/image_files.png) 从凌云实验室文件服务器上下载并安装下面烧录软件。 * [CP210x_VCP_Windows.zip](http://studio.iot-yun.club:2211/rockchip/tools/CP210x_VCP_Windows.zip) 解压缩并安装开发板的Console调试串口驱动； * [DriverAssitant_v5.1.1.zip](http://studio.iot-yun.club:2211/rockchip/tools/DriverAssitant_v5.1.1.zip) ， 解压缩安装RK3568开发板驱动； * [RKDevTool_Release_v2.86.zip](http://studio.iot-yun.club:2211/rockchip/tools/RKDevTool_Release_v2.86.zip) ，直接解压缩即可运行的 RK3568开发板烧录软件； 下面是我 Windows下的开发板项目目录结构： ![project_folder](images/project_folder.png) * **docs** 存放开发板相关文档、芯片datasheet等； * **images** 存放开发板编译出来系统镜像； * **installer** 项目相关的安装软件； * **RKDevTools_v2.86** RK3568开发板烧录软件； 双击运行 ***RKDevTools_v2.86*** 文件夹下的 **RKDevTool.exe** 可执行文件， 在下载镜像页面配置各个镜像文件及其烧录地址如下： ![RKDevTool_conf](images/RKDevTool_conf.png) ## 2.3 Maskrom烧录模式 如果我们想烧录或更新系统镜像，必须要让CPU进入到 Maskrom 烧录模式。在RK3568开发板上，我们可以分别按住开发板上的不同按键进入到 Maskrom 烧录模式。下面是开发板上的各个按键说明： | 按键 | 作用 | 备注 | | ------ | -------------- | -------------------------------------- | | SW2101 | RK809_PWRON | 长按8秒左右关机，再按开机 | | S1300 | A核Maskrom按键 | 按住该键+复位键系统将进入到MASKROM模式 | | SW1501 | Recovery Key | 按住该键+复位键系统将进入到Loader模式 | | SW2100 | RESETN | A核复位按键 | | S6000 | M3核复位按键 | M核复位按键 | | S6001 | M3核ISP按键 | 按下复位M核将进入UART ISP模式 | ### 2.3.1 按住 Maskrom 按键进入 如下图所示，将开发板上电后，按住 **S1300(Maskrom)按键** 同时，然后 **按下并释放 SW2100(Reset)按键** 将开发板重启，接下来 **再释放S1300按键**，这时候CPU将会进入到 **Maskrom模式**，在该模式下我们可以烧录或升级系统镜像。 ![boot_maskrom](images/boot_maskrom.png) 下面是开发板上的各个按键说明： | 按键 | 作用 | 备注 | | ------ | -------------- | -------------------------------------- | | SW2101 | RK809_PWRON | 长按8秒左右关机，再按开机 | | S1300 | A核Maskrom按键 | 按住该键+复位键系统将进入到MASKROM模式 | | SW1501 | Recovery Key | 按住该键+复位键系统将进入到Loader模式 | | SW2100 | RESETN | A核复位按键 | | S6000 | M3核复位按键 | M核复位按键 | | S6001 | M3核ISP按键 | 按下复位M核将进入UART ISP模式 | 此时在 **RKDevTool.exe** 软件底行会显示 “**发现一个MASKROM设备**” 。 ![mode_maskrom](images/mode_maskrom.png) ### 2.3.1 按住 Recovery 按键进入 如下图所示，将开发板上电后，按住 **SW1501(Recovery)按键** 同时，然后 **按下并释放 SW2100(Reset)按键** 将开发板重启，**继续SW1501(Recovery)按键 8秒后释放**，这时候CPU将会进入到 **Loader 模式**，在该模式下我们可以烧录或升级系统镜像。 ![boot_loader](images/boot_loader.png) 此时在 **RKDevTool.exe** 软件底行会显示 “**发现一个LOADER设备**”。 ![mode_loader](images/mode_loader.png) 接下来切换到 “**高级功能**” 菜单下，并点击 “**进入Maskrom**” 按钮，这时候将会切换到 “**Maskrom**” 模式。 ![mode_switch](images/mode_switch.png) ## 2.4 系统烧录与启动 在 **RKDevTool.exe** 烧录软件上，确认设备已经进入到 Maskrom模式后，点击上面的 **“执行”** 按钮。 ![maskrom_program1](images/maskrom_program1.png) 此时将会开始烧录系统镜像到开发板上，烧录完成后系统将会自动重启，系统启动后将会提示 “**发现一个ADB设备**”。 ![maskrom_program1](images/maskrom_program2.png) 烧录完成第一次启动后，系统将会自动初始化。初始化完成之后将会再次重启，此时可以使用 Console 串口上登录到开发板的 Linux 系统中去。 ![console_login](images/console_login.png) # 3. 外设调试与测试 ## 3.1 系统心跳灯 ### 3.1.1 内核修改支持 原理图及分析 DTS文件修改(如果有) ``` TBD ``` 内核make menuconfig配置(如果有) ``` xxxx -> xxxx -> xxxx -> ``` ### 3.1.2 应用程序测试 TBD ## 3.2 RGB灯和蜂鸣器扩展接口 ### 3.2.1 内核修改支持 原理图及分析 DTS文件修改(如果有) ``` TBD ``` 内核make menuconfig配置(如果有) ``` xxxx -> xxxx -> xxxx -> ``` ### 3.2.2 应用程序测试 系统状态在系统启动后会默认工作在心跳灯模式，我们也可以使用下面命令修改为其他工作状态。 ## 3.3 RTC芯片 ### 3.3.1 内核修改支持 DTS文件修改 ``` TBD ``` 内核make menuconfig配置 ``` xxxx -> xxxx -> xxxx -> ``` ### 3.3.2 应用程序测试 TBD ## 3.4 RS232和RS485 ### 3.4.1 内核修改支持 原理图及分析 DTS文件修改(如果有) ``` TBD ``` 内核make menuconfig配置(如果有) ``` xxxx -> xxxx -> xxxx -> ``` ### 3.4.2 应用程序测试 TBD ## 3.5 CAN总线 ### 3.5.1 内核修改支持 原理图及分析 DTS文件修改(如果有) ``` TBD ``` 内核make menuconfig配置(如果有) ``` xxxx -> xxxx -> xxxx -> ``` ### 3.5.2 应用程序测试 TBD ## 3.6 声卡Codec ### 3.6.1 内核修改支持 原理图及分析 DTS文件修改(如果有) ``` TBD ``` 内核make menuconfig配置(如果有) ``` xxxx -> xxxx -> xxxx -> ``` ### 3.6.2 应用程序测试 TBD ## 3.7 内存压力测试 ### 3.7.1 内核修改支持 原理图及分析 DTS文件修改(如果有) ``` TBD ``` 内核make menuconfig配置(如果有) ``` xxxx -> xxxx -> xxxx -> ``` ### 3.7.2 应用程序测试 TBD ## 3.8 网卡压力测试 ### 3.8.1 内核修改支持 原理图及分析 DTS文件修改(如果有) ``` TBD ``` 内核make menuconfig配置(如果有) ``` xxxx -> xxxx -> xxxx -> ``` ### 3.8.2 应用程序测试 TBD ## 3.9 4G模块 ### 3.9.1 内核修改支持 原理图及分析 DTS文件修改(如果有) ``` TBD ``` 内核make menuconfig配置(如果有) ``` xxxx -> xxxx -> xxxx -> ``` ### 3.9.2 应用程序测试 TBD