零知派——TCS3200颜色识别传感器模块

零知派开源平台为电子爱好者提供高性价比STM32开发板和物联网控制板，简化开发流程。本文详细介绍了TCS3200颜色传感器的硬件架构、接线方案、测试代码及实现原理。该传感器通过RGB三原色检测实现颜色识别，采用归一化算法自动适应不同光照条件。文章还列举了工业分拣、农业监测、医疗诊断等典型应用场景，并针对常见工程问题提供解决方案。配套的完整测试代码支持一键下载，帮助开发者快速实现颜色检测功能。

lingzhilab

347人浏览 · 2026-05-13 15:33:58

lingzhilab · 2026-05-13 15:33:58 发布

✔零知派（零知开源）是一个专为电子初学者/电子兴趣爱好者设计的开源软硬件平台，在硬件上提供超高性价比STM32系列开发板、物联网控制板。取消了Bootloader程序烧录，让开发重心从 “配置环境” 转移到 “创意实现”，极大降低了技术门槛。零知开源编程软件，内置上千个覆盖多场景的示例代码，支持项目源码一键下载，项目文章在线浏览。零知派(零知开源)平台通过软硬件协同创新，让你的创意快速转化为实物，来动手试试吧！

✔访问零知实验室，获取更多实战项目和教程资源吧！

www.lingzhilab.com

2.2 完整接线方案（基于零知派ESP32）

6.2 频率缩放配置陷阱（高增益不是越高越好）

6.3 电源与去耦问题（规格书强制要求）

6.4 测量时序与稳定时间（切换通道后必须等待）

6.5 电池供电场景的功耗管理（待机模式电流仅0.1μA）

6.6 常见故障速查表

一、模块外观与硬件架构

1.1 外观特征

TCS3200模块的主要可视特征包括：

组件	位置	描述
光学窗口	PCB中央	Φ10mm透明环氧树脂封装，内部集成TCS3200芯片
白光LED阵列	窗口四周	4颗1206封装高亮贴片LED，呈90°对称分布，作主动补光光源
信号排针	PCB边缘	8针2.54mm标准间距直插排针（6个有效信号 + VCC + GND）
电源指示灯	边角	红色SMD LED，VCC上电即亮
预留电阻位	背面	可能预留LED限流电阻调整位（部分型号支持PWM调光）

1.2 核心芯片TCS3200内部结构

TCS3200采用8引脚SOIC表贴封装，其内部包含以下几个功能模块：

光电二极管阵列

这是传感器的“视网膜”。64个二极管被平均分为四组，每组16个，分别覆盖：

红色滤光片（16个）
绿色滤光片（16个）
蓝色滤光片（16个）
透明无滤光片（16个，用于全光谱检测）

电流-频率转换器

当光照射到光电二极管上时，产生与光强成正比的光电流。该转换器将此微弱电流直接转换为方波脉冲信号——光电流越大，输出频率越高。

二、引脚定义与外部接线

2.1 引脚定义速查表

引脚	名称	I/O类型	电平标准	功能描述
1	S0	输入	CMOS/TTL	与S1组合设定满量程频率缩放因子
2	S1	输入	CMOS/TTL	与S0组合设定满量程频率缩放因子
3	OE	输入（低有效）	CMOS/TTL	输出使能：低电平=OUT有效，高电平=OUT高阻
4	OUT	输出	开漏（需上拉）	方波频率输出，内部无上拉电阻
5	VDD	电源	2.7V ~ 5.5V	芯片供电，推荐3.3V（与ESP32匹配）
6	GND	地	—	公共地
7	S2	输入	CMOS/TTL	与S3组合选择滤波器类型
8	S3	输入	CMOS/TTL	与S2组合选择滤波器类型
LED	LED	电源	3~5V	与VDD独立，推荐直接接5V以获得足够亮度

2.2 完整接线方案（基于零知派ESP32）

TCS3200模块引脚	ESP32引脚	说明
VDD	3.3V	芯片电源，与ESP32逻辑电平匹配
GND	GND	系统共地
OUT	GPIO 23	频率信号输入，ESP32内部弱上拉已足够
S0	GPIO 18	频率缩放MSB
S1	GPIO 19	频率缩放LSB
S2	GPIO 21	滤波器选择MSB
S3	GPIO 22	滤波器选择LSB
OE	GND	永久使能输出（也可接GPIO做软件控制）

2.3 频率缩放选项详解

S0	S1	缩放比例	输出频率范围（典型值）	适用场景
LOW	LOW	关断（Power Down）	0 Hz	省电模式
LOW	HIGH	2%	2k ~ 12kHz	极暗环境或低速应用
HIGH	LOW	20%	20k ~ 120kHz	通用推荐
HIGH	HIGH	100%	100k ~ 600kHz	快速动态检测

三、测试方法与完整代码

3.1 测试方法

准备工具

零知派开发工具，数据线，TCS3200模块，零知派esp32模块，跳线。

使用步骤

新建工程：打开零知派开发工具，新建一个空白工程。
粘贴代码：将上方完整代码复制到工程中，根据实际传感器和光照环境调整颜色检测部分阈值。
选择开发板：在软件右侧开发板列表中，选择ESP32。
编译上传：点击「验证」→「上传」，将程序烧录到 ESP32 开发板。
调试：打开软件串口调试窗口，将TCS3200传感器对准带有颜色的物体。就可以看到输出的颜色，如图：

3.2 完整测试代码

/******************************************************************************
 * 深圳市在芯间科技有限公司
 * 淘宝旗舰店：零知派
 * 网 址：https://shop533070398.taobao.com
 * 版权说明：
 *  1.本代码的版权归【深圳市在芯间科技有限公司】所有，仅限个人非商业性学习使用。
 *  2.严禁将本代码或其衍生版本用于任何商业用途（包括但不限于产品开发、付费服务、企业内部使用等）。
 *  3.任何商业用途均需事先获得【深圳市在芯间科技有限公司】的书面授权，未经授权的商业使用行为将被视为侵权。
******************************************************************************/

/**************************************************************************************
 * 文件: TCS3200.ino
 * 作者：零知派（深圳市在芯间科技有限公司）
 * -^^- 零知派，让电子制作变得更简单！ -^^-
 * 时间: 2026-05-013
 * 说明: 5V 供电（LED较亮，适合环境光较亮或需要远距离检测的场景）
 *      白平衡方式：归一化到 0-255 范围（自动适应，无需手动校准）
 *      支持颜色：红、橙、黄、绿、青、蓝、紫、黑、白
***************************************************************************************/
/*
 * TCS3200 颜色传感器 - ESP32 测试程序
 * ==================================================
 * 
 * 【接线定义】
 *   TCS3200      ->   ESP32
 *   -------------------------
 *   S0           ->   GPIO 18  (输出频率缩放控制)
 *   S1           ->   GPIO 19  (输出频率缩放控制)
 *   S2           ->   GPIO 21  (滤波器选择)
 *   S3           ->   GPIO 22  (滤波器选择)
 *   OUT          ->   GPIO 23  (频率信号输出)
 *   OE           ->   GND      (使能端，低电平有效，直接接地)
 *   LED          ->   VIN (5V) (LED照明，使用5V供电更亮)
 *   VDD          ->   3.3V     (芯片供电)
 *   GND          ->   GND
 * 
 * 【工作原理简述】
 *   TCS3200 内置 RGB 三种颜色的滤光器，通过 S2/S3 引脚选择当前要检测的颜色通道。
 *   传感器输出方波信号的频率与光强成正比（光越强，频率越高，脉宽越小）。
 *   本程序通过测量高电平脉宽（单位：微秒）来间接获取频率信息。
 *   脉宽越小 = 频率越高 = 光强越强。
 * 
 * 【频率缩放设置】
 *   S0=S1=HIGH -> 输出频率为 100% (最快，最灵敏)
 *   S0=HIGH, S1=LOW -> 输出频率为 20% (本程序使用，适合大多数情况)
 *   S0=LOW, S1=HIGH -> 输出频率为 2%
 *   S0=S1=LOW -> 关闭输出（省电模式）
 * 
 * 【颜色识别逻辑】
 *   1. 先读取原始 RGB 脉宽值（多次采样取平均，减少噪声）
 *   2. 归一化处理：将原始值转换为 0-255 的 RGB 标准值
 *   3. 基于归一化 RGB 值判断颜色（采用阈值比较法）
 * 
 * 【注意事项】
 *   - 传感器与被测物体距离建议保持 1-2cm
 *   - 环境光会影响读数，建议在遮光条件下使用
 *   - 不同颜色的物体反射率不同，可能需要微调颜色判断阈值
 *   - 白色物体用于白平衡校准（程序已自动归一化）
 * 
 */

// ==================== 引脚定义 ====================
#define S0 18         // 输出频率缩放控制引脚1
#define S1 19         // 输出频率缩放控制引脚2
#define S2 21         // 滤波器选择引脚1（颜色通道）
#define S3 22         // 滤波器选择引脚2（颜色通道）
#define OUT_PIN 23    // 频率信号输入引脚（来自传感器）

// ==================== 全局变量 ====================
// 原始脉宽值（单位：微秒，数值越小表示该颜色光强越强）
int rawR = 0;         // 红色通道原始值
int rawG = 0;         // 绿色通道原始值
int rawB = 0;         // 蓝色通道原始值

// 归一化后的 RGB 值（范围：0-255，标准 RGB 格式）
int normR = 0;        // 红色分量（255=最强红）
int normG = 0;        // 绿色分量（255=最强绿）
int normB = 0;        // 蓝色分量（255=最强蓝）

// 采样次数（用于平滑读数，提高稳定性）
const int SAMPLES = 5;    // 每个通道采5次取平均

// ==================== 初始化函数 ====================
void setup() {
  // 初始化串口通信（波特率 115200，用于输出调试信息）
  Serial.begin(115200);
  delay(500);                // 等待串口稳定
  
  // 配置所有控制引脚为输出模式
  pinMode(S0, OUTPUT);       // 频率缩放控制
  pinMode(S1, OUTPUT);
  pinMode(S2, OUTPUT);       // 颜色通道选择
  pinMode(S3, OUTPUT);
  pinMode(OUT_PIN, INPUT);   // 信号输入引脚
  
  // 设置输出频率缩放比例：S0=HIGH, S1=LOW -> 20% 频率
  digitalWrite(S0, HIGH);
  digitalWrite(S1, LOW);
  
  // 打印程序启动信息
  Serial.println("=================================");
  Serial.println("TCS3200 颜色传感器测试程序");
  Serial.println("频率缩放: 20%");
  Serial.println("白平衡: 自动归一化");
  Serial.println("=================================");
  Serial.println();
}

// ==================== 核心函数 ====================

/**
 * 读取指定颜色通道的脉宽值
 * 
 * 【功能】选择传感器的颜色滤波器，并测量输出方波的高电平脉宽。
 *         脉宽与光强成反比：脉宽越小 = 频率越高 = 光越强。
 * 
 * 【参数】color - 要读取的颜色通道
 *         'R' : 红色通道
 *         'G' : 绿色通道
 *         'B' : 蓝色通道
 * 
 * 【返回值】脉宽（单位：微秒）
 *          - 正常范围：几十到几千微秒
 *          - 返回 999999 表示超时（信号丢失或光线过暗）
 * 
 * 【注意事项】pulseIn() 会阻塞等待信号，最大等待时间1秒
 */
int readColor(char color) {
  // 根据颜色选择对应的滤波器（通过 S2、S3 设置）
  switch(color) {
    case 'R':  // 红色滤波器：S2=LOW,  S3=LOW
      digitalWrite(S2, LOW);
      digitalWrite(S3, LOW);
      break;
    case 'G':  // 绿色滤波器：S2=HIGH, S3=HIGH
      digitalWrite(S2, HIGH);
      digitalWrite(S3, HIGH);
      break;
    case 'B':  // 蓝色滤波器：S2=LOW,  S3=HIGH
      digitalWrite(S2, LOW);
      digitalWrite(S3, HIGH);
      break;
  }
  
  // 等待滤波器稳定（100微秒足够）
  delayMicroseconds(100);
  
  // 测量高电平脉宽，超时时间设为 1 秒（1000000 微秒）
  // pulseIn() 会持续测量直到信号到来或超时
  int pulseWidth = pulseIn(OUT_PIN, HIGH, 1000000);
  
  // 如果超时（脉冲宽度为0），返回一个很大的值表示无效数据
  if(pulseWidth == 0) return 999999;
  
  return pulseWidth;
}

/**
 * 读取 RGB 三个通道的原始脉宽值（带多次采样平滑）
 * 
 * 【功能】依次读取红、绿、蓝三个通道，对每个通道采样多次取平均，
 *         减少环境光变化和测量误差的影响。
 * 
 * 【输出】更新全局变量 rawR、rawG、rawB
 * 
 * 【采样顺序】R -> G -> B 循环5次，每次间隔5毫秒
 *            这样能更好地平均掉瞬时干扰
 */
void readRawRGB() {
  long sumR = 0, sumG = 0, sumB = 0;   // 累加器（使用 long 防止溢出）
  
  for(int i = 0; i < SAMPLES; i++) {
    sumR += readColor('R');    // 读取红色通道
    delay(5);                  // 短暂延迟，让传感器稳定
    sumG += readColor('G');    // 读取绿色通道
    delay(5);
    sumB += readColor('B');    // 读取蓝色通道
    delay(5);
  }
  
  // 计算平均值并存储到全局变量
  rawR = sumR / SAMPLES;
  rawG = sumG / SAMPLES;
  rawB = sumB / SAMPLES;
}

/**
 * 归一化处理（将原始脉宽转换为 0-255 的标准 RGB 值）
 * 
 * 【核心原理】
 *   原始脉宽值（rawR/G/B）越小，表示该颜色光越强。
 *   归一化公式（以红色为例）：normR = 255 * minRaw / rawR
 *   - minRaw 是三个通道中最小的原始值（对应光最强的通道）
 *   - 最小原始值对应的颜色会被归一化为 255（最饱和）
 *   - 其他颜色按比例计算，范围自动限制在 0-255 之间
 * 
 * 【优点】自动适应不同光照条件和物体距离，无需手动白平衡
 * 
 * 【注意事项】如果遇到原始值为 0 的异常情况，所有归一化值置 0
 */
void normalizeRGB() {
  // 找出三通道原始值中的最小值（最小的脉宽 = 最强的光）
  int minRaw = min(rawR, min(rawG, rawB));
  
  if(minRaw > 0) {   // 避免除零错误
    // 归一化计算：最小值通道变成 255，其他按比例缩放
    normR = 255 * minRaw / rawR;
    normG = 255 * minRaw / rawG;
    normB = 255 * minRaw / rawB;
    
    // 将结果限制在 0-255 范围内（防止浮点误差导致的越界）
    normR = constrain(normR, 0, 255);
    normG = constrain(normG, 0, 255);
    normB = constrain(normB, 0, 255);
  } else {
    // 异常情况：原始值为0（传感器故障或光线极暗）
    normR = normG = normB = 0;
  }
}

/**
 * 颜色检测（基于归一化 RGB 值判断颜色）
 * 
 * 【功能】根据归一化 RGB 的数值特征识别颜色种类
 *         采用阈值比较法，判断红色、绿色、蓝色等基本色及其混合色
 * 
 * 【参数】
 *   r - 归一化红色分量（0-255）
 *   g - 归一化绿色分量（0-255）
 *   b - 归一化蓝色分量（0-255）
 * 
 * 【返回值】颜色名称（中文）
 *          支持：黑、白、红、橙、黄、绿、青、蓝、紫、未知颜色
 * 
 * 【识别逻辑说明】
 *   1. 黑色：三通道都很低（<40）
 *   2. 白色：三通道都很高（>200）且数值接近
 *   3. 红色：R 显著高于 G/B，且 G、B 较低
 *   4. 橙色：R 高，G 中等（100-200），B 低
 *   5. 黄色：R 和 G 高，B 低
 *   6. 绿色：G 显著高于 R/B
 *   7. 青色：G 和 B 高，R 低
 *   8. 蓝色：B 显著高于 R/G
 *   9. 紫色：R 和 B 高，G 低
 * 
 * 【使用建议】可根据实际传感器和光照环境调整阈值
 */
String detectColorAdvanced(int r, int g, int b) {
  // ----- 黑色检测 -----
  // 三通道都非常低（物体几乎不反射光）
  if(r < 40 && g < 40 && b < 40) {
    return "黑色";
  }
  
  // ----- 白色检测 -----
  // 三通道都很高且数值接近（等量反射红绿蓝）
  if(r > 200 && g > 200 && b > 200 && abs(r-g) < 30 && abs(r-b) < 30) {
    return "白色";
  }
  
  // ----- 红色检测 -----
  // 红色明显高于绿/蓝，且红本身较饱和，绿蓝受压制
  if(r > g + 50 && r > b + 50 && r > 150 && g < 120 && b < 120) {
    return "红色";
  }
  
  // ----- 橙色检测 -----
  // 红较高，绿中等（红加少量绿），蓝很低
  if(r > 180 && g > 100 && g < 200 && b < 100 && r > g + 20 && g > b + 20) {
    return "橙色";
  }
  
  // ----- 黄色检测 -----
  // 红和绿都很高，蓝很低（红加绿=黄）
  if(r > 180 && g > 180 && b < 120 && abs(r-g) < 50) {
    return "黄色";
  }
  
  // ----- 绿色检测 -----
  // 绿色明显高于红和蓝，且绿较饱和
  if(g > r + 40 && g > b + 40 && g > 150 && r < 120 && b < 120) {
    return "绿色";
  }
  
  // ----- 青色检测 -----
  // 绿和蓝都很高，红很低（绿加蓝=青）
  if(g > 150 && b > 150 && r < 120 && abs(g-b) < 60) {
    return "青色";
  }
  
  // ----- 蓝色检测 -----
  // 蓝色明显高于红和绿，且蓝较饱和
  if(b > r + 40 && b > g + 40 && b > 150 && r < 120 && g < 120) {
    return "蓝色";
  }
  
  // ----- 紫色检测 -----
  // 红和蓝都很高，绿较低（红加蓝=紫）
  if(r > 120 && b > 120 && g < 100 && abs(r-b) < 60) {
    return "紫色";
  }
  
  // ----- 无法识别 -----
  // 不符合以上任何颜色特征
  return "未知颜色";
}

// ==================== 主循环 ====================
void loop() {
  // 1. 读取原始 RGB 脉宽值（带采样平滑）
  readRawRGB();

  // 2. 归一化处理（转换为 0-255 RGB 标准值）
  normalizeRGB();

  // 3. 颜色识别（基于归一化 RGB 值）
  String colorAdvanced = detectColorAdvanced(normR, normG, normB);

  // 4. 输出结果到串口监视器
  Serial.println("---------------------------------");
  
  // 输出原始脉宽（单位：微秒，越小表示该色光越强）
  Serial.print("原始脉宽(us):   R=");
  Serial.print(rawR);
  Serial.print("  G=");
  Serial.print(rawG);
  Serial.print("  B=");
  Serial.println(rawB);
  
  // 输出归一化 RGB（标准 0-255 格式）
  Serial.print("归一化RGB:      R=");
  Serial.print(normR);
  Serial.print("  G=");
  Serial.print(normG);
  Serial.print("  B=");
  Serial.println(normB);
  
  // 输出识别结果
  Serial.print("颜色:       ");
  Serial.println(colorAdvanced);

  // 延迟 500 毫秒再进行下一次读取（避免输出过快）
  delay(500);
}

3.3 调整代码

颜色检测部分需要根据实际传感器和光照环境调整阈值

/**
 * 颜色检测（基于归一化 RGB 值判断颜色）
 * 
 * 【功能】根据归一化 RGB 的数值特征识别颜色种类
 *         采用阈值比较法，判断红色、绿色、蓝色等基本色及其混合色
 * 
 * 【参数】
 *   r - 归一化红色分量（0-255）
 *   g - 归一化绿色分量（0-255）
 *   b - 归一化蓝色分量（0-255）
 * 
 * 【返回值】颜色名称（中文）
 *          支持：黑、白、红、橙、黄、绿、青、蓝、紫、未知颜色
 * 
 * 【识别逻辑说明】
 *   1. 黑色：三通道都很低（<40）
 *   2. 白色：三通道都很高（>200）且数值接近
 *   3. 红色：R 显著高于 G/B，且 G、B 较低
 *   4. 橙色：R 高，G 中等（100-200），B 低
 *   5. 黄色：R 和 G 高，B 低
 *   6. 绿色：G 显著高于 R/B
 *   7. 青色：G 和 B 高，R 低
 *   8. 蓝色：B 显著高于 R/G
 *   9. 紫色：R 和 B 高，G 低
 * 
 * 【使用建议】需要根据实际传感器和光照环境调整阈值
 */
String detectColorAdvanced(int r, int g, int b) {
  // ----- 黑色检测 -----
  // 三通道都非常低（物体几乎不反射光）
  if(r < 40 && g < 40 && b < 40) {
    return "黑色";
  }
  
  // ----- 白色检测 -----
  // 三通道都很高且数值接近（等量反射红绿蓝）
  if(r > 200 && g > 200 && b > 200 && abs(r-g) < 30 && abs(r-b) < 30) {
    return "白色";
  }
  
  // ----- 红色检测 -----
  // 红色明显高于绿/蓝，且红本身较饱和，绿蓝受压制
  if(r > g + 50 && r > b + 50 && r > 150 && g < 120 && b < 120) {
    return "红色";
  }
  
  // ----- 橙色检测 -----
  // 红较高，绿中等（红加少量绿），蓝很低
  if(r > 180 && g > 100 && g < 200 && b < 100 && r > g + 20 && g > b + 20) {
    return "橙色";
  }
  
  // ----- 黄色检测 -----
  // 红和绿都很高，蓝很低（红加绿=黄）
  if(r > 180 && g > 180 && b < 120 && abs(r-g) < 50) {
    return "黄色";
  }
  
  // ----- 绿色检测 -----
  // 绿色明显高于红和蓝，且绿较饱和
  if(g > r + 40 && g > b + 40 && g > 150 && r < 120 && b < 120) {
    return "绿色";
  }
  
  // ----- 青色检测 -----
  // 绿和蓝都很高，红很低（绿加蓝=青）
  if(g > 150 && b > 150 && r < 120 && abs(g-b) < 60) {
    return "青色";
  }
  
  // ----- 蓝色检测 -----
  // 蓝色明显高于红和绿，且蓝较饱和
  if(b > r + 40 && b > g + 40 && b > 150 && r < 120 && g < 120) {
    return "蓝色";
  }
  
  // ----- 紫色检测 -----
  // 红和蓝都很高，绿较低（红加蓝=紫）
  if(r > 120 && b > 120 && g < 100 && abs(r-b) < 60) {
    return "紫色";
  }
  
  // ----- 无法识别 -----
  // 不符合以上任何颜色特征
  return "未知颜色";
}

四、实现原理及深度解析

4.1 三原色的感应原理

通常所看到的物体的颜色,实际上是物体表面吸收了照射到它上面的白光(日光)中的一
部分有色成分，而反射出的另一部分有色光在人眼中的反应。白色是由各种频率的可见光混
合在一起构成的，也就是说白光中包含着各种颜色的色光(如红 R、黄 Y、绿 G、青 V、蓝 B、
紫 P)。根据德国物理学家赫姆霍兹(Helinholtz)的三原色理论可知，各种颜色是由不同比
例的三原色(红、绿、蓝)混合而成的。

4.2 TCS230 识别颜色的原理

由上面的三原色感应原理可知，如果知道构成各种颜色的三原色的值，就能够知道所测
试物体的颜色。对于 TCS230 来说，当选定一个颜色滤波器时，它只允许某种特定的原色通
过，阻止其它原色的通过。例如:当选择红色滤波器时，入射光中只有红色可以通过，蓝色
和绿色都被阳止，这样就可以得到红色光的光强:同理，选择其它的滤波器，就可以得到蓝
色光和绿色光的光强。通过这三个值，就可以分析投射到TCS230 传感器上的光的颜色。

4.3 白平衡和颜色识别原理

白平衡就是告诉系统什么是白色。从理论上讲，白色是由等量的红色、绿色和蓝色混合
而成的:但实际上，白色中的三原色并不完全相等，并且对于 TCS230 的光传感器来说，它
对这三种基本色的敏感性是不相同的，导致 TCS230 的 RGB 输出并不相等，因此在测试前必
须进行白平衡调整，使得 TCS230 对所检测的“白色”中的三原色是相等的。进行白平衡调整是为后续的颜色识别做准备。

4.4 归一化算法的数学原理

关键技术亮点：无需手动白平衡校准自动适应不同光照条件。代码中最核心的算法是normalizeRGB()函数，其数学原理如下：

问题背景：

传感器原始读数受光照强度、物体距离的影响很大
同一个颜色在不同距离下，原始脉宽会成比例变化
需要一种与光照强度无关的颜色表示方法

解决方案：归一化到最大值（Max Normalization）

设原始读数向量为 R = (r_raw, g_raw, b_raw)

定义 m = min(r_raw, g_raw, b_raw)

归一化输出向量：

r_norm = 255 × (m / r_raw)
g_norm = 255 × (m / g_raw)
b_norm = 255 × (m / b_raw)

归一化结果与光照强度k无关！这就是你的程序能够“无需手动白平衡校准”自动适应不同光照条件的数学本质。

五、TCS3200的应用场景

5.1 工业自动化与分拣系统

TCS3200在工业场景中最成熟的应用是颜色分拣。由于它输出的是频率信号而非I²C数据，在含有电机变频器、电磁阀等强干扰源的工业环境中具有天然优势——频率信号的抗干扰能力远优于模拟电压或I²C总线。

典型应用案例：

咖啡豆烘焙度分拣：研究表明，TCS3200可在7.5~16.5cm距离范围内有效区分不同成熟度的咖啡豆，准确率满足自动化分拣要求-4
快递包裹分拣：配合传送带系统，按颜色标签分类路由，MCU负担极轻（驱动占用Flash < 1.2KB）

5.2 智慧农业：叶绿素含量检测

这是近年来非常活跃的应用方向。印尼乌达亚纳大学的研究团队开发了基于TCS3200的叶绿素计[ citation:1]。其原理是：叶片中叶绿素含量越高，对红光和蓝光的吸收越强，对绿光的反射越强。通过检测叶片反射的RGB分量，可推算叶绿素含量。与农业物联网的结合：配合ESP32的Deep Sleep功能，可在田间实现电池供电的长期监测。

5.3 医疗与化学诊断：试纸条读取

TCS3200可用于读取尿液分析试纸条、血糖试纸等侧向层析试纸条。不同浓度的待测物会导致试纸反应区呈现不同的颜色深度，TCS3200通过检测RGB值的变化可实现定量或半定量分析。可以用来替代专用读卡器。

5.4 STEM教育与机器人竞赛

TCS3200在高校机器人竞赛（如“光电搬运机器人”）中非常流行。。相比集成度更高的I²C传感器（如TCS34725），TCS3200的示波器可见方波输出让“信号链路”变得肉眼可见——学生可以真正理解“光→电流→频率”的转换过程，而不是调用一个“读颜色”的黑盒函数。

经典任务：

按颜色分拣物块（如红/绿/蓝/黑/白）
颜色巡线（沿特定颜色轨迹行驶）
识别色卡完成指定动作

5.5 其他应用方向

应用领域	具体场景	关键考量
智能照明	环境光色温检测、屏幕背光自适应调节	关注无色滤光片(Clear)通道作为基准
消费电子	智能玩具、家居设备颜色识别	低功耗设计是重点
产品质检	生产线产品颜色一致性检测	需固定照明和距离

六、工程注意事项

6.1 光学结构问题（最常见的故障源）

这是TCS3200应用中最容易被忽视的问题。实验数据表明：一块没加遮光罩的TCS3200，Clear读数会因角度变化浮动±25%；加15mm遮光筒后，波动可压到±1.8%。

工程建议：

用黑色3D打印件或热缩管制作遮光筒
筒内壁做哑光处理（黑色喷漆或植绒）防止反射干扰
筒长度通常15-20mm，太长影响近距测量

6.2 频率缩放配置陷阱（高增益不是越高越好）

测试代码选择20%缩放（S0=HIGH, S1=LOW）是最佳实践。很多教程建议使用100%增益（S0=HIGH, S1=HIGH），但在室内灯光下，无色滤光片(Clear)通道输出频率可能飙到600kHz以上。此时pulseIn()函数超时返回0，新手会误以为接线错误。

缩放比例选择指南：

场景	推荐缩放	理由
室内正常照明	20%	约20-120kHz，pulseIn稳定
极暗环境	100%	需要最大灵敏度
强光/白色物体	2%	防止饱和
电池供电/低速采样	2%	降低MCU中断负载

6.3 电源与去耦问题（规格书强制要求）

TCS3200数据手册明确要求：电源引脚必须用0.01μF至0.1μF的电容靠近芯片引脚处去耦。模块现状：市售模块是否包含此电容取决于设计质量。如果你遇到读数跳变剧烈且无规律，首先检查的就是电源质量，可考虑额外加一个0.1μF电容在模块VCC/GND引脚间。OE引脚：数据手册要求OE必须接明确的低电平或高电平，不能悬空。

6.4 测量时序与稳定时间（切换通道后必须等待）

切换S2/S3选择不同滤光片后，传感器需要时间稳定。数据手册给出的响应时间为：一个新频率周期的时长 + 1μs。通道切换顺序：建议按固定顺序循环（如R→G→B→C），每次切换后稳定100μs，采样后进行下一次。

6.5 电池供电场景的功耗管理（待机模式电流仅0.1μA）

TCS3200是低功耗设计的典范：工作模式：约2mA；待机模式（S0=LOW, S1=LOW）：仅0.1μA。省电策略：若你的ESP32项目需要电池供电（如田间监测节点），可在两次测量之间将模块置于待机模式。

digitalWrite(S0, LOW);
digitalWrite(S1, LOW);
delay(测量间隔);
digitalWrite(S0, HIGH); // 恢复20%模式
digitalWrite(S1, LOW);

6.6 常见故障速查表

现象	可能原因	解决方案
OUT恒为0	OE悬空或接地不良	OE接GND
四通道读数几乎相等	遮光罩漏光/环境光太强	增加遮光罩
频率>600kHz导致pulseIn超时	使用了100%增益	切回20%增益
RAW值全为999999（你的代码）	超时	检查OUT上拉电阻或降低缩放
读数跳变剧烈无规律	电源去耦不良	VCC/GND加0.1μF电容
归一化结果全接近255	minRaw异常小	检查是否有通道读数错误