You can provide access to fieldbus, HART, and PROFIBUS DP device methods from DeltaV Operate pictures using the AMSMenu application. The AMSMenu application is available with the licensed version of AMS Device Manager. The application opens a menu that allows access to device methods, device views, installed SNAP-ONs and the AMS Device Manager Audit Trail. This topic describes how to develop a script that calls the AMSMenu application.
The command line for the AMSMenu application has two forms which take different command line parameters.
In the following form, the AMSMenu application opens the AMS menu for the specified device.
fieldbus syntax
AMSMenu -n <device tag>
HART syntax
AMSMenu -hart <device tag>
PROFIBUS DP syntax
AMSMenu -profibus <device tag>
Alternative AMSMenu command syntax
In the following form, the command provides all the device information so the AMSMenu application does not connect to the DeltaV database and is therefore faster:
fieldbus syntax
AMSMenu -n <device tag> -m <manufacturer id> -t <device type id> -r <revision number> -i <physical device id> -p <host path>
HART syntax
AMSMenu -hart <device tag> -m <manufacturer id> -t <device type id> -r <revision number> -p <host path>
PROFIBUS DP syntax
AMSMenu -profibus <device tag> -p <host path> -id <identifier>
The following table explains the meanings of the parameters in the AMSMenu commands.
| Command line flag | Parameter | Explanation |
|---|---|---|
| -n |
device tag |
The device tag in the DeltaV database |
| -m |
manufacturer id |
The hexadecimal identifier code for the device manufacturer. |
| -t |
device type id |
The unique identifier for the HART device type. This value can be found in the device documentation or on the Properties dialog for the device in DeltaV Explorer device library. |
| -r |
revision number |
Device revision number |
| -i |
physical device id |
Unique identifier for this fieldbus device type. This value can be found in the device documentation or on the Properties dialog for the device in DeltaV Explorer device library. |
| -id |
identifier |
Unique identifier for this device type (for PROFIBUS DP devices). This value can be found in the device documentation or on the Properties dialog for the device in DeltaV Explorer device library. |
| -p |
host path |
The location of the device in the control system in the form: IO1.<card>.<channel_or_port>^<protocol>%%ROC.<controller> Examples: HART — IO1.C05.CH01^HART%%ROC.CTRL1 fieldbus — IO1.C05.P01^FFBUS%%ROC.CTRL1 Profibus — IO1.C05.P01^PFBUS%%ROC.CTRL1 |
For example, if your configuration includes a Fisher Controls DVC 6000 with a device tag of CTLR1C05CH01 that has the following characteristics:
Manufacturer ID: 19 (hex)
Device Type ID: 3 (hex)
Revision Level: 1 (decimal)
Host path: IO1.C05.CH01^HART%ROC.CTLR1
The following script opens the AMS Device Manager menu for the device when a user clicks the object to which the script is attached:
Private Sub Rect1_Click()
frsruntask "AMSMenu", "-hart ctlr1c05ch01 -m 19 -t 3 -r 1 " _
& "-p IO1.C05.CH01^HART%%ROC.CTLR1"
End Sub