Actualización de componentes desde bases de datos y bibliotecas basadas en archivos

Ha colocado componentes en el esquema, quizás incluso lo haya conectado y compilado por completo, y ha llevado el diseño a la etapa de diseño de la placa. Lo más probable es que llegue un momento en el que sea necesario modificar un componente: añadir un parámetro, cambiar un enlace a un modelo o quizás modificar gráficamente un símbolo o una huella.

Lo lógico es realizar el cambio en el origen. La naturaleza de este origen depende de cómo se haya colocado el componente:

• From an Integrated Library - se extraen las bibliotecas de origen, se realiza el cambio y se compila el paquete de biblioteca integrada para generar la biblioteca integrada revisada.
• From a Database Library - si se trata de un parámetro o de una referencia a un símbolo/modelo, el cambio se realiza en el registro correspondiente al componente en la base de datos externa vinculada. Si el cambio es gráfico (en un símbolo o modelo), se realiza en la biblioteca de origen referenciada.
• From a Schematic/PCB Library - el cambio se realiza en el componente o la huella de la biblioteca correspondiente desde la que se colocó el componente o la huella.

También puede haber vinculado un componente colocado a una base de datos externa mediante un archivo Database Link (*.DBLink). Los cambios en los símbolos y modelos se realizan en las bibliotecas de origen. En el caso de los parámetros, los cambios se realizan en la base de datos.

Una vez realizados los cambios, es necesario transferirlos al diseño. Altium Designer ofrece diversas herramientas de actualización que permiten transferir los cambios de los componentes a sus componentes de Altium Designer de forma rápida y eficiente. Este documento describe estas herramientas, es decir, las que permiten mantener siempre la sincronización entre el origen de los componentes y las instancias colocadas de dichos componentes.

Actualización de parámetros desde una base de datos

En el contexto de esta herramienta, el término «componente de Altium Designer» se utiliza para describir una instancia de componente colocada en una hoja de esquema o un componente de una biblioteca de esquemas de origen. Altium Designer proporciona una herramienta para actualizar los parámetros de los componentes de Altium Designer con información almacenada en una base de datos externa. Los componentes deben estar vinculados a los registros de componentes correspondientes en la base de datos externa para que sea posible actualizarlos. La vinculación se realiza mediante un archivo de enlace intermedio, que puede ser uno de los siguientes:

• Database Link archivo (*.DBLink) - se utiliza para vincular componentes existentes ya colocados a una base de datos externa o, más habitualmente, componentes definidos en una biblioteca de esquemas de origen.
• Database Library archivo (*.DBLib) - se utiliza al colocar componentes directamente en una hoja de esquema desde una base de datos externa.
• SVN Database Library archivo (*.SVNDBLib) - igual que para un *.DBLib, pero con las bibliotecas de símbolos y modelos almacenadas bajo control de versiones.

Las actualizaciones se realizan desde el editor de esquemas seleccionando el comando Tools » Update Parameters From Database, disponible en los menús principales. Al ejecutar este comando, se abrirá el cuadro de diálogo Update Parameters From Database. Utilice este cuadro de diálogo para elegir los documentos de esquema y los tipos de componentes que desea incluir en la actualización.

El cuadro de diálogo Update Parameters From Database

Tras definir el alcance de la actualización, haga clic en OK. Se consultará la base de datos externa para buscar componentes coincidentes. Si existen diferencias en los parámetros entre los componentes de Altium Designer y los registros coincidentes de la base de datos, se abrirá el cuadro de diálogo Select Parameter Changes. Si no se encuentran diferencias, se abrirá un cuadro de diálogo que lo indicará.

El cuadro de diálogo Select Parameter Changes

Este cuadro de diálogo enumera todos los parámetros que existen en los registros de la base de datos de los componentes vinculados de Altium Designer incluidos en el alcance de la actualización. Los parámetros definidos para un componente de Altium Designer que no sean un campo de una tabla de la base de datos no aparecerán en la lista. Por ejemplo, puede haber colocado un componente directamente desde una base de datos mediante la función de biblioteca de base de datos y haber añadido uno o más parámetros después de colocarlo.

Solo se enumeran los parámetros que tienen una correspondencia entre la base de datos externa y la instancia del componente colocado. La asignación de parámetros se realiza en la pestaña Field Mappings del archivo de enlace intermedio.

El cuadro de diálogo mostrará inicialmente las actualizaciones propuestas para sincronizar los parámetros de los componentes de Altium Designer con los de la base de datos, según las acciones de actualización que haya definido en el archivo de enlace intermedio (*.DbLink, *.DbLib o *.SvnDbLib).

Las diferencias entre parámetros se distinguen mediante un icono específico insertado en la celda correspondiente. Por ejemplo, un triángulo azul en la esquina de una celda significa que se ha detectado una diferencia entre el valor de un parámetro del componente de Altium Designer y el mismo parámetro del registro vinculado de la base de datos.

Encontrará una lista completa de todos los estados de celda disponibles en el cuadro de diálogo Select Parameter Changes en esta página, en la sección Estados de actualización de parámetros.

Los controles del cuadro de diálogo Select Parameter Changes le permiten controlar por completo qué actualizaciones se aplican y cuáles se rechazan. Puede rechazar las actualizaciones de todos los parámetros de un componente seleccionado o de parámetros específicos de ese componente. Para rechazar una actualización propuesta para un parámetro específico, seleccione la celda correspondiente y haga clic en el botón Reject Selected. Para restablecer la actualización, haga clic en el botón Update Selected.

Cuando esté satisfecho con la propuesta de actualización, haga clic en el botón Accept Changes (Create ECO). Utilice el cuadro de diálogo Engineering Change Order que se abre para validar y, a continuación, ejecutar las actualizaciones correspondientes. Si detecta una actualización que no desea realizar, deshabilite la entrada correspondiente de la orden de cambio.

El cuadro de diálogo Engineering Change Order

Sincronización doble

Es posible que tenga un proyecto de diseño existente en el que la mayoría de los componentes colocados se hayan vinculado a una base de datos externa mediante un archivo DbLink. Los cambios en el diseño pueden dar lugar a circuitos adicionales, cuyos componentes podrían colocarse mediante la función Biblioteca de base de datos. Es perfectamente posible que el archivo DbLib/SVNDbLib asociado apunte a una base de datos externa diferente.

Al utilizar el comando Update Parameters From Database, se consultarán todos los parámetros vinculados de los componentes colocados en todas las bases de datos vinculadas, independientemente del método de vinculación utilizado, y las diferencias detectadas para esos parámetros se mostrarán en el cuadro de diálogo Seleccionar cambios de parámetros.

Actualización de componentes del esquema desde bibliotecas

Altium Designer proporciona una herramienta para actualizar los componentes colocados en una hoja de esquema con información modificada de una biblioteca de origen. Esto incluye bibliotecas de componentes de esquema (*.SchLib), bibliotecas integradas (*.IntLib) y bibliotecas de base de datos (*.DBLib, *.SVNDBLib).

Aunque los archivos DBLib y SVNDBLib aparecen como bibliotecas en el panel Componentes, solo proporcionan información de conexión y asignación de campos, y no son bibliotecas en el sentido estricto de la palabra. La función de actualización transfiere los cambios realizados en los parámetros y en las referencias a símbolos y modelos de la base de datos externa, así como las modificaciones gráficas realizadas en las bibliotecas de símbolos y modelos referenciadas.

La función de actualización permite transferir cambios en los parámetros, así como en la información de modelos y gráficos.

Las actualizaciones se realizan desde el documento de esquema seleccionando el comando Tools » Update From Libraries, disponible en los menús principales. Al ejecutar este comando, se abrirá el cuadro de diálogo Update From Library. El comando Update From Libraries actualiza todos los componentes de la hoja de esquema con información modificada de una biblioteca de origen.

Las actualizaciones también se realizan desde el documento de esquema seleccionando el comando Tools » Update Selected From Libraries, disponible en los menús principales. El comando Update Selected From Libraries actualiza únicamente los componentes seleccionados de la hoja de esquema con información modificada de una biblioteca de origen.

El cuadro de diálogo Update From Library

Definición del alcance de la actualización

La primera página del cuadro de diálogo aborda el alcance de la actualización, es decir, qué documentos de esquema de origen se incluirán en la actualización y los tipos específicos de componentes que contienen.

La región Schematic Sheets cargará todos los documentos de esquema a los que se puede aplicar la actualización. Puede tratarse de un único documento de esquema independiente o de todas las hojas de esquema del proyecto activo. Habilite los documentos cuyos componentes desee tener en cuenta en la actualización.

A medida que habilite o deshabilite entradas de la lista Schematic Sheets mediante las casillas de verificación o los comandos All On / All Off del menú contextual, los componentes físicos que contienen se mostrarán en la región Component Types del cuadro de diálogo. Para cada componente se indica:

• Nombre del componente físico
• Símbolo lógico asociado
• Biblioteca de origen desde la que se colocó
• Número de instancias colocadas actualmente en todos los documentos de esquema habilitados.

La inclusión de componentes en la lista depende de las opciones disponibles en la parte inferior izquierda de la página. Utilice el campo Show para determinar los tipos de componentes incluidos en la actualización. De forma predeterminada, está seleccionado All Components, pero puede optar por actualizar únicamente:

• Standard Components - los colocados desde una biblioteca de esquemas o una biblioteca integrada.
• Database Components - los colocados desde una base de datos externa mediante un archivo DBLib o SVNDBLib.

El campo Show del cuadro de diálogo Update From Library

Todos los tipos de componentes están inicialmente habilitados para incluirse en la actualización. Deshabilita los que no quieras actualizar. Como alternativa, selecciona los componentes exactos que quieras actualizar directamente en las hojas del esquema antes de abrir el cuadro de diálogo. A continuación, habilita la opción Selected Parts Only. Solo aparecerán en la lista los componentes de tu selección. También puedes usar los comandos All On / All Off del menú contextual.

Usa la opción Include Variants para incluir variantes y/o la opción Update to Latest Revision para actualizar los componentes colocados desde una biblioteca de Workspace a sus últimas revisiones disponibles. Usa estas opciones para actualizar los parámetros de los componentes alternativos.

Lo más importante es recordar que siempre tienes pleno control sobre lo que se incluye en la actualización.

Definir las acciones de actualización predeterminadas

En la sección Settings de la página puedes definir el nivel de actualización predeterminado que se requiere. Las acciones de actualización predeterminadas que definas aquí se aplicarán a todas las instancias de los componentes de los tipos habilitados.

La sección Actions del cuadro de diálogo Update From Library

La forma más sencilla de actualización consiste en sustituir por completo los componentes de las hojas del esquema por los definidos en la biblioteca de origen: Fully replace symbols on sheet with those from library. Los atributos gráficos, los parámetros y los enlaces a modelos se actualizan directamente con la información existente en la biblioteca de origen. Al seleccionar esta opción, se habilitan las siguientes opciones. Selecciona todas las que correspondan:

• Update designator lock field (ver imagen)
• Update part ID lock field (ver imagen)
• Preserve parameter locations
• Preserve parameter visibility

La sustitución completa (Fully replace symbols on sheet with those from library) está habilitada de forma predeterminada. Si quieres tener un poco más de control sobre lo que se actualiza, cambia a Replace selected attributes of symbols on sheets. Las opciones de actualización individuales (Update graphical attributes, Update parameters, Update models) estarán disponibles para incluirlas o excluirlas según sea necesario.

Las definiciones de la primera página del cuadro de diálogo Update From Library y del cuadro de diálogo Library Update Settings son persistentes. Se almacenan en el archivo del proyecto al guardarlo.

Para las acciones de actualización de parámetros y modelos, puedes obtener un mayor control en el cuadro de diálogo Library Update Settings. Accede a él haciendo clic en el botón Advanced. Este cuadro de diálogo no solo te permite definir las acciones de actualización globales predeterminadas para los parámetros y modelos, sino también controlar qué parámetros y modelos específicos se incluyen en la actualización.

Acceder al cuadro de diálogo Library Update Settings

Después de definir el alcance de la actualización según sea necesario y las acciones predeterminadas que se llevarán a cabo, puedes hacer clic en Finish y, a continuación, revisar y ejecutar los cambios que se implementarán mediante la orden de cambio de ingeniería (ECO) que se genere. Si quieres ajustar aún más la actualización para cada componente antes de generar la ECO, haz clic en Next para acceder a la segunda página del cuadro de diálogo, que se detalla en la siguiente sección.

Controlar la actualización por instancia de componente

Las definiciones de la segunda página del cuadro de diálogo Update From Library no son persistentes. Se perderán si vuelves a la primera página o cierras el cuadro de diálogo.

La segunda página del cuadro de diálogo Update From Library presenta una tabla detallada que enumera todas las instancias de componentes incluidas en el proceso de actualización previsto. La página anterior del cuadro de diálogo te permitía especificar, de forma general, qué tipos de componentes físicos se incluyen en la actualización. Esta página te permite ajustar con precisión qué instancias de esos tipos de componentes se actualizan.

La segunda página del cuadro de diálogo Update From Library

La tabla se divide en tres secciones:

• Schematic Parts - esta área muestra Designator, Comment, Physical Component y Logical Symbol de cada componente colocado en las hojas del esquema. Marca la casilla Update para actualizar el componente seleccionado.
• Library Components - esta área muestra Physical Component, Logical Symbol, Library Name y Life Cycle State del componente de la biblioteca correspondiente a cada componente del esquema enumerado. Normalmente, se trata de la misma biblioteca de origen desde la que se colocó originalmente el componente, pero puedes sustituirlo por completo por otro de la misma biblioteca o de una distinta. Los componentes que no se encuentren en las bibliotecas disponibles actualmente aparecen como <Not Found>.
• Actions - las acciones de actualización específicas necesarias para cada instancia de componente cuya casilla Update  esté marcada. Inicialmente, estas se establecerán de acuerdo con los ajustes de acción predeterminados definidos en la primera página del cuadro de diálogo. Haga clic en la casilla para habilitar o deshabilitar la acción para el componente seleccionado, o utilice los comandos del menú contextual.
  • Full Replace - marque la casilla para sustituir por completo los elementos seleccionados.
  • Graphical - marque la casilla para realizar una actualización gráfica de los elementos seleccionados.
  • Parameters - marque la casilla para actualizar los parámetros de los elementos seleccionados. Si hay al menos un componente con esta casilla habilitada, puede hacer clic en el botón Parameters Changes para controlar de forma selectiva los cambios a nivel de parámetro: más información.
  • Models - marque la casilla para actualizar los modelos de los elementos seleccionados.

Para cada componente, la entrada correspondiente al componente de la biblioteca de origen será inicialmente la que se utilizó para colocar la instancia del componente. Esta información se obtiene de la región Library Link del panel Properties del componente colocado.

Especificación de un componente alternativo

Normalmente, la actualización consiste en trasladar los cambios realizados en el componente físico original de la biblioteca de origen a las instancias de ese mismo componente físico colocadas en las hojas de esquemático. En ocasiones, puede que desee cambiar por completo el componente físico colocado en el diseño. Esto se puede especificar fácilmente como parte de la actualización.

Puede especificar un componente alternativo para una instancia de componente editando directamente el campo Physical Component correspondiente en la región Library Components. Si el componente físico especificado no existe en ninguna de las bibliotecas añadidas actualmente a la lista de bibliotecas basadas en archivos disponibles del proyecto, se introducirá la entrada <Not Found> en los campos Logical Symbol y Library Name. En este caso, no será posible actualizar esa instancia de componente.

Al buscar un componente de base de datos, la búsqueda solo puede realizarse en los archivos DBLib y SVNDBLib cargados actualmente (Available Filed-based Libraries). No se pueden buscar componentes de base de datos en una ruta de búsqueda especificada.

Como alternativa, seleccione una instancia de componente en la tabla y haga clic en el botón Choose Component. Se abrirá el cuadro de diálogo Replace Component, donde podrá buscar el componente de sustitución necesario en cualquiera de las bibliotecas disponibles actualmente.

Acceso al cuadro de diálogo Replace Component (File-based)

Cuando se elija un componente válido, la información correspondiente se introducirá en la región Library Components de la página y sustituirá la del componente original de la biblioteca de origen.

Si desea volver a la biblioteca de origen original y conservar el componente físico original, seleccione la instancia de componente en la tabla y haga clic en el botón Return Selected to Default.

Control de los cambios en los parámetros

Los cambios individuales a nivel de parámetro de una instancia de componente solo se mostrarán si la opción Full Replace está deshabilitada y la opción Parameters está habilitada en la región Actions de la página. Si desea examinar los cambios individuales en los parámetros propuestos por la actualización, haga clic en el botón Parameters Changes. Se abrirá el cuadro de diálogo Select Parameter Changes, que resume los cambios en los parámetros de las instancias de componente que tienen habilitada una acción de actualización de parámetros. En la ilustración siguiente, observe que las instancias de componente C1, C3, C7 y C10 tienen deshabilitada su acción de actualización de parámetros y, por lo tanto, no aparecen en el cuadro de diálogo.

Acceso al cuadro de diálogo Select Parameter Changes

Al igual que con la herramienta Update Parameters From Database, el cuadro de diálogo mostrará todos los parámetros asignados de las instancias de componente vinculadas a una base de datos externa. Además, también se mostrarán todos los parámetros encontrados en las instancias de componente colocadas que intervienen en la actualización de parámetros. Esta es una diferencia clave al acceder al cuadro de diálogo Select Parameter Changes desde las dos herramientas de actualización.

De nuevo, el cuadro de diálogo muestra los cambios propuestos para volver a sincronizar los parámetros de los componentes colocados con los de los componentes de la biblioteca o base de datos de origen correspondiente. Las actualizaciones propuestas se ajustan a las acciones de actualización definidas en:

• La región Parameter Settings del cuadro de diálogo Ajustes de actualización de bibliotecas, cuando el origen de la actualización es una biblioteca de esquemáticos o una biblioteca integrada.
• El archivo de enlace intermedio (*.DBLink, *.DBLib, *.SVNDBLib) cuando el origen de la actualización es una base de datos.

Las diferencias entre parámetros se resaltan mediante un icono específico insertado en la celda correspondiente. Consulte la siguiente sección (Parameter Update States) para ver una lista completa de todos los estados posibles de las celdas.

Utilice los controles disponibles en el cuadro de diálogo (botones o menú contextual) para determinar qué cambios en los parámetros se aplicarán y cuáles se rechazarán, lo que le permite anular las condiciones de actualización predeterminadas a nivel de parámetro individual. Recuerde que rechazar una actualización propuesta en una celda significa que no desea que se realice ningún cambio en ese parámetro para esa instancia de componente concreta de la hoja de esquemático.

Estados de actualización de los parámetros

Una celda del cuadro de diálogo Select Parameter Changes puede presentar distintos estados de actualización en función de las diferencias exactas detectadas entre los componentes colocados y la biblioteca o base de datos de origen, así como de las acciones de actualización de parámetros aplicables que se hayan especificado. La siguiente tabla enumera los posibles estados de las celdas.

Cell State	Description
	Tanto el componente de Altium Designer como el componente de la biblioteca/base de datos poseen el parámetro y su valor es el mismo. La actualización no producirá ningún cambio.
	Tanto el componente de Altium Designer como el componente de la biblioteca/base de datos poseen el parámetro, pero no tiene ningún valor asignado. La actualización no producirá ningún cambio.
	Ni el componente de Altium Designer ni el componente de la biblioteca/base de datos poseen el parámetro. La actualización no producirá ningún cambio. Este estado también puede aparecer si se impide que el parámetro del componente de Altium se incluya en una actualización al desactivar las opciones Allow Synchronization With Library y/o Allow Synchronization With Database en el panel Properties asociado.
	Tanto el componente de Altium Designer como el componente de la biblioteca/base de datos poseen el parámetro, pero con valores diferentes. La actualización asignará el valor de la base de datos.
	Tanto el componente de Altium Designer como el componente de la biblioteca/base de datos poseen el parámetro. En el componente de Altium Designer tiene un valor asignado, pero en la base de datos no. La actualización asignará el valor de la base de datos; en este caso, ningún valor.
	El componente de Altium Designer no posee el parámetro, pero el componente de la biblioteca/base de datos sí. La actualización añadirá el parámetro al componente de Altium Designer con el valor mostrado en la celda.
	El componente de Altium Designer no posee el parámetro, pero el componente de la biblioteca/base de datos sí. La actualización añadirá el parámetro al componente de Altium Designer sin ningún valor asignado inicialmente.
	El componente de Altium Designer posee el parámetro, pero el componente de la biblioteca/base de datos no. La actualización eliminará el parámetro del componente de Altium Designer. Note: Si la instancia del componente se está actualizando desde una base de datos externa y la correspondencia entre el campo de la base de datos y el parámetro del diseño está configurada como, el parámetro se tratará como si no existiera en el registro de la base de datos, aunque exista.
	Existe una diferencia entre los valores del parámetro del componente de Altium Designer y del componente de la biblioteca/base de datos. La propuesta de actualizarlo al valor de la base de datos se ha rechazado debido al valor actual de la opción Update Values en el documento de vinculación con la base de datos (archivo DbLink, DbLib o SvnDbLib). No se producirá ningún cambio. Tenga en cuenta que los comandos Update Selected y Update All de este cuadro de diálogo anularán este estado y forzarán una actualización.
	El componente de Altium Designer no posee el parámetro, pero el componente de la biblioteca/base de datos sí. La actualización propuesta para añadir el parámetro al componente de Altium Designer se ha rechazado debido al valor actual de la opción Add To Design . No se producirá ningún cambio. Tenga en cuenta que los comandos Update Selected y Update All de este cuadro de diálogo anularán este estado y forzarán una actualización.
	El componente de Altium Designer posee el parámetro, pero el componente de la biblioteca/base de datos no. La actualización propuesta para eliminar el parámetro del componente de Altium Designer se ha rechazado debido al valor actual de la opción Remove From Design en el documento de vinculación con la base de datos (archivo DbLink, DbLib o SvnDbLib). No se producirá ningún cambio. Tenga en cuenta que los comandos Update Selected y Update All de este cuadro de diálogo anularán este estado y forzarán una actualización.

Aplicación de cambios directamente desde el editor de bibliotecas de esquemas

La actualización directa de los componentes colocados en los esquemas puede realizarse desde una biblioteca de esquemas de origen. Este método resulta especialmente adecuado para actualizar componentes que se han colocado desde bibliotecas independientes de componentes de esquemas (*.SchLib), cuando dichas bibliotecas forman parte de las bibliotecas basadas en archivos disponibles para el proyecto.

Las modificaciones realizadas en los componentes de una biblioteca de esquemas de origen se transfieren a los documentos de esquema mediante el comando Tools » Update Schematics, disponible en los menús principales del editor de bibliotecas de esquemas. Como alternativa, los cambios en los componentes seleccionados pueden aplicarse seleccionando dichos componentes en el panel SCH Library y utilizando el comando de actualización del menú contextual.

Desde una biblioteca de esquemas de origen, los cambios pueden aplicarse mediante el menú contextual del panel SCH Library

Se actualizarán todas las instancias de los componentes colocados en todos los documentos de esquema abiertos, independientemente del proyecto al que pertenezca cada documento. En esencia, si un componente colocado tiene el mismo valor en su campo Physical Component que el componente de la biblioteca, se actualizará. Se le notificará cuántos componentes (y en cuántos documentos) se han modificado durante el proceso de actualización. La actualización sustituye por completo cada instancia existente del componente por la de la biblioteca.

Verificación de una actualización

Después de actualizar los componentes colocados en los esquemas, los componentes de las bibliotecas de esquemas o las huellas de PCB, naturalmente querrá verificar que la actualización se haya realizado según lo previsto. Las siguientes secciones explican cómo comprobar rápidamente que los parámetros, los vínculos a modelos y los atributos gráficos se han actualizado correctamente.

Comprobación de las actualizaciones de parámetros

Puede comprobar que los parámetros se han actualizado correctamente abriendo el cuadro de diálogo Parameter Table Editor (Tools » Parameter Manager) o consultando los parámetros de un componente seleccionado a través del panel Properties.

A continuación, cada uno de los componentes C1, C2 y C3 ha recibido un nuevo parámetro TestParam, con el valor Test, como parte de un proceso de actualización.

El cuadro de diálogo Parameter Table Editor

Comprobación de las actualizaciones de vínculos a modelos

Las actualizaciones de los vínculos a modelos de un componente pueden verificarse en la sección Models del panel Properties asociado.

Comprobación de las actualizaciones gráficas

La forma más sencilla de comprobar las actualizaciones gráficas es comparar el componente del diseño en la hoja con el componente de la biblioteca de origen. Este último puede visualizarse fácilmente mediante el panel Components, que permite compararlos directamente uno al lado del otro.