Обеспечьте трассируемость между объектами модели, сгенерированным кодом и требованиями модели

Когда вы используете Модельно-ориентированное Проектирование и генерацию производственного кода для разработки компонентов прикладного программного обеспечения, можно сгенерировать traceability matrix. Матрица трассируемости обеспечивает трассируемости между объектами модели, сгенерированным кодом и требованиями модели. Можно добавить комментарии к сгенерированной матрице трассируемости. Если вы измените модель и регенерируете матрицу трассируемость, матрица сохраняет ваши комментарии.

Для модели сгенерированная матрица трассируемости предоставляет информацию о:

  • Моделируйте объекты, которые отслеживаются между моделью и сгенерированным кодом, такие как Simulink® блоки, Stateflow® объекты и MATLAB® функций.

  • Моделируйте объекты, которые не отслеживаются между моделью и сгенерированным кодом, такие как исключенные и виртуальные блоки.

  • Требует документы, которые вы связываете с объектами модели при помощи Simulink Requirements™.

Когда вы генерируете матрицу трассируемости, XLS создается файл. Этот файл содержит следующие листы:

  • Model Information ─ Сводные данные строения модели и контрольная сумма. Сводные данные включают имя модели, версию, автора, дату создания, последнюю сохраненную по идентификатору, последнюю обновленную дату, контрольную сумму и выбор параметров отчета о трассируемости.

  • Code Interface ─ Информация об интерфейсе сгенерированного кода, таком как прототип функции и времени выполнения для инициализации модели и шага функций.

  • Code Files ─ Папки и имена файлов сгенерированного кода.

  • Report информацию ─ трассируемости для каждого объекта модели, включая имя модели, сгенерированный код и требования. Каждая строка в листе относится к одному вхождению объекта модели. Информация для объекта модели находится более чем в одной строке, если объект:

    • Появляется более одного раза в сгенерированном коде.

    • Ссылки на несколько требований.

Необходимые условия для генерации матрицы трассируемости

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

  1. (Необязательно) Прикрепить документы требований. Для получения дополнительной информации смотрите Ссылки требования (Simulink Requirements).

  2. В диалоговом окне Параметров конфигурации выберите:

  3. Сгенерируйте код для модели. Embedded Coder® для генерации кода требуется лицензия.

    Совет

    Вам не нужно создавать исполняемый файл, чтобы сгенерировать матрицу трассируемости. Чтобы сгенерировать код, в диалоговом окне Параметров конфигурации выберите Generate code only.

Сгенерируйте матрицу трассируемости

  1. Откройте модель, если она еще не открыта.

  2. Убедитесь, что завершены необходимые условия для генерации матрицы трассируемости.

  3. Сгенерируйте матрицу трассируемости с помощью одного из следующих методов:

    • В отчете генерации кода для вашей модели щелкните элемент Traceability Report Contents. В отчете о трассируемости нажмите Generate Traceability Matrix.

    • На панели инструментов Simulink откройте приложение DO Qualification Kit и выберите Traceability Matrix.

    • Программно используя do178c.ExportTraceReport функция.

  4. Чтобы задать новый файл матрицы, который вы хотите создать или просмотреть существующий файл матрицы, который вы хотите обновить, используйте поле Generate Traceability Matrix. Выберите и упорядочите столбцы, которые появляются в сгенерированной матрице. Чтобы создать или обновить указанный отчет, нажмите OK.

Добавление комментариев к матрице трассируемости

Можно добавить комментарии к матрице трассируемости, которую вы генерируете для своей модели. Чтобы добавить комментарии, вы должны:

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

  • Используйте уникальные заголовки столбца. Добавляемые столбцы должны иметь заголовки.

  • Добавьте по крайней мере одну запись к каждому столбцу, кроме заголовка столбца.

  • Сохраните следующие столбцы:

    • Имя объекта модели

    • Путь к объекту модели

    • Подсистема объектов модели

    • Расположение файла кода

    • Имя файла кода

    • Функция кода

    • Код линии

    • Уникальный идентификатор объекта модели

    • Оптимизированный объект модели

    • Контрольная сумма комментария к коду

Примечание

Комментарии должны разрешиться к текстовой строке. Например, ссылка на изображение разрешается в текстовую строку, а копия изображения - нет.

Перегенерируйте матрицу трассируемости электронной таблицы, чтобы сохранить комментарии

  1. Откройте существующую матрицу трассируемости или сгенерируйте новую матрицу трассируемости. См. «Генерация матрицы трассируемости».

  2. В поле Excel file найдите и выберите таблицу матрицы трассируемости, которую вы хотите заменить.

  3. Программа регенерирует матричную таблицу трассируемости и вносит следующие изменения:

    • Ранее сгенерированная матричная электронная таблица трассируемости переименована <FileName>_Trace_BAK.xlsx

    • Новая матричная электронная таблица трассируемости сохранена следующим <FileName>_Trace_.xlsx

    Проверьте, что недавно сохраненная матричная таблица трассируемости, <FileName>_Trace_.xlsx, включает ваши комментарии.

Трассируемость Матрицы ограничения

Генерация матрицы трассируемости имеет следующие ограничения:

  • Работает только с Microsoft® Windows® платформы.

  • Не поддерживает ссылку на модели. Когда вы генерируете матрицу трассируемости для модели, которая содержит ссылочные модели, матрица трассируемости содержит информацию только о Model блоке. Матрица трассируемости не содержит информации о содержимом модели-ссылки. Если ваша модель содержит модели-ссылки, сгенерируйте матрицу трассируемости для модели верхнего уровня и каждой модели-ссылки отдельно.

  • Не поддерживает модели, которые используют опцию строения модели Classic call interface (GRTInterface).

  • В большинстве случаев программное обеспечение идентифицирует комментарии, которые вы добавляете к матрице трассируемости. Когда комментарии не могут быть идентифицированы, матрица трассируемости включает текст: Строка не уникальна: comment.

  • Если требование связано с аннотацией, не содержащейся в блоке DocBlock, матрица трассируемости не содержит ссылку требования. Чтобы сгенерировать отчет о трассируемости, содержащий ссылку требования на аннотацию, поместите аннотацию в DocBlock блок.