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

Структура AR-PACKAGE

Стандарт AUTOSAR определяет пакеты AUTOSAR (AR-PACKAGEs). AR-PACKAGE содержат группы элементов AUTOSAR и находятся в иерархической структуре AR-PACKAGE. В средстве разработки AUTOSAR (AAT) или в Simulink структуру AR-PACKAGE можно настроить следующим образом:

Импортер ARXML импортирует AR-PACKAGEs, их элементы и пути в Simulink. Конфигурация модели сохраняет пакеты для последующего экспорта в код ARXML. Как правило, программное обеспечение сохраняет пакеты AUTOSAR во время поездок в оба конца между AAT и Simulink.

Если компонент AUTOSAR был создан в Simulink при создании компонента, построитель компонентов AUTOSAR создает начальную структуру AR-PACKAGE по умолчанию, содержащую следующие пакеты.

Например, предположим, что вы начинаете с простой модели Simulink, такой как rtwdemo_counter. Переименовать в mySWC. Настройте модель для генерации кода AUTOSAR. (Например, откройте окно быстрого запуска встроенного кодера и выберите создание кода AUTOSAR.) При построении модели ее начальная структура AR-PACKAGE напоминает следующий рисунок.

После создания компонента можно использовать представление Параметры XML в словаре AUTOSAR для указания дополнительных пакетов AR. (См. раздел Настройка параметров AUTOSAR XML или Настройка параметров AUTOSAR Adaptive XML.) Каждый AR-PACKAGE представляет категорию элементов AUTOSAR. При создании кода экспортер ARXML генерирует пакет, если в модели существуют какие-либо элементы его категории. Для каждого пакета указывается путь, определяющий его расположение в структуре AR-PACKAGE.

С помощью параметров XML можно настроить пакеты AUTOSAR для следующих категорий элементов AUTOSAR:

Структура AR-PACKAGE логически отличается от однофайлового или модульного разбиения файлов, которое можно выбрать для экспорта ARXML, используя опцию XML Экспортированная упаковка XML-файлов. Дополнительные сведения об экспорте пакета AUTOSAR см. в разделе Расположение AR-PACKAGE в экспортированных файлах ARXML.

Настройка пакетов и путей AUTOSAR

При импорте структуры AR-PACKAGE в Simulink импортер ARXML сохраняет отношения «пакет-элемент» и пути к пакету, определенные в коде ARXML. Кроме того, импортер заполняет свойства упаковки в представлениях компонентов и XML Options в словаре AUTOSAR. Если код ARXML не присваивает пакетам элементы AUTOSAR на основе категории, импортер использует эвристику для определения оптимальной связи категорий для пакета. Однако с категорией может быть связан максимум один пакет.

Предположим, что вы начинаете с модели Simulink, отличной от AUTOSAR, и настраиваете модель для генерации кода AUTOSAR. (Например, откройте окно быстрого запуска встроенного кодера и выберите создание кода AUTOSAR.) Программа создает начальную структуру AR-PACKAGE по умолчанию. После создания компонента в представлении компонента в словаре AUTOSAR отображаются параметры XML компонента, включая пути пакета для компонента, внутреннее поведение и реализацию.

В представлении «Параметры XML» отображаются пути для типов данных AUTOSAR и пакетов интерфейса, а также дополнительные пакеты.

С помощью подпанели Дополнительные пакеты можно заполнить поля пути для дополнительных пакетов или оставить их пустыми. Если оставить поле пакета пустым и если модель содержит упаковываемые элементы этой категории, экспортер ARXML использует внутренние правила для вычисления пути пакета. Применение внутренних правил обратно совместимо с более ранними версиями. В следующей таблице перечислены свойства упаковки опций XML с путями пакетов по умолчанию на основе правил.

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

hModel = 'autosar_swc_counter';
addpath(fullfile(matlabroot,'/examples/autosarblockset/main'));
open_system(hModel);
arProps=autosar.api.getAUTOSARProperties(hModel);
set(arProps,'XmlOptions','ApplicationDataTypePackage','/Company/Powertrain/DataTypes/ADTs');
get(arProps,'XmlOptions','ApplicationDataTypePackage')

Пример сценария см. в разделе Настройка экспорта AUTOSAR XML.

Пример настройки и экспорта пакетов AUTOSAR см. в разделе Экспорт пакетов AUTOSAR.

Управление элементами AUTOSAR, на которые влияют изменения пути пакета

Если изменяется путь к пакету AUTOSAR и затрагиваются упаковываемые элементы этой категории, можно:

Если изменить путь к пакету в словаре AUTOSAR и затронуть упаковываемые элементы этой категории, откроется диалоговое окно. Например, если изменить параметр XML ConstantSpecification Package из значения пути /pkg/dt/Ground кому /pkg/misc/MyGround, программа открывает следующее диалоговое окно.

Чтобы переместить элементы спецификации константы AUTOSAR в новый пакет, нажмите кнопку ОК. Чтобы задать путь к новому пакету без перемещения элементов, нажмите кнопку Отмена.

При программном изменении пути к пакету можно использовать MoveElements для указания обработки затронутых элементов. Свойство может иметь значение All (по умолчанию), None, или Alert. При указании Alertи если затрагиваются упакованные элементы, программа открывает диалоговое окно с помощью кнопок OK и Cancel.

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

hModel = 'autosar_swc_expfcns';
addpath(fullfile(matlabroot,'/examples/autosarblockset/main'));
open_system(hModel);
arProps = autosar.api.getAUTOSARProperties(hModel);
set(arProps,'XmlOptions','ConstantSpecificationPackage','/pkg/misc/MyGround',...
    'MoveElements','None');

Экспорт пакетов AUTOSAR

В этом примере показано, как настроить и экспортировать пакеты AUTOSAR для программного компонента AUTOSAR, созданного в Simulink.

Расположение AR-PACKAGE в экспортированных файлах ARXML

Группирование элементов AUTOSAR в пакеты AUTOSAR (AR-PACKAGEs) логически отличается от пакета выходных файлов ARXML, который контролирует параметр конфигурации AUTOSAR Экспортированный пакет XML-файлов. Устанавливается ли для параметра Экспортированная упаковка XML-файлов значение Single file или Modular, экспорт ARXML сохраняет сконфигурированную структуру AR-PACKAGE.

Предположим, что пример модели настроен autosar_swc_expfcns со следующей структурой AR-PACKAGE. (См. шаги в разделе Экспорт пакетов AUTOSAR.) В этой конфигурации путь к пакету спецификаций констант был изменен по сравнению с исходной настройкой модели. /pkg/dt/GroundКому /pkg/misc/myGround.

При экспорте этой структуры AR-PACKAGE в один файл (для параметра Экспортированная упаковка XML-файлов установлено значение Single file) экспортированный код ARXML сохраняет сконфигурированную структуру AR-PACKAGE.

autosar_swc_expfcns.arxml:

<AR-PACKAGES>
    <AR-PACKAGE>
        <SHORT-NAME>pkg</SHORT-NAME>
        ...
                <SHORT-NAME>swc</SHORT-NAME>
                ...
                <SHORT-NAME>if</SHORT-NAME>
                ...
                <SHORT-NAME>dt</SHORT-NAME>
                ...
                        <SHORT-NAME>SwBaseTypes</SHORT-NAME>
                     ...
                <SHORT-NAME>misc</SHORT-NAME>
                ...
                        <SHORT-NAME>MyGround</SHORT-NAME>
                        ...
                <SHORT-NAME>imp</SHORT-NAME>
                ...
    </AR-PACKAGE>
</AR-PACKAGES>

При экспорте одной и той же структуры AR-PACKAGE в несколько файлов (для параметра Экспортированная упаковка XML-файлов установлено значение Modular) экспортированный код ARXML сохраняет сконфигурированную структуру AR-PACKAGE, распределенную по нескольким файлам.

Экспортер сопоставляет упаковываемые элементы AUTOSAR с файлами ARXML на основе категории элементов, а не пути к пакету. Например, экспортер отображает ориентированный на тип данных ConstantSpecification пакет, /pkg/misc/myGround, для типов данных ARXML файл, autosar_swc_expfcns_datatype.arxml.

autosar_swc_expfcns_component.arxml:

<AR-PACKAGES>
    <AR-PACKAGE>
        <SHORT-NAME>pkg</SHORT-NAME>
        ...
                <SHORT-NAME>swc</SHORT-NAME>
                ...
    </AR-PACKAGE>
</AR-PACKAGES>

autosar_swc_expfcns_datatype.arxml:

<AR-PACKAGES>
    <AR-PACKAGE>
        <SHORT-NAME>pkg</SHORT-NAME>
        ...
                <SHORT-NAME>dt</SHORT-NAME>
                ...
                        <SHORT-NAME>SwBaseTypes</SHORT-NAME>
                        ...
                <SHORT-NAME>misc</SHORT-NAME>
                ...
                        <SHORT-NAME>MyGround</SHORT-NAME>
                        ...   
    </AR-PACKAGE>
</AR-PACKAGES>

autosar_swc_expfcns_implementation.arxml:

<AR-PACKAGES>
    <AR-PACKAGE>
        <SHORT-NAME>pkg</SHORT-NAME>
        ...
                <SHORT-NAME>imp</SHORT-NAME>
                ...
    </AR-PACKAGE>
</AR-PACKAGES>

autosar_swc_expfcns_interface.arxml:

<AR-PACKAGES>
    <AR-PACKAGE>
        <SHORT-NAME>pkg</SHORT-NAME>
        ...
                <SHORT-NAME>if</SHORT-NAME>
                ...
    </AR-PACKAGE>
</AR-PACKAGES>