Экспортируйте файл ASAP2 для измерения данных и калибровки

Стандарт ASAM MCD-2 MC, также известный как ASAP2, является стандартом определения данных, предложенным Ассоциацией для Стандартизации Автоматизации и Измеряющихся Систем (ASAM). ASAP2 является необъектно-ориентированным описанием данных, используемых в измерении, калибровке и диагностических системах. Для получения дополнительной информации о ASAM и ASAM MCD-2 MC (ASAP2) стандарт, смотрите веб-сайт ASAM в https://www.asam.net.

Генератор кода позволяет вам экспортировать файл ASAP2, содержащий информацию о вашей модели во время процесса генерации кода.

Можно запустить интерактивный пример генерации файла ASAP2. Чтобы открыть пример в командной строке MATLAB^®, введите следующую команду:

rtwdemo_asap2

Примечание

Поддержка Simulink^® Coder™ генерации файла ASAP2 нейтральна в отношении версии. По умолчанию программное обеспечение генерирует формат версии 1.31 ASAP2, но сгенерированная информация модели обычно совместима с другими версиями ASAP2. Генерация файла ASAP2 также нейтральна относительно определенных потребностей измерения ASAP2 и инструментов калибровки. Программное обеспечение обеспечивает API индивидуальной настройки, которые можно использовать, чтобы настроить генерацию файла ASAP2, чтобы сгенерировать версию ASAP2 и удовлетворить определенные потребности инструментов ASAP2.

Что необходимо знать
Цели, поддерживающие ASAP2
Задайте информацию ASAP2
Сгенерируйте файл ASAP2
Структура файла ASAP2
Создайте основанный на хосте файл определения данных ASAM-ASAP2 для измерения данных и калибровки

Что необходимо знать

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

ASAM и стандарт ASAP2 и терминология. Смотрите веб-сайт ASAM в https://www.asam.net.
Объекты данных Simulink. Объекты данных используются, чтобы предоставить информацию, не содержавшуюся в модели. Для обзора смотрите Объекты данных (Simulink).
Устройство хранения данных и представление сигналов и параметров в сгенерированном коде. Смотрите Доступ к данным для Прототипирования и Отладки (Simulink Coder).
Если вам лицензируют для Embedded Coder^®, см. также Представление данных темы Embedded Coder и доступ.

Цели, поддерживающие ASAP2

Можно использовать генерацию файла ASAP2 различные системные настройки конечного файла. Например,

Generic Real-Time Target (grt.tlc) позволяет вам сгенерировать файл ASAP2 как часть генерации кода и процесса сборки.
Embedded Coder (ert.tlc) системные выборы конечного файла также позволяют вам сгенерировать файл ASAP2 как часть генерации кода и процесса сборки.
ASAM-ASAP2 Data Definition Target (asap2.tlc) позволяет вам сгенерировать только файл ASAP2, не создавая исполняемую программу.

Процедуры для генерации файлов ASAP2 при помощи этих целевых настроек сданы, Генерируют Файл ASAP2.

Задайте информацию ASAP2

Задайте информацию ASAP2 для параметров и сигналов
Атрибут адреса памяти
Автоматическая замена адреса ECU для файлов ASAP2 (Embedded Coder)
Задайте информацию ASAP2 для интерполяционных таблиц

Задайте информацию ASAP2 для параметров и сигналов

Процесс генерации файла ASAP2 запрашивает информацию о параметрах и сигналах в вашей модели. Часть этой информации содержится в самой модели. Необходимо предоставить остальных при помощи Объектов данных Simulink в словаре данных или рабочей области. В некоторых случаях использование объектов рабочей области является дополнительным.

Используйте Model Data Editor и встроенные Объекты данных Simulink, чтобы предоставить информацию. Например, можно использовать Simulink.Signal объекты предоставить информацию об ИЗМЕРЕНИИ и Simulink.Parameter объекты предоставить ХАРАКТЕРИСТИЧЕСКУЮ информацию. Кроме того, можно использовать объекты данных от классов данных, которые выведены из Simulink.Signal и Simulink.Parameter предоставить информацию. Для получения информации об объектах данных смотрите Объекты данных (Simulink). Для получения информации о Model Data Editor смотрите Configure Data Properties при помощи Model Data Editor (Simulink).

Следующая таблица содержит минимальный набор атрибутов данных, требуемых для генерации файла ASAP2. Некоторые атрибуты данных заданы в модели; другие предоставляются в свойствах объектов. Для атрибутов, которые заданы в Simulink.Signal или Simulink.Parameter объекты, таблица дает связанное имя свойства.

Атрибут данных	Заданный в	PropertyName
Назовите (символ)	Модель и объект данных	Наследованный от указателя объекта данных, к которому параметр или сигнал называют твердость
Описание	Объект данных	`Description`
Тип данных	Модель или объект данных	`DataType`
Масштабирование (если тип данных с фиксированной точкой)	Модель или объект данных	`DataType`
Минимальное допустимое значение	Модель или объект данных	`Min`
Максимальное допустимое значение	Модель или объект данных	`Max`
Модуль	Модель или объект данных	`Unit`
(Дополнительный) адрес памяти	Модель или объект данных	`MemoryAddress_ASAP2` (дополнительный; смотрите Атрибут Адреса памяти.)

Атрибут адреса памяти

Если атрибут адреса памяти неизвестен, прежде чем генерация кода, генератор кода вставит ECU Address текст заполнителя в сгенерированном файле ASAP2. Можно заменить исполнительным адресом заполнителя путем постобработки сгенерированного файла. Смотрите файл matlabroot/toolbox/rtw/targets/asap2/asap2/asap2post.m для примера. asap2post.m синтаксические анализы через файл карты компоновщика, что вы обеспечиваете и заменяете ECU Address заполнители в файле ASAP2 с фактическими адресами памяти. Поскольку файлы карты компоновщика варьируются от компилятора до компилятора, вы можете должны быть изменить код регулярного выражения в asap2post.m чтобы совпадать с форматом компоновщика сопоставляют вас использование.

Примечание

Если Embedded Coder лицензируется и устанавливается в вашей системе, и если вы генерируете Исполняемый и Связываемый Формат (ELF) или База данных Программы (PDB) файлы для вашего целевого процессора, можно использовать rtw.asap2SetAddress функция, чтобы автоматизировать ECU обращается к замене. Для получения дополнительной информации смотрите Автоматическую Замену Адреса ECU для Файлов ASAP2 (Embedded Coder).

Если атрибут адреса памяти известен перед генерацией кода он может быть задан в элементе данных или объекте данных. По умолчанию, MemoryAddress_ASAP2 свойство не существует в Simulink.Signal или Simulink.Parameter классы объекта данных. Если вы хотите добавить атрибут, добавьте свойство под названием MemoryAddress_ASAP2 к пользовательскому классу, который является подклассом Simulink или ASAP2 класс. Для получения информации о разделении на подклассы классов данных Simulink смотрите, Задают Классы Данных (Simulink).

Следующая таблица указывает на свойства объектов Simulink, которые заменили свойства объектов ASAP2 предыдущего релиза:

Различия между ASAP2 и Simulink Parameter и свойствами объектов сигнала

(Предыдущие) свойства объектов ASAP2	(Текущие) свойства объектов Simulink
LONGID_ASAP2	Описание
PhysicalMin_ASAP2	Min
PhysicalMax_ASAP2	Max
Units_ASAP2	Модуль

Автоматическая замена адреса ECU для файлов ASAP2 (Embedded Coder)

Если Embedded Coder лицензируется и устанавливается в вашей системе, и если вы генерируете Исполняемый и Связываемый Формат (ELF) или База данных Программы (PDB) файлы для вашего целевого процессора, можно использовать rtw.asap2SetAddress функция, чтобы автоматизировать замену ECU Address значения адреса памяти заполнителя с исполнительными адресами в сгенерированном файле ASAP2.

Если атрибут адреса памяти неизвестен, прежде чем генерация кода, генератор кода вставит ECU Address текст заполнителя в сгенерированном файле ASAP2, как показано в примере ниже.

/begin CHARACTERISTIC
  /* Name            */ Ki
  /* Long Identifier */ ""
  /* Type            */ VALUE
  /* ECU Address     */ 0x0000 /* @ECU_Address@Ki@ */

Заменять исполнительными адресами ECU Address заполнители, обработайте сгенерированный файл ASAP2 с помощью rtw.asap2SetAddress функция. Общий синтаксис следующие:

rtw.asap2SetAddress(ASAP2File,InfoFile)

Аргументы являются векторами символов, задающими имя сгенерированного файла ASAP2 и имя сгенерированного исполняемого файла ELF, файла PDB от набора инструментальных средств Microsoft или файлов отладочной информации DWARF для модели. Когда названо, rtw.asap2SetAddress извлекает фактический адрес ECU из заданного ELF, PDB или файла DWARF и заменяет заполнителя в файле ASAP2 с исполнительным адресом, например:

/begin CHARACTERISTIC
  /* Name            */ Ki
  /* Long Identifier */ ""
  /* Type            */ VALUE
  /* ECU Address     */ 0x40009E60

Задайте информацию ASAP2 для интерполяционных таблиц

Программное обеспечение Simulink Coder генерирует описания ASAP2 для данных об интерполяционной таблице и его точек останова. Программное обеспечение представляет 1D табличные данные как CURVE информация, 2D табличные данные как MAP информация и точки останова как AXIS_DESCR и AXIS_PTS информация. Можно смоделировать интерполяционные таблицы с помощью одного из следующих блоков Интерполяционной таблицы Simulink:

Прямая Интерполяционная таблица (n-D) — 1 и 2 размерности
Интерполяция Используя Предварительный поиск — 1 и 2 размерности
1D интерполяционная таблица
Двумерная интерполяционная таблица
Интерполяционная таблица n-D — 1 и 2 размерности

Программное обеспечение поддерживает следующие типы точек останова интерполяционной таблицы (точки оси):

Установите точки останова тип	Генерирует
Настраиваемый и общий для несколько табличных осей (общая ось)	`COM_AXIS`
Зафиксированный и ненастраиваемый (зафиксированная ось)	Один из этих вариантов `FIX_AXIS`: `FIX_AXIS_PAR` если точки останова являются целыми числами с равноотстоящим интервалом, и равноотстоящий интервал является степенью двойки `FIX_AXIS_PAR_DIST` если точки останова являются целыми числами с равноотстоящим интервалом `FIX_AXIS_PAR_LIST` если точки останова являются целыми числами с неравноотстоящим интервалом
Настраиваемый, но не общий для несколько таблиц (стандартная ось)	`STD_AXIS`

Когда вы конфигурируете блоки для генерации кода ASAP2:

Для табличных данных используйте Simulink.Parameter объект данных с non-Auto класс памяти.
Для настраиваемых данных о точке останова, которые являются общими для несколько табличных осей (COM_AXIS), используйте Simulink.Parameter объект данных с non-Auto класс памяти.
Для фиксированных, ненастраиваемых данных о точке останова (FIX_AXIS), используйте переменные рабочей области или массивы, заданные в диалоговом окне параметров блоков. Точки останова должны храниться как целые числа в коде, таким образом, тип данных должен быть встроенным целочисленным типом (int8int16int32uint8uint16, или uint32), тип данных с фиксированной точкой или эквивалентный тип псевдонима.
Для настраиваемых данных о точке останова, которые не являются общими для несколько таблиц (STD_AXIS):
1. Создайте Simulink.Bus объект задать struct упаковка (имена и порядок полей). Поля структуры параметра должны соответствовать данным об интерполяционной таблице и каждой оси блока интерполяционной таблицы. Например, в блоке n-D Lookup Table с 2 размерностями, структура должна содержать только три поля. Этот объект шины описывает размещение записи для характеристики поиска.
2. Создайте Simulink.Parameter объект представлять настраиваемый параметр.
3. Составьте значения оси и таблица.
4. Опционально, задайте Units, Minimum и свойства Maximum для объекта параметра. Свойства будут применены к табличным данным только.

Вот пример записи n-D Lookup Table, сгенерированной в файл ASAP2 в Стандартном формате Оси:

/begin CHARACTERISTIC
  /* Name */  STDAxisParam
  ...
  /* Record Layout */   Lookup1D_X_WORD_Y_FLOAT32_IEEE
  ...
  begin AXIS_DESCR
    /* Description of X-Axis Points */
    /* Axis Type */      STD_AXIS
    ...
  /end AXIS_DESCR
/end CHARACTERISTIC

/begin RECORD_LAYOUT Lookup1D_X_WORD_Y_FLOAT32_IEEE
  AXIS_PTS_X 1 WORD INDEX_INCR DIRECT
  FNC_VALUES 2 FLOAT32_IEEE COLUMN_DIR DIRECT
/end   RECORD_LAYOUT

Примечание

Модель rtwdemo_asap2 в качестве примера иллюстрирует генерацию файла ASAP2 для блоков Интерполяционной таблицы, и включая настраиваемый (COM_AXIS) и включая зафиксированные точки останова интерполяционной таблицы (FIX_AXIS).

Сгенерируйте файл ASAP2

О генерации файлов ASAP2
Используйте GRT или системный конечный файл ERT
Используйте цель определения данных ASAM-ASAP2
Сгенерируйте файлы ASAP2 для моделей, на которые ссылаются,
Объедините файлы ASAP2 для главных и моделей, на которые ссылаются,

О генерации файлов ASAP2

Можно сгенерировать файл ASAP2 из модели одним из следующих способов:

Используйте Типовую Цель В реальном времени или цель Embedded Coder, чтобы сгенерировать файл ASAP2 как часть генерации кода и процесса сборки.
Используйте Цель Определения данных ASAM-ASAP2, чтобы сгенерировать только файл ASAP2, не создавая исполняемый файл.

В этом разделе рассматриваются, как сгенерировать файл ASAP2 при помощи целей, которые имеют встроенную поддержку ASAP2. Для примера см. модель rtwdemo_asap2 в качестве примера ASAP2.

Используйте GRT или системный конечный файл ERT

Процедура для генерации определения данных ASAP2 для модели с помощью Типового системного конечного файла Целевого или Embedded Coder В реальном времени следующие:

Используйте Model Data Editor, чтобы применить классы памяти к сигналам, состояниям блока, и параметры блоков как описано в Применяют Классы памяти к Отдельному Сигналу, состоянию и Элементам данных Параметра. Используйте сигнал и утвердите имена, чтобы относиться к соответствующим записям ИЗМЕРЕНИЯ и именам объекта параметра, чтобы относиться к ХАРАКТЕРИСТИЧЕСКИМ записям.
Используйте класс памяти кроме Auto, FileScope, или, если вы устанавливаете класс памяти по умолчанию соответствующей категории данных к Default в редакторе Отображений Кода (настройка по умолчанию), Model default. Например, использование ExportedGlobal конфигурирует элемент данных как неструктурированную глобальную переменную в сгенерированном коде.
Примечание
Параметры не представлены в файле ASAP2, если один или несколько следующих условий существует:
- Вы применяете класс памяти Auto, FileScope, или Default (через Model default).
- Вы применяете класс памяти, который заставляет генератор кода генерировать макро-или неадресуемую переменную.
Используйте Model Data Editor, чтобы сконфигурировать остающиеся свойства, как желаемый для каждого элемента данных.
На панели Code Generation нажмите Browse, чтобы открыть Системный Браузер Конечного файла. В браузере выберите grt.tlc или ERT основывал конечный файл, и нажмите OK.
Выберите параметр конфигурации модели ASAP2 interface.
Выберите параметр Generate code only.
Нажмите Apply.
Сгенерируйте код.
Генератор кода записывает файл ASAP2 в папку сборки. По умолчанию файл называют model.a2l, где model имя модели. Файл настройки ASAP2 управляет именем файла ASAP2. Для получения дополнительной информации смотрите, Настраивают Сгенерированный Файл ASAP2.

Используйте цель определения данных ASAM-ASAP2

Процедура для генерации определения данных ASAP2 для модели с помощью Цели Определения данных ASAM-ASAP2 следующие:

Используйте Model Data Editor, чтобы применить классы памяти к сигналам, состояниям блока, и параметры блоков как описано в Применяют Классы памяти к Отдельному Сигналу, состоянию и Элементам данных Параметра. Используйте сигнал и утвердите имена, чтобы относиться к соответствующим записям ИЗМЕРЕНИЯ и именам объекта параметра, чтобы относиться к ХАРАКТЕРИСТИЧЕСКИМ записям.
Используйте класс памяти или пользовательский класс памяти кроме Auto, FileScope, или, если вы устанавливаете класс памяти по умолчанию соответствующей категории данных к Default в Коде, Сопоставляющем Редактор (настройка по умолчанию), Model default. Например, использование ExportedGlobal конфигурирует элемент данных как неструктурированную глобальную переменную в сгенерированном коде.
Примечание
Элемент данных не представлен в файле ASAP2, если один или несколько следующих условий существует:
- Вы применяете один из классов памяти Auto, FileScope, или Default (через Model default).
- Вы применяете пользовательский класс памяти, который заставляет генератор кода генерировать макро-или неадресуемую переменную.
Используйте Model Data Editor, чтобы сконфигурировать остающиеся свойства, как желаемый для каждого элемента данных.
На панели Code Generation нажмите Browse, чтобы открыть Системный Браузер Конечного файла. В браузере выберите asap2.tlc и нажмите OK.
Выберите параметр конфигурации модели Generate code only.
Нажмите Apply.
Сгенерируйте код.
Генератор кода записывает файл ASAP2 в папку сборки. По умолчанию файл называют model.a2l, где model имя модели. Файл настройки ASAP2 управляет именем файла ASAP2. Для получения дополнительной информации смотрите, Настраивают Сгенерированный Файл ASAP2.

Сгенерируйте файлы ASAP2 для моделей, на которые ссылаются,

Процесс сборки может сгенерировать файл ASAP2 для каждой модели, на которую ссылаются, в иерархии модели - ссылки. В сгенерированном файле ASAP2 записи ИЗМЕРЕНИЯ представляют сигналы и состояния в модели, на которую ссылаются.

Чтобы сгенерировать файлы ASAP2 для моделей, на которые ссылаются, выберите генерацию файла ASAP2 для топ-модели и для каждой модели, на которую ссылаются, в ссылочной иерархии. Например, если вы используете Типовую Цель В реальном времени или цель Embedded Coder, выполняете процедуру, описанную в GRT Использования или Системном Конечном файле ERT для топ-модели и каждой модели, на которую ссылаются.

Объедините файлы ASAP2 для главных и моделей, на которые ссылаются,

Используйте функциональный rtw.asap2MergeMdlRefs объединять файлы ASAP2, сгенерированные для главных и моделей, на которые ссылаются. Функция имеет следующий синтаксис:

[status,info] = rtw.asap2MergeMdlRefs(topModelName,asap2FileName)

topModelName имя модели, содержащей одну или несколько моделей, на которые ссылаются.
asap2FileName имя, которое вы задаете для объединенного файла ASAP2.
Дополнительный:: status возвращает false (логический ноль), если слияние завершается и верный (логическая единица) в противном случае.
Дополнительный:: info возвращает дополнительную информацию об отказе слияния если status верно. В противном случае это возвращает пустой символьный вектор.

Рассмотрите следующий пример.

[status,info] = rtw.asap2MergeMdlRefs('myTopMdl','merged.a2l')

Эта команда объединяет файлы ASAP2, сгенерированные для топ-модели myTopMdl и его модели, на которые ссылаются, в файле merged.a2l.

Модель rtwdemo_asap2 в качестве примера включает пример слияния файлов ASAP2.

Структура файла ASAP2

Следующая таблица обрисовывает в общих чертах базовую структуру файла ASAP2 и описывает функции Компилятора выходного языка (TLC), и файлы раньше создавали каждую часть файла:

Статические части файла ASAP2 показывают полужирным.
Вызовы функции обозначаются %<FunctionName()>.

Раздел файла	Содержимое asap2main.tlc	Файл TLC, содержащий функциональное определение
Заголовок файла	`%<ASAP2UserFcnWriteFileHead()>`	`asap2userlib.tlc`
`/begin PROJECT ""`	`/begin PROJECT` `"%<ASAP2ProjectName>"`	`asap2setup.tlc`
`/begin HEADER ""` `HEADER` содержимое	`/begin HEADER``"% <ASAP2HeaderName>" % <ASAP2UserFcnWriteHeader ()>`	`asap2setup.tlc` `asap2userlib.tlc`
`/end HEADER`	`/end HEADER`	`asap2userlib.tlc`
`/begin MODULE ""` `MODULE` содержимое:	`/begin MODULE` `"%<ASAP2ModuleName>"}`	`asap2setup.tlc` `asap2userlib.tlc`
`- A2ML - MOD_PAR - MOD_COMMON` ...	`%<ASAP2UserFcnWriteHardwareInterface()>`	`asap2userlib.tlc`
`MODULE` модели зависимый содержимое:	`%<SLibASAP2WriteDynamicContents()>` Вызывает пользовательские функции:	`asap2lib.tlc`
`- RECORD_LAYOUT - ХАРАКТЕРИСТИКА - ParameterGroups - ModelParameters`	`... WriteRecordLayout_TemplateName () ... WriteCharacteristic_TemplateName () ... WriteCharacteristic_Scalar ()`	`user/templates/...`
`- ИЗМЕРЕНИЕ - ExternalInputs - BlockOutputs`	`...WriteMeasurement()`	`asap2userlib.tlc`
`- COMPU_METHOD`	`...WriteCompuMethod()`	`asap2userlib.tlc`
`/end MODULE`	`/end MODULE`
Нижний колонтитул/хвост файла	`%<ASAP2UserFcnWriteFileTail()>`	`asap2userlib.tlc`

Создайте основанный на хосте файл определения данных ASAM-ASAP2 для измерения данных и калибровки

Открыть скрипт

Эта модель показывает экспорт данных ASAP2. ASAP2 является стандартом определения данных, предложенным Ассоциацией для Стандартизации Автоматизации и Измеряющихся Систем (ASAM).

Открытая модель в качестве примера

Откройте модель rtwdemo_asap2 в качестве примера.

open_system('rtwdemo_asap2');

ASAP2 является необъектно-ориентированным описанием данных, используемых в измерении, калибровке и системах диагностики. Для получения дополнительной информации о ASAM и стандарте ASAP2, смотрите веб-сайт ASAM: https://www.asam.net.

Определение данных ASAP2 достигается с объектами данных Simulink® и сигналами тестовой точки. Используя Компилятор выходного языка (TLC), можно создать очень специализированные решения для приложения. См. документацию Simulink Coder® для получения дополнительной информации о генерации файла ASAP2.

Можно сконфигурировать генерацию файла ASAP2 путем выбора интерфейса ASAP2 на Генерации кода> Интерфейсная панель диалогового окна Configuration Parameters.

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