Using the Workbench to define a Stanley Tools device
The Workbench provides the view into a node's installation, configuration and resource definition. The Workbench also provides access and control over those resources.
A device is a resource that can represent a physical device, such as a Stanley Tools controller, an RF tag reader or a sensor. A device can also be defined in one node to represent a device that is defined and supported in another node. This allows your application solution to have access to devices and their data independent of their location or connectivity details.
The following devices can be defined with the Stanley Tools driver:
- QPM family of controllers
The Stanley Tools driver follows a subscription/publish model, where the driver registers subscriptions with the Stanley Tools controller and the controller publishes messages to the driver for events that occur that match the subscription. There are certain messages that the driver will always subscribe to, the Tightening/Rundown event messages and Job Information messages. The definition panel allows the user to optionally configure the driver to receive other messages that are published by the controller. An example of this would be a change of PSET. The driver by default will subscribe to receive notification when a PSET is changed on the Stanley Tools controller. When notified of a PSET change, the driver will then query the controller for the details of the PSET that is currently active. This information is stored in memory and can be viewed on the Using the Variables window to access Stanley Tools device variables This information maybe of interest, but along with it comes the overhead of additional messages that will flow back and forth between the driver and the Stanley Tools controller. It is recommended that unless there is a business reason to receive this additional information from the controller, the subscriptions for the optional items should be turned off.
To define a device that represents a Stanley Tools device, follow these steps:
- From the Workbench left pane, expand the node where you want to define the device.
-
Right-click on Devices and click New
The Device window appears. The available device types are determined by the device support that is installed in this node. - Use the Type down-arrow, to select a device type under the Stanley Tools group.
-
The Device window changes to accommodate the selected device type.
-
To define a device that represents a Stanley Tools controller, set this new device’s parameters as follows:
Parameter Description Name Enter a name for the Stanley Tools controller. Type Select the type of the Stanley Tools controller. Select QPM to communicate with a QPM controller. IP Address Enter the IP Address of the Stanley Tools controller. Port Enter the port number used by the controller. The default value of 4545 should be used in most cases. Revision Level This is the Open Protocol revision level of the MID0061 trigger pull messages that the device will support. The Stanley Tools driver only supports revision level 3. Spindle The QPM type supports Single spindle configurations. The MID0061 message will be sent from the Stanley Tools controller. Keep Alive Enter a value between 3 and 14. This is the amount of time, in seconds, the driver will wait before sending out a heart beat message to the controller. The heart beat message is sent if there is no activity between the Stanley Tools driver and the Stanley Tools controller, within the Keep Alive time frame. Device Timeout Enter the timeout value to use when communicating with this device. This is entered in milliseconds. VIN or Identifiers Subscription Turn on the subscription to receive information whenever either a VIN is changed on the controller or one of the four Identifiers is changed. The default value is to subscribe to change of VIN controller events. Please note that VIN information is sent from the controller to the driver within the MID0061 messages, even if the subscription is turned off for VIN or Identifiers. PSET Subscription Turn on the subscription to receive information whenever a PSET is changed on the controller. The default value is to subscribe to receive change of PSET messages. Job Detail Subscription Turn on the additional request for Job Detail information. The driver will always register a request for Job Change notifications. The driver will in turn request details on the current active Job on the controller. Setting this value to Do not subscribe will eliminate the request for details message sent by the driver. The default value is to request the Job detail information. When you select Request Job Detail Option will activate the In A Job setting on the Stanley QPM Controller. If In A Job is true, the controller returns information regarding TASKS rather than PSETS or Jobs. This will affect the execution of the Select Parameter Set action and will also affect the values of the Active Parameter Set variables. For more information on Active Parameter Set variable, see Using the Variables window to access Stanley Tools device variables.Alarm Subscription Turn on a request to receive alarm notifications. Setting this value to Controller Alarm Notification to receive notifications from the controller when an alarm condition has been encountered. Retrieve Missed Messages Turn on the subscription to receive Single Spindle tightening messages that occurred when the device was not connected to the Stanley Tools controller. Setting this value to Yes will activate a process when the device is started, which will determine if any MID0061 Tightening messages have not been sent to this node. Requests will then be made to the Stanley Tools controller to send information about those missed messages. The controller sends replies in the form of a MID0065 message. Enable Diagnostics This field allows the user to turn on the collection of Diagnostic information. The default value is No meaning Diagnostic information will not be collected. Turning on collection of Diagnostic information adds overhead to a started Stanley Tools device. Trace Curve Subscription Turn on the subscription to receive Trace Curve data. The Trace Data is the information that tracks the actual spinning of the tool, providing the torque and angle values over that time. With that information the user can plot the torque/angle over time as well as angle over torque and vice versa to give a visual representation that should be consistent with each tightening. If the visual begins to vary, then the user can see that the tool is starting to come out of alignment and will need maintenance. The default value is No meaning that the information will not be sent to the driver when a rundown occurs. Queue Timeout Whenever an action triggers it is put on a queue.The queue is processed one item at a time. After an item is processed the thread sleeps for the time defined in queue timeout. Per Variable Security Select False to disable the allocation of additional memory to track User to Variable access for all Variables in this Device. Select True to enable this feature if required. For more information, see Setting up Read Write per device variable.