제10부 서드파티 생태계

10.1 라즈베리파이 호환 HAT·카메라 활용

라즈베리파이 생태계는 방대하다. 카메라 모듈, 디스플레이, GPIO 확장 HAT까지 십수 년간 쌓인 액세서리가 있다. UNO Q가 "라즈베리파이와 호환된다"는 말을 들으면 이 생태계 전체를 그대로 활용할 수 있다고 기대하기 쉽다. 실제로는 부분적으로만 맞는 말이다 — 어디까지 맞고 어디부터 틀리는지를 정확히 구분하는 것이 이 장의 목적이다.

10.1.1 "호환"의 두 가지 의미

라즈베리파이 관련 호환성 주장은 크게 두 가지로 나뉜다.

카메라·디스플레이 커넥터 호환: MIPI CSI/DSI는 업계 표준 규격이고, 커넥터 핀아웃이 같으면 물리적으로 같은 케이블·모듈을 연결할 수 있다. 이 유형은 UNO Q에도 실제로 해당한다(10.1.5).
GPIO HAT 호환: 라즈베리파이의 40핀 2.54mm 헤더에 장착하는 HAT(Hardware Attached on Top) 생태계. 이 유형은 UNO Q 본체에는 해당하지 않는다 — 흔히 혼동되는 지점이라 다음 절에서 먼저 바로잡는다.

10.1.2 먼저 바로잡기 — UNO Q에는 라즈베리파이 40핀 헤더가 없다

시중 자료·블로그를 검색하면 "UNO Q, 40핀 GPIO 헤더로 라즈베리파이 액세서리와 완전 호환"이라는 문장을 심심찮게 보게 된다. 이 문장은 UNO Q가 아니라 Arduino의 별도 제품인 VENTUNO Q에 대한 설명이다. Arduino 공식 VENTUNO Q 제품 페이지는 다음과 같이 명시한다(2026-08 확인).

"Standard 40-pin GPIO header provides full electrical and mechanical compatibility with Raspberry Pi accessories." — Arduino VENTUNO Q 제품 페이지

VENTUNO Q는 UNO Q와 이름이 비슷하고 같은 "듀얼 브레인" 계열이지만 별도의 폼팩터를 가진 다른 제품이다. 두 제품의 자세한 비교는 0.3(제품군 개관)에서 다룬다. 이 책에서 "UNO Q"라고 쓸 때는 항상 기본 UNO Q 보드를 가리키며, 이 장의 나머지 내용도 UNO Q 기준이다.

⚠️ 실전 함정: 중고 거래·해외 쇼핑몰·번역된 리뷰 글에서 두 제품명이 뒤섞여 인용되는 경우가 있다. 라즈베리파이 HAT을 사기 전에는 반드시 보드 실물의 실크스크린이나 구매 영수증의 정확한 모델명(UNO Q vs VENTUNO Q)을 확인한다.

10.1.3 UNO Q의 실제 헤더·커넥터 배치

UNO Q 공식 사용자 매뉴얼은 보드의 커넥터를 이렇게 설명한다.

"The UNO Q is equipped with two connector types: the classic UNO-style headers on the top, designed for prototyping and debugging, guaranteeing full compatibility with Arduino UNO Shields, and the high-speed header connectors on the bottom, purpose-built for integration with UNO Q carriers." — UNO Q 공식 사용자 매뉴얼

정리하면 UNO Q에는 라즈베리파이식 40핀 헤더 대신 다음 세 종류의 커넥터가 있다.

Maker I/O 헤더(상단): 클래식 Arduino UNO 실드와 기계적으로 호환. 3.3V 로직 — 상세는 10.2.
Qwiic 커넥터: SparkFun 표준 I2C 커넥터. 상세는 10.3.
메자닌 커넥터(하단, JMISC1·JMEDIA1): 고밀도 board-to-board 커넥터로, Arduino의 자체 "캐리어" 보드(공식 UNO Media Carrier·UNO Breakout Carrier 등, 2026-03 발표)나 서드파티 캐리어가 장착되는 위치다. 커뮤니티 리버스엔지니어링 프로젝트(frankie-eight-days/uno-q-mezzanine-kicad)에 따르면 이 커넥터는 Greenconn GPEC212 계열의 2×30핀, 1.27mm 피치 부품으로, 라즈베리파이의 2.54mm 피치 40핀 헤더와는 전혀 다른 규격이다 — 즉 기계적으로도 라즈베리파이 HAT을 직꽂이할 수 없다.

카메라·디스플레이용 MIPI 신호는 이 메자닌 커넥터의 JMEDIA1 뱅크에 1.8V 도메인으로 실려 있을 뿐, UNO Q 기본 보드 자체에는 카메라를 연결할 수 있는 22핀 FPC 커넥터가 노출되어 있지 않다. 실제로 카메라를 연결하려면 이 메자닌 신호를 22핀 FPC 커넥터로 breakout해 주는 캐리어 보드가 하나 더 필요하다 — 10.1.5에서 이어진다.

10.1.4 라즈베리파이 GPIO HAT, UNO Q에서 얼마나 살릴 수 있나

물리적으로 장착할 수 없다고 해서 라즈베리파이 HAT 생태계가 UNO Q에서 완전히 무용지물인 것은 아니다. HAT 내부 구조에 따라 살릴 수 있는 정도가 다르다.

HAT 유형	UNO Q에서 되는 정도	이유·방법
순수 I2C 센서·디스플레이 HAT(예: 소형 OLED, BME280류 환경센서, RTC 모듈)	대체로 가능(재배선 필요)	I2C는 표준 프로토콜이므로 HAT의 40핀 커넥터 대신 해당 SDA·SCL·전원·GND 4가닥만 UNO Q의 Qwiic 또는 Maker I/O의 I2C 핀(D20/D21, A4/A5)에 점퍼선으로 연결하면 동작할 가능성이 높다. 단 HAT이 5V만 지원한다면 10.2의 레벨 시프터·전압 확인 절차를 반드시 거친다.
GPIO 핀 번호에 종속적인 HAT(예: 특정 BCM 핀 번호를 하드코딩한 릴레이·버튼 HAT)	부분 가능, 소프트웨어 이식 필요	전기적으로는 재배선하면 되지만, HAT 전용 라이브러리가 라즈베리파이의 `RPi.GPIO`·`gpiozero` API나 BCM 핀 번호를 직접 참조하는 경우가 많아 코드를 Arduino API(`digitalWrite` 등) 또는 Linux 측 `libgpiod`로 다시 작성해야 한다.
라즈베리파이 전용 커널 드라이버·디바이스트리 오버레이가 필요한 HAT(예: 공식 카메라 HAT의 ISP 파이프라인, 일부 e-ink 디스플레이의 SPI+GPIO 조합 드라이버, DAC/사운드 HAT의 ALSA 오버레이)	대체로 불가 또는 매우 어려움	이런 드라이버는 라즈베리파이 커널(`bcm2835`/`raspberrypi` 트리)에 맞춰 컴파일되어 있고, UNO Q는 Qualcomm QRB2210 기반의 완전히 다른 SoC·커널을 쓴다(3.1). 드라이버를 UNO Q 커널에 새로 포팅하지 않는 한 동작하지 않는다.
전원 인젝션·팬 제어처럼 라즈베리파이 40핀의 특정 전원 핀(5V 직결) 배치에 의존하는 HAT	불가	UNO Q 커넥터 배치 자체가 다르므로 애초에 해당 없음.

견해: 순수 센서형 HAT은 "부품 서랍"으로 재활용하고, 라즈베리파이 전용 드라이버가 필요한 HAT(카메라 HAT, 사운드 HAT 등)은 처음부터 UNO Q용으로 기대하지 않는 편이 현실적이다. 애매하면 HAT 제조사 GitHub 저장소에서 커널 모듈·디바이스트리 오버레이 파일이 있는지 검색해보면 판단이 빨라진다 — 그런 파일이 있다는 것 자체가 라즈베리파이 종속성의 신호다.

10.1.5 MIPI CSI 카메라 — 라즈베리파이 카메라 모듈을 UNO Q에서 쓰는 법

카메라 쪽은 사정이 다르다. Arduino는 2026년 3월 UNO Q용 신규 액세서리 7종을 발표하면서, 카메라·디스플레이 확장용 캐리어 보드에 대해 다음과 같이 설명했다(Arduino 공식 블로그, 2026-03-27).

UNO Q의 카메라 확장 커넥터는 표준 22핀 MIPI CSI 4-lane 카메라(라즈베리파이 카메라 모듈 등)를 위한 것이며, 라즈베리파이 5와 동일한 22핀 핀아웃을 사용한다. 이 표준화 덕분에 라즈베리파이 5 호환 카메라 모듈은 재배선·어댑터 없이 그대로 연결할 수 있다.

다만 10.1.3에서 언급했듯, 이 22핀 커넥터는 UNO Q 기본 보드에 직접 실장되어 있지 않다. 실제 경로는 다음과 같다.

UNO Q의 메자닌 커넥터(JMEDIA1)에 MIPI CSI/DSI 신호가 1.8V 도메인으로 노출되어 있다.
이 신호를 22핀 FPC 커넥터로 물리적으로 breakout해주는 캐리어 보드를 UNO Q 하단에 장착한다 — 공식 UNO Media Carrier(2026-03 발표, 정확한 판매 시점·가격은 구매 전 재확인)이거나 10.1.6의 커뮤니티 어댑터.
그 22핀 FPC 커넥터에 라즈베리파이 5 호환 카메라 모듈(Camera Module 3, HQ Camera 등)을 연결한다.

카메라만이 아니라 MIPI DSI 디스플레이도 같은 경로로 확장된다 — 라즈베리파이 호환성은 카메라 입력뿐 아니라 디스플레이 출력에도 적용된다.

10.1.6 커뮤니티 비전 어댑터 실사용

UNO Q가 출시된 지 오래되지 않았음에도, 커뮤니티는 이미 이 메자닌 커넥터를 breakout하는 오픈하드웨어 카메라 보드를 공개했다. GitHub·제조사 페이지를 직접 확인한 두 사례를 소개한다.

Camemake — Camemake-Arduino-Uno-Q-Vision-Adaptor(GitHub, 제품 페이지)

"A fully open source camera shield for the Arduino UNO Q" — UNO Q 전용으로 명시(클래식 UNO용이 아님).
UNO Q의 클래식 UNO 실드 폼팩터 헤더에 직접 얹히는 형태("Fits directly on the Arduino UNO Q headers").
22핀 FPC 커넥터 2개(MIPI CSI-2), 라즈베리파이 5 카메라 포트와 동일 핀아웃. "all Raspberry Pi 5 camera modules" 및 Camemake 자체 모듈군 지원.
전원 레일 1.8V(코어/IO)·2.8V(아날로그), 센서 초기화용 I2C/TWI 제어 버스.
GPL-3.0 라이선스, 회로도·BOM·기구 파일 공개.

RevLmt — camboard-uno-q(GitHub)

MIPI-CSI 카메라 2개와 MIPI-DSI 디스플레이 1개를 분리해 내는 브레이크아웃 보드.
카메라용 22핀 FPC 커넥터 2개, 디스플레이용 22핀 FPC 커넥터 1개.
UNO Q와는 60핀 헤더 2개로 직결(패스스루용 60핀 헤더 2개도 별도 제공) — 앞서 설명한 JMISC1/JMEDIA1 메자닌 커넥터 규격과 일치한다.
현재 라즈베리파이 Camera Module V2(IMX219 센서)만 검증되어 있으며, CAM0 커넥터를 쓰려면 디바이스트리 파일을 직접 편집해야 하고 이를 자동화하는 셸 스크립트(setup_device.sh)를 제공한다.
CERN-OHL-P-2.0 오픈하드웨어 라이선스.

두 프로젝트 모두 Arduino 공식이 아닌 커뮤니티/개인 오픈하드웨어 프로젝트다. 상용화되어 있긴 하나(Camemake는 "Production modules sold"라고 명시) 공식 지원·보증과는 별개다.

10.1.7 소프트웨어 측 함정 — 핀아웃이 같아도 드라이버는 다르다

여기가 이 장에서 가장 자주 간과되는 지점이다. 커넥터 핀아웃이 같다고 카메라 센서가 자동으로 인식되는 것은 아니다. 라즈베리파이는 Broadcom SoC + libcamera/bcm2835-camera 스택으로 특정 센서(IMX219, IMX708 등)를 인식하도록 커널·디바이스트리가 미리 갖춰져 있다. UNO Q는 Qualcomm QRB2210 SoC이고 카메라 ISP·드라이버 스택도 Qualcomm 계열이다 — 물리적 핀아웃이 같다고 소프트웨어 인식까지 같이 오는 것이 아니다.

camboard-uno-q 프로젝트가 "IMX219 센서만 검증, 디바이스트리 수동 편집 필요"라고 명시한 것이 바로 이 함정을 보여주는 실사례다. 카메라 프로젝트를 계획할 때는 다음을 먼저 확인한다.

쓰려는 센서(IMX219/IMX708 등)가 UNO Q Debian 이미지에서 이미 인식 보고가 있는지(커뮤니티 포럼·GitHub 이슈 검색).
디바이스트리 오버레이 편집이 필요한지, 필요하다면 어떤 절차인지(대개 커뮤니티 프로젝트 README에 스크립트로 정리되어 있다).
One-Click AI·GPU 가속 추론 파이프라인(9.2~9.3)이 해당 카메라 입력 경로를 지원하는지.

카메라 인식 이후의 실전 예제·추론 성능 측정은 9.5에서 다룬다.

10.1.8 실전 체크리스트

라즈베리파이 액세서리를 UNO Q 프로젝트에 도입하기 전에 다음을 순서대로 확인한다.

보드 실물 확인: 실제 UNO Q인가, VENTUNO Q인가(10.1.2). 40핀 헤더가 실물에 있다면 VENTUNO Q다.
HAT인가 카메라 모듈인가: HAT이면 10.1.4 표로 이식 가능성부터 판단한다.
카메라라면: 캐리어 보드(공식 또는 커뮤니티, 10.1.5~10.1.6)가 준비되어 있는가.
소프트웨어: 해당 센서의 UNO Q 인식 사례가 커뮤니티에 있는가, 디바이스트리 편집이 필요한가(10.1.7).
전압: I2C HAT을 재배선한다면 10.2의 3.3V 확인 절차를 그대로 적용한다.

10.1.9 요약 — 확인됨과 확인 필요

항목	상태
UNO Q 상단 헤더 = 클래식 UNO 실드 폼팩터 + 별도 디버그 헤더(JCTL1), 하단 = 메자닌(JMISC1/JMEDIA1)	확인됨(공식 사용자 매뉴얼)
UNO Q에는 라즈베리파이식 40핀 헤더 없음, 이는 VENTUNO Q의 기능	확인됨(양쪽 공식 페이지 대조)
MIPI CSI 22핀 = 라즈베리파이 5와 동일 핀아웃, 캐리어 보드 경유	확인됨(공식 블로그 + 커뮤니티 프로젝트 2건 실물 확인)
Camemake·camboard-uno-q 어댑터의 기술 사양	확인됨(각 저장소·제품 페이지 직접 확인)
공식 "UNO Media Carrier" 등의 정확한 출시일·가격	확인 필요 — 발표 시점(2026-03)과 실제 구매 가능 시점·가격은 구매 전 공식 스토어에서 재확인
라즈베리파이 HAT 이식 가능성 표(10.1.4)의 세부 사례	일반 원칙은 확인됨(SoC·드라이버 구조 차이), 개별 HAT의 성공 여부는 HAT마다 확인 필요

교차참조: 0.3(UNO Q vs VENTUNO Q 상세 비교), 2.2~2.3(핀아웃·고속 인터페이스), 3.1(Debian/커널 구조), 9.2~9.3(GPU 가속 추론), 9.5(카메라 비전 예제), 10.2(3.3V·레벨 시프터), 10.3(Qwiic 생태계), 11.1~11.3(카메라 마운트 3D 프린팅).