Read an analog sensor (ADC)

For a sensor that outputs a varying voltage (potentiometer, 4–20 mA via a shunt, 0–3.3 V probe):

  1. Add a device with protocol gpio-analog, pick the gateway, and set:
    • pinNumber (an ADC-capable pin),
    • adcAttenuation to match your input range (0db ≈ up to ~1.1 V … 11db ≈ up to ~3.3 V),
    • sampleIntervalMs.
  2. On the tag, add scaling/offset to convert the raw ADC reading into engineering units (e.g. volts → bar).
  3. Visualize with a gauge and set min/max for nice thresholds.

Pick the smallest attenuation that still covers your signal for the best resolution.

More in Devices
Devices vs. gateways
When you need a gateway, and when a device can talk to us directly.
Device parameters (tags) explained
Tags are the named measurements a device reports — what widgets bind to.
How device online/offline status works
A device is online if we've seen a message in the last 90 seconds.
Alert thresholds (and the yellow dot)
Set a high/low range on a tag; the device dot turns yellow when a reading goes out of range.
Why a device gets suspended
Repeated rate-limit violations suspend a device temporarily — here's the cycle.
Editing, moving, and deleting a device
Change a device's name, connection settings, gateway, or remove it.