 |
ALPHA-VISION® API-Interface to Technology program: FC167 |
FC167
SUMMARY
The AbvSpu provides functions to read and write process attributes (status, measuring value, alarm information) as well as to control process parameters (limits, delay times, etc.).PARAMETERS (IN)
- obj (INT)
- Object Number
PARAMETERS (OUT)
- iVal (DINT)
- Value as 32bit-Integer
- rVal (REAL)
- Value as 32bit-Real digit
- bVal (BOOL)
- Value as 0/1-Signal
- bOk (BOOL)
- 1=okay, 0=error
PARAMETERS (IN_OUT)
DESCRIPTION
GetValue_ex() - Reads actual value.Returns the value of the object referenced by <obj>.
The function is defined for Measuring Points (MP) and Process Variables (PV).
- For MP-Objects the value <obj.val> is returned.
- For PV-Objects of the types <Bit/Byte/Word/Dword/Real> the value <obj.val> is returned.
- For PV-Objects of the type <String> the string length <obj.strlen> is returned.
- The value/String length is returned as <DINT/REAL/BOOL>.
- In case of an error <bOk=0> is returned.
- Possible errors: Invalid Object Number.
Internally the value of MPs are stored as real digit, that also applies for PVs of the format <REAL>. The return values of <bVal> and <iVal> are calculated from the REAL-Value.
- <bVal> is 'false' for <rVal=0.0>, apart from that it is always 'true'.
- <iVal> is the integer part of <rVal>.
For PV-Objects of the formats <BIT/BYTE/WORD/DWORD> the value is stored as a INTEGER internally. The return value <bVal> and <rVal> are calculated from the INTEGER-Value.
- <bVal> is 'false' for <iVal=0>, apart from that it is always 'true'.
- <rVal> is the to REAL converted INTEGER value <iVal>.
Description of the Output Parameters
| Objekt/Signaladresse | bOk | bVal | iVal | rVal |
|---|---|---|---|---|
| Bin-MS (A) | 1 | true/false | 1/0 | 1.0/0.0 |
| Bin-MS (DBX) | 1 | true/false | 1/0 | 1.0/0.0 |
| Bin-MS (E) | 1 | true/false | 1/0 | 1.0/0.0 |
| Ana-MS (PEW) | 1 | true/false | L#-2147483648 bis L##2147483647 |
-3.402823e+38 bis +3.402823e+38 |
| Ana-MS (PAW) | 1 | true/false | L#-2147483648 bis L##2147483647 |
-3.402823e+38 bis +3.402823e+38 |
| Ana-MS (DBD) | 1 | true/false | L#-2147483648 bis L##2147483647 |
-3.402823e+38 bis +3.402823e+38 |
| Ana-MS (DBW) | 1 | true/false | L#-2147483648 bis L##2147483647 |
-3.402823e+38 bis +3.402823e+38 |
| PV (DBX) | 1 | true/false | 1/0 | 1.0/0.0 |
| PV (DBB) | 1 | true/false | 0 ... 255 | 0.0 ... 255.0 |
| PV (DBW) | 1 | true/false | 0 ... 65535 | 0.0 ... 65535.0 |
| PV (DBD, int) | 1 | true/false | L#-2147483648 bis L##2147483647 |
-2.147e+009 bis +2.147e+009 |
| PV (DBD, real) | 1 | true/false | L#-2147483648 bis L##2147483647 |
-3.402823e+38 bis +3.402823e+38 |
| PV (DBW, string) | 1 | true/false | 0 ... 65535 | 0.0 ... 65535.0 |