R2 ObixExport objects

NOTE: Use of these objects is entirely optional. Many R2 to AX oBIX integrations have not used them, as standard AX Obix proxy points for these specific R2 object types provide “right click command access”, along with value and status. Use is necessary only to permit an “interstation control link”, from AX to the R2 station.

The three “export” objects in the tridiumx/obix jar are available if you want to allow “link control” writes from AX to R2 objects, for example to the “priorityArray” input of an AnalogOutput, BinaryOutput, or MultistateOutput object. In this case, you copy one of objects from the R2 tridiumx/obix jar and paste it into the station, linking its output into the priorityArray input of the R2 object being controlled.

If controlling an AnalogOutput, BinaryOutput, or MultistateOutput, another link is also required—from the statusOutput of the controlled object back to the “feedbackValue” input (fIn) of the export object.

Figure 12. Example ObixAnalogExport object copied into station for linking into AnalogOutput object

Figure 2-3 shows an example of both links, where an ObixAnalogExport object controls an AnalogOutput (“Damper1”).

Figure 13. ObixBinaryExport object copied into station for linking into BinaryOutput (BO) object

Figure 2-4 shows a similarly-linked ObixBinaryExport object used for linking into a BinaryOutput object, “BO_Load1”.

You can also use an export object to link to a “status” type input of an R2 object, for example an input on a Math object (“FloatStatusType”, using an ObixAnalogExport) or on a Logic object (“BooleanStatusType”, using an ObixBinaryExport object). In this case, you simply link the statusOutput (sOut) of the export object into the statusInput of the R2 object, and need not link the “feedbackValue” input of the export object.

Figure 14. ObixAnalogExport object copied into station for use as “statusInput” type value

Figure 2-5 shows an example where an ObixAnalogExport object is used for setpoint control of an R2 Loop object, linked into the Loop’s “sInSet” input.

For any R2 export object you use, you must set up several Config properties, described in the next section, “ R2 Obix Export object properties”. Then in the AX station, you can “discover” this object within station’s ObixClient “lobby,” and add a writable Obix proxy point for it. This allows you to link other AX station logic into the proxy point, as well as invoke actions on that same point.

R2 Obix Export object properties

All three of the R2 Obix export object have these common properties, as found on tabs in their property sheet:

Status

On the Status tab of an Obix export object, find these read-only properties

lastWrite — The last value written by the oBIX Client.
lastWriteTimestamp — The time of the last client write.

Config

On the Config tab of an Obix export object, specify these values accordingly:

priority — The priority to be used for writing values at the prioritizedOutput (defaults to 16).
units (if ObixAnalogExport), or
activeInactiveText (if ObixBinaryExport), or

stateText (if ObixMultistateExport) — In any type of export object, set units, etc. to mirror the units for the linked input on the controlled R2 object.
NOTE: An ObixAnalogExport object has these additional Config properties, described below (see Figure below). Use of these “limit” type properties is optional.
- highLimit — The maximum value that can be written by the oBIX client.
- lowLimit — The minimum value that can be written by the oBIX client.
- limitEnabled — If set to true, high and low limits are enforced on client writes (default is false).
  Figure 15. Config properties for ObixAnalogExport, including “limit” type properties

Any “outside of limit” value that a client attempts write to the R2 object input is rejected, and the last “in-limit” value is retained. For related details on the AX side, see “AnalogExport Limit Notes” on page 2-14.

Engineering

On the Engineering tab of an ObixExport object, find these read-only properties

feedbackValue — If linked, the value returned for client read requests on this object.
prioritizedOutput — Value being written on this “pOut” output.
statusOutput — Value being written on this “sOut” output.