Niagara Cloud Network (nCloudDriver-NiagaraCloudNetwork)

This component is a container for most components required for communicating with the cloud. This component provides logical organization for many types of cloud platforms.

The NiagaraCloudNetwork structure, shown here, adheres to the standard driver framework utilities built into Workbench. The overall intent is to provide generic Niagara components that can be used to accomplish specific goals without having to program in cloud platform provider-specific terms. Such specifics are held within the CloudDevice in what is known as a “concrete cloudFactory” and are used by the child device extensions as needed.

This component is available in the nCloudDriver palette. The Cloud Device Manager is the default view of this component.

Figure 36. Niagara Cloud Network properties

To access these properties, expand Config > Drivers, right-click NiagaraCloudNetwork and click Views > Ax Property Sheet.

In addition to the standard properties (Status, Enabled, Fault Cause, Health and Alarm Source Info), these properties are unique to this component.

Name	Value	Description
Monitor	additional properties	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. The Niagara Drivers Guide documents these properties.
Tuning Policies	additional properties	Holds the tuning policies governing the behavior of cloud proxy points with respect to communication to the cloud. For details see, Tuning Policies properties.
Point Read Allowed	`true`, `false` (default)	Must be set to “true” if point read commands are sent from the cloud.
Point Write Allowed	`true`, `false` (default)	Must be set to “true” if point write commands are sent from the cloud.

Tuning Policies properties

NOTE: The Point Subscription Period property, described below, is available starting in Niagara 4.10u2 and later versions.

Figure 37. Tuning Policies Property Sheet view

In addition to the common properties (Min Write Time, Max Write Time, Stale Time) the following properties are available.

Name	Value	Description
Write On Start	true (default), false	Determines behavior of writable proxy points at station startup. This property applies to the Default Policy, Priority and Background tuning policies. If “true”, (default) a write occurs when the station first reaches steady state. If set to “false”, a write does not occur when the station reaches steady state. Consider setting this to false in most tuning policies, except for tuning policies selectively assigned to more critical writable proxy points. This is particularly important for large networks with many writable proxy points.
Write On Up	true (default), false	Determines behavior when writable proxy point (and parent device) transitions from “down” to “up.” This property applies to the Default Policy, Priority and Background tuning policies. If “true”, (default) a write occurs when the parent device transitions from down to up. If set to “false”, a write does not occur when the parent device transitions from down to up
Write On Enabled	true (default), false	Determines behavior when a writable proxy point’s status transitions from disabled to normal (enabled). This property applies to the Default Policy, Priority and Background tuning policies. If “true”, (default) a write occurs when writable point transitions from disabled. If set to “false”, a write does not occur when writable point transitions from disabled. 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 in tuning policies, that all associated writable points receive a write upon either the device or network when it transitions from status disabled to enabled.
Update Group	`fast`, `normal` (default), `slow`	Specifies the update frequency for batch point updates. For the Default Tuning Policy, specifies the period for normal (standard) batch point updates. Default setting is 5 minutes. Minimum limit is 1 minute. For the Priority Tuning Policy, specifies the period for priority batch point updates. The default setting is 30 seconds. Minimum limit is 5 seconds. For the Background Tuning Policy, specifies the period for background batch point updates. The default setting is 15 minutes. Minimum limit is 5 minutes.
Require Change For Update	`true`, `false`	Specifies whether this point must have a value change to be included in batch update.
Numeric Change Tolerance	numeric	Specifies the minimum change that will cause a numeric point to be included in batch update, if the Require Change For Update property is “true”. Boolean, String, Enum points do not have a change tolerance; any change drives an update. For any point type, including Numeric Points, any change of point status will add the point to the batch update regardless of the point value.
Subscribe Source Point	`true`, `false` (default)	Flag for controlling whether the source point is forced into subscription by the CloudProxyPoint. If set to “false” (the default value) it will not affect whether the source point is subscribed. When set to “true” it causes the CloudProxyPoint to force a permanent subscription of the source point. NOTE: Setting this property to “true” may affect the performance of the driver network containing the source point.
COV Mode Duration	`+00000h 10m 00s` (default)	Specifies how long COV points will stay in COV before exiting COV mode.
Priority For COV	`High` (default), `Low`	Specifies whether COV messages will be sent with high or low priority.
Default Priority	`none`, `in1` through `in16`, `fallback`	Starting in Niagara 4.9 (NCHSD 2019.2), this property is used to configure the priority for writes incoming from the cloud, when using System Command writes, and the Priority parameter is not present.
Default Duration	`true`, `false` (default)	Starting in Niagara 4.9 (NCHSD 2019.2), this property is used to configure writes incoming from the cloud, when using System Command writes and the `Duration` parameter is not present.
Point Subscription Period	`+00000h 5m 00s` (default)	If the `Subscribe Source Point` property is set to `false`, then on live value read using Honeywell Cloud Sentience APIs, respective source points are added to the Niagara subscription (if not already subscribed) for this specified period of time. Once the time expires, the points are automatically unsubscribed. NOTE: The nCloudDriver adds the points to Niagara subscription on live value read. Based on the tuning policy configuration of underlying drivers, the polling or COV mechanism is used to get the value from the remote devices. If the subscription time is set to +0000h 0m 00s, the points will not be subscribed through the nCloudDriver on live value read using Honeywell Cloud Sentience APIs.