D1 mini·ESP32-C3 채널 송수신
버튼을 누르면 #homeButton 채널로 신호를 보내고, 같은 채널의 신호를 받으면 LED를 켜고 끕니다. 같은 공유기의 보드끼리, 그리고 웹·CLI와 신호를 주고받는 가장 짧은 예제입니다. 예제 이름은 esp_channel_txrx이고 test.iosignal.net에 배선 그림과 "직접 해 보기" 화면이 있습니다.
준비
| 보드 | LED | 버튼 | 바꿀 것 |
|---|---|---|---|
| ESP8266 D1 mini (기본) | 내장 LED(GPIO2) | D5(GPIO14)와 GND 사이 | 없음 |
| ESP32-C3 Super Mini | 내장 LED(GPIO8) | 내장 BOOT 버튼(GPIO9) | 스케치의 LED_PIN을 8, ESP32용 BUTTON_PIN을 9로 |
- D1 mini는 버튼 하나만 있으면 됩니다. 버튼이 없으면 점퍼선으로 D5를 GND에 잠깐 대도 됩니다.
- ESP32-C3 Super Mini는 핀 두 줄만 바꾸면 부품 없이 동작합니다. 내장 LED는 LOW에서 켜집니다.
- 2.4GHz Wi-Fi 공유기가 필요합니다.
업로드
- 라이브러리 설치에서 IOSignal과 Bounce2를 설치합니다.
- 파일 > 예제 > IOSignal > esp_channel_txrx를 엽니다. ESP32-C3라면 위 표대로 핀을 바꿉니다.
- 보드를 고르고(D1 mini: LOLIN(WEMOS) D1 R2 & mini, ESP32-C3: ESP32C3 Dev Module) 업로드합니다. ESP32-C3에서 시리얼 출력을 보려면 USB CDC On Boot를 Enabled로 둡니다.
- 보드를 USB로 연결한 채 데스크톱 Chrome·Edge에서 보드 설정을 열고 Wi-Fi 이름과 비밀번호를 넣습니다. 보드가 저장하므로 다시 업로드해도 남습니다. 스케치의
WIFI_SSID,WIFI_PASS에 직접 써도 됩니다.
서버는 io.iosignal.net:55488(TCP)이 기본입니다. 같은 보드 설정 페이지에서 다른 IOSignal 서버(호스트:포트)와 장치 키를 넣을 수 있습니다.
동작
- 연결되어
ready가 되면#homeButton을 구독합니다. 시리얼 모니터(115200 baud)에onReady cid: …가 나옵니다. - 버튼을 누르면
#homeButton에 보드 종류(esp8266또는esp32)를 텍스트로 보냅니다. 보낸 보드를 구분하는 값이며 on/off 명령이 아닙니다. #homeButton을 받으면 LED를 토글합니다. 자기가 보낸 신호도 받으므로, 보드 한 대에서도 버튼을 누르면 LED가 바뀝니다.
#homeButton은 채널 이름이 없는 홈채널 태그입니다. 같은 공유기(같은 공인 IP)에서 접속한 보드·웹·CLI끼리만 전달됩니다.
웹이나 CLI로 확인
- test.iosignal.net의 예제 페이지에서 "직접 해 보기"로
#homeButton을 보내고 보드가 보낸 신호를 봅니다. 보드와 같은 공유기에 연결한 PC나 휴대폰에서 엽니다. - CLI로는 같은 공유기의 PC에서
io-client -c wss://io.iosignal.net/ws -j '#homeButton'로 연결하고sig #homeButton hello를 보냅니다(CLI 클라이언트). LED가 바뀌고, 보드의 버튼을 누르면 CLI에 신호가 옵니다.
CLI나 웹에 자기 메시지가 보였다고 보드가 받은 것은 아닙니다. 보드의 LED와 시리얼 로그로 확인하세요.
문제 해결
- 시리얼에 연결 로그가 없으면 Wi-Fi 이름·비밀번호와 2.4GHz 여부를 확인합니다. 보드 설정 페이지에서 Wi-Fi 검색 결과를 볼 수 있습니다.
ready인데 LED가 반응하지 않으면 서버, 태그 철자(#homeButton), 같은 공유기인지를 확인합니다.- 로컬 서버를 쓸 때는
localhost가 아니라 PC의 LAN IP와 TCP 포트를 넣습니다. 연결 환경을 참고하세요.
다음 단계로 웹앱이 찾고 제어하는 장치를 만들려면 Remocon 장치 만들기와 Arduino 시작하기의 D1 mini·ESP32 예제를 보세요.