If

Sélectionner l’exécution du sous-système en utilisant une logique semblable à l’instruction if-else

• 

Bibliothèques :
Simulink / Ports & Subsystems

Description

Le bloc If, ainsi que les blocs If Action Subsystem qui contiennent un bloc Action Port, implémente la logique if-else pour contrôler l’exécution des sous-systèmes. Pour un exemple qui utilise le bloc If, consultez Select Subsystem Execution.

Exemples

Simulink Subsystem Semantics

This set of examples shows different types of Simulink® Subsystems and what semantics are used when simulating these subsystems. Each example provides a description of the model and the subtleties governing how the model is executed.

• Ouvrir le live script

Blocs If-Then-Else

Cet exemple illustre l'effet de l'introduction d'une onde sinusoïdale dans les blocs If Action Subsystem. Il a pour but de souligner la similitude entre le bloc du sous-système If Action et le bloc Enabled Subsystem.

• Ouvrir le modèle

Modeling Clutch Lock-Up Using If Blocks

Use If/Else subsystems to build a clutch model. An 'If' subsystem models the clutch dynamics in the locked position while an 'Else' subsystem models the unlocked position. One or the other is enabled using the 'If' block. The dot-dashed lines from the 'If' block denote control signals, which are used to enable If/Else (or other conditional) subsystems. Checking any of the boxes on the GUI produces a plot of any of the selected variables (versus time).

• Ouvrir le modèle

Limitations

Le bloc If possède les limitations suivantes :

• Il ne supporte pas les paramètres réglables. Les valeurs d’une expression if ou elseif ne peuvent pas être réglées pendant une simulation en mode normal ou accélérateur, ni pendant l’exécution de code généré.

  Pour implémenter des expressions if-else, réglez l’expression hors du bloc If. Par exemple, utilisez le bloc Relational Operator pour évaluer l’expression hors du bloc If ou ajoutez le paramètre réglable comme entrée au bloc If.

• Il ne supporte pas les classes de stockage personnalisées. Consultez la rubrique Organize Parameter Data into a Structure by Using Struct Storage Class (Embedded Coder).

• Les expressions if et elseif ne peuvent pas accepter certains opérateurs tels que +, -, * et /.

Ports

Entrée

Logical operands — Valeurs pour évaluer les expressions logiques

scalaire | vecteur

Les entrées u1,u2,...,un doivent avoir le même type de données. Les entrées ne peuvent pas être d’un type défini par l’utilisateur tel qu’un type énuméré.

Le bloc If ne supporte pas directement les types de données à virgule fixe. Cependant, vous pouvez utiliser le bloc Compare To Constant pour contourner cette limitation. Consultez le support pour les types de données en virgule fixe sur Select Subsystem Execution.

Types de données : single | double | int8 | int16 | int32 | uint8 | uint16 | uint32 | Boolean

Sortie(s)

Action — Signal d’action pour un bloc du sous-système If Action

scalaire

Les sorties des ports if, else et elseif sont des signaux d’action pour les blocs If Action Subsystem.

Paramètres

Number of inputs — Spécifier le nombre de ports d’entrée

1 (par défaut) | entier

1

Spécifiez un port d’entrée.

entier

Spécifiez le nombre de ports d’entrée. Les ports de bloc sont étiquetés avec un caractère 'u' suivi d’un nombre, 1,2,...,n, où n est égal au nombre d’entrées que vous spécifiez.

Utilisation programmatique

Paramètre de bloc : NumInputs

Type : vecteur de caractères

Valeurs : '1' | entier entre guillemets

Par défaut : '1'

Show else condition — Contrôler l’affichage du port Else

on (par défaut) | off

Quand le port if et toutes les expressions de port elseif sont false, le port else envoie un signal d’action pour exécuter le bloc If Action Subsystem relié.

on

Affichez le port else.

off

Masquez le port else.

Utilisation programmatique

Paramètre de bloc : ShowElse

Type : vecteur de caractères

Valeurs : 'on' | 'off'

Par défaut : 'on'

Enable zero-crossing detection — Contrôle de la détection des passages par zéro

on (par défaut) | off

Contrôlez la détection des passages par zéro.

on

Détectez les passages par zéro.

off

Ne détectez pas les passages par zéro.

Utilisation programmatique

Paramètre de bloc : ZeroCross

Type : vecteur de caractères

Valeurs : 'on' | 'off'

Par défaut : 'on'

Provide if-else statements in generated code — Option permettant d’inclure uniquement les instructions if-else dans le code généré à partir d’un bloc If

off (par défaut) | on

Depuis R2025a

Sélectionnez ce paramètre pour que seules les instructions if-else soient incluses dans le code généré à partir d’un bloc If .

on

Seules les instructions if-else sont incluses dans le code généré. Cette option empêche l’inclusion d’instructions switch-case dans le code généré.

off

Lorsque ce paramètre est défini à « off », le code généré à partir d’un bloc If peut contenir des instructions switch-case effectuant les mêmes opérations que le bloc If.

Utilisation programmatique

Pour définir la valeur du paramètre du bloc de manière programmatique, utilisez la fonction set_param.

Paramètre de bloc : EnsureIfElseCode

Type : vecteur de caractères

Valeurs : 'on' | 'off'

Par défaut : 'off'

if — Expression logique

u1 > 0 (par défaut) | expression logique

Le bloc If Action Subsystem relié au port if s’exécute quand l’expression if associée est évaluée à true.

u1 > 0

Spécifiez l’envoi d’un signal d’action sur le port de sortie quand l’entrée u1 est supérieure à 0.

expression logique

Remarque

À partir de la version R2025a, pour modifier l’expression if par défaut (u1 > 0), utilisez le tableau Expressions. Pour une expression complexe comprenant plusieurs entrées et opérateurs, sélectionnez l’expression if et modifiez-la dans la zone Expression editor.

Pour les versions antérieures à la version R2025a, ce paramètre figure en tant que If expressions dans la boîte de dialogue du bloc. Vous pouvez spécifier des expressions logiques avec ce paramètre.

Cependant, dans toutes les versions de Simulink^®, cette expression apparaît sur le bloc If adjacent au port de sortie if.

L’expression ne peut inclure que les opérateurs <, <=, ==, ~=, >, >=, &, |, ~, () et unary-minus. Les opérateurs tels que +, -, *, / et ^ ne sont pas autorisés. L’expression ne doit pas contenir d’expressions de type de données, par exemple int8(6), et ne doit pas faire référence à des variables d’espace de travail dont le type de données est différent de double ou de single.

Utilisation programmatique

Paramètre de bloc : IfExpression

Type : vecteur de caractères

Valeurs : 'u1 > 0' | expression logique entre guillemets

Par défaut : 'u1 > 0'

elseif — Expression logique

vide (par défaut) | liste d’expressions logiques

Le bloc If Action Subsystem relié à un port elseif s’exécute quand l’expression elseif associée est évaluée à true et que toutes les expressions if et elseif sont fausses.

vide

Expressions logiques non spécifiées.

liste d’expressions logiques

Remarque

À partir de la version R2025a, pour ajouter et modifier des expressions elseif, utilisez le tableau Expressions. Utilisez les boutons d’action à gauche du tableau pour ajouter, supprimer et déplacer des expressions. Le tableau vous permet de rédiger chaque expression elseif séparément plutôt que sous forme de liste séparée par des virgules. Vous pouvez ainsi organiser les expressions selon vos exigences de modélisation. Pour une expression complexe comprenant plusieurs entrées et opérateurs, sélectionnez la ligne qui contient l’expression elseif en question et modifiez-la dans la zone Expression editor.

Pour les versions antérieures à la version R2025a, ce paramètre figure en tant que Else expressions dans la boîte de dialogue du bloc. Dans ces versions, spécifiez une liste d’expressions logiques séparées par des virgules.

Cependant, dans toutes les versions de Simulink, les expressions apparaissent sur le bloc If sous le port if et au-dessus du port else quand vous cochez la case Show else condition.

Les expressions ne peuvent inclure que les opérateurs <, <=, ==, ~=, >, >=, &, |, ~, () et unary-minus. Les opérateurs tels que +, -, *, / et ^ ne sont pas autorisés. Les expressions ne doivent pas contenir d’expressions de type de données, par exemple int8(6), et ne doivent pas faire référence à des variables d’espace de travail dont le type de données est différent de double ou de single.

Utilisation programmatique

Paramètre de bloc : ElseIfExpressions

Type : vecteur de caractères

Valeurs : '' | liste d’expressions logiques séparées par des virgules et placées entre guillemets

Par défaut : ''

Caractéristiques des blocs

Types de données	Boolean | double | integer | single
Traversée directe	oui
Signaux multidimensionnels	non
Signaux de taille variable	non
Détection des passages à zéro	oui

Capacités étendues

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

Génération de code HDL

Générez du code VHDL, Verilog et SystemVerilog pour les designs FPGA et ASIC avec HLD Coder™.

HDL Coder™ fournit des options de configuration supplémentaires qui influent sur l’implémentation HDL et la logique synthétisée.

Architecture HDL

Ce bloc a une architecture HDL par défaut.

Propriétés de bloc HDL

ConstrainedOutputPipeline	Nombre de registres à placer aux sorties en déplaçant les retards au sein de votre design. Le pipelining distribué ne redistribue pas ces registres. La valeur par défaut est 0. Pour en savoir plus, consultez ConstrainedOutputPipeline (HDL Coder).
InputPipeline	Nombre d’étapes de pipelines d’entrée à insérer dans le code généré. Le pipelining distribué et le pipelining de sortie sous contrainte peuvent déplacer ces registres. La valeur par défaut est 0. Pour en savoir plus, consultez InputPipeline (HDL Coder).
OutputPipeline	Nombre d’étapes de pipelines de sortie à insérer dans le code généré. Le pipelining distribué et le pipelining de sortie sous contrainte peuvent déplacer ces registres. La valeur par défaut est 0. Pour en savoir plus, consultez OutputPipeline (HDL Coder).

Historique des versions

Introduit avant R2006a

R2025a: Amélioration de la boîte de dialogue des blocs et de la génération de code

• La boîte de dialogue des blocs a été modifiée pour vous permettre de spécifier les expressions logiques dans un tableau. Vous n’avez plus besoin de spécifier les expressions elseif dans une liste séparée par des virgules. Ce changement rend le déroulement logique plus facile à visualiser et à analyser dans son ensemble. Le tableau contient de nouveaux boutons d’action permettant d’ajouter, de supprimer et de déplacer des expressions if-else vers le haut et vers le bas. Ces boutons vous aident à organiser les expressions selon vos exigences de modélisation. De plus, la nouvelle zone d’édition d’expression vous permet de modifier les expressions complexes.

• Le code généré contient des expressions if-else. Ce changement empêche l’inclusion d’instructions switch-case et améliore la lisibilité du code généré.

Voir aussi

Subsystem | Action Port | If Action Subsystem

Rubriques

• Sélectionner l’exécution de sous-systèmes