QCC---Host configure tools

参考文档：

80-CT781-1 Rev. AP
January 30, 2020
 

1、htf文件

configuration text file（htf）is a kind of file to configure the data，the character should be used in ASCII character.

2、htf文件格式转换

htf文件通过configCmd工具进行格式转换，通过编译log可以看到那些htf文件被放入database中。

3、htf文件解析

file=[]
[[].] =
....
....
[[].] =
can be one of bt, wlan, audio, system, app
 

can be from 1-15. The line file=[] indicates the default layer to
be used for any following declarations. For a given key, a setting for a higher layer number overrides a
setting for a lower layer number, that is the firmware will use the setting with the highest layer number
for the key.

For example, wlan2.dot11ShortRetryLimit = 135 overrides
                      wlan1.dot11ShortRetryLimit = 134.

3.1 comments 3.1.1 Line comments

started with hash(#) and the rest of the line would be ignored.

DeviceName = "BT device"    # this is BT name string.

3.1.2  block comments

started with and can span multiple lines,pls see example as below:

bt_addr = {0x005b3a, 0x01, 0x002b}

3.2 types

• Integer(uint8,uint16,uint32,uint64,int8,int16,int32,int64)
• String(octet string, quoted string)
• Boolean(true,false)
• Named type
• Arrays
• Structures

3.2.1 Integer

Integers are entered as decimal and hexadecimal,what's more,hexadecimal values should preceded by 0x, for instance 0x304D.

3.2.2 String

octet string：

An octet string is a series of single byte values.They are enterd as hex(without a preceding 0x) and surrounded with '[' and ']' ,for instance

[ 30 31 32]

Keys with a MAC adress format may be enterd as above, or alternatively as hex (without a preceding 0x) and separated with ':' or '-' ,such as

aa:bb:cc:dd:ee:ff 

or

aa-bb-cc-dd-ee-ff

quoted string：

a series of characters are surrounded by double quotes,for example

"123456"

They can also be entered as an octet string, for example 

[ 31 32 33 34 35 36]

3.2.3 Boolean

Boolean values can be entered by using true or false.

3.2.4 Name types

Some configuration data variables can be set by enumerated value name or the corresponding number.for example:

3.2.5 Arrays

An array is a series of values of a given type,an array is a list of comma-separated values,surronded by '{' and '}', for example the following arrays represents a list of uint8 values.

TEST_ARRAY = { 10, 20, 30}

3.2.6 Structures

A structure is a series of values,each of which may have different type.A structure is entered as a list of comma-separated values,surrounded by '{' and '}',pls see below example:

 STRUCTURE_TEST = { 20, 0x30, "TEST"}

3.3 Line continuation 

A configuration data can split across multiple lines using the line contiuation character ""，for example:

bt_addr = {0x005b3a,

                  0x01,

                  0x002b