use super::*;
use bacnet_objects::analog::AnalogInputObject;
use bacnet_objects::binary::BinaryInputObject;
use bacnet_objects::event_enrollment::EventEnrollmentObject;
use bacnet_objects::traits::BACnetObject;
use bacnet_types::constructed::BACnetDeviceObjectPropertyReference;
fn setup_out_of_range(
present_value: f32,
high_limit: f32,
low_limit: f32,
deadband: f32,
) -> (ObjectDatabase, ObjectIdentifier, ObjectIdentifier) {
let mut db = ObjectDatabase::new();
let mut ai = AnalogInputObject::new(1, "AI-1", 62).unwrap();
ai.set_present_value(present_value);
let ai_oid = ai.object_identifier();
db.add(Box::new(ai)).unwrap();
let mut ee = EventEnrollmentObject::new(1, "EE-OOR", EventType::OUT_OF_RANGE.to_raw()).unwrap();
ee.set_object_property_reference(Some(BACnetDeviceObjectPropertyReference::new_local(
ai_oid,
PropertyIdentifier::PRESENT_VALUE.to_raw(),
)));
ee.set_event_parameters(encode_out_of_range_params(high_limit, low_limit, deadband));
ee.set_event_enable(0x07); let ee_oid = ee.object_identifier();
db.add(Box::new(ee)).unwrap();
(db, ee_oid, ai_oid)
}
fn setup_floating_limit(
present_value: f32,
setpoint: f32,
high_diff: f32,
low_diff: f32,
deadband: f32,
) -> (ObjectDatabase, ObjectIdentifier, ObjectIdentifier) {
let mut db = ObjectDatabase::new();
let mut ai = AnalogInputObject::new(2, "AI-2", 62).unwrap();
ai.set_present_value(present_value);
let ai_oid = ai.object_identifier();
db.add(Box::new(ai)).unwrap();
let mut ee =
EventEnrollmentObject::new(2, "EE-FL", EventType::FLOATING_LIMIT.to_raw()).unwrap();
ee.set_object_property_reference(Some(BACnetDeviceObjectPropertyReference::new_local(
ai_oid,
PropertyIdentifier::PRESENT_VALUE.to_raw(),
)));
ee.set_event_parameters(encode_floating_limit_params(
setpoint, high_diff, low_diff, deadband,
));
ee.set_event_enable(0x07);
let ee_oid = ee.object_identifier();
db.add(Box::new(ee)).unwrap();
(db, ee_oid, ai_oid)
}
fn setup_change_of_state(
present_value: u32,
alarm_values: &[u32],
) -> (ObjectDatabase, ObjectIdentifier, ObjectIdentifier) {
let mut db = ObjectDatabase::new();
let mut bi = BinaryInputObject::new(1, "BI-1").unwrap();
bi.set_present_value(present_value);
let bi_oid = bi.object_identifier();
db.add(Box::new(bi)).unwrap();
let mut ee =
EventEnrollmentObject::new(3, "EE-COS", EventType::CHANGE_OF_STATE.to_raw()).unwrap();
ee.set_object_property_reference(Some(BACnetDeviceObjectPropertyReference::new_local(
bi_oid,
PropertyIdentifier::PRESENT_VALUE.to_raw(),
)));
ee.set_event_parameters(encode_change_of_state_params(alarm_values));
ee.set_event_enable(0x07);
let ee_oid = ee.object_identifier();
db.add(Box::new(ee)).unwrap();
(db, ee_oid, bi_oid)
}
#[test]
fn out_of_range_normal_stays_normal() {
let (mut db, _ee_oid, _ai_oid) = setup_out_of_range(50.0, 80.0, 20.0, 2.0);
let transitions = evaluate_event_enrollments(&mut db);
assert!(transitions.is_empty());
}
#[test]
fn out_of_range_normal_to_high_limit() {
let (mut db, ee_oid, ai_oid) = setup_out_of_range(85.0, 80.0, 20.0, 2.0);
let transitions = evaluate_event_enrollments(&mut db);
assert_eq!(transitions.len(), 1);
assert_eq!(transitions[0].enrollment_oid, ee_oid);
assert_eq!(transitions[0].monitored_oid, ai_oid);
assert_eq!(transitions[0].change.from, EventState::NORMAL);
assert_eq!(transitions[0].change.to, EventState::HIGH_LIMIT);
assert_eq!(transitions[0].event_type, EventType::OUT_OF_RANGE);
let obj = db.get(&ee_oid).unwrap();
assert_eq!(
obj.read_property(PropertyIdentifier::EVENT_STATE, None)
.unwrap(),
PropertyValue::Enumerated(EventState::HIGH_LIMIT.to_raw())
);
}
#[test]
fn out_of_range_normal_to_low_limit() {
let (mut db, ee_oid, _ai_oid) = setup_out_of_range(15.0, 80.0, 20.0, 2.0);
let transitions = evaluate_event_enrollments(&mut db);
assert_eq!(transitions.len(), 1);
assert_eq!(transitions[0].change.from, EventState::NORMAL);
assert_eq!(transitions[0].change.to, EventState::LOW_LIMIT);
let obj = db.get(&ee_oid).unwrap();
assert_eq!(
obj.read_property(PropertyIdentifier::EVENT_STATE, None)
.unwrap(),
PropertyValue::Enumerated(EventState::LOW_LIMIT.to_raw())
);
}
#[test]
fn out_of_range_high_to_normal_with_deadband() {
let (mut db, ee_oid, ai_oid) = setup_out_of_range(85.0, 80.0, 20.0, 2.0);
evaluate_event_enrollments(&mut db);
let ai = db.get_mut(&ai_oid).unwrap();
ai.write_property(
PropertyIdentifier::OUT_OF_SERVICE,
None,
PropertyValue::Boolean(true),
None,
)
.unwrap();
ai.write_property(
PropertyIdentifier::PRESENT_VALUE,
None,
PropertyValue::Real(79.0),
None,
)
.unwrap();
let transitions = evaluate_event_enrollments(&mut db);
assert!(transitions.is_empty(), "within deadband — no transition");
let ai = db.get_mut(&ai_oid).unwrap();
ai.write_property(
PropertyIdentifier::PRESENT_VALUE,
None,
PropertyValue::Real(77.0),
None,
)
.unwrap();
let transitions = evaluate_event_enrollments(&mut db);
assert_eq!(transitions.len(), 1);
assert_eq!(transitions[0].change.from, EventState::HIGH_LIMIT);
assert_eq!(transitions[0].change.to, EventState::NORMAL);
let obj = db.get(&ee_oid).unwrap();
assert_eq!(
obj.read_property(PropertyIdentifier::EVENT_STATE, None)
.unwrap(),
PropertyValue::Enumerated(EventState::NORMAL.to_raw())
);
}
#[test]
fn out_of_range_no_change_when_already_faulted() {
let (mut db, _ee_oid, _ai_oid) = setup_out_of_range(85.0, 80.0, 20.0, 2.0);
let t1 = evaluate_event_enrollments(&mut db);
assert_eq!(t1.len(), 1);
let t2 = evaluate_event_enrollments(&mut db);
assert!(t2.is_empty());
}
#[test]
fn out_of_range_event_enable_suppresses_notification() {
let mut db = ObjectDatabase::new();
let mut ai = AnalogInputObject::new(10, "AI-10", 62).unwrap();
ai.set_present_value(85.0);
let ai_oid = ai.object_identifier();
db.add(Box::new(ai)).unwrap();
let mut ee =
EventEnrollmentObject::new(10, "EE-sup", EventType::OUT_OF_RANGE.to_raw()).unwrap();
ee.set_object_property_reference(Some(BACnetDeviceObjectPropertyReference::new_local(
ai_oid,
PropertyIdentifier::PRESENT_VALUE.to_raw(),
)));
ee.set_event_parameters(encode_out_of_range_params(80.0, 20.0, 2.0));
ee.set_event_enable(0x04); let ee_oid = ee.object_identifier();
db.add(Box::new(ee)).unwrap();
let transitions = evaluate_event_enrollments(&mut db);
assert!(transitions.is_empty());
let obj = db.get(&ee_oid).unwrap();
assert_eq!(
obj.read_property(PropertyIdentifier::EVENT_STATE, None)
.unwrap(),
PropertyValue::Enumerated(EventState::NORMAL.to_raw())
);
}
#[test]
fn out_of_range_skips_out_of_service() {
let (mut db, ee_oid, _ai_oid) = setup_out_of_range(85.0, 80.0, 20.0, 2.0);
let obj = db.get_mut(&ee_oid).unwrap();
obj.write_property(
PropertyIdentifier::OUT_OF_SERVICE,
None,
PropertyValue::Boolean(true),
None,
)
.unwrap();
let transitions = evaluate_event_enrollments(&mut db);
assert!(transitions.is_empty());
}
#[test]
fn floating_limit_normal_stays_normal() {
let (mut db, _ee_oid, _ai_oid) = setup_floating_limit(50.0, 50.0, 10.0, 10.0, 2.0);
let transitions = evaluate_event_enrollments(&mut db);
assert!(transitions.is_empty());
}
#[test]
fn floating_limit_to_high() {
let (mut db, ee_oid, ai_oid) = setup_floating_limit(65.0, 50.0, 10.0, 10.0, 2.0);
let transitions = evaluate_event_enrollments(&mut db);
assert_eq!(transitions.len(), 1);
assert_eq!(transitions[0].enrollment_oid, ee_oid);
assert_eq!(transitions[0].monitored_oid, ai_oid);
assert_eq!(transitions[0].change.from, EventState::NORMAL);
assert_eq!(transitions[0].change.to, EventState::HIGH_LIMIT);
assert_eq!(transitions[0].event_type, EventType::FLOATING_LIMIT);
}
#[test]
fn floating_limit_to_low() {
let (mut db, _ee_oid, _ai_oid) = setup_floating_limit(35.0, 50.0, 10.0, 10.0, 2.0);
let transitions = evaluate_event_enrollments(&mut db);
assert_eq!(transitions.len(), 1);
assert_eq!(transitions[0].change.to, EventState::LOW_LIMIT);
}
#[test]
fn floating_limit_deadband_hysteresis() {
let (mut db, _ee_oid, ai_oid) = setup_floating_limit(65.0, 50.0, 10.0, 10.0, 2.0);
evaluate_event_enrollments(&mut db);
let ai = db.get_mut(&ai_oid).unwrap();
ai.write_property(
PropertyIdentifier::OUT_OF_SERVICE,
None,
PropertyValue::Boolean(true),
None,
)
.unwrap();
ai.write_property(
PropertyIdentifier::PRESENT_VALUE,
None,
PropertyValue::Real(59.0),
None,
)
.unwrap();
let transitions = evaluate_event_enrollments(&mut db);
assert!(transitions.is_empty());
let ai = db.get_mut(&ai_oid).unwrap();
ai.write_property(
PropertyIdentifier::PRESENT_VALUE,
None,
PropertyValue::Real(57.0),
None,
)
.unwrap();
let transitions = evaluate_event_enrollments(&mut db);
assert_eq!(transitions.len(), 1);
assert_eq!(transitions[0].change.to, EventState::NORMAL);
}
#[test]
fn change_of_state_normal_when_not_in_alarm_set() {
let (mut db, _ee_oid, _bi_oid) = setup_change_of_state(0, &[1]);
let transitions = evaluate_event_enrollments(&mut db);
assert!(transitions.is_empty());
}
#[test]
fn change_of_state_to_offnormal() {
let (mut db, ee_oid, bi_oid) = setup_change_of_state(1, &[1]);
let transitions = evaluate_event_enrollments(&mut db);
assert_eq!(transitions.len(), 1);
assert_eq!(transitions[0].enrollment_oid, ee_oid);
assert_eq!(transitions[0].monitored_oid, bi_oid);
assert_eq!(transitions[0].change.from, EventState::NORMAL);
assert_eq!(transitions[0].change.to, EventState::OFFNORMAL);
assert_eq!(transitions[0].event_type, EventType::CHANGE_OF_STATE);
}
#[test]
fn change_of_state_back_to_normal() {
let (mut db, _ee_oid, bi_oid) = setup_change_of_state(1, &[1]);
evaluate_event_enrollments(&mut db);
let bi = db.get_mut(&bi_oid).unwrap();
bi.write_property(
PropertyIdentifier::OUT_OF_SERVICE,
None,
PropertyValue::Boolean(true),
None,
)
.unwrap();
bi.write_property(
PropertyIdentifier::PRESENT_VALUE,
None,
PropertyValue::Enumerated(0),
None,
)
.unwrap();
let transitions = evaluate_event_enrollments(&mut db);
assert_eq!(transitions.len(), 1);
assert_eq!(transitions[0].change.from, EventState::OFFNORMAL);
assert_eq!(transitions[0].change.to, EventState::NORMAL);
}
#[test]
fn change_of_state_multiple_alarm_values() {
let (mut db, _ee_oid, _bi_oid) = setup_change_of_state(3, &[1, 3, 5]);
let transitions = evaluate_event_enrollments(&mut db);
assert_eq!(transitions.len(), 1);
assert_eq!(transitions[0].change.to, EventState::OFFNORMAL);
}
#[test]
fn change_of_bitstring_normal() {
let mut db = ObjectDatabase::new();
let mut target = EventEnrollmentObject::new(50, "Target", EventType::NONE.to_raw()).unwrap();
target.set_event_enable(0x05); let target_oid = target.object_identifier();
db.add(Box::new(target)).unwrap();
let mut ee =
EventEnrollmentObject::new(51, "EE-COBS", EventType::CHANGE_OF_BITSTRING.to_raw()).unwrap();
ee.set_object_property_reference(Some(BACnetDeviceObjectPropertyReference::new_local(
target_oid,
PropertyIdentifier::EVENT_ENABLE.to_raw(),
)));
ee.set_event_parameters(encode_change_of_bitstring_params(&[0xFF], &[0xE0]));
ee.set_event_enable(0x07);
db.add(Box::new(ee)).unwrap();
let transitions = evaluate_event_enrollments(&mut db);
assert!(transitions.is_empty());
}
#[test]
fn change_of_bitstring_offnormal() {
let mut db = ObjectDatabase::new();
let mut target = EventEnrollmentObject::new(60, "Target2", EventType::NONE.to_raw()).unwrap();
target.set_event_enable(0x07); let target_oid = target.object_identifier();
db.add(Box::new(target)).unwrap();
let mut ee =
EventEnrollmentObject::new(61, "EE-COBS2", EventType::CHANGE_OF_BITSTRING.to_raw())
.unwrap();
ee.set_object_property_reference(Some(BACnetDeviceObjectPropertyReference::new_local(
target_oid,
PropertyIdentifier::EVENT_ENABLE.to_raw(),
)));
ee.set_event_parameters(encode_change_of_bitstring_params(&[0xE0], &[0xE0]));
ee.set_event_enable(0x07);
db.add(Box::new(ee)).unwrap();
let transitions = evaluate_event_enrollments(&mut db);
assert_eq!(transitions.len(), 1);
assert_eq!(transitions[0].change.to, EventState::OFFNORMAL);
}
#[test]
fn change_of_value_within_increment() {
let mut db = ObjectDatabase::new();
let mut ai = AnalogInputObject::new(70, "AI-COV", 62).unwrap();
ai.set_present_value(3.0);
let ai_oid = ai.object_identifier();
db.add(Box::new(ai)).unwrap();
let mut ee =
EventEnrollmentObject::new(70, "EE-COV", EventType::CHANGE_OF_VALUE.to_raw()).unwrap();
ee.set_object_property_reference(Some(BACnetDeviceObjectPropertyReference::new_local(
ai_oid,
PropertyIdentifier::PRESENT_VALUE.to_raw(),
)));
ee.set_event_parameters(encode_change_of_value_params(5.0));
ee.set_event_enable(0x07);
db.add(Box::new(ee)).unwrap();
let transitions = evaluate_event_enrollments(&mut db);
assert!(transitions.is_empty());
}
#[test]
fn change_of_value_exceeds_increment() {
let mut db = ObjectDatabase::new();
let mut ai = AnalogInputObject::new(71, "AI-COV2", 62).unwrap();
ai.set_present_value(10.0);
let ai_oid = ai.object_identifier();
db.add(Box::new(ai)).unwrap();
let mut ee =
EventEnrollmentObject::new(71, "EE-COV2", EventType::CHANGE_OF_VALUE.to_raw()).unwrap();
ee.set_object_property_reference(Some(BACnetDeviceObjectPropertyReference::new_local(
ai_oid,
PropertyIdentifier::PRESENT_VALUE.to_raw(),
)));
ee.set_event_parameters(encode_change_of_value_params(5.0));
ee.set_event_enable(0x07);
db.add(Box::new(ee)).unwrap();
let transitions = evaluate_event_enrollments(&mut db);
assert_eq!(transitions.len(), 1);
assert_eq!(transitions[0].change.to, EventState::OFFNORMAL);
}
#[test]
fn evaluates_multiple_enrollments() {
let mut db = ObjectDatabase::new();
let mut ai1 = AnalogInputObject::new(80, "AI-80", 62).unwrap();
ai1.set_present_value(90.0); let ai1_oid = ai1.object_identifier();
db.add(Box::new(ai1)).unwrap();
let mut ai2 = AnalogInputObject::new(81, "AI-81", 62).unwrap();
ai2.set_present_value(50.0); let ai2_oid = ai2.object_identifier();
db.add(Box::new(ai2)).unwrap();
let mut ee1 =
EventEnrollmentObject::new(80, "EE-80", EventType::OUT_OF_RANGE.to_raw()).unwrap();
ee1.set_object_property_reference(Some(BACnetDeviceObjectPropertyReference::new_local(
ai1_oid,
PropertyIdentifier::PRESENT_VALUE.to_raw(),
)));
ee1.set_event_parameters(encode_out_of_range_params(80.0, 20.0, 2.0));
ee1.set_event_enable(0x07);
db.add(Box::new(ee1)).unwrap();
let mut ee2 =
EventEnrollmentObject::new(81, "EE-81", EventType::OUT_OF_RANGE.to_raw()).unwrap();
ee2.set_object_property_reference(Some(BACnetDeviceObjectPropertyReference::new_local(
ai2_oid,
PropertyIdentifier::PRESENT_VALUE.to_raw(),
)));
ee2.set_event_parameters(encode_out_of_range_params(80.0, 20.0, 2.0));
ee2.set_event_enable(0x07);
db.add(Box::new(ee2)).unwrap();
let transitions = evaluate_event_enrollments(&mut db);
assert_eq!(transitions.len(), 1);
assert_eq!(transitions[0].monitored_oid, ai1_oid);
}
#[test]
fn missing_monitored_object_is_skipped() {
let mut db = ObjectDatabase::new();
let fake_oid = ObjectIdentifier::new(ObjectType::ANALOG_INPUT, 999).unwrap();
let mut ee =
EventEnrollmentObject::new(90, "EE-miss", EventType::OUT_OF_RANGE.to_raw()).unwrap();
ee.set_object_property_reference(Some(BACnetDeviceObjectPropertyReference::new_local(
fake_oid,
PropertyIdentifier::PRESENT_VALUE.to_raw(),
)));
ee.set_event_parameters(encode_out_of_range_params(80.0, 20.0, 2.0));
ee.set_event_enable(0x07);
db.add(Box::new(ee)).unwrap();
let transitions = evaluate_event_enrollments(&mut db);
assert!(transitions.is_empty());
}
#[test]
fn no_reference_is_skipped() {
let mut db = ObjectDatabase::new();
let ee = EventEnrollmentObject::new(91, "EE-noref", EventType::OUT_OF_RANGE.to_raw()).unwrap();
db.add(Box::new(ee)).unwrap();
let transitions = evaluate_event_enrollments(&mut db);
assert!(transitions.is_empty());
}
#[test]
fn empty_parameters_is_skipped() {
let mut db = ObjectDatabase::new();
let mut ai = AnalogInputObject::new(92, "AI-92", 62).unwrap();
ai.set_present_value(100.0);
let ai_oid = ai.object_identifier();
db.add(Box::new(ai)).unwrap();
let mut ee =
EventEnrollmentObject::new(92, "EE-noparam", EventType::OUT_OF_RANGE.to_raw()).unwrap();
ee.set_object_property_reference(Some(BACnetDeviceObjectPropertyReference::new_local(
ai_oid,
PropertyIdentifier::PRESENT_VALUE.to_raw(),
)));
ee.set_event_enable(0x07);
db.add(Box::new(ee)).unwrap();
let transitions = evaluate_event_enrollments(&mut db);
assert!(transitions.is_empty());
}