라즈베리 파이 피코 TCS3200D/TCS230 컬러 센서
이 종합 가이드는 TCS3200D/TCS230 컬러 센서를 Raspberry Pi Pico에 연결하여 MicroPython으로 정밀한 색상 측정과 RGB 값 추출을 수행하는 방법을 보여줍니다. 보정 절차를 마스터하고 프로젝트에서 색상 인식 기능을 개발해보세요.
학습 목표:
- TCS3200D/TCS230과 Raspberry Pi Pico 사이의 연결 구성하기
- 환경 노이즈를 제거하기 위한 센서 보정 수행하기
- RGB 색상 측정을 위한 MicroPython 프로그램 개발하기
필요한 하드웨어
| 1 | × | Raspberry Pi Pico W | 쿠팡 | 아마존 | |
| 1 | × | Raspberry Pi Pico (alternative) | 쿠팡 | 아마존 | |
| 1 | × | 마이크로 USB 케이블 | 아마존 | |
| 1 | × | TCS3200D/TCS230 Color Recognition Sensor Module | 아마존 | |
| 1 | × | 브레드보드 | 쿠팡 | 아마존 | |
| 1 | × | 점퍼케이블 | 쿠팡 | 아마존 | |
| 1 | × | (추천) 라즈베리 파이 피코용 스크루 터미널 확장 보드 | 아마존 |
공개: 이 포스팅 에 제공된 일부 링크는 아마존 제휴 링크입니다. 이 포스팅은 쿠팡 파트너스 활동의 일환으로, 이에 따른 일정액의 수수료를 제공받습니다.
TCS3200D/TCS230 컬러 센서에 대하여
TCS3200D/TCS230 센서는 광학 필터링을 통한 색상 감지를 위해 8×8 그리드로 배열된 포토다이오드 매트릭스를 활용합니다. 64개 소자 배열에서 16개의 포토다이오드는 적색 스펙트럼 필터를 가지고, 다른 16개는 녹색 필터를, 16개는 청색 필터를 사용하며, 나머지 16개는 필터 없이(투명 응답) 동작합니다. 색상 측정은 특정 필터 세트를 활성화하고 결과적인 주파수 변조 구형파 출력을 분석하여 이루어집니다.
일반적인 모듈의 내장 백색 LED 어레이는 대상에 일정한 조명을 제공하여, 외부 조명 변화에 관계없이 측정 안정성을 유지하고 어두운 환경에서의 성능을 향상시킵니다.
핀아웃
TCS3200D/TCS230 센서 보드의 사용 가능한 연결:
- VCC 핀: 공급 전압 입력(+5V).
- GND 핀: 접지 기준(0V).
- S0, S1 핀: 출력 주파수 스케일링 선택기.
- S2, S3 핀: 색상 채널 필터 선택기.
- OUT 핀: 주파수 변조 구형파 출력.
- OE 핀: 출력 활성화 입력(LOW일 때 활성화). 표준 모듈은 일반적으로 내부적으로 GND에 연결되어 있습니다. 연결되지 않은 경우 수동으로 GND에 연결합니다.
작동 원리
두 가지 중요한 설정이 센서 동작을 제어합니다: 어떤 색상 채널을 활성화할지와 어떤 출력 신호 강도를 생성할지. 두 쌍의 제어 입력이 이 기능을 관리합니다:
주파수 스케일링 제어(S0 및 S1 핀):
- S0=LOW, S1=LOW: 전원 끄기 상태
- S0=LOW, S1=HIGH: 2% 스케일링 계수
- S0=HIGH, S1=LOW: 20% 스케일링 계수
- S0=HIGH, S1=HIGH: 100% 스케일링 계수(전체 속도)
색상 채널 선택(S2 및 S3 핀):
- S2=LOW, S3=LOW: 적색 포토다이오드 활성
- S2=LOW, S3=HIGH: 청색 포토다이오드 활성
- S2=HIGH, S3=LOW: 투명 포토다이오드 활성(필터 없음)
- S2=HIGH, S3=HIGH: 녹색 포토다이오드 활성
OUT 핀은 약 2Hz에서 500kHz 범위의 구형파 주파수를 출력합니다. 주파수는 빛의 강도에 따라 증가합니다 — 밝은 조명일수록 주파수가 높아집니다. 펄스 지속 시간을 측정함으로써(반비례 관계 — 지속 시간이 짧을수록 빛이 강함), 보정을 통해 표준 0-255 RGB 형식으로 변환할 수 있습니다.
최적 정밀도 달성
- 센서를 측정 대상에서 1-3cm 거리, 안정적인 각도로 유지합니다.
- 반복 가능한 조명을 위해 내장 백색 LED 조명을 사용합니다.
- 측정 일관성을 향상시키기 위해 센서를 외부 주변광으로부터 차폐합니다.
배선도
TCS3200 컬러 센서와 Raspberry Pi Pico 배선 구성:
| TCS3200 Color Sensor | Raspberry Pi Pico |
|---|---|
| VCC | VBUS (5V) |
| GND | GND |
| OUT | GP9 |
| S0 | GP6 |
| S1 | GP5 |
| S2 | GP8 |
| S3 | GP7 |
이 이미지는 Fritzing을 사용하여 만들어졌습니다. 이미지를 확대하려면 클릭하세요.
Raspberry Pi Pico 코드 - 펄스 폭 보정
보정은 원시 측정값에서 환경적 간섭을 제거합니다. LED 출력 강도, 대상 거리, 재료 반사율, 실내 조명 등의 변수가 측정값에 영향을 줍니다. 이를 체계적인 오류로 생각하고 측정이 필요합니다. 보정 루틴은 모든 색상 채널에서 최소 및 최대 펄스 폭을 식별하여, 원시 데이터를 배포 환경에 맞는 정확한 0–255 RGB 값으로 변환하기 위한 기준 경계를 설정합니다.
/*
* 이 라즈베리 파이 피코 코드는 newbiely.kr 에서 개발되었습니다
* 이 라즈베리 파이 피코 코드는 어떠한 제한 없이 공개 사용을 위해 제공됩니다.
* 상세한 지침 및 연결도에 대해서는 다음을 방문하세요:
* https://newbiely.kr/tutorials/raspberry-pico/raspberry-pi-pico-tcs3200d-tcs230-color-sensor
*/
from machine import Pin
import utime
# Pin Definitions
OUT_PIN = Pin(9, Pin.IN) # GP9 connected to OUT
S0_PIN = Pin(6, Pin.OUT) # GP6 connected to S0
S1_PIN = Pin(5, Pin.OUT) # GP5 connected to S1
S2_PIN = Pin(8, Pin.OUT) # GP8 connected to S2
S3_PIN = Pin(7, Pin.OUT) # GP7 connected to S3
# Set frequency scaling to 20% (S0=HIGH, S1=LOW)
S0_PIN.value(1)
S1_PIN.value(0)
# Variables to track min and max pulse widths for each color
red_min = 999999
red_max = 0
green_min = 999999
green_max = 0
blue_min = 999999
blue_max = 0
def read_pulse_width():
"""Read the pulse width from OUT pin in microseconds"""
# Wait for pulse to start (LOW to HIGH)
timeout = utime.ticks_ms()
while OUT_PIN.value() == 0:
if utime.ticks_diff(utime.ticks_ms(), timeout) > 100:
return 0
# Measure HIGH pulse duration
pulse_start = utime.ticks_us()
timeout = utime.ticks_ms()
while OUT_PIN.value() == 1:
if utime.ticks_diff(utime.ticks_ms(), timeout) > 100:
return 0
pulse_end = utime.ticks_us()
# Return duration in microseconds
return utime.ticks_diff(pulse_end, pulse_start)
def read_red():
"""Read red color pulse width
"""
S2_PIN.value(0)
S3_PIN.value(0)
utime.sleep_ms(10)
return read_pulse_width()
def read_green():
"""Read green color pulse width"""
S2_PIN.value(1)
S3_PIN.value(1)
utime.sleep_ms(10)
return read_pulse_width()
def read_blue():
"""Read blue color pulse width
"""
S2_PIN.value(0)
S3_PIN.value(1)
utime.sleep_ms(10)
return read_pulse_width()
print("=== TCS3200 Calibration ===")
print("Point the sensor at different objects (white, black, colors).")
print("Min and Max values are tracked automatically.")
print("When values look stable, note them down for the next code.")
print()
try:
while True:
# Read all three colors
red_pw = read_red()
green_pw = read_green()
blue_pw = read_blue()
# Update min values
if red_pw > 0 and red_pw < red_min:
red_min = red_pw
if green_pw > 0 and green_pw < green_min:
green_min = green_pw
if blue_pw > 0 and blue_pw < blue_min:
blue_min = blue_pw
# Update max values
if red_pw > red_max:
red_max = red_pw
if green_pw > green_max:
green_max = green_pw
if blue_pw > blue_max:
blue_max = blue_pw
# Display current readings and min/max
print("-" * 42)
print(f"Red PW = {red_pw} - Green PW = {green_pw} - Blue PW = {blue_pw}")
print(f" Min -> R:{red_min} G:{green_min} B:{blue_min}")
print(f" Max -> R:{red_max} G:{green_max} B:{blue_max}")
utime.sleep_ms(500)
except KeyboardInterrupt:
print("\nCalibration stopped")
print(f"\nFinal calibration values:")
print(f"redMin = {red_min}, redMax = {red_max}")
print(f"greenMin = {green_min}, greenMax = {green_max}")
print(f"blueMin = {blue_min}, blueMax = {blue_max}")
빠른 시작
- 배선도에 따라 Raspberry Pi Pico에 부품을 배선합니다.
- Micro USB 케이블을 사용하여 Raspberry Pi Pico를 컴퓨터에 연결합니다.
- Thonny IDE를 열고 인터프리터를 MicroPython (Raspberry Pi Pico)로 설정합니다.
- 위 코드를 Thonny IDE에 복사합니다.
- 코드를 Raspberry Pi Pico에 tcs3200_calibration.py로 저장합니다.
- 코드를 실행합니다.
- 센서를 다양한 표면에 향하게 합니다: 흰색 재료(프린터 용지), 검정색 물체, 다양한 색상의 물체
- Thonny IDE 콘솔에서 Min/Max 경계가 자동으로 업데이트되는 것을 확인합니다.
- 값이 안정화되면(일반적으로 10-20초), 실행 중지 버튼을 클릭합니다.
- 표시된 여섯 개의 보정 매개변수를 기록합니다.
Shell x
>>> %Run -c $EDITOR_CONTENT
MPY: soft reboot
=== TCS3200 Calibration ===
Point the sensor at different objects (white, black, colors).
Min and Max values are tracked automatically.
When values look stable, note them down for the next code.
------------------------------------------
Red PW = 42 - Green PW = 55 - Blue PW = 60
Min -> R:42 G:55 B:60
Max -> R:42 G:55 B:60
------------------------------------------
Red PW = 210 - Green PW = 185 - Blue PW = 172
Min -> R:42 G:55 B:60
Max -> R:210 G:185 B:172
------------------------------------------
Red PW = 44 - Green PW = 57 - Blue PW = 61
Min -> R:42 G:55 B:60
Max -> R:210 G:185 B:172
------------------------------------------
Calibration stopped
Final calibration values:
red_min = 42, red_max = 210
green_min = 55, green_max = 185
blue_min = 60, blue_max = 172
MicroPython (Raspberry Pi Pico) • Board CDC @ COM29 ≡
위 출력에서 추출한 샘플 보정 매개변수:
- Red_min = 42, red_max = 210
- Green_min = 55, green_max = 185
- Blue_min = 60, blue_max = 172
Raspberry Pi Pico 코드 - RGB 값 측정
/*
* 이 라즈베리 파이 피코 코드는 newbiely.kr 에서 개발되었습니다
* 이 라즈베리 파이 피코 코드는 어떠한 제한 없이 공개 사용을 위해 제공됩니다.
* 상세한 지침 및 연결도에 대해서는 다음을 방문하세요:
* https://newbiely.kr/tutorials/raspberry-pico/raspberry-pi-pico-tcs3200d-tcs230-color-sensor
*/
from machine import Pin
import utime
# Pin Definitions
OUT_PIN = Pin(9, Pin.IN) # GP9 connected to OUT
S0_PIN = Pin(6, Pin.OUT) # GP6 connected to S0
S1_PIN = Pin(5, Pin.OUT) # GP5 connected to S1
S2_PIN = Pin(8, Pin.OUT) # GP8 connected to S2
S3_PIN = Pin(7, Pin.OUT) # GP7 connected to S3
# Calibration values - REPLACE with your calibrated values!
red_min = 0
red_max = 0
green_min = 0
green_max = 0
blue_min = 0
blue_max = 0
# Set frequency scaling to 20% (S0=HIGH, S1=LOW)
S0_PIN.value(1)
S1_PIN.value(0)
def read_pulse_width():
"""Read the pulse width from OUT pin in microseconds"""
# Wait for pulse to start (LOW to HIGH)
timeout = utime.ticks_ms()
while OUT_PIN.value() == 0:
if utime.ticks_diff(utime.ticks_ms(), timeout) > 100:
return 0
# Measure HIGH pulse duration
pulse_start = utime.ticks_us()
timeout = utime.ticks_ms()
while OUT_PIN.value() == 1:
if utime.ticks_diff(utime.ticks_ms(), timeout) > 100:
return 0
pulse_end = utime.ticks_us()
# Return duration in microseconds
return utime.ticks_diff(pulse_end, pulse_start)
def read_red():
"""Read red color pulse width
"""
S2_PIN.value(0)
S3_PIN.value(0)
utime.sleep_ms(10)
return read_pulse_width()
def read_green():
"""Read green color pulse width"""
S2_PIN.value(1)
S3_PIN.value(1)
utime.sleep_ms(10)
return read_pulse_width()
def read_blue():
"""Read blue color pulse width
"""
S2_PIN.value(0)
S3_PIN.value(1)
utime.sleep_ms(10)
return read_pulse_width()
def map_value(value, in_min, in_max, out_min, out_max):
"""Map value from one range to another"""
if in_max == in_min:
return out_min
return int((value - in_min) * (out_max - out_min) // (in_max - in_min) + out_min)
def constrain(value, min_val, max_val):
"""Constrain value between min and max
"""
return max(min_val, min(value, max_val))
print("TCS3200 Color Sensor - RGB Reading")
print()
try:
while True:
# Read pulse widths for all colors
red_pw = read_red()
green_pw = read_green()
blue_pw = read_blue()
# Convert to 0-255 RGB values
# Lower pulse width = brighter = higher RGB value
red_value = map_value(red_pw, red_min, red_max, 255, 0)
green_value = map_value(green_pw, green_min, green_max, 255, 0)
blue_value = map_value(blue_pw, blue_min, blue_max, 255, 0)
# Constrain to 0-255 range
red_value = constrain(red_value, 0, 255)
green_value = constrain(green_value, 0, 255)
blue_value = constrain(blue_value, 0, 255)
# Display RGB values
print(f"Red = {red_value} - Green = {green_value} - Blue = {blue_value}")
utime.sleep_ms(500)
except KeyboardInterrupt:
print("\nProgram stopped")
빠른 시작
- 배선도에 따라 Raspberry Pi Pico에 부품을 배선합니다.
- Micro USB 케이블을 사용하여 Raspberry Pi Pico를 컴퓨터에 연결합니다.
- Thonny IDE를 열고 인터프리터를 MicroPython (Raspberry Pi Pico)로 설정합니다.
- 위 코드를 Thonny IDE에 복사합니다.
- 코드 시작 부분의 보정 변수를 확인합니다:
red_min = 0
red_max = 0
green_min = 0
green_max = 0
blue_min = 0
blue_max = 0
- 여섯 개의 0 자리 표시자를 측정된 보정 데이터로 교체합니다. 예: red_min = 42, red_max = 210, green_min = 55, green_max = 185, blue_min = 60, blue_max = 172 값 사용:
red_min = 42
red_max = 210
green_min = 55
green_max = 185
blue_min = 60
blue_max = 172
- 업데이트된 코드를 Raspberry Pi Pico에 tcs3200_sensor.py로 저장합니다.
- 코드를 실행합니다.
- 센서 앞에 색상 샘플을 배치합니다.
- Thonny IDE 콘솔에서 RGB 출력을 확인합니다.
Shell x
>>> %Run -c $EDITOR_CONTENT
MPY: soft reboot
TCS3200 Color Sensor - RGB Reading
Red = 210 - Green = 35 - Blue = 20
Red = 25 - Green = 200 - Blue = 40
Red = 30 - Green = 45 - Blue = 215
MicroPython (Raspberry Pi Pico) • Board CDC @ COM29 ≡
표시된 RGB 값은 표준 0-255 스케일을 따릅니다. 펄스 폭이 짧을수록(밝은 반사를 나타냄) RGB 출력이 높아지고, 펄스 폭이 길수록(어두운 반사) 낮은 값이 나옵니다.
프로젝트 응용
RGB 측정 기능이 작동하면 다음을 개발할 수 있습니다:
- 색상 분류 시스템: 색상별 물체 분류(적색/녹색/청색 구분)
- 색상 검증 장치: 샘플 간 색상 일관성 확인
- 색상 경로 추적 로봇: 색상 마커를 따라 이동하는 로봇
- 시각적 품질 검사: 색상 분석으로 생산 결함 감지
- 색상 트리거 자동화: 특정 색조가 감지될 때 동작 실행
동영상
비디오 제작은 시간이 많이 걸리는 작업입니다. 비디오 튜토리얼이 학습에 도움이 되었다면, YouTube 채널 을 구독하여 알려 주시기 바랍니다. 비디오에 대한 높은 수요가 있다면, 비디오를 만들기 위해 노력하겠습니다.