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

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

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

Блокировка вызова C и определение портов

Можно начать пользовательскую интеграцию кода C в Simulink, введя C Caller в холсте Simulink. Можно также перетащить блок вызывающего абонента C из обозревателя библиотек > Пользовательские функции. Дважды щелкните блок, чтобы открыть диалоговое окно «Параметры блока» для просмотра имен функций и спецификаций портов.

Сопоставить аргументы функции C портам Simulink

Можно сопоставить аргументы функции C из исходного кода с портами Simulink, используя таблицу спецификации порта в блоке 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);

Спецификация порта показывает сведения о аргументах и их подключении к блоку C Caller в Simulink.

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

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

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

Используйте 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. Чтобы включить использование глобальных переменных в модели, выберите Включить глобальные переменные как интерфейсы функций в меню Настройки модели > Параметры конфигурации > Цель моделирования. Можно сопоставить глобальные переменные с Input, Output, InputOutput или Global область в блоке C Caller. Доступность этих областей зависит от использования глобальной переменной в пользовательском коде.

A Global область позволяет передавать данные между пользовательским кодом и блоком вызывающего абонента C и позволяет использовать глобальную переменную во время вычислений в блоке. Значения, перенесенные с помощью 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. По умолчанию метка аргумента совпадает с именем аргумента, если его не изменить.

Тип (Type) - демонстрирует соответствие между типом данных 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-вызывающих и сохранения упорядоченности моделей.

Создание символов отладки для пользовательского кода

Чтобы подключить внешний отладчик к процессу MATLAB и отладить внешний код C, создайте символы отладки, используя:

Simulink.CustomCode.debugSymbols('on')

Отключить этот параметр с помощью:

Simulink.CustomCode.debugSymbols('off')

Моделирование пользовательского кода в отдельном процессе

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

Чтобы включить эту опцию, в параметрах конфигурации модели на панели Цель моделирования (Simulation target) выберите Моделировать пользовательский код (Simulate custom code) в отдельном процессе. Опция применяется к пользовательскому коду C/C + +, интегрированному в модель с использованием любого из следующих блоков:

Например, эта модель содержит блок вызывающего абонента C, который вызывает функцию adder(), который обращается к объекту с именем adderObj. Перед вызовом функции необходимо создать объект, что можно сделать путем вызова initAdder() в функции Инициализация (Initialize) панели Цель моделирования (Simulation Target) параметров конфигурации модели.

static Adder* adderObj = nullptr;

int adder(int increment)
{
    adderObj->add_one(increment);
    return adderObj->get_val();
}

void initAdder()
{
    adderObj = new Adder();
}

Если initAdder() не вызывается ранее adder(), то adder() пытается получить доступ к неинициализированному указателю, что приводит к исключению во время выполнения. Если пользовательский код Simulate в отдельном параметре процесса не выбран, это исключение может привести к сбою MATLAB при моделировании модели. Однако если параметр выбран, при моделировании модели в Simulink появляется сообщение об ошибке.

Затем можно нажать кнопку Открыть, чтобы запустить внешний отладчик и устранить проблему, вызвавшую ошибку.

После запуска отладчика он перезапустит моделирование и автоматически остановится в точках останова пользовательских записей функций.

После полной отладки пользовательского кода можно отменить выбор пользовательского кода Simulate в отдельном процессе для ускорения моделирования.

Ограничения

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