跳转至

Hello Word

编译顺序

在正式开始程序编写之前,有必要先整体上了解程序的编译顺序。

Harmony的编译路径主要由vendor/xradio/xr806/config.json决定

  "product_name": "wifi_skylark",
  "ohos_version": "OpenHarmony 1.0.1",
  "device_company": "xradio",
  "board": "xr806",
  "kernel_type": "liteos_m",

其中"product_name"决定了执行hb set出现的选项,"device_company","board","kernel_type"共同决定了编译路径。

hb set选定wifi_skylark后,会在根目录中生成文件ohos_config.json,里面的内容大致如下:

{
 "root_path": "/home/workspace/Harmony_XR806",
 "board": "xr806",
 "kernel": "liteos_m",
 "product": "wifi_skylark",
 "product_path": "/home/workspace/Harmony_XR806/vendor/xradio/xr806",
 "device_path": "/home/workspace/Harmony_XR806/device/xradio/xr806/liteos_m"
}

在执行hb build -f后,HarmonyOS的编译脚本会从device_path中获取编译工具和编译选项,从product_path下寻找BUILD.gn文件。BUILD.gn文件内容如下:

build_ext_component("libSDK") {
  exec_path = rebase_path(".", root_build_dir)
  outdir = rebase_path("$root_out_dir")
  command = "./build.sh ${outdir}"
  deps = [
      "//kernel/liteos_m:kernel",       #(3)
      "os:liteos_glue",
      "adapter/hals:adapter",
      "adapter/console:app_console",
      "ohosdemo:ohosdemo",              #(2)
  ]
}

group("xr806") {
    deps = [
        ":libSDK"       #(1)
    ]
}

(1)deps关键字代表执行group("xr806")前需要先执行libSDK,也就是build_ext_component("libSDK")。

(2)执行build_ext_component("libSDK")前要求先寻找ohosdemo文件夹下的BUILD.gn,并且BUILD.gn里面会有ohosdemo的定义。

(3)“//”代表绝对路径,可以理解为根目录。//kernel/liteos_m代表根目录下的kernel/liteos_m文件夹。

打开ohosdemo/BUILD.gn

group("ohosdemo") {
    deps = [
        "hello_demo:app_hello",             #(1)
        #"iot_peripheral:app_peripheral",
        #"wlan_demo:app_WlanTest",
    ]
}

(1)“#”是gn文件的注释符号。

打开hello_demo/BUILD.gn

import("//device/xradio/xr806/liteos_m/config.gni")         #(1)

static_library("app_hello") {                               #(2)
   configs = []
   sources = [
      "src/main.c",                                         #(3)
   ]

   cflags = board_cflags                                    #(4)

   include_dirs = board_include_dirs                        #(5)
   include_dirs += [
      "//kernel/liteos_m/kernel/arch/include",              #(6)
   ]
}

(1).gni文件类似C语言的.h文件,用于定义一些模板

(2)static_library代表生成静态库(.a)文件,其中包含main.c的静态库必须是app_打头,如app_hello,否则虽然可以编译成功,但无法生效。

(3)需要编译的C文件,代表src文件夹下的main.c文件。

(4)gcc编译选项,其中board_cflags在//device/xradio/xr806/liteos_m/config.gni中定义。

(5)全局头文件,其中board_include_dirs在//device/xradio/xr806/liteos_m/config.gni中定义。

(6)除了board_include_dirs,额外需要添加的头文件。

代码

#include <stdio.h>
#include "ohos_init.h"                      //(2)                       
#include "kernel/os/os.h"

static OS_Thread_t g_main_thread;

static void MainThread(void *arg)
{
  while (1) {
​    printf("hello world!\n");
​    LOS_Msleep(1000);
  }
}

void HelloTestMain(void)
{
  printf("Wifi Test Start\n");
  if (OS_ThreadCreate(&g_main_thread, "MainThread", MainThread, NULL,
​        OS_THREAD_PRIO_APP, 4 * 1024) != OS_OK) {
​    printf("[ERR] Create MainThread Failed\n");
  }
}

SYS_RUN(HelloTestMain);                     //(1)

(1)Harmony启动时会调用所有SYS_RUN,上文中提到的应用库必须用“app_ ”打头就是因为SYS_RUN不会加入ld链接,所以使用"app_"标识,强制链接。

(2)必须添加ohos_init.h头文件,否则SYS_RUN失效。

演示

XR806_OpenHarmony串口默认配置为:波特率115200,无校验,8位数据位,1位停止位。

开发板成功连接PC上对串口调试助手后,按下开发板的复位按键,串口输出如下。

image-20211101110602933