Bibliotecas de bases de datos

Altium Designer permite colocar componentes directamente desde una base de datos de la empresa mediante la creación y el uso de un Database Library. La colocación se realiza desde el panel Components, que, tras instalar la biblioteca de base de datos, permite explorar su base de datos.

Tras la colocación, la información de los parámetros de diseño se puede sincronizar entre los componentes colocados y sus correspondientes registros vinculados en la base de datos mediante el comando Tools » Update Parameters From Database. Las actualizaciones completas de los componentes, incluidos el símbolo gráfico, las referencias de los modelos y los parámetros, se pueden realizar mediante el comando Tools » Update From Libraries. La información paramétrica de la base de datos también se puede incluir en la lista de materiales (BOM) final, lista para la adquisición de componentes.

Colocación directa: más allá de la simple vinculación

Altium Designer proporciona tres métodos para vincular un componente con una base de datos: mediante un archivo de vínculo a base de datos (*.DbLink), un archivo de biblioteca de base de datos (*.DbLib) o un archivo de biblioteca de base de datos SVN (*.SVNDbLib), respectivamente. El enfoque DbLink ofrece una forma eficaz de vincular y mantener sincronizados los componentes utilizados en su diseño (o bibliotecas) con los datos introducidos en la base de datos. El enfoque DbLib/SVNDbLib aprovecha esta eficacia de vinculación ya probada y añade la libertad de colocar un componente directamente desde la base de datos; en esencia, crea el componente de forma dinámica a partir de la información almacenada para él en el registro correspondiente de la base de datos.

Antes de profundizar en la función de biblioteca de base de datos, conviene comentar las diferencias entre estos métodos en cuanto a su uso.

Vinculación mediante un archivo de vínculo a base de datos

Related page: Vinculación de componentes existentes con la base de datos de su empresa

• Con este método, el archivo de vínculo a base de datos (*.DbLink) define la vinculación entre el componente del esquema y un registro coincidente de una base de datos. La coincidencia del registro se establece mediante la vinculación por campos clave, que puede utilizar un único campo clave (por ejemplo, un número de pieza) o varios campos clave (mediante la definición de una cláusula Where).
• Con este método de vinculación, la información de los modelos y los parámetros del componente debe estar predefinida como parte del componente de biblioteca de Altium Designer. El componente de biblioteca también debe incluir la información necesaria de los campos clave como parte de su definición. Una vez definido esto, añada un archivo de vínculo a base de datos a su paquete de bibliotecas o proyecto de diseño; a continuación, podrá sincronizar la información del componente (parámetros) con el contenido de los campos de la base de datos.
• Aunque cada componente físico definido por cada registro de la base de datos no tiene por qué corresponder a un componente de biblioteca único de Altium Designer —varios componentes de la base de datos pueden compartir el mismo símbolo de componente—, este método de vinculación se utiliza normalmente con una correspondencia de «un registro de base de datos a un componente de Altium Designer». El componente único de Altium Designer puede ser una instancia colocada en una hoja de esquema o un componente único de una biblioteca de componentes.
• Con la vinculación a bases de datos de tipo DbLink, el archivo de vínculo a base de datos se incluye en el paquete de bibliotecas o en el proyecto de diseño.

Vinculación mediante un archivo de biblioteca de base de datos

• Con este método, el archivo de biblioteca de base de datos (*.DbLib) también define la vinculación entre el componente del esquema y un registro coincidente de una base de datos. De nuevo, la coincidencia del registro se establece mediante la vinculación por campos clave, que puede utilizar un único campo clave (por ejemplo, un número de pieza) o varios campos clave (mediante la definición de una cláusula Where).
• La diferencia principal de este método de vinculación es que la información del símbolo, los modelos y los parámetros del componente se almacena como parte de la definición del registro de ese componente en la base de datos externa. El componente de esquema referenciado (almacenado en una biblioteca de componentes subyacente (*.SchLib)) es únicamente el símbolo; no tiene modelos vinculados ni parámetros de diseño definidos.
• Cuando se coloca el componente, la información de sus parámetros y modelos se crea sobre la marcha, utilizando los campos correspondientes del registro coincidente de la base de datos y de acuerdo con la asignación definida. A continuación, se utilizarán uno o varios de estos parámetros para mantener un vínculo permanente con la base de datos, conforme a los criterios de coincidencia definidos, lo que permitirá sincronizaciones posteriores a la colocación.
• Este método de vinculación, debido a la creación dinámica de componentes en el momento de la colocación, resulta muy adecuado para una correspondencia de «varios registros de base de datos a un componente de Altium Designer».
• A diferencia de la vinculación a bases de datos de tipo DbLink, en la que el archivo DbLink debe incluirse en el paquete de bibliotecas (o proyecto de diseño), no es necesario añadir el archivo DbLib/SVNDbLib al proyecto. La biblioteca de base de datos (DbLib) se incluye en las bibliotecas basadas en archivos disponibles, a las que se accede desde el panel Components. Recuerde que las bibliotecas basadas en archivos disponibles pueden ser bibliotecas del proyecto, bibliotecas instaladas o bibliotecas encontradas en las rutas de búsqueda especificadas.
• Normalmente, los archivos DbLib/SVNDbLib se configuran con una organización por bibliotecas. Por ejemplo, podría tener uno para todas las resistencias detalladas en la base de datos de su empresa, otro para los condensadores, etc.

DbLib frente a SVNDbLib

Una biblioteca de base de datos SVN es una extensión del modelo de biblioteca de base de datos, con la diferencia de que el símbolo y los modelos de origen se almacenan bajo control de versiones.

Las bibliotecas de origen se crean, amplían y mantienen en un repositorio basado en Subversion. El vínculo con el repositorio y con la base de datos externa se define en un archivo de biblioteca de base de datos SVN (*.SVNDbLib). Y, dado que este enfoque es una extensión de la biblioteca de base de datos, a menudo se denomina Version-Controlled Database Library.

¿Responsable de bibliotecas o diseñador?

Hay básicamente dos modos de trabajar con una biblioteca de base de datos bajo control de versiones: como Librarian o como Designer.

Como bibliotecario, no solo tendrá que configurar y mantener el repositorio externo de control de código fuente de las bibliotecas de símbolos y modelos, sino que también será responsable de configurar el archivo de biblioteca de base de datos SVN. Esto implica:

• Conectarse a la base de datos externa de componentes.
• Definir la correspondencia entre los registros de la base de datos y los parámetros/modelos de los componentes.
• Especificar el enlace al repositorio SVN en el que se almacenan las bibliotecas de símbolos y modelos.

Como diseñador, tomará el archivo SVNDbLib generado por el bibliotecario y lo pondrá a disposición en el panel Componentes, añadiéndolo a la lista de bibliotecas basadas en archivos disponibles, para poder explorar y colocar los componentes de la base de datos.

El uso de estos roles variará de una empresa a otra. Una empresa grande puede contar con un centro de bibliotecas dedicado que, en el papel de bibliotecario, se encargue exclusivamente de la configuración y el mantenimiento de las bibliotecas de símbolos y modelos en el repositorio de control de código fuente, así como de la generación de los archivos de biblioteca de base de datos SVN. Los archivos SVNDbLib se pondrán entonces a disposición de los diseñadores de esa empresa, quienes instalarán y utilizarán los archivos de biblioteca para colocar los componentes en sus diseños.

En una empresa más pequeña, una misma persona puede desempeñar ambos roles. Esa persona no solo configurará y mantendrá el repositorio de bibliotecas, sino que también utilizará los archivos SVNDbLib definidos en su trabajo de diseño.

El repositorio de control de código fuente

Related article: Uso del control de versiones externo

Los archivos de biblioteca de símbolos y modelos deben añadirse a un repositorio Subversion (SVN). Altium Designer incluye un proveedor de control de versiones SVN, que se habilita y configura en la página Gestión de datos - Control de versiones del cuadro de diálogo Preferences. Una vez habilitado el proveedor de control de versiones SVN, se puede crear un repositorio en la página Gestión de datos - Repositorios de diseño del cuadro de diálogo Preferences.

Los repositorios SVN también se pueden crear y gestionar fuera de Altium Designer mediante un cliente y un servidor SVN externos, como TortoiseSVN. Es posible conectarse a un repositorio existente desde la página Data Management - Design Repositories del cuadro de diálogo Preferences.

Un aspecto importante que debe tenerse en cuenta al añadir archivos al repositorio es que cada símbolo y modelo must be stored in its own library file. En una biblioteca convencional, que puede contener cualquier número de símbolos o modelos, cambiar una sola entrada haría que el sistema de control de versiones los marcara todos como modificados. Tener un solo símbolo o modelo por archivo de biblioteca se ajusta al funcionamiento del control de versiones y permite llevar un seguimiento exacto de lo que se ha modificado y lo que no.

A efectos de este documento, se da por hecho que el repositorio ya se ha creado.

Uso del asistente de división de bibliotecas

Si las bibliotecas de símbolos y modelos se están creando desde cero, no hay ningún problema en garantizar que haya un solo símbolo o modelo por archivo. Sin embargo, lo habitual es que las bibliotecas de origen ya existan. Para simplificar la tarea de separar estas bibliotecas en archivos de una sola entidad para añadirlos al repositorio SVN, Altium Designer proporciona una herramienta de división: el Library Splitter Wizard. El asistente permite dividir rápidamente bibliotecas de esquemáticos (*.SchLib) y de PCB (*.PcbLib) con varios componentes en bibliotecas de componentes individuales. Se puede acceder al asistente desde el menú Tools del editor de bibliotecas de esquemáticos, del editor de bibliotecas de PCB y del editor de bibliotecas de base de datos SVN.

Divida las bibliotecas de origen en archivos con un solo símbolo o modelo mediante el Library Splitter Wizard.

La configuración del proceso de división implica los siguientes pasos:

1. Añadir los archivos de biblioteca de origen que desee dividir (no es necesario que se encuentren en la misma carpeta). Utilice la página Libraries to Split para elegir las bibliotecas de esquemáticos o de PCB que desee dividir. Haga clic en el botón Add para abrir un cuadro de diálogo en el que podrá buscar y añadir las bibliotecas deseadas a la lista. Las bibliotecas añadidas se dividirán en bibliotecas de componentes individuales más adelante en el asistente. No es necesario que las bibliotecas de origen se encuentren en la misma carpeta. Utilice el botón Remove para eliminar de la lista una biblioteca seleccionada.

   

2. Especificar el directorio de salida. La página Output Directories se utiliza para establecer los directorios de salida de las bibliotecas de componentes individuales. El Output Directory que aparece en la lista es la ruta en la que se guardarán las bibliotecas divididas. Haga clic en Change Output Directory para actualizar el directorio seleccionado en la lista, si es necesario. Se abrirá un cuadro de diálogo en el que podrá buscar y seleccionar la nueva carpeta del directorio de salida.

   De forma predeterminada, el directorio de salida será el mismo en el que se almacena la biblioteca de origen. Debe tener cuidado si todas las bibliotecas originales se almacenan en la misma carpeta de origen. Si no se especifican los directorios de salida y se mantienen sus valores predeterminados, que apuntan a la misma carpeta de origen, puede acabar con una gran cantidad de bibliotecas de símbolos y modelos individuales mezcladas. Clasificarlas al crear la estructura del repositorio puede llevar mucho tiempo.

   

   Dado que los archivos de biblioteca divididos se añadirán al repositorio SVN, puede ser conveniente crear localmente, en el disco duro, la estructura de carpetas que desee utilizar en el repositorio para los archivos de símbolos y modelos. Una vez definida la estructura, copie las bibliotecas de origen en sus respectivas carpetas dentro de ella. Así podrá dejar la configuración del directorio de salida de cada biblioteca de origen con sus valores predeterminados. Tras la división, los archivos de biblioteca individuales generados ya estarán en las ubicaciones correctas. A continuación, podrá eliminar la biblioteca de origen de cada carpeta y añadir las carpetas al repositorio mediante el cliente SVN que haya decidido utilizar.

3. Configurar opciones adicionales para controlar cómo se dividen las bibliotecas de origen. Para una biblioteca de componentes de esquemáticos, estas incluyen opciones que permiten eliminar la información de parámetros o modelos de cada componente, dejando únicamente el símbolo.

    
   Dos variantes de la página Dividir bibliotecas; a la izquierda: la página Dividir bibliotecas al convertir un archivo .PCBLib . A la derecha: la página Dividir bibliotecas al convertir un archivo .SCHLib .

   Puede controlar cómo se dividen las bibliotecas mediante la página Options . Utilice el menú desplegable (que se muestra en la imagen anterior) para seleccionar cómo se gestionan los nuevos archivos. Si elige Overwrite Existing Files (opción predeterminada), los archivos recién creados sobrescribirán los archivos existentes. Si elige Append Incrementing Number To File Names , la herramienta de división de bibliotecas examinará todos los directorios de salida seleccionados en la página anterior (Output Directories) y creará una lista de archivos que se protegerán para evitar que se sobrescriban. A las nuevas bibliotecas de componentes con el mismo nombre se les añadirá el sufijo "_#Increment Number".

4. Una vez especificadas las bibliotecas de origen y las opciones, el asistente realizará un análisis cuyo resultado será el conjunto de bibliotecas de un único símbolo/modelo que se crearán, presentadas en una lista para su revisión. Se muestra el nombre de cada biblioteca que se generará mediante la división, así como el nombre real del componente de esquemático/modelo de huella dentro de esa biblioteca. También se indica la biblioteca de origen. El nombre de cada biblioteca será el mismo que el del componente/modelo que contiene.

   Si se ha utilizado alguno de los siguientes caracteres en el nombre del componente/modelo, se sustituirá por un guion bajo al crear el nombre de la biblioteca: '\', '/', '!', ''', '[', ']'.

   

   Las bibliotecas de componentes que se crearán se pueden revisar en la página Review. Se muestran Splitted Library Name, Component Name y Source Library para indicar los nuevos archivos que se crearán durante el proceso de división. Puede acceder fácilmente a una lista desplegable de los datos de cada columna haciendo clic en la flecha hacia abajo situada a la derecha de cada columna. Esta función resulta especialmente útil al revisar los archivos de bibliotecas de gran tamaño.

5. Revise la lista de bibliotecas que se crearán y, a continuación, haga clic en Next para continuar con el proceso de división y obtener las bibliotecas que se añadirán al repositorio de control de versiones. Una vez completado correctamente el asistente, haga clic en Finish para cerrarlo.

   

Uso del asistente de conversión a bibliotecas de base de datos SVN

Otra forma de convertir bibliotecas existentes en una biblioteca de base de datos de tipo SVN es utilizar el asistente de conversión a bibliotecas de base de datos SVN. Este asistente convierte bibliotecas de esquemáticos, de PCB, de base de datos e integradas en bibliotecas de base de datos SVN. El asistente ofrece varias opciones de conversión, entre ellas cómo deben dividirse las bibliotecas de origen, en qué directorios de qué repositorio deben almacenarse y cuál será el directorio de salida del archivo SVNDbLib y del archivo de base de datos MDB creados. 

Se puede acceder al asistente desde el menú Tools al editar un documento de biblioteca de PCB o de esquemáticos.

El asistente divide las bibliotecas de símbolos y huellas y las incorpora a un repositorio, y crea los archivos SVNDbLib y de base de datos de Access.

¿Cómo continuar?

Consulte las siguientes páginas para obtener más información sobre los distintos aspectos del trabajo con bibliotecas de base de datos:

• Creación y definición de la biblioteca de base de datos
• Modificación de una tabla de base de datos
• Modificación de símbolos y huellas