Level-2 MATLAB S-Function

Verwenden einer Level-2 MATLAB S-function im Modell

• 

Bibliotheken:
Simulink / User-Defined Functions

Beschreibung

Mit diesem Block können Sie eine Level-2 MATLAB^® S-function (siehe Write Level-2 MATLAB S-Functions) in einem Modell verwenden. Erstellen Sie hierfür eine Instanz dieses Blocks im Modell. Geben Sie daraufhin den Namen der Level-2 MATLAB S-function im Feld S-function name des Parameterfelds des Blocks ein.

Hinweis

Verwenden Sie den S-Function-Block, um eine Level-1 MATLAB S-function in einen Block aufzunehmen.

Wenn die Level-2 MATLAB S-function weitere Parameter definiert, können Sie diese im Feld Parameters im Parameter-Dialogfeld des Blocks eingeben. Geben Sie die Parameter als MATLAB-Ausdrücke ein, deren Werte in der von der MATLAB S-function festgelegten Reihenfolge errechnet werden. Trennen Sie die Ausdrücke durch Kommas.

Wenn ein Modell einen Block Level-2 MATLAB S-Function umfasst und ein Fehler in der S-function auftritt, werden im Block Level-2 MATLAB S-Function MATLAB Stack-Trace-Informationen für den Fehler in einem Dialogfeld angezeigt. Klicken Sie auf OK, um das Dialogfeld zu schließen.

Ports

Eingabe

In — Signaleingang für einen Level 2 MATLAB S-function-Block

Skalar | Vektor | Matrix

Der Level-2 MATLAB S-Function akzeptiert Eingaben mit den in der Blockeigenschaftstabelle aufgeführten Typen. Weitere Informationen finden Sie unter Data Types Supported by Simulink. Sie können den Eingabeport mithilfe der Callback-Funktion setup konfigurieren. Verwenden Sie die Funktion setup, um die Anzahl der Eingabeports, die Dimension der Eingabesignale, die Abtastzeit jedes Ports und die Frage, ob es sich um direkte Durchleitungen handelt, anzugeben.

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

Ausgabe

Out — Signalausgang eines Level-2 MATLAB S-function-Blocks

Skalar | Vektor | Matrix

Signalausgang eines Level-2 MATLAB S-Function Blocks, den die S-function zurückgibt. Sie können den Eingabeport mithilfe der Callback-Funktion setup konfigurieren. Verwenden Sie die Funktion setup, um die Anzahl der Eingangsports, die Dimension der Eingangssignale und die Abtastrate jedes Ports festzulegen.

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

Parameter

S-Function Name — Name der S-function angeben

matlabfile (Standardeinstellung) | Name der S-function

Geben Sie den Namen einer MATLAB-Funktion an, die das Verhalten dieses Blocks definiert. Die MATLAB-Funktion muss dem Level-2-Standard zum Schreiben von MATLAB S-functions entsprechen (weitere Informationen siehe Write Level-2 MATLAB S-Functions).

Programmatische Verwendung

Blockparameter: FunctionName

Typ: Zeichenvektor

Werte: 'matlabfile' | Name der S-function

Standardwert: 'matlabfile'

Parameters — Legt Parameterwerte für diesen Block fest

kein Standardwert (Standardeinstellung)

Legt Parameterwerte für diesen Block fest.

Programmatische Verwendung

Blockparameter: Parameters

Typ: Zeichenvektor

Werte: Werte der Blockparameter

Standardwert: ' '

Blockeigenschaften

Datentypen	Booleana | doublea | fixed pointa | integera | singlea
Direct Feedthrough	ja
Mehrdimensionale Signale	ja
Signale mit variabler Größe	ja
Erkennung von Nulldurchgängen	nein
a Level-1-MATLAB-S-Funktionen unterstützen nur den Double-Datentyp. Level-2-MATLAB S-Funktionen unterstützen alle von Simulink unterstützten Datentypen.

Erweiterte Fähigkeiten

C/C++ Codegenerierung

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

• Wenn eine entsprechende TLC-Datei verfügbar ist, verwendet der Level-2 MATLAB S-Function Block die TLC-Datei zur Codegenerierung; andernfalls gibt die Codegenerierung einen Fehler aus.

• Die Echtzeit-Codegenerierung unterstützt keine S-functions, die MATLAB aufrufen.

• Die tatsächliche Unterstützung von Datentypen oder Funktionen hängt von der Blockimplementierung ab.

Festkommakonvertierung

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

Level-1 MATLAB S-functions unterstützen nur den Datentyp double. Level-2 MATLAB S-functions unterstützen alle Datentypen, die Simulink unterstützt.

Versionsverlauf

Eingeführt in R2010b

Siehe auch

Blöcke

• MATLAB Function | MATLAB System | Simulink Function | Subsystem, Atomic Subsystem, Nonvirtual Subsystem, CodeReuse Subsystem | S-Function | S-Function Builder

Themen

• What Is an S-Function?
• Write Level-2 MATLAB S-Functions
• Design and Create a Custom Block