Skip to Content
🚀 We just launched! Please star us on Github!

Valve Channel

Channel Category: valve

Controls fluid or gas valves, managing open/close states or flow rates.


Required Properties

PropertyData TypeRangeUnitPermissions
onBooltrue/false-RW (Read/Write)
typeEnumgeneric/irrigation/shower_head/water_faucet-RO (Read-Only)

Property Details

on

Indicates whether the valve is open or closed:

  • true: The valve is open, allowing water to flow.
  • false: The valve is closed, stopping the flow of water.

type

Specifies the type of valve being controlled:

  • Possible values:
    • generic: A general-purpose valve.
    • irrigation: A valve used in irrigation systems.
    • shower_head: A valve integrated into a shower head.
    • water_faucet: A valve associated with a water faucet.

Optional Properties

PropertyData TypeRangeUnitPermissions
durationUshort0–3600sRW (Read/Write)
remainingUshort0–3600sRO (Read-Only)
modeEnummanual/scheduled-RW (Read/Write)
faultUchar0–255-RO (Read-Only)

Property Details

duration

Specifies the duration for which the valve should remain open:

  • Measured in seconds (s).
  • Example: duration = 300 keeps the valve open for 5 minutes.

remaining

Indicates the time remaining before the valve automatically closes:

  • Measured in seconds (s).
  • Example: If remaining = 120, the valve will close in 2 minutes.

mode

Specifies how the valve is being operated:

  • Possible values:
    • manual: The valve is controlled directly by the user.
    • scheduled: The valve is controlled according to a predefined schedule.

fault

Represents the fault state of the actor:

  • 0: No fault detected.
  • Non-zero: A fault has been detected, potentially affecting functionality.
Last updated on