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

ESP-01 버튼 제어기

ESP-01의 GPIO3 버튼 하나로 다른 장치(4채널 릴레이, ESP-01 릴레이, iris, Remocon8266, 그룹 채널)를 제어하고, 내장 LED로 대상의 상태를 보여 줍니다. 대상과 버튼 동작은 보드 설정(target, b1)이라 펌웨어를 고치지 않고 바꿉니다.

장치ESP-01 (ESP8266)실물 확인 예제

ESP-01 버튼 제어기 보드 그림

사진 · 회로도

아직 등록된 사진과 회로도가 없습니다. 아래 배선 표를 참고하세요.

준비물

배선 · 핀맵

보드 핀연결비고
GPIO3 (RX)푸시 버튼 → GND내부 풀업. 시리얼 RX 핀이라 설정 모드에서는 읽지 않습니다. 켠 뒤 3초 안에 누르고 있으면 설정 모드로 시작합니다.
GPIO1 (TX)내장 LED: 대상이 켜져 있으면 켜짐active low, ESP-01 보드에 내장. ESP-01S는 LED가 GPIO2라 LED_PIN을 2로 바꿉니다.

펌웨어 설치

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

ESP-01 (ESP8266) · ESP8266버전 9.14.2+esp01-button-controller.e61e50b

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

보드 설정

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

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

이 페이지에서 바로 설정

펌웨어를 설치한 뒤 이어서, 또는 이미 이 예제가 올라간 보드를 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. 제어할 장치(예: esp8266-relay4ch, esp01-relay-button, iris-basic, Remocon8266-basic)를 먼저 켜고 CID를 확인합니다.
  2. 업로드 어댑터로 스케치를 올립니다. 저장된 Wi-Fi가 없으면 설정 모드(시리얼 켜짐, 버튼·LED 꺼짐)로 시작합니다. 설정 모드에서는 버튼을 누르지 마세요(어댑터의 TX 선을 GND로 당깁니다).
  3. USB-TTL을 연결한 채 https://arduino.remocon.kr/wifi/ 에서 Wi-Fi를 넣고, 같은 페이지의 스케치 설정 target에 대상 CID를 넣습니다. 원하면 b1, 서버, 장치 키도 넣습니다.
  4. 보드 설정 페이지 연결을 끊고 버튼을 누르지 않은 채 리셋하면 일반 모드로 시작합니다. 페이지에서 설정을 저장해도 보드는 다시 시작하지 않으므로 리셋 전까지는 설정 모드(버튼 무시)입니다. 일반 모드에서 버튼을 누르면 대상에 명령을 보내고, 대상의 상태에 따라 내장 LED가 켜지고 꺼집니다.
  5. b1을 비워 두면 대상 채널이 하나라도 켜져 있으면 모두 끄고 아니면 모두 켭니다. 's1'(채널 1 토글), 'r2=1'(릴레이 2 켜기), 'all=0'(모두 끄기), 'lamp1:toggle'(다른 장치), '#lab:s2'(그룹 채널)처럼 바꿀 수 있습니다.
  6. 설정을 다시 바꾸려면 켠 뒤 3초 안에 버튼을 누르고 있어 설정 모드로 들어가거나, remocon.kr 카드나 remocon pub "<제어기 cid>@" "target=<cid>" 로 원격으로 바꿉니다.

직접 해 보기

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

미연결 · 내 CID —

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

화면:

주고받은 신호

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

    시그널 흐름

    보내는 쪽받는 쪽태그값설명
    장치서버@$nameESP01 Button:HOME이름과 분류(첫 : 뒤)입니다. 서버에 보관됩니다. 분류는 앱이 장치를 묶어 보여 주는 탭 이름입니다. 이름과 분류 모두 보드 설정 name(이름:분류)으로 바꿉니다(바꾸면 바로 다시 보냄). 분류가 없으면 앱의 미분류 탭에 나옵니다.
    장치서버@$uib1버튼 목록입니다. 앱은 누른 버튼 이름을 그대로 명령으로 보냅니다. 서버에 보관됩니다.
    장치서버<대상>@$state구독대상(과 b1이 따로 지정한 장치나 그룹)의 상태를 구독합니다. 토글은 마지막 상태의 반대를 보내고, LED는 이 상태를 따릅니다.
    장치대상<대상>@all=1버튼을 누르면 설정대로 보냅니다. 기본은 all=1/all=0, 's1'이면 s1=1처럼 채널 하나입니다. 상태를 받기 전에는 토글을 보내지 않습니다.
    대상장치<대상>@$stater1=1;r2=1;r3=1;r4=1대상이 바뀐 상태로 답하면 LED가 켜집니다. b1이 채널 하나(예: s1)면 그 채널, 기본이나 all이면 채널이 하나라도 켜졌을 때 켜집니다.
    앱장치<cid>@b1 / b1=s2 / target=?k3vd누르기, 버튼 설정 바꾸기, 대상 바꾸기. 처리 뒤 상태로 답합니다.
    장치서버@$statetarget=?k3vd;link=1;on=1;b1=link는 대상 상태를 알고 있는지, on은 LED가 보여 주는 대상의 켜짐입니다. 잘못된 설정은 ?로 보입니다.

    참고

    소스 코드