Parâmetro

Parent page: Objetos esquemáticos

Os parâmetros são utilizados para componentes (mostrados), documentos e projetos para adicionar informação detalhada ao desenho.

Resumo

Os parâmetros são cadeias de texto de uso geral que são objetos-filho de um objeto-pai, permitindo adicionar informação detalhada a esse objeto-pai. Por exemplo, os componentes esquemáticos fazem uma utilização extensiva de parâmetros. São usados para definir o Designator e o Comment, bem como as cadeias de parâmetros de uso geral que podem ser adicionadas para o definir completamente. Os parâmetros gerais de componentes podem ser usados para várias funções, incluindo detalhes do componente, como potência, tensão, etc., detalhes do fornecedor, incluindo o nome do fornecedor e o número de peça, detalhes do desenho do componente de biblioteca, como o número de revisão do símbolo, e detalhes de documentação, como um URL que liga a uma folha de dados do componente.

Os parâmetros podem ser definidos ao nível da folha esquemática (documento) e ao nível do projeto. Os parâmetros ao nível do documento são ideais para definir campos, como o título e o número do documento, e os parâmetros ao nível do projeto são ideais para definir campos como o autor do desenho ou o nome do projeto.

Disponibilidade

Os parâmetros são adicionados como uma propriedade do objeto-pai; não são colocados de forma independente como uma cadeia de texto. Os parâmetros podem ser adicionados a qualquer um dos seguintes objetos de desenho:

• Component - adicionar parâmetros definidos pelo utilizador na região Parameters da caixa de diálogo Component Properties ou da caixa de diálogo Library Component Properties se estiverem a ser adicionados durante a definição do componente no editor de bibliotecas esquemáticas. Os parâmetros Designator e Comment estão sempre presentes num objeto Component. Para aceder à caixa de diálogo, faça duplo clique num componente no editor esquemático ou faça duplo clique no nome do componente no painel Sch Library no editor de bibliotecas esquemáticas.
• Pin - no separador Parameters da caixa de diálogo Pin Properties.
• Port - no separador Parameters da caixa de diálogo Port Properties.
• Sheet Symbol - no separador Parameters da caixa de diálogo Sheet Symbol.
• Document - na caixa de diálogo Document Options (Project | Content | ). Os parâmetros são listados no separador Parameters da caixa de diálogo; vários parâmetros predefinidos são automaticamente incluídos numa nova folha esquemática.
• Project - na caixa de diálogo Options for Project (Project | Content | ). Os parâmetros são listados no separador Parameters da caixa de diálogo.

Edição gráfica

As cadeias visíveis podem ser editadas graficamente usando o que é conhecido como edição in-place. Para editar uma cadeia no local, clique uma vez para selecionar, faça uma pausa de um segundo e depois clique uma segunda vez para entrar no modo de edição.

 Clique uma vez para selecionar a cadeia.

 Faça uma pausa, e depois clique uma segunda vez para entrar no modo de edição no local.

O valor da cadeia do designador pode ser editado no local.

 Aqui a cadeia foi selecionada, pronta para escrever uma cadeia de substituição.

Quando a edição estiver concluída, prima Enter ou clique fora da cadeia para sair do modo de edição no local.

Edição através de um painel Inspector

Panel pages: SCH Inspector, SCHLIB Inspector

Um painel Inspector permite-lhe inspecionar e editar as propriedades de um ou mais objetos de desenho no documento ativo.

Parâmetros de componente

Os parâmetros de componente incluem o designador e o comentário, bem como quaisquer parâmetros definidos pelo utilizador.

Edição de parâmetros de componente no editor de bibliotecas esquemáticas

Por predefinição, o designador, o comentário e os parâmetros definidos pelo utilizador não são visíveis no editor de bibliotecas esquemáticas. São editados na caixa de diálogo Library Component Properties. Faça duplo clique no nome do Component no painel SCH Library ou clique no botão Edit para abrir a caixa de diálogo, como mostrado na imagem abaixo.

Faça duplo clique no nome do componente ou clique no botão Edit para abrir a caixa de diálogo e editar os parâmetros do componente no editor de bibliotecas.

Os parâmetros definidos pelo utilizador podem ser apresentados ativando a respetiva caixa de verificação Visible na caixa de diálogo Library Component Properties. Ao ativar esta opção, será apresentado o Value. do parâmetro. Para apresentar o nome do parâmetro, clique no botão Edit para abrir a caixa de diálogo Parameter Properties, onde a caixa de verificação Visible do campo Name pode ser ativada.

Em alternativa, as cadeias do designador e do comentário podem ser apresentadas no Editor de Bibliotecas Esquemáticas e depois editadas com duplo clique para alterar as respetivas propriedades. Para apresentar estas cadeias, clique em Tools | Options |

para abrir a caixa de diálogo Library Editor Workspace e depois ative a opção Always Show Comment/Designator, como mostrado na imagem abaixo. Esta definição é uma propriedade da Biblioteca Esquemática.

Ative a opção Always Show Comment/Designator para apresentar estas cadeias no Editor de Bibliotecas Esquemáticas.

Edição de parâmetros de componente no editor esquemático

Os parâmetros de componente podem ser definidos no Editor Esquemático enquanto o componente está a ser colocado ou depois de o componente ter sido colocado numa folha esquemática.

• Para definir o designador/comentário/parâmetro do utilizador durante a colocação do componente, prima a tecla Tab enquanto o componente estiver suspenso no cursor. A caixa de diálogo Properties for Schematic Component será aberta. Introduza a cadeia necessária para o designador/comentário/parâmetro definido pelo utilizador e depois clique em OK para fechar a caixa de diálogo e concluir a colocação do componente. Continue a colocar componentes ou prima Esc para terminar a colocação.
• Para definir o designador/comentário/parâmetro do utilizador após a colocação, faça duplo clique no componente colocado para abrir a caixa de diálogo Properties for Schematic Component, onde o designador/comentário/parâmetro do utilizador pode ser editado. Clique em OK para fechar a caixa de diálogo e confirmar a alteração.

Edição das propriedades de visualização dos parâmetros de componente

A aparência das cadeias do designador/comentário/parâmetro do utilizador, incluindo o tipo de letra, o tamanho e a cor, pode ser definida:

1. Como uma propriedade do símbolo, definindo as propriedades do designador/comentário/parâmetro do utilizador na caixa de diálogo Parameter Properties no Editor de Bibliotecas Esquemáticas. Isto requer que a cadeia do designador esteja visível, conforme descrito anteriormente.
2. Editando a cadeia do designador/comentário/parâmetro do utilizador do componente esquemático colocado - faça duplo clique no componente para editar as diferentes propriedades do parâmetro.

Ambas as abordagens abrem a caixa de diálogo Parameter Properties, como mostrado abaixo. Note que todas as propriedades do parâmetro podem ser editadas nesta caixa de diálogo.

O valor e a aparência da cadeia Designator podem ser editados na caixa de diálogo Parameter Properties.

Fixar a localização das cadeias de parâmetros

O comportamento predefinido de uma cadeia de parâmetro de componente é posicioná-la automaticamente à medida que um componente é rodado durante a colocação. Se este comportamento não for necessário, desative a opção Autoposition na caixa de diálogo Parameter Properties (consulte a imagem anterior), quer durante a criação do símbolo quer depois de o componente ter sido colocado numa folha esquemática. Note que, ao fazê-lo, este parâmetro passa a ser classificado como um manual parameter (ou seja, parâmetro posicionado manualmente). Os parâmetros manuais são identificados por um ponto no canto inferior esquerdo da respetiva caixa de seleção.

Parâmetros de componente de finalidade especial

Foram criados parâmetros de componente de finalidade especial para definir ligações de componentes para documentação relacionada. Estes incluem o par de parâmetros HelpURL e ComponentLink.

O parâmetro HelpURL

O parâmetro HelpURL permite-lhe definir uma ligação de um componente para um documento externo, como um PDF ou uma página web. A ligação é ativada quando prime F1 sobre o componente na folha esquemática ou quando esse componente é selecionado no painel Libraries. Utilizando este parâmetro, pode referenciar um PDF, um ficheiro de texto ou uma página HTML. Para utilizar esta funcionalidade, adicione o parâmetro HelpURL ao componente pretendido e defina o valor do parâmetro para o documento que pretende abrir.

Ao especificar o valor do parâmetro, pode incluir um caminho absoluto ou introduzir o nome do documento. Os exemplos seguintes são entradas válidas para o valor do parâmetro:

• C:\Design_Projects\Schematics\Modifications.txt
• From Idea to Manufacture - Driving a PCB Design through CircuitStudio.pdf
• www.circuitstudio.com

Quando F1 é premido com o cursor sobre o objeto colocado, é efetuada uma procura do documento da seguinte forma:

• Se for especificado um caminho, essa localização é pesquisada primeiro,
• Se o documento não puder ser encontrado nessa localização ou se não for especificado qualquer caminho, é pesquisada a pasta \Help da instalação do CircuitStudio,
• Se o documento não puder ser encontrado, é apresentado o tópico de ajuda predefinido para o objeto.

O par de parâmetros ComponentLink

Esta funcionalidade permite-lhe definir e apresentar ligações nomeadas para qualquer número de documentos de referência. Podem ser definidos vários pares de parâmetros ComponentLink. Para utilizar esta funcionalidade, adicione e configure os dois parâmetros para cada par ComponentLink da seguinte forma:

Primeiro parâmetro - utilizado para definir o documento de destino:

• Nome do parâmetro = ComponentLinknURL (onde n é qualquer valor inteiro)
• Valor do parâmetro = target document path\name

Segundo parâmetro - utilizado para definir a entrada que aparece no menu:

• Nome = ComponentLinknDescription (onde n é o mesmo valor inteiro usado no primeiro parâmetro)
• Valor = Entry to appear in the menu

Pode ser definido qualquer número de pares de parâmetros ComponentLink; cada par é associado por partilhar o mesmo valor para n.

Para aceder às ligações do componente, clique com o botão direito sobre a peça colocada na área de trabalho. A entrada da ligação aparecerá no submenu References.

Substituir o Valor de uma String por um Valor de Parâmetro

Os parâmetros de componente podem ser facilmente apresentados através da respetiva Visible caixa de verificação. Isto não acontece com os parâmetros de Documento ou de Projeto, que não podem ser apresentados diretamente na folha esquemática. Para apresentar estes parâmetros, é utilizada uma técnica conhecida como String Indirection. A Indireção de Strings é um sistema em que uma string de texto padrão é colocada na folha esquemática e, em vez de introduzir um valor de string, introduz-se o nome de um parâmetro de Documento ou de Projeto precedido por um sinal de igual, por exemplo =Title. O software deteta automaticamente essas strings e, em vez de apresentar o conteúdo da string de texto, como =Title, verifica os parâmetros de Documento e de Projeto e, se for encontrado um parâmetro chamado Title, é apresentado o valor do parâmetro Title.

As strings indiretas são conhecidas como Special Strings. Existe um grande número de strings especiais predefinidas, que são listadas abaixo. Qualquer parâmetro de documento ou de projeto definido pelo utilizador também pode ser considerado uma string especial e ser indirecionado para uma String de Texto na folha esquemática.

Strings Especiais Predefinidas do Esquemático

Seguem-se as strings especiais predefinidas disponíveis para utilização num documento esquemático. A maioria destas liga-se à informação de parâmetros predefinidos definida para o documento ativo no separador Parameters da caixa de diálogo Document Options (Project | Content | Document Options).

• =Address1 – apresenta o valor especificado para o parâmetro predefinido ao nível do documento Address1.
• =Address2 – apresenta o valor especificado para o parâmetro predefinido ao nível do documento Address2.
• =Address3 – apresenta o valor especificado para o parâmetro predefinido ao nível do documento Address3.
• =Address4 – apresenta o valor especificado para o parâmetro predefinido ao nível do documento Address4.
• =Application_BuildNumber – apresenta a versão e a compilação da instalação atual do CircuitStudio.
• =ApprovedBy – apresenta o valor especificado para o parâmetro predefinido ao nível do documento ApprovedBy.
• =Author – apresenta o valor especificado para o parâmetro predefinido ao nível do documento Author.
• =CheckedBy – apresenta o valor especificado para o parâmetro predefinido ao nível do documento CheckedBy.
• =CompanyName – apresenta o valor especificado para o parâmetro predefinido ao nível do documento CompanyName.
• =CurrentDate – a data atual, calculada automaticamente a partir das definições do sistema do utilizador e no formato dd/mm/yyyy, atualizada ao editar o esquemático ou ao atualizar/redesenhar. Exemplo: 10/12/2012.
• =CurrentTime – a hora atual, calculada automaticamente a partir das definições do sistema do utilizador e no formato h:mm:ss AM/PM, atualizada ao editar o esquemático ou ao atualizar/redesenhar. Exemplo: 2:39:47 PM.
• =Date – utilizada para apresentar informação de data estática. Apresenta o valor especificado para o parâmetro predefinido ao nível do documento Date. Ao contrário da string especial =CurrentDate, que é calculada automaticamente e apresentada num formato definido, pode introduzir informação de data estática em qualquer formato que pretenda.
• =DocumentFullPathAndName – utilizada para apresentar o caminho completo e o nome do documento no qual a string é colocada. Exemplo: C:\MyTestDesign\PSU.SchDoc.
• =DocumentName – utilizada para apresentar apenas o nome do ficheiro do esquemático (sem o caminho do ficheiro). Exemplo: PSU.SchDoc.
• =DocumentNumber – apresenta o valor especificado para o parâmetro predefinido ao nível do documento DocumentNumber. O parâmetro de origem também pode ser atualizado através da caixa de diálogo Sheet Numbering For Project ao utilizar o comando Tools | Annotation | Number Sheets.
• =DrawnBy – apresenta o valor especificado para o parâmetro predefinido ao nível do documento DrawnBy.
• =Engineer – apresenta o valor especificado para o parâmetro predefinido ao nível do documento Engineer.
• =ImagePath – apresenta o valor especificado para o parâmetro predefinido ao nível do documento ImagePath.
• =ModifiedDate – a marca temporal da data de modificação do esquemático, preenchida automaticamente. Exemplo: 10/12/2012.
• =Organization – apresenta o valor especificado para o parâmetro predefinido ao nível do documento Organization.
• =ProjectName – apresenta o nome real do projeto (incluindo a extensão). Por exemplo, para um projeto com o nome de ficheiro MyPCB.PrjPcb, esta string especial apresentará MyPCB.PrjPcb.
• =Revision – apresenta o valor especificado para o parâmetro predefinido ao nível do documento Revision.
• =Rule – apresenta o valor especificado para o parâmetro predefinido ao nível do documento Rule. O valor deste parâmetro será inicialmente Undefined Rule (aparecendo como * no esquemático). Faça duplo clique no valor do parâmetro para aceder à possibilidade de definir um tipo de regra e editar a(s) sua(s) restrição(ões).
• =SheetNumber – o número da folha do esquemático atual. Este valor é calculado ao utilizar o comando Tools | Annotate | Number Sheets. O número de folha atribuído na caixa de diálogo Sheet Numbering For Project será introduzido no valor do parâmetro predefinido ao nível do documento SheetNumber. A string especial, quando utilizada na vista do separador Editor da folha esquemática, obterá a sua informação a partir daqui.
• =SheetTotal – o total de folhas do projeto. Este valor é calculado ao utilizar o comando Tools | Annotate | Number Sheets. O total de folhas na caixa de diálogo Sheet Numbering For Project será introduzido no valor do parâmetro predefinido ao nível do documento SheetTotal. A string especial, quando utilizada na vista do separador Editor da folha esquemática, obterá a sua informação a partir daqui.
• =Time – utilizada para apresentar informação de hora estática. Apresenta o valor especificado para o parâmetro predefinido ao nível do documento Time. Ao contrário da string especial =CurrentTime, que é calculada automaticamente e apresentada num formato definido, pode introduzir informação de hora estática em qualquer formato que pretenda.
• =Title – apresenta o valor especificado para o parâmetro predefinido ao nível do documento Title.
• =VariantName - apresenta a variante a partir da qual a saída foi gerada. Isto segue a entrada da variante atual (Project | Project Actions | Current Variant). Se o desenho base for utilizado para gerar a saída, o valor será [No Variations].

Strings Especiais para utilização com Parâmetros de Componente

Estão disponíveis várias strings especiais adicionais (ou interpretações especiais de strings existentes) ao definir parâmetros de componente. Em cada caso, a string especial é introduzida como o value de um parâmetro.

• =CurrentFootprint – apresenta o nome da footprint atualmente atribuída ao componente, conforme definido na região Models da caixa de diálogo associada Component Properties.
• =Comment – apresenta o valor que aparece no campo Comment do componente, conforme definido na região Properties da caixa de diálogo associada Component Properties.
• =Description – apresenta o valor que aparece no campo Description do componente, conforme definido na região Properties da caixa de diálogo associada Component Properties.
• =[ParameterName] – apresenta o valor definido para um parâmetro de componente especificado. Introduza o nome real de um parâmetro de componente como nome da string especial; por exemplo, para um parâmetro de componente com o nome PowerRating, introduza =PowerRating. Ao definir a propriedade Comment de um componente, o campo pendente associado será preenchido com strings especiais para todos os parâmetros de componente existentes, o que permite a utilização rápida do valor de qualquer parâmetro definido para o Comment.