Holarch

Interfaces

Interfaces

Defina interfaces como Conduits, registre o que flui por elas, cheque a capacidade, acompanhe a maturidade das interfaces no Registro de interfaces e produza ICDs e matrizes N² e I².

Como usá-lo →

Nesta página
  1. Visão geral
  2. Conceitos
    1. Conduit
    2. Input/Output (item)
    3. Requisitos de interface
    4. Portas e blocos de interface
    5. Checagem de capacidade
    6. Direção do fluxo de itens
  3. Como usá-lo
    1. Quando e por quê
    2. Definir uma interface em um Diagrama de blocos interno
    3. Revisar todas as interfaces no registro
    4. Gerar um documento de controle de interfaces
    5. Checar as interfaces pelo lado funcional
    6. Exemplo prático: a interface de carga útil do CubeSat EO-1
    7. Dicas e boas práticas
    8. Erros comuns
    9. Como se conecta a outros recursos
  4. Registro de interfaces
    1. Cabeçalho da página
    2. Cartões de status
    3. Tabela
  5. Painel de interface no inspetor
    1. Painel de porta
  6. Diagrama de controle de interfaces
    1. Barra de ferramentas
    2. Paleta
    3. Edição na tela
    4. Exibir ▾
    5. Colunas da tabela ICD (CSV)
    6. Conteúdo do documento ICD (Word)
  7. Caixa de diálogo Registro de interfaces
  8. Diagrama de I/O físico
    1. Criar uma linha
    2. Avisos de linha
  9. Diagramas N² e I²
  10. Itens e I/O
  11. Atalhos
  12. Mensagens
  13. Limites
  14. Relacionado

Visão geral

Use as páginas de Interfaces para definir o que atravessa cada fronteira do seu sistema, checar se cada caminho consegue transportá-lo e entregar o resultado a outras equipes como um ICD.

No Holarch, uma interface é um Conduit. Um Conduit é uma entidade do modelo que:

  • connects to dois assets (ou portas)
  • transfers os itens Input/Output que a atravessam

Todo Conduit do projeto é uma interface, onde quer que você o tenha desenhado: em um Diagrama de blocos interno, um Diagrama de I/O físico, um Diagrama de controle de interfaces, um Diagrama I² ou no Banco de dados.

O grupo Interfaces na barra de navegação contém quatro páginas:

PáginaO que mostra
Registro de interfacesTodos os Conduits com extremidades, status, responsável, TBD/TBR, contagem de itens, contagem de requisitos e checagem de capacidade.
ICDsOs Diagramas de controle de interfaces do projeto (a lista de Diagramas filtrada por esse tipo).
Diagramas N²Os Diagramas N² do projeto: as funções na diagonal, os Input/Outputs que elas trocam nas células.
Itens e I/OO Banco de dados filtrado pela classe Input/Output.

Conceitos

Conduit

Um Conduit é o caminho físico ou lógico entre dois assets: um cabo, um barramento, um enlace de RF, um tubo, uma conexão de rede. Ele se vincula às extremidades com connects to (visto a partir do asset: connected by).

Um Conduit pode ser decomposto em Conduits filhos. O pai então funciona como um feixe: transporta tudo o que os filhos transportam.

O Holarch adiciona estes atributos de interface a todo Conduit:

AtributoSignificado
Capacity e UnitsO máximo que o conduit pode transportar, por exemplo 400 Mbps ou 15 W. Usado pela checagem de capacidade.
LatencyAtraso pelo conduit (uma duração).
Connector/PinsTipo de conector e atribuição de pinos em cada extremidade.
MediumMeio físico, por exemplo cobre, fibra, enlace de RF, tubo.
ResponsávelPessoa ou equipe responsável pela definição da interface.
Interface StatusMaturidade da definição: Draft, Proposed, Agreed ou Baselined.
TBD/TBRItens em aberto: None, TBD (a ser determinado) ou TBR (a ser revisado).

Input/Output (item)

Um Input/Output (um item) é o que atravessa a interface: dados, energia, fluido, força, um sinal. Ele tem três tipos de vínculo:

  • generated by a Action que o produz
  • received by a Action que o consome
  • transferred by os Conduits que o transportam

O Holarch adiciona estes atributos:

AtributoSignificado
Size e UnitsQuantidade por item, por exemplo 2.5 GB. Contada pela checagem de capacidade quando não há Data Rate definida.
Data Rate e Data Rate UnitsTaxa com que o item é transportado, por exemplo 480 Mbps ou 6 W. A checagem de capacidade a soma.
Protocol/FormatProtocolo, codificação ou formato físico.
Message/Data DefinitionCampos, faixas e significado dos dados que o item transporta.

Requisitos de interface

Um requisito de uma interface é vinculado ao Conduit com traced from (o Conduit é traced from o requisito). Os requisitos que o Conduit satisfies também são listados. Um requisito criado pelo seletor de requisitos da interface recebe o rótulo Requisito de interface.

Portas e blocos de interface

Nos diagramas de blocos, uma extremidade pode ser uma Port de um bloco em vez do próprio bloco. Uma porta pode ser tipificada por um Input/Output ou por um Interface Block. Um Interface Block é um Asset com o rótulo Interface Block; ele descreve os itens e os fluxos que um ponto de interação aceita.

Uma porta Conjugated usa o tipo dela com todas as direções de fluxo invertidas. Ela é mostrada como ~Type.

Checagem de capacidade

A checagem de capacidade informa se um Conduit consegue transportar os itens dele. Para cada Conduit, o Holarch:

  1. Pega a carga de cada item transportado: a Data Rate dele, ou o Size quando não há taxa definida.
  2. Converte cada carga para as Units do Conduit e as soma.
  3. Compara o total com a Capacity.

Os itens dos conduits filhos de um feixe contam para o feixe. O resultado é um destes:

ResultadoTexto do registroSignificado
Dentro da capacidadeOKA carga total cabe.
Acima da capacidadeAcima da capacidadeA carga total ultrapassa a Capacity.
Unidades incompatíveisUnidades incompatíveisAs unidades de pelo menos um item não se convertem para as unidades do Conduit; esse item fica fora do total.
Sem capacidadeSem capacidadeO Conduit tem itens, mas não tem Capacity, então a carga não é checada.
Vazio—O Conduit não transporta itens.

As unidades são convertidas com o mesmo sistema de unidades dos orçamentos (veja Unidades e grandezas), então kbps, Mbps, Gbps, B/s, kW e W se misturam livremente dentro de um mesmo tipo.

Direção do fluxo de itens

Em um conector de IBD, cada item mostra uma seta. O Holarch obtém a direção do primeiro destes que a decide:

  1. As Actions executadas em cada lado. O lado cuja Action gera o item é o que o envia.
  2. Os atributos Direction das portas (In, Out, In and Out).
  3. O ajuste Fluxo de itens do próprio conector.

Como usá-lo

Quando e por quê

Defina as interfaces depois de decompor a arquitetura, junto com a alocação funcional. Depois que as funções são alocadas a subsistemas, toda troca que atravessa a fronteira de um subsistema precisa de um caminho físico.

A gestão de interfaces responde a quatro perguntas:

  • O que atravessa cada fronteira? Os itens transportados, com as taxas, os formatos e as definições de dados deles.
  • O caminho consegue transportá-lo? A checagem de capacidade.
  • Quem é o responsável, e está definido? Owner, Interface Status e TBD/TBR.
  • Quais requisitos a regem, e o que entregamos à outra equipe? Os requisitos de interface e o documento ICD.

Uma cadência típica:

  • Esboce as interfaces na revisão de requisitos do sistema.
  • Acorde-as entre as equipes responsáveis antes da revisão preliminar de projeto.
  • Coloque-as na linha de base antes da revisão crítica de projeto.

Definir uma interface em um Diagrama de blocos interno

Desenhe o conector, diga o que ele transporta e depois registre o status, os requisitos e a capacidade dele.

  1. Abra Arquitetura → Diagramas de blocos.
  2. Abra o Diagrama de blocos interno do sistema. Para criar um, clique em + Novo diagrama, escolha Diagrama de blocos interno e escolha o bloco em Diagrama de.
  3. Arraste a alça da borda de uma parte até outra parte ou porta.
  4. Solte sobre o alvo. O conector é criado na hora. Quando você arrasta de uma porta para um bloco, escolha Conectar ao bloco ou Adicionar porta conjugada no seletor de conexão.

Você vê um conector. O conector é um Conduit.

  1. Selecione o conector.
  2. No inspetor, em Itens transportados (fluxos de itens), adicione um item:
    • Para transportar um item que as Actions das duas extremidades já trocam, clique no botão de sugestão dele em Trocado pelas extremidades:, como + Image Strip.
    • Caso contrário, clique em + Adicionar item ▾ e escolha Input/Output existente… ou Novo Input/Output….

O nome do item aparece em verde no conector, com a seta de direção.

  1. No mesmo painel, defina Interface Status, Owner e TBD/TBR.
  2. Em Requisitos de interface, clique em + Vincular Requirement… e escolha ou crie o requisito.
  3. Nos atributos da entidade, defina Capacity e Units do Conduit.
  4. Em cada item, defina Data Rate e Data Rate Units, ou Size e Units.

A caixa Checagem de capacidade é atualizada na hora. O rótulo do conector mostra o status entre colchetes, por exemplo Payload Interface [Agreed]. O rótulo fica:

  • vermelho com ⚠ acima da capacidade quando a carga é alta demais
  • laranja com ⚠ unidades incompatíveis quando as unidades não se convertem

Revisar todas as interfaces no registro

  1. Abra Interfaces → Registro de interfaces.

Você vê cartões de status (Draft, Proposed, Agreed, Baselined, Não definido) e uma tabela com todos os Conduits.

  1. Opcional: clique em um cartão para mostrar só essas interfaces. Clique de novo, ou clique no chip Status: … ×, para mostrar todas.
  2. Opcional: digite em Filtrar por nome ou extremidade para restringir a lista.
  3. Procure na coluna Capacidade por Acima da capacidade e Unidades incompatíveis, ambos mostrados em vermelho.
  4. Clique em uma linha para abrir o Conduit no inspetor e edite os atributos dele ali.
  5. Para compartilhar o registro, clique em Exportar CSV. Para o documento Word de uma interface, clique em ICD na linha dela.

Gerar um documento de controle de interfaces

Um Diagrama de controle de interfaces descreve a interface inteira entre dois assets pais. A raiz dele é um Conduit para essa interface.

  1. Abra Interfaces → ICDs.
  2. Clique em + Novo diagrama, ou abra um Diagrama de controle de interfaces existente.
  3. Clique em Nenhum Asset à esquerda. Escolha um Asset… e escolha o primeiro asset pai.
  4. Clique em Nenhum Asset à direita. Escolha um Asset… e escolha o segundo.

Cada faixa agora lista os assets filhos desse asset.

  1. Para cada enlace físico, arraste Conduit da paleta para a caixa central.

Um conduit filho aparece como uma barra na caixa central.

  1. Para cada item que um conduit filho transporta, arraste Input/Output para esse conduit.
  2. Opcional: para adicionar um asset filho, arraste Asset para a faixa de um pai.
  3. Arraste de um conduit filho até um asset filho (ou o inverso). O vínculo connects to é criado na hora. Repita para a outra extremidade.
  4. Selecione um conduit filho e complete o painel de interface dele no inspetor, como no IBD.
  5. Clique em Exportar documento ICD para o ICD em Word, ou em Exportar ICD (CSV) para o CSV.

Checar as interfaces pelo lado funcional

Comece pelas funções para encontrar trocas que ainda não têm caminho físico.

  1. Abra Interfaces → Diagramas N² e abra o Diagrama N² da Action pai.

As Actions filhas ficam na diagonal. A célula na linha A, coluna B lista os itens que A gera e B recebe.

  1. Para adicionar uma troca, arraste Input/Output da paleta para uma célula fora da diagonal. Você também pode arrastar uma caixa da diagonal para uma célula da própria linha ou coluna: um Novo Input/Output é criado ali na hora.

O novo item recebe o nome da célula: <row action> To <column action>.

  1. Abra o Diagrama de I/O físico do Asset pai.
  2. Clique no selo de checagens do diagrama (⚠ e o número de constatações).

O inspetor lista, em Interfaces, todos os itens que fluem entre dois assets mas não têm Conduit para transportá-los.

  1. Corrija cada constatação. Clique em Mostrar para selecionar a linha dela e defina a parte que falta no inspetor da linha (Adicionar ao lado de Nenhum Conduit transporta este Input/Output.), ou adicione o item a um Conduit no IBD ou no ICD.

Exemplo prático: a interface de carga útil do CubeSat EO-1

Crie a demonstração com Gerenciar projetos → Arquivos de projeto ▾ → Novo projeto de demonstração e depois:

  1. Abra Interfaces → Registro de interfaces.

Os cartões mostram 2 Draft, 2 Proposed, 16 Agreed, 6 Baselined e 0 Não definido.

  1. Encontre IF-05 Payload Interface (C&DH ↔ Payload Camera).

A coluna Capacidade dela mostra Acima da capacidade.

  1. Aponte para Acima da capacidade.

Você vê Acima da capacidade: 480.02 de 400 Mbps (120%).

  1. Clique na linha.

O inspetor mostra o Conduit:

  • Capacity 400 Mbps
  • Owner Payload Lead
  • Medium LVDS twisted pairs plus SPI
  • Connector/Pins J5 (Micro-D 25)
  • Itens transportados Command Schedule (0.02 Mbps) e Image Strip (480 Mbps)

A taxa bruta de faixas da carga útil ultrapassa o enlace LVDS. Corrija de uma de três formas:

  • Aumente a Capacity do Conduit até a especificação real do enlace, por exemplo 600. O registro passa a mostrar OK.
  • Adicione compressão a bordo e depois reduza a Data Rate de Image Strip.
  • Registre a decisão em aberto: defina TBD/TBR como TBR e vincule um novo requisito com + Vincular Requirement… no IBD ou no ICD.
  1. Encontre IF-12 S-band Downlink e aponte para a coluna Capacidade dele.

Você vê Dentro da capacidade: 9.6 de 10 Mbps (96%). Passa, mas com pouca margem, então é candidato a TPM. A demonstração o acompanha como TPM-3 Payload Downlink Rate (veja Orçamentos e TPMs).

  1. Abra Interfaces → ICDs → IF-10 Space-to-Ground Link.

Os pais da esquerda e da direita são a espaçonave e o segmento solo. Os conduits filhos são IF-11 UHF Command Uplink (9.6 kbps, Baselined) e IF-12 S-band Downlink (10 Mbps, Baselined).

  1. Clique em Exportar documento ICD.

O arquivo Word contém:

  • o registro de interfaces dos três conduits
  • um resumo de status
  • uma seção por conduit, com as extremidades, os atributos, os itens transportados (com direção), os requisitos vinculados (5.1, 5.2 e 5.3) e a checagem de capacidade
  1. Abra o Diagrama de blocos interno do EPS.

A porta 12 V Bus é tipificada pelo bloco de interface IFB-1 12 V Power Interface. A porta 12 V In da carga útil usa o mesmo tipo, conjugado, então mostra 12 V In : ~12 V Power Interface.

Dicas e boas práticas

  • Dê aos Conduits nomes que sejam substantivos (Payload Interface, S-band Downlink) e um número a cada um (IF-05). As checagens do modelo marcam conduits sem nome, sem número e com nomes que não são substantivos.
  • Coloque a taxa no item, não no conduit. O conduit contém a capacidade; os itens contêm a carga. Assim, um item transportado por vários conduits é checado em cada um.
  • Use um conduit de feixe para um chicote ou grupo de enlaces e conduits filhos para cada linha. O diagrama ICD é construído em torno dessa estrutura.
  • Defina Interface Status em todo conduit. O cartão Não definido deve estar em zero antes de uma revisão de projeto.
  • Referencie a norma da interface: um Artifact com o rótulo Standard que o conduit e os dois assets reference. A checagem do modelo Conduit.7 procura por ele.

Erros comuns

  • Unidades incompatíveis. Um item tem a Data Rate em Mbps, mas as Units do conduit são W. O registro mostra Unidades incompatíveis, e o item não é contado. Corrija as unidades do lado que estiver errado.
  • Um conduit com só uma extremidade. Extremidades mostra Não conectado ou só um nome. Conecte o segundo asset com connects to.

Como se conecta a outros recursos

  • Alimentado por:
    • a arquitetura: Assets, Blocks e a decomposição deles
    • a análise funcional: Actions que geram e recebem Input/Outputs
    • os requisitos: requisitos de interface
  • Alimenta:
    • a RVTM: os requisitos de interface são verificados como qualquer outro (veja Verificação)
    • Checagens do modelo: Conduit.1–9 e IO.1–10
    • orçamentos e TPMs: margens de taxa
    • pacotes de revisão e linhas de base
  • Sugestões: o IBD sugere itens a transportar a partir das Actions que cada extremidade executa, para que a alocação funcional e as interfaces físicas fiquem consistentes.

Registro de interfaces

A página lista todos os Conduits do projeto. Ela se atualiza ao vivo conforme o modelo muda. Em um projeto SysML v2, lista os usos de conexão e de interface do modelo; as derivações de requisitos ficam de fora. Só as linhas próximas da posição de rolagem são desenhadas, então a página abre na hora em projetos grandes; a exportação ainda inclui todas as interfaces.

ControleAção
Exportar CSVBaixa Interface Register - <project>.csv: Number, Interface, Endpoints, Status, Owner, TBD/TBR, Items, Requirements, Capacity Check (o texto completo da checagem) e depois um resumo Status/Count.
ICDsAbre a lista de Diagramas de controle de interfaces.
+ Nova interfaceAbre Nova interface: um Nome (opcional; vazio gera <primeiro> to <segundo>) e os dois Assets que ela conecta (Escolher… para cada um). Criar adiciona o Conduit com os dois vínculos connected by e seleciona a linha dele; um único Desfazer reverte tudo. Em um projeto SysML v2, o botão é + Nova conexão: adiciona um uso de conexão entre duas partes.

Cartões de status

Um cartão por status (Draft, Proposed, Agreed, Baselined) mais Não definido, cada um com a contagem. Os cartões Agreed e Baselined são verdes; Não definido é âmbar.

Clique em um cartão para filtrar. O chip Status: <status> × limpa o filtro. O endereço interfaces?status=<status> abre a página filtrada. Ao lado de Filtrar por nome ou extremidade, a contagem mostra, por exemplo, 26 interfaces, ou 3 de 26 interfaces enquanto um filtro está ativo.

Tabela

ColunaConteúdo
InterfaceNúmero e nome; o link abre a Visão de item.
ExtremidadesAs duas entidades conectadas, A ↔ B, ou Não conectado.
StatusInterface Status, ou Não definido.
ResponsávelAtributo Owner.
TBD/TBRTBD ou TBR; em branco para None.
ItensNúmero de itens transportados, incluindo os itens dos conduits filhos.
RequisitosNúmero de requisitos de interface vinculados.
CapacidadeOK, Acima da capacidade, Unidades incompatíveis, Sem capacidade ou —. Aponte para ele para ver o texto completo.
(botão)ICD exporta o documento ICD dessa interface (Word).

Clique em uma linha, ou coloque o foco nela e pressione Enter ou Space, para mostrar o Conduit no inspetor. ↑ e ↓ passam de uma linha para outra. Esc limpa a seleção.

Painel de interface no inspetor

O painel de interface é onde você edita uma interface. Ele aparece no inspetor, acima dos atributos da entidade, quando você seleciona:

  • um conector em um Diagrama de blocos interno
  • um conduit filho ou a caixa central em um Diagrama de controle de interfaces

O painel contém:

  • Fluxo de itens (só IBD): Não direcionado, Direcionado, Reverso ou Bidirecional. Define as setas dos itens quando nem as Actions nem as direções das portas decidem.
  • Itens transportados (fluxos de itens): cada item com a direção (EPS → Payload Camera ou nos dois sentidos). Os itens de conduits filhos são marcados (conduit filho). × deixa de transportar um item; o item em si continua. Sem itens: Nenhum item. Adicione os Input/Outputs que este conector transporta.
  • Trocado pelas extremidades: um botão + <item> por item sugerido. Um item é sugerido quando uma Action em uma extremidade o gera, uma Action na outra extremidade o recebe, e o conduit ainda não o transporta.
  • + Adicionar item ▾: Input/Output existente… (escolha um) ou Novo Input/Output… (dê um nome; padrão Novo item).
  • Interface Status, Owner (texto de exemplo Pessoa ou equipe) e TBD/TBR.
  • Requisitos de interface: cada requisito vinculado com traced from ou satisfies. × o desvincula. + Vincular Requirement… abre o seletor. Um requisito que você cria ali recebe o rótulo Requisito de interface. Sem nenhum: Nenhum vinculado.
  • Checagem de capacidade: o texto da checagem, em vermelho quando acima da capacidade.

Painel de porta

Selecionar uma porta em um diagrama de blocos acrescenta:

  • Tipo: o Interface Block ou o Input/Output que tipifica a porta, ou Sem tipo. Definir tipo… (ou Alterar…) abre Tipo de porta (bloco de interface ou Input/Output). Limpar remove o tipo. Tipificar uma porta com um Asset adiciona o rótulo Interface Block a esse Asset.
  • Conjugada (inverte os fluxos do tipo; mostrada como ~Type).

Uma porta tipificada mostra name : Type; uma conjugada, name : ~Type.

Diagrama de controle de interfaces

A raiz de um Diagrama de controle de interfaces é um Conduit. A tela mostra:

  • a faixa do asset pai da esquerda e a faixa do asset pai da direita
  • entre elas, a caixa central: o conduit raiz
  • dentro da caixa central, os conduits filhos como barras horizontais, com os itens deles como etiquetas verdes

Barra de ferramentas

ControleAção
Esquerda: <asset> / Nenhum Asset à esquerda. Escolha um Asset…Escolha o asset pai da esquerda. O conduit raiz connects to ele; um pai da esquerda anterior é desvinculado.
Direita: <asset> / Nenhum Asset à direita. Escolha um Asset…Escolha o asset pai da direita.
Exportar ICD (CSV)Baixa ICD - <name>.csv, uma linha por conduit filho e item (veja abaixo).
Exportar documento ICDBaixa ICD - <name>.docx (veja abaixo).
Registro de interfacesAbre uma caixa de diálogo com o registro da raiz e dos conduits filhos dela.

Quando não há pais salvos, são usados os dois primeiros assets aos quais a raiz se conecta.

Paleta

ItemOnde soltarResultado
AssetA faixa de um asset paiUm asset filho desse pai (decomposed by). Caso contrário: Solte-o na faixa de um asset pai.
ConduitA caixa central do conduitUm conduit filho da raiz. Caso contrário: Solte-o na caixa do conduit no meio.
Input/OutputUm conduit filhoO conduit transfers o item. Caso contrário: Solte sobre um conduit filho.

Assets, Conduits e Input/Outputs existentes podem ser arrastados da lista de entidades existentes da paleta da mesma forma. Qualquer outra coisa: Este diagrama não pode mostrar essa entidade.

Edição na tela

  • Arraste de um conduit filho até um asset filho para vinculá-los (connects to, criado na hora). Outros pares são recusados com Um conduit filho se conecta a um asset filho. Arraste até um.
  • Arraste um asset filho para a outra faixa para movê-lo para esse pai. Arraste um item para outro conduit filho para movê-lo para lá.
  • Delete remove a seleção do diagrama na hora (desvincula; a entidade continua). ⇧Delete / Shift+Delete exclui a entidade depois de uma confirmação. Remover a faixa de um pai desvincula esse pai.

Exibir ▾

OpçãoOculta
Avisos de unidadeO contorno de aviso em um item cujas unidades diferem das do conduit dele, e a constatação dele nas checagens do diagrama (<item> está em <unidade>; <conduit> transporta <unidade>. Mude uma das unidades.).
I/OAs etiquetas dos itens.
Latência e capacidadeOs rótulos de latência e de capacidade na caixa central e nos conduits filhos.
Assets filhosOs assets filhos nas faixas e as linhas de conexão deles.

O rótulo de cada conduit filho mostra o status entre colchetes e Latency: … · Capacity: …. Quando a checagem de capacidade falha, o rótulo acrescenta · over (120%) ou · unit mismatch, e a barra fica vermelha ou laranja.

Colunas da tabela ICD (CSV)

  • Conduit e extremidades: Child Conduit, From Asset, To Asset.
  • Item: I/O, Units.
  • Atributos do conduit: Latency, Capacity, Interface Status, Owner, TBD/TBR, Connector/Pins, Medium.
  • Atributos do item: Direction (From → To, To → From ou Both), Size, Data Rate, Data Rate Units, Protocol/Format, Message/Data Definition.
  • Requirements, Capacity Check.
  • Uma coluna por atributo personalizado de Conduit (Conduit: <name>) e por atributo personalizado de Input/Output (I/O: <name>).

Conteúdo do documento ICD (Word)

  1. O título Documento de controle de interfaces: <raiz>, uma linha com os nomes dos dois assets pais e a data de geração, e a descrição da raiz.
  2. Registro de interfaces: Interface, Extremidades, Status, Responsável, TBD/TBR, Itens, Capacidade para a raiz e para cada conduit filho.
  3. Resumo de status: contagem por status.
  4. Uma seção por conduit, com:
    • uma tabela de Extremidades, Status, Responsável, TBD/TBR, Conector/pinos, Meio, Latência, Capacidade e quaisquer atributos personalizados
    • Itens transportados: Item, Direção, Tamanho, Taxa de dados, Protocolo/formato, Definição de mensagem/dados, mais os atributos personalizados de I/O
    • Requisitos: Número, Requisito, Enunciado
    • Checagem de capacidade

O botão ICD em uma linha do Registro de interfaces gera o mesmo documento para esse conduit e os filhos dele.

Caixa de diálogo Registro de interfaces

O botão Registro de interfaces nas barras de ferramentas do ICD e do IBD abre Registro de interfaces: <nome>. Ele lista os conduits desse diagrama:

  • etiquetas de status
  • uma tabela de Interface, Extremidades, Status, Responsável, TBD/TBR, Itens, Requisitos e Capacidade
  • a opção Todos os Conduits do projeto
  • os botões Exportar CSV, Exportar documento ICD (só ICD) e Fechar

Sem nenhum conduit ligado: Nenhum Conduit. Adicione Conduits ao diagrama para listá-los aqui.

Diagrama de I/O físico

Use o Diagrama de I/O físico para ver quais itens fluem entre as partes de um Asset, e se um Conduit transporta cada um. Ele mostra os assets filhos do Asset e desenha uma linha por Input/Output que flui entre eles.

As linhas são derivadas do modelo:

  • as Actions que cada asset executa (gera → recebe)
  • os Conduits que conectam os assets

Uma linha tracejada sem item é um Conduit que não transporta nada.

  • Agregação: as Actions executadas por qualquer descendente de um asset mostrado, e os Conduits ligados a eles, contam como do próprio asset. Os descendentes incluem filhos, netos e portas.
  • Externos: os assets fora do pai que trocam itens com ele são desenhados em uma fileira separada, marcados como externo.
  • Barra de ferramentas: Tratar como interno e Tratar como externo. As checagens de interface ficam no selo de checagens do diagrama. Os dois botões precisam de um asset selecionado (Selecione primeiro um asset.). Exibir ▾ alterna Assets externos e Avisos.

Criar uma linha

  1. Arraste de um asset até outro.

A linha aparece na hora, do primeiro asset para o segundo, e um único Desfazer reverte tudo:

  • um novo Input/Output Novo Input/Output;
  • transportado pelo Conduit que já liga os dois assets, ou por um novo Conduit A to B (com Origin na extremidade do primeiro asset);
  • enviado pela única Action do primeiro asset, ou por uma nova Send New Input/Output, e recebido pela única Action do segundo asset, ou por uma nova Receive New Input/Output.
  1. A nova linha fica selecionada. O inspetor dela tem um espaço por parte: Input/Output, Conduit, Action emissora e Action receptora. Em cada espaço:
    • Alterar… escolhe uma entidade existente dessa classe;
    • Novo cria um com o nome padrão (renomeie-o no próprio inspetor dele);
    • Limpar (só Input/Output) mantém a linha do Conduit sem item.
  2. Opcional: marque Bidirecional quando o Conduit transporta itens nos dois sentidos.

Cada alteração reescreve a linha, e um único Desfazer reverte tudo. Uma parte que falta é marcada no espaço (por exemplo ⚠ Nenhum Conduit transporta este Input/Output.) com Adicionar para criá-la.

Avisos de linha

NívelMensagem
Aviso<item> flui entre A e B, mas nenhum Conduit os liga para transportá-lo.
Aviso<item> flui entre A e B, mas nenhum dos Conduits que ligam A e B o transporta.
Aviso<item> flui entre A e B, mas nenhuma Action o produz ou consome ali.
Erro<item> flui entre A e B em uma direção que o Conduit de ligação não permite.
Informação<conduit> liga A e B, mas não transporta nenhum Input/Output.

As linhas com aviso ficam âmbar, as com erro ficam vermelhas. O selo de checagens do diagrama as lista em Interfaces; Mostrar seleciona a linha. O inspetor da linha selecionada lista os dela.

Diagramas N² e I²

Os dois são matrizes quadradas montadas a partir dos filhos da raiz.

Diagrama N²Diagrama I²
RaizUma ActionUm Asset
DiagonalActions filhasAssets filhos
CélulasInput/Outputs: a linha gera, a coluna recebeConduits: a linha é a extremidade de origem, a coluna a outra extremidade
Linha superiorInputs externos (recebidos, gerados por nada na matriz)Para (conduits com uma só extremidade que entram na coluna)
Coluna da direitaOutputs externos (gerados, recebidos por nada na matriz)De (conduits com uma só extremidade que saem da linha)
Barra de ferramentas+ Action, Remover, Exportar CSV+ Asset, Remover, Exportar CSV
  • Adicionar um elemento à diagonal: clique em + Action / + Asset, ou arraste-o da paleta para qualquer lugar.
  • Adicionar uma entrada a uma célula: arraste Input/Output / Conduit da paleta para uma célula fora da diagonal. Ou arraste uma caixa da diagonal para uma célula da própria linha ou coluna: um Novo Input/Output / Novo Conduit é criado ali na hora. Os nomes padrão viram <row> To <column>, To <column> ou From <row>.
  • Mover uma entrada: arraste o nome dela para outra célula. Os relacionamentos são reescritos.
  • Abrir: clique duas vezes em uma caixa da diagonal ou em uma entrada para abrir a Visão de item dela.
  • Remover: selecione-a e pressione Delete ou Backspace, ou clique em Remover. Ela sai da matriz na hora (desvinculada; a entidade continua). ⇧Delete / Shift+Delete exclui a entidade depois de uma confirmação.
  • Uma célula lista até nove nomes por coluna, depois duas colunas, depois +N mais.
  • Exportar CSV grava N2 - <root>.csv ou I2 - <root>.csv com a grade completa.
  • Organizar ▾: Atualizar.
  • Erros: Solte sobre uma célula, Solte sobre uma célula fora da diagonal.

Itens e I/O

Interfaces → Itens e E/S abre o Banco de dados com a consulta class:"Input/Output". Use-o para editar Data Rate, Size, Protocol/Format e Message/Data Definition em massa, e para encontrar itens que nenhum conduit transporta.

Atalhos

TeclaOndeAção
Enter / SpaceLinha do Registro de interfacesMostrar a interface no inspetor
↑ / ↓Registro de interfacesPassar de uma linha para outra
EscRegistro de interfaces, N²/I²Limpar a seleção
Delete / BackspaceICD, N²/I², I/O físicoRemover ou excluir a seleção

Mensagens

MensagemSignificado e correção
Este projeto não tem interfaces. Adicione Conduits em um diagrama IBD, de I/O físico ou ICD para listá-los aqui.Ainda não há Conduits. Desenhe um conector ou adicione um Conduit.
Nenhuma interface corresponde a este filtro. Limpe o filtro para mostrar todas as interfaces.O filtro de texto ou de status oculta todas as linhas.
Nenhuma Capacity definida; a carga não é checada.Defina Capacity e Units no Conduit.
Nenhum item transportado.O conduit não transfere nada. Adicione itens.
Acima da capacidade: X de Y <unidade> (N%).Aumente a Capacity, reduza as taxas dos itens ou divida a carga.
N itens não contados: as unidades "…" (<item>) não se convertem para "<unidade>".Corrija as unidades do item ou do conduit.
A exportação de documentos não está disponível nesta versão.O exportador do Word não carregou. Recarregue a página.

Limites

  • A checagem de capacidade compara só somas de Data Rate (ou Size). Ela não modela sobrecarga de protocolo nem ciclo de trabalho, então digite taxas efetivas.
  • Um Conduit é ponto a ponto. A checagem do modelo Conduit.5 marca mais de duas extremidades.
  • A Data Rate de um item é contada uma vez por conduit que o transporta, inclusive por um feixe.