import

Импортируйте пользовательский код, функции и типы в Simulink

    Описание

    success = obj.import(), где obj является объектом класса Simulink.CodeImporter, анализирует указанный пользовательский код и импортирует его в Simulink® с настройками импорта по умолчанию. Если пользовательский код не был предварительно проанализирован, или если пользовательский код или настройки obj.CustomCode изменились с тех пор, как пользовательский код был проанализирован, а затем ParseInfo свойство obj заполняется или заново заполняется информацией, полученной в результате анализа.

    success = obj.import(Name1,Value1,...,NameN,ValueN) анализирует указанный пользовательский код и импортирует его в Simulink с опциями на основе заданных аргументов имя-значение.

    Примеры

    свернуть все

    Укажите местоположение и опции для пользовательского кода, а затем импортируйте код в Simulink.

    %% Create code importer object
    obj = Simulink.CodeImporter;
    
    %% Set library file name and output folder
    obj.LibraryFileName = "pumpController";
    obj.OutputFolder = ".";
    
    %% Set the custom code to import
    obj.CustomCode.InterfaceHeaders = ["pumpController.h"];
    obj.CustomCode.IncludePaths = ["./include"];
    obj.CustomCode.SourceFiles = ["src/pumpController.c" "src/utils.c"];
    
    %% Parse custom code and configure function
    obj.parse();
    fcn = obj.ParseInfo.getFunctions("Controller");
    fcn.PortSpecification.ReturnArgument.Label = "control_out";
    
    %% Import function "Controller"
    obj.import('Functions', ["Controller"]);

    Входные параметры

    свернуть все

    Аргументы в виде пар имя-значение

    Задайте необязательные разделенные разделенными запятой парами Name,Value аргументы. Name - имя аргумента и Value - соответствующее значение. Name должны находиться внутри кавычек. Можно задать несколько аргументов в виде пар имен и значений в любом порядке Name1,Value1,...,NameN,ValueN.

    Пример: obj.import('Functions',["Controller"],'EntryFunctionsOnly','On');

    Опция ограничения импорта функциями точки входа, заданная как 'On' или 'Off'. Если задано как 'On'в библиотеку Simulink импортируются только функции точки входа из пользовательского кода, то есть функции, не вызываемые другими функциями пользовательского кода. В противном случае импортируются все доступные пользовательские функции кода.

    Типы данных: char | string

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

    Типы данных: char | string

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

    Типы данных: char | string

    Опция перезаписи существующей библиотеки Simulink с таким же именем, как и имя, заданное в LibraryFileName свойство, заданное как 'On' или 'Off'. Если установлено значение 'Off' и существует существующая библиотека Simulink с таким же именем, пользовательский код импортируется в существующую библиотеку без изменения параметров блоков, применяемых в библиотеке после предыдущего импорта пользовательского кода. Если установлено значение 'On'существующая библиотека перезаписывается библиотекой, созданной из импорта пользовательского кода, и любые предыдущие изменения существующей библиотеки теряются. Если существующая библиотека Simulink с таким именем отсутствует, создается новая библиотека.

    Типы данных: char | string

    Опция добавления пользовательского кода и сгенерированных программных продуктов к существующему проекту MATLAB, заданная как путь к файлу. Программные продукты включают файл библиотеки для импортированных функций и словарь данных для импортированных типов. Если obj.Options.CreateTestHarness установлено в true и Simulink Test™ установлен, программные продукты также включают файл Simulink Test.

    Типы данных: char | string

    Выходные аргументы

    свернуть все

    Является ли импорт успешным, задается как логический скаляр. Simulink выдает исключение, если импорт неудачен.

    Введенный в R2021a