핵심 개념 5분 요약
처음 읽는 사람을 위해 API와 옵션은 빼고 어떻게 동작하는지만 정리했습니다. 각 절의 자세한 내용은 끝의 링크에 있습니다.
1. IOSignal이란
브라우저, Node.js, Arduino를 서버 하나로 연결해 실시간으로 메시지를 주고받게 하는 오픈소스 라이브러리입니다.
- 클라이언트는 서버에만 연결합니다. 클라이언트끼리 직접 연결하지 않습니다.
- 메시지 하나를 시그널이라고 부릅니다. 시그널은 태그(CID 또는 채널)와 데이터로 이루어집니다.
- 서버는 데이터의 의미를 해석하지 않고, 태그만 보고 받을 대상을 찾아 전달합니다.
2. 네 가지 용어
| 용어 | 뜻 |
|---|---|
| CID | 서버가 연결마다 붙이는 클라이언트 ID. 접속이 끝나 ready 이벤트가 오면 확정됩니다. |
| 태그 | room#chat, A@state처럼 받을 대상이나 주제를 나타내는 문자열 |
| 채널 | 이름으로 만드는 대화방. 구독한 모두가 받습니다. |
| 구독 | "이 태그의 시그널을 받겠다"고 서버에 알리는 것 |
3. 태그 읽는 법
#앞은 채널,@앞은 CID입니다.#앞을 비우면 홈채널입니다(5절).$를 넣으면 서버가 마지막 값을 보관합니다. 나중에 구독한 클라이언트도 바로 받습니다. 장치 상태처럼 "현재 값"이 중요한 곳에 씁니다.- 태그는 글자 하나만 달라도 다른 태그입니다.
#state와#$state는 서로 다릅니다.
4. 세 가지 전달 방식
IOSignal에서 가장 중요한 부분입니다.
| 방식 | 언제 쓰나 | 구독 |
|---|---|---|
| ① 채널 발행 | 채팅처럼 여럿이 같은 주제를 주고받을 때 | 필요 |
| ② CID 직접 송신 | 특정 장치 하나에 명령할 때 | 불필요 |
| ③ CID 발행 | 장치가 자기 상태를 여러 앱에 알릴 때 | 필요 |
가장 헷갈리는 것은 @가 들어간 태그입니다.
B@cmd로 보내면 B 하나에게만 갑니다. B는 자기 CID가 빠진@cmd로 받습니다.A@state를 구독하면 A가@state로 보내는 시그널을 받습니다.@state처럼@로 시작하는 태그로 보내면 "내 CID로 발행"이라는 뜻입니다. 서버가 보낸 연결의 CID를 붙이므로, 다른 클라이언트가 A인 척 A의 상태를 보낼 수 없습니다.
5. 홈채널
채널 이름 없이 #search처럼 쓰면, 같은 공유기(같은 공인 IP)에서 접속한 연결끼리만 전달됩니다.
- 채널 이름을 미리 정하지 않아도 같은 장소의 장치를 찾을 수 있습니다. 집에서 앱을 열면 집 장치가, 사무실에서 열면 사무실 장치가 보입니다.
- 보안 경계는 아닙니다. 같은 IP를 쓰는 다른 사람(카페, VPN 등)도 같은 홈채널에 들어옵니다. 중요한 제어에는 인증을 함께 씁니다.
6. 장치 찾기와 제어
지금까지의 기능을 조합한 응용 규칙입니다. 서버가 강제하는 프로토콜이 아니라, Remocon 웹앱과 예제가 함께 따르는 약속입니다.
| 단계 | 쓰는 기능 |
|---|---|
① 앱이 #search → ② 장치가 #notify <cid> | 홈채널 |
③ 이름 <cid>@$name, 버튼 <cid>@$ui, 상태 <cid>@$state 구독 | CID 발행 + 리테인 |
④ 명령: <cid>@로 on | CID 직접 송신 |
⑤ 장치가 @$state로 on=1 | CID 발행 + 리테인 |
- 명령을 보냈다고 끝이 아닙니다. 장치가 보낸 ⑤ 상태가 실제 결과입니다. 장치는 모르는 명령을 받아도 상태를 한 번 보냅니다.
- 장치 연결이 끊기면 서버가
<cid>@$state구독자에게close를 보냅니다. - 이름은
거실 조명:거실처럼 보냅니다. 첫:뒤는 앱이 목록을 나누는 분류이고, 없으면 미분류입니다. - 버튼은
$ui에on,off,toggle처럼 쉼표 목록으로 보냅니다. 공식 타입이 있으면t=light.1처럼 보내고, 장치가 직접 정한 화면은<cid>@$panel로 따로 보내며$ui에p=1을 붙입니다(t=switch3.1;p=1). - 여러 보드를 카드 하나로 묶을 때는 그룹 채널을 씁니다. 구성원은
#search에#notify #채널로 답하고, 명령 대신 공유 상태#채널$state를 함께 씁니다. - 앱이 아니어도 됩니다. 다른 Arduino도 같은 태그로 보내고 구독하면 똑같이 제어할 수 있습니다.
규칙 전체는 Remocon 장치 만들기, 실제 보드로 짠 구성은 장치 구성 예: 릴레이와 버튼 제어기에 있습니다.
7. 인증과 암호화
- 익명 연결은 재접속할 때마다 CID가 바뀝니다. 오래된 CID로 보내면 엉뚱한 상대가 받을 수 있으니 다시 찾습니다.
- 인증 연결은 장치 ID와 비밀 키로 접속하고, 서버에 등록된 고정 CID를 씁니다.
- boho는 IOSignal의 공유 키 인증·암호화 라이브러리입니다. 연결 암호화는 도청을 막지만 서버는 내용을 읽을 수 있습니다. 서버도 못 읽게 하려면 양 끝만 아는 별도 키(E2E)가 필요합니다.
8. 코드 한 번 보기
import { IO } from 'iosignal';
const io = new IO('wss://io.iosignal.net/ws');
// 받는 쪽: 연결될 때마다 자동으로 구독
io.listen('room#chat', (tag, msg) => console.log(tag, msg));
// 보내는 쪽(다른 클라이언트): ready 이후에 보냄
io.on('ready', () => io.signal('room#chat', 'hi'));
Arduino도 같은 태그를 씁니다. 다만 모든 수신을 onMessage(tag, type, payload, size) 하나로 받고 tag를 비교해 구분합니다.
기억할 다섯 가지
- 모든 시그널은 서버를 거치고, 서버는 태그만 봅니다.
#은 채널,@는 CID, 앞을 비운#topic은 홈채널,$는 값 보관입니다.B@x로 보내기와A@x를 구독하기는 뜻이 다릅니다.- 홈채널은 편리한 검색 범위일 뿐, 보안이 아닙니다.
- 장치 검색·제어 규칙은 프로토콜이 아니라 앱과 장치의 약속입니다.