征程 6 环视快启 sample
01 功能概述
环视 4V 解串器直接接到 main 域，mcu 访问 main 域 i2c、gpio、lpwm，对 camera sensor、serdes 以及 lpwm 进行初始化，完成环视的快速出图。
mcu 启动后，会在 mcu task 中调用 Camera_Init 接口，完成 camera sensor、serdes 以及 lpwm 的配置，并使能数据流，数据会通过加串器 bypass 给 IVI。
Camera_Init 中会先检查 AonSram 中当前需要配置的 camera 通路是否 working，如果 working 状态，接口将直接退出，当检查 flag 为非 working 状态时，会将需要使能通路 flag 设置为 working，并开始初始化环视，并使能数据流 bypass 给 IVI。
1.1 mcu 编译
mcu camera bypass 参考方案相关实现在 mcu/Service/Camera 目录下。
├── inc
│ ├── camera_common_gpio.h
│ ├── camera_common_i2c.h
│ ├── camera_common_lpwm.h
│ ├── Camera_PreInit.h
│ ├── Camera_Setting.h
│ └── Camera_Sub.h
├── SConscript
└── src
├── Camera_Autosar.c
├── camera_common_lpwm.c
├── Camera_PreInit.c
├── camsys_common_gpio.c
├── camsys_common_i2c.c
└── I2c_Operation.c
由于 mcu 调试环境不适合 camera sensor & serdes 的调试工作，所以 camera sensor & serdes 的调试需要在 acore 侧进行，由 acore 完成 camera sensor & serdes 调试，调试完成后通过 libcam 提供的 setting dump 命令得到 setting 文件，如 camdump-hbn_camera_test-608660-639939578641.log.i2c。
在开发板执行如下命令，会在/log/camera 目录下得到 dump 的 setting 文件：
# 创建默认 dump 目录：
mkdir -p /log/camera
# 关闭诊断功能：
export CAM_DIAG_DISABLE=1
# 关闭内参预读功能：
export CAM_IPARAM_MODE=1
# 打开 debug 功能，不打印，但正常初始化并（开流完）后 dump 到文件：同时 i2c 源记录
export CAM_DEBUG_LEVEL=0x2201
# 打开 debug 功能，不打印，但正常初始化完（不开流）后 dump 到文件：同时 i2c 源记录
export CAM_DEBUG_LEVEL=0xa01
# 运行相应的配置，如：RX4/96724 4V 环视 HK ISX031
/app/testcase/S10_Camera/testsuite/scripts/hbn_camera_test.sh 4v_yuv_cim0_ddr_1536p_isx031 config_HK_F196P1_MAX96724 R4
# 或：RX4/96724 4V 环视 SENSING ISX031
/app/testcase/S10_Camera/testsuite/scripts/hbn_camera_test.sh 4v_yuv_cim0_ddr_1536p_isx031 config_SENSING_F190S0T7_MAX96724 R4 # 创建默认 dump 目录： mkdir -p /log/camera # 关闭诊断功能： export CAM_DIAG_DISABLE=1 # 关闭内参预读功能： export CAM_IPARAM_MODE=1 # 打开 debug 功能，不打印，但正常初始化并（开流完）后 dump 到文件：同时 i2c 源记录 export CAM_DEBUG_LEVEL=0x2201 # 打开 debug 功能，不打印，但正常初始化完（不开流）后 dump 到文件：同时 i2c 源记录 export CAM_DEBUG_LEVEL=0xa01 # 运行相应的配置，如：RX4/96724 4V 环视 HK ISX031 /app/testcase/S10_Camera/testsuite/scripts/hbn_camera_test.sh 4v_yuv_cim0_ddr_1536p_isx031 config_HK_F196P1_MAX96724 R4 # 或：RX4/96724 4V 环视 SENSING ISX031 /app/testcase/S10_Camera/testsuite/scripts/hbn_camera_test.sh 4v_yuv_cim0_ddr_1536p_isx031 config_SENSING_F190S0T7_MAX96724 R4
在得到 dump 的 setting 文件后，地平线提供工具 Camera_Setting_Tools 对 dump 的 setting 文件进行解析，进而得到 mcu 侧可用的 Camera_Setting.h 文件。
./Camera_Setting_Tools camdump-hbn_camera_test-23984-48446987219.log.i2c
Camera_Setting.h 文件中包含 i2c bus、i2c 寄存器、gpio 操作、延时等，完全复用 acore 执行侧时序进行初始化。
Camera_Setting.h 中的结构：
typedef struct {
uint8_t bus; // i2c bus num
uint8_t i2c_addr; // i2c addr, exception:(i2c_addr \| alen \| dlen) = 0 for gpio
uint8_t i2c_op; // read/write/sleep
uint8_t alen; // i2c reg addr length, exception:(i2c_addr \| alen \| dlen) = 0 for gpio
uint8_t dlen; // i2c reg val length, exception:(i2c_addr \| alen \| dlen) = 0 for gpio
uint32_t reg_addr; // i2c reg addr or gpio
uint32_t value; // i2c reg value or gpio val
uint32_t time_us; // i2c timestemp
uint32_t delay_us; // i2c timestemp
} cam_i2c_info_t;
lpwm 的配置在 camera_common_lpwm.c 文件中，根据需要配置 lpwm 参数，将参数填入 g_LpwmAttr 的初始化。
由于该参考方案需要 mcu 跨域访问 i2c & ioext，而默认 mcu 侧不一定配置了 main 域的 i2c & ioext，所以需要确认需要访问的 i2c bus 以及 gpio 是否需要额外配置，如果需要额外配置，需要对 i2c 以及 ioext 的 Config 进行修改，并在 Camera_PreInit.c 中增加适配，并在 mcu HorizonTask.c 中 I2c_Init（）之前调用 Camera_PreInit.h 中提供的 Camera_PreInit（）接口。
I2c 配置 matrix A 参考修改：
mcu/Config/McalCdd/gen_matrix_A/I2c/inc/I2c_PBcfg.h
将#define I2C_CONFIG_CHANNEL （4U）定义修改为#define I2C_CONFIG_CHANNEL （10U）。
#define I2C_CONFIG_CHANNEL (10U)
mcu/Config/McalCdd/gen_matrix_A/I2c/src/I2c_PBcfg.c
将 I2cConfig[4]初始化修改为 I2cConfig[10]，并进行初始化。
const I2c_ConfigType I2cConfig[10] =
{
{
I2cHwChannel0,
MASTER_MODE,
ADDRESS_7_BITS,
I2C_FAST_MODE,
0
},
{
I2cHwChannel1,
MASTER_MODE,
ADDRESS_7_BITS,
I2C_FAST_MODE,
0
},
{
I2cHwChannel2,
MASTER_MODE,
ADDRESS_7_BITS,
I2C_FAST_MODE,
0
},
{
I2cHwChannel3,
MASTER_MODE,
ADDRESS_7_BITS,
I2C_FAST_MODE,
0
},
{
I2cHwChannel4,
MASTER_MODE,
ADDRESS_7_BITS,
I2C_FAST_MODE,
0
},
{
I2cHwChannel5,
MASTER_MODE,
ADDRESS_7_BITS,
I2C_FAST_MODE,
0
},
{
I2cHwChannel6,
MASTER_MODE,
ADDRESS_7_BITS,
I2C_STANDARD_MODE,
0
},
{
I2cHwChannel7,
MASTER_MODE,
ADDRESS_7_BITS,
I2C_STANDARD_MODE,
0
},
{
I2cHwChannel8,
MASTER_MODE,
ADDRESS_7_BITS,
I2C_STANDARD_MODE,
0
},
{
I2cHwChannel9,
MASTER_MODE,
ADDRESS_7_BITS,
I2C_STANDARD_MODE,
0
},
};
ioext 配置 matrix A 参考修改：
mcu/Config/McalCdd/gen_matrix_A/IoExt/inc/TCA9539_Cfg.h
增加 acore tca9539 拓展 io i2c bus 定义
#define TCA9539_ACORE_I2C_CHANNEL 5U
TCA9539_DEVICE 中增加参数 TCA9539_DEVICE2
typedef enum
{
TCA9539_DEVICE0 = 0,
TCA9539_DEVICE1 = 1,
TCA9539_DEVICE2, // add for acore TCA9539
TCA9539_DEVICE_MAX
} TCA9539_DEVICE;
mcu/Config/McalCdd/gen_matrix_A/IoExt/src/TCA9539_Cfg.c
TCA9539_DeviceMapping 增加{TCA9539_ACORE_I2C_CHANNEL， 0x74u}参数
const TCA9539_DeviceMappingType TCA9539_DeviceMapping[TCA9539_DEVICE_MAX] =
{
{TCA9539_0_I2C_CHANNEL, 0x74u}, /* Device 0 */
{TCA9539_0_I2C_CHANNEL, 0x75u}, /* Device 1 */
{TCA9539_ACORE_I2C_CHANNEL, 0x74u}, /* Device acore */
};
TCA9539_RegRecord 增加{{0u， 0u}， {0xFFu， 0xFFu}， {0u， 0u}， {0xFFu， 0xFFu}参数
TCA9539_RegRecordType TCA9539_RegRecord[TCA9539_DEVICE_MAX] =
{
{
{0u, 0u},
{TCA9539_0_OUTPUT_LEVEL_0, TCA9539_0_OUTPUT_LEVEL_1},
{TCA9539_0_POLORITY_INVERSION_0, TCA9539_0_POLORITY_INVERSION_1},
{TCA9539_0_CONFIGURATION_0, TCA9539_0_CONFIGURATION_1}
},
{
{0u, 0u},
{TCA9539_1_OUTPUT_LEVEL_0, TCA9539_1_OUTPUT_LEVEL_1},
{TCA9539_1_POLORITY_INVERSION_0, TCA9539_1_POLORITY_INVERSION_1},
{TCA9539_1_CONFIGURATION_0, TCA9539_1_CONFIGURATION_1}
},
{
{0u, 0u},
{0xFFu, 0xFFu},
{0u, 0u},
{0xFFu, 0xFFu}
},
};
在生成完 Camera_Setting.h 并配置好 g_LpwmAttr 后以及适配完 i2c&ioext 后：
- 将 Camera_PreInit（）函数放在 mcu 初始化任务中，注意要在 I2c_Init（NULL_PTR）之前。
- 将 Lpwm_Ops（0， 0）和 Camera_Init（）放在 task 中只执行一次，就可以编译 mcu 镜像了。
注：
- 如果是解串器接到 switch 并分别接到 mcu 侧 i2c bus 和 acore i2c bus，需要将解析后的 Camera_Setting.h 文件中 bus 替换成 mcu 侧对应 bus，且不需要对 I2c_PBcfg 以及 IoExt_PBcfg 进行额外适配修改。
- Camera_Setting_Tools 工具可在 mcu 工程 mcu/Tools/mcu_camsys_tools 目录找到。
1.2 soc 侧配置修改
soc 侧在环视 4V 快起时，需要在 hb_j6dev.json 中 deserial 的配置添加"flags":"0x20"，表示打开环视 4V 快起功能。
打开该功能后，soc 在初始化时，会通过 i2c 读取 deserial 的 0x108 寄存器判断是否 mcu 已经开流。
- 如果 mcu 已经开流，soc 侧会跳过 deserial、sensor 的上电及初始化配置。
- 如果 mcu 未开流，soc 侧会对 deserial、sensor 进行正常的上电及初始化配置。
1.3 mcu 侧运行
mcu 启动后，通过 i2cdetect 确认检查 camera 设备被扫到。
确认是否出流可以通过加串器出流寄存查看：I2c_Read 3 0x27 16 8 0x108
1.4 PYM-Sample
soc 侧可通过以下命令打开环视 4V，进行测试验证。
/app/sample/S83_Sample/S83E04_Module/camera_sample/scripts/camera_sample.sh matrix 4V_4xISX031_RX4_HK_SYNC t33554432
deserial 判断 mcu 是否已经初始化：
sensor 判断 mcu 是否已经初始化：
soc 侧也可通过以下命令打开 3V，进行测试验证。
/app/sample/S83_Sample/S83E04_Module/camera_sample/scripts/camera_sample.sh matrix 3V_2xOVX8B_1xOVX3C_RX0
