bacnet-objects 0.12.0

BACnet object model: traits, database, and standard object types
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94

//! The database's selected Device and the local-reference rule built on it
//! (#1183, #1184).
use super::*;
use crate::analog::AnalogValueObject;
use crate::device::{DeviceConfig, DeviceObject};

fn device(instance: u32) -> ObjectIdentifier {
    ObjectIdentifier::new(ObjectType::DEVICE, instance).unwrap()
}

fn database(instances: &[u32]) -> ObjectDatabase {
    let mut db = ObjectDatabase::new();
    db.add(Box::new(AnalogValueObject::new(1, "AV-1", 62).unwrap()))
        .unwrap();
    for &instance in instances {
        db.add(Box::new(
            DeviceObject::new(DeviceConfig {
                instance,
                name: format!("Device-{instance}"),
                ..DeviceConfig::default()
            })
            .unwrap(),
        ))
        .unwrap();
    }
    db
}

#[test]
fn selected_device_is_independent_of_iteration_order() {
    let low = device(813);
    let high = device(900);
    let wildcard = device(ObjectIdentifier::WILDCARD_INSTANCE);
    let analog = ObjectIdentifier::new(ObjectType::ANALOG_VALUE, 1).unwrap();
    for candidates in [
        [analog, high, low, wildcard],
        [analog, low, high, wildcard],
        [wildcard, high, low, analog],
    ] {
        assert_eq!(select_device(candidates), Some(low));
    }
}

#[test]
fn selected_device_preserves_empty_single_and_wildcard_only_cases() {
    let concrete = device(813);
    let wildcard = device(ObjectIdentifier::WILDCARD_INSTANCE);
    let analog = ObjectIdentifier::new(ObjectType::ANALOG_VALUE, 1).unwrap();
    assert_eq!(select_device([]), None);
    assert_eq!(select_device([analog]), None);
    assert_eq!(select_device([analog, concrete]), Some(concrete));
    assert_eq!(select_device([analog, wildcard]), Some(wildcard));
}

#[test]
fn the_database_selects_its_lowest_device() {
    assert_eq!(database(&[]).selected_device(), None);
    assert_eq!(database(&[900, 813]).selected_device(), Some(device(813)));
    let wildcard = ObjectIdentifier::WILDCARD_INSTANCE;
    assert_eq!(
        database(&[wildcard]).selected_device(),
        Some(device(wildcard))
    );
    assert_eq!(
        database(&[wildcard, 900]).selected_device(),
        Some(device(900))
    );
}

#[test]
fn a_reference_is_local_without_a_device_or_naming_the_selected_one() {
    let local = database(&[900, 813]).local_device();
    assert_eq!(local.identifier(), Some(device(813)));
    assert!(local.is_local(None));
    assert!(local.is_local(Some(device(813))));
    // Another Device in the same database is not the one this device is.
    assert!(!local.is_local(Some(device(900))));
    assert!(!local.is_local(Some(device(7))));
    // A non-Device identifier in the Device member names no device here.
    let analog = ObjectIdentifier::new(ObjectType::ANALOG_VALUE, 813).unwrap();
    assert!(!local.is_local(Some(analog)));
}

#[test]
fn without_a_concrete_device_only_unqualified_references_are_local() {
    let wildcard = ObjectIdentifier::WILDCARD_INSTANCE;
    for db in [database(&[]), database(&[wildcard])] {
        let local = db.local_device();
        assert_eq!(local.identifier(), None);
        assert!(local.is_local(None));
        assert!(!local.is_local(Some(device(wildcard))));
        assert!(!local.is_local(Some(device(813))));
    }
}