8장 Arduino UNO Q에서 Debian Linux 기본 사용법 완벽 정리

개요

Arduino UNO Q는 기존의 단순한 마이크로컨트롤러 보드가 아니라, Debian Linux가 돌아가는 마이크로프로세서(MPU)와 Arduino 스케치를 실행하는 마이크로컨트롤러(MCU)가 함께 들어 있는 하이브리드 보드입니다. 즉, 한쪽에서는 리눅스로 파이썬·네트워크·리눅스 앱을 돌리고, 다른 쪽에서는 실시간 GPIO 제어와 센서 처리를 수행하도록 나눠 쓸 수 있습니다.

Generated Image

이 노트에서는 UNO Q에 탑재된 Debian Linux의 특징, 보드의 하이브리드 아키텍처, Bridge 메커니즘, Python 중심의 MPU 개발 환경, 그리고 실제로 어떻게 쉘에 접속하고 기본 리눅스 명령을 활용하는지까지 실용적인 관점에서 정리합니다. UNO Q를 "작은 리눅스 컴퓨터 + Arduino 보드"로 이해하고 활용하는 데 필요한 최소한의 개념과 명령을 한 번에 훑는 것을 목표로 합니다.

강사과정 모집 -> 아두이노 강의 | Arduino Uno로 배우는 임베디드 개발 | Arduino Uno Club

UNO Q에서의 Debian Linux 개념

UNO Q의 Qualcomm QRB2210 MPU에는 "완전한" Debian Linux 운영체제가 설치되어 있습니다. 이는 라즈베리 파이 같은 싱글보드 컴퓨터와 유사하게, 표준 Unix 도구와 유틸리티, 네트워크 서비스, 개발 도구 등을 그대로 사용할 수 있다는 의미입니다.

Debian 상에서는 여러 개의 프로그램을 동시에 실행할 수 있고, apt 패키지 관리자를 이용해 수천 개의 소프트웨어 패키지를 설치할 수 있습니다. 예를 들어 네트워크 서버를 띄우고, 파이썬 스크립트를 실행하며, 동시에 시스템 모니터링 도구를 돌리는 식의 "일반 리눅스 머신"과 같은 활용이 가능합니다.

UNO Q에서는 기본 사용자 디렉터리가 /home/arduino/이며, 여기서 대부분의 작업을 수행하게 됩니다. Arduino App Lab으로 만든 앱들은 ~/ArduinoApps/ 폴더 아래에 각각 독립된 디렉터리로 저장되어, 리눅스 환경에서 직접 확인·수정할 수 있습니다.

Debian 배포판의 특징

Debian은 다음과 같은 특징으로 잘 알려진 리눅스 배포판입니다.

첫째, 안정성입니다. Debian Stable 릴리스는 장기간 검증된 패키지들로 구성되어, 임베디드 보드나 서버 환경에 적합한 높은 안정성을 제공합니다.

둘째, 보안입니다. 보안 패치가 체계적으로 관리되고, 취약점에 대한 업데이트가 꾸준히 제공되며, 패키지들도 공식 저장소를 통해 검증된 형태로 배포됩니다.

셋째, 방대한 패키지 생태계와 apt입니다. apt 패키지 관리자를 이용하면 컴파일 없이 대부분의 개발도구·라이브러리·애플리케이션을 바로 설치할 수 있습니다. 예를 들어:

sudo apt update          # 패키지 목록 갱신
sudo apt install git     # git 설치
sudo apt install python3-pip  # 파이썬 패키지 관리 도구 설치

UNO Q에서도 기본적으로 이 Debian 생태계를 그대로 활용할 수 있기 때문에, 필요한 도구를 손쉽게 추가하면서 보드를 확장해 나갈 수 있습니다.

UNO Q 하드웨어와 하이브리드 아키텍처 이해

UNO Q는 두 개의 서로 다른 프로세서가 협력하는 구조를 가지고 있습니다.

Qualcomm QRB2210 MPU (리눅스 측)
- Debian Linux를 실행하는 메인 프로세서입니다.
- Wi‑Fi, Bluetooth 같은 네트워크 기능을 관리합니다.
- Python 스크립트, 각종 리눅스 애플리케이션, 서버 프로그램 등을 실행합니다.
- 시스템 자원과 고수준의 주변장치를 제어합니다.
STM32U585 MCU (마이크로컨트롤러 측)
- Zephyr RTOS를 실행하면서 Arduino 스케치를 구동합니다.
- 실시간 제어, 빠른 GPIO 응답, 센서/액추에이터 제어처럼 타이밍이 중요한 작업을 담당합니다.
- I2C, SPI, UART 등 하드웨어 인터페이스도 이쪽에서 직접 다루는 구조입니다.

두 프로세서는 내부적으로 Bridge 메커니즘을 통해 서로 통신합니다. 이 덕분에 UNO Q는 "리눅스가 가능한 일"과 "실시간 MCU가 잘하는 일"을 적절히 분담하여, Raspberry Pi + Arduino를 한 보드에 통합한 것처럼 쓸 수 있습니다.

Bridge 메커니즘과 MPU/MCU 통신 구조

Bridge 메커니즘은 Debian을 실행하는 MPU와 Zephyr·Arduino 스케치를 실행하는 MCU가 끊김 없이 데이터를 주고받게 해주는 통신 레이어입니다.

MPU 쪽에서는 보통 Python 스크립트나 기타 리눅스 프로그램이 Bridge를 통해 MCU 쪽에 명령을 보내거나 센서 데이터를 요청합니다. 예를 들어:

MPU(Python): 센서 값을 요청 → Bridge를 통해 메시지 전송
MCU(Arduino 스케치): 센서 읽기 → 값 계산 → Bridge로 응답 전송
MPU: 받은 값을 기반으로 데이터 로깅, 웹 대시보드 업데이트, 클라우드 전송 등 수행

MCU 쪽에서는 하드웨어에 밀접한, 실시간성이 필요한 처리를 하고, MPU는 연산량이 크거나 네트워크·파일 시스템을 많이 사용하는 일을 담당하는 식으로 역할을 분리할 수 있습니다.

현재 UNO Q에서 MPU 측 공식 지원 언어는 Python으로 명시되어 있으며, 향후에는 다른 언어 및 다양한 Bridge 사용 방식이 추가될 예정입니다. 실제 프로젝트에서는 "MCU 코드는 최대한 단순·안정적으로, 복잡한 로직과 통신은 MPU에서 처리"하는 방향으로 아키텍처를 설계하면 관리가 편해집니다.

MPU(리눅스 측) 개발 환경: Python 중심

UNO Q의 Debian 환경에서 Python은 공식적으로 지원되는 MPU 측 개발 언어입니다. 따라서 Debian 쉘에 접속한 뒤 다음과 같은 식으로 개발을 진행하는 흐름이 일반적입니다.

프로젝트 디렉터리 준비

cd ~
mkdir -p projects/uno-q-demo
cd projects/uno-q-demo

필요한 Python 패키지 설치

시스템 전역 혹은 가상환경을 사용해 필요한 패키지를 설치합니다.

sudo apt update
sudo apt install python3 python3-pip

필요하다면 pip로 추가 패키지를 설치할 수 있습니다.

Python 스크립트 작성

nano, vim, micro 같은 터미널 에디터나, SBC 모드에서 GUI 에디터(예: VSCode Server, 텍스트 에디터)를 통해 스크립트를 작성합니다. 스크립트 안에서 Bridge API(공식 라이브러리 문서 참조)를 사용하여 MCU 쪽 Arduino 스케치와 데이터를 주고받는 구조를 만들 수 있습니다.

서비스화/자동 실행

프로젝트 규모가 커지면 systemd 서비스로 등록하여 부팅 시 자동으로 파이썬 스크립트가 실행되도록 구성할 수도 있습니다. 이 부분은 일반적인 Debian 서버 설정 방식과 동일한 흐름을 따르게 됩니다.

Debian 쉘 접근 방법 개요

UNO Q의 Debian 쉘에 접근하는 방법은 크게 네 가지입니다.

USB-C(ADB) - 가장 간단한 직접 연결
SSH (네트워크) - 원격 접속
SBC 모드 - 모니터·키보드를 연결해 "작은 PC"처럼 사용
Hardware Debug UART - 저수준 디버그 및 부트 로그 확인

각 방법은 상황에 따라 장단점이 있으므로, 개발 초반에는 주로 ADB와 SSH를 사용하고, 문제가 생겼을 때 UART를 사용하는 패턴이 많습니다.

USB-C(ADB)를 통한 쉘 접속

ADB(Android Debug Bridge)는 USB를 통해 UNO Q의 쉘에 바로 접속할 수 있게 해주는 도구입니다. 네트워크 설정 없이도 쓸 수 있기 때문에 초기 설정이나 Wi‑Fi가 아직 안 잡힌 상태에서 특히 유용합니다.

준비물
- USB‑C 케이블
- PC에 ADB 도구 설치 (리눅스·macOS·Windows 모두 지원)
보드 연결 및 기기 인식 확인

터미널에서 다음을 실행합니다.

adb devices

여기에 UNO Q가 리스트로 나타나면 연결이 잘 된 것입니다.

쉘 접속

adb shell

명령을 실행하면 UNO Q의 Debian 쉘 프롬프트가 나타납니다. 이 상태에서 일반 리눅스 명령(ls, cd, apt 등)을 그대로 사용할 수 있습니다.

ADB는 물리적으로 USB 케이블을 연결한 상태여야 하기 때문에, 이동 중 원격 관리에는 적합하지 않지만, "언제나 되는 비상구" 같은 용도로 기억해 두면 좋습니다.

SSH(네트워크)를 통한 쉘 접속

SSH(Secure Shell)는 네트워크를 통해 UNO Q에 원격으로 접속하는 방법입니다. Wi‑Fi에만 연결되어 있으면, 같은 네트워크 어디에서든 터미널을 열어 접속할 수 있기 때문에, 일상적인 개발에는 SSH가 가장 편리합니다.

사전 조건
- UNO Q가 Wi‑Fi에 연결되어 있어야 합니다.
- Arduino App Lab에서의 초기 설정을 완료하면 SSH가 활성화됩니다.
- 접속하는 PC와 UNO Q는 반드시 같은 네트워크에 있어야 합니다.
SSH 접속

기본적으로 다음 형식으로 접속합니다.

ssh arduino@<boardname>

예를 들어 보드 이름이 unoqtest라면:

ssh arduino@unoqtest

처음 접속하면 "접속을 신뢰하겠냐"는 메시지가 나오며 yes를 입력하면 됩니다. 이후 보드의 비밀번호를 입력하면 Debian 쉘에 접속됩니다.

mDNS 문제 시 IP로 접속

일부 네트워크 환경에서는 <boardname>.local 이름이 잘 인식되지 않을 수 있습니다. 이럴 때는 UNO Q에 ADB나 SBC 모드로 먼저 접속해서 다음을 실행해 IP를 확인합니다.

hostname -I

그러면 예를 들어 192.168.0.23 같은 IP가 출력됩니다. 이 IP로 직접 SSH 접속하면 됩니다.

ssh arduino@192.168.0.23

SSH는 scp, rsync 등과 함께 사용하면 파일 업로드·다운로드까지 한 번에 해결할 수 있어, 코드 배포·로그 수집 등에 매우 유용합니다.

SBC(Single-Board Computer) 모드 사용

SBC 모드는 UNO Q를 작은 데스크톱 PC처럼 사용하는 모드입니다. 모니터와 키보드·마우스를 직접 연결해 GUI 환경으로 Debian을 사용할 수 있습니다.

준비물
- USB‑C 허브(전원 공급 가능, Apple 일부 어댑터 제외)
- HDMI 케이블 + 모니터
- USB 키보드·마우스
연결 방법
- UNO Q의 USB‑C 포트에 허브를 연결합니다.
- 허브에 외부 전원을 연결해 전력 공급을 합니다.
- HDMI 포트에 모니터를, USB 포트에 키보드·마우스를 연결합니다.
로그인 및 터미널 사용

부팅이 완료되면 그래픽 로그인 화면이 나오며, UNO Q의 사용자 계정으로 로그인합니다. 로그인 후 데스크톱 환경에서 Terminal 앱을 열어 쉘에 접속할 수 있습니다.

SBC 모드는 웹 브라우저로 테스트 페이지를 띄우거나, GUI 에디터를 사용해 편하게 코드 편집을 할 때 유리합니다. 다만 추가 주변기기가 필요하므로, 개발 중에는 SSH·ADB와 병행해 사용하는 경우가 많습니다.

Hardware Debug UART를 이용한 저수준 디버깅

마지막으로, UNO Q에는 Hardware Debug UART라는 전용 디버그 포트가 있습니다. 이는 SoC의 메인 콘솔(TTY)에 직접 연결되어 있어, 부트 단계에서 출력되는 커널 로그 등을 그대로 볼 수 있습니다.

특징
- 전압 레벨: 1.8V
- 보레이트: 115200 bps
- 커넥터: 보드의 JCTL 커넥터
사용을 위한 준비물
- 1.8V를 지원하는 USB‑to‑TTL 시리얼 변환기
- 시리얼 터미널 프로그램(minicom, screen, PuTTY 등)

이 포트는 네트워크나 ADB가 아직 올라오기 전 단계에서도 접근 가능하므로, 부팅 문제나 커널 패닉 등 가장 낮은 레벨의 문제를 진단할 때 사용합니다. 일반적인 애플리케이션 개발 단계에서는 자주 사용하지 않지만, 시스템 레벨 튜닝이나 커스텀 이미지 작업을 할 계획이 있다면 숙지해 두는 것이 좋습니다.

Debian 기본 사용법: 디렉터리 구조와 탐색

UNO Q의 Debian 파일 시스템은 일반적인 리눅스와 동일한 계층 구조를 따릅니다. 최상위는 /(root)이며, 그 아래에 /home, /tmp, /mnt 등의 디렉터리가 존재합니다.

/home/arduino/ : 기본 사용자(arduino)의 홈 디렉터리, 대부분의 작업이 이 안에서 이루어짐
/home/arduino/ArduinoApps/ : Arduino App Lab으로 만든 앱들이 저장되는 위치
/tmp/ : 임시 파일을 저장하는 디렉터리(재부팅 시 삭제 가능성 있음)
/mnt/ : USB 저장장치 등을 마운트할 때 주로 사용하는 경로

기본 이동 명령

디렉터리 이동에는 cd 명령을 사용합니다.

cd ~                     # 홈 디렉터리로 이동 (/home/arduino)
cd /home/arduino/Documents   # 특정 경로로 이동
cd ..                   # 상위 디렉터리로 이동
cd -                    # 이전 디렉터리로 되돌아감

현재 위치가 어디인지 확인하려면 pwd를 사용합니다.

pwd
# 예: /home/arduino/Documents

디렉터리 내용 보기

디렉터리 내 파일·폴더 목록을 확인할 때는 ls를 사용합니다.

ls              # 기본 목록
ls -lh          # 권한, 소유자, 크기(사람 읽기 좋은 단위) 포함
ls -a           # 숨김 파일(.으로 시작)까지 포함
ls -lah         # 전부 합친 상세 목록

이 명령들만 익숙해져도, UNO Q에서 파일을 찾고 프로젝트 폴더를 탐색하는 데 큰 어려움이 없습니다.

Debian 기본 사용법: 파일·디렉터리 관리

프로젝트를 정리하려면 디렉터리를 만들고, 파일을 복사·이동·삭제하는 기본 명령을 알아두면 좋습니다.

디렉터리 생성

mkdir my_project
mkdir -p projects/arduino/sketches   # 중간 디렉터리까지 한 번에 생성

-p 옵션은 중간에 없는 디렉터리가 있으면 자동으로 함께 만들어 줍니다.

파일 복사·이동·삭제

cp source.txt destination.txt      # 파일 복사
cp main.py backup/main.py          # 다른 디렉터리로 복사

mv oldname.txt newname.txt         # 이름 변경
mv file.txt ../                    # 상위 폴더로 이동

rm temp.txt                        # 파일 삭제
rm -r old_project                  # 폴더 및 내부 내용 삭제 (주의!)

중요한 파일을 다룰 때는 rm -r 사용에 특히 주의해야 하며, 삭제 전 ls로 한 번 더 확인하는 습관을 들이면 좋습니다.

Debian 기본 사용법: 권한과 관리자 작업(개념)

UNO Q에서 일반 작업은 보통 arduino 사용자로 수행합니다. 시스템 설정을 바꾸거나, 새로운 패키지를 설치하는 등 관리자 권한이 필요한 작업은 sudo를 사용합니다.

sudo apt update
sudo apt install htop

sudo는 "일시적으로 관리자(root) 권한으로 명령을 실행"하는 것으로, 비밀번호를 요구할 수 있습니다. UNO Q의 기본 설정이나 계정 정보는 공식 문서를 참고하여 확인하고, 프로젝트 보안 요구에 맞게 비밀번호를 변경해 두는 것이 안전합니다.

Debian 기본 사용법: 패키지 관리자 apt 활용

apt는 Debian에서 소프트웨어를 설치·업데이트·삭제하는 표준 도구입니다. UNO Q에서는 추가 개발 도구, 유틸리티, 서버 프로그램 등을 설치할 때 대부분 apt를 사용합니다.

패키지 목록 갱신

sudo apt update

패키지 설치

sudo apt install git
sudo apt install python3-venv

패키지 삭제

sudo apt remove 패키지이름
sudo apt purge 패키지이름   # 설정 파일까지 완전히 제거

설치 여부 확인

dpkg -l | grep 패키지이름

이 정도만 익혀도, 필요할 때마다 "검색 → 적당한 패키지 발견 → apt install"의 흐름으로 UNO Q를 원하는 개발 환경으로 확장해 나갈 수 있습니다.

실전 활용 아이디어: 하이브리드 구조를 어떻게 쓸까?

마지막으로, UNO Q의 "MPU + MCU + Bridge" 구조를 실제 프로젝트에 어떻게 활용할 수 있을지 간단히 정리합니다.

고성능 + 실시간 센서 처리
- MCU(Arduino 스케치): 초당 수백 회 센서 데이터를 읽고 필터링, 노이즈 제거 등 실시간 처리
- MPU(Python): 처리된 데이터를 받아 장기 로깅, 그래프 생성, 클라우드 업로드
네트워크·웹 서비스 + 로보틱스 제어
- MPU: Flask/FastAPI 같은 웹 서버를 띄워 HTTP REST API 제공
- MCU: 웹에서 들어온 명령(모터 속도, 서보 각도 등)을 Bridge를 통해 전달받아 즉시 하드웨어 제어
에지 AI + 주변장치
- MPU: 비교적 무거운 AI 모델(소형)을 실행해 인식 결과만 Bridge로 전송
- MCU: 인식 결과에 따라 LED, 부저, 모터 등 빠른 반응이 필요한 부분을 담당

이처럼 UNO Q는 단순히 "Linux도 되는 Arduino"가 아니라, 두 세계를 동시에 활용하는 하이브리드 플랫폼입니다. Debian 기본 사용법과 쉘 접속 방법만 익혀 두면, 이 구조를 다양한 형태의 프로젝트에 응용할 수 있습니다.

정리

UNO Q의 Qualcomm QRB2210 MPU에는 완전한 Debian Linux가 설치되어 있으며, 네트워크·파일 시스템·멀티태스킹 등 일반 리눅스 기능을 그대로 사용할 수 있습니다.
Debian은 안정성과 보안, 방대한 패키지 생태계를 강점으로 하며, apt를 통해 쉽게 소프트웨어를 설치·관리할 수 있습니다.
STM32U585 MCU는 Zephyr RTOS와 Arduino 스케치를 실행하며, 실시간 GPIO·센서·하드웨어 인터페이스를 담당합니다.
두 프로세서는 Bridge 메커니즘으로 연결되어, Python 등 MPU 측 코드와 Arduino 스케치가 데이터를 주고받을 수 있습니다.
Debian 쉘은 USB‑C(ADB), SSH, SBC 모드, Hardware Debug UART 네 가지 방식으로 접근할 수 있으며, 상황에 맞게 선택하면 됩니다.
cd, ls, pwd, mkdir, cp, mv, rm, sudo, apt 정도의 기본 명령만 익혀도 UNO Q의 Debian 환경을 실용적으로 활용할 수 있습니다.

이 노트를 바탕으로, 우선 ADB나 SSH로 보드에 접속해 직접 몇 개의 명령을 실행해 보고, 이후에 Python + Arduino 스케치를 함께 사용하는 간단한 하이브리드 예제를 만들어 보면서 개념을 몸으로 익혀 보기를 권장합니다.