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 서버에서는 거부된 시도 횟수를 출력합니다.