Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

...

...

...

...

...

...

...

The device setup

...

entity contains the following properties:

...


version string

...

requiredThis value should be "3.0.0"

...


_id string required:

...

 The id of the device setup object


bDeploy object requiredA B-Deploy Entity (v3)


firmwareUpdatesByFamily  object requiredThe FirmwareUpdatebyFamily Entity (v3)


firmwareUpdateType string required: The firmware update type which is one of "different", "newer", "save", and "standard". See firmwareUpdateDifferentTargetFileName, firmwareUpdateNewerTargetFileName, firmwareUpdateSaveTargetFileName, and firmwareUpdateStandardTargetFileName in FirmwareUpdatebyFamily Entity (v3) for more information about these types.


setupType string required: The device setup type which is one of "legacyLfn", "localToBsn", "lfn", "sfn", "

...

partnerApplication", "standalone", or "bsn")

...

  • [string] token: The device registration token
  • [string] scope: The scope of the device registration token (for example, "cert")
  • [string] validFrom: The beginning of the token validity window  
  • [string] validTo: The end of the token validity window  


bsnDeviceRegistrationTokenEntity  object requiredA Token Entity (DOCS-1116)


enableSerialDebugging bool required: False is the default. If true, serial debugging is enabled.

...


enableSystemLogDebugging  bool

...

required: False is the default. If true, system log debugging is enabled.

...


remoteDwsEnabled  bool required:  False is the default. If true, the remote DWS is enabled

...

.


dwsEnabled bool required: False is the default. If true, the DWS is enabled.

...


dwsPassword string

...

required: The DWS password

...

(this can be an empty string)


dwsPasswordPreviousSavedTimeStamp  number required: The DWS password time stamp

...


lwsEnabled bool

...

required: False is the default. If true, the LWS is enabled.

...


lwsConfig string

...

required: The local web server user type, either "status" or "content" or "none" (this can be an empty string)


lwsUserName string required: The user name of the LWS server (this can be an empty string)


lwsPassword string required: The password for the LWS server (this can be an empty string)


lwsEnableUpdateNotifications bool required: False is the default. If true, update notifications are enabled on the LWS.

...


bsnCloudEnabled bool

...

required: False is the default. If true, bsn.cloud is enabled.

...


deviceName string

...

required: The

...

user-defined device name for devices that are provisioned with the Device Setup package

...

. This can be an empty string.


deviceDescription string required: The user-defined description give to devices that are provisioned with the Device Setup package

...

. This can be an empty string.


unitNamingMethod string required: Either "appendUnitIDToUnitName" or "unitNameOnly", which determines whether or not to append the serial number to the device name.


timeZone string required: The time zone (for example, "PST")

...


bsnGroupName string required: The name of the BSN.cloud group to which provisioned devices will be assigned. This value defaults to the "Default" group if undefined.

...


timeBetweenNetConnects int

...

[int] timeBetweenHeartbeats:

...

required: How often the autorun checks for content (in milliseconds)


timeBetweenHeartbeats int required: How often the player reports health to BSN (in milliseconds)


sfnWebFolderUrl string required: The URL address for the web-accessible folder that contains the simple file networking presentation

...

. This can be an empty string.


sfnUserName string required: The user name for the simple file networking setup

...

. This string can be empty.


sfnPassword string required: The password for the simple file networking setup

...

. This string can be empty.


sfnEnableBasicAuthentication  bool required: False is the default. If true, basic authentication is enabled for simple file networking.

...


playbackLoggingEnabled  bool required: False is the default. If true, playback logging is enabled

...

.


eventLoggingEnabled bool required: False is the default. If true, event logging is enabled

...

.


diagnosticLoggingEnabled bool required: False is the default. If true, diagnostic logging is enabled.

...


stateLoggingEnabled bool required: False is the default. If true, state logging is enabled.

...


variableLoggingEnabled bool

...

required: False is the default. If true, variable logging is enabled

...

.


uploadLogFilesAtBoot bool required: False is the default. If true, log files will be uploaded at

...

startup.


uploadLogFilesAtSpecificTime bool required: False is the default. If true, log files will be uploaded at a specific time.

...


uploadLogFilesTime int required: The time that log files will be uploaded, if any, in minutes

...


logHandlerUrl string

...

optional: The custom log handler URL to which the logs are uploaded. This is only enabled for simple file networking (otherwise it will be an empty string).


enableRemoteSnapshot bool optional: False is the default. If true, remote snapshot is enabled.

...


remoteSnapshotInterval int required: The number of

...

milliseconds to wait between capturing each snapshot

...

. Zero is the default, but this value should be set if enableRemoteSnapshot is true.


remoteSnapshotMaxImages int required: The maximum number of snapshot images to

...

save. Possible values are 1 to 100.


remoteSnapshotJpegQualityLevel int required: The JPEG quality level for the remote snapshot, on a scale from

...

1 to 100

...


remoteSnapshotScreenOrientation string required: The screen orientation ("Landscape""PortraitBottomRight", or "

...

PortraitBottomLeft")

...


remoteSnapshotHandlerUrl string

...

optional: The

...

URL for the remote snapshot handler

...

...

[bool] contentDataTypeEnabledWired: If true, the "content data type" is enabled over the ethernet interface

...

[bool] textFeedsDataTypeEnabledWired: If true, the "text feeds data type" is enabled over the ethernet interface

...

[bool] healthDataTypeEnabledWired: If true, health is enabled over the ethernet interface

...

[bool] mediaFeedsDataTypeEnabledWired: If true, the "media feeds data type" is enabled over the ethernet interface

...

[bool] logUploadsXfersEnabledWired: If true, log uploads are enabled over the ethernet interface.

...

[bool] contentDataTypeEnabledWireless: If true, the "content data type" is enabled over the WiFi interface

...

[bool] textFeedsDataTypeEnabledWireless: If true, the "text feeds data type" is enabled over the WiFi interface

...

[bool] healthDataTypeEnabledWirelessIf true, health is enabled over the WiFi interface

...

[bool] mediaFeedsDataTypeEnabledWireless: If true, the "media feeds data type" is enabled over the WiFi interface

...

[bool] logUploadsXfersEnabledWireless: If true, log uploads are enabled over the WiFi interface

...

[string] rateLimitModeOutsideWindow: The rate limit mode if you are not in the content downloads window for ethernet or WiFi

...

[int] rateLimitRateOutsideWindow: The actual rate limit numerical values for ethernet or WiFi if you are outside of the content downloads window.

...

[string] rateLimitModeInWindow: The rate limit mode during the content downloads window for ethernet or WiFi

...

[int] rateLimitRateInWindow: The actual rate limit numerical values for ethernet or WiFi if you are in the content downloads window.

...

[string] rateLimitModeInitialDownloads: The rate limit mode during initial downloads for ethernet or WiFi

...

[int] rateLimitRateInitialDownloads: The actual rate limit numerical values for ethernet or WiFi

...

[string] networkConnectionPriority: The network priority for ethernet or WiFi

...

[bool] networkDiagnosticsEnabled: If true, network diagnostics are enabled


idleScreenColor object required: An object with RGBA properties


networkDiagnosticsEnabled  bool required: False is the default. If true, network diagnostics are enabled. This must be enabled in order to enable  testEthernetEnabled, testWirelessEnabled, or testInternetEnabled.


testEthernetEnabled bool requiredFalse is the default. If true, ethernet testing during setup is enabled

...

.


testWirelessEnabled bool required: False is the default. If true, wireless testing during setup is enabled

...

.


testInternetEnabled bool required: False is the default. If true, internet testing during setup is enabled.

...


useCustomSplashScreen bool

...

required: False is the default. If true, a custom splash screen will be used.

...


BrightWallName  string required: The name of the BrightWall settings

...


BrightWallScreenNumber string required: The BrightWall display number

...


contentDownloadsRestricted bool

...

required: False is the default. If true, content downloads are restricted

...

for simple file networking.


contentDownloadRangeStart time required: The start time

...

when content can be downloaded, from 00:00 to 23:59


contentDownloadRangeEnd time required: The end time

...

[bool] heartbeatsRestricted: If true, player health reporting is restricted

...

[int] heartbeatsRangeStart: DEPRECATED The default value is 0

...

[int] heartbeatsRangeEnd: DEPRECATED The default value is 0

...

when content can be downloaded, from 00:00 to 23:59


usbUpdatePassword string required: The password for the USB update feature

...


inheritNetworkProperties bool requiredFalse is the default (it will use the network properties from the device setup file). If true, the setup will use the

...

current network configuration settings of the player.


internalCaArtifacts internalCaArtifacts

...

[] required: A list of certificate objects. Each object has a name and an asset (the certificate file object). This can be an empty object.


network  object requiredThe Network Entity (DOCS-1116). This will contain default values unless the user specifies parameters.