Remocon 아두이노
REMOCON / iris-button-controller

iris 버튼 제어기

iris 보드의 버튼 2개로 다른 장치(4채널 릴레이, 스위치, 전등)를 제어하고, LED 4개에 대상의 채널 상태를 보여 줍니다. 대상과 버튼 동작은 보드 설정입니다.

장치iris 보드 (ESP32-C3)실물 확인 예제

iris 버튼 제어기 보드 그림

사진 · 회로도

준비물

배선 · 핀맵

보드 핀연결비고
GPIO1버튼 1 (보드 설정 b1)내부 풀업
GPIO2버튼 2 (보드 설정 b2)내부 풀업
GPIO4WS2812 4개: 대상의 처음 4채널(r1~r4, s1~s4)보드에 내장
GPIO8상태 LED: 대상 상태를 알면 켜짐active low

펌웨어 설치

미리 빌드한 이 예제의 펌웨어를 USB로 연결한 보드에 브라우저에서 바로 설치합니다. 설치가 끝나면 Wi-Fi 입력 창이 이어집니다.

iris 보드 (ESP32-C3) · ESP32-C3버전 9.14.1+iris-button-controller.2195cb7

이 브라우저는 Web Serial을 지원하지 않습니다. 데스크톱 Chrome이나 Edge에서 여세요.HTTPS 주소에서만 설치할 수 있습니다.

보드 설정

이 예제는 USB로 연결한 뒤 보드 설정 페이지에서 Wi-Fi, IOSignal 서버(호스트:포트)와 장치 키, 그리고 아래 설정 항목을 바꿀 수 있습니다. 스케치를 다시 빌드하지 않아도 되고, 보드가 값을 저장합니다.

이름설명형식기본값참고
name
장치 이름과 앱(remocon.kr 등)의 분류 탭을 이름:분류로 함께 정합니다. 장치는 이 값을 그대로 $name으로 보냅니다. 기본값은 Iris Button Control:HOME이고, 예를 들어 거실 조명:1층이면 앱에 "거실 조명"이 1층 탭에 나옵니다. :가 없으면 분류 없이 이름만 보내 앱의 미분류 탭에 나오고, 이름을 비우면(:1층) 이름은 Iris Button Control입니다. 64바이트까지, 바꾸면 바로 다시 보냅니다.
보드 설정 화면 표시: Name & category (name:category)
글자, 64바이트까지
Iris Button Control:HOME
target
제어할 장치의 CID입니다(예: 1413, ?k3vd). 기본값 the-cid는 자리 표시라 실제 CID로 바꿔야 동작합니다. 앱 카드의 Target CID 칸이나 원격 명령 target=<cid>로도 바뀝니다.
보드 설정 화면 표시: Target CID
CID
the-cid
원격 명령으로도 바뀜
b1
버튼 1(GPIO1)을 눌렀을 때 할 일입니다. 비우면 기본 동작입니다. 직접 정하려면 r1(채널 1 토글), r2=1(채널 2 켜기), all(하나라도 켜져 있으면 모두 끄고 아니면 모두 켬), all=0(모두 끄기), lamp1:toggle(다른 장치에 명령), #lab:s2(그룹 채널)처럼 씁니다. 원격 명령 b1=r3으로도 바뀝니다. 기본 동작: 대상 채널이 3개 이상이면 all=1(모두 켜기), 2채널이면 채널 1 토글입니다.
보드 설정 화면 표시: Button 1 (empty: default)
글자
없음
원격 명령으로도 바뀜
b2
버튼 2(GPIO2). 기본 동작: 대상 채널이 3개 이상이면 all=0(모두 끄기), 2채널이면 채널 2 토글. 쓰는 법은 b1과 같습니다.
보드 설정 화면 표시: Button 2 (empty: default)
글자
없음
원격 명령으로도 바뀜

이 페이지에서 바로 설정

펌웨어를 설치한 뒤 이어서, 또는 이미 이 예제가 올라간 보드를 USB로 연결해 Wi-Fi, 서버와 장치 키, 위 설정 항목을 여기서 바로 바꿉니다. 설치 창은 먼저 닫으세요(포트를 함께 쓸 수 없습니다). 데스크톱 Chrome·Edge에서 됩니다. 보드 설정 페이지와 같은 기능입니다.

01 보드 연결

상태
Not connected
장치
—
칩
—
펌웨어
—

보드에 IOSignalConfig를 쓰는 스케치가 올라가 있어야 합니다(Improv Wi-Fi Serial, 115200bps). 시리얼 모니터가 열려 있으면 포트를 쓸 수 없으니 먼저 닫으세요.

02 Wi-Fi 입력

비밀번호는 USB 시리얼로 보드에만 전달됩니다. 이 페이지는 저장하거나 서버로 보내지 않습니다. 보드는 2.4GHz Wi-Fi만 접속합니다. 연결에 실패하면 보드는 이전 Wi-Fi 설정을 되돌립니다.

05 시리얼 로그

보드가 출력하는 글입니다. READY CID 줄에서 장치 CID를 확인할 수 있습니다.

사용 순서

  1. 스케치를 올리고 USB로 연결해 https://arduino.remocon.kr/wifi/ 에서 Wi-Fi를 넣습니다. 같은 페이지의 스케치 설정 target에 제어할 장치의 CID를 넣습니다.
  2. b1, b2를 비워 두면 대상이 3채널 이상일 때 버튼 1은 모두 켜기, 버튼 2는 모두 끄기, 2채널이면 채널 1·2 토글입니다.
  3. 버튼마다 하는 일은 보드 설정입니다. 비워 두면 기본 동작이고, 'r1'(릴레이 1 토글), 'r2=1'(켜기), 'all'·'all=0', 'lamp1:toggle'(다른 장치), '#lab:s2'(그룹 채널)처럼 넣습니다. remocon pub "<제어기 cid>@" "b2=r3" 로도 바꾸고, 'b2'만 보내면 그 버튼을 누른 것과 같습니다. 형식은 Remocon 라이브러리의 RemoconBinding.h 맨 위에 있습니다.
  4. 대상 상태를 받으면 상태 LED가 켜지고, LED 4개가 대상의 채널 상태를 따라갑니다.

직접 해 보기

보드를 켜고 연결하면 #search로 이 예제의 보드(이름 Iris Button Control)를 찾아 remocon.kr과 같은 화면으로 제어합니다.

미연결 · 내 CID —

연결하면 이 예제의 보드를 찾습니다.

화면:

주고받은 신호

    제어 화면 내려받기 (HTML 파일 하나) CSS와 스크립트가 들어 있는 파일입니다. 내려받아 브라우저로 열면 이 사이트 없이도 같은 화면으로 보드를 제어합니다.

    시그널 흐름

    보내는 쪽받는 쪽태그값설명
    장치서버@$nameIris Button Control:HOME이름과 분류(첫 : 뒤)입니다. 서버에 보관됩니다. 분류는 앱이 장치를 묶어 보여 주는 탭 이름입니다. 이름과 분류 모두 보드 설정 name(이름:분류)으로 바꿉니다(바꾸면 바로 다시 보냄). 분류가 없으면 앱의 미분류 탭에 나옵니다.
    장치서버@$uib1,b2버튼 목록입니다. 앱은 누른 버튼 이름을 그대로 명령으로 보냅니다. 서버에 보관됩니다.
    장치서버<대상>@$state구독대상과 설정이 이름 붙인 장치마다 구독합니다. 토글은 마지막 상태의 반대를 보냅니다.
    장치대상<대상>@r1=1all은 all=1/all=0 명령 하나로 보냅니다. 상태를 받기 전에는 토글을 보내지 않습니다.
    앱장치<cid>@b1 / b2=r3 / target=?k3vd누르기, 버튼 설정 바꾸기, 대상 바꾸기. 처리 뒤 상태로 답합니다.
    장치서버@$statetarget=?k3vd;link=1;b1=;b2=r3link는 대상 상태를 알고 있는지입니다. 잘못된 설정은 ?로 보입니다.

    참고

    소스 코드