TCS34725 и Arduino: I2C RGB-датчик цвета, освещённость и цветовая температура
Подключение TCS34725 к Arduino, время интеграции и усиление, расчёт цветовой температуры и освещённости в люксах, отличия от TCS3200, сортировщик по цвету и код для ESP32 и Pico.
TCS34725 — цифровой RGB-датчик цвета с интерфейсом I2C и один из самых точных и простых способов распознавать цвет с Arduino. Он выдаёт количество красного, зелёного, синего и общего (clear) света от предмета перед ним или от окружающего освещения в виде 16-битных чисел. На микросхеме есть ещё и фильтр, блокирующий инфракрасное излучение, поэтому невидимый свет от солнца и ламп влияет на показания гораздо меньше. Для подключения TCS34725 к Arduino нужны всего два провода данных (SDA и SCL), а с библиотекой Adafruit первые значения читаются в несколько строк.
В этой статье ты пошагово узнаешь, что находится внутри датчика, как настройки времени интеграции и усиления меняют измерение и как из «сырых» чисел рассчитать цветовую температуру (в кельвинах) и освещённость в люксах. Затем сравним его со старым, но распространённым TCS3200, соберём откалиброванный сортировщик по цвету и используем тот же датчик с ESP32 и Raspberry Pi Pico (MicroPython).

Что такое TCS34725 и как он работает?
На микросхеме расположены 12 маленьких фотодиодов в виде матрицы 3×4. Три из них закрыты красным фильтром, три — зелёным и три — синим; оставшиеся три без фильтра и видят весь свет (clear, C). Ток каждой группы в течение заданного времени накапливается в отдельном 16-битном аналого-цифровом преобразователе (АЦП). Это время называется временем интеграции. Когда оно истекает, четыре результата (R, G, B, C) записываются в регистры, и ты читаешь их по I2C. Фильтр над фотодиодами, блокирующий инфракрасное излучение, в значительной мере отсекает свет с длиной волны выше 700 нм, который наш глаз не видит. Благодаря этому TCS34725 измеряет цвета ближе к тому, как их воспринимает человеческий глаз. На большинстве модулей рядом с микросхемой есть ещё и нейтральный белый светодиод. Когда ты считываешь цвет предмета, на самом деле измеряется та часть света этого светодиода, которая отразилась от предмета и вернулась обратно.
| Характеристика | Значение |
|---|---|
| Измеряемые каналы | Красный (R), зелёный (G), синий (B), без фильтра (C) |
| Матрица фотодиодов | 3×4, всего 12 фотодиодов |
| Разрешение | 16 бит на канал (0–65535) |
| Интерфейс | I2C, до 400 kHz |
| I2C-адрес | 0x29 (фиксированный) |
| Питание | Микросхема 2,7–3,6 V; модуль со стабилизатором 3,3–5 V |
| Ток | Около 235 µA при измерении, 2,5 µA в режиме сна (без учёта светодиода) |
| ИК-фильтр | На микросхеме, блокирует инфракрасное излучение |
| Динамический диапазон | 3 800 000:1 |
| Время интеграции | 2,4 мс – 614 мс (с шагом 2,4 мс) |
| Усиление | 1x, 4x, 16x, 60x |
| Светодиод на плате | Нейтральный белый, около 4150 К |
Время интеграции и усиление
Время интеграции похоже на выдержку в фотоаппарате. Чем оно больше, тем больше света собирает датчик, тем крупнее числа и тем меньше шум в темноте. Зато каждое измерение длится дольше, а при ярком свете каналы легче входят в насыщение. Время задаётся регистром ATIME с шагом 2,4 мс. Максимальное число, которого может достичь канал, находится по формуле (256 − ATIME) × 1024, и результат не может превышать 65535. В таблице ниже — самые распространённые значения и случаи, когда их стоит выбирать.
| ATIME | Циклов | Время | Макс. отсчёт | Когда? |
|---|---|---|---|---|
| 0xFF | 1 | 2,4 мс | 1024 | Очень яркий свет, очень быстрое чтение |
| 0xF6 | 10 | 24 мс | 10240 | На солнце, быстро движущиеся предметы |
| 0xEB | 21 | 50 мс | 21504 | Хорошая отправная точка для чтения цвета со светодиодом |
| 0xD6 | 42 | 101 мс | 43008 | Измерение освещения в помещении |
| 0xC0 | 64 | 154 мс | 65535 | Тусклое освещение, полное 16-битное разрешение |
| 0x00 | 256 | 614 мс | 65535 | Очень темно, медленное чтение |
Усиление (gain) аналоговым способом увеличивает накопленный сигнал. Есть варианты 1x, 4x, 16x и 60x. Повышение усиления увеличивает чувствительность без удлинения времени, но вместе с ней растёт и шум. Практическое правило такое: всегда освещай предмет светодиодом с одного и того же расстояния и начинай с 50 мс и 4x. Если C остаётся намного ниже максимального отсчёта (например, ниже 1000), подними усиление до 16x. Если C приближается к насыщению, снизь усиление или сократи время. Когда канал упирается в потолок, показание уже неверно: с ростом света число больше не может увеличиваться, и соотношения цветов искажаются. В даташите также сказано, что при времени меньше 150 мс из-за пульсаций насыщение может начаться примерно на 75% от максимального отсчёта. Поэтому при 50 мс считай безопасным верхним пределом примерно 16 000.
Подключение TCS34725 (Arduino Uno, ESP32, Pico)
| Пин TCS34725 | Arduino Uno | ESP32 | Raspberry Pi Pico |
|---|---|---|---|
| VIN | 5V | 3V3 | 3V3(OUT) (пин 36) |
| GND | GND | GND | GND |
| SDA | A4 | GPIO 21 | GP4 (пин 6) |
| SCL | A5 | GPIO 22 | GP5 (пин 7) |
| LED | Не подключён: светодиод горит / GND: светодиод погашен | Не подключён или GND | Не подключён или GND |
| INT | Не подключён (необязательный выход прерывания) | Не подключён | Не подключён |
| 3V3 | Не подключать (выход стабилизатора) | Не подключать | Не подключать |
Пошагово: первое чтение цвета с Arduino Uno
- Подключи модуль, как в таблице: VIN к 5V, GND к GND, SDA к A4, SCL к A5. Пины LED и INT пока оставь свободными.
- В Arduino IDE открой «Менеджер библиотек» (Library Manager), найди библиотеку Adafruit TCS34725 и установи её; если появится вопрос о зависимостях, установи и Adafruit BusIO. Если не получается, загляни в статью установка библиотек Arduino.
- Загрузи код ниже и открой монитор порта на скорости 9600 бод.
- Подноси к датчику красную, зелёную и синюю бумагу на расстоянии 1–2 см и следи, какой канал растёт для каждого цвета.
- Приближай и отдаляй бумагу, чтобы увидеть, как меняются числа, и убедись, что значение C не доходит до предела насыщения.
1#include <Wire.h>
2#include <Adafruit_TCS34725.h>
3
4// 50 ms entegrasyon, 4x kazanç / 50 ms integration, 4x gain
5Adafruit_TCS34725 tcs(TCS34725_INTEGRATIONTIME_50MS, TCS34725_GAIN_4X);
6
7const float ATIME_MS = 50.4; // 21 döngü x 2,4 ms / 21 cycles x 2.4 ms
8const float GAIN = 4.0; // kazanç katsayısı / gain factor
9const uint16_t DOYMA = 16128; // 21504'ün %75'i / 75% of 21504 (ripple saturation)
10
11void setup() {
12 Serial.begin(9600);
13 if (tcs.begin()) {
14 Serial.println(F("TCS34725 bulundu / found"));
15 } else {
16 Serial.println(F("Sensor yok, kablolari kontrol et / No sensor, check wiring"));
17 while (1);
18 }
19}
20
21// ams DN40 formülü ile lüks / lux with the ams DN40 formula
22float luxHesapla(uint16_t r, uint16_t g, uint16_t b, uint16_t c) {
23 float ir = ((float)r + g + b - c) / 2.0; // kızılötesi tahmini / IR estimate
24 if (ir < 0) ir = 0;
25 float r2 = r - ir;
26 float g2 = g - ir;
27 float b2 = b - ir;
28 float cpl = (ATIME_MS * GAIN) / 310.0; // lüks başına sayım / counts per lux
29 float lux = (0.136 * r2 + 1.0 * g2 - 0.444 * b2) / cpl;
30 return lux < 0 ? 0 : lux;
31}
32
33void loop() {
34 uint16_t r, g, b, c;
35 tcs.getRawData(&r, &g, &b, &c); // bir entegrasyon süresi bekler / waits one integration time
36 uint16_t cct = tcs.calculateColorTemperature_dn40(r, g, b, c);
37 float lux = luxHesapla(r, g, b, c);
38
39 Serial.print(F("R:")); Serial.print(r);
40 Serial.print(F(" G:")); Serial.print(g);
41 Serial.print(F(" B:")); Serial.print(b);
42 Serial.print(F(" C:")); Serial.print(c);
43 Serial.print(F(" CCT:")); Serial.print(cct); Serial.print(F(" K"));
44 Serial.print(F(" Lux:")); Serial.print(lux, 0);
45 if (c > DOYMA) Serial.print(F(" DOYMA! / SATURATED!"));
46 Serial.println();
47 delay(500);
48}Время интеграции и усиление задаются вместе при создании объекта; при желании их можно позже изменить через tcs.setIntegrationTime() и tcs.setGain(). getRawData() ждёт одно время интеграции, а затем читает четыре канала. Поэтому при 614 мс не получится сделать даже двух измерений в секунду. Для цветовой температуры мы использовали функцию библиотеки calculateColorTemperature_dn40(); при насыщении она возвращает недопустимое значение (65535). Освещённость мы рассчитали вручную, потому что функция calculateLux() из библиотеки не учитывает время и усиление, и при смене настроек её результат уплывает. Обязательно держи константы ATIME_MS и GAIN в коде такими же, как выбранные настройки.
Расчёт цветовой температуры и освещённости
Люкс (лк) показывает, насколько ярким кажется человеческому глазу свет, падающий на поверхность. В тусклой комнате около 50–100 лк, в хорошо освещённом офисе около 300–500 лк; на улице в пасмурную погоду намеряешь несколько тысяч люкс, а полуденное солнце даёт до 100 000 лк. Цветовая температура (CCT) описывает оттенок белого света в кельвинах. Пламя свечи — около 1900 К, лампа накаливания — 2700 К, тёплый белый светодиод — 3000 К, полуденное солнце — 5500 К, а облачное небо — около 6500–7500 К. Чем меньше значение, тем сильнее свет уходит в жёлто-оранжевый, чем больше — тем сильнее в синий. Производитель TCS34725, компания ams, в своей заметке по применению DN40 рекомендует такие шаги для расчёта этих двух величин из «сырых» чисел:
| Шаг | Формула |
|---|---|
| 1. Инфракрасная составляющая | IR = (R + G + B − C) / 2 (0, если отрицательно) |
| 2. Каналы без ИК | R' = R − IR, G' = G − IR, B' = B − IR |
| 3. Отсчётов на люкс | CPL = (ATIME_ms × усиление) / (GA × 310) |
| 4. Освещённость | Lux = (0,136 × R' + 1,000 × G' − 0,444 × B') / CPL |
| 5. Цветовая температура | CCT = 3810 × (B' / R') + 1391 |
Разберём пример: допустим, при 50,4 мс и усилении 4x получено R = 1200, G = 1000, B = 800, C = 2800. IR = (1200 + 1000 + 800 − 2800) / 2 = 100; значения без ИК: R' = 1100, G' = 900, B' = 700. CPL = 50,4 × 4 / 310 ≈ 0,650. Освещённость = (0,136 × 1100 + 900 − 0,444 × 700) / 0,650 = 738,8 / 0,650 ≈ 1136 лк. Цветовая температура: 3810 × 700 / 1100 + 1391 ≈ 3816 К. GA в формуле показывает, насколько стеклянная или пластиковая крышка перед датчиком ослабляет свет; для открытого датчика бери 1. Если датчик стоит за крышкой, GA нужно поднять выше 1 и откалибровать, сравнивая показания с люксметром, которому можно доверять.
Сравнение TCS34725 и TCS3200
| Характеристика | TCS34725 | TCS3200 |
|---|---|---|
| Выход | I2C, 16-битное цифровое число | Меандр, частота пропорциональна свету |
| Занятые пины | 2 (SDA, SCL) | 5–6 (S0–S3, OUT, OE) |
| Фотодиоды | 3×4 = 12 | 8×8 = 64 |
| ИК-фильтр | Есть, на микросхеме | Нет, чувствителен к инфракрасному |
| Настройки | Время 2,4–614 мс, усиление 1x–60x | Масштаб выходной частоты 2%, 20%, 100% |
| Питание | Модуль 3,3–5 V (микросхема 2,7–3,6 V) | 2,7–5,5 V |
| Светодиоды на плате | 1 нейтральный белый | 4 белых |
| Способ чтения | Четыре канала сразу, из регистров | Выбор фильтров по очереди и измерение частоты через pulseIn |
| Освещённость и цветовая температура | Рассчитываются напрямую по формулам | Сложно, нужна подробная калибровка |
TCS3200 до сих пор очень популярен в школьных проектах: четыре светодиода хорошо освещают предмет, и он спокойно работает от 5 V. Но переключение фильтра для каждого цвета пинами S2 и S3 и измерение частоты отнимают и пины, и время. Поскольку ИК-фильтра нет, окружающее освещение тоже сильнее влияет на показания. TCS34725 же подключается двумя проводами, читает четыре канала сразу и благодаря настраиваемым времени и усилению работает от темноты до яркого солнца. Если начинаешь новый проект, выбирай TCS34725; если у тебя уже есть TCS3200, поможет статья датчик цвета TCS3200. А если кроме цвета нужно распознавать жесты и приближение, хорошей альтернативой будет APDS-9960.
Пример: сортировщик по цвету
Классический проект для школы и научной выставки: останавливать перед датчиком цветные конфеты или бусины, скатывающиеся по горке, и направлять их в разные контейнеры по цвету. Датчик измеряет цвет, а сервопривод поворачивает жёлоб на угол нужного контейнера. Самый важный приём — использовать не «сырые» числа, а соотношения. Когда предмет немного отодвигается, R, G и B уменьшаются вместе, но соотношение R/(R+G+B) остаётся почти тем же. Для калибровки помести перед датчиком по одному предмету каждого цвета, запиши значения nr, ng и nb из монитора порта и внеси их в таблицу ref в коде; значения в коде — только пример. Если разместить датчик внутри чёрной трубки и всегда держать предмет на одном расстоянии (идеально 5–10 мм), влияние окружающего света исчезает, а точность заметно растёт.
1#include <Wire.h>
2#include <Adafruit_TCS34725.h>
3#include <Servo.h>
4
5Adafruit_TCS34725 tcs(TCS34725_INTEGRATIONTIME_50MS, TCS34725_GAIN_4X);
6Servo oluk; // yönlendirme oluğu / sorting chute
7
8const int RENK_SAYISI = 4;
9const char* renkAd[RENK_SAYISI] = {"KIRMIZI", "YESIL", "MAVI", "SARI"};
10// Kalibrasyonla bul: her renk için nr, ng, nb / find by calibration: nr, ng, nb per color
11const float ref[RENK_SAYISI][3] = {
12 {0.52, 0.26, 0.22},
13 {0.27, 0.44, 0.29},
14 {0.20, 0.31, 0.49},
15 {0.42, 0.39, 0.19}
16};
17const int aci[RENK_SAYISI] = {20, 65, 110, 155}; // her kutunun servo açısı / servo angle of each bin
18const uint16_t BOS_ESIK = 300; // tüp boşken C bunun altında / C stays below this when empty
19
20void setup() {
21 Serial.begin(9600);
22 if (!tcs.begin()) {
23 Serial.println(F("TCS34725 bulunamadi / not found"));
24 while (1);
25 }
26 oluk.attach(9); // servo sinyali D9 / servo signal on D9
27 oluk.write(90); // bekleme konumu / idle position
28}
29
30int renkBul(float nr, float ng, float nb) {
31 int enIyi = -1;
32 float enKucuk = 1000.0;
33 for (int i = 0; i < RENK_SAYISI; i++) {
34 float d = sq(nr - ref[i][0]) + sq(ng - ref[i][1]) + sq(nb - ref[i][2]);
35 if (d < enKucuk) {
36 enKucuk = d;
37 enIyi = i;
38 }
39 }
40 if (enKucuk > 0.004) return -1; // hiçbir renge yakın değil / not close to any color
41 return enIyi;
42}
43
44void loop() {
45 uint16_t r, g, b, c;
46 tcs.getRawData(&r, &g, &b, &c);
47 if (c < BOS_ESIK) { // önünde nesne yok / no object in front
48 delay(50);
49 return;
50 }
51 float top = (float)r + g + b;
52 float nr = r / top;
53 float ng = g / top;
54 float nb = b / top;
55 Serial.print(F("nr=")); Serial.print(nr, 3);
56 Serial.print(F(" ng=")); Serial.print(ng, 3);
57 Serial.print(F(" nb=")); Serial.print(nb, 3);
58
59 int renk = renkBul(nr, ng, nb);
60 if (renk >= 0) {
61 Serial.print(F(" -> "));
62 Serial.println(renkAd[renk]);
63 oluk.write(aci[renk]); // oluğu kutuya çevir / turn chute to the bin
64 delay(800); // nesnenin kaymasını bekle / wait for the object to slide
65 oluk.write(90);
66 } else {
67 Serial.println(F(" -> bilinmiyor / unknown"));
68 }
69 delay(300);
70}При каждом измерении код сначала смотрит на значение C. Пока трубка пуста, свет светодиода не отражается обратно, C остаётся маленьким, и машина ждёт; если в трубку попадает внешний свет, подбери BOS_ESIK под свою установку. Когда появляется предмет, соотношения цветов находятся делением R, G и B на их сумму. Затем вычисляется квадрат расстояния до каждого эталонного цвета и выбирается ближайший. Порог расстояния 0.004 относит предметы, не похожие ни на один цвет, к неизвестным; если уменьшить порог, машина станет избирательнее. Чтобы добавить новый цвет, достаточно добавить строку в массивы ref, renkAd и aci и обновить RENK_SAYISI. Питание сервопривода от отдельного источника 5 V не даёт показаниям I2C искажаться, пока мотор двигается. Сделать показания стабильнее помогает и усреднение нескольких измерений; об этом — в статье фильтрация данных датчиков.
TCS34725 с ESP32: повторяем цвет на RGB-светодиоде
На ESP32 та же библиотека Adafruit работает без изменений. Пины I2C по умолчанию — GPIO 21 (SDA) и GPIO 22 (SCL), а питать модуль безопаснее всего от пина 3V3. Пример ниже повторяет цвет, который видит датчик, на RGB-светодиоде с общим катодом и выводит код цвета в формате #RRGGBB в монитор порта. Функция getRGB() делит цвета на канал C и приводит их к диапазону 0–255; код растягивает самый сильный канал до 255 и применяет гамма-коррекцию, чтобы оживить блёклые цвета. Поскольку функции ШИМ в версиях 2.x и 3.x ядра ESP32 для Arduino отличаются, код разделён на два варианта. Подходящий резистор для каждой ножки светодиода найдёшь с помощью утилиты калькулятор резистора для светодиода.
1#include <Wire.h>
2#include <Adafruit_TCS34725.h>
3
4Adafruit_TCS34725 tcs(TCS34725_INTEGRATIONTIME_50MS, TCS34725_GAIN_4X);
5
6const int PIN_R = 25; // RGB LED kırmızı / red
7const int PIN_G = 26; // RGB LED yeşil / green
8const int PIN_B = 27; // RGB LED mavi / blue
9
10void pwmBaslat() {
11#if ESP_ARDUINO_VERSION_MAJOR >= 3
12 ledcAttach(PIN_R, 5000, 8); // core 3.x: pin, frekans, çözünürlük / pin, frequency, resolution
13 ledcAttach(PIN_G, 5000, 8);
14 ledcAttach(PIN_B, 5000, 8);
15#else
16 ledcSetup(0, 5000, 8); // core 2.x: kanal, frekans, çözünürlük / channel, frequency, resolution
17 ledcSetup(1, 5000, 8);
18 ledcSetup(2, 5000, 8);
19 ledcAttachPin(PIN_R, 0);
20 ledcAttachPin(PIN_G, 1);
21 ledcAttachPin(PIN_B, 2);
22#endif
23}
24
25void ledYaz(uint8_t r, uint8_t g, uint8_t b) {
26#if ESP_ARDUINO_VERSION_MAJOR >= 3
27 ledcWrite(PIN_R, r);
28 ledcWrite(PIN_G, g);
29 ledcWrite(PIN_B, b);
30#else
31 ledcWrite(0, r);
32 ledcWrite(1, g);
33 ledcWrite(2, b);
34#endif
35}
36
37uint8_t duzelt(float v, float enBuyuk) {
38 float x = v / enBuyuk; // en güçlü kanal 1 olur / strongest channel becomes 1
39 x = powf(x, 2.5f); // gama: renkleri canlandır / gamma: make colors vivid
40 return (uint8_t)(x * 255.0f);
41}
42
43void setup() {
44 Serial.begin(115200);
45 Wire.begin(21, 22); // SDA, SCL
46 if (!tcs.begin(TCS34725_ADDRESS, &Wire)) {
47 Serial.println("TCS34725 bulunamadi / not found");
48 while (true) delay(10);
49 }
50 pwmBaslat();
51}
52
53void loop() {
54 float r, g, b;
55 tcs.getRGB(&r, &g, &b); // C kanalına göre 0-255 / normalized to clear, 0-255
56 float enBuyuk = fmaxf(r, fmaxf(g, b));
57 if (enBuyuk < 1.0f) enBuyuk = 1.0f;
58 uint8_t R = duzelt(r, enBuyuk);
59 uint8_t G = duzelt(g, enBuyuk);
60 uint8_t B = duzelt(b, enBuyuk);
61 ledYaz(R, G, B);
62 Serial.printf("#%02X%02X%02X\n", R, G, B);
63 delay(100);
64}Raspberry Pi Pico и TCS34725 (MicroPython)
В MicroPython не обязательно ставить готовую библиотеку: у TCS34725 простая структура регистров, поэтому общаться с ним можно напрямую в несколько строк. К адресу каждого регистра добавляется командный бит (0x80), а при чтении нескольких байтов используется ещё и бит автоинкремента (0x20). Сначала код читает регистр ID (0x12): для TCS34725 должно вернуться 0x44, для TCS34727 — 0x4D. Затем он устанавливает ATIME в 0xEB (около 50 мс) и усиление 4x, включает датчик и при каждом измерении рассчитывает освещённость и цветовую температуру по формуле DN40. Если Pico и MicroPython для тебя в новинку, сначала загляни в статью Что такое Raspberry Pi Pico.
1from machine import Pin, I2C
2import time
3
4ADDR = 0x29 # sabit I2C adresi / fixed I2C address
5CMD = 0x80 # komut biti / command bit
6AUTO = 0x20 # otomatik artırma / auto-increment
7ATIME_MS = 50.4 # 0xEB = 21 döngü x 2,4 ms / 21 cycles x 2.4 ms
8GAIN = 4
9
10i2c = I2C(0, sda=Pin(4), scl=Pin(5), freq=400000)
11
12def yaz(reg, deger):
13 i2c.writeto_mem(ADDR, CMD | reg, bytes([deger]))
14
15def oku(reg):
16 return i2c.readfrom_mem(ADDR, CMD | reg, 1)[0]
17
18print("ID:", hex(oku(0x12))) # 0x44 = TCS34725, 0x4D = TCS34727
19
20yaz(0x01, 0xEB) # ATIME: yaklaşık 50 ms / about 50 ms
21yaz(0x0F, 0x01) # kazanç 4x (0=1x, 1=4x, 2=16x, 3=60x) / gain 4x
22yaz(0x00, 0x01) # PON: güç aç / power on
23time.sleep_ms(3)
24yaz(0x00, 0x03) # PON + AEN: ölçümü başlat / start measuring
25
26def rgbc_oku():
27 while not (oku(0x13) & 0x01): # AVALID: veri hazır mı? / data ready?
28 time.sleep_ms(5)
29 d = i2c.readfrom_mem(ADDR, CMD | AUTO | 0x14, 8)
30 c = d[0] | (d[1] << 8)
31 r = d[2] | (d[3] << 8)
32 g = d[4] | (d[5] << 8)
33 b = d[6] | (d[7] << 8)
34 return r, g, b, c
35
36def lux_cct(r, g, b, c):
37 ir = max(0, (r + g + b - c) / 2) # kızılötesi tahmini / IR estimate
38 r2, g2, b2 = r - ir, g - ir, b - ir
39 cpl = (ATIME_MS * GAIN) / 310 # lüks başına sayım / counts per lux
40 lux = max(0, (0.136 * r2 + g2 - 0.444 * b2) / cpl)
41 cct = 3810 * b2 / r2 + 1391 if r2 > 0 else 0
42 return lux, cct
43
44while True:
45 r, g, b, c = rgbc_oku()
46 lux, cct = lux_cct(r, g, b, c)
47 print("R:", r, "G:", g, "B:", b, "C:", c, "Lux: %.0f" % lux, "CCT: %.0f K" % cct)
48 time.sleep(0.5)Идеи проектов с TCS34725
- Сортировщик по цвету: раскладывай конфеты или бусины по контейнерам в зависимости от цвета с помощью сервопривода и горки (пример выше).
- Лампа, копирующая цвет: считывай цвет ткани или бумаги и точно повторяй его на ленте WS2812B NeoPixel.
- Измеритель освещения: измеряй освещённость и цветовую температуру в комнате и показывай их на дисплее; проверь, достигает ли освещение рабочего стола цели в 500 лк.
- Робот с цветовыми правилами: добавь TCS34725 к роботу, следующему по линии, и задай правила вроде «стоп на красной метке, поворот на зелёной».
- Устройство, называющее цвет вслух: сделай вспомогательный прибор для незрячих и слабовидящих, который произносит распознанный цвет с помощью DFPlayer Mini.
- Индикатор спелости фруктов: отслеживай по соотношениям цветов, как помидор или банан меняет цвет с зелёного на красный или жёлтый.
Частые ошибки и их решение
| Признак | Вероятная причина | Решение |
|---|---|---|
| Выводится «TCS34725 not found» (датчик не найден) | SDA и SCL перепутаны, нет питания или отошёл провод | Проверь, что на Uno SDA=A4 и SCL=A5; найди адрес 0x29 с помощью I2C-сканера |
| Все каналы очень большие и не меняются | Насыщение: света слишком много для выбранных времени и усиления | Снизь усиление до 1x, сократи время или немного отодвинь предмет |
| Числа очень маленькие, цвета скачут | Недостаточно света | Включи светодиод, поставь усиление 16x или 60x, увеличь время |
| Один и тот же предмет на разном расстоянии даёт разный цвет | Сравнение идёт по «сырым» значениям | Используй соотношения R/(R+G+B) и зафиксируй расстояние |
| При открытом окне результаты меняются | В измерение подмешивается окружающий свет | Окружи датчик чёрной трубкой или кожухом |
| Цветовая температура всегда около 4000 К | Светодиод на плате остался включённым | Подключи пин LED к GND или гаси светодиод цифровым пином |
| Измерения очень медленные | Большое время интеграции (например, 614 мс) | getRawData() ждёт это время; выбери 24–50 мс |
| Красный и оранжевый путаются | Эталонные соотношения слишком близки друг к другу | Калибруй на итоговой установке, уменьши порог, усредняй несколько измерений |
TCS34725 — универсальный датчик, который подключается двумя проводами и благодаря настраиваемой чувствительности и ИК-фильтру надёжно измеряет и цвет предметов, и окружающее освещение. Секрет правильных результатов в трёх вещах: выбор времени и усиления без насыщения, работа с соотношениями вместо «сырых» чисел и калибровка на итоговой установке. Если хочется начать измерять свет с более простого датчика, хорошим первым шагом будет фоторезистор (LDR). В приложении BlueGrays есть пошаговые проекты со схемами и кодом: измерение света с LDR, плавная смена цветов RGB-светодиода, лампа-смеситель цветов на ESP32 и проекты с сервоприводами, а на их основе можно собрать свою машину с датчиком цвета.
Частые вопросы
Чем отличаются TCS34725 и TCS3200?
TCS34725 выдаёт по I2C четыре канала сразу в виде 16-битных чисел, а на микросхеме есть фильтр, блокирующий инфракрасное излучение. TCS3200 выбирает цветовые фильтры по одному пинами S2–S3 и выдаёт частоту; ему нужно 5–6 пинов, а без ИК-фильтра окружающий свет влияет на него сильнее. Для точности и простого подключения лучше выбрать TCS34725.
Какой I2C-адрес у TCS34725 и можно ли его изменить?
Адрес TCS34725 фиксированный — 0x29, изменить его нельзя. Чтобы подключить два датчика к одной плате, можно использовать I2C-мультиплексор, например TCA9548A. На ESP32 и Pico также можно подключить каждый датчик к отдельной шине I2C.
Работает ли TCS34725 от 5 V?
Сама микросхема работает от 2,7–3,6 V. Но на большинстве модулей есть стабилизатор на 3,3 V, поэтому на пин VIN можно подавать 5 V и подключать модуль прямо к Arduino Uno. Подача 5 V на пин 3V3 выводит микросхему из строя; если на твоём модуле нет стабилизатора, питай его от 3,3 V.
Почему TCS34725 неправильно определяет цвета?
Самые частые причины — насыщение, недостаток света, подмешивание окружающего освещения и сравнение по «сырым» числам. Освещай предмет светодиодом с фиксированного расстояния, следи, чтобы значение C оставалось ниже предела насыщения, и работай с соотношениями вроде R/(R+G+B). И обязательно калибруй эталонные цвета на итоговой установке.
Как выключить светодиод на TCS34725?
Если подключить пин LED модуля к GND, белый светодиод гаснет. Если подключить этот пин к цифровому выходу, светодиод можно гасить, записывая LOW, и включать, записывая HIGH. При измерении окружающего освещения или цветовой температуры светодиод должен быть выключен.
Насколько точно TCS34725 измеряет освещённость в люксах?
TCS34725 не так точен, как профессиональный люксмётр, но с формулой DN40 и правильными настройками времени и усиления даёт в помещении вполне полезные приблизительные значения. Если датчик стоит за стеклянной или пластиковой крышкой, его нужно откалибровать коэффициентом GA. Если нужна только яркость, проще взять BH1750, который сразу выдаёт люксы.
Что собрать после прочтения
Все проекты
Измерение освещённости с LDR
Хочешь увидеть яркость своей комнаты в виде числа? LDR — маленькая деталь, реагирующая на свет, — измеряет освещённость вокруг, а Arduino каждые полсекунды выводит значение на экран компьютера.

Измерение освещённости модулем LDR на ESP32
Наблюдение в мониторе порта в реальном времени за сырым значением ADC модуля LDR и относительным процентом освещённости, вычисленным по опорным значениям темноты и света. Этот процент — не измерение в люксах. Учит логике калибровки модуля. Идеально выполнить его перед проектом 10, потому что он нужен для определения порога.

Работа с RGB-светодиодом
В одном светодиоде прячутся три цвета: RGB-светодиод загорается красным, затем зелёным, затем синим, каждый цвет горит полсекунды и полсекунды не горит, а потом цикл начинается снова.

Плавная смена цвета RGB-светодиода
Один RGB-светодиод медленно переходит от красного к зелёному, от зелёного к синему и обратно к красному, без остановки прокручивая радугу.

Управление RGB-светодиодом на ESP32
Бесконечное число цветов одним RGB-светодиодом вместо 3 отдельных. Как в Arduino, радужный переход получается заданием значений R/G/B через analogWrite(). Теория цвета (например, красный + зелёный = жёлтый) видна на практике.

Смеситель цветов на ESP32 (3 потенциометра + RGB-светодиод + OLED)
Умная лампа для смешивания цветов на ESP32: вращая три потенциометра, можно получить любой цвет! Когда крутишь потенциометры красного, зелёного и синего, RGB-светодиод с общим катодом меняет цвет в реальном времени. OLED-дисплей SSD1306 показывает значения каждого цвета в диапазоне 0–255, полосы заполнения и веб-код цвета HEX (например, #FF8040). Мини-студия цвета, которая учит теории цвета RGB, чтению АЦП, регулировке яркости через PWM и дизайну экрана I2C.

Определение чёрной и белой поверхности с TCRT5000
С маленьким датчиком, который служит глазом роботов, едущих по линии, можно узнать, чёрный пол или белый.

Смена цветов RGB-светодиода на Pico (3 канала PWM)
Один светодиод — миллионы цветов! RGB-светодиод содержит 3 светодиода: красный, зелёный и синий. Если управлять каждым своим каналом PWM Pico, цвета смешиваются: красный + зелёный = жёлтый, зелёный + синий = голубой, все три = белый. Светодиод перебирает 8 цветов. Изучи несколько каналов PWM, объявление функций (def set_color(...)), смешивание RGB, перевод 8 бит → 16 бит (x257) и общий катод и общий анод.
Другие статьи
Приложение BlueGrays
Собери эту схему шаг за шагом в телефоне
Схема подключения, код и список деталей на одном экране. 500+ проектов на Arduino, ESP32 и Pico готовы к сборке.
Наведи камеру телефона
Наведи камеру на код — откроется магазин приложений на телефоне.
или открыть магазин

