장치 구성 예: 릴레이와 버튼 제어기
Remocon 장치 만들기의 규칙을 실제 예제 보드 네 대에 적용한 구성입니다. 앱(remocon.kr)과 버튼이 달린 다른 보드가 같은 장치를 함께 제어하고, 모두 같은 상태를 봅니다.
구성
| 보드 | 예제 | 하는 일 |
|---|---|---|
| A 4채널 릴레이 | esp8266-relay4ch | 릴레이 4개 r1~r4 |
| B 전등 | d1-mini-led-button (ESP8266 D1 mini) | 내장 LED 하나 on |
| c1 버튼 제어기 | button-controller (D1 mini) | 버튼 1은 A의 릴레이 1, 버튼 2는 B를 토글 |
| c2 버튼 제어기 | button-controller (ESP32-C3) | 버튼 1은 A 전체 토글, 버튼 2는 A의 릴레이 2 |
네 보드는 같은 공유기(같은 공인 IP)에서 접속합니다. 그래서 같은 홈채널에 있고 #search가 서로에게 전달됩니다. 버튼 제어기는 같은 스케치를 D1 mini(버튼 D5, D6)와 ESP32-C3(버튼 GPIO9 BOOT, GPIO10)에 올린 것입니다.
장치마다 CID를 쓰는 구성
A와 B는 각자 장치 하나입니다. 제어기는 버튼을 누르면 대상 장치의 CID로 명령을 보냅니다. 장치는 명령을 처리한 뒤 자기 상태를 보내고, 그 상태를 구독한 제어기와 앱이 모두 같은 값을 받습니다.
고정 CID를 쓰는 이유
익명으로 접속하면 재접속할 때마다 CID가 바뀝니다(?k3vd → ?p2xq). 제어기의 설정에 적어 둔 대상 CID가 그때마다 틀려지므로, A와 B는 장치 키로 로그인해 서버에 등록된 고정 CID를 씁니다. 장치 키는 보드 설정 페이지에서 USB로 넣습니다. 이 문서에서는 고정 CID를 relayA, lampB로 씁니다.
제어기는 익명이어도 됩니다. 제어기의 CID로 명령을 보내는 쪽이 없기 때문입니다. 앱에서 제어기의 설정을 바꿀 때는 앱이 검색으로 그 CID를 찾습니다.
보드마다 하는 일
| 보드 | 구독 | 보관 값으로 보내는 것 | 받는 명령 |
|---|---|---|---|
A relayA | #search | @$name = Relay4CH:HOME@$ui = t=relay4.1@$state = r1=1;r2=0;r3=0;r4=1 | r1=0, all=1, all=0 |
B lampB | #search | @$name = D1-mini:HOME@$ui = t=light.1@$state = on=1 | on, off, toggle |
| c1, c2 | #search, relayA@$state (c1은 lampB@$state도) | @$name = Button Control:HOME@$ui = b1,b2@$state = target=relayA;link=1;b1=relayA:r1;b2=lampB:toggle | b1(누르기), b2=r3(설정), target=… |
$name의 첫:앞은 이름, 뒤는 앱 목록의 분류입니다. 이름과 분류는 보드 설정name으로 바꿉니다.$ui의t=는 공식 타입입니다. 타입이 정해지면 앱은 그 타입의 화면을 그립니다. 제어기처럼 타입이 없는 장치는$ui에 버튼 목록을 보냅니다.- 제어기도
#search에 답하는 장치입니다. 앱 목록에 보이고, 앱에서 버튼을 눌러 보거나 버튼이 하는 일을 바꿀 수 있습니다.
버튼 설정
제어기 버튼이 하는 일은 보드 설정 target, b1, b2로 정합니다. 값은 대상:할 일 형식이고, 대상:을 빼면 target이 대상입니다.
| 제어기 | target | b1 | b2 |
|---|---|---|---|
| c1 | relayA | relayA:r1 | lampB:toggle |
| c2 | relayA | all | r2 |
| 값 | 뜻 | 실제로 보내는 것 |
|---|---|---|
relayA:r1 | A의 릴레이 1 토글 | 마지막으로 받은 상태가 r1=1이면 relayA@로 r1=0 |
all | 대상 전체 토글 | 하나라도 켜져 있으면 all=0, 모두 꺼져 있으면 all=1 (명령 하나) |
lampB:toggle | B 토글 | lampB@로 toggle 그대로 |
- 앱이나 CLI에서
c1@로b2=relayA:r4를 보내면 원격으로 바꿀 수 있습니다. 제어기는 값을 검사해 저장하고 상태로 답합니다. - 제어기는 대상의
$state를 받기 전에는 토글을 보내지 않습니다. 켤지 끌지를 마지막 상태로 정하기 때문입니다.
누르면 생기는 일
c1의 버튼 1을 누르는 경우입니다.
- c1은 이미
relayA@$state=r1=1;r2=0;r3=0;r4=1을 받아 두었습니다. 보관 값이라 구독하자마자 옵니다. - 버튼 1(
relayA:r1):r1이 1이므로relayA@로r1=0을 보냅니다. - A가 릴레이 1을 끄고
@$state로r1=0;r2=0;r3=0;r4=1을 보냅니다. - 서버가 이 상태를 보관하고, 구독한 c1, c2, 앱에 보냅니다. 모두 같은 상태를 압니다.
- 다음에 c2에서 릴레이 1을 바꾸면 c2도 이미
r1=0을 알고 있습니다.
명령을 보냈다고 끝이 아닙니다. 3번의 상태가 실제 결과입니다. 그래서 장치는 값이 그대로이거나 모르는 명령을 받아도 상태를 한 번 보냅니다.
c2의 버튼 1을 누르면 r4가 켜져 있으므로 relayA@로 all=0을 보내고, A는 릴레이 4개를 모두 끈 뒤 상태를 한 번 보냅니다.
찾기와 끊김
- 앱이
#search를 보내면 A, B, c1, c2가 모두#notify <자기 CID>로 답합니다. 앱은 CID마다@$name,@$ui,@$state를 구독해 카드 네 장을 만듭니다. - 보드가 꺼지면 서버가
<cid>@$state로close를 보내고, 앱은 그 카드를 뺍니다. A가 꺼지면 제어기도close를 받으므로 A가 없다는 것을 압니다.
그룹 채널로 묶으면
규칙에는 채널 하나를 여럿이 함께 쓰는 그룹 채널도 있습니다. A와 B를 그룹 #room의 구성원으로 만들면 다음과 같습니다.
- 공유 상태
#room$state=r1=1;r2=0;r3=0;r4=1;r5=1. A는r1~r4, B는r5만 적용합니다. 키가 겹치지 않게 정해야 합니다. - 그룹에는 명령이 없습니다. 제어기 버튼
#room:r2는 상태를 바꾼 문자열 전체를#room$state에 다시 씁니다. - 앱에는 카드 하나(
#room)로 보이고, 검색에는 구성원이#notify #room으로 답합니다.
이 구성에는 맞지 않습니다.
#room:all은 그룹의 키를 모두 바꾸므로 B(r5)까지 토글합니다. A만 끄고 켤 수 없습니다.- 두 제어기가 거의 동시에 쓰면 나중에 쓴 문자열이 먼저 쓴 변경을 덮습니다.
- 그룹에는 주인이 없어서
close가 오지 않습니다. A만 꺼져도 알 수 없고, 앱은 다시 검색했을 때 아무도 답하지 않아야 카드를 뺍니다.
그룹은 여러 보드가 같은 출력을 함께 따라야 할 때(여러 방의 조명을 한 스위치처럼) 씁니다. 예제는 esp32-group-led와 wifi-simple입니다. 보드마다 하는 일이 다르면 위처럼 장치마다 CID를 씁니다.
비교
| 장치마다 CID | 그룹 채널 | |
|---|---|---|
| 앱의 카드 | 장치마다 하나 | 그룹에 하나 |
| 제어 | 명령(<cid>@), 장치가 상태로 답함 | 공유 상태 #ch$state를 통째로 다시 씀 |
| 동시에 누르면 | 장치가 순서대로 처리 | 나중에 쓴 값이 이김 |
| 꺼짐 알림 | 서버가 close를 보냄 | 없음 |
| 대상 CID | 고정 CID 필요(장치 키 로그인) | 채널 이름만 맞추면 됨 |