Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Redirected several links to the new BrightSign Shell and BrightScript Debugger doc. Fixed several broken links.

...

The BrightSign Shell is the CLI (command-line interface) that enables interaction with the BrightSignOS through a serial cable or Telnet/SSH. The BrightScript Debugger is a tool that facilitates debugging of BrightScript code. More info about these tools can be found here.

Crash Dumps

If a player encounters a non-deliberate shutdown (aka a crash), “crash dumps” are generated upon reboot. These files contain useful information that BrightSign Support can analyze and use for troubleshooting. These files can be found in the brightsign-dumps folder located in the root folder of the player’s storage device.

...

The Diagnostic Web Server (DWS) is a powerful tool that enables inspection of various player settings and diagnostic details. Both a Local Diagnostic Web Server (LDWS, accessible over the local network via the player’s IP address or by typing http://BrightSign-NNNNNNNNNN.local into a browser where NNNNNNNNNN is the serial number) and Remote Diagnostic Web Server (RDWS, accessible via either the Control Cloud or Content Cloud at bsn.cloud) are available. General info about the DWS can be found here and more specific info about the RDWS can be found here.

Media Analyzer

The DWS includes a useful tool that can analyze media files for playability. More info can be found here.

...

HTML is a common format for displaying presentations on BrightSign players. The HTML Best Practices document will likely be very useful to developers. Specific sub-sections from that document worth noting individually are listed below.

...

During development and testing, it is useful to have the correct version of Chromium on your Mac or PC. More information about this can be found here and here.

Logs / Diagnostics

Logs contain important diagnostic information about players. System logs (sometimes referred to as player logs) from the player are available and can be gathered via a syslog server, telnet or SSH, or an RS-232 a serial cable. More info about accessing logs via these means can be found here.

Refer to this article on obtaining player logs and this one for interpreting player logs. Logs can easily be accessed via the RDWS as described here.

Node

The node prompt is a command-line interface (CLI) that allows you to interact with Node.js. It is used to run JavaScript code and execute Node.js commands. Information about the Node prompt as well as the Node Inspector/Debugger can be found here.

...

The registry object allows you to read from and write to the player registry (the player’s persistent memory). More info about the registry can be found here.

Serial Ports

Brightsign players have serial ports for diagnostic purposes as well as to provide interactive capabilities. More info about the hardware details of player serial ports can be found here and how to use the serial port to access the BrightSign Shell and BrightScript Debugger can be found here.

Telnet and SSH

Telnet and SSH can be used to communicate with BrightSign players. More info can be found here.

VSCode Extension for BrightScript

...