rtw.connectivity.ConfigRegistry

Укажите настройку возможности соединения

Описание

Укажите свою настройку возможности соединения с MATLAB® или Simulink®.

Создание

Описание

config = rtw.connectivity.ConfigRegistry возвращает указатель на rtw.connectivity.ConfigRegistry объект.

Создать этот класс:

  • Для MATLAB используйте rtwTargetInfo.m файл, который необходимо поместить в путь поиска файлов MATLAB. В rtwTargetInfo.m файл, вызов registerTargetInfo указывает настройку возможности соединения.

  • Для Simulink используйте sl_customization.m файл, который необходимо поместить в путь поиска файлов MATLAB. Когда Simulink запускается, он читает файл и указывает вашу настройку возможности соединения через вызов registerTargetInfo в файле.

Через первые два свойства этого класса можно задать для настройки возможности соединения:

  • Уникальное имя.

  • Связанный класс реализации возможности соединения, который является подклассом rtw.connectivity.Config.

Через остающиеся свойства можно задать:

  • Для MATLAB, код, который совместим с классом реализации возможности соединения.

  • Для Simulink, набора моделей, которые совместимы с классом реализации возможности соединения.

Сравнение объединения этих свойств против параметров конфигурации MATLAB Coder™ или параметров модели Simulink определяет совместимость. Например, с Simulink, ли SystemTargetFile, TemplateMakefile, и HardwareBoard свойства совместно совпадают с соответствующими параметрами модели.

Свойства

развернуть все

Уникальное имя для настройки.

Полное имя класса реализации возможности соединения, которую вы хотите указать.

Для Simulink, системные конечные файлы, которые поддерживают rtw.connectivity.ConfigRegistry объект вы создаете. Сравнение этого массива ячеек против SystemTargetFile параметр конфигурации модели определяет, допустим ли созданный объект для использования. Массив пустой ячейки совпадает с любым системным конечным файлом.

Для Simulink, make-файлы шаблона, которые поддерживают rtw.connectivity.ConfigRegistry объект вы создаете. Сравнение этого массива ячеек против TemplateMakefile параметр конфигурации модели определяет, допустим ли созданный объект для использования. Массив пустой ячейки совпадает с любой целью make-файла и не-make-файла шаблона (GenerateMakefile'off'.

Если вы используете набор инструментальных средств, чтобы создать сгенерированный код, не задавайте TemplateMakefile параметр конфигурации. Вместо этого задайте Toolchain параметр конфигурации.

Наборы инструментальных средств, которые поддерживают rtw.connectivity.ConfigRegistry объект вы создаете:

  • Для MATLAB, сравнения этого массива ячеек против MATLAB Coder Toolchain параметр конфигурации определяет, допустим ли созданный объект для использования.

  • Для Simulink, сравнения этого массива ячеек против Toolchain параметр конфигурации модели определяет, допустим ли созданный объект для использования. Если вы не используете набор инструментальных средств, чтобы создать сгенерированный код, не задавайте Toolchain параметр конфигурации. Вместо этого задайте TemplateMakefile параметр конфигурации.

Массив пустой ячейки совпадает с любым набором инструментальных средств.

Аппаратные платы, которые поддерживают rtw.connectivity.ConfigRegistry объект вы создаете:

  • Для MATLAB, сравнения этого массива ячеек против MATLAB Coder HardwareBoard параметр конфигурации определяет, допустим ли созданный объект для использования.

  • Для Simulink, сравнения этого массива ячеек против HardwareBoard параметр конфигурации модели определяет, допустим ли созданный объект для использования.

Массив пустой ячейки совпадает с любой аппаратной платой.

Типы аппаратного устройства, которые поддерживают rtw.connectivity.ConfigRegistry объект вы создаете:

  • Для MATLAB, сравнения этого массива ячеек против MATLAB Coder TargetHWDeviceType параметр конфигурации определяет, допустим ли созданный объект для использования.

  • Для Simulink, сравнения этого массива ячеек против TargetHWDeviceType параметр конфигурации модели определяет, допустим ли созданный объект для использования.

Массив пустой ячейки совпадает с любым типом аппаратного устройства.

Примеры

Создайте rtwTargetInfo.m Файл

Этот код является примером rtwTargetInfo.m файл. Используйте синтаксис функций точно как показано.

function rtwTargetInfo(tr)
% Register PIL connectivity config: mypil.ConnectivityConfig

tr.registerTargetInfo(@loc_createConfig);

% local function
function config = loc_createConfig

% Create object for connectivity configuration
config = rtw.connectivity.ConfigRegistry;
% Assign connectivity configuration name
config.ConfigName = 'My PIL Example';
% Associate the connectivity configuration with the connectivity
% API implementation
config.ConfigClass = 'mypil.ConnectivityConfig';

% Specify toolchains for host-based PIL
config.Toolchain =  rtw.connectivity.Utils.getHostToolchainNames;

% Through the HardwareBoard and TargetHWDeviceType properties,
% define compatible code for the target connectivity configuration 
config.HardwareBoard = {};
config.TargetHWDeviceType = {'Generic->32-bit x86 compatible' ...
                             'Generic->Custom' ...
                             'Intel->x86-64 (Windows64)', ...
                             'Intel->x86-64 (Mac OS X)', ...
                             'Intel->x86-64 (Linux 64)'};

Функция выполняет следующие шаги:

  1. Создает экземпляр rtw.connectivity.ConfigRegistry класс. Например:

    config = rtw.connectivity.ConfigRegistry;
  2. Присваивает имя настройки возможности соединения к ConfigName свойство объекта. Например:

    config.ConfigName = 'My PIL Example';
  3. Сопоставляет настройку возможности соединения с реализацией API возможности соединения, созданной на шаге 1. Например:

    config.ConfigClass = 'mypil.ConnectivityConfig';
  4. Задает совместимый код для этой целевой настройки возможности соединения, путем установки HardwareBoard и TargetHWDeviceType свойства объекта. Например:

    config.HardwareBoard = {};  % Any hardware board
    config.TargetHWDeviceType = {'Generic->32-bit x86 compatible' ...
                                 'Generic->Custom' ...
                                 'Intel->x86-64 (Windows64)', ...
                                 'Intel->x86-64 (Mac OS X)', ...
                                 'Intel->x86-64 (Linux 64)'};
    

Создайте sl_customization.m Файл

Этот код является примером sl_customization.m файл. Используйте sl_customization.m файловая структура и вызов registerTargetInfo функционируйте точно как показано.

function sl_customization(cm)
% SL_CUSTOMIZATION for PIL connectivity config:...
% mypil.ConnectivityConfig

% Copyright 2008 The MathWorks, Inc.

cm.registerTargetInfo(@loc_createConfig);

% local function
function config = loc_createConfig

config = rtw.connectivity.ConfigRegistry;
config.ConfigName = 'My PIL Example';
config.ConfigClass = 'mypil.ConnectivityConfig';

% Match only ert.tlc
config.SystemTargetFile = {'ert.tlc'};

% If you use a toolchain to build your generated code,
% specify the config.Toolchain property to match your
% Simulink model toolchain setting. Otherwise, for a
% non-toolchain approach, match the TMF
config.TemplateMakefile = {'ert_default_tmf' ...
                           'ert_unix.tmf', ...
                           'ert_vcx64.tmf', ...
                           'ert_lcc.tmf'};

% Match hardware boards and hardware device types
config.HardwareBoard = {};  % Any hardware board
config.TargetHWDeviceType = {'Generic->32-bit x86 compatible' ...
                             'Generic->Custom' ...
                             'Intel->x86-64 (Windows64)', ...
                             'Intel->x86-64 (Mac OS X)', ...
                             'Intel->x86-64 (Linux 64)'};

Необходимо сконфигурировать файл, чтобы выполнить следующие шаги, когда Simulink запускается:

  1. Создайте экземпляр rtw.connectivity.ConfigRegistry класс. Например:

    config = rtw.connectivity.ConfigRegistry;
  2. Присвойте имя настройки возможности соединения к ConfigName свойство объекта. Например:

    config.ConfigName = 'My PIL Example';
  3. Сопоставьте настройку возможности соединения с реализацией API возможности соединения (созданный на шаге 1). Например:

    config.ConfigClass = 'mypil.ConnectivityConfig';
  4. Задайте совместимые модели для этой целевой настройки возможности соединения путем установки этих свойств свойств объекта:

    • SystemTargetFile

    • Toolchain или TemplateMakefile

    • HardwareBoard

    • TargetHWDeviceType

    Например:

    config.SystemTargetFile = {'ert.tlc'};
    config.TemplateMakefile = {'ert_default_tmf' ...
                               'ert_unix.tmf', ...
                               'ert_vcx64.tmf', ...
                               'ert_lcc.tmf'};
    config.HardwareBoard = {};
    config.TargetHWDeviceType = {'Generic->32-bit x86 compatible' ...
                                 'Generic->Custom' ...
                                 'Intel->x86-64 (Windows64)', ...
                                 'Intel->x86-64 (Mac OS X)', ...
                                 'Intel->x86-64 (Linux 64)'};

Используя rtw.connectivity.ConfigRegistry в возможности соединения PIL

Для примера, который показывает, как использовать этот объект в подготовке возможности соединения PIL, см.:

Представленный в R2008b