Openharmony在RK3568X环境搭建编译及运行-快速上手

OpenHarmony是由开放原子开源基金会（OpenAtom Foundation）孵化及运营的开源项目，目标是面向全场景、全连接、全智能时代、基于开源的方式，搭建一个智能终端设备操作系统的框架和平台，促进万物互联产业的繁荣发展。

• 一、开发环境准备

针对openharmony板级开发需要准备以下环境：

1. TB-RK3568X开发板1个（附购买链接）
2. PC-Windows10 1台（用于烧录和调试）
3. 服务器-Ubuntu20.04（用于openharmony代码编译）
4. RK3568开发板外围配件（屏幕/摄像头等，附购买链接）

• 二、开发板（目标板）硬件规格说明

TB-RK3568X采用四核64位Cortex-A55 处理器，主频高达2.0GHz，效能有大幅提升；采用22nm先进工艺，具有低功耗高性能的特点；配置双千兆自适应RJ45以太网口，可通过双网口访问和传输内外网的数据，提高网络传输效率，满足NVR、工业网关等多网口产品需求。下图为本次开发使用的硬件目标板：

• 2.1 目标板-核心板规格参数

SOC 系统芯片	Rockchip RK3568
CPU 中央处理器	Quad-core Cortex-A55 up to 2.0GHz
GPU 图形处理器	Mali-G52 GPU 支持OpenGL ES 1.1/2.0/3.2，OpenCL 2.0，Vulkan 1.1 内嵌高性能2D加速硬件
VPU 视频处理单元	支持4K 60fps H.265/H.264/VP9视频解码 支持1080P 100fps H.265/H.264视频编码 支持8M ISP，支持HDR
NPU 嵌入式神经网络处理器	支持0.8T算力，支持INT8，INT16，FP16运算
CPU 内存	2/4GB LPDRR4/LPDRR4x,最高可配8GB,频率高达1600MHz
NPU 内存	共享3568端ddr，根据模型大小，决定开辟多大
Storage 闪存	16/32 GB
输入电源	DC 12V/2A
系统支持	Android、Linux
PCB 规格	6 层板
核心板尺寸	82mm×60mm
接口类型	SODIMM 314P（MXM 3.0）

• 2.2 底板规格参数

底板尺寸	180mm×130mm
PCB 规格	4 层板
显示接口	1x HDMI2.0(Type-A)接口，支持4K/60fps输出 2x MIPI接口，支持1920*1080@60fps输出 1x eDP接口，支持2K@60fps输出
音频接口	1x 8ch I2S/TDM/PDM 1x HDMI音频输出 1x 喇叭输出 1x 耳机输出 1x 麦克风，板载音频输入
以太网	2x GMAC(10/100/1000M)
无线网络	SDIO接口，支持WIFI6 5G/2.5G,BT4.2
摄像头接口	MIPI-CSI2, 1x4-lane/[email protected]/lane
USB	2x USB2.0 Host,Type-A 1x USB3.0 Host,Type-A 1x USB3.0 OTG
PCIe	1x 2Lanes PCIe3.0 Connector (RC Mode)
SATA	1x SATA3.0 Connector
SDMMC	1x Micro SD Card3.0
按键	1x Vol+/Recovery 1x Reset 1x Power 1x Vol- 1x Mute
调试	1x 调试串口
RTC	1x RTC
IR	1x IR
三色灯	3x LED
G-sensor	1x G-sensor
FAN	1x Fan
扩展接口	20Pin扩展接口包括： 2x ADC接口 2x I2C接口 7x GPIO口（或者3x gpio + 4x uart信号） 3x VCC电源（12V、3.3V、5V））

• 三、固件编译

• 搭建编译环境（在服务器或虚拟机上）
  • 服务器安装Ubuntu20.04系统
  • 安装repo

  • curl https://gitee.com/oschina/repo/raw/fork_flow/repo-py3 | sudo tee /usr/local/bin/repo >/dev/null
    sudo chmod a+x /usr/local/bin/repo

  • 设置git信息

  • git config --global user.name "yourname"
    git config --global user.email "your-email-address"
    git config --global credential.helper store

• 源码准备（在服务器Ubuntu20.04上）

  • # 该仓库选择了openharmony-3.1-Beta版本，大家也可以根据gitee分支进行索取其他版本
    cd ~
    mkdir openharmony
    cd openharmony
    repo init -u https://gitee.com/openharmony/manifest.git -b OpenHarmony-3.1-Beta  --no-repo-verify
    repo sync -c
    repo forall -c 'git lfs pull'

• 编译（在服务器Ubuntu20.04上）
  • 执行prebuilts

  • #在源码根目录下执行脚本，安装编译器及二进制工具
    cd ~/openharmony
    #下载的prebuilts二进制默认存放在与openHarmony同目录下的OpenHarmony_2.0_canary_prebuilts下
    ./build/prebuilts_download.sh

  • 进入源码根目录，开始编译

  • cd ~/openharmony
    ./build.sh --product-name rk3568

  • 编译完成后，会有如下显示：

  •  build system image successful.
    =====build RK3568 successful.

  • 生成的固件保存在out/rk3568/packages/phone/images目录下，生成的文件有

    

• 烧录（在Windows PC上）
  • 首次烧录需要安装USB驱动，驱动文件名为：DriverAssitant\ DriverInstall.exe，双击即可安装，针对RK开发板所有平台通用，安装一次就可以了。如下图所示：

  • 

  • 安装USB驱动后，下载烧录工具，打开工具RKDevTool.exe，如图所示：

  • 

  • 用双公口USB的烧录线连接Windows宿主机（PC）和开发板USB OTG3.0口，按住核心板的按键后，上电启动，等待开发板进入MASKROM模式，如下图所示：

  • 

  • 更改烧录固件路径（将服务器Ubuntu编译好的固件下载至Windows PC，下载方式自己百度一下），执行烧录，如下图所示：

  • 

   下载完成后，等待开发板重启后，即可看到新鲜出炉的鸿蒙系统，可以直接进行调试及进一步开发工作了。

• 四、固件下载

此部分链接是我按照第三步编译后的openharmony现成的固件，有需要的朋友可以取用。

• 五、调试及进一步开发

• 串口调试
  • 将串口线连接 Windows PC 与开发板，打开 securtCRT 串口工具，在设备管理器查看端口，如下图所示：

  • 

    串口波特率配置为 1500000，如下图所示

  • 

• hdc_std调试

hdc，全称 HarmonyOS Device Connector，是HarmonyOS提供的方便开发人员调试的命令行工具，使用该工具可以在个人电脑与设备或模拟器之间进行交互通讯。

hdc_std，与hdc相似，但它是OpenHarmony提供的用于开发人员调试的命令行工具，专门用在个人电脑与开发板之间的交互，并且这个开发板是需要运行OpenHarmony标准版（standard）系统的，所以在hdc后面加了std后缀以示区分。

在源码根目录下，编译hdc_std文件，

./build.sh --product-name ohos-sdk

#编译后如下：
post_process
=====build ohos-sdk successful.

生成的文件在out/sdk/ohos-sdk/windows/toolchains目录下，文件如下：

 将生成的hdc_std.exe文件拷贝至windows，在Windows下执行如下命令进行安装：

#安装hap包
hdc_std.exe install -r 包路径+包名

#如果安装失败，执行如下命令重新安装hap包
hdc_std.exe kill

 这样也可以通过hdc_std在Windows端进行调试了。