Entidad de referencia de firmware (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 cual obtener 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 destinado a las actualizaciones. La actualización contenida en el archivo se aplica y, si tiene éxito, el archivo se elimina del medio de almacenamiento que lo contiene. Si la eliminación se realiza correctamente, el sistema se reinicia. Si falla, entonces el dispositivo se comporta como si el archivo se hubiera llamado *_save.bsfw - consulte a continuación. 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 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 reinicios posteriores el número de versión será el mismo, por lo que se ignorará el archivo de actualización. En modo de rescate, la actualización siempre se aplica.
- firmwareUpdateNewerTargetFileName string: 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 reinicios posteriores el número de versión será el mismo, por lo que se ignorará el archivo de actualización. En modo de rescate, la actualización siempre se aplica porque no se puede verificar la versión del modo de ejecución y no se producirá el bucle infinito porque el dispositivo se reiniciará en 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 dispositivo se reiniciara en este punto simplemente volvería a aplicar la actualización. El dispositivo seguirá aplicando la actualización y 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 llave 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 obtener 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 al archivo .bsfw desde el cual el dispositivo obtendrá los archivos de configuración para su uso en producción
- betaReleaseURL string: La URL al archivo .bsfw para la versión beta en producción
- compatibleReleaseURL string: La URL al archivo .bsfw para la versión mínima compatible 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 tipo de fuente y actualización de firmware.
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 del 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 después de completar 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"
}
}