Arduino 시작하기
ESP8266·ESP32 같은 보드를 IOSignal 서버에 연결해 웹앱, 다른 보드, Node.js와 신호를 주고받습니다. 처음이라면 핵심 개념 5분 요약을 먼저 읽으세요. 태그, 전달 방식, 홈채널은 모든 환경에서 같습니다.
| 용도 | 하는 일 | 시작할 곳 |
|---|---|---|
| 기본 통신 | 채널·CID 송수신, 인증과 암호화 | IOSignal Arduino Client, D1 mini·ESP32-C3 채널 송수신, arduino.iosignal.net |
| 장치 | remocon.kr 웹앱이 찾고 제어하는 장치(이름·버튼·상태) | 아래 예제, 장치 만들기 (app.iosignal.net 호환), arduino.iosignal.net |
두 가지 모두 IOSignal 라이브러리 하나에 들어 있습니다. 9.23.0부터 장치 예제와 장치 도우미 헤더(IOSignalUi.h 등)도 IOSignal에 있습니다. 그 전에는 Remocon 라이브러리에 있었습니다.
1. 설치
Arduino IDE의 라이브러리 매니저에서 IOSignal을 설치합니다(9.23.0 이상). 자세한 순서는 라이브러리 설치에 있습니다. 코드를 고치지 않고 먼저 동작을 보려면 아래 브라우저에서 바로 설치하기로 펌웨어를 올리세요.
2. 첫 연결
D1 mini·ESP32-C3 채널 송수신을 올립니다. 버튼을 누르면 #homeButton 채널로 신호를 보내고, 받으면 LED가 바뀝니다. Wi-Fi는 USB로 연결한 채 브라우저의 보드 설정 페이지에서 넣습니다.
3. Arduino에서 다른 점
- 수신은 콜백 하나: 모든 신호를
onMessage(tag, type, payload, size)하나로 받고tag를 비교해 나눕니다. JS의on()·listen()은 없습니다. - 구독은
onReady에서:onReady는 접속할 때마다(재접속 포함) 불립니다. 구독과 첫 알림을 여기에 둡니다. - TCP로 연결: 보드는 WebSocket이 아니라 서버의 TCP 포트(공개 서버
io.iosignal.net:55488)에 연결합니다. 호스트에ws://를 붙이지 않습니다. 연결 환경 - 수신 버퍼: 기본 80바이트입니다. 서버는 이보다 큰 메시지를 이 보드에 보내지 않습니다. 다른 장치의 이름·상태처럼 긴 메시지를 받으려면
begin()전에setRxBuffer()로 늘립니다. - 보드 설정: ESP 예제는 Wi-Fi, 서버, 장치 키를 USB로 연결한 브라우저에서 넣고 보드가 저장합니다. 보드 설정
- 인증: 장치 키로 로그인하면 고정 CID를 씁니다. 같은 키로 다른 곳에서 접속해 교체되면 라이브러리가 멈춥니다. 인증 해제와 로그
4. 만들기 가이드
| 만들고 싶은 것 | 문서 |
|---|---|
| 보드끼리, 웹과 채널로 주고받기 | D1 mini·ESP32-C3 채널 송수신, 태그와 전달 방식 |
| remocon.kr 앱이 찾고 제어하는 장치 | 장치 만들기 (app.iosignal.net 호환) |
| 릴레이를 다른 보드의 버튼으로 제어 | 장치 구성 예: 릴레이와 버튼 제어기 |
| JS와 바이너리·숫자 주고받기 | 데이터 형식과 JS·Arduino 호환성 |
| 장치 키로 로그인 | IOSignal Arduino Client, 서버 인증 설정 |
| 메서드·콜백·상수 찾기 | Arduino API |
5. 예제: 브라우저에서 바로 설치하기
arduino.iosignal.net의 ESP 예제 페이지에는 미리 빌드한 펌웨어가 있습니다. Arduino IDE 없이 USB 케이블과 브라우저만 있으면 됩니다.
- 데스크톱 Chrome이나 Edge로 예제 페이지를 엽니다(Web Serial이 필요합니다. iOS는 지원하지 않습니다).
- 보드를 USB로 연결하고 펌웨어 설치의 "이 보드에 설치"를 누른 뒤 포트를 고릅니다.
- 설치가 끝나면 이어지는 창에 2.4GHz Wi-Fi 이름과 비밀번호를 넣습니다. 나중에 바꿀 때는 보드 설정 페이지를 씁니다.
- 같은 공유기에 연결한 휴대폰이나 PC에서 remocon.kr을 열면 장치 카드가 나타납니다.
- 펌웨어에는 Wi-Fi 비밀번호나 장치 키가 들어 있지 않으며 익명 CID로 접속합니다. 장치 키와 서버는 보드 설정에서 넣을 수 있습니다(보드 설정).
- 이미 IOSignal 보드 설정을 쓰는 펌웨어가 있으면 업데이트로 설치되어 저장된 Wi-Fi가 남습니다.
- 시리얼 모니터가 포트를 쓰고 있으면 먼저 닫으세요.
- 같은 예제의 스케치는 Arduino IDE의 파일 > 예제 > IOSignal에도 있습니다.
카드를 누르면 arduino.iosignal.net의 예제 페이지(배선, 신호 흐름, 펌웨어 설치, 웹 제어 화면)로 갑니다. "실물 미확인"은 코드를 보고 쓴 설명으로, 아직 실제 보드로 확인하지 않은 예제입니다.
보드 한 대, 카드 하나
보드 한 대가 앱의 장치 카드 하나가 되는 기본 형태입니다. 장치 검색, 명령, 상태가 오가는 흐름을 보려면 여기서 시작하세요.
ESP32 CID LEDESP32 개발 보드LED 하나를 CID 명령으로 켜고 끕니다. 검색·명령·상태를 가장 짧게 보여 주는 기준 예제입니다.
D1 mini LED와 버튼ESP8266 D1 mini내장 LED를 웹앱과 버튼으로 켜고 끕니다.
Remocon8266 basicRemocon8266 보드 (D1 mini 기반)출력 3개를 3구 스위치로 제어하고, 바뀐 상태와 누가 바꿨는지를 OLED에 보여 줍니다.
Remocon8266 tvRemocon8266 보드 (D1 mini 기반)버튼 4개로 bayo.tv 화면을 제어하고 재생 상태·음량·제목을 OLED에 보여 줍니다.
Remocon8266 scannerRemocon8266 보드 (D1 mini 기반)앱처럼 #search를 보내 같은 공유기의 장치 목록과 상태를 OLED에 보여 줍니다.
ESP32-CAM 카메라ESP32-CAM (AI Thinker)찍은 사진을 remocon.kr 장치 카드에 보여 줍니다. E2E 키로 사진을 암호화할 수 있습니다.
그룹으로 묶기
여러 보드가 하나의 상태를 함께 씁니다. 앱에는 보드 수와 상관없이 그룹 카드 하나가 나옵니다.
ESP32 그룹 LEDESP32 개발 보드 2대두 보드가 #lab 그룹을 공유하고, 앱의 2구 스위치 하나가 각 보드의 LED를 제어합니다.
WiFi 공유 스위치ESP-01, D1 mini, ESP32, ESP32-C3#switch 그룹의 상태를 시리얼로 출력하는 가장 간단한 예제입니다. 보드 설정으로 릴레이·버튼 보드가 됩니다.
릴레이와 버튼 제어기
릴레이 보드를 앱으로 켜고 끄거나, 버튼이 달린 다른 보드로 제어합니다. 제어기의 대상 CID와 버튼마다 할 일은 보드 설정이라 펌웨어를 고치지 않고 바꿉니다.
ESP8266 4채널 릴레이ESP-12F 4채널 릴레이 보드릴레이 4개를 relay4 타입 화면으로 제어합니다.
Remocon8266 버튼 제어기Remocon8266 보드 (D1 mini 기반)버튼 5개로 다른 장치(기본: 4채널 릴레이)를 CID로 제어하고 OLED에 상태를 보여 줍니다.
버튼 2개 제어기D1 mini, ESP32, ESP32-C3, ESP32-S3아무 ESP 보드에 버튼 2개를 달아 릴레이·전등·그룹을 제어합니다.
ESP-01 릴레이와 버튼ESP-01 (ESP8266)릴레이와 LED를 2구 스위치로 제어하고, 버튼으로도 릴레이를 켜고 끕니다.
ESP-01 버튼 제어기ESP-01 (ESP8266)버튼 하나로 다른 장치를 제어하고, 내장 LED로 대상의 상태를 보여 줍니다.
iris 보드
같은 iris 보드(ESP32-C3, 내장 RGB LED 4개, 버튼 2개, DIP 스위치)로 하는 다섯 가지 방식입니다. 처음이면 iris 기본부터, 보드 두 대가 있으면 iris-basic 전용 제어기와 짝지어 보세요.
iris 기본iris 보드 (ESP32-C3)내장 RGB LED 4개를 4구 스위치로 켜고 끕니다.
iris-basic 전용 제어기iris 보드 (ESP32-C3)웹앱처럼 iris-basic 보드를 찾아 제어하고, 상대 상태를 자기 LED에 보여 줍니다.
iris 버튼 제어기iris 보드 (ESP32-C3)버튼 2개로 다른 장치를 제어하고 LED 4개에 대상의 채널 상태를 보여 줍니다.
iris RGB 조명iris 보드 (ESP32-C3)LED 4개를 하나씩 색상과 밝기로 제어합니다. iris 전용 화면(iris.2)을 씁니다.
iris 그룹 조명iris 보드 (ESP32-C3) 여러 대여러 보드가 8구 스위치 상태를 공유합니다. DIP 스위치로 그룹과 장치 번호를 정합니다.
브라우저 설치가 없는 예제
- Arduino UNO R4 WiFi 예제(
uno-r4-wifi-heart)는 Arduino IDE로 업로드합니다. 설명은 arduino.iosignal.net에 있습니다. - 장치가 아닌 통신 예제(채널 송수신, 중복 로그인)는 arduino.iosignal.net에 있습니다. 첫 실습은 D1 mini·ESP32-C3 채널 송수신입니다.