Gestão de bibliotecas de base de dados e baseadas em ficheiros disponíveis
No Altium Designer, os componentes de bibliotecas de base de dados e baseadas em ficheiros só podem ser colocados a partir de bibliotecas que estejam atualmente disponíveis. Estas incluem:
-
Libraries in the current project – se uma biblioteca fizer parte do projeto, os seus componentes ficam automaticamente disponíveis para colocação nesse projeto.
-
Installed libraries – estas bibliotecas foram instaladas no Altium Designer; os seus componentes estão disponíveis para utilização em qualquer projeto aberto.
-
Libraries on a defined search path – também é possível definir um caminho de pesquisa para uma pasta com várias bibliotecas. Como todos os ficheiros no caminho de pesquisa são pesquisados sempre que é escolhido um novo componente num painel, esta abordagem só é recomendada para bibliotecas pequenas com definições de modelo simples, como modelos de simulação. Os caminhos de pesquisa não são recomendados para modelos complexos, como footprints que incluem modelos 3D.
Para gerir bibliotecas de base de dados e baseadas em ficheiros disponíveis, pode utilizar a caixa de diálogo Libraries Preferences, à qual pode aceder clicando no botão 
na parte superior do painel Components e selecionando Libraries Preferences no menu.
A caixa de diálogo Libraries Preferences tem três separadores. Todas as bibliotecas e localizações de modelos definidas nestes separadores são reunidas para compor a sua lista de bibliotecas disponíveis. Quando é executada uma ação que requer a procura de um modelo, como a transferência do design do esquema para o layout PCB, as bibliotecas são pesquisadas pela ordem dos separadores e, depois, dentro de cada separador, pela ordem em que as bibliotecas/modelos estão listados. Assim que o modelo correto é localizado, o processo de pesquisa termina.
Bibliotecas do projeto
As bibliotecas que fazem parte do projeto ativo são listadas no separador Project da caixa de diálogo Libraries Preferences quando esse projeto é o projeto ativo no software. A vantagem das bibliotecas do projeto é que os modelos/bibliotecas ficam automaticamente disponíveis sempre que o projeto é aberto. A desvantagem é que, se os modelos/bibliotecas não estiverem armazenados na mesma estrutura de pastas do projeto que os ficheiros de design, podem ser facilmente esquecidos se os ficheiros do projeto forem movidos.
O separador Project fornece uma lista das bibliotecas disponíveis no projeto atual.
Qualquer biblioteca pode ser uma biblioteca do projeto; não precisa de estar armazenada na pasta do projeto. Para incluir bibliotecas no projeto, clique com o botão direito no nome do projeto no painel Projects e selecione o comando Add Existing to Project.
Bibliotecas instaladas
As bibliotecas e modelos que foram disponibilizados na sua instalação do software são designados por bibliotecas instaladas. Estas estão listadas no separador Installed da caixa de diálogo Libraries Preferences.
Esta lista é uma definição do ambiente. Quaisquer bibliotecas adicionadas à lista estarão disponíveis para todos os projetos, e a lista mantém-se entre sessões de design. As bibliotecas do projeto podem ser adicionadas a esta lista, mas não fazem inicialmente parte dela.
As bibliotecas instaladas podem ser listadas utilizando um caminho absoluto ou um caminho relativo à definição Library Path Relative To . A vantagem de utilizar um caminho relativo é que isto lhe permite criar um subambiente comum em vários PCs, permitindo mover facilmente os ficheiros de design entre eles. Além disso, as bibliotecas instaladas podem ser temporariamente desativadas limpando a caixa de verificação Activated, em vez de as remover.
Apenas bibliotecas Activated estão acessíveis a partir do painel Components.
O separador Installed lista as bibliotecas que foram disponibilizadas nesta instalação do Altium Designer.
Quando ligado a um Workspace Altium 365, é-lhe também apresentado um resumo do estado da sua Workspace Library. Isto mostra, de relance, o número de componentes que estão completamente saudáveis e o número de componentes que têm pelo menos um problema. Clique no controlo See Details para abrir a página Components da interface do browser do Workspace no seu navegador predefinido.
Quando ligado a um Workspace Altium 365, pode importar para o Workspace uma biblioteca instalada atualmente selecionada na área de grelha da caixa de diálogo clicando em
Import na coluna mais à direita. Será aberto o
Library Importer no seu modo simples com a biblioteca selecionada carregada.
Caminho de pesquisa
O separador Search Path apresenta uma lista de bibliotecas que foram localizadas de acordo com as definições de caminho definidas no separador Search Paths da caixa de diálogo Project Options, à qual se acede clicando no botão Paths. Cada caminho de pesquisa define uma pasta e pode incluir subpastas se a opção Recursive estiver ativada (disponível no separador Search Paths da caixa de diálogo Project Options depois de um caminho ser adicionado). Todos os ficheiros de modelo e biblioteca encontrados no caminho de pesquisa ficarão disponíveis. Os caminhos de pesquisa são guardados com o projeto.
Clique no botão Refresh para atualizar a lista com base nos caminhos de pesquisa mais recentes (definidos no separador Search Paths da caixa de diálogo Project Options ).
O separador Search Path lista as bibliotecas que foram encontradas nos caminhos de pesquisa definidos.
O separador Search Paths da caixa de diálogo Project Options está disponível quando a opção UI.ProjectOptions.SearchPaths está ativada na caixa de diálogo Advanced Settings.
A obtenção de modelos através de caminhos de pesquisa pode ser lenta se existir um grande número de ficheiros na(s) pasta(s) do caminho de pesquisa. Por esta razão, não se recomenda a utilização desta abordagem para bibliotecas PCB, uma vez que podem ser ficheiros grandes que contêm muitos footprints. Esta funcionalidade foi desenvolvida para fornecer uma forma de referenciar modelos de simulação e de integridade de sinal disponíveis.
Embora o software ofereça flexibilidade e controlo sobre localizações específicas de modelos/bibliotecas, exige a utilização da extensão de ficheiro correta para cada tipo de modelo. Por exemplo, um footprint só será encontrado se estiver num ficheiro com extensão .Lib ou .PcbLib. De forma semelhante, um SPICE *.SUBCKT só será encontrado se estiver num ficheiro .ckt e um SPICE *.MODEL só será encontrado se estiver num ficheiro .mdl. Sempre que uma pesquisa de modelo não encontrar correspondência, aparece um erro no painel Messages.
Browsing the Database Components
Assim que o DbLib/SVNDbLib tiver sido adicionado à lista de bibliotecas baseadas em ficheiros disponíveis, os componentes na base de dados ficarão disponíveis para navegação no painel Components. Embora seja adicionado apenas um único ficheiro DbLib/SVNDbLib, cada tabela na base de dados ligada será apresentada como se fosse uma biblioteca distinta.
Lembre-se de que, se a base de dados de destino tiver sido criada utilizando vários ficheiros de folha de cálculo Excel (*.xls), devido a limitações do controlador ODBC, o número de folhas que podem estabelecer ligação está limitado a 64.
A lista pendente superior no painel será preenchida com entradas da forma:
-
<LibraryName>.DbLib - <TableName> ou <LibraryName>.SVNDbLib - <TableName> ----onde a sua base de dados tem tabelas
-
<LibraryName>.DbLib - <SheetName>$ ou <LibraryName>.SVNDbLib - <SheetName>$ ----onde a sua base de dados é composta por folhas numa folha de cálculo Excel.
Exemplo de um DbLib carregado com três tabelas, outro com uma tabela e um SVNDbLib com uma tabela.
Cada entrada de componente no painel corresponde a um registo nessa tabela específica da base de dados. Na verdade, ao navegar em bibliotecas de base de dados carregadas, o painel Components comporta-se como um navegador direto da base de dados. As informações de símbolo e modelo são preenchidas a partir das bibliotecas de símbolos e modelos subjacentes apontadas pelos campos relevantes da base de dados (e em conjunto com os caminhos/localizações de pesquisa definidos).
Navegar por componentes numa base de dados externa ligada através de uma biblioteca de base de dados.
Por predefinição, apenas os campos Part Number e Library Ref são apresentados na região de listagem de componentes do painel. Para “expor” outros campos na tabela da base de dados, clique com o botão direito na região e escolha Select Columns no menu de contexto. Isto dar-lhe-á acesso à caixa de diálogo Select Columns, na qual pode ativar a apresentação de qualquer um dos campos adicionais dessa tabela.
Armazenamento em cache local de símbolos e modelos utilizados por bibliotecas de base de dados SVN
Quando um ficheiro SVNDbLib é adicionado à lista de bibliotecas disponíveis, as bibliotecas de símbolos e modelos no repositório são colocadas em cache numa pasta temporária, local ao computador do Designer. Quando uma ação no software exige a utilização de um símbolo esquemático ou de um modelo, esse símbolo/modelo é obtido a partir da cache local.
Atualização automática da cache
As bibliotecas na cache serão automaticamente atualizadas com a versão mais recente do repositório de controlo de versões ao executar qualquer uma das seguintes ações no software:
-
Colocar um componente a partir de um ficheiro SVNDbLib instalado (a partir do painel Components).
-
Executar uma transferência de design (ou seja, atualizar a PCB).
-
Utilizar o comando Tools » Update From Libraries no Schematic Editor.
-
Utilizar o comando Tools » Update From PCB Libraries no e PCB Editor.
Embora a atualização seja automática, pode ser controlada utilizando a opção Do not check files more often than xx minutes na página Data Management - SVN Libraries da caixa de diálogo Preferences . Esta opção fornece essencialmente um “temporizador de atualização” para a cache local. Se tiver decorrido o tempo especificado desde a última atualização da cache, então a cache será atualizada automaticamente quando uma das ações listadas for executada. Se uma ação for executada dentro desse intervalo de tempo, será utilizado o conteúdo atual da cache, que poderá estar desatualizado em comparação com o conteúdo do repositório.
Forçar manualmente uma atualização da cache
Pode haver ocasiões em que pretenda forçar uma atualização da cache local, para garantir que tem as bibliotecas mais atualizadas atualmente armazenadas no repositório de controlo de versões. Por exemplo, ao preparar-se para transferir o design do esquema para o PCB.
Pode forçar manualmente uma atualização da cache utilizando um dos seguintes métodos:
-
Utilizar um dos Refresh comandos disponíveis no menu de contexto acionado com o botão direito no painel Components.
-
Desinstalar e reinstalar o ficheiro SVNDbLib na lista de Bibliotecas Disponíveis.
Sempre que reiniciar o Altium Designer, a cache local será automaticamente atualizada com as bibliotecas mais recentes armazenadas no repositório SVN.
Pesquisar Componentes em Bibliotecas de Base de Dados e Baseadas em Ficheiros
Para ajudar a encontrar um componente em bibliotecas baseadas em ficheiros (tanto instaladas como não instaladas de momento) e em bibliotecas de base de dados, o Altium Designer inclui uma funcionalidade de pesquisa de bibliotecas.
É possível pesquisar um componente em bibliotecas de base de dados e bibliotecas baseadas em ficheiros utilizando o campo Search do ComponentspainelEnter. Introduza uma cadeia de texto e prima Enter para pesquisar essa cadeia na biblioteca atual, em qualquer ponto dos parâmetros visíveis do componente.
Pode efetuar uma pesquisa diretamente no Componentspainel.
A caixa de diálogo File-based Libraries Search permite uma pesquisa mais detalhada. Pode ser acedida clicando no botão no Componentspainel e selecionando File-based Libraries Search no menu. A metade superior da caixa de diálogo é utilizada para definir what o que está a procurar; a metade inferior é utilizada para definir where onde procurar.
Pesquise nas bibliotecas instaladas (Available libraries) ou nas bibliotecas no disco rígido (Libraries on path).O processo de pesquisa pode ser resumido da seguinte forma:
-
A pesquisa é efetuada definindo Filters que são aplicados a todas as bibliotecas pesquisáveis de acordo com as definições atuais de Scope pesquisa.
-
O Scope inclui o tipo de bibliotecas a pesquisar. Apenas um tipo pode ser pesquisado de cada vez.
-
Para ativar a pesquisa de componentes de base de dados, defina o campo Search in como Database Components e selecione a Table necessária. Tenha em atenção que os Fields disponíveis listados na lista pendente acima serão alterados para refletir os cabeçalhos de coluna disponíveis na tabela escolhida. As restantes opções da caixa de diálogo ficam esbatidas, uma vez que não são relevantes ao pesquisar bibliotecas de base de dados.
-
O Scope define que bibliotecas serão pesquisadas: ou as bibliotecas às quais o software tem atualmente acesso (Available libraries) ou todas as bibliotecas dentro de uma pasta (Libraries on path).
-
Ao pesquisar bibliotecas num caminho, o alvo é uma pasta específica e também pode Include Subdirectories.
-
Também pode pesquisar dentro dos resultados da pesquisa definindo o Scope para Refine last search.
-
Clique em Clear para limpar os parâmetros de pesquisa introduzidos.
Definir o Filtro de Pesquisa
A região Filters é utilizada para definir cadeias de texto a aplicar à pesquisa. Existem três regiões a configurar:
-
Field – este é o atributo do componente que será pesquisado. Pode ser qualquer atributo do componente ou do footprint, incluindo Nome, Descrição, Comentário, Footprint, ou qualquer parâmetro que tenha sido adicionado a um componente. Selecione um campo disponível na lista pendente ou introduza um campo na caixa de texto.
-
Operator – define como é determinada uma correspondência. Isto pode acontecer quando o valor equals, contains, starts with ou ends with. Tenha em atenção que equals exigem uma correspondência exata da cadeia, pelo que só devem ser utilizados quando tiver a certeza de que a cadeia de pesquisa está correta e completa.
-
Value – os caracteres a pesquisar no Field escolhido, com correspondência determinada de acordo com o Operator escolhido. Selecione um valor disponível na lista pendente ou introduza um valor no campo de texto.
Por predefinição, existem três restrições de filtro; pode adicionar até mais sete linhas para um total de 10 linhas utilizando o controlo Add Row. A última linha de restrição de filtro adicionada pode ser removida utilizando Remove Row. Pode remover linhas que não estejam a ser utilizadas.
Definir o Âmbito
Existem essencialmente duas abordagens de pesquisa:
-
Bibliotecas atualmente disponíveis – esta é a lista de bibliotecas apresentada na lista pendente no topo do Components painel.
-
Bibliotecas armazenadas numa pasta específica juntamente com subdiretórios, se a opção estiver ativada.
A pesquisa devolverá todos os itens do tipo de pesquisa escolhido na lista pendente Search in (Components/Footprints/3D Models/Database Components) encontrados em todas as bibliotecas que se enquadrem no Scope definido:
-
Available libraries - ativar para pesquisar tipos de modelo especificados apenas nas bibliotecas disponíveis.
-
Libraries on path - ativar para pesquisar tipos de modelo especificados nas bibliotecas disponíveis em pasta(s) especificada(s). Na região Path da caixa de diálogo, que fica disponível com a opção de âmbito Libraries on path selecionada, pode definir o caminho, incluir subdiretórios e incluir a máscara de ficheiro da biblioteca para especificar e restringir os critérios de pesquisa:
-
Path - edite para definir a pasta a partir da qual as bibliotecas podem ser pesquisadas, ou clique no ícone de procura no fim do campo para procurar uma pasta.
-
Include Subdirectories - ative se pretender pesquisar bibliotecas a partir do caminho especificado e respetivos subcaminhos.
-
File Mask - introduza a cadeia da máscara de ficheiro ou escolha uma das máscaras de ficheiro existentes na lista pendente. A pesquisa é filtrada para corresponder à cadeia. Pode utilizar o caráter universal * (qualquer caráter) na cadeia. Por exemplo, escreva * para pesquisar todos os ficheiros e escreva M para pesquisar todos os ficheiros que começam pela letra M.
Ative Refine last search para definir ainda mais os critérios de uma consulta de pesquisa a partir da lista de Resultados da Consulta obtidos pela pesquisa anterior. Por exemplo, se pesquisou footprints PCB com um nome baseado em DIP e pretende pesquisar e devolver apenas os footprints com uma altura definida inferior a 100 mil, ative esta opção. Introduza a nova expressão de consulta e clique em Search. O subconjunto dos resultados da consulta anterior será apresentado como a nova lista de Resultados da Consulta no Componentspainel.
Por exemplo, se pretender encontrar um componente que pensa estar numa biblioteca dentro de pastas específicas no disco rígido e essa biblioteca não estiver atualmente listada em Available File-based Libraries, defina a pesquisa da seguinte forma:
-
Na região Scope, defina Search in como Components e selecione Libraries on path.
-
Na região Path, defina o Path para apontar para a pasta que contém o documento de biblioteca que pretende pesquisar.
-
Clique em Search. Os resultados são apresentados no painel Components à medida que a pesquisa é efetuada.
Só pode colocar componentes de bibliotecas instaladas no Altium Designer. Se tentar colocar um componente de uma biblioteca que não esteja atualmente instalada, terá de confirmar a respetiva instalação.
Modo de Pesquisa Avançada
A pesquisa de bibliotecas é, na verdade, efetuada através de consultas. Na caixa de diálogo File-based Libraries Search, mude para o modo Advanced para examinar a consulta.
No modo Advanced da caixa de diálogo, também pode criar as suas próprias consultas utilizando as palavras-chave da linguagem de consulta para efetuar uma pesquisa baseada em consultas. Consulte a secção abaixo para saber mais sobre as palavras-chave disponíveis da linguagem de consulta.
Utilize os seguintes controlos adicionais quando o modo Advanced estiver selecionado:
-
Helper - clique para abrir a caixa de diálogo Query Helper e criar facilmente uma consulta de pesquisa de bibliotecas com funções de biblioteca e funções de sistema predefinidas. Também pode utilizar os botões History e Favorites para escolher uma consulta de biblioteca aplicada recentemente ou predefinida.
-
History - clique para abrir a caixa de diálogo Expression Manager e escolher uma das expressões de consulta anteriormente aplicadas para utilizar na pesquisa de bibliotecas. Também pode utilizar o botão Favorites para usar uma consulta predefinida para uma pesquisa de biblioteca especificada.
-
Favorites - clique para abrir a caixa de diálogo Expression Manager e escolher uma das suas expressões de consulta favoritas para utilizar numa pesquisa de bibliotecas. Também pode alterar a lista Favorites removendo, renomeando ou copiando expressões da lista History.
Ao pesquisar entre Database Components, o modo Advanced permite efetuar uma pesquisa de consulta SQL. Este nível de pesquisa oferece uma pesquisa 'fina' com base numa expressão de consulta especificada, na qual pode introduzir diretamente uma consulta SQL na secção do editor de consultas da caixa de diálogo.
Clique em Advanced para aceder a uma poderosa pesquisa de consultas baseada em SQL. Clique novamente em Advanced para regressar à pesquisa simples.
Funções de Consulta de Componentes e Bibliotecas
Funções de consulta de componentes e bibliotecas na caixa de diálogo Query Helper
Subjacente aos editores de esquema e PCB do Altium Designer está um poderoso motor de consultas. Ao introduzir consultas neste motor, pode delimitar logicamente com precisão os objetos de que necessita.
Uma consulta é uma cadeia que introduz utilizando palavras-chave e sintaxe específicas, que devolverá os objetos visados. Estão disponíveis muitas palavras-chave, permitindo direcionar objetos pelo seu tipo, pelas suas propriedades, ou por ambos.
As secções abaixo detalham as palavras-chave da linguagem de consulta disponíveis ao pesquisar componentes baseados em base de dados e em ficheiros no Altium Designer. Para obter ajuda sobre uma palavra-chave de consulta específica, utilize as seguintes secções expansíveis ou realce (ou clique dentro de) qualquer palavra-chave indicada - no Query Helper.
Componentes
ComponentType
Resumo
Devolve todos os componentes cuja propriedade Component Type cumpre a Consulta.
Sintaxe
ComponentType = ComponentType_String
ComponentType_String deve ser uma das cadeias da seguinte lista:
-
'Graphical'
-
'Jumper'
-
'Mechanical'
-
'Net Tie'
-
'Net Tie (In BOM)'
-
'Standard'
-
'Standard (No BOM)'
Exemplo de utilização
ComponentType = 'Graphical'
Devolve todos os componentes cuja Component Type é Graphical.
ComponentType = 'Standard'
Devolve todos os componentes cuja Component Type é Standard.
Notas
-
Certifique-se de que o âmbito da pesquisa está definido para Components utilizando o campo Search in na caixa de diálogo File Libraries Search dialog.
-
Ao pesquisar componentes, todas as bibliotecas SchLib e IntLib - disponíveis ou ao longo de um caminho de pesquisa definido - serão analisadas.
-
Todos os resultados são apresentados na listagem Query Results, de volta ao painel Components.
-
Os caracteres de aspas simples (') no início e no fim de ComponentType_String são obrigatórios.
Designator
Resumo
Devolve todos os componentes cuja propriedade Designator cumpre a Consulta.
Sintaxe
Designator : String
Exemplo de utilização
Designator = 'U2'
Devolve todos os componentes cuja propriedade Designator é U2.
Designator Like '*Channel*'
Devolve todos os componentes cuja propriedade Designator inclui Channel.
Designator <> 'C*'
Devolve todos os componentes exceto aqueles cuja propriedade except Designator começa com C.
Notas
-
Certifique-se de que o âmbito da pesquisa está definido para Components utilizando o campo Search in na caixa de diálogo File Libraries Search dialog.
-
Ao pesquisar componentes, todas as bibliotecas SchLib e IntLib - disponíveis ou ao longo de um caminho de pesquisa definido - serão analisadas.
-
Todos os resultados são apresentados na listagem Query Results no painel Components.
HasModel
Resumo
Devolve cada componente que está ligado a (ou referencia) um modelo de domínio cujas propriedades cumprem a Consulta.
Cada componente pode estar ligado a modelos dos tipos Footprint, Simulation, PCB3D, Ibis e Signal Integrity. É possível ligar um componente a mais do que um modelo do mesmo tipo, mas apenas um modelo de cada tipo pode ser selecionado como Current Model do componente.
Sintaxe
HasModel(ModelType : String,ModelName : String,CurrentModelOnly : Boolean) : Boolean/Boolean_String
A cadeia ModelType especifica a propriedade Type de um modelo ligado e tem de ser uma das cadeias da seguinte lista:
-
'PCB3DLIB' - utilize esta cadeia para direcionar um modelo ligado cuja propriedade Type é PCB3D.
-
'PCBLIB' - utilize esta cadeia para direcionar um modelo ligado cuja propriedade Type é Footprint.
-
'IBIS' - utilize esta cadeia para direcionar um modelo ligado cuja propriedade Type é Ibis Model.
-
'SI' - utilize esta cadeia para direcionar um modelo ligado cuja propriedade Type é Signal Integrity.
-
'SIM' - utilize esta cadeia para direcionar um modelo ligado cuja propriedade Type é Simulation.
A cadeia ModelName especifica a propriedade Name de um Modelo ligado.
O parâmetro CurrentModelOnly especifica se o modelo ligado tem ou não de ser um Modelo Atual de cada componente. Quando for False, o modelo ligado não tem de ser um Modelo Atual (mas ainda assim pode sê-lo); quando for True, o modelo ligado tem de ser um Modelo Atual.
Exemplo de utilização
HasModel('PCBLIB','SOIC14',False)
HasModel('PCBLIB','SOIC14',False) = True
HasModel('PCBLIB','SOIC14',False) = 'True'
Devolve todos os componentes que estão ligados a um Modelo Footprint cuja propriedade Name é SOIC14; esse Modelo não tem de ser o Modelo Footprint Atual de cada componente (mas pode sê-lo).
HasModel('PCBLIB','DIP14',True)
HasModel('PCBLIB','DIP14',True) = True
HasModel('PCBLIB','DIP14',True) = 'True'
Devolve todos os componentes que estão ligados a um Modelo Footprint cuja propriedade Name é DIP14; esse Modelo tem de ser o Modelo Footprint Atual do componente.
HasModel('SI','RES1',False)
HasModel('SI','RES1',False) = True
HasModel('SI','RES1',False) = 'True'
Devolve todos os componentes que estão ligados a um Modelo Signal Integrity cuja propriedade Name é RES1; esse Modelo não tem de ser o Modelo Signal Integrity Atual de cada componente (mas pode sê-lo).
HasModel('SIM','RESISTOR',True)
HasModel('SIM','RESISTOR',True) = True
HasModel('SIM','RESISTOR',True) = 'True'
Devolve todos os componentes que estão ligados a um Modelo Simulation cuja propriedade Name é RESISTOR; esse Modelo tem de ser o Modelo Simulation Atual do componente.
Notas
-
Certifique-se de que o âmbito da pesquisa está definido para Components utilizando o campo Search in na caixa de diálogo File Libraries Search dialog.
-
Ao pesquisar componentes, todas as bibliotecas SchLib e IntLib - disponíveis ou ao longo de um caminho de pesquisa definido - serão analisadas.
-
Todos os resultados são apresentados na listagem Query Results no painel Components.
HasModelParameter
Resumo
Devolve cada componente que está ligado a (ou referencia) um modelo de domínio, que contém um objeto parâmetro cujas propriedades Parameter Name e Value cumprem a Consulta.
Cada componente pode estar ligado a modelos dos tipos Footprint, Simulation, PCB3D, Ibis e Signal Integrity. É possível ligar um componente a mais do que um modelo do mesmo tipo, mas apenas um modelo de cada tipo pode ser selecionado como Current Model do componente.
Sintaxe
HasModelParameter(Parameter Name : String,Value : String,CurrentModelOnly : Boolean) : Boolean/Boolean_String
O parâmetro CurrentModelOnly especifica se o modelo ligado (que contém um parâmetro compatível) tem ou não de ser um Modelo Atual de cada componente. Quando for False, o modelo ligado não tem de ser um Modelo Atual (mas ainda assim pode sê-lo); quando for True, o modelo ligado tem de ser um Modelo Atual.
Exemplo de utilização
HasModelParameter('Inductance A','1mH',False)
HasModelParameter('Inductance A','1mH',False) = True
HasModelParameter('Inductance A','1mH',False) = 'True'
Devolve todos os componentes que estão ligados a um modelo que contém um objeto parâmetro cuja propriedade Parameter Name é Inductance A, e cuja propriedade Value é 1mH. Esse modelo não tem de ser um Modelo Atual de cada componente (mas pode sê-lo).
HasModelParameter('Coupling Factor','0.999',True)
HasModelParameter('Coupling Factor','0.999',True) = True
HasModelParameter('Coupling Factor','0.999',True) = 'True'
Devolve todos os componentes que estão ligados a um modelo que contém um objeto parâmetro cuja propriedade Parameter Name é Coupling Factor, e cuja propriedade Value é 0.999. Esse modelo tem de ser um Modelo Atual do componente.
Notas
-
Certifique-se de que o âmbito da pesquisa está definido para Components utilizando o campo Search in na caixa de diálogo File Libraries Search dialog.
-
Ao pesquisar componentes, todas as bibliotecas SchLib e IntLib - disponíveis ou ao longo de um caminho de pesquisa definido - serão analisadas.
-
Todos os resultados são apresentados na listagem Query Results no painel Components.
LibReference
Resumo
Devolve todos os componentes cuja propriedade Library Reference cumpre a Consulta.
Sintaxe
LibReference : String
Exemplo de utilização
LibReference = 'LM833'
Devolve todos os componentes cuja propriedade Library Reference é LM833.
LibReference Like 'C*'
Devolve todos os componentes cuja propriedade Library Reference começa com C.
Notas
-
Certifique-se de que o âmbito da pesquisa está definido para Components utilizando o campo Search in na caixa de diálogo File Libraries Search dialog.
-
Ao pesquisar componentes, todas as bibliotecas SchLib e IntLib - disponíveis ou ao longo de um caminho de pesquisa definido - serão analisadas.
-
Todos os resultados são apresentados na listagem Query Results no painel Components.
PartCount
Resumo
Devolve todos os componentes cuja propriedade Part Count cumpre a Consulta.
Sintaxe
PartCount : Number
Exemplo de utilização
PartCount = 2
Devolve todos os componentes cujo Part Count é 2.
PartCount > 4
Devolve todos os componentes cujo Part Count é superior a 4 (ou seja, todos os componentes multi-partes que contêm mais de quatro subpartes).
Notas
-
Certifique-se de que o âmbito da pesquisa está definido para Components utilizando o campo Search in na caixa de diálogo File Libraries Search dialog.
-
Ao pesquisar componentes, todas as bibliotecas SchLib e IntLib - disponíveis ou ao longo de um caminho de pesquisa definido - serão analisadas.
-
Todos os resultados são apresentados na lista Query Results no painel Components.
PinCount
Resumo
Devolve todos os componentes cuja propriedade Pin Count cumpre a Query.
Sintaxe
PinCount : Number
Exemplo de utilização
PinCount = 2
Devolve todos os componentes cuja Pin Count é 2.
PinCount > 14
Devolve todos os componentes cuja Pin Count é superior a 14.
Notas
-
Certifique-se de que o âmbito da pesquisa está definido para Components utilizando o campo Search in na caixa de diálogo File Libraries Search.
-
Ao procurar componentes, serão analisadas todas as bibliotecas SchLib e IntLib — disponíveis ou ao longo de um caminho de pesquisa definido.
-
Todos os resultados são apresentados na lista Query Results no painel Components.
Todos
Description
Resumo
Devolve todos os componentes ou footprints cuja propriedade Description cumpre a Query.
Sintaxe
Description : String
Exemplo de utilização
Description = 'TTL-RS232 DRIVER'
Devolve todos os componentes ou footprints cuja propriedade Description é TTL-RS232 DRIVER.
Description Like '*RS485*'
Devolve todos os componentes ou footprints cuja propriedade Description inclui RS485.
Notas
-
As entidades devolvidas, Components ou Footprints, dependem do âmbito escolhido, definido através do campo Search in na caixa de diálogo File Libraries Search.
-
Todos os resultados são apresentados na lista Query Results no painel Components.
HasParameter
Resumo
Devolve todos os componentes que contêm um objeto de parâmetro cujas propriedades Parameter Name e Value cumprem a Query.
Sintaxe
HasParameter(Parameter Name : String,Value : String) : Boolean/Boolean_String
Exemplo de utilização
HasParameter('Comment','1K')
HasParameter('Comment','1K') = True
HasParameter('Comment','1K') = 'True'
Devolve todos os componentes que contêm um objeto de parâmetro cuja propriedade Parameter Name é Comment e cuja propriedade Value é 1K.
Notas
-
As entidades devolvidas, Components ou Footprints, dependem do âmbito escolhido, definido através do campo Search in na caixa de diálogo File Libraries Search.
-
Todos os resultados são apresentados na lista Query Results no painel Components.
LibraryName
Resumo
Devolve todos os componentes ou footprints cujo nome da biblioteca principal cumpre a Query.
Sintaxe
LibraryName : String
Exemplo de utilização
LibraryName = 'Miscellaneous Devices.SchLib'
Devolve todos os componentes cuja biblioteca principal é Miscellaneous Devices.SchLib.
LibraryName Like 'Miscellaneous*.IntLib'
Devolve todos os componentes ou footprints cujo nome da biblioteca principal começa por Miscellaneous e termina em .IntLib.
LibraryName Like '*Vishay*'
Devolve todos os componentes cujo nome da biblioteca principal contém Vishay.
Notas
-
As entidades devolvidas, Components ou Footprints, dependem do âmbito escolhido, definido através do campo Search in na caixa de diálogo File Libraries Search.
-
Ao procurar componentes, serão analisadas todas as bibliotecas SchLib, IntLib e DbLib — disponíveis ou ao longo de um caminho de pesquisa definido. Ao procurar footprints, serão analisadas todas as bibliotecas PcbLib e IntLib.
-
Todos os resultados são apresentados na lista Query Results no painel Components.
LibraryPath
Resumo
Devolve todos os componentes ou footprints que se encontram na biblioteca especificada como parte da Query.
Sintaxe
LibraryPath : String
Exemplo de utilização
LibraryPath = 'C:\Documents\Altium\Library\MyExampleLibrary.SchLib'
Devolve todos os componentes cuja biblioteca principal é MyExampleLibrary.SchLib e em que essa biblioteca se encontra na pasta C:\Documents\Altium\Library.
LibraryPath Like ' C:\Documents\Altium\Library\Miscellaneous*.IntLib'
Devolve todos os componentes ou footprints cujo nome da biblioteca principal começa por Miscellaneous e termina em .IntLib, e em que essa biblioteca se encontra na pasta C:\Documents\Altium\Library.
LibraryPath = 'C:\Test Projects\Example DBLib\VishayCapacitor.DBLib'
Devolve todos os componentes cuja biblioteca principal é VishayCapacitor.DBLib e em que essa biblioteca se encontra na pasta C:\Test Projects\Example DBLib.
Notas
-
As entidades devolvidas, Components ou Footprints, dependem do âmbito escolhido, definido através do campo Search in na caixa de diálogo File Libraries Search.
-
Ao procurar componentes, serão analisadas todas as bibliotecas SchLib, IntLib e DbLib — disponíveis ao longo do caminho de biblioteca definido. Ao procurar footprints, serão analisadas todas as bibliotecas PcbLib e IntLib.
-
Todos os resultados são apresentados na lista Query Results no painel Components.
Name
Resumo
Devolve todos os componentes ou footprints cujo nome cumpre a Query.
Sintaxe
Name : String
Exemplo de utilização
Name = 'Res1'
Devolve todos os componentes ou footprints cujo nome é Res1.
Name Like 'DIP*'
Devolve todos os componentes ou footprints cujo nome começa por DIP.
Name Like '*33*'
Devolve todos os componentes ou footprints cujo nome contém 33.
Notas
-
As entidades devolvidas, Components ou Footprints, dependem do âmbito escolhido, definido através do campo Search in na caixa de diálogo File Libraries Search.
-
Ao procurar componentes, serão analisadas todas as bibliotecas SchLib e IntLib — disponíveis, ou ao longo de um caminho de pesquisa definido. Ao procurar footprints, serão analisadas todas as bibliotecas PcbLib e IntLib.
-
Todos os resultados são apresentados na lista Query Results, de volta ao painel Components.
-
O nome de um componente esquemático é verificado em relação à sua propriedade Design Item ID e o nome de um PCB Footprint é verificado em relação à sua propriedade Footprint .
SourceLibraryName
Resumo
Devolve todos os componentes ou footprints cujo nome da biblioteca de origem principal cumpre a Query.
Sintaxe
SourceLibraryName : String
Exemplo de utilização
SourceLibraryName = 'Miscellaneous Devices.SchLib'
Devolve todos os componentes cuja biblioteca de origem principal é Miscellaneous Devices.SchLib.
SourceLibraryName = 'Miscellaneous Devices.PcbLib '
Devolve todos os footprints cuja biblioteca de origem principal é Miscellaneous Devices.PcbLib.
Notas
-
As entidades devolvidas, Components ou Footprints, dependem do âmbito escolhido, definido através do campo Search in na caixa de diálogo File Libraries Search.
-
Ao procurar componentes, apenas serão analisadas as bibliotecas esquemáticas de origem — disponíveis ou ao longo de um caminho de pesquisa definido. Ao procurar footprints, apenas serão analisadas bibliotecas PCB.
-
Todos os resultados são apresentados na lista Query Results no painel Components.
SourceLibraryPath
Resumo
Devolve todos os componentes ou footprints que se encontram na biblioteca de origem especificada como parte da Query.
Sintaxe
SourceLibraryPath : String
Exemplo de utilização
SourceLibraryPath = ' C:\Documents\Altium\Library\MyExampleLibrary.SchLib'
Devolve todos os componentes cuja biblioteca de origem principal é MyExampleLibrary.SchLib e em que essa biblioteca se encontra na pasta C:\Documents\Altium\Library.
SourceLibraryPath = ' C:\Documents\Altium\Library\Miscellaneous Devices.PcbLib'
Devolve todos os footprints cuja biblioteca de origem principal é Miscellaneous Devices.PcbLib e em que essa biblioteca se encontra na pasta C:\Documents\Altium\Library.
SourceLibraryPath Like ' C:\Documents\Altium\Library\*'
Devolve todos os componentes ou footprints cuja biblioteca de origem principal se encontra na pasta C:\Documents\Altium\Library.
Notas
-
As entidades devolvidas, Components ou Footprints, dependem do âmbito escolhido, definido através do campo Search in na caixa de diálogo File Libraries Search.
-
Ao procurar componentes, apenas serão analisadas bibliotecas esquemáticas — disponíveis ao longo do caminho de biblioteca definido. Ao procurar footprints, apenas serão analisadas bibliotecas PCB.
-
Todos os resultados são apresentados na lista Query Results no painel Components.
Footprints
Height
Resumo
Devolve todos os footprints cuja propriedade Height cumpre a Query.
Sintaxe
Height : Number
Number seguirá as unidades de medida atualmente utilizadas para a biblioteca — Imperial (mil; 1 mil = 0,001 polegada) ou Métrico (mm; 1 mm = 0,001 metro).
Exemplo de utilização
Height = 300
Devolve todos os footprints que têm uma propriedade Height igual a 300 unidades de medida atuais.
Height >= 5.08
Devolve todos os footprints que têm uma propriedade Height superior ou igual a 5.08 unidades de medida atuais.
Height <> 550
Devolve todos os footprints que têm uma propriedade Height que é not igual a 550 unidades de medida atuais.
Notas
-
Certifique-se de que o âmbito da pesquisa está definido para Components utilizando o campo Search in na caixa de diálogo File Libraries Search.
-
Ao procurar footprints, serão analisadas todas as bibliotecas PcbLib e IntLib — disponíveis, ou ao longo de um caminho de pesquisa definido.
-
Todos os resultados são apresentados na lista Query Results no painel Components.
PadCount
Resumo
Devolve todos os footprints cuja propriedade Pad Count cumpre a Query.
Sintaxe
PadCount : Number
Exemplo de utilização
PadCount = 2
Devolve todos os footprints cuja Pad Count é 2.
PadCount > 14
Devolve todos os footprints cuja Pad Count é superior a 14.
Notas
-
Certifique-se de que o âmbito da pesquisa está definido para Components utilizando o campo Search in na caixa de diálogo File Libraries Search.
-
Ao procurar footprints, todas as bibliotecas PcbLib e IntLib - disponíveis ou ao longo de um caminho de pesquisa definido - serão pesquisadas.
-
Todos os resultados são apresentados na listagem Query Results no painel Components.
AI-localized