Referência de consultas de pesquisa
Num relance
- 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.
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. |
|
| 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"]). |
|
|
Encontre componentes pelo parâmetro de valor (ex.: 100nF ou 4.7k). |
|
|
Encontre componentes em um encapsulamento físico específico (ex.: QFN-48). |
|
|
| 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). |
|
Encontre todos os componentes de tecnologia de montagem em furos passantes (THT). |
|
|
Types |
Encontre todos os componentes passivos (resistores, capacitores, indutores). |
|
Encontre todos os componentes ativos (circuitos integrados, transistores, diodos). |
|
|
Encontre todos os componentes classificados como conectores. |
|
|
| 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. |
|
Encontre componentes em que um parâmetro tenha um valor específico. |
|
|
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. |
|
|
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). |
|
Encontre a rede 'SYS_CLK' e tudo o que está conectado a ela. |
|
|
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 |
|
Objetos de projeto
| Use Category | Application Example | Query |
|---|---|---|
General Types |
Encontre objetos de um tipo específico [ex.: pad, via, trilha]. |
|
| 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 |
|
| 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'. |
|
Encontre todas as redes pertencentes à classe de redes 'DDR_DATA'. |
|
|
Physical Groups |
Encontre todas as entidades em uma camada especificada da PCB (ex.: Mid 3). |
|
Encontre todos os componentes dentro da região (room) 'RF_Shield' na PCB. |
|
Projeto físico
| Use Category | Application Example | Query |
|---|---|---|
Physical Properties |
Encontre redes de alta velocidade com trilhas de comprimento superior a 50mm. Filtro |
|
Mostre trilhas da placa com largura superior a 10 mil. Filtro |
|
|
Encontre vias com diâmetro de furação inferior a 8 mil. Filtro |
|
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 |
|
Encontre qualquer componente que não tenha um modelo de simulação. |
|
|
| 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" |