Criando e Definindo a Biblioteca de Banco de Dados

A espinha dorsal da funcionalidade de biblioteca de base de dados é o ficheiro de biblioteca de base de dados. Este apresenta-se em duas formas, consoante esteja a utilizar uma biblioteca de base de dados standard ou uma biblioteca de base de dados com controlo de versões:

• Standard Database Library - o ficheiro Database Library. Este ficheiro é criado e gerido utilizando o DatabaseLib Editor do Altium Designer. Este editor fica disponível quando o documento ativo na janela principal de design é um ficheiro *.DbLib.
• Version-Controlled Database Library - o ficheiro SVN Database Library. Este ficheiro é criado e gerido utilizando o SVNDatabaseLib Editor do Altium Designer. Este editor fica disponível quando o documento ativo na janela principal de design é um ficheiro *.SVNDbLib.

Exemplo de ficheiro DbLib, aberto no DatabaseLib Editor. Passe o cursor sobre a imagem para ver um exemplo de ficheiro SVNDbLib, aberto no SVNDatabaseLib Editor.

Crie um novo ficheiro destes tipos escolhendo o comando File » New » Library nos menus principais e selecionando a opção Database Library ou SVN Database Library na secção Database da caixa de diálogo New Library que é aberta.

Ligar a uma Base de Dados Externa

Os dados da tabela e do mapeamento só aparecerão na janela principal de visualização de um Editor depois de o ficheiro ativo Database Library/SVN Database Library ser ligado com sucesso à base de dados externa necessária. A ligação é definida utilizando os controlos fornecidos na secção Source of Connection.

Especificar a ligação à base de dados externa através de um ficheiro DbLib. Passe o cursor sobre a imagem para ver a ligação através de um ficheiro SVNDbLib.

É possível ligar qualquer base de dados que disponibilize suporte OLE DB. As opções fornecidas nesta secção utilizam cada uma uma cadeia de ligação OLE DB para estabelecer ligação à base de dados de destino. Algumas bases de dados podem não disponibilizar suporte OLE DB. No entanto, praticamente todos os Sistemas de Gestão de Bases de Dados atualmente utilizados podem ser acedidos através da interface Open Database Connectivity (ODBC). A funcionalidade de ligação à base de dados utiliza o fornecedor ODBC da Microsoft, o que permite a um ADO (ActiveX Data Object) ligar-se a qualquer fonte de dados ODBC. O resultado é que qualquer base de dados ODBC pode ser ligada. O fornecedor OLE DB para a base de dados ODBC é especificado como parte da cadeia de ligação.

A ligação também pode ser definida no separador Connection da caixa de diálogo Database Connection, acedida escolhendo o comando Tools » Database Connection nos menus principais, ou clicando no botão Advanced (à direita do botão Connect , na parte inferior da secção).

Ligação Rápida a Bases de Dados Access e Excel

A opção Select Database Type oferece um método expedito para criar uma cadeia de ligação quando a base de dados de destino foi criada com Microsoft Access ou Microsoft Excel. Utilizando esta opção, selecione o tipo de base de dados e depois procure e selecione o ficheiro de base de dados necessário. A cadeia de ligação correspondente será automaticamente composta e introduzida no campo da opção Use Connection String.

Criar uma Cadeia de Ligação

Se a base de dados da sua empresa não for baseada em Access nem em Excel, e pretender criar explicitamente a cadeia de ligação, ative a opção Use Connection String e depois clique no botão Build associado à direita. Surgirá a caixa de diálogo Data Link Properties.

Criar uma cadeia de ligação através da caixa de diálogo Data Link Properties.

A caixa de diálogo abre no separador Connection . O Microsoft Office <Version> Access Database Engine OLE DB Provider do fornecedor OLE DB está definido por predefinição no separador Provider da caixa de diálogo. Esta é a definição de fornecedor predefinida para novos ficheiros Database Library/SVN Database Library e também é utilizada para ligar a ficheiros de base de dados Access (*.mdb). Altere o fornecedor conforme necessário.

No separador Connection , introduza o nome (incluindo o caminho) da base de dados à qual pretende ligar-se.

Se a sua base de dados exigir permissões de início de sessão, introduza-as conforme necessário, juntamente com quaisquer outras definições avançadas disponíveis no separador Advanced da caixa de diálogo. O separador All fornece uma lista de resumo das opções de ligação definidas, bem como opções alargadas relacionadas com o fornecedor OLE DB escolhido. As opções podem ser modificadas conforme necessário a partir deste separador.

Depois de definidas as opções de ligação, pode verificar se a ligação foi bem-sucedida clicando no botão Test Connection (no separador Connection ). Uma ligação bem-sucedida produzirá uma caixa de diálogo de confirmação nesse sentido.

Especificar um ficheiro Data Link

Se a fonte de dados à qual pretende ligar-se estiver descrita utilizando um ficheiro Microsoft Data Link (*.udl), ative a terceira das opções de ligação - Use Data Link File - e clique no botão Browse associado para localizar o ficheiro necessário. Um ficheiro Data Link é essencialmente um repositório para uma cadeia de ligação.

Prosseguir com a Ligação

Depois de definir a ligação à base de dados externa, o texto do botão Connect ficará a negrito, assinalando que pode prosseguir com a ligação. Se os detalhes da ligação estiverem corretos, a informação de tabela e mapeamento da base de dados de destino será carregada para o ficheiro Database Library/SVN Database Library. O texto no botão Connect mudará para Connected e o botão ficará desativado.

Se existir um problema com os detalhes da ligação, por exemplo se uma cadeia de ligação tiver sido criada incorretamente ou se tiver sido introduzido um caminho incorreto, a ligação falhará e surgirá uma mensagem a alertá-lo desse facto. Verifique as definições da sua ligação e clique novamente no botão Connect .

Exemplos de assinalar falha de ligação numa biblioteca de base de dados.

Após a ligação inicial bem-sucedida e depois de guardar o ficheiro Database Library/SVN Database Library, a ligação será estabelecida automaticamente sempre que o ficheiro for aberto, desde que a localização e o nome do ficheiro da base de dados de destino não sejam alterados.

Especificar a Ligação ao Repositório de Controlo de Versões (Apenas SVNDbLib)

Com uma DbLib, as bibliotecas de símbolos e de modelos são armazenadas no seu disco rígido, ou noutro meio local/de rede. Lembre-se de que, para uma SVNDbLib, estas bibliotecas são armazenadas sob controlo de versões num repositório Subversion. Como parte do ficheiro SVNDbLib, tem de definir a ligação a este repositório. A ligação ao repositório SVN é definida no separador SVN Repository da caixa de diálogo Database Library Options (Tools » Options). Esta caixa de diálogo também pode ser acedida clicando no botão Options na secção Field Settings da vista do documento.

Exemplo de ligação a um repositório SVN baseado em ficheiros.

Listagem de Tabelas da Base de Dados

Depois de estabelecida com sucesso a ligação à base de dados externa, os dados de tabela e mapeamento serão carregados. O lado esquerdo do documento DbLib/SVNDbLib lista todas as tabelas existentes na base de dados ligada.

Tabelas existentes na base de dados ligada.

A opção Enable junto a cada entrada de tabela permite-lhe controlar se essa tabela fará ou não parte da biblioteca de base de dados resultante. Quando a biblioteca de base de dados é adicionada à lista de Available File-based Libraries para navegação no painel Components, cada tabela aparecerá como uma entidade de biblioteca separada. Assim, embora apenas uma biblioteca de base de dados seja adicionada em termos reais, na perspetiva do painel Components , é como se tivesse adicionado várias bibliotecas distintas. Para mais informações, consulte Searching for Components in File-based & Database Libraries.

À medida que clica numa entrada da tabela na lista, o respetivo ícone muda de  para , de modo a distingui-la como a tabela atualmente ativa. A tabela — com todos os seus dados — aparece no separador Table Browser do documento. Esta é uma vista editável da tabela e permite-lhe consultar rapidamente o seu conteúdo e editar o que for necessário, sem ter de abrir a própria base de dados externa.

Navegar numa tabela de origem na base de dados ligada.

Para ampliar a área do Table Browser (como mostrado na ilustração acima), recolha toda a área acima (definições de ligação e de campos) clicando no controlo , no canto superior direito da vista do documento. Clique em  para expandir. A tabela também suporta as funcionalidades habituais de agrupamento, ordenação e filtragem.

Especificar Critérios de Correspondência

Depois de um componente ser colocado a partir da base de dados externa, tem de existir alguma forma de manter a ligação entre esse componente colocado e o registo da base de dados cujas informações foram usadas para o criar. Em essência, os dois têm de ser correspondidos.

Quando um componente é colocado, a informação dos seus parâmetros é criada dinamicamente, usando os campos correspondentes no registo da base de dados. A ligação pós-colocação entre o componente esquemático e o registo da base de dados é estabelecida usando um ou mais destes parâmetros. A região Field Settings do documento permite-lhe definir os critérios de correspondência — quer uma pesquisa simples por chave única, quer uma correspondência mais avançada usando uma cláusula Where.

Controlar os critérios de correspondência pós-colocação.

Pesquisa por Chave Única

Se a opção Single key lookup estiver ativada (predefinição), os campos Database field e Part parameter ficam disponíveis. O primeiro lista todos os nomes de campo disponíveis (cabeçalhos de coluna) na tabela ativa da base de dados. Como os parâmetros de um componente esquemático são adicionados à medida que este é colocado, o campo Part parameter refletirá qualquer campo da base de dados que seja escolhido.

Normalmente, o campo de chave de pesquisa utilizado é algo que identifica exclusivamente cada componente na base de dados externa, como um Número de Peça. O campo de pesquisa escolhido é assinalado no separador Field Mappings do documento pela entrada Design Parameter, apresentada a cinzento.

Mapeamento de chave única por Número de Peça.

Ao usar a funcionalidade Update Parameters From Database numa fase posterior à colocação, a informação é lida a partir do parâmetro de chave escolhido nos componentes esquemáticos colocados e depois pesquisada no campo (chave) escolhido da base de dados — em todas as tabelas ativadas. Quando existe correspondência, a informação de outras células desse registo da tabela principal pode então ser transferida de volta para os parâmetros mapeados no componente esquemático.

Correspondência Avançada — a Cláusula Where

Embora a opção Single key lookup funcione bem se existir um número/ID de peça único para correspondência, não é tão eficaz quando a correspondência é feita por um parâmetro que não é único, como capacitância ou resistência. Neste caso, deve ser usada a cláusula Where mais avançada, permitindo-lhe especificar correspondência por múltiplas chaves para ligar o componente esquemático ao respetivo registo de origem na base de dados.

Na sua forma mais simples, a cláusula Where (escrita com sintaxe SQL) reflete as entradas escolhidas que definem a pesquisa por chave única. Por exemplo, se o Database field for escolhido como Part Number — a predefinição — o campo Part parameter será automaticamente definido também como Part Number, e a entrada para a cláusula Where será:

[Part Number] = '{Part Number}'

Os parênteses retos em torno do campo da base de dados (coluna da tabela) são caracteres de aspas, conforme especificado no separador Advanced da caixa de diálogo Database Connection dialog. Aceda a esta caixa de diálogo clicando no botão Advanced na região Source of Connection do documento, ou a partir do menu principal Tools .

O separador Advanced da caixa de diálogo Database Connection disponibiliza opções SQL adicionais para colocar entre aspas
tabelas, ou usar nomes de esquema de tabela, numa cláusula Where construída.

As chavetas especificam que a entrada referenciada é um parâmetro de projeto. As aspas simples são usadas para especificar que o parâmetro de projeto deve ser tratado como uma cadeia de caracteres, em vez de um número (sem aspas). A correspondência de tipos é muito importante, pois o SQL é sensível a tipos. O parâmetro de projeto deve ser do mesmo tipo que a coluna na base de dados.

Usando a sintaxe SQL padrão, a cláusula Where pode então ser expandida para corresponder usando múltiplas entradas Database field/Part parameter, por exemplo:

[Capacitance] = '{Capacitance}' AND [Tolerance] = {Tolerance} AND [Manufacturer] = '{Manufacturer}'

Neste caso, seria estabelecida ligação a um único registo na tabela relevante da base de dados, usando três parâmetros de projeto diferentes. Repare que a entrada do parâmetro de projeto Tolerance não está entre aspas. Isto significa que o tipo da coluna na tabela associada da base de dados é Number e não String.

Usando a sintaxe SQL padrão, pode tornar a cláusula Where tão simples ou tão complexa quanto pretender.

Mapear Campos da Base de Dados para Parâmetros de Projeto

Os parâmetros de projeto para um componente colocado a partir de uma biblioteca de base de dados são criados/adicionados no momento da colocação. Que parâmetros são efetivamente criados, e as opções usadas para atualizar a respetiva informação após a colocação — usando o comando Tools » Update Parameters From Database — são determinados pela informação de mapeamento e atualização especificada no ficheiro Database Library/SVN Database Library. Estas definições são efetuadas no separador Field Mappings da vista principal do documento.

Especifique as opções de mapeamento e atualização de parâmetros no separador Field Mappings do documento DbLib/SVNDbLib.

Mapeamento de Modelos e Parâmetros

As primeiras duas colunas (da esquerda) no separador Field Mappings são usadas para controlar que informação da base de dados será mapeada para os atributos, modelos e parâmetros do componente.

• Database Field Name - esta coluna lista todos os nomes de campos (colunas) na tabela atualmente ativa da base de dados.
• Design Parameter - esta coluna define como cada campo correspondente da base de dados deve ser usado. Isto pode ser para fornecer o símbolo de um componente ou o modelo de footprint (ficará entre parênteses retos), ou, se for para ser incluído como parâmetro do componente (estes não ficam entre parênteses).

O mapeamento inicial é efetuado automaticamente aquando da ligação à base de dados, com todos os campos da base de dados mapeados.

Atributos & Modelos

Se o nome do campo da base de dados for um dos seguintes nomes reservados, a entrada de mapeamento do atributo/modelo correspondente será automaticamente definida no campo Design Parameter:

• Description → [Description]
• Footprint Ref → [Footprint Ref]
• Footprint Path → [Footprint Path]
• Footprint Ref n → [Footprint Ref n]
• Footprint Path n → [Footprint Path n]

• Library Ref → [Library Ref]
• Library Path → [Library Path]
• Orcad Footprint → [Orcad Footprint]
• Orcad Library → [Orcad Library]

• PCB3D Ref → [PCB3D Ref]

• PCB3D Path → [PCB3D Path]

  • As referências a PCB3D dizem respeito ao visualizador 3D legado; estas não devem ser usadas em novos projetos. O motor 3D nativo do PCB Editor pode processar corpos de componentes e ficheiros de modelos 3D importados associados a footprints de componentes.
  • Os mapeamentos de modelos PCB3D podem ser definidos num ficheiro SVNDbLib; no entanto, o armazenamento de bibliotecas de modelos PCB3D no repositório Subversion não é suportado.
• Sim Description → [Sim Description]
• Sim Excluded Parts → [Sim Excluded Parts]
• Sim File → [Sim File]
• Sim Kind → [Sim Kind]
• Sim Model Name → [Sim Model Name]
• Sim Netlist → [Sim Netlist]
• Sim Parameters → [Sim Parameters]
• Sim Port Map → [Sim Port Map]
• Sim Spice Prefix → [Sim Spice Prefix]

• Sim SubKind → [Sim SubKind]

  Consulte Simulation Model Mapping abaixo para saber mais em detalhe sobre campos relacionados com modelos de simulação.
  Só pode ser definida uma ligação a modelo de simulação por componente numa base de dados externa. Normalmente, existirá apenas um único modelo de simulação ligado a um componente. Se pretender configurar múltiplas ligações a modelos de simulação, as restantes ligações terão de ser definidas e armazenadas com esse componente no ficheiro da biblioteca esquemática de origem.
  Os modelos de simulação ligados são suportados para uma biblioteca de base de dados sob controlo de versões (SVNDbLib); no entanto, o armazenamento de ficheiros de modelos de simulação no repositório Subversion não é suportado.

Estes mapeamentos definem a informação de atributos e modelos do componente. Quando o componente é colocado, o símbolo esquemático especificado pelo campo [Library Ref] do registo correspondente da base de dados será extraído da biblioteca esquemática especificada. Do mesmo modo, a informação do footprint PCB e do modelo de simulação armazenada no registo será adicionada ao componente como footprint ligado e modelos de simulação ligados, respetivamente.

A entrada [Library Ref] tem de existir na coluna Design Parameter e ser mapeada para o Database Field Name que especifica o símbolo esquemático, para que seja possível colocar um componente da Database Library/SVN Database Library num esquema. Se a tabela da base de dados contiver a referência do símbolo sob um Database Field Name diferente, por exemplo SCH Symbol, terá de definir manualmente a entrada Design Parameter associada a este campo como [Library Ref], utilizando a lista pendente disponível para essa célula.

Da mesma forma, se a informação de referência do modelo for introduzida na base de dados usando uma nomenclatura de campos diferente, terá de efetuar o mapeamento manualmente escolhendo a entrada Design Parameter apropriada ([Footprint Ref], [Footprint Ref n], [PCB3D Ref], [Sim Model Name], e assim por diante) na lista pendente, para cada campo, sucessivamente.

Para definir a informação de símbolo e de modelo de um componente no momento da colocação, são os campos de referência de símbolo e de modelo na base de dados que constituem as entidades de mapeamento cruciais
- certifique-se de que existe um símbolo e pelo menos uma referência de footprint PCB como parte do mapeamento definido.

Mapeamento do Modelo de Simulação

Esta secção aborda cada um dos campos da base de dados que podem ser adicionados a uma tabela de base de dados externa para definir a ligação ao modelo de simulação, que será criada aquando da colocação do componente.

• Sim Model Name – o nome do modelo que pretende utilizar. Depois de o componente ser colocado, esta informação aparecerá no campo Model Name da caixa de diálogo Sim Model.

  Ao mapear campos da base de dados para parâmetros de design no ficheiro DBLib, o campo Sim Model Name é análogo aos campos Footprint Ref, Library Ref, etc.
• Sim Description – uma descrição do modelo ligado. Esta informação é opcional e não afeta o funcionamento da ligação ao modelo de simulação.

• Sim File – um ficheiro de modelo específico no qual procurar o modelo de simulação especificado no campo Sim Model Name. Existem várias formas de este campo poder ser utilizado:

  • Pode introduzir um caminho absoluto para um ficheiro de modelo (por exemplo, C:\DbLibs\Switching Diodes\Libraries\JAS33.mdl). O modelo especificado no campo Sim Model Name será procurado dentro deste ficheiro e utilizado se for encontrado.
  • Pode introduzir um caminho relativo (relativamente ao ficheiro DbLib) para um ficheiro de modelo (por exemplo, Libraries\JAS33.mdl). O modelo especificado no campo Sim Model Name será procurado dentro deste ficheiro e utilizado se for encontrado.
  • Pode introduzir apenas o nome do ficheiro do modelo (por exemplo, JAS33.mdl). Os caminhos de pesquisa definidos como parte do ficheiro DbLib serão utilizados para localizar o primeiro ficheiro de modelo que corresponda ao nome especificado e que contenha uma correspondência para o modelo especificado no campo Sim Model Name.
  • Pode deixar o campo em branco. Os caminhos de pesquisa definidos como parte do ficheiro DbLib serão utilizados para localizar o primeiro ficheiro de modelo que contenha uma correspondência para o modelo especificado no campo Sim Model Name.
  Os caminhos de pesquisa são definidos para o ficheiro DbLib no separador Symbol & Model Search Paths da caixa de diálogo Database Library Options (Tools » Options).
• Sim Kind – a categoria principal do modelo ao qual está a ser feita a ligação.
• Sim SubKind – o tipo de modelo ao qual está a ser feita a ligação.

• Sim Netlist – a informação do modelo de netlist, de acordo com o tipo de modelo ao qual está a ser feita a ligação. Este campo torna-se especialmente importante se estiver a especificar o seu próprio modelo de netlist e tiver definido o campo Sim SubKind como Generic Editor, proporcionando-lhe mais controlo sobre a informação que é colocada na netlist.

  Este campo tem de ser definido e não pode ficar em branco; caso contrário, não será criada qualquer entrada para o modelo na netlist de simulação e a peça não será simulada quando colocada a partir da biblioteca de base de dados.
  Netlist Template Syntax

  Ao definir o Netlist Template, a informação introduzida deve estar de acordo com os requisitos do SPICE e com as regras de sintaxe descritas abaixo.

  Os caracteres introduzidos no modelo são escritos literalmente na netlist SPICE, com exceção dos seguintes caracteres especiais:

  %	sinal de percentagem
  @	arroba
  &	e comercial
  ?	ponto de interrogação
  ~	til
  #	cardinal

  Estes caracteres são traduzidos ao criar a netlist, conforme mostrado na tabela seguinte:

  Sintaxe no Netlist Template...	O Netlister substitui por...
  @<param>	Valor de <param>.  É gerado um erro se não existir um parâmetro com este nome ou se não lhe tiver sido atribuído qualquer valor.
  &<param>	Valor de <param>.  Não é gerado qualquer erro se o parâmetro não estiver definido.
  ?<param>s...s	Texto entre separadores s...s se <param> estiver definido.
  ?<param>s...ss...s	Texto entre os primeiros separadores s...s se <param> estiver definido; caso contrário, entre os segundos separadores s...s.
  ~<param>s...s	Texto entre separadores s...s se <param> NÃO estiver definido.
  ~<param>s...ss...s	Texto entre os primeiros separadores s...s se <param> NÃO estiver definido; caso contrário, entre os segundos separadores s...s.
  #<param>s...s	Texto entre separadores s...s se <param> estiver definido, mas ignora o resto do modelo se <param> NÃO estiver definido.
  #s...s	Texto entre separadores s...s se existir algum texto a introduzir na netlist XSpice a partir de entradas subsequentes no Netlist Template.
  %<pin id>	O nome da net à qual se liga a net do pino esquemático mapeado para <pin id>.
  %%	Um carácter percentagem literal.

  Na tabela acima,

  • s representa um carácter separador (, . ; / |).
  • <param> refere-se ao nome de um parâmetro.

  Se o nome do parâmetro contiver quaisquer caracteres não alfanuméricos, deve ser colocado entre aspas duplas. Por exemplo:

  @"DC Magnitude" - aqui são usadas aspas duplas porque o nome contém um espaço.
  &"Init_Cond" - aqui são usadas aspas duplas porque o nome contém um sublinhado.

  As aspas duplas também devem ser usadas quando quiser adicionar um prefixo alfanumérico ao nome de um parâmetro. Por exemplo:

  @"DESIGNATOR"A - a utilização de aspas duplas assegura que A é acrescentado ao designador do componente.

  Seguem-se exemplos das entradas de sintaxe de caracteres especiais na tabela anterior. Em cada caso é fornecida informação sobre a forma como a entrada de sintaxe é traduzida pelo Netlister.

  @"AC Phase"

  O nome do parâmetro AC Phase é colocado entre chavetas devido ao espaço. Isto será substituído na netlist pelo valor do parâmetro AC Phase. Se não existir um parâmetro com este nome, ou se o respetivo valor estiver em branco, será gerado um erro.

  &Area

  Se existir um parâmetro denominado Area e este tiver um valor, então esse valor será introduzido na netlist. Se o parâmetro não estiver definido (isto é, se não existir ou se não lhe tiver sido atribuído qualquer valor), então nada será escrito na netlist, mas não será gerado qualquer erro. Isto pode ser utilizado para parâmetros opcionais.

  ?IC|IC=@IC|

  Se o parâmetro denominado IC estiver definido, então o texto dentro dos separadores || será inserido na netlist. Por exemplo, se o parâmetro IC tiver o valor 0.5, então IC=0.5 será inserido na netlist em vez desta entrada. Se o parâmetro não estiver definido, então nada será inserido na netlist.

  ?IC/IC=@IC//IC=0/

  Isto é o mesmo que o exemplo anterior, exceto que, se o parâmetro IC não estiver definido, então IC=0 será inserido na netlist. Note também que foi utilizado um carácter separador diferente.

  ~VALUE/1k/

  Se um parâmetro denominado VALUE NÃO estiver definido, então o texto 1k será inserido na netlist.

  ~VALUE/1k//@VALUE/

  Isto é o mesmo que o exemplo anterior, exceto que, se o parâmetro VALUE estiver definido, então o respetivo valor de texto será inserido na netlist.

  #"AC Magnitude"|AC@"AC Magnitude"|@"AC Phase"

  Este exemplo pode ser visto no modelo de netlist predefinido para a fonte de tensão sinusoidal.

  Se o parâmetro AC Magnitude tiver sido definido, então o conteúdo dos separadores é avaliado e inserido na netlist. Todas as entradas seguintes na netlist são também avaliadas e introduzidas na netlist (neste caso @"AC Phase").

  Se, por exemplo, AC Magnitude=1 e AC Phase=0, então AC 1 0 será inserido na netlist. Se, no entanto, AC Phase não estiver definido, será gerado um erro.

  Se o parâmetro AC Magnitude não estiver definido, então nada do que se segue à entrada #"AC Magnitude" no modelo de netlist será introduzido na netlist.

  #|PARAMS:|?Resistance|Resistance=Resistance|?Current|Current=@Current|

  Este exemplo pode ser visto no modelo de netlist predefinido para um subcircuito parametrizado (ver F1 em Fuse.PrjPcb).

  Se os parâmetros Resistência e Corrente estiverem ambos indefinidos, então não haverá texto a inserir na netlist a seguir à entrada #|PARAMS:|, pelo que o texto nos separadores também será omitido.

  Se, por exemplo, os parâmetros tiverem os valores Resistance=1k e Current=5mA, isso resultará em texto a seguir à entrada #|PARAMS:| e PARAMS: Resistance=1k Current=5mA será a entrada criada na netlist.

  @DESIGNATOR%1%2@VALUE

  Este exemplo serve para demonstrar a utilização do caráter %.

  Se, por exemplo, os parâmetros tiverem os valores DESIGNATOR=R1 e VALUE=1k, e os pinos estiverem mapeados na região Pin Mapping da caixa de diálogo Sim Model de acordo com a tabela seguinte:

  Pino esquemático	Pino do modelo	Nome da net à qual o pino esquemático se liga
  1 (N+)	1 (1)	GND
  2 (N-)	2 (2)	OUT

  Então, o texto R1 GND OUT 1k será colocado na netlist SPICE para este componente.
• Sim Spice Prefix – o prefixo SPICE para o tipo de modelo ao qual está a ligar.

• Sim Port Map – o mapeamento dos pinos do componente esquemático para os pinos do modelo associado. Depois de o componente ser colocado, esta informação aparecerá na região Pin Mapping da caixa de diálogo Sim Model.

  Cada emparelhamento de pinos deve ser introduzido no seguinte formato:

  (SchematicPinNumber:ModelPinNumber),

  com cada emparelhamento mapeado separado por uma vírgula.

  Por exemplo, ao mapear um modelo de simulação de díodo em que o pino esquemático 1 (ânodo) tem de ser mapeado para o pino 1 do modelo (ânodo), e o pino esquemático 3 (cátodo) tem de ser mapeado para o pino 2 do modelo (cátodo), isto seria introduzido no campo da base de dados como:

  (1:1),(3:2)

• Sim Excluded Parts – crie este campo na base de dados se pretender excluir determinadas partes de um componente com várias partes da simulação. Esta informação corresponde à opção Exclude part from simulation na região Pin Mapping da caixa de diálogo Sim Model.

  Por predefinição, todas as partes de um componente com várias partes são incluídas numa simulação, pelo que só precisa de especificar os números das partes que pretende excluir. Separe várias partes na lista de exclusão com vírgulas. Por exemplo, se um componente tiver quatro partes e não pretender que as partes 2 e 4 sejam incluídas em qualquer simulação, então deve introduzir o seguinte no campo da base de dados:

  2,4

• Sim Parameters – crie este campo na base de dados se pretender atribuir valores aos parâmetros de simulação do modelo. Estes são parâmetros que podem ser definidos ao nível do componente, em oposição aos parâmetros mais avançados que podem ser incluídos num ficheiro de modelo.

  Um parâmetro tem de ser introduzido no seguinte formato:

  ParameterName=Value,

  Vários parâmetros devem ser separados pelo caráter pipe (|).

  Poderá lembrar-se de que um parâmetro de simulação ao nível do componente também pode ser definido como parâmetro do componente — aparecendo na região Parameters da caixa de diálogo Component Properties associada, com a possibilidade de ser depois apresentado na folha esquemática. Por predefinição, uma entrada de parâmetro no campo Sim Parameters será automaticamente adicionada como parâmetro do componente. Se não pretender que um parâmetro de simulação seja adicionado como parâmetro do componente, basta acrescentar um ponto de exclamação como prefixo ao nome do parâmetro (por exemplo, !Initial Voltage=100mV).

  Considere um modelo de díodo, que tem os quatro parâmetros seguintes ao nível do componente:

  • Fator de área
  • Condição inicial
  • Tensão inicial
  • Temperatura.

  Considere agora adicionar valores na base de dados para o Fator de área (por exemplo, 2) e a Temperatura (por exemplo, 22°C). Além disso, nenhum destes dois deve ser adicionado como parâmetro do componente. A entrada no campo Sim Parameters seria:

  !Area Factor=2|!Temperature=22

Parâmetros

Todos os outros nomes de campos da base de dados serão automaticamente mapeados para parâmetros de desenho com os mesmos nomes. Por exemplo, se um campo na base de dados se chamar Tolerance, será mapeado para ele um parâmetro de desenho com o nome Tolerance. Pode alterar o nome de um parâmetro de desenho clicando na respetiva célula e escrevendo diretamente o novo nome. São estes nomes de parâmetros de desenho que aparecerão na região Parameters da caixa de diálogo de propriedades associada ao componente, depois de este ter sido colocado numa folha esquemática.

Pode ter um grande número de campos de dados associados a um componente na base de dados, dos quais nem todos quererá, ou sequer precisará, de adicionar como parâmetros de desenho ao componente quando este for colocado numa folha esquemática. Grande parte desta informação poderá só ser necessária ao gerar uma Lista de Materiais. A caixa de diálogo Report Manager dialog permite-lhe adicionar informação de parâmetros a uma BOM, diretamente a partir de uma base de dados associada — permitindo-lhe reduzir a quantidade de informação que é “transportada” com os documentos-fonte esquemáticos. Para mais informação, consulte a secção Preparar uma BOM no Report Manager.

Para campos que explicitamente não pretenda mapear a partir da base de dados, defina a entrada Design Parameter como [None]. Os campos da base de dados não mapeados distinguem-se no separador pela utilização de um ícone de cruz vermelha (). Os campos da base de dados mapeados distinguem-se por um ícone de visto verde ().

Configure o mapeamento de parâmetros conforme necessário. Defina como [None] para impedir que um parâmetro na base de dados seja mapeado para o componente colocado. Os parâmetros não mapeados podem ser incluídos diretamente na BOM, se necessário.

Opções de atualização de parâmetros

As colunas restantes no separador Field Mappings permitem-lhe especificar as ações executadas para os parâmetros ao colocar um componente da biblioteca da base de dados pela primeira vez, ou ao atualizar um componente depois de este ter sido colocado usando o comando Tools » Update Parameters From Database.

As quatro colunas são as seguintes:

• Update Values - uma célula nesta coluna é usada para determinar a ação que deve ser executada se o parâmetro existir tanto numa folha esquemática como na base de dados, mas os valores forem atualmente diferentes. Pode optar por atualizar o parâmetro do componente colocado com o valor armazenado na base de dados (Update) ou por não o atualizar de todo (Do not update). Esta opção é respeitada ao usar o comando Update Parameters From Database, depois de o componente ser colocado.
• Add To Design - uma célula nesta coluna é usada para determinar a ação que deve ser executada se o parâmetro for encontrado na base de dados, mas não existir para o componente colocado. Pode optar por adicionar o parâmetro (Add), não adicionar o parâmetro (Do not add) ou adicionar o parâmetro apenas se lhe tiver sido atribuído um valor na base de dados (Add only if not blank in database). Esta opção é respeitada tanto ao colocar inicialmente o componente a partir da biblioteca da base de dados como ao usar o comando Update Parameters From Database, depois de o componente ter sido colocado.
• Visible On Add - uma caixa de verificação nesta coluna é usada para determinar se um parâmetro recém-adicionado, resultante da colocação inicial ou de uma atualização após a colocação, é tornado visível para o componente na folha esquemática (ativado) ou não (desativado).
• Remove From Design - uma célula nesta coluna é usada para determinar a ação que deve ser executada se se verificar que o parâmetro existe para o componente colocado, mas não está na base de dados ou, estando, não tem qualquer valor. Pode optar por não remover o parâmetro de todo (Do not remove) ou removê-lo apenas se não tiver qualquer valor atribuído na base de dados (Remove only if blank in database). Esta opção é respeitada ao usar o comando Update Parameters From Database, depois de o componente ter sido colocado.

Inicialmente, os campos Update Values, Add To Design e Remove From Design — para cada campo da base de dados mapeado — serão definidos com a entrada Default, e a opção Visible On Add estará desativada, como ilustrado na imagem seguinte.

Opções iniciais (predefinidas) de atualização de parâmetros.

Observando a imagem, há quatro pontos importantes a referir relativamente às opções de atualização:

1. Os campos da base de dados não mapeados não terão opções de atualização associadas.
2. Os mapeamentos baseados em Atributo e Modelo (entradas com parênteses retos na coluna Design Parameter) não terão opções de atualização associadas, uma vez que estes não são parâmetros de desenho.
3. O campo-chave (por exemplo, Part Number na imagem) não terá opções de atualização associadas. Este campo é usado exclusivamente para fins de correspondência de parâmetros.
4. Uma definição de Default faz com que uma opção de atualização siga a respetiva definição predefinida, tal como especificado no separador Default Actions da caixa de diálogo Database Library Options (Tools » Options a partir dos menus principais ou Options a partir do menu do botão direito do rato do separador Table Browser). Esta caixa de diálogo também pode ser acedida clicando no botão Options na região Field Settings da vista do documento.

Defina opções predefinidas de atualização de parâmetros numa localização central para uma DbLib. Passe o cursor sobre a imagem para ver o equivalente para uma SVNDbLib.

O quarto ponto é benéfico porque lhe permite especificar opções de atualização a partir de uma localização central e, depois, apontar para essa localização ao definir as opções de atualização para cada campo mapeado. É por isso que a entrada Default é carregada automaticamente nos campos de atualização relevantes ao mapear um campo da base de dados para um parâmetro de projeto.

Se pretender substituir a definição predefinida de uma opção de atualização, clique dentro do campo de atualização relevante, no separador Field Mappings, e depois clique novamente para aceder a uma lista pendente com as opções de atualização aplicáveis.

As opções de atualização de parâmetros podem ser substituídas manualmente, se necessário.

Desta forma, tem controlo total sobre como os parâmetros no projeto são atualizados. Pode definir todos os campos como Default e tomar as decisões de atualização necessárias na caixa de diálogo Database Library Options, definir cada campo de atualização individualmente, ou ter uma combinação de ambas as abordagens - a decisão é inteiramente sua, conforme considerar mais adequado. Para componentes colocados, a atualização, quando executada, é realizada através de uma caixa de diálogo Engineering Change Order. Se, nesta fase, existirem atualizações que prefira não efetuar, pode optar por não incluir essas alterações específicas - dando-lhe a palavra final, e definitiva, sobre quais os parâmetros do projeto que são atualizados.

Especificar Localizações das Bibliotecas de Símbolos e Modelos

Quando coloca um componente a partir de uma biblioteca de base de dados, o respetivo símbolo - especificado pelo mapeamento [Library Ref] - é extraído da biblioteca esquemática especificada (*.SchLib). Da mesma forma, quaisquer referências de modelo (footprint, PCB3D, simulação) especificadas na base de dados residirão em ficheiros subjacentes de PCB Library (*.PcbLib), PCB3D Library (*.PCB3DLib) e Simulation Model (*.mdl, *.ckt). Os caminhos para estes ficheiros podem ser especificados explicitamente na base de dados através de:

• Introduzir um caminho absoluto para o ficheiro.
• Introduzir um caminho relativo para o ficheiro.

Se tiver definido campos na sua base de dados para informação de caminho, esses campos precisam de ser mapeados para os parâmetros de projeto apropriados - [Library Path], [Footprint Path], [PCB3D Path], [Sim File], e assim por diante (consulte novamente Mapeamento de Modelos e Parâmetros).

Introduzir caminhos - mesmo relativos - numa tabela de base de dados pode ser algo restritivo. Se mover a localização de uma biblioteca ou de um ficheiro de modelo, terá de atualizar a tabela da base de dados em conformidade. Para lhe dar maior liberdade, tem a possibilidade de especificar informação de pesquisa de bibliotecas no próprio ficheiro DbLib/SVNDbLib. Isto permite-lhe especificar o nome da biblioteca de origem ou do ficheiro de modelo na base de dados, ou até não o definir de todo.

Para uma Database Library

Para uma DbLib, os caminhos de pesquisa de bibliotecas são definidos no separador Symbol and Model Search Paths da caixa de diálogo Database Library Options (Tools » Options). Esta caixa de diálogo também pode ser acedida clicando no botão Options na região Field Settings da vista do documento.

Especificar caminhos de pesquisa para bibliotecas de símbolos e modelos.

Para adicionar um caminho à lista:

1. Introduza diretamente o caminho no campo abaixo da região Library Search Paths, ou clique no botão para aceder à caixa de diálogo Browse for Folder, a partir da qual pode localizar a diretoria em que residem os ficheiros de biblioteca/modelo necessários.
2. Pode adicioná-lo quer como caminho completo, quer como caminho relativo (relativo à localização do ficheiro DbLib). Controle isto utilizando a opção Add/Update As Relative Path.
3. Depois de especificar o caminho necessário, adicione-o à lista de caminhos de pesquisa clicando no botão Add .
4. Continue a adicionar caminhos de pesquisa adicionais conforme necessário.

Os caminhos de pesquisa de bibliotecas determinam onde os ficheiros de biblioteca e de modelo podem ser encontrados ao colocar a partir da biblioteca da base de dados e ao procurar um modelo após a colocação. O modelo específico utilizado dependerá de como configurou os seus caminhos de pesquisa de bibliotecas e de ter ou não adicionado informação específica de biblioteca à sua base de dados. A pesquisa será efetuada pela seguinte ordem:

1. Se existir um caminho completo no campo de caminho mapeado para o símbolo ou modelo, utilize esse ficheiro de biblioteca/modelo e extraia o símbolo ou modelo especificado no campo de referência aplicável.
2. Se existir um caminho relativo no campo de caminho mapeado para o símbolo ou modelo, utilize esse ficheiro de biblioteca/modelo e extraia o símbolo ou modelo especificado no campo de referência aplicável.
3. Se no campo de caminho mapeado para o símbolo ou modelo existir apenas um nome de ficheiro de biblioteca/modelo, utilize os caminhos de pesquisa para localizar o primeiro ficheiro de biblioteca/modelo que corresponda ao nome especificado e que contenha uma correspondência para o símbolo ou modelo especificado no campo de referência aplicável.
4. Se não existir informação de ficheiro de biblioteca/modelo na base de dados, utilize os caminhos de pesquisa para localizar o primeiro ficheiro de biblioteca/modelo que contenha uma correspondência para o símbolo ou modelo especificado no campo de referência aplicável.

Para uma SVN Database Library

Para uma SVNDbLib, as diretorias base dentro do repositório Subversion - nas quais residem os símbolos e os modelos de footprint - são especificadas no separador SVN Repository da caixa de diálogo Database Library Options (Tools » Options). Esta caixa de diálogo também pode ser acedida clicando no botão Options na região Field Settings da vista do documento.

Especificar diretorias base do repositório para símbolos e footprints.

Utilize os campos disponíveis na região Models Location para especificar a diretoria base para os símbolos e footprints. Clique no botão , à direita de um campo, para aceder à caixa de diálogo Browse for directory - uma janela para o repositório ligado. Utilize esta caixa de diálogo para selecionar a pasta necessária.

Navegar para a diretoria relevante no repositório SVN ligado.

As localizações dos modelos determinam onde os ficheiros de biblioteca e de modelo podem ser encontrados ao colocar a partir da biblioteca de base de dados sob controlo de versões e ao procurar um modelo após a colocação. O símbolo esquemático específico e o(s) modelo(s) de footprint utilizado(s) dependerão de como configurou estas localizações e de ter ou não adicionado informação específica de biblioteca à sua base de dados. A pesquisa será efetuada pela seguinte ordem:

1. Se existir um caminho completo no campo de caminho mapeado para o símbolo ou modelo de footprint (por exemplo http://MyServer/svn/MyCompany/ParentDirectory/SchematicSymbols/Capacitor_NonPolarized.SchLib), utilize esse ficheiro de biblioteca e extraia o símbolo ou footprint especificado no campo de referência aplicável.
2. Se existir um caminho relativo (relativo à raiz do repositório) no campo de caminho mapeado para o símbolo ou modelo de footprint (por exemplo /ParentDirectory/SchematicSymbols/Capacitor_NonPolarized.SchLib), utilize esse ficheiro de biblioteca e extraia o símbolo ou footprint especificado no campo de referência aplicável. O URL do repositório - especificado na região Repository Server Connection da caixa de diálogo - será prefixado ao caminho que introduzir, para fornecer o endereço absoluto.
3. Se no campo de caminho mapeado para o símbolo ou modelo de footprint existir apenas um nome de ficheiro de biblioteca (por exemplo Capacitor_NonPolarized.SchLib), utilize as localizações de modelos especificadas dentro do repositório para localizar o primeiro ficheiro de biblioteca que corresponda ao nome especificado e que contenha uma correspondência para o símbolo ou modelo de footprint especificado no campo de referência aplicável.

4. Se não existir informação de ficheiro de biblioteca na base de dados, utilize as localizações de modelos especificadas para localizar o primeiro ficheiro de biblioteca que contenha uma correspondência para o símbolo ou modelo de footprint especificado no campo de referência aplicável.