본문으로 건너뛰기

장치 구성 예: 릴레이와 버튼 제어기

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이 대상입니다.

제어기targetb1b2
c1relayArelayA:r1lampB:toggle
c2relayAallr2
값뜻실제로 보내는 것
relayA:r1A의 릴레이 1 토글마지막으로 받은 상태가 r1=1이면 relayA@로 r1=0
all대상 전체 토글하나라도 켜져 있으면 all=0, 모두 꺼져 있으면 all=1 (명령 하나)
lampB:toggleB 토글lampB@로 toggle 그대로
  • 앱이나 CLI에서 c1@로 b2=relayA:r4를 보내면 원격으로 바꿀 수 있습니다. 제어기는 값을 검사해 저장하고 상태로 답합니다.
  • 제어기는 대상의 $state를 받기 전에는 토글을 보내지 않습니다. 켤지 끌지를 마지막 상태로 정하기 때문입니다.

누르면 생기는 일​

c1의 버튼 1을 누르는 경우입니다.

  1. c1은 이미 relayA@$state = r1=1;r2=0;r3=0;r4=1을 받아 두었습니다. 보관 값이라 구독하자마자 옵니다.
  2. 버튼 1(relayA:r1): r1이 1이므로 relayA@로 r1=0을 보냅니다.
  3. A가 릴레이 1을 끄고 @$state로 r1=0;r2=0;r3=0;r4=1을 보냅니다.
  4. 서버가 이 상태를 보관하고, 구독한 c1, c2, 앱에 보냅니다. 모두 같은 상태를 압니다.
  5. 다음에 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 필요(장치 키 로그인)채널 이름만 맞추면 됨