roDeviceCustomization

ifFailureReason

GetFailureReason() As String

Returns helpful information if one of the ifDeviceCustomization methods fail.

ifDeviceCustomization

WriteSplashScreen(filename As String) As Boolean

Removes the default splash screen (or a previously set splash screen) and replaces it with the specified image file. The image file must use a supported format. This method returns True upon success and False upon failure.

FactoryReset(confirm As String) As Boolean

Applies a factory reset to the player. This method must be passed the string "confirm" to work; otherwise, it will return False and do nothing. If successful, this method will reboot without a return value. The following steps will be carried out during a factory reset:

1. All files are wiped from the BOOT: drive (including custom splash screens and autorun scripts).

2. All values are wiped from the registry.

3. The RTC is reset (if the player has an RTC).

4. The FLASH: drive is wiped.

EncryptStorage(device As String, params As roAssociativeArray) As Boolean

Encrypts the contents of a storage device using an encryption key stored in the private section of the player registry. This prevents other devices from reading the names or contents of files on the storage device (though metadata will still be readable). The storage device can still be mounted on other devices–which can list, delete, and copy files (even though they cannot read them).

Use the device parameter to specify which storage drive to encrypt (see here for a list of valid drive names). Encryption parameters are passed as an associative array, which can contain the following:

• method As String:(Required) The encryption method, which can be one of the following:
  • "none": Encryption is disabled and any encryption keys are deleted from the registry. 
  • "passphrase": The storage device is encrypted using an un-obfuscated passphrase.
  • "obfuscated_passphrase": The storage device is encrypted using an obfuscated passphrase. Contact support@brightsign.biz to learn more about generating a key for obfuscation and storing it on the player.
  • "brightsign_key": The storage device is encrypted using an encryption key that is common to all BrightSign players, but is not shared with outside parties.

  • "generate_key": The storage device is encrypted using an encryption key that is generated on-demand using a secure random generator. The private registry of the player contains the only copy of the key; if the value in the registry is erased or becomes corrupted, there will be no way to recover data from that storage device.

    Important

    The private registry does not distinguish between different physical volumes of the same drive. For example, if you encrypt two SD cards, the key for the first SD card will be overwritten when the second SD card is encrypted.

• passphrase As String: The passphrase for encrypting the storage device. This parameter must be included if the method is specified as "passphrase" or "obfuscated_passphrase".

• format As Boolean: Setting this parameter to true will cause the specified storage device to be reformatted–all existing files will be deleted (but are not guaranteed to be securely erased) before the device is encrypted; however, if the device cannot be reformatted, the operation will fail. If this parameter is set to false, the storage device will be mounted as if it has been previously encrypted using the supplied key. If the storage device hasn't been previously encrypted, it will be encrypted while leaving any preexisting files unencrypted. If the storage device has been encrypted using a different key, the operation will fail.

  Note

  If the format parameter is not specified, the storage device will be mounted as if it has been previously encrypted using the supplied key. If the storage device hasn't been previously encrypted, the operation will fail.