# 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
        },
        "force": {
            "force_enable":"true",
            "ddr_type": "lpddr4",
            "rank_type": "single",
            "die_dencity": 1
        },
        "ecc_enabled": "false",
        "freq": "default",
        "diag_test": "false"
    },
	...
}
```
这里主要配置DDR的信息，用于适配不同的DDR，需要配置的信息包括4个
- 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

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

- force_enable：设置为false，表示使用外部ADC自动探测的方式
- adc_channel：ADC探测DDR的通道

ADC的电压值与DDR的类型和DDR rank值的映射关系如下
- [51~140mv]: lpddr4 + single rank + 1GB/die
- [151~240mv]: lpddr4x + single rank + 1GB/die
- [251~340mv]: lpddr4 + dual rank + 1GB/die
- [351~440mv]: lpddr4x + dual rank + 1GB/die
- [851~940mv]: lpddr4 + single rank + 2GB/die
- [951~1040mv]: lpddr4x + single rank + 2GB/die
- [1051~1140mv]: lpddr4 + dual rank + 2GB/die
- [1151~1240mv]: lpddr4x + dual rank + 2GB/die

对于频点，默认值情况为
- lpddr4 + single rank + 1GB/die： 4266, dvfs, 4266_2844_2133_266
- lpddr4 + dual rank + 1GB/die： 4266, dvfs, 4266_2844_2133_266
- lpddr4x + single rank + 1GB/die： 4266, dvfs, 4266_2844_2133_266
- lpddr4x + dual rank + 1GB/die： 4266, dvfs, 4266_2844_2133_266
- lpddr4 + single rank + 2GB/die： 4266, dvfs, 4266_2844_2133_266
- lpddr4 + dual rank + 2GB/die： 4266, dvfs, 4266_2844_2133_266
- lpddr4x + single rank + 2GB/die： 当前不支持
- lpddr4x + dual rank + 2GB/die： 当前不支持

若默认值符合使用要求，则配置为默认值即可
```
"freq": "default"
```
若使用非默认值，则将freq字段修改相应的数字即可
```
"freq": 4266
```

参数"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](../../system_component_development/security_development/efuse/efuse_update.html#span-id-bl2-update-efuse-bl2-efuse) 章节。
