树莓派3B上烧录OpenHarmony3.0

2022-04-26 IT智能化专栏

OpenHarmony3.0已于2021年9月30号正式发布，本篇文章详细给出OpenHarmony3.0在树莓派3B上的烧录与通讯步骤，对其中使用的指令进行详细解释，同时附有烧录与通讯过程中使用的各类软件的下载链接，欢迎各位浏览指正。

1、OpenHarmony3.0编译及烧录

1.1 安装必要的依赖包

（1）安装必要的依赖包

执行sudo的apt update命令，用来检查已安装的软件包是否有可用的更新；再执行sudo的apt install -y命令，用来下载安装后续需要使用的依赖包。

sudo apt update
sudo apt install -y 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 lib32z-dev ccache 
                    libgl1-mesa-dev libxml2-utils xsltproc unzip m4 wget bc Python/ target=_blank class=infotextkey>Python python3 
                    Android-tools-fsutils libssl-dev mtools

此处需要注意的是，在Ubuntu20的环境下执行上一步命令时，可能会出现android-tools-fsutils工具安装失败的情况，如图1所示。只需将上述安装指令中的android-tools-fsutils替换为图1红框中的android-sdk-libspares和android-sdk-ext4-utils，并重新执行即可。

图1 android-tools-fsutils安装失败示意图

（2）安装repo工具

使用curl命令从Gitee网站上下载repo工具，并通过sudo的tee命令将下载后的结果以repo命名，标准输出到/usr/local/bin/repo路径下，实现repo安装。

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

安装完成后，使用sudo的chmod命令为已安装后的文件添加权限，此处设置的是a+x，即为全部使用者添加此文件的可执行权限。

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

（3）将/bin/sh重新指向/bin/bash

此步骤由sudo的ln -sf命令实现，命令含义是由/bin/sh重新指向/bin/bash。

sudo ln -sf bash /bin/sh

（4）设置git信息

在前面安装依赖包的步骤中，我们已经成功安装好了git，由于git是分布式版本控制系统，因此需要设置git自己的名字和电子邮件以作区分。

git config --global user.name your_name
git config --global user.email your_email

1.2 下载编译内核需要的工具链

编译内核需要下载和安装工具链

gcc-linaro-7.5.0-2019.12-x86_64_arm-linux-gnueabihf，安装路径此处设置为/ohos，因此需要先创建并切换至此路径。

mkdir ~/ohos
cd ~/ohos

使用Wget下载命令可以从官网进行下载，然后使用tar命令对已下载的工具链安装包进行解压即可。

Wget https://releases.linaro.org/components/toolchain/binaries/7.5-2019.12/arm-linux-gnueabihf/gcc-linaro-7.5.0-2019.12-x86_64_arm-linux-gnueabihf.tar.xz

tar -xvf gcc-linaro-7.5.0-2019.12-x86_64_arm-linux-gnueabihf.tar.xz

1.3 编译OpenHarmony

拉取源码同样将路径切换至/ohos下，新建名为openharmony的文件夹并进入此文件夹，通过前面已安装好的repo工具从Gitee网站上（

https://gitee.com/xfan1024/oh-rpi3b.git）拉取代码。

cd ~/ohos
mkdir openharmony
cd openharmony

repo init -u https://gitee.com/xfan1024/oh-rpi3b.git -m oh-rpi3b.xml -b refs/tags/v20210823 --no-repo-verify
 
repo sync -c
repo forall -c 'git lfs pull'
./build/prebuilts_download.sh

在openharmony文件夹中，先打补丁；之后进入/ohos路径下使用export命令设置环境变量；设置完成后再回到openharmony文件夹，即可开始编译。编译完成的界面如图2所示。

cd ~/ohos/openharmony
python3 projectpatch/patch.py

cd ~/ohos
export PATH="$PATH:$(pwd)/gcc-linaro-7.5.0-2019.12-x86_64_arm-linux-gnueabihf/bin"
cd openharmony
python3 build-rpi3.py build

图2 编译完成界面图

1.4 烧录到SD卡（windows烧录方法）

编译完成后生成的映像firmware.img的位置路径是

out/ohos-arm-release/packages/phone/images/firmware.img。在开始烧录之前，最好先检查下映像firmware.img的大小，这是为了防止由于未拷贝完成可能造成的烧录失败。经查看后，其大小为941MB，如图3所示。

图3 firmware.img映像大小示意图

之后将此firmware.img拷贝到window电脑上使用Win32DiskImager（下载地址：

https://sourceforge.NET/projects/win32diskimager/）进行烧录。此处我们需要使用SD卡+读卡器的组合，将映像烧录到SD卡所在的分区上。

首先将SD卡正确安装在读卡器中，然后将读卡器插到电脑上，“设备与驱动器”中会增加SD卡的分区。
按照下图所示配置Win32DiskImager工具后，点击写入即可完成烧录。

图4 Win32DiskImager工具配置界面

1.5 点亮树莓派的开发板的屏幕

烧录完成后，接下来需要点亮树莓派的开发板的屏幕，此部分主要分为如下4个步骤：

（1）插入SD卡

将SD卡插入到树莓派开发板的SD卡槽中，正确插入后的效果如图5红框中所示。

图5 在树莓派开发板上插入SD卡示意图

（2）连接开发板和其他硬件

按照图6所示的硬件连接示意图（图中每两个相同的序号分别表示同一根数据线的两端），用HDMI线①为树莓派开发板连接显示屏，用DC线②为显示屏供电，用电源线③连接开发板和电源。

图6 连接示意图

（3）开发板通电和显示屏点亮
在正确完成上述所有硬件连接后，需要先给开发板通电，再开启显示屏：

打开上述电源线③已连接的电源开关，给开发板通电，若硬件连接正常，即可启动树莓派开发板，效果如图7所示。

图7 开发板通电示意图

长按显示器侧面的按键“Power”约3~5秒，若硬件连接正常，屏幕就会点亮，注意此时显示器暂不支持触屏功能。

图8 点亮显示屏示意图

（4）设置显示器触屏
先使用一根数据线（图9中灰色数据线），在图9所示位置处，将显示器侧面标有“TOUCH”标志的端口和开发板的USB口相连。再在串口工具（串口工具下载使用方法见2.1）中使用reboot命令，重启设备即可设置显示器实现可触屏的效果，若命令未生效，可多次重启后再进行尝试。

图9 设置触摸屏的硬件连接示意图

2、开发板的通信和文件传输

OpenHarmony3.0在烧录到树莓派3B后，可以实现基本的显示、触屏等功能，接下来尝试与树莓派3B开发板实现通信，目前尝试的通信方式包括：串口通讯、SSH通讯、文件可视化传输三种通讯方式。

2.1 与树莓派开发板实现串口通讯

连接好串口线硬件设备，并且能成功识别串口的基础上，借助XCOM工具或者XSHELL工具可实现串口通信。
（1）连接串口线
将电脑和树莓派开发板使用串口线相互连接，其中USB端②与电脑连接，串口线①按照红线、黑线、白线、绿线的顺序依次与开发板连接，效果如图10所示。

图10 串口线连接效果

（2）检查USB端口是否显示
在电脑中，打开设备管理界面，来查看USB端口是否可以显示。若能够正常显示，则效果如图11；

图11 端口正常显示的界面

若端口名上出现了黄色叹号，则说明无法正常显示端口，此时需要右键端口名，查看其属性中的详细信息，检查是否是由于缺少驱动造成的。若确实是此原因造成，则需要在相应下载地址（

http://www.wch.cn/downloads/CH341SER_EXE.html）中下载驱动，并重启电脑；在重启后重新打开设备管理界面即可看到已显示的USB端口。

（3）使用XCOM工具实现串口通讯
在连接好串口线且USB端口能在电脑上正常显示后，就可以测试通讯功能是否正常了。此处需要使用XCOM工具，此工具能够准确地自动识别串口，还能够查看接收到的历史数据，可以单条发送也可以多条发送。在完成下载安装之后（下载地址为

http://www.downcc.com/soft/317457.html，仅供参考），XCOM工具的正常运行界面如图12所示。在右上角的红框区域可以设置端口和波特率，注意此处端口应选择上一步中能正常显示的USB端口；在界面中左下角的红框区域可输入cat命令用于测试串口是否正常。

图12 XCOM工具运行界面

（4）使用XSHELL工具实现串口通讯
使用XSHELL工具也可以实现串口通讯功能（下载地址为xshellcn.com/xiazai.html），在完成下载安装之后，正常运行界面如图12所示。
正常运行后，在XSHELL下新建一个会话，完成相关参数的设置。设置连接属性可参考图13上图，选择协议为红框中的SERIAL协议；设置串口参数可参考图13下图，其中端口号可以在上述步骤中提到的设备管理器中查找，其余参数保持默认设置即可。