4.3. isd_config.ini 配置文件说明
4.3.1. 各个配置段说明
段名 |
说明 |
---|---|
|
用于配置生成flash.bin前所需要的信息。 |
|
用于配置系统所需要的参数,该配置的所有选项都会进过转后然后存入flash.bin中。 |
|
用于配置相关工具信息。 |
|
用于配置芯片版本相关信息。 |
|
用于配置预留区域信息的区域,如果 |
|
用于配置预留区域信息的区域,与 |
4.3.2. 选项
默认值指的是,当选项不出现的时候的值。
有效值指的是,对应配置值接收指定的值。
4.3.2.1. [EXTRA_CFG_PARAM]
段选项说明
选项 |
类型 |
默认值 |
有效值 |
说明 |
---|---|---|---|---|
NEED_RESERVED_4K |
布尔 |
YES |
YES/NO |
预留部分空间用于保存SDK需要的配置,默认不修改,如需修改请联系杰理工程师 |
NEED_RESERVED_AREA |
布尔 |
YES |
YES/NO |
预留区域是否一定要配置BTIF区域的限制 |
NEW_FLASH_FS |
布尔 |
YES/NO |
是否使用新的文件系统(BR22),该配置与双备份配置互斥 |
|
BR22_TWS_DB |
布尔 |
YES/NO |
是否使用BR22双备份flash结构,该配置与单备份配置互斥(需要配合FLASH_SIZE、BR22_TWS_VERSION一起使用) |
|
BR22_TWS_VERSION |
立即数 |
双备份的版本号(一般配合BR22_TWS_DB一起使用) |
||
FLASH_SIZE |
立即数 |
指定当前FLASH的大小(一般配合BR22_TWS_DB一起使用) |
||
CHECK_OTA_BIN |
布尔 |
YES/NO |
可以指定 YES 或者 NO;如果不指定,则默认会在单备份(BR22_TWS_DB 表示双备份)情况下检查 ota.bin 并计算大小。如果是 NO 则不检查 ota.bin |
|
CHIP_NAME |
字符串 |
芯片名称 |
||
ENTRY |
立即数 |
SDK的入口地址 |
||
RESERVED_OPT |
立即数 |
0 |
预留区域是否需要提前预留 |
|
PID |
字符串 |
芯片的pid(少于等于16个byte的字符串) |
||
VID |
字符串 |
芯片的vid(少于等于4个byte的字符串) |
||
DOWNLOAD_MODEL |
字符串 |
USB/SERIAL |
下载模式,可选择USB下载或者串口下载(默认使用USB下载) |
|
COMPACT_SETTING |
布尔 |
NO |
YES/NO |
是否允许文件起始位置不按4K对齐 |
EXPAND_BIN |
布尔 |
NO |
YES/NO |
是否生成jl_isd_expand.bin。将jl_isd.bin扩展到方案实际占用flash的大小(jl_isd.bin后面追加0xFF)。 |
SDK_VERSION |
字符串 |
当前SDK的版本信息,此参数由编译脚本自动配置 |
||
SPECIAL_OPT |
立即数 |
0 |
FLASH格式,默认不修改,如需修改请联系杰理工程师 |
|
FORCE_4K_ALIGN |
布尔 |
YES/NO |
默认的FLASH BIN格式,默认不修改,如需修改请联系杰理工程师 |
|
UFW_ELEMENT |
格式 |
UFW文件中FLASH BIN的格式和顺序,默认不修改,如需修改请联系杰理工程师 |
||
AREA_ALIGN |
立即数 |
1/0x10 |
离线生成FLASH BIN的对齐方式,默认不修改,如需修改请联系杰理工程师 |
4.3.2.2. [SYS_CFG_PARAM]
段选项说明
该区域的配置是自定一配置,对应配置会转化后存入flash.bin中供固件使用。
目前已有配置:
配置 |
说明 |
---|---|
SPI=2_3_0_0 |
配置spi参数,等号右边的参数含义是 |
OSC=btosc |
使用的参数,指定系统始终源,一般注释掉 |
OSC_FREQ=12MHz |
使用的参数,指定FREQ频率,可填写12MHz或24MHz,一般注释掉 |
SYS_CLK=24MHz |
使用的参数,指定CLK频率,可填写24MHz或48MHz,一般注释掉 |
UTTX=PA05 |
串口tx |
UTBD=1000000 |
串口波特率 |
UTRX=PB01 |
串口升级,可填写PB00、PB05、PA05,一般注释掉 |
RESET=PB01_08_0 |
指定重启按键引脚和重启参数,等号右边的含义是 port口_长按时间_有效电平(长按时间有00、01、02、04、08、16六个值可选,单位为秒,当长按时间为00时,则关闭长按复位功能。) |
EX_FLASH=PB07_2A_PB11 |
用于isd_download.exe工具烧写外部flash时指定外部升级参数, |
EOFFSET=0 |
请勿随便修改,如需要修改请联系杰理工程师,注意:此功能需要UBOOT支持 |
AUTH_CODE=0 |
默认关闭, 如需开启请联系杰理工程师,根据SDK实际情况填写该值 |
POWERON_TIMES=0 |
芯片在烧写完毕后第一次上电时间,单位:ms,最长可配置60S,默认不填写,仅AC695X、AC635N、AC6083型号在2.27.2及以上版本支持, 如需开启请联系杰理工程师 |
4.3.2.3. [TOOL_CONFIG]
段选项说明
配置 |
说明 |
---|---|
1TO2_MIN_VER=2.24.0 |
允许加载当前配置生成的FW/UFW文件的一拖二烧写器最低版本是2.24.0,不能修改,如需修改请联系杰理工程师,根据SDK实际情况填写该值 |
1TO8_MIN_VER=3.0.34 |
允许加载当前配置生成的FW/UFW文件的一拖八烧写器最低版本是3.0.34,不能修改,如需修改请联系杰理工程师,根据SDK实际情况填写该值 |
BTBOX_MIN_VER=1.2.4.f |
允许加载当前配置生成的UFW文件的蓝牙测试盒最低版本是1.2.4.f,不能修改,如需修改请联系杰理工程师,根据SDK实际情况填写该值 |
4.3.2.4. [CHIP_VERSION]
段选项说明
配置 |
说明 |
---|---|
SUPPORTED_LIST=A,B,C |
允许当前配置生成的FW/UFW烧写到A、B、C版芯片中,不能修改,如需修改请联系杰理工程师 根据SDK实际情况填写该值 |
4.3.2.5. [RESERVED_CONFIG]
段选项说明
该区域用于配置预留区域,可单独存在,其中VM和PRCT这两个区域是特殊区域,VM是用于表示VM相关的信息,PRCT是用于表示保护区域的信息。
如果
[EXTRA_CFG_PARAM]
区域中有RESERVED_OPT
的配置,那么当前区域不能配置超过6项。VM、PROC和BIIF这三个配置必须在预留配置区域(
[RESERVED_CONFIG]
或[RESERVED_EXPAND_CONFIG]
其中一个区域)中有对应的配置,不然会报错。每个配置项目都遵循下面的固定格式:
配置 |
配置说明 |
值说明 |
---|---|---|
XXXX_ADR |
区域起始地址,XXXX为预留区域名字 |
AUTO:由工具自动分配起始地址(PROC与VM配置不支持) |
XXXX_LEN |
区域长度,XXXX为预留区域名字 |
CODE_LEN:代码长度(只针对PROC配置) |
XXXX_OPT |
区域操作属性,XXXX为预留区域名字 |
0: 下载代码时擦除指定区域 |
XXXX_FILE(可选) |
下代码时指定的文件会下载到对应的区域,XXXX为预留区域名字 |
|
4.3.2.6. [RESERVED_EXPAND_CONFIG] 段选项说明(可选)
该区域就是
[RESERVED_CONFIG]
区域的扩展,也是用于配置预留配置信息,格式也遵循[RESERVED_CONFIG]
中配置项的规则。该区域没有个数限制,如果只配置了
[RESERVED_EXPAND_CONFIG]
区域没有配置[RESERVED_CONFIG]区域,那么[EXTRA_CFG_PARAM]
区域中的RESERVED_OPT的配置则无效。该区域可以与
[RESERVED_CONFIG]
区域同时存在,这种情况下[EXTRA_CFG_PARAM]
区域中的RESERVED_OPT
的配置还是会生效。