Connect GPIO devices
Wire simple sensors and actuators straight to a gateway's pins. There are four GPIO protocols:
Digital input — gpio-digital-in
Reads a high/low signal (button, contact, level switch).
| Field | Meaning |
|---|---|
pinNumber |
Gateway pin |
activeHigh |
Treat HIGH as the "on" state |
pullMode |
up, down, or float |
sampleIntervalMs |
Read interval (ms) |
Digital output — gpio-digital-out
Drives a pin high/low (relay, LED).
| Field | Meaning |
|---|---|
pinNumber, activeHigh |
Pin + polarity |
defaultState |
0 or 1 at boot |
Analog input — gpio-analog
Reads an ADC voltage (potentiometer, 0–3.3 V sensor).
| Field | Meaning |
|---|---|
pinNumber |
ADC-capable pin |
adcAttenuation |
0db, 2.5db, 6db, 11db (input range) |
sampleIntervalMs |
Read interval (ms) |
PWM output — gpio-pwm
Drives a PWM signal (dimming, motor speed).
| Field | Meaning |
|---|---|
pinNumber, frequencyHz |
Pin + PWM frequency |
defaultDuty |
Default duty cycle |
Add a device with the matching protocol, pick the gateway, set the pin fields, and add tags. gpio/fault events indicate a pin conflict or out-of-range value.