WiFi 공유 스위치 (가장 간단한 예제)
#switch 그룹에 참여해 공유 상태를 시리얼로 출력합니다. 하드웨어 없이 통신만 확인하는 가장 간단한 예제이고, 보드 설정으로 출력 핀(LED·릴레이)과 버튼 핀을 정하면 s1을 따르는 릴레이나 s1을 토글하는 버튼 보드가 됩니다.
그룹ESP-01 (ESP8266)ESP8266 D1 miniESP32 개발 보드ESP32-C3 Super Mini실물 확인 예제
사진 · 회로도
준비물
- 보드 ESP-01 (ESP8266)
esp8266:esp8266:generic - 보드 ESP8266 D1 mini (브라우저 설치는 ESP-01과 같은 ESP8266 펌웨어(1MB)를 씁니다)
esp8266:esp8266:d1_mini - 보드 ESP32 개발 보드
esp32:esp32:esp32 - 보드 ESP32-C3 Super Mini
esp32:esp32:esp32c3 - 네트워크 Wi-Fi 2.4GHz 공유기
- 앱 https://remocon.kr 또는 IOSignal Desktop 장치 제어 화면
배선 · 핀맵
| 보드 핀 | 연결 | 비고 |
|---|---|---|
out (보드 설정) | LED 또는 릴레이 | s1을 따릅니다. out_high 0이면 LOW가 켜짐(내장 LED), 1이면 HIGH가 켜짐(릴레이 모듈). 예: ESP-01 릴레이 보드 0, D1 mini 내장 LED 2, ESP32-C3 Super Mini 8 |
button (보드 설정) | 버튼 (GND로) | 누르면 s1을 바꿔 그룹 상태 전체를 다시 씁니다(s2, s3는 유지). 내부 풀업. 예: ESP-01 GPIO0, 버튼이 RX에 있는 보드 3, D1 mini D5(14) |
펌웨어 설치
미리 빌드한 이 예제의 펌웨어를 USB로 연결한 보드에 브라우저에서 바로 설치합니다. 설치가 끝나면 Wi-Fi 입력 창이 이어집니다.
ESP-01 (ESP8266) · ESP8266ESP32 개발 보드 · ESP32ESP32-C3 Super Mini · ESP32-C3버전 9.14.1+wifi-simple.f6d32d9
- 이미 IOSignal 보드 설정을 쓰는 펌웨어가 있으면 업데이트로 설치되고 저장된 Wi-Fi가 그대로 남습니다.
- 다른 펌웨어가 있으면 “Erase device” 확인 창이 나옵니다. 체크하지 않으면 칩에 저장된 Wi-Fi를 지우지 않습니다. 체크하면 모두 지우고 Wi-Fi를 다시 넣습니다.
- Wi-Fi·서버·장치 키나 스케치 설정만 바꾸려면 보드 설정 페이지를 쓰세요. 시리얼 모니터가 포트를 쓰고 있으면 먼저 닫습니다.
- 펌웨어에는 Wi-Fi 비밀번호나 장치 키가 들어 있지 않습니다. 익명 CID로 접속합니다.
보드 설정
이 예제는 USB로 연결한 뒤 보드 설정 페이지에서 Wi-Fi, IOSignal 서버(호스트:포트)와 장치 키, 그리고 아래 설정 항목을 바꿀 수 있습니다. 스케치를 다시 빌드하지 않아도 되고, 보드가 값을 저장합니다.
| 이름 | 설명 | 형식 | 기본값 | 참고 |
|---|---|---|---|---|
name | 그룹 카드의 이름과 분류 탭을 이름:분류로 함께 정합니다. 구성원 모두 이 값을 그룹 $name으로 보내므로 같은 그룹의 보드에는 같은 값을 넣으세요. 기본값은 공유 스위치:HOME이고, :가 없으면 분류 없이 미분류 탭에 나옵니다. 이름을 비우면(:1층) 이름은 공유 스위치입니다.보드 설정 화면 표시: Name & category (name:category) | 글자, 64바이트까지 | 공유 스위치:HOME | |
out | s1을 따르는 출력 핀(LED나 릴레이)입니다. -1이면 쓰지 않습니다. 예: ESP-01 릴레이 보드 0, D1 mini 내장 LED 2, ESP32-C3 Super Mini 내장 LED 8. 바꾸면 보드가 재시작합니다.보드 설정 화면 표시: Output pin, follows s1 (-1: none) | 정수, -1~39 | -1 | 바꾸면 재시작 |
out_high | 출력이 켜질 때의 전압입니다. 1이면 HIGH가 켜짐(대부분의 릴레이 모듈), 0이면 LOW가 켜짐(보드 내장 LED). 바꾸면 보드가 재시작합니다.보드 설정 화면 표시: Output on is HIGH (relay 1, LED 0) | 켜기/끄기 (1/0) | 0 | 바꾸면 재시작 |
button | s1을 토글하는 버튼 핀입니다(GND로 연결, 내부 풀업). -1이면 쓰지 않습니다. 누르면 s2, s3는 그대로 두고 s1만 바꿔 그룹 상태를 씁니다. 예: ESP-01 0, D1 mini D5 14. 바꾸면 보드가 재시작합니다.보드 설정 화면 표시: Button pin, toggles s1 (-1: none) | 정수, -1~39 | -1 | 바꾸면 재시작 |
이 페이지에서 바로 설정
펌웨어를 설치한 뒤 이어서, 또는 이미 이 예제가 올라간 보드를 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를 확인할 수 있습니다.
사용 순서
- 업로드한 뒤(또는 이 페이지의 펌웨어 설치로) USB로 연결해 https://arduino.remocon.kr/wifi/ (보드 설정)에서 Wi-Fi를 넣습니다(데스크톱 Chrome·Edge, 보드가 저장). 같은 페이지에서 다른 IOSignal 서버(호스트:포트)와 장치 키도 넣을 수 있습니다.
- LED·릴레이나 버튼을 쓰면 보드 설정 out, out_high, button을 넣습니다. 핀은 부팅할 때 읽으므로 바꾸면 보드가 재시작합니다.
- 시리얼 모니터 115200을 엽니다.
- 같은 공유기에 연결한 브라우저로 https://remocon.kr 을 엽니다.
- 공유 스위치를 눌러 시리얼에 s1=1 같은 값이 나오는지, 출력 핀이 따라오는지 봅니다. 버튼을 누르면 앱의 s1도 바뀝니다.
직접 해 보기
그룹 채널의 공유 상태(#switch$state)를 remocon.kr과 같은 화면으로 바꿉니다. 그룹의 보드들이 각자 자기 키를 적용합니다.
미연결 · 내 CID —
화면:
주고받은 신호
제어 화면 내려받기 (HTML 파일 하나) CSS와 스크립트가 들어 있는 파일입니다. 내려받아 브라우저로 열면 이 사이트 없이도 같은 화면으로 보드를 제어합니다.
시그널 흐름
| 보내는 쪽 | 받는 쪽 | 태그 | 값 | 설명 |
|---|---|---|---|---|
| 장치 | 서버 | #switch$state | 구독 | 공유 상태를 구독합니다. 보관된 값이 있으면 바로 받습니다. |
| 장치 | 서버 | #search | 구독 | 앱의 검색 요청을 받도록 구독합니다. |
| 장치 | 서버 | #switch$name | 공유 스위치:HOME | 그룹 이름과 분류입니다. 구성원 모두 같은 값을 보냅니다. 분류는 앱이 그룹 카드를 묶어 보여 주는 탭 이름입니다. 이름과 분류 모두 보드 설정 name(이름:분류)으로 바꿉니다(바꾸면 바로 다시 보냄). 분류가 없으면 앱의 미분류 탭에 나옵니다. |
| 장치 | 서버 | #switch$ui | t=switch3.1 | 공식 타입 switch3.1입니다(확장형: 첫 키가 t). 앱이 그 타입의 화면을 그립니다. 서버에 보관됩니다. 그룹은 확장형만 씁니다. |
| 장치 | 앱 | #notify | #switch | 그룹은 CID 대신 채널 이름으로 알립니다. |
| 앱 | 장치 | #search | 앱이 그룹을 찾습니다. | |
| 장치 | 앱 | #notify | #switch | 구성원마다 답하고 앱은 하나로 합칩니다. |
| 앱 | 장치 | #switch$state | s1=1;s2=0;s3=0 | 앱이 전체 문자열을 다시 씁니다. 구성원은 자기 키를 읽습니다. |
| 장치 | 그룹 | #switch$state | s1=1;s2=0;s3=0 | button 핀을 누르면 s1만 바꿔 그룹 상태 전체를 씁니다. 구성원 모두와 앱이 받습니다. |
참고
- 기본은 값을 출력만 하고 핀은 제어하지 않습니다(out, button 모두 -1).
- 비공개 예제 esp-d1-switch-button, esp01-relay-passive, esp01-relay-passive-control, esp01-relay-passive-control-woryboard를 보드 설정으로 합쳤습니다(2026-11-16).
- ESP-01은 GPIO1(TX)을 출력이나 버튼으로 쓰면 시리얼이 멈춥니다. 보드 설정이 필요하면 다른 핀을 쓰세요.
