OpenHarmony-RK3568开发板操作梳理

镜像下载、域名解析、时间同步请点击阿里云开源镜像站

写在前面可参考
PS：使用wsl2作为Windows下Ubuntu环境时提升代码编译等效率的几个点：
1.安装完wsl后，检查wsl的版本，确保是版本2（cmd执行wsl -l -v查看，如果不是，可通过wsl.exe -set-version Ubuntu-20.04 2转换成版本2）
2.wsl2安装完成后，切换软件源为国内软件源，可参考（亲测好用） Ubuntu20.04换阿里源（解决安装build-essential失败问题）_AnChenliang
3.默认是安装在系统盘的，可安装完后迁移到非系统盘
4.OpenHarmony代码相关操作建议在wsl2个人用户家目录下操作

一、板子组装

该电路板组装方便、安全。注意屏幕和摄像头的插入顺序。反向插头可能会导致屏幕不亮，相机无法使用。

[En]

The board can be assembled conveniently and securely. Pay attention to the order in which the screen and the camera are plugged in. The reverse plug may cause the screen not to light up and the camera can not be used.

二、WSL2安装

InsStep:

1.打开设置->安全和更新->开发者选项，选择为”开发人员模式”；

2.Win + R运行control appwiz.cpl指令,在启用或关闭Windows功能中勾选适用于Linux的Windows子系统和虚拟机平台两项启用，重启（注：没有虚拟机平台的，请升级Windows系统,Win10 版本号为 2004（内部版本19041或更高）,）；

3.以管理员身份打开PowerShell并运行：dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart 开启Windows子系统功能；

4.打开Microsoft Store搜索Ubuntu，安装Ubuntu20.04：

5.安装完直接打开，设置用户名和密码以及root用户密码：

6.将Ubuntu Shell环境修改为bash

执行sudo dpkg-reconfigure dash,选择No，将Ubuntu shell由dash修改为bash

如图，执行ls -l /bin/sh查看：

7.python3环境

Ubuntu20已自带python3.8.5，执行sudo update-alternatives –install /usr/bin/python python /usr/bin/python3 150切换python3：

安装pip3

$ sudo apt-get -y update

$ sudo apt-get install python3-pip

8.安装完成，用户账号设置好之后，打开命令行窗口执行wsl -l -v查看下wsl的版本(注：cmd,wsl找不到的请更新windows版本)，确保是wsl2,如果是版本1，可执行wsl.exe –set-version Ubuntu-20.04 2命令升级为版本2，执行后等待转换完成即可！！注意一定要是WSL2，如果是版本1，编译速度会慢几十倍！

PS：执行wsl.exe –set-version Ubuntu-20.04 2出现内核组件问题，先下载安装
wsl_update_x64.msi后，在执行切换命令，即可开始转换，等待转换完成即可。

9.wsl2迁移参考OpenHarmony代码操作总结wsl迁移部分

10.wsl2安装完成后，切换软件源为国内软件源:

s1:备份原来的源:cp -ra /etc/apt/sources.list /etc/apt/sources.list.bak

s2: 将源换成阿里源:sudo gedit /etc/apt/sources.list,将里面的内容清空，把下面的内容复制进去，保存退出

deb http://mirrors.aliyun.com/ubuntu/ focal main restricted universe multiverse
deb-src http://mirrors.aliyun.com/ubuntu/ focal main restricted universe multiverse

deb http://mirrors.aliyun.com/ubuntu/ focal-security main restricted universe multiverse
deb-src http://mirrors.aliyun.com/ubuntu/ focal-security main restricted universe multiverse

deb http://mirrors.aliyun.com/ubuntu/ focal-updates main restricted universe multiverse
deb-src http://mirrors.aliyun.com/ubuntu/ focal-updates main restricted universe multiverse

deb http://mirrors.aliyun.com/ubuntu/ focal-proposed main restricted universe multiverse
deb-src http://mirrors.aliyun.com/ubuntu/ focal-proposed main restricted universe multiverse

deb http://mirrors.aliyun.com/ubuntu/ focal-backports main restricted universe multiverse
deb-src http://mirrors.aliyun.com/ubuntu/ focal-backports main restricted universe multiverse

s3: 更新缓存和升级:

sudo apt-get update

sudo apt-get upgrade

PS:按上述步骤切换软件源后可解决一Ubuntu20.04一些依赖工具安装失败的问题

11.WSL映射到本地

如图：

本地方便查看

三、获取源码

代码初次下载需要做一些前期准备工作：主要有码云gitee账号注册、添加码云SSH公钥、安装git和git-lfs、配置用户信息、repo工具安装

注册码云gitee账号

只需注册电话号码，添加工作邮箱为主邮箱即可，如图：

[En]

Just register the phone number and add the work mailbox as the main mailbox, as shown in the figure:

注册码云SSH公钥

参考码云生成/添加SSH公钥

如图：

如图所示，检查公钥是否添加成功：

[En]

As shown in the figure, check whether the public key has been added successfully:

安装git客户端和git-lfs并配置用户信息

安装git客户端

执行：

sudo apt install git-all

安装git-lfs

依次执行以下命令：

curl -s https://packagecloud.io/install/repositories/github/git-lfs/script.deb.sh | sudo bash

sudo apt-get install git-lfs

git lfs install

配置用户信息

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

安装repo工具

安装码云repo工具，由于权限可切换到root用户下安装，安装后再切换个人用户目录操作既可：

执行：

 curl https://gitee.com/oschina/repo/raw/fork_flow/repo-py3 > /usr/local/bin/repo

chmod a+x /usr/local/bin/repo

 pip3 install -i https://pypi.tuna.tsinghua.edu.cn/simple requests

下载主干master分支源码

repo init -u git@gitee.com:openharmony/manifest.git -b master --no-repo-verify
repo sync -c
repo forall -c 'git lfs pull'

ps:git lfs

rk3568对应仓库

device/hihope/rk3568

四、编译

代码下载后的初始编译需要做一些准备工作：主要依赖于工具安装和预编译。

[En]

Some preparatory work needs to be done for the initial compilation after the code download: mainly dependent on tool installation and pre-compilation.

编译环境准备

S1:安装依赖工具

sudo apt-get update && sudo apt-get install binutils git git-lfs gnupg flex bison gperf build-essential zip curl zlib1g-dev gcc-multilib g++-multilib libc6-dev-i386 lib32ncurses5-dev x11proto-core-dev libx11-dev genext2fs liblz4-tool libssl-dev libtinfo5 lib32z1-dev ccache libgl1-mesa-dev libxml2-utils xsltproc unzip m4 bc gnutls-bin python3.8 python3-pip ruby

S2:执行java –version看是否有java的环境，没有的话安装下

sudo apt install openjdk-17-jre-headless

如图：

S3:执行prebuilts,在源码根目录下执行，安装编译器及二进制工具

bash build/prebuilts_download.sh

版本编译

进入源码根目录，执行：

./build.sh --product-name rk3568 --ccache

编译结果

编译完成后，log显示如下：

镜像路径：\out\rk3568\packages\phone\images\

daily构建版本或转测版本获取

daily构建版本

http://ci.openharmony.cn/dailybuilds

PS：hdc工具除过自己本地编译，也可以从流水线构建本下载：

转测版本

Release-Testing-Version.md · OpenHarmony-SIG/oh-inner-release-management – Gitee.com

五、烧写

烧写所需驱动和工具获取

usb驱动安装

双击windows\DriverAssitant\DriverInstall.exe安装usb驱动

正常烧写

烧写

双击\windows\RKDevTool.exe打开烧写工具，工具界面击烧写步骤如图所示：

MASKROM模式和LOADER模式两种模式下可供烧写，推荐LOADER模式烧写，非必要不使用MASKROM按键操作烧写。

LOADER模式烧写：板子上电状态，PC usb线连接板子，先按住板子上的Recovery键，然后按一下reset键，待工具界面显示LOADER设备后，松开Recovery键，设备进入loader模式，点击执行开始烧写，如图：

MASKROM模式烧写：设备断开电源状态，PC usb线连接设备，先按住板子上的MASKROM按键，设备上电，待工具界面显示MASKROM设备后，松开MASKROM键，系统进入MASKROM模式，点击执行开始烧写，具体步骤截图与上图一样（注：MASKROM模式烧写，需勾选Loader下载项）。

变砖拯救

烧写时由于烧写不当，比如uboot文件烧错等，导致烧写工具MASKROM和Loader模式都发现不了设备，设备无法启动的情况下，可按照如下操作进行烧写：

Windows下，设备连接电源状态，PC连接设备（通过USB），同时按住reset 键maskrom 按键，然后先松开reset键，待工具界面显示MASKROM设备后，再松开MASKROM键，设备进入MASKROM模式，勾选Loader，MASKROM模式下点击执行开始烧写即可。

如图：沟通Loader下载项，MASKROM模式开始烧写：

PS：MaskRom 模式是设备变砖的最后一条防线。强行进入 MaskRom 涉及硬件操作，有一定风险，因此仅在设备进入不了 Loader 模式的情况下，方可尝试 MaskRom 模式。进入 MaskRom 的原理是人为的把 EMMC 的数据脚与地线短接，系统会认为 EMMC 数据出错，从而清除 EMMC 数据。

参考MaskRom模式 — Firefly Wiki

六、Hdc工具连接设备

hdc的版本和设备版本保持一致，可自己编译最新hdc工具：源码根目录执行./build.sh –product-name ohos-sdk –ccache,直接copy到本地路径（可将hdc_std.exe改为hdc.exe方便点）加入环境变量，如图：

七、测试套编译和执行

测试套编译

到/test/xts/acts目录下执行./build.sh product_name=rk3568 system_size=standard target_subsystem=××××可编译单个子系统测试套

编译结果查看：/out/rk3568/suites/acts/

用例执行

编译生成的可执行文件（C++用例等）和hap包（js用例等）在testcases目录下，用例执行可以将可执行文件或hap包通过hdc send到设备制定目录，通过 ./***或aa start的方式执行，也可以连接设备后，将编译生成的acts文件夹coay到Windows本地，cmd命令行进入acts目录，运行run.bat，然后执行run acts的方式开始执行用例，用例执行的报告和log会在acts目录下生成。