Edit Firmware Update Files

7 min

This page / section pertains to BrightSign Network (often abbreviated BSN), our legacy cloud platform. Our latest cloud platform is BSN.Cloud. Development of BSN has largely ceased and the platform will eventually be deprecated and replaced with BSN.Cloud.

BSNEE uses two mechanisms to distribute firmware updates: the API/WebUI allows users to distribute firmware updates to groups, while BrightAuthor provides beta, production, and minimum-compatible firmware versions that can be downloaded and bundled with player setup files. In both cases, BSNEE uses XML files in the Resources folder of the Persistent Storage site to determine which firmware updates are available for distribution.

This page outlines how to edit the XML files to include different firmware versions for distribution.

WebAPI / WebUI (BSNEE 3.9)

Locate and open the WebUIAutorun.xml file located in the Resources folder of the Persistent Storage site.

The file will contain an entry for each compatible BrightAuthor autorun. Each entry contains several elements: Each denotes a specific minimum firmware version for a specific set of player models. Note that, unlike the BSNEE 4.0 WebAPI/WebUI, you cannot add new firmware file elements—you must modify the files that are already listed:

<firmware uses=”WebUI”>: If you include the uses=”WebUI” attribute and value, users will be able to select the firmware version in the Scheduled firmware upgrades dropdown list of the WebUI Group Properties window; otherwise, the update file will only be selectable via WebAPI calls.

For the changes to take affect in the WebUI, you must restart the BSNEEWebSite and BSNEEWebServices application pools in IIS.

<family>: The player model family to which the firmware update applies. The family code names correspond to the model numbers as follows:
- Raptor: XCx55
- Cobra: LS5, HD5, XD5, HS5, XT5
- Sebring: AU335
- Malibu: XTx44, XDx34
- Impala: XTx43, XDx33
- Pagani: HDx24, LS424
- Pantera: HDx23, LS423, HO523, HS123
- Tiger: 4Kx42
- Lynx: XDx32
- Cheetah: XDx30
- Bobcat: HDx22
- Panther: LSx22, HDx20
- Monaco: HDx10
<version>: The version number of the firmware update in X.Y.Z format
<versionNumber>: The version number of the firmware update calculated using the following expression: X*256*256+Y*256+Z (where the version number corresponds to X.Y.Z)
<link>: The local-path URL of the firmware update file
<sha1>:: The SHA1 checksum of the firmware update file
<filelength>: The size of the firmware update file (in bytes: Actual Size not Size on Disk)

WebAPI / WebUI (BSNEE 4.0+)

Locate and open the BSNFirmwares.xml file located in the Resources folder of the Persistent Storage site.

The file should contain several elements; each element denotes a specific firmware version for a specific set of player models. You can either add new elements (increasing the available versions for distribution) or edit the existing ones:

<firmware uses=”WebUI”>: If you include the uses=”WebUI” attribute and value, users will be able to select the firmware version in the Scheduled firmware upgrades dropdown list of the WebUI Group Properties window; otherwise, the update file will only be selectable via WebAPI calls.

For the changes to take affect in the WebUI, you must restart the BSNEEWebSite and BSNEEWebServices application pools in IIS.

<family>: The player model family to which the firmware update applies. The family code names correspond to the model numbers as follows:
- Raptor: XCx55
- Cobra: LS5, HD5, HS5, XD5, XT5
- Malibu: XTx44, XDx34
- Impala: XTx43, XDx33
- Pantera: HDx23, LS423, HO523, HS123
- Tiger: 4Kx42
- Lynx: XDx32
- Cheetah: XDx30
- Bobcat: HDx22
- Panther: LSx22, HDx20
- Monaco: HDx10
<version>: The version number of the firmware update in X.Y.Z format
<versionNumber>: The version number of the firmware update calculated using the following expression: X*256*256+Y*256+Z (where the version numbers correspond to X.Y.Z)
<link>: The local-path URL of the firmware update file
<sha1>: The SHA1 checksum of the firmware update file
<filelength>: The size of the firmware update file (in bytes)

BrightAuthor Classic

Locate and open the FirmwareCompatibilityFile.xml file located in the Resources folder of the Persistent Storage site.

The file should contain several elements; each element denotes a specific firmware version for a specific set of player models. Note that, unlike the BSNEE 4.0 WebAPI/WebUI, you cannot add new firmware file elements—you must modify the files that are already listed:

<family>: The player model family to which the firmware update applies. The family code names correspond to the model numbers as follows:
- Raptor: XC5
- Cobra: LS5, HD5, HS5, XD5, XT5
- Malibu: XTx44, XDx34
- Impala: XTx43, XDx33
- Pantera: HDx23, LS423, HO523, HS123
- Tiger: 4Kx42
- Lynx: XDx32
- Cheetah: XDx30
- Bobcat: HDx22
- Panther: LSx22, HDx20
- Monaco: HDx10
<type>: The firmware-update type, which can be one of the following:
- Production
- Beta
- Minimum Compatible
<BAVersion>: The target BrightAuthor version for the element.
<version>: The version number of the firmware update in X.Y.Z format
<versionNumber>: The version number of the firmware update calculated using the following expression: X*256*256+Y*256+Z (where the version numbers correspond to X.Y.Z)
<link>: The URL of the firmware update file. The default location is the Resources subfolder.
<sha1>: The SHA1 checksum of the firmware update file
<filelength>: The size of the firmware update file (in bytes)