Skip to main content

Contact Input — contact v1

A single dry-contact sense input. Devices with a bank of inputs expose one binding per input. Consumed by drivers that declare a contact control connection — a garage door driver reading its own limit switch, for example — and usable directly as an automation trigger.

Capabilities

Declared in the driver manifest under [[proxy]] capabilities. Anything not declared takes the default below.

CapabilityTypeDefaultMeaning
has_debounceboolfalseDebounce interval is configurable
supports_voltage_senseboolfalseReports analog voltage as well as open/closed
voltage_max_mvu320

Commands

set_debounce

Only present when has_debounce is declared true.

ParameterTypeNotes
msu32 0–10000

Notifications

contact_changed

ParameterTypeNotes
closedbool

online_changed

ParameterTypeNotes
onlinebool

voltage_changed

Only present when supports_voltage_sense is declared true.

ParameterTypeNotes
mvu32

State

Last-known values core keeps for a binding of this proxy.

KeyTypeMeaning
closedbool
mvu32
onlinebool