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 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下图，其中端口号可以在上述步骤中提到的设备管理器中查找，其余参数保持默认设置即可。
图13 XSHELL工具运行界面(上：设置连接，下：设置串口)
在完成上述所有设置之后，就可以通过XSHELL实现串口连接了，若出现“Connected”则说明成功连接，效果如图14所示。
图14 成功实现串口连接效果图
2.2 与树莓派的板子实现SSH通讯
实现SSH通讯的前提是需要先获取树莓派的IP地址并与MAC地址绑定，在成功绑定后，使用上一节中设置好的串口打开树莓派的SSH服务，然后就可以建立SSH通讯了。
(1)获取树莓派的IP地址并绑定
由于需要借助路由器来获取树莓派的IP地址，因此需要使树莓派开发板和电脑主机处于同一局域网下。流程如下：
将网线一端连接至树莓派开发板的网口，另一端连接至路由器网口，实现树莓派开发板联网。
给电脑主机连接此路由器的WiFi。
在浏览器中输入路由器的后台管理IP进入后台管理界面，输入密码进行登录，如图15中红框所示。
图15 登录路由器后台管理
成功登录后，按照图16中标记的序号顺序，依次点击设置红框部分：高级设置—IP----添加—弹出“绑定设备”提示框----记录树莓派的IP地址并更改设备名称(图中鼠标所致处)-----一键绑定。
图16 获取并绑定树莓派IP流程
(2)通过串口打开树莓派的SSH服务
如图17，在前面介绍的串口工具XCOM/XSHELL中，选择之前已检测正常的串口并保持其他属性选项为默认;在左下角控制台单条发送ifconfig命令，用来打开树莓派的SSH服务。
图17 XCOM打开树莓派的SSH服务
(3)建立与树莓派板子的SSH连接
正常运行后，同样使用XSHELL新建一个如图18的会话，用于设置树莓派的属性即名称和主机IP，名称可自定义，主机IP是之前已从路由器获取的树莓派IP地址。
图18 设置树莓派属性建立SSH连接
点击“确定”后，在弹出来的提示框中选择接受并保存主机秘钥，输入登录的用户名和密码，点击“确定”即可出现建立远程SSH服务，效果如图19所示。
图19 成功实现SSH通讯效果图
2.3 与树莓派开发板实现文件可视化传输
为实现电脑与树莓派开发板进行文件可视化传输，需要使用工具WinSCP。此工具是支持SSH的SCP文件传输工具，将其与相应的服务器连接并设置相关参数后，即可在电脑和开发板之间相互下载或传输文件。
(1)工具下载
下载WinScp工具，下载地址可参考https://www.onlinedown.net/soft/20088.htm，下载完成后根据提示进行安装。
(2)参数设置
启动电脑的ssh服务，在ssh服务已开启且成功建立连接的情况下，启动WinScp工具，在WinScp中新建站点，参数设置可参考图20红框中的内容。
图20 新建站点
(3)文件传输
设置完参数后点击登录按钮，在出现的各种提示项中选择默认选项，之后便可以进入如图20所示界面，界面左侧表示主机文件系统，右侧表示openharmony3.0(即树莓派开发板)的文件系统，用户可以采用拖动的方式，实现在两台设备间相互文件传输的效果。
图21 文件传输界面
