A Dimmable Light is a lighting device that is capable of being switched on or off and the intensity of its light adjusted by means of a bound controller device such as a Dimmer Switch or a Color Dimmer Switch. In addition, a Dimmable Light device is also capable of being switched by means of a bound occupancy sensor or other device(s).

MatterSpecification.v13.Device § 4.2

interface DimmableLightDevice {
    behaviors: {
        identify: Type<WithAlterations<Identify.Cluster, {
            commands: {
                triggerEffect: {
                    optional: false;
                };
            };
        }>, typeof IdentifyServer, IdentifyInterface>;
    } & {
        groups: typeof GroupsServer;
    } & {
        onOff: Type<WithFeatures<WithFeatures<OnOff.Cluster, readonly [Lighting]>, readonly ["Lighting"]>, typeof OnOffServer, OnOffInterface>;
    } & {
        levelControl: Type<WithAlterations<WithFeatures<WithFeatures<WithFeatures<LevelControl.Cluster, readonly [OnOff, Lighting]>, readonly [OnOff]>, readonly ["Lighting", "OnOff"]>, {
            attributes: {
                currentLevel: {
                    max: 254;
                    min: 1;
                };
                maxLevel: {
                    default: 254;
                    max: 255;
                    min: 254;
                };
                minLevel: {
                    default: 1;
                    max: 2;
                    min: 1;
                };
            };
        }>, Type<WithFeatures<WithFeatures<WithFeatures<LevelControl.Cluster, readonly [OnOff, Lighting]>, readonly [OnOff]>, readonly ["Lighting", "OnOff"]>, typeof LevelControlServer, LevelControlInterface>, LevelControlInterface>;
    } & {
        identify: Type<WithAlterations<Identify.Cluster, {
            commands: {
                triggerEffect: {
                    optional: false;
                };
            };
        }>, typeof IdentifyServer, IdentifyInterface>;
    } & {
        groups: typeof GroupsServer;
    } & {
        onOff: Type<WithFeatures<WithFeatures<OnOff.Cluster, readonly [Lighting]>, readonly ["Lighting"]>, typeof OnOffServer, OnOffInterface>;
    } & {
        levelControl: Type<WithAlterations<WithFeatures<WithFeatures<WithFeatures<LevelControl.Cluster, readonly [OnOff, Lighting]>, readonly [OnOff]>, readonly ["Lighting", "OnOff"]>, {
            attributes: {
                currentLevel: {
                    max: 254;
                    min: 1;
                };
                maxLevel: {
                    default: 254;
                    max: 255;
                    min: 254;
                };
                minLevel: {
                    default: 1;
                    max: 2;
                    min: 1;
                };
            };
        }>, Type<WithFeatures<WithFeatures<WithFeatures<LevelControl.Cluster, readonly [OnOff, Lighting]>, readonly [OnOff]>, readonly ["Lighting", "OnOff"]>, typeof LevelControlServer, LevelControlInterface>, LevelControlInterface>;
    };
    defaults: StateOf<{
        identify: Type<WithAlterations<Identify.Cluster, {
            commands: {
                triggerEffect: {
                    optional: false;
                };
            };
        }>, typeof IdentifyServer, IdentifyInterface>;
    } & {
        groups: typeof GroupsServer;
    } & {
        onOff: Type<WithFeatures<WithFeatures<OnOff.Cluster, readonly [Lighting]>, readonly ["Lighting"]>, typeof OnOffServer, OnOffInterface>;
    } & {
        levelControl: Type<WithAlterations<WithFeatures<WithFeatures<WithFeatures<LevelControl.Cluster, readonly [OnOff, Lighting]>, readonly [OnOff]>, readonly ["Lighting", "OnOff"]>, {
            attributes: {
                currentLevel: {
                    max: 254;
                    min: 1;
                };
                maxLevel: {
                    default: 254;
                    max: 255;
                    min: 254;
                };
                minLevel: {
                    default: 1;
                    max: 2;
                    min: 1;
                };
            };
        }>, Type<WithFeatures<WithFeatures<WithFeatures<LevelControl.Cluster, readonly [OnOff, Lighting]>, readonly [OnOff]>, readonly ["Lighting", "OnOff"]>, typeof LevelControlServer, LevelControlInterface>, LevelControlInterface>;
    }>;
    deviceClass: DeviceClassification;
    deviceRevision: number;
    deviceType: DeviceTypeId;
    name: "DimmableLight";
    requirements: typeof DimmableLightRequirements;
    set(defaults: InputStateOf<{
        identify: Type<WithAlterations<Identify.Cluster, {
            commands: {
                triggerEffect: {
                    optional: false;
                };
            };
        }>, typeof IdentifyServer, IdentifyInterface>;
    } & {
        groups: typeof GroupsServer;
    } & {
        onOff: Type<WithFeatures<WithFeatures<OnOff.Cluster, readonly [Lighting]>, readonly ["Lighting"]>, typeof OnOffServer, OnOffInterface>;
    } & {
        levelControl: Type<WithAlterations<WithFeatures<WithFeatures<WithFeatures<LevelControl.Cluster, readonly [OnOff, Lighting]>, readonly [OnOff]>, readonly ["Lighting", "OnOff"]>, {
            attributes: {
                currentLevel: {
                    max: 254;
                    min: 1;
                };
                maxLevel: {
                    default: 254;
                    max: 255;
                    min: 254;
                };
                minLevel: {
                    default: 1;
                    max: 2;
                    min: 1;
                };
            };
        }>, Type<WithFeatures<WithFeatures<WithFeatures<LevelControl.Cluster, readonly [OnOff, Lighting]>, readonly [OnOff]>, readonly ["Lighting", "OnOff"]>, typeof LevelControlServer, LevelControlInterface>, LevelControlInterface>;
    }>): With<For<{
        behaviors: {
            identify: Type<WithAlterations<Identify.Cluster, {
                commands: {
                    triggerEffect: {
                        optional: false;
                    };
                };
            }>, typeof IdentifyServer, IdentifyInterface>;
        } & {
            groups: typeof GroupsServer;
        } & {
            onOff: Type<WithFeatures<WithFeatures<OnOff.Cluster, readonly [Lighting]>, readonly ["Lighting"]>, typeof OnOffServer, OnOffInterface>;
        } & {
            levelControl: Type<WithAlterations<WithFeatures<WithFeatures<WithFeatures<LevelControl.Cluster, readonly [(...), (...)]>, readonly [OnOff]>, readonly ["Lighting", "OnOff"]>, {
                attributes: {
                    currentLevel: {
                        max: 254;
                        min: 1;
                    };
                    maxLevel: {
                        default: 254;
                        max: 255;
                        min: 254;
                    };
                    minLevel: {
                        default: 1;
                        max: 2;
                        min: 1;
                    };
                };
            }>, Type<WithFeatures<WithFeatures<WithFeatures<LevelControl.Cluster, readonly [(...), (...)]>, readonly [OnOff]>, readonly ["Lighting", "OnOff"]>, typeof LevelControlServer, LevelControlInterface>, LevelControlInterface>;
        };
        deviceRevision: 3;
        deviceType: 257;
        name: "DimmableLight";
        requirements: typeof DimmableLightRequirements;
    }>, {
        identify: Type<WithAlterations<Identify.Cluster, {
            commands: {
                triggerEffect: {
                    optional: false;
                };
            };
        }>, typeof IdentifyServer, IdentifyInterface>;
    } & {
        groups: typeof GroupsServer;
    } & {
        onOff: Type<WithFeatures<WithFeatures<OnOff.Cluster, readonly [Lighting]>, readonly ["Lighting"]>, typeof OnOffServer, OnOffInterface>;
    } & {
        levelControl: Type<WithAlterations<WithFeatures<WithFeatures<WithFeatures<LevelControl.Cluster, readonly [OnOff, Lighting]>, readonly [OnOff]>, readonly ["Lighting", "OnOff"]>, {
            attributes: {
                currentLevel: {
                    max: 254;
                    min: 1;
                };
                maxLevel: {
                    default: 254;
                    max: 255;
                    min: 254;
                };
                minLevel: {
                    default: 1;
                    max: 2;
                    min: 1;
                };
            };
        }>, Type<WithFeatures<WithFeatures<WithFeatures<LevelControl.Cluster, readonly [OnOff, Lighting]>, readonly [OnOff]>, readonly ["Lighting", "OnOff"]>, typeof LevelControlServer, LevelControlInterface>, LevelControlInterface>;
    }>;
    with<const BL>(...behaviors: BL): With<For<{
        behaviors: {
            identify: Type<WithAlterations<Identify.Cluster, {
                commands: {
                    triggerEffect: {
                        optional: false;
                    };
                };
            }>, typeof IdentifyServer, IdentifyInterface>;
        } & {
            groups: typeof GroupsServer;
        } & {
            onOff: Type<WithFeatures<WithFeatures<OnOff.Cluster, readonly [Lighting]>, readonly ["Lighting"]>, typeof OnOffServer, OnOffInterface>;
        } & {
            levelControl: Type<WithAlterations<WithFeatures<WithFeatures<WithFeatures<LevelControl.Cluster, readonly [(...), (...)]>, readonly [OnOff]>, readonly ["Lighting", "OnOff"]>, {
                attributes: {
                    currentLevel: {
                        max: 254;
                        min: 1;
                    };
                    maxLevel: {
                        default: 254;
                        max: 255;
                        min: 254;
                    };
                    minLevel: {
                        default: 1;
                        max: 2;
                        min: 1;
                    };
                };
            }>, Type<WithFeatures<WithFeatures<WithFeatures<LevelControl.Cluster, readonly [(...), (...)]>, readonly [OnOff]>, readonly ["Lighting", "OnOff"]>, typeof LevelControlServer, LevelControlInterface>, LevelControlInterface>;
        };
        deviceRevision: 3;
        deviceType: 257;
        name: "DimmableLight";
        requirements: typeof DimmableLightRequirements;
    }>, With<{
        identify: Type<WithAlterations<Identify.Cluster, {
            commands: {
                triggerEffect: {
                    optional: false;
                };
            };
        }>, typeof IdentifyServer, IdentifyInterface>;
    } & {
        groups: typeof GroupsServer;
    } & {
        onOff: Type<WithFeatures<WithFeatures<OnOff.Cluster, readonly [Lighting]>, readonly ["Lighting"]>, typeof OnOffServer, OnOffInterface>;
    } & {
        levelControl: Type<WithAlterations<WithFeatures<WithFeatures<WithFeatures<LevelControl.Cluster, readonly [OnOff, Lighting]>, readonly [OnOff]>, readonly ["Lighting", "OnOff"]>, {
            attributes: {
                currentLevel: {
                    max: 254;
                    min: 1;
                };
                maxLevel: {
                    default: 254;
                    max: 255;
                    min: 254;
                };
                minLevel: {
                    default: 1;
                    max: 2;
                    min: 1;
                };
            };
        }>, Type<WithFeatures<WithFeatures<WithFeatures<LevelControl.Cluster, readonly [OnOff, Lighting]>, readonly [OnOff]>, readonly ["Lighting", "OnOff"]>, typeof LevelControlServer, LevelControlInterface>, LevelControlInterface>;
    }, BL>>;
}

Hierarchy (view full)

Properties

behaviors: {
    identify: Type<WithAlterations<Identify.Cluster, {
        commands: {
            triggerEffect: {
                optional: false;
            };
        };
    }>, typeof IdentifyServer, IdentifyInterface>;
} & {
    groups: typeof GroupsServer;
} & {
    onOff: Type<WithFeatures<WithFeatures<OnOff.Cluster, readonly [Lighting]>, readonly ["Lighting"]>, typeof OnOffServer, OnOffInterface>;
} & {
    levelControl: Type<WithAlterations<WithFeatures<WithFeatures<WithFeatures<LevelControl.Cluster, readonly [OnOff, Lighting]>, readonly [OnOff]>, readonly ["Lighting", "OnOff"]>, {
        attributes: {
            currentLevel: {
                max: 254;
                min: 1;
            };
            maxLevel: {
                default: 254;
                max: 255;
                min: 254;
            };
            minLevel: {
                default: 1;
                max: 2;
                min: 1;
            };
        };
    }>, Type<WithFeatures<WithFeatures<WithFeatures<LevelControl.Cluster, readonly [OnOff, Lighting]>, readonly [OnOff]>, readonly ["Lighting", "OnOff"]>, typeof LevelControlServer, LevelControlInterface>, LevelControlInterface>;
} & {
    identify: Type<WithAlterations<Identify.Cluster, {
        commands: {
            triggerEffect: {
                optional: false;
            };
        };
    }>, typeof IdentifyServer, IdentifyInterface>;
} & {
    groups: typeof GroupsServer;
} & {
    onOff: Type<WithFeatures<WithFeatures<OnOff.Cluster, readonly [Lighting]>, readonly ["Lighting"]>, typeof OnOffServer, OnOffInterface>;
} & {
    levelControl: Type<WithAlterations<WithFeatures<WithFeatures<WithFeatures<LevelControl.Cluster, readonly [OnOff, Lighting]>, readonly [OnOff]>, readonly ["Lighting", "OnOff"]>, {
        attributes: {
            currentLevel: {
                max: 254;
                min: 1;
            };
            maxLevel: {
                default: 254;
                max: 255;
                min: 254;
            };
            minLevel: {
                default: 1;
                max: 2;
                min: 1;
            };
        };
    }>, Type<WithFeatures<WithFeatures<WithFeatures<LevelControl.Cluster, readonly [OnOff, Lighting]>, readonly [OnOff]>, readonly ["Lighting", "OnOff"]>, typeof LevelControlServer, LevelControlInterface>, LevelControlInterface>;
}
defaults: StateOf<{
    identify: Type<WithAlterations<Identify.Cluster, {
        commands: {
            triggerEffect: {
                optional: false;
            };
        };
    }>, typeof IdentifyServer, IdentifyInterface>;
} & {
    groups: typeof GroupsServer;
} & {
    onOff: Type<WithFeatures<WithFeatures<OnOff.Cluster, readonly [Lighting]>, readonly ["Lighting"]>, typeof OnOffServer, OnOffInterface>;
} & {
    levelControl: Type<WithAlterations<WithFeatures<WithFeatures<WithFeatures<LevelControl.Cluster, readonly [OnOff, Lighting]>, readonly [OnOff]>, readonly ["Lighting", "OnOff"]>, {
        attributes: {
            currentLevel: {
                max: 254;
                min: 1;
            };
            maxLevel: {
                default: 254;
                max: 255;
                min: 254;
            };
            minLevel: {
                default: 1;
                max: 2;
                min: 1;
            };
        };
    }>, Type<WithFeatures<WithFeatures<WithFeatures<LevelControl.Cluster, readonly [OnOff, Lighting]>, readonly [OnOff]>, readonly ["Lighting", "OnOff"]>, typeof LevelControlServer, LevelControlInterface>, LevelControlInterface>;
}>

Access default state values.

deviceRevision: number
deviceType: DeviceTypeId
name
requirements: typeof DimmableLightRequirements

Methods