Level-2 MATLAB S-Function

Utiliser une S-function MATLAB de niveau 2 dans un modèle

• 

Bibliothèques :
Simulink / User-Defined Functions

Description

Ce bloc vous permet d’utiliser une S-function MATLAB^® de niveau 2 (consultez Write Level-2 MATLAB S-Functions) dans un modèle. Pour ce faire, créez une instance de ce bloc dans le modèle. Ensuite, saisissez la S-function MATLAB de niveau 2 dans le champ S-function name de la boîte de dialogue des paramètres du bloc.

Remarque

Utilisez le bloc S-Function pour insérer une S-function MATLAB de niveau 1 dans un bloc.

Si la S-function MATLAB de niveau 2 définit des paramètres supplémentaires, vous pouvez les saisir dans le champ Parameters de la boîte de dialogue des paramètres du bloc. Entrez les paramètres comme des expressions MATLAB qui s’évaluent à leurs valeurs dans l’ordre défini par la S-function MATLAB. Utilisez des virgules pour séparer chaque expression.

Si un modèle inclut un bloc Level-2 MATLAB S-Function, et qu’une erreur se produit dans la S-function, le bloc Level-2 MATLAB S-Function affiche les informations de trace de pile MATLAB correspondant à l’erreur dans une boîte de dialogue. Cliquez sur OK pour fermer la boîte de dialogue.

Ports

Entrée(s)

In — Signaux d’entrée dans un bloc de la S-function MATLAB de niveau 2

scalaire | vecteur | matrice

Le bloc Level-2 MATLAB S-Function accepte les entrées des types répertoriés dans le tableau Block Characteristics. Pour plus d’informations, consultez Data Types Supported by Simulink. Vous pouvez configurer le port d’entrée avec la fonction de callback setup. Utilisez la fonction setup pour spécifier le nombre de ports d’entrée, la dimension des signaux d’entrée, le pas d’échantillonnage de chaque port et si les ports sont en traversée directe (direct feedthrough).

Types de données : single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | fixed point

Sortie(s)

Out — Signaux de sortie d’un bloc de la S-function MATLAB de niveau 2

scalaire | vecteur | matrice

Signaux de sortie d’un bloc Level-2 MATLAB S-Function que la S-function renvoie. Vous pouvez configurer le port d’entrée avec la fonction de callback setup. Utilisez la fonction setup pour spécifier le nombre de ports d’entrée, la dimension des signaux d’entrée et le pas d’échantillonnage de chaque port.

Types de données : single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | Boolean | fixed point | enumerated | bus

Paramètres

S-Function Name — Spécifiez le nom de la S-function.

matlabfile (par défaut) | nom de la S-function

Spécifiez le nom d’une fonction MATLAB qui définit le comportement de ce bloc. La fonction MATLAB doit respecter la norme Niveau 2 en matière de rédaction des S-functions MATLAB (consultez Write Level-2 MATLAB S-Functions pour plus de détails).

Utilisation programmatique

Paramètre de bloc : FunctionName

Type : vecteur de caractères

Valeurs : 'matlabfile' | nom de la S-Function

Valeur par défaut : 'matlabfile'

Parameters — Spécifier les valeurs des paramètres pour ce bloc

pas de valeur par défaut (par défaut)

Spécifiez les valeurs des paramètres pour ce bloc.

Utilisation programmatique

Paramètre de bloc : Parameters

Type : vecteur de caractères

Valeurs : valeurs des paramètres du bloc

Par défaut : ' '

Caractéristiques des blocs

Types de données	Booleana | doublea | fixed pointa | integera | singlea
Traversée directe	oui
Signaux multidimensionnels	oui
Signaux de taille variable	oui
Détection des passages à zéro	non
a Les Level-1 MATLAB S-functions ne supportent que les données de type double. Les Level-2 MATLAB S-functions supportent tous les types de données supportés par Simulink.

Capacités étendues

Génération de code C/C++

Générez du code C et C++ avec Simulink® Coder™.

• Si un fichier TLC correspondant est disponible, le bloc Level-2 MATLAB S-Function utilise le fichier TLC pour générer du code. Dans le cas contraire, la génération de code génère une erreur.

• La génération de code en temps réel ne supporte pas les S-functions qui appellent MATLAB.

• Le support effectif du type de données ou de la fonctionnalité dépend de l’implémentation du bloc.

Conversion en virgule fixe

Concevez et simulez des systèmes en virgule fixe avec Fixed-Point Designer™.

Les S-functions MATLAB de niveau 1 supportent uniquement le type de données double, alors que les Level-2 MATLAB S-functions supportent tous les types de données que Simulink supporte.

Historique des versions

Introduit dans R2010b

Voir aussi

Blocs

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

Rubriques

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