---
title: Entidad de referencia de firmware (v2)
slug: develop/es/entidad-de-referencia-de-firmware-v2
docTags: 
createdAt: 2025-03-11T07:03:28.938Z
---

Esta entidad contiene un arreglo de las siguientes propiedades por familia de reproductores (Cobra, Raptor, Impala, Pantera, Tiger, Pagani, Malibu y Sebring). Estos campos solo son necesarios si necesita realizar una actualización de firmware.

Para ver ejemplos de cómo actualizar el OS para una familia de reproductores en particular, consulte la sección al final de la página.

## Propiedades

- `firmwareUpdateSource` <font color="#704ae0">string</font>: La fuente enum desde la cual obtener la actualización de firmware. Los valores posibles son “Production”, “Beta”, “MinimumCompatible”, “SpecificUrl”, “None” o “Existing”. Si usa “Production”, “Beta” o “MinimumCompatible”, no es necesario definir valores adicionales.
- `firmwareUpdateStandardTargetFileName` <font color="#704ae0">string</font>: El nombre del archivo de firmware .bsfw que es el objetivo de las actualizaciones. La actualización contenida en el archivo se aplica y, si se realiza correctamente, el archivo se elimina del medio de almacenamiento que lo contiene. Si la eliminación se realiza correctamente, el sistema se reinicia. Si falla, el reproductor se comporta como si el archivo hubiera sido nombrado `*_save.bsfw` - vea a continuación. La eliminación siempre falla si la tarjeta usa un sistema de archivos NTFS o HFS+.
- `firmwareUpdateDifferentTargetFileName` <font color="#704ae0">string</font>: El nombre de un archivo de firmware .bsfw. En modo de ejecución, la actualización contenida en este archivo se aplica solo si la versión que contiene no coincide con la versión que se está ejecutando actualmente. El archivo no se elimina, pero se evita el bucle infinito porque en los arranques posteriores el número de versión será el mismo, por lo que el archivo de actualización será ignorado. En modo de rescate, la actualización siempre se aplica.
- `firmwareUpdateNewerTargetFileName` <font color="#704ae0">string</font>: El nombre de un archivo de firmware .bsfw. En modo de ejecución, la actualización contenida en el archivo se aplica solo si la versión que contiene es estrictamente más reciente que la versión que se está ejecutando actualmente. El archivo no se elimina, pero se evita el bucle infinito porque en los arranques posteriores el número de versión será el mismo, por lo que el archivo de actualización será ignorado. En modo de rescate, la actualización siempre se aplica porque la versión del modo de ejecución no puede comprobarse y el bucle infinito no ocurrirá porque el reproductor se reiniciará en modo de ejecución.
- `firmwareUpdateSaveTargetFileName` <font color="#704ae0">string</font>: El nombre de un archivo de firmware .bsfw. La actualización contenida en el archivo se aplica, pero el archivo no se elimina, porque si el reproductor se reiniciara en este punto simplemente volvería a aplicar la actualización sobre el reproductor y no se reiniciará automáticamente al aplicar actualizaciones nombradas de esta manera hasta que se retire el dispositivo de almacenamiento que contiene la actualización. Esto hace que este nombre de archivo sea útil si desea actualizar muchas unidades desde una clave USB.
- `firmwareUpdateVersion` <font color="#704ae0">string</font>: Esto puede ser una cadena vacía o el número de versión del firmware al que desea actualizar
- `firmwareUpdateSourceUrl` <font color="#704ae0">string</font>: Requerido si la fuente es “SpecificUrl”. Esto puede ser un URL de origen para la actualización de firmware.

:::hint{type="info"}
Si desea obtener un URL de BrightSign para cualquiera de los siguientes parámetros, puede encontrarlos en el archivo manifest disponible públicamente ([https://bsncloud.s3.amazonaws.com/public/FirmwareManifest.json](https://bsncloud.s3.amazonaws.com/public/FirmwareManifest.json)):
:::

- `productionReleaseURL` <font color="#704ae0">string</font>: El URL al archivo .bsfw desde el cual el reproductor obtendrá los archivos de configuración para su uso en producción
- `betaReleaseURL` <font color="#704ae0">string</font>: El URL al archivo .bsfw para la versión beta en producción
- `compatibleReleaseURL` <font color="#704ae0">string</font>: El URL al archivo .bsfw para la versión mínima compatible en producción

## Ejemplos

Todos estos ejemplos usan la familia Cobra, pero pueden sustituirse otras familias de reproductores. Estos ejemplos contienen los parámetros mínimos requeridos para cada fuente de firmware y tipo de actualización.

### Actualización a la versión Production del OS

```json
"firmwareUpdateType": "standard",
"firmwareUpdatesByFamily":{
  "Cobra":{
    "firmwareUpdateSource":"production",
    "firmwareUpdateStandardTargetFileName":"cobra-update.bsfw",
    "productionReleaseURL":"https://bsncloud.s3.amazonaws.com/public/cobra-9.0.59-update.bsfw"
  }
}
```

### Actualización a la versión mínima compatible

```json
"firmwareUpdateType": "standard",
"firmwareUpdatesByFamily":{
  "Cobra":{
    "firmwareUpdateSource":"compatible",
    "firmwareUpdateStandardTargetFileName":"cobra-update.bsfw",
    "compatibleReleaseURL":"https://bsncloud.s3.amazonaws.com/public/cobra-9.0.59-update.bsfw"
  }
}
```

### Actualización a la versión Beta del OS

```json
"firmwareUpdateType": "standard",
"firmwareUpdatesByFamily":{
  "Cobra":{
    "firmwareUpdateSource":"beta",
    "firmwareUpdateStandardTargetFileName":"cobra-update.bsfw",
    "betaReleaseURL":"https://bsncloud.s3.amazonaws.com/public/cobra-9.0.59-update.bsfw"
  }
}
```

### Actualización mediante una URL específica

```json
"firmwareUpdateType": "standard",
"firmwareUpdatesByFamily":{
  "Cobra":{
    "firmwareUpdateSource":"specificUrl",
    "firmwareUpdateStandardTargetFileName":"cobra-update.bsfw",
    "firmwareUpdateSourceUrl":"https://bsncloud.s3.amazonaws.com/public/cobra-9.0.34-update.bsfw"
  }
}
```

### Actualización a un OS diferente

Estos ejemplos actualizan el OS si es diferente del que ya está en el reproductor:

```json
// Different OS update - Production version
"firmwareUpdateType": "different",
"firmwareUpdatesByFamily":{
  "Cobra":{
    "firmwareUpdateSource":"production",
    "firmwareUpdateDifferentTargetFileName":"cobra-update.bsfw",
    "productionReleaseURL":"https://bsncloud.s3.amazonaws.com/public/cobra-9.0.34-update.bsfw"
  }
}
```

```json
// Different OS update - Beta version
"firmwareUpdateType": "different",
"firmwareUpdatesByFamily":{
  "Cobra":{
    "firmwareUpdateSource":"beta",
    "firmwareUpdateDifferentTargetFileName":"cobra-update.bsfw",
    "betaReleaseURL":"https://bsncloud.s3.amazonaws.com/public/cobra-9.0.34-update.bsfw"
  }
}
```

```json
// Different OS update - Minimum compatible version
"firmwareUpdateType": "different",
"firmwareUpdatesByFamily":{
  "Cobra":{
    "firmwareUpdateSource":"compatible",
    "firmwareUpdateDifferentTargetFileName":"cobra-update.bsfw",
    "compatibleReleaseURL":"https://bsncloud.s3.amazonaws.com/public/cobra-9.0.34-update.bsfw"
  }
}
```

```json
// Different OS update - Specific URL version
"firmwareUpdateType": "different",
"firmwareUpdatesByFamily":{
  "Cobra":{
    "firmwareUpdateSource":"specificUrl",
    "firmwareUpdateDifferentTargetFileName":"cobra-update.bsfw",
    "firmwareUpdateSourceUrl":"https://bsncloud.s3.amazonaws.com/public/cobra-9.0.34-update.bsfw"
  }
}
```

### Actualización a un OS más reciente

Estos ejemplos actualizan la versión del OS si esa versión es superior/más reciente que la que está en el reproductor:

```json
// Newer OS update - Production version
"firmwareUpdateType": "newer",
"firmwareUpdatesByFamily":{
  "Cobra":{
    "firmwareUpdateSource":"production",
    "firmwareUpdateNewerTargetFileName":"cobra-update.bsfw",
    "productionReleaseURL":"https://bsncloud.s3.amazonaws.com/public/cobra-9.0.34-update.bsfw"
  }
}
```

```json
// Newer OS update - Beta version
"firmwareUpdateType": "newer",
"firmwareUpdatesByFamily":{
  "Cobra":{
    "firmwareUpdateSource":"beta",
    "firmwareUpdateNewerTargetFileName":"cobra-update.bsfw",
    "betaReleaseURL":"https://bsncloud.s3.amazonaws.com/public/cobra-9.0.34-update.bsfw"
  }
}
```

```json
// Newer OS update - Minimum compatible version
"firmwareUpdateType": "newer",
"firmwareUpdatesByFamily":{
  "Cobra":{
    "firmwareUpdateSource":"compatible",
    "firmwareUpdateNewerTargetFileName":"cobra-update.bsfw",
    "compatibleReleaseURL":"https://bsncloud.s3.amazonaws.com/public/cobra-9.0.34-update.bsfw"
  }
}
```

```json
// Newer OS update - Specific URL version
"firmwareUpdateType": "newer",
"firmwareUpdatesByFamily":{
  "Cobra":{
    "firmwareUpdateSource":"specificUrl",
    "firmwareUpdateDifferentTargetFileName":"cobra-update.bsfw",
    "firmwareUpdateSourceUrl":"https://bsncloud.s3.amazonaws.com/public/cobra-9.0.34-update.bsfw"
  }
}
```

### Actualización y guardado del archivo .bsfw

Estos ejemplos actualizan el OS a una nueva versión sin eliminar el archivo .bsfw de la tarjeta SD después de que se complete la actualización, y no reinician el reproductor después de aplicar la actualización (para evitar un bucle de reinicio):

```json
// Save OS update - Production version
"firmwareUpdateType": "save",
"firmwareUpdatesByFamily":{
  "Cobra":{
    "firmwareUpdateSource":"production",
    "firmwareUpdateSaveTargetFileName":"cobra-update.bsfw",
    "productionReleaseURL":"https://bsncloud.s3.amazonaws.com/public/cobra-9.0.34-update.bsfw"
  }
}
```

```json
// Save OS update - Beta version
"firmwareUpdateType": "save",
"firmwareUpdatesByFamily":{
  "Cobra":{
    "firmwareUpdateSource":"beta",
    "firmwareUpdateNewerTargetFileName":"cobra-update.bsfw",
    "betaReleaseURL":"https://bsncloud.s3.amazonaws.com/public/cobra-9.0.34-update.bsfw"
  }
}
```

```json
// Save OS update - Minimum compatible version
"firmwareUpdateType": "save",
"firmwareUpdatesByFamily":{
  "Cobra":{
    "firmwareUpdateSource":"compatible",
    "firmwareUpdateNewerTargetFileName":"cobra-update.bsfw",
    "compatibleReleaseURL":"https://bsncloud.s3.amazonaws.com/public/cobra-9.0.34-update.bsfw"
  }
}
```

```json
// Save OS update - Specific URL version
"firmwareUpdateType": "save",
"firmwareUpdatesByFamily":{
  "Cobra":{
    "firmwareUpdateSource":"specificUrl",
    "firmwareUpdateDifferentTargetFileName":"cobra-update.bsfw",
    "firmwareUpdateSourceUrl":"https://bsncloud.s3.amazonaws.com/public/cobra-9.0.34-update.bsfw"
  }
}
```