아두이노 우노 Q LED 페이딩
LED 밝기 제어 — 부드럽게 페이딩하여 밝기를 증가 및 감소시키기 — 는 Arduino 프로그래밍의 기본 기술입니다. 이 자습서에서는 PWM(펄스 폭 변조)을 사용하여 Arduino UNO Q의 LED 밝기를 점진적으로 증가 및 감소시키는 방법을 배웁니다.
이 자습서에서 배울 내용:
- delay() 를 사용하여 LED를 페이딩하는 방법 (간단함, 초보자용)
- millis() 를 사용하여 블로킹 없이 LED를 페이딩하는 방법 (권장됨)
- Bridge를 통해 Linux 측(Python)에서 LED 밝기를 제어하는 방법
- Telegram을 통해 원격으로 LED 밝기를 설정하거나 페이딩을 트리거하는 방법
필요한 하드웨어
| 1 | × | Arduino UNO Q | 아마존 | |
| 1 | × | USB Cable for Arduino Uno Q | 아마존 | |
| 1 | × | LED | 쿠팡 | 아마존 | |
| 1 | × | LED Module | 아마존 | |
| 1 | × | 220Ω Resistor | 아마존 | |
| 1 | × | 브레드보드 | 쿠팡 | 아마존 | |
| 1 | × | 점퍼케이블 | 쿠팡 | 아마존 | |
| 1 | × | (추천) 아두이노 우노용 스크루 터미널 블록 쉴드 | 쿠팡 | 아마존 | |
| 1 | × | (추천) Sensors/Servo Expansion Shield for Arduino Uno | 쿠팡 | 아마존 | |
| 1 | × | (추천) 아두이노 우노용 브레드보드 쉴드 | 쿠팡 | 아마존 | |
| 1 | × | (추천) 아두이노 우노용 케이스 | 쿠팡 | 아마존 | |
| 1 | × | (추천) 아두이노 우노용 프로토타이핑 베이스 플레이트 & 브레드보드 키트 | 아마존 |
공개: 이 포스팅 에 제공된 일부 링크는 아마존 제휴 링크입니다. 이 포스팅은 쿠팡 파트너스 활동의 일환으로, 이에 따른 일정액의 수수료를 제공받습니다.
LED에 대하여
핀 배열
LED는 두 개의 핀을 가지고 있습니다:
- 캐소드(−) 핀: GND(0V)에 연결
- 애노드(+) 핀: LED 밝기를 제어하는 데 사용
작동 방식
캐소드를 GND에 연결한 후:
- 애노드를 GND(0V) 에 연결 → LED는 OFF
- 애노드를 VCC 에 연결 → LED는 완전히 ON
- 애노드에 PWM 신호 전송 → 밝기는 0(꺼짐)과 255(완전)사이로 변함
※ 주의:
대부분의 LED는 애노드와 신호 핀 사이에 전류 제한 저항(예: 220Ω)이 필요합니다. 없으면 LED가 타버릴 위험이 있습니다.
Arduino UNO Q로 LED 페이딩
Arduino UNO Q STM32 MCU는 특정 핀(예: 핀 9)에서 PWM을 지원합니다. LED 애노드를 220Ω 저항을 통해 PWM 가능 핀에 연결하고, 캐소드를 GND에 연결합니다. analogWrite(pin, value) 를 사용하여 밝기(0–255)를 설정합니다.
배선도
이 이미지는 Fritzing을 사용하여 만들어졌습니다. 이미지를 확대하려면 클릭하세요.
프로그래밍 방법
- 핀 모드를 출력으로 설정:
pinMode(9, OUTPUT);
- PWM을 사용하여 LED 밝기 조정:
analogWrite(9, brightness); // brightness: 0 (off) to 255 (full on)
MCU 코드 — LED 페이딩 (delay 포함)
Arduino UNO Q는 두 개의 프로세서를 가지고 있습니다: STM32 MCU(실시간 하드웨어 제어 담당)와 Qualcomm MPU(Debian Linux 실행). 이 섹션에서는 STM32 MCU만 프로그래밍됩니다 — Linux 측은 유휴 상태로 남습니다. 이후 섹션에서 두 프로세서가 함께 작동하는 방법을 보여드리겠습니다.
이 예제는 delay() 를 사용하여 LED 밝기를 점진적으로 증가 및 감소시킵니다:
/*
* 이 Arduino UNO Q 코드는 newbiely.kr 에서 개발되었습니다
* 이 Arduino UNO Q 코드는 어떠한 제한 없이 공개 사용을 위해 제공됩니다.
* 상세한 지침 및 연결도에 대해서는 다음을 방문하세요:
* https://newbiely.kr/tutorials/arduino-uno-q/arduino-uno-q-fade-led
*/
#define LED_PIN 9 // The Arduino UNO Q pin connected to the LED
int brightness = 0; // how bright the LED is
int fade_step = 5; // how many points to fade the LED by
// the setup routine runs once when you press reset:
void setup() {
// declare pin 9 to be an output:
pinMode(LED_PIN, OUTPUT);
}
// the loop routine runs over and over again forever:
void loop() {
// set the brightness of pin 9:
analogWrite(LED_PIN, brightness);
// change the brightness for next time through the loop:
brightness = brightness + fade_step;
// reverse the direction of the fading at the ends of the fade:
if (brightness <= 0 || brightness >= 255) {
fade_step = -fade_step;
}
// wait for 30 milliseconds to see the dimming effect
delay(30);
}
빠른 단계
- Arduino UNO Q를 처음 사용하나요? 진행하기 전에 아두이노 우노 Q 시작하기 자습서를 따라 개발 환경을 준비하세요.
- LED 연결: 배선도에 따라 220Ω 저항과 함께 LED를 핀 9에 연결합니다.
- 연결: Arduino UNO Q를 USB-C 케이블로 컴퓨터에 연결합니다.
- Arduino App Lab 열기: Arduino App Lab을 실행하고 Arduino UNO Q를 감지할 때까지 기다립니다.
- 새 App 만들기: Create New App 버튼을 클릭합니다.
- App에 이름을 지정합니다. 예: DIYables_FadeLED
- Create 를 클릭하여 확인합니다.
- 새 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의 Run 버튼을 클릭하여 STM32로 컴파일하고 업로드합니다.
- LED 확인: LED가 부드럽게 페이딩하여 밝기가 증가 및 감소해야 합니다.
- 프로 팁: delay(30) 값을 줄입니다(예: delay(10)). 페이딩을 더 빠르게 하거나 늘려서 더 느리게 만듭니다.
코드 설명
설명은 위의 코드의 주석에 있습니다.
※ 주의:
delay() 함수는 대기하는 동안 모든 다른 코드를 블로킹합니다. 더 반응성 있는 동작(예: 센서 읽기 또는 명령에 응답)을 원하면 다음 섹션에서 보여드리는 millis() 를 대신 사용하세요.
MCU 코드 — LED 페이딩 (delay 없음)
이 버전은 millis() 를 사용하여 논-블로킹 페이딩합니다 — 루프는 자유롭게 계속 실행되고, LED는 3초 기간 동안 부드럽게 페이딩합니다:
/*
* 이 Arduino UNO Q 코드는 newbiely.kr 에서 개발되었습니다
* 이 Arduino UNO Q 코드는 어떠한 제한 없이 공개 사용을 위해 제공됩니다.
* 상세한 지침 및 연결도에 대해서는 다음을 방문하세요:
* https://newbiely.kr/tutorials/arduino-uno-q/arduino-uno-q-fade-led
*/
#define LED_PIN 9 // The Arduino UNO Q pin connected to the LED
#define FADE_PERIOD 3000 // fade time is 3 seconds
unsigned long fade_start_ms;
// the setup routine runs once when you press reset
void setup() {
pinMode(LED_PIN, OUTPUT); // declare pin 9 to be an output
fade_start_ms = millis();
}
// fade-in in loop, and restart after finishing
void loop() {
unsigned long progress = millis() - fade_start_ms;
if (progress <= FADE_PERIOD) {
long brightness = map(progress, 0, FADE_PERIOD, 0, 255);
analogWrite(LED_PIN, brightness);
} else {
fade_start_ms = millis(); // restart fade again
}
}
빠른 단계
- sketch/sketch.ino 의 코드를 이 논-블로킹 버전으로 교체합니다.
- Run을 클릭하여 업로드합니다.
- LED는 3초 주기로 지속적으로 페이딩합니다.
- 프로 팁: FADE_PERIOD 3000 을 1000 으로 변경하면 더 빠른 페이딩이거나 5000 으로 더 느린 페이딩입니다. map() 에서 0, 255 와 255, 0 를 바꿔서 대신 페이드 아웃할 수도 있습니다.
Linux + MCU Bridge 프로그래밍
Arduino UNO Q는 함께 작동하는 두 개의 프로세서를 가지고 있습니다: MPU(Qualcomm, Debian Linux 실행)와 MCU(STM32, Zephyr OS 실행). 그들은 Arduino_RouterBridge 라이브러리를 통해 RPC 로 통신합니다 — 절대 원본 직렬 포트로 통신하지 않습니다.
- 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 명령을 수신하고 원격으로 LED 밝기를 설정하거나 페이딩을 트리거할 수 있습니다.
- 통신: Linux 측의 Bridge.call() 은 MCU 측의 Bridge.provide_safe() 함수를 호출합니다.
- ⚠️ 예약됨: /dev/ttyHS1(Linux)과 Serial1(MCU)은 Arduino Router에서 사용됩니다 — 절대 직접 열지 마세요.
간단히 말해서: MPU는 밝기/페이드 명령을 보냅니다 → MCU는 수신 → MCU는 실시간으로 LED를 업데이트합니다.
MCU 스케치 — Bridge 제어를 사용한 LED 페이드:
/*
* 이 Arduino UNO Q 코드는 newbiely.kr 에서 개발되었습니다
* 이 Arduino UNO Q 코드는 어떠한 제한 없이 공개 사용을 위해 제공됩니다.
* 상세한 지침 및 연결도에 대해서는 다음을 방문하세요:
* https://newbiely.kr/tutorials/arduino-uno-q/arduino-uno-q-fade-led
*/
#include "Arduino_RouterBridge.h"
#define LED_PIN 9
int current_brightness = 0;
bool fading = false;
int fade_period_ms = 3000;
unsigned long fade_start_ms = 0;
int fade_direction = 1; // 1 = fade-in, -1 = fade-out
void set_brightness(int value) {
fading = false;
current_brightness = constrain(value, 0, 255);
analogWrite(LED_PIN, current_brightness);
Monitor.println("Brightness set to: " + String(current_brightness));
}
void start_fade(int period_ms) {
fade_period_ms = period_ms > 0 ? period_ms : 3000;
fade_start_ms = millis();
fading = true;
fade_direction = 1;
Monitor.println("Fading started with period: " + String(fade_period_ms) + "ms");
}
void stop_fade() {
fading = false;
analogWrite(LED_PIN, 0);
current_brightness = 0;
Monitor.println("Fade stopped");
}
void setup() {
pinMode(LED_PIN, OUTPUT);
Bridge.begin();
Monitor.begin();
Bridge.provide_safe("set_brightness", set_brightness);
Bridge.provide_safe("start_fade", start_fade);
Bridge.provide_safe("stop_fade", stop_fade);
Monitor.println("Fade LED Bridge ready");
}
void loop() {
if (!fading) return;
unsigned long progress = millis() - fade_start_ms;
if (progress >= (unsigned long)fade_period_ms) {
// reverse direction and restart
fade_direction = -fade_direction;
fade_start_ms = millis();
progress = 0;
}
long brightness;
if (fade_direction == 1) {
brightness = map(progress, 0, fade_period_ms, 0, 255);
} else {
brightness = map(progress, 0, fade_period_ms, 255, 0);
}
analogWrite(LED_PIN, brightness);
}
Python 스크립트(Arduino App Lab) — Linux에서 LED 밝기 및 페이딩 제어:
/*
* 이 Arduino UNO Q 코드는 newbiely.kr 에서 개발되었습니다
* 이 Arduino UNO Q 코드는 어떠한 제한 없이 공개 사용을 위해 제공됩니다.
* 상세한 지침 및 연결도에 대해서는 다음을 방문하세요:
* https://newbiely.kr/tutorials/arduino-uno-q/arduino-uno-q-fade-led
*/
from arduino.app_utils import *
import time
def loop():
print("Starting auto fade (2 seconds per cycle)")
Bridge.call("start_fade", 2000)
time.sleep(8)
print("Setting brightness to 128 (half)")
Bridge.call("set_brightness", 128)
time.sleep(2)
print("Setting brightness to 255 (full)")
Bridge.call("set_brightness", 255)
time.sleep(2)
print("Setting brightness to 0 (off)")
Bridge.call("set_brightness", 0)
time.sleep(2)
print("Starting slow fade (5 seconds per cycle)")
Bridge.call("start_fade", 5000)
time.sleep(15)
print("Stopping fade")
Bridge.call("stop_fade")
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 스크립트 추가: 같은 App의 Python 탭에 위의 Python 코드를 붙여넣습니다.
- App 실행: Run을 클릭합니다 — Python 측은 페이드 및 밝기 패턴 사이를 자동으로 순환합니다.
- 콘솔 확인: Console 탭 → Python Console 하위 탭을 열어 Python 측이 수행 중인 작업을 확인합니다.
- 프로 팁: Python에서 Bridge.call("set_brightness", 0) 을 호출하여 LED를 즉시 끕니다.
App Lab 콘솔 출력
sketch.ino
1#include "Arduino_RouterBridge.h"
Serial Monitor
Python
Starting auto fade (2 seconds per cycle)
Setting brightness to 128 (half)
Setting brightness to 255 (full)
Setting brightness to 0 (off)
Starting slow fade (5 seconds per cycle)
Stopping fade
Telegram 통합
Telegram을 통해 원격으로 LED 밝기 및 페이딩을 제어할 수 있습니다 — 특정 밝기 수준을 설정하거나 어디서나 부드러운 페이딩을 트리거합니다.
아직 Telegram 봇이 없으면 계속하기 전에 아두이노 우노 Q - 텔레그램 봇 을 보고 봇 토큰을 얻습니다.
이 섹션에서 다루는 내용:
- Arduino UNO Q의 Linux 측에서 Python 스크립트를 실행하여 Telegram 메시지를 듣기
- Bridge.call() 을 통해 MCU로 밝기 또는 페이드 명령 전달
- Telegram으로 확인 응답 전송
MCU 스케치: 이전 Bridge 섹션에서 동일한 MCU 스케치를 유지 — 변경이 필요하지 않습니다. STM32에서 업로드되고 실행 중인지 확인하고 진행하세요.
Python 스크립트(Arduino App Lab) — LED 밝기 제어용 Telegram 봇:
/*
* 이 Arduino UNO Q 코드는 newbiely.kr 에서 개발되었습니다
* 이 Arduino UNO Q 코드는 어떠한 제한 없이 공개 사용을 위해 제공됩니다.
* 상세한 지침 및 연결도에 대해서는 다음을 방문하세요:
* https://newbiely.kr/tutorials/arduino-uno-q/arduino-uno-q-fade-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("/brightness "):
parts = text.split()
try:
value = int(parts[1])
if 0 <= value <= 255:
Bridge.call("set_brightness", value)
send_message(chat_id, f"Brightness set to {value}")
else:
send_message(chat_id, "Brightness must be between 0 and 255")
except (ValueError, IndexError):
send_message(chat_id, "Usage: /brightness <0-255>")
elif text.startswith("/fade "):
parts = text.split()
try:
period_ms = int(parts[1])
Bridge.call("start_fade", period_ms)
send_message(chat_id, f"Fading started with {period_ms}ms period")
except (ValueError, IndexError):
send_message(chat_id, "Usage: /fade <period_ms>\nExample: /fade 3000")
elif text == "/fade":
Bridge.call("start_fade", 3000)
send_message(chat_id, "Fading started with 3000ms period")
elif text == "/stop":
Bridge.call("stop_fade")
send_message(chat_id, "Fade stopped, LED off")
else:
send_message(chat_id, "Commands:\n/brightness <0-255> — set brightness\n/fade <period_ms> — start fading\n/stop — stop fade\n\nExamples:\n/brightness 128\n/fade 3000")
time.sleep(1)
App.run(user_loop=loop)
- 참고: YOUR_BOT_TOKEN 을 Telegram의 @BotFather에서 얻은 토큰으로 바꿉니다.
- /brightness 128 을 보내 LED를 절반의 밝기로 설정합니다.
- /fade 3000 을 보내 3초 주기의 부드러운 페이딩을 시작합니다.
- /stop 을 보내 페이딩을 중지하고 LED를 끕니다.
빠른 단계
- MCU 스케치 업로드: 이전 섹션의 Bridge MCU 스케치를 사용합니다(아직 수행하지 않았으면 먼저 업로드하세요).
- Telegram 스크립트 붙여넣기: 위의 Python 코드를 Arduino App Lab의 App의 Python 탭에 복사합니다.
- 토큰 설정: 스크립트에서 YOUR_BOT_TOKEN 을 실제 봇 토큰으로 바꿉니다.
- App 실행: Run을 클릭합니다 — 봇이 즉시 Telegram 메시지를 듣기 시작합니다.
- 테스트: /brightness 200 을 보내 LED를 거의 완전한 밝기로 설정하거나 빠른 페이드 효과를 위해 /fade 2000 을 보냅니다.
- 프로 팁: /brightness 0 을 /stop 대신 보냅니다 — 페이드 상태를 중지하지 않고 LED를 끕니다.
App Lab 콘솔 출력
sketch.ino
1#include "Arduino_RouterBridge.h"
Serial Monitor
Python
[2026-04-29 12:00:01] Telegram: /brightness 128
[2026-04-29 12:00:01] Brightness set to 128
[2026-04-29 12:03:20] Telegram: /fade 3000
[2026-04-29 12:03:20] Fading started with 3000ms period
[2026-04-29 12:07:45] Telegram: /stop
[2026-04-29 12:07:45] Fade stopped, LED off
Telegram
12:45
Welcome to Telegram!
ArduinoBot
10:19
Chatting with Arduino...
BotFather
Yesterday
Your bot has been created.
ArduinoBot
bot
OpenClaw 통합
아두이노 우노 Q - OpenClaw 자습서에서 지침을 참조하여 OpenClaw를 이 자습서에 적용할 수 있습니다
애플리케이션/프로젝트 아이디어
다음은 LED 페이딩 및 Arduino UNO Q로 구축할 수 있는 프로젝트입니다:
- 주변 분위기 조명: Telegram을 사용하여 침대에서 책상 램프 또는 야간 조명의 밝기 수준 설정
- 일출 알람: 예약된 시간에 MPU의 Linux 시계를 사용하여 느린 페이드인 프로그래밍
- 배터리 표시기: 배터리 전압을 LED 밝기에 매핑 — 어두울수록 충전량이 낮음
- 심박 효과: 빠르게 페이딩하여 펄스 효과 생성 — 웨어러블 또는 상태 LED에 최적
- 야간 조명 제어기: 저녁에는 완전 밝기, 밤에는 절반, 새벽에는 꺼짐 — 예약된 Telegram 명령을 통해
자신을 도전해보세요
Arduino UNO Q의 LED 페이딩으로 이러한 챌린지를 시도하세요:
- 쉬움: Fade2.cpp 에서 FADE_PERIOD 를 변경하여 LED가 3초 대신 1초에 페이드인하도록 만들기
- 중간: Bridge 스케치를 확장하여 현재 밝기 값을 Python에 반환하는 get_brightness() 함수 노출
- 고급: 명명된 밝기 수준(/dim, /half, /full)을 수용하고 64, 128, 255에 매핑한 후 Bridge.call() 을 통해 적용하는 Telegram 봇 구축