Use a Bus with S-Function Builder to Create an S-Function - MATLAB & Simulink (original) (raw)

Main Content

This topic will show you how to create a bus and connect it to an S-Function Builder block. At the end, you will use the S-Function Builder to build a simple C MEX S-function.

The S-Function Builder block is a Simulink® block that integrates C/C++ code to build an S-function from specifications and C code that you supply. The S-Function Builder block also serves as a wrapper for the generated S-function in models that use the S-function. To learn more about theS-Function Builder block, see Build S-Functions Automatically Using S-Function Builder. To see more examples on how to use the S-Function Builder block, typesfundemos in the MATLAB® Command Window. Double-click the block named C-file S-functions. Then, double-click the block named S-function Builder.

1. Start building your S-function by setting the current folder to the folder in which you want to create an S-function. Then, add this folder to the MATLAB path.
   mkdir newSfun
   addpath(fullfile(pwd,'newSfun'))
   cd('newSfun')

2. If you want to connect a bus to the input or output port of the S-Function Builder block, you must first create a bus object. You can create a bus object interactively using the Simulink Type Editor. Alternatively, you can use Simulink.Bus:

   1. In the MATLAB Command Window, enter:
      As a result, the HeaderFile for the bus defaults to the empty character vector:
      a =

   Simulink.Bus
   Description: ''
   HeaderFile: ''
   Elements: [0x1 double]
   2. If you want to specify the header file for the bus, then at the MATLAB Command Window, enter the following:
   a.Headerfile = 'Busdef.h'
   If you do not specify a header file, Simulink automatically generates_`Sfunctionname`__bus.h

For a demonstration on how to use the S-Function Builder block with a bus, enter the following command at the MATLAB Command Window:
open_system(fullfile(matlabroot,...
'/toolbox/simulink/sfuntemplates/sfbuilder_bususage')) 3. Create a new Simulink model. Click the canvas and type S-Function Builder to create an instance of the S-Function Builder block. Alternatively, drag anS-Function Builder block from the library in the Library Browser into the new model.
4. Double-click the S-Function Builder block icon to open the S-Function Builder editor. 5. Use the specification and code entry panes on the S-Function Builder dialog box to enter information and custom source code required to tailor the generated S-function to your application. 6. Check whether the bus is in between the specified upper and lower saturation limits. To do this, create two input and two output ports, and assign the ports according to the table below:
7. Fill the Outputs_wrapper function with the logic of your code. See the example code:

How the S-Function Builder Builds an S-Function

The S-Function Builder builds an S-function by generating the following source files in the current folder:

• sfun.c — This file contains the C source code representation of the standard portions of the generated S-function.
• sfun_wrapper.c — This file contains the custom code that you entered in the S-Function Builder dialog box.
• sfun.tlc — This file permits the generated S-function to run in SimulinkRapid Accelerator mode and allows for inlining the S-function during code generation. In addition, this file generates code for the S-function inAccelerator mode which allows the model to run faster.
• sfun_bus.h — If you specify any Input port or Output port as a bus in the table, but do not specify a header file, then the S-Function Builder automatically generates this header file.

After generating the S-function source code, the S-Function Builder uses themex command to build the MEX file representation of the S-function from the generated source code and any external custom source code and libraries that you specified.

Deploy the Generated S-Function

To use the generated S-function in another model, first check to ensure that the folder containing the generated S-function is on the MATLAB path. Then, copy the S-Function Builder block from the model used to create the S-function into the target model. If necessary, set the target model's parameters to the values required by the target model.

Alternatively, you can deploy the generated S-function without using theS-Function Builder block or exposing the underlying C source file.

1. Open the Simulink model that will include the S-function.
2. Click the canvas to create an instance of the S-function block, or copy an S-Function block from the library in the Library Browser into the model.
3. Double-click on the S-Function block.
4. In the Block Parameters dialog box that opens, in the S-function name edit field, enter the name of the executable file generated by the S-Function Builder.
5. Enter any parameters for the S-function into the S-function parameters edit field. Enter the parameters in the order in which they appear in the S-Function Builder dialog box.
6. Click OK on the S-Function Block Parameters dialog box.

By creating a block from a generated S-function, you can also create a mask for yourS-Function block. To learn more about how to add a mask for your S-function, see Author Block Masks. To see an example of how block masks are added to an S-function, enter the following command on the MATLAB Command Window.

open_system(fullfile(matlabroot,... '/toolbox/simulink/sfuntemplates/sfcndemo_matadd'));

You can use the generated executable file in any S-Function block in any model as long as the executable file is on the MATLAB path.

See Also

S-Function | S-Function Builder

Topics

• Build S-Functions Automatically Using S-Function Builder
• Model a State-Space System Using S-Function Builder