ClusterInstance: MutableCluster<{
    attributes: {
        ballastFactorAdjustment: OptionalWritableAttribute<number | null, any>;
        ballastStatus: OptionalAttribute<TypeFromPartialBitSchema, any>;
        intrinsicBallastFactor: OptionalWritableAttribute<number | null, any>;
        lampAlarmMode: OptionalWritableAttribute<TypeFromPartialBitSchema, any>;
        lampBurnHours: OptionalWritableAttribute<number | null, any>;
        lampBurnHoursTripPoint: OptionalWritableAttribute<number | null, any>;
        lampManufacturer: OptionalWritableAttribute<string, any>;
        lampQuantity: Attribute<number, any>;
        lampRatedHours: OptionalWritableAttribute<number | null, any>;
        lampType: OptionalWritableAttribute<string, any>;
        maxLevel: WritableAttribute<number, any>;
        minLevel: WritableAttribute<number, any>;
        physicalMaxLevel: Attribute<number, any>;
        physicalMinLevel: Attribute<number, any>;
    };
    id: 769;
    name: "BallastConfiguration";
    revision: 4;
}, []>

Type declaration

  • Readonlyattributes: {
        ballastFactorAdjustment: OptionalWritableAttribute<number | null, any>;
        ballastStatus: OptionalAttribute<TypeFromPartialBitSchema, any>;
        intrinsicBallastFactor: OptionalWritableAttribute<number | null, any>;
        lampAlarmMode: OptionalWritableAttribute<TypeFromPartialBitSchema, any>;
        lampBurnHours: OptionalWritableAttribute<number | null, any>;
        lampBurnHoursTripPoint: OptionalWritableAttribute<number | null, any>;
        lampManufacturer: OptionalWritableAttribute<string, any>;
        lampQuantity: Attribute<number, any>;
        lampRatedHours: OptionalWritableAttribute<number | null, any>;
        lampType: OptionalWritableAttribute<string, any>;
        maxLevel: WritableAttribute<number, any>;
        minLevel: WritableAttribute<number, any>;
        physicalMaxLevel: Attribute<number, any>;
        physicalMinLevel: Attribute<number, any>;
    }
    • ReadonlyballastFactorAdjustment: OptionalWritableAttribute<number | null, any>

      This attribute shall specify the multiplication factor, as a percentage, to be applied to the configured light output of the lamps. A typical use for this attribute is to compensate for reduction in efficiency over the lifetime of a lamp.

      The light output is given by

      actual light output = configured light output x BallastFactorAdjustment / 100%

      The range for this attribute is manufacturer dependent. If an attempt is made to set this attribute to a level that cannot be supported, a response shall be returned with status code set to CONSTRAINT_ERROR, and the level shall NOT be changed. The value of null indicates that ballast factor scaling is not in use.

      MatterSpecification.v13.Cluster § 3.3.6.7

    • ReadonlyballastStatus: OptionalAttribute<TypeFromPartialBitSchema, any>

      This attribute shall specify the status of various aspects of the ballast or the connected lights, see BallastStatusBitmap.

      MatterSpecification.v13.Cluster § 3.3.6.3

    • ReadonlyintrinsicBallastFactor: OptionalWritableAttribute<number | null, any>

      This attribute shall specify the ballast factor, as a percentage, of the ballast/lamp combination, prior to any adjustment.

      A value of null indicates in invalid value.

      MatterSpecification.v13.Cluster § 3.3.6.6

    • ReadonlylampAlarmMode: OptionalWritableAttribute<TypeFromPartialBitSchema, any>

      This attribute shall specify which attributes may cause an alarm notification to be generated. Ain each bit position means that its associated attribute is able to generate an alarm.

      NOTE All alarms are also logged in the alarm table – see Alarms cluster.

      MatterSpecification.v13.Cluster § 3.3.6.13

    • ReadonlylampBurnHours: OptionalWritableAttribute<number | null, any>

      This attribute shall specify the length of time, in hours, the currently connected lamps have been operated, cumulative since the last re-lamping. Burn hours shall NOT be accumulated if the lamps are off.

      This attribute SHOULD be reset to zero (e.g., remotely) when the lamps are changed. If partially used lamps are connected, LampBurnHours SHOULD be updated to reflect the burn hours of the lamps.

      A value of null indicates an invalid or unknown time.

      MatterSpecification.v13.Cluster § 3.3.6.12

    • ReadonlylampBurnHoursTripPoint: OptionalWritableAttribute<number | null, any>

      This attribute shall specify the number of hours the LampBurnHours attribute may reach before an alarm is generated.

      If the Alarms cluster is not present on the same device this attribute is not used and thus may be omitted (see Dependencies).

      The Alarm Code field included in the generated alarm shall be 0x01.

      If this attribute has the value of null, then this alarm shall NOT be generated.

      MatterSpecification.v13.Cluster § 3.3.6.14

    • ReadonlylampManufacturer: OptionalWritableAttribute<string, any>

      This attribute shall specify the name of the manufacturer of the currently connected lamps.

      MatterSpecification.v13.Cluster § 3.3.6.10

    • ReadonlylampQuantity: Attribute<number, any>

      This attribute shall specify the number of lamps connected to this ballast. (Note 1: this number does not take into account whether lamps are actually in their sockets or not).

      MatterSpecification.v13.Cluster § 3.3.6.8

    • ReadonlylampRatedHours: OptionalWritableAttribute<number | null, any>

      This attribute shall specify the number of hours of use the lamps are rated for by the manufacturer.

      A value of null indicates an invalid or unknown time.

      MatterSpecification.v13.Cluster § 3.3.6.11

    • ReadonlylampType: OptionalWritableAttribute<string, any>

      This attribute shall specify the type of lamps (including their wattage) connected to the ballast.

      MatterSpecification.v13.Cluster § 3.3.6.9

    • ReadonlymaxLevel: WritableAttribute<number, any>

      This attribute shall specify the light output of the ballast according to the dimming light curve

      (see Dimming Curve) when the Level Control Cluster’s CurrentLevel attribute equals to 254 (and the On/Off Cluster’s OnOff attribute equals to TRUE).

      The value of this attribute shall be both less than or equal to PhysicalMaxLevel and greater than or equal to MinLevel. If an attempt is made to set this attribute to a level where these conditions are not met, a response shall be returned with status code set to CONSTRAINT_ERROR, and the level shall NOT be set.

      MatterSpecification.v13.Cluster § 3.3.6.5

    • ReadonlyminLevel: WritableAttribute<number, any>

      This attribute shall specify the light output of the ballast according to the dimming light curve (see Dimming Curve) when the Level Control Cluster’s CurrentLevel attribute equals to 1 (and the On/Off Cluster’s OnOff attribute equals to TRUE).

      The value of this attribute shall be both greater than or equal to PhysicalMinLevel and less than or equal to MaxLevel. If an attempt is made to set this attribute to a level where these conditions are not met, a response shall be returned with status code set to CONSTRAINT_ERROR, and the level shall NOT be set.

      MatterSpecification.v13.Cluster § 3.3.6.4

    • ReadonlyphysicalMaxLevel: Attribute<number, any>

      This attribute shall specify the maximum light output the ballast can achieve according to the dimming light curve (see Dimming Curve).

      MatterSpecification.v13.Cluster § 3.3.6.2

    • ReadonlyphysicalMinLevel: Attribute<number, any>

      This attribute shall specify the minimum light output the ballast can achieve according to the dimming light curve (see Dimming Curve).

      MatterSpecification.v13.Cluster § 3.3.6.1

  • Readonlyid: 769
  • Readonlyname: "BallastConfiguration"
  • Readonlyrevision: 4