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

C реализация блока MEX

Большая часть кода в vxinterrupt1.c выполняет обычные функции, которые не связаны с асинхронной поддержкой (например, получая и подтверждая параметры от маски блока, отмечая параметры ненастраиваемые, и передающие данные о параметре к model.rtw файл).

mdlInitializeSizes функционируйте использует специальный SimStruct макросы и SS_OPTIONS настройки, которые требуются для асинхронных блоков, аналогичных описанному ниже.

Обратите внимание на то, что следующие макросы не могут быть названы прежде ssSetOutputPortWidth называется:

Если одни из вышеупомянутых макросов называются прежде ssSetOutputPortWidth, следующее сообщение об ошибке появляется:

SL_SfcnMustSpecifyPortWidthBfCallSomeMacro {  
S-function '%s' in '%<BLOCKFULLPATH>'
must set output port %d width using
ssSetOutputPortWidth before calling macro %s
 }

ssSetAsyncTimerAttributes.  ssSetAsyncTimerAttributes объявляет, что блок требует таймера и устанавливает разрешение таймера, как задано для параметров блоков Timer resolution (seconds).

Прототип функции

ssSetAsyncTimerAttributes(SimStruct *S, double res)

где

Следующая выборка кода показывает вызов ssSetAsyncTimerAttributes.

/* Setup Async Timer attributes */
ssSetAsyncTimerAttributes(S,mxGetPr(TICK_RES)[0]);

ssSetAsyncTaskPriorities.  ssSetAsyncTaskPriorities устанавливает приоритет задач Simulink для блоков, выполняющихся на каждом уровне прерывания, как задано для параметров блоков Simulink task priority.

Прототип функции

ssSetAsyncTaskPriorities(SimStruct *S, int numISRs, 
                         int *priorityArray)

где

Следующая выборка кода показывает вызов ssSetAsyncTaskPriorities:

/* Setup Async Task Priorities */
    priorityArray = malloc(numISRs*sizeof(int_T));
    for (i=0; i<numISRs; i++) {
        priorityArray[i] = (int_T)(mxGetPr(ISR_PRIORITIES)[i]);
    }
    ssSetAsyncTaskPriorities(S, numISRs, priorityArray); 
    free(priorityArray);
    priorityArray = NULL;
}

Настройки SS_OPTION.  Выборка кода ниже показов SS_OPTION настройки для vxinterrupt1.c. SS_OPTION_ASYNCHRONOUS_INTERRUPT должен использоваться, когда подсистема вызова функции присоединена к прерыванию. Для получения дополнительной информации см. документацию для SS_OPTION и SS_OPTION_ASYNCHRONOUS в matlabroot/simulink/include/simstruc.h.

ssSetOptions( S, (SS_OPTION_EXCEPTION_FREE_CODE |
              SS_OPTION_DISALLOW_CONSTANT_SAMPLE_TIME |
              SS_OPTION_ASYNCHRONOUS_INTERRUPT |

Если S-функция задает SS_OPTION_DISALLOW_CONSTANT_SAMPLE_TIME опция и наследовала шаг расчета Inf, ​ генератор кода определяет, как произвести код для блока на основе того, является ли блок инвариантным. Блок является инвариантным, если его сигналы порта являются инвариантными. Сигнал является инвариантным, если он имеет постоянное значение во время целой симуляции. Если вы задаете шаг расчета блока Constant, не принимайте, что сигналы порта являются инвариантными. Для получения дополнительной информации ​ видят Встроенные Инвариантные Сигналы. Если блок не является инвариантным, ​ генератор кода производит код только в инициализировать функции точки входа. Если блок является инвариантным, ​ генератор кода не производит код для блока.

Реализация TLC

В этом разделе рассматриваются каждую функцию vxinterrupt1.tlc, с акцентом на целевые функции, которые необходимо будет изменить, чтобы сгенерировать код для целевого RTOS.

Сгенерируйте #include директивы.  vxinterrupt1.tlc начинается с оператора

%include "vxlib.tlc"

vxlib.tlc целевой файл, который генерирует директивы, чтобы включать заголовочные файлы для примера RTOS (VxWorks). Необходимо заменить это на файл, который генерирует, включает для целевого RTOS.

Функция BlockInstanceSetup.  Поскольку каждый соединил выход блока Async Interrupt, BlockInstanceSetup задает имя функции для соответствующего ISR в сгенерированном коде. Имена функций имеют форму

isr_num_vec_offset

где num номер ISR, заданный для параметров блоков VME interrupt number(s) и offset смещение таблицы прерываний, заданное параметрами блоков VME interrupt vector offset(s).

В пользовательской реализации это соглашение о присвоении имен является дополнительным.

Имена функций кэшируются для использования Outputs функция, которая генерирует фактический код ISR.

Выходная функция.  Outputs выполняет итерации по связанным выходным параметрам блока Async Interrupt. ISR сгенерирован для каждого такого выхода.

Код ISR кэшируется в "Functions" раздел сгенерированного кода. Прежде, чем сгенерировать ISR, Outputs делает следующее:

При генерации кода ISR, Outputs вызывает asynclib функция LibNeedAsyncCounter определить, требуется ли таймер связанной подсистемой. Если так, и если источник времени собирается быть SS_TIMESOURCE_SELF ssSetTimeSource, LibSetAsyncCounter называется, чтобы сгенерировать RTOS (VxWorks) tickGet вызов функции и обновление счетчик. В вашей реализации необходимо сгенерировать или эквивалентный вызов целевого RTOS или сгенерировать код, чтобы считать регистр таймера на целевом компьютере.

Запустите функцию.  Start функция генерирует необходимый RTOS (VxWorks) вызовы (int_connect и sysInt_Enable) соединить и включить каждый ISR. Необходимо заменить это на вызовы целевого RTOS.

Оконечная функция.  Terminate функция генерирует вызов sysIntDisable отключить каждый ISR. Необходимо заменить это на вызовы целевого RTOS.

C реализация блока MEX

Как блок Async Interrupt, блок Task Sync настраивает таймер, в этом случае с фиксированным разрешением. Приоритет задачи, сопоставленной с блоком, получен из параметров блоков Simulink task priority. SS_OPTION настройки совпадают с используемыми для блока Async Interrupt.

ssSetAsyncTimerAttributes(S, 0.01);

priority  = (int_T) (*(mxGetPr(PRIORITY)));
ssSetAsyncTaskPriorities(S,1,&priority);

ssSetOptions(S, (SS_OPTION_EXCEPTION_FREE_CODE |
                 SS_OPTION_ASYNCHRONOUS |
                 SS_OPTION_DISALLOW_CONSTANT_SAMPLE_TIME |
}

Реализация TLC

Сгенерируйте #include директивы.  vxtask1.tlc начинается с оператора

%include "vxlib.tlc"

vxlib.tlc целевой файл, который генерирует директивы, чтобы включать заголовочные файлы для примера RTOS (VxWorks). Необходимо заменить это на файл, который генерирует, включает для целевого RTOS.

Функция BlockInstanceSetup.  BlockInstanceSetup функция выводит имя задачи, имя блока и другие идентификаторы, используемые позже в генерации кода. Это также проверяет на и предупреждает о несвязанных условиях блока и генерирует объявление устройства хранения данных для семафора (stopSem) это используется в случае условий переполнения прерывания.

Запустите функцию.  Start функция генерирует необходимый RTOS (VxWorks) вызовы, чтобы задать устройство хранения данных для семафора, который используется в управлении задачей, порожденной блоком Task Sync. В зависимости от значения CodeFormat Переменная TLC цели, или статическое объявление устройства хранения данных или вызов динамического выделения памяти сгенерированы. Эта функция также создает семафор (semBCreate) и порождает задачу RTOS (taskSpawn). Необходимо заменить их на вызовы целевого RTOS.

Выходная функция.  Outputs функция генерирует пример RTOS (VxWorks) задача, которая ожидает семафора. Когда это получает семафор, это обновляет таймер метки деления блока и вызывает нисходящий код подсистемы, как описано в Икре, и Синхронизируйте Выполнение Задачи RTOS. Outputs также генерирует код (названный от уровня прерывания), который предоставляет семафор.

Оконечная функция.  Terminate функция генерирует пример RTOS (VxWorks) вызов taskDelete закончить выполнение задачи, порожденной блоком. Необходимо заменить это на вызовы целевого RTOS.

Обратите внимание также на это, если целевой RTOS динамически выделил память, сопоставленную с задачей, Terminate функция должна освободить память.