Referência de consultas de pesquisa

Num relance

Encontre o que você precisa nos projetos de hardware do seu Workspace com esta referência de sintaxe, operadores e convenções de pesquisa. De buscas simples por componentes a consultas precisas sobre redes, conectividade, objetos de PCB e propriedades de bibliotecas, este guia apresenta tarefas de pesquisa acompanhadas de exemplos de consultas que você pode usar como ponto de partida. Continue lendo para criar pesquisas mais direcionadas com confiança.

- Saiba como localizar componentes, redes, conexões e objetos de projeto usando a sintaxe 'campo:valor'.
- Refine as pesquisas com curingas, operadores lógicos, intervalos numéricos e filtros por camadas, documentos e grupos.
- Encontre exemplos de consultas para propriedades físicas e para identificar modelos de componentes ou recursos de biblioteca ausentes.
Aprofunde-se com a IA:

Este documento é um guia de referência para a sintaxe, os operadores e as convenções utilizados na linguagem de pesquisa de projetos de hardware do Workspace. As consultas de pesquisa baseiam-se em uma sintaxe field:value familiar e podem ser usadas tanto para realizar pesquisas rápidas e simples quanto para criar consultas poderosas e precisas.

Consulte Pesquisa avançada de projetos para obter informações relacionadas ao uso.

Sintaxe e guia de pesquisa

As informações de referência abaixo estão agrupadas por tipos de alvos de pesquisa (componentes, conexões etc.), e cada seção inclui subtipos de categorias de uso, exemplos de uso e as consultas de exemplo correspondentes.

Pesquisa de componentes

Use Category Application Example Query

Basics

Encontre um componente conhecido pelo seu designador.

R14

Encontre um componente de circuito integrado específico pelo designador. designator:U7

Encontre componentes pelo nome/comentário (ex.: ERJ-2RKF1002X ou "Capacitor 100nF +/-20% 50V 0402"]).

comment:ERJ-2RKF1002X

Encontre componentes pelo parâmetro de valor (ex.: 100nF ou 4.7k).

value:100nF

Encontre componentes em um encapsulamento físico específico (ex.: QFN-48).

package:0402

Encontre componentes que utilizem um nome de footprint de PCB específico. footprint:RESC0402

Identifiers

Encontre componentes que sejam dispositivos de montagem em superfície (SMD).

mounting:smd

Encontre todos os componentes de tecnologia de montagem em furos passantes (THT).

mounting:tht

Types

Encontre todos os componentes passivos (resistores, capacitores, indutores).

type:passive

Encontre todos os componentes ativos (circuitos integrados, transistores, diodos).

type:active

Encontre todos os componentes classificados como conectores.

type:connector

Connections Encontre componentes que contenham um nome ou número de pino específico. pin:SCLK
Encontre componentes que contenham pinos com uma direção especificada (ex.: entrada, saída, E/S etc.). Também encontra portas com a direção especificada. direction:output

Parametric

Encontre componentes com uma propriedade ou um parâmetro específico (ex.: tolerância) de qualquer valor.

has:tolerance

Encontre componentes em que um parâmetro tenha um valor específico.

tolerance:1%

Encontre componentes em que um parâmetro numérico esteja dentro de um intervalo. Filtro. Observe que nomes de parâmetros com espaços devem estar entre aspas.

"Voltage Rating":[3V to 5.5V]

Encontre componentes na camada superior com um parâmetro de potência nominal específico. Filtro

power:63mW layer:Top

Pesquisa de redes

Use Category Application Example Query
Basics Encontre uma rede conhecida pelo nome. GND
Encontre uma rede de alimentação específica pelo nome (ex.: VCC, GND, VSENSE). net:VCC3
Classes Encontre todas as redes que pertençam a uma classe de redes. netclass:analog
Encontre as redes de um par diferencial específico. diffpair:USB_SYS
Encontre todos os pares de redes na classe de pares diferenciais. diffpairclass:USB

Conectividade

Use Category Application Example Query

Simple Search

Encontre o componente U3 e tudo o que está conectado a ele. Os caminhos de conexão lógica também são exibidos, ignorando os dispositivos passivos entre dispositivos ativos (ex.: resistores de terminação e capacitores de acoplamento).

connectsTo:U3

Encontre a rede 'SYS_CLK' e tudo o que está conectado a ela.

connectsTo:SYS_CLK

Advanced Search

Encontre o componente U3 e tudo o que está diretamente conectado a ele. Somente conexões físicas (na mesma rede) são exibidas — as conexões lógicas entre dispositivos ativos não são incluídas. connectsTo.Direct:U3
Encontre o componente U3 e suas conexões físicas e lógicas, mas exclua as conexões aos barramentos de alimentação. connectsTo.noPower:U3
Encontre o componente U3 e suas conexões físicas (na mesma rede), mas exclua as conexões aos barramentos de alimentação. ConnectsTo.Direct:U3 ConnectsTo.NoPower:U3
Encontre a rede específica conectada ao pino 5 do componente U12. connectsTo:U12.5
Encontre a rede específica conectada à entrada 'D_CLK' do componente U12. connectsTo:U12.D_CLK

Encontre redes do barramento CAN em camadas específicas da PCB (ex.: L3 e inferior). Filtro

net:can* layer:Bottom layer:L3

Objetos de projeto

Use Category Application Example Query

General Types

Encontre objetos de um tipo específico [ex.: pad, via, trilha].

object:pad

Encontre objetos específicos em uma determinada rede (ex.: vias na rede de terra). Filtro object:via net:GND
Advanced Encontre trilhas nas camadas internas da PCB (ou seja, não nas camadas superior ou inferior). Filtro

object:track -layer:Top -layer:Bottom

Encontre todos os pinos designados como saídas. Filtro direction:output object:pin
Encontre todos os pads com formato retangular. Filtro object:pad shape:rectangle

Filtros lógicos e de intervalo

Use Category Application Example Query
Wildcards Encontre todas as redes cujo nome inclua vários caracteres após 'VCC' (ex.: VCC1, VCC_Digital, VCC_Analog). net:VCC*
Encontre todos os componentes cujos designadores incluam um único caractere após 'C1' (ou seja, capacitores C11 a C19). C1?
Logic Combinations Encontre capacitores na camada superior. Observe que um espaço entre expressões de pesquisa representa um AND implícito. type:Capacitor AND layer:Top
Encontre componentes que utilizem o encapsulamento 0402 ou 0603. Observe que uma expressão lógica OR deve estar entre parênteses quando usada com a lógica AND. package:0402 OR package:0603
Mostre todas as conexões com U1, mas não inclua aquelas com a camada GND. Observe que o caractere '-' equivale ao qualificador lógico 'NOT' (-term:value). connectsto:U1 NOT Layer:GND
Parentheses Logic Encontre componentes que utilizem o encapsulamento 0402 ou 0603. package:(0402 OR 0603)
Encontre trilhas nas camadas internas da PCB (ou seja, não nas camadas superior ou inferior). object:track -layer:(Top or Bottom)
Ranges Encontre trilhas de PCB com comprimento maior que o especificado. Observe que o caractere '>' substitui os dois-pontos do termo. object:Track tracklength>100mm
Encontre pads de PCB com diâmetros de furo maiores ou iguais ao diâmetro especificado. object:Pad holesize>=0.6mm
Encontre resistores com valor dentro de um intervalo especificado. Observe o uso de colchetes. R* Value:[100k to 200k]
Encontre redes de PCB com comprimentos de 1mm a 1.5mm. Inclui conexões (pads, vias, pinos etc.). NetLength:[1mm to 1.5mm]

Pesquisa hierárquica e por agrupamento

Use Category Application Example Query

Logical Groups

Encontre todos os componentes na classe de componentes 'DecouplingCaps'.

componentClass:DecouplingCaps

Encontre todas as redes pertencentes à classe de redes 'DDR_DATA'.

netClass:DDR_DATA

Physical Groups

Encontre todas as entidades em uma camada especificada da PCB (ex.: Mid 3).

layer:"Mid 3"

Encontre todos os componentes dentro da região (room) 'RF_Shield' na PCB.

room:RF_Shield

Projeto físico

Use Category Application Example Query

Physical Properties

Encontre redes de alta velocidade com trilhas de comprimento superior a 50mm. Filtro

netClass:HighSpeed netlength>50mm

Mostre trilhas da placa com largura superior a 10 mil. Filtro

object:track trackwidth>10mil

Encontre vias com diâmetro de furação inferior a 8 mil. Filtro

object:via holesize<8mil

Pesquisas de documentos

Use Category Application Example Query

Document Objects

Encontre todos os objetos em um documento de PCB do projeto (ex.: 'Module1'). document:module1.pcbdoc
Encontre todos os objetos no documento esquemático 'Power'. sheet:power.schdoc
Encontre resistores em um esquemático especificado. Filtro sheet:power.schdoc type:resistor

Gerenciamento de bibliotecas

Use Category Application Example Query

Status

Encontre todos os componentes que tenham um footprint de PCB, mas não tenham modelo 3D. Filtro

has:footprint -has:model3d

Encontre qualquer componente que não tenha um modelo de simulação.

-has:simulation_model

Parts Source Encontre componentes utilizados provenientes de uma fonte de biblioteca específica (ex.: Workspace, estoque interno de peças, project.IntLib). Library_Path:"Company Stock"
AI-LocalizedLocalizado por IA
Caso encontre um problema, selecione o texto/imagem e primaCtrl + Enterpara nos enviar o seu feedback.
Contents
Disponibilidade de Recursos

Os recursos disponíveis para você dependem de qual solução Altium você possui – Altium Develop, Altium Agile Teams, Altium Agile Enterprise ou Altium Designer (com assinatura ativa).

Se você não vir um recurso documentado no software que está usando no momento, entre em contato com a equipe de vendas da Altium para saber mais.

Contents