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

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

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

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

Можно запустить пользовательское интегрирование кода С в Simulink путем ввода C Вызывающей стороны в холсте Simulink. В качестве альтернативы перетащите блок C Caller из Library Browser> 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 и сохранить модели организованными.

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

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

Simulink.CustomCode.debugSymbols('on')

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

Simulink.CustomCode.debugSymbols('off')

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

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

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

Например, эта модель содержит блок C Caller, который вызывает функциональный adder(), который получает доступ к объекту под названием adderObj. Прежде, чем вызвать функцию, объект должен быть создан, который может быть сделан путем вызова initAdder() от Initialize function панели 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 custom code in a separate process не выбран, это исключение могло бы заставить MATLAB отказывать, когда вы симулируете модель. Однако, если параметр выбран, симулирование модели производит сообщение об ошибке в Simulink.

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

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

Если ваш пользовательский код полностью отлажен, можно отменять Simulate custom code in a separate process для более быстрого времени симуляции.

Ограничения

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