본문으로 건너뛰기

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 케이블과 브라우저만 있으면 됩니다.

  1. 데스크톱 Chrome이나 Edge로 예제 페이지를 엽니다(Web Serial이 필요합니다. iOS는 지원하지 않습니다).
  2. 보드를 USB로 연결하고 펌웨어 설치의 "이 보드에 설치"를 누른 뒤 포트를 고릅니다.
  3. 설치가 끝나면 이어지는 창에 2.4GHz Wi-Fi 이름과 비밀번호를 넣습니다. 나중에 바꿀 때는 보드 설정 페이지를 씁니다.
  4. 같은 공유기에 연결한 휴대폰이나 PC에서 remocon.kr을 열면 장치 카드가 나타납니다.
  • 펌웨어에는 Wi-Fi 비밀번호나 장치 키가 들어 있지 않으며 익명 CID로 접속합니다. 장치 키와 서버는 보드 설정에서 넣을 수 있습니다(보드 설정).
  • 이미 IOSignal 보드 설정을 쓰는 펌웨어가 있으면 업데이트로 설치되어 저장된 Wi-Fi가 남습니다.
  • 시리얼 모니터가 포트를 쓰고 있으면 먼저 닫으세요.
  • 같은 예제의 스케치는 Arduino IDE의 파일 > 예제 > IOSignal에도 있습니다.

카드를 누르면 arduino.iosignal.net의 예제 페이지(배선, 신호 흐름, 펌웨어 설치, 웹 제어 화면)로 갑니다. "실물 미확인"은 코드를 보고 쓴 설명으로, 아직 실제 보드로 확인하지 않은 예제입니다.

보드 한 대, 카드 하나​

보드 한 대가 앱의 장치 카드 하나가 되는 기본 형태입니다. 장치 검색, 명령, 상태가 오가는 흐름을 보려면 여기서 시작하세요.

그룹으로 묶기​

여러 보드가 하나의 상태를 함께 씁니다. 앱에는 보드 수와 상관없이 그룹 카드 하나가 나옵니다.

릴레이와 버튼 제어기​

릴레이 보드를 앱으로 켜고 끄거나, 버튼이 달린 다른 보드로 제어합니다. 제어기의 대상 CID와 버튼마다 할 일은 보드 설정이라 펌웨어를 고치지 않고 바꿉니다.

iris 보드​

같은 iris 보드(ESP32-C3, 내장 RGB LED 4개, 버튼 2개, DIP 스위치)로 하는 다섯 가지 방식입니다. 처음이면 iris 기본부터, 보드 두 대가 있으면 iris-basic 전용 제어기와 짝지어 보세요.

브라우저 설치가 없는 예제​

6. 막혔을 때​