iris-basic 전용 제어기
iris 보드 한 대가 웹앱처럼 iris-basic 보드를 찾아 제어합니다. 상대 상태를 자기 LED 4개에 그대로 보여 주고, 내장 버튼 2개로 명령을 보냅니다.
기타iris 보드 (ESP32-C3)실물 확인 예제
사진 · 회로도
준비물
- 보드 iris 보드 (ESP32-C3)
esp32:esp32:esp32c3 - 네트워크 Wi-Fi 2.4GHz 공유기
- 앱 없음. 같은 네트워크의 iris-basic 보드를 제어합니다. 웹앱으로 동시에 제어해도 됩니다
- 연동 iris-basic 보드: 제어 대상. @$name의 : 앞이 Iris Basic인 첫 장치를 고릅니다
배선 · 핀맵
| 보드 핀 | 연결 | 비고 |
|---|---|---|
GPIO4 | WS2812 4개 | 보드에 내장. 대상의 상태를 보여 줍니다 |
GPIO8 | 상태 LED | active low. 대상을 찾으면 켜집니다 |
GPIO1 | 버튼 1: 대상 전체 켜기/끄기 | 내부 풀업 |
GPIO2 | 버튼 2: 대상의 켜진 LED를 하나씩 늘림, 4개 다음은 모두 끔 | 내부 풀업 |
펌웨어 설치
미리 빌드한 이 예제의 펌웨어를 USB로 연결한 보드에 브라우저에서 바로 설치합니다. 설치가 끝나면 Wi-Fi 입력 창이 이어집니다.
iris 보드 (ESP32-C3) · ESP32-C3버전 9.14.1+iris-basic-controller.2195cb7
- 이미 IOSignal 보드 설정을 쓰는 펌웨어가 있으면 업데이트로 설치되고 저장된 Wi-Fi가 그대로 남습니다.
- 다른 펌웨어가 있으면 “Erase device” 확인 창이 나옵니다. 체크하지 않으면 칩에 저장된 Wi-Fi를 지우지 않습니다. 체크하면 모두 지우고 Wi-Fi를 다시 넣습니다.
- Wi-Fi·서버·장치 키나 스케치 설정만 바꾸려면 보드 설정 페이지를 쓰세요. 시리얼 모니터가 포트를 쓰고 있으면 먼저 닫습니다.
- 펌웨어에는 Wi-Fi 비밀번호나 장치 키가 들어 있지 않습니다. 익명 CID로 접속합니다.
보드 설정
이 예제는 USB로 연결한 뒤 보드 설정 페이지에서 Wi-Fi, IOSignal 서버(호스트:포트)와 장치 키을 바꿀 수 있습니다. 스케치를 다시 빌드하지 않아도 되고, 보드가 값을 저장합니다.
이 페이지에서 바로 설정
펌웨어를 설치한 뒤 이어서, 또는 이미 이 예제가 올라간 보드를 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를 확인할 수 있습니다.
사용 순서
- 보드 한 대에 iris-basic을 업로드합니다.
- 다른 보드에 이 스케치를 업로드하고, 두 보드 모두 같은 공유기의 Wi-Fi를 USB로 https://arduino.remocon.kr/wifi/ 에서 넣습니다(또는 스케치의 Wi-Fi 값).
- 제어기의 상태 LED가 켜지면 대상을 찾은 것입니다.
- 제어기 버튼을 누르면 두 보드의 LED가 함께 바뀝니다. 대상 보드 버튼이나 웹앱으로 바꿔도 제어기에 반영됩니다.
시그널 흐름
| 보내는 쪽 | 받는 쪽 | 태그 | 값 | 설명 |
|---|---|---|---|---|
| 제어기 | 서버 | #notify | 구독 | 장치들의 CID 응답을 받습니다. |
| 제어기 | 장치 | #search | 접속할 때, 그리고 대상이 없으면 15초마다 보냅니다. | |
| 장치 | 제어기 | #notify | <cid> | 검색에 답한 장치마다 받습니다. |
| 제어기 | 서버 | <cid>@$name | 구독 | 보관된 이름을 바로 받아 : 앞이 Iris Basic인지 본 뒤 구독을 취소합니다(unsubscribe). |
| 제어기 | 서버 | <cid>@$state | 구독 | 대상을 고른 뒤 상태를 구독합니다. 보관된 상태를 바로 받습니다. |
| 제어기 | 장치 | <cid>@ | s1=1 | 버튼을 누르면 바뀌어야 할 LED마다 명령을 하나씩 보냅니다. |
| 장치 | 제어기 | <cid>@$state | s1=1;s2=0;s3=0;s4=0 | 제어기 LED는 이 값으로만 바뀝니다. |
| 서버 | 제어기 | <cid>@$state | close | 대상이 끊기면 상태 LED를 끄고 다시 검색합니다. |
참고
- 제어기는 장치로 자신을 알리지 않습니다. 웹앱과 같은 쪽 역할입니다.
- 버튼은 대상의 상태를 받은 뒤부터 동작합니다.
- Iris Basic이 여러 대면 먼저 답한 한 대만 제어합니다.
- 시리얼 로그는 115200입니다. 보드 USB로 보려면 USB CDC On Boot를 Enabled로 컴파일합니다(fqbn esp32:esp32:esp32c3:CDCOnBoot=cdc).
- Wi-Fi 절전을 끄고(WiFi.setSleep(false)) TCP 지연 전송을 끕니다(setNoDelay). 절전이 켜져 있으면 받는 신호가 100~800ms 늦어집니다. 2026-11-09 측정: 명령에서 상태까지 213ms → 23ms.
- IOSignal 9.6.0 이상이 필요합니다(unsubscribe()를 씁니다).
- Wi-Fi 송신 출력을 8.5dBm으로 낮춥니다. 한 iris 보드가 최대 출력에서 보내는 패킷을 잃어 TCP가 멈췄고(명령 60개 중 32개 응답), 낮추자 60개 모두 응답했습니다(2026-11-09).
