BACnet Knowledgebase

i4BACnet Service Settings

Abstract

Here is the list of the i4BACnet Service Settings that need to be organised before starting to use the software.

As soon as the installation steps for i4BACnet have been finished system will open in your default browser the Service Settings page. 

Service may be configured at any point, under http://localhost:5000/settings/edit.

BACnet_service_settings.jpg

BACnet Service Settings

Following fields can be configured in this view:

  • InstanceNumber -This is the BACnet instance number for the virtual device associated with the BACnet service.  Two devices must not have the same number. The field InstanceNumber must contain values between 0 and 4194303.

  • CharSet - Character Setting

  • NetworkNumber -The field stands for the network number, used for broadcast of WhoIs requests. The network number represents the high-order bits portion of an IP Address. 

  • PortId - This field is required. It represents the BACnet port number, used by the BACnet Service.

  • Segmentation - Stands for the segmentation in BACnet protocol, for both transmit and receive. This field is required.

  • SegmentTimeout - This field is also required. Here, you can define the timeout in ms/s/min/hr, etc, of one segment in the BACnet protocol. 

  • Timeout - Field is required and it defines the timeout in ms/s/min/hr, etc, in BACnet protocol.

  • LifetimeCOV - The lifetime of COV (change of value) subscriptions, described in milliseconds, after which subscriptions will be recreated. The LifetimeCOV field is required.

  • BrokerUrl - The url of broker with which the service will communicate. The BrokerUrl field is required.  The default value points to a local broker installation. Change this field if the broker runs in a different location. 

  • ClientTsmPoolSize - This required field defines the size of the client TSM pool. The pool size, determines the maximum number of outstanding client confirmed requests. The field ClientTsmPoolSize must be between 1 and 65535.

  • ServerTsmPoolSize - The server TSM pool field is required. The pool size, determines the maximum number of incoming confirmed requests that the application can execute concurrently. The field ServerTsmPoolSize must be between 1 and 65535.

  • MaxMessageSizeInBytes - The maximum size in bytes of messages sent from client to the server via WebSockets. The default value is 10485760 bytes (10 MB).

  • ProcessMeasurementsBufferIntervalInMilliseconds - The buffer interval to wait to receive measurements and process them after the interval elapses. The default value is 50 milliseconds.

  • SelfDiscovery - If this field is checked, the BACnet Service will also discover itself as a device during the discovery process. 

  • CheckAvailablePropertiesOnServer - If this field is checked, a separate request will be sent, to check which Object properties are available on server.  

  • PollingInterval - The system monitoring frequency. The user is provided with a set of predefined options, available in a drop-down list: 100 milliseconds, 200 milliseconds, 500 milliseconds, 1 second, 2 seconds, 3 seconds and 10 seconds.

  • KestrelLimitsMinRequestBodyBytesPerSecond - The minimum rate in bytes/second at which data should be processed for a request. The default value is 240.

  • KestrelLimitsMinRequestBodyGracePeriodSeconds - The amount of time to delay enforcement of bytesPerSecond, starting at the time data is first read or written for a request. The default value is 5 seconds.

  • KestrelLimitsMinResponseBytesPerSecond - The minimum rate in bytes/second at which data should be processed for a response. The default value is 240.

  • KestrelLimitsMinResponseGracePeriodSeconds - The amount of time to delay enforcement of bytesPerSecond, starting at the time data is first read or written for a response. The default value is 5 seconds.

  • DelayPollingDuringSubscription - Whether the polling should be delayed during a subscription operation (subscribe or unsubscribe). The default value of this property, is true.

  • CheckRunningSubscriptionsIntervalMilliseconds - The timer's interval (in milliseconds) to check if there is a subscription operation (subscribe or unsubscribe) running. The default value is 5000 milliseconds (5 seconds).

  • RemoveLongRunningSubscriptionIntervalMilliseconds - The interval (in milliseconds) allowed for a subscription operation (subscribe or unsubscribe) to run. After this interval, the polling is no more delayed. The settings is per operation (subscribe or unsubscribe). The default value is 3000 milliseconds (3 seconds). Remark: the subscription operation it not cancelled, but the polling is no longer delayed and can execute in parallel with subscription.

  • ProcessDeviceDiscoveryBufferIntervalMilliseconds - The buffer interval to wait for device discovery data and process data after the interval elapses. The default value is 3000 milliseconds (3 seconds).

  • PerformSubscriptionsIntervalMilliseconds - The interval to check if there are new subscription requests coming from the consumers to be sent to the devices. The default value is 1000 milliseconds (1 second).

  • SubscriptionsChunkSize - The length of a chunk of subscriptions (subscribe/unsubscribe operations) to be sent to a device. The default value is 100 subscriptions.

  • WaitBetweenChunksIntervalMilliseconds - The interval to wait between consecutive calls (sending subscriptions) to a device. The default value is 100 milliseconds.

  • InitialDelayWhIs - The interval to wait before boadcasting the first WhoIs message, in the network, after the BACnet Service is turned on. The default value is 5000 milliseconds (5 seconds). The reason to delay the first WhoIs message, is to allow a proper initialization and stabilization of the network.

  • PeriodToWaitForIAmAfterWhoIs - The interval to wait for BACnet devices to respond with IAm. The default value is 10000 milliseconds (10 seconds).

  • PeriodToWaitForAnotherWhoIs - The interval to wait before the next WhoIs message is broadcast in the network. The default value is 20000 milliseconds (20 seconds).

  • PollStrategy - The system monitoring strategy type to use for polling subscription type. The user can select the desired strategy from the drop-down list, choosing from the following options:

    • DevicesSequentiallyPropertiesOneByOne - during the polling cycle, devices are read sequentially and the properties are handled one by one.

    • DevicesInParallelPropertiesInBatch - during the polling cycle, devices are read in parallel and the properties are handled in one batch. This strategy is set as default.