Bibliotecas de bases de datos

Altium Designer proporciona la capacidad de colocar componentes directamente desde una base de datos corporativa, mediante la creación y el uso de un Database Library. La colocación se realiza desde el panel Components, que, después de instalar la biblioteca de base de datos, actúa como un explorador de su base de datos.

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

Colocación directa: más allá del simple vínculo

Altium Designer proporciona tres métodos para vincular un componente a una base de datos: usando respectivamente un archivo Database Link (*.DbLink), un archivo Database Library (*.DbLib) o un archivo SVN Database Library (*.SVNDbLib). El enfoque DbLink proporciona un medio eficiente para 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 toma esta eficacia de vinculación ya probada y le añade la libertad de poder 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 funcionalidad de biblioteca de base de datos, conviene analizar las diferencias entre estos métodos en cuanto a la manera de utilizarlos.

Vinculación mediante un archivo Database Link

Related page: Vinculación de componentes existentes a su base de datos corporativa

• Con este método, el archivo Database Link (*.DbLink) define la vinculación entre el componente esquemático y un registro coincidente en una base de datos. La coincidencia del registro se establece mediante la vinculación por campo clave, que puede ser un único campo clave (por ejemplo, un número de parte) o varios campos clave (mediante la definición de una cláusula Where).
• Con este método de vinculación, la información de modelo y 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 del campo clave como parte de su definición. Una vez definido esto, se agrega un archivo Database Link a su paquete de bibliotecas o proyecto de diseño, y luego puede sincronizar la información del componente (parámetros) con el contenido de los campos de la base de datos.
• Aunque no es necesario que cada componente físico definido por cada registro de base de datos se asigne a un componente único de biblioteca de Altium Designer —muchos componentes de base de datos pueden compartir el mismo símbolo de componente—, este método de vinculación se utilizaría normalmente con un enfoque de "un registro de base de datos por un componente de Altium Designer". El componente único de Altium Designer puede ser una instancia colocada en una hoja esquemática o un componente único en una biblioteca de componentes.
• Con la vinculación de base de datos de estilo DbLink, se incluye el archivo Database Link con el paquete de bibliotecas o el proyecto de diseño.

Vinculación mediante un archivo Database Library

• Con este método, el archivo Database Library (*.DbLib) también define la vinculación entre el componente esquemático y un registro coincidente en una base de datos. De nuevo, la coincidencia del registro se establece mediante vinculación por campo clave, que puede ser un único campo clave (por ejemplo, un número de parte) o varios campos clave (mediante la definición de una cláusula Where).
• La diferencia clave con este método de vinculación es que el símbolo del componente, el modelo y la información de parámetros de un componente se almacenan como parte de la definición del registro de ese componente en la base de datos externa. El componente esquemático referenciado (almacenado en una biblioteca de componentes subyacente (*.SchLib)) es solo el símbolo; no tiene modelos vinculados ni parámetros de diseño definidos.
• Cuando se coloca el componente, su información de parámetros y modelos se crea sobre la marcha, utilizando los campos correspondientes del registro coincidente en la base de datos y de acuerdo con la asignación definida. Luego, uno o más de estos parámetros se utilizarán para mantener un vínculo continuo de regreso a la base de datos, según los criterios de coincidencia definidos, lo que permitirá futuras sincronizaciones después de la colocación.
• Este método de vinculación, debido a su creación dinámica de componentes en el momento de la colocación, se presta muy bien para usarse con un enfoque de "muchos registros de base de datos por un componente de Altium Designer".
• A diferencia del estilo DbLink de vinculación de base de datos, en el que el archivo DbLink debe incluirse con el paquete de bibliotecas (o proyecto de diseño), el archivo DbLib/SVNDbLib no necesita agregarse al proyecto. La biblioteca de base de datos (DbLib) se incluye en las bibliotecas disponibles basadas en archivos, accesibles desde el panel Components. Recuerde que las bibliotecas disponibles basadas en archivos pueden estar formadas por bibliotecas del proyecto, bibliotecas instaladas o bibliotecas encontradas a lo largo de rutas de búsqueda especificadas.
• Normalmente configuraría los archivos DbLib/SVNDbLib con un enfoque orientado a bibliotecas. Por ejemplo, podría tener uno para todas las resistencias detalladas en la base de datos de su empresa, otro para los condensadores, y así sucesivamente.

DbLib frente a SVNDbLib

Una SVN Database Library es una extensión del modelo Database Library, 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, se amplían y se mantienen dentro de un repositorio basado en Subversion. El vínculo al repositorio y a la base de datos externa se define dentro de un archivo SVN Database Library (*.SVNDbLib). Y dado que este enfoque es una extensión de Database Library, a menudo se lo denomina Version-Controlled Database Library.

¿Bibliotecario o diseñador?

Existen esencialmente dos modos en los que puede 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 versiones de bibliotecas de símbolos y modelos, sino que también será responsable de configurar el archivo SVN Database Library. Esto implica:

• Conectarse a la base de datos externa de componentes.
• Definir la asignación entre registros de base de datos y parámetros/modelos de componentes.
• Especificar el vínculo 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 Components —añadiéndolo a la lista de bibliotecas disponibles basadas en archivos— 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 tener un centro de bibliotecas dedicado que, en el rol de bibliotecario, se encargará exclusivamente de la configuración y el mantenimiento de las bibliotecas de símbolos y modelos en el repositorio de control de versiones, así como de la generación de los archivos SVN Database Library. Luego, los archivos SVNDbLib se pondrán a disposición de los diseñadores de esa empresa, quienes instalarán y utilizarán los archivos de biblioteca desde los cuales colocar los componentes en sus diseños.

En una empresa más pequeña, ambas funciones pueden ser desempeñadas por la misma persona. Esa persona no solo configurará y mantendrá el repositorio de bibliotecas, sino que también utilizará los SVNDbLib definidos en su trabajo de diseño.

El repositorio de control de versiones

Related article: Uso de control de versiones externo

Los archivos de bibliotecas de símbolos y modelos deben agregarse a un repositorio Subversion (SVN). Altium Designer incluye un proveedor de control de versiones SVN, que se habilita y configura en la página Data Management - Version Control page del cuadro de diálogo Preferences. Una vez que se ha habilitado el proveedor de control de versiones SVN, puede crearse un repositorio en la página Data Management - Design Repositories del cuadro de diálogo Preferences.

Los repositorios SVN también pueden crearse y administrarse fuera de Altium Designer utilizando un cliente y servidor SVN externos, como TortoiseSVN. Se puede conectar con un repositorio existente en la Data Management - Design Repositories página del cuadro de diálogo Preferences.

Un aspecto importante que se debe tener en cuenta al agregar archivos al repositorio es que cada símbolo y modelo must be stored in its own library file. En una biblioteca normal, que puede contener cualquier cantidad de símbolos/modelos, cambiar una sola entrada haría que el sistema de control de versiones marcara todos como modificados. Tener un símbolo/modelo por archivo de biblioteca se adapta a la naturaleza del control de versiones, permitiéndole llevar un seguimiento exacto de qué se ha modificado y qué no.

Para los fines de este documento, se asume que el repositorio ya ha sido creado.

Uso del asistente Library Splitter Wizard

Si las bibliotecas para los símbolos y modelos se van a crear desde cero, no hay problema en asegurar que haya un solo símbolo/modelo por archivo. Sin embargo, normalmente las bibliotecas de origen ya existirán. Para simplificar la tarea de separar estas bibliotecas en archivos de entidad única para agregarlos al repositorio SVN, Altium Designer proporciona una herramienta de división: el Library Splitter Wizard. El asistente le permite dividir rápidamente bibliotecas esquemáticas de múltiples componentes (*.SchLib) y bibliotecas PCB (*.PcbLib) en bibliotecas de componentes individuales. Se puede acceder al asistente desde el menú Tools en el Schematic Library Editor, el PCB Library Editor y el SVN Database Library Editor.

Divida las bibliotecas de origen en un símbolo/modelo por archivo usando el Library Splitter Wizard.

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

1. Agregar los archivos de biblioteca de origen necesarios que desea dividir (no es necesario que estén en la misma carpeta). Use la página Libraries to Split para elegir la(s) biblioteca(s) esquemática(s) o PCB que desea dividir. Haga clic en el botón Add para acceder a un cuadro de diálogo donde podrá explorar y agregar la(s) biblioteca(s) deseada(s) a la lista. Las bibliotecas agregadas se dividirán posteriormente en bibliotecas de componentes individuales dentro del asistente. No es necesario que las bibliotecas de origen existan en la misma carpeta. Use 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 el/los directorio(s) de salida para las bibliotecas de componentes individuales. El Output Directory mostrado es la ruta en la que se colocarán las bibliotecas divididas. Haga clic en Change Output Directory para actualizar el directorio listado y seleccionado, si es necesario. Se abrirá un cuadro de diálogo en el que podrá explorar y seleccionar la carpeta actualizada para el directorio de salida.

   De forma predeterminada, el directorio de salida se establecerá en el mismo directorio donde se almacena la biblioteca de origen. Debe tenerse cuidado si todas las bibliotecas de origen originales están almacenadas en la misma carpeta de directorio de origen. Si no se especifican los directorios de salida y se dejan con sus valores predeterminados, apuntando a la misma carpeta de directorio de origen, puede terminar con una mezcla muy grande de bibliotecas individuales de símbolos y modelos. Revisarlas al crear la estructura del repositorio puede consumir mucho tiempo.

   

   Como los archivos de biblioteca divididos se agregarán al repositorio SVN, puede ser una buena idea configurar localmente en su disco duro la estructura de carpetas que desea tener en el repositorio, en términos de los archivos de símbolos/modelos. Una vez definida la estructura, copie las bibliotecas de origen a sus respectivas carpetas dentro de esa estructura. Después, puede simplemente 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. Luego podrá eliminar la biblioteca de origen original de cada carpeta y agregar las carpetas al repositorio, utilizando el cliente SVN que haya decidido usar.

3. Configure opciones adicionales para controlar cómo se dividen las bibliotecas de origen. Estas incluyen, para una biblioteca de componentes esquemáticos, opciones que permiten eliminar la información de parámetros y/o de modelos de cada componente constituyente, dejando solo el símbolo básico.

    
   Dos iteraciones de la página Split Libraries; a la izquierda: la página Split Libraries al convertir un archivo .PCBLib . A la derecha: la página Split Libraries al convertir un archivo .SCHLib .

   Puede controlar cómo se dividen las bibliotecas utilizando la página Options . Use la lista desplegable (mostrada en la imagen anterior) para seleccionar cómo se gestionan los archivos nuevos. Elegir Overwrite Existing Files (predeterminado) hará que cualquier archivo recién creado sobrescriba cualquier archivo existente. Si se elige Append Incrementing Number To File Names , el divisor de bibliotecas examinará todos los directorios de salida seleccionados en la página anterior (Output Directories) y creará una lista de archivos que se deben proteger para que no se sobrescriban. Las nuevas bibliotecas de componentes con el mismo nombre llevarán añadido 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 individuales de símbolos/modelos que se crearán, y que se mostrarán para su revisión. Se muestra el nombre de cada biblioteca dividida que se va a generar, así como el nombre real del componente esquemático/modelo de huella dentro de esa biblioteca. También se muestra la biblioteca de origen original. El nombre usado para una biblioteca será el mismo que el usado para el componente/modelo constituyente.

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

   

   Las bibliotecas de componentes que se crearán pueden revisarse 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. Se puede acceder fácilmente a una lista desplegable de los datos de cada columna haciendo clic en la flecha hacia abajo en el lado derecho de cada columna. Esta función resulta especialmente útil al revisar archivos de bibliotecas extremadamente grandes.

5. Revise la lista de bibliotecas que se van a crear y luego haga clic en Next para continuar con el proceso de división y, en última instancia, obtener las bibliotecas que se agregarán al repositorio de control de código fuente. Después de completar correctamente el asistente, haga clic en Finish para cerrar.

   

Uso del asistente SVN Database Library Conversion Wizard

Otro enfoque para convertir bibliotecas existentes en una biblioteca de base de datos de tipo SVN es el SVN Database Library Conversion Wizard. Este asistente convierte bibliotecas esquemáticas, PCB, de base de datos e integradas en bibliotecas de base de datos SVN. El asistente dispone de varias opciones relacionadas con la conversión, incluidas la forma en que deben dividirse las bibliotecas de origen, en qué directorios de qué repositorio deben almacenarse y el directorio de salida para los archivos SVNDbLib y la base de datos MDB creados. 

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

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

¿Qué sigue?

Consulte las siguientes páginas para obtener más información sobre 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