Skip to main content

Device types

When a device sends t=<name>.<major> to <cid>@$ui, apps (app.iosignal.net, remocon.kr, IOSignal Desktop, the Android apps and others) draw that type's screen and default picture. A type also fixes the meaning of the state keys ($state) and commands, so devices of the same type are controlled the same way in every app. The full rules are in Build a device (app.iosignal.net compatible).

The type files come from the IOSignal package, iosignal/devices/types (this page follows iosignal 9.23.0). The major number (.1, .2) changes only when compatibility breaks; compatible changes raise the file's rev.

TypeDescriptionExamples
Light
light.1
A light, relay or single LED that only turns on and off.d1-mini-led-button, uno-ethernet-button, uno-ethernet-ir, uno-r4-wifi-heart
Dimmer
dimmer.1
A light with on/off and 0–100% brightness.—
RGB light
rgb-light.1
A color light with on/off, brightness and color.—
4-channel relay
relay4.1
A board whose four relays turn on and off one by one or all together.esp8266-relay4ch
Fan
fan.1
A fan with on/off, speed 1–10 and swing.—
Thermo-hygrometer
thermo-hygrometer.1
A sensor that shows temperature and humidity. The app sends no commands.—
Media remote
media-remote.1
A remote screen that sends play/pause, previous/next and arrow keys.—
2 switches
switch2.1
Two switches.esp01-relay-button, esp32-group-led
3 switches
switch3.1
Three switches.wifi-simple, Remocon8266-basic, Remocon8266-scanner
4 switches
switch4.1
Four switches.iris-basic
8 switches
switch8.1
Eight switches.iris-group
iris light (v1)
iris.1
On/off, brightness and color (#rrggbb) of the four RGB LEDs on the iris board. Replaced by iris.2.—
iris light
iris.2
Hue and brightness of the four RGB LEDs on the iris board. Brightness 0 means off.iris-rgb
Camera
camera.1
A camera that keeps sending photos (JPEG). The app card shows the latest photo.esp32cam
Camera (session)
camera-session.1
A camera whose photos only one card can open. The card and the device agree on a new session key and use it for each photo.esp32cam-session