企业官网建设流程全解析

海思3559A SDK 2.0.3.1实战：BT656视频输入全流程解析与源码改造指南

当工程师第一次拿到海思3559A开发板和官方SDK时，往往会发现一个尴尬的现实——虽然芯片规格明确标注支持BT656视频输入，但SDK中却找不到任何相关示例代码。本文将彻底解决这个痛点，从硬件接口原理到SDK源码改造，提供一套完整的BT656接入方案。

1. 硬件基础与接口原理

在开始代码修改前，我们需要明确几个关键硬件特性：

• 引脚复用关系：Hi3559AV100的VI CMOS2接口与MIPI RX Port2/Port3共用物理引脚
• 时钟配置：必须通过PERI_CRG65寄存器的bit[11:9]使能VI CMOS2时钟
• 信号类型：仅支持逐行输入（如需接入PAL等隔行信号需外接转换芯片）

硬件连接示意图如下：

提示：实际硬件设计中，建议用示波器检查BT656的时钟信号（27MHz）和数据信号是否稳定，这是后续软件调试的基础。

2. SDK源码深度改造

2.1 时钟配置的两种实现方式

在SDK 2.0.3.1版本中，我们发现有两条路径可以配置BT656所需的时钟：

方法一：直接寄存器操作

# 通过devmem工具直接配置CRG寄存器 devmem 0x12010104 32 0xCEBEDB

方法二：修改驱动源码

需要修改sysconfig.c中的coms_clock_config函数：

static void coms_clock_config(int index) { if(0 == index) { reg_write32(0x5 << 15, 0x7 << 15, (unsigned long)reg_crg_base+0x0104); } else if(1 == index) { reg_write32(0x6 << 21, 0x7 << 21, (unsigned long)reg_crg_base+0x0104); } else if(2 == index) { reg_write32(0x7 << 9, 0x7 << 9, (unsigned long)reg_crg_base+0x0104); } }

两种方法对比：

2.2 VI模块关键结构体配置

BT656配置的核心在于三个关键结构体：

1. VI_DEV_ATTR_S（设备属性）

VI_DEV_ATTR_S DEV_BT656_ATTR_HX = { VI_MODE_BT656, VI_WORK_MODE_1Multiplex, {0x00FF0000, 0}, // 注意掩码与官方手册差异 VI_SCAN_PROGRESSIVE, { -1, -1, -1, -1}, VI_DATA_SEQ_YUYV, { /* 时序参数 */ }, VI_DATA_TYPE_YUV, HI_FALSE, {720 , 576}, /* 其他参数 */ };

2. VI_PIPE_ATTR_S（管道属性）

VI_PIPE_ATTR_S PIPE_BT656_ATTR_HX = { VI_PIPE_BYPASS_NONE, HI_FALSE, // UV skip enable HI_TRUE, // ISP Bypass 720, 576, PIXEL_FORMAT_YVU_SEMIPLANAR_422, COMPRESS_MODE_NONE, DATA_BITWIDTH_8, /* 其他参数 */ };

3. VI_CHN_ATTR_S（通道属性）

VI_CHN_ATTR_S CHN_BT656_ATTR_HX = { {720, 576}, PIXEL_FORMAT_YVU_SEMIPLANAR_422, DYNAMIC_RANGE_SDR8, VIDEO_FORMAT_LINEAR, /* 其他参数 */ };

关键参数说明：

• 掩码设置：au32ComponentMask[0] = 0x00FF0000（与官方文档建议不同）
• 像素格式：必须使用PIXEL_FORMAT_YVU_SEMIPLANAR_422
• ISP旁路：设置bIspBypass=HI_TRUE以跳过ISP处理

2.3 传感器类型枚举扩展

在sample_comm.h中新增BT656枚举类型：

typedef enum hiSAMPLE_SNS_TYPE_E { // 原有传感器类型... BT656_HX_TEST, SAMPLE_SNS_TYPE_BUTT, } SAMPLE_SNS_TYPE_E;

2.4 配置加载逻辑改造

需要修改多个获取属性的函数，以SAMPLE_COMM_VI_GetDevAttrBySns为例：

HI_S32 SAMPLE_COMM_VI_GetDevAttrBySns(SAMPLE_SNS_TYPE_E enSnsType, VI_DEV_ATTR_S* pstViDevAttr) { switch (enSnsType) { // 其他传感器case... case BT656_HX_TEST: hi_memcpy(pstViDevAttr, sizeof(VI_DEV_ATTR_S), &DEV_BT656_ATTR_HX, sizeof(VI_DEV_ATTR_S)); break; default: // 默认处理 } return HI_SUCCESS; }

类似修改还需要应用于：

• SAMPLE_COMM_VI_GetPipeAttrBySns
• SAMPLE_COMM_VI_GetChnAttrBySns
• SAMPLE_COMM_ISP_GetIspAttrBySns

3. 编译配置与系统集成

3.1 Makefile配置修改

在sample/Makefile.param中指定传感器类型：

SENSOR0_TYPE ?= BT656_HX_TEST SENSOR1_TYPE ?= BT656_HX_TEST SENSOR2_TYPE ?= BT656_HX_TEST SENSOR3_TYPE ?= BT656_HX_TEST

3.2 内核模块加载

保持原有的ko加载顺序不变：

insmod sysconfig.ko insmod hi_osal.ko # 其他模块加载...

4. 调试技巧与问题排查

当配置完成后仍无图像输出时，建议按照以下流程排查：

1. 硬件检查

   • 电源电压（特别是1.8V和3.3V）
   • 27MHz时钟信号质量
   • 数据线对地阻抗

2. 软件日志分析

   cat /proc/umap/vi

   重点关注：

   • 中断计数是否增长
   • 帧率是否稳定
   • 图像尺寸是否正确

3. 信号测量

   • 使用逻辑分析仪检查BT656的SAV/EAV码
   • 测量行同步和场同步信号

4. 数据通路验证

   // 在驱动中添加调试打印 printk("VI buffer addr: %p, size: %d\n", pstFrame->addr, pstFrame->size);

常见问题解决方案：

5. 进阶应用：与VPSS/VENC集成

完成VI配置后，典型的视频处理流水线如下：

graph LR BT656输入-->VI-->VPSS-->VENC-->输出

关键绑定代码示例：

HI_MPI_VPSS_BindVi(VPSS_GRP, VI_PIPE); HI_MPI_VENC_BindVpss(VENC_CHN, VPSS_GRP);

配置建议：

• VPSS组号与VI管道号保持一致
• 对于720x576分辨率，建议VPSS使用默认缩放模式
• VENC配置为H.264 Baseline Profile

6. 性能优化技巧

1. 内存带宽优化

   // 在VI属性中启用压缩 stViDevAttr.enCompressMode = COMPRESS_MODE_SEG;

2. 中断优化

   # 设置VI中断CPU亲和性 echo 1 > /proc/irq/xx/smp_affinity

3. 低延迟配置

   stViPipeAttr.enBypassMode = VI_PIPE_BYPASS_NONE; stViChnAttr.u32Depth = 2; // 减少缓冲区数量

实测性能指标（720x576@25fps）：

通过本文的详细配置和优化，开发者可以充分发挥海思3559A的BT656接口能力，构建稳定高效的视频采集系统。