Documentation

CAN Read Strategy

The "CAN Read" block reads one message from one channel of the module input queue. The "Data present" output port shows if there are more messages available in the queue.

The CAN receiver requires a do-while construction to ensure that all messages in the buffer are read at a given sample step. It is important to estimate the number of messages expected so that the correct sample time of the do-while subsystem is selected. The sample time of the subsystem is defined by Simulink inheritance rules: if the subsystem does not have input ports, it will inherit the fundamental sample time of the model. Alternatively, the sample time of the subsystem can be controlled by adding an input port. The sample time of the block connected to the input port is inherited by the subsystem.

The do-while construction iterates the CAN Read operation until the receiver buffer is empty (this information is provided by the Data present port). In the same subsystem, we can filter the messages required by the application.

The sample time must be chosen in order to avoid buffer overflow during a sample step. Furthermore, if multiple messages with the same Message ID are received, only the most recent messages will appear in the do-while subsystem output. To read all messages with a certain ID, the do-while subsystem must be run faster than the frequency of the message(s) in question.

For example, if Message ID 100 is expected with a frequency of 10 ms, and all these messages must be read, the do-while subsystem sample time must be faster than 10 ms, for example, 5 ms.

If there are other messages in the line, a check must be carried out to ensure that there is no message overflow; for example, with a buffer size of 501 messages (IO612), if 500 messages are expected within 500 ms, a sample time of 500 ms or slower may lead to the messages in the buffer being overwritten.

Top level view:

Inside the While Iterator Subsystem

The "Sample Time" input port defines the rate at which the subsystem is executed. Otherwise it will run on the base rate.

CAN Message Filtering

The IO601 has some limited message identifier filtering capabilities. The filters are handled on the module level, so rejected messages do not add to the model execution latency.

Here are two examples of how to configure CAN message ID filtering. Both of these work with the Acceptance parameter for extended CAN IDs ('Acceptance [ExtMask1, ExtCode1, ExtMask2, ExtCode2]:'). The Acceptance parameter for standard IDs works in the same way.

These parameters are configured in the Setup driver block.

To filter specific IDs:

ExtMask1 = double(hex2dec('1FFFFFFF')) - masks all 29 bits of the ID

ExtCode1 = double(hex2dec('7DO')) - first ID to filter is 0x7D0

ExtMask2 = double(hex2dec('1FFFFFFF')) - masks all 29 bits of the ID

ExtCode2 = double(hex2dec('FFFFF')) - second ID to filter is 0xFFFFF

In this case, only the message IDs 0x7D0 and 0xFFFFF are accepted.

To filter a group of IDs smaller than a certain value:

ExtMask1 = double(hex2dec('1FFFFF00'))

ExtCode1 = double(hex2dec('00000000'))

ExtMask2 = double(hex2dec('1FFFFF00'))

ExtCode2 = double(hex2dec('00000000'))

In this case, only IDs below 0xFF (255) are accepted.

	Note
	The Acceptance parameter takes decimal values. As it is often easier to work with hex for CAN IDs, we use MATLAB conversion functions here for simplicity.

LIN Power Supply and Firmware Requirements

To enable LIN communication, firmware v4.27 or newer must be loaded by Speedgoat, and 12V must be supplied to pin 9 of connector 1 of the module.

If a previous firmware version is installed, an error message will appear on the target screen before model execution. In this case, please contact Speedgoat to receive updated firmware.

Initialization and Termination CAN Messages

The CAN Setup driver blocks for the supported CAN boards allow you to define CAN messages to be sent during initialization and termination of the real-time application. The driver blocks send these messages once at the beginning of each application run and once before an application run is stopped. The main purpose for sending these messages is to initialize or terminate other CAN nodes on the network, such as CANopen or DeviceNet nodes. Even if the CAN layers are not directly supported, the model can usually communicate with these nodes with standard CAN messages, provided the nodes are initialized. The initialization and termination fields of the Setup blocks are intended for this purpose.

You define the initialization and termination CAN messages by using MATLAB® structure arrays with CAN-specific field names. This approach was also used for the RS-232 and general counter driver blocks found in the Simulink® Real-Time™ I/O library. Refer to these driver blocks and their help for additional information about this basic concept.