Trabalhando com Parâmetros de Objetos de Projeto

Os parâmetros são usados em objetos, documentos e projetos para acrescentar informações detalhadas ao projeto. Um componente é mostrado na imagem acima.

Os parâmetros são adicionados ou incluídos automaticamente como propriedades do objeto pai e não são posicionados de forma independente como uma string de texto. Os tipos de parâmetros disponíveis podem ser agrupados, de modo geral, em parâmetros do sistema e do usuário, sendo estes últimos adicionados manualmente.

Parâmetros de identificação e do sistema

Os objetos posicionados em um esquemático incluem automaticamente um conjunto de parâmetros essenciais do sistema. Eles fornecem as informações básicas do objeto usadas pelo sistema para distinguir o nome, o tipo e a fonte de dados do objeto pai. Os parâmetros inerentes do sistema para objetos incluem, entre outros, as propriedades Comment, Description e Design Item ID (Referência da biblioteca). Os parâmetros do sistema dos objetos podem ser acessados na seção General do painel Propriedades (na aba General) quando um objeto pai é selecionado (). Quando visível e selecionado na área de projeto, um parâmetro individual pode ser acessado pelo modo correspondente do painel Propriedades, conforme descrito abaixo().

Parâmetros do usuário

É possível adicionar parâmetros a qualquer um dos seguintes objetos de projeto.

Os parâmetros do usuário estão disponíveis na região Parameters do painel Properties ou da caixa de diálogo modal quando o objeto pai está selecionado. Os parâmetros podem ser adicionados e editados. As exceções são os parâmetros do projeto (pela caixa de diálogo Opções do projeto) e os parâmetros dos pinos do componente (por meio de Propriedades do pino ou da visualização modal da Pin caixa de diálogo). Quando visível e selecionado na área de projeto, um parâmetro individual pode ser acessado pelo modo correspondente do painel Propriedades ou da caixa de diálogo modal, conforme descrito abaixo.

Primeiro: parâmetros do usuário de um componente no painel Properties (região Parameters). Segundo: um parâmetro individual do sistema no painel Properties.

Edição gráfica

As strings de parâmetros visíveis podem ser editadas graficamente diretamente na área de projeto.

Clique e arraste um parâmetro para reposicioná-lo. Para editar a string do parâmetro no próprio local:

1. Arraste o cursor do mouse ao redor do objeto de parâmetro mantendo o botão do mouse pressionado.

2. Após ser selecionado, o objeto será destacado por uma borda verde.

3. Selecione Enter para começar a editar o texto.

4. Após concluir a edição, pressione Enter novamente ou clique fora da string para sair do modo de edição no próprio local.

Uma string de parâmetro pode ser selecionada e editada diretamente na área de projeto. Selecione a string inteira para substituí-la ao digitar.

Os parâmetros visíveis e selecionáveis na área de projeto podem ser arrastados para um novo local e girados durante o processo. Clique e arraste a string do parâmetro, use as teclas Spacebar e Shift+Spacebar para girá-la em incrementos de 90° e, em seguida, clique para confirmar a nova posição/orientação.

Consulte Posicionamento de strings de parâmetros abaixo para obter informações sobre Autopositioning dos parâmetros de componentes e as opções relacionadas do painel Properties.

Parâmetros bloqueados

Um parâmetro que seja filho de uma Peça de componente pode ser bloqueado, o que significa que suas strings Name e Value não podem ser editadas. Isso pode ser feito:

• alternando o ícone de cadeado () associado à sua entrada na região Parameters do painel Properties ou da caixa de diálogo modal do objeto pai, ou

• marcando a opção Lock Parameter no painel Propriedades quando o parâmetro estiver diretamente selecionado na área de projeto.

Uma vez bloqueada, a string do parâmetro não pode ser editada no painel Properties, na caixa de diálogo modal (em Parameters para o objeto pai) nem no espaço de projeto usando a edição no local.

Parâmetros de componentes

Os parâmetros de componentes, os parâmetros de esquemático mais evidentes e usados com maior frequência, incluem conjuntos adicionais de parâmetros e recursos dedicados que ampliam a capacidade de definir objetos de componente.  

Definição de parâmetros na biblioteca de esquemáticos

Os parâmetros filhos de um objeto de componente pai podem ser definidos na biblioteca de origem do componente antes de suao inserção em um esquemático. O painel Properties é usado para editar e adicionar parâmetros a uma entrada de componente no editor de bibliotecas de esquemáticos, da mesma maneira que ao trabalhar com parâmetros no editor de esquemáticos.

Com um documento de biblioteca de componentes de esquemático aberto, selecione uma entrada de componente no painel Biblioteca SCH para acessar as propriedades de seus parâmetros no painel Properties.

Acesse as propriedades de um componente da biblioteca selecionando sua entrada no painel SCH Library.

O designador e o comentário de um componente da biblioteca não ficam visíveis por padrão no espaço de projeto do editor de bibliotecas de esquemáticos, mas podem ser exibidos marcando a opção Show Comment/Designator no modo Opções da biblioteca do painel Propriedades (Tools » Document Options) – disponível quando nenhum objeto está selecionado no espaço de projeto.

Os parâmetros pertencentes a um componente da biblioteca são definidos e editados usando o mesmo processo aplicado aos componentes inseridos no esquemático. A tecla Tab pode ser usada para criar ou editar parâmetros durante a inserção de um objeto no espaço de projeto. Os parâmetros são acessados pelo painel Properties ou pela caixa de diálogo modal, onde os parâmetros básicos do sistema estão disponíveis na aba General do painel, e os parâmetros do usuário são adicionados/editados no menu suspenso Parameters do painel.

O parâmetro Designador

No editor de bibliotecas de esquemáticos, o parâmetro Designator de um componente normalmente recebe um prefixo adequado seguido de um ponto de interrogação. Quando o componente é inserido em um esquemático a partir da biblioteca, o ponto de interrogação é detectado pela ferramenta de anotação do editor de esquemáticos e substituído por um sufixo numérico adequado durante a anotação do projeto.

O editor de esquemáticos também inclui um recurso simples de incremento automático do designador, que pode ser usado durante a inserção de várias instâncias da mesma peça. Para usá-lo, pressione Tab enquanto o primeiro componente estiver flutuando no cursor para pausar a inserção e, em seguida, insira um designador adequado no painel Properties; por exemplo, R1. Os componentes subsequentes receberão então os designadores R2, R3 etc. 

Ao inserir componentes com várias partes e atribuir o designador inicial dessa maneira, um sufixo de parte será adicionado automaticamente, por exemplo, U3A, U3B etc. Se o designador inicial não for atribuído, todas as partes terão o mesmo sufixo. Isso pode ser resolvido pelo recurso de anotação do editor de esquemáticos. O sufixo de parte pode ser alfabético ou numérico, conforme especificado pela opção Alpha Numeric Suffix na página Esquemático - Geral da caixa de diálogo Preferences.

Posicionamento da string do parâmetro

O comportamento padrão da string de um parâmetro de componente é posicioná-la automaticamente (ou seja, manter a orientação) quando um componente é girado durante ou após a inserção. Se esse comportamento não for necessário, desative a opção Autoposition para a entrada do parâmetro do componente na região Parameters do painel Properties. Para acessar a opção, selecione o parâmetro na lista e clique em Other. Observe que, durante a inserção do componente, as teclas Spacebar e Shift+Spacebar são usadas para girá-lo. Um objeto de componente já inserido pode ser girado pelo menu Rotation na região Location do painel Properties ou selecionando o componente e pressionando Spacebar ou Shift+Spacebar.

Clique e arraste um parâmetro visível para reposicioná-lo manualmente no esquemático; as teclas de atalho padrão de orientação serão aplicadas. Se a opção Autoposition estiver desativada para esse parâmetro and a opção Mark Manual Parameters estiver ativada na página Esquemático - Edição gráfica da caixa de diálogo Preferences, os parâmetros movidos manualmente serão identificados por um ponto no canto inferior esquerdo de sua caixa de seleção.

Parâmetros de componentes para fins específicos

Os parâmetros de componentes para fins específicos estão disponíveis para criar links para URLs relacionadas ou documentação em arquivos. Para um componente selecionado, esses parâmetros são adicionados clicando em Add na região Parameters  do painel Properties e selecionando Link no menu suspenso, ou na aba Parameters para links de ajuda dedicados que são ativados usando a tecla F1.

Parâmetros de link

O recurso de links permite definir e apresentar links nomeados para qualquer quantidade de URLs ou documentos de referência.

Para adicionar um link de referência a um componente, selecione o componente no espaço de projeto e clique em Links na região Parameters do painel Properties. Selecione Link no menu suspenso Add na parte inferior da região Parameters . Insira o Name e o Value do link (URL de destino ou caminho do arquivo) na grade. O link poderá então ser acessado clicando com o botão direito do mouse no componente no espaço de projeto e selecionando o <name> do link no submenu References.

Os links de componentes, conforme apresentados no painel e no espaço de projeto, são baseados internamente em pares Nome/Valor no formato ComponentLinknDescription/ComponentLinknURL (em que n é o número do link na lista, com base na ordem de criação). Consulte a entrada do Editor de tabelas de parâmetros desse componente para ver mais detalhes.

O parâmetro HelpURL

Semelhante ao parâmetro de link, o parâmetro HelpURL permite definir um link de um componente para um documento externo, como um PDF, ou para a URL de uma página da web. Quando adicionado como parâmetro de componente, o link é ativado quando a tecla F1 é pressionada com o cursor sobre o componente na folha do esquemático ou quando o componente está selecionado no painel Libraries. Observe que essa ação substituirá a função normal da tecla F1, que abre a página relevante na documentação on-line da Altium.

O link de ajuda é adicionado como um parâmetro do usuário no painel Properties quando um componente está selecionado no espaço de projeto. Clique em Parameters na região Parameters do painel Properties e selecione Parameter no menu suspenso Add na parte inferior da região Parameters . Insira "HelpURL" como o Name do parâmetro e o caminho/URL de destino como o Valuedo parâmetro.

Ao especificar o valor do parâmetro, ele pode ser uma URL, um caminho absoluto para um documento ou apenas o nome do documento. Quando F1 é pressionado com o cursor sobre o objeto de componente posicionado, ou quando a opção References » Help é usada no menu do botão direito, uma busca pela referência de Ajuda é realizada da seguinte forma:

• Se um caminho for especificado, esse local será pesquisado primeiro.
• Se o documento não puder ser encontrado nesse local, ou se nenhum caminho for especificado, a pasta \Help da instalação do software será pesquisada.
• Se o destino for uma URL, a página da web será aberta no navegador interno do software ou em um navegador externo, dependendo do estado da opção Open internet links in external Web browser na página Sistema - Visualização da caixa de diálogo Preferences.

Indireção - Um parâmetro como valor de uma string

A maioria dos parâmetros de componentes pode ser exibida em uma folha de esquemático ativando o ícone de visibilidade () (quando disponível) no painel Properties. Os parâmetros de identificador e de sistema estão disponíveis na aba General do painel, e os parâmetros do usuário são acessados na região Parameters do painel.

Outros parâmetros, no entanto, como os parâmetros de documento e de projeto, não podem ser exibidos diretamente na folha de esquemático, mas podem ser inseridos em um objeto de texto padrão usando uma técnica conhecida como String Indirection. A indireção ocorre quando a entrada de Valor de um objeto de string é o nome de um parâmetro disponível (como um parâmetro de documento ou de projeto) precedido por um sinal de igual, por exemplo, =Title.

O software detecta automaticamente essas strings e procura um nome de parâmetro disponível que corresponda à entrada de valor do objeto de texto posicionado. O exemplo de Title é encontrado como um parâmetro de documento, fazendo com que a string de texto interprete e exiba o valor do parâmetro de título, por exemplo, MyDocument. Um nome de parâmetro pode ser associado ao valor de uma string de texto selecionada por meio da edição no próprio local (ou seja, digitando =Title) ou, como uma abordagem mais informativa, usando o menu suspenso Text no painel Propriedades para selecionar entre as strings de parâmetros disponíveis.

Strings especiais

As strings de parâmetros disponíveis como strings indiretas (veja acima) são conhecidas como special strings. O valor apresentado por essas strings é inferido dinamicamente a partir de modelos ou de dados do sistema e de origem. Assim, por exemplo, a string especial =Time detectará e mostrará a hora atual do sistema, e =DocumentName mostrará o nome do arquivo do documento de esquemático atual (por exemplo, MySchematic.SchDoc).

Há um grande número de strings especiais predefinidas disponíveis. Consulte a página Trabalhando com objetos de texto em um esquemático para saber mais sobre essas strings especiais. Qualquer parâmetro de documento ou de projeto definido pelo usuário também pode ser usado como uma string especial e ser associado por indireção a uma string de texto na folha de esquemático.

Os parâmetros têm uma hierarquia, o que significa que você pode criar um parâmetro com o mesmo nome em diferentes níveis do projeto, cada um com valores diferentes. Para um parâmetro de componente, o Altium Designer resolve isso da seguinte forma:

1. Parâmetro de componente (prioridade mais alta)

2. Variante

3. Documento de esquemático

4. Símbolo de folha (para ver o valor do parâmetro do símbolo de folha acima, selecione a aba Compiled na parte inferior da área de projeto)

5. Projeto

A maioria das opções e dos controles deste painel é simples e não exige explicações adicionais. Uma opção que exige explicação é descrita abaixo.

• Allow Synchronization with Database (somente na caixa de diálogo Preferences ) - habilite para sincronizar com o banco de dados. Esta opção é usada para controlar se o comentário pode ser atualizado. Por padrão, essas opções estão habilitadas para sempre permitir a sincronização com a biblioteca ou o banco de dados de origem. Você pode desabilitar esta opção para impedir que esse comentário seja incluído em um processo de atualização.

A maioria das opções e dos campos da caixa de diálogo é autoexplicativa. As explicações para os demais são apresentadas abaixo.

• Remove Columns - clique para remover colunas. Esta opção está disponível apenas para colunas com informações estáticas.

• Add Column - clique para adicionar uma coluna. A caixa de diálogo Add Parameter é aberta, permitindo definir o nome do parâmetro.

• Reset Column Order - clique para exibir as colunas em ordem alfabética.

• Accept Changes (Create ECO) - para aplicar essas alterações aos componentes, é necessário gerar uma ECO (Ordem de Alteração de Engenharia). Clique para abrir a caixa de diálogo Engineering Change Order. 

Menu do botão direito

• Revert - clique para desfazer as edições nas células selecionadas.

• Add - clique para adicionar informações à célula selecionada. Use o menu suspenso exibido para selecionar as informações desejadas.

• Rename Column - clique para abrir a caixa de diálogo Renomear parâmetro existente, na qual você pode renomear um parâmetro existente.

• Remove Columns - clique para excluir a coluna selecionada.

• Report - clique para abrir a caixa de diálogo Report Preview e gerar um relatório.

• Cross Probe - clique para realizar a sondagem cruzada do objeto selecionado. O objeto selecionado será destacado na folha do esquemático.

Notas

• Você pode arrastar e soltar colunas na área da grade para alterar a ordem de exibição das colunas. A nova ordem é salva no arquivo do projeto para que seja mantida quando a caixa de diálogo for acessada novamente.

• É possível impedir a atualização dos parâmetros das seguintes maneiras:

  • No nível de parâmetro de cada componente, habilite a opção Lock Parameter no modo Component do painel Properties (clique duas vezes em um componente para acessá-lo). A opção Allow Synchronization With Database também é usada para controlar se o comentário pode ser atualizado. Por padrão, essa opção está habilitada para sempre permitir a sincronização com a biblioteca/banco de dados de origem. Você pode desabilitar essa opção para impedir que o comentário seja incluído em um processo de atualização.
  • No nível de vínculo com o banco de dados — a área Field Mapping do documento de vínculo com o banco de dados correspondente (arquivo *.DbLink, *.DbLib ou *.SvnDbLib) inclui várias opções que controlam se os parâmetros podem ser atualizados, incluindo Update Values, Add to Design e Remove from Design.