RK3566 Android11平台STK3311X传感器调试全记录：从DTS配置到中断处理

RK3566 Android11平台STK3311X传感器深度调试指南：从硬件设计到功耗优化

1. STK3311X传感器与RK3566平台集成概述

STK3311X作为一款集成了环境光传感(ALS)和接近传感(PS)功能的复合传感器，在移动设备中具有广泛的应用场景。在RK3566+Android11平台上，其典型应用包括：

• 自动背光调节：根据环境光照度动态调整屏幕亮度
• 接近检测：通话时自动关闭屏幕防止误触
• 节能优化：通过智能检测策略降低系统功耗

硬件设计上需要注意以下关键点：

• I2C接口：标准400kHz通信速率，需确保信号完整性
• 中断引脚：GPIO0_PD4用于接近检测中断触发
• 电源管理：典型工作电压3.3V，峰值电流可达100mA

传感器主要技术参数对比：

2. 设备树(DTS)配置详解

RK3566平台的设备树配置是传感器驱动的核心，需要特别注意光感与距离传感器的差异化配置：

ls_stk3x1x: light@48 {
    compatible = "ls_stk3x1x";
    status = "okay";
    reg = <0x48>;
    type = <SENSOR_TYPE_LIGHT>;
    irq_enable = <0>;  // 光感使用轮询模式
    als_threshold_high = <100>;  // 高阈值(单位lux)
    als_threshold_low = <10>;    // 低阈值
    als_ctrl_gain = <2>;         // 增益设置(0:x1 1:x4 2:x16 3:x64)
    poll_delay_ms = <100>;       // 轮询间隔
    layout = <1>;                // 传感器方位
};

ps_stk3x1x: proximity@48 {
    compatible = "ps_stk3x1x";
    status = "okay";
    reg = <0x48>;
    type = <SENSOR_TYPE_PROXIMITY>;
    pinctrl-names = "default";
    pinctrl-0 = <&al_det>;
    irq-gpio = <&gpio0 RK_PD4 IRQ_TYPE_LEVEL_LOW>;  // 中断引脚配置
    irq_enable = <1>;           // 启用中断模式
    ps_threshold_high = <0x200>; // 接近阈值高
    ps_threshold_low = <0x100>;  // 接近阈值低
    ps_ctrl_gain = <3>;         // 增益设置
    ps_led_current = <3>;       // LED电流(0:12.5mA 1:25mA 2:50mA 3:100mA)
    poll_delay_ms = <100>;      // 备用轮询间隔
};

关键参数优化建议：

1. 光感增益选择：

   • 室内环境：1-2级增益(4x-16x)
   • 户外强光：3级增益(64x)

2. 接近检测阈值：

   // 典型阈值设置
   #define PS_DEFAULT_THRESHOLD_HIGH  0x200  // 约50mm
   #define PS_DEFAULT_THRESHOLD_LOW   0x100  // 约30mm
   

3. 轮询间隔影响：

   • 100ms间