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².
Nesta página
- Visão geral
- Conceitos
- Como usá-lo
- Quando e por quê
- Definir uma interface em um Diagrama de blocos interno
- Revisar todas as interfaces no registro
- Gerar um documento de controle de interfaces
- Checar as interfaces pelo lado funcional
- Exemplo prático: a interface de carga útil do CubeSat EO-1
- Dicas e boas práticas
- Erros comuns
- Como se conecta a outros recursos
- Registro de interfaces
- Painel de interface no inspetor
- Diagrama de controle de interfaces
- Caixa de diálogo Registro de interfaces
- Diagrama de I/O físico
- Diagramas N² e I²
- Itens e I/O
- Atalhos
- Mensagens
- Limites
- 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ágina | O que mostra |
|---|---|
| Registro de interfaces | Todos os Conduits com extremidades, status, responsável, TBD/TBR, contagem de itens, contagem de requisitos e checagem de capacidade. |
| ICDs | Os 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/O | O 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:
| Atributo | Significado |
|---|---|
| Capacity e Units | O máximo que o conduit pode transportar, por exemplo 400 Mbps ou 15 W. Usado pela checagem de capacidade. |
| Latency | Atraso pelo conduit (uma duração). |
| Connector/Pins | Tipo de conector e atribuição de pinos em cada extremidade. |
| Medium | Meio físico, por exemplo cobre, fibra, enlace de RF, tubo. |
| Responsável | Pessoa ou equipe responsável pela definição da interface. |
| Interface Status | Maturidade da definição: Draft, Proposed, Agreed ou Baselined. |
| TBD/TBR | Itens 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:
| Atributo | Significado |
|---|---|
| Size e Units | Quantidade por item, por exemplo 2.5 GB. Contada pela checagem de capacidade quando não há Data Rate definida. |
| Data Rate e Data Rate Units | Taxa com que o item é transportado, por exemplo 480 Mbps ou 6 W. A checagem de capacidade a soma. |
| Protocol/Format | Protocolo, codificação ou formato físico. |
| Message/Data Definition | Campos, 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:
- Pega a carga de cada item transportado: a Data Rate dele, ou o Size quando não há taxa definida.
- Converte cada carga para as Units do Conduit e as soma.
- Compara o total com a Capacity.
Os itens dos conduits filhos de um feixe contam para o feixe. O resultado é um destes:
| Resultado | Texto do registro | Significado |
|---|---|---|
| Dentro da capacidade | OK | A carga total cabe. |
| Acima da capacidade | Acima da capacidade | A carga total ultrapassa a Capacity. |
| Unidades incompatíveis | Unidades incompatíveis | As unidades de pelo menos um item não se convertem para as unidades do Conduit; esse item fica fora do total. |
| Sem capacidade | Sem capacidade | O 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:
- As Actions executadas em cada lado. O lado cuja Action gera o item é o que o envia.
- Os atributos Direction das portas (In, Out, In and Out).
- 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.
- Abra Arquitetura → Diagramas de blocos.
- 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.
- Arraste a alça da borda de uma parte até outra parte ou porta.
- 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.
- Selecione o conector.
- 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.
- No mesmo painel, defina Interface Status, Owner e TBD/TBR.
- Em Requisitos de interface, clique em + Vincular Requirement… e escolha ou crie o requisito.
- Nos atributos da entidade, defina Capacity e Units do Conduit.
- 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
- 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.
- Opcional: clique em um cartão para mostrar só essas interfaces. Clique de novo, ou clique no chip Status: … ×, para mostrar todas.
- Opcional: digite em Filtrar por nome ou extremidade para restringir a lista.
- Procure na coluna Capacidade por Acima da capacidade e Unidades incompatíveis, ambos mostrados em vermelho.
- Clique em uma linha para abrir o Conduit no inspetor e edite os atributos dele ali.
- 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.
- Abra Interfaces → ICDs.
- Clique em + Novo diagrama, ou abra um Diagrama de controle de interfaces existente.
- Clique em Nenhum Asset à esquerda. Escolha um Asset… e escolha o primeiro asset pai.
- Clique em Nenhum Asset à direita. Escolha um Asset… e escolha o segundo.
Cada faixa agora lista os assets filhos desse asset.
- Para cada enlace físico, arraste Conduit da paleta para a caixa central.
Um conduit filho aparece como uma barra na caixa central.
- Para cada item que um conduit filho transporta, arraste Input/Output para esse conduit.
- Opcional: para adicionar um asset filho, arraste Asset para a faixa de um pai.
- 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.
- Selecione um conduit filho e complete o painel de interface dele no inspetor, como no IBD.
- 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.
- 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.
- 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>.
- Abra o Diagrama de I/O físico do Asset pai.
- 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.
- 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:
- Abra Interfaces → Registro de interfaces.
Os cartões mostram 2 Draft, 2 Proposed, 16 Agreed, 6 Baselined e 0 Não definido.
- Encontre IF-05 Payload Interface (C&DH ↔ Payload Camera).
A coluna Capacidade dela mostra Acima da capacidade.
- Aponte para Acima da capacidade.
Você vê Acima da capacidade: 480.02 de 400 Mbps (120%).
- Clique na linha.
O inspetor mostra o Conduit:
- Capacity
400Mbps - 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.
- 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).
- 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).
- 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
- 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ãoW. 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.
Cabeçalho da página
| Controle | Ação |
|---|---|
| Exportar CSV | Baixa 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. |
| ICDs | Abre a lista de Diagramas de controle de interfaces. |
| + Nova interface | Abre 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
| Coluna | Conteúdo |
|---|---|
| Interface | Número e nome; o link abre a Visão de item. |
| Extremidades | As duas entidades conectadas, A ↔ B, ou Não conectado. |
| Status | Interface Status, ou Não definido. |
| Responsável | Atributo Owner. |
| TBD/TBR | TBD ou TBR; em branco para None. |
| Itens | Número de itens transportados, incluindo os itens dos conduits filhos. |
| Requisitos | Número de requisitos de interface vinculados. |
| Capacidade | OK, 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 Cameraou 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
| Controle | Açã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 ICD | Baixa ICD - <name>.docx (veja abaixo). |
| Registro de interfaces | Abre 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
| Item | Onde soltar | Resultado |
|---|---|---|
| Asset | A faixa de um asset pai | Um asset filho desse pai (decomposed by). Caso contrário: Solte-o na faixa de um asset pai. |
| Conduit | A caixa central do conduit | Um conduit filho da raiz. Caso contrário: Solte-o na caixa do conduit no meio. |
| Input/Output | Um conduit filho | O 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ção | Oculta |
|---|---|
| Avisos de unidade | O 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/O | As etiquetas dos itens. |
| Latência e capacidade | Os rótulos de latência e de capacidade na caixa central e nos conduits filhos. |
| Assets filhos | Os 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)
- 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.
- Registro de interfaces: Interface, Extremidades, Status, Responsável, TBD/TBR, Itens, Capacidade para a raiz e para cada conduit filho.
- Resumo de status: contagem por status.
- 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
- 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.
- 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.
- 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ível | Mensagem |
|---|---|
| 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² | |
|---|---|---|
| Raiz | Uma Action | Um Asset |
| Diagonal | Actions filhas | Assets filhos |
| Células | Input/Outputs: a linha gera, a coluna recebe | Conduits: a linha é a extremidade de origem, a coluna a outra extremidade |
| Linha superior | Inputs externos (recebidos, gerados por nada na matriz) | Para (conduits com uma só extremidade que entram na coluna) |
| Coluna da direita | Outputs 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>ouFrom <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>.csvouI2 - <root>.csvcom 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
| Tecla | Onde | Ação |
|---|---|---|
| Enter / Space | Linha do Registro de interfaces | Mostrar a interface no inspetor |
| ↑ / ↓ | Registro de interfaces | Passar de uma linha para outra |
| Esc | Registro de interfaces, N²/I² | Limpar a seleção |
| Delete / Backspace | ICD, N²/I², I/O físico | Remover ou excluir a seleção |
Mensagens
| Mensagem | Significado 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.
Relacionado
- Guia: Documento de controle de interfaces (ICD): o que ele contém e como mantê-lo atualizado.
- Verificação — verifique os requisitos de interface e acompanhe a cobertura.
- Orçamentos e TPMs — unidades, grandezas e margens.
- Diagramas SysML — Diagramas de blocos internos, portas e conectores.
- Análise funcional — as Actions e os Input/Outputs que as interfaces transportam.
- Ajuda: Registro de interfaces, Interfaces, Conduits e ICDs, Montar a arquitetura e gerar um ICD, Diagrama de blocos interno, Diagrama de controle de interfaces, Diagrama N², Diagrama I², Diagrama de I/O físico, Checagens do modelo.