Hi3516DV300因其可实现图像采集、识别、双屏显示、双向语音、红外夜视等多种丰富功能,在开发者中广受关注。然而,正是由于丰富的功能,不少开发者在Hi3516DV300开发板的组装、编译、应用开发和安装中或多或少会遭遇瓶颈。
那么Hi3516DV300开发板应该如何组装?如何获取OpenHarmony L2源码并进行编译和烧录?应用开发者又该如何基于Huawei DevEco Studio进行应用开发?这些开发者们关注的问题,我们将用一个完整指南为大家一一揭秘~
如果你是0基础上手该开发板并进行应用开发的开发者,那就千万不要错过本篇指南啦,我们将从环境搭建、代码获取、镜像烧录、应用开发、应用签名和应用安装六个方面入手,帮助开发者快速搭建OpenHarmony L2 应用开发调试环境。
一、环境搭建
为了后续更好的进行系统烧录和应用开发,我们需要先搭建好开发环境,这其中包含材料准备、硬件组装、安装USB串口驱动和通过串口连接开发板。
1. 材料准备
工欲善其事,必先利其器。为了后续更好进行编译烧录和应用开发,【材料准备】环节我们以表格的形式为大家罗列所有需要的硬件和软件工具,大家可以先行准备和下载哦~
2. 硬件组装
我们需要首先完成硬件(Hi3516DV300开发套件)组装,具体如何组装,直接上视频,让大家看得更清晰:
https://harmonyos.51cto.com/show/1053
最终安装效果如图:
注意:由于测试时L1屏幕默认横屏,而L2屏幕默认为竖屏。进行L2测试时需要调整整体设备右转90度,建议开发者将底座部分放到安装最后,调整到合适的角度后改为用点胶安装,可参见下图:
3. 安装USB串口驱动
硬件套装组装完毕后,我们需要识别开发板串口,便于后续通过串口连接开发板。
开发板接通电源线后,将USB串口线连接到电脑,并安装USBtoSerial Comm Port驱动。
正确安装驱动后,在系统设备管理器里可以获取com端口号,例如:
注意:图中的com端口号是计算机随机分配的,每个开发板识别出来的com端口号并不一致。
4. 通过串口连接开发板
获取端口号后,为开发板供电,在PC端安装Xshell或MobaXterm并新建连接,这里我们以Xshell工具为例来说明:
(1)点击“新建会话”,协议选择"SERIAL",即串行接口,如图所示:
(2)左侧目录选“SERIAL”,在右侧“Port ”中选择开发板对应的COM端口号(即上面获取到的COM4),“Baud Rate(波特率)”填写115200,“Flow Control(流控制)”选择None。
配置完后连接会话,我们就完成了通过串口连接开发板。到这里,我们已经可以通过串口控制开发板,同时可以在电脑端获取到开发板的运行状态,看到设备打印日志。
接下来我们来看看如何进行代码获取。
二、代码获取
开发者可以通过两种途径获取代码:
- 源码下载并编译。如果需要对代码进行编译,开发者可以在Gitee下载源码并使用DevEco Device Tool进行编译;
- 二进制代码直接获取。如果开发者仅仅是用于应用调试,不需要进行编译,可以直接下载二进制代码使用;
下面我们将从这两种途径详细讲述代码获取流程。
1. 源码下载并编译
(1)下载代码
我们可以在Gitee的OpenHarmony文档仓库获取到最新代码版本分支。
OpenHarmony文档仓库地址
https://gitee.com/openharmony/docs/tree/master
开发者可以通过以下两种方式获取最新版本OpenHarmony v2.2 Beta2:
方式一(推荐):通过repo + ssh 下载
- repo init -u git@gitee.com:openharmony/manifest.git -b refs/tags/OpenHarmony-v2.2-Beta2 --no-repo-verify
- repo sync -c
- repo forall -c 'git lfs pull'
注意:需注册公钥,请参考码云帮助中心:
https://gitee.com/help/articles/4191
方式二:通过repo + https 下载
- repo init -u https://gitee.com/openharmony/manifest.git -b refs/tags/OpenHarmony-v2.2-Beta2 --no-repo-verify
- repo sync -c
- repo forall -c 'git lfs pull'
(2)编译代码
Hi3516DV300的源码可以在Ubuntu编译环境下使用DevEco Device Tool实现一键编译,开发者可以参考官网文档,实现编译。
Hi3516DV300开发板源码编译:
https://device.harmonyos.com/cn/docs/ide/user-guides/ide-hi3516dv300-compile-0000001146686054
同样,开发者也可以参考下面内容通过命令行方式完成代码编译:
2. 二进制代码获取
如果仅需要进行应用调试,我们可以从Gitee每日构建网站获取最新下载链接。
网站地址:
http://ci.openharmony.cn/dailybuilds
开发者可以根据需求,选择对应的版本进行下载。
三、镜像烧录
完成代码获取后,让我们进入镜像烧录环节。为了实现在Linux系统下一站式编译烧录,本次我们使用的烧录工具是HiTool,我们将为大家介绍HiTool实现烧录时的配置,以及烧录方式的选择。
1. 烧录配置
打开HiTool工具,选择“烧写eMMC”页签,填写配置。
(1)由于在解压目录里,已经包含了xml配置文件,开发者需打开xml文件将其中的文件夹路径替换为当前文件所在的路径。
(2)替换为当前文件路径后,在工具中点击“浏览”选择xml文件加载即可:
2. 不同烧录方式实现
HiTool提供了三种烧录方式,分别为串口、网口和USB口,这里我们整理了三种烧录方式的区别:
建议大家优先选用USB口烧录,我们也将从USB口烧录开始为大家介绍。
(1)USB口烧录
USB口烧录需要先安装USB驱动,所以我们就从驱动安装和HiTool烧录两方面讲解。
驱动安装
这里我们选择的驱动工具为Zadig 2.5 。
① 安装完毕后,点击Options,点击下面几个选项查看具体的属性:
②选择Device中的Create New Device,新建设备:
③开发者需按图片所示填写以下三个字段,使开发板能够正确识别,并点击Install Driver安装:
Unknown Device #1
Driver:libusbK(v3.0.7.0)
USB ID:12D1 D001
通过串口连接开发板,先不要插USBType C线,通电后显示倒计时3秒内按回车(或任意键)进入fastboot,此时截图如下:
输入usb device命令并回车启动USB,如下图:
此时在开发板背后插上USB TypeC线,在设备管理器中可以看到对应的设备,说明驱动安装成功。
HiTool烧录
在HiTool界面,按照上文完成xml配置文件后,界面如下:
在传输方式中选择“USB口”,先拔掉USBType和电源线进行断电,按住update键(该键在串口线旁边)不松手,在HiTool上点击烧写,接着快速插入USBType线,此时HiTool界面会提示串口烧写,大概在几分钟即可完成。
注意:USB最好直插电脑,不要插扩展坞,避免由于供电不足导致烧录失败。
下面我们简单讲一下如何使用网口和串口进行烧录。
(2)网口烧录
如果使用网口,开发者需要使用网线进行连接。在HiTool传输方式上选择网口,在左侧输入相应的IP。点击烧写,这个时候可能会提示重新加电,开发者只需要按电源线两下即可。
(3)串口烧录
串口烧录使用的是USB串口线。在HiTool传输方式上选择串口,同样会提示重新加电,开发者按电源线两下即可解决。但串口烧录速度非常慢,不推荐开发者使用。
3. 系统启动
连接串口,在显示倒计时3秒时按任意键进入fastboot界面(如果没赶上,可以reboot或者通过电源按钮重启),接着使用下面的启动参数:
- setenv bootargs 'mem=640M console=ttyAMA0,115200 mmz=anonymous,0,0xA8000000,384M clk_ignore_unused androidboot.selinux=permissive skip_initramfs rootdelay=5 init=/init root=/dev/mmcblk0p5 rootfstype=ext4 rw blkdevparts=mmcblk0:1M(boot),15M(kernel),20M(updater),1M(misc),3307M(system),256M(vendor),-(userdata)'
- setenv bootcmd "mmc read 0x0 0x80000000 0x800 0x4800; bootm 0x80000000";
- save
- reset
完成上述操作后,屏幕将被点亮,系统会自动启动进入桌面。
到这里我们完成烧录环节。下面我们来看看应用的开发、应用签名与安装。
四、应用开发
我们将简要介绍OpenHarmony应用如何开发,详细介绍请参考OpenHarmony Doc开发文档。
- OpenHarmony Doc开发文档
- https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/quick-start/Readme-CN.md
下面操作建议使用DevEco Studio 2.2 Beta1及以上版本进行。
1. 配置OpenHarmony SDK
(1)下载OpenHarmony SDK包并解压,复制下方链接即可直接下载:
下载链接
https://mirror.iscas.ac.cn/OpenHarmony/sdk/OpenHarmony-SDK-2.0-Canary.7z
(2)在Settings > Appearance & Behavior > System Settings > HarmonyOS SDK界面,选择刚才解压的SDK目录;
(3)进入Sdk\js\2.2.0.0\buildtools\aceloader目录,在该目录下运行命令行工具,分别执行如下命令,直至安装完成。
- npm cache clean -f
- npm install
2. 新建应用
创建工程时选择 “[Standard]Empty Ability(JS)” 模板进行即可开发。
如果开发者是导入历史应用,需要注意在entry\build.gradle的ohos中增加**supportSystem “*standard*”**字段。如果应用编译遇到其它问题,可以新建一个空项目并比对一下build.gradle文件排除故障。
五、应用签名
由于在L2上安装应用时无法关闭签名验证,因此开发者在安装前需要对hap包进行签名。OpenHarmony应用签名步骤如下图所示,详细操作开发者可参考配置OpenHarmony应用签名信息,这里不再赘述。
配置OpenHarmony应用签名信息:
签名配置完成后,我们可以在Deveco点击菜单栏中的“BuildBuild Haps(s)/App(s)Build Hap(s)”完成应用的编译,生成hap包。
保持USB TypeC线连接情况下,我们可以通过手动执行命令行完成对已签名的hap应用的安装。
六、应用安装
保持USB TypeC线连接情况下,我们可以通过手动执行命令行完成对已签名应用的安装。
我们可以在SDK的toolchains中找到HDC鸿蒙设备连接器的“hdc_std”工具,也可以在Gitee上developtools_hdc_standard仓的prebuilt目录获取最新编译的hdc_std。
下载链接
https://gitee.com/openharmony/developtools_hdc_standard/tree/master/prebuilt
通过“hdc_std”工具,开发者可完成应用的发送、安装、卸载和log抓取等常用功能,这里我们为大家罗列了一些具体常用命令:
当应用正常完成安装操作后,屏幕上会显示应用图标,此时开发者就可以运行自己的应用啦。
至此我们已经完成了Hi3516DV300 OpenHarmony L2 应用开发调试环境的搭建,以上教程旨在帮助开发者学习如何快速搭建OpenHarmony L2 应用开发调试环境,更多脑洞大开的业务场景,等待开发者们一一探索。欢迎更多开发者们加入我们,基于Hi3516DV300开发有趣的作品,说不定下一次我们分享的就是你的作品哦~