스마트 기기, 센서, 액추에이터 등 인터넷에 연결된 다양한 장비를 이미 갖고 계신가요? 그렇다면 이제 이 컴포넌트들을 하나의 사물인터넷(IoT) 프로젝트로 만들어 볼 차례입니다.
Cayenne은 모바일 앱, 온라인 서비스, 대시보드를 하나로 묶어 IoT 세계의 진입 장벽을 낮춰주는 도구입니다. 라즈베리 파이에 Cayenne을 설치해 두면, 메뉴를 탐색하고 버튼을 선택하는 것만으로도 손쉽게 IoT 프로젝트를 구축할 수 있습니다.
입문자에게는 IoT 및 홈 오토메이션 네트워크 구축의 복잡함을 크게 덜어주고, 숙련된 사용자에게는 지루한 초기 설정과 반복적인 보일러플레이트 코드 없이 바로 핵심 개발에 집중할 수 있는 출발점을 제공합니다.
이 글에서는 라즈베리 파이에 Cayenne을 설치하고 실행하는 방법, 센서·액추에이터·기기를 등록하는 절차, 그리고 마지막으로 간단한 온도 기반 트리거를 만드는 과정까지 단계별로 살펴봅니다.
Cayenne이란 무엇인가?
Cayenne은 다음 세 가지 요소로 구성됩니다.
- 라즈베리 파이용 소프트웨어: 명령, 트리거, 알림을 관리하는 역할을 담당합니다. Cayenne 모바일 앱을 통해 설치하거나, 라즈베리 파이에서 터미널 명령어를 직접 실행해 설치할 수 있으며, 두 방법 모두 이 튜토리얼에서 다룹니다.
- Cayenne 클라우드: 라즈베리 파이에서 수집된 모든 데이터를 처리하고 저장합니다.
- 온라인 대시보드: 시각적인 그래픽 환경에서 IoT 프로젝트를 만들고, 등록한 모든 컴포넌트를 한곳에서 관리할 수 있습니다.
준비물
이 튜토리얼을 따라 하려면 다음 준비물이 필요합니다.
- 라즈베리 파이 4
- SD 카드
- Raspbian(현재는 Raspberry Pi OS) 시스템 이미지를 다운로드할 노트북 또는 PC
- 사용 중인 라즈베리 파이 모델에 맞는 전원 케이블
- Wi-Fi 연결을 사용하지 않는 경우 이더넷 케이블
설치 방식에 따라 아래 항목도 추가로 필요할 수 있습니다.
- 외장 키보드와 라즈베리 파이에 연결할 수단
- 마이크로 HDMI 케이블
- 외부 모니터
- 안드로이드 또는 iOS 스마트폰·태블릿
준비물이 갖춰졌다면 이제 Cayenne 설정을 시작해 보겠습니다.
1단계: Raspbian 운영체제 설치하기
운영체제를 설치하는 순서는 다음과 같습니다.
- 노트북이나 PC에 최신 버전의 Raspbian(Raspberry Pi OS) 이미지를 다운로드합니다.
- SD 카드를 컴퓨터에 삽입합니다.
- 아직 설치하지 않았다면 Ether(Etcher) 프로그램을 다운로드하여 설치합니다.
- Ether에서 Select image를 클릭하고 방금 내려받은 Raspbian 파일을 선택합니다.
- Select target을 클릭하고 SD 카드를 지정합니다.
- Ether가 Raspbian을 SD 카드에 플래싱하면, SD 카드를 빼내 라즈베리 파이에 삽입합니다.
이후 단계는 모바일 앱을 사용하는지, 아니면 라즈베리 파이에서 직접 터미널 명령을 입력하는지에 따라 달라집니다.
방법 1: Cayenne 모바일 앱 활용하기
모바일 앱으로 라즈베리 파이에 Cayenne을 설치하는 방법입니다.
- 라즈베리 파이에 이더넷 케이블을 연결합니다.
- 전원을 연결합니다. 기기가 자동으로 부팅됩니다.
- 모바일 기기에 Cayenne 앱을 다운로드합니다.
- 앱을 설치하고 실행합니다.
- Open → Create my free Account를 눌러 Cayenne 계정을 생성합니다.
- 새로 만든 계정으로 로그인합니다.
- Find Raspberry Pis 버튼을 눌러 라즈베리 파이를 검색합니다.
- 목록에 라즈베리 파이가 나타나면 해당 항목을 탭합니다.
이후 Cayenne이 필요한 라이브러리와 에이전트를 라즈베리 파이에 설치하고, 자동으로 재부팅한 뒤 나머지 소프트웨어와 드라이버를 설치합니다. 몇 분 정도 걸릴 수 있으니 잠시 커피 한 잔의 여유를 즐겨도 좋습니다.
모든 소프트웨어 설치가 끝나면 라즈베리 파이가 Cayenne 대시보드에 표시됩니다.
방법 2: 터미널 명령으로 설치하기
모바일 앱 사용을 원하지 않는다면, 터미널 명령으로 직접 설치할 수 있습니다.
- 외부 모니터와 키보드, 그리고 선택 사항인 이더넷 케이블을 라즈베리 파이에 연결합니다.
- 전원 케이블을 꽂으면 라즈베리 파이가 자동으로 부팅됩니다.
- Wi-Fi 연결 등 기본 초기 설정을 완료합니다.
- Cayenne 공식 웹사이트에 접속해 무료 계정을 만듭니다.
- 로그인 후 Add New → Device / Widget을 선택합니다.
- Raspberry Pi를 선택합니다. Cayenne 콘솔이 필요한 소프트웨어를 다운로드할 수 있는 설치 스크립트를 생성해 줍니다.
- 라즈베리 파이에서 상단 도구 모음의 터미널 아이콘을 클릭해 터미널 창을 엽니다.
- Cayenne 설치 스크립트를 터미널에 입력하고 Enter 키를 누릅니다. Raspbian이 필요한 소프트웨어를 모두 내려받습니다.
설치가 완료되면 라즈베리 파이가 자동으로 재부팅되며, 재부팅에 성공하면 Cayenne 대시보드에 기기가 나타납니다.
문제 해결: Cayenne이 라즈베리 파이를 찾지 못한다면?
Cayenne이 라즈베리 파이를 감지하지 못하는 경우 아래 방법을 시도해 보세요.
① 네트워크 확인
Cayenne은 동일한 네트워크에 연결된 라즈베리 파이만 감지할 수 있습니다. 안드로이드 앱, iOS 앱, 웹 브라우저 중 어떤 방식을 사용하든, 라즈베리 파이와 같은 네트워크에 접속되어 있는지 먼저 확인하세요.
② IP 주소로 검색
기기를 스캔할 때 화면에 Search with an IP address 옵션이 표시됩니다.
기기 검색이 잘 되지 않는다면 이 옵션을 클릭하고 라즈베리 파이의 IP 주소를 직접 입력하면 원하는 결과를 얻을 수 있습니다.
IP 주소는 Raspbian 터미널을 열고 아래 명령어를 실행하면 확인할 수 있습니다.
hostname -I
Cayenne 대시보드로 라즈베리 파이 모니터링하기
Cayenne 대시보드에서는 라즈베리 파이의 CPU 사용률, RAM 사용량, 온도 등 주요 통계를 한눈에 확인할 수 있습니다.
각 항목을 탭하면 Cayenne이 시간순으로 기록한 데이터를 확인할 수 있어, 기기의 성능 추세나 건강 상태 변화를 파악하는 데 유용합니다.
IoT 네트워크 구축: 센서와 액추에이터 추가하기
네트워크에 센서나 액추에이터가 있다면 이를 Cayenne에 추가할 수 있습니다. 추가된 컴포넌트는 대시보드에서 실시간으로 모니터링하고 제어할 수 있습니다. 아래 안내는 모바일 앱 기준이며, 웹 브라우저로 접속하면 인터페이스가 다소 다를 수 있습니다.
- Cayenne 앱에서 라즈베리 파이 기기를 선택합니다.
- 상단 도구 모음에서 작은 속도계 아이콘을 선택합니다.
- 오른쪽 위의 '+' 아이콘을 탭합니다.
- 추가하고 싶은 센서 또는 액추에이터를 찾아 탭합니다.
- 표시되는 양식을 작성한 뒤 Add sensor 또는 Add actuator를 탭합니다.
이제 해당 컴포넌트를 자유롭게 사용할 수 있습니다.
온도 트리거 만들기
Cayenne 대시보드에서 할 수 있는 작업은 매우 다양하지만, 여기서는 간단한 온도 트리거를 만들어 보겠습니다. 특정 부품이 설정한 온도 임계값을 초과하면 Cayenne이 알림을 발송하는 방식으로, 부품 과열 방지는 물론 난방 켜고 끄기 같은 더 폭넓은 홈 오토메이션 워크플로의 트리거로도 활용할 수 있습니다.
Cayenne 앱에서 다음 순서대로 진행합니다.
- 작업할 라즈베리 파이 기기를 선택합니다.
- 도구 모음의 '재생(Play)' 버튼을 누른 뒤, 오른쪽 위의 '+' 아이콘을 탭합니다.
- 트리거 이름을 지정합니다. 예시에서는 'Too hot(너무 뜨거움)'이라고 정했습니다.
- 파란색 '+' 버튼을 탭합니다.
- 모니터링할 센서나 액추에이터를 찾아 옆의 Temperature 버튼을 탭합니다.
- 온도 임계값을 선택합니다.
- Sensor above가 선택되어 있는지 확인합니다.
- then → +를 탭합니다.
- 알림 수신 방식(이메일 또는 SMS)을 선택하고, 필요한 정보를 입력한 후 Done을 탭합니다.
- 입력한 내용에 문제가 없다면 오른쪽 위의 Save 아이콘을 누릅니다.
- 트리거를 활성화하려면 '재생' 버튼이 선택된 상태에서 슬라이더를 'On' 위치로 밀어 올립니다.
이제 해당 부품이 지정한 온도 임계값을 초과할 때마다 알림을 받게 됩니다.
Cayenne 설정을 마치고 기본 워크플로에 익숙해졌다면, 이제 기기·센서·액추에이터를 계속 추가하면서 모든 IoT 컴포넌트에 대한 트리거와 규칙을 만들어 볼 수 있습니다. 한 걸음 더 나아가 라즈베리 파이를 에지 게이트웨이(edge gateway)로 변신시키는 것도 좋은 방법입니다.