VIP2060 Files

Notice
------
This is the source code distribution for open source with
redistribution obligations that has been used in the KreaTV Software
Development Kit. The KreaTV SDK is used by operators and system
integrators to create a customized bootimage which is commonly
downloaded to the set-top box over the operator network. The operator
or system integrator adds their own GUI and possibly extra software in
that process.

This distribution covers the VIP2060 model set-top box (STB).

The VIP2060 STB is only available in secure versions. Secure
versions will only boot signed software images.

Installing the cross compiler toolchain
---------------------------------------
Extract the toolchain archive in /usr/local/motorola.


Installing required external build tools
----------------------------------------
Install the patch management tool Quilt, which is available as an optional
package in major Linux distributions. Example:

 * yum install quilt

or

 * apt-get install quilt

Alternatively, build it from source found at
<http://savannah.nongnu.org/projects/quilt>.


Install the perfect hash function generator gperf:

 * yum install gperf
 * apt-get install gperf

Build it from source: <http://www.gnu.org/software/gperf/>


Build environment
-----------------
The build scripts in the OSSK require that bash is installed as the default shell.
This is not the case on some Linux installations (Ubuntu 9.10, for example, uses
dash as its default shell).

Please update your /bin/sh link to point to /bin/bash:
 $ cd /bin
 $ sudo rm sh
 $ sudo ln -s bash sh


Building the cross compiler toolchain
-------------------------------------
Extract the toolchain src archive. Run make from the src root directory. This
is only needed if the pre built toolchain is not installed or if modifications
to binutils, gcc or glibc are needed.


Building
--------
Run the build_image.sh script from bootimage/tools. This will create:

 * dist/products/kernel.pre_bcm74xx_vip20x2
   - Linux kernel image
 * dist/products/kernel-debug.pre_bcm74xx_vip20x2
   - Linux kernel image with NFS support
 * bootimage/tools/vip20x2/rootdisk.tar.gz
   - Tarball of the root filesystem
 * bootimage/tools/vip20x2/bi_bcm74xx_vip22x2.bin
   - Bootimage (kernel with initrd filesystem)
 * bootimage/tools/vip20x2/bi_bcm74xx_vip20x2_debug.bin
   - Bootimage with NFS support


Altering a bootimage
--------------------
Modify build_image.sh to have more files added to the bootimage.


Boot methods
------------
What's required:
 * DHCP server

What's optional:
 * NFS server

For configuring the server daemons consult your system documentation. An
example of relevant dhcpd options follows below.

The boot-loader can load and execute a bootimage or kernel from flash
if it is properly signed.

Configuring the dhcpd DHCP server for booting a kernel from flash with
NFS rootdisk:

host clientname {
  option swap-server 0.0.0.0;                    # NFS server IP
  option root-path "/nfs/rootdisk";              # rootdisk location
}