目录
摘要
1 引言
2 硬件电路设计
3 设备树配置
3.1 Overlay 文件
3.2 多通道命名
4 C 代码实现
5 典型故障分析
5.1 错误 -22（EINVAL）：Channel 0 not configured
5.2 数值异常与噪声抑制
6 结论
摘要
光敏传感器是嵌入式环境感知的基础组件。本文基于 nRF Connect SDK（NCS）平台，系统阐述了光敏电阻（LDR）与光敏晶体管两类模拟光敏器件通过 SAADC 外设实现光照检测的完整方法。文章从硬件分压电路、设备树配置、ADC 序列参数与工程调试四个层面展开，重点分析了 nRF5340 上常见的“Channel 0 not configured”错误机理及其基于设备树 Overlay 的解决方案。研究表明，NCS 中 SAADC 的通道配置已从传统寄存器编程完全迁移至设备树声明，正确编写 Overlay 是功能实现的前提条件。
关键词：光敏传感器；SAADC；nRF Connect SDK；设备树；模拟数字转换
1 引言
光敏传感器通过光电效应将光照强度转换为电信号，是自动照明、显示背光调节与环境监测的核心器件。光敏电阻（如硫化镉 LDR）阻值随光照增强而下降，光敏晶体管（如 Everlight ALS-PT19）则输出随光照变化的电流信号。
nRF 系列 SoC 集成了逐次逼近型 ADC（SAADC），支持 8 路单端输入通道，分辨率可达 8/10/12/14 位。在 NCS 框架下，SAADC 的使用方式与旧版 nRF5 SDK 有本质区别：通道的引脚映射、增益、参考电压等参数均通过设备树声明，而非在 C 代码中以宏定义硬编码。这一架构转变导致许多从 nRF5 SDK 迁移的开发者遭遇配置错误。
本文旨在给出 NCS 平台下光敏传感器数据采集的规范化实现路径，并针对典型故障提供诊断依据。
2 硬件电路设计
光敏器件通常以分压电路形式接入 ADC 输入引脚。以光敏电阻为例，典型连接方式为：VDD → LDR → ADC 输入引脚 → 固定电阻（如 10 kΩ）→ GND。
在此拓扑下，输出电压与光照强度呈反比关系：光照增强 → LDR 阻值下降 → 分压点电压上升。但也有实现采用相反配置，将 LDR 置于下臂，此时光照增强导致输出电压下降。代码中的光照百分比换算公式必须与硬件拓扑保持一致，否则数值语义将发生反转。
以 XIAO nRF52840 平台为例，其光敏电阻分压电路的实测数据为：强光条件下 ADC 原始值约 200–500（电压 0.2–0.4 V，光照约 75–95%）；暗环境下原始值约 2500–4000（电压 2.0–3.2 V，光照约 0–25%）。该数据可作为阈值设定的参考基准。
3 设备树配置
3.1 Overlay 文件
NCS 的samples/drivers/adc示例不包含 nRF5340 的 Overlay 文件，需开发者自行编写。以下为针对 P0.04（对应 AIN0）的 Overlay 示例：
/ { zephyr,user { io-channels = <&adc 0>; }; }; &adc { #address-cells = <1>; #size-cells = <0>; channel@0 { reg = <0>; zephyr,gain = "ADC_GAIN_1_6"; zephyr,reference = "ADC_REF_INTERNAL"; zephyr,acquisition-time = <ADC_ACQ_TIME_DEFAULT>; zephyr,input-positive = <NRF_ADC_AIN0>; /* P0.04 */ zephyr,resolution = <12>; }; };上述配置的关键参数含义如下：
zephyr,gain设为ADC_GAIN_1_6，对应约 0.6 V 的内部参考电压。若光敏分压电路的输出电压可能超过该范围，需改用ADC_REF_VDD_1_4或外部参考。
zephyr,input-positive将 ADC 通道映射至物理引脚。nRF5340 的NRF_ADC_AIN0对应 P0.04，这一映射关系在数据手册中固定不可重映射。
zephyr,resolution设为 12 位时，原始值范围为 0–4095。
3.2 多通道命名
若系统同时使用光敏传感器与其他模拟传感器，可通过io-channel-names为各通道赋予语义标签：
zephyr,user { io-channels = <&adc 0>, <&adc 1>; io-channel-names = "LIGHT_SENSOR", "TEMP_SENSOR"; };C 代码中可通过ADC_DT_SPEC_GET_BY_NAME(DT_PATH(zephyr_user), LIGHT_SENSOR)获取对应通道的adc_dt_spec，从而避免硬编码通道编号，提升代码可移植性。
4 C 代码实现
#include <zephyr/drivers/adc.h> #define ADC_NODE DT_NODELABEL(adc) static const struct device *adc_dev = DEVICE_DT_GET(ADC_NODE); #define ADC_CHANNEL_ID 0 static const struct adc_dt_spec adc_ch = ADC_DT_SPEC_GET_BY_IDX(DT_PATH(zephyr_user), 0); int16_t sample_buffer[1]; void main(void) { int ret; if (!device_is_ready(adc_dev)) { printk("ADC device not ready\n"); return; } struct adc_sequence seq = { .channels = BIT(ADC_CHANNEL_ID), .buffer = sample_buffer, .buffer_size = sizeof(sample_buffer), .resolution = 12, }; while (1) { ret = adc_read(adc_dev, &seq); if (ret != 0) { printk("ADC read failed: %d\n", ret); k_msleep(500); continue; } int32_t mv = sample_buffer[0]; adc_raw_to_millivolts(adc_ref_internal(adc_dev), ADC_GAIN_1_6, 12, &mv); printk("Light sensor: %d mV\n", mv); k_msleep(500); } }注意adc_raw_to_millivolts的增益参数必须与设备树中zephyr,gain声明一致，否则换算结果将产生系统性偏差。
5 典型故障分析
5.1 错误 -22（EINVAL）：Channel 0 not configured
这是 nRF5340 上最普遍的首发错误。开发者启用CONFIG_ADC=y并在 C 代码中调用adc_channel_setup()，却忽略了 NCS 中通道配置已迁移至设备树的事实。错误日志表现为：
<err> adc_nrfx_saadc: Channel 0 not configured read failed -22解决方案是编写正确的 Overlay 文件，在设备树中声明channel@0节点及其input-positive属性。此后 C 代码中的adc_channel_setup()调用通常可省略，驱动会在首次adc_read时依据设备树自动完成通道初始化。
5.2 数值异常与噪声抑制
光敏电阻的响应时间较长（数十至数百毫秒），高速采样并无必要。若 ADC 读数出现剧烈抖动，可考虑在硬件层面添加 RC 滤波（如 82 nF 电容与弱下拉电阻并联），或在软件层面进行多次采样取均值。
此外，若使用 nRF5340 DK 的 VDD 直接为分压电路供电，应注意 ADC 参考电压与供电电压的一致性。当zephyr,reference设为ADC_REF_INTERNAL时，驱动使用内部参考源，与 VDD 波动解耦，精度更优。
6 结论
本文给出了 NCS 平台下光敏传感器接入 SAADC 的完整技术路径。核心结论为：NCS 中 ADC 通道的引脚映射与电气参数必须通过设备树 Overlay 声明，C 代码仅负责序列配置与数据读取。对于从 nRF5 SDK 迁移的项目，应放弃基于nrf_drv_saadc_channel_init的传统写法，转而采用adc_dt_spec与adc_read_dt的现代 API。光敏传感器的光照阈值应在实际环境中通过实测标定，不可依赖理论计算。