Page Comparison

...

BrightSign partners who use HTML/JavaScript applications (and do not use the BrightAuthor:connected interface) can follow the steps outlined below to update to the latest firmwareBOS. 

Accessing the

...

BOS

1. Go to the Downloads section of our website or to Previous-OS-and-FirmwareBOS-Releases to download the firmware BOS version you want. 

2. Click the Download button on the download page that corresponds with the model number of your BrightSign player. Note that firmware BOS versions for different model families are often designated with the same number, but they are different files. Make sure to use only the update file that corresponds to the model number of your BrightSign player.

3. Unzip the downloaded file.

4. Put the .bsfw file in your known URL location.

Contact support@brightsign.biz if you need help creating an URL for the correct firmware BOS release.

Installing the Update

To install the update, your code must download the firmware BOS update into the root directory of an attached storage device (where the OS will look for it during a reboot) and reboot the player after the download. You may also want to add a check to see if the firmware BOS has been downloaded correctly.

Code Requirements

1. Specify the correct OS version and .bsfw firmware from  from the downloaded URL.

2. If you know where to download the update, specify that location in your code. If not, the code must "decide" where to write the firmware BOS update file. See "Selecting a Download Location" for more guidance.

3. Download the firmwareBOS. You can use the downloadFile() function and and the node-fetch module or your own preferred method.

4. To call the reboot function after download, use the @brightsign/system API.

5. You can use the @brightsign/deviceinfo API to make sure the firmware BOS was downloaded correctly on the device.

Selecting a Download Location

You can use any writable storage device with sufficient space, but we recommend that you implement a search order which prefers a faster or more durable device (prioritize a plugged in USB stick over other storage, while the primary SD should take precedence over the secondary SD, and an SD card the user plugs in should take precedence over an SSD). For example:

...

Have your script iterate over all the mountpoints in /storage (skipping anything that's not a mountpoint, or is a tmpfs, or is read-only) looking for a drive with enough space.

Example

This code is for illustration purposes only. A production implementation should also contain steps to handle errors, data overflow, write-protected storage devices, etc.

...

• osYouWant: The correct OS version

• fwName: The .bsfw filename of the firmwareOS

• URL: The firmware OS URL (https://bsncloud.s3.amazonaws.com/public is the public URL that stores BrightSign .bsfw files).

• devicePath: Write the firmware OS update to this storage device
  

// Fetch the firmwareBOS url.
let fs = require("fs")
let path = require("path")
let fetch = require("node-fetch");

const systemClass = require("@brightsign/system");
let system = new systemClass();
const diClass = require("@brightsign/deviceinfo");
let di = new diClass();

// Use the information in the hardcoded URL to specify the osYouWant and fwName variables.
let osYouWant = '8.2.82'
let fwName = 'malibu-8.2.82-update.bsfw'
let url = 'https://bsncloud.s3.amazonaws.com/public/malibu-8.2.82-update.bsfw';
let devicePath = '/storage/sd/'+fwName;


const downloadFile = (async (url, path) => {
  const res = await fetch(url);
  const fileStream = fs.createWriteStream(path);
  await new Promise((resolve, reject) => {
      res.body.pipe(fileStream);
      res.body.on("error", (err) => {
        reject(err);
      });
      fileStream.on("finish", function() {
        resolve('success');
      });
    });
});

 
function main(){
  if (di.osVersionCompare(osYouWant) != 0) {
    downloadFile(url, devicePath).then(() => {
        console.log(`${osYouWant} has been downloaded successfully!`)
        system.reboot();
    })
    .catch((err) => {
        console.log(err)
    })
  }
  else{
    console.log(`You have gotten the right OS ${osYouWant} you want!`)
  }
}

main();

Checking the

...

BOS

After the player reboots, check the BrightSign firmware BOS version in the BrightAuthor:connected DWS to make sure that it is updated to the correct version.

...