본문으로 건너뛰기

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 공유기가 필요합니다.

업로드​

  1. 라이브러리 설치에서 IOSignal과 Bounce2를 설치합니다.
  2. 파일 > 예제 > IOSignal > esp_channel_txrx를 엽니다. ESP32-C3라면 위 표대로 핀을 바꿉니다.
  3. 보드를 고르고(D1 mini: LOLIN(WEMOS) D1 R2 & mini, ESP32-C3: ESP32C3 Dev Module) 업로드합니다. ESP32-C3에서 시리얼 출력을 보려면 USB CDC On Boot를 Enabled로 둡니다.
  4. 보드를 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 예제를 보세요.