You can create custom
Transmit blocks to
use with hardware currently not supported by Vehicle Network
Toolbox™. Choose one of the following work flows.
Blocks Using Simulink Buses (recommended) — Use Simulink® bus signals to connect blocks. Create functions and blocks with S-Function Builder and S-Function blocks.
Blocks Using CAN Message Data Types — Use CAN message data types to share information. Write and compile your own C++ code to define functions, and MATLAB® code to create blocks.
To create custom blocks for Vehicle Network Toolbox that use Simulink CAN buses, you can use the S-function builder. For full instructions on building S-functions and blocks this way, see Build S-Functions Automatically (Simulink). The following example uses the steps outlined in that topic.
This example shows you how to build two custom blocks for transmitting and receiving CAN messages. These blocks use a Simulink message bus to interact with CAN Pack and CAN Unpack blocks.
Create a Simulink message bus in the MATLAB workspace for CAN or CAN FD.
Each of these functions creates a variable in the workspace named
CAN_FD_MESSAGE_BUS, respectively. You use this
variable later for building your S-functions.
Open a new blank model in Simulink, and add to your model an S-Function Builder block from the block library.
Double-click the S-Function Builder block to open its dialog box. The first function you build is for transmitting.
Among the settings in the dialog box, define a function name and specify usage of a Simulink bus.
Data Properties: Input Ports: Bus:
CAN_MESSAGE_BUS, as shown in the following
For CAN FD, set the bus name to
In your function and block building, use the other tabs in the dialog box to define the code for interaction with your device driver, and remove unnecessary ports.
Click Build. The code files are placed in the current working folder of MATLAB.
Place a new S-Function Builder block in your model, and repeat the steps to build an S-function named CustomCANReceive. Use the same settings, except for input and output ports. The receive block output port uses the same bus name as the transmit function input.
Build the receive function, and remove both S-Function Builder blocks from your model. At this point, you can use the files generated by the S-Function Builder as a set of templates, which you can further edit and compile with your own tools. Alternatively, you can use S-Function blocks to run your functions.
Add two S-Function blocks to your model. Open each block, and set its Model Parameters S-function name field, so you have one each of CustomCANTransmit and CustomCANReceive.
At this point you could create a mask for each block to allow access to parameters for your hardware. This example does not need masks for these blocks.
Add other necessary blocks to your model, including:
Set the block parameters and connections.
For ease of design and to take advantage or more Simulink features, it is recommended that you use Simulink buses instead of CAN message data types when possible. See Blocks Using Simulink Buses.
To create your own blocks for use with other Vehicle Network Toolbox blocks, can use a custom CAN data type. Register this custom CAN data type in a C++ S-function.
You must use a C++ file type S-function (
.cpp) to create custom
blocks that use CAN message data types. Using a C-file type S-function
.c) might cause linker errors.
To register and use the custom CAN data type, in your S-function:
IMPORT_SCANUTIL identifier that imports the
required symbols when you compile the S-function:
can_datatype.h header located
at the top of the S-function:
can_message.h included by
can_datatype.h is located in
can_message.h file for information on the
Link your S-function during build to the
located in the
folder. The shared library
scanutil.dll, is located in
Call this function in
initialize the custom CAN data type:
Get custom data type ID using
dataTypeID = ssGetDataTypeId(S,SL_CAN_MESSAGE_DTYPE_NAME);
Do one of the following:
To create a receive block, set output port data type to
To create a transmit block, set the input port to