OH輕量系統(tǒng)開(kāi)發(fā)—【4】編寫(xiě)第一個(gè)程序、啟動(dòng)流程分析

摘要：本文簡(jiǎn)單介紹如何編寫(xiě)第一個(gè)hello world程序，以及程序是被執(zhí)行的

適合群體：適用于Hi3861開(kāi)發(fā)板，啟動(dòng)流程分析

?

4.1編寫(xiě)第一個(gè)程序

編寫(xiě)一個(gè)hello world程序比較簡(jiǎn)單，可以參考官網(wǎng)：

https://gitee.com/openharmony/docs/blob/master/zh-cn/device-dev/quick-start/quickstart-lite-steps-hi3861-application-framework.md?

本文在這里做下總結(jié)：

?

（1）確定目錄結(jié)構(gòu)。

?

開(kāi)發(fā)者編寫(xiě)業(yè)務(wù)時(shí)，務(wù)必先在./applications/sample/wifi-iot/app路徑下新建一個(gè)目錄（或一套目錄結(jié)構(gòu)），用于存放業(yè)務(wù)源碼文件。

?

例如：在app下新增業(yè)務(wù)my_first_app，其中hello_world.c為業(yè)務(wù)代碼，BUILD.gn為編譯腳本，具體規(guī)劃目錄結(jié)構(gòu)如下：

.
└── applications
    └── sample
        └── wifi-iot
            └── app
                │── my_first_app
                │  │── hello_world.c
                │  └── BUILD.gn
                └── BUILD.gn

復(fù)制

?

（2）編寫(xiě)業(yè)務(wù)代碼。

?

在hello_world.c中新建業(yè)務(wù)入口函數(shù)HelloWorld，并實(shí)現(xiàn)業(yè)務(wù)邏輯。并在代碼最下方，使用 HarmonyOS啟動(dòng)恢復(fù)模塊接口SYS_RUN()啟動(dòng)業(yè)務(wù)。（SYS_RUN定義在ohos_init.h文件中）

#include 
#include "ohos_init.h"
#include "ohos_types.h"

void HelloWorld(void)
{
    printf("___________>>>>>>>>>>>>>>>>>>>> [DEMO] Hello world.\n");
}
SYS_RUN(HelloWorld);

復(fù)制

?

（3）編寫(xiě)用于將業(yè)務(wù)構(gòu)建成靜態(tài)庫(kù)的BUILD.gn文件。

?

如步驟1所述，BUILD.gn文件由三部分內(nèi)容（目標(biāo)、源文件、頭文件路徑）構(gòu)成，需由開(kāi)發(fā)者完成填寫(xiě)。以my_first_app為例，需要?jiǎng)?chuàng)建./applications/sample/wifi-iot/app/my_first_app/BUILD.gn，并完如下配置。

?

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

復(fù)制

?

static_library中指定業(yè)務(wù)模塊的編譯結(jié)果，為靜態(tài)庫(kù)文件libmyapp.a，開(kāi)發(fā)者根據(jù)實(shí)際情況完成填寫(xiě)。

?

sources中指定靜態(tài)庫(kù).a所依賴(lài)的.c文件及其路徑，若路徑中包含"http://"則表示絕對(duì)路徑（此處為代碼根路徑），若不包含"http://"則表示相對(duì)路徑。

?

include_dirs中指定source所需要依賴(lài)的.h文件路徑。

?

?

?

（4）編寫(xiě)模塊BUILD.gn文件，指定需參與構(gòu)建的特性模塊。

?

配置./applications/sample/wifi-iot/app/BUILD.gn文件，在features字段中增加索引，使目標(biāo)模塊參與編譯。features字段指定業(yè)務(wù)模塊的路徑和目標(biāo)，以my_first_app舉例，features字段配置如下。

?

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


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

}

復(fù)制

my_first_app是相對(duì)路徑，指向./applications/sample/wifi-iot/app/my_first_app/BUILD.gn。

?

myapp是目標(biāo)，指向./applications/sample/wifi-iot/app/my_first_app/BUILD.gn中的static_library("myapp")。

?

?

4.2 Hi3861相關(guān)代碼結(jié)構(gòu)

?

目前hi3861用的是liteos-m內(nèi)核，但是目前hi3681的liteos-m被芯片rom化了，固化在芯片內(nèi)部了。所以在harmonyOS代碼是找不到hi3861的內(nèi)核部分。

?

但是這樣不妨礙我們?nèi)ダ砬録i3861的其他代碼結(jié)構(gòu)。

?

hi3861平臺(tái)配置文件位于：

vendor\hisilicon\hispark_pegasus\config.json

可以看到該配置文件有很多內(nèi)容，

第一段這里指定了產(chǎn)品名稱(chēng)、版本、使用的內(nèi)核類(lèi)型

?

下面這里都是子系統(tǒng)：

其中我們重點(diǎn)關(guān)注這幾個(gè)模塊：

（1）applications：應(yīng)用子系統(tǒng)

路徑：applications/sample/wifi-iot/app?

?

作用：這個(gè)路徑下存放了hi3681編寫(xiě)的應(yīng)用程序代碼，例如我們剛剛寫(xiě)得hello world 代碼就放在這個(gè)路徑下。

?

（2）iot_hardware：硬件驅(qū)動(dòng)子系統(tǒng)

頭文件路徑： base\iot_hardware\peripheral\interfaces\kits

具體代碼路徑，由device\board\hisilicon\hispark_pegasus\liteos_m\config.gni文件中指定：

?

config.gni文件內(nèi)容較多，后續(xù)會(huì)一一解讀

作用：存放了 hi3681 芯片相關(guān)的驅(qū)動(dòng)、例如spi、gpio、uart等。

?

（3）xts：xts測(cè)試子系統(tǒng)。

這里我們先不要xts子系統(tǒng)，不然每次開(kāi)機(jī)后，系統(tǒng)都要跑xts認(rèn)證程序，影響我們后面測(cè)試，我們先注刪除，如下：

?

4.3 Hi3861啟動(dòng)流程

?

由于hi3681的liteos-m被芯片rom化了，固化在芯片內(nèi)部了。所以我們主要看內(nèi)核啟動(dòng)后的第一個(gè)入口函數(shù)。

?

代碼路徑：

?

device\soc\hisilicon\hi3861v100\sdk_liteos\app\wifiiot_app\src\app_main.c

?

hi_void app_main(hi_void)
{
#ifdef CONFIG_FACTORY_TEST_MODE
        printf("factory test mode!\r\n");
#endif

    const hi_char* sdk_ver = hi_get_sdk_version();
    printf("sdk ver:%s\r\n", sdk_ver);
    printf("_____>>>>>>> lza %s %d\r\n", __FILE__, __LINE__);
    hi_flash_partition_table *ptable = HI_NULL;

    peripheral_init();
    peripheral_init_no_sleep();

#ifndef CONFIG_FACTORY_TEST_MODE
    hi_lpc_register_wakeup_entry(peripheral_init);
#endif

    hi_u32 ret = hi_factory_nv_init(HI_FNV_DEFAULT_ADDR, HI_NV_DEFAULT_TOTAL_SIZE, HI_NV_DEFAULT_BLOCK_SIZE);
    if (ret != HI_ERR_SUCCESS) {
        printf("factory nv init fail\r\n");
    }

    /* partion table should init after factory nv init. */
    ret = hi_flash_partition_init();
    if (ret != HI_ERR_SUCCESS) {
        printf("flash partition table init fail:0x%x \r\n", ret);
    }
    ptable = hi_get_partition_table();

    ret = hi_nv_init(ptable->table[HI_FLASH_PARTITON_NORMAL_NV].addr, ptable->table[HI_FLASH_PARTITON_NORMAL_NV].size,
        HI_NV_DEFAULT_BLOCK_SIZE);
    if (ret != HI_ERR_SUCCESS) {
        printf("nv init fail\r\n");
    }

#ifndef CONFIG_FACTORY_TEST_MODE
    hi_upg_init();
#endif

    /* if not use file system, there is no need init it */
    hi_fs_init();

    (hi_void)hi_event_init(APP_INIT_EVENT_NUM, HI_NULL);
    hi_sal_init();
    /* 此處設(shè)為T(mén)RUE后中斷中看門(mén)狗復(fù)位會(huì)顯示復(fù)位時(shí)PC值，但有復(fù)位不完全風(fēng)險(xiǎn)，量產(chǎn)版本請(qǐng)務(wù)必設(shè)為FALSE */
    hi_syserr_watchdog_debug(HI_FALSE);
    /* 默認(rèn)記錄宕機(jī)信息到FLASH，根據(jù)應(yīng)用場(chǎng)景，可不記錄，避免頻繁異常宕機(jī)情況損耗FLASH壽命 */
    hi_syserr_record_crash_info(HI_TRUE);

    hi_lpc_init();
    hi_lpc_register_hw_handler(config_before_sleep, config_after_sleep);

#if defined(CONFIG_AT_COMMAND) || defined(CONFIG_FACTORY_TEST_MODE)
    ret = hi_at_init();
    if (ret == HI_ERR_SUCCESS) {
        hi_at_sys_cmd_register();
    }
#endif

    /* 如果不需要使用Histudio查看WIFI驅(qū)動(dòng)運(yùn)行日志等，無(wú)需初始化diag */
    /* if not use histudio for diagnostic, diag initialization is unnecessary */
    /* Shell and Diag use the same uart port, only one of them can be selected */
#ifndef CONFIG_FACTORY_TEST_MODE

#ifndef ENABLE_SHELL_DEBUG
#ifdef CONFIG_DIAG_SUPPORT
    (hi_void)hi_diag_init();
#endif
#else
    (hi_void)hi_shell_init();
#endif

    tcpip_init(NULL, NULL);
#endif

    ret = hi_wifi_init(APP_INIT_VAP_NUM, APP_INIT_USR_NUM);
    if (ret != HISI_OK) {
        printf("wifi init failed!\n");
    } else {
        printf("wifi init success!\n");
    }
    app_demo_task_release_mem(); /* 釋放系統(tǒng)棧內(nèi)存所使用任務(wù) */

#ifndef CONFIG_FACTORY_TEST_MODE
    app_demo_upg_init();
#ifdef CONFIG_HILINK
    ret = hilink_main();
    if (ret != HISI_OK) {
        printf("hilink init failed!\n");
    } else {
        printf("hilink init success!\n");
    }
#endif
#endif
    OHOS_Main();
}

復(fù)制

?

app_main一開(kāi)始打印了 SDK版本號(hào)，中間還會(huì)有一些初始化動(dòng)作，最后一行會(huì)調(diào)用OHOS_Main();?

該函數(shù)原型如下：

void OHOS_Main()
{
#if defined(CONFIG_AT_COMMAND) || defined(CONFIG_FACTORY_TEST_MODE)
    hi_u32 ret;
    ret = hi_at_init();
    if (ret == HI_ERR_SUCCESS) {
        hi_u32 ret2 = hi_at_register_cmd(G_OHOS_AT_FUNC_TBL, OHOS_AT_FUNC_NUM);
        if (ret2 != HI_ERR_SUCCESS) {
            printf("Register ohos failed!\n");
        }
    }
#endif
    OHOS_SystemInit();
}

復(fù)制

?

?

最后，OHOS_SystemInit函數(shù)進(jìn)行鴻蒙系統(tǒng)的初始化。我們進(jìn)去看下初始化做了哪些動(dòng)作。

?

路徑：base\startup\bootstrap_lite\services\source\system_init.c

void OHOS_SystemInit(void)
{

    MODULE_INIT(bsp);

    MODULE_INIT(device);

    MODULE_INIT(core);

    SYS_INIT(service);

    SYS_INIT(feature);

    MODULE_INIT(run);

    SAMGR_Bootstrap();

} 

復(fù)制

我們可以看到主要是初始化了 一些相關(guān)模塊、系統(tǒng)，包括有bsp、device（設(shè)備）。其中最終的是MODULE_INIT(run);

?

它負(fù)責(zé)調(diào)用了，所有run段的代碼，那么run段的代碼是哪些呢？

?

事實(shí)上就是我們前面application中使用SYS_RUN() 宏設(shè)置的函數(shù)名。

?

還記得我們前面寫(xiě)的hello world應(yīng)用程序嗎？

?

#include "ohos_init.h"
#include "ohos_types.h"

void HelloWorld(void)
{
    printf("[DEMO] Hello world.\n");
}

SYS_RUN(HelloWorld);

復(fù)制

?

也就是說(shuō)所有用SYS_RUN() 宏設(shè)置的函數(shù)都會(huì)在使用MODULE_INIT(run); 的時(shí)候被調(diào)用。

?

為了驗(yàn)證這一點(diǎn)，我們可以加一些打印信息，如下：

?

?

我們重新編譯后燒錄。打開(kāi)串口查看打印信息，如下：

?

可以看到在27行之后，就打印 hello world的信息。符合預(yù)期。

審核編輯：符乾江