4.3.28.2. BL2 配置文件说明

BL2 可以根据配置文件中的内容在启动阶段对系统做一些设置，包括 bl2 feature 配置（看门狗的配置、gpio 的配置）、DDR 的配置和 eFUSE 烧写相关的配置。

BL2 配置文件路径为：

device/horizon/x5/board_cfg/soc/bl2_cfg/bl2_cfg.json

配置文件的打包程序路径为：

build/tools/bl2_cfg.py

bl2_cfg.py 会解析 bl2_cfg.json 中的内容，打包为 bin 文件，最终和 uboot 通过 fip 包的形式打包在一起，制作 uboot fip 包的脚本路径为：

build/mk_uboot.sh

bl2 feature 配置

bl2 看门狗配置

{
	"bl2_cfg": {
		"feature": {
			"wdt_en": "false",
			"wtd_timeout": 10,
			...
		},
	},
	...
}

在配置文件中可以设置 bl2 阶段看门狗的使能以及超时时间：

wdt_en：bl2 看门狗是否使能。false 表示关闭，true 表示开启
wtd_timeout：超时时间，单位是秒

bl2 gpio 配置

bl2 支持将 pin 配置成 gpio 功能，方向默认为 out，可以配置高电平或低电平，可以配置单个 pin 或者连续的一组 pin，最多支持 40 个 pin 的配置。当前的 pin 分布在 4 个子系统，分别为 aon、hsio、lsio 和 dsp。每个子系统中 pin 可能会分为多个组，子系统 hsio 和 lsio 有组 0 和组 1，其他子系统只有组 0。在每个组中，pin 的序号以 0 为开始。

单 pin 配置

{
	"bl2_cfg": {
		"feature": {
			...
			"gpio_cfg": {
				"lsio_0_1": {
					"value": 1
				}
			}
		}
	},
	...
}

配置时需要写明 pin 所属的系统、组和序号，以 lsio_0_1 为例，表明这个 pin 属于 lsio 子系统，第 0 组的序号为 1 的 pin。 value 为 1 表示将此 pin 配置为高电位， 0 为低电位（只要配置为 gpio，会将此 pin 默认配置为 out）。

连续 pin 配置

{
	"bl2_cfg": {
		"feature": {
			...
			"gpio_cfg": {
				"lsio_0_2-31": {
					"value": 1
				}
			}
		}
	},
	...
}

以 lsio_0_2-31 为例，表示 lsio 子系统的第 0 组的序号为 2 到 31 的 pin，将此组 pin 都配置为高电位。

注：gpio_cfg 下可以有多个单 pin 配置和连续 pin 配置，但是 pin 的总数不能超过 40。

DDR 配置

{
	...
    "ddr": {
        "detect": {
            "adc_channel": 2,
            "adc_map_rules": {
              "ddr_profile_10": [51, 140],
              "ddr_profile_11": [151, 240],
              "ddr_profile_2": [251, 340],
              "ddr_profile_3": [351, 440],
              "ddr_profile_1": [451, 540],
              "ddr_profile_7": [551, 640],
              "ddr_profile_17": [651, 740],
              "ddr_profile_18": [751, 840],
              "ddr_profile_14": [851, 940],
              "ddr_profile_15": [951, 1040],
              "ddr_profile_12": [1051, 1140],
              "ddr_profile_13": [1151, 1240],
              "reserved_5": [1251, 1340],
              "reserved_6": [1351, 1440]
            }
        },
        "force": {
            "force_enable":"false",
            "ddr_type": "lpddr4",
            "rank_type": "single",
            "die_dencity": 1,
            "alternative": 0
        },
        "ecc_enabled": "false",
        "freq": "default",
        "diag_test": "false"
    },
	...
}

这里主要配置 DDR 的信息，用于适配不同的 DDR，需要配置的信息如下所示

识别 DDR 的 ADC map 规则
DDR 的类型，lpddr4 还是 lpddr4x
DDR 的 rank 值，single rank 还是 dual rank
DDR 单 die 的容量，1: 1GB; 2: 2GB
频点信息
是否使能 ecc

其中 DDR 的类型、DDR rank 值和单 die 容量有两种配置方法

通过 ADC 探测获取
在该配置文件中强制指定

如果在该配置文件中强制指定 DDR 的类型、DDR rank 值、单 die 容量和最高频率，则需要

force_enable：设置为 true，表示强制指定
ddr_type：DDR 类型。当前支持的有 lpddr4、lpddr4x
rank_type：DDR rank 数量。当前支持的有 single、dual
die_dencity：DDR 单 die 容量。1: 1GB; 2: 2GB
alternative：DDR Alternative 值。表示在相同的 ddr_type、rank_type 和 die_dencity 下的其他配置，主要是针对相同规格客户的不同 ODT 配置。默认为 0，表示使用默认的 ODT 配置。
freq：DDR 最高频率。3200; 3733; 4266

如果通过 ADC 获取 DDR 的类型、DDR rank 值和单 die 容量，则需要

force_enable：设置为 false，表示使用外部 ADC 自动探测的方式
adc_channel：ADC 探测 DDR 的通道
adc_map_rules：ADC 档位与 DDR 配置的映射关系。字典中的 key 表示的是 DDR 配置文件，即 profile，value 表示的是当前 DDR 配置的 ADC 识别范围，列表中的第一项表示当前 DDR 配置的 ADC 值的下限，第二项表示当前 DDR 配置的 ADC 值的上限，单位都是 mv.

注意：

字典中的 key 的组成形式必须是 ddr_profile_num 或 reserved_num, 其中最后的 num 必须是十进制数字

ADC 的电压值与 DDR 配置的映射关系如下

颗粒类型	rank 数量	density/CH	最高频率	Alternative	profile	ADC 档位
LP4	1	1	3200	0	profile_1	500mv
LP4	2	1	4266	0	profile_2	300mv
LP4X	2	1	4266	0	profile_3	400mv
LP4X	2	1	3733	0	profile_7	600mv
LP4	1	1	4266	0	profile_10	100mv
LP4X	1	1	4266	0	profile_11	200mv
LP4	2	2	4266	0	profile_12	1100mv
LP4X	2	2	4266	0	profile_13	1200mv
LP4	1	2	4266	0	profile_14	900mv
LP4X	1	2	4266	0	profile_15	1000mv
LP4	1	1	3733	0	profile_17	700mv
LP4	1	2	4266	1	profile_18	800mv

重新映射 adc 档位与 DDR profile

用户可以重新配置 ADC 档位和 DDR profile 的映射关系。

例如地瓜提供的新的 DDR 配置文件 profile_19，客户可以替换 reserved_5 为 profile_19，profile_19 将会启动 1300 这个 ADC 档位。即 ADC 识别到了 1300 档位，就会使用 profile_19 的配置进行对 DDR 的初始化。

...
              "ddr_profile_19": [1251, 1340],
...

注意事项

并非所有 DDR profile 都支持重新配置映射关系，用户可配置的档位如下

颗粒类型	rank 数量	density/CH	最高频率	Alternative	profile	ADC 档位
LP4	1	1	3200	0	profile_1	500mv
LP4X	2	1	3733	0	profile_7	600mv
LP4	1	1	3733	0	profile_17	700mv
LP4	1	2	4266	1	profile_18	800mv
N/A	N/A	N/A	N/A	N/A	N/A	1300mv
N/A	N/A	N/A	N/A	N/A	N/A	1400mv

开启 DDR 数字眼图

参数 diag_test 用于配置是否开启 DDR 数字眼图功能

"diag_test": "false"   # 不开启眼图功能
"diag_test": "true"    # 开启眼图功能

通过 bl2_cfg 开启 DDR 数字眼图后，想要退出只能重新烧录包含未开启眼图功能 bl2_cfg 的 uboot 镜像

DDR 数字眼图功能开启除了可以在 bl2_cfg 中配置外，也可以在 kernel 下通过重启命令 reboot -m eye -f 进入，通过此命令进入 DDR 数字眼图模式后，芯片重启后可以退出眼图模式

eFUSE 配置

参考 BL2 烧录 eFuse 章节。