/** * @license * Copyright 2022-2026 Matter.js Authors * SPDX-License-Identifier: Apache-2.0 */ /*** THIS FILE IS GENERATED, DO NOT EDIT ***/ import { Resource } from "#models/Resource.js"; Resource.add({ tag: "cluster", name: "OnOff", pics: "OO", xref: "cluster§1.5", details: "Attributes and commands for turning devices on and off.", children: [ { tag: "attribute", name: "FeatureMap", xref: "cluster§1.5.4", children: [ { tag: "field", name: "LT", xref: "cluster§1.5.4.1", details: "This cluster is used for a lighting application." + "\n" + "On receipt of a Level Control cluster command that causes the OnOff attribute to be set to FALSE, " + "the OnTime attribute shall be set to 0." + "\n" + "On receipt of a Level Control cluster command that causes the OnOff attribute to be set to TRUE, if " + "the value of the OnTime attribute is equal to 0, the server shall set the OffWaitTime attribute to " + "0." }, { tag: "field", name: "DF", xref: "cluster§1.5.4.2", details: "When this feature is supported, the device exposing this server cluster exhibits \"dead front\" " + "behavior when the \"OnOff\" attribute is FALSE (Off). This \"dead front\" behavior includes:" + "\n" + " - clusters other than this cluster that are also exposed may respond with failures to Invoke and " + "Write interactions. Such failure responses when in a \"dead front\" shall be with an " + "INVALID_IN_STATE status code." + "\n" + " - clusters other than this cluster may change the values of their attributes to best-effort " + "values, due to the actual values not being defined or available in this state. Device type " + "specifications that require support for the DF feature SHOULD define what these best-effort " + "values are." + "\n" + " - Report Transactions shall continue to be generated. Such transactions may include best-effort " + "values as noted above." + "\n" + " - Event generation logic for clusters other than this cluster is unchanged (noting possible use of " + "best-effort attribute values as in the preceding bullets)." + "\n" + "When this feature is supported and the OnOff attribute changes from TRUE to FALSE (e.g. when " + "receiving an Off Command, or due to a manual interaction on the device), it shall start executing " + "this \"dead front\" behavior." + "\n" + "When this feature is supported and the OnOff attribute changes from FALSE to TRUE (e.g. when " + "receiving an On Command, or due to a manual interaction on the device), it shall stop executing this " + "\"dead front\" behavior." + "\n" + "When this feature is supported, and any change of the \"dead front\" state leads to changes in " + "attributes of other clusters due to the \"dead front\" feature, these attribute changes shall NOT be " + "skipped or omitted from the usual processing associated with attribute changes. For example, if an " + "attribute changes from value 4 to null on \"dead front\" behavior due to an Off command being " + "received, this change shall be processed for reporting and subscriptions." }, { tag: "field", name: "OFFONLY", xref: "cluster§1.5.4.3", details: "When this feature is supported, the Off command shall be supported and the On and Toggle commands " + "shall NOT be supported." + "\n" + "This feature is useful for devices which can be turned off via the Off command received by an " + "instance of this cluster but cannot be turned on via commands received by an instance of this " + "cluster due to regulatory requirements." } ] }, { tag: "attribute", name: "OnOff", xref: "cluster§1.5.6.2", details: "This attribute indicates whether the device type implemented on the endpoint is turned off or turned " + "on, in these cases the value of the OnOff attribute equals FALSE, or TRUE respectively." }, { tag: "attribute", name: "GlobalSceneControl", xref: "cluster§1.5.6.3", details: "In order to support the use case where the user gets back the last setting of a set of devices (e.g. " + "level settings for lights), a global scene is introduced which is stored when the devices are turned " + "off and recalled when the devices are turned on. The global scene is defined as the scene that is " + "stored with group identifier 0 and scene identifier 0." + "\n" + "This attribute is defined in order to prevent a second Off command storing the all-devices-off " + "situation as a global scene, and to prevent a second On command destroying the current settings by " + "going back to the global scene." + "\n" + "This attribute shall be set to TRUE after the reception of a command which causes the OnOff " + "attribute to be set to TRUE, such as a standard On command, a MoveToLevel(WithOnOff) command, a " + "RecallScene command or a OnWithRecallGlobalScene command." + "\n" + "This attribute is set to FALSE after reception of an OffWithEffect command." }, { tag: "attribute", name: "OnTime", xref: "cluster§1.5.6.4", details: "This attribute specifies the length of time (in 1/10ths second) that the On state shall be " + "maintained before automatically transitioning to the Off state when using the OnWithTimedOff " + "command." + "\n" + "This attribute can be written at any time, but writing a value only has an effect when in the Timed " + "On state." + "\n" + "While in the Timed On state, this attribute shall be decremented every 1/10^th second until it " + "reaches 0. See OnWithTimedOff for more details." }, { tag: "attribute", name: "OffWaitTime", xref: "cluster§1.5.6.5", details: "This attribute specifies the length of time (in 1/10ths second) that the Off state shall be guarded " + "to prevent another OnWithTimedOff command turning the server back to its On state (e.g., when " + "leaving a room, the lights are turned off but an occupancy sensor detects the leaving person and " + "attempts to turn the lights back on)." + "\n" + "This attribute can be written at any time, but writing a value only has an effect when in the Timed " + "On state followed by a transition to the Delayed Off state, or in the Delayed Off state." + "\n" + "While in the Off state after a Timed On state, this attribute shall be decremented every 1/10^th " + "second until it reaches 0. See OnWithTimedOff for more details." }, { tag: "attribute", name: "StartUpOnOff", xref: "cluster§1.5.6.6", details: "This attribute shall define the desired startup behavior of a device when it is supplied with power " + "and this state shall be reflected in the OnOff attribute. If the value is null, the OnOff attribute " + "is set to its previous value. Otherwise, the behavior is defined in the table defining " + "StartUpOnOffEnum." + "\n" + "This behavior does not apply to reboots associated with OTA. After an OTA restart, the OnOff " + "attribute shall return to its value prior to the restart." }, { tag: "command", name: "Off", xref: "cluster§1.5.7.1", details: "This command allows devices to be turned off." }, { tag: "command", name: "On", xref: "cluster§1.5.7.2", details: "This command allows devices to be turned on." }, { tag: "command", name: "Toggle", xref: "cluster§1.5.7.3", details: "This command allows devices to be toggled." }, { tag: "command", name: "OffWithEffect", xref: "cluster§1.5.7.4", details: "The OffWithEffect command allows devices to be turned off using enhanced ways of fading.", children: [ { tag: "field", name: "EffectIdentifier", xref: "cluster§1.5.7.4.1", details: "This field specifies the fading effect to use when turning the device off. This field shall contain " + "one of the non-reserved values listed in EffectIdentifierEnum." }, { tag: "field", name: "EffectVariant", xref: "cluster§1.5.7.4.2", details: "This field is used to indicate which variant of the effect, indicated in the EffectIdentifier field, " + "SHOULD be triggered. If the server does not support the given variant, it shall use the default " + "variant. This field is dependent on the value of the EffectIdentifier field and shall contain one of " + "the non-reserved values listed in either DelayedAllOffEffectVariantEnum or " + "DyingLightEffectVariantEnum." } ] }, { tag: "command", name: "OnWithRecallGlobalScene", xref: "cluster§1.5.7.5", details: "This command allows the recall of the settings when the device was turned off." }, { tag: "command", name: "OnWithTimedOff", xref: "cluster§1.5.7.6", details: "This command allows devices to be turned on for a specific duration with a guarded off duration so " + "that SHOULD the device be subsequently turned off, further OnWithTimedOff commands, received during " + "this time, are prevented from turning the devices back on. Further OnWithTimedOff commands received " + "while the server is turned on, will update the period that the device is turned on.", children: [ { tag: "field", name: "OnOffControl", xref: "cluster§1.5.7.6.1", details: "This field contains information on how the server is to be operated." }, { tag: "field", name: "OnTime", xref: "cluster§1.5.7.6.2", details: "This field is used to adjust the value of the OnTime attribute." }, { tag: "field", name: "OffWaitTime", xref: "cluster§1.5.7.6.3", details: "This field is used to adjust the value of the OffWaitTime attribute." } ] }, { tag: "datatype", name: "OnOffControlBitmap", xref: "cluster§1.5.5.1", children: [{ tag: "field", name: "AcceptOnlyWhenOn", description: "Indicates a command is only accepted when in On state." }] }, { tag: "datatype", name: "StartUpOnOffEnum", xref: "cluster§1.5.5.2", children: [ { tag: "field", name: "Off", description: "Set the OnOff attribute to FALSE" }, { tag: "field", name: "On", description: "Set the OnOff attribute to TRUE" }, { tag: "field", name: "Toggle", description: "If the previous value of the OnOff attribute is equal to FALSE, set the OnOff attribute to TRUE. If the previous value of the OnOff attribute is equal to TRUE, set the OnOff attribute to FALSE (toggle)." } ] }, { tag: "datatype", name: "EffectIdentifierEnum", xref: "cluster§1.5.5.3", children: [ { tag: "field", name: "DelayedAllOff", description: "Delayed All Off" }, { tag: "field", name: "DyingLight", description: "Dying Light" } ] }, { tag: "datatype", name: "DelayedAllOffEffectVariantEnum", xref: "cluster§1.5.5.4", children: [ { tag: "field", name: "DelayedOffFastFade", description: "Fade to off in 0.8 seconds" }, { tag: "field", name: "NoFade", description: "No fade" }, { tag: "field", name: "DelayedOffSlowFade", description: "50% dim down in 0.8 seconds then fade to off in 12 seconds" } ] }, { tag: "datatype", name: "DyingLightEffectVariantEnum", xref: "cluster§1.5.5.5", children: [{ tag: "field", name: "DyingLightFadeOff", description: "20% dim up in 0.5s then fade to off in 1 second" }] } ] });