BrightSign OS Source Code Corresponding to brightsign-v8.5.33 (fab6483aa49eb2c7771149110cf5609b47b0bc3b) 2022-12-02 * Introduction Parts of the BrightSign OS make use of "Open Source" software under various different licenses. Under the terms of some of these licenses we are required to provide the source code used to generate the binaries we distribute. This file describes the components and where the source code can be found. Note that BrightSign OS also contains many other proprietary parts from BrightSign and third parties. The source code for these parts is not provided. * Build System BrightSign OS is based on the OpenEmbedded build framework (http://www.openembedded.org) which in turn uses bitbake (https://www.yoctoproject.org/tools-resources/projects/bitbake) The brightsign-8.5.33-src-oe.tar.gz file contains Bitbake, OpenEmbedded and the Brightsign-specific recipes and configuration files necessary to build the open source components used by BrightSign OS. The brightsign-8.5.33-src-dl.tar.gz file contains the actual source package tarballs. You should be able to build the toolchain and the open source components included in BrightSign OS by running the following: tar xaf brightsign-8.5.33-src-oe.tar.gz tar xaf brightsign-8.5.33-src-dl.tar.gz cd brightsign-oe/build-bcm7425 for HD3, LS3, HO3 and HS3 models: MACHINE=pantera ./bsbb brightsign-source-release-world for HD4, LS4 and HS4 models: MACHINE=pagani ./bsbb brightsign-source-release-world for XD3 and XT3 models: MACHINE=impala ./bsbb brightsign-source-release-world for XD4 and XT4 models: MACHINE=malibu ./bsbb brightsign-source-release-world for 4K models: MACHINE=tiger ./bsbb brightsign-source-release-world for AU5 models: MACHINE=sebring ./bsbb brightsign-source-release-world Note that a 64-bit host with at least 12GiB of memory is probably required for a successful build. * Player Serial Console For LS3 and LS4 a 5V serial port is available via the USB type C connector. The BrightSign player receives via TX1- or TX2- (A3 or B3) and transmits via TX1+ and TX2+ (A2 or B2.) If your BrightSign player has an RS-232 serial port then you should use that with a female to female null modem (cross over) cable. If your BrightSign player has a 3-pin 5V 3.5mm serial port then it will transmit on the tip and receive on the ring with ground on the sleeve. See https://docs.brightsign.biz/display/DOC/HDx23+Hardware+Interfaces . If your player has neither an RS-232 serial port nor a 3.5mm serial port then a 3.3V serial port is available via the GPIO connector: the BrightSign player receives via GPIO 4 (DE-15 pin 12, Phoenix pin 9) and transmits via GPIO 5 (DE-15 pin 4, Phoenix pin 10.) * Secure boot lock (AU, HD, XD, XT and 4K models) In order to comply with HDCP and other content-protection regulations BrightSign players will only boot signed code and system access is limited. If you wish to take advantage of your right to modify the "Open Source" software and install updated versions on the BrightSign you will need to disable secure booting. Disabling secure booting requires that the HDCP and other encryption keys are permanently deleted from the device. Once you do this your BrightSign will not be capable of receiving HDCP-encrypted signals or transmitting HDCP-encrypted signals over HDMI ever again. THIS OPERATION CANNOT BE UNDONE. Disabling secure booting requires a serial connection to the player. To disable secure booting and permanently wipe the keys: 1. Connect a serial cable to your BrightSign player (115200 8-N-1.) 2. Remove power from your BrightSign player. 3. Hold the SVC button in whilst applying power. 4. You should see messages appear on the serial port. 5. Once you are invited to press Ctrl-C you should do so and let go of the SVC button. 6. At the prompt type "help" and view the information about the "disable-secure-boot" or "disable_secure_boot" command before using it if you so choose.