MSG_CIPGENERIC (common industrial protocol generic message)

The MSG_CIPGENERIC instruction sends a common industrial protocol (CIP) explicit message over an Ethernet channel or a serial port.
A maximum of four message requests per channel can be processed in one scan. For ladder diagram programs, message requests are executed at the end of a ladder scan.
Languages supported: Function block diagram, ladder diagram, structured text.
This instruction applies to the L20E, L50E, and L70E controllers.
MSG_CIPGENERIC
MSG_CIPGENERIC
MSG_CIPGENERIC parameters
Parameter
Parameter Type
Data Type
Description
IN
Input
BOOL
Rung input state.
  • TRUE: Rising edge detected, start the instruction block with the precondition that the last operation has been completed.
  • FALSE: Rising edge not detected, idle.
CtrlCfg
Input
CIPCONTROLCFG
The instruction block execution control configuration. Use the CIPCONTROLCFG parameters to define CtrlCfg.
AppCfg
Input
CIPAPPCFG
CIP service and application path (EPATH) configuration.
Use the CIPAPPCFG parameters to define AppCfg.
TargetCfg
Input
CIPTARGETCFG
Target device configuration.
Use the CIPTARGETCFG parameters to define TargetCfg.
ReqData
Input
USINT[1..1]
CIP message request data. The array size should be greater than the ReqLength size.
ReqLength
Input
UINT
CIP message request data length: 0–490.
ResData
Input
USINT[1..1]
CIP message response data. The array size should be greater than the ReqLength size.
When an MSG is triggered or re-triggered, data in the ResData array is cleared.
Q
Output
BOOL
Outputs of this instruction are updated asynchronously from the program scan. Output Q cannot be used to re-trigger the instruction because IN is edge triggered.
  • TRUE: MSG instruction finished successfully.
  • FALSE: MSG instruction is not finished.
Status
Output
CIPSTATUS
The instruction block status.
When an MSG is triggered or re-triggered, all elements inside Status are reset.
The Status output is defined in CIPSTATUS data type.
ResLength
Output
UINT
CIP message response data length: 0–490.
When an MSG is triggered, or re-triggered, ResLength is reset to 0.

MSG_CIPGENERIC examples

MSG_CIPGENERIC function block diagram example
MSG_CIPGENERIC function block diagram example
MSG_CIPGENERIC ladder diagram example
MSG_CIPGENERIC ladder diagram example
MSG_CIPGENERIC structured text example
MSG_CIPGENERIC structured text example
Provide Feedback
Have questions or feedback about this documentation? Please submit your feedback here.
Normal