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 modelizar un péndulo invertido. La animación se crea usando MATLAB® Handle Graphics®. El bloque de animación es una función S enmascarada. Para obtener más información, use el menú contextual para buscar debajo de la máscara del bloque Animation y abra la función S para editar.

Abrir modelo

Custom Code and Hand Coded Blocks Using the S-function API

This library launches examples of different types of Simulink® S-functions. Simulink S-functions allow you to extend Simulink with new hand coded blocks, interface to custom external code, and create live interfaces to other programs. Use this example to access models containing S-functions in the C, C++, M, and Fortran.

Abrir ejemplo

Run Quality Checks on S-Functions

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

Abrir modelo

Parámetros

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	Booleana | busa | doublea | fixed pointba | halfa | integera | singlea | stringa
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.

Historial de versiones

Introducido antes de R2006a

Consulte también

Level-2 MATLAB S-Function | S-Function Builder

Temas

• Implementing S-Functions
• Create a Basic C MEX S-Function
• Write Level-2 MATLAB S-Functions