第3章鴻蒙 hi3681 開(kāi)發(fā)板入門(mén) 代碼路徑、啟動(dòng)流程分析
想了解更多內(nèi)容，請(qǐng)?jiān)L問(wèn)：
51CTO和華為官方合作共建的鴻蒙技術(shù)社區(qū)
https://harmonyos.51cto.com/#zz
第3章 Hi3681開(kāi)發(fā)
目錄：
3.1 編寫(xiě)一個(gè)簡(jiǎn)單的hello world程序
3.2 Hi3861相關(guān)代碼結(jié)構(gòu)
3.2 Hi3861啟動(dòng)流程
3.1 編寫(xiě)一個(gè)簡(jiǎn)單的hello world程序
編寫(xiě)一個(gè)hello world程序比較簡(jiǎn)單，可以參考官網(wǎng)：
https://device.harmonyos.com/cn/docs/start/introduce/oem_wifi_start-0000001050168544
本文在這里做下總結(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
(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 "ohos_init.h"
- #include "ohos_types.h"
- void HelloWorld(void)
- {
- printf("[DEMO] Hello world.\n");
- }
- SYS_RUN(HelloWorld);
(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 = [
- "//utils/native/liteos/include"
- ]
- }
static_library中指定業(yè)務(wù)模塊的編譯結(jié)果，為靜態(tài)庫(kù)文件libmyapp.a，開(kāi)發(fā)者根據(jù)實(shí)際情況完成填寫(xiě)。
sources中指定靜態(tài)庫(kù).a所依賴(lài)的.c文件及其路徑，若路徑中包含"//"則表示絕對(duì)路徑(此處為代碼根路徑)，若不包含"//"則表示相對(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("//build/lite/config/component/lite_component.gni")
- lite_component("app") {
- features = [
- "my_first_app:myapp",
- ]
- }
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")。
3.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)配置文件
build\lite\platform\hi3861v100_liteos_riscv\platform.json
該文件描述了hi3681平臺(tái)相關(guān)的代碼路徑，例如application、startup等。
這里我列舉出來(lái)幾個(gè)比較重要的：
子系統(tǒng)：applications ：
路徑：applications/sample/wifi-iot/app
作用：這個(gè)路徑下存放了hi3681編寫(xiě)的應(yīng)用程序代碼，例如我們剛剛寫(xiě)得hello world 代碼就放在這個(gè)路徑下。
子系統(tǒng)：iot_hardware ：
路徑：base/iot_hardware/frameworks/wifiiot_lite
作用：存放了 hi3681 芯片相關(guān)的驅(qū)動(dòng)、例如spi、gpio、uart等。
子系統(tǒng)：vendor
路徑：vendor/hisi/hi3861/hi3861
作用：存放了 hi3681 相關(guān)的廠(chǎng)商SDK之類(lèi)的文件。其中最重要的是
vendor\hisi\hi3861\hi3861\app\wifiiot_app\init\app_io_init.c
vendor\hisi\hi3861\hi3861\app\wifiiot_app\src\app_main.c
其中，app_io_init.c 是hi3681內(nèi)核啟動(dòng)后的io口相關(guān)設(shè)置，用戶(hù)需根據(jù)應(yīng)用場(chǎng)景，合理選擇各外設(shè)的IO復(fù)用配置。
app_main.c 是內(nèi)核啟動(dòng)進(jìn)入的應(yīng)用程序入口。
3.2 Hi3861啟動(dòng)流程
由于hi3681的liteos-m被芯片rom化了，固化在芯片內(nèi)部了。所以我們主要看內(nèi)核啟動(dòng)后的第一個(gè)入口函數(shù)。
代碼路徑：
vendor\hisi\hi3861\hi3861\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);
- hi_flash_partition_table *ptable = HI_NULL;
- peripheral_init();
- …..中間省略代碼
- HOS_SystemInit();
- }
app_main一開(kāi)始打印了 SDK版本號(hào)，最后一行會(huì)調(diào)用HOS_SystemInit(); 函數(shù)進(jìn)行鴻蒙系統(tǒng)的初始化。我們進(jìn)去看下初始化做了哪些動(dòng)作。
路徑：base/startup/services/bootstrap_lite/source/system_init.c
- void HOS_SystemInit(void)
- {
- MODULE_INIT(bsp);
- MODULE_INIT(device);
- MODULE_INIT(core);
- SYS_INIT(service);
- SYS_INIT(feature);
- MODULE_INIT(run);
- SAMGR_Bootstrap();
- }
我們可以看到主要是初始化了 一些相關(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);
也就是說(shuō)所有用SYS_RUN() 宏設(shè)置的函數(shù)都會(huì)在使用MODULE_INIT(run); 的時(shí)候被調(diào)用。
為了驗(yàn)證這一點(diǎn)，我們可以加一些打印信息，如下：
我們重新編譯后燒錄。打開(kāi)串口查看打印信息，如下：
可以看到在35行之后，就打印 hello world的信息。符合預(yù)期。
想了解更多內(nèi)容，請(qǐng)?jiān)L問(wèn)：
51CTO和華為官方合作共建的鴻蒙技術(shù)社區(qū)
https://harmonyos.51cto.com/#zz
