Trabalhando com a Caixa de Diálogo de Gerenciamento de Variantes

As variantes são criadas e configuradas na caixa de diálogo Variant Management. Para abrir a caixa de diálogo, selecione Variants no menu Project (atalho: C, V) ou clique com o botão direito no nome do projeto no painel Projects e depois selecione Variants.

A caixa de diálogo também pode ser acessada clicando com o botão direito em um componente colocado no editor Schematic e, em seguida, selecionando Part Actions » Variants. Nesse caso, a caixa de diálogo será preenchida com as peças que estão selecionadas no momento no editor Schematic.

A caixa de diálogo Variant Management está disponível quando a opção UI.ModernVariantsManager está desabilitada na caixa de diálogo Advanced Settings dialog. Quando a opção UI.ModernVariantsManager está habilitada, o Variant Manager é usado para criar e configurar variantes de projeto.

Recursos da Caixa de Diálogo

A caixa de diálogo tem duas regiões principais:

  • A região superior Components for project, que lista todos os componentes do projeto base e, se aplicável, colunas para as variantes aplicadas.

  • A região inferior Component Parameters, que detalha todos os parâmetros do(s) componente(s) selecionado(s) no momento na região superior e, se aplicável, colunas para as variantes aplicadas.

As variantes são criadas e configuradas na caixa de diálogo Variant Management.
As variantes são criadas e configuradas na caixa de diálogo Variant Management.

Clique duas vezes em um componente na caixa de diálogo Variant Management para ir até esse componente no esquemático ou selecione Cross Probe no menu de contexto do clique com o botão direito.

Criando uma Nova Variante

Clique no botão Add Variant button na caixa de diálogo Variant Management para criar uma nova variante do projeto base. A caixa de diálogo Edit Project Variant será aberta.

No mínimo, insira um nome para a variante no campo Description, que, por padrão, terá a entrada Variant of <ProjectName>.

Se for necessário gerar variantes de fabricação a partir do projeto, habilite a opção Allow variation of fabrication outputs na caixa de diálogo Edit Project Variant. Se for necessário gerar saídas de máscara de pasta para um projeto que inclua variantes com componentes 'Not Fitted', habilite a opção Allow variation for paste mask . Esses componentes deixarão de ter máscara de pasta incluída em seus pads.

Você pode escolher se uma peça alternativa precisa ter seu símbolo alterado em um esquemático, ou sua footprint adicionada à PCB, usando as seguintes opções na caixa de diálogo Edit Project Variant:

  • Do not overwrite schematic symbol – quando habilitada, símbolos não variados serão usados para componentes cujas peças alternativas forem selecionadas na variante.

    Observe que esta opção afeta apenas a representação do símbolo na folha esquemática. O símbolo da peça alternativa é considerado quando o modelo de conectividade do projeto é construído. Portanto, os componentes base e alternativo precisam ser compatíveis em pinos, mesmo que a opção esteja habilitada. Consulte a seção Choosing an Alternate Part para saber mais sobre compatibilidade de pinos.

  • Do not overwrite PCB footprint – quando habilitada, footprints não variadas serão usadas para componentes cujas peças alternativas forem selecionadas na variante. A footprint de uma peça alternativa aplicada a uma variante não será transferida para a PCB como parte da atualização da PCB (não será gerado um ECO para adicionar a footprint à PCB).

Independentemente de esses dois parâmetros estarem habilitados ou não, os parâmetros da alternativa escolhida são apresentados no ActiveBOM.

Você também pode definir parâmetros para a variante. Para detalhes sobre como isso funciona e como os parâmetros em nível de variante se encaixam na hierarquia paramétrica dentro do Altium Designer, consulte Working with Variant Parameters.

Com a variante definida conforme necessário, clique em OK. Uma coluna adicional será aberta no lado direito da caixa de diálogo Variant Management, com o novo nome da variante como título da coluna. Todas as células estarão vazias; uma célula vazia indica que o componente está Ajustado e inalterado em relação ao projeto base. Os componentes agora podem ser configurados para a nova variante. A imagem abaixo mostra um projeto no qual foram criadas duas variantes: BGA e TSOP.

A região 1 detalha os componentes no projeto base; a região 2 detalha os componentes na variante BGA; e a região 3 detalha os componentes na variante TSOP.
A região 1 detalha os componentes no projeto base; a região 2 detalha os componentes na variante BGA; e a região 3 detalha os componentes na variante TSOP.

Para tornar uma variante a seleção ativa, clique no nome da variante no cabeçalho da coluna ou clique em qualquer célula da variante.

A caixa de diálogo Variant Management inclui vários recursos de interface que permitem exibir informações úteis. Eles são configurados por meio do menu de contexto do botão direito.

Right-click context menu, Variant Management dialog

Comandos úteis ainda não definidos incluem:

  • Columns

    • Hierarchy Path – mostra a localização do componente na hierarquia do projeto.

    • Original Library Link – detalha de onde o componente base foi obtido.

  • Set Selected As – use o submenu para escolher o tipo de variação (Fitted, Not Fitted, Alternate). Pode ser usado em vez de clicar no controle Ellipsis control used to configure a variation na célula do componente. Disponível apenas quando você clica com o botão direito na célula de componente de uma variante.

  • Only Show Varied Parameters – exibe apenas componentes que tenham algum tipo de variação aplicada na caixa de diálogo Variant Management.

  • Filter – use o submenu para controlar quais tipos de variações são exibidos na caixa de diálogo Variant Management. (Funciona bem em combinação com o comando Only Show Varied Parameters.)

Definindo variações de componentes

Depois que a variante tiver sido criada, o estado de cada componente estará pronto para ser variado. Isso pode ser feito clicando em uma célula de componente na coluna da variante para revelar o controle Ellipsis control used to configure a variation, ou clicando com o botão direito na célula e escolhendo a entrada necessária no submenu de contexto Set Selected As.

O controle Ellipsis control used to configure a variation abre a caixa de diálogo Edit Component Variation.

A caixa de diálogo Edit Component Variation também pode ser acessada a partir da guia compilada de um esquemático clicando com o botão direito em um componente com uma variante definida e, em seguida, escolhendo Part Actions » Choose Alternate Part.

Três opções são oferecidas:

  •  Fitted – o componente original usado no projeto base também é ajustado/usado nesta variante do projeto. Para uma variante recém-adicionada, todos os componentes são ajustados por padrão, e as células dos componentes ajustados ficam vazias. Observe que parâmetros individuais também podem ser variados para um componente ajustado digitando um novo valor de parâmetro na região Component Parameters da caixa de diálogo para a variante.

  • Not Fitted – o componente original usado no projeto base não é ajustado/usado nesta variante do projeto. Para o status de componente Not Fitted, a célula exibe o texto Not Fitted e a região inferior Component Parameters da caixa de diálogo fica em branco.

  • Alternate Part – esta opção permite selecionar uma peça diferente (alternativa). A caixa de diálogo será expandida para incluir controles para procurar e localizar o componente de substituição necessário. Depois que a peça for escolhida, a célula exibirá o link de origem da peça alternativa. A região Component Parameters da caixa de diálogo exibirá todos os parâmetros da peça alternativa. Veja a próxima seção para mais informações.

São compatíveis as técnicas padrão de multisseleção do Windows. Use-as para selecionar e configurar vários componentes simultaneamente.

Escolhendo uma peça alternativa

Quando a opção Alternate Part é selecionada, a caixa de diálogo Edit Component Variation se expande para mostrar os parâmetros base da peça existente. Use o botão para procurar e localizar o componente de peça alternativa necessário na caixa de diálogo Replace Component dialog, que é uma versão modal do painel Components panel. Todos os modelos de armazenamento de componentes do Altium Designer são compatíveis, como bibliotecas independentes, bibliotecas de banco de dados, bem como componentes da Workspace Library (como mostrado no exemplo abaixo).

Após selecionar uma peça alternativa, o software verifica a compatibilidade de pinos entre o componente alternativo selecionado e o componente original do projeto base. Para ser compatível em pinos, a alternativa deve ter o mesmo número de pinos que o componente original, e esses pinos devem ser idênticos em localização e tipo elétrico. Não é necessário que os primitivos gráficos usados nos símbolos dos dois componentes correspondam. Se o software detectar que o componente alternativo não é compatível em pinos, uma caixa de diálogo Confirm deverá ser dispensada antes que a substituição seja aceita. Nesse caso, esteja atento ao impacto potencial na fiação e ao fato de que pode ocorrer uma violação de erro quando o projeto for validado (Project » Validate <project name>).

Um exemplo de variação com peça alternativa.
Um exemplo de variação com peça alternativa.

O novo componente alternativo aplicado pode ser verificado no espaço de projeto. Consulte a página Working with Variants in the Design para saber mais.

Redefinindo e atualizando dados de variante

As variações de projeto configuradas na caixa de diálogo Variant Management são, em última instância, salvas no arquivo do projeto. Isso inclui o estado "Not Fitted", variações locais de parâmetros em um componente Fitted e os valores de parâmetro de Alternate Parts. As Alternate Parts reais são armazenadas em um arquivo [ProjectName].PrjPcbVariants. A caixa de diálogo Variant Management inclui comandos para redefinir parâmetros e atualizar componentes, o que ajuda a garantir que eles estejam sincronizados com as bibliotecas de componentes de origem.

Atualizando um parâmetro de componente variado

Parâmetros modificados localmente na caixa de diálogo Variant Management podem ser restaurados ao seu valor original clicando com o botão direito no parâmetro modificado (mostrado em negrito) na lista Variant Parameter e escolhendo Reset Selected no menu de contexto – como mostrado abaixo. Observe que vários parâmetros podem ser selecionados de uma vez e depois redefinidos em uma única ação, ou pode-se usar Reset All para redefinir todos os parâmetros desse componente.

Os valores de parâmetro modificados podem ser restaurados usando o comando Reset Selected.
Os valores de parâmetro modificados podem ser restaurados usando o comando Reset Selected.

Atualizando um parâmetro de peça alternativa

Se um componente de biblioteca usado como Alternate Part teve parâmetros alterados na biblioteca, você pode trazer essas alterações diretamente para as definições de variante em seu projeto clicando com o botão direito na lista de parâmetros dessa Variant e selecionando Update Values from Library no menu (como mostrado abaixo). Observe que isso atualiza os parâmetros; se você precisar atualizar o gráfico, use a técnica descrita abaixo.

Se um componente Alternate Part tiver sido modificado na biblioteca, use o comando Update Values from Library para atualizar a cópia usada no projeto.
Se um componente Alternate Part tiver sido modificado na biblioteca, use o comando Update Values from Library para atualizar a cópia usada no projeto.

Após o comando Update Values from Library, procure e localize o componente na biblioteca de origem na caixa de diálogo Browse Libraries e clique em OK para abrir a caixa de diálogo Update Project Variants From Library. Selecione/desmarque Parameters from Library Component e Variants to Update e clique em OK para concluir o processo de atualização.

Se o componente selecionado para atualização de parâmetro for um componente Workspace, será aberta uma versão modal básica do painel Components panel em vez da caixa de diálogo Browse Libraries. Navegue ou pesquise para localizar o componente, clique em OK para abrir a caixa de diálogo Update Project Variants From Library e então selecione os parâmetros desejados para atualização, conforme descrito aqui.

Atualizando um componente variado a partir da biblioteca de origem. Aqui você configura quais parâmetros são atualizados e a qual variante as atualizações são aplicadas.
Atualizando um componente variado a partir da biblioteca de origem. Aqui você configura quais parâmetros são atualizados e a qual variante as atualizações são aplicadas.

Todos os parâmetros são listados à esquerda da caixa de diálogo Update Project Variants From Library – se necessário, qualquer parâmetro pode ser desmarcado para excluí-lo do processo de atualização. À direita da caixa de diálogo, a variante de projeto de destino pode ser alterada (Project Variant To Update). Por padrão, será selecionada a variante que estava selecionada quando o comando Update Values from Library foi ativado.

Observe que esse processo de atualização de parâmetros traz os valores dos parâmetros diretamente da biblioteca para a caixa de diálogo Variant Management e não atualiza a cópia do componente armazenada no arquivo [ProjectName].PrjPcbVariants. Se mais tarde você executar um dos comandos Reset para redefinir valores de parâmetros, que recupera valores do arquivo PrjPcbVariants, ele poderá reverter um valor de parâmetro para um valor anterior e sobrescrever quaisquer alterações atuais. Para garantir que isso não aconteça, atualize o componente no arquivo PrjPcbVariants usando o processo descrito abaixo.

Atualização Completa de uma Peça Alternativa

Se o componente de origem de uma Peça Alternativa tiver sido editado em sua biblioteca, ele poderá ser atualizado no projeto executando a caixa de diálogo Update from Library dialog.

Iniciada a partir do menu Tools no editor esquemático, a caixa de diálogo inclui uma opção para Include Variants. Quando essa opção estiver habilitada, a lista de componentes será expandida para incluir quaisquer componentes que tenham sido usados como Peças Alternativas. Marque os componentes na lista a serem atualizados e, em seguida, conclua o Assistente para atualizar as peças necessárias a partir da origem.

Para atualizar totalmente uma Peça Alternativa, incluindo seu gráfico, habilite a caixa de seleção Include Variants e habilite a peça a ser atualizada.
Para atualizar totalmente uma Peça Alternativa, incluindo seu gráfico, habilite a caixa de seleção Include Variants e habilite a peça a ser atualizada.

Se tiver havido alterações feitas nos componentes de biblioteca usados no projeto base, elas também serão atualizadas da maneira usual:

  • por meio do comando Tools » Update from Library do editor esquemático
  • ou do comando Tools » Update Schematics do editor de Biblioteca Esquemática.

Alterar Vários Parâmetros para Vários Componentes

A caixa de diálogo Variant Management oferece suporte à multisseleção, o que significa que qualquer número de componentes pode ser selecionado simultaneamente na parte superior (Componentes) da caixa de diálogo, e então as atualizações podem ser realizadas em qualquer número de parâmetros selecionados na parte inferior (Parâmetros) da caixa de diálogo. A caixa de diálogo também oferece Filtros (por meio do menu de contexto do botão direito), para refinar ainda mais a seleção e os dados exibidos.

Como exemplo, para redefinir os parâmetros alterados manualmente para todos os componentes, em todas as variantes:

  1. Na parte superior (Componentes) da caixa de diálogo, use a opção do menu do botão direito Only Show Varied Components em combinação com as opções Filter do botão direito para mostrar apenas Show Fitted with Varied Parameters. A lista de componentes agora deve exibir somente aqueles componentes que têm parâmetros alterados manualmente.

  2. Clique com o botão direito na lista de componentes e escolha Select All no menu de contexto. Todos os componentes exibidos atualmente na parte superior da caixa de diálogo serão selecionados.

  3. Em seguida, clique com o botão direito na parte inferior (Parâmetros) da caixa de diálogo e escolha Select All nesse menu de contexto. Todos os parâmetros de todos os componentes serão selecionados. Observe que o comando Select Column poderia ter sido escolhido em vez disso, o que permitiria aplicar uma ação (como Redefinir) aos componentes em uma variante (coluna) específica.

  4. Clique com o botão direito novamente na lista de parâmetros e escolha Reset Selected no menu de contexto. Passe o cursor sobre a imagem abaixo para mostrar as etapas 2, 3 e 4.

Redefinindo todos os parâmetros alterados manualmente, para todos os componentes, em todas as variantes. Passe o cursor sobre a imagem para mostrar as etapas 2, 3 e 4.
Redefinindo todos os parâmetros alterados manualmente, para todos os componentes, em todas as variantes. Passe o cursor sobre a imagem para mostrar as etapas 2, 3 e 4.

Se você estiver experimentando as opções de Filtro e tiver aplicado filtros diferentes, talvez seja necessário redefinir o filtro antes de tentar outra atualização. Para fazer isso, desabilite a opção Only Show Varied Components para limpar o sistema de filtros, depois aplique-a novamente e limpe as opções Filter conforme necessário.

Trabalhando com Parâmetros de Variantes

Altium Designer oferece suporte a parâmetros em vários níveis de um projeto. Por exemplo, parâmetros em nível de documento podem ser adicionados a cada folha esquemática na aba Parameters do painel Properties do editor esquemático (disponível quando nada está selecionado). Parâmetros em nível de projeto também podem ser adicionados a um projeto na aba Parameters da caixa de diálogo Project Options (Project » Options).

Além disso, parâmetros também podem ser adicionados a uma variante por meio da caixa de diálogo Edit Project Variant. Na caixa de diálogo Variant Management, selecione a coluna da variante e clique no botão Edit Variant para abrir essa caixa de diálogo. Para adicionar um novo parâmetro, clique no botão Add . Use a caixa de diálogo Parameter Properties que é aberta para inserir o Name e definir o Value do novo parâmetro e então clique em OK. O novo parâmetro agora é exibido na caixa de diálogo Edit Project Variant .

Os parâmetros incluídos em vários níveis de um projeto existem em uma hierarquia, o que significa que você pode criar um parâmetro com o mesmo nome em níveis diferentes do projeto, em que cada um tem um valor diferente. O Altium Designer resolve essa situação usando prioridades da seguinte forma:

  1. Variante (prioridade mais alta)
  2. Documento esquemático
  3. Projeto

Essa organização significa que o valor do parâmetro definido em um documento esquemático substitui o valor definido nas opções do Projeto, e o valor do parâmetro definido em uma Variante substitui o valor definido no documento esquemático. Observe que parâmetros em nível esquemático não estão disponíveis na PCB nem na BOM. Para esses tipos de saídas, devem ser usados parâmetros de projeto ou de variante.

Um parâmetro de variante pode ser mostrado em um documento esquemático ou PCB por meio da colocação de uma string especial. Saiba mais sobre Special Strings on a Schematic e Special Strings on a PCB.

Nas imagens abaixo, um parâmetro chamado ProjectTitle foi definido para o projeto e também para cada variante. O vídeo mostra o comportamento na PCB à medida que o seletor Variants é usado para mostrar o projeto base e, em seguida, cada variante.

Um parâmetro ProjectTitle adicionado ao projeto (por meio da caixa de diálogo Project Options ) também foi adicionado a cada variante do projeto, mas com um valor diferente em cada caso.
Um parâmetro ProjectTitle adicionado ao projeto (por meio da caixa de diálogo Project Options ) também foi adicionado a cada variante do projeto, mas com um valor diferente em cada caso.

Uma string especial .ProjectTitle foi colocada na sobreposição da PCB, a qual é vinculada automaticamente a parâmetros de projeto e de variante com o mesmo nome. Uma string especial .ProjectTitle foi colocada na sobreposição da PCB, a qual é vinculada automaticamente a parâmetros de projeto e de variante com o mesmo nome.

Variantes Quando um Arquivo DbLink é Usado

O Altium Designer oferece suporte a várias maneiras de armazenar e trabalhar com componentes, incluindo o uso de um arquivo DBLink com o projeto. Um arquivo DBLink é uma interface entre os componentes no esquemático e um banco de dados da empresa.

Em vez de apenas criar uma referência de cada componente para um registro específico do banco de dados (como normalmente é feito quando você posiciona um componente a partir de uma biblioteca do tipo DBLib), o modelo DBLink depende de que você inicie uma ação de consulta com base em um ou mais parâmetros do componente. O software então pesquisa no banco de dados um registro com campos que contenham valores correspondentes. Quando ocorre uma correspondência, outros valores de campo desse registro (como o Número da Peça) podem ser retornados ao componente no Altium Designer. O mapeamento component parameter-to-database field é definido no documento DBLink, assim como o banco de dados de destino.

Saiba mais sobre Database Libraries

Em um projeto que não usa variantes, a ação de consulta é realizada usando o comando Update Parameters from Database e também pode ser realizada durante a geração da BOM habilitando a opção Include Parameters from Database (veja abaixo), para extrair dados de componentes específicos da BOM, como preço.

Para um projeto que inclui variantes, os parâmetros usados para consultar o banco de dados são alterados na caixa de diálogo Variant Management. Como esses valores de parâmetros existem apenas na caixa de diálogo Variant Management, o comando Update Parameters from Database não é usado para recuperar informações do banco de dados. Em vez disso, os parâmetros são extraídos do banco de dados quando a BOM está sendo gerada.

Gerando um Relatório de Variantes

A caixa de diálogo Variant Report acessada ao clicar no botão Detailed Report na parte inferior da caixa de diálogo Variant Management permite configurar e gerar um relatório detalhado em formato HTML das variantes de projeto definidas.

A caixa de diálogo Variant Report
A caixa de diálogo Variant Report

Erros de Variante

As configurações de variante são armazenadas no arquivo de projeto (*.PrjPcb), e esses dados são lidos, analisados e carregados na caixa de diálogo Variant Management quando ela é aberta. Se forem detectados problemas durante o carregamento dos dados, como incompatibilidades entre designadores de componentes ou UIDs de componentes, uma caixa de diálogo Information será aberta para descrever o problema.

Resolva incompatibilidades de designador e UID antes de continuar com o processo de projeto.
Resolva incompatibilidades de designador e UID antes de continuar com o processo de projeto.

As incompatibilidades de UID de componentes são resolvidas automaticamente, e as correções serão mantidas quando o projeto for salvo. Designadores duplicados devem ser corrigidos no nível esquemático. Para resolvê-los, valide o projeto (Project » Validate <project name>) e verifique o painel Messages para obter detalhes de avisos/erros.

AI-LocalizedLocalizado por IA
Caso encontre um problema, selecione o texto/imagem e primaCtrl + Enterpara nos enviar o seu feedback.
Disponibilidade de Funcionalidades

As funcionalidades disponíveis dependem da solução Altium que possui – Altium Develop, uma edição do Altium Agile (Agile Teams ou Agile Enterprise), ou Altium Designer (com subscrição ativa).

Se não encontrar uma funcionalidade mencionada no seu software, contacte a equipa de Vendas da Altium para saber mais.

Documentação Legada

A documentação do Altium Designer já não é versionada. Se precisar de aceder à documentação de versões anteriores do Altium Designer, visite a secção Documentação Legada da página de Outros Instaladores.

Conteúdo