MotoHawk XCPSlave Ethernet Definition
The XCP Ethernet Definition block defines the protocol settings necessary to manage an XCP connection on Ethernet.
Block ID
XCPSlave Ethernet Definition
Library
MotoHawk_Protocols_lib
Description
This block establishes one or more logical XCP connections on the indicated Etherent adapter. There can only be one XCP Ethernet Definition block in the application. The use of this block will enable
connections over both TCP and UDP Ethernet protocols. The use of UDP connections is favored when the XCP Slave device and XCP Master device are not on the same LAN. The use of high speed
data acquisition over TCP becomes impractical whenever the devices are not on the same LAN.
By default the XCP Command packets are responded to in IDLE time of the application, while data acquisition list (DAQ) packets will be transmitted in association
with the event trigger requested by the XCP Master. The priority of XCP Command servicing can be specified via the
Protocol Execution Priority Definition block. The absolute execution priority of the Task selected by the
Protocol Execution Priority Definition block must be selected to be less than 50 to ensure compatibility with
the Ethernet stack. The configuration of available DAQ event triggers is provided by the Event Definition block.
DAQ lists have a limitation that the number of DAQ lists * the number of ODTs per list must be less than or equal to 252. The number of ODT Entries per ODT can be in the range of 1 to 255 for Ethernet.
The XCP Protocol handler uses a Command/Response Message length (MAX_CTO) value of 255 for Ethernet, which is the maximum possible value for this setting.
It is common that an XCP instance such as this one is accessed by an XCP Master device by loading an ASAP2 file. Generation of an ASAP2 file may be accomplished through the use of the ASAP2 Definition block
Block Parameters
| Parameter Field | Values | Comments/Description |
|---|---|---|
| XCP Instance Name | String | The unique name assigned to this logical Ethernet connection. |
| Ethernet Channel Name | String | Specify which Ethernet channel to use |
| Number of Connections | Number, Minimum of 1 | The logical XCP connections to support on this Ethernet adapter. |
| TCP Port | Number, 16 bit | Port number necessary for establishing the XCP connection |
| DAQ/STIM Message Length (MAX_DTO) | Number, 8-4096 | The maximum allowed length for a DAQ packet |
| Receive Queue Size | Number | The number of block transfer packets to buffer |
| Total Number of DAQs (1-252) | Number, 1-252 | Set the number of Data Acquisitions (DAQs) for this connection. DAQs are lists of automatically transmitted signals. |
| Total Number of Object Descriptors (ODT) per (DAQ) (1-252) | Number, 1-252 | Set the number of Object Descriptors (ODTs) per Data Acquisition list. ODTs determine the length of each DAQ list in DTO messages. |
| Total Number of Signals per ODT(Constrained by MAX_DTO) | Number, 1-255 | Set the number of allowable signals per Object Descriptor (ODT) |