본문으로 건너뛰기

핵심 개념 5분 요약

처음 읽는 사람을 위해 API와 옵션은 빼고 어떻게 동작하는지만 정리했습니다. 각 절의 자세한 내용은 끝의 링크에 있습니다.

1. IOSignal이란​

브라우저, Node.js, Arduino를 서버 하나로 연결해 실시간으로 메시지를 주고받게 하는 오픈소스 라이브러리입니다.

Arduino, 브라우저, Node.js 클라이언트가 모두 IOSignal 서버 하나에 연결되고 서버가 태그를 읽어 전달하는 구조

  • 클라이언트는 서버에만 연결합니다. 클라이언트끼리 직접 연결하지 않습니다.
  • 메시지 하나를 시그널이라고 부릅니다. 시그널은 태그(CID 또는 채널)와 데이터로 이루어집니다.
  • 서버는 데이터의 의미를 해석하지 않고, 태그만 보고 받을 대상을 찾아 전달합니다.

2. 네 가지 용어​

용어뜻
CID서버가 연결마다 붙이는 클라이언트 ID. 접속이 끝나 ready 이벤트가 오면 확정됩니다.
태그room#chat, A@state처럼 받을 대상이나 주제를 나타내는 문자열
채널이름으로 만드는 대화방. 구독한 모두가 받습니다.
구독"이 태그의 시그널을 받겠다"고 서버에 알리는 것

3. 태그 읽는 법​

태그는 대상, 구분 문자, 토픽으로 이루어지고 #은 채널, @는 CID, $는 리테인을 뜻함

  • # 앞은 채널, @ 앞은 CID입니다.
  • # 앞을 비우면 홈채널입니다(5절).
  • $를 넣으면 서버가 마지막 값을 보관합니다. 나중에 구독한 클라이언트도 바로 받습니다. 장치 상태처럼 "현재 값"이 중요한 곳에 씁니다.
  • 태그는 글자 하나만 달라도 다른 태그입니다. #state와 #$state는 서로 다릅니다.

4. 세 가지 전달 방식​

IOSignal에서 가장 중요한 부분입니다.

채널 발행은 구독자 모두에게, CID 직접 송신은 CID 하나에게, CID 발행은 그 CID를 구독한 클라이언트에게 전달

방식언제 쓰나구독
① 채널 발행채팅처럼 여럿이 같은 주제를 주고받을 때필요
② CID 직접 송신특정 장치 하나에 명령할 때불필요
③ CID 발행장치가 자기 상태를 여러 앱에 알릴 때필요

가장 헷갈리는 것은 @가 들어간 태그입니다.

  • B@cmd로 보내면 B 하나에게만 갑니다. B는 자기 CID가 빠진 @cmd로 받습니다.
  • A@state를 구독하면 A가 @state로 보내는 시그널을 받습니다.
  • @state처럼 @로 시작하는 태그로 보내면 "내 CID로 발행"이라는 뜻입니다. 서버가 보낸 연결의 CID를 붙이므로, 다른 클라이언트가 A인 척 A의 상태를 보낼 수 없습니다.

5. 홈채널​

채널 이름 없이 #search처럼 쓰면, 같은 공유기(같은 공인 IP)에서 접속한 연결끼리만 전달됩니다.

같은 공인 IP의 웹앱과 조명은 #search로 서로 찾고, 다른 IP의 사무실 장치에는 전달되지 않음

  • 채널 이름을 미리 정하지 않아도 같은 장소의 장치를 찾을 수 있습니다. 집에서 앱을 열면 집 장치가, 사무실에서 열면 사무실 장치가 보입니다.
  • 보안 경계는 아닙니다. 같은 IP를 쓰는 다른 사람(카페, VPN 등)도 같은 홈채널에 들어옵니다. 중요한 제어에는 인증을 함께 씁니다.

6. 장치 찾기와 제어​

지금까지의 기능을 조합한 응용 규칙입니다. 서버가 강제하는 프로토콜이 아니라, Remocon 웹앱과 예제가 함께 따르는 약속입니다.

앱이 #search를 보내고 장치가 #notify로 CID를 알린 뒤, 앱이 $name·$ui·$state를 구독하고 명령을 보내면 장치가 상태로 답하는 순서

단계쓰는 기능
① 앱이 #search → ② 장치가 #notify <cid>홈채널
③ 이름 <cid>@$name, 버튼 <cid>@$ui, 상태 <cid>@$state 구독CID 발행 + 리테인
④ 명령: <cid>@로 onCID 직접 송신
⑤ 장치가 @$state로 on=1CID 발행 + 리테인
  • 명령을 보냈다고 끝이 아닙니다. 장치가 보낸 ⑤ 상태가 실제 결과입니다. 장치는 모르는 명령을 받아도 상태를 한 번 보냅니다.
  • 장치 연결이 끊기면 서버가 <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를 비교해 구분합니다.

기억할 다섯 가지​

  1. 모든 시그널은 서버를 거치고, 서버는 태그만 봅니다.
  2. #은 채널, @는 CID, 앞을 비운 #topic은 홈채널, $는 값 보관입니다.
  3. B@x로 보내기와 A@x를 구독하기는 뜻이 다릅니다.
  4. 홈채널은 편리한 검색 범위일 뿐, 보안이 아닙니다.
  5. 장치 검색·제어 규칙은 프로토콜이 아니라 앱과 장치의 약속입니다.

더 읽기​