LevelComponent: {
    attributes: {
        currentLevel: Attribute<number | null, any>;
        defaultOpenLevel: OptionalWritableAttribute<number, any>;
        levelStep: OptionalFixedAttribute<number, any>;
        targetLevel: Attribute<number | null, any>;
    };
}

A ValveConfigurationAndControlCluster supports these elements if it supports feature Level.

Type declaration

  • Readonlyattributes: {
        currentLevel: Attribute<number | null, any>;
        defaultOpenLevel: OptionalWritableAttribute<number, any>;
        levelStep: OptionalFixedAttribute<number, any>;
        targetLevel: Attribute<number | null, any>;
    }
    • ReadonlycurrentLevel: Attribute<number | null, any>

      Indicates the current level of the valve as a percentage value, between fully closed and fully open. During a transition from one level to another level, the valve SHOULD keep this attribute updated to the best of its ability, in order to represent the actual level of the valve during the movement.

      A value of 100 percent shall indicate the fully open position. A value of 0 percent shall indicate the fully closed position.

      A value of null shall indicate that the current state is not known.

      MatterSpecification.v13.Cluster § 4.6.7.7

    • ReadonlydefaultOpenLevel: OptionalWritableAttribute<number, any>

      Indicates the default value used for the TargetLevel attribute, when a valve transitions from the closed to the open state, caused by an Open command, if a TargetLevel field is not present in the Open command.

      If the LevelStep attribute is present and the value of a write interaction to this attribute field is not 100, the value shall be a supported value as defined by the LevelStep attribute, such that (Value received in the write interaction) % (Value of LevelStep attribute) equals 0. If the resulting value is not 0, the requested DefaultOpenLevel value is considered an unsupported value and a CONSTRAINT_ERROR status shall be returned.

      MatterSpecification.v13.Cluster § 4.6.7.9

    • ReadonlylevelStep: OptionalFixedAttribute<number, any>

      Indicates the step size the valve can support.

      The step size defined by this attribute is counted from 0 and the final step towards 100 may be different than what is defined in this attribute. For example, if the value of this attribute is 15, it results in these target values being supported; 0, 15, 30, 45, 60, 75, 90 and 100.

      The values of 0 and 100 shall always be supported, regardless of the value of this attribute.

      MatterSpecification.v13.Cluster § 4.6.7.11

    • ReadonlytargetLevel: Attribute<number | null, any>

      Indicates the target level of the valve as a percentage value, between fully closed and fully open.

      The interpretation of the percentage value is the same as for the CurrentLevel attribute.

      A value of null shall indicate that no target position is set, since the change of level is either done or failed.

      MatterSpecification.v13.Cluster § 4.6.7.8