Interfejsy
Interfejsy
Definiuj interfejsy jako Conduit, zapisuj, co przez nie przepływa, sprawdzaj przepustowość, śledź dojrzałość interfejsów w Rejestrze interfejsów i twórz ICD oraz macierze N² i I².
Na tej stronie
- Przegląd
- Pojęcia
- Jak z niego korzystać
- Kiedy i dlaczego
- Definiowanie interfejsu na Diagramie bloków wewnętrznych
- Przegląd wszystkich interfejsów w rejestrze
- Tworzenie dokumentu kontroli interfejsów (ICD)
- Sprawdzanie interfejsów od strony funkcjonalnej
- Przykład: interfejs ładunku CubeSat EO-1
- Wskazówki i dobre praktyki
- Typowe błędy
- Powiązania z innymi funkcjami
- Rejestr interfejsów
- Panel interfejsu w inspektorze
- Diagram kontroli interfejsów
- Okno Rejestr interfejsów
- Fizyczny diagram we/wy
- Diagramy N² i I²
- Elementy i I/O
- Skróty
- Komunikaty
- Limity
- Powiązane
Przegląd
Strony Interfejsy służą do definiowania tego, co przechodzi przez każdą granicę systemu, sprawdzania, czy każda ścieżka może to przenieść, i przekazywania wyniku innym zespołom jako ICD.
W Holarch interfejs to Conduit. Conduit to encja modelu, która:
- connects to dwa elementy Asset (lub porty)
- transfers elementy Input/Output, które przez nią przechodzą
Każdy Conduit w projekcie jest interfejsem, niezależnie od tego, gdzie go narysowano: na Diagramie bloków wewnętrznych, Fizycznym diagramie we/wy, Diagramie kontroli interfejsów, Diagramie I² czy w Bazie danych.
Grupa Interfejsy na pasku nawigacji zawiera cztery strony:
| Strona | Co pokazuje |
|---|---|
| Rejestr interfejsów | Każdy Conduit z punktami końcowymi, statusem, właścicielem, TBD/TBR, liczbą elementów, liczbą wymagań i sprawdzeniem przepustowości. |
| ICD | Diagramy kontroli interfejsów w projekcie (lista Diagramy przefiltrowana do tego typu). |
| Diagramy N² | Diagramy N² w projekcie: funkcje na przekątnej, wymieniane przez nie elementy Input/Output w komórkach. |
| Elementy i I/O | Baza danych przefiltrowana do klasy Input/Output. |
Pojęcia
Conduit
Conduit to fizyczna lub logiczna ścieżka między dwoma elementami Asset: kabel, magistrala, łącze radiowe, rura, połączenie sieciowe. Łączy się ze swoimi punktami końcowymi relacją connects to (od strony elementu Asset: connected by).
Conduit można zdekomponować na podrzędne elementy Conduit. Rodzic działa wtedy jako wiązka: przenosi wszystko, co przenoszą jego elementy podrzędne.
Holarch dodaje do każdego elementu Conduit następujące atrybuty interfejsu:
| Atrybut | Znaczenie |
|---|---|
| Capacity i Units | Maksimum, jakie kanał może przenieść, np. 400 Mbps lub 15 W. Używane przez sprawdzenie przepustowości. |
| Latency | Opóźnienie w kanale (czas trwania). |
| Connector/Pins | Typ złącza i przypisanie styków na każdym końcu. |
| Medium | Medium fizyczne, np. miedź, światłowód, łącze radiowe, rura. |
| Właściciel | Osoba lub zespół odpowiedzialny za definicję interfejsu. |
| Status interfejsu | Dojrzałość definicji: Draft, Proposed, Agreed lub Baselined. |
| TBD/TBR | Otwarte kwestie: None, TBD (do ustalenia) lub TBR (do przeglądu). |
Input/Output (element)
Input/Output (element) to to, co przechodzi przez interfejs: dane, moc, płyn, siła, sygnał. Ma trzy rodzaje powiązań:
- generated by akcję, która go wytwarza
- received by akcję, która go zużywa
- transferred by elementy Conduit, które go przenoszą
Holarch dodaje następujące atrybuty:
| Atrybut | Znaczenie |
|---|---|
| Size i Units | Ilość na element, np. 2.5 GB. Uwzględniana przez sprawdzenie przepustowości, gdy nie ustawiono Data Rate. |
| Data Rate i Data Rate Units | Szybkość przenoszenia elementu, np. 480 Mbps lub 6 W. Sprawdzenie przepustowości ją sumuje. |
| Protocol/Format | Protokół, kodowanie lub format fizyczny. |
| Message/Data Definition | Pola, zakresy i znaczenie danych przenoszonych przez element. |
Wymagania interfejsu
Wymaganie dotyczące interfejsu jest powiązane z elementem Conduit relacją traced from (Conduit jest śledzony od wymagania). Wymienione są też wymagania, które Conduit satisfies. Wymaganie utworzone w selektorze wymagań interfejsu otrzymuje etykietę Wymaganie interfejsowe.
Porty i bloki interfejsu
Na diagramach bloków punktem końcowym może być Port bloku zamiast samego bloku. Port może być typowany przez Input/Output lub przez Interface Block. Interface Block to Asset z etykietą Interface Block; opisuje elementy i przepływy obsługiwane przez punkt interakcji.
Port Conjugated używa swojego typu z odwróconym kierunkiem każdego przepływu. Jest wyświetlany jako ~Type.
Sprawdzenie przepustowości
Sprawdzenie przepustowości informuje, czy Conduit może przenieść swoje elementy. Dla każdego elementu Conduit Holarch:
- Pobiera obciążenie każdego przenoszonego elementu: jego Data Rate lub jego Size, gdy szybkość nie jest ustawiona.
- Przelicza każde obciążenie na Units elementu Conduit i je sumuje.
- Porównuje sumę z Capacity.
Elementy kanałów podrzędnych wiązki liczą się do wiązki. Wynik jest jednym z następujących:
| Wynik | Tekst w rejestrze | Znaczenie |
|---|---|---|
| W granicach przepustowości | OK | Całkowite obciążenie się mieści. |
| Przekroczona przepustowość | Przekroczona przepustowość | Całkowite obciążenie przekracza Capacity. |
| Niezgodność jednostek | Niezgodność jednostek | Jednostek co najmniej jednego elementu nie da się przeliczyć na jednostki elementu Conduit; ten element jest pomijany w sumie. |
| Brak przepustowości | Brak przepustowości | Conduit ma elementy, ale nie ma Capacity, więc obciążenie nie jest sprawdzane. |
| Pusty | — | Conduit nie przenosi żadnych elementów. |
Jednostki są przeliczane w tym samym systemie jednostek co budżety (zobacz Jednostki i wielkości), więc kbps, Mbps, Gbps, B/s, kW i W można dowolnie łączyć w obrębie jednego rodzaju.
Kierunek przepływu elementu
Na łączniku IBD każdy element pokazuje strzałkę. Holarch ustala kierunek na podstawie pierwszego rozstrzygającego źródła spośród:
- Akcji wykonywanych po każdej stronie. Strona, której akcja generuje element, go wysyła.
- Atrybutów Direction portów (In, Out, In and Out).
- Własnego ustawienia Przepływ elementu łącznika.
Jak z niego korzystać
Kiedy i dlaczego
Definiuj interfejsy po dekompozycji architektury, równolegle z alokacją funkcjonalną. Gdy funkcje są już przydzielone do podsystemów, każda wymiana przekraczająca granicę podsystemu potrzebuje ścieżki fizycznej.
Zarządzanie interfejsami odpowiada na cztery pytania:
- Co przechodzi przez każdą granicę? Przenoszone elementy wraz z szybkościami, formatami i definicjami danych.
- Czy ścieżka może to przenieść? Sprawdzenie przepustowości.
- Kto jest właścicielem i czy sprawa jest ustalona? Owner, Interface Status i TBD/TBR.
- Które wymagania go regulują i co przekazujemy drugiemu zespołowi? Wymagania interfejsowe i dokument ICD.
Typowy rytm:
- Projekty interfejsów na przeglądzie wymagań systemowych.
- Uzgodnienie ich między zespołami-właścicielami przed wstępnym przeglądem projektu.
- Ustanowienie ich linii bazowej przed krytycznym przeglądem projektu.
Definiowanie interfejsu na Diagramie bloków wewnętrznych
Narysuj łącznik, określ, co przenosi, a następnie zapisz jego status, wymagania i przepustowość.
- Otwórz Architektura → Diagramy bloków.
- Otwórz Diagram bloków wewnętrznych systemu. Aby go utworzyć, kliknij + Nowy diagram, wybierz Diagram bloków wewnętrznych i wybierz blok w polu Diagram dla.
- Przeciągnij uchwyt krawędzi jednej części na inną część lub port.
- Puść na celu. Łącznik powstaje od razu. Gdy przeciągasz od portu na blok, wybierz Połącz z blokiem lub Dodaj port sprzężony w selektorze połączenia.
Pojawia się łącznik. Łącznik to Conduit.
- Zaznacz łącznik.
- W inspektorze, w sekcji Przenoszone elementy (przepływy elementów), dodaj element:
- Aby przenosić element, który akcje obu końców już wymieniają, kliknij jego przycisk sugestii w obszarze Wymieniane przez końce:, np. + Image Strip.
- W przeciwnym razie kliknij + Dodaj element ▾ i wybierz Istniejący Input/Output… lub Nowy Input/Output….
Nazwa elementu pojawia się na zielono na łączniku, ze strzałką kierunku.
- W tym samym panelu ustaw Status interfejsu, Właściciel i TBD/TBR.
- W sekcji Wymagania interfejsowe kliknij + Powiąż wymaganie… i wybierz lub utwórz wymaganie.
- W atrybutach encji ustaw Capacity i Units elementu Conduit.
- W każdym elemencie ustaw Data Rate i Data Rate Units albo Size i Units.
Pole Sprawdzenie przepustowości aktualizuje się od razu. Etykieta łącznika pokazuje status w nawiasach, np. Payload Interface [Agreed]. Etykieta zmienia kolor na:
- czerwony z oznaczeniem ⚠ przekroczona przepustowość, gdy obciążenie jest zbyt duże
- pomarańczowy z oznaczeniem ⚠ niezgodność jednostek, gdy jednostek nie da się przeliczyć
Przegląd wszystkich interfejsów w rejestrze
- Otwórz Interfejsy → Rejestr interfejsów.
Widać karty statusów (Draft, Proposed, Agreed, Baselined, Nie ustawiono) i tabelę wszystkich elementów Conduit.
- Opcjonalnie: kliknij kartę, aby pokazać tylko te interfejsy. Kliknij ją ponownie lub kliknij etykietę Status: … ×, aby pokazać wszystkie.
- Opcjonalnie: wpisz tekst w polu Filtruj według nazwy lub końca, aby zawęzić listę.
- Przejrzyj kolumnę Przepustowość pod kątem wartości Przekroczona przepustowość i Niezgodność jednostek, obie pokazywane na czerwono.
- Kliknij wiersz, aby otworzyć Conduit w inspektorze, i tam edytuj jego atrybuty.
- Aby udostępnić rejestr, kliknij Eksportuj CSV. Aby uzyskać dokument Word jednego interfejsu, kliknij ICD w jego wierszu.
Tworzenie dokumentu kontroli interfejsów (ICD)
Diagram kontroli interfejsów opisuje cały interfejs między dwoma nadrzędnymi elementami Asset. Jego elementem głównym jest Conduit tego interfejsu.
- Otwórz Interfejsy → ICD.
- Kliknij + Nowy diagram lub otwórz istniejący Diagram kontroli interfejsów.
- Kliknij Brak elementu Asset po lewej. Wybierz Asset… i wybierz pierwszy nadrzędny Asset.
- Kliknij Brak elementu Asset po prawej. Wybierz Asset… i wybierz drugi.
Każdy pas wymienia teraz podrzędne elementy Asset danego elementu Asset.
- Dla każdego łącza fizycznego przeciągnij Conduit z palety na pole środkowe.
Kanał podrzędny pojawia się jako pasek w polu środkowym.
- Dla każdego elementu przenoszonego przez kanał podrzędny przeciągnij Input/Output na ten kanał.
- Opcjonalnie: aby dodać podrzędny Asset, przeciągnij Asset do pasa rodzica.
- Przeciągnij od kanału podrzędnego do podrzędnego elementu Asset (lub odwrotnie). Powiązanie connects to powstaje od razu. Powtórz dla drugiego końca.
- Zaznacz kanał podrzędny i uzupełnij jego panel interfejsu w inspektorze, tak jak na IBD.
- Kliknij Eksportuj dokument ICD, aby uzyskać ICD w formacie Word, lub Eksportuj ICD (CSV), aby uzyskać plik CSV.
Sprawdzanie interfejsów od strony funkcjonalnej
Zacznij od funkcji, aby znaleźć wymiany, którym wciąż brakuje ścieżki fizycznej.
- Otwórz Interfejsy → Diagramy N² i otwórz Diagram N² nadrzędnego elementu Action.
Podrzędne elementy Action znajdują się na przekątnej. Komórka w wierszu A i kolumnie B wymienia elementy, które A generuje, a B odbiera.
- Aby dodać wymianę, przeciągnij Input/Output z palety na komórkę poza przekątną. Możesz też przeciągnąć pole z przekątnej do komórki w jego wierszu lub kolumnie: od razu powstaje tam Nowy Input/Output.
Nowy element otrzymuje nazwę od swojej komórki: <row action> To <column action>.
- Otwórz Fizyczny diagram we/wy nadrzędnego elementu Asset.
- Kliknij plakietkę Kontrole diagramu (⚠ i liczba ustaleń).
Inspektor wymienia w sekcji Interfejsy każdy element, który przepływa między dwoma elementami Asset, ale nie ma elementu Conduit, który by go przenosił.
- Popraw każde ustalenie. Kliknij Pokaż, aby zaznaczyć jego linię, a następnie ustaw brakującą część w inspektorze linii (Dodaj obok Żaden Conduit nie przenosi tego Input/Output.) lub dodaj element do elementu Conduit na IBD albo ICD.
Przykład: interfejs ładunku CubeSat EO-1
Utwórz projekt demonstracyjny poleceniem Zarządzaj projektami → Pliki projektów ▾ → Nowy projekt demonstracyjny, a następnie:
- Otwórz Interfejsy → Rejestr interfejsów.
Karty pokazują 2 Draft, 2 Proposed, 16 Agreed, 6 Baselined i 0 Nie ustawiono.
- Znajdź IF-05 Payload Interface (C&DH ↔ Payload Camera).
Jego kolumna Przepustowość pokazuje Przekroczona przepustowość.
- Wskaż Przekroczona przepustowość.
Widać komunikat Przekroczona przepustowość: 480.02 z 400 Mbps (120%).
- Kliknij wiersz.
Inspektor pokazuje Conduit:
- Capacity
400Mbps - Owner Payload Lead
- Medium LVDS twisted pairs plus SPI
- Connector/Pins J5 (Micro-D 25)
- Przenoszone elementy: Command Schedule (0.02 Mbps) i Image Strip (480 Mbps)
Surowa szybkość pasków obrazu ładunku przekracza łącze LVDS. Popraw to na jeden z trzech sposobów:
- Zwiększ Capacity elementu Conduit do rzeczywistej wartości znamionowej łącza, np.
600. Rejestr pokazuje wtedy OK. - Dodaj kompresję na pokładzie, a następnie obniż Data Rate elementu Image Strip.
- Zapisz otwartą decyzję: ustaw TBD/TBR na TBR i powiąż nowe wymaganie za pomocą + Powiąż wymaganie… na IBD lub ICD.
- Znajdź IF-12 S-band Downlink i wskaż jego kolumnę Przepustowość.
Widać komunikat W granicach przepustowości: 9.6 z 10 Mbps (96%). Sprawdzenie przechodzi, ale margines jest mały, więc to kandydat na TPM. Projekt demonstracyjny śledzi go jako TPM-3 Payload Downlink Rate (zobacz Budżety i TPM).
- Otwórz Interfejsy → ICD → IF-10 Space-to-Ground Link.
Lewy i prawy rodzic to statek kosmiczny i segment naziemny. Kanały podrzędne to IF-11 UHF Command Uplink (9.6 kbps, Baselined) i IF-12 S-band Downlink (10 Mbps, Baselined).
- Kliknij Eksportuj dokument ICD.
Plik Word zawiera:
- rejestr interfejsów dla trzech kanałów
- podsumowanie statusów
- po jednej sekcji na kanał z punktami końcowymi, atrybutami, przenoszonymi elementami (z kierunkiem), powiązanymi wymaganiami (5.1, 5.2 i 5.3) i sprawdzeniem przepustowości
- Otwórz Diagram bloków wewnętrznych EPS.
Port 12 V Bus jest typowany przez blok interfejsu IFB-1 12 V Power Interface. Port 12 V In ładunku używa tego samego typu, sprzężonego, więc ma postać 12 V In : ~12 V Power Interface.
Wskazówki i dobre praktyki
- Nazywaj elementy Conduit rzeczownikami (Payload Interface, S-band Downlink) i nadawaj każdemu numer (
IF-05). Kontrole modelu oznaczają kanały bez nazwy, bez numeru i z nazwą niebędącą rzeczownikiem. - Podawaj szybkość w elemencie, a nie w kanale. Kanał przechowuje przepustowość, a elementy obciążenie. Wtedy jeden element przenoszony przez kilka kanałów jest sprawdzany w każdym z nich.
- Używaj kanału-wiązki dla wiązki przewodów lub grupy łączy, a kanałów podrzędnych dla każdej linii. Diagram ICD jest zbudowany wokół tej struktury.
- Ustawiaj Status interfejsu w każdym kanale. Karta Nie ustawiono powinna przed przeglądem projektu pokazywać zero.
- Odwołuj się do normy interfejsu: elementu Artifact z etykietą Standard, do którego kanał i oba elementy Asset mają relację reference. Kontrola modelu Conduit.7 jej szuka.
Typowe błędy
- Niezgodne jednostki. Element ma Data Rate w
Mbps, ale Units kanału toW. Rejestr pokazuje Niezgodność jednostek, a element nie jest uwzględniany. Popraw jednostki po tej stronie, która jest błędna. - Kanał z tylko jednym punktem końcowym. Punkty końcowe pokazuje Niepołączony lub tylko jedną nazwę. Połącz drugi Asset relacją connects to.
Powiązania z innymi funkcjami
- Zasilane przez:
- architekturę: elementy Asset, bloki i ich dekompozycję
- analizę funkcjonalną: elementy Action, które generują i odbierają elementy Input/Output
- wymagania: wymagania interfejsowe
- Zasila:
- RVTM: wymagania interfejsowe są weryfikowane jak wszystkie inne (zobacz Weryfikacja)
- Kontrole modelu: Conduit.1–9 i IO.1–10
- budżety i TPM: marginesy szybkości
- pakiety przeglądu i linie bazowe
- Sugestie: IBD podpowiada elementy do przenoszenia na podstawie akcji wykonywanych przez każdy koniec, dzięki czemu alokacja funkcjonalna i interfejsy fizyczne pozostają spójne.
Rejestr interfejsów
Strona wymienia każdy Conduit w projekcie. Aktualizuje się na bieżąco wraz ze zmianami modelu. W projekcie SysML v2 wymienia użycia połączeń i interfejsów modelu; wyprowadzenia wymagań są pomijane. Rysowane są tylko wiersze w pobliżu pozycji przewijania, więc strona otwiera się od razu w dużych projektach; eksport nadal zawiera każdy interfejs.
Nagłówek strony
| Element sterujący | Czynność |
|---|---|
| Eksportuj CSV | Pobiera Interface Register - <project>.csv: Number, Interface, Endpoints, Status, Owner, TBD/TBR, Items, Requirements, Capacity Check (pełny tekst sprawdzenia), a następnie podsumowanie Status/Count. |
| ICD | Otwiera listę Diagramów kontroli interfejsów. |
| + Nowy interfejs | Otwiera okno Nowy interfejs: pole Nazwa (opcjonalne; gdy puste, powstaje <first> to <second>) i dwa łączone elementy Asset (Wybierz… dla każdego). Utwórz dodaje Conduit z dwoma powiązaniami connected by i zaznacza jego wiersz; jedno polecenie Cofnij wycofuje całość. W projekcie SysML v2 przycisk to + Nowe połączenie: dodaje użycie połączenia między dwiema częściami. |
Karty statusów
Jedna karta na status (Draft, Proposed, Agreed, Baselined) oraz Nie ustawiono, każda z liczbą. Karty Agreed i Baselined są zielone; Nie ustawiono jest bursztynowa.
Kliknij kartę, aby filtrować. Etykieta Status: <status> × czyści filtr. Adres interfaces?status=<status> otwiera stronę z filtrem. Obok pola Filtruj według nazwy lub końca licznik pokazuje np. Interfejsy: 26 lub 3 z 26 interfejsów, gdy filtr jest włączony.
Tabela
| Kolumna | Zawartość |
|---|---|
| Interfejs | Numer i nazwa; łącze otwiera widok elementu. |
| Punkty końcowe | Dwie połączone encje, A ↔ B, lub Niepołączony. |
| Status | Interface Status lub Nie ustawiono. |
| Właściciel | Atrybut Owner. |
| TBD/TBR | TBD lub TBR; puste dla None. |
| Elementy | Liczba przenoszonych elementów, wraz z elementami kanałów podrzędnych. |
| Wymagania | Liczba powiązanych wymagań interfejsowych. |
| Przepustowość | OK, Przekroczona przepustowość, Niezgodność jednostek, Brak przepustowości lub —. Wskaż, aby zobaczyć pełny tekst. |
| (przycisk) | ICD eksportuje dokument ICD tego interfejsu (Word). |
Kliknij wiersz lub ustaw na nim fokus i naciśnij Enter albo Space, aby pokazać Conduit w inspektorze. ↑ i ↓ przechodzą między wierszami. Esc czyści zaznaczenie.
Panel interfejsu w inspektorze
Panel interfejsu służy do edycji jednego interfejsu. Pojawia się w inspektorze nad atrybutami encji, gdy zaznaczysz:
- łącznik na Diagramie bloków wewnętrznych
- kanał podrzędny lub pole środkowe na Diagramie kontroli interfejsów
Panel zawiera:
- Przepływ elementu (tylko IBD): Bez kierunku, Skierowany, Odwrotny lub Dwukierunkowy. Ustala strzałki elementów, gdy nie rozstrzygają ani akcje, ani kierunki portów.
- Przenoszone elementy (przepływy elementów): każdy element z kierunkiem (
EPS → Payload Cameralub w obie strony). Elementy z kanałów podrzędnych są oznaczone (kanał podrzędny). × kończy przenoszenie elementu; sam element pozostaje. Bez elementów: Brak elementów. Dodaj elementy Input/Output przenoszone przez ten łącznik. - Wymieniane przez końce: jeden przycisk + <item> na każdy sugerowany element. Element jest sugerowany, gdy akcja na jednym końcu go generuje, akcja na drugim końcu go odbiera, a kanał jeszcze go nie przenosi.
- + Dodaj element ▾: Istniejący Input/Output… (wybierz jeden) lub Nowy Input/Output… (nadaj nazwę; domyślnie New Item).
- Status interfejsu, Właściciel (tekst zastępczy Osoba lub zespół) i TBD/TBR.
- Wymagania interfejsowe: każde powiązane wymaganie z traced from lub satisfies. × usuwa powiązanie. + Powiąż wymaganie… otwiera selektor. Wymaganie utworzone w nim otrzymuje etykietę Wymaganie interfejsowe. Gdy brak: Brak powiązań.
- Sprawdzenie przepustowości: tekst sprawdzenia, czerwony przy przekroczonej przepustowości.
Panel portu
Zaznaczenie portu na diagramie bloków dodaje:
- Typ: typujący Interface Block lub Input/Output albo Bez typu. Ustaw typ… (lub Zmień…) otwiera okno Typ portu (Interface Block lub Input/Output). Wyczyść usuwa typ. Typowanie portu elementem Asset dodaje do tego elementu Asset etykietę Interface Block.
- Sprzężony (odwraca przepływy typu; pokazywany jako ~Type).
Port z typem ma postać name : Type; port sprzężony name : ~Type.
Diagram kontroli interfejsów
Elementem głównym Diagramu kontroli interfejsów jest Conduit. Obszar roboczy pokazuje:
- pas lewego nadrzędnego elementu Asset i pas prawego nadrzędnego elementu Asset
- między nimi pole środkowe: kanał główny
- wewnątrz pola środkowego kanały podrzędne jako poziome paski, z ich elementami jako zielonymi znacznikami
Pasek narzędzi
| Element sterujący | Czynność |
|---|---|
| Lewo: <asset> / Brak elementu Asset po lewej. Wybierz Asset… | Wybierz lewy nadrzędny Asset. Kanał główny connects to go; poprzedni lewy rodzic zostaje odłączony. |
| Prawo: <asset> / Brak elementu Asset po prawej. Wybierz Asset… | Wybierz prawy zasób nadrzędny |
| Eksportuj ICD (CSV) | Pobiera ICD - <name>.csv, z jednym wierszem na każdy kanał podrzędny i element (zobacz niżej). |
| Eksportuj dokument ICD | Pobiera ICD - <name>.docx (zobacz niżej). |
| Rejestr interfejsów | Otwiera okno z rejestrem dla kanału głównego i jego kanałów podrzędnych. |
Gdy nie zapisano rodziców, używane są pierwsze dwa elementy Asset, z którymi łączy się kanał główny.
Paleta
| Element | Gdzie upuścić | Wynik |
|---|---|---|
| Asset | Pas nadrzędnego elementu Asset | Podrzędny Asset tego rodzica (decomposed by). W przeciwnym razie: Upuść go w pasie nadrzędnego elementu Asset. |
| Conduit | Pole kanału środkowego | Kanał podrzędny kanału głównego. W przeciwnym razie: Upuść na polu kanału pośrodku. |
| Input/Output | Kanał podrzędny | Kanał transfers element. W przeciwnym razie: Upuść na kanale podrzędnym. |
Istniejące elementy Asset, Conduit i Input/Output można w ten sam sposób przeciągać z listy istniejących encji palety. Wszystko inne: Ten diagram nie może pokazać tej encji.
Edycja w obszarze roboczym
- Przeciągnij od kanału podrzędnego do podrzędnego elementu Asset, aby je powiązać (connects to, tworzone od razu). Inne pary są odrzucane komunikatem Kanał podrzędny łączy się z zasobem podrzędnym. Przeciągnij do jednego z nich.
- Przeciągnij podrzędny Asset do drugiego pasa, aby przenieść go do tamtego rodzica. Przeciągnij element na inny kanał podrzędny, aby go tam przenieść.
- Delete od razu usuwa zaznaczenie z diagramu (odłącza je; encja pozostaje). ⇧Delete / Shift+Delete usuwa encję po potwierdzeniu. Usunięcie pasa rodzica odłącza tego rodzica.
Widok ▾
| Opcja | Ukrywa |
|---|---|
| Ostrzeżenia jednostek | Obrys ostrzeżenia na elemencie, którego jednostki różnią się od jednostek jego kanału, oraz jego ustalenie w kontrolach diagramu (<item> jest w jednostce <unit>; <conduit> przenosi w jednostce <unit>. Zmień jedną jednostkę.). |
| I/O | Znaczniki elementów. |
| Opóźnienie i przepustowość | Etykiety opóźnienia i przepustowości na polu środkowym i kanałach podrzędnych. |
| Zasoby podrzędne | Podrzędne elementy Asset w pasach i ich linie połączeń. |
Etykieta każdego kanału podrzędnego pokazuje jego status w nawiasach oraz Latency: … · Capacity: …. Gdy sprawdzenie przepustowości nie przechodzi, etykieta dodaje · over (120%) lub · unit mismatch, a pasek zmienia kolor na czerwony lub pomarańczowy.
Kolumny tabeli ICD (CSV)
- Kanał i punkty końcowe: Child Conduit, From Asset, To Asset.
- Element: I/O, Units.
- Atrybuty kanału: Latency, Capacity, Interface Status, Owner, TBD/TBR, Connector/Pins, Medium.
- Atrybuty elementu: Direction (From → To, To → From lub Both), Size, Data Rate, Data Rate Units, Protocol/Format, Message/Data Definition.
- Requirements, Capacity Check.
- Jedna kolumna na każdy niestandardowy atrybut klasy Conduit (Conduit: <name>) i na każdy niestandardowy atrybut klasy Input/Output (I/O: <name>).
Zawartość dokumentu ICD (Word)
- Tytuł Dokument kontroli interfejsów: <root>, wiersz z nazwami dwóch nadrzędnych elementów Asset i datą wygenerowania oraz opis elementu głównego.
- Rejestr interfejsów: Interface, Endpoints, Status, Owner, TBD/TBR, Items, Capacity dla kanału głównego i każdego kanału podrzędnego.
- Podsumowanie statusów: liczba dla każdego statusu.
- Po jednej sekcji na kanał, z:
- tabelą Endpoints, Status, Owner, TBD/TBR, Connector/Pins, Medium, Latency, Capacity i wszystkich atrybutów niestandardowych
- Przenoszone elementy: Item, Direction, Size, Data Rate, Protocol/Format, Message/Data Definition oraz niestandardowe atrybuty I/O
- Wymagania: Number, Requirement, Statement
- Sprawdzenie przepustowości
Przycisk ICD w wierszu Rejestru interfejsów tworzy ten sam dokument dla tego jednego kanału i jego elementów podrzędnych.
Okno Rejestr interfejsów
Przycisk Rejestr interfejsów na paskach narzędzi ICD i IBD otwiera okno Rejestr interfejsów: <name>. Wymienia ono kanały tego diagramu:
- znaczniki statusów
- tabelę z kolumnami Interface, Endpoints, Status, Owner, TBD/TBR, Items, Requirements i Capacity
- opcję Wszystkie elementy Conduit w projekcie
- przyciski Eksportuj CSV, Eksportuj dokument ICD (tylko ICD) i Zamknij
Bez dołączonego kanału: Brak elementów Conduit. Dodaj elementy Conduit do diagramu, aby wyświetlić je tutaj.
Fizyczny diagram we/wy
Fizyczny diagram we/wy pokazuje, które elementy przepływają między częściami elementu Asset i czy każdy z nich przenosi jakiś Conduit. Pokazuje podrzędne elementy Asset danego elementu Asset i rysuje jedną linię na każdy Input/Output przepływający między nimi.
Linie są wyprowadzane z modelu:
- z akcji wykonywanych przez każdy Asset (generuje → odbiera)
- z elementów Conduit łączących elementy Asset
Linia przerywana bez elementu to Conduit, który niczego nie przenosi.
- Agregacja: akcje wykonywane przez dowolnego potomka pokazanego elementu Asset oraz kanały z nim połączone liczą się jako własne dla tego elementu Asset. Potomkowie to elementy podrzędne, ich elementy podrzędne i porty.
- Elementy zewnętrzne: elementy Asset spoza rodzica, które wymieniają z nim elementy, są rysowane w osobnym wierszu z oznaczeniem zewnętrzny.
- Pasek narzędzi: Traktuj jako wewnętrzny i Traktuj jako zewnętrzny. Kontrole interfejsów są w plakietce Kontrole diagramu. Dwa ostatnie przyciski wymagają zaznaczonego elementu Asset (Najpierw wybierz Asset.). Widok ▾ przełącza Zewnętrzne elementy Asset i Ostrzeżenia.
Tworzenie linii
- Przeciągnij od jednego elementu Asset do innego.
Linia pojawia się od razu, od pierwszego elementu Asset do drugiego, a jedno polecenie Cofnij wycofuje całość:
- nowy Input/Output New Input/Output;
- przenoszona przez Conduit, który już łączy oba elementy Asset, lub przez nowy Conduit A to B (z Origin na końcu pierwszego elementu Asset);
- wysyłany przez jedyną akcję pierwszego elementu Asset lub nową Send New Input/Output i odbierany przez jedyną akcję drugiego elementu Asset lub nową Receive New Input/Output.
- Nowa linia zostaje zaznaczona. Jej inspektor ma jedno miejsce na każdą część: Input/Output, Conduit, Wysyłający Action i Odbierający Action. W każdym miejscu:
- Zmień… wybiera istniejącą encję danej klasy;
- Nowy tworzy encję z nazwą domyślną (zmień ją w jej własnym inspektorze);
- Wyczyść (tylko Input/Output) zachowuje linię kanału bez elementu.
- Opcjonalnie: zaznacz Dwukierunkowy, gdy Conduit przenosi elementy w obu kierunkach.
Każda zmiana zapisuje linię na nowo, a jedno polecenie Cofnij wycofuje całość. Brakująca część jest oznaczona w swoim miejscu (np. ⚠ Żaden Conduit nie przenosi tego Input/Output.) z przyciskiem Dodaj, który ją tworzy.
Ostrzeżenia linii
| Poziom | Wiadomość |
|---|---|
| Ostrzeżenie | <item> przepływa między A i B, ale żaden Conduit ich nie łączy, aby go przenieść. |
| Ostrzeżenie | <item> przepływa między A i B, ale żaden z elementów Conduit łączących A i B go nie przenosi. |
| Ostrzeżenie | <item> przepływa między A i B, ale żaden element Action go tam nie wytwarza ani nie zużywa. |
| Błąd | <item> przepływa między A i B w kierunku, na który łączący je Conduit nie pozwala. |
| Informacja | <conduit> łączy A i B, ale nie przenosi żadnych elementów Input/Output. |
Linie ostrzeżeń są bursztynowe, a linie błędów czerwone. Plakietka Kontrole diagramu wymienia je w sekcji Interfejsy; Pokaż zaznacza linię. Inspektor zaznaczonej linii wymienia jej własne.
Diagramy N² i I²
Oba są macierzami kwadratowymi zbudowanymi z elementów podrzędnych elementu głównego.
| Diagram N² | Diagram I² | |
|---|---|---|
| Element główny | Action | Asset |
| Przekątna | Podrzędne elementy Action | Zasoby podrzędne |
| Komórki | Elementy Input/Output: wiersz generuje, kolumna odbiera | Elementy Conduit: wiersz to koniec źródłowy, kolumna to drugi koniec |
| Górny wiersz | Wejścia zewnętrzne (odbierane, niegenerowane przez nic w macierzy) | Do (kanały z jednym końcem prowadzące do kolumny) |
| Prawa kolumna | Wyjścia zewnętrzne (generowane, nieodbierane przez nic w macierzy) | Od (kanały z jednym końcem wychodzące z wiersza) |
| Pasek narzędzi | + Action, Usuń, Eksportuj CSV | + Asset, Usuń, Eksportuj CSV |
- Dodawanie elementu przekątnej: kliknij + Action / + Asset lub przeciągnij go z palety w dowolne miejsce.
- Dodawanie wpisu komórki: przeciągnij Input/Output / Conduit z palety na komórkę poza przekątną. Możesz też przeciągnąć pole z przekątnej do komórki w jego wierszu lub kolumnie: od razu powstaje tam Nowy Input/Output / Nowy Conduit. Nazwy domyślne mają postać
<row> To <column>,To <column>lubFrom <row>. - Przenoszenie wpisu: przeciągnij jego nazwę do innej komórki. Relacje są zapisywane na nowo.
- Otwieranie: kliknij dwukrotnie pole na przekątnej lub wpis, aby otworzyć jego widok elementu.
- Usuwanie: zaznacz go i naciśnij Delete lub Backspace albo kliknij Usuń. Od razu opuszcza macierz (zostaje odłączony; encja pozostaje). ⇧Delete / Shift+Delete usuwa encję po potwierdzeniu.
- Komórka wymienia do dziewięciu nazw w kolumnie, potem dwie kolumny, a potem +N więcej.
- Eksportuj CSV zapisuje
N2 - <root>.csvlubI2 - <root>.csvz pełną siatką. - Rozmieść ▾: Odśwież.
- Błędy: Upuść na komórce, Upuść na komórce poza przekątną.
Elementy i I/O
Interfejsy → Elementy i we/wy otwiera Bazę danych z zapytaniem class:"Input/Output". Używaj go do zbiorczej edycji Data Rate, Size, Protocol/Format i Message/Data Definition oraz do wyszukiwania elementów, których nie przenosi żaden kanał.
Skróty
| Klawisz | Gdzie | Czynność |
|---|---|---|
| Enter / Space | Wiersz Rejestru interfejsów | Pokazuje interfejs w inspektorze |
| ↑ / ↓ | Rejestr interfejsów | Przechodzi między wierszami |
| Esc | Rejestr interfejsów, N²/I² | Wyczyszczenie zaznaczenia |
| Delete / Backspace | ICD, N²/I², Fizyczny we/wy | Usuwa zaznaczenie z diagramu lub z modelu |
Komunikaty
| Wiadomość | Znaczenie i rozwiązanie |
|---|---|
| Ten projekt nie ma interfejsów. Dodaj elementy Conduit na diagramie IBD, Physical I/O lub ICD, aby pojawiły się tutaj. | Brak elementów Conduit. Narysuj łącznik lub dodaj Conduit. |
| Żaden interfejs nie pasuje do tego filtra. Wyczyść filtr, aby pokazać wszystkie interfejsy. | Filtr tekstu lub statusu ukrywa wszystkie wiersze. |
| Nie ustawiono Capacity; obciążenie nie jest sprawdzane. | Ustaw Capacity i Units w elemencie Conduit. |
| Brak przenoszonych elementów. | Kanał niczego nie przenosi. Dodaj elementy. |
| Przekroczona przepustowość: X z Y <unit> (N%). | Zwiększ Capacity, obniż szybkości elementów lub podziel obciążenie. |
| Nieuwzględnione elementy: N; jednostki “…” (<item>) nie dają się przeliczyć na “<unit>”. | Popraw jednostki elementu lub kanału. |
| Eksport dokumentów nie jest dostępny w tej kompilacji. | Eksporter Word się nie wczytał. Załaduj stronę ponownie. |
Limity
- Sprawdzenie przepustowości porównuje tylko sumy Data Rate (lub Size). Nie modeluje narzutu protokołu ani cyklu pracy, więc wpisuj szybkości efektywne.
- Conduit jest połączeniem punkt–punkt. Kontrola modelu Conduit.5 oznacza więcej niż dwa punkty końcowe.
- Data Rate elementu jest liczony raz dla każdego kanału, który go przenosi, także przez wiązkę.
Powiązane
- Przewodnik: Dokument kontroli interfejsów (ICD): co zawiera i jak utrzymywać go w aktualności.
- Weryfikacja — weryfikowanie wymagań interfejsowych i śledzenie pokrycia.
- Budżety i TPM — jednostki, wielkości i marginesy.
- Diagramy SysML — Diagramy bloków wewnętrznych, porty i łączniki.
- Analiza funkcjonalna — elementy Action i Input/Output, które przenoszą interfejsy.
- Pomoc: Rejestr interfejsów, Interfejsy, elementy Conduit i ICD, Budowanie architektury i tworzenie ICD, Diagram bloków wewnętrznych, Diagram kontroli interfejsów, Diagram N², Diagram I², Fizyczny diagram we/wy, Kontrole modelu.