MATRIX Voice 라즈베리 파이에 구글 어시스턴트 설치하기 – 단계별 가이드

이전 튜토리얼에서 MATRIX Voice 라즈베리 파이로 아마존 알렉사 제어 로봇을 만들었습니다. 이제 같은 하드웨어에 구글 어시스턴트를 통합하는 방법을 보여드리겠습니다.

MATRIX Voice 구글 어시스턴트 데모 영상

(영상 링크 준비 중)

MATRIX Voice 구글 어시스턴트 개요

필수 구성품

• MATRIX Voice / Creator
• 라즈베리 파이 3 (구매 링크)
• 스피커 (구매 링크)
• 마이크로 SD 카드 (구매 링크)
• 활성 인터넷 연결

사전 준비

시작 전 핵심 하드웨어와 소프트웨어를 숙지하세요. 라즈베리 파이와 MATRIX Voice를 빠르게 훑으면 단계를 매끄럽게 따라갈 수 있습니다.

라즈베리 파이

라즈베리 파이는 신용카드 크기 저전력 컴퓨터로 풀 리눅스 배포판을 실행합니다. 로봇틱스, 홈 오토메이션, 취미 프로젝트에 널리 쓰입니다.

MATRIX Voice

MATRIX Voice 보드는 8채널 MEMS 마이크 어레이, 18 RGBW LED, 64 GPIO 핀, 자일링스 스파르탄-6 FPGA, 64Mbit SDRAM을 탑재합니다. ESP32 기반 변종은 와이파이/블루투스 연결을 추가해 네트워크 통합을 쉽게 만듭니다.

MATRIX Voice 구글 어시스턴트 튜토리얼

1단계: 라즈베리 파이 설정

1. 최신 라즈베리 파이 OS 이미지 다운로드해 마이크로 SD 카드에 플래시.
2. 카드 삽입, 전원 연결(최소 2.5A), 파이 부팅.
3. 터미널 열고 기본 사용자 비밀번호 설정: sudo passwd pi.
4. 와이파이 또는 이더넷 연결. IP 할당 확인.
5. 시스템 업데이트: sudo apt update -y && sudo apt upgrade -y.

2단계: MATRIX 저장소 추가

curl https://apt.matrix.one/doc/apt-key.gpg | sudo apt-key add –
echo "deb https://apt.matrix.one/raspbian $(lsb_release -sc) main" | sudo tee /etc/apt/sources.list.d/matrixlabs.list
sudo apt update && sudo apt upgrade

3단계: MATRIX 소프트웨어 및 커널 모듈 설치

sudo apt install matrixio-creator-init raspberrypi-kernel-headers raspberrypi-kernel git
sudo reboot
sudo apt install matrixio-kernel-modules
sudo reboot

4단계: 구글 개발자 프로젝트 생성

1. Actions Console 방문 후 Add/import project 클릭.
2. 프로젝트 이름 입력 후 Create Project 클릭.
3. Cloud Platform Console에서 프로젝트용 Google Assistant API 활성화.
4. Activity Controls 이동 후 활성화:
   • Web & App Activity (Chrome 브라우징 기록 포함)
   • Device Information
   • Voice & Audio Activity

5단계: 기기 등록

1. Actions Console에서 프로젝트 선택 후 Connected properties 이동.
2. Device Models 탭에서 Register Model 클릭 후 필수 세부사항 입력.
3. 등록 후 credentials.json 파일 다운로드해 라즈베리 파이 /home/pi에 배치. 파일명 변경 금지.

6단계: 파이썬 가상 환경 설정 및 SDK 설치

cd /home/pi
sudo apt-get update
sudo apt-get install python3-dev python3-venv portaudio19-dev libffi-dev libssl-dev
python3 -m venv env
source env/bin/activate
pip install --upgrade pip setuptools wheel
pip install --upgrade google-assistant-library google-assistant-sdk[samples] google-auth-oauthlib[tool]

OAuth 인증 정보 생성:

google-oauthlib-tool \
 --scope https://www.googleapis.com/auth/assistant-sdk-prototype \
 --save --headless --client-secrets /path/to/credentials.json

화면 안내 URL 따라 브라우저에서 열기, 구글 계정 로그인, 요청된 권한 허용.

인증 완료되면 설정이 끝납니다. 이제 MATRIX Voice 보드가 구글 어시스턴트 음성 명령에 응답합니다.

자세한 내용은 공식 Google Assistant SDK 문서 참조.

MATRIX VOICE GOOGLE ASSISTANT – MATRIX VOICE PROJECT