bacnet-server 0.11.0

BACnet server: APDU dispatch and service handlers
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
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153

use super::event_notifications_tests::{
    broadcasts_from_per_write_path, db_with_high_limit_transition, RecordingTransport,
};
use super::*;
use bacnet_objects::analog::AnalogInputObject;
use bacnet_objects::device::{DeviceConfig, DeviceObject};
use bacnet_objects::traits::BACnetObject;
use bacnet_types::enums::EventState;
use bytes::Bytes;
use std::sync::{Arc as StdArc, Mutex as StdMutex};

#[tokio::test]
async fn dcc_states_preserve_per_write_detection_but_suppress_distribution() {
    for comm_state in [1, 2] {
        let db = db_with_high_limit_transition(0x80);
        let sent = broadcasts_from_per_write_path(&db, comm_state).await;

        assert!(
            sent.is_empty(),
            "DCC state {comm_state} must suppress event notification distribution"
        );
        let db = db.read().await;
        let oid = ObjectIdentifier::new(ObjectType::ANALOG_INPUT, 1).unwrap();
        assert_eq!(
            db.get(&oid)
                .unwrap()
                .read_property(PropertyIdentifier::EVENT_STATE, None)
                .unwrap(),
            PropertyValue::Enumerated(EventState::HIGH_LIMIT.to_raw()),
            "DCC state {comm_state} must not suppress event-state detection"
        );
    }
}

#[tokio::test(start_paused = true)]
async fn dcc_states_preserve_delayed_detection_but_suppress_distribution() {
    for comm_state in [1, 2] {
        let sent = StdArc::new(StdMutex::new(Vec::<Bytes>::new()));
        let transport = RecordingTransport {
            sent_broadcast: StdArc::clone(&sent),
            local_mac: vec![127, 0, 0, 1, 0xBA, 0xC0],
        };
        let mut ai = AnalogInputObject::new(1, "AI-1", 62).unwrap();
        for (property, value) in [
            (PropertyIdentifier::HIGH_LIMIT, 80.0),
            (PropertyIdentifier::LOW_LIMIT, 20.0),
            (PropertyIdentifier::DEADBAND, 2.0),
        ] {
            ai.write_property(property, None, PropertyValue::Real(value), None)
                .unwrap();
        }
        ai.write_property(
            PropertyIdentifier::LIMIT_ENABLE,
            None,
            PropertyValue::BitString {
                unused_bits: 6,
                data: vec![0xC0],
            },
            None,
        )
        .unwrap();
        ai.write_property(
            PropertyIdentifier::EVENT_ENABLE,
            None,
            PropertyValue::BitString {
                unused_bits: 5,
                data: vec![0x80], // TO_OFFNORMAL at wire bit 0
            },
            None,
        )
        .unwrap();
        ai.write_property(
            PropertyIdentifier::TIME_DELAY,
            None,
            PropertyValue::Unsigned(2),
            None,
        )
        .unwrap();
        ai.write_property(
            PropertyIdentifier::OUT_OF_SERVICE,
            None,
            PropertyValue::Boolean(true),
            None,
        )
        .unwrap();
        ai.set_present_value(62.0);
        let oid = ai.object_identifier();

        let mut db = ObjectDatabase::new();
        db.add(Box::new(ai)).unwrap();
        db.add(Box::new(
            DeviceObject::new(DeviceConfig {
                instance: 1,
                name: "Dev".into(),
                ..DeviceConfig::default()
            })
            .unwrap(),
        ))
        .unwrap();
        // A recipient that WOULD be broadcast to, so the empty assertion can
        // only be satisfied by the DCC gate rather than by an unnamed recipient.
        db.add(Box::new(
            super::event_notifications_tests::notification_class_0_broadcasting(),
        ))
        .unwrap();

        let mut server = BACnetServer::start(ServerConfig::default(), db, transport)
            .await
            .expect("server should start");
        server.comm_state.store(comm_state, Ordering::Release);
        server
            .write_local(
                &oid,
                PropertyIdentifier::PRESENT_VALUE,
                None,
                PropertyValue::Real(81.0),
                None,
            )
            .await
            .expect("local Present_Value write should seed delayed detection");

        {
            let db = server.database().read().await;
            assert_eq!(
                db.get(&oid)
                    .unwrap()
                    .read_property(PropertyIdentifier::EVENT_STATE, None)
                    .unwrap(),
                PropertyValue::Enumerated(EventState::NORMAL.to_raw()),
                "DCC state {comm_state} must honor Time_Delay before transitioning"
            );
        }

        tokio::time::sleep(Duration::from_secs(5)).await;

        assert!(
            sent.lock().unwrap().is_empty(),
            "DCC state {comm_state} must suppress delayed event notification distribution"
        );
        {
            let db = server.database().read().await;
            assert_eq!(
                db.get(&oid)
                    .unwrap()
                    .read_property(PropertyIdentifier::EVENT_STATE, None)
                    .unwrap(),
                PropertyValue::Enumerated(EventState::HIGH_LIMIT.to_raw()),
                "DCC state {comm_state} must not pause the Time_Delay countdown"
            );
        }
        server.stop().await.unwrap();
    }
}