Unitary

Pre-APOGEE

APOGEE

BACnet

PXC.A

●

●

●

●

●

Syntax for PXC.A controllers

SET(cmdPriority)

cmdPriority

An optional command priority specifier. cmdPriority may be specified as @1 through @16, indicating priorities 1 (highest) through 16 (lowest).

If cmdPriority is not specified when writing a commandable object, the program's PPCL Program Priority value shall be used.

SET(srcValSpec)

srcValSpec

A specifier for the value to write to the set of object properties. srcValSpec may be passed in as:

- A literal numeric value (for example, 1.0, -50)

-  A reserved word specifying binary or multistate objects/bundled points

-  An object reference (for example, BAC_7_AO_11, KwMeter)

SET(targObjRefs)

targObjRefs

A specifier for the target object(s) of the set operation. Multiple objects may be specified. The same priority slot will be written in each target object. A targObjRef may be passed as an object reference (for example, BAC_7_AO_11, KwMeter).

Use

The update SET() statement writes the present-value property of a specified object instance. For commandable properties, SET() has been modified to support BACnet command prioritization.

Notes

  • Database migration tools should automate the transformation of Apogee proprietary priorities to BACnet priorities.
  • In general, the program should limit itself to commanding at its specified priority as defined by the PPCL Program Priority property.
  • If the PXC.A automation station is unable to resolve one or more object references, whether the reference is specified in valueSpec or one of the objrefs, the PPCL line will be marked unresolved.
  • The SET command is not always resolved to the actual value, which may result in points being continuously commanded. To prevent unnecessary MS/TP traffic, use a deadband.
    For example:
    10  LOCAL(cmd, diff, deadband)
    20  $deadband = 0.3
    30  $cmd = 77
    40  $diff = bac_771037_ao_79-$cmd
    50  IF ($diff.GT.$deadband .OR. $diff .LT. -($deadband)) THEN SET($cmd, bac_771037_ao_79)

Syntax for Legacy controllers

SET(value,pt1,...,pt15)

value

Value to which points are commanded.

-  This value can be a decimal, a logical point, or a local variable. Integers are not allowed.

pt1 through pt15

Point names of logical points.

SET(@prior, value, pt1,...,pt14)

@prior

Defines a specific point priority.

value

Value to which points are commanded. This value can be a decimal, a logical point, or a local variable. Integers are allowed in APOGEE firmware.

pt1 through pt14

Point names of LAO or LDO, L2SL, L2SP, LOOAL, LOOAP, LFSSL, LFSSP, and LPACI point types.

NOTE:
The SET(@prior) command is not available in Unitary firmware.

Use

Changes output points to a new value.

  • Acceptable point types are: LAO or LDO, L2SL, L2SP, LOOAL, LOOAP, LFSSL, LFSSP, and LPACI.
  • A maximum of 15 points can be changed with one SET command.
  • A maximum of 14 points can be changed with one SET(@ prior…) command.

Example 1

450  SET(75.0,RMSET1,RMSET2,RMSET3)

Example 2

550  SET(@EMER,75.0,RMSET1,RMSET2,RMSET3)

Notes

Do not use resident points in either the SET or the TABLE command. With both the SET and TABLE commands, the following should be used for resident points:

Virtual point = Resident point