pub struct BipServerBuilder { /* private fields */ }Expand description
BIP-specific builder that constructs BipTransport from interface/port/broadcast fields.
Implementations§
Source§impl BipServerBuilder
impl BipServerBuilder
Sourcepub fn mutation_policy(self, policy: MutationPolicy) -> Self
pub fn mutation_policy(self, policy: MutationPolicy) -> Self
Select local mutation authorization (default: MutationPolicy::Permissive).
SC mTLS channel/peer authentication is not service authorization; identities
here are claimed link/routed addresses, never certificate principals.
use bacnet_server::{mutation::MutationPolicy, server::BACnetServer};
let builder = BACnetServer::bip_builder().mutation_policy(MutationPolicy::DenyAll);Set opt-in mutation policy. See MutationAuthorizer for callback rules,
the Channel writes of an inbound WriteGroup among them (#1319).
use bacnet_server::server::BACnetServer;
let builder = BACnetServer::bip_builder().mutation_authorizer(|_| false);Source§impl BipServerBuilder
impl BipServerBuilder
Sourcepub fn audit_reporters(self, profile: AuditReportersConfig) -> Self
pub fn audit_reporters(self, profile: AuditReportersConfig) -> Self
Enable the narrow target audit profile; see AuditReportersConfig.
Source§impl BipServerBuilder
impl BipServerBuilder
Sourcepub fn time_sync_policy(self, policy: TimeSyncPolicy) -> Self
pub fn time_sync_policy(self, policy: TimeSyncPolicy) -> Self
Configure opt-in inbound clock restrictions; see TimeSyncPolicy.
Source§impl BipServerBuilder
impl BipServerBuilder
Sourcepub fn dcc_disable_rate_limit(self, limit: Option<DccDisableRateLimit>) -> Self
pub fn dcc_disable_rate_limit(self, limit: Option<DccDisableRateLimit>) -> Self
Limit authorized DISABLE_INITIATION globally; None (default) disables it.
Source§impl BipServerBuilder
impl BipServerBuilder
Sourcepub fn dcc_password(self, password: impl Into<String>) -> Self
pub fn dcc_password(self, password: impl Into<String>) -> Self
Set the password required for DeviceCommunicationControl requests.
Sourcepub fn dcc_source_restriction(
self,
restriction: Option<DccSourceRestriction>,
) -> Self
pub fn dcc_source_restriction( self, restriction: Option<DccSourceRestriction>, ) -> Self
Restrict claimed DCC sources; requires explicit RequirePassword policy.
Sourcepub fn dcc_policy(self, policy: DccPolicy) -> Self
pub fn dcc_policy(self, policy: DccPolicy) -> Self
Select explicit local DCC authorization (default: deny all).
Source§impl BipServerBuilder
impl BipServerBuilder
Sourcepub fn registered_network_port(self, oid: ObjectIdentifier) -> Self
pub fn registered_network_port(self, oid: ObjectIdentifier) -> Self
Select the built-in Network Port that represents this owned NORMAL B/IP link.
Source§impl BipServerBuilder
impl BipServerBuilder
Sourcepub fn request_admission_policy(self, policy: RequestAdmissionPolicy) -> Self
pub fn request_admission_policy(self, policy: RequestAdmissionPolicy) -> Self
Set positive global and peer handler limits, validated before startup.
Source§impl BipServerBuilder
impl BipServerBuilder
Sourcepub fn read_property_multiple_budget(
self,
budget: ReadPropertyMultipleBudget,
) -> Self
pub fn read_property_multiple_budget( self, budget: ReadPropertyMultipleBudget, ) -> Self
Set positive per-service RPM limits, validated before transport startup.
Source§impl BipServerBuilder
impl BipServerBuilder
Sourcepub fn get_alarm_summary_budget(self, budget: GetAlarmSummaryBudget) -> Self
pub fn get_alarm_summary_budget(self, budget: GetAlarmSummaryBudget) -> Self
Set limits validated before transport startup.
Source§impl BipServerBuilder
impl BipServerBuilder
Sourcepub fn atomic_read_file_budget(self, budget: AtomicReadFileBudget) -> Self
pub fn atomic_read_file_budget(self, budget: AtomicReadFileBudget) -> Self
Set AtomicReadFile limits validated before transport startup.
Source§impl BipServerBuilder
impl BipServerBuilder
Sourcepub fn atomic_write_file_budget(self, budget: AtomicWriteFileBudget) -> Self
pub fn atomic_write_file_budget(self, budget: AtomicWriteFileBudget) -> Self
Set AtomicWriteFile payload limits, validated before transport startup.
Source§impl BipServerBuilder
impl BipServerBuilder
Sourcepub fn read_range_budget(self, budget: ReadRangeBudget) -> Self
pub fn read_range_budget(self, budget: ReadRangeBudget) -> Self
Set ReadRange page limits, validated before startup.
Source§impl BipServerBuilder
impl BipServerBuilder
Sourcepub fn get_event_information_budget(
self,
budget: GetEventInformationBudget,
) -> Self
pub fn get_event_information_budget( self, budget: GetEventInformationBudget, ) -> Self
Set GetEventInformation limits, validated before startup.
Source§impl BipServerBuilder
impl BipServerBuilder
Sourcepub fn get_enrollment_summary_budget(
self,
budget: GetEnrollmentSummaryBudget,
) -> Self
pub fn get_enrollment_summary_budget( self, budget: GetEnrollmentSummaryBudget, ) -> Self
Set GetEnrollmentSummary limits validated before transport startup.
Source§impl BipServerBuilder
impl BipServerBuilder
Sourcepub fn broadcast_address(self, addr: Ipv4Addr) -> Self
pub fn broadcast_address(self, addr: Ipv4Addr) -> Self
Set the directed broadcast address.
Sourcepub fn database(self, db: ObjectDatabase) -> Self
pub fn database(self, db: ObjectDatabase) -> Self
Set the object database (transfers ownership).
Sourcepub fn device_binding(self, binding: DeviceBinding) -> Result<Self, Error>
pub fn device_binding(self, binding: DeviceBinding) -> Result<Self, Error>
Register one explicit unicast route for a Device recipient.
Sourcepub fn reinit_password(self, password: impl Into<String>) -> Self
pub fn reinit_password(self, password: impl Into<String>) -> Self
Set the password required for ReinitializeDevice requests.
Set the policy that authorizes inbound LifeSafetyOperation requests.
Sourcepub fn audit_notification_sink(self, sink: ObjectIdentifier) -> Self
pub fn audit_notification_sink(self, sink: ObjectIdentifier) -> Self
Select the only local Audit Log that receives authorized notifications.
Set the fail-closed ConfirmedAuditNotification authorization policy.
Set the fail-closed UnconfirmedAuditNotification authorization policy.
Sourcepub fn enable_fault_detection(self, enabled: bool) -> Self
pub fn enable_fault_detection(self, enabled: bool) -> Self
Enable periodic fault detection / reliability evaluation.
When enabled, every object’s opt-in reliability hook runs every 10 seconds; the default hook is a no-op.
Reliability evaluation only; Event Enrollment evaluation is configured
by enable_event_enrollment.
Sourcepub fn enable_event_enrollment(self, enabled: bool) -> Self
pub fn enable_event_enrollment(self, enabled: bool) -> Self
Enable periodic Event Enrollment evaluation (default true).
Sourcepub fn event_enrollment_interval_secs(self, secs: u64) -> Self
pub fn event_enrollment_interval_secs(self, secs: u64) -> Self
Set the interval in seconds between Event Enrollment evaluation passes (default 10).
Sourcepub fn segmentation_supported(self, segmentation: Segmentation) -> Self
pub fn segmentation_supported(self, segmentation: Segmentation) -> Self
Set the segmentation support this device advertises and enforces.
The dispatch loop honors the advertisement (Clause 5.4.5.1): inbound
segmented requests are reassembled only under BOTH or RECEIVE, and
draw a SEGMENTATION_NOT_SUPPORTED Abort otherwise. The default is
NONE.
Sourcepub fn vendor_id(self, id: u16) -> Self
pub fn vendor_id(self, id: u16) -> Self
Set the vendor identifier advertised in I-Am responses.
Sourcepub fn discovery_policy(self, policy: DiscoveryPolicy) -> Self
pub fn discovery_policy(self, policy: DiscoveryPolicy) -> Self
Set the discovery rate-limiting and duplicate suppression policy.
Sourcepub fn cov_policy(self, policy: CovPolicy) -> Self
pub fn cov_policy(self, policy: CovPolicy) -> Self
Set the COV quota and notification work budget policy, checked by
CovPolicy::validate before transport startup.
Sourcepub async fn build(self) -> Result<BACnetServer<BipTransport>, Error>
pub async fn build(self) -> Result<BACnetServer<BipTransport>, Error>
Build and start the server, constructing a BipTransport from the config.