Bootcast information

The bootcast information file contains information for the IP-STB to where to find the boot image and the splash screen.

Additionally, it's used for telling IP-STBs with a large flash memory that a software upgrade is necessary. Those units normally boot from it's own flash memory, and does not download software from the network.

The splash screen information is optional. If it is removed, then the IP-STB will boot displaying a black screen except for the boot indicators.

File syntax

This file is a text file with no syntax check done in the server, but the format must match the outline below.

bc_kernel_addr <ip address>:<port number>
bc_kernel_name <object name of the boot image>
bc_kernel_version <version of boot image>
bc_splash_addr <ip address>:<port number>
bc_splash_name <name of object containing splash image>
bc_splash_version <version of the splash image>

Channel addresses

The addresses (<ip address>:<port number>) must match the channel addresses of the Boot image channel and the Splash image channel respectively in the Infocast server configuration file.

File names

The names must correspond to names of the objects in the Boot image channel and the Splash image channel respectively in the Infocast server configuration file.

Version handling

The version tags bc_kernel_version and bc_splash_version are used to determine if a software update is required. Some devices store the boot image and boot splash image in flash memory. If a version tag changes, the device will discard the version stored in flash and download the newer version from the network next time it boots.

The boot splash image itself does not contain version information and the version tag bc_splash_version can be set arbitrarily. It is stored together with the boot splash image in flash memory.

For devices running KreaTV Firmware DBL 3.x

On devices running KreaTV Firmware DBL version 3.x such as VIP1903, VIP1963 and VIP1002 the boot image version tag bc_kernel_version is an arbitrary text string and does not have to match the actual boot image version stored in the boot image binary. This version is separately stored in flash memory.

For devices running KreaTV Firmware DBL 4.x

On devices running KreaTV Firmware DBL version 4.0 or later such as VIP2853, VIP1103 and VIP1113 the boot image version tag bc_kernel_version must match the one stored in the boot image binary. The boot image version is chosen when a boot image binary is built. A boot image is built using the build_boot_image command. The boot image version is specified using the --info version parameter. The command boot_image_version can be used to retrieve the version of a boot image.

Example

This is a typical bootcast information file. Note that the version tags are ignored unless the IP-STB boots from it's own flash memory.

bc_kernel_addr 224.2.2.11:22222
bc_kernel_name software_1700
bc_kernel_version 3.0.0
bc_splash_addr 224.2.2.13:11111
bc_splash_name splash-data_1700
bc_splash_version 3.0.0