淺述OpenHarmony HDF 配置管理分析及使用

HDF配置管理概述

• 在弱性能環(huán)境中，轉(zhuǎn)換為配置樹(shù)源碼，驅(qū)動(dòng)可直接調(diào)用 C 代碼獲取配置。

• 在高性能環(huán)境中，轉(zhuǎn)換為 HCB(HDF Configuration Binary)二進(jìn)制文件，驅(qū)動(dòng)可使用 HDF 框架提供的配置解析接口獲取配置。

以下是使用 HCB 模式的典型應(yīng)用場(chǎng)景：

圖2 HCS的架構(gòu)圖

HCS源碼語(yǔ)法

• 屬性

  屬性即最小的配置單元，是一個(gè)獨(dú)立的配置項(xiàng)。語(yǔ)法如下：

attribute_name = value;

• 數(shù)字常量，支持二進(jìn)制、八進(jìn)制、十進(jìn)制、十六進(jìn)制數(shù)，具體參考數(shù)據(jù)類(lèi)型節(jié)。

• 字符串，內(nèi)容使用雙引號(hào)("")引用。

• 節(jié)點(diǎn)引用。

• attribute 必須以分號(hào)(;)結(jié)束且必須屬于一個(gè) node。

• 節(jié)點(diǎn)

節(jié)點(diǎn)是一組屬性的集合，語(yǔ)法如下：

1.  node_name {2.        module = "sample";3.        ...4.}

• node_name 是字母、數(shù)字、下劃線的組合且必須以字母或下劃線開(kāi)頭，字母區(qū)分大小寫(xiě)。

• 大括號(hào)后無(wú)需添加結(jié)束符“;”。

• root為保留關(guān)鍵字，用于聲明配置表的根節(jié)點(diǎn)。每個(gè)配置表必須以 root 節(jié)點(diǎn)開(kāi)始。

• root 節(jié)點(diǎn)中必須包含 module 屬性，其值應(yīng)該為一個(gè)字符串，用于表征該配置所屬模塊。

• 節(jié)點(diǎn)中可以增加 match_attr 屬性，其值為一個(gè)全局唯一的字符串。在解析配置時(shí)可以調(diào)用查找接口以該屬性的值查找到包含該屬性的節(jié)點(diǎn)。

• 整型

整型長(zhǎng)度自動(dòng)推斷，根據(jù)實(shí)際數(shù)據(jù)長(zhǎng)度給與最小空間占用的類(lèi)型。

• 二進(jìn)制，0b 前綴，示例：0b1010。

• 八進(jìn)制，0 前綴，示例：0664。

• 十進(jìn)制 ，無(wú)前綴，且支持有符號(hào)與無(wú)符號(hào)，示例：1024，+1024 均合法。負(fù)值在讀取時(shí)注意使用有符號(hào)數(shù)讀取接口。

• 十六進(jìn)制，0x 前綴，示例：0xff00、0xFF。

• 字符串

字符串使用雙引號(hào)("")表示。

• 數(shù)組

attr_foo = [0x01, 0x02, 0x03, 0x04];attr_bar=["hello","world"];

• bool類(lèi)型

1.  // comment

2.  /*3.  comment4.*/

root {    module = "sample";    template foo {        attr_1 = 0x1;        attr_2 = 0x2;    }    bar :: foo {    }    bar_1 :: foo {        attr_1 = 0x2;    }}

root {    module = "sample";    bar {        attr_1 = 0x1;        attr_2 = 0x2;    }    bar_1 {        attr_1 = 0x2;        attr_2 = 0x2;    }}

node :& source_node

root {    module = "sample";    foo {        foo_ :& root.bar{            attr = "foo";        }        foo1 :& foo2 {            attr = 0x2;        }        foo2 {            attr = 0x1;        }    }
    bar {        attr = "bar";    }}

root {    module = "sample";    foo {        foo2 {            attr = 0x2;        }    }    bar {        attr = "foo";    }}

node : source_node

root {    module = "sample";    foo {        attr_0 = 0x0;    }    bar:foo {        attr_1 = 0x1;    }}

root {    module = "sample";    foo {        attr_0 = 0x0;    }    bar {        attr_1 = 0x1;        attr_0 = 0x0;    }}

1.  #include "sample1.hcs"2.  root {3.      attr_2 = delete;4.      foo_2 : delete {5.      }6.}

1.  attribute = &node；

root {    module = "sample";    gpio = [1, 2];}

HC-GEN使用介紹

cd drivers/framework/tools/hc-genmake
./build/hc-gen –v>Hcscompiler0.7

hc-gen -o [OutputHcbFileName] -b [SourceHcsFileName]

hc-gen -o [OutputHcsFileName] -d [SourceHcbFileName]

HCS文件編譯過(guò)程

HC_GEN_DIR := $(abspath $(SOURCE_ROOT)/drivers/framework/tools/hc-gen)HC_GEN := $(HC_GEN_DIR)/build/hc-genLOCAL_HCS_ROOT := $(abspath $(dir $(realpath $(lastword $(MAKEFILE_LIST)))))
# LOCAL_HCS_ROOT為根據(jù)目標(biāo)平臺(tái)和產(chǎn)品拼接出的HCS路徑HCS_DIR := $(LOCAL_HCS_ROOT)HCB_FLAGS := -b -i -a
HCS_OBJ := hdf_hcs_hex.oHCS_OBJ_SRC := $(subst .o,.c,$(notdir $(HCS_OBJ)))
CONFIG_GEN_HEX_SRC := $(addprefix $(LOCAL_HCS_ROOT)/, $(HCS_OBJ_SRC))CONFIG_HCS_SRC := $(subst _hcs_hex.o,.hcs,$(addprefix $(HCS_DIR)/, $(HCS_OBJ)))
# 使用自定義的.o生成規(guī)則覆蓋KBbuild默認(rèn)規(guī)則$(obj)/$(HCS_OBJ): $(CONFIG_GEN_HEX_SRC)         $(Q)$(CC) $(c_flags) -c -o $@ $<        $(Q)rm -f $<
# 將HCB文件生成后再轉(zhuǎn)換為.c文件中的hex數(shù)組，依賴(lài)目標(biāo)為hc-gen工具$(CONFIG_GEN_HEX_SRC):  $(LOCAL_HCS_ROOT)/%_hcs_hex.c: $(HCS_DIR)/%.hcs | $(HC_GEN)        $(Q)echo gen hdf built-in config        $(Q)if [ ! -d $(dir $@) ]; then mkdir -p $(dir $@); fi        $(Q)$(HC_GEN) $(HCB_FLAGS) -o $(subst _hex.c,,$(@)) $<
# 生成hc-gen工具$(HC_GEN):         $(Q)make -C $(HC_GEN_DIR)
obj-$(CONFIG_DRIVERS_HDF)+=$(HCS_OBJ)

HCS配置使用

HCS配置讀取接口

device_uart :: device {    device0 :: deviceNode {        policy = 1;        priority = 40;        permission = 0644;        moduleName = "HDF_PLATFORM_UART";        serviceName = "HDF_PLATFORM_UART_0";        deviceMatchAttr = "hisilicon_hi35xx_uart_0";    }}

root {    platform {        uart_config {            device_uart_0x0000  {                serviceName = "";                match_attr = "hisilicon_hi35xx_uart_0";                driver_name = "ttyAMA";                num = 0;            }        }    }}

static int32_t HdfUartInit(struct HdfDeviceObject *obj){    int32_t ret;    struct DeviceResourceIface *iface = NULL;    …    devResourceIface = DeviceResourceGetIfaceInstance(HDF_CONFIG_SOURCE);    if (devResourceIface == NULL) {        HDF_LOGE("%s: face is invalid", __func__);        return HDF_FAILURE;    }
    devResourceIface->GetUint32(obj->property, "num", &host->num, 0);devResourceIface->GetString(obj->property, "driver_name", &drName, "ttyAMA")；……       ret = memcpy_s(g_driverName, UART_NAME_LEN - 1, drName, strlen(drName));    if (ret != EOK) {        return HDF_FAILURE;    }    host->method = &g_uartHostMethod;    return HDF_SUCCESS;}

總結(jié)

編輯：jq