1. 环境准备与基础概念
做MTK平台Sensor移植的朋友们都知道,搭建调试环境是整个流程中最关键的一步。我记得第一次做Sensor Porting的时候,光是环境配置就花了整整两天时间,各种依赖问题、版本冲突让人头疼不已。不过别担心,今天我就把这些年踩过的坑和总结的经验毫无保留地分享给大家。
首先我们需要明白,MTK平台的Sensor Porting本质上是在Android系统上适配一个新的图像传感器驱动程序。这就像给手机安装一个新的"眼睛",需要硬件、驱动、系统三层完美配合。在实际操作前,我强烈建议先准备好以下环境:
基础开发环境:
- Ubuntu 18.04或20.04 LTS(MTK官方推荐)
- 至少16GB内存,建议32GB(编译真的很吃内存)
- 200GB以上硬盘空间(源码+编译输出)
- 稳定的网络连接(下载源码和依赖包)
软件依赖:
# 安装基础编译工具
sudo apt-get install git-core gnupg flex bison build-essential zip curl \
zlib1g-dev gcc-multilib g++-multilib libc6-dev-i386 lib32ncurses5-dev \
lib32z1-dev libssl-dev libxml2-utils xsltproc unzip fontconfig
# 安装Python相关工具
sudo apt-get install python python2.7 python3 python3-pip
# 配置git(必须步骤)
git config --global user.name "Your Name"
git config --global user.email "your.email@example.com"
我这里特别要强调Python版本的问题。MTK的编译系统对Python版本有严格要求,很多新手都会在这里栽跟头。建议使用Python 2.7和Python 3.6+的混合环境,可以通过update-alternatives来管理多版本:
# 设置Python版本优先级
sudo update-alternatives --install /usr/bin/python python /usr/bin/python2.7 1
sudo update-alternatives --install /usr/bin/python python /usr/bin/python3.8 2
源码下载是另一个容易出问题的环节。MTK使用repo工具管理源码,下载时一定要保持网络稳定:
# 初始化repo
mkdir mtk-source && cd mtk-source
repo init -u https://github.com/mediatek/manifest.git -b main
repo sync -j4 --no-clone-bundle
如果下载过程中断,可以使用repo sync --fail-fast来继续,避免重新下载。我通常会在晚上开始同步,第二天早上就能得到完整的源码树。
2. ProjectConfig.mk关键配置解析
ProjectConfig.mk文件是整个Sensor Porting的入口点,它定义了系统编译时需要包含哪些传感器驱动。这个文件位于device/mediatek/{project}/ProjectConfig.mk,其中{project}是你的项目名称。
传感器命名规范是第一个需要注意的点。MTK有一套严格的命名规则,通常采用"厂商_接口类型_传感器类型"的格式。比如ov64b_mipi_raw表示OmniVision的64B传感器,使用MIPI接口,输出RAW格式数据。
# 主摄传感器配置
CUSTOM_HAL_IMGSENSOR = ov64b_mipi_raw gc02m1_mipi_raw
CUSTOM_HAL_MAIN_IMGSENSOR = ov64b_mipi_raw
CUSTOM_HAL_SUB_IMGSENSOR = gc02m1_mipi_raw
CUSTOM_HAL_MAIN2_IMGSENSOR = # 如果有第二主摄可以在这里配置
# 内核传感器配置
CUSTOM_KERNEL_IMGSENSOR = ov64b_mipi_raw gc02m1_mipi_raw
CUSTOM_KERNEL_MAIN_IMGSENSOR = ov64b_mipi_raw
CUSTOM_KERNEL_SUB_IMGSENSOR = gc02m1_mipi_raw
这里有个实际项目中容易遇到的坑:传感器顺序问题。CUSTOM_HAL_IMGSENSOR和CUSTOM_KERNEL_IMGSENSOR中传感器的顺序必须与内核中的传感器列表顺序一致,否则会导致IOCTL通信错误。
编译选项优化也是重要的一环。为了提高编译速度,我们可以针对性地只编译需要的模块:
# 只编译相机相关模块
MTK_CAMERA_APP = yes
MTK_CAMERA_VIDEO = yes
MTK_CAMERA_STEREO = no # 如果没有立体视觉需求可以关闭
# 优化编译速度
MTK_ION_SUPPORT = yes
MTK_CAMERA_MMSDK_SUPPORT = yes
在实际操作中,我建议每次修改ProjectConfig.mk后都执行一次clean build,避免缓存导致的问题:
# 清理编译输出
make clean
# 或者只清理相机模块
make camclean
调试技巧:如果遇到传感器无法识别的问题,首先检查ProjectConfig.mk中的传感器名称是否与驱动文件中的名称完全一致,包括大小写。我曾经因为一个下划线的问题调试了整整一天!
3. 内核配置与设备树修改
内核配置是Sensor Porting的核心环节,这里涉及到多个关键文件的修改。首先我们要修改内核配置文件mgk_64_k61_defconfig(路径:kernel/device_modules-6.1/arch/arm64/configs/)。
内核配置选项:
# 添加传感器驱动配置
CONFIG_CUSTOM_KERNEL_IMGSENSOR=y
CONFIG_CUSTOM_KERNEL_IMGSENSOR_OV64B_MIPI_RAW=y
CONFIG_CUSTOM_KERNEL_IMGSENSOR_GC02M1_MIPI_RAW=y
# 启用MIPI接口支持
CONFIG_MTK_MIPI_TX_DRIVER=y
CONFIG_MTK_MIPI_RX_DRIVER=y
# 相机相关配置
CONFIG_MTK_CAMERA=y
CONFIG_MTK_CAMERA_DEBUG=y # 调试阶段建议开启
设备树修改是最容易出问题的部分。我们需要在custom_platform_camera.dtsi文件中添加传感器的硬件配置:
&kd_camera_hw1 {
/* 主摄配置 */
cam0_enable_sensor = "ov64b_mipi_raw";
cam0_avdd-supply = <&mt6359_vcamio_reg>;
cam0_dvdd-supply = <&mt6359_vcamd_reg>;
cam0_afvdd-supply = <&mt6359_vcamaf_reg>;
/* 时钟配置 */
cam0_mclk = <0>;
cam0_mclk_freq = <24000000>;
/* GPIO配置 */
pinctrl-names = "default";
pinctrl-0 = <&camera_pins_default>;
};
/* 引脚控制配置 */
&pio {
camera_pins_default: camdefault {
pins_cmd_dat {
pinmux = <PINMUX_GPIO100__FUNC_CMMCLK0>, /* MCLK0 */
<PINMUX_GPIO101__FUNC_CMRST0>, /* RST0 */
<PINMUX_GPIO102__FUNC_CMPDN0>; /* PWDN0 */
slew-rate = <1>;
output-low;
};
};
};
电源管理是另一个需要特别注意的区域。传感器通常需要多个电压域(AVDD、DVDD、DOVDD),每个电压的时序和值都必须严格按照传感器规格书来配置:
&mt6359_vcamio_reg {
regulator-name = "vcamio";
regulator-min-microvolt = <1800000>;
regulator-max-microvolt = <1800000>;
regulator-enable-ramp-delay = <100>;
};
&mt6359_vcamd_reg {
regulator-name = "vcamd";
regulator-min-microvolt = <1200000>;
regulator-max-microvolt = <1200000>;
regulator-enable-ramp-delay = <100>;
};
在实际项目中,我遇到最多的就是电源时序问题。建议用示波器实际测量各电压的上电时序,确保与传感器规格书一致。记得有一次,因为DVDD比AVDD早上电了1ms,导致传感器无法正常工作。
4. 传感器驱动注册与初始化
传感器驱动的注册涉及到多个文件的配合修改,这是整个Porting过程中最需要细心的地方。
首先在kd_imgsensor.h中定义传感器ID和名称:
/* 内核空间定义 */
#define OV64B_MIPI_RAW_SENSOR_ID 0x648B
#define SENSOR_DRVNAME_OV64B_MIPI_RAW "ov64b_mipi_raw"
/* 用户空间定义(必须与内核空间一致) */
#define OV64B_MIPI_RAW_SENSOR_ID 0x648B
#define SENSOR_DRVNAME_OV64B_MIPI_RAW "ov64b_mipi_raw"
传感器列表注册需要在imgsensor_sensor_list.c中完成:
struct IMGSENSOR_INIT_FUNC_LIST kdSensorList[MAX_NUM_OF_SUPPORT_SENSOR] = {
#if defined(OV64B_MIPI_RAW)
{
OV64B_MIPI_RAW_SENSOR_ID, // 传感器ID
SENSOR_DRVNAME_OV64B_MIPI_RAW, // 传感器驱动名称
OV64B_MIPI_RAW_SensorInit // 初始化函数
},
#endif
/* 其他传感器... */
{0, {0}, NULL} // 结束标记
};
初始化函数实现在传感器的cpp文件中:
UINT32 OV64B_MIPI_RAW_SensorInit(struct SENSOR_FUNCTION_STRUCT **pfFunc)
{
if (pfFunc != NULL) {
*pfFunc = &sensor_func; // 注册传感器函数结构体
}
// 检查传感器状态
if (sensor_check_id() != ERROR_NONE) {
pr_err("OV64B sensor check ID failed!\n");
return ERROR_SENSOR_CONNECT_FAIL;
}
return ERROR_NONE;
}
HAL层注册同样重要,需要在sensorlist.cpp中添加:
MSDK_SENSOR_INIT_FUNCITON_STUTCT SensorList[] = {
#if defined(OV64B_MIPI_RAW)
RAW_INIFO(OV64B_MIPI_RAW_SENSOR_ID,
SENSOR_DRVNAME_OV64B_MIPI_RAW,
NULL),
#endif
/* 其他传感器... */
};
这里有个关键注意事项:内核空间的kdSensorList和用户空间的SensorList中的传感器顺序必须完全一致!我曾经因为顺序不一致导致相机预览花屏,调试了很久才发现是这个原因。
调试技巧:可以在初始化函数中添加详细的日志输出,帮助定位问题:
pr_debug("OV64B sensor init start\n");
if (pfFunc == NULL) {
pr_err("pfFunc is NULL!\n");
return ERROR_NONE;
}
5. 电源时序与硬件配置
电源时序配置是Sensor Porting中最精细的部分,直接关系到传感器能否正常工作。MTK平台提供了灵活的电源管理机制,支持GPIO和PMIC两种供电方式。
硬件配置表在imgsensor_cfg_table.c中定义:
struct IMGSENSOR_HW_CFG imgsensor_custom_config[] = {
{
IMGSENSOR_SENSOR_IDX_MAIN, // 主摄索引
IMGSENSOR_I2C_DEV_0, // I2C设备号
{
{IMGSENSOR_HW_PIN_MCLK, IMGSENSOR_HW_ID_MCLK},
{IMGSENSOR_HW_PIN_AVDD, IMGSENSOR_HW_ID_GPIO}, // AVDD使用GPIO控制
{IMGSENSOR_HW_PIN_DOVDD, IMGSENSOR_HW_ID_REGULATOR}, // DOVDD使用PMIC
{IMGSENSOR_HW_PIN_DVDD, IMGSENSOR_HW_ID_GPIO},
{IMGSENSOR_HW_PIN_PDN, IMGSENSOR_HW_ID_GPIO}, // 功率下降引脚
{IMGSENSOR_HW_PIN_RST, IMGSENSOR_HW_ID_GPIO}, // 复位引脚
{IMGSENSOR_HW_PIN_NONE, IMGSENSOR_HW_ID_NONE}, // 结束标记
},
},
};
电源序列配置需要严格按照传感器规格书来设置:
struct IMGSENSOR_HW_POWER_SEQ sensor_power_sequence[] = {
#if defined(OV64B_MIPI_RAW)
{
SENSOR_DRVNAME_OV64B_MIPI_RAW,
{
{PDN, Vol_Low, 0}, // 先将PDN拉低
{RST, Vol_Low, 1}, // 复位引脚拉低,延时1ms
{DOVDD, Vol_1800, 1}, // 开启DOVDD 1.8V,延时1ms
{DVDD, Vol_1200, 1}, // 开启DVDD 1.2V,延时1ms
{AVDD, Vol_2800, 1}, // 开启AVDD 2.8V,延时1ms
{SensorMCLK, Vol_High, 2}, // 开启MCLK,延时2ms
{PDN, Vol_High, 0}, // PDN拉高
{RST, Vol_High, 2} // 复位引脚拉高,延时2ms后完成初始化
},
},
#endif
};
实际调试经验:电源时序的调试需要耐心和细致的测量。我建议使用示波器同时测量所有电源引脚和控制引脚,确保时序完全符合规格书要求。特别是延时时间,即使相差1ms也可能导致传感器无法正常工作。
常见问题排查:
- 如果传感器完全无响应,首先检查AVDD、DVDD、DOVDD三个电压是否正常
- 检查MCLK时钟是否有输出,频率是否正确
- 确认I2C通信是否正常,可以通过i2cdetect工具检测
- 检查复位序列是否正确,包括复位引脚的电平变化
功耗优化:在电源序列配置时,还要考虑功耗优化。比如在传感器不需要工作时及时关闭电源,合理安排电源开启顺序来降低峰值电流等。
6. 调试与验证方法
传感器Porting完成后,我们需要进行全面的调试和验证。MTK提供了一套完整的调试工具链,可以帮助我们快速定位问题。
基本验证命令:
# 进入adb shell
adb shell
# 查看传感器是否被正确识别
cat /proc/device-tree/camera*
# 检查I2C通信
i2cdetect -y 0 # 检测I2C总线0上的设备
使用sentest工具验证:
# 获取传感器列表
adb shell sentest
# 测试主摄预览
adb shell sentest 1 0
# 测试主摄拍照
adb shell sentest 1 1
# 测试前摄视频
adb shell sentest 2 2
sentest输出解析很重要,我们需要关注几个关键信息:
- sensorNum:检测到的传感器数量
- SensorDevIdx:传感器设备索引(主摄=1,前摄=2,后辅摄=4)
- fps:帧率是否正常
- mipi rate:MIPI数据传输速率
日志调试是定位问题的关键手段:
# 开启相机详细日志
adb shell setprop persist.vendor.mtk.camera.log_level 2
adb shell setprop persist.vendor.mtk.camera.debug 1
# 查看内核日志
adb shell dmesg | grep -i camera
# 查看相机相关日志
adb logcat | grep -i cam
常见问题排查技巧:
-
传感器无响应:
- 检查电源时序是否正确
- 确认I2C地址是否正确
- 验证MCLK时钟信号
-
图像质量问题:
- 检查 tuning参数是否正确
- 确认分辨率配置
- 验证数据格式匹配
-
性能问题:
- 检查帧率配置
- 确认MIPI数据传输速率
- 验证内存带宽是否足够
实际案例分享:有一次我在调试时遇到传感器偶尔识别失败的问题,最终发现是电源稳定性问题。在AVDD上电后增加了5ms的稳定时间,问题就解决了。这种间歇性问题最考验调试耐心,需要仔细分析日志和硬件信号。
自动化测试:建议编写简单的测试脚本,自动化执行各种测试场景:
#!/bin/bash
# 自动化测试脚本
echo "开始传感器测试..."
# 测试所有传感器
for dev in 1 2 4; do
for scenario in 0 1 2; do
echo "测试设备$dev,场景$scenario"
adb shell sentest $dev $scenario
sleep 1
done
done
通过全面的测试和验证,我们可以确保传感器在各种工作模式下都能稳定运行,为后续的图像质量调试打下坚实基础。
5078



被折叠的 条评论
为什么被折叠?



