If, while a script is running, a runtime error occurs or a
STOP statement is encountered, the BrightSign application will enter the BrightScript debug console. The debug console can be accessed via the BrightSign application console, which communicates over the primary serial port by default and can be accessed from a terminal program using a null-modem cable. The BrightSign application console can alternatively be routed over Telnet or SSH.
You can also access the debug console at bootup:
- Power off the device.
- Hold the SVC button and power on the device.
- Wait until the
brightsign>prompt appears in the serial/Telnet/SSH terminal (which indicates that you are in the BrightSign Shell). You can now release the SVC button.
scriptat the prompt while in the BrightSign Shell. This will take you to the BrightScript debug console.
The above instructions apply to Series 4 (XTx44, XDx34) and Series 3 (XTx43, XDx33, HDx23, LS423) players. To access the debug console on earlier player models, power on the device and wait at least 5 seconds after the power LED (pwr) lights up. Then, use a paperclip or pen to press and hold the SVC button on the side of the player until the
brightsign> prompt appears in the terminal.
The console scope is set to the function that was running when a runtime error or
STOP statement occurred. While in the console, you can type in any BrightScript statement; it will then be compiled and executed in the current context.
BrightScript Console Commands
The following console commands are currently available in the BrightScript debug console:
Print a backtrace of call-function context frames.
List all public classes.
Continue script execution.
List count of BrightScript Component instances.
Show disassembly and bytecode for this function.
Move one position down the function context chain.
Exit the debug shell.
Run the garbage collector and show collection statistics.
Print the internal hash-table histograms.
Show the last line that executed.
List methods provided by specified class.
List methods provided by the specified interface or class.
List the current source of the current function.
Show line data (source records)
Show the next line to execute.
List all allocated BrightScript Component instances.
Step one program statement.
Step one statement and show each executed opcode.
Move one function up the context chain.
Display local variables and their types/values.
Print variable value or expression.*
BrightSign Shell Commands
The following commands are currently available in the BrightSign Shell:
|Display the list of available commands.|
|Provide more information about a command.|
|Clear the terminal window.|
|Exit the shell.|
|List the contents of a storage directory.|
|Measure the performance of file reading.|
|Measure the performance of file writing.|
|Measure simultaneus file read/write performance.|
|Play an audio snippet.|
|Start the BrightScript debug console.|
|Perform a manufacturing test.|
|Reboot the system.|
|Shut down the system.|
|Display the date and time.|
|Set the date and time.|
|Display the time zone.|
|Display a list of accepted time zones.|
|Set the time zone.|
|Change the current directory.|
|Delete files or or directories recursively.|
|Display software versions.|
|Access the device registry.|
|Display device uptime.|
|Write a boot file to flash.|
|Erase a boot file in flash.|
|Display device identification information.|
|Determine a file type.|
|Cryptographically hash a file.|
|Reset the system to factory defaults.|
|Format a drive using one of the following file systems: "vfat", "ext3", "ext4".|
|Eject a drive.|
|Display the system log.|
|Clear the real time clock (RTC). Note that this action does not modify the system clock.|
|Probe a file.|
|Analyze a file.|
|Display the PTP status.|
|Display a list of discovered USB devices.|
|Configure the network interface. Type |
|Scan for WiFi networks.|
|Measure the download performance from the specified URL. If a destination file is not specified, the contents are discarded.|
|Look up the hostname in the DNS.|
|Play a video snippet.|
|Display an image.|
|Change the current video mode.|
|Read the EDID from the attached monitor.|
|Set the VGA power saving mode.|