Holarch

Интерфейсы

Интерфейсы

Определение интерфейсов как Conduit, запись того, что через них передаётся, проверка пропускной способности, отслеживание зрелости интерфейсов в Реестре интерфейсов и создание ICD, матриц N² и I².

Как использовать →

На этой странице
  1. Обзор
  2. Понятия
    1. Conduit
    2. Input/Output (элемент)
    3. Требования к интерфейсу
    4. Порты и интерфейсные блоки
    5. Проверка пропускной способности
    6. Направление потока элементов
  3. Как использовать
    1. Когда и зачем
    2. Определение интерфейса на диаграмме внутренних блоков
    3. Просмотр всех интерфейсов в реестре
    4. Создание документа управления интерфейсами
    5. Проверка интерфейсов с функциональной стороны
    6. Разобранный пример: интерфейс полезной нагрузки CubeSat EO-1
    7. Советы и рекомендации
    8. Типичные ошибки
    9. Связь с другими функциями
  4. Реестр интерфейсов
    1. Заголовок страницы
    2. Карточки статусов
    3. Таблица
  5. Панель интерфейса в инспекторе
    1. Панель порта
  6. Диаграмма управления интерфейсами
    1. Панель инструментов
    2. Палитра
    3. Редактирование на холсте
    4. Вид ▾
    5. Столбцы таблицы ICD (CSV)
    6. Содержание документа ICD (Word)
  7. Диалог реестра интерфейсов
  8. Диаграмма физических входов/выходов
    1. Создание линии
    2. Предупреждения линий
  9. Диаграммы N² и I²
  10. Элементы и I/O
  11. Сочетания клавиш
  12. Сообщения
  13. Ограничения
  14. Связанные материалы

Обзор

Используйте страницы раздела “Интерфейсы”, чтобы определить, что пересекает каждую границу системы, проверить, может ли каждый путь это переносить, и передать результат другим командам в виде ICD.

В Holarch интерфейс — это Conduit. Conduit — это сущность модели, которая:

  • connects to двум активам (или портам)
  • transfers элементы Input/Output, которые через неё проходят

Каждый Conduit в проекте — это интерфейс, где бы вы его ни нарисовали: на диаграмме внутренних блоков, диаграмме физических входов/выходов, диаграмме управления интерфейсами, диаграмме I² или в базе данных.

Группа Интерфейсы на боковой панели навигации содержит четыре страницы:

СтраницаЧто показывает
Реестр интерфейсовКаждый Conduit с конечными точками, статусом, владельцем, TBD/TBR, числом элементов, числом требований и проверкой пропускной способности.
ICDДиаграммы управления интерфейсами в проекте (список диаграмм, отфильтрованный по этому типу).
Диаграммы N²Диаграммы N² в проекте: функции на диагонали, Input/Output, которыми они обмениваются, в ячейках.
Элементы и I/OБаза данных, отфильтрованная по классу Input/Output.

Понятия

Conduit

Conduit — это физический или логический путь между двумя активами: кабель, шина, радиолиния, трубопровод, сетевое соединение. Он связан со своими конечными точками через connects to (со стороны актива — connected by).

Conduit можно декомпозировать на дочерние Conduit. Тогда родитель действует как жгут: он передаёт всё, что передают его дочерние элементы.

Holarch добавляет каждому Conduit следующие атрибуты интерфейса:

АтрибутЗначение
Capacity и UnitsМаксимум, который может переносить канал, например 400 Mbps или 15 W. Используется проверкой пропускной способности.
LatencyЗадержка при прохождении канала (длительность).
Connector/PinsТип разъёма и назначение контактов на каждом конце.
MediumФизическая среда, например медь, оптоволокно, радиолиния, трубопровод.
ВладелецЧеловек или команда, отвечающие за определение интерфейса.
Статус интерфейсаЗрелость определения: Draft, Proposed, Agreed или Baselined.
TBD/TBRОткрытые вопросы: None, TBD (подлежит определению) или TBR (подлежит рецензированию).

Input/Output (элемент)

Input/Output (элемент) — это то, что пересекает интерфейс: данные, мощность, жидкость, сила, сигнал. У него три вида связей:

  • generated by Action, которое его производит
  • received by Action, которое его потребляет
  • transferred by Conduit, которые его переносят

Holarch добавляет следующие атрибуты:

АтрибутЗначение
Size и UnitsКоличество на элемент, например 2.5 GB. Учитывается проверкой пропускной способности, если Data Rate не задан.
Data Rate и Data Rate UnitsСкорость, с которой передаётся элемент, например 480 Mbps или 6 W. Проверка пропускной способности суммирует её.
Protocol/FormatПротокол, кодирование или физический формат.
Message/Data DefinitionПоля, диапазоны и смысл данных, которые переносит элемент.

Требования к интерфейсу

Требование к интерфейсу связывается с Conduit через traced from (Conduit трассируется от требования). Требования, которым Conduit satisfies, тоже перечисляются. Требование, созданное из окна выбора требований интерфейса, получает метку Interface Requirement.

Порты и интерфейсные блоки

На блочных диаграммах конечной точкой может быть Port блока, а не сам блок. Порт может быть типизирован Input/Output или Interface Block. Interface Block — это Asset с меткой Interface Block; он описывает элементы и потоки, которые поддерживает точка взаимодействия.

Порт с Conjugated использует свой тип с обращёнными направлениями всех потоков. Он показывается как ~Type.

Проверка пропускной способности

Проверка пропускной способности сообщает, может ли Conduit переносить свои элементы. Для каждого Conduit Holarch:

  1. Берёт нагрузку каждого передаваемого элемента: его Data Rate или его Size, если скорость не задана.
  2. Преобразует каждую нагрузку в Units Conduit и суммирует их.
  3. Сравнивает итог с Capacity.

Элементы дочерних каналов жгута учитываются в жгуте. Результат — один из следующих:

РезультатТекст в реестреЗначение
В пределах пропускной способностиOKОбщая нагрузка укладывается.
Превышение пропускной способностиПревышение пропускной способностиОбщая нагрузка превышает Capacity.
Несоответствие единицНесоответствие единицЕдиницы хотя бы одного элемента не преобразуются в единицы Conduit; этот элемент исключается из итога.
Нет пропускной способностиНет пропускной способностиУ Conduit есть элементы, но нет Capacity, поэтому нагрузка не проверяется.
Пусто—Conduit не передаёт элементов.

Единицы преобразуются той же системой единиц, что и в бюджетах (см. Единицы и величины), поэтому kbps, Mbps, Gbps, B/s, kW и W свободно смешиваются в пределах одного рода.

Направление потока элементов

На соединителе IBD каждый элемент показывает стрелку. Holarch берёт направление из первого источника, который его определяет:

  1. Action, выполняемые с каждой стороны. Отправляет элемент та сторона, чьё Action его генерирует.
  2. Атрибуты Direction портов (In, Out, In and Out).
  3. Собственная настройка Поток элементов соединителя.

Как использовать

Когда и зачем

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

Управление интерфейсами отвечает на четыре вопроса:

  • Что пересекает каждую границу? Передаваемые элементы с их скоростями, форматами и определениями данных.
  • Может ли путь это переносить? Проверка пропускной способности.
  • Кто владелец и согласовано ли это? Owner, Interface Status и TBD/TBR.
  • Какие требования это регулируют и что передать другой команде? Требования к интерфейсам и документ ICD.

Типичный ритм:

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

Определение интерфейса на диаграмме внутренних блоков

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

  1. Откройте Архитектура → Блок-диаграммы.
  2. Откройте Диаграмма внутренних блоков системы. Чтобы создать её, нажмите + Новая диаграмма, выберите Диаграмма внутренних блоков и выберите блок в Диаграмма для.
  3. Перетащите маркер на краю одной части на другую часть или порт.
  4. Отпустите на цели. Соединитель создаётся сразу. Когда вы перетаскиваете от порта на блок, выберите Соединить с блоком или Добавить сопряжённый порт в окне выбора соединения.

Вы увидите соединитель. Соединитель — это Conduit.

  1. Выберите соединитель.
  2. В инспекторе в разделе Передаваемые элементы (потоки элементов) добавьте элемент:
    • Чтобы передавать элемент, которым Action двух концов уже обмениваются, нажмите кнопку его предложения под Передаётся между концами:, например + Image Strip.
    • Иначе нажмите + Добавить элемент ▾ и выберите Существующий Input/Output… или Новый Input/Output….

Имя элемента появляется на соединителе зелёным цветом со стрелкой направления.

  1. На той же панели задайте Статус интерфейса, Владелец и TBD/TBR.
  2. В разделе Требования к интерфейсам нажмите + Связать требование… и выберите или создайте требование.
  3. В атрибутах сущности задайте Capacity и Units у Conduit.
  4. У каждого элемента задайте Data Rate и Data Rate Units или Size и Units.

Блок Проверка пропускной способности сразу обновляется. Подпись соединителя показывает статус в квадратных скобках, например Payload Interface [Agreed]. Подпись становится:

  • красной с ⚠ превышение пропускной способности, когда нагрузка слишком велика
  • оранжевой с ⚠ несоответствие единиц, когда единицы не преобразуются

Просмотр всех интерфейсов в реестре

  1. Откройте Интерфейсы → Реестр интерфейсов.

Вы увидите карточки статусов (Draft, Proposed, Agreed, Baselined, Не задано) и таблицу всех Conduit.

  1. Необязательно: щёлкните карточку, чтобы показать только эти интерфейсы. Щёлкните её снова или щёлкните чип Статус: … ×, чтобы показать все.
  2. Необязательно: введите текст в Фильтр по имени или конечной точке, чтобы сузить список.
  3. Просмотрите столбец Capacity на наличие Превышение пропускной способности и Несоответствие единиц, оба показываются красным.
  4. Щёлкните строку, чтобы открыть Conduit в инспекторе, и редактируйте там его атрибуты.
  5. Чтобы поделиться реестром, нажмите Экспортировать CSV. Чтобы получить документ Word для одного интерфейса, нажмите ICD в его строке.

Создание документа управления интерфейсами

Диаграмма управления интерфейсами описывает весь интерфейс между двумя родительскими активами. Её корень — Conduit для этого интерфейса.

  1. Откройте Интерфейсы → ICD.
  2. Нажмите + Новая диаграмма или откройте существующую диаграмму управления интерфейсами.
  3. Нажмите Слева нет Asset. Выберите Asset… и выберите первый родительский актив.
  4. Нажмите Справа нет Asset. Выберите Asset… и выберите второй.

Теперь каждая полоса перечисляет дочерние активы этого актива.

  1. Для каждого физического соединения перетащите Conduit из палитры на центральный блок.

В центральном блоке появляется дочерний канал в виде полосы.

  1. Для каждого элемента, который переносит дочерний канал, перетащите Input/Output на этот канал.
  2. Необязательно: чтобы добавить дочерний актив, перетащите Asset в полосу родителя.
  3. Перетащите от дочернего канала к дочернему активу (или наоборот). Связь connects to создаётся сразу. Повторите для другого конца.
  4. Выберите дочерний канал и заполните его панель интерфейса в инспекторе, как на IBD.
  5. Нажмите Экспортировать документ ICD, чтобы получить ICD в Word, или Экспортировать ICD (CSV), чтобы получить CSV.

Проверка интерфейсов с функциональной стороны

Начните с функций, чтобы найти обмены, у которых ещё нет физического пути.

  1. Откройте Интерфейсы → Диаграммы N² и откройте Диаграмма N² родительского Action.

Дочерние Action находятся на диагонали. Ячейка в строке A, столбце B перечисляет элементы, которые A генерирует, а B принимает.

  1. Чтобы добавить обмен, перетащите Input/Output из палитры на ячейку вне диагонали. Можно также перетащить блок с диагонали в ячейку его строки или столбца: там сразу создаётся Новый Input/Output.

Новый элемент получает имя по своей ячейке: <row action> To <column action>.

  1. Откройте Диаграмма физических входов/выходов родительского Asset.
  2. Щёлкните значок проверок диаграммы (⚠ и число замечаний).

Инспектор перечисляет в разделе Интерфейсы каждый элемент, который передаётся между двумя активами, но не имеет Conduit для переноса.

  1. Исправьте каждое замечание. Нажмите Показать, чтобы выбрать его линию, затем задайте недостающую часть в инспекторе линии (Добавить рядом с Ни один Conduit не переносит этот Input/Output.) или добавьте элемент в Conduit на IBD или ICD.

Разобранный пример: интерфейс полезной нагрузки CubeSat EO-1

Создайте демо через Управление проектами → Файлы проекта ▾ → Новый демо-проект, затем:

  1. Откройте Интерфейсы → Реестр интерфейсов.

Карточки показывают 2 Draft, 2 Proposed, 16 Agreed, 6 Baselined и 0 “Не задано”.

  1. Найдите IF-05 Payload Interface (C&DH ↔ Payload Camera).

Его столбец Capacity показывает Превышение пропускной способности.

  1. Наведите указатель на Превышение пропускной способности.

Вы увидите Превышение пропускной способности: 480.02 из 400 Mbps (120%).

  1. Щёлкните строку.

Инспектор показывает Conduit:

  • Capacity 400 Mbps
  • Owner Payload Lead
  • Medium LVDS twisted pairs plus SPI
  • Connector/Pins J5 (Micro-D 25)
  • Передаваемые элементы Command Schedule (0.02 Mbps) и Image Strip (480 Mbps)

Исходная скорость полосы снимков полезной нагрузки превышает возможности линии LVDS. Исправьте это одним из трёх способов:

  • Повысьте Capacity у Conduit до реального номинала линии, например 600. Тогда реестр показывает OK.
  • Добавьте бортовое сжатие, затем уменьшите Data Rate у Image Strip.
  • Запишите открытое решение: задайте TBD/TBR равным TBR и свяжите новое требование через + Связать требование… на IBD или ICD.
  1. Найдите IF-12 S-band Downlink и наведите указатель на его столбец Capacity.

Вы увидите В пределах пропускной способности: 9.6 из 10 Mbps (96%). Проверка пройдена, но запас мал, поэтому это кандидат в TPM. Демо отслеживает его как TPM-3 Payload Downlink Rate (см. Бюджеты и TPM).

  1. Откройте Интерфейсы → ICD → IF-10 Space-to-Ground Link.

Левый и правый родители — космический аппарат и наземный сегмент. Дочерние каналы — IF-11 UHF Command Uplink (9.6 kbps, Baselined) и IF-12 S-band Downlink (10 Mbps, Baselined).

  1. Нажмите Экспортировать документ ICD.

Файл Word содержит:

  • реестр интерфейсов для трёх каналов
  • сводку статусов
  • по разделу на каждый канал с его конечными точками, атрибутами, передаваемыми элементами (с направлением), связанными требованиями (5.1, 5.2 и 5.3) и проверкой пропускной способности
  1. Откройте Диаграмма внутренних блоков EPS.

Порт 12 V Bus типизирован интерфейсным блоком IFB-1 12 V Power Interface. Порт 12 V In полезной нагрузки использует тот же тип, сопряжённый, поэтому выглядит как 12 V In : ~12 V Power Interface.

Советы и рекомендации

  • Называйте Conduit существительными (Payload Interface, S-band Downlink) и давайте каждому номер (IF-05). Проверки модели отмечают каналы без имени, без номера и с именами, не являющимися существительными.
  • Указывайте скорость у элемента, а не у канала. Канал хранит пропускную способность, элементы — нагрузку. Тогда один элемент, передаваемый несколькими каналами, проверяется на каждом.
  • Используйте канал-жгут для жгута проводов или группы линий и дочерние каналы для каждой линии. Диаграмма ICD построена вокруг этой структуры.
  • Задавайте Статус интерфейса у каждого канала. Перед рецензированием проекта карточка Не задано должна показывать ноль.
  • Ссылайтесь на стандарт интерфейса: Artifact с меткой Standard, на который reference канал и оба актива. Проверка модели Conduit.7 ищет его.

Типичные ошибки

  • Несовпадающие единицы. У элемента Data Rate в Mbps, а Units канала — W. Реестр показывает Несоответствие единиц, и элемент не учитывается. Исправьте единицы на той стороне, где они неверны.
  • Канал только с одной конечной точкой. Endpoints показывает Не соединён или только одно имя. Соедините второй актив через connects to.

Связь с другими функциями

  • Получает данные из:
    • архитектуры: Asset, блоки и их декомпозиция
    • функционального анализа: Action, которые генерируют и принимают Input/Output
    • требований: требования к интерфейсам
  • Передаёт данные в:
    • RVTM: требования к интерфейсам верифицируются так же, как любые другие (см. Верификация)
    • Проверки модели: Conduit.1–9 и IO.1–10
    • бюджеты и TPM: запасы по скорости
    • пакеты рецензирования и базовые линии
  • Предложения: IBD предлагает элементы для передачи на основе Action, которые выполняет каждый конец, поэтому распределение функций и физические интерфейсы остаются согласованными.

Реестр интерфейсов

Страница перечисляет каждый Conduit в проекте. Она обновляется в реальном времени при изменении модели. В проекте SysML v2 она перечисляет использования connection и interface модели; производные требований не включаются. Отрисовываются только строки рядом с положением прокрутки, поэтому страница открывается сразу даже в больших проектах; экспорт всё равно включает все интерфейсы.

Элемент управленияДействие
Экспортировать CSVСкачивает Interface Register - <project>.csv: Number, Interface, Endpoints, Status, Owner, TBD/TBR, Items, Requirements, Capacity Check (полный текст проверки), затем сводка Status/Count.
ICDОткрывает список диаграмм управления интерфейсами.
+ Новый интерфейсОткрывает Новый интерфейс: Имя (необязательно; пустое даёт <first> to <second>) и два Asset, которые он соединяет (Выбрать… для каждого). Создать добавляет Conduit с двумя связями connected by и выбирает его строку; одно нажатие “Отменить” возвращает всё назад. В проекте SysML v2 кнопка называется + Новое соединение: она добавляет использование connection между двумя частями.

Карточки статусов

По одной карточке на статус (Draft, Proposed, Agreed, Baselined) плюс Не задано, каждая с числом. Карточки Agreed и Baselined зелёные, “Не задано” — янтарная.

Щёлкните карточку, чтобы отфильтровать. Чип Статус: <status> × сбрасывает фильтр. Адрес interfaces?status=<status> открывает страницу с фильтром. Рядом с Фильтр по имени или конечной точке счётчик показывает, например, 26 интерфейсов или 3 из 26 интерфейсов, пока действует фильтр.

Таблица

СтолбецСодержимое
ИнтерфейсНомер и имя; ссылка открывает вид элемента.
Конечные точкиДве соединённые сущности, A ↔ B, или Не соединён.
СтатусInterface Status или Не задано.
ВладелецАтрибут Owner.
TBD/TBRTBD или TBR; пусто для None.
ЭлементыЧисло передаваемых элементов, включая элементы дочерних каналов.
ТребованияЧисло связанных требований к интерфейсу.
Пропускная способностьOK, Превышение пропускной способности, Несоответствие единиц, Нет пропускной способности или —. Наведите указатель, чтобы увидеть полный текст.
(кнопка)ICD экспортирует документ ICD этого интерфейса (Word).

Щёлкните строку или поставьте на неё фокус и нажмите Enter или Space, чтобы показать Conduit в инспекторе. ↑ и ↓ переходят между строками. Esc снимает выбор.

Панель интерфейса в инспекторе

Панель интерфейса — место, где редактируется один интерфейс. Она появляется в инспекторе над атрибутами сущности, когда вы выбираете:

  • соединитель на диаграмме внутренних блоков
  • дочерний канал или центральный блок на диаграмме управления интерфейсами

Панель содержит:

  • Поток элементов (только IBD): Ненаправленный, Направленный, Обратный или Двунаправленный. Задаёт стрелки элементов, когда направление не определяют ни Action, ни направления портов.
  • Передаваемые элементы (потоки элементов): каждый элемент с его направлением (EPS → Payload Camera или в обе стороны). Элементы дочерних каналов помечены (дочерний канал). × прекращает передачу элемента; сам элемент остаётся. Без элементов: Нет элементов. Добавьте Input/Output, которые переносит этот соединитель.
  • Передаётся между концами: по одной кнопке + <item> на каждый предложенный элемент. Элемент предлагается, когда Action на одном конце генерирует его, Action на другом конце принимает его, а канал его ещё не передаёт.
  • + Добавить элемент ▾: Существующий Input/Output… (выбрать один) или Новый Input/Output… (дать имя; по умолчанию New Item).
  • Статус интерфейса, Владелец (заполнитель Человек или команда) и TBD/TBR.
  • Требования к интерфейсам: каждое связанное требование с traced from или satisfies. × удаляет связь. + Связать требование… открывает окно выбора. Требование, созданное там, получает метку Interface Requirement. Если ничего нет: Связей нет.
  • Проверка пропускной способности: текст проверки, красный при превышении пропускной способности.

Панель порта

Выбор порта на блочной диаграмме добавляет:

  • Тип: типизирующий Interface Block или Input/Output, или Без типа. Задать тип… (или Изменить…) открывает Тип порта (Interface Block или Input/Output). Очистить убирает тип. Типизация порта с помощью Asset добавляет этому Asset метку Interface Block.
  • Сопряжённый (обращает потоки типа; показывается как ~Type).

Типизированный порт выглядит как name : Type; сопряжённый — name : ~Type.

Диаграмма управления интерфейсами

Корень диаграммы управления интерфейсами — Conduit. Холст показывает:

  • полосу левого родительского актива и полосу правого родительского актива
  • между ними — центральный блок: корневой канал
  • внутри центрального блока — дочерние каналы в виде горизонтальных полос с их элементами в виде зелёных меток

Панель инструментов

Элемент управленияДействие
Слева: <asset> / Слева нет Asset. Выберите Asset…Выбрать левый родительский актив. Корневой канал connects to ему; связь с предыдущим левым родителем удаляется.
Справа: <asset> / Справа нет Asset. Выберите Asset…Выбрать правый родительский актив.
Экспортировать ICD (CSV)Скачивает ICD - <name>.csv, по одной строке на каждый дочерний канал и элемент (см. ниже).
Экспортировать документ ICDСкачивает ICD - <name>.docx (см. ниже).
Реестр интерфейсовОткрывает диалог с реестром для корня и его дочерних каналов.

Если родители не сохранены, используются первые два актива, к которым подключён корень.

Палитра

ПредметКуда бросатьРезультат
AssetПолоса родительского активаДочерний актив этого родителя (decomposed by). Иначе: Бросьте в полосу родительского актива.
ConduitЦентральный блок каналаДочерний канал корня. Иначе: Бросьте на блок канала в середине.
Input/OutputДочерний каналКанал transfers элемент. Иначе: Бросьте на дочерний канал.

Существующие Asset, Conduit и Input/Output можно так же перетаскивать из списка существующих сущностей палитры. Для всего остального: Эта диаграмма не может показать эту сущность.

Редактирование на холсте

  • Перетащите от дочернего канала к дочернему активу, чтобы связать их (connects to, создаётся сразу). Другие пары отклоняются с сообщением Дочерний канал соединяется с дочерним активом. Перетащите на него.
  • Перетащите дочерний актив в другую полосу, чтобы перенести его к тому родителю. Перетащите элемент на другой дочерний канал, чтобы перенести его туда.
  • Delete сразу убирает выбранное с диаграммы (удаляет связь; сущность остаётся). ⇧Delete / Shift+Delete удаляет сущность после подтверждения. Уборка полосы родителя удаляет связь с этим родителем.

Вид ▾

ПараметрСкрывает
Предупреждения о единицахКонтур предупреждения у элемента, единицы которого отличаются от единиц его канала, и соответствующее замечание в проверках диаграммы (<item> в <unit>; <conduit> переносит <unit>. Измените одну из единиц.).
Вх./вых.Метки элементов.
Задержка и пропускная способностьПодписи задержки и пропускной способности на центральном блоке и дочерних каналах.
Дочерние AssetДочерние активы в полосах и их линии соединения.

Подпись каждого дочернего канала показывает его статус в квадратных скобках и Latency: … · Capacity: …. Если проверка пропускной способности не пройдена, подпись добавляет · over (120%) или · unit mismatch, а полоса становится красной или оранжевой.

Столбцы таблицы ICD (CSV)

  • Канал и конечные точки: Child Conduit, From Asset, To Asset.
  • Элемент: I/O, Units.
  • Атрибуты канала: Latency, Capacity, Interface Status, Owner, TBD/TBR, Connector/Pins, Medium.
  • Атрибуты элемента: Direction (From → To, To → From или Both), Size, Data Rate, Data Rate Units, Protocol/Format, Message/Data Definition.
  • Requirements, Capacity Check.
  • По столбцу на каждый пользовательский атрибут Conduit (Conduit: <name>) и на каждый пользовательский атрибут Input/Output (I/O: <name>).

Содержание документа ICD (Word)

  1. Заголовок Interface Control Document: <root>, строка с названиями двух родительских активов и датой создания, и описание корня.
  2. Interface Register: Interface, Endpoints, Status, Owner, TBD/TBR, Items, Capacity для корня и каждого дочернего канала.
  3. Status Summary: число по каждому статусу.
  4. По разделу на каждый канал, где есть:
    • таблица Endpoints, Status, Owner, TBD/TBR, Connector/Pins, Medium, Latency, Capacity и любых пользовательских атрибутов
    • Conveyed Items: Item, Direction, Size, Data Rate, Protocol/Format, Message/Data Definition, а также пользовательские атрибуты I/O
    • Requirements: Number, Requirement, Statement
    • Проверка пропускной способности

Кнопка ICD в строке реестра интерфейсов создаёт тот же документ для одного этого канала и его дочерних элементов.

Диалог реестра интерфейсов

Кнопка Реестр интерфейсов на панелях инструментов ICD и IBD открывает Реестр интерфейсов: <name>. Он перечисляет каналы этой диаграммы:

  • метки статусов
  • таблица Interface, Endpoints, Status, Owner, TBD/TBR, Items, Requirements и Capacity
  • параметр Все Conduit в проекте
  • кнопки Экспортировать CSV, Экспортировать документ ICD (только ICD) и Закрыть

Если каналы не подключены: Нет Conduit. Добавьте Conduit на диаграмму, чтобы они перечислялись здесь.

Диаграмма физических входов/выходов

Используйте диаграмму физических входов/выходов, чтобы увидеть, какие элементы передаются между частями Asset и переносит ли каждый из них Conduit. Она показывает дочерние активы Asset и рисует по одной линии на каждый Input/Output, который передаётся между ними.

Линии выводятся из модели:

  • Action, которые выполняет каждый актив (generates → receives)
  • Conduit, которые соединяют активы

Пунктирная линия без элемента — это Conduit, который ничего не переносит.

  • Свёртка: Action, выполняемые любым потомком показанного актива, и Conduit, подключённые к нему, считаются собственными для этого актива. Потомки включают дочерние элементы, их дочерние элементы и порты.
  • Внешние: активы вне родителя, которые обмениваются с ним элементами, рисуются в отдельном ряду с пометкой внешний.
  • Панель инструментов: Считать внутренним и Считать внешним. Проверки интерфейсов находятся в значке проверок диаграммы. Для двух последних кнопок нужен выбранный актив (Сначала выберите актив.). Вид ▾ переключает Внешние Asset и Предупреждения.

Создание линии

  1. Перетащите от одного актива к другому.

Линия появляется сразу, от первого актива ко второму, и одно нажатие “Отменить” возвращает всё назад:

  • новый Input/Output New Input/Output;
  • переносимый Conduit, который уже связывает два актива, или новым Conduit A to B (его Origin — на конце первого актива);
  • отправляемый единственным Action первого актива или новым Send New Input/Output и принимаемый единственным Action второго актива или новым Receive New Input/Output.
  1. Новая линия выбирается. В её инспекторе по одному слоту на каждую часть: Input/Output, Conduit, Отправляющий Action и Получающий Action. В каждом слоте:
    • Изменить… выбирает существующую сущность этого класса;
    • Создать создаёт новую с именем по умолчанию (переименуйте её в её собственном инспекторе);
    • Очистить (только Input/Output) сохраняет линию Conduit без элемента.
  2. Необязательно: отметьте Двусторонний, если Conduit переносит элементы в обе стороны.

Каждое изменение перезаписывает линию, и одно нажатие “Отменить” возвращает всё назад. Отсутствующая часть отмечается в слоте (например, ⚠ Ни один Conduit не переносит этот Input/Output.) с кнопкой Добавить, чтобы создать её.

Предупреждения линий

УровеньСообщение
Предупреждение<item> передаётся между A и B, но ни один Conduit не связывает их, чтобы переносить его.
Предупреждение<item> передаётся между A и B, но ни один из Conduit, связывающих A и B, его не переносит.
Предупреждение<item> передаётся между A и B, но ни одно Action не производит и не потребляет его там.
Ошибка<item> передаётся между A и B в направлении, которое соединяющий Conduit не допускает.
Информация<conduit> связывает A и B, но не переносит Input/Output.

Линии с предупреждениями — янтарные, с ошибками — красные. Значок проверок диаграммы перечисляет их в разделе Интерфейсы; Показать выбирает линию. Инспектор выбранной линии перечисляет её собственные.

Диаграммы N² и I²

Обе — квадратные матрицы, построенные из дочерних элементов корня.

Диаграмма N²Диаграмма I²
КореньActionAsset
ДиагональДочерние ActionДочерние Asset
ЯчейкиInput/Output: строка генерирует, столбец принимаетConduit: строка — конец-источник, столбец — другой конец
Верхняя строкаВнешние Input (принимаются, не генерируются ничем в матрице)To (каналы с одним концом, входящие в столбец)
Правый столбецВнешние Output (генерируются, не принимаются ничем в матрице)From (каналы с одним концом, выходящие из строки)
Панель инструментов+ Action, Убрать, Экспортировать CSV+ Asset, Убрать, Экспортировать CSV
  • Добавление элемента диагонали: нажмите + Action / + Asset или перетащите его из палитры в любое место.
  • Добавление записи в ячейку: перетащите Input/Output / Conduit из палитры на ячейку вне диагонали. Или перетащите блок с диагонали в ячейку его строки или столбца: там сразу создаётся Новый Input/Output / Новый Conduit. Имена по умолчанию — <row> To <column>, To <column> или From <row>.
  • Перемещение записи: перетащите её имя в другую ячейку. Связи перезаписываются.
  • Открытие: дважды щёлкните блок на диагонали или запись, чтобы открыть её вид элемента.
  • Уборка: выберите её и нажмите Delete или Backspace либо нажмите Убрать. Она сразу уходит из матрицы (связь удаляется; сущность остаётся). ⇧Delete / Shift+Delete удаляет сущность после подтверждения.
  • Ячейка перечисляет до девяти имён в столбце, затем в два столбца, затем +N ещё.
  • Экспортировать CSV записывает N2 - <root>.csv или I2 - <root>.csv с полной сеткой.
  • Упорядочить ▾: Обновить.
  • Ошибки: Бросьте на ячейку, Бросьте на ячейку вне диагонали.

Элементы и I/O

Интерфейсы → Элементы и входы/выходы открывает базу данных с запросом class:"Input/Output". Используйте её, чтобы массово редактировать Data Rate, Size, Protocol/Format и Message/Data Definition и находить элементы, которые не переносит ни один канал.

Сочетания клавиш

КлавишаГдеДействие
Enter / SpaceСтрока реестра интерфейсовПоказать интерфейс в инспекторе
↑ / ↓Реестр интерфейсовПереход между строками
EscРеестр интерфейсов, N²/I²Снять выделение
Delete / BackspaceICD, N²/I², физические входы/выходыУбрать или удалить выбранное

Сообщения

СообщениеЗначение и исправление
В этом проекте нет интерфейсов. Добавьте Conduit на диаграмме IBD, физических входов/выходов или ICD, чтобы они перечислялись здесь.Conduit пока нет. Нарисуйте соединитель или добавьте Conduit.
Ни один интерфейс не соответствует этому фильтру. Очистите фильтр, чтобы показать все интерфейсы.Текстовый фильтр или фильтр по статусу скрывает все строки.
Capacity не задана; нагрузка не проверяется.Задайте Capacity и Units у Conduit.
Нет передаваемых элементов.Канал ничего не передаёт. Добавьте элементы.
Превышение пропускной способности: X из Y <unit> (N%).Повысьте Capacity, снизьте скорости элементов или разделите нагрузку.
Не учтено элементов: N; единицы “…” (<item>) не преобразуются в “<unit>”.Исправьте единицы элемента или канала.
Экспорт документов недоступен в этой сборке.Модуль экспорта Word не загрузился. Перезагрузите страницу.

Ограничения

  • Проверка пропускной способности сравнивает только суммы Data Rate (или Size). Она не моделирует накладные расходы протокола и коэффициент заполнения, поэтому вводите эффективные скорости.
  • Conduit — соединение точка-точка. Проверка модели Conduit.5 отмечает более двух конечных точек.
  • Data Rate элемента учитывается один раз для каждого канала, который его передаёт, в том числе через жгут.