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

Page 159

Advertising
background image

API Library of Routines

Appendix B

CC_PLC_BTR

B-28

Requests the PLC-5 programmable controller to perform a block-transfer
read from an intelligent I/O module.

Important: You can use this function only if the coprocessor is connected
directly to the PLC-5 programmable controller.

C Syntax

# include <copro.h>

unsigned CC_PLC_BTR (r,g,m,size,retry,data_ptr,iostat)

unsigned char r;
unsigned char g;
unsigned char m;
unsigned char size;
unsigned char retry;
unsigned short *data_ptr;

unsigned *iostat;

Parameters

r

The assigned rack number in which the target I/O module resides.

g

The I/O group number that specifies the target I/O module.

m

The module slot number within the I/O group.

size

The number of words to be read from the I/O module.

retry

The retry value for doing the block transfer. If the value is, 0 the
processor will retry the transfer one time before returning. If the value
is 1, the processor will repeatedly attempt the transfer from an
unresponsive module for four seconds.

data_ptr

The address of a data buffer that will store the block transfer read data.

iostat

CC_PLC_BTR

Advertising