Referência de consulta de pesquisa

Updated: June 02, 2026

Este documento é um guia de referência para a sintaxe, os operadores e as convenções usados na linguagem de busca de projeto de hardware do Workspace. As consultas de busca são baseadas em uma sintaxe field:value familiar e podem ser usadas tanto para realizar buscas rápidas e simples quanto para construir consultas poderosas e precisas.

Sintaxe e Guia de Busca

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

Busca de Componentes

Use Category	Application Example	Query
Basics	Encontre um componente conhecido pelo seu Designador.	`R14`
	Encontre um componente CI 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 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 usam um nome específico de footprint de PCB.	`footprint:RESC0402`
Identifiers	Encontre componentes que são dispositivos de montagem em superfície (SMD).	`mounting:smd`
Identifiers	Encontre todos os componentes Through-Hole Technology (THT).	`mounting:tht`
Types	Encontre todos os componentes passivos (resistores, capacitores, indutores).	`type:passive`
	Encontre todos os componentes ativos (CIs, 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`
Connections	Encontre componentes que contenham pinos com uma direção especificada. (ex.: entrada, saída, IO etc.). Também encontra Ports com a direção especificada.	`direction:output`
Parametric	Encontre componentes com uma propriedade ou 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 em uma faixa. Filtro. Observe que nomes de parâmetros com espaço devem estar entre aspas.	`"Voltage Rating":[3V to 5.5V]`
	Encontre componentes na camada Top com um parâmetro específico de potência nominal. Filtro	`power:63mW layer:Top`

Busca de Nets

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

Conectividade

Use Category	Application Example	Query
Simple Search	Encontre o componente U3 e tudo conectado a ele. Caminhos de conexão lógica também são mostrados, onde dispositivos passivos entre dispositivos ativos (ex.: resistores de terminação e capacitores de acoplamento) são ignorados.	`connectsTo:U3`
Simple Search	Encontre a net 'SYS_CLK' e tudo conectado a ela.	`connectsTo:SYS_CLK`
Advanced Search	Encontre o componente U3 e tudo diretamente conectado a ele. Apenas conexões físicas (mesma net) são mostradas – conexões lógicas entre dispositivos ativos não são incluídas.	`connectsTo.Direct:U3`
	Encontre o componente U3 e as conexões físicas e lógicas a ele, mas exclua conexões com trilhos de alimentação.	`connectsTo.noPower:U3`
	Encontre o componente U3 e as conexões físicas (mesma net) a ele, mas exclua conexões com trilhos de alimentação.	`ConnectsTo.Direct:U3 ConnectsTo.NoPower:U3`
	Encontre a net específica conectada ao pino 5 do componente U12.	`connectsTo:U12.5`
	Encontre a net específica conectada à entrada 'D_CLK' do componente U12.	`connectsTo:U12.D_CLK`
	Encontre nets do barramento CAN em camadas específicas da PCB (ex.: L3 e Bottom). 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, track].	`object:pad`
General Types	Encontre objetos específicos em uma determinada net (ex.: vias na net de terra). Filtro	`object:via net:GND`
Advanced	Encontre tracks (trilhas) em camadas intermediárias da PCB. (ou seja, não Top nem Bottom). 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`

Lógica & Filtros de Faixa

Use Category	Application Example	Query
Wildcards	Encontre todas as nets cujo nome inclua múltiplos caracteres após 'VCC' (ex.: VCC1, VCC_Digital, VCC_Analog).	`net:VCC*`
Wildcards	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 Top. Observe que um espaço entre expressões de busca implica um AND.	`type:Capacitor AND layer:Top`
	Encontre componentes usando encapsulamento 0402 ou 0603. Observe que uma expressão lógica OR deve ser colocada entre parênteses quando usada com lógica AND.	`package:0402 OR package:0603`
	Mostre todas as conexões com U1, mas não inclua as do plano GND. Observe que o caractere '-' é equivalente ao qualificador lógico 'NOT' (-term:value).	`connectsto:U1 NOT Layer:GND`
Parentheses Logic	Encontre componentes usando encapsulamento 0402 ou 0603.	`package:(0402 OR 0603)`
Parentheses Logic	Encontre tracks (trilhas) em camadas intermediárias da PCB. (ou seja, não Top nem Bottom).	`object:track -layer:(Top or Bottom)`
Ranges	Encontre tracks de PCB mais longas que um comprimento especificado. Observe que o caractere '>' substitui os dois-pontos do termo.	`object:Track tracklength>100mm`
	Encontre pads de PCB com diâmetro de furo maior que ou igual a um diâmetro especificado.	`object:Pad holesize>=0.6mm`
	Encontre resistores que tenham um valor dentro de uma faixa especificada. Observe o uso de colchetes.	`R* Value:[100k to 200k]`
	Encontre nets de PCB com comprimentos de 1 mm a 1,5 mm. Incluirá conexões (pads, vias, pinos etc.).	`NetLength:[1mm to 1.5mm]`

Busca Hierárquica & por Agrupamento

Use Category	Application Example	Query
Logical Groups	Encontre todos os componentes na classe de componentes 'DecouplingCaps'.	`componentClass:DecouplingCaps`
Logical Groups	Encontre todas as nets pertencentes à classe de nets 'DDR_DATA'.	`netClass:DDR_DATA`
Physical Groups	Encontre todas as entidades em uma camada específica da PCB (ex.: Mid 3).	`layer:"Mid 3"`
Physical Groups	Encontre todos os componentes dentro da room 'RF_Shield' na PCB.	`room:RF_Shield`

Projeto Físico

Use Category	Application Example	Query
Physical Properties	Encontre nets de alta velocidade com trilhas mais longas que 50 mm. Filtro	`netClass:HighSpeed netlength>50mm`
	Mostre trilhas (tracks) da placa com largura maior que 10 mil. Filtro	`object:track trackwidth>10mil`
	Encontre vias com tamanho de furo menor que 8 mil. Filtro	`object:via holesize<8mil`

Buscas em Documentos

Use Category	Application Example	Query
Document Objects	Encontre todos os objetos em um documento 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 footprint de PCB, mas não tenham modelo 3D. Filtro	`has:footprint -has:model3d`
Status	Encontre qualquer componente que não tenha modelo de simulação.	`-has:simulation_model`
Parts Source	Encontre componentes usados de uma fonte de biblioteca específica (ex.: Workspace, estoque interno de peças, project.IntLib).	`Library_Path:”Company Stock”.`

Versão para impressão

Localizado por IA

Caso encontre um problema, selecione o texto/imagem e primaCtrl + Enterpara nos enviar o seu feedback.