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

Задайте исходный код и зависимости

Задайте свой внешний файл исходного кода, который содержит ваши функции C.

Обработка N-D массивов

Simulink может передать данные массива N-D функциям пользовательского кода в блоках C Caller и получить данные из таких блоков. Когда вы делаете так, необходимо задать правильное размещение массивов, чтобы достигнуть намеченных результатов. Смотрите функциональное размещение массивов По умолчанию и Исключение функцией. Для примеров использования данных массива с блоками C Caller смотрите, Приносят Алгоритмы Фильтра Пользовательского изображения как Допускающие повторное использование Блоки в Simulink и Вызове блок Legacy Lookup Table Function Using C Caller.

Можно задать порядок того, как матричные данные обрабатываются в функциях C. Матричные данные передали, и от вашего C функции преобразованы при необходимости в размещение массивов, которое вы задаете. Если размещение массивов не задано, матричные данные передаются через функцию C в том же порядке ваших данных Simulink, и вычислительные ошибки могут произойти из-за упорядоченного по столбцам строкой разногласия. Убедитесь, что вы следуете за тем же функциональным размещением массивов по умолчанию для всех данных Simulink.

Чтобы узнать больше об упорядоченных по строкам и упорядоченных по столбцам размещениях массивов в Simulink, смотрите функциональное размещение массивов По умолчанию.

Если ваши функции C принимают только скалярные и/или векторные входные параметры, установка Default function array layout не оказывает влияния.

Вызовите блок C Caller и задайте порты

Можно запустить пользовательское интегрирование кода С в Simulink путем ввода C Caller в холсте Simulink. В качестве альтернативы перетащите блок C Caller из библиотеки User-Defined Functions на холст. Дважды кликните блок, чтобы открыть диалоговое окно Block Parameters, чтобы видеть имена ваших функций и технических требований порта.

Карта C Аргументы функции к портам Simulink

Можно сопоставить аргументы функции C от исходного кода до портов Simulink с помощью таблицы Port specification в блоке C Caller и путем создания FunctionPortSpecification объект через командную строку. В вашем исходном коде заголовочный файл включает аргументы функции C, которые будут соединены с портами Simulink.

extern void mean_filter(const unsigned char* src,
                           unsigned char* dst,
                           unsigned int width, unsigned int height,
                           unsigned int filterSize);

Port specification показывает детали ваших аргументов и как они соединяются с вашим блоком C Caller в Simulink.

Имя Задает имя аргументов ввода и вывода. Name является аргументом функции или названием параметра, как задано в ваших функциях C из исходного кода. Этот столбец в ссылочных целях только.

Осциллограф Задает, как аргументы функции C сопоставляют с Осциллографом Simulink. Ваши аргументы имеют осциллографы по умолчанию в зависимости от функционального определения, и можно изменить осциллографы, зависящие функциональное определение в исходном коде.

Для аргумента, переданного указателем, когда у вас есть постоянное определение спецификатора, такое как const double *u, аргумент может только быть входом или параметром. Когда нет никакого постоянного спецификатора, аргументом является InputOutput по умолчанию, и можно изменить его в Inputвывод , или Parameter осциллограф. В случае Input или Parameter определите объем, гарантируйте, что функция C не изменяет память, указанную указателем. Если аргумент имеет Output определите объем, каждый элемент, на который указывает этот указатель, должен быть повторно присвоен в каждом призыве к функции.

Используйте InputOutput порт, чтобы сопоставить вход, переданный указателем в ваших функциях C. Порты создали использование InputOutput порт имеет то же имя для портов ввода и вывода. InputOutput порты включают повторное использование буфера для портов ввода и вывода. Это может оптимизировать использование памяти в зависимости от размера сигнала и блочного расположения.

К аргументам функции карты C к InputOutput порт, задайте переменную как указатель в ваших функциональных определениях.

extern void mean_filter(unsigned char* src,
                           unsigned int width, unsigned int height,
                           unsigned int filterSize);

Затем выберите спецификацию порта к InputOutput определите объем в таблице Port Specification и присвойте получившийся функциональный выход входной переменной в пользовательской функции.

Можно использовать глобальные переменные в пользовательском коде, сопоставляя их с соответствующим Осциллографом Simulink. Чтобы включить использование глобальных переменных в вашей модели, выберите глобальные переменные Enable, когда функция взаимодействует через интерфейс от Model Settings> Configuration Parameters> Simulation Target. Можно сопоставить глобальные переменные с Inputвывод , InputOutput или Global определите объем на блоке C Caller. Доступность этих осциллографов зависит от использования глобальной переменной в вашем пользовательском коде.

Global осциллограф позволяет вам передать данные между пользовательским кодом и блоком C Caller и позволяет вам использовать глобальную переменную во время вычислений на блоке. Значения, переданные с помощью Global осциллограф не отображается в интерфейсе блока. Эта таблица показывает отрывки примера кода и их и доступные порты по умолчанию.

double data;

void foo(void)
    {
        int temp = data;  
    }

double data;

void bar(void)
    {
        data = 0;
    }

double data;

void foo2(void)
    {
        data = data + 1;
    }

Метка — Указывает на метку для соответствующего аргумента в блоке Simulink. По умолчанию ваша марка аргумента совпадает с именем аргумента, если вы не изменяете его.

Введите — Демонстрирует соответствие между типом данных Simulink и типом данных аргумента функции C.

Размер — Задает размерности данных в аргументе.

myCCallerConfigObj = get_param(gcb, 'FunctionPortSpecification')

myCCallerConfigObj = 

  FunctionPortSpecification with properties:

        CPrototype:  'real_T add(real_T u1, real_T u2);'
    InputArguments:  [1×2 Simulink.CustomCode.FunctionArgument]
    ReturnArgument:  [1×1 Simulink.CustomCode.FunctionArgument] 
    GlobalArguments: [1×0 Simulink.CustomCode.FunctionArgument]

Создайте пользовательскую библиотеку вызывающей стороны C

Рекомендуется создать модель библиотеки, чтобы сгруппировать ваши блоки C Caller и сохранить ваши модели организованными. Можно также соединить словарь данных с библиотекой, чтобы содержать пользовательские типы, заданные в коде. Используя библиотеку модель особенно полезно, когда у вас есть многоуровневые модели или иерархия модели - ссылки, которая использует пользовательский код С.

Можно также создать библиотеку блоков C Caller из пользовательского кода с помощью Средства импорта Simulink Кода. Смотрите Импорт Пользовательский Код C/C++ Используя Средство импорта Simulink Кода.

Сгенерируйте отладочные символы для пользовательского кода

Чтобы присоединить внешний отладчик к процессу MATLAB и отладить внешний код С, убеждаются, что Параметр конфигурации Модели, Simulate custom code in a separate process очищен, затем генерируют использование отладочных символов:

clear mex
Simulink.CustomCode.debugSymbols('on')

Поверните это выделение использования:

Simulink.CustomCode.debugSymbols('off')

Сгенерируйте код из модели

C Caller поддерживает генерацию кода. В коде, сгенерированном из вашей модели, каждое выполнение блока C Caller соответствует вызову внешней функции C, сопоставленной с блоком. Для того, чтобы создать сгенерированный код, панель Code Generation > Custom Code Параметров конфигурации Модели должна быть заполнена с правильной информацией относительно пользовательского кода. Смотрите Параметры конфигурации Модели: Пользовательский код Генерации кода (Simulink Coder).

Симулируйте пользовательский код в отдельном процессе

Ограничения

К тестовым моделям, которые включают блоки C Caller, смотрите Тест Интегрированный код С (Simulink Test).