Dtl_c_define – Rockwell Automation 1771-DMC_DMC1_DMC4_DXPS Control Coprocessor User Manual User Manual

Page 171

Advertising
background image

API Library of Routines

Appendix B

DTL_C_DEFINE

B-40

Adds a definition to the DTL data-definition table.

C Syntax

#include <copro.h>

unsigned DTL_C_DEFINE (name_id,data_definition)

unsigned *name_id;
char *data_def;

Parameters

name_id

Use to return a handle assigned by the library to the data.

data_definition

Use to specify the data you wish to access. The data_definition
character string is a null-terminated string composed of arguments
separated by commas.

“data_address,[elements],[CC data_type],[access type]”

data_address

Specifies the starting address of the data item.

The first three data files in the PLC-5 programmable controller are
fixed. When addressing them, do not reference a file number.
Use

I:03

for rack 0 group 3, for example, not

I1:03

for file

number 1.

[elements]

Optional; specifies the number of consecutive data elements,
starting at data_address, to be included in the data item. The
number of elements multiplied by the number of bytes per element
must be <= 2000 bytes. Default is 1 element.

You can specify elements to the bit level—for example,

B3:/4

would point only to bit 4.

[CC data_type]

Optional; specifies data type of calling programs copy of the data.

DTL_C_DEFINE

Advertising