본문으로 건너뛰기

IOSignal Arduino Client

Arduino용 IOSignal 클라이언트로 다른 보드, 웹앱, 서버와 실시간으로 통신하고 인증·암호화를 사용할 수 있습니다. 메서드·콜백·상수 목록은 Arduino API에 있습니다.

특정 보드에 묶이지 않도록 Arduino Client 인터페이스로 통신하며, Wi-Fi와 Ethernet은 보드의 호환 클라이언트를 사용합니다. 일반 Stream은 begin()에 바로 넘길 수 없고 Client를 구현한 어댑터가 필요합니다. 메모리가 작은 UNO R3 + W5100도 지원합니다.

호환되는 아두이노​

개발자가 실물로 동작을 확인한 보드입니다. 예제별 배선·주변장치 조건은 따로 확인하세요.

  • ESP8266 D1 mini
  • ESP32-C3 Super Mini
  • ESP8266 D1
  • Sparkfun esp8266 thing / thing dev
  • ESP32 호환보드
  • Arduino Uno R4 WiFi
  • Arduino Uno R3 + Ethernet Shield W5100
  • ESP32-S3
  • ESP32 cam AI thinker 호환
  • ESP32 Odroid Go

네트워크 준비와 핀 설정은 보드마다 다르지만 송수신·CID·그룹 제어 흐름은 같습니다. 처음이라면 D1 mini·ESP32-C3 채널 송수신에서 시작하세요. IOSignal 예제는 arduino.iosignal.net, 장치 검색·제어(Remocon) 예제는 arduino.iosignal.net에 배선과 함께 있습니다.

수신 버퍼는 기본 80바이트입니다. 버퍼 크기는 접속할 때 서버에 전달되고, 서버는 그보다 큰 메시지를 이 보드에 보내지 않습니다(건너뜀). 다른 장치의 이름·상태처럼 긴 메시지를 받아야 하면 begin() 전에 io.setRxBuffer(크기)로 늘립니다.

보드 설정 (ESP32·ESP8266)​

IOSignal Arduino 9.13.0부터 IOSignalConfig.h를 쓰는 ESP32·ESP8266 스케치는 다시 빌드하지 않고 USB로 연결한 브라우저에서 설정을 바꿉니다. 페이지는 arduino.iosignal.net/wifi와 arduino.iosignal.net/wifi(데스크톱 Chrome·Edge)이고, 각 예제 페이지의 "보드 설정" 패널도 같습니다. 표준 Improv Wi-Fi Serial에 IOSignal 전용 명령을 더한 방식입니다.

#include <IOSignal.h>
#include <IOSignalConfig.h>

IOSignalConfig config;
IOSignalSetting target(config, "target", "Target CID", "the-cid", IOSignalSetting::CID); // 선택: 스케치 설정 항목

void setup() {
Serial.begin(115200);
config.begin(Serial, "My Device", "WIFI_SSID", "WIFI_PASS"); // 자리표시자면 칩에 저장된 Wi-Fi를 씁니다
config.setServer("io.iosignal.net", 55488); // 기본 서버
if (config.key()) io.auth(config.key()); // 브라우저에서 넣은 장치 키
io.begin(&client, config.host(), config.port());
}

void loop() {
config.loop(); // 브라우저 요청, Wi-Fi 재접속
if (config.connected()) io.loop();
}
항목동작
Wi-Fi칩이 저장해 다음 부팅에도 씁니다. 스케치에 실제 SSID를 쓰면 부팅할 때마다 그 값이 우선합니다.
서버(호스트:포트)브라우저에서 넣은 값이 스케치 값보다 우선하고, 지우면 스케치 값으로 돌아갑니다.
장치 키(id.key)서버와 같습니다. 키는 보드 밖으로 다시 보내지 않습니다. "익명으로 접속"(9.14.1부터)을 고르면 스케치에 키가 있어도 익명으로 접속합니다.
스케치 설정 항목IOSignalSetting으로 글자·CID·정수·켜기/끄기·선택 항목을 8개까지(값 64바이트) 선언하면 페이지가 입력칸을 만듭니다. 코드는 value(), toInt(), toBool()로 읽고 onChange()로 바로 적용합니다.
  • 설정은 ESP32 Preferences, ESP8266 LittleFS에 저장합니다. 다른 보드에서는 이 헤더가 비어 있습니다.
  • ESP 예제 대부분이 보드 설정을 쓰며, 예제 사이트에서 펌웨어를 브라우저로 바로 설치한 뒤 같은 화면에서 Wi-Fi를 넣을 수 있습니다.
  • 자세한 API는 iosignal-arduino README를 참고하세요.

인증 해제와 라이브러리 로그​

서버가 AUTH_CLEAR를 보내면(예: 같은 ID로 다른 곳에서 접속해 이 장치가 교체됨) IOSignal Arduino 7.0.0부터 라이브러리는 인증 정보를 지우고 IO_STOP 상태로 멈춥니다. 익명으로 다시 접속하지 않습니다. 서버가 보낸 사유는 io.lastReason에 남고 onError 콜백이 IO_AUTH_CLEAR로 호출됩니다. 다시 연결하려면 auth()와 begin()을 다시 호출합니다. 서버의 keepNew·keepOld 정책은 중복 로그인을 참고하세요.

void printLog(const char* message) {
Serial.println(message);
}

void setup() {
// ...
io.setLog(printLog);
}

setLog를 설정하면 [IOSignal] AUTH_CLEAR: duplicate login. connection stopped. 같은 한 줄을 받습니다. 설정하지 않으면 라이브러리는 아무것도 출력하지 않습니다.

실기 확인용 예제는 esp32c3_duplicate_login(ESP32-C3 Super Mini)입니다. 같은 ID_KEY로 다른 곳에서 로그인하면 위 메시지가 출력되고, keepOld 서버에서는 거부된 시도 횟수를 출력합니다.