Інтерфейси
Інтерфейси
Визначайте інтерфейси як Conduit, записуйте, що через них передається, перевіряйте пропускну здатність, відстежуйте зрілість інтерфейсів у Реєстрі інтерфейсів і створюйте ICD, матриці N² та I².
На цій сторінці
- Огляд
- Поняття
- Як користуватися
- Коли й навіщо
- Визначити інтерфейс на Діаграмі внутрішніх блоків
- Переглянути всі інтерфейси в реєстрі
- Створити документ контролю інтерфейсів
- Перевірити інтерфейси з функціонального боку
- Розібраний приклад: інтерфейс корисного навантаження CubeSat EO-1
- Поради та добрі практики
- Типові помилки
- Як це пов’язано з іншими функціями
- Реєстр інтерфейсів
- Панель інтерфейсу в інспекторі
- Діаграма керування інтерфейсами
- Діалог «Реєстр інтерфейсів»
- Діаграма Physical I/O
- Діаграми N² та I²
- Елементи й I/O
- Комбінації клавіш
- Повідомлення
- Обмеження
- Пов’язане
Огляд
Використовуйте сторінки «Інтерфейси», щоб визначити, що перетинає кожну межу у вашій системі, перевірити, що кожен шлях може це перенести, і передати результат іншим командам як ICD.
У Holarch інтерфейс — це Conduit. Conduit — це сутність моделі, яка:
- connects to два активи (або порти)
- transfers елементи Input/Output, що через неї проходять
Кожен Conduit у проєкті є інтерфейсом, хоч би де ви його намалювали: на Діаграмі внутрішніх блоків, Діаграмі фізичних I/O, Діаграмі керування інтерфейсами, Діаграмі 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 (to be determined, підлягає визначенню) або TBR (to be reviewed, підлягає перегляду). |
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 traced from вимоги). Вимоги, які Conduit satisfies, також перелічуються. Вимога, створена із засобу вибору вимог інтерфейсу, отримує мітку Interface Requirement.
Порти й інтерфейсні блоки
На блокових діаграмах кінцевою точкою може бути Порт блока замість самого блока. Порт можна типізувати через Input/Output або Interface Block. Interface Block — це Asset з міткою Interface Block; він описує елементи й потоки, які підтримує точка взаємодії.
Спряжений порт використовує свій тип з оберненим напрямком кожного потоку. Він показується як ~Type.
Перевірка пропускної здатності
Перевірка пропускної здатності показує, чи може Conduit перенести свої елементи. Для кожного Conduit Holarch:
- Бере навантаження кожного переданого елемента: його Data Rate або його Size, якщо швидкість не задано.
- Перетворює кожне навантаження в Units каналу Conduit і підсумовує їх.
- Порівнює суму з Capacity.
Елементи дочірніх каналів пучка враховуються в пучку. Результат — одне з:
| Результат | Текст у реєстрі | Значення |
|---|---|---|
| Within capacity | OK | Загальне навантаження вміщується. |
| Over capacity | Over capacity | Загальне навантаження перевищує Capacity. |
| Unit mismatch | Unit mismatch | Одиниці щонайменше одного елемента не перетворюються в одиниці Conduit; цей елемент не враховується в сумі. |
| No capacity | No capacity | Conduit має елементи, але не має Capacity, тому навантаження не перевіряється. |
| Empty | — | Conduit не передає жодних елементів. |
Одиниці перетворюються тією самою системою одиниць, що й у бюджетах (див. Одиниці та величини), тож kbps, Mbps, Gbps, B/s, kW і W вільно поєднуються в межах одного виду.
Напрямок потоку елементів
На з’єднувачі IBD кожен елемент показує стрілку. Holarch бере напрямок із першого джерела, яке його визначає:
- Action, що виконуються з кожного боку. Бік, Action якого генерує елемент, надсилає його.
- Атрибути порту Напрямок (In, Out, In and Out).
- Власне налаштування з’єднувача Потік елементів.
Як користуватися
Коли й навіщо
Визначайте інтерфейси після декомпозиції архітектури, паралельно з функціональним розподілом. Щойно функції розподілено на підсистеми, кожен обмін, що перетинає межу підсистеми, потребує фізичного шляху.
Керування інтерфейсами відповідає на чотири питання:
- Що перетинає кожну межу? Передані елементи з їхніми швидкостями, форматами й визначеннями даних.
- Чи може шлях це перенести? Перевірка пропускної здатності.
- Хто ним володіє і чи його узгоджено? Owner, Interface Status і TBD/TBR.
- Які вимоги ним керують і що ми передаємо іншій команді? Вимоги до інтерфейсу та документ ICD.
Типовий ритм:
- Чернетки інтерфейсів — на рецензуванні системних вимог.
- Погодження між командами-власниками — до попереднього рецензування проєкту.
- Базова лінія — до критичного рецензування проєкту.
Визначити інтерфейс на Діаграмі внутрішніх блоків
Намалюйте з’єднувач, укажіть, що він переносить, потім запишіть його статус, вимоги й пропускну здатність.
- Відкрийте Архітектура → Блок-діаграми.
- Відкрийте Діаграма внутрішніх блоків системи. Щоб створити її, натисніть + Нова діаграма, виберіть Діаграма внутрішніх блоків і виберіть блок у Діаграма для.
- Перетягніть крайовий маркер однієї частини на іншу частину чи порт.
- Відпустіть на цілі. З’єднувач створюється одразу. Коли ви перетягуєте від порту на блок, виберіть З’єднати з блоком або Додати спряжений порт у засобі вибору з’єднання.
З’являється з’єднувач. З’єднувач — це Conduit.
- Виберіть з’єднувач.
- В інспекторі в розділі Передані елементи (потоки елементів) додайте елемент:
- Щоб передавати елемент, яким уже обмінюються Action обох кінців, натисніть кнопку його пропозиції під Обмінюються кінці:, наприклад + Image Strip.
- Інакше натисніть + Додати елемент ▾ і виберіть Наявний Input/Output… або Новий Input/Output….
Назва елемента з’являється зеленим на з’єднувачі зі стрілкою напрямку.
- На тій самій панелі задайте Статус інтерфейсу, Власник і TBD/TBR.
- У розділі Вимоги до інтерфейсів натисніть + Зв’язати вимогу… і виберіть або створіть вимогу.
- В атрибутах сутності задайте Capacity і Units каналу Conduit.
- Для кожного елемента задайте Data Rate і Data Rate Units або Size і Units.
Поле Перевірка пропускної здатності одразу оновлюється. Підпис з’єднувача показує статус у квадратних дужках, наприклад Payload Interface [Agreed]. Підпис стає:
- червоним з ⚠ over capacity, коли навантаження завелике
- помаранчевим з ⚠ unit mismatch, коли одиниці не перетворюються
Переглянути всі інтерфейси в реєстрі
- Відкрийте Інтерфейси → Реєстр інтерфейсів.
Ви бачите картки статусів (Draft, Proposed, Agreed, Baselined, Не задано) і таблицю всіх Conduit.
- Необов’язково: клацніть картку, щоб показати лише ці інтерфейси. Клацніть її знову або клацніть мітку Статус: … ×, щоб показати всі.
- Необов’язково: введіть текст у Фільтр за назвою або кінцевою точкою, щоб звузити список.
- Перегляньте стовпець Capacity на наявність Over capacity і Unit mismatch, обидва показано червоним.
- Клацніть рядок, щоб відкрити Conduit в інспекторі, і редагуйте його атрибути там.
- Щоб поділитися реєстром, натисніть Експортувати CSV. Щоб отримати документ Word для одного інтерфейсу, натисніть ICD у його рядку.
Створити документ контролю інтерфейсів
Діаграма керування інтерфейсами описує весь інтерфейс між двома батьківськими активами. Її корінь — Conduit цього інтерфейсу.
- Відкрийте Інтерфейси → ICD.
- Натисніть + Нова діаграма або відкрийте наявну Діаграму керування інтерфейсами.
- Натисніть Ліворуч немає Asset. Виберіть Asset… і виберіть перший батьківський актив.
- Натисніть Праворуч немає Asset. Виберіть Asset… і виберіть другий.
Тепер кожна смуга перелічує дочірні активи цього активу.
- Для кожного фізичного зв’язку перетягніть Conduit з палітри на центральний блок.
Дочірній канал з’являється як смуга в центральному блоці.
- Для кожного елемента, який переносить дочірній канал, перетягніть Input/Output на цей канал.
- Необов’язково: щоб додати дочірній актив, перетягніть Asset у батьківську смугу.
- Перетягніть від дочірнього каналу до дочірнього активу (або навпаки). Зв’язок connects to створюється одразу. Повторіть для іншого кінця.
- Виберіть дочірній канал і заповніть його панель інтерфейсу в інспекторі, як на IBD.
- Натисніть Експортувати документ ICD, щоб отримати ICD у Word, або Експортувати ICD (CSV), щоб отримати CSV.
Перевірити інтерфейси з функціонального боку
Почніть із функцій, щоб знайти обміни, яким досі бракує фізичного шляху.
- Відкрийте Інтерфейси → Діаграми N² і відкрийте Діаграма N² батьківського Action.
Дочірні Action розташовані на діагоналі. Клітинка в рядку A, стовпці B перелічує елементи, які A генерує, а B отримує.
- Щоб додати обмін, перетягніть Input/Output з палітри на клітинку поза діагоналлю. Можна також перетягнути блок діагоналі в клітинку його рядка чи стовпця: там одразу створюється Новий Input/Output.
Новий елемент отримує назву за своєю клітинкою: <row action> To <column action>.
- Відкрийте Діаграма фізичних входів/виходів батьківського Asset.
- Натисніть значок перевірок діаграми (⚠ і кількість зауважень).
Інспектор перелічує в розділі Інтерфейси кожен елемент, що тече між двома активами, але не має Conduit, який би його переносив.
- Виправте кожне зауваження. Натисніть Показати, щоб вибрати його лінію, потім задайте відсутню частину в інспекторі лінії (Додати поруч із Жоден Conduit не переносить цей Input/Output.) або додайте елемент до Conduit на IBD чи ICD.
Розібраний приклад: інтерфейс корисного навантаження CubeSat EO-1
Створіть демонстраційний проєкт через Керувати проєктами → Файли проєкту ▾ → Новий демонстраційний проєкт, потім:
- Відкрийте Інтерфейси → Реєстр інтерфейсів.
Картки показують 2 Draft, 2 Proposed, 16 Agreed, 6 Baselined і 0 Не задано.
- Знайдіть IF-05 Payload Interface (C&DH ↔ Payload Camera).
Його стовпець Capacity показує Over capacity.
- Наведіть вказівник на Over capacity.
Ви бачите Over capacity: 480.02 of 400 Mbps (120%).
- Клацніть рядок.
Інспектор показує Conduit:
- Capacity
400Mbps - 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.
- Знайдіть IF-12 S-band Downlink і наведіть вказівник на його стовпець Capacity.
Ви бачите Within capacity: 9.6 of 10 Mbps (96%). Перевірку пройдено, але запас невеликий, тож це кандидат на TPM. Демонстраційний проєкт відстежує його як TPM-3 Payload Downlink Rate (див. Бюджети й TPM).
- Відкрийте Інтерфейси → ICD → IF-10 Space-to-Ground Link.
Лівий і правий батьківські елементи — космічний апарат і наземний сегмент. Дочірні канали — IF-11 UHF Command Uplink (9.6 kbps, Baselined) і IF-12 S-band Downlink (10 Mbps, Baselined).
- Натисніть Експортувати документ ICD.
Файл Word містить:
- реєстр інтерфейсів для трьох каналів
- зведення статусів
- по розділу на кожен канал з його кінцевими точками, атрибутами, переданими елементами (з напрямком), пов’язаними вимогами (5.1, 5.2 і 5.3) і перевіркою пропускної здатності
- Відкрийте Діаграма внутрішніх блоків 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. Реєстр показує Unit mismatch, і елемент не враховується. Виправте одиниці з того боку, де помилка. - Канал лише з однією кінцевою точкою. Endpoints показує Не з’єднано або лише одну назву. З’єднайте другий актив через connects to.
Як це пов’язано з іншими функціями
- Живиться від:
- архітектури: Asset, блоків та їхньої декомпозиції
- функціонального аналізу: Action, що генерують і отримують Input/Output
- вимог: вимог до інтерфейсу
- Передає дані в:
- RVTM: вимоги до інтерфейсу верифікуються, як і будь-які інші (див. Верифікація)
- Перевірок моделі: Conduit.1–9 та IO.1–10
- бюджетів і TPM: запасів швидкості
- пакетів рецензування й базових ліній
- Пропозиції: IBD пропонує елементи для передавання з Action, які виконує кожен кінець, тож функціональний розподіл і фізичні інтерфейси залишаються узгодженими.
Реєстр інтерфейсів
Сторінка перелічує кожен Conduit у проєкті. Вона оновлюється наживо, коли змінюється модель. У проєкті SysML v2 вона перелічує використання з’єднань та інтерфейсів моделі; виведення вимог не включено. Малюються лише рядки поблизу позиції прокручування, тож сторінка відкривається одразу навіть у великих проєктах; експорт усе одно містить кожен інтерфейс.
Заголовок сторінки
| Елемент керування | Дія |
|---|---|
| Експортувати CSV | Завантажує Interface Register - <project>.csv: Number, Interface, Endpoints, Status, Owner, TBD/TBR, Items, Requirements, Capacity Check (повний текст перевірки), потім зведення Status/Count. |
| ICD | Відкриває список Діаграм керування інтерфейсами. |
| + Новий інтерфейс | Відкриває Новий інтерфейс: Name (необов’язково; порожнє дає <first> to <second>) і два Asset, які він з’єднує (Вибрати… для кожного). Створити додає Conduit з його двома зв’язками connected by і вибирає його рядок; одне натискання “Відмінити” повертає все назад. У проєкті SysML v2 кнопка називається + Нове з’єднання: вона додає використання з’єднання між двома складниками. |
Картки статусів
По картці на кожен статус (Draft, Proposed, Agreed, Baselined) плюс Не задано, кожна з кількістю. Картки Agreed і Baselined зелені; «Не задано» — бурштинова.
Клацніть картку, щоб відфільтрувати. Мітка Статус: <status> × очищує фільтр. Адреса interfaces?status=<status> відкриває сторінку з фільтром. Поруч із Фільтр за назвою або кінцевою точкою лічильник показує, наприклад, 26 interfaces або 3 of 26 interfaces, поки діє фільтр.
Таблиця
| Стовпець | Вміст |
|---|---|
| Інтерфейс | Номер і назва; посилання відкриває Подання елемента. |
| Кінцеві точки | Дві з’єднані сутності, A ↔ B, або Не з’єднано. |
| Статус | Interface Status або Не задано. |
| Власник | Атрибут Owner. |
| TBD/TBR | TBD або TBR; порожньо для None. |
| Елементи | Кількість переданих елементів, включно з елементами дочірніх каналів. |
| Вимоги | Кількість пов’язаних вимог до інтерфейсу. |
| Пропускна здатність | OK, Over capacity, Unit mismatch, No capacity або —. Наведіть вказівник, щоб побачити повний текст. |
| (кнопка) | ICD експортує документ ICD цього інтерфейсу (Word). |
Клацніть рядок або наведіть на нього фокус і натисніть Enter чи Space, щоб показати Conduit в інспекторі. ↑ і ↓ переходять між рядками. Esc знімає вибір.
Панель інтерфейсу в інспекторі
Панель інтерфейсу — місце, де ви редагуєте один інтерфейс. Вона з’являється в інспекторі над атрибутами сутності, коли ви вибираєте:
- з’єднувач на Діаграмі внутрішніх блоків
- дочірній канал або центральний блок на Діаграмі керування інтерфейсами
Панель містить:
- Потік елементів (лише IBD): Undirected, Directed, Reverse або Bidirectional. Задає стрілки елементів, коли ні Action, ні напрямки портів цього не визначають.
- Передані елементи (потоки елементів): кожен елемент із його напрямком (
EPS → Payload Cameraабо both ways). Елементи з дочірніх каналів позначено (дочірній канал). × припиняє передавання елемента; сам елемент залишається. Без елементів: No items. Add the Input/Outputs this connector carries. - Обмінюються кінці: одна кнопка + <item> на кожен запропонований елемент. Елемент пропонується, коли Action на одному кінці його генерує, Action на іншому кінці його отримує, а канал його ще не передає.
- + Додати елемент ▾: Наявний Input/Output… (виберіть один) або Новий Input/Output… (назвіть його; типово Новий елемент).
- Статус інтерфейсу, Власник (заповнювач Особа або команда) і 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). Інакше: Drop it into a parent asset band. |
| Conduit | Центральний блок каналу | Дочірній канал кореня. Інакше: Перетягніть на блок каналу посередині. |
| Input/Output | Дочірній канал | Канал transfers елемент. Інакше: Drop onto a child conduit. |
Наявні Asset, Conduit та Input/Output можна так само перетягувати зі списку наявних сутностей палітри. Будь-що інше: Ця діаграма не може показати цю сутність.
Редагування на полотні
- Перетягніть від дочірнього каналу до дочірнього активу, щоб пов’язати їх (connects to, створюється одразу). Інші пари відхиляються з Дочірній канал з’єднується з дочірнім активом. Перетягніть до нього.
- Перетягніть дочірній актив в іншу смугу, щоб перемістити його до того батьківського. Перетягніть елемент на інший дочірній канал, щоб перемістити його туди.
- Delete одразу вилучає вибране з діаграми (розриває зв’язок; сутність залишається). ⇧Delete / Shift+Delete видаляє сутність після підтвердження. Вилучення батьківської смуги розриває зв’язок із цим батьківським активом.
Вигляд ▾
| Параметр | Приховує |
|---|---|
| Попередження щодо одиниць | Контур попередження на елементі, одиниці якого відрізняються від одиниць його каналу, і відповідне зауваження в перевірках діаграми (<item> is in <unit>; <conduit> carries <unit>. Change one unit.). |
| I/O | Мітки елементів. |
| Затримка й пропускна здатність | Підписи затримки й пропускної здатності на центральному блоці та дочірніх каналах. |
| Дочірні активи | Дочірні активи в смугах і їхні лінії з’єднання. |
Підпис кожного дочірнього каналу показує його статус у квадратних дужках і 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)
- Заголовок Документ контролю інтерфейсів: <root>, рядок із назвами двох батьківських активів і датою створення та опис кореня.
- Реєстр інтерфейсів: Interface, Endpoints, Status, Owner, TBD/TBR, Items, Capacity для кореня й кожного дочірнього каналу.
- Зведення статусів: кількість за кожним статусом.
- По розділу на кожен канал, з:
- таблицею Endpoints, Status, Owner, TBD/TBR, Connector/Pins, Medium, Latency, Capacity і будь-яких власних атрибутів
- Передані елементи: Item, Direction, Size, Data Rate, Protocol/Format, Message/Data Definition, плюс власні атрибути I/O
- Вимоги: Number, Requirement, Statement
- Перевірка пропускної здатності
Кнопка ICD у рядку Реєстру інтерфейсів створює той самий документ для одного цього каналу та його дочірніх.
Діалог «Реєстр інтерфейсів»
Кнопка Реєстр інтерфейсів на панелях інструментів ICD та IBD відкриває Interface Register: <name>. Він перелічує канали цієї діаграми:
- мітки статусів
- таблицю Interface, Endpoints, Status, Owner, TBD/TBR, Items, Requirements і Capacity
- параметр Усі Conduit у проєкті
- кнопки Експортувати CSV, Експортувати документ ICD (лише ICD) і Закрити
Коли каналів немає: No Conduits. Add Conduits to the diagram to list them here.
Діаграма Physical I/O
Використовуйте Діаграму фізичних I/O, щоб побачити, які елементи течуть між частинами Asset і чи переносить кожен із них Conduit. Вона показує дочірні активи Asset і малює по лінії на кожен Input/Output, що тече між ними.
Лінії виводяться з моделі:
- Action, які виконує кожен актив (generates → receives)
- Conduit, що з’єднують активи
Пунктирна лінія без елемента — це Conduit, що нічого не переносить.
- Згортання: Action, які виконують, і Conduit, з’єднані з будь-яким нащадком показаного активу, вважаються власними для цього активу. Нащадки охоплюють дочірні елементи, онуків і порти.
- Зовнішні: активи поза батьківським, що обмінюються з ним елементами, малюються в окремому рядку з позначкою external.
- Панель інструментів: Вважати внутрішнім і Вважати зовнішнім. Перевірки інтерфейсів — у значку перевірок діаграми. Дві останні потребують вибраного активу (Спочатку виберіть актив.). Вигляд ▾ перемикає Зовнішні елементи Asset і Попередження.
Створити лінію
- Перетягніть від одного активу до іншого.
Лінія з’являється одразу, від першого активу до другого, і одне натискання “Відмінити” повертає все назад:
- новий Input/Output Новий Input/Output;
- її переносить Conduit, що вже з’єднує два активи, або новий Conduit A to B (з Origin на кінці першого активу);
- надсилає єдиний Action першого активу або новий Send New Input/Output, а отримує єдиний Action другого активу або новий Receive New Input/Output.
- Нова лінія вибрана. Її інспектор має по слоту на кожну частину: Input/Output, Conduit, Action-відправник і Action-отримувач. У кожному слоті:
- Змінити… вибирає наявну сутність цього класу;
- Новий створює сутність із типовою назвою (перейменуйте її в її власному інспекторі);
- Очистити (лише Input/Output) зберігає лінію Conduit без елемента.
- Необов’язково: позначте Двобічний, коли Conduit переносить елементи в обидва боки.
Кожна зміна переписує лінію, і одне натискання “Відмінити” повертає все назад. Відсутню частину позначено в слоті (наприклад, ⚠ Жоден Conduit не переносить цей Input/Output.) з Додати, щоб її створити.
Попередження ліній
| Рівень | Повідомлення |
|---|---|
| Попередження | <item> flows between A and B, but no Conduit links them to carry it. |
| Попередження | <item> flows between A and B, but none of the Conduits linking A and B carries it. |
| Попередження | <item> flows between A and B, but no Action produces or consumes it there. |
| Помилка | <item> flows between A and B in a direction the connecting Conduit does not allow. |
| Інформація | <conduit> links A and B but carries no Input/Outputs. |
Лінії з попередженням бурштинові, з помилкою — червоні. Значок перевірок діаграми перелічує їх у розділі Інтерфейси; Показати вибирає лінію. Інспектор вибраної лінії перелічує її власні.
Діаграми N² та I²
Обидві — квадратні матриці, побудовані з дочірніх елементів кореня.
| Діаграма N² | Діаграма I² | |
|---|---|---|
| Корінь | Action | Asset |
| Діагональ | Дочірні Action | Дочірні активи |
| Клітинки | Input/Output: рядок генерує, стовпець отримує | Conduit: рядок — кінець-джерело, стовпець — інший кінець |
| Верхній рядок | Зовнішні входи (отримані, але не згенеровані нічим у матриці) | До (канали з одним кінцем, що входять у стовпець) |
| Правий стовпець | Зовнішні виходи (згенеровані, але не отримані нічим у матриці) | Від (канали з одним кінцем, що виходять із рядка) |
| Панель інструментів | + 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 more.
- Експортувати 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 / Backspace | ICD, N²/I², фізичні I/O | Вилучити або видалити вибране |
Повідомлення
| Повідомлення | Значення та виправлення |
|---|---|
| У цьому проєкті немає інтерфейсів. Додайте Conduit на діаграмі IBD, Physical I/O або ICD, щоб вони з’явилися тут. | Ще немає Conduit. Намалюйте з’єднувач або додайте Conduit. |
| Жоден інтерфейс не відповідає цьому фільтру. Очистьте фільтр, щоб показати всі інтерфейси. | Текстовий фільтр або фільтр статусу приховує всі рядки. |
| No Capacity set; the load is not checked. | Задайте Capacity і Units для Conduit. |
| Немає переданих елементів. | Канал нічого не передає. Додайте елементи. |
| Over capacity: X of Y <unit> (N%). | Збільште Capacity, зменште швидкості елементів або розділіть навантаження. |
| N items not counted: units “…” (<item>) do not convert to “<unit>”. | Виправте одиниці елемента або каналу. |
| Експорт документів недоступний у цій збірці. | Засіб експорту Word не завантажився. Перезавантажте сторінку. |
Обмеження
- Перевірка пропускної здатності порівнює лише суми Data Rate (або Size). Вона не моделює накладні витрати протоколу чи робочий цикл, тому вводьте ефективні швидкості.
- Conduit з’єднує дві точки. Перевірка моделі Conduit.5 позначає більше двох кінцевих точок.
- Data Rate елемента враховується один раз для кожного каналу, що його передає, зокрема через пучок.
Пов’язане
- Посібник: Документ контролю інтерфейсів (ICD): що він містить і як підтримувати його актуальним.
- Верифікація — верифікуйте вимоги до інтерфейсів і відстежуйте покриття.
- Бюджети й TPM — одиниці, величини й запаси.
- Діаграми SysML — Діаграми внутрішніх блоків, порти й з’єднувачі.
- Функціональний аналіз — Action та Input/Output, які переносять інтерфейси.
- Довідка: Реєстр інтерфейсів, Інтерфейси, Conduit і ICD, Побудова архітектури й підготовка ICD, Діаграма внутрішніх блоків, Діаграма керування інтерфейсами, Діаграма N², Діаграма I², Діаграма Physical I/O, Перевірки моделі.