아두이노 우노 Q 포텐셔미터로 서보 모터 제어하기
이 튜토리얼은 Arduino UNO Q를 사용하여 포텐셔미터로 서보 모터의 각도를 제어하는 방법을 보여줍니다. 포텐셔미터 손잡이를 돌리면 서보 모터가 0°에서 180°까지 비례적으로 회전합니다.
※ 주의:
Arduino UNO Q ADC 차이점: Arduino UNO Q의 STM32 MCU는 12비트 ADC (값 0–4095)를 가지고 있으며, 10비트(0–1023)가 아닙니다. ADC 값을 0–4095에서 서보 각도 0–180도로 매핑하세요.
필요한 하드웨어
| 1 | × | Arduino UNO Q | 아마존 | |
| 1 | × | USB Cable for Arduino Uno Q | 아마존 | |
| 1 | × | 서보 모터 | 쿠팡 | 아마존 | |
| 1 | × | 포텐셔미터 | 쿠팡 | 아마존 | |
| 1 | × | 노브가 있는 포텐셔미터 모듈 | 쿠팡 | 아마존 | |
| 1 | × | 브레드보드 | 쿠팡 | 아마존 | |
| 1 | × | 점퍼케이블 | 쿠팡 | 아마존 | |
| 1 | × | (추천) 아두이노 우노용 스크루 터미널 블록 쉴드 | 쿠팡 | 아마존 | |
| 1 | × | (추천) Sensors/Servo Expansion Shield for Arduino Uno | 쿠팡 | 아마존 | |
| 1 | × | (추천) 아두이노 우노용 브레드보드 쉴드 | 쿠팡 | 아마존 | |
| 1 | × | (추천) 아두이노 우노용 케이스 | 쿠팡 | 아마존 | |
| 1 | × | (추천) 아두이노 우노용 프로토타이핑 베이스 플레이트 & 브레드보드 키트 | 아마존 |
공개: 이 포스팅 에 제공된 일부 링크는 아마존 제휴 링크입니다. 이 포스팅은 쿠팡 파트너스 활동의 일환으로, 이에 따른 일정액의 수수료를 제공받습니다.
배선도
- 기본 포텐셔미터를 사용하는 경우:
이 이미지는 Fritzing을 사용하여 만들어졌습니다. 이미지를 확대하려면 클릭하세요.
- 포텐셔미터 모듈을 사용하는 경우:
이 이미지는 Fritzing을 사용하여 만들어졌습니다. 이미지를 확대하려면 클릭하세요.
프로그래밍 방법
- 포텐셔미터에서 ADC 값 읽기 (Arduino UNO Q에서 12비트, 0–4095):
int analogValue = analogRead(A0);
- ADC 값을 서보 각도로 매핑 (0–180도):
int angle = map(analogValue, 0, 4095, 0, 180);
- 계산된 각도로 서보 이동:
myServo.write(angle);
MCU 코드 — 포텐셔미터가 서보 모터 제어
Arduino UNO Q는 두 개의 프로세서를 가지고 있습니다: STM32 MCU (실시간 하드웨어 제어 처리) 및 Qualcomm MPU (Debian Linux 실행). 이 섹션에서는 STM32 MCU만 프로그래밍됩니다 — Linux 쪽은 유휴 상태로 유지됩니다. 나중 섹션에서는 두 프로세서가 함께 작동하는 방법을 보여줍니다.
/*
* 이 Arduino UNO Q 코드는 newbiely.kr 에서 개발되었습니다
* 이 Arduino UNO Q 코드는 어떠한 제한 없이 공개 사용을 위해 제공됩니다.
* 상세한 지침 및 연결도에 대해서는 다음을 방문하세요:
* https://newbiely.kr/tutorials/arduino-uno-q/arduino-uno-q-potentiometer-servo-motor
*/
#include <Servo.h>
Servo myServo;
void setup() {
myServo.attach(9); // attach servo to pin 9
}
void loop() {
// Read ADC value from potentiometer (12-bit: 0-4095 on Arduino UNO Q)
int analogValue = analogRead(A0);
// Map ADC value to servo angle (0-180 degrees)
int angle = map(analogValue, 0, 4095, 0, 180);
// Move servo to the mapped angle
myServo.write(angle);
delay(50);
}
빠른 단계
- Arduino UNO Q를 처음 사용하나요? 진행하기 전에 아두이노 우노 Q 시작하기 튜토리얼을 따라 개발 환경을 준비하세요.
- 컴포넌트 배선: 포텐셔미터 출력을 A0에 연결하고, GND를 GND에, VCC를 3.3V에 연결하세요. 배선도에 따라 서보 신호를 핀 9에 연결하세요.
- 연결: Arduino UNO Q를 USB-C 케이블로 컴퓨터에 연결하세요.
- Arduino App Lab 열기: Arduino App Lab을 시작하고 Arduino UNO Q를 감지할 때까지 기다리세요.
- 새 앱 만들기: Create New App 버튼을 클릭하세요.
- 앱에 이름을 지정하세요. 예: DIYables_PotServo
- Create를 클릭하여 확인하세요.
- 새 앱 내에서 생성된 폴더 및 파일 집합을 볼 수 있습니다.
- 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에 컴파일 및 업로드하세요.
- 포텐셔미터 손잡이를 돌리세요 — 서보가 손잡이 위치를 0°에서 180°까지 부드럽게 추적해야 합니다.
Linux + MCU Bridge 프로그래밍
Arduino UNO Q는 함께 작동하는 두 개의 프로세서를 가지고 있습니다: MPU (Qualcomm, Debian Linux 실행) 및 MCU (STM32, Zephyr OS와 Arduino 스케치 실행). 이들은 Arduino_RouterBridge 라이브러리를 통해 RPC를 사용하여 통신합니다 — 절대 원본 직렬 포트를 통해서가 아닙니다.
- 포텐셔미터와 서보는 MCU(STM32)에 연결됩니다 — 포텐셔미터 출력 와이어는 A0으로, 서보 신호는 핀 9로 연결됩니다. MCU는 지속적으로 ADC 값을 읽고 loop()에서 서보 각도를 업데이트합니다.
- MPU는 포텐셔미터를 직접 읽거나 서보를 제어할 수 없습니다 — Bridge.call()을 통해 MCU에서 현재 서보 각도를 요청해야 합니다.
- MPU는 Wi-Fi를 가지고 있습니다 — MPU는 Wi-Fi와 함께 전체 Debian Linux를 실행하기 때문에 Telegram을 통해 서보 각도를 보고할 수 있습니다.
- 통신: Linux 쪽의 Bridge.call()은 MCU 쪽의 Bridge.provide() 함수를 호출합니다.
- ⚠️ 예약됨: /dev/ttyHS1 (Linux) 및 Serial1 (MCU)은 Arduino Router에서 사용됩니다 — 절대 직접 열지 마세요.
요약하면: MPU가 서보 각도 요청 → MCU가 ADC를 읽고 변환 → MCU가 ADC 및 각도 보고 → MPU가 기록하거나 전달합니다.
MCU 스케치 — Bridge 및 Monitor 출력이 있는 포텐셔미터-서보:
/*
* 이 Arduino UNO Q 코드는 newbiely.kr 에서 개발되었습니다
* 이 Arduino UNO Q 코드는 어떠한 제한 없이 공개 사용을 위해 제공됩니다.
* 상세한 지침 및 연결도에 대해서는 다음을 방문하세요:
* https://newbiely.kr/tutorials/arduino-uno-q/arduino-uno-q-potentiometer-servo-motor
*/
#include "Arduino_RouterBridge.h"
#include <Servo.h>
Servo myServo;
int current_angle = 0;
void get_servo_angle() {
Monitor.print("Potentiometer ADC: ");
Monitor.print(analogRead(A0));
Monitor.print(" => Servo angle: ");
Monitor.println(current_angle);
}
void setup() {
myServo.attach(9);
Bridge.begin();
Monitor.begin();
Bridge.provide("get_servo_angle", get_servo_angle);
Monitor.println("Potentiometer-Servo Bridge ready");
}
void loop() {
int analogValue = analogRead(A0);
current_angle = map(analogValue, 0, 4095, 0, 180);
myServo.write(current_angle);
delay(50);
}
Python 스크립트 (Arduino App Lab) — Linux에서 서보 각도 폴링:
/*
* 이 Arduino UNO Q 코드는 newbiely.kr 에서 개발되었습니다
* 이 Arduino UNO Q 코드는 어떠한 제한 없이 공개 사용을 위해 제공됩니다.
* 상세한 지침 및 연결도에 대해서는 다음을 방문하세요:
* https://newbiely.kr/tutorials/arduino-uno-q/arduino-uno-q-potentiometer-servo-motor
*/
from arduino.app_utils import *
import time
def loop():
while True:
Bridge.call("get_servo_angle")
time.sleep(1)
App.run(user_loop=loop)
- 참고: MCU 스케치에서 Bridge.begin()을 호출했고 Linux 쪽에서 Python 스크립트를 실행하기 전에 스케치가 업로드되었는지 확인하세요.
- ⚠️ 경고: Linux에서 /dev/ttyHS1을 직접 열거나 MCU에서 Serial1을 사용하지 마세요 — 이들은 Arduino Router에 의해 예약되어 있으며 이들에 액세스하면 Bridge가 손상됩니다.
빠른 단계
- MCU 스케치 업로드: Arduino App Lab을 열고, 새 앱을 만들고, 위의 Bridge MCU 스케치를 sketch/sketch.ino에 붙여넣고, Servo 및 Arduino_RouterBridge 라이브러리를 설치하고, Run을 클릭하세요.
- Python 스크립트 추가: 위의 Python 코드를 같은 앱의 Python 탭에 붙여넣으세요.
- 앱 실행: Run을 클릭하세요 — Python 쪽이 매초 서보 각도를 폴링합니다.
- 포텐셔미터 손잡이를 돌리세요 그리고 서보가 손잡이 위치를 추적하는 것을 보세요.
- 콘솔 확인: Console 탭을 열기 → MCU Monitor 서브탭에서 ADC 및 각도 값이 기록되는 것을 보세요.
App Lab 콘솔 출력
sketch.ino
1#include "Arduino_RouterBridge.h"
Serial Monitor
Python
Potentiometer-Servo Bridge ready
Potentiometer ADC: 0 => Servo angle: 0
Potentiometer ADC: 1024 => Servo angle: 45
Potentiometer ADC: 2048 => Servo angle: 90
Potentiometer ADC: 3072 => Servo angle: 135
Potentiometer ADC: 4095 => Servo angle: 180
Telegram 통합
Telegram을 통해 어디서나 원격으로 현재 서보 각도를 확인하세요.
아직 Telegram 봇이 없다면, 계속하기 전에 아두이노 우노 Q - 텔레그램 봇을 보고 봇 토큰을 얻으세요.
MCU 스케치: 이전 Bridge 섹션에서 같은 MCU 스케치 유지 — 변경 사항 없음. STM32에 이미 업로드되어 실행 중인지 확인하세요.
Python 스크립트 (Arduino App Lab) — 서보 각도를 위한 Telegram 봇:
/*
* 이 Arduino UNO Q 코드는 newbiely.kr 에서 개발되었습니다
* 이 Arduino UNO Q 코드는 어떠한 제한 없이 공개 사용을 위해 제공됩니다.
* 상세한 지침 및 연결도에 대해서는 다음을 방문하세요:
* https://newbiely.kr/tutorials/arduino-uno-q/arduino-uno-q-potentiometer-servo-motor
*/
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 == "/angle":
angle = Bridge.call("get_servo_angle")
send_message(chat_id, angle)
else:
send_message(chat_id, "Commands:\n/angle — read current servo angle (based on potentiometer position)")
time.sleep(1)
App.run(user_loop=loop)
- 참고: YOUR_BOT_TOKEN을 Telegram의 @BotFather에서 얻은 토큰으로 바꾸세요.
- /angle을 보내면 포텐셔미터 위치에 따른 현재 서보 각도를 확인합니다.
빠른 단계
- MCU 스케치 업로드: 이전 섹션의 Bridge MCU 스케치를 사용하세요 (아직 업로드하지 않았다면 먼저 업로드하세요).
- Telegram 스크립트 붙여넣기: 위의 Python 코드를 Arduino App Lab의 앱 Python 탭에 복사하세요.
- 토큰 설정: 스크립트의 YOUR_BOT_TOKEN을 실제 봇 토큰으로 바꾸세요.
- 앱 실행: Run을 클릭하세요 — 봇이 Telegram 메시지를 수신 대기하기 시작합니다.
- 테스트: 포텐셔미터를 돌리고, /angle을 보내세요 — 봇이 ADC 값과 서보 각도로 응답합니다.
App Lab 콘솔 출력
sketch.ino
1#include "Arduino_RouterBridge.h"
Serial Monitor
Python
[2026-04-29 12:00:01] Telegram: /angle
[2026-04-29 12:00:01] Potentiometer ADC: 2048 => Servo angle: 90
[2026-04-29 12:03:20] Telegram: /angle
[2026-04-29 12:03:20] Potentiometer ADC: 4095 => Servo angle: 180
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 튜토리얼의 지시사항을 참조하여 적용하세요.
응용 프로그램/프로젝트 아이디어
- 카메라 팬 제어: 포텐셔미터를 서보 장착 카메라의 실제 팬 조이스틱으로 사용 — Telegram을 통해 위치 확인
- 로봇 팔 조인트: 로봇 팔 조인트 각도를 포텐셔미터로 수동으로 제어
- 원격 안테나 포지셔: 포텐셔미터를 사용하여 서보로 안테나를 정렬 — Telegram을 통해 각도 확인
- 밸브 유량 제어기: 포텐셔미터를 서보 조작 밸브로 매핑 — 밸브 개방 비율을 원격으로 확인
- 대화형 다이얼: 다이얼이 서보를 통해 시각적 지표를 제어하는 물리적 인터페이스 구축
도전해 보세요
- 쉬움: 두 개의 포텐셔미터 (A0 및 A1)를 추가하여 각각 두 개의 서보를 서로 다른 핀에서 제어
- 중간: ADC 값과 각도를 별도의 Bridge 콜백으로 노출: get_adc() 및 get_angle()
- 어려움: 마지막 기록된 각도에서 서보가 15° 이상 이동할 때 자동으로 알림을 보내는 Telegram 봇 구축 — Python의 모니터링 루프 사용