matter-clusters 0.4.1

//! Pm10ConcentrationMeasurement cluster (0x042D).
//! @generated by `cargo xtask codegen` — do not edit.

#![allow(
    clippy::all,
    clippy::pedantic,
    dead_code,
    unreachable_pub,
    unused_imports
)]

use crate::datatypes::SemanticTagStruct;
use crate::error::ClusterError;
use crate::types::Nullable;
use matter_codec::{ContainerKind, Element, Tag, TlvReader, TlvWriter, Value};

/// Cluster ID.
pub const CLUSTER_ID: u32 = 0x042D;
/// Cluster revision.
pub const CLUSTER_REVISION: u16 = 4;

/// Command IDs (requests and responses).
pub mod command_id {}

/// Attribute IDs (cluster-specific).
pub mod attribute_id {
    /// `MeasuredValue`.
    pub const MEASURED_VALUE: u32 = 0x0000;
    /// `MinMeasuredValue`.
    pub const MIN_MEASURED_VALUE: u32 = 0x0001;
    /// `MaxMeasuredValue`.
    pub const MAX_MEASURED_VALUE: u32 = 0x0002;
    /// `PeakMeasuredValue`.
    pub const PEAK_MEASURED_VALUE: u32 = 0x0003;
    /// `PeakMeasuredValueWindow`.
    pub const PEAK_MEASURED_VALUE_WINDOW: u32 = 0x0004;
    /// `AverageMeasuredValue`.
    pub const AVERAGE_MEASURED_VALUE: u32 = 0x0005;
    /// `AverageMeasuredValueWindow`.
    pub const AVERAGE_MEASURED_VALUE_WINDOW: u32 = 0x0006;
    /// `Uncertainty`.
    pub const UNCERTAINTY: u32 = 0x0007;
    /// `MeasurementUnit`.
    pub const MEASUREMENT_UNIT: u32 = 0x0008;
    /// `MeasurementMedium`.
    pub const MEASUREMENT_MEDIUM: u32 = 0x0009;
    /// `LevelValue`.
    pub const LEVEL_VALUE: u32 = 0x000A;
}

bitflags::bitflags! {
    /// `Pm10ConcentrationMeasurement` feature bits (FeatureMap).
    #[derive(Copy, Clone, Debug, PartialEq, Eq, Hash)]
    pub struct Feature: u32 {
        /// NumericMeasurement (MEA).
        const MEA = 1 << 0;
        /// LevelIndication (LEV).
        const LEV = 1 << 1;
        /// MediumLevel (MED).
        const MED = 1 << 2;
        /// CriticalLevel (CRI).
        const CRI = 1 << 3;
        /// PeakMeasurement (PEA).
        const PEA = 1 << 4;
        /// AverageMeasurement (AVG).
        const AVG = 1 << 5;
    }
}

/// `LevelValueEnum` (enum8).
#[derive(Copy, Clone, Debug, PartialEq, Eq)]
pub enum LevelValueEnum {
    /// Unknown = 0.
    Unknown,
    /// Low = 1.
    Low,
    /// Medium = 2.
    Medium,
    /// High = 3.
    High,
    /// Critical = 4.
    Critical,
    /// A value not known to this codegen revision.
    Unrecognized(u8),
}

impl LevelValueEnum {
    /// Decode from its raw discriminant (unknown → `Unrecognized`).
    #[must_use]
    pub fn from_raw(v: u8) -> Self {
        match v {
            0 => Self::Unknown,
            1 => Self::Low,
            2 => Self::Medium,
            3 => Self::High,
            4 => Self::Critical,
            other => Self::Unrecognized(other),
        }
    }
    /// The raw discriminant.
    #[must_use]
    pub fn to_raw(self) -> u8 {
        match self {
            Self::Unknown => 0,
            Self::Low => 1,
            Self::Medium => 2,
            Self::High => 3,
            Self::Critical => 4,
            Self::Unrecognized(v) => v,
        }
    }
}

/// `MeasurementMediumEnum` (enum8).
#[derive(Copy, Clone, Debug, PartialEq, Eq)]
pub enum MeasurementMediumEnum {
    /// Air = 0.
    Air,
    /// Water = 1.
    Water,
    /// Soil = 2.
    Soil,
    /// A value not known to this codegen revision.
    Unknown(u8),
}

impl MeasurementMediumEnum {
    /// Decode from its raw discriminant (unknown → `Unknown`).
    #[must_use]
    pub fn from_raw(v: u8) -> Self {
        match v {
            0 => Self::Air,
            1 => Self::Water,
            2 => Self::Soil,
            other => Self::Unknown(other),
        }
    }
    /// The raw discriminant.
    #[must_use]
    pub fn to_raw(self) -> u8 {
        match self {
            Self::Air => 0,
            Self::Water => 1,
            Self::Soil => 2,
            Self::Unknown(v) => v,
        }
    }
}

/// `MeasurementUnitEnum` (enum8).
#[derive(Copy, Clone, Debug, PartialEq, Eq)]
pub enum MeasurementUnitEnum {
    /// Ppm = 0.
    Ppm,
    /// Ppb = 1.
    Ppb,
    /// Ppt = 2.
    Ppt,
    /// Mgm3 = 3.
    Mgm3,
    /// Ugm3 = 4.
    Ugm3,
    /// Ngm3 = 5.
    Ngm3,
    /// Pm3 = 6.
    Pm3,
    /// Bqm3 = 7.
    Bqm3,
    /// A value not known to this codegen revision.
    Unknown(u8),
}

impl MeasurementUnitEnum {
    /// Decode from its raw discriminant (unknown → `Unknown`).
    #[must_use]
    pub fn from_raw(v: u8) -> Self {
        match v {
            0 => Self::Ppm,
            1 => Self::Ppb,
            2 => Self::Ppt,
            3 => Self::Mgm3,
            4 => Self::Ugm3,
            5 => Self::Ngm3,
            6 => Self::Pm3,
            7 => Self::Bqm3,
            other => Self::Unknown(other),
        }
    }
    /// The raw discriminant.
    #[must_use]
    pub fn to_raw(self) -> u8 {
        match self {
            Self::Ppm => 0,
            Self::Ppb => 1,
            Self::Ppt => 2,
            Self::Mgm3 => 3,
            Self::Ugm3 => 4,
            Self::Ngm3 => 5,
            Self::Pm3 => 6,
            Self::Bqm3 => 7,
            Self::Unknown(v) => v,
        }
    }
}

/// Decode the `MeasuredValue` attribute value.
///
/// # Errors
/// Returns [`ClusterError`] on a type mismatch or out-of-range value.
pub fn decode_measured_value(tlv: &[u8]) -> Result<Nullable<f32>, ClusterError> {
    let mut r = TlvReader::new(tlv);
    match r.next()? {
        Some(Element::Scalar {
            value: Value::Null, ..
        }) => Ok(Nullable::Null),
        Some(Element::Scalar {
            value: Value::Float(v),
            ..
        }) => Ok(Nullable::Value(v)),
        _ => Err(ClusterError::UnexpectedType {
            context: "MeasuredValue",
        }),
    }
}

/// Decode the `MinMeasuredValue` attribute value.
///
/// # Errors
/// Returns [`ClusterError`] on a type mismatch or out-of-range value.
pub fn decode_min_measured_value(tlv: &[u8]) -> Result<Nullable<f32>, ClusterError> {
    let mut r = TlvReader::new(tlv);
    match r.next()? {
        Some(Element::Scalar {
            value: Value::Null, ..
        }) => Ok(Nullable::Null),
        Some(Element::Scalar {
            value: Value::Float(v),
            ..
        }) => Ok(Nullable::Value(v)),
        _ => Err(ClusterError::UnexpectedType {
            context: "MinMeasuredValue",
        }),
    }
}

/// Decode the `MaxMeasuredValue` attribute value.
///
/// # Errors
/// Returns [`ClusterError`] on a type mismatch or out-of-range value.
pub fn decode_max_measured_value(tlv: &[u8]) -> Result<Nullable<f32>, ClusterError> {
    let mut r = TlvReader::new(tlv);
    match r.next()? {
        Some(Element::Scalar {
            value: Value::Null, ..
        }) => Ok(Nullable::Null),
        Some(Element::Scalar {
            value: Value::Float(v),
            ..
        }) => Ok(Nullable::Value(v)),
        _ => Err(ClusterError::UnexpectedType {
            context: "MaxMeasuredValue",
        }),
    }
}

/// Decode the `PeakMeasuredValue` attribute value.
///
/// # Errors
/// Returns [`ClusterError`] on a type mismatch or out-of-range value.
pub fn decode_peak_measured_value(tlv: &[u8]) -> Result<Nullable<f32>, ClusterError> {
    let mut r = TlvReader::new(tlv);
    match r.next()? {
        Some(Element::Scalar {
            value: Value::Null, ..
        }) => Ok(Nullable::Null),
        Some(Element::Scalar {
            value: Value::Float(v),
            ..
        }) => Ok(Nullable::Value(v)),
        _ => Err(ClusterError::UnexpectedType {
            context: "PeakMeasuredValue",
        }),
    }
}

/// Decode the `PeakMeasuredValueWindow` attribute value.
///
/// # Errors
/// Returns [`ClusterError`] on a type mismatch or out-of-range value.
pub fn decode_peak_measured_value_window(tlv: &[u8]) -> Result<u32, ClusterError> {
    let mut r = TlvReader::new(tlv);
    match r.next()? {
        Some(Element::Scalar {
            value: Value::Uint(v),
            ..
        }) => {
            Ok(u32::try_from(v)
                .map_err(|_| ClusterError::InvalidLength("PeakMeasuredValueWindow"))?)
        }
        _ => Err(ClusterError::UnexpectedType {
            context: "PeakMeasuredValueWindow",
        }),
    }
}

/// Decode the `AverageMeasuredValue` attribute value.
///
/// # Errors
/// Returns [`ClusterError`] on a type mismatch or out-of-range value.
pub fn decode_average_measured_value(tlv: &[u8]) -> Result<Nullable<f32>, ClusterError> {
    let mut r = TlvReader::new(tlv);
    match r.next()? {
        Some(Element::Scalar {
            value: Value::Null, ..
        }) => Ok(Nullable::Null),
        Some(Element::Scalar {
            value: Value::Float(v),
            ..
        }) => Ok(Nullable::Value(v)),
        _ => Err(ClusterError::UnexpectedType {
            context: "AverageMeasuredValue",
        }),
    }
}

/// Decode the `AverageMeasuredValueWindow` attribute value.
///
/// # Errors
/// Returns [`ClusterError`] on a type mismatch or out-of-range value.
pub fn decode_average_measured_value_window(tlv: &[u8]) -> Result<u32, ClusterError> {
    let mut r = TlvReader::new(tlv);
    match r.next()? {
        Some(Element::Scalar {
            value: Value::Uint(v),
            ..
        }) => Ok(u32::try_from(v)
            .map_err(|_| ClusterError::InvalidLength("AverageMeasuredValueWindow"))?),
        _ => Err(ClusterError::UnexpectedType {
            context: "AverageMeasuredValueWindow",
        }),
    }
}

/// Decode the `Uncertainty` attribute value.
///
/// # Errors
/// Returns [`ClusterError`] on a type mismatch or out-of-range value.
pub fn decode_uncertainty(tlv: &[u8]) -> Result<f32, ClusterError> {
    let mut r = TlvReader::new(tlv);
    match r.next()? {
        Some(Element::Scalar {
            value: Value::Float(v),
            ..
        }) => Ok(v),
        _ => Err(ClusterError::UnexpectedType {
            context: "Uncertainty",
        }),
    }
}

/// Decode the `MeasurementUnit` attribute value.
///
/// # Errors
/// Returns [`ClusterError`] on a type mismatch or out-of-range value.
pub fn decode_measurement_unit(tlv: &[u8]) -> Result<MeasurementUnitEnum, ClusterError> {
    let mut r = TlvReader::new(tlv);
    match r.next()? {
        Some(Element::Scalar {
            value: Value::Uint(v),
            ..
        }) => Ok(MeasurementUnitEnum::from_raw(
            u8::try_from(v).map_err(|_| ClusterError::InvalidLength("MeasurementUnit"))?,
        )),
        _ => Err(ClusterError::UnexpectedType {
            context: "MeasurementUnit",
        }),
    }
}

/// Decode the `MeasurementMedium` attribute value.
///
/// # Errors
/// Returns [`ClusterError`] on a type mismatch or out-of-range value.
pub fn decode_measurement_medium(tlv: &[u8]) -> Result<MeasurementMediumEnum, ClusterError> {
    let mut r = TlvReader::new(tlv);
    match r.next()? {
        Some(Element::Scalar {
            value: Value::Uint(v),
            ..
        }) => Ok(MeasurementMediumEnum::from_raw(
            u8::try_from(v).map_err(|_| ClusterError::InvalidLength("MeasurementMedium"))?,
        )),
        _ => Err(ClusterError::UnexpectedType {
            context: "MeasurementMedium",
        }),
    }
}

/// Decode the `LevelValue` attribute value.
///
/// # Errors
/// Returns [`ClusterError`] on a type mismatch or out-of-range value.
pub fn decode_level_value(tlv: &[u8]) -> Result<LevelValueEnum, ClusterError> {
    let mut r = TlvReader::new(tlv);
    match r.next()? {
        Some(Element::Scalar {
            value: Value::Uint(v),
            ..
        }) => Ok(LevelValueEnum::from_raw(
            u8::try_from(v).map_err(|_| ClusterError::InvalidLength("LevelValue"))?,
        )),
        _ => Err(ClusterError::UnexpectedType {
            context: "LevelValue",
        }),
    }
}