Importing Existing Libraries to Your Connected Workspace

O Altium Designer, em conjunto com o seu Workspace ligado, disponibiliza um processo simplificado e altamente automatizado para importar rapidamente as suas bibliotecas existentes para esse Workspace. A interface para este processo – a Library Importer – apresenta uma solução de um clique que analisa automaticamente as bibliotecas selecionadas e importa-as para o Workspace ao qual está ativamente ligado.

Compatível com todos os tipos de bibliotecas, relacionados com metodologias mais antigas de gestão de componentes (SchLib, PcbLib, IntLib, DbLib, SVNDbLib), o Library Importer é uma solução dedicada para criar rapidamente a biblioteca de componentes do Workspace da sua empresa, para que possa beneficiar das suas muitas vantagens – armazenamento e gestão centralizados com elevada integridade, facilidade de reutilização de projeto, informação da cadeia de fornecimento em tempo real.

O Library Importer oferece um modo de interface minimalista Simple, em que as bibliotecas de componentes baseadas em base de dados e em ficheiros selecionadas são importadas para componentes do Workspace num único passo, enquanto o importer trata automaticamente da classificação por tipo, da pasta de origem de destino, da inclusão de parâmetros e do tipo de valor, e da transferência de todos os dados relevantes. A interface também está disponível num modo Advanced, que fornece uma pré-visualização completa da importação proposta da biblioteca, bem como acesso aos respetivos dados e definições. E, embora a importação seja por predefinição um processo de um clique, o importer também oferece opções avançadas de configuração através do painel Properties, para um controlo reforçado sobre a forma exata como essa importação é executada.

O que é importado?

Toda a informação presente numa biblioteca de origem original é importada para os componentes do Workspace , incluindo todos os modelos de domínio referenciados (símbolos esquemáticos, footprints de PCB, modelos de simulação), informação paramétrica, escolhas de peça atribuídas, ficheiros de folha de dados, etc. Os Component Templates também são criados quando necessário, podendo depois ser refinados e utilizados em importações posteriores de bibliotecas.

Se os seus componentes originais tiverem vários footprints de PCB definidos, o Library Importer irá transferir esses modelos e manter o footprint predefinido atual. E se trabalhar apenas com bibliotecas PCB – sendo essa a sua única preocupação em termos de layout de PCB – então o Library Importer suporta a importação apenas dessas bibliotecas, ou pode ser comutado para um modo de importação só de modelos, em que os tipos de modelos especificados são importados a partir de bibliotecas integradas ou de base de dados. Bibliotecas que incluem vários tipos de componentes (bibliotecas monolíticas) também são automaticamente detetadas e processadas.

Embora o processo de importação de bibliotecas tenha de lidar com fontes de bibliotecas baseadas em base de dados e em ficheiros que podem usar uma variedade de normas de formatação, os seus processos de análise automática detetam os tipos de componentes na biblioteca de origem (resistência, condensador, etc.) e também os nomes dos parâmetros e os respetivos tipos de valor (Volts, Ohms, etc.). O sistema realiza e gere um conjunto de validações, por exemplo, para garantir que não existem IDs duplicados para os componentes resultantes da biblioteca do Workspace, ou para garantir que não são criados modelos ou component templates duplicados, e que essas entidades são reutilizadas entre componentes (com ligação entre si) quando necessário. E, se surgirem problemas, o sistema assinala-os, com sugestões sobre como os resolver, com o objetivo de recolocar a importação no rumo certo o mais rapidamente, e da forma mais fluida possível.

Os tipos de bibliotecas que podem ser importados são:

  • Biblioteca esquemática (*.SchLib).

  • Biblioteca de footprints PCB (*.PcbLib).

  • Biblioteca integrada (*.IntLib)

  • Biblioteca de base de dados (*.DbLib).

  • Biblioteca de base de dados SVN (*.SVNDbLib).

Atualmente, a importação de informação de mapeamento de pinos (para modelos de simulação) não é suportada.

Aceder ao Library Importer

O Library Importer está disponível quando está ligado a um Workspace. Para aceder ao importer no seu modo Simple :

  • No painel Components, escolha a opção Import Library no menu  . Se uma biblioteca baseada em base de dados ou em ficheiro estiver atualmente selecionada na coluna Categories do painel (ou no menu pendente superior quando o painel está em modo compacto), o Library Importer será aberto para essa biblioteca. Quando está selecionado um tipo de componente de biblioteca do Workspace, será aberta a caixa de diálogo padrão do Windows Open para procurar e selecionar um ficheiro de biblioteca a importar.

    As bibliotecas baseadas em base de dados e em ficheiros que estão atualmente disponíveis para o software podem ser visualizadas e geridas na caixa de diálogo Libraries Preferences, acedida a partir da opção Libraries Preferences no menu do botão  , no painel Components.

    Também pode ver e gerir as bibliotecas baseadas em ficheiros atualmente instaladas na página Data Management – File-based Libraries da caixa de diálogo Preferences.

  • Clique com o botão direito num ficheiro de biblioteca no painel Projects e selecione Import Library no menu de contexto.

  • Selecione Tools » Import Library no editor de símbolo esquemático ou footprint PCB quando um ficheiro de biblioteca local estiver aberto.

  • Selecione File » Import Library ou Tools » Import Library no Editor de Biblioteca de Base de Dados.

  • Na caixa de diálogo Libraries Preferences, selecione uma entrada de biblioteca no separador Installed e depois clique no controlo Import.

  • Arraste e largue um ficheiro de biblioteca a partir de uma pasta do Windows para o painel Explorer.

O modo Simple disponibiliza opções para importar imediatamente a biblioteca selecionada () ou abrir o Library Importer no seu modo GUI completo ().

O Library Importer quando acedido no seu modo de importação de um clique Simple.
O Library Importer quando acedido no seu modo de importação de um clique Simple.

Para aceder diretamente ao Library Importer no seu modo de interface Advanced, selecione File » Library Importer no menu principal.

O Library Importer quando acedido no seu modo de interface completo Advanced também suporta um processo de importação com um clique.
O Library Importer quando acedido no seu modo de interface completo Advanced também suporta um processo de importação com um clique.

Modo Simple

O modo Simple do Library Importer pré-seleciona todos os aspetos do processo de importação com base na sua análise da biblioteca de origem e do Workspace ligado. A caixa de diálogo Library Importer apresenta então um resumo da estrutura de importação, incluindo uma contagem total para cada tipo de item. A importação da biblioteca é executada como um único passo através do comando .

Este modo de interface Simple adequa-se à maioria dos formatos comuns de bibliotecas de origem, que tendem a conter tipos de componentes comuns (resistências, condensadores, circuitos integrados, etc.) e valores de parâmetros normalizados. Durante o processo de análise inicial, o sistema deduz o tipo de componentes existentes na biblioteca com base no designador ou em palavras-chave de parâmetros (LD?, LED, etc.) e depois localiza um Component Template correspondente no Workspace de destino (LED). Este Template é aplicado à importação desses componentes, especificando então definições de importação como uma pasta de destino (Components/LED), mapeamento de parâmetros, unidades de valor dos parâmetros, e assim por diante – estão disponíveis templates adequados no Workspace se a opção de inclusão de dados de exemplo tiver sido selecionada durante a ativação de um Workspace Altium 365 ou a instalação do Altium On-Prem Enterprise Server.

Os resultados da importação da biblioteca, sob a forma de componentes recém-criados no Workspace, podem ser vistos tanto no painel Explorer como no painel Components. Os componentes importados incluem todos os modelos, parâmetros conforme interpretados pelos Component Templates aplicados, Part Choices derivados dos dados de origem de Supplier Link, e quaisquer ligações ou ficheiros de referência.

Quaisquer Component Templates criados pelo Library Importer podem ser acedidos na pasta Managed Content\Templates\Component Templates do painel Explorer.

Se, por qualquer razão – como um resultado de importação insatisfatório – quiser eliminar um conjunto de componentes, os selecionados no painel Components podem ser removidos de forma limpa escolhendo a opção Delete no menu de contexto do botão direito. Juntamente com os componentes selecionados, os seus modelos associados também podem ser eliminados (se não forem utilizados por outros componentes).

Pontos importantes relativos ao processo de importação de bibliotecas:

  • As bibliotecas monolíticas (as que contêm vários tipos de componentes) são automaticamente divididas em subgrupos, em que cada grupo representa um tipo de componente encontrado nessa biblioteca. Os grupos são processados como bibliotecas individuais.

  • Uma biblioteca de origem com um tipo de componente irreconhecível (não detetado) será importada sem interpretação, como tipos de componentes não atribuídos numa pasta Components/Uncategorized do Workspace. Antes de a importação ser executada, isto pode ser resolvido aplicando Designator Mapping ou Parameter Grouping no modo Advanced (UI completa). Em alternativa, pode prosseguir com a importação e depois modificar as definições e a pasta do componente mais tarde, através do painel Explorer.
  • O processo de importação da biblioteca inclui uma fase automática de Validation de componentes. Os componentes que desencadearem um erro de validação serão ignorados.
  • Se forem detetados modelos duplicados na biblioteca de origem a importar, apenas um desses modelos será importado e ligado aos componentes resultantes no Workspace de destino. Será mostrada uma notificação adequada no topo da caixa de diálogo Library Importer.
  • Quaisquer erros encontrados pelo processo podem ser visualizados em Importing Report, disponível a partir do botão quando a importação tiver sido concluída.

Modo Advanced

A GUI completa do Library Importer é apresentada no modo Advanced, que oferece controlo detalhado sobre a gestão de bibliotecas, tipos de componentes e parâmetros de componentes. Quando combinada com o painel Properties, a importação de bibliotecas de componentes para o Workspace pode ser configurada de acordo com as suas necessidades específicas. Tenha em conta que as definições do importer podem ser guardadas e restauradas através da exportação/importação de ficheiros de configuração.

O modo Avançado é ativado quando o Library Importer é aberto a partir do comando File » Library Importer , ou quando o botão é selecionado no modo Simples. As bibliotecas são adicionadas à secção SOURCE LIBRARIES do importador (caso ainda não esteja preenchida) arrastando e largando um ficheiro de biblioteca para essa área, clicando com o botão direito em <All Libraries> e selecionando depois Add Library no menu de contexto, ou selecionando o botão .

A secção Import Preview lista grupos de tipos de componentes identificados a partir das bibliotecas de origem – como Types () ou o Folder Structure () proposto – e inclui uma vista em grelha desses componentes baseada em parâmetros (Components). Os valores dos parâmetros na grelha podem ser editados de imediato, o que evita a necessidade de abrir e editar a biblioteca de origem. A área inferior Details inclui informações adicionais obtidas a partir do componente atualmente selecionado – Part Choices, Models e Datasheets.

Pode alterar o tipo de componente clicando com o botão direito num tipo na lista Types e selecionando o comando Change Component Type.

Independentemente das opções detalhadas e dos dados apresentados na interface, a vista Avançada do importador pode ser utilizada da mesma forma que a vista Simples – basta clicar no botão para invocar o processo de importação, sem intervenção. Tal como no processo da vista Simples, o importador analisou a biblioteca, deduziu o tipo de componentes que contém e aplicou o Component Template correto. Por sua vez, o template determina a pasta de destino no Workspace, os Naming Schemes e Lifecycle Definitions aplicados, bem como o mapeamento/interpretação de parâmetros.

  • Utilize o botão (canto superior esquerdo) para atualizar o Library Importer. Isto recarregará todas as bibliotecas de origem e os dados do Workspace para refletir quaisquer alterações ocorridas desde que o importador foi aberto.
  • Utilize o campo Search field (canto superior direito) para filtrar as entradas de Components por um valor de parâmetro correspondente.

Bibliotecas monolíticas

As bibliotecas de origem que contêm vários tipos de componentes são detetadas pelas rotinas de análise do importador e segregadas em grupos de sub-bibliotecas, onde podem ser processadas como bibliotecas individuais por tipo. A deteção do tipo de componente baseia-se nos Designators dos componentes de origem (R?, C?, etc.) e também em palavras-chave (Resistor, Res, etc.) contidas noutros parâmetros principais do componente (Description, ID, etc.).

No exemplo apresentado abaixo, a biblioteca de origem (ProjectABC.IntLib) foi automaticamente “dividida” de acordo com os tipos de componentes detetados (Condensadores, Resistências, etc.), que podem ser selecionados na coluna Folder Structure (ou na coluna Types) para pré-visualizar as respetivas entradas de componentes na grelha Components.

Os tipos de componentes que ainda não existem no Workspace, mas que serão criados durante o processo de importação, são identificados com o ícone .

Tenha em atenção que a apresentação da listagem Components pode ser alterada de várias formas:

  • Clique no cabeçalho de uma coluna para reordenar a lista por essa coluna de parâmetro e clique novamente para inverter a ordem.

  • No menu de contexto do cabeçalho, acessível com o botão direito:

    • Escolha Clear Sorting para repor a ordem predefinida da listagem (pela coluna Name por ordem ascendente).

    • Escolha Best Fit para ajustar a largura de uma determinada coluna ao respetivo conteúdo.

    • Escolha Select Best Fit All Columns para ajustar todas as colunas disponíveis à largura do respetivo conteúdo.

    • Escolha Select Columns para aceder à caixa de diálogo Select Columns, onde as colunas de parâmetros podem ser ativadas, desativadas e ter as suas posições na lista reordenadas.

  • Clique no ícone Filter () dentro de um cabeçalho para restringir a listagem a um valor disponível da coluna de parâmetro, a valores em branco/não em branco, ou a uma definição de filtro Custom. O filtro aplicado é apresentado na parte inferior da listagem, onde pode ser ativado/desativado (através da respetiva caixa de verificação), modificado em Filter Editor ou eliminado. Selecionar All através do ícone de filtro do cabeçalho () também removerá o filtro aplicado.

Componentes não categorizados

Se uma entrada de subgrupo de biblioteca tiver o nome Uncategorized (e estiver listada como Uncategorized em Types ou Folder Structure e acompanhada pelo ícone ), isto indica que o importador não conseguiu detetar e atribuir um tipo a esse grupo de componentes – o Component Type está efetivamente definido como None. Neste caso, os componentes não detetados (ICs de lógica inversora) utilizam um prefixo de Designator não reconhecido (U?) e os seus parâmetros não contêm palavras-chave detetadas, como IC, logic, etc.

Se a importação for executada, os componentes são importados como um tipo não categorizado, sem interpretação. No entanto, se estiverem incluídos quaisquer parâmetros chave/padrão (como Resistance, Capacitance, Tolerance, etc.), o importador defini-los-á automaticamente para um tipo de unidade de parâmetro adequado (Ohm, Farad, Percent, etc.).

Esta situação pode ser resolvida mapeando manualmente os designators utilizados para esses componentes para o tipo de componente pretendido na caixa de diálogo Library Splitting, à qual se acede a partir do botão – disponível quando a biblioteca de origem (ProjectABC.IntLib) está selecionada. A caixa de diálogo Library Splitting, com valores predefinidos, fornece controlos para definir opções personalizadas de agrupamento da biblioteca para componentes não categorizados com base no mapeamento de designators por tipos de componentes e na divisão baseada em parâmetros.

Com a opção Map Designators  da caixa de diálogo selecionada, escolha na lista pendente Component Type a opção de tipo de componente que se aplica aos componentes não categorizados (estão incluídos todos os tipos de componentes disponíveis). Confirme o mapeamento concluído entre tipo e designator (o tipo de componente Logic para os designators U?) com o botão .

Com o tipo de componente agora especificado pelo mapeamento aplicado, o importador utilizará o Component Template correspondente (Logic) para configurar a importação da biblioteca conforme definido pelas definições do template (pasta, nomenclatura, etc.).

  • A caixa de diálogo Library Splitting também inclui a opção de agrupar componentes divididos por um valor de parâmetro especificado (por exemplo, de um parâmetro Category ou Component_Type) se este estiver definido na biblioteca de origem. Para o fazer, selecione a opção Parameter Grouping da caixa de diálogo e depois um parâmetro adequado no menu pendente.
  • Em alternativa, o Component Type de uma biblioteca pode ser selecionado manualmente na secção General do Properties panel.
  • Para alterar o Component Type de uma entrada individual na lista Components, clique na respetiva célula Component Type e escolha depois um tipo alternativo no menu pendente, ou clique com o botão direito no tipo de componente e selecione Change Component Type no menu de contexto.

Tenha em atenção que, graças à flexibilidade das definições do Library Importer, um novo tipo (não categorizado) de biblioteca de componentes pode ser importado com toda a infraestrutura necessária para futuras importações desse tipo de biblioteca. Ao escolher uma configuração de importação adequada – novo Component Type, Component Template, pasta de destino, mapeamento de parâmetros e tipos de unidade de Value dos parâmetros – o único requisito para a próxima importação desse tipo de biblioteca é selecionar o Component Type previamente definido. O Component Type selecionado determinará então todos os restantes aspetos da importação.

Excluir do Importer

Também pode excluir tipos de componentes específicos da importação. Para excluir um tipo de componente, na lista Types, clique com o botão direito no tipo de componente que pretende excluir e selecione depois Exclude from Importer no menu de contexto – altere a listagem da coluna de Folder Structure para Types, se pretendido ().

O tipo de componente excluído ficará esbatido na lista Types. Para visualizar o(s) componente(s) excluído(s) na grelha, clique em Show Excluded Component (n), onde n indica o número de componentes excluídos.

Incluir no Importer

Se excluiu um tipo de componente da importação utilizando o comando Exclude from Importer descrito acima e, afinal, precisar de incluir esse tipo de componente, clique com o botão direito no tipo de componente esbatido na lista Types (ou Folder Structure) e selecione depois Include to Importer no menu de contexto. O tipo de componente voltará a ser apresentado na lista Types, indicando que já não está excluído.

Erros e avisos de validação

Os componentes que não serão importados corretamente para o Workspace, ou que não serão de todo importados, são assinalados por etiquetas de aviso ou erro na interface avançada quando o Library Importer é executado () ou quando é efetuada uma validação da importação (). A validação também verifica caminhos de pasta do Workspace vazios, parâmetros de sistema em conflito e modelos duplicados. Um erro fatal bloqueará a importação.

Ao tentar efetuar a importação, o painel Messages é preenchido com os problemas de violação detetados, e uma caixa de diálogo oferecerá a escolha entre abandonar ou prosseguir com a configuração atual da importação. Neste último caso, os componentes inválidos não são importados ou o processo de importação falhará.

No caso de uma importação cancelada ou quando é executada a validação manual, quaisquer componentes que não passem nas verificações de importação passam então a estar associados a ícones de erro/aviso, juntamente com informações adicionais na área inferior Details. Os ícones na coluna de pré-visualização Status indicam as entradas de componentes específicas que estão em violação das regras de verificação da importação.

As verificações de validação fixas disponíveis estão listadas abaixo.

As verificações definidas pelo utilizador são configuradas na região Import Checks do painel Properties. Utilize o menu pendente Report Mode para escolher um nível de relatório diferente para o tipo de violação associado. Estas verificações estão listadas abaixo.

Resolução de Erros e Avisos

Os erros de parâmetros, como no exemplo aqui apresentado em que o valor Forward Voltage do componente não pode ser interpretado como uma tensão válida, podem ser resolvidos através de:

  • Editar o Valor do parâmetro infrator – localize e edite a respetiva célula para um formato compatível.

  • Alterar a unidade do parâmetro mapeado Type, conforme determinada pelo Modelo de Componente aplicado, de Voltage para não interpretado Text – selecione a Biblioteca de Origem na interface do importador e, em seguida, altere o Forward Voltage Type na lista do painel Propriedades Parameter Mapping (no separador General).

  • Remover o componente do processo de importação – clique com o botão direito na respetiva entrada e escolha a opção Exclude from Importer .

Um erro de ficheiro em falta, como o ficheiro de Folha de Dados não localizável aqui apresentado, pode ser resolvido através de:

  • A solução óbvia de localizar e restaurar o ficheiro em falta para a localização esperada.
  • Desativar a importação de ficheiros de folha de dados – altere a opção Migrate na secção do painel Propriedades Datasheet (no separador Advanced).
  • Excluir o componente do processo de importação da biblioteca – conforme descrito acima.

Utilize o campo Search (canto superior direito) se pretender encontrar entradas de componentes específicas. A pesquisa filtra a lista de itens pelos valores de parâmetro correspondentes para o tipo de componente atualmente selecionado – selecione All em Types (Folder Structure) para que a pesquisa seja aplicada a todos os componentes nas bibliotecas de origem disponíveis.

Importação de Biblioteca Esquemática

Se encontrar um erro de 'modelo não encontrado' (como Footprint <footprint name> not found in available libraries) ao tentar importar uma biblioteca esquemática, isso significa que o Library Importer não consegue localizar os modelos que estão ligados a componentes dentro da SCHLIB.

No Modo Simples, esses erros serão apresentados no Importing Report baseado em HTML, acedido a partir do botão que fica disponível quando a importação tiver sido executada. No Modo Avançado, os erros são indicados por ícones de Estado na interface principal () e como entradas no painel Messages – isto ocorre ao efetuar uma verificação de validação () ou ao tentar importar a biblioteca ().

As footprints em falta são corretamente detetadas pelo processo de Validação, que também fornece uma opção Choose a Library no respetivo relatório de erros (no menu pendente Details). No caso de ter sido detetada em falta mais de uma footprint de componente, uma caixa de diálogo Apply PcbLib Selection fornece opções para utilizar a PcbLib especificada para esta instância ou para todos os componentes com footprints em falta.

Outra forma de resolver (ou evitar) este problema é garantir que os ficheiros de biblioteca de modelos necessários estão disponíveis no Altium Designer. As bibliotecas são instaladas através da página Gestão de Dados – Bibliotecas Baseadas em Ficheiros da caixa de diálogo Preferences.

Em alternativa, se não pretender instalar várias bibliotecas de modelos, terá de as localizar no caminho predefinido das bibliotecas do software (ou editar o caminho) e verificar se a biblioteca de origem do modelo está especificada para os componentes da Biblioteca Esquemática:

  • Inclua a biblioteca de modelos na localização do caminho de pesquisa predefinido do software. Adicione a biblioteca de modelos, como uma biblioteca PCB correspondente, à localização especificada pelo caminho predefinido de bibliotecas do sistema. Para verificar esta localização, consulte a entrada Library Path na página Sistema – Localizações Predefinidas da caixa de diálogo Preferences. Se tiver sido adicionado/copiado um ficheiro de biblioteca para essa localização de caminho, poderá ser necessário reiniciar o Altium Designer para registar a alteração.
  • Especifique o nome da biblioteca de modelos de destino para os componentes da Schematic Library. Para que a biblioteca de modelos ligada por um componente da schematic library seja conhecida pelo Library Importer, especifique o respetivo nome na caixa de diálogo da biblioteca PCB Model dialog.

Note que não é necessário, nem sequer desejável, importar uma PCB Library juntamente com a respetiva Schematic Library correspondente, uma vez que a importação e associação do modelo necessário serão efetuadas pelo próprio Library Importer. O processo de importação identifica, localiza e transfere o(s) modelo(s) correto(s) de cada componente para criar um componente unificado no Workspace de destino.

Deteção de Duplicados

O Library Importer inclui também mecanismos para evitar a criação de componentes duplicados no Workspace de destino. Isto é conseguido durante a validação através da comparação dos parâmetros identificadores dos componentes da biblioteca de origem e das Part Choices com os dos componentes no Workspace de destino e nas bibliotecas de origem a importar. Com as definições predefinidas do importador, um passo de Validação () assinalará uma mensagem Warning quando for detetada a mesma entrada de componente Name ou Part Choices (indicando um potencial componente duplicado). A mensagem de aviso/erro apresentada inclui o tipo de violação por duplicação (parâmetro ou Part Choice), o nome do componente da biblioteca em infração e o componente (por ID) com o qual está em infração.

Duas potenciais duplicações detetadas pelo processo Validate, em que o Name do componente (imagem superior) ou a sua Part Choice (imagem inferior) já existem em componentes do Workspace.
Duas potenciais duplicações detetadas pelo processo Validate, em que o Name do componente (imagem superior) ou a sua Part Choice (imagem inferior) já existem em componentes do Workspace.

O par nome-valor do parâmetro utilizado para detetar violações por duplicação é especificado na região Duplicates Detection do painel Properties, no separador Advanced. Utilize o menu pendente Unique Field (definido por predefinição para Name) para selecionar entre os Parameters disponíveis na biblioteca de origem. Esta seleção é particularmente útil para configurações de bibliotecas empresariais que utilizam um campo identificador proprietário ligado ao sistema empresarial mais amplo.

Foi detetada uma violação por duplicação em que o valor de um parâmetro especificado (ERP-REF) é o mesmo para um componente de biblioteca local e para um componente do Workspace.
Foi detetada uma violação por duplicação em que o valor de um parâmetro especificado (ERP-REF) é o mesmo para um componente de biblioteca local e para um componente do Workspace.

É possível definir um tipo diferente de sinalizador de estado para as violações por duplicação, selecionando uma Report Mode alternativa na região Import Checks, no separador General do painel Properties.

A deteção de duplicados também é efetuada para modelos de símbolos de componentes. Se os componentes a importar tiverem modelos de símbolos com a mesma geometria nas bibliotecas de origem, apenas um desses modelos será importado.

Esta funcionalidade está disponível quando a opção LibraryMigrator.DuplicatedModelCheck está ativada na caixa de diálogo Advanced Settings dialog.

Bibliotecas de Modelo Único

A deteção automática de duplicados também é utilizada para processar bibliotecas de origem que usam um modelo de símbolo comum para todos os componentes. Essas bibliotecas tendem a ser compostas por um único tipo de componente com estilos e valores diferentes, como resistências de um determinado formato de encapsulamento, em que o símbolo de cada uma é um gráfico de modelo padrão.

Esta condição de modelo único e comum é detetada pelo Library Importer, que depois configura a importação para transferir um modelo de símbolo aplicável a todos os componentes importados – em vez de um símbolo correspondente, com nome individual, para cada componente. O símbolo a importar adota o nome de um dos símbolos a importar, e todos os parâmetros dos componentes permanecem inalterados.

O símbolo de biblioteca importado (que tem o nome genérico e um campo Description em branco) pode ser editado para se adequar às suas necessidades. No painel Components panel, utilize a opção Edit do menu de contexto para invocar a ação. Durante o processo, selecione a opção Update items related to <symbol ID> na caixa de diálogo Create Revisions for Item para garantir que os componentes importados utilizam a nova revisão do símbolo.

Unir Tipos de Componente

O conjunto de Tipos de Componente registados no sistema – ou, na prática, no Workspace ligado – pode ser visualizado e gerido na página Gestão de Dados – Tipos de Componente da caixa de diálogo Preferences. Os tipos são listados com o respetivo Template de componente e a Folder do Workspace associados, e incluirão quaisquer novos tipos criados quando o Library Importer tiver importado ficheiros de biblioteca para o Workspace.

A criação de vários novos Tipos de Componente pode ocorrer tipicamente quando uma configuração do Library Importer utilizou Parameter Grouping (um valor de parâmetro de componente nomeado) para determinar o Tipo de cada componente importado. Por exemplo, o parâmetro Categories pode ser Resistor-0608 para um conjunto de componentes importados e Resistor-0402 para outro, e assim sucessivamente. Neste caso, todos seriam melhor agrupados sob o único Tipo de Componente Resistors para utilização futura.

Em vez de alterar manualmente todos os Tipos de Componente nestas circunstâncias, a página Component Types page em Preferences permite que entradas de Tipo selecionadas sejam unidas numa única entrada especificada. Para saber mais, consulte a secção Merging Component Types da página Component Types.

O resultado dessa união é que, quando Resistors for escolhido como o tipo de componente importado no Library Importer, será aplicado se selecionar qualquer um dos Templates unidos (Resistor_0402 etc.,) como alternativa.

Importação Apenas de Modelos

O Library Importer pode ser alterado para um modo especial de importação Models Only que deteta e processa os modelos de componentes disponíveis numa biblioteca de origem.

Esta funcionalidade está disponível quando a opção LibraryMigrator.ModelsOnlyMode está ativada na caixa de diálogo Advanced Settings dialog.

No modo Apenas Modelos, o processo de análise do importador irá detetar todos os modelos Symbol, Footprint e Simulation disponíveis numa biblioteca de origem (IntLib, SchLib, PcbLib, etc.,), e depois importar esses modelos para o Workspace utilizando as localizações predefinidas, os esquemas de nomenclatura e as definições de ciclo de vida do sistema.

Quando o Library Importer é mudado para o seu modo Avançado () ou aberto no seu modo Avançado (File » Library Importer), ficam disponíveis detalhes completos da importação de modelos proposta. A região Import Preview mostra o Folder Structure que será utilizado no Workspace de destino, o qual pode ser modificado relativamente às definições predefinidas no campo Folder para cada tipo de modelo no painel Properties. Os esquemas de nomenclatura aplicados e a definição de Lifecycle para cada modelo podem ser selecionados a partir dos tipos de sistema disponíveis (consulte o painel Properties panel, abaixo).

A importação de modelos de componentes para o Workspace pode ser limitada por tipo, se desejado, desativando (ou ativando) tipos de modelo específicos no painel Properties através dos respetivos botões .

Depois de o Library Importer estar configurado, selecione o botão para concluir a importação dos modelos de componentes listados. Os resultados podem ser revistos no ficheiro de registo da importação, conforme disponibilizado pela caixa de diálogo de progresso Library Importer (), ou visualizando os modelos importados no painel Components panel.

Importação Apenas de Componentes

Semelhante ao modo de importação Models Only descrito acima, o Library Importer pode ser alterado para um modo especial de importação Components Only que lhe permite importar os componentes disponíveis numa biblioteca de origem sem os respetivos modelos associados.

Esta funcionalidade está disponível quando a opção LibraryMigrator.ReleaseComponentsWithoutModels está ativada na caixa de diálogo Advanced Settings dialog.

No modo Apenas Componentes, o processo de análise do importador irá detetar todos os componentes, parâmetros e Part Choices numa biblioteca de origem, e depois importar estes componentes para o Workspace utilizando a localização predefinida, o esquema de nomenclatura e a definição de ciclo de vida do sistema.

Quando o Library Importer é mudado para o seu modo Avançado () ou aberto no seu modo Avançado (File » Library Importer), ficam disponíveis detalhes completos da importação de componentes proposta. A pasta aplicada, os esquemas de nomenclatura e a definição de Lifecycle podem ser selecionados a partir dos tipos de sistema disponíveis (consulte o painel Properties panel, abaixo).

Depois de o Library Importer estar configurado, selecione o botão para concluir a importação dos componentes listados. Apenas serão criados itens de componente no Workspace, sem quaisquer modelos associados. Os resultados podem ser revistos no ficheiro de registo da importação, conforme disponibilizado pela caixa de diálogo de progresso Library Importer (), ou visualizando os componentes importados no painel Components panel

Painel Properties

As definições do painel Properties associado ao Library Importer proporcionam controlo avançado sobre a configuração da importação para a biblioteca selecionada (ou grupo de sub-bibliotecas). O painel pode ser acedido a partir do modo Avançado do Library Importer selecionando a opção Properties no menu do botão  (na parte inferior direita da área de trabalho de design), clicando no botão  no canto superior direito da vista do Library Importer, ou clicando no botão  junto de <All Libraries> ou de uma entrada de categoria específica na lista Source Libraries.

As definições de opções do painel são definidas pelas predefinições do sistema ou pelas especificadas pelo Component Template aplicado, que por sua vez é definido pelo tipo de componente detetado da biblioteca – LED no exemplo aqui apresentado. As definições também podem ser editadas pelo utilizador, permitindo ajustar o processo de importação conforme necessário, e podem ser repostas através da ligação Reset to Default (canto superior direito).

As secções do separador General do painel são as seguintes:

  • General:
    • Component Type – o tipo de componente detetado pelo importador para a biblioteca selecionada e, por associação, o modelo aplicado (consulte Component Template abaixo). Substitua esta definição editando o campo, o que criará um novo component type, ou selecionando um tipo alternativo através das opções do menu pendente (ou através do botão ) – esta é outra forma de resolver um problema de uncategorized component issue. Escolha a opção [LibraryName] para definir o tipo como sendo o nome da biblioteca selecionada.
    • Component Template – o Component Template do Workspace que será aplicado aos componentes importados e, por associação, à respetiva definição de Tipo de Componente. Substitua esta definição selecionando um modelo alternativo através das opções do menu pendente (ou através do botão ). Defina esta opção como [Create new] para a criação automática de um modelo derivado dos parâmetros da biblioteca de origem e das definições atuais do Library Importer, ou escolha [No Template] para impedir que um modelo seja aplicado ou criado.

      Tenha em atenção que as definições Component Type e Component Template ficam efetivamente associadas quando definidas para um Tipo/Modelo disponível – por exemplo, se qualquer uma delas for definida como Capacitors, a outra é automaticamente definida como Capacitors. No entanto, se neste caso a definição Component Template for alterada para [Create New], será criado outro modelo Capacitors (com um sufixo de versão/revisão apropriado no nome) para cumprir as definições atuais. Os Component Templates existentes não são alterados pelo processo de importação.
  • Parameter Mapping – a correspondência de parâmetros entre os parâmetros da biblioteca e os do modelo de componente aplicado (ou as predefinições, quando não existe modelo disponível), bem como o Tipo de valor para cada parâmetro (Texto ou um tipo com reconhecimento de unidade). Utilize as opções do menu pendente da coluna Source Library Parameter para alterar o mapeamento e as opções do menu da coluna Type para substituir a definição existente determinada pelo modelo ou pelas predefinições. Escolha a opção <Skip> para não incluir um parâmetro. Qualquer parâmetro que não tenha sido automaticamente associado a um parâmetro da biblioteca de origem (fica definido como <Skip> pelo sistema) pode ser mapeado manualmente para um parâmetro adequado do Modelo – por exemplo, o parâmetro de origem ROHS pode ser selecionado para corresponder ao parâmetro RoHS Compliant definido pelo modelo do Workspace. Os nomes dos parâmetros podem ser editados e os conjuntos de parâmetros podem ser adicionados, editados e removidos. Os parâmetros base do componente (ID, Name, Description) podem ser remapeados, mas fora isso são apenas de leitura.

    Para o parâmetro do Workspace ID, o Parâmetro da Biblioteca de Origem está definido como <Auto>. Isto resulta em IDs de componentes criados automaticamente com base no Naming Template especificado na secção Component do painel, localizada no separador Advanced do painel. O mapeamento do ID pode ser alterado para utilizar qualquer parâmetro da biblioteca de origem (que seja único para cada entrada de componente), escolhendo uma alternativa no menu pendente Parâmetro da Biblioteca de Origem. Tenha em atenção que os parâmetros base do componente (ID, Name, Description) podem ser remapeados, mas fora isso são apenas de leitura.
  • Part Choice Mapping – a lista de parâmetros de peça do fabricante ou de ligação a fornecedor reconhecidos pelo importador, que será usada para derivar entradas de Part Choices para os componentes importados. Utilize as opções do menu pendente para redefinir o mapeamento, ou adicione e elimine conjuntos de mapeamento. Tenha em atenção que, por predefinição, os parâmetros de peça do fabricante e de ligação a fornecedor não são incluídos (são ignorados) no processo de importação. Quando são incluídas várias ligações a fornecedores com um componente da biblioteca, a referência do fornecedor principal (Supplier 1 / Supplier Part Number 1) é utilizada para as entradas do campo Part Choices.
  • Import Checks – ver ou definir a resposta de erro/aviso do importador a violações das regras de validação da importação. Utilize o menu pendente Report Mode para alterar a resposta e o ícone de uma entrada Violation Type. Tenha em atenção que, se o modo de relatório Fatal Error estiver selecionado, o processo de importação será bloqueado quando esta violação for detetada.

O separador Advanced do painel oferece definições para todos os itens de objetos de dados do importador, conforme definidas pelas predefinições do sistema ou pelo Component Template aplicado. Estes incluem modelos de componentes, ficheiros de datasheet e quaisquer Component Templates criados. Com exceção da opção Datasheet (um comutador de ativação/desativação), as definições para cada objeto importado incluem:

  • Folder – a pasta de destino do Workspace para o objeto importado, que pode ser editada manualmente (por exemplo, para criar uma nova pasta de destino) ou selecionada através do botão de pesquisa ().
  • Naming Scheme – a especificação de nomenclatura do objeto no Workspace, conforme definida pelo Component Template ou, na ausência de um modelo ativo, o esquema definido para a pasta de destino (ou conforme introduzido manualmente). Utilize o menu pendente para escolher entre os Naming Schemes disponíveis. Tenha em atenção que uma alteração no caminho da pasta de destino (Folder) pode ser acompanhada por uma alteração no Naming Scheme aplicado, conforme definido pela própria pasta ou por um Component Template aplicado/associado.
  • Revision Naming Scheme – o esquema de nomenclatura utilizado para as Workspace revisions do objeto, conforme definido pelo modelo aplicado ou selecionado nas opções do menu pendente da entrada. Apenas os esquemas ativados pelo sistema estarão disponíveis como opção.
  • Lifecycle Definition – o Lifecycle system utilizado para o objeto, conforme definido pelo modelo aplicado ou selecionado nas opções do menu pendente da entrada. Apenas as definições ativadas pelo sistema estarão disponíveis como opção.
A secção do objeto Component inclui a definição de Duplicates Detection, conforme descrito acima.

Configuração de Exportação-Importação

O Library Importer disponibiliza a capacidade de exportar um ficheiro detalhado baseado em texto que regista a configuração atual, incluindo todas as definições de importação configuráveis, tais como caminhos de destino, mapeamento de parâmetros, esquema de nomenclatura, definições de ciclo de vida, tipos de componentes de destino, entre outros.

O ficheiro de Configuração do Importador é guardado a partir do comando File » Export » Importer Config como um tipo de ficheiro *.lmcfg e pode ser restaurado em qualquer altura através da opção de menu File » Import » Importer Config .

A capacidade de restaurar uma configuração é particularmente útil quando a base de dados de origem ou a biblioteca baseada em ficheiros foi atualizada e essas alterações precisam de ser importadas para o Workspace. Se a configuração tiver sido exportada quando a biblioteca foi importada pela primeira vez, a configuração restaurada (importada) restabelecerá exatamente as definições de configuração que foram utilizadas, o que garante um esquema de transferência de dados consistente para essa biblioteca (ou bibliotecas).

Tenha em atenção que um ficheiro de Configuração do Importador exportado (guardado) inclui referências aos ficheiros de biblioteca que estavam abertos como bibliotecas de origem quando a configuração foi exportada. Quando esse ficheiro de Configuração do Importador for subsequentemente importado (recarregado), uma ou mais das bibliotecas referenciadas na configuração têm de estar disponíveis – isto é, têm de estar atualmente disponíveis como biblioteca de origem no Library Importer.
AI-LocalizedAI-localized
If you find an issue, select the text/image and pressCtrl + Enterto send us your feedback.
Feature Availability

The features available to you depend on which Altium solution you have – Altium Develop, an edition of Altium Agile (Agile Teams or Agile Enterprise), or Altium Designer (on active term).

If you don’t see a discussed feature in your software, contact Altium Sales to find out more.

Legacy Documentation

Altium Designer documentation is no longer versioned. If you need to access documentation for older versions of Altium Designer, visit the Legacy Documentation section of the Other Installers page.

Conteúdo