OpenHarmony设备开发基于IDE开发 小型系统(基于Hi3861开发板)
编写“Hello World”程序
下方将展示如何在单板上运行第一个应用程序,其中包括新建应用程序、编译、烧写、运行等步骤,最终输出“Hello World!”。
前提条件
已参考创建工程并获取源码,创建Hi3516开发板的源码工程。
示例目录
示例完整目录如下:
applications/sample/hello
│── BUILD.gn
└── src
└── helloworld.c
开发步骤
请在源码目录中通过以下步骤创建“Hello World”应用程序。
- 新建目录及源码。
新建applications/sample/hello/src/helloworld.c目录及文件,代码如下所示,用户可以自定义修改打印内容(例如:修改OHOS为World)。当前应用程序可支持标准C及C++的代码开发。
#include <stdio.h>
int main(int argc, char **argv)
{
printf("\n\n");
printf("\n\t\tHello OHOS!\n");
printf("\n\n\n");
return 0;
}
- 新建编译组织文件。
import("//build/lite/config/component/lite_component.gni")
lite_component("hello-OHOS") {
features = [ ":helloworld" ]
}
executable("helloworld") {
output_name = "helloworld"
sources = [ "src/helloworld.c" ]
}
- 添加新组件。
修改文件build/lite/components/applications.json,添加组件hello_world_app的配置,如下所示为applications.json文件片段,"##start##“和”##end##“之间为新增配置(”##start##“和”##end##"仅用来标识位置,添加完配置后删除这两行):
说明: 本章节操作是以OpenHarmony-v3.1-Release版本为例进行操作的,该版本中,组件配置文件为build/lite/components/applications.json;若源码版本大于等于OpenHarmony 3.2 Beta2时,组件配置文件为build/lite/components/communication.json。
{
"components": [
{
"component": "camera_sample_communication",
"description": "Communication related samples.",
"optional": "true",
"dirs": [
"applications/sample/camera/communication"
],
"targets": [
"//applications/sample/camera/communication:sample"
],
"rom": "",
"ram": "",
"output": [],
"adapted_kernel": [ "liteos_a" ],
"features": [],
"deps": {
"components": [],
"third_party": []
}
},
##start##
{
"component": "hello_world_app",
"description": "hello world samples.",
"optional": "true",
"dirs": [
"applications/sample/hello"
],
"targets": [
"//applications/sample/hello:hello-OHOS"
],
"rom": "",
"ram": "",
"output": [],
"adapted_kernel": [ "liteos_a" ],
"features": [],
"deps": {
"components": [],
"third_party": []
}
},
##end##
{
"component": "camera_sample_app",
"description": "Camera related samples.",
"optional": "true",
"dirs": [
"applications/sample/camera/launcher",
"applications/sample/camera/cameraApp",
"applications/sample/camera/setting",
"applications/sample/camera/gallery",
"applications/sample/camera/media"
],
4.修改单板配置文件。
修改文件vendor/hisilicon/hispark_taurus/config.json,新增hello_world_app组件的条目,如下所示代码片段为applications子系统配置,"##start##“和”##end##“之间为新增条目(”##start##“和”##end##"仅用来标识位置,添加完配置后删除这两行):
{
"subsystem": "applications",
"components": [
{ "component": "camera_sample_app", "features":[] },
{ "component": "camera_sample_ai", "features":[] },
##start##
{ "component": "hello_world_app", "features":[] },
##end##
{ "component": "camera_screensaver_app", "features":[] }
]
},
编译
DevEco Device Tool支持Hi3516DV300开发板的源码一键编译功能,提供编译工具链和编译环境依赖的检测及一键安装,简化复杂编译环境的同时,提升了编译的效率。
说明: Hi3516DV300编译环境为Ubuntu环境。
- 在菜单栏中点击Project Settings,进入Hi3516DV300工程配置界面。
- 在“Tool Chain”页签中,DevEco Device Tool会自动检测依赖的编译工具链是否完备,如果提示部分工具缺失,可单击Install,自动安装所需工具链
3.安装Hi3516DV300相关工具链,部分工具安装需要使用root权限,请在“TERMINAL”窗口输入用户密码进行安装。
说明:如果出现安装pip组件失败,可参考修改Python源的方法进行修改,完成尝试重新安装。
- 若出现安装apt组件失败,可参考修改apt源的方法进行修改,完成后尝试重新安装。
工具链自动安装完成后如下图所示。
4.在ipcamera_hispark_taurus配置页签中,设置源码的编译类型build_type,默认为“debug”类型,请根据需要进行修改。
5.在“PROJECT TASKS”中,单击对应开发板下的Build,执行编译。
6.等待编译完成,在TERMINAL窗口输出“SUCCESS”,编译完成
编译完成后,可以在工程的out目录下,查看编译生成的文件,用于后续的Hi3516DV300开发板烧录。
烧录
烧录是指将编译后的程序文件下载到芯片开发板上的动作,为后续的程序调试提供基础。DevEco Device Tool提供一键烧录功能,操作简单,能快捷、高效的完成程序烧录,提升烧录的效率。
Hi3516DV300的镜像烧录通过Windows环境进行烧录,开发者启动烧录操作后,DevEco Device Tool通过Remote远程模式,将Ubuntu环境下编译生成的待烧录程序文件拷贝至Windows目录下,然后通过Windows的烧录工具将程序文件烧录至开发板中。
Hi3516DV300开发板小型系统的烧录方式包括USB烧录、网口烧录两种方式,本文采用USB方式进行烧录。
前提条件
- 代码已编译完成。
- 请安装Hi3516DV300开发板串口驱动程序,请参考Hi3516DV300开发板串口驱动安装指导。
- 请安装Hi3516DV300开发板USB驱动程序,请参考Hi3516DV300开发板USB驱动安装
操作步骤
- 请连接好电脑和待烧录开发板,需要连接USB口和串口,具体可参考Hi3516DV300开发板介绍。
- 在DevEco Device Tool中,选择REMOTE DEVELOPMENT > Local PC,查看远程计算机(Ubuntu开发环境)与本地计算机(Windows开发环境)的连接状态。
● 如果Local PC右边连接按钮为
,则远程计算机与本地计算机为已连接状态,不需要执行其他操作。
● 如果Local PC右边连接按钮为
,则点击绿色按钮进行连接。连接时DevEco Device Tool会重启服务,因此请不要在下载源码或源码编译过程中进行连接,否则会中断任务。
- 在菜单栏中点击Project Settings按钮,进入Hi3516DV300工程配置界面。
4.在“Tool Chain”页签,设置Uploader烧录器工具,可以通过Tool Chain页签中的Install按钮在线安装。
5.在“hi3516dv300”页签,设置烧录选项,包括upload_partitions、upload_port和upload_protocol。配置完成后工程将自动保存。
● upload_partitions:选择待烧录的文件,默认情况下会同时烧录fastboot、kernel、rootfs和userfs。DevEco Device Tool已预置默认的烧录文件信息,包括起始地址、分区大小、待烧录文件地址等,开发者可根据实际情况进行调整,点击每个待烧录文件后的
说明: 在设置烧录分区起始地址和分区长度时,应根据实际待烧录文件的大小进行设置,要求设置的烧录分区大小,要大于待烧录文件的大小;同时,各烧录文件的分区地址设置不能出现重叠。
- upload_protocol:选择烧录协议,固定选择“hiburn-usb”。
- upload_port:选择已查询到的串口号。
6.点击hi3516dv300下的Upload按钮。
此时待烧录文件会从Ubuntu系统传输到Windows下,传输完成后界面显示“Operation paused, Please press Enter key to continue”时,请点击Enter键启动烧录。
7.在终端窗口显示如下提示信息时,请在15秒内,按住Update键,插拔USB线,最后松开Update键启动烧录。
启动烧录后,界面提示SUCCESS信息时,表示烧录成功。
8.烧录成功后,请根据运行章节进行操作,启动系统。
运行
启动系统
在完成Hi3516DV300的烧录后,还需要设置BootLoader引导程序,才能运行OpenHarmony系统。
- 在Hi3516DV300任务中,单击Configure bootloader(Boot OS)进行配置即可。
说明: DevEco Device Tool针对Hi3516DV300开发板的BootLoader设置进行了适配,无需开发者手动修改。
2.提示如下图中的重启开发板的提示信息时,重启开发板,然后在控制台输出“SUCCESS”表示设置成功。
3.在任务栏单击Monitor按钮,启动串口工具。
4.当界面打印回显信息,单击Enter按钮,直到界面显示OHOS #信息,表示系统启动成功。
运行“Hello World”
系统启动成功后,通过以下步骤运行“Hello World”。
- 在启动界面进入bin目录。
cd bin
2.进入bin目录后可以看到helloworld文件,通过以下命令运行helloworld程序。
./helloworld
界面打印“Hello World!”,程序运行成功。