아두이노 우노 Q RGB LED
RGB LED는 PWM 신호를 사용하여 빨강, 초록, 파랑 광도를 혼합하여 거의 모든 색상을 만들 수 있습니다. 이 튜토리얼에서는 간단한 색상 순환부터 Telegram을 통한 완전한 원격 제어까지 Arduino UNO Q로 RGB LED를 제어하는 방법을 배웁니다.
이 튜토리얼에서 배울 내용:
- RGB LED가 작동하는 방식 및 Arduino UNO Q에 연결하는 방법
- Arduino UNO Q MCU를 프로그래밍하여 다양한 색상을 표시하는 방법
- Bridge를 통해 Linux 측(Python)에서 RGB LED 색상을 제어하는 방법
- Telegram을 통해 세계 어디서나 원격으로 RGB 색상을 설정하는 방법
필요한 하드웨어
| 1 | × | Arduino UNO Q | 아마존 | |
| 1 | × | USB Cable for Arduino Uno Q | 아마존 | |
| 1 | × | RGB LED 모듈 | 쿠팡 | 아마존 | |
| 1 | × | (또는) RGB LED | 아마존 | |
| 1 | × | 브레드보드 | 쿠팡 | 아마존 | |
| 1 | × | 점퍼케이블 | 쿠팡 | 아마존 | |
| 1 | × | (추천) 아두이노 우노용 스크루 터미널 블록 쉴드 | 쿠팡 | 아마존 | |
| 1 | × | (추천) Sensors/Servo Expansion Shield for Arduino Uno | 쿠팡 | 아마존 | |
| 1 | × | (추천) 아두이노 우노용 브레드보드 쉴드 | 쿠팡 | 아마존 | |
| 1 | × | (추천) 아두이노 우노용 케이스 | 쿠팡 | 아마존 | |
| 1 | × | (추천) 아두이노 우노용 프로토타이핑 베이스 플레이트 & 브레드보드 키트 | 아마존 |
공개: 이 포스팅 에 제공된 일부 링크는 아마존 제휴 링크입니다. 이 포스팅은 쿠팡 파트너스 활동의 일환으로, 이에 따른 일정액의 수수료를 제공받습니다.
RGB LED 소개
작동 원리
RGB LED는 하나의 패키지에 빨강, 초록, 파랑의 세 개의 개별 LED를 포함합니다. PWM 신호(값 0–255)를 사용하여 각 색상의 다양한 강도를 혼합하면 256 × 256 × 256 = 1600만 가지 색상을 만들 수 있습니다.
핀아웃
RGB LED는 4개의 핀을 가지고 있습니다:
- 공통(카소드−): GND(0V)에 연결
- R: 빨강 색상 제어
- G: 초록 색상 제어
- B: 파랑 색상 제어
배선을 단순하게 유지하려면 RGB LED 모듈을 사용하세요 — 전류 제한 저항이 내장되어 있습니다.
※ 주의:
이 튜토리얼은 공통 카소드 RGB LED를 사용합니다. LED가 공통 애노드인 경우 공통 핀을 3.3V에 연결하고 값을 반전하세요: analogWrite()에서 255 - R, 255 - G, 255 - B를 사용합니다.
배선도
- 배선도 — Arduino UNO Q에서 RGB LED로(별도 저항 사용):
이 이미지는 Fritzing을 사용하여 만들어졌습니다. 이미지를 확대하려면 클릭하세요.
※ 주의:
공통 핀의 단일 저항이 아닌 색상 핀 3개 각각에 별도의 저항을 사용하세요. 3개의 내부 LED는 서로 다른 양의 전류를 소비하므로 공유 저항은 밝기를 불균등하게 하고 LED를 손상시킬 수 있습니다.
- 배선도 — Arduino UNO Q에서 RGB LED 모듈로(저항 내장):
이 이미지는 Fritzing을 사용하여 만들어졌습니다. 이미지를 확대하려면 클릭하세요.
RGB LED를 제어하는 방법
특정 색상(예: #00979D)을 표시하려면:
#define PIN_RED 9
#define PIN_GREEN 6
#define PIN_BLUE 3
pinMode(PIN_RED, OUTPUT);
pinMode(PIN_GREEN, OUTPUT);
pinMode(PIN_BLUE, OUTPUT);
analogWrite(PIN_RED, 0);
analogWrite(PIN_GREEN, 151);
analogWrite(PIN_BLUE, 157);
MCU 코드 — RGB LED 색상 순환
Arduino UNO Q는 두 개의 프로세서를 가지고 있습니다: STM32 MCU(실시간 하드웨어 제어 담당) 및 Qualcomm MPU(Debian Linux 실행). 이 섹션에서는 STM32 MCU만 프로그래밍되고 Linux 측은 유휴 상태입니다. 나중 섹션에서는 두 프로세서가 함께 작동하는 방식을 보여줍니다.
이 예제는 매초 3가지 색상을 순환합니다:
- #00C9CC — 틸(R=0, G=201, B=204)
- #F7788A — 연어 핑크(R=247, G=120, B=138)
- #34A853 — 초록(R=52, G=168, B=83)
/*
* 이 Arduino UNO Q 코드는 newbiely.kr 에서 개발되었습니다
* 이 Arduino UNO Q 코드는 어떠한 제한 없이 공개 사용을 위해 제공됩니다.
* 상세한 지침 및 연결도에 대해서는 다음을 방문하세요:
* https://newbiely.kr/tutorials/arduino-uno-q/arduino-uno-q-rgb-led
*/
#define PIN_RED 9 // The Arduino UNO Q pin connected to the LED's red pin
#define PIN_GREEN 6 // The Arduino UNO Q pin connected to the LED's green pin
#define PIN_BLUE 3 // The Arduino UNO Q pin connected to the LED's blue pin
void setup() {
pinMode(PIN_RED, OUTPUT); // Set red LED pin as an output
pinMode(PIN_GREEN, OUTPUT); // Set green LED pin as an output
pinMode(PIN_BLUE, OUTPUT); // Set blue LED pin as an output
}
void loop() {
// Set RGB LED to teal color #00C9CC (R = 0, G = 201, B = 204)
analogWrite(PIN_RED, 0);
analogWrite(PIN_GREEN, 201);
analogWrite(PIN_BLUE, 204);
delay(1000); // Maintain color for 1 second
// Set RGB LED to salmon pink #F7788A (R = 247, G = 120, B = 138)
analogWrite(PIN_RED, 247);
analogWrite(PIN_GREEN, 120);
analogWrite(PIN_BLUE, 138);
delay(1000); // Maintain color for 1 second
// Set RGB LED to Google green #34A853 (R = 52, G = 168, B = 83)
analogWrite(PIN_RED, 52);
analogWrite(PIN_GREEN, 168);
analogWrite(PIN_BLUE, 83);
delay(1000); // Maintain color for 1 second
}
빠른 단계
- Arduino UNO Q를 처음 사용하세요? 진행하기 전에 아두이노 우노 Q 시작하기 튜토리얼을 따라 개발 환경을 준비하세요.
- RGB LED 배선: 배선도에 따라 RGB LED 모듈(또는 저항이 있는 LED)을 핀 9, 6, 3에 연결합니다.
- 연결: USB-C 케이블로 Arduino UNO Q를 컴퓨터에 연결합니다.
- Arduino App Lab 열기: Arduino App Lab을 실행하고 Arduino UNO Q가 감지될 때까지 기다립니다.
- 새 App 생성: Create New App 버튼을 클릭합니다.
- 앱에 이름을 지정합니다. 예: DIYables_RgbLED
- 생성을 클릭하여 확인합니다.
- 새 App 내에서 생성된 폴더와 파일 집합을 볼 수 있습니다.
- sketch/sketch.ino 파일을 찾습니다 — MCU 스케치를 붙여넣을 위치입니다.
스케치 붙여넣기: 위의 MCU 코드를 복사하여 스케치 파일에 붙여넣습니다. 다른 파일은 기본값으로 유지합니다.
- Install the library: Click the Add sketch library button (the open book icon with a + sign) in the left sidebar.
- Search for Arduino_RouterBridge created by Arduino and click the Install button.
Bricks
No bricks added...
Sketch Libraries
No sketch libra...
Files
python
sketch
.gitignore
README.md
app.yaml
sketch.ino
- 업로드: Arduino App Lab에서 실행 버튼을 클릭하여 STM32로 컴파일 및 업로드합니다.
- LED 확인: RGB LED는 틸, 연어 핑크, 초록을 순환해야 합니다 — 각각 1초씩.
- 전문가 팁: RGB 값을 변경하여 자신의 색상을 표시합니다. 색상 선택기를 사용하여 올바른 값을 찾습니다.
setColor() 함수로 더 간단한 코드
많은 색상으로 작업할 때 setColor() 도우미 함수는 코드를 더 짧고 읽기 쉽게 만듭니다:
/*
* 이 Arduino UNO Q 코드는 newbiely.kr 에서 개발되었습니다
* 이 Arduino UNO Q 코드는 어떠한 제한 없이 공개 사용을 위해 제공됩니다.
* 상세한 지침 및 연결도에 대해서는 다음을 방문하세요:
* https://newbiely.kr/tutorials/arduino-uno-q/arduino-uno-q-rgb-led
*/
#define PIN_RED 9 // The Arduino UNO Q pin connected to the LED's red pin
#define PIN_GREEN 6 // The Arduino UNO Q pin connected to the LED's green pin
#define PIN_BLUE 3 // The Arduino UNO Q pin connected to the LED's blue pin
void setup() {
pinMode(PIN_RED, OUTPUT); // Set RED LED pin as an output
pinMode(PIN_GREEN, OUTPUT); // Set GREEN LED pin as an output
pinMode(PIN_BLUE, OUTPUT); // Set BLUE LED pin as an output
}
void loop() {
setColor(0, 201, 204); // teal #00C9CC
delay(1000);
setColor(247, 120, 138); // salmon pink #F7788A
delay(1000);
setColor(52, 168, 83); // Google green #34A853
delay(1000);
}
void setColor(int R, int G, int B) {
analogWrite(PIN_RED, R); // Write RED value to RED LED
analogWrite(PIN_GREEN, G); // Write GREEN value to GREEN LED
analogWrite(PIN_BLUE, B); // Write BLUE value to BLUE LED
}
- 전문가 팁: 색상 배열을 구축하고 이를 통해 루프하여 자동 색상 쇼 시퀀스를 만들 수 있습니다.
Linux + MCU Bridge 프로그래밍
Arduino UNO Q는 함께 작동하는 두 개의 프로세서를 가지고 있습니다: MPU(Qualcomm, Debian Linux 실행) 및 MCU(STM32, Arduino 스케치를 실행하는 Zephyr OS). Arduino_RouterBridge 라이브러리를 통해 RPC를 사용하여 통신합니다 — 절대 raw serial 포트를 통해서는 아닙니다.
- RGB LED는 MCU(STM32)에 연결됩니다 — STM32의 PWM 지원 디지털 핀에 배선됩니다. MCU는 analogWrite()를 사용하여 색상을 설정합니다.
- MPU는 LED를 직접 제어할 수 없습니다 — Bridge.call()을 통해 MCU에 명령을 보내야 합니다. MCU는 등록된 Bridge.provide_safe() 함수를 실행합니다.
- MPU는 Wi-Fi를 가지고 있습니다 — MPU는 Wi-Fi가 있는 전체 Debian Linux를 실행하므로 Telegram 명령을 받고 모든 RGB 색상을 원격으로 설정할 수 있습니다.
- 통신: Linux 측의 Bridge.call()은 MCU 측의 Bridge.provide_safe() 함수를 호출합니다
- ⚠️ 예약됨: /dev/ttyHS1(Linux) 및 Serial1(MCU)은 Arduino Router에서 사용됩니다 — 직접 열지 마세요
요약하면: MPU가 색상 명령을 보냅니다 → MCU가 수신합니다 → MCU가 실시간으로 RGB LED 색상을 설정합니다.
MCU 스케치 — Bridge 제어가 있는 RGB LED:
/*
* 이 Arduino UNO Q 코드는 newbiely.kr 에서 개발되었습니다
* 이 Arduino UNO Q 코드는 어떠한 제한 없이 공개 사용을 위해 제공됩니다.
* 상세한 지침 및 연결도에 대해서는 다음을 방문하세요:
* https://newbiely.kr/tutorials/arduino-uno-q/arduino-uno-q-rgb-led
*/
#include "Arduino_RouterBridge.h"
#define PIN_RED 9
#define PIN_GREEN 6
#define PIN_BLUE 3
void setColor(int R, int G, int B) {
analogWrite(PIN_RED, R);
analogWrite(PIN_GREEN, G);
analogWrite(PIN_BLUE, B);
Monitor.println("Color set to R=" + String(R) + " G=" + String(G) + " B=" + String(B));
}
void set_color(int R, int G, int B) {
setColor(R, G, B);
}
void turn_off() {
setColor(0, 0, 0);
Monitor.println("RGB LED off");
}
void setup() {
pinMode(PIN_RED, OUTPUT);
pinMode(PIN_GREEN, OUTPUT);
pinMode(PIN_BLUE, OUTPUT);
Bridge.begin();
Monitor.begin();
Bridge.provide_safe("set_color", set_color);
Bridge.provide_safe("turn_off", turn_off);
Monitor.println("RGB LED Bridge ready");
}
void loop() {}
Python 스크립트(Arduino App Lab) — Linux에서 색상을 순환:
/*
* 이 Arduino UNO Q 코드는 newbiely.kr 에서 개발되었습니다
* 이 Arduino UNO Q 코드는 어떠한 제한 없이 공개 사용을 위해 제공됩니다.
* 상세한 지침 및 연결도에 대해서는 다음을 방문하세요:
* https://newbiely.kr/tutorials/arduino-uno-q/arduino-uno-q-rgb-led
*/
from arduino.app_utils import *
import time
COLORS = [
(0, 201, 204, "Teal"),
(247, 120, 138, "Salmon pink"),
(52, 168, 83, "Green"),
(255, 0, 0, "Red"),
(0, 0, 255, "Blue"),
(255, 255, 0, "Yellow"),
(128, 0, 128, "Purple"),
]
def loop():
for r, g, b, name in COLORS:
print(f"Setting color: {name} (R={r}, G={g}, B={b})")
Bridge.call("set_color", r, g, b)
time.sleep(2)
print("Turning off RGB LED")
Bridge.call("turn_off")
time.sleep(2)
App.run(user_loop=loop)
- 참고: MCU 스케치에서 Bridge.begin()이 호출되고 Linux 측에서 Python 스크립트를 실행하기 전에 스케치가 업로드되었는지 확인하세요.
- ⚠️ 경고: 코드에서 /dev/ttyHS1(Linux)을 직접 열거나 Serial1(MCU)을 사용하지 마세요 — 이는 Arduino Router에서 예약되었으며 액세스하면 Bridge가 중단됩니다.
빠른 단계
- MCU 스케치 업로드: Arduino App Lab을 열고 새 App을 만들고 위의 Bridge MCU 스케치를 sketch/sketch.ino에 붙여넣고 기본 라이브러리를 유지하고(추가 라이브러리 필요 없음) Run을 클릭합니다.
- Python 스크립트 추가: 위의 Python 코드를 동일한 App의 Python 탭에 붙여넣습니다.
- 앱 실행: Run을 클릭합니다 — Python 측은 7가지 색상을 자동으로 순환한 다음 LED를 끕니다.
- 콘솔 확인: 콘솔 탭 → Python Console 서브탭을 열어 어느 색상이 활성화되어 있는지 확인합니다.
- 전문가 팁: Python 스크립트의 COLORS 목록에 더 많은 색상을 추가하여 색상 쇼를 확장합니다.
App Lab 콘솔 출력
sketch.ino
1#include "Arduino_RouterBridge.h"
Serial Monitor
Python
Setting color: Teal (R=0, G=201, B=204)
Setting color: Salmon pink (R=247, G=120, B=138)
Setting color: Green (R=52, G=168, B=83)
Setting color: Red (R=255, G=0, B=0)
Setting color: Blue (R=0, G=0, B=255)
Setting color: Yellow (R=255, G=255, B=0)
Setting color: Purple (R=128, G=0, B=128)
Turning off RGB LED
Telegram 통합
Telegram을 통해 원격으로 LED의 모든 RGB 색상을 설정할 수 있습니다 — R, G, B 값을 명령으로 보내면 됩니다.
Telegram 봇이 없다면 계속하기 전에 아두이노 우노 Q - 텔레그램 봇을 참조하여 봇 토큰을 얻으세요.
이 섹션에서 다루는 내용:
- Arduino UNO Q의 Linux 측에서 Python 스크립트를 실행하여 Telegram 메시지 수신 대기
- Bridge.call()을 통해 MCU로 색상 명령 전달
- Telegram으로 확인 회신 보내기
MCU 스케치: 이전 Bridge 섹션의 동일한 MCU 스케치 유지 — 변경 없음. 계속 진행하기 전에 STM32에서 이미 업로드되고 실행 중인지 확인하세요.
Python 스크립트(Arduino App Lab) — RGB LED 제어를 위한 Telegram 봇:
/*
* 이 Arduino UNO Q 코드는 newbiely.kr 에서 개발되었습니다
* 이 Arduino UNO Q 코드는 어떠한 제한 없이 공개 사용을 위해 제공됩니다.
* 상세한 지침 및 연결도에 대해서는 다음을 방문하세요:
* https://newbiely.kr/tutorials/arduino-uno-q/arduino-uno-q-rgb-led
*/
from arduino.app_utils import *
import requests
import time
BOT_TOKEN = "YOUR_BOT_TOKEN"
API_URL = f"https://api.telegram.org/bot{BOT_TOKEN}"
last_update_id = 0
def send_message(chat_id, text):
requests.post(f"{API_URL}/sendMessage", json={"chat_id": chat_id, "text": text})
def get_updates():
global last_update_id
resp = requests.get(f"{API_URL}/getUpdates", params={"offset": last_update_id + 1, "timeout": 5})
return resp.json().get("result", [])
def loop():
global last_update_id
updates = get_updates()
for update in updates:
last_update_id = update["update_id"]
msg = update.get("message", {})
chat_id = msg.get("chat", {}).get("id")
text = msg.get("text", "").strip()
if text.startswith("/color "):
parts = text.split()
try:
r = int(parts[1])
g = int(parts[2])
b = int(parts[3])
if all(0 <= v <= 255 for v in (r, g, b)):
Bridge.call("set_color", r, g, b)
send_message(chat_id, f"Color set to R={r}, G={g}, B={b}")
else:
send_message(chat_id, "Each value must be between 0 and 255")
except (ValueError, IndexError):
send_message(chat_id, "Usage: /color <R> <G> <B>\nExample: /color 255 0 0")
elif text == "/off":
Bridge.call("turn_off")
send_message(chat_id, "RGB LED turned off")
else:
send_message(chat_id, "Commands:\n/color <R> <G> <B> — set RGB color\n/off — turn LED off\n\nExamples:\n/color 255 0 0\n/color 0 201 204")
time.sleep(1)
App.run(user_loop=loop)
- 참고: YOUR_BOT_TOKEN을 Telegram의 @BotFather에서 얻은 토큰으로 바꾸세요.
- LED를 빨강으로 설정하려면 /color 255 0 0을 보냅니다.
- 틸의 경우 /color 0 201 204를 보냅니다.
- LED를 끄려면 /off를 보냅니다.
빠른 단계
- MCU 스케치 업로드: 이전 섹션의 Bridge MCU 스케치를 사용합니다(아직 업로드되지 않은 경우 먼저 업로드).
- Telegram 스크립트 붙여넣기: 위의 Python 코드를 Arduino App Lab의 App의 Python 탭에 복사합니다.
- 토큰 설정: 스크립트의 YOUR_BOT_TOKEN을 실제 봇 토큰으로 바꿉니다.
- 앱 실행: Run을 클릭합니다 — 봇이 즉시 Telegram 메시지 수신 대기를 시작합니다.
- 테스트: Telegram을 열고 봇을 찾아 보라색의 경우 /color 128 0 128을 보내거나 LED를 끄려면 /off를 보냅니다.
- 전문가 팁: 색상 선택기를 사용하여 모든 색상의 RGB 값을 찾은 다음 Telegram을 통해 직접 보냅니다.
App Lab 콘솔 출력
sketch.ino
1#include "Arduino_RouterBridge.h"
Serial Monitor
Python
[2026-04-29 12:00:01] Telegram: /color 255 0 0
[2026-04-29 12:00:01] Color set to R=255, G=0, B=0
[2026-04-29 12:03:15] Telegram: /color 0 201 204
[2026-04-29 12:03:15] Color set to R=0, G=201, B=204
[2026-04-29 12:06:40] Telegram: /off
[2026-04-29 12:06:40] RGB LED turned off
Telegram
12:45
Welcome to Telegram!
ArduinoBot
10:19
Chatting with Arduino...
BotFather
Yesterday
Your bot has been created.
ArduinoBot
bot
OpenClaw 통합
이 튜토리얼을 OpenClaw에 적응시킬 수 있습니다. 아두이노 우노 Q - OpenClaw 튜토리얼의 지침을 참조하세요.
추가 지식
- 공통 애노드 RGB LED: 공통 핀을 3.3V에 연결하고 각 채널 값을 반전합니다: analogWrite(PIN_RED, 255 - R).
- 이미지의 색상: Colors From Image 도구를 사용하여 모든 사진에서 색상 코드를 추출한 다음 RGB 값으로 변환합니다.
- RGB LED 스트립: 함께 연결된 일련의 RGB LED는 RGB LED 스트립을 형성합니다. 주소 지정 가능한 스트립(예: WS2812B)은 각 LED를 개별적으로 설정할 수 있습니다 — 이 항목에 대한 전용 튜토리얼을 참조하세요.
애플리케이션/프로젝트 아이디어
다음은 RGB LED와 Arduino UNO Q로 만들 수 있는 프로젝트 아이디어입니다:
- Telegram 제어 분위기 조명: Telegram을 사용하여 어디서든 방의 조명 색상을 설정합니다
- 알림 표시기: 다양한 색상을 사용하여 다양한 이벤트를 알립니다(파랑 = 이메일, 빨강 = 경고, 초록 = 정상)
- 식물 건강 모니터: 토양 수분 수준에 따라 LED 색상 변경(초록 = 좋음, 노랑 = 건조, 빨강 = 물 필요)
- 색상 코딩된 날씨 스테이션: 맑은 하늘은 초록, 비는 파랑, 높은 온도 경고는 빨강
- 디스코 라이트 쇼: 높은 속도로 무작위 색상을 순환하며 Telegram을 통해 트리거합니다
도전 문제
Arduino UNO Q의 RGB LED로 다음 도전 문제를 시도하세요:
- 쉬움: 독립 실행형 스케치의 순환 시퀀스에 네 번째 색상을 추가합니다(예: 주황색: R=255, G=165, B=0)
- 중간: Bridge 스케치를 확장하여 set_red(), set_green(), set_blue()를 별도의 Bridge 함수로 노출하고 Python에서 각 채널을 독립적으로 제어합니다
- 고급: Telegram 봇을 구축하여 이름이 지정된 색상(예: /purple, /orange)을 수락하고 이를 RGB 값으로 매핑한 다음 MCU에서 set_color()를 호출합니다