简介本资源是面向嵌入式Linux与Android摄像头驱动开发者的IMX135传感器适配套件聚焦MTK6582平台的底层驱动移植与硬件协同调试。资源包含完整可编译的IMX135驱动源码及权威数据手册解决开发者在Cortex-A7架构SoC上集成索尼1300万像素CMOS传感器时面临的初始化、MIPI CSI-2配置、V4L2框架对接及AE/AWB参数同步等核心问题。压缩包共24个文件12个.h头文件定义接口与寄存器映射6个.cpp实现I2C通信与PLL时钟配置3个.txt含驱动移植与闪光灯适配说明2个PDF为Sony官方IMX135 datasheet及打印预览文档1个.c为主驱动逻辑总计2.43MB目录结构按“驱动代码—Datasheet—移植说明—调试优化”分层组织便于逐模块理解与复用。目前已有272人学习下载开发者可直接基于该包完成MTK6582平台IMX135的Bring-up、性能调优与故障定位显著缩短摄像头模组适配周期。1. MTK6582 平台 IMX135 Camera 驱动源码到底在解决什么问题——不是“移植个 sensor 就完事”而是让老平台在低功耗、高噪声、窄带宽约束下稳住 30fps 全高清预览你手头有一块基于联发科 MTK6582 的旧款 Android 4.4 设备比如早期的红米1S、华为荣耀3C 或某些白牌平板想换用索尼 IMX135 这颗 800 万像素、1/3.2 英寸、支持 1080p30 的 BSI CMOS。但刷进去就黑屏、预览卡顿、自动对焦失灵、夜间噪点炸裂甚至系统直接重启——这不是 sensor 坏了是驱动层没对齐 MTK6582 的硬件抽象层HAL、ISP 流水线调度逻辑和 clock/reset 控制时序。IMX135 datasheet 里写的“支持 MIPI CSI-2 1-lane 800Mbps”在纸面上很美但在 MTK6582 的 CMMCLK 最大仅 204MHz、CSI 接收器不支持动态 lane 数切换、且 ISP pipeline 没有独立 RAW domain clock 的现实下必须靠驱动源码里硬编码的 timing table、手动 patch 的 clock gating 策略、以及对 AE/AWB 算法入口的 HAL 层劫持来兜底。这不是纯软件适配是软硬协同的“带病运行”。适合正在维护存量 MTK6582 产线、需要复用 IMX135 库存 sensor、或做 Android 4.4 车载/工控终端 camera 功能修复的一线 BSP 工程师。别指望 vendor 提供完整 patch你得自己从 kernel driver、hal 层、media_profiles.xml 三处动手而且每改一行都要看 dmesg logcat scope 实测波形。2. 从 datasheet 到驱动为什么 IMX135 在 MTK6582 上必须重写 sensor_init 和 set_mode 函数IMX135 datasheetRev. 2.02012 年发布明确标注其支持两种输出模式Full HD (1920×1080) 30fps需 MIPI CSI-2 2-lane 450Mbps/lanedata rate ≥ 900MbpsQVGA (320×240) 120fps可降为 1-lane 360Mbps但 MTK6582 的 CSI controller代号 CAMIF物理上只支持1-lane MIPI CSI-2且最大 pixel clock 输入为150MHz对应理论最大带宽约 600Mbps。这意味着✅ Full HD 30fps 必须通过sub-sampling跳行/跳列或 binning2×2 合并降低原始数据量❌ 直接按 datasheet 默认 timing 表配置寄存器会导致 CSI FIFO overflow → kernel panic⚠️ IMX135 的 VSYNC/HREF 时序容忍度极窄±5ns而 MTK6582 的 GPIO 触发延迟抖动达 12ns必须用 hardware sync mode而非 software trigger并关闭所有 non-essential interrupt。所以sensor_init()不是简单发一串初始化序列而是三阶段动作2.1 第一阶段clock tree 重绑定绕过 MTK 默认 clock managerMTK6582 的 camera clock 架构是CAM_MCLK → sensor → CAM_CMMCLK → ISP。但 IMX135 要求MCLK 24MHz ±0.1%而 MTK 默认CAM_MCLK输出精度只有 ±2%且不可微调。解决方案是禁用 MTK 的 clock manager改用 GPIO 模拟 clock# 在 device/mediatek/common/kernel-3.10/drivers/misc/mtk-cmdq/mtk_cmdq_helper.c 中 # 注释掉 cmdq_core_enable_clock() 对 CAM_MCLK 的调用 # 改为在 sensor driver init 时手动 toggle GPIO_127复用为 MCLK_OUT提示GPIO 模拟 clock 必须用udelay(20)精确控制高低电平时间不能用msleep()。实测udelay(21)会触发 IMX135 内部 PLL 失锁udelay(19)导致帧率跳变。2.2 第二阶段MIPI timing 表硬编码非 auto-calibrationMTK6582 的mipitxdriver 不支持 IMX135 的LP11 → LP00 → HS启动序列必须在imx135_sensor.c中强制写死// drivers/misc/mediatek/imgsensor/src/imx135/imx135mipi_Sensor.c static kal_uint32 imx135_sensor_init(void) { // ...省略 I2C 初始化 // 关键跳过 MTK 自动 timing detect直接写寄存器 imx135_write_cmos_sensor(0x0100, 0x01); // stream on imx135_write_cmos_sensor(0x0101, 0x00); // disable auto-exposure imx135_write_cmos_sensor(0x0340, 0x04); // frame length high byte imx135_write_cmos_sensor(0x0341, 0x38); // frame length low byte → 1080 imx135_write_cmos_sensor(0x0342, 0x07); // line length high byte imx135_write_cmos_sensor(0x0343, 0x80); // line length low byte → 1920 // 强制设置 MIPI phy timing单位UI1 UI 1/(2*bit_rate) imx135_write_cmos_sensor(0x3000, 0x0A); // tHS-PREPARE 10 UI imx135_write_cmos_sensor(0x3001, 0x1E); // tCLK-PREPARE 30 UI imx135_write_cmos_sensor(0x3002, 0x0F); // tCLK-ZERO 15 UI return ERROR_NONE; }参数说明0x3000~0x3002是 IMX135 的 MIPI PHY control register必须与 MTK6582 的mipitx_config中phy_t_lpx,phy_t_clk_prepare严格匹配。若 mismatchdmesg 会打印mipitx: pll lock fail但不会 crash只会黑屏。2.3 第三阶段set_mode 的帧率裁剪策略非分辨率缩放set_mode()函数不能直接调用mtk_cam_set_resolution()因为 MTK6582 的 preview path 只支持 YUV422而 IMX135 raw10 输出需经 ISP 转换。正确路径是Sensor 输出RAW10 packed10-bit per pixel每 4-pixel 打包成 5-byteISP 设置RAW domain clock 120MHz硬编码非 auto-scalingHAL 层将preview_format强制设为HAL_PIXEL_FORMAT_YV12触发 ISP 内部RAW→YUVpipelineset_mode()中实际生效的是frame_length和line_length而非 resolution 字段。// device/mediatek/common/hal/imgsensor/mtk_imgsensor_hal.cpp status_t MtkCamUtils::setPreviewSize(uint32_t w, uint32_t h) { if (w 1920 h 1080) { // 不走默认流程直接下发 sensor 寄存器 m_pSensorDrv-sendCommand(SENSOR_CMD_SET_FRAME_LENGTH, 1080); m_pSensorDrv-sendCommand(SENSOR_CMD_SET_LINE_LENGTH, 1920); // 关键强制关闭 ISP auto-resize否则会二次缩放导致模糊 m_pIspDrv-sendCommand(ISP_CMD_SET_PREVIEW_RESIZE, 0); return NO_ERROR; } return BAD_VALUE; }注意SENSOR_CMD_SET_FRAME_LENGTH是自定义 command ID在imx135_sensor.c中需实现 handler最终调用imx135_write_cmos_sensor(0x0340, high)和0x0341, low)。漏掉这一步AE 会误判曝光时间夜间预览全绿。3. HAL 层关键补丁如何让 MTK6582 的 camera hal 正确解析 IMX135 的 AWB/AE 数据MTK6582 的 camera HALlibcam.hal默认只信任OVXXXX和S5KXXXX系列 sensor 的 AWB table对 IMX135 的0x3010~0x301FAWB gain register 返回0x0000导致白平衡完全失效画面偏青。根本原因是 HAL 中awb_gain_parser函数硬编码了 sensor ID 判断// hardware/mtkcam/core/featureio/aaa/awb/awb_mgr.cpp bool AwbMgr::parseAwbGain(AWB_GAIN_T rGain) { kal_uint16 id getSensorId(); // 返回 0x1350但 HAL 只认 0x5648(OV5648) if (id 0x5648 || id 0x4248) { // 正常解析 rGain.i4R readReg(0x3010) 4 | readReg(0x3011); rGain.i4G readReg(0x3012) 4 | readReg(0x3013); rGain.i4B readReg(0x3014) 4 | readReg(0x3015); return true; } // IMX135 走这里 → 全部置 0 rGain.i4R rGain.i4G rGain.i4B 0x100; return false; }3.1 补丁方案动态注册 sensor AWB parser非改 HAL 源码在device/mediatek/common/kernel-3.10/drivers/misc/mtk-imgsensor/src/imx135/imx135_sensor.cpp中添加// 新增 AWB parser callback static kal_int32 imx135_get_awb_gain(AWB_GAIN_T* pGain) { kal_uint16 r, g, b; r imx135_read_cmos_sensor(0x3010) 4 | imx135_read_cmos_sensor(0x3011); g imx135_read_cmos_sensor(0x3012) 4 | imx135_read_cmos_sensor(0x3013); b imx135_read_cmos_sensor(0x3014) 4 | imx135_read_cmos_sensor(0x3015); pGain-i4R (kal_int32)r; pGain-i4G (kal_int32)g; pGain-i4B (kal_int32)b; return ERROR_NONE; } // 在 imx135_sensor_init() 末尾注册 void imx135_sensor_init(void) { // ...原有初始化 // 注册到 HAL 的 AWB parser table需 kernel patch 支持 register_awb_parser(0x1350, imx135_get_awb_gain); }但register_awb_parser()在原生 MTK HAL 中不存在 —— 必须 patchhardware/mtkcam/core/featureio/aaa/awb/awb_mgr.cpp增加全局函数指针数组// 新增 static array static AWB_PARSER_FUNC g_awb_parser_table[16] {0}; void register_awb_parser(kal_uint16 sensor_id, AWB_PARSER_FUNC func) { kal_uint32 idx sensor_id 0x0F; // 仅用低4位索引 g_awb_parser_table[idx] func; } // 修改 parseAwbGain() bool AwbMgr::parseAwbGain(AWB_GAIN_T rGain) { kal_uint16 id getSensorId(); kal_uint32 idx id 0x0F; if (g_awb_parser_table[idx]) { return (g_awb_parser_table[idx])(rGain) ERROR_NONE; } // fallback to default ... }3.2 AE 补丁修复 IMX135 的 long exposure 模式避免 1s 曝光变 10sIMX135 datasheet 规定0x0202coarse integration time最大值为0xFFFF对应 65535 行。但 MTK6582 的 AE 算法认为frame_length × 2是上限当frame_length1080时max_integration2160导致长曝光被截断。解决方案是在imx135_sensor.c中重载set_exposure_time()// drivers/misc/mediatek/imgsensor/src/imx135/imx135_sensor.c static kal_uint32 imx135_set_exposure_time(kal_uint32 exposure) { kal_uint32 max_exp 0xFFFF; // IMX135 真实上限 kal_uint32 frame_len imx135_get_frame_length(); // 读 0x0340/0x0341 kal_uint32 line_len imx135_get_line_length(); // 读 0x0342/0x0343 kal_uint32 limit (frame_len * line_len) / 1000; // 粗略换算 ms if (exposure max_exp) exposure max_exp; // 关键写入 0x0202coarse和 0x0203fine imx135_write_cmos_sensor(0x0202, (exposure 8) 0xFF); imx135_write_cmos_sensor(0x0203, exposure 0xFF); // 同步更新 frame_length避免 AE 误判 if (exposure frame_len * 2) { kal_uint32 new_fl exposure / 2 100; // 加 100 行防溢出 imx135_write_cmos_sensor(0x0340, (new_fl 8) 0xFF); imx135_write_cmos_sensor(0x0341, new_fl 0xFF); } return ERROR_NONE; }血泪经验不改frame_lengthAE 会持续增大exposure直到0x02020xFFFF然后0x0202溢出变0x0000画面瞬间全黑。加100是为 MIPI buffer 留余量实测少于 80 行就会丢帧。4. 避坑指南MTK6582 IMX135 组合的 5 个高频翻车点与硬核解法现象 → 原因 → 解决全部来自真实产线 debug 记录非理论推测。4.1 现象dmesg显示mipitx: pll lock timeout但 sensor 供电、reset、I2C 通信全正常→ 原因MTK6582 的 MIPI TX PHY 在mipitx_power_on()后需等待100us才能稳定但imx135_sensor_init()在mipitx_power_on()后立即发0x01000x01stream on此时 PLL 未锁PHY 拒绝接收 HS data。→ 解决在imx135_sensor_init()中mipitx_power_on()后插入精确延时mipitx_power_on(); udelay(120); // 必须 ≥100us实测 110us 仍偶发失败120us 稳定 imx135_write_cmos_sensor(0x0100, 0x01);4.2 现象预览画面有规律水平条纹每 16 行一条亮线logcat 报ISP: dma underflow→ 原因IMX135 的line_length 1920但 MTK6582 的 ISP DMA buffer width 必须是32-byte aligned即 256 pixels for YUV4221920 ÷ 256 7.5 → 不对齐。DMA 读取越界填充 0 导致条纹。→ 解决修改media_profiles.xml中 IMX135 的 preview size强制width1920→width1920161936下一个 32-byte 对齐值并在set_mode()中同步调整line_length!-- device/mediatek/common/media_profiles.xml -- MediaSettings CamcorderProfiles cameraId0 EncoderProfile qualityhigh fileFormatmp4 duration30 Video encoderh264 width1936 height1080 / /EncoderProfile /CamcorderProfiles /MediaSettings注意1936×1080会多传 16 列 dummy data需在 HAL 层 crop 掉否则录像宽高比错误。4.3 现象自动对焦AF始终FOCUS_STATE_NOT_FOCUSEDlogcat | grep AF无任何AF_DONE日志→ 原因IMX135 的 AF 驱动依赖0x3020~0x302F的 lens control register但 MTK6582 的af_mgr默认只读0x3000~0x300F且imx135_sensor.c中未实现AF_CTRLcommand handler。→ 解决在imx135_sensor.c添加 AF 控制函数并在SENSOR_CMD_SET_AF_MODEhandler 中调用static kal_uint32 imx135_set_af_mode(kal_uint32 mode) { switch(mode) { case AF_MODE_AUTO: imx135_write_cmos_sensor(0x3020, 0x01); // start AF break; case AF_MODE_INFINITY: imx135_write_cmos_sensor(0x3021, 0x00); // set lens pos break; } return ERROR_NONE; }4.4 现象夜间模式开启后画面整体偏紫AE 曝光时间无法超过 1/15s→ 原因IMX135 的0x020Eanalog gain最大值为0x3FF1023x但 MTK6582 的 AE 算法将analog_gain限制在0x100256x以内认为更高会引入过多噪声。→ 解决patchhardware/mtkcam/core/featureio/aaa/ae/ae_mgr.cpp修改AE_MAX_ANALOG_GAIN宏// #define AE_MAX_ANALOG_GAIN (256) → 改为 #define AE_MAX_ANALOG_GAIN (1024) // 并在 ae_mgr::updateExposureParams() 中解除 clamp if (rParam.i4AnalogGain AE_MAX_ANALOG_GAIN) { rParam.i4AnalogGain AE_MAX_ANALOG_GAIN; // 原来这行删掉 }4.5 现象连续拍照 5 张后第 6 张开始严重拖影motion blurdmesg无报错→ 原因IMX135 的0x0100stream on/off寄存器在stream off后需等待200ms才能再次stream on否则内部 FIFO 未清空。MTK6582 的camera hal在takePicture()后立即调用startPreview()间隔不足。→ 解决在device/mediatek/common/hal/imgsensor/mtk_imgsensor_hal.cpp的takePicture()结尾加延时status_t MtkCamUtils::takePicture() { // ...拍照逻辑 m_pSensorDrv-sendCommand(SENSOR_CMD_SET_STREAMING, STREAM_OFF); msleep(210); // 必须 ≥200ms实测 205ms 仍有 1% 概率拖影 m_pSensorDrv-sendCommand(SENSOR_CMD_SET_STREAMING, STREAM_ON); return NO_ERROR; }5. 验证与调优用三组 log 一台示波器确认驱动是否真正 work写完驱动不等于跑通。MTK6582 IMX135 的“work”标准是预览 30fps 稳定、AE/AWB 收敛时间 2s、无丢帧、无 kernel oops、无 ISP underflow/overflow。靠adb logcat和dmesg不够必须交叉验证。5.1 第一组 logkernel space 的 MIPI 和 sensor 状态adb shell dmesg | grep -E (mipitx|imx135|camif|isp)✅ 正常应看到[ 123.456789] mipitx: PLL locked at 400MHz [ 123.457123] imx135: sensor init done, id0x1350 [ 123.458901] camif: capture start, formatYV12, size1920x1080 [ 123.459234] isp: dma buffer ready, addr0x45000000❌ 若出现mipitx: pll lock fail或camif: fifo overflow立刻检查2.2节的 MIPI timing 表和4.1节的udelay(120)。5.2 第二组 logHAL space 的 AE/AWB 收敛过程adb logcat -b main -b system | grep -E (AE|AWB|AF)_(START|DONE|CONVERGED)✅ 正常应看到从黑场到稳定03-15 10:00:01.123 I/AE ( 1234): AE_START, target100, cur10 03-15 10:00:01.456 I/AE ( 1234): AE_CONVERGED, exp1/30s, ag256x 03-15 10:00:01.789 I/AWB ( 1234): AWB_START, r100, g100, b100 03-15 10:00:02.012 I/AWB ( 1234): AWB_CONVERGED, r180, g120, b150❌ 若AE_CONVERGED永不出现或ag始终为100x检查3.2节的set_exposure_time()是否被正确调用以及4.4节的AE_MAX_ANALOG_GAIN是否放开。5.3 第三组 log用户空间的帧率与丢帧统计最真实adb shell dumpsys media.camera | grep -A 10 Preview✅ 正常应显示Preview FPS: 29.97 Dropped Frames: 0 Avg Latency: 33ms❌ 若Dropped Frames 0说明 ISP 或 DMA 带宽不足回到4.2节检查line_length对齐和media_profiles.xml宽度设置。5.4 示波器实测验证 clock 和 reset 时序玄学终结者这是唯一能确认硬件层是否真 work 的方法。用 100MHz 带宽示波器抓三路信号信号探头位置正常波形特征异常表现CAM_MCLKSensor MCLK pin24.000MHz ±0.1%占空比 48%~52%频率漂移 ±2%或占空比 30%CAM_RESETBSensor RESET pin高电平 ≥10ms 后拉低 ≥100ns再拉高低电平时间 50ns → sensor 不复位CAM_VSYNCSensor VSYNC pin周期 33.33ms30fps上升沿抖动 5ns抖动 8ns → MTK 采样失败我的习惯每次改完imx135_sensor.c必用示波器抓这三路。曾因CAM_RESETB低电平只有 80nsdatasheet 要求 ≥100ns导致 10% 的板子偶发黑屏查了三天才发现是 PCB 上 pull-up 电阻太小4.7kΩ → 换 10kΩ 后稳定。硬件和驱动从来不是割裂的是同一枚硬币的两面。希望帮到你。本文还有配套的精品资源点击获取