After you specify a Point by Address description using the Point by Address dialog box, a completed description will be returned to the Edit field. This description is specified as a string of keywords and values, proceeded by the at sign (@) and delimited by the vertical bar character ( | ). Point by Address descriptions may be fully qualified with a project name before the @ sign. The following are some sample Point by Address descriptions:
@DEVICE=MY_DEVICE|ADDR=%R100
\\MYPROJECT\DEVICE=DEV1|ADDR=%M100|TYPE=BOOL
|
Keywords supported for Point by Address descriptions. |
|
|
Keywords not acceptable as Point by Address descriptions. |
Keywords supported for Point by Address descriptions
The following keywords are supported for Point by Address descriptions:
|
Keyword |
Description |
||
|
DEVICE |
Required |
Any valid CIMPLICITY device identifier |
|
|
ADDR |
Required |
A valid device address for the specified device |
|
|
TYPE |
Optional |
Any valid CIMPLICITY point type. If you do not use this keyword, the default is INT. |
|
|
SCAN |
Optional |
Multiple of the device scan rate at which the data will be collected. If you do not use this keyword, the default is one (1). |
|
|
OFFSET |
Optional |
Bit offset for the address of BOOL, BYTE, or WORD points. If you do not use this keyword, the default is zero (0). |
|
|
ACCESS |
Optional |
Either READ or WRITE. If you do not use this keyword, the default is READ. |
|
|
ELEM |
Optional |
The number of elements (for an array). If you do not use this keyword, the default is one (1). |
|
|
ORIGIN |
Optional |
The point's origin. Use one of the following: |
|
|
|
|
Origin |
For a: |
|
|
|
DEV |
Device point |
|
|
|
DIA |
Diagnostic point |
|
|
|
ALW |
Ethernet Global Data point |
If you do not use this keyword, the default is DEV.
The keywords may be specified in any order, but the required keywords must be included. Thus, the following are acceptable Point by Address descriptions:
@TYPE=BOOL|DEVICE=DEV03|ADDR=%R100|OFFSET=3|ELEM=4
@ADDR=%R100|DEVICE=DEV04|TYPE=REAL|SCAN=4|ACCESS=WRITE
@DEVICE=DEV05|ADDR=%M100
Keywords not acceptable as Point by Address descriptions
The following are not acceptable Point by Address descriptions:
|
@ADDR=%R100|TYPE=INT |
(no device specified) |
|
@DEVICE=MYDEV |
(no device address specified) |
|
DEVICE=MYDEV|ADDR=%R100 |
(missing @ sign) |
|
@DEVICE=DEV99|ADDR=%R1|OFFSET=4 |
(integer point types cannot have a device address offset) |
Within a point expression, Point by Address descriptors must be quoted; thus, you could display the sum of two registers in CimView:
'@DEVICE=MYDEV|ADDR=%R10' + '@DEVICE=MYDEV|ADDR=%R11'
|
|
Point by address in CimEdit. |
