4.3. isd_config.ini 配置文件说明

4.3.1. 各个配置段说明

段名

说明

[EXTRA_CFG_PARAM]

用于配置生成flash.bin前所需要的信息。

[SYS_CFG_PARAM]

用于配置系统所需要的参数,该配置的所有选项都会进过转后然后存入flash.bin中。

[TOOL_CONFIG]

用于配置相关工具信息。

[CHIP_VERSION]

用于配置芯片版本相关信息。

[RESERVED_CONFIG]

用于配置预留区域信息的区域,如果[EXTRA_CFG_PARAM]区域有设置RESERVED_OPT配置项,则当前区域最多只能配置6个。

[RESERVED_EXPAND_CONFIG]

用于配置预留区域信息的区域,与[RESERVED_CONFIG],该区域是为了预防[RESERVED_CONFIG]区域不够而添加的。

4.3.2. 选项

默认值指的是,当选项不出现的时候的值。

有效值指的是,对应配置值接收指定的值。

4.3.2.1. [EXTRA_CFG_PARAM]段选项说明

选项

类型

默认值

有效值

说明

NEED_RESERVED_4K

布尔

YES

YES/NO

预留部分空间用于保存SDK需要的配置,默认不修改,如需修改请联系杰理工程师

NEED_RESERVED_AREA

布尔

YES

YES/NO

预留区域是否一定要配置BTIF区域的限制
没有蓝牙配置的芯片型号的会配置为NO,例如AD14N, AD15N

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参数,等号右边的参数含义是 datawidth_clk_mode_port

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时指定外部升级参数,
CS引脚为PB07
使用SPI1的C端
如果norflash电源为vddio,填NULL即可,否则填写对应的引脚号,
需要配合packres.exe工具使用

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配置不支持)
如果填写立即数即代表绝对地址
VM配置如果填写0则代表自动分配

XXXX_LEN

区域长度,XXXX为预留区域名字

CODE_LEN:代码长度(只针对PROC配置)
如果填写立即数即代表指定长度

XXXX_OPT

区域操作属性,XXXX为预留区域名字

0: 下载代码时擦除指定区域
1: 下载代码时不操作指定区域
2: 下载代码时给指定区域加上保护

XXXX_FILE(可选)

下代码时指定的文件会下载到对应的区域,XXXX为预留区域名字


1、指定的文件名(该文件必须要与isd_download.exe同在一个目录)
2、如果需要找到该区域,则需要根据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的配置还是会生效。