La base de la función de biblioteca de bases de datos es el archivo de biblioteca de base de datos. Este se presenta en dos formas, según si se utiliza una biblioteca de base de datos estándar o una biblioteca de base de datos bajo control de versiones:
-
Standard Database Library - el archivo Database Library. Este archivo se crea y administra con el editor DatabaseLib Editor de Altium Designer. Este editor está disponible cuando el documento activo en la ventana principal de diseño es un archivo *.DbLib.
-
Version-Controlled Database Library - el archivo SVN Database Library. Este archivo se crea y administra con el editor SVNDatabaseLib Editor de Altium Designer. Este editor está disponible cuando el documento activo en la ventana principal de diseño es un archivo *.SVNDbLib.
Ejemplo de archivo DbLib abierto en el DatabaseLib Editor. Pase el cursor sobre la imagen para ver un ejemplo de archivo SVNDbLib abierto en el SVNDatabaseLib Editor.
Cree un nuevo archivo de estos tipos eligiendo el comando File » New » Library en los menús principales y seleccionando la opción Database Library o SVN Database Library en la región Database del cuadro de diálogo New Library que se abre.
Conexión a una base de datos externa
La tabla y los datos de mapeo solo aparecerán en la ventana principal de visualización de un editor después de que el archivo activo Database Library/SVN Database Library se conecte correctamente a la base de datos externa requerida. La conexión se define mediante los controles proporcionados en la región Source of Connection.
Especificación de la conexión a la base de datos externa mediante un archivo DbLib. Pase el cursor sobre la imagen para ver la conexión mediante un archivo SVNDbLib.
Se puede conectar cualquier base de datos que proporcione compatibilidad con OLE DB. Las opciones proporcionadas en esta región utilizan una cadena de conexión OLE DB para conectarse a la base de datos de destino. Es posible que algunas bases de datos no ofrezcan compatibilidad con OLE DB. Sin embargo, prácticamente todos los sistemas de gestión de bases de datos que se usan hoy en día pueden accederse mediante la interfaz Open Database Connectivity (ODBC). La función de vínculo a base de datos utiliza el proveedor ODBC de Microsoft, que permite que un ADO (ActiveX Data Object) se conecte a cualquier origen de datos ODBC. El resultado es que se puede conectar cualquier base de datos ODBC. El proveedor OLE DB para la base de datos ODBC se especifica como parte de la cadena de conexión.
La conexión también se puede definir en la pestaña Connection del cuadro de diálogo Database Connection, al que se accede eligiendo el comando Tools » Database Connection en los menús principales, o haciendo clic en el botón Advanced (a la derecha del botón Connect , en la parte inferior de la región).
Options and Controls of the Database Connection Dialog
Pestaña Connection
-
Source of Connection
-
Use Data Link File - una cadena de conexión es una versión en texto de la información de conexión a una base de datos y puede guardarse como un archivo independiente con extensión .udl, conocido como archivo Microsoft Data Link. Si desea usar un archivo de vínculo de datos como origen de conexión a una base de datos, seleccione esta opción y luego haga clic en Browse para abrir el cuadro de diálogo Select Data Link File o use la lista desplegable para buscar el archivo .udl deseado.
-
Use Connection String - seleccione esta opción y luego haga clic en Build para abrir el cuadro de diálogo Data Link Properties y reconstruir la cadena de conexión a una base de datos para el mapeo de los parámetros de los componentes. La información especificada en una cadena de conexión puede variar según el proveedor OLE DB especificado.
Pestaña Advanced
-
SQL Options
-
Quote Tables - habilite esta opción para usar caracteres de comillas específicos para entrecomillar tablas.
-
Left Quote Character - especifique el carácter de comilla izquierdo. El valor predeterminado es "[".
-
Right Quote Character - especifique el carácter de comilla derecho. El valor predeterminado es "]".
Los caracteres de comillas específicos utilizados dependerán de la base de datos usada. Por ejemplo, los corchetes ([ ]) solo son válidos en una base de datos de Microsoft, como MS Access, mientras que MySQL usa el carácter "`" para entrecomillar.
-
Include Table Schema Names - habilite esta opción para incluir tablas con nombres de esquema de tabla. De forma predeterminada, esta opción está desactivada y solo se usan tablas con nombres de tabla normales.
La mayoría de las bases de datos tienen tablas identificadas por el nombre de la tabla. Otras bases de datos, como Oracle, tienen tablas que también cuentan con un prefijo llamado table schema name. Esta opción debe estar habilitada para incluir dichas tablas.
-
Field Data Type - especifique el tipo de datos para los nuevos campos. Por ejemplo, TEXT(N) o VARCHAR(N) se pueden usar para bases de datos MS Access o MySQL; VARCHAR2(N) se puede usar para bases de datos Oracle.
Conexión rápida a bases de datos Access y Excel
La opción Select Database Type ofrece un método rápido para crear una cadena de conexión cuando la base de datos de destino se ha creado con Microsoft Access o Microsoft Excel. Con esta opción, seleccione el tipo de base de datos y luego busque y seleccione el archivo de base de datos requerido. La cadena de conexión correspondiente se compondrá automáticamente y se introducirá en el campo de la opción Use Connection String.
Se puede especificar la ruta completa, o puede optar por almacenar la ruta relativa al archivo Database Library/SVN Database Library.
Creación de una cadena de conexión
Si la base de datos de su empresa no está basada en Access ni en Excel, y desea crear la cadena de conexión explícitamente, habilite la opción Use Connection String y luego haga clic en el botón Build asociado a la derecha. Aparecerá el cuadro de diálogo Data Link Properties.
Creación de una cadena de conexión mediante el cuadro de diálogo Data Link Properties.
El cuadro de diálogo se abre en la pestaña Connection . El proveedor OLE DB Microsoft Office <Version> Access Database Engine OLE DB Provider se establece de forma predeterminada en la pestaña Provider del cuadro de diálogo. Esta es la configuración predeterminada del proveedor para los nuevos archivos Database Library/SVN Database Library y también se usa para conectarse a archivos de base de datos Access (*.mdb). Cambie el proveedor según sea necesario.
En la pestaña Connection , introduzca el nombre (incluida la ruta) de la base de datos a la que desea conectarse.
Si su base de datos requiere permisos de inicio de sesión, introdúzcalos según corresponda, junto con cualquier otra configuración avanzada disponible en la pestaña Advanced del cuadro de diálogo. La pestaña All ofrece un resumen de las opciones de vínculo definidas, así como opciones extendidas relacionadas con el proveedor OLE DB elegido. Las opciones pueden modificarse según sea necesario desde esta pestaña.
Una vez definidas las opciones del vínculo, puede comprobar si la conexión se realizó correctamente haciendo clic en el botón Test Connection (en la pestaña Connection ). Si la conexión es correcta, aparecerá un cuadro de diálogo de confirmación indicándolo.
El cuadro de diálogo Data Link Properties es un cuadro de diálogo de Microsoft y, como tal, al presionar F1 o usar el botón Help disponible se obtendrá acceso al archivo Microsoft Data Link Help. Este archivo no forma parte del conjunto de documentación de Altium Designer.
Especificación de un archivo Data Link
Si el origen de datos al que desea conectarse se describe mediante un archivo Microsoft Data Link (*.udl), habilite la tercera de las opciones de conexión - Use Data Link File - y haga clic en el botón Browse asociado para localizar el archivo requerido. Un archivo Data Link es esencialmente un contenedor para una cadena de conexión.
Continuar con la conexión
Después de definir la conexión con la base de datos externa, el texto del botón Connect aparecerá en negrita, lo que indica que puede continuar con la conexión. Si los detalles de la conexión son correctos, la tabla y la información de mapeo de la base de datos de destino se cargarán en el archivo Database Library/SVN Database Library. El texto del botón Connect cambiará a Connected y el botón aparecerá atenuado.
Si hay un problema con los detalles de la conexión, por ejemplo, si una cadena de conexión se crea incorrectamente o se introduce una ruta errónea, la conexión fallará y aparecerá un mensaje alertándole de este hecho. Revise la configuración de su conexión y haga clic de nuevo en el botón Connect .
Ejemplos de indicación de fallo de conexión en una biblioteca de bases de datos.
Si cambia la configuración de la conexión mientras está conectado a una base de datos, la conexión activa se perderá y el texto del botón Connect cambiará a Reconnect. Haga clic para restablecer la conexión.
Después de una conexión inicial correcta, y tras guardar el archivo Database Library/SVN Database Library, la conexión se realizará automáticamente cada vez que se abra el archivo, siempre que no cambien la ubicación ni el nombre del archivo de la base de datos de destino.
Especificación del vínculo al repositorio de control de versiones (solo SVNDbLib)
Con un DbLib, las bibliotecas de símbolos y modelos se almacenan en su disco duro u otro medio local/de red. Recuerde que, para un SVNDbLib, estas bibliotecas se almacenan bajo control de versiones en un repositorio Subversion. Como parte del archivo SVNDbLib, debe definir el vínculo a este repositorio. La conexión al repositorio SVN se define en la pestaña SVN Repository del cuadro de diálogo Database Library Options (Tools » Options). También se puede acceder a este cuadro de diálogo haciendo clic en el botón Options en la región Field Settings de la vista del documento.
Ejemplo de conexión a un repositorio SVN basado en archivos.
Listado de tablas de la base de datos
Después de conectarse correctamente a la base de datos externa, se cargarán los datos de tablas y de mapeo. El lado izquierdo del documento DbLib/SVNDbLib enumera todas las tablas que existen en la base de datos conectada.
Para una base de datos basada en Excel, una tabla es en realidad una hoja de ese libro vinculado. El nombre de la tabla tendrá el sufijo $.
Tablas existentes en la base de datos conectada.
La opción Enable junto a cada entrada de tabla le permite controlar si esa tabla formará parte o no de la biblioteca de base de datos resultante. Cuando la biblioteca de base de datos se agrega a la lista de Available File-based Libraries para exploración en el panel Components, cada tabla aparecerá como una entidad de biblioteca independiente. Por lo tanto, aunque en términos reales solo se agregue una biblioteca de base de datos, desde la perspectiva del panel Components , es como si hubiera agregado varias bibliotecas distintas. Para obtener más información, consulte Búsqueda de componentes en bibliotecas basadas en archivos y bibliotecas de base de datos.
Al hacer clic en una entrada de tabla de la lista, su icono cambia de
a
para distinguirla como la tabla activa en ese momento. La tabla, junto con todos sus datos, aparece en la pestaña Table Browser del documento. Esta es una vista editable de la tabla y le permite consultar rápidamente su contenido y editarlo cuando sea necesario, sin tener que iniciar la propia base de datos externa.
Exploración de una tabla de origen en la base de datos conectada.
Para ampliar el área del Explorador de tablas (como se muestra en la ilustración anterior), contraiga toda el área superior (configuración de conexión y campos) haciendo clic en el control

, en la parte superior derecha de la vista del documento. Haga clic en

para expandirla. La tabla también admite funciones conocidas de agrupación, ordenación y filtrado.
Especificación de criterios de coincidencia
Después de colocar un componente desde la base de datos externa, debe existir alguna forma de mantener el vínculo entre ese componente colocado y el registro de la base de datos cuya información se utilizó para crearlo. En esencia, ambos deben coincidir.
Cuando se coloca un componente, su información de parámetros se crea sobre la marcha utilizando los campos correspondientes del registro de la base de datos. El vínculo posterior a la colocación entre el componente esquemático y el registro de la base de datos se establece utilizando uno o más de estos parámetros. La región Field Settings del documento le permite definir los criterios de coincidencia: ya sea una búsqueda simple con una sola clave o una coincidencia más avanzada mediante una cláusula Where.
Los criterios de coincidencia se especifican por tabla.
Control de los criterios de coincidencia posteriores a la colocación.
Búsqueda por clave única
Si la opción Single key lookup está habilitada (predeterminada), los campos Database field y Part parameter estarán disponibles. El primero enumera todos los nombres de campo disponibles (encabezados de columna) en la tabla activa de la base de datos. Como los parámetros de un componente esquemático se agregan a medida que se coloca, el campo Part parameter reflejará el campo de base de datos que se elija.
Normalmente, el campo de clave de búsqueda utilizado es algo que identifica de forma única cada componente en la base de datos externa, como un número de pieza. El campo de búsqueda elegido se distingue en la pestaña Field Mappings del documento mediante la entrada Design Parameter, que se muestra atenuada.
Asignación de clave única por número de pieza.
Al utilizar la función Update Parameters From Database en alguna etapa posterior a la colocación, la información se lee desde el parámetro clave elegido en los componentes esquemáticos colocados y luego se busca en el campo (clave) elegido de la base de datos, en todas las tablas habilitadas. Cuando hay coincidencia, la información de otras celdas de ese registro de la tabla principal puede devolverse a los parámetros asignados en el componente esquemático.
Coincidencia avanzada: la cláusula Where
Aunque la opción Single key lookup funciona bien si existe un número/id de pieza único con el que hacer la coincidencia, no es tan efectiva cuando se compara mediante un parámetro que no es único, como capacitancia o resistencia. En este caso debe utilizarse la cláusula Where más avanzada, que le permite especificar una coincidencia con múltiples claves para vincular el componente esquemático con su registro de base de datos de origen.
En su forma más simple, la cláusula Where (escrita con sintaxis SQL) refleja las entradas elegidas que definen la búsqueda por clave única. Por ejemplo, si se eligió que Database field fuera Part Number —el valor predeterminado—, el campo Part parameter también se establecería automáticamente en Part Number, y la entrada para la cláusula Where sería:
[Part Number] = '{Part Number}'
Los corchetes alrededor del campo de base de datos (columna de la tabla) son caracteres de comillas, según se especifica en la pestaña Advanced del cuadro de diálogo Database Connection dialog. Acceda a este cuadro de diálogo haciendo clic en el botón Advanced de la región Source of Connection del documento, o desde el menú principal Tools .
La pestaña Advanced del cuadro de diálogo Database Connection proporciona opciones SQL adicionales para poner entre comillas
las tablas, o para usar nombres de esquema de tabla, en una cláusula Where construida.
Cuando se ponen tablas entre comillas, los caracteres específicos utilizados dependerán de la base de datos que esté utilizando. Por ejemplo, los corchetes [ ] solo pueden usarse en bases de datos de Microsoft como Access, Excel mediante ADO o MSSQL (versiones posteriores). MYSQL usaría el carácter ` (acento grave invertido) para las comillas. En realidad, solo necesita poner entre comillas los nombres de columna, en cualquier base de datos, si incluyen espacios o son palabras reservadas (para esa base de datos). Consulte la documentación de su software de base de datos en particular para ver qué caracteres de comillas se usan (si corresponde).
Las llaves especifican que la entrada a la que se hace referencia es un parámetro de diseño. Las comillas simples se utilizan para indicar que el parámetro de diseño debe tratarse como una cadena, en lugar de como un número (sin comillas). La coincidencia de tipos es muy importante, ya que SQL es sensible a los tipos. El parámetro de diseño debe ser del mismo tipo que la columna en la base de datos.
Utilizando sintaxis SQL estándar, la cláusula Where puede ampliarse luego para coincidir usando varias entradas Database field/Part parameter, por ejemplo:
[Capacitance] = '{Capacitance}' AND [Tolerance] = {Tolerance} AND [Manufacturer] = '{Manufacturer}'
En este caso, se vincularía un único registro de la tabla correspondiente de la base de datos utilizando tres parámetros de diseño diferentes. Observe que la entrada para el parámetro de diseño Tolerance no está entre comillas. Esto significa que el tipo de columna en la tabla asociada de la base de datos es Number y no String.
Utilizando sintaxis SQL estándar, puede hacer que la cláusula Where sea tan simple o tan compleja como desee.
Asignación de campos de base de datos a parámetros de diseño
Los parámetros de diseño de un componente colocado desde una biblioteca de base de datos se crean/agregan en el momento de la colocación. Qué parámetros se crean realmente y las opciones utilizadas para actualizar su información después de la colocación, usando el comando Tools » Update Parameters From Database, se determinan mediante la información de asignación y actualización especificada en el archivo de Biblioteca de Base de Datos/Biblioteca de Base de Datos SVN. Estas configuraciones se realizan en la pestaña Field Mappings de la vista principal del documento.
Las opciones de asignación y actualización se especifican por tabla.
Especifique las opciones de asignación de parámetros y actualización en la pestaña Field Mappings del documento DbLib/SVNDbLib.
Asignación de modelos y parámetros
Las dos primeras columnas (desde la izquierda) en la pestaña Field Mappings se utilizan para controlar qué información de la base de datos se asignará a los atributos, modelos y parámetros del componente.
-
Database Field Name - esta columna enumera todos los nombres de campo (columna) de la tabla activa actual de la base de datos.
-
Design Parameter - esta columna define cómo debe utilizarse cada campo correspondiente de la base de datos. Puede usarse para proporcionar el símbolo de un componente o su modelo de huella (irá entre corchetes), o para incluirse como parámetro del componente (estos no van entre corchetes).
Cuando abre un documento DbLib/SVNDbLib que se ha conectado a una base de datos, observará que algunos parámetros de diseño incluyen corchetes y otros no. Los corchetes indican un nombre reservado, como [Library Ref]. Estos datos se utilizan para rellenar los atributos y modelos del componente. Los parámetros de diseño que no incluyen corchetes se convierten en parámetros del componente.
La asignación inicial se realiza automáticamente al conectarse a la base de datos, y todos los campos de la base de datos quedan asignados.
Tenga en cuenta que la asignación automática supone que los nombres de los campos de la base de datos coinciden con el nombre reservado utilizado en Altium Designer. Si no es así, la asignación debe configurarse manualmente.
Atributos y modelos
Si el nombre del campo de la base de datos es uno de los siguientes nombres reservados, la entrada de asignación de atributo/modelo correspondiente se establecerá automáticamente en el 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]
Se pueden especificar referencias ilimitadas a modelos de huella (y rutas) en una tabla de base de datos y asignarlas en el archivo DbLib/SVNDbLib. En los nombres reservados, n representa un entero positivo que comienza desde 2.
-
Library Ref → [Library Ref]
-
Library Path → [Library Path]
-
Orcad Footprint → [Orcad Footprint]
-
Orcad Library → [Orcad Library]
Estas referencias se utilizan al importar un archivo de configuración y bibliotecas de OrCAD CIS, y al generar una biblioteca de base de datos estándar (DbLib).
-
PCB3D Ref → [PCB3D Ref]
-
PCB3D Path → [PCB3D Path]
-
Las referencias a PCB3D se refieren al visor 3D heredado; no deben utilizarse para diseños nuevos. El motor 3D nativo del editor PCB puede representar cuerpos de componentes y archivos de modelos 3D importados asociados con las huellas de los componentes.
-
Las asignaciones de modelos PCB3D pueden definirse en un archivo SVNDbLib; sin embargo, no se admite el almacenamiento de bibliotecas de modelos PCB3D en el repositorio Subversion.
-
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 a continuación para obtener más información sobre los campos relacionados con modelos de simulación.
Solo se puede definir un enlace de modelo de simulación para un componente en una base de datos externa. Normalmente solo habrá un único modelo de simulación vinculado a un componente. Si desea configurar varios enlaces de modelos de simulación, los demás enlaces deberán definirse y almacenarse con ese componente en el archivo de biblioteca esquemática de origen.
Los modelos de simulación vinculados son compatibles con una biblioteca de base de datos con control de versiones (SVNDbLib); sin embargo, no se admite el almacenamiento de archivos de modelos de simulación en el repositorio Subversion.
Estas asignaciones definen la información de atributos y modelos del componente. Cuando se coloca el componente, el símbolo esquemático especificado por el campo [Library Ref] del registro correspondiente de la base de datos se extraerá de la biblioteca esquemática especificada. Del mismo modo, la información de huella PCB y del modelo de simulación almacenada en el registro se agregará al componente como modelos vinculados de huella y simulación, respectivamente.
La entrada [Library Ref] debe existir en la columna Design Parameter y estar asignada al Database Field Name que especifica el símbolo esquemático, para poder colocar un componente desde la Biblioteca de Base de Datos/Biblioteca de Base de Datos SVN en un esquema. Si la tabla de base de datos contiene la referencia del símbolo bajo un Database Field Name diferente, por ejemplo SCH Symbol, deberá establecer manualmente la entrada Design Parameter asociada para este campo en [Library Ref], usando la lista desplegable disponible para esa celda.
De manera similar, si la información de referencia del modelo se introduce en la base de datos usando nombres de campo diferentes, deberá asignarla manualmente eligiendo la entrada Design Parameter apropiada ([Footprint Ref], [Footprint Ref n], [PCB3D Ref], [Sim Model Name], etc.) de la lista desplegable, para cada campo sucesivamente.
Para definir la información del símbolo y del modelo de un componente al colocarlo, los campos de referencia de símbolo y modelo en la base de datos son las entidades de asignación fundamentales
: asegúrese de que haya un símbolo y al menos una referencia de huella PCB como parte de la asignación definida.
Como se mencionó, se pueden asignar múltiples modelos PCB. El Database Field Name que esté asignado a Design Parameter [Footprint Ref] será la huella predeterminada cuando el componente se coloque en el esquema. Esta es la huella que se colocará cuando el diseño se transfiera al dominio PCB.
Asignación de modelos de simulación
Esta sección describe cada uno de los campos de la base de datos que pueden agregarse a una tabla de base de datos externa para definir el vínculo del modelo de simulación, que se creará al colocar el componente.
-
Sim Model Name – el nombre del modelo que desea usar. Después de colocar el componente, esta información aparecerá en el campo Model Name del cuadro de diálogo Sim Model.
Al asignar campos de base de datos a parámetros de diseño en el archivo DBLib, el campo Sim Model Name es análogo a los campos Footprint Ref, Library Ref, etc.
-
Sim Description – una descripción del modelo vinculado. Esta información es opcional y no afecta el funcionamiento del vínculo del modelo de simulación.
-
Sim File – un archivo de modelo específico en el que buscar el modelo de simulación especificado en el campo Sim Model Name. Hay varias formas de utilizar este campo:
-
Puede introducir una ruta absoluta a un archivo de modelo (por ejemplo,
C:\DbLibs\Switching Diodes\Libraries\JAS33.mdl). El modelo especificado en el campo Sim Model Name se buscará dentro de este archivo y se usará si se encuentra.
-
Puede introducir una ruta relativa (relativa al archivo DbLib) a un archivo de modelo (por ejemplo,
Libraries\JAS33.mdl). El modelo especificado en el campo Sim Model Name se buscará dentro de este archivo y se usará si se encuentra.
-
Puede introducir solo el nombre del archivo de modelo (por ejemplo,
JAS33.mdl). Las rutas de búsqueda definidas como parte del archivo DbLib se usarán para localizar el primer archivo de modelo que coincida con el nombre especificado y que contenga una coincidencia para el modelo especificado en el campo Sim Model Name.
-
Puede dejar el campo en blanco. Las rutas de búsqueda definidas como parte del archivo DbLib se usarán para localizar el primer archivo de modelo que contenga una coincidencia para el modelo especificado en el campo Sim Model Name.
Las rutas de búsqueda se definen para el archivo DbLib desde la pestaña Symbol & Model Search Paths del cuadro de diálogo Database Library Options (Tools » Options).
-
Sim Kind – la categoría principal del modelo que se está vinculando.
-
Sim SubKind – el tipo de modelo que se está vinculando.
-
Sim Netlist – la información de la plantilla de netlist, de acuerdo con el tipo de modelo que se está vinculando. Este campo se vuelve especialmente importante si está especificando su propia plantilla de netlist y ha establecido el campo Sim SubKind en Generic Editor, lo que le da más control sobre qué información se coloca en la netlist.
Este campo debe estar definido y no dejarse en blanco; de lo contrario, no se hará ninguna entrada para el modelo en la netlist de simulación y la pieza no se simulará cuando se coloque desde la biblioteca de base de datos.
Netlist Template Syntax
Al definir la plantilla de netlist, la información introducida debe estar de acuerdo con los requisitos de SPICE y las reglas de sintaxis descritas a continuación.
Los caracteres introducidos en la plantilla se escriben literalmente en la netlist de SPICE, excepto los siguientes caracteres especiales:
| % |
signo de porcentaje |
| @ |
arroba |
| & |
ampersand |
| ? |
signo de interrogación |
| ~ |
tilde |
| # |
signo numérico |
Estos caracteres se traducen al crear la netlist, como se muestra en la siguiente tabla:
| Sintaxis en la plantilla de netlist... |
El generador de netlist reemplaza con... |
| @<param> |
Valor de <param>. Se genera un error si no existe un parámetro con este nombre o si no tiene un valor asignado. |
| &<param> |
Valor de <param>. No se genera ningún error si el parámetro no está definido. |
| ?<param>s...s |
Texto entre los separadores s...s si <param> está definido. |
| ?<param>s...ss...s |
Texto entre los primeros separadores s...s si <param> está definido; de lo contrario, entre los segundos separadores s...s. |
| ~<param>s...s |
Texto entre los separadores s...s si <param> NO está definido. |
| ~<param>s...ss...s |
Texto entre los primeros separadores s...s si <param> NO está definido; de lo contrario, entre los segundos separadores s...s. |
| #<param>s...s |
Texto entre los separadores s...s si <param> está definido, pero ignora el resto de la plantilla si <param> NO está definido. |
| #s...s |
Texto entre los separadores s...s si hay algún texto que deba introducirse en la netlist XSpice a partir de entradas posteriores en la plantilla de netlist. |
| %<pin id> |
El nombre de red de la red a la que se conecta el pin esquemático asignado a <pin id>. |
| %% |
Un carácter de porcentaje literal. |
En la tabla anterior,
-
s representa un carácter separador (, . ; / |).
-
<param> se refiere al nombre de un parámetro.
Si el nombre del parámetro contiene caracteres no alfanuméricos, debe ir entre comillas dobles. Por ejemplo:
@"DC Magnitude" - aquí se usan comillas dobles porque el nombre contiene un espacio.
&"Init_Cond" - aquí se usan comillas dobles porque el nombre contiene un guion bajo.
Las comillas dobles también deben usarse cuando desee agregar un prefijo alfanumérico a un nombre de parámetro. Por ejemplo:
@"DESIGNATOR"A - el uso de las comillas dobles garantiza que A se agregue al designador del componente.
A continuación se muestran ejemplos de las entradas de sintaxis de caracteres especiales de la tabla anterior. En cada caso, se proporciona información sobre cómo el generador de netlist traduce la entrada de sintaxis.
@"AC Phase"
El nombre del parámetro AC Phase está entre llaves debido al espacio. Esto se reemplazará en la netlist por el valor del parámetro AC Phase. Si no existe un parámetro con este nombre, o su valor está en blanco, se generará un error.
&Area
Si existe un parámetro llamado Area y tiene un valor, entonces su valor se introducirá en la netlist. Si el parámetro no está definido (es decir, no existe o no tiene ningún valor asignado), no se escribirá nada en la netlist, pero no se generará ningún error. Esto puede usarse para parámetros opcionales.
?IC|IC=@IC|
Si el parámetro llamado IC está definido, entonces el texto dentro de los separadores || se insertará en la netlist. Por ejemplo, si el parámetro IC tuviera el valor 0.5, entonces IC=0.5 se insertaría en la netlist en lugar de esta entrada. Si el parámetro no está definido, no se insertará nada en la netlist.
?IC/IC=@IC//IC=0/
Esto es igual que el ejemplo anterior, excepto que si el parámetro IC no está definido, entonces IC=0 se insertará en la netlist. Observe también que se ha usado un carácter separador diferente.
~VALUE/1k/
Si un parámetro llamado VALUE NO está definido, entonces el texto 1k se insertará en la netlist.
~VALUE/1k//@VALUE/
Esto es igual que el ejemplo anterior, excepto que si el parámetro VALUE está definido, entonces su valor de texto se insertará en la netlist.
#"AC Magnitude"|AC@"AC Magnitude"|@"AC Phase"
Este ejemplo puede verse en la plantilla de netlist predefinida para la fuente de voltaje sinusoidal.
Si el parámetro AC Magnitude ha sido definido, entonces el contenido de los separadores se evalúa y se inserta en la netlist. Todas las entradas siguientes en la netlist también se evalúan y se introducen en la netlist (en este caso @"AC Phase").
Si, por ejemplo, AC Magnitude=1 y AC Phase=0, entonces AC 1 0 se insertará en la netlist. Sin embargo, si AC Phase no estuviera definido, se generaría un error.
Si el parámetro AC Magnitude no está definido, entonces nada de lo que siga a la entrada #"AC Magnitude" en la plantilla de netlist se introducirá en la netlist.
#|PARAMS:|?Resistance|Resistance=Resistance|?Current|Current=@Current|
Este ejemplo puede verse en la plantilla de netlist predefinida para un subcircuito parametrizado (consulte F1 en Fuse.PrjPcb).
Si los parámetros Resistance y Current están ambos sin definir, no habrá texto que insertar en la netlist después de la entrada #|PARAMS:|, por lo que también se omitirán los separadores.
Si, por ejemplo, los parámetros tienen los valores Resistance=1k y Current=5mA, esto dará como resultado texto después de la entrada #|PARAMS:| y PARAMS: Resistance=1k Current=5mA será la entrada realizada en la netlist.
@DESIGNATOR%1%2@VALUE
Este ejemplo es para demostrar el uso del carácter %.
Si, por ejemplo, los parámetros tienen los valores DESIGNATOR=R1 y VALUE=1k, y los pines están asignados en la región Pin Mapping del cuadro de diálogo Sim Model según la siguiente tabla:
| Pin esquemático |
Pin del modelo |
Nombre de red al que se conecta el pin esquemático |
| 1 (N+) |
1 (1) |
GND |
| 2 (N-) |
2 (2) |
OUT |
Entonces, el texto R1 GND OUT 1k se colocará en la netlist SPICE para este componente.
-
Sim Spice Prefix – el prefijo SPICE para el tipo de modelo al que está enlazando.
-
Sim Port Map – la asignación de pines desde el componente esquemático a los pines del modelo enlazado. Después de colocar el componente, esta información aparecerá en la región Pin Mapping del cuadro de diálogo Sim Model.
Cada emparejamiento de pines debe introducirse con el siguiente formato:
(SchematicPinNumber:ModelPinNumber),
con cada par asignado separado por una coma.
Por ejemplo, al asignar un modelo de simulación de diodo donde el pin esquemático 1 (ánodo) debe asignarse al pin 1 del modelo (ánodo), y el pin esquemático 3 (cátodo) debe asignarse al pin 2 del modelo (cátodo), esto se introduciría en el campo de la base de datos como:
(1:1),(3:2)
-
Sim Excluded Parts – cree este campo en la base de datos si desea excluir determinadas partes de un componente multipartes de la simulación. Esta información corresponde a la opción Exclude part from simulation en la región Pin Mapping del cuadro de diálogo Sim Model.
De forma predeterminada, todas las partes de un componente multipartes se incluyen en una simulación, por lo que solo necesita especificar las partes que desea excluir, por número. Separe varias partes en la lista de exclusión usando comas. Por ejemplo, si un componente tiene cuatro partes y no desea que las partes 2 y 4 se incluyan en ninguna simulación, entonces introduciría lo siguiente en el campo de la base de datos:
2,4
-
Sim Parameters – cree este campo en la base de datos si desea asignar valores a los parámetros de simulación del modelo. Son parámetros que pueden definirse a nivel de componente, a diferencia de los parámetros más avanzados que pueden incluirse en un archivo de modelo.
Un parámetro debe introducirse con el siguiente formato:
ParameterName=Value,
Varios parámetros deben separarse con el carácter de barra vertical (|).
Quizás recuerde que un parámetro de simulación a nivel de componente también puede establecerse como parámetro del componente, apareciendo en la región Parameters del cuadro de diálogo Component Properties asociado, con la posibilidad de mostrarse después en la hoja esquemática. De forma predeterminada, una entrada de parámetro en el campo Sim Parameters se agregará automáticamente como parámetro del componente. Si no desea que un parámetro de simulación se agregue como parámetro del componente, simplemente añada un prefijo de signo de exclamación al nombre del parámetro (p. ej., !Initial Voltage=100mV).
Considere un modelo de diodo, que tiene los siguientes cuatro parámetros a nivel de componente:
-
Factor de área
-
Condición inicial
-
Tensión inicial
-
Temperatura.
Ahora considere agregar valores en la base de datos para Factor de área (digamos 2) y Temperatura (digamos 22°C). Además, ninguno de estos debe agregarse como parámetro del componente. La entrada en el campo Sim Parameters sería:
!Area Factor=2|!Temperature=22
Una vez que haya colocado el componente desde la biblioteca de base de datos, puede verificar que la información definida para el enlace de simulación sea efectivamente la requerida. Cuando el componente colocado esté seleccionado en el espacio de diseño, seleccione la entrada del modelo de simulación en la región Parameters del panel Properties, haga clic en el botón
para acceder al cuadro de diálogo Sim Model, desde donde podrá comprobar que:
-
El archivo del modelo se ha localizado según lo esperado. Cuando se encuentra, la pestaña Model File del cuadro de diálogo mostrará el contenido del archivo.
-
La información restante de simulación desde la base de datos se ha agregado al cuadro de diálogo según lo esperado.
Los valores almacenados en los campos de la base de datos se usarán para el componente colocado desde la biblioteca de base de datos al ejecutar una simulación. Sin embargo, tenga en cuenta que si accede al cuadro de diálogo Sim Model para un modelo de simulación de un componente colocado desde una biblioteca de base de datos y hace clic en OK, los campos Sim Netlist y Sim Spice Prefix se establecerán automáticamente para ese componente según el texto del modelo elegido.
Parámetros
Todos los demás nombres de campos de la base de datos se asignarán automáticamente a parámetros de diseño usando los mismos nombres. Por ejemplo, si un campo en la base de datos se llama Tolerance, se le asignará un parámetro de diseño con el nombre Tolerance. Puede cambiar el nombre de un parámetro de diseño haciendo clic en su celda y escribiendo directamente el nuevo nombre. Son estos nombres de parámetros de diseño los que aparecerán en la región Parameters del cuadro de diálogo de propiedades asociado del componente, una vez que se haya colocado en una hoja esquemática.
Puede que tenga una gran cantidad de campos de datos asociados a un componente en la base de datos, no todos los cuales querrá, o incluso necesitará, agregar como parámetros de diseño al componente cuando se coloque en una hoja esquemática. Gran parte de esta información puede requerirse solo al generar una lista de materiales. El cuadro de diálogo Report Manager le permite agregar información de parámetros a una BOM directamente desde una base de datos vinculada, lo que le permite reducir la cantidad de información que se “arrastra” con los documentos fuente del esquemático. Para obtener más información, consulte la sección Preparación de una BOM en el Report Manager.
Para los campos que explícitamente no desea que se asignen desde la base de datos, establezca la entrada Design Parameter en [None]. Los campos de base de datos no asignados se distinguen en la pestaña mediante el uso de un icono de cruz roja (
). Los campos de base de datos asignados se distinguen mediante un icono de marca verde (
).
Configure la asignación de parámetros según sea necesario. Establézcala en [None] para evitar que un parámetro de la base de datos se asigne al componente colocado. Los parámetros no asignados pueden incluirse directamente en la BOM, si es necesario.
Para reasignar rápidamente un campo no asignado, haga clic dentro de la fila de ese campo y use el atajo de teclado Ctrl+D. Tenga en cuenta que para las asignaciones de modelo deberá seleccionar manualmente desde la lista desplegable Design Parameter asociada.
Opciones de actualización de parámetros
Las columnas restantes en la pestaña Field Mappings le permiten especificar las acciones que se deben tomar para los parámetros al colocar un componente desde la biblioteca de base de datos por primera vez, o al actualizar un componente después de haberlo colocado usando el comando Tools » Update Parameters From Database.
Las cuatro columnas son las siguientes:
-
Update Values - una celda de esta columna se usa para determinar la acción que debe realizarse si el parámetro existe tanto en una hoja esquemática como en la base de datos, pero los valores son actualmente diferentes. Elija actualizar el parámetro del componente colocado con el valor almacenado en la base de datos (Update), o no actualizarlo en absoluto (Do not update). Esta opción se respeta cuando se usa el comando Update Parameters From Database, después de colocar el componente.
-
Add To Design - una celda de esta columna se usa para determinar la acción que debe realizarse si el parámetro se encuentra en la base de datos, pero no existe para el componente colocado. Puede elegir agregar el parámetro (Add), no agregar el parámetro (Do not add), o agregar el parámetro solo si tiene un valor asignado en la base de datos (Add only if not blank in database). Esta opción se respeta tanto al colocar inicialmente el componente desde la biblioteca de base de datos como al usar el comando Update Parameters From Database, después de que el componente haya sido colocado.
-
Visible On Add - una casilla de verificación en esta columna se usa para determinar si un parámetro recién agregado, como resultado de la colocación inicial o de una actualización posterior a la colocación, se hace visible para el componente en la hoja esquemática (habilitado) o no (deshabilitado).
-
Remove From Design - una celda de esta columna se usa para determinar la acción que debe realizarse si se detecta que el parámetro existe para el componente colocado, pero no está en la base de datos, o sí está, pero no tiene valor. Puede elegir no eliminar el parámetro en absoluto (Do not remove), o eliminarlo solo si no tiene un valor asignado en la base de datos (Remove only if blank in database). Esta opción se respeta al usar el comando Update Parameters From Database, después de que el componente haya sido colocado.
Inicialmente, los campos Update Values, Add To Design y Remove From Design —para cada campo de base de datos asignado— se establecerán en la entrada Default, y la opción Visible On Add estará deshabilitada, como se ilustra en la siguiente imagen.
Opciones iniciales (predeterminadas) de actualización de parámetros.
Al observar la imagen, hay cuatro puntos importantes que señalar con respecto a las opciones de actualización:
-
Los campos de base de datos no asignados no tendrán opciones de actualización asociadas.
-
Las asignaciones basadas en Attribute y Model (entradas con corchetes en la columna Design Parameter) no tendrán opciones de actualización asociadas, ya que no son parámetros de diseño.
-
El campo clave (por ejemplo, Part Number en la imagen) no tendrá opciones de actualización asociadas. Este campo se usa únicamente con fines de coincidencia de parámetros.
-
Un ajuste de Default hace que una opción de actualización siga su definición predeterminada correspondiente, tal como se especifica en la pestaña Default Actions del cuadro de diálogo Database Library Options (Tools » Options desde los menús principales o Options desde el menú contextual de la pestaña Table Browser). También se puede acceder a este cuadro de diálogo haciendo clic en el botón Options en la región Field Settings de la vista del documento.
Defina las opciones predeterminadas de actualización de parámetros en una ubicación central para una DbLib. Pase el cursor sobre la imagen para ver el equivalente para una SVNDbLib.
El cuarto punto es beneficioso porque le permite especificar opciones de actualización desde una ubicación central y luego señalar esa ubicación al definir las opciones de actualización para cada campo asignado. Por eso la entrada Default se carga automáticamente en los campos de actualización pertinentes al asignar un campo de base de datos a un parámetro de diseño.
Si desea reemplazar la configuración predeterminada de una opción de actualización, haga clic dentro del campo de actualización correspondiente en la pestaña Field Mappings y luego vuelva a hacer clic para acceder a una lista desplegable con las opciones de actualización aplicables.
Las opciones de actualización de parámetros pueden reemplazarse manualmente, si es necesario.
De este modo, tiene control total sobre cómo se actualizan los parámetros del diseño. Puede establecer todos los campos en Default y tomar las decisiones de actualización necesarias desde el cuadro de diálogo Database Library Options, establecer cada campo de actualización individualmente o usar una combinación de ambos; la decisión es totalmente suya según lo considere conveniente. Para los componentes colocados, la actualización, cuando se realiza, se lleva a cabo mediante un cuadro de diálogo Engineering Change Order. Si en esta etapa hay actualizaciones que preferiría no realizar, puede optar por no incluir esos cambios concretos, lo que le da la decisión final y definitiva sobre qué parámetros del diseño se actualizan.
Especificación de ubicaciones de bibliotecas de símbolos y modelos
Cuando coloca un componente desde una biblioteca de base de datos, su símbolo, especificado por la asignación [Library Ref], se extrae de la biblioteca esquemática especificada (*.SchLib). Del mismo modo, cualquier referencia a modelos (footprint, PCB3D, simulación) especificada en la base de datos residirá en los archivos subyacentes de biblioteca PCB (*.PcbLib), biblioteca PCB3D (*.PCB3DLib) y modelo de simulación (*.mdl, *.ckt). Las rutas a estos archivos pueden especificarse explícitamente en la base de datos mediante:
-
La introducción de una ruta absoluta al archivo.
-
La introducción de una ruta relativa al archivo.
Si ha definido campos en su base de datos para la información de ruta, estos campos deben asignarse a los parámetros de diseño apropiados: [Library Path], [Footprint Path], [PCB3D Path], [Sim File], etc. (consulte Asignación de modelos y parámetros).
Introducir rutas, incluso relativas, en una tabla de base de datos puede ser un poco restrictivo. Si mueve la ubicación de una biblioteca o archivo de modelo, tendría que actualizar la tabla de la base de datos en consecuencia. Para ofrecerle mayor libertad, puede especificar información de búsqueda de bibliotecas dentro del propio archivo DbLib/SVNDbLib. Esto le permite especificar en la base de datos el nombre de la biblioteca de origen o del archivo de modelo, o incluso no definirlo en absoluto.
Using Search Paths with a large number of symbol/model files - aunque las rutas de búsqueda ofrecen mayor flexibilidad y simplicidad para configurar cómo se localizan los símbolos y modelos, este enfoque no se recomienda cuando hay un gran número de archivos de símbolos o modelos en la ubicación de búsqueda. Dependiendo del esquema de nombres de archivo utilizado, las rutas de búsqueda pueden requerir que se busque en todos los archivos de biblioteca/modelo presentes en la ruta cada vez que se necesita un símbolo/modelo, por ejemplo, al examinar componentes o al transferir el diseño del esquemático a la PCB.
Para una biblioteca de base de datos
Para una DbLib, las rutas de búsqueda de bibliotecas se definen en la pestaña Symbol and Model Search Paths del cuadro de diálogo Database Library Options (Tools » Options). También se puede acceder a este cuadro de diálogo haciendo clic en el botón Options en la región Field Settings de la vista del documento.
Especificación de rutas de búsqueda para bibliotecas de símbolos y modelos.
Para agregar una ruta a la lista:
-
Escriba la ruta directamente en el campo debajo de la región Library Search Paths o haga clic en el botón
para acceder al cuadro de diálogo Browse for Folder, desde donde puede localizar el directorio en el que residen los archivos de biblioteca/modelo requeridos.
-
Puede agregarla como ruta completa o como ruta relativa (respecto a la ubicación del archivo DbLib). Controle esto mediante la opción Add/Update As Relative Path.
-
Después de especificar la ruta requerida, agréguela a la lista de rutas de búsqueda haciendo clic en el botón Add .
-
Siga agregando rutas de búsqueda adicionales según sea necesario.
Para la entrada directa, si especifica una ruta incorrecta (por ejemplo, a una carpeta que no existe), la entrada igualmente puede agregarse, pero aparecerá atenuada en la lista para indicar que es una ruta de búsqueda no válida. Si detecta que ha introducido una ruta por error, puede seleccionarla en la lista y hacer clic en el botón Remove , o modificar su definición de ruta y hacer clic en el botón Update .
Las rutas de búsqueda de bibliotecas determinan dónde pueden encontrarse los archivos de biblioteca y modelo al colocar desde la biblioteca de base de datos y al buscar un modelo después de la colocación. El modelo específico que se utilice dependerá de cómo haya configurado sus rutas de búsqueda de bibliotecas y de si ha agregado información específica de biblioteca en su base de datos. La búsqueda se realizará en el siguiente orden:
-
Si existe una ruta completa en el campo de ruta asignado para el símbolo o modelo, use ese archivo de biblioteca/modelo y extraiga el símbolo o modelo especificado en el campo de referencia correspondiente.
-
Si existe una ruta relativa en el campo de ruta asignado para el símbolo o modelo, use ese archivo de biblioteca/modelo y extraiga el símbolo o modelo especificado en el campo de referencia correspondiente.
-
Si en el campo de ruta asignado para el símbolo o modelo solo existe un nombre de archivo de biblioteca/modelo, use las rutas de búsqueda para localizar el primer archivo de biblioteca/modelo que coincida con el nombre especificado y que contenga una coincidencia para el símbolo o modelo especificado en el campo de referencia correspondiente.
-
Si no existe información de archivo de biblioteca/modelo en la base de datos, use las rutas de búsqueda para localizar el primer archivo de biblioteca/modelo que contenga una coincidencia para el símbolo o modelo especificado en el campo de referencia correspondiente.
Para una biblioteca de base de datos SVN
Para una SVNDbLib, los directorios base dentro del repositorio Subversion, en los que residen los símbolos y modelos footprint, se especifican en la pestaña SVN Repository del cuadro de diálogo Database Library Options (Tools » Options). También se puede acceder a este cuadro de diálogo haciendo clic en el botón Options en la región Field Settings de la vista del documento.
Especificación de directorios base del repositorio para símbolos y footprints.
Use los campos disponibles en la región Models Location para especificar el directorio base para los símbolos y footprints. Haga clic en el botón
situado a la derecha de un campo para acceder al cuadro de diálogo Browse for directory, una ventana al repositorio vinculado. Use este cuadro de diálogo para seleccionar la carpeta requerida.
Exploración del directorio correspondiente en el repositorio SVN vinculado.
Es importante destacar que los símbolos y footprints deben residir dentro de los directorios base del repositorio especificados. Por supuesto, pueden estar en subcarpetas de esos directorios, y las rutas especificadas tanto para símbolos como para footprints pueden apuntar al mismo directorio del repositorio.
Las ubicaciones de los modelos determinan dónde pueden encontrarse los archivos de biblioteca y modelo al colocar desde la biblioteca de base de datos con control de versiones y al buscar un modelo después de la colocación. Los símbolos esquemáticos específicos y los modelos footprint utilizados dependerán de cómo haya configurado estas ubicaciones y de si ha agregado información específica de biblioteca en su base de datos. La búsqueda se realizará en el siguiente orden:
-
Si existe una ruta completa en el campo de ruta asignado para el símbolo o modelo footprint (por ejemplo, http://MyServer/svn/MyCompany/ParentDirectory/SchematicSymbols/Capacitor_NonPolarized.SchLib), use ese archivo de biblioteca y extraiga el símbolo o footprint especificado en el campo de referencia correspondiente.
-
Si existe una ruta relativa (respecto a la raíz del repositorio) en el campo de ruta asignado para el símbolo o modelo footprint (por ejemplo, /ParentDirectory/SchematicSymbols/Capacitor_NonPolarized.SchLib), use ese archivo de biblioteca y extraiga el símbolo o footprint especificado en el campo de referencia correspondiente. La URL del repositorio, especificada en la región Repository Server Connection del cuadro de diálogo, se antepondrá a la ruta que introduzca para proporcionar la dirección absoluta.
-
Si en el campo de ruta asignado para el símbolo o modelo footprint solo existe un nombre de archivo de biblioteca (por ejemplo, Capacitor_NonPolarized.SchLib), use las ubicaciones de modelo especificadas dentro del repositorio para localizar el primer archivo de biblioteca que coincida con el nombre especificado y que contenga una coincidencia para el símbolo o modelo footprint especificado en el campo de referencia correspondiente.
Al buscar una coincidencia de símbolo/modelo, las rutas de carpetas aplanadas en el directorio base de símbolos o footprints se ordenan y buscan alfabéticamente. Si se utiliza el
Library Splitter Wizard, siempre habrá una biblioteca correspondiente con el nombre del símbolo/footprint real.
-
Si no existe información de archivo de biblioteca en la base de datos, use las ubicaciones de modelo especificadas para localizar el primer archivo de biblioteca que contenga una coincidencia para el símbolo o modelo footprint especificado en el campo de referencia correspondiente.
Al localizar el símbolo/footprint, el sistema buscará inicialmente la primera biblioteca con el mismo nombre que el propio símbolo o footprint. Por ejemplo, si el nombre del símbolo lógico en la base de datos (especificado por la asignación [Library Ref]) es Capacitor_NonPolarized, el sistema buscará primero el archivo llamado Capacitor_NonPolarized.SchLib y buscará el símbolo dentro de ese archivo. Si el símbolo/footprint no puede encontrarse de esta manera, el sistema buscará una coincidencia en todas las bibliotecas.