use alloc::string::String;
use alloc::vec::Vec;
use bon::Builder;
use serde::{Deserialize, Serialize};
use super::common::{PowerRange, Timer, Transition};
use super::{Id, NumberRange, Timestamp};
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize, Builder)]
#[serde(deny_unknown_fields)]
#[builder(on(String, into))]
pub struct OperationMode {
pub id: Id,
#[serde(skip_serializing_if = "Option::is_none")]
pub diagnostic_label: Option<String>,
pub power_ranges: Vec<PowerRange>,
#[serde(skip_serializing_if = "Option::is_none")]
pub running_costs: Option<NumberRange>,
pub abnormal_condition_only: bool,
}
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize, Builder)]
#[serde(deny_unknown_fields)]
pub struct SystemDescription {
#[cfg_attr(feature = "uuid", builder(default = Id::generate()))]
pub message_id: Id,
pub valid_from: Timestamp,
pub operation_modes: Vec<OperationMode>,
pub transitions: Vec<Transition>,
pub timers: Vec<Timer>,
}
impl SystemDescription {
#[must_use]
pub fn operation_mode(&self, id: &Id) -> Option<&OperationMode> {
self.operation_modes.iter().find(|m| m.id == *id)
}
#[must_use]
pub fn timer(&self, id: &Id) -> Option<&Timer> {
self.timers.iter().find(|t| t.id == *id)
}
#[must_use]
pub fn transition(&self, from: &Id, to: &Id) -> Option<&Transition> {
self.transitions
.iter()
.find(|t| t.from == *from && t.to == *to)
}
}
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize, Builder)]
#[serde(deny_unknown_fields)]
pub struct Status {
#[cfg_attr(feature = "uuid", builder(default = Id::generate()))]
pub message_id: Id,
pub active_operation_mode_id: Id,
pub operation_mode_factor: f64,
#[serde(skip_serializing_if = "Option::is_none")]
pub previous_operation_mode_id: Option<Id>,
#[serde(skip_serializing_if = "Option::is_none")]
pub transition_timestamp: Option<Timestamp>,
}
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize, Builder)]
#[serde(deny_unknown_fields)]
pub struct TimerStatus {
#[cfg_attr(feature = "uuid", builder(default = Id::generate()))]
pub message_id: Id,
pub timer_id: Id,
pub finished_at: Timestamp,
}
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize, Builder)]
#[serde(deny_unknown_fields)]
pub struct Instruction {
#[cfg_attr(feature = "uuid", builder(default = Id::generate()))]
pub message_id: Id,
pub id: Id,
pub execution_time: Timestamp,
pub operation_mode_id: Id,
pub operation_mode_factor: f64,
pub abnormal_condition: bool,
}
#[cfg(test)]
mod tests {
use super::*;
use crate::types::common::CommodityQuantity;
#[test]
fn the_generator_example_from_the_whitepaper() {
let modes = alloc::vec![
OperationMode {
id: Id::new_const("off"),
diagnostic_label: Some("Off".into()),
power_ranges: alloc::vec![PowerRange::exactly(
0.0,
CommodityQuantity::ElectricPowerL1
)],
running_costs: None,
abnormal_condition_only: false,
},
OperationMode {
id: Id::new_const("reduced"),
diagnostic_label: Some("Reduced power".into()),
power_ranges: alloc::vec![PowerRange::exactly(
-1800.0,
CommodityQuantity::ElectricPowerL1
)],
running_costs: None,
abnormal_condition_only: false,
},
];
let system = SystemDescription {
message_id: Id::new_const("m1"),
valid_from: Timestamp::UNIX_EPOCH,
operation_modes: modes,
transitions: alloc::vec![Transition::simple(
Id::new_const("t1"),
Id::new_const("off"),
Id::new_const("reduced")
)],
timers: Vec::new(),
};
assert!(system.operation_mode(&Id::new_const("reduced")).is_some());
assert!(
system
.transition(&Id::new_const("off"), &Id::new_const("reduced"))
.is_some()
);
assert!(
system
.transition(&Id::new_const("reduced"), &Id::new_const("off"))
.is_none()
);
}
#[test]
fn the_timer_status_has_no_actuator() {
let json = serde_json::to_string(&TimerStatus {
message_id: Id::new_const("m1"),
timer_id: Id::new_const("timer0"),
finished_at: Timestamp::UNIX_EPOCH,
})
.unwrap();
assert!(!json.contains("actuator_id"));
}
}