Section 5 Smart Plugs

Section 5: Smart Plugs/Actuators

Matter Specification § 5 - Devices that control power and fluid flow.

---

On/Off Outlet

Property	Value
Device Type	api.matter.deviceTypes.OnOffOutlet
Description	A plug-in unit (smart plug) capable of being switched on or off.
Matter Specification	§ 5.1

OnOff Cluster

Controls the power state of the outlet.

Attributes

Attribute	Type	Range/Values	Description
onOff	boolean	true, false	Power state (true=on, false=off)

Reading State

const isOn = accessory.clusters.onOff.onOff

Handlers

handlers: {
  onOff: {
    /**
     * Called when user turns outlet ON via Home app
     */
    on: async () => {
      // Control your physical device
      await myOutletAPI.turnOn()
      // State automatically updated by Homebridge
    },

    /**
     * Called when user turns outlet OFF via Home app
     */
    off: async () => {
      // Control your physical device
      await myOutletAPI.turnOff()
      // State automatically updated by Homebridge
    },
  },
}