Skip to main content

Get started with Arduino

Connect boards such as ESP8266 and ESP32 to an IOSignal server and exchange signals with web apps, other boards and Node.js. If you are new, read core concepts in five minutes first; tags, delivery types and the home channel are the same in every environment.

UseWhat it doesWhere to start
MessagingChannel and CID messaging, authentication and encryptionIOSignal for Arduino, D1 mini and ESP32-C3 channel messaging, arduino.iosignal.net
DevicesDevices the remocon.kr web app finds and controls (name, buttons, state)The examples below, Build a device (app.iosignal.net compatible), arduino.iosignal.net

Both are in one library, IOSignal. Since 9.23.0 the device examples and the device helper headers (IOSignalUi.h and others) are in IOSignal too; before that they were in the Remocon library.

1. Install​

Install IOSignal (9.23.0 or later) from the Arduino IDE Library Manager. The steps are in library installation. To see something working before touching code, flash firmware with install from the browser below.

2. First connection​

Upload D1 mini and ESP32-C3 channel messaging. Pressing the button sends a signal on the #homeButton channel, and receiving one toggles the LED. Enter Wi-Fi on the board settings page with the board on USB.

3. What differs on Arduino​

  • One receive callback: every signal arrives in onMessage(tag, type, payload, size); compare tag to tell them apart. There is no JS-style on() or listen().
  • Subscribe in onReady: onReady runs on every connection, reconnections included. Put subscriptions and the first announcements there.
  • TCP: boards connect to the server's TCP port (io.iosignal.net:55488 on the public server), not to WebSocket. Do not put ws:// in the host. Connections
  • Receive buffer: 80 bytes by default. The server does not send larger messages to the board. To receive long messages such as other devices' names and state, enlarge it with setRxBuffer() before begin().
  • Board settings: ESP examples take Wi-Fi, server and device key from a browser over USB, and the board stores them. Board settings
  • Authentication: logging in with a device key gives a fixed CID. When the same key logs in elsewhere and replaces this board, the library stops. Authentication clear and logs

4. Build guides​

What you want to buildPages
Boards and the web exchanging channel signalsD1 mini and ESP32-C3 channel messaging, tags and delivery types
A device the remocon.kr app finds and controlsBuild a device (app.iosignal.net compatible)
Relays controlled by buttons on other boardsDevice setup example: relays and button controllers
Binary data and numbers with JSPayload formats and JS–Arduino compatibility
Logging in with a device keyIOSignal for Arduino, server authentication
Looking up methods, callbacks and constantsArduino API

5. Examples: install from the browser​

ESP example pages on arduino.iosignal.net carry prebuilt firmware. You need only a USB cable and a browser, no Arduino IDE. The site is in Korean.

  1. Open the example page in desktop Chrome or Edge (Web Serial is required; iOS is not supported).
  2. Connect the board over USB, press the install button in the firmware section and choose the port.
  3. When the install finishes, enter the 2.4 GHz Wi-Fi name and password in the window that follows. To change them later, use the board settings page.
  4. Open remocon.kr on a phone or PC on the same router, and the device card appears.
  • The firmware holds no Wi-Fi password or device key and connects with an anonymous CID. A device key and server can be set in the board settings (board settings).
  • If the board already runs firmware with IOSignal board settings, the install is an update and the stored Wi-Fi stays.
  • Close the serial monitor first if it holds the port.
  • The same sketches are in the Arduino IDE under File → Examples → IOSignal.

Each card opens the example page on arduino.iosignal.net (wiring, signal flow, firmware install, web control screen). "Not tested on hardware" marks an example whose description was written from the code and not yet checked on a real board.

One board, one card​

One board becomes one device card in the app. Start here to see how discovery, commands and state flow.

Groups​

Several boards share one state. The app shows one group card however many boards there are.

Relays and button controllers​

Switch a relay board from the app, or control it from another board with buttons. A controller's target CID and what each button does are board settings, so they change without new firmware.

iris board​

Five ways to use the same iris board (ESP32-C3, four built-in RGB LEDs, two buttons, DIP switches). Start with iris basic; with two boards, pair it with the iris-basic controller.

Examples without browser install​

6. When you are stuck​