아두이노 우노 Q 키패드 3x4
당신의 아두이노 UNO Q 프로젝트에 12키 멤브레인 키패드를 추가하고 싶으신가요? 이 튜토리얼에서는 키 입력을 읽는 방법과 비밀번호 확인 시스템을 구축하는 방법을 배우게 됩니다 — 그리고 키가 눌렸을 때 Telegram 알림도 받을 수 있습니다.
이 튜토리얼에서는 다음을 배우게 됩니다:
- 3x4 키패드가 무엇이고 어떻게 작동하는지
- 3x4 키패드를 아두이노 UNO Q에 연결하는 방법
- 키 입력을 감지하기 위해 MCU (C/C++ 아두이노 코드)를 프로그래밍하는 방법
- 키패드에 입력된 비밀번호 확인하는 방법
- Linux 측 (Python)과 MCU 측 (C/C++)을 모두 프로그래밍하여 Bridge를 통해 키패드를 읽는 방법
- 아두이노 UNO Q에서 키가 눌렸을 때 Telegram 알림을 보내는 방법
- 3x4 키패드를 사용하여 아두이노 UNO Q에서 OpenClaw를 사용하는 방법

하드웨어 필수
| 1 | × | Arduino UNO Q | 아마존 | |
| 1 | × | USB Cable for Arduino Uno Q | 아마존 | |
| 1 | × | 키패드 3x4 | 쿠팡 | 아마존 | |
| 1 | × | 점퍼케이블 | 쿠팡 | 아마존 | |
| 1 | × | (추천) 아두이노 우노용 스크루 터미널 블록 쉴드 | 쿠팡 | 아마존 | |
| 1 | × | (추천) Sensors/Servo Expansion Shield for Arduino Uno | 쿠팡 | 아마존 | |
| 1 | × | (추천) 아두이노 우노용 브레드보드 쉴드 | 쿠팡 | 아마존 | |
| 1 | × | (추천) 아두이노 우노용 케이스 | 쿠팡 | 아마존 | |
| 1 | × | (추천) 아두이노 우노용 프로토타이핑 베이스 플레이트 & 브레드보드 키트 | 아마존 |
3x4 키패드 소개
3x4 키패드는 4개의 행과 3개의 열로 배열된 12개의 멤브레인 버튼이 있습니다 — 표준 전화 스타일 레이아웃으로 1-9, *, 0, # 키가 있습니다.
핀아웃
3x4 키패드는 7개의 핀이 있으며 행과 열로 나뉩니다:
- 4개의 행 핀: R1, R2, R3, R4
- 3개의 열 핀: C1, C2, C3

배선 다이어그램

이 이미지는 Fritzing을 사용하여 만들어졌습니다. 이미지를 확대하려면 클릭하세요.
| 키패드 핀 | Arduino UNO Q MCU |
|---|---|
| R1 (Row 1) | D9 |
| R2 (Row 2) | D8 |
| R3 (Row 3) | D7 |
| R4 (Row 4) | D6 |
| C1 (Col 1) | D5 |
| C2 (Col 2) | D4 |
| C3 (Col 3) | D3 |
오래 사용할 프로젝트라면 나사 단자가 점퍼 와이어보다 전선을 더 잘 고정합니다. Arduino UNO Q 위에 Proto Screw Terminal Block Shield 또는 Screw Shield V2를 올린 다음, 각 전선을 나사로 조이세요. Screw Shield 버전은 아래 다이어그램을 참고하세요.

이 이미지는 Fritzing을 사용하여 만들어졌습니다. 이미지를 확대하려면 클릭하세요.
Arduino UNO Q 코드
Arduino UNO Q는 함께 작동하는 두 개의 프로세서를 가지고 있습니다:
- STM32 MCU는 DIYables_Keypad 라이브러리를 사용하여 키패드 매트릭스를 직접 읽습니다
- Qualcomm MPU는 Debian Linux를 실행하고 Wi-Fi, Python, 클라우드 연결을 처리합니다
- 이 섹션에서는 MCU만 프로그래밍됩니다 — Linux 측은 유휴 상태로 유지됩니다. 나중 섹션에서는 두 프로세서가 Bridge를 통해 함께 작동하는 방식을 보여줍니다.
빠른 단계
아두이노 UNO Q를 처음 사용하신가요? 계속하기 전에 아두이노 우노 Q 시작하기 튜토리얼을 따라 개발 환경을 준비하세요.
- 연결: 위의 배선 다이어그램에 따라 3x4 키패드를 Arduino UNO Q MCU에 연결합니다.
- Arduino App Lab 열기: Arduino App Lab을 시작하고 Arduino UNO Q를 감지할 때까지 기다립니다.
- 새 App 생성: Create New App 버튼을 클릭합니다.

- App의 이름을 입력합니다. 예를 들어: Keypad3x4
- Create를 클릭하여 확인합니다.

- 스케치 붙여넣기: 위의 MCU 코드를 복사하여 sketch/sketch.ino에 붙여넣습니다. 다른 파일은 기본값으로 유지합니다.
- Install the library: Click the Add sketch library button (the open book icon with a + sign) in the left sidebar.

- Search for DIYables_Keypad created by DIYables.io and click the Install button.
- 업로드: Arduino App Lab에서 Run 버튼을 클릭합니다.

- 시리얼 모니터 열기를 클릭하고 키패드의 키를 누릅니다. 각 키가 출력되는 것을 볼 수 있습니다.
키패드와 비밀번호
3x4 키패드의 일반적인 용도는 비밀번호 입력입니다. 두 개의 특수 키가 사용됩니다:
- * — 현재 입력을 지우고 다시 시작합니다
- # — 항목을 확인하고 비밀번호를 검사합니다
다른 모든 키는 비밀번호 문자열을 한 번에 한 문자씩 만듭니다.
로직:
- 아무 숫자 키든 누르기 → 입력 버퍼에 추가
- * 누르기 → 입력 버퍼 지우기
- # 누르기 → 입력과 저장된 비밀번호 비교, 버퍼 지우기
※ 주의:
업로드하기 전에 password 변수를 원하는 비밀번호로 변경하세요.
Bridge: Linux + MCU
이 섹션에서는 Linux 측에서 키패드 누름을 원격으로 읽을 수 있도록 Arduino UNO Q의 두 프로세서를 모두 프로그래밍하는 방법을 보여줍니다:
- 3x4 키패드는 MCU (STM32)에 연결됩니다 — MCU는 loop()에서 keypad.getKey()를 통해 이를 폴링합니다
- MPU는 키패드 핀을 직접 읽을 수 없습니다 — Bridge.call()을 통해 MCU에서 마지막으로 눌린 키를 요청해야 합니다
- MPU는 Wi-Fi를 가지고 있습니다 — 전체 Debian Linux를 실행하여 키 누름에 반응하고 인터넷을 통해 경고를 보낼 수 있습니다
- Arduino_RouterBridge는 두 프로세서 간 RPC 통신을 활성화합니다
- ⚠️ /dev/ttyHS1 (Linux)과 Serial1 (MCU)은 라우터에서 예약됨 — 사용자 코드에서 절대 열지 마세요
요약하면: MCU가 키패드를 폴링합니다 → MPU가 Bridge를 통해 마지막 키를 읽습니다 → MPU가 인터넷을 통해 어디에서나 키 누름에 반응할 수 있습니다.
참고: Bridge 스케치에서 keypad.getKey()는 Arduino loop() 내부에서 호출되어 키 누름을 지속적으로 감지합니다 — 이는 필수이며 Bridge 통신을 방해하지 않습니다.
MCU 코드 (Bridge)
Python 코드 (Bridge)
빠른 단계
- 연결: 배선 다이어그램에 표시된 대로 3x4 키패드를 Arduino UNO Q에 연결합니다.
- Arduino App Lab 열기: Arduino App Lab을 시작하고 보드가 감지될 때까지 기다립니다.
- 새 App 생성: Create New App을 클릭하고 Keypad3x4Bridge라고 이름 지은 후 Create를 클릭합니다.
- MCU 스케치 붙여넣기: 위의 MCU Bridge 코드를 복사하여 sketch/sketch.ino에 붙여넣습니다.
- Python 코드 붙여넣기: 위의 Python Bridge 코드를 복사하여 App의 Python 파일에 붙여넣습니다.
- 업로드: Arduino App Lab에서 Run 버튼을 클릭합니다.

- 키패드의 키를 누르고 Python 콘솔을 확인합니다.
App Lab 콘솔 출력
Telegram
3x4 키패드에서 키가 눌렸을 때 Telegram 알림을 받습니다 — 원격 액세스 시스템, 이벤트 트리거, 또는 PIN 코드 경고에 유용합니다.
MCU 스케치: 이전 Bridge 섹션과 동일한 MCU 스케치를 유지합니다.
Python 코드 (Telegram)
빠른 단계
- YOUR_TELEGRAM_BOT_TOKEN을 BotFather에서 받은 실제 봇 토큰으로 교체합니다.
- YOUR_CHAT_ID를 Telegram 채팅 ID로 교체합니다.
- 이 Python 코드를 App의 Python 파일에 붙여넣습니다 (동일한 MCU 스케치 유지).
- Run 버튼을 클릭합니다. 키패드의 키를 누릅니다 — Telegram 채팅에서 자동으로 알림을 받습니다.
App Lab 콘솔 출력
ArduinoBot
OpenClaw
You can adapt the OpenClaw to this tutorial by refering the instruction on 아두이노 우노 Q - OpenClaw Tutorial
프로젝트 아이디어
3x4 키패드를 사용하여 Arduino UNO Q로 많은 창의적인 프로젝트를 만들 수 있습니다:
- 원격 PIN 코드 잠금: 사용자가 키패드에 PIN을 입력합니다. MCU가 이를 검증하고 릴레이 또는 솔레노이드 잠금을 제어하는 동시에 MPU가 성공 또는 실패를 Telegram으로 경고합니다
- 스마트 숫자 입력: 키패드를 사용하여 여러 자리 숫자 (예: 온도 설정점 또는 타이머 지속 시간)를 입력하고 Bridge를 통해 Linux MPU로 보냅니다
- Telegram 트리거 키패드 검증: Python이 /check Telegram 명령을 받고 Bridge를 통해 get_key를 호출하며 물리적 키패드에서 가장 최근에 눌린 키로 응답합니다
- 메뉴 기반 제어 시스템: 키 1-9를 사용하여 동작을 선택하고 #을 눌러 확인합니다 — Python이 선택을 해석하고 릴레이 토글 또는 HTTP 요청 전송과 같은 IoT 작업을 트리거합니다
- 원격 액세스 코드 로거: 모든 키 누름이 자동으로 Telegram으로 전달됩니다. MPU의 보안 스크립트가 반복된 잘못된 시도를 감지하고 경고를 보냅니다
도전해 보세요
Arduino UNO Q의 3x4 키패드로 더 나아갈 준비가 되셨나요? 이 도전을 시도해 보세요:
- 쉬움: MCU 스케치를 수정하여 #가 눌렸을 때마다 D2에 연결된 LED를 켭니다.
- 중간: Python에서 전체 비밀번호 시스템을 구현합니다: Bridge를 통해 받은 키 누름을 문자열로 누적하고, #이 도착했을 때 저장된 비밀번호와 비교하며, 성공 또는 실패를 나타내는 Telegram 메시지를 보냅니다.
- 고급: Telegram 통합 액세스 제어 시스템을 구축합니다 — 물리적 4자리 PIN을 키패드에 입력합니다. 올바르면 MCU가 릴레이 (도어 잠금)를 활성화합니다. MPU가 모든 시도를 기록하고 결과와 타임스탐프가 포함된 Telegram 알림을 보냅니다.