Main Content

EtherCAT Sync SDO Download

Transmit data synchronously to subordinate device represented by service data object

Since R2020b

  • EtherCAT Sync SDO Download block

Libraries:
Simulink Real-Time / EtherCAT

Description

The EtherCAT Sync SDO Download block selects a CANopen register by Index value in the specified EtherCAT® subordinate device and sends a write request. The block then waits until it receives a response or until the timeout period is over.

The response to an operation takes several ticks of the main task sample time. Assign the synchronous blocks a sample time slower than the main task sample time.

Examples

Ports

Input

expand all

Input data for writing to the EtherCAT subordinate device.

Output

expand all

If no error occurs, this port transmits 0. Otherwise, it transmits a nonzero value. For a list of error codes, see EtherCAT Error Codes.

Parameters

expand all

Specify the hexadecimal (for example, 0x7) or decimal index of the CANopen register.

If you specify an invalid index, the block returns a nonzero value through the Error output.

Programmatic Use

Block Parameter: index

Specify the hexadecimal (for example, 0x7) or decimal subindex of the CANopen register.

If you specify an invalid subindex, the block returns a nonzero value through the Error output.

Programmatic Use

Block Parameter: subIndex

From the list, select the data type of the CANopen register.

If you select a data type that does not match the type of the entry, the block returns a nonzero value through the Error output.

Programmatic Use

Block Parameter: sig_type

Specify the row and column dimension of the CANopen register.

Enter the vector length as found in the CoE description for the subordinate device in its manual.

Programmatic Use

Block Parameter: sig_dim

To associate a block with an EtherCAT network, enter the Network Device Index value from the EtherCAT Init block representing that network into the Network Device Index for the block.

Programmatic Use

Block Parameter: device_id

From the list, select the name of the device that contains the CANopen register.

The block populates this drop-down list with the contents of the configuration file.

Programmatic Use

Block Parameter: subdevice_name

Enter the base sample time or a multiple of the base sample time. -1 means that the sample time is inherited.

Programmatic Use

Block Parameter: sample_time

The maximum number of milliseconds to wait for a response before returning a timeout error.

Programmatic Use

Block Parameter: timeout

Extended Capabilities

C/C++ Code Generation
Generate C and C++ code using Simulink® Coder™.

Version History

Introduced in R2020b