S-Function

Incluir la función S en el modelo

Bibliotecas:
Simulink / User-Defined Functions

Descripción

El bloque S-Function proporciona acceso a las funciones S desde un diagrama de bloques. La función S denominada como el parámetro S-function name puede ser una función S de C MEX de nivel 1 o nivel 2 (consulte Conceptos básicos de funciones S de MATLAB para obtener información sobre cómo crear funciones S).

Nota

Utilice el bloque Level-2 MATLAB S-Function para incluir una función S de MATLAB^® de nivel 2 en un diagrama de bloques.

El bloque S-Function muestra el nombre de la función S especificada y el número de puertos de entrada y salida especificados por la función S. Las señales conectadas a las entradas deben tener las dimensiones especificadas por la función S para las entradas.

Ejemplos

Péndulo invertido con animación

En este ejemplo se muestra cómo usar Simulink® para modelar y animar un sistema de péndulo invertido. El centro de masa de un péndulo invertido se encuentra por encima de su punto de rotación. Para mantener esta posición estable, el sistema implementa lógica de control para mover el punto de rotación por debajo del centro de masa en el momento en que el péndulo comienza a caer. El péndulo invertido es un problema de dinámica clásico que se utiliza para probar estrategias de control.

Abrir modelo

Personalizar código y bloques codificados manualmente mediante la API de funciones S

Esta biblioteca ofrece ejemplos de diferentes tipos de funciones S de Simulink®. Las funciones S de Simulink permiten ampliar Simulink con nuevos bloques codificados manualmente, interfaz con código externo personalizado y crear interfaces en tiempo real con otros programas . Use este ejemplo para acceder a modelos que contienen funciones S en C, C++, M y Fortran.

Abrir script

Run Quality Checks on S-Functions

Use S-Function analyzer programmatic interfaces to check S-functions for potential problems and improvements.

Abrir modelo

Puertos

Entrada

expandir todo

In — Entrada de señal para un bloque S-Function
escalar | vector | matriz

Puede configurar un puerto de entrada utilizando la función de callback mdlInitializeSizes. Use la función mdlInitializeSizes para especificar el número de puertos de entrada, la dimensión de las señales de entrada, el tiempo de muestreo de cada puerto y si los puertos tienen alimentación directa.

Salida

expandir todo

Out — Salida de señal de un bloque S-Function
escalar | vector | matriz

Puede configurar un puerto de salida usando la función de callback mdlInitializeSizes. Use la función mdlInitializeSizes para especificar el número de puertos de salida, la dimensión de las señales de salida y el tiempo de muestreo de cada puerto.

Parámetros

expandir todo

Nombre de la función S — Nombre de la función S
arreglo de caracteres (predeterminado)

Utilice este parámetro para especificar el nombre de la función S.

Uso programático

Parámetro de bloque: FunctionName

Tipo: vector de caracteres

Valor: nombre de la función S

Predeterminado: 'system'

Parámetros de función S — Parámetros adicionales de función S
arreglo de celdas (predeterminado)

Especifique los parámetros adicionales de función S.

Los parámetros de función pueden especificarse como expresiones de MATLAB o como variables separadas por comas. Por ejemplo,

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

Observe que, aunque los parámetros individuales pueden encerrarse entre paréntesis, la lista de parámetros no debe encerrarse entre paréntesis.

Uso programático

Parámetro de bloque: Parameters

Tipo: vector de caracteres

Valor: parámetros de función S

Predeterminado: ' '

Módulos de función S — Crear una lista de archivos adicionales para generación de código
arreglo de celdas (predeterminado)

Este parámetro solo se aplica si este bloque representa una función S de C MEX y tiene la intención de usar el software Simulink^® Coder™ para generar código desde el modelo que contiene el bloque. Si lo utiliza y está listo para generar código, debe obligar al codificador a reconstruir el modelo superior como se explica en Control Regeneration of Top Model Code (Simulink Coder).

Para obtener más información sobre cómo usar este parámetro, consulte Specify Additional Source Files for an S-Function (Simulink Coder).

Uso programático

Parámetro de bloque: SFunctionModules

Tipo: vector de caracteres

Valor: vector de caracteres de nombres de archivo

Predeterminado: ' '

Características del bloque

Tipos de datos	`Boolean^a` \| `bus^a` \| `double^a` \| `fixed point^b^a` \| `half^a` \| `integer^a` \| `single^a` \| `string^a`
Paso directo	`sí^a`
Señales multidimensionales	`sí^a`
Señales de tamaño variable	`sí^a`
Detección de cruce por cero	`sí^a`
^a El soporte actual de tipo de datos o capacidad depende de la implementación de bloques. ^b Consulte "Cómo escribir funciones S de punto fijo" para obtener detalles sobre el uso de tipos de datos de punto fijo en funciones S.

Capacidades ampliadas

Generación de código C/C++
Genere código C y C++ mediante Simulink® Coder™.

El soporte para generación de código depende de la implementación del bloque.
Las funciones S que llaman a MATLAB no se admiten para la generación de código.

Conversión de punto fijo
Diseñe y simule sistemas en punto fijo mediante Fixed-Point Designer™.

El soporte para el tipo de datos depende de la implementación del bloque.
Consulte Integrate External Code (Fixed-Point Designer) para obtener detalles sobre cómo utilizar tipos de datos de punto fijo en funciones S.

S-Function

Descripción