knxnetIp-KnxNetwork

This component is the base container for all KNXnet/IP devices and their child data objects (KNX proxy points).
Figure 21.   KnxNetwork Property Sheet
Image
Property Value Description
Status read-only Indicates the condition of the component at the last check.

{ok} indicates that the component is licensed and polling successfully.

{down} indicates that the last check was unsuccessful, perhaps because of an incorrect property, or possibly loss of network connection.

{disabled} indicates that the Enable property is set to false.

{fault} indicates another problem. Refer to Fault Cause for more information.

Enabled true or false (defaults to true) Activates and deactivates use of the component.
Fault Cause read-only Indicates the reason why a system object (network, device, component, extension, etc.) is not working properly (in fault). This property is empty unless a fault exists.
Health read-only Indicates the status of a system object (network, device or component) in the station. Includes a timestamp.
Alarm Source Info additional properties Contains a set of properties for configuring and routing alarms when this component is the alarm source.
Monitor Ping Monitor Configures a network's ping mechanism, which verifies network health. This includes verifying the health of all connected objects (typically, devices) by pinging each device at a repeated interval.
Tuning Policies Tuning Policy Map Refer to Tuning Policies/Default Policy.
Poll Scheduler Knx Poll Scheduler Refer to knxnetIp-KnxPollScheduler.
Local Interfaces Local Interfaces Refer to knxnetIp-LocalInterface.
Knx Data Defs Additional properties Refer to knxnetIp-KnxStationDataDefs.

Tuning Policies/Default Policy

The network Tuning Policies holds one or more collections of rules for evaluating both write requests (for example, to writable proxy points) as well as the acceptable freshness of read requests from polling.This is the default tuning policy which is always installed. More tuning policies may be created by copying and editing this default policy.

Figure 22.   Tuning Policies, Default Policy properties
Image
Property Value Description
Min Write Time hh-mm-ss, 0ms ... +inf Defaults to 00–00–00 Specifies the minimum amount of time allowed between writes to writable proxy points, thus providing a method to throttle rapidly changing values so that only the last value is written.

A value of zero (0) disables this rule causing all value changes to attempt to write.

Max Write Time hh-mm-ss, 0ms ... +inf Defaults to 00–00–00 If nothing else triggers a write, this property specifies the maximum amount of time to wait before rewriting the value to the point. Any write action resets this timer.

The default (zero) disables this rule resulting in no timed rewrites.

Write On Start true (default) or false Defines a writeable proxy point’s behavior at station startup.

true initiates a write when the station first reaches a steady state.

false prevents a write when the station first reaches a steady state.

Consider setting this to false for most tuning policies, except for those selectively assigned to more critical writable proxy points. This is particularly important for large networks with many writable proxy points. For example, a Network with 4,000 writable proxy points, if configured with only the default tuning policy (at default values), will upon station startup attempt to write to all 4,000 points, putting a significant load on the station. As a consequence, the driver (network) may generate write queue overflow exceptions.
Write On Up true (default) or false Defines a writeable proxy point’s behavior when the point and its parent device transition from down to up.

true initiates a write when the transition occurs.

false prevents a write when the transition occurs.

Write On Enabled true (default) or false Defines a writeable proxy point’s behavior when its status transitions from disabled to enabled.

true initiates a write when the transition occurs.

false prevents a write when the transition occurs.

The disabled-to-enabled status transition can be inherited globally by points if the parent device had been set to disabled—or network-wide if the driver network was set to disabled. Therefore, be aware that if left at true, all associated writable points receive a write upon either the device or network when it transitions from status disabled to enabled.
Stale Time hh-mm-ss, 0ms ... +inf Defaults to 00–00–00 Defines the length of time after which the data for a point in the station database is considered to be too old to be meaningful (stale).

A non-zero value causes the point to become stale (status stale) if the configured time elapses without a successful read, indicated by Read Status {ok}.

Zero disables the stale timer. Points become stale immediately when unsubscribed.

By default, the system indicates a stale proxy point status by a tan background color. In addition, stale status is considered invalud for any downstream-linked control logic.