As with device objects in other drivers, each McQuayDevice has a Points extension that serves as the container for proxy points. The default view for any Points extension is the Point Manager (in this case, the “McQuay Point Manager”). You use it to add McQuay proxy points under any McQuayDevice.
For general information, see the “About the Point Manager” section in the Drivers Guide.
Unlike the point managers in many other drivers, the McQuay Point Manager does not offer a “Learn mode” with a button and pane. The simplicity of the McQuay OPM protocol excludes these functions. Instead, you simply use the button to create proxy points, and refer to the appropriate McQuay documentation to specify the register addresses of data items in each device.
To add McQuay proxy points
Once a McQuayDevice is added, you can add proxy points to read and write data. If programming online (and the device shows
a status of “{ok}”), you can get statuses and values back immediately, to help determine if point configuration is correct. Use the following
procedure:
To create McQuay proxy points in a device:
In the Device Manager, in the Exts column, double-click the Points icon
in the row representing the device you wish to create proxy points.
This brings up the McQuay Point Manager.
(Optional) Click the button to create a new points folder to help organize points, and give it a short name, such as “Analog Inputs”, or whatever name works for your application. You can repeat this to make multiple points folders, or simply skip this step to make all proxy points in the root of Points.
Note that each points folder has its own McQuay Point Manager view, just like Points. If making points folders, double-click one to move to its location (and see its point manager).
At the location needed (Points root, or a points folder), click the button.
The New points dialog appears, in which you select a point “Type” and “Number to Add”.
For more details on adding proxy points, see Adding McQuay proxy points.
Click .
This brings up another New dialog to name the point(s), enter register hex address, and specify data length in number of registers. Additional properties are also available for editing, if needed (sometimes Conversion type should be changed, for example).
Default point names are similar to: “<PointType>”, for example: “McQuayAI” or “McQuayEnum”.
![]()
Refer to the appropriate McQuay document for valid (hex) register addresses for specific data items, along with data length—most items are one (1) but sometimes two (2) or more registers in length.
Point type “McQuay Enum” provides read-only access to one of 6 different enumerated values in the device, chosen only by “EnumType”. Do not enter values in “Register Hex” or “Data Len Registers”.
Again, find more details on this step in Adding McQuay proxy points.
Click to add the proxy point(s) to the Points extension (or to the current points folder), where each shows as a row in the point manager.
Each point should have a status of “{ok}” with a polled value displayed.
If a point shows a “{fault}” status, check its ProxyExt “Fault Cause” property value.
In such a case, re-check the address in the point against the documented address for the data item.
Except for McQuay Enum points, values displayed reflect raw values, typically 0 - 255. Sometimes for AI and AO points you must apply scale and offset values.
Do this by editing a point’s Conversion property, selecting Linear.
In the Scale and Offset fields, enter the appropriate values, per McQuay documentation.
As needed, set the Facets property for each AI, AO, BI, and BO proxy point (Enum proxy points automatically use an appropriate frozen facet).
Continue to add proxy points as needed under the Points extension of each McQuayDevice.
As needed, double-click one or more existing points for the Edit dialog, similar to the New dialog used to create the points. This is commonly done for re-editing items like register addresses, names, and so on.
Copyright © 2000-2016 Tridium Inc. All rights reserved.