Entidad FirmwareUpdatebyFamily (v3)
14 min
Esta entidad contiene una matriz 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 string: La fuente enum desde la que se obtiene la actualización de firmware. Los valores posibles son “Production”, “Beta”, “MinimumCompatible”, “SpecificUrl”, “None” o “Existing”. Si utiliza “Production”, “Beta” o “MinimumCompatible”, no es necesario definir valores adicionales.
- firmwareUpdateStandardTargetFileName string: El nombre del archivo de firmware .bsfw que se utiliza como destino para 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 dispositivo se comporta como si el archivo hubiera sido nombrado *_save.bsfw - vea más abajo. La eliminación siempre falla si la tarjeta utiliza un sistema de archivos NTFS o HFS+.
- firmwareUpdateDifferentTargetFileName string: El nombre de un archivo de firmware .bsfw. En el 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 el modo de rescate, la actualización siempre se aplica.
- firmwareUpdateNewerTargetFileName string: El nombre de un archivo de firmware .bsfw. En el 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 el modo de rescate, la actualización siempre se aplica porque la versión del modo de ejecución no se puede comprobar y el bucle infinito no ocurrirá porque el dispositivo se reiniciará en el modo de ejecución.
- firmwareUpdateSaveTargetFileName string: 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 momento simplemente volvería a aplicar la actualización. El reproductor no se reiniciará automáticamente al aplicar actualizaciones con este nombre hasta que se haya retirado 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 memoria USB.
- firmwareUpdateVersion string: Esto puede ser una cadena vacía o el número de versión del firmware al que desea actualizar
- firmwareUpdateSourceUrl string: Requerido si la fuente es “SpecificUrl”. Esto puede ser una URL de origen para la actualización de firmware.
Si desea utilizar una URL de BrightSign para cualquiera de los siguientes parámetros, puede encontrarlas en el archivo de manifiesto disponible públicamente (https://bsncloud.s3.amazonaws.com/public/FirmwareManifest.json):
- productionReleaseURL string: La URL del archivo .bsfw desde el que el reproductor obtendrá los archivos de configuración para su uso en producción
- betaReleaseURL string: La URL del archivo .bsfw para la versión beta publicada en producción
- compatibleReleaseURL string: La URL del archivo .bsfw para la versión mínima compatible publicada en producción
Ejemplos
Todos estos ejemplos utilizan la familia Cobra, pero se pueden sustituir 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
"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
"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
"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
"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:
// 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"
}
}// 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"
}
}// 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"
}
}// 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:
// 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"
}
}// 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"
}
}// 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"
}
}// 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 una vez finalizada la actualización, y no reinician el reproductor después de aplicar la actualización (para evitar un bucle de reinicio):
// 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"
}
}// 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"
}
}// 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"
}
}// 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"
}
}