Используйте сигнал шины с разработчиком S-функции создать S-функцию

Эта тема покажет вам, как создать сигнал шины и соединить его с Разработчиком S-функции. В конце вы будете использовать Разработчика S-функции, чтобы создать простую S-функцию MEX C.

Разработчик S-функции является блоком Simulink^®, который интегрирует код C/C++, чтобы создать S-функцию из технических требований и кода С, который вы предоставляете. Разработчик S-функции также служит оберткой для сгенерированной S-функции в моделях, которые используют S-функцию. Чтобы узнать больше на Разработчике S-функции, смотрите S-функции Сборки Автоматически Используя Разработчика S-функции. Чтобы видеть больше примеров о том, как использовать Разработчика S-функции, введите sfundemos в Командном окне MATLAB^® затем перейдите к C-file S-functions> S-function Builder.

Начните создавать свою S-функцию путем установки текущей папки на папку, в которой вы хотите создать S-функцию. Затем добавьте эту папку в путь MATLAB.
```
mkdir newSfun
addpath(fullfile(pwd,'newSfun'))
cd('newSfun')
```
Если вы хотите соединить сигнал шины с портом Input or Output Разработчика S-функции, необходимо сначала создать объект шины. Можно создать объект шины в интерактивном режиме с помощью Редактора Шины Simulink (см., Создают и Задают Simulink. Соедините шиной Объекты). В качестве альтернативы можно использовать Simulink.Bus:
1. В командном окне MATLAB, введите:
  a = Simulink.Bus
  В результате HeaderFile для значений по умолчанию шины к пустому символьному вектору:
  a = Simulink.Bus Description: '' HeaderFile: '' Elements: [0x1 double]
2. Если вы хотите задать заголовочный файл для шины, то в командном окне MATLAB, введите следующее:
```
a.Headerfile = 'Busdef.h'
```
  Если вы не задаете заголовочный файл, Simulink автоматически генерирует Sfunctionname_bus.h
Для демонстрации о том, как использовать Разработчика S-функции с шиной, введите следующую команду в командном окне MATLAB:
```
open_system(fullfile(matlabroot,'/toolbox/simulink/simdemos/simfeatures/sfbuilder_bususage'))
```
Создайте новую модель Simulink. Нажмите на холст и введите Разработчика S-функции, чтобы создать экземпляр блока S-Function Builder. В качестве альтернативы перетащите блок S-Function Builder из библиотеки User-Defined Functions в Браузере Библиотеки в новую модель.
Нажмите на холст и введите Разработчика S-функции или скопируйте экземпляр блока S-Function Builder из библиотеки User-Defined Functions в новую модель.
Дважды кликните, чтобы открыть Разработчика S-функции редактор.
Используйте панели записи спецификации и кода на диалоговом окне S-Function Builder, чтобы ввести информацию и пользовательский исходный код, требуемый адаптировать сгенерированную S-функцию в соответствии с вашим приложением.
Проверяйте, является ли сигнал шины промежуточным заданные верхние и более низкие пределы насыщения. Чтобы сделать так это, создайте два входа и два выходных порта, и присвойте порты согласно приведенной ниже таблице:

Заполните Outputs_wrapper функция с логикой вашего кода. Смотрите пример кода:

void sfbuilder_bus_Outputs_wrapper(const SFB_COUNTERBUS *u0,
                                   const int32_T *u1,
                                   const SFB_COUNTERBUS *y0,
                                   int32_T *y1)
{
/* Output_BEGIN */
int32_T limit;
  boolean_T inputGElower;
  
  /* limit is sum of SFB_SIGNALBUS.input and the second input(u1) */
  limit = u0->inputsignal.input + *u1;
  
  /* check if SFB_SIGNALBUS.limit is >= LIMITBUS.lower_saturation_limit */
  inputGElower = (limit >= u0->limits.lower_saturation_limit);

  if((u0->limits.upper_saturation_limit >= limit) && inputGElower) 
  {
      *y1 = limit;
  } 
  else 
  {
      if(inputGElower) 
      {
          limit = u0->limits.upper_saturation_limit;
      } else 
      {
          limit = u0->limits.lower_saturation_limit;
      }
      *y1 = limit;
  }

  y0->inputsignal.input = *y1;
  y0->limits = u0->limits;
/* Output_END */
}

Кликните по стреле под Build и Выберите Generate TLC wrapper, чтобы создать обертку для вашей S-функции для генерации кода.
Нажмите Build on the S-Function Builder, чтобы запустить процесс сборки.
Разработчик S-функции создает файл MEX, который реализует заданную S-функцию и сохранил файл в текущей папке (см. Как разработчик S-функции Билдс S-функция).
Сохраните модель, содержащую блок S-Function Builder.

Как разработчик S-функции создает S-функцию

Разработчик S-функции создает S-функцию путем генерации следующих исходных файлов в текущей папке:

sfun.c — Этот файл содержит представление исходного кода C стандартных фрагментов сгенерированной S-функции.
sfun_wrapper.c — Этот файл содержит пользовательский код, который вы ввели в диалоговое окно S-Function Builder.
sfun.tlc — Этот файл разрешает сгенерированной S-функции запускать в Simulink Rapid Accelerator режим и допускает встраивание S-функции во время генерации кода. Кроме того, этот файл генерирует код для S-функции в Accelerator режим, который позволяет модели запускаться быстрее.
sfun_bus.h — Если вы задаете какой-либо Input port или Output port как шина в таблице Ports and Parameters, но не задают заголовочный файл, затем Разработчик S-функции автоматически генерирует этот заголовочный файл.

После генерации исходного кода S-функции Разработчик S-функции использует mex команда, чтобы создать представление файла MEX из S-функции из сгенерированного исходного кода и любого внешнего пользовательского исходного кода и библиотек, которые вы задали.

Разверните сгенерированную S-функцию

Чтобы использовать сгенерированную S-функцию в другой модели, сначала проверяйте, чтобы гарантировать, что папка, содержащая сгенерированную S-функцию, находится на пути MATLAB. Затем скопируйте блок S-Function Builder из модели, используемой, чтобы создать S-функцию в целевую модель. При необходимости установите параметры целевой модели на значения, требуемые целевой моделью.

В качестве альтернативы можно развернуть сгенерированную S-функцию, не используя блок S-Function Builder или отсоединив базовый исходный файл C.

Откройте модель Simulink, которая будет включать S-функцию.
Кликните по холсту, чтобы создать экземпляр Блока s-function или скопировать Блок s-function с библиотеки User-Defined Functions в Браузере Библиотеки в модель.
Дважды кликните на Блоке s-function.
В диалоговом окне Block Parameters, которое открывается в поле редактирования S-function name, вводят имя исполняемого файла, сгенерированного Разработчиком S-функции.
Введите любые параметры для S-функции в поле редактирования S-function parameters. Введите параметры в порядок, в котором они появляются в диалоговом окне S-Function Builder.
Нажмите OK на диалоговом окне S-Function Block Parameters.

Путем создания блока из сгенерированной S-функции можно также создать маску для блока S-Function. Чтобы узнать больше, как добавить маску для вашей S-функции, смотрите, Создают Маски Блока. Чтобы видеть пример того, как маски блока добавляются к S-функции, введите следующую команду в командное окно MATLAB.

open_system(fullfile(matlabroot,'/toolbox/simulink/simdemos/simfeatures/sfcndemo_matadd'));

Можно использовать сгенерированный исполняемый файл в любом Блоке s-function в любой модели, пока исполняемый файл находится на пути MATLAB.

Смотрите также

S-Function | S-Function Builder

Документация