Requesting object description
The description of a TASK COM object can be requested by accessing the object with bit identifier 0x30000.
An object is described by the following 84 bytes.
-The description of an object of the task COM can be requested by the bit identifier Object Access (ISGADS_IGR_OBJECT_ACCESS = 0x30000) in the index group-
Data type | Bit | Date | Description |
DWORD | 0-3 | ID | Internal unique ID of an object |
DWORD | 4-7 | Size | Size of object in bytes |
WORD | 8-9 | Write access | TRUE is object is describable. |
WORD | 10-11 | - | Not assigned |
DWORD | 12-15 | Index group | for direct object access to the content |
DWORD | 16-19 | Index offset | for direct object access to the content |
STRING(32) | 20-51 | Name | Name of object |
STRING(32) | 52-83 | Type | Object data type BOOL, BYTE, SINT, WORD, INT, DWORD, DINT, LWORD, LINT, REAL, LREAL, STRING |
The index group = 0x13010<ch> is used for objects of the first channel (<ch> = 1). If several channels are configured, the required channel can be selected accordingly via the logic channel ID [1; max]. The platform data can optionally be addressed under channel ID = 0 or 1.
- Total number of all objects is requested via index offset = 0.
- Reading an object description Index offset > 0 supplies object description with index [1; number of objects]; the return memory must be a total of 84 bytes per object.
Reading several object descriptions with one access
- If exactly a multiple of 84 bytes is provided as return memory, object descriptions are returned in sequence starting from the transferred index.
Example
Example
Index group = 0x130101, index offset = 0 returns the number of objects in the first channel
Index group = 0x130101, index offset = 1 returns the object description in the first object (channel=1)
Example
Requesting a single object description
Index group = 0x130101, index offset = 0x10 supplies a single object description with 84 bytes.
Example listing
- ID= 82 (4 bytes)
- Size = 1 (4 bytes)
- Write access = 0, i.e. read only (2 bytes)
- Free (2 bytes)
- Index group = 0x00120101 (4 bytes)
- Index offset = 0x00000003 (4 bytes)
- Name = mc_active_single_block_r (32Byte)
- Type = BOOL (32 bytes)