S-Function Builder

Integrieren von C oder C++ Code zum Erstellen von S-Functions

• 

Bibliotheken:
Simulink / User-Defined Functions

Beschreibung

Der Block S-function Builder integriert neuen oder bestehenden C oder C++ Code und erstellt eine C MEX S-Function (system-function) aus den von Ihnen angegebenen Spezifikationen. Eine C MEX S-Function ist eine computersprachliche Beschreibung eines Simulink^®-Blocks in C oder C++. S-Funktionen verwenden eine spezielle Aufrufsyntax, die S-Funktions-API, die Ihnen die Interaktion mit der Simulink-Engine ermöglicht. Diese Interaktion ist der Interaktion zwischen der Engine und den integrierten Simulink-Blöcken sehr ähnlich. Weitere Informationen über C MEX S-Functions finden Sie unter What Is an S-Function?. Weitere Informationen über das Erstellen von C MEX S-Functions mithilfe des Blocks S-function Builder finden Sie unter Build S-Functions Automatically Using S-Function Builder. Ein Beispiel mit einem Schritt-für-Schritt-Verfahren finden Sie unter Use a Bus with S-Function Builder to Create an S-Function.

Instanzen des Blocks S-Function Builder können zudem als Wrapper für generierte S-Functions in Simulink-Modellen fungieren. Wenn ein Modell simuliert wird, das Instanzen eines Blocks S-Function Builder enthält, ruft Simulink die generierte C MEX S-Function ab, um Ihren C oder C++ Code in den Instanzen von mdlStart-, mdlOutputs-, mdlDerivatives-, mdlUpdate- und mdlTerminate-Methoden aufzurufen. Weitere Informationen zur Interaktion der Simulink-Engine mit S-Functions finden Sie unter Simulink Engine Interaction with C S-Functions.

Hinweis

Der Block S-Function Builder unterstützt kein Masking. Sie können jedoch einen Subsystem-Block maskieren, der einen Block S-Function Builder enthält. Weitere Informationen finden Sie unter Create Library Blocks Using Self-Modifiable Masks and Variant Blocks.

Beispiele

Create S-Function Using S-Function Builder API

Integrate C function using S-Function Builder block API.

• Live Script öffnen

Invertiertes Pendel mit Animation

Dieses Beispiel zeigt, wie Simulink® zur Modellierung und Animation eines invertierten Pendelsystems verwendet werden kann. Bei einem invertierten Pendel liegt der Schwerpunkt über dem Drehpunkt. Um diese Position stabil zu halten, implementiert das System eine Steuerlogik, um den Drehpunkt unter den Schwerpunkt zu bewegen, wenn das Pendel abzufallen beginnt. Das invertierte Pendel ist ein klassisches dynamisches Problem, das zur Prüfung von Kontrollstrategien verwendet wird.

• Modell öffnen

Benutzerdefinierter Code und handcodierte Blöcke unter Verwendung der S-Function-API

Diese Bibliothek enthält Beispiele für verschiedene Arten von Simulink® S-Funktionen. Mit Simulink S-Funktionen können Sie Simulink um neue handcodierte Blöcke erweitern, Schnittstellen zu benutzerdefiniertem externen Code erstellen und Live-Schnittstellen zu anderen Programmen erstellen. Verwenden Sie dieses Beispiel, um auf Modelle zuzugreifen, die S-Funktionen in C, C++, M und Fortran® enthalten.

• Script öffnen

Ports

Eingabe

Port_1 — S-function-Eingang

Skalar | Vektor | Matrix

Der Block S-Function Builder kann reale und komplexe 1-D- oder 2-D-Signale und nicht virtuelle Busse akzeptieren. In diesen Fällen müssen die Signale einen von Simulink unterstützten Datentypen aufweisen.

Weitere Informationen finden Sie unter Data Types Supported by Simulink in der Simulink-Dokumentation.

Datentypen: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | Boolean | fixed point | bus

Ausgabe

Out — S-function-Ausgang

Skalar | Vektor | Matrix

S-Function Builder kann reale und komplexe 1-D- oder 2-D-Signale und nicht virtuelle Busse erzeugen. In diesen Fällen müssen die Signale einen von Simulink unterstützten Datentypen aufweisen.

Weitere Informationen finden Sie unter Data Types Supported by Simulink in der Simulink-Dokumentation.

Datentypen: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | Boolean | fixed point | bus

Parameter

Verwenden Sie den S-Function Builder Editor, um benutzerdefinierte Parameter zu erstellen. Weitere Informationen zum Erstellen benutzerdefinierter Parameter mit dem Editor finden Sie unter Specify Ports and Parameters for the S-Function.

Hinweis

Sie müssen diese aufgeführten Simulink-Blockparameter für diesen Block nicht über den Blockdialog einstellen. Die Simulink-Blockparameter werden mithilfe der Informationen aus dem S-Function Builder Editor festgelegt.

S-function name — Name der S-Funktion

system (Standardeinstellung) | Name der S-Funktion

Verwenden Sie diesen Parameter, um den Namen Ihrer S-Funktion anzugeben.

Programmatische Verwendung

Um den Wert des Blockparameters programmatisch festzulegen, verwenden Sie die Funktion set_param.

Parameter:	FunctionName
Werte:	'system' (Standardeinstellung) | S-function name in quotes

S-function parameters — Zusätzliche S-Funktions-Parameter

MATLAB^®-Ausdrücke | Kommagetrennte Variablen

Geben Sie die zusätzlichen S-Funktions-Parameter an.

Die Funktionsparameter können als MATLAB-Ausdrücke oder als durch Kommas getrennte Variablen angegeben werden. Beispiel:

A, B, C, D, [eye(2,2);zeros(2,2)]

Auch wenn einzelne Parameter in Klammern gesetzt werden können, darf die Liste der Parameter nicht in Klammern gesetzt werden.

Programmatische Verwendung

Parameter:	Parameters
Werte:	'' (Standardeinstellung) | S-function parameters in quotes

S-function modules — Zusätzliche Dateien für die Codegenerierung

'' (Standardeinstellung) | Dateinamen

Dieser Parameter ist nur relevant, wenn dieser Block eine C MEX S-Funktion darstellt und Sie die Software Simulink Coder™ verwenden möchten, um Code aus dem Modell zu generieren, das den Block enthält. Wenn Sie sie verwenden, müssen Sie, wenn Sie bereit sind, Code zu generieren, den Codierer zwingen, das Top-Modell neu zu erstellen, wie in unter Control Regeneration of Top Model Code (Simulink Coder) erläutert.

Weitere Informationen zur Verwendung dieses Parameters finden Sie unter Specify Additional Source Files for an S-Function (Simulink Coder).

Programmatische Verwendung

Parameter:	SFunctionModules
Werte:	'' (Standardeinstellung) | filenames in quotes

Blockeigenschaften

Datentypen	Boolean | double | fixed point | integer | single
Direct Feedthrough	nein
Mehrdimensionale Signale	ja
Signale mit variabler Größe	nein
Erkennung von Nulldurchgängen	nein

Tipps

Haben Sie die S-function mit dem Block S-Function Builder erstellt, gibt die get_param-Funktion Informationen über diese Parameter zurück:

• Parameters – Zusätzliche S-function-Parameter

• SFunctionModules – Zusätzliche Dateien für die Codegenerierung, wenn der Block eine C MEX S-Function darstellt

Erweiterte Fähigkeiten

C/C++ Codegenerierung

Generieren von C und C++ Code mit Simulink® Coder™.

S-Funktionen, die MATLAB aufrufen, werden bei der Codegenerierung nicht unterstützt.

Festkommakonvertierung
Entwerfen und Simulieren von Festkommasystemen mit Fixed-Point Designer™.

Versionsverlauf

Eingeführt vor R2006a

Siehe auch

S-Function | Level-2 MATLAB S-Function | C Function

Themen

• Use a Bus with S-Function Builder to Create an S-Function
• Build S-Functions Automatically Using S-Function Builder
• Create a Blockset Project
• Run Quality Checks on S-Functions Using S-Function Analyzer