HDF配置管理概述

• 在弱性能環境中，轉換為配置樹源碼，驅動可直接調用 C 代碼獲取配置。

• 在高性能環境中，轉換為 HCB(HDF Configuration Binary)二進制文件，驅動可使用 HDF 框架提供的配置解析接口獲取配置。

以下是使用 HCB 模式的典型應用場景：

圖2 HCS的架構圖

HCS源碼語法

• 屬性

  屬性即最小的配置單元，是一個獨立的配置項。語法如下：

attribute_name = value;

• 數字常量，支持二進制、八進制、十進制、十六進制數，具體參考數據類型節。

• 字符串，內容使用雙引號("")引用。

• 節點引用。

• attribute 必須以分號(;)結束且必須屬于一個 node。

• 節點

節點是一組屬性的集合，語法如下：

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

• node_name 是字母、數字、下劃線的組合且必須以字母或下劃線開頭，字母區分大小寫。

• 大括號后無需添加結束符“;”。

• root為保留關鍵字，用于聲明配置表的根節點。每個配置表必須以 root 節點開始。

• root 節點中必須包含 module 屬性，其值應該為一個字符串，用于表征該配置所屬模塊。

• 節點中可以增加 match_attr 屬性，其值為一個全局唯一的字符串。在解析配置時可以調用查找接口以該屬性的值查找到包含該屬性的節點。

• 整型

整型長度自動推斷，根據實際數據長度給與最小空間占用的類型。

• 二進制，0b 前綴，示例：0b1010。

• 八進制，0 前綴，示例：0664。

• 十進制 ，無前綴，且支持有符號與無符號，示例：1024，+1024 均合法。負值在讀取時注意使用有符號數讀取接口。

• 十六進制，0x 前綴，示例：0xff00、0xFF。

• 字符串

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

• 數組

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

• bool類型

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，可以直接使用 node 名稱，否則被引用的節點必須使用絕對路徑，節點間使用“.”分隔，root 表示根節點，格式為 root 開始的節點路徑序列，例如 root.foo.bar 即為一個合法的絕對路徑。
• 如果出現修改沖突（即多處修改同一個屬性），編譯器將提示 warning，因為這種情況下只會生效某一個修改而導致最終結果不確定。

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；

HCB二進制格式

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文件編譯過程

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為根據目標平臺和產品拼接出的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生成規則覆蓋KBbuild默認規則$(obj)/$(HCS_OBJ): $(CONFIG_GEN_HEX_SRC)         $(Q)$(CC) $(c_flags) -c -o $@ $<        $(Q)rm -f $<
# 將HCB文件生成后再轉換為.c文件中的hex數組，依賴目標為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;}

總結

編輯：jq