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

Ha colocado componentes en el esquemático, quizá incluso los haya cableado por completo, compilado y 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 realizar un cambio en un componente: agregar un nuevo parámetro, cambiar un enlace de modelo o quizá modificar un símbolo o una huella a nivel gráfico.

El lugar lógico para realizar un cambio es en el origen. La naturaleza de este origen depende de cómo se colocó el componente:

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

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

Una vez realizados los cambios, estos deben transferirse al diseño. Altium ofrece una variedad de herramientas de actualización que le permiten transferir de forma rápida y eficiente los cambios de componentes a sus componentes de Altium Designer. Este documento detalla esas herramientas: herramientas que le permiten mantener siempre la sincronización entre el origen de sus componentes y las instancias colocadas de esos 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 esquemática o un componente en una biblioteca esquemática fuente. 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 enlazados a los registros de componentes correspondientes en la base de datos externa para que la actualización sea posible. El enlace se realiza mediante el uso de un archivo de vinculación intermediario, que puede ser uno de los siguientes:

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

Las actualizaciones se realizan desde el Editor Esquemático eligiendo 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 qué documentos esquemáticos y tipos de componentes desea incluir en la actualización.

El cuadro de diálogo Update Parameters From Database

Después de definir el alcance de la actualización, haga clic en OK. Se consultará la base de datos externa en busca de componentes coincidentes. Si existen diferencias de parámetros entre los componentes de Altium Designer y los registros coincidentes en la base de datos, se abrirá el cuadro de diálogo Select Parameter Changes.

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 para los componentes de Altium Designer enlazados que se encuentran dentro del alcance de la actualización. Cualquier parámetro definido para un componente de Altium Designer pero que no sea un campo de una tabla de base de datos no aparecerá 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 luego haber agregado uno o más parámetros después de la colocación.

Solo se enumeran los parámetros que están mapeados entre la base de datos externa y la instancia del componente colocado. El mapeo de parámetros se realiza en la pestaña Field Mappings del archivo de enlace intermediario.

El cuadro de diálogo mostrará inicialmente las actualizaciones propuestas para sincronizar los parámetros del componente de Altium Designer con los de la base de datos, según las acciones de actualización que haya definido en su archivo de enlace intermediario (DBLink, DBLib, SVNDBLib).

Las diferencias de parámetros se distinguen mediante el uso de un icono único 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 en el componente de Altium Designer y el mismo parámetro en el registro de base de datos enlazado.

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

Los controles proporcionados en el cuadro de diálogo Select Parameter Changes le permiten controlar por completo qué actualizaciones se realizarán y cuáles se rechazarán. Puede rechazar las actualizaciones de todos los parámetros para un componente seleccionado o para 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 solución de actualización, haga clic en el botón Accept Changes (Create ECO). Use el cuadro de diálogo Engineering Change Order que se abre para validar y luego ejecutar las actualizaciones según corresponda. Si se da cuenta de que hay una actualización con la que realmente no desea continuar, desactive la entrada de orden de cambio aplicable.

El cuadro de diálogo Engineering Change Order

Sincronización dual

Puede que tenga un proyecto de diseño existente en el que la mayoría de las piezas colocadas se hayan vinculado a una base de datos externa mediante un archivo DbLink. Los cambios de diseño pueden dar lugar a circuitería adicional, cuyos componentes podrían colocarse utilizando 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 esquemáticos desde bibliotecas

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

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

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

Las actualizaciones se realizan desde el documento esquemático eligiendo 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 esquemática con la información modificada de una biblioteca de origen.

Las actualizaciones también se realizan desde el documento esquemático eligiendo el comando Tools » Update Selected From Libraries disponible en los menús principales. El comando Update Selected From Libraries actualiza solo los componentes seleccionados en la hoja esquemática 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 trata del alcance de la actualización: qué documentos esquemáticos de origen se incluirán en la actualización y los tipos específicos de componentes que contienen.

La región Schematic Sheets del cuadro de diálogo cargará todos los documentos esquemáticos posibles a los que se puede aplicar la actualización. Puede tratarse de un único documento esquemático independiente o de todas las hojas esquemáticas del proyecto activo. Habilite aquellos documentos cuyos componentes desea que se tengan en cuenta en la actualización.

A medida que habilita o deshabilita entradas en la lista Schematic Sheets usando casillas de verificación o los comandos All On / All Off del menú contextual, los componentes físicos constituyentes se mostrarán en la región Component Types del cuadro de diálogo. Cada componente se enumera en términos de:

• 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 esquemáticos habilitados.

La inclusión de componentes en la lista se ajusta a las opciones disponibles en la parte inferior izquierda de la página. Use el campo Show para determinar los tipos de componentes incluidos en la actualización. De forma predeterminada, se selecciona All Components, pero puede optar por actualizar solo:

• Standard Components - los colocados desde una biblioteca esquemática o una biblioteca integrada.
• Database Components - los colocados desde una base de datos externa mediante una DBLib o SVNDBLib.

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

Todos los tipos de componentes están habilitados inicialmente para su inclusión en la actualización. Desactive cualquiera que definitivamente no desee actualizar. Como alternativa, seleccione los componentes exactos que desea actualizar, directamente en la(s) hoja(s) esquemática(s), antes de abrir el cuadro de diálogo. Luego habilite la opción Selected Parts Only. Solo aparecerán en la lista esos componentes de su selección. También puede usar los comandos All On / All Off del menú contextual.

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

Lo principal que debe recordar es que siempre tiene el control total sobre lo que se incluye en la actualización.

Definición de acciones de actualización predeterminadas

La región Settings de la página es donde puede definir el nivel predeterminado de actualización requerido. Las acciones de actualización predeterminadas que defina aquí se aplicarán a todas las instancias de componentes de los tipos de componentes habilitados.

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

La forma más sencilla de actualización es reemplazar por completo los componentes de la(s) hoja(s) esquemática(s) 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 de modelo se actualizan directamente con la información que existe en la biblioteca de origen. Cuando se selecciona esta opción, se habilitan las siguientes opciones. Seleccione todas las que correspondan:

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

El reemplazo completo (Fully replace symbols on sheet with those from library) está habilitado de forma predeterminada. Si desea un poco más de control sobre lo que se actualiza, cambie a Replace selected attributes of symbols on sheets. Las opciones de actualización individuales (Update graphical attributes, Update parameters, Update models) pasarán a estar disponibles para su inclusión o exclusión 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 guardar.

Para las acciones de actualización de parámetros y modelos, se ofrece todavía más control mediante el cuadro de diálogo Library Update Settings. Acceda a este cuadro de diálogo haciendo clic en el botón Advanced. Con este cuadro de diálogo no solo puede definir las acciones de actualización globales predeterminadas para parámetros y modelos, sino también controlar qué parámetros y modelos específicos se incluyen en la actualización.

Acceso al cuadro de diálogo Library Update Settings

Después de definir según sea necesario el alcance de la actualización y las acciones predeterminadas que se llevarán a cabo, puede hacer clic en Finish y luego revisar y ejecutar los cambios que se implementarán en la subsiguiente Engineering Change Order que se genere. Si desea refinar aún más la actualización por componente antes de generar la ECO, haga clic en Next para acceder a la segunda página del cuadro de diálogo, detallada en la siguiente sección.

Control de 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 vuelve a la primera página o cierra el cuadro de diálogo.

La segunda página del cuadro de diálogo Update From Library presenta una cuadrícula detallada que enumera todas las instancias de componentes implicadas en el proceso de actualización previsto. La página anterior del cuadro de diálogo le permitió especificar, a un nivel general, qué tipos de componentes físicos se incluyen en la actualización. Esta página le permite ajustar con precisión qué instancias de componentes de esos tipos se actualizarán exactamente.

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

La cuadrícula está dividida en tres regiones:

• Schematic Parts - esta área enumera el Designator, Comment, Physical Component, y Logical Symbol de cada componente colocado en la(s) hoja(s) esquemática(s). Habilite la casilla de verificación Update  para actualizar el componente seleccionado.
• Library Components - esta área enumera el Physical Component, Logical Symbol, Library Name, y Life Cycle State del componente de biblioteca para cada parte esquemática enumerada. Normalmente, esta es la misma biblioteca fuente desde la que se colocó originalmente el componente, pero también tiene la posibilidad de cambiar completamente el componente por otro, en la misma biblioteca o en una diferente. Los componentes que no se pueden encontrar en las bibliotecas disponibles actualmente aparecen como <Not Found>.
• Actions - las acciones de actualización específicas requeridas para cada instancia de componente cuya casilla Update  esté marcada. Inicialmente, estas se establecerán de acuerdo con la configuración de acción predeterminada definida en la primera página del cuadro de diálogo. Haga clic en la casilla de verificación para habilitar/deshabilitar la acción para el componente seleccionado o use los comandos del menú contextual.
  • Full Replace - marque la casilla para realizar un reemplazo completo de 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 selectivamente 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 del componente de biblioteca fuente será inicialmente la utilizada para colocar la instancia del componente en primer lugar. Esta información se toma de la región Library Link del panel Properties del componente colocado.

Especificar un componente alternativo

Normalmente, la actualización implicará transferir a la(s) instancia(s) colocada(s) de ese mismo componente físico en la(s) hoja(s) esquemática(s) los cambios realizados en el componente físico original de la biblioteca fuente. Puede haber ocasiones en las que desee cambiar por completo el componente físico colocado en el diseño. Esto puede especificarse 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 agregadas actualmente a la lista de Available Filed-based Libraries del proyecto, la entrada <Not Found> se introducirá en los campos Logical Symbol y Library Name. En este caso, la actualización no será posible para 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 es posible buscar componentes de base de datos a lo largo de una ruta de búsqueda especificada.

Como alternativa, seleccione una instancia de componente en la cuadrícula y luego haga clic en el botón Choose Component. Aparecerá el cuadro de diálogo Replace Component, desde donde puede buscar el componente de reemplazo requerido en cualquiera de las bibliotecas actualmente disponibles.

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

Cuando se elige un componente válido, la información correspondiente del componente elegido se introducirá en la región Library Components de la página, sobrescribiendo el componente original de la biblioteca fuente.

Si desea volver a la biblioteca fuente original, manteniendo el componente físico original, seleccione la instancia del componente en la cuadrícula y luego haga clic en el botón Return Selected to Default.

Control de los cambios de parámetros

Los cambios individuales a nivel de parámetro para una instancia de componente se mostrarán solo 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 de 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 de parámetros para aquellas instancias de componentes que tienen habilitada una acción de actualización de parámetros. En la ilustración siguiente, observe que las instancias de componentes 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 enumerará todos los parámetros asignados para aquellas instancias de componentes vinculadas a una base de datos externa. Además, también se enumerarán todos los parámetros encontrados en las instancias de componentes colocadas implicadas en la actualización de parámetros. Esta es una diferencia clave al acceder al cuadro de diálogo Select Parameter Changes entre estas dos herramientas de actualización.

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

• La región Parameter Settings del cuadro de diálogo Library Update Settings cuando el origen de la actualización es una biblioteca esquemática o integrada.
• El archivo de vínculo intermedio (*.DBLink, *.DBLib, *.SVNDBLib) cuando el origen de la actualización es una base de datos.

Las diferencias de parámetros se resaltan mediante el uso de un icono único insertado en la celda correspondiente. Consulte la siguiente sección (Parameter Update States) para obtener una lista completa de todos los estados posibles de celda.

Use los controles disponibles en el cuadro de diálogo (botones o menú contextual) para determinar con qué cambios de parámetros continuar y cuáles rechazar, lo que le da la posibilidad de 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 concreta del componente en la hoja esquemática.

Estados de actualización de parámetros

Hay varios estados de actualización diferentes en los que se puede colocar una celda del cuadro de diálogo Select Parameter Changes, según las diferencias exactas detectadas entre los componentes colocados y la biblioteca/base de datos de origen, así como las acciones de actualización de parámetros especificadas que correspondan. La siguiente tabla enumera los posibles estados de las celdas.

Cell State	Description
	El componente de Altium Designer y el componente de la biblioteca/base de datos poseen ambos el parámetro, y el valor es el mismo. La actualización no producirá ningún cambio.
	El componente de Altium Designer y el componente de la biblioteca/base de datos poseen ambos el parámetro, pero no tiene ningún valor asignado. La actualización no producirá ningún cambio.
	El componente de Altium Designer y el componente de la biblioteca/base de datos no 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 deshabilitar las opciones Allow Synchronization With Library y/o Allow Synchronization With Database en el panel Properties asociado.
	El componente de Altium Designer y el componente de la biblioteca/base de datos poseen ambos el parámetro, pero con valores diferentes. La actualización asignará el valor de la base de datos.
	El componente de Altium Designer y el componente de la biblioteca/base de datos poseen ambos el parámetro. En el componente de Altium Designer tiene un valor asignado; 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 agregará 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 agregará 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 asignación correspondiente de campo de base de datos a parámetro de diseño está configurada en, el parámetro se tratará como si no existiera en el registro de la base de datos, aunque sí exista.
	Existe una diferencia entre los valores del parámetro para el componente de Altium Designer y el componente de la biblioteca/base de datos. La propuesta de actualizar al valor de la base de datos ha sido rechazada, en función del valor actual de la opción Update Values en el documento de vinculación a 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 agregar el parámetro al componente de Altium Designer ha sido rechazada, en función del 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 ha sido rechazada, en función del valor actual de la opción Remove From Design en el documento de vinculación a 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 esquemáticas

La actualización directa de componentes esquemáticos colocados puede realizarse desde una biblioteca esquemática de origen. Este método de actualización es especialmente adecuado para actualizar componentes que se han colocado desde bibliotecas aisladas de componentes esquemáticos (*.SchLib) y cuando dichas bibliotecas forman parte de las bibliotecas basadas en archivos disponibles para el proyecto.

Las modificaciones realizadas en los componentes de una biblioteca esquemática de origen se transfieren a los documentos esquemáticos mediante el comando Tools » Update Schematics, disponible en los menús principales del editor de bibliotecas esquemáticas. Como alternativa, los cambios en los componentes seleccionados pueden aplicarse seleccionando esos componentes en el panel SCH Library y usando el comando de actualización desde el menú contextual.

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

Todas las instancias de los componentes colocados en todos los documentos esquemáticos abiertos se actualizarán independientemente del proyecto al que pertenezca un documento. Básicamente, si un componente colocado tiene la misma entrada para su campo Physical Component que el componente de biblioteca, se actualizará. Se le notificará cuántos componentes (y en cuántos documentos) han sido modificados por el proceso de actualización. La actualización es una sustitución completa de cada instancia existente del componente por la de la biblioteca.

Verificación de una actualización

Después de actualizar los componentes esquemáticos colocados, los componentes de la biblioteca esquemática o las huellas PCB, por supuesto querrá verificar que la actualización se realizó según lo previsto. Las siguientes secciones muestran cómo puede comprobar rápidamente que los parámetros, los vínculos de modelo y los atributos gráficos se han actualizado correctamente.

Comprobación de actualizaciones de parámetros

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

A continuación, los componentes C1, C2 y C3 han recibido cada uno 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 actualizaciones de vínculos de modelo

Las actualizaciones de los vínculos de modelo de un componente pueden verificarse desde la región Models del panel Properties asociado.

Comprobación de 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 mostrarse fácilmente usando el panel Components, que permite una comparación directa lado a lado.