Skip to main content

ServerConfig

Struct ServerConfig 

Source
pub struct ServerConfig {
Show 17 fields pub interface: Ipv4Addr, pub port: u16, pub broadcast_address: Ipv4Addr, pub max_apdu_length: u32, pub segmentation_supported: Segmentation, pub vendor_id: u16, pub cov_retry_timeout_ms: u64, pub on_time_sync: Option<Arc<dyn Fn(TimeSyncData) + Send + Sync>>, pub life_safety_operation_authorizer: Option<LifeSafetyOperationAuthorizer>, pub audit_notification_sink: Option<ObjectIdentifier>, pub audit_notification_authorizer: Option<AuditNotificationAuthorizer>, pub unconfirmed_audit_notification_authorizer: Option<UnconfirmedAuditNotificationAuthorizer>, pub dcc_password: Option<String>, pub reinit_password: Option<String>, pub enable_fault_detection: bool, pub enable_event_enrollment: bool, pub event_enrollment_interval_secs: u64,
}
Expand description

Server configuration.

Fields§

§interface: Ipv4Addr

Local interface to bind.

§port: u16

UDP port (default 0xBAC0 = 47808).

§broadcast_address: Ipv4Addr

Directed broadcast address.

§max_apdu_length: u32

Maximum APDU length accepted.

§segmentation_supported: Segmentation

Segmentation support level.

Enforced, not just advertised: the dispatch loop reassembles inbound segmented requests only under BOTH/RECEIVE and transmits segmented responses only under BOTH/TRANSMIT (Clauses 5.4.5.1 and 5.4.5.3); anything else draws a SEGMENTATION_NOT_SUPPORTED Abort. The default is NONE, so a default-configured server refuses segmented traffic in both directions — set this to what the device should actually honor.

§vendor_id: u16

Vendor identifier.

§cov_retry_timeout_ms: u64

Timeout in ms before retrying a failed confirmed COV notification send (default 3000ms).

§on_time_sync: Option<Arc<dyn Fn(TimeSyncData) + Send + Sync>>

Optional observer invoked after a time-synchronization request is accepted.

§life_safety_operation_authorizer: Option<LifeSafetyOperationAuthorizer>

Optional LifeSafetyOperation authorization policy.

Absence is fail-closed: requests receive SERVICES / SERVICE_REQUEST_DENIED before object mutation.

§audit_notification_sink: Option<ObjectIdentifier>

Exactly one explicitly configured Audit Log notification sink.

Absence is fail-closed; the server never selects a sink by database iteration order.

§audit_notification_authorizer: Option<AuditNotificationAuthorizer>

Optional fast, nonblocking ConfirmedAuditNotification authorizer.

Absence, false, or a panic denies the request before mutation.

§unconfirmed_audit_notification_authorizer: Option<UnconfirmedAuditNotificationAuthorizer>

Optional fast, nonblocking UnconfirmedAuditNotification authorizer.

Absence, false, or a panic silently denies the request before mutation.

§dcc_password: Option<String>

Optional password required for DeviceCommunicationControl.

§reinit_password: Option<String>

Optional password required for ReinitializeDevice.

§enable_fault_detection: bool

Enable periodic fault detection / reliability evaluation. When true, the server invokes every object’s opt-in, object-owned reliability evaluation hook every 10 seconds. Stock objects currently inherit the no-op default.

This governs reliability evaluation only. Event Enrollment evaluation is configured separately via enable_event_enrollment.

§enable_event_enrollment: bool

Enable periodic Event Enrollment evaluation (default true).

When true, the server re-reads the property each Event Enrollment object names in its Object_Property_Reference and applies the configured event algorithm. Startup: the task is spawned by start and its first pass runs immediately, then once per interval. Shutdown: stop aborts it and awaits the abort.

This switch governs the evaluation task; it is not the per-object Event_Detection_Enable property of ASHRAE 135-2020 Clause 13.2.2.1. Setting it false stops evaluation without performing the reset that clause requires of a disabled detector (Event_State to NORMAL, with the corresponding timestamp and acknowledgment state), so a device carrying active enrollments will hold whatever state it last detected.

Evaluation is a no-op on databases holding no Event Enrollment objects, so the default is on.

Successful enabled transitions commit Event_State, Acked_Transitions, and Event_Time_Stamps atomically and are then routed through the shared EventNotification sender. Event Enrollment message text remains intentionally absent, and exact event-specific notification values are deferred to the payload projection work.

§event_enrollment_interval_secs: u64

Interval in seconds between Event Enrollment evaluation passes (default 10).

This is a sampling cadence with no basis in ASHRAE 135-2020, which prescribes no evaluation frequency and leaves acquisition of a monitored value a local matter (Clause 12.12). It is not the Time_Delay of an event algorithm, which is how long a condition must persist before a transition is indicated (Clause 13.3) — a coarse interval delays detection and can miss a condition that both appears and clears between two passes.

A value of 0 is clamped to one second. Ignored when enable_event_enrollment is false.

Trait Implementations§

Source§

impl Clone for ServerConfig

Source§

fn clone(&self) -> ServerConfig

Returns a duplicate of the value. Read more
1.0.0 (const: unstable) · Source§

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source. Read more
Source§

impl Debug for ServerConfig

Source§

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter. Read more
Source§

impl Default for ServerConfig

Source§

fn default() -> Self

Returns the “default value” for a type. Read more

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T> Instrument for T

Source§

fn instrument(self, span: Span) -> Instrumented<Self> ⓘ

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
Source§

fn in_current_span(self) -> Instrumented<Self> ⓘ

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = !

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, !>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
Source§

impl<T> WithSubscriber for T

Source§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self> ⓘ
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
Source§

fn with_current_subscriber(self) -> WithDispatch<Self> ⓘ

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more