Remocon8266 버튼 제어기
Remocon8266 보드의 버튼으로 다른 장치를 CID로 제어합니다. 기본 설정은 4채널 릴레이 보드(esp8266-relay4ch)용이고, 버튼마다 하는 일을 보드 설정(b1~b5)으로 바꾸면 스위치·전등·그룹도 제어합니다. 기본 대상은 DEFAULT_TARGET(the-cid)이고, 웹앱 카드나 CLI에서 target=<cid>로, 또는 USB로 연결한 보드 설정 페이지에서 펌웨어 변경 없이 바꿀 수 있으며 target 설정으로 플래시에 저장됩니다. 버튼 4개로 릴레이 1~4를, D6 버튼으로 전체를 토글하고 OLED에 상태를 보여 줍니다.
장치Remocon8266 보드 (D1 mini 기반)실물 확인 예제
사진 · 회로도
준비물
- 보드 Remocon8266 보드 (D1 mini 기반)
esp8266:esp8266:d1_mini - 네트워크 Wi-Fi 2.4GHz 공유기
- 앱 https://remocon.kr 장치 제어 화면에 Relay Control 카드가 나옵니다. 대상 CID 입력칸은 웹앱의 text 위젯이 필요하고, 없으면 r1~r4 버튼만 나옵니다
- 연동 esp8266-relay4ch 보드: 제어 대상. 기본 CID는 스케치의 DEFAULT_TARGET(the-cid)이며, 장치 키로 고정된 릴레이 보드의 CID로 바꿉니다
배선 · 핀맵
| 보드 핀 | 연결 | 비고 |
|---|---|---|
GPIO16 (D0) | SW1 버튼 → 릴레이 1 | 외부 풀업 |
GPIO0 (D3) | SW2 버튼 → 릴레이 2 | 내부 풀업 |
GPIO14 (D5) | SW3 버튼 → 릴레이 3 | 내부 풀업 |
GPIO13 (D7) | SW4 버튼 → 릴레이 4 | 내부 풀업 |
GPIO12 (D6) | 외부 버튼, 다른 쪽은 GND → 릴레이 전체 | 내부 풀업. 하나라도 켜져 있으면 전체 끄기, 모두 꺼져 있으면 전체 켜기 |
GPIO4 (D2), GPIO5 (D1) | SSD1306 128x64 OLED | I2C SDA, SCL. 맨 위는 대상 CID, 가운데는 릴레이 1~4, 맨 아래는 이 제어기의 CID입니다. |
펌웨어 설치
미리 빌드한 이 예제의 펌웨어를 USB로 연결한 보드에 브라우저에서 바로 설치합니다. 설치가 끝나면 Wi-Fi 입력 창이 이어집니다.
Remocon8266 보드 (D1 mini 기반) · ESP8266버전 9.14.1+Remocon8266-button-controller.2195cb7
- 이미 IOSignal 보드 설정을 쓰는 펌웨어가 있으면 업데이트로 설치되고 저장된 Wi-Fi가 그대로 남습니다.
- 다른 펌웨어가 있으면 “Erase device” 확인 창이 나옵니다. 체크하지 않으면 칩에 저장된 Wi-Fi를 지우지 않습니다. 체크하면 모두 지우고 Wi-Fi를 다시 넣습니다.
- Wi-Fi·서버·장치 키나 스케치 설정만 바꾸려면 보드 설정 페이지를 쓰세요. 시리얼 모니터가 포트를 쓰고 있으면 먼저 닫습니다.
- 펌웨어에는 Wi-Fi 비밀번호나 장치 키가 들어 있지 않습니다. 익명 CID로 접속합니다.
보드 설정
이 예제는 USB로 연결한 뒤 보드 설정 페이지에서 Wi-Fi, IOSignal 서버(호스트:포트)와 장치 키, 그리고 아래 설정 항목을 바꿀 수 있습니다. 스케치를 다시 빌드하지 않아도 되고, 보드가 값을 저장합니다.
| 이름 | 설명 | 형식 | 기본값 | 참고 |
|---|---|---|---|---|
name | 장치 이름과 앱(remocon.kr 등)의 분류 탭을 이름:분류로 함께 정합니다. 장치는 이 값을 그대로 $name으로 보냅니다. 기본값은 Relay Control:HOME이고, 예를 들어 거실 조명:1층이면 앱에 "거실 조명"이 1층 탭에 나옵니다. :가 없으면 분류 없이 이름만 보내 앱의 미분류 탭에 나오고, 이름을 비우면(:1층) 이름은 Relay Control입니다. 64바이트까지, 바꾸면 바로 다시 보냅니다.보드 설정 화면 표시: Name & category (name:category) | 글자, 64바이트까지 | Relay Control:HOME | |
target | 제어할 릴레이 보드(esp8266-relay4ch)의 CID입니다(예: 1413). 기본값 the-cid는 자리 표시라 실제 CID로 바꿔야 동작합니다. 앱 카드의 Target CID 칸이나 원격 명령 target=<cid>로도 바뀝니다.보드 설정 화면 표시: Target CID | CID | the-cid | 원격 명령으로도 바뀜 |
b1 | SW1을 눌렀을 때 할 일입니다. 비우면 대상의 r1을 토글합니다. 직접 정하려면 r1=1(켜기), all=0(모두 끄기), lamp1:toggle(다른 장치), #lab:s2(그룹 채널)처럼 씁니다. 원격 명령 b1=r3으로도 바뀝니다.보드 설정 화면 표시: SW1 (empty: r1) | 글자 | 없음 | 원격 명령으로도 바뀜 |
b2 | SW2. 비우면 r2 토글. 쓰는 법은 b1과 같습니다.보드 설정 화면 표시: SW2 (empty: r2) | 글자 | 없음 | 원격 명령으로도 바뀜 |
b3 | SW3. 비우면 r3 토글. 쓰는 법은 b1과 같습니다.보드 설정 화면 표시: SW3 (empty: r3) | 글자 | 없음 | 원격 명령으로도 바뀜 |
b4 | SW4. 비우면 r4 토글. 쓰는 법은 b1과 같습니다.보드 설정 화면 표시: SW4 (empty: r4) | 글자 | 없음 | 원격 명령으로도 바뀜 |
b5 | D6 버튼. 비우면 all: 하나라도 켜져 있으면 모두 끄고, 모두 꺼져 있으면 모두 켭니다. 쓰는 법은 b1과 같습니다.보드 설정 화면 표시: D6 button (empty: all) | 글자 | 없음 | 원격 명령으로도 바뀜 |
이 페이지에서 바로 설정
펌웨어를 설치한 뒤 이어서, 또는 이미 이 예제가 올라간 보드를 USB로 연결해 Wi-Fi, 서버와 장치 키, 위 설정 항목을 여기서 바로 바꿉니다. 설치 창은 먼저 닫으세요(포트를 함께 쓸 수 없습니다). 데스크톱 Chrome·Edge에서 됩니다. 보드 설정 페이지와 같은 기능입니다.
01 보드 연결
이 브라우저는 Web Serial을 지원하지 않습니다. 데스크톱 Chrome이나 Edge에서 여세요. iOS는 지원하지 않습니다.
- 상태
- Not connected
- 장치
- —
- 칩
- —
- 펌웨어
- —
보드에 IOSignalConfig를 쓰는 스케치가 올라가 있어야 합니다(Improv Wi-Fi Serial, 115200bps). 시리얼 모니터가 열려 있으면 포트를 쓸 수 없으니 먼저 닫으세요.
02 Wi-Fi 입력
비밀번호는 USB 시리얼로 보드에만 전달됩니다. 이 페이지는 저장하거나 서버로 보내지 않습니다. 보드는 2.4GHz Wi-Fi만 접속합니다. 연결에 실패하면 보드는 이전 Wi-Fi 설정을 되돌립니다.03 IOSignal 서버 · 장치 키 (선택)
- 서버
- —
- 장치 키
- —
이 보드는 설정을 저장할 곳이 없습니다. ESP8266은 보드 설정의 Flash Size에서 파일 시스템(FS)이 있는 항목을 골라 다시 올려야 합니다.
값은 USB로 보드에만 전달됩니다. 보드는 키를 다시 보내지 않고 점(.) 앞의 id만 알려 줍니다. 장치 키는 서버마다 따로 발급되므로 서버를 바꾸면 그 서버에 등록된 키를 함께 넣으세요. 키 칸을 비워 두면 키는 바뀌지 않습니다. 보드가 쓰는 키는 저장한 키(또는 익명 설정), 스케치의 키, 익명 순입니다. 바꾸면 보드가 재시작합니다.04 스케치 설정
이 스케치가 정한 설정 항목입니다. 보드가 알려 준 목록과 규칙대로 입력칸을 만듭니다.
비밀 항목은 보드가 값을 돌려보내지 않습니다. “스케치 기본값으로”는 저장된 값을 지웁니다.05 시리얼 로그
보드가 출력하는 글입니다. READY CID 줄에서 장치 CID를 확인할 수 있습니다.
사용 순서
- 펌웨어를 올립니다. 이 페이지의 펌웨어 설치에서 '이 보드에 설치'를 누르거나(데스크톱 Chrome·Edge), arduino-cli compile --upload -p <포트> --fqbn esp8266:esp8266:d1_mini 로 업로드합니다(Arduino IDE는 LOLIN(WEMOS) D1 R2 & mini).
- 릴레이 보드에 esp8266-relay4ch를 올리고 장치 키로 CID를 고정합니다.
- Wi-Fi는 설치 직후 이어지는 창이나 https://arduino.remocon.kr/wifi/ 에서 USB로 넣습니다. 보드가 저장하므로 다시 넣을 필요가 없습니다. 스케치 폴더의 _secrets.h(SECRET_WIFI_SSID, SECRET_WIFI_PASS)나 스케치의 WIFI_SSID에 실제 값을 쓰면 그 값이 부팅할 때마다 우선합니다. 제어기에 키를 쓰려면 릴레이와 다른 키로 SECRET_ID_KEY를 넣습니다.
- OLED에 Relay <대상 CID>와 상자 4개가 나오면 버튼을 눌러 봅니다. 맨 아래 줄은 이 제어기의 CID입니다.
- 버튼마다 하는 일은 보드 설정 b1~b5(SW1~SW4, D6 버튼)입니다. 비워 두면 릴레이 1~4 토글과 전체 토글입니다. 'r2=1'(릴레이 2 켜기), 'all=0'(모두 끄기), 'lamp1:toggle'(다른 장치), '#lab:s1'(그룹 채널)처럼 넣거나 remocon pub "<제어기 cid>@" "b5=all=0" 으로 바꿉니다.
- 대상을 바꾸려면 카드의 Target CID에 입력하거나 remocon pub "<제어기 cid>@" "target=<cid>" 를 보내거나, USB로 연결해 https://arduino.remocon.kr/wifi/ 의 설정 항목 target에 넣습니다. 지우면 DEFAULT_TARGET으로 돌아갑니다. 예전 버전이 EEPROM에 저장한 대상은 처음 부팅할 때 한 번 옮겨집니다.
직접 해 보기
보드를 켜고 연결하면 #search로 이 예제의 보드(이름 Relay Control)를 찾아 remocon.kr과 같은 화면으로 제어합니다. 보드가 보낸 화면($panel)이 오면 그 화면으로 바뀝니다.
미연결 · 내 CID —
화면:
- CID
- 이름
- 타입
이 예제와 맞지 않는 장치
같은 공유기에서 #search에 응답한 다른 장치입니다. 화면이 맞지 않아 여기서는 제어하지 않습니다(remocon.kr에서 제어).
주고받은 신호
제어 화면 내려받기 (HTML 파일 하나) CSS와 스크립트가 들어 있는 파일입니다. 내려받아 브라우저로 열면 이 사이트 없이도 같은 화면으로 보드를 제어합니다.
시그널 흐름
| 보내는 쪽 | 받는 쪽 | 태그 | 값 | 설명 |
|---|---|---|---|---|
| 제어기 | 서버 | #search | 구독 | 앱의 검색에 답합니다. |
| 제어기 | 서버 | @$panel | 화면 JSON (text, value, buttons) | Target CID 입력칸, 릴레이 상태, r1~r4, all 버튼 화면입니다. $ui보다 먼저 보내 보관시킵니다. |
| 제어기 | 서버 | @$name | Relay Control:HOME | 이름과 분류(첫 : 뒤)입니다. 서버에 보관됩니다. 분류는 앱이 장치를 묶어 보여 주는 탭 이름입니다. 이름과 분류 모두 보드 설정 name(이름:분류)으로 바꿉니다(바꾸면 바로 다시 보냄). 분류가 없으면 앱의 미분류 탭에 나옵니다. |
| 제어기 | 서버 | @$ui | p=1;b=r1,r2,r3,r4,all | p=1은 자체 화면을 @$panel로 보낸다는 뜻이고, b는 화면을 모르는 앱이 보여 줄 버튼입니다. 서버에 보관됩니다. |
| 제어기 | 서버 | @$state | target=the-cid;relays=0001;link=1 | 대상 CID, 릴레이 상태, 대상 연결 여부입니다. |
| 제어기 | 서버 | <target>@$state | 구독 | 보관된 릴레이 상태를 바로 받고, 이후 변경을 받습니다. |
| 앱 | 제어기 | <cid>@ | target=2001 | 대상을 바꾸고 플래시에 저장합니다. 1~12자, 공백과 @ # $ ; = 은 안 됩니다. |
| 앱 | 제어기 | <cid>@ | r1 ~ r4 | 해당 릴레이를 토글합니다. 버튼 SW1~SW4와 같습니다. |
| 앱 | 제어기 | <cid>@ | all | 대상의 r1~r4를 모두 끄거나(하나라도 켜져 있으면) 모두 켭니다. all=0 또는 all=1 명령 하나를 보냅니다. |
| 앱 | 장치 | <cid>@ | b2=r3 / b2 | b1~b5=<동작>은 그 버튼의 설정을 바꾸고(검사 후 보드에 저장), b1~b5만 보내면 그 버튼을 누른 것과 같습니다. 처리 뒤 상태로 답합니다. |
| 제어기 | 릴레이 | <target>@ | r1=1 | 현재 상태의 반대 값을 보냅니다. |
| 릴레이 | 제어기 | <target>@$state | r1=1;r2=0;r3=0;r4=1 | OLED와 카드 상태를 갱신합니다. |
| 서버 | 제어기 | <target>@$state | close | 대상이 끊기면 link=0이 되고 버튼이 멈춥니다. 다시 접속하면 이어집니다. |
참고
- text 위젯을 모르는 앱은 @$panel 화면 전체를 쓰지 않고 ui의 r1~r4, all 버튼만 보여 줍니다.
- 릴레이 상태를 모르면(link=0) 토글 명령을 보내지 않습니다.
- 릴레이와 같은 키로 인증하면 한쪽이 로그아웃되므로 별도 키를 씁니다.
- IOSignalConfig.h가 들어 있는 IOSignal 릴리스(9.12.0 다음)가 필요합니다. 보드 설정(USB)과 target 설정 항목에 씁니다.
- 저장된 target 설정이 있으면 DEFAULT_TARGET보다 먼저 씁니다. DEFAULT_TARGET을 바꿔 다시 올려도 저장값이 남아 있으면 그 값을 씁니다. 보드 설정 페이지에서 target의 '스케치 기본값으로'를 고르면 DEFAULT_TARGET으로 돌아갑니다.
- 버튼 동작은 RemoconButtons.h(Remocon 라이브러리)가 맡습니다. 형식은 RemoconBinding.h 맨 위에 있고, 잘못된 값은 저장하지 않고 시리얼에 'bad setting'을 찍습니다.
