#![cfg(all(feature = "std", feature = "rustcrypto"))]
#![allow(clippy::unwrap_used, clippy::expect_used, clippy::indexing_slicing)]
use matter_kit::clusters::generated::device_types::{
DIMMABLE_LIGHT, ON_OFF_LIGHT, ON_OFF_LIGHT_SWITCH, ROOT_NODE,
};
use matter_kit::clusters::groups::{self, Groups, NeverIdentifying};
use matter_kit::clusters::identify::Identify;
use matter_kit::clusters::level_control::{self, LevelControl, LevelControlHooks, NoOnOff};
use matter_kit::clusters::on_off::{self, EffectIdentifierEnum, OnOff, OnOffHooks};
use matter_kit::clusters::scenes::{self, ExtensionFieldSetStruct, SceneHooks, SceneTable, Scenes};
use matter_kit::clusters::{descriptor, validate_endpoint};
use matter_kit::dm::device::DeviceType as Spec;
use matter_kit::dm::spec::Optional;
use matter_kit::dm::{DeviceType, Endpoint};
use matter_kit::tlv::{TlvList, TlvWriter};
#[derive(Debug, Default)]
struct Lamp;
impl OnOffHooks for Lamp {
fn set(&self, _on: bool) {}
fn off_with_effect(&self, _effect: EffectIdentifierEnum, _variant: u8) {}
}
impl matter_kit::clusters::identify::IdentifyHooks for Lamp {
fn identifying(&self, _on: bool) {}
}
impl LevelControlHooks for Lamp {
fn level(&self, _level: Option<u8>) {}
}
impl SceneHooks for Lamp {
fn capture(&self, _w: &mut TlvWriter<'_>) -> matter_kit::error::Result<()> {
Ok(())
}
fn apply<'a>(&self, _sets: TlvList<'a, ExtensionFieldSetStruct<'a>>, _transition: u32) {}
}
type Table = SceneTable<16, 128, 5>;
type Lamps<'a> = Scenes<'a, Lamp, Groups<'a, 16, NeverIdentifying, Table>, 16, 128, 5>;
fn defects(endpoint: &Endpoint<'_>, device_type: &Spec) -> Vec<String> {
let mut found = Vec::new();
validate_endpoint(endpoint, device_type, |defect| {
found.push(format!("{defect:?}"));
});
found
}
#[test]
fn the_light_example_furnishes_the_on_off_light_it_claims() {
let identify = Identify::<Lamp>::conforming(&Identify::<Lamp>::WITH_TRIGGER_EFFECT).unwrap();
let group = Groups::<16>::conforming(groups::feature::GROUP_NAMES, &Optional::NONE).unwrap();
let lamp = OnOff::<Lamp>::conforming(on_off::feature::LIGHTING, &Optional::NONE).unwrap();
let scene = Lamps::conforming(scenes::feature::SCENE_NAMES, &Lamps::WITH_COPY_SCENE).unwrap();
let clusters = [
identify.descriptor(), group.descriptor(), lamp.descriptor(), descriptor::cluster(), scene.descriptor(), ];
let claimed = [DeviceType::new(ON_OFF_LIGHT.id, ON_OFF_LIGHT.revision)];
let endpoint = Endpoint::new(1, &clusters).with_device_types(&claimed);
assert_eq!(defects(&endpoint, &ON_OFF_LIGHT), Vec::<String>::new());
}
#[test]
fn dropping_any_one_cluster_is_reported() {
let identify = Identify::<Lamp>::conforming(&Identify::<Lamp>::WITH_TRIGGER_EFFECT).unwrap();
let group = Groups::<16>::conforming(groups::feature::GROUP_NAMES, &Optional::NONE).unwrap();
let lamp = OnOff::<Lamp>::conforming(on_off::feature::LIGHTING, &Optional::NONE).unwrap();
let scene = Lamps::conforming(scenes::feature::SCENE_NAMES, &Lamps::WITH_COPY_SCENE).unwrap();
let all = [
identify.descriptor(),
group.descriptor(),
lamp.descriptor(),
descriptor::cluster(),
scene.descriptor(),
];
for (index, id) in [(0usize, 0x0003u32), (1, 0x0004), (2, 0x0006), (4, 0x0062)] {
let mut kept = Vec::new();
for (i, cluster) in all.iter().enumerate() {
if i != index {
kept.push(*cluster);
}
}
let endpoint = Endpoint::new(1, &kept);
let reported = defects(&endpoint, &ON_OFF_LIGHT);
assert!(
reported.iter().any(|d| d.contains(&format!("{id}"))),
"dropping {id:#06x} went unreported: {reported:?}"
);
}
}
#[test]
fn an_optional_element_a_device_type_makes_mandatory_is_demanded() {
let identify = Identify::<Lamp>::conforming(&Optional::NONE).unwrap();
let group = Groups::<16>::conforming(groups::feature::GROUP_NAMES, &Optional::NONE).unwrap();
let lamp = OnOff::<Lamp>::conforming(on_off::feature::LIGHTING, &Optional::NONE).unwrap();
let scene = Lamps::conforming(scenes::feature::SCENE_NAMES, &Optional::NONE).unwrap();
let clusters = [
identify.descriptor(),
group.descriptor(),
lamp.descriptor(),
descriptor::cluster(),
scene.descriptor(),
];
let endpoint = Endpoint::new(1, &clusters);
let reported = defects(&endpoint, &ON_OFF_LIGHT);
assert!(!reported.is_empty(), "the missing commands went unreported");
}
#[test]
fn on_off_without_its_lighting_feature_is_not_an_on_off_light() {
let identify = Identify::<Lamp>::conforming(&Identify::<Lamp>::WITH_TRIGGER_EFFECT).unwrap();
let group = Groups::<16>::conforming(groups::feature::GROUP_NAMES, &Optional::NONE).unwrap();
let lamp = OnOff::<Lamp>::conforming(0, &Optional::NONE).unwrap();
let scene = Lamps::conforming(scenes::feature::SCENE_NAMES, &Lamps::WITH_COPY_SCENE).unwrap();
let clusters = [
identify.descriptor(),
group.descriptor(),
lamp.descriptor(),
descriptor::cluster(),
scene.descriptor(),
];
let endpoint = Endpoint::new(1, &clusters);
let reported = defects(&endpoint, &ON_OFF_LIGHT);
assert!(
reported.iter().any(|d| d.contains("Feature")),
"the missing Lighting feature went unreported: {reported:?}"
);
}
#[test]
fn a_light_is_not_a_light_switch() {
let identify = Identify::<Lamp>::conforming(&Identify::<Lamp>::WITH_TRIGGER_EFFECT).unwrap();
let group = Groups::<16>::conforming(groups::feature::GROUP_NAMES, &Optional::NONE).unwrap();
let lamp = OnOff::<Lamp>::conforming(on_off::feature::LIGHTING, &Optional::NONE).unwrap();
let scene = Lamps::conforming(scenes::feature::SCENE_NAMES, &Lamps::WITH_COPY_SCENE).unwrap();
let clusters = [
identify.descriptor(),
group.descriptor(),
lamp.descriptor(),
descriptor::cluster(),
scene.descriptor(),
];
let endpoint = Endpoint::new(1, &clusters);
assert!(defects(&endpoint, &ON_OFF_LIGHT).is_empty());
assert!(
!defects(&endpoint, &ON_OFF_LIGHT_SWITCH).is_empty(),
"a light passed as a light switch"
);
}
#[test]
fn the_root_node_is_checked_the_same_way() {
let clusters = [descriptor::cluster()];
let endpoint = Endpoint::new(0, &clusters);
assert!(
!defects(&endpoint, &ROOT_NODE).is_empty(),
"a bare endpoint passed as a Root Node"
);
}
#[test]
fn a_dimmable_light_is_an_on_off_light_plus_level_control() {
let identify = Identify::<Lamp>::conforming(&Identify::<Lamp>::WITH_TRIGGER_EFFECT).unwrap();
let group = Groups::<16>::conforming(groups::feature::GROUP_NAMES, &Optional::NONE).unwrap();
let lamp = OnOff::<Lamp>::conforming(on_off::feature::LIGHTING, &Optional::NONE).unwrap();
let scene = Lamps::conforming(scenes::feature::SCENE_NAMES, &Lamps::WITH_COPY_SCENE).unwrap();
let dimming = level_control::feature::LIGHTING | level_control::feature::ON_OFF;
let full = LevelControl::<Lamp, NoOnOff>::conforming(
dimming,
&LevelControl::<Lamp, NoOnOff>::WITH_RANGE,
)
.unwrap();
let clusters = [
identify.descriptor(), group.descriptor(), lamp.descriptor(), full.descriptor(), descriptor::cluster(), scene.descriptor(), ];
let endpoint = Endpoint::new(1, &clusters);
assert_eq!(defects(&endpoint, &DIMMABLE_LIGHT), Vec::<String>::new());
let bare = LevelControl::<Lamp, NoOnOff>::conforming(dimming, &Optional::NONE).unwrap();
let clusters = [
identify.descriptor(),
group.descriptor(),
lamp.descriptor(),
bare.descriptor(),
descriptor::cluster(),
scene.descriptor(),
];
let endpoint = Endpoint::new(1, &clusters);
let reported = defects(&endpoint, &DIMMABLE_LIGHT);
assert!(
reported.iter().any(|d| d.contains("MinLevel")),
"{reported:?}"
);
assert!(
reported.iter().any(|d| d.contains("MaxLevel")),
"{reported:?}"
);
let featureless =
LevelControl::<Lamp, NoOnOff>::conforming(0, &LevelControl::<Lamp, NoOnOff>::WITH_RANGE)
.unwrap();
let clusters = [
identify.descriptor(),
group.descriptor(),
lamp.descriptor(),
featureless.descriptor(),
descriptor::cluster(),
scene.descriptor(),
];
let endpoint = Endpoint::new(1, &clusters);
let reported = defects(&endpoint, &DIMMABLE_LIGHT);
assert!(
reported.iter().any(|d| d.contains("\"LT\"")),
"{reported:?}"
);
assert!(
reported.iter().any(|d| d.contains("\"OO\"")),
"{reported:?}"
);
let reported = defects(&endpoint, &ON_OFF_LIGHT);
assert!(
reported.iter().any(|d| d.contains("\"LT\"")),
"an optional cluster's mandatory features went undemanded: {reported:?}"
);
let clusters = [
identify.descriptor(),
group.descriptor(),
lamp.descriptor(),
full.descriptor(),
descriptor::cluster(),
scene.descriptor(),
];
let both = Endpoint::new(1, &clusters);
assert!(defects(&both, &ON_OFF_LIGHT).is_empty());
assert!(defects(&both, &DIMMABLE_LIGHT).is_empty());
}