第二章 快速入门

一、OpenHarmony快速入门：Hello World

1. 添加Hello World源码文件

1.1 新增my_app文件夹

在./applications/BearPi/BearPi-HM_Nano/sample路径下新建一个my_app目录，用于存放业务源码文件。

1.2 新增hello_world.c文件

在./applications/BearPi/BearPi-HM_Nano/sample/my_app路径下新建一个hello_world.c文件，该文件为业务源码文件。

1.3 新增BUILD.gn文件

在./applications/BearPi/BearPi-HM_Nano/sample/my_app路径下新建一个BUILD.gn文件，该文件为业务源码编译脚本。

2. 编写Hello World业务代码

添加HelloWorld代码

• 在hello_world.c中新建业务入口函数HelloWorld，并实现业务逻辑。并在代码最下方，使用HarmonyOS
• 启动恢复模块接口APP_FEATURE_INIT()启动业务。（APP_FEATURE_INIT定义在ohos_init.h文件中）

#include <stdio.h>
#include "ohos_init.h"
void Hello_World(void)
{
	printf("Hello World!\r\n");
}
APP_FEATURE_INIT(Hello_World);

3. 编写编译构建文件BUILD.gn

编写用于将业务构建成静态库的BUILD.gn文件
在./applications/BearPi/BearPi-HM/sample/my_app下的BUILD.gn文件中添加如下代码。

static_library("myapp") {
	sources = [
		"hello_world.c"
	]
	include_dirs = [
		"//utils/native/lite/include"
	]
}

• static_library中指定业务模块的编译结果，为静态库文件libmyapp.a，开发者根据实际情况完成填写。
• sources中指定静态库.a所依赖的.c文件及其路径，若路径中包含"//“则表示绝对路径（此处为代码根路径），若不包含”//"则表示相对路径。
• include_dirs中指定source所需要依赖的.h文件路径。

编写模块BUILD.gn文件，指定需参与构建的特性模块。
在./applications/BearPi/BearPi-HM/sample下的BUILD.gn文件中添加如下代码。

import("//build/lite/config/component/lite_component.gni")

lite_component("app") {
	features = [
		"my_app:myapp",
	]
}

• my_app是相对路径，指向./applications/BearPi/BearPi-HM/sample/my_app/BUILD.gn。
• myapp是目标，指向./applications/BearPi/BearPi-HM/sample/my_app/BUILD.gn中的static_library(“myapp”)。

4. 调试Hello World程序

1. 在Visual Studio Code底部，点击“串口”按钮图标。
2. 输入端口号，其他参数保持默认配置。
3. 按下开发板RESET按键，即可输出日志信息。
   

二、OpenHarmony快速入门：点亮LED灯

1. 添加点亮LED灯源码文件

1.1 新增my_led文件夹

在./applications/BearPi/BearPi-HM_Nano/sample路径下新建一个my_led目录，用于存放业务源码文件。

1.2 新增led_example.c文件

在./applications/BearPi/BearPi-HM_Nano/sample/my_led路径下新建一个led_example.c文件，该文件为业务源码文件。

1.3 新增BUILD.gn文件

在./applications/BearPi/BearPi-HM_Nano/sample/my_led路径下新建一个BUILD.gn文件，该文件为业务源码编译脚本。

2. 编写点亮LED灯业务代码

#include <stdio.h>
#include <unistd.h>
#include "ohos_init.h"
#include "wifiiot_gpio.h"
#include "wifiiot_gpio_ex.h"
void Led_Sample(void)
{
	GpioInit(); //初始化GPIO
	IoSetFunc(WIFI_IOT_IO_NAME_GPIO_2, WIFI_IOT_IO_FUNC_GPIO_2_GPIO);//设置GPIO_2的复用功能为普通GPIO
	GpioSetDir(WIFI_IOT_IO_NAME_GPIO_2, WIFI_IOT_GPIO_DIR_OUT);//设置GPIO_2为输出模式
	GpioSetOutputVal(WIFI_IOT_IO_NAME_GPIO_2,1);//设置GPIO_2输出高电平点亮LED灯
}
APP_FEATURE_INIT(Led_Sample);

3. 编写编译构建文件BUILD.gn

编写用于将业务构建成静态库的BUILD.gn文件
在./applications/BearPi/BearPi-HM_Nano/sample/my_led下的BUILD.gn文件中添加如下代码。

static_library("myled") {
	sources = [
		"led_example.c"
	]
	include_dirs = [
		"//utils/native/lite/include",
		"//base/iot_hardware/interfaces/kits/wifiiot_lite"
	]
}

• static_library中指定业务模块的编译结果，为静态库文件libmyled.a，开发者根据实际情况完成填写。
• sources中指定静态库.a所依赖的.c文件及其路径，若路径中包含"//“则表示绝对路径（此处为代码根路径），若不包含”//"则表示相对路径。
• include_dirs中指定source所需要依赖的.h文件路径。

编写模块BUILD.gn文件，指定需参与构建的特性模块。
在./applications/BearPi/BearPi-HM_Nano/sample下的BUILD.gn文件中添加如下代码。

import("//build/lite/config/component/lite_component.gni")

lite_component("app") {
	features = [
		"my_led:myled",
	]
}

• my_led是相对路径，指向./applications/BearPi/BearPi-HM_Nano/sample/my_led/BUILD.gn。
• led是目标，指向./applications/BearPi/BearPi-HM_Nano/sample/my_led/BUILD.gn中的static_library(“myled”)。

4. 调试LED灯程序

添加LED灯闪烁源码

#include "ohos_init.h"
#include "unistd.h"
#include "wifiiot_gpio.h"
#include "wifiiot_gpio_ex.h"
void led_example(void)
{
	GpioInit();
	IoSetFunc(WIFI_IOT_IO_NAME_GPIO_2,WIFI_IOT_IO_FUNC_GPIO_2_GPIO);
	GpioSetDir(WIFI_IOT_IO_NAME_GPIO_2,WIFI_IOT_GPIO_DIR_OUT);
	for(int i = 0; i < 10; i++)
	{
		GpioSetOutputVal(WIFI_IOT_IO_NAME_GPIO_2,1);
		usleep(1000000);
		GpioSetOutputVal(WIFI_IOT_IO_NAME_GPIO_2,0);
		usleep(1000000);
	}
	GpioSetOutputVal(WIFI_IOT_IO_NAME_GPIO_2,1);
}
APP_FEATURE_INIT(led_example);

三、OpenHarmony编译构建介绍

1. Ninja编译工具简介

什么是Ninja
在Unix/Linux下通常使用Makefile来控制代码的编译，但是Makefile对于比较大的项目有时候会比较慢，代码在编译都变成了程序员放松的借口了。
这个Google的程序员在开发Chrome的时候因为忍受不了Makefile的速度，自己重新开发出来一套新的控制编译的工具叫作Ninja。
Ninja相对于Makefile这套工具更注重于编译速度。
除了Chrome现在还有一些其他的比较大的项目也在开始使用Ninja。

2. 如何编译模块

模块gn文件

业务gn文件

Json文件

3. 代码如何执行的

初始化入口

注册入口

四、OpenHarmony CMSIS接口简介

1. CMSIS接口简介

什么是CMSIS接口
CMSIS是Cortex微控制器软件接口标准（Cortex Microcontroller Software Interface Standard）是ARM和一些编译器厂家以及半导体厂家共同遵循的一套标准，是由ARM专门针对Cortex-M系列提出的标准。在该标准的约定下，ARM和芯片厂商会提供一些通用的API接口来访问Cortex内核以及一些专用外设，以减少更换芯片以及开发工具等移植工作所带来的金钱以及时间上的消耗。

2. 鸿蒙与CMSIS接口联系

鸿蒙在CMSIS-RTOS2接口中封装了LiteOS-m的内核代码
CMSIS-RTOS2实现://kernel/liteos_m/kal/cmsis/cmsis_liteos2.c

3. 如何使用CMSIS接口

1、在业务代码中包含“cmsis_os2.h”
2、通过调用“cmsis_os2.h”中的API函数使用系统相关功能

更多API介绍请参考：https://arm-software.github.io/CMSIS_5/RTOS2/html/index.html