검증 범위와 문제 해결
이 과정은 공개 IOSignal JS 6.1.2를 웹앱 의존성으로 고정합니다. Arduino는 IOSignal 5.1.0, Boho 0.8.0 소스를 기준으로 확인합니다. 새 예제의 소스 포함 여부와 Library Manager 배포 상태는 별개입니다.
프로젝트 개발자는 기존 라이브러리로 UNO R3 + W5100, UNO R4 WiFi, ESP8266, ESP32-C3, ESP32, ESP32-S3의 실물 동작을 확인했습니다. 아래 기록은 이번 튜토리얼에 사용한 개별 스케치의 검증 범위이며, 라이브러리 전체의 보드 지원 목록과는 구분합니다.
소스 검증 기록 (2026-10-02)
| 대상 | 결과 |
|---|---|
IOSignal esp32_channel_txrx | ESP32 코어 3.3.12, esp32:esp32:esp32 컴파일 통과 |
Remocon esp32-cid-led | 같은 ESP32 설정으로 컴파일 통과 |
Remocon esp32-group-led | 같은 ESP32 설정으로 컴파일 통과 |
Remocon esp32s3-ws2812 | ESP32 코어 3.3.12, esp32:esp32:esp32s3 컴파일 통과 |
| 공개 JS 6.1.2 로컬 통신 | payload 구별, 검색, CID 명령·상태, 그룹 리테인 수신 검사 통과 |
| 웹앱 브라우저 확인 | 기본 송수신·모의 장치 검색/CID·그룹·RGB·잘못된 HEX 입력 확인, 모바일 390px 가로 넘침 없음 |
| 실물 업로드·제어 | 미검증. 검증 당시 연결된 ESP32가 감지되지 않음 |
| 운영 Remocon 웹앱 연동 | 소스 규약 대조 완료, 운영 서비스에서 실물 검증은 미실시 |
Playwright UI 테스트 코드도 포함되어 있습니다. 작성 환경에서 독립 Chrome 실행이 차단되어 해당 자동 테스트는 완료하지 못했고, 내장 브라우저로 위 동작을 확인했습니다.
실물 확인 순서
각 실습에서 다음을 순서대로 확인하세요.
- 보드 종류와 핀 배선이 예제와 일치하는가?
- Wi-Fi에 연결되어 시리얼에
READY CID:가 나타나는가? - 웹과 보드가 같은 서버를 사용하며 웹도
ready인가? - 기본·검색·그룹 태그를 사용할 때 같은 홈채널 환경인가?
- RX의 태그·타입·값이 문서와 같은가?
- LED 출력과 실제 상태 발행이 일치하는가?
- 보드·웹 재접속 후 다시 구독하거나 새 CID를 선택했는가?
증상별 확인
| 증상 | 확인할 항목 |
|---|---|
| Wi-Fi 대기 | SSID·비밀번호, 2.4GHz 지원 네트워크, 전원 |
| 웹 연결 실패 | WebSocket URL, 서버 실행 여부, WS/WSS 사용 환경 |
| Arduino 서버 연결 실패 | 호스트에 URL 접두어를 넣지 않았는지, TCP 포트 55488, 방화벽 |
| 검색 결과 없음 | 같은 서버·홈채널인지, 스케치가 #search 또는 #scan/ch에 응답하는지 |
| CID 명령 무반응 | 내 CID가 아니라 장치 CID인지, 재접속으로 CID가 변경되었는지 |
| 그룹의 같은 LED만 움직임 | 두 보드의 OUTPUT_INDEX가 각각 0과 1인지 |
| RGB 무반응 | 정확한 S3 보드·WS2812 핀인지, BINARY 4바이트인지 |
| TX·RX는 보이는데 LED 무반응 | 자기 메시지를 받은 것인지, 잘못된 프리셋·배선인지 |
| 초기 상태가 안 나타남 | 리테인 사용 여부와 보관 정책, 장치의 실제 연결 상태 |
컴파일 성공은 실물 통신 검증을 뜻하지 않습니다. 운영 웹앱의 계정·인증 기능 및 실제 장치 동작은 해당 환경에서 별도로 확인해야 합니다.
보드별 예제 확장 검증
ESP32-C3 Super Mini esp32c3-button-led와 iris-group를 ESP32 코어 3.3.12의 esp32:esp32:esp32c3 대상으로 컴파일했습니다. 원본의 테스트된 핀 구성을 적용했으며 이번에 구성한 스케치의 실 물 재검증은 아직 하지 않았습니다.
웹앱은 npm 브라우저 ESM 직접 import와 Vite 빌드로 전환했습니다. 브라우저에서 실제 버전 6.1.2 표시, 로컬 ready 연결, #homeButton 송수신, iris 그룹 3의 00100000 송수신을 확인했습니다. 이전 데모와 복사된 라이브러리 파일은 제거했습니다.