Notice
------
This is the source code distribution for open source with
redistribution obligations that has been used in the KreaTV Software
Development Kit.
See the Makefile for the supported set-top boxes. Execute 'make' to
get a list of available targets.
Build environment
-----------------
The following 64-bit Linux distros have been used to build this package:
CentOS 7.2.1511, 7.3.1611, 7.4.1708, 7.5.1804, 7.6.1810, 7.7.1908, 8.1.1911
Debian 8.0, 8.1, 8.2, 8.3, 8.4, 8.5, 8.6, 8.7, 8.8, 8.9, 8.10, 8.11, 9.0, 9.1, 9.2, 9.3, 9.4, 9.5, 9.6, 9.7, 9.8, 9.9, 10.0, 10.1, 10.2, 10.3
Fedora 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32
OpenSUSE 15.1, 42.3
Ubuntu 12.10, 13.04, 13.10, 14.04, 14.10, 15.04, 15.10, 16.04, 16.10, 17.04, 17.10, 18.04, 18.10, 19.04, 19.10, 20.04
The following build environments can NOT be used to build this package:
Any 32-bit Linux distro
Any 64-bit Linux distro without a gcc that supports C++11
Newer 64-bit distros not mentioned may work, but older ones probably will not.
Extracting distribution tarballs
--------------------------------
Each source code distribution is provided with one .tgz file, and, perhaps, an
optional .patch.tar file to correct for Linux distro issues. Please extract the
tarballs in the following order:
tar xvf <distribution>.tgz
tar xvf <distribution>.patch.tar
Installing required external build tools
----------------------------------------
Install the required packages for your Linux distro.
You can do so with 'make required' or 'su -c ./required.sh'.
Reboot after the packages have been installed and then re-run this
step again. Repeat until there a no more packages to install (some
distros require you to do so more than once).
See that script for more details.
Setting needed links
--------------------
The build scripts in this kit require that bash is installed as the default shell.
This is not the case on some Linux installations and in the Debian-based distros
you may be warned to run "su -c 'dpkg-reconfigure dash'" to change the default
shell. Please re-run the script if you are asked to reconfigure the shell.
You can do so with 'make setlinks' or 'su -c ./setlinks.sh'.
See that script for more details.
Installing the cross compiler toolchains
----------------------------------------
Extract the toolchain archives to /usr/local/kreatv.
You can do so with 'make install_toolchains' or 'su -c ./install_toolchains.sh'.
See that script for more details.
Building the cross compiler toolchains
--------------------------------------
Extract the toolchain src archive. Run make from the src root directory. This
is only needed if the pre-built toolchain is not usable or if modifications
to binutils, gcc or glibc are needed.
Building
--------
Use 'make help' to see the build targets for individual devices.
Each device build target, will build the following files:
* <device>
- Symbolic link to bootimage/tools/<device>
* <device>/kernel_nfs
- Linux kernel image with NFS support (uncompressed)
* <device>/rootdisk.tar.gz
- Tarball of the root filesystem
* <device>/boot
- Bootimage
Altering a bootimage
--------------------
Modify bootimage/tools/build_image.sh to have more files added to the bootimage.
Boot methods
------------
What's required:
* TFTP server
* DHCP server
What's optional:
* NFS server
For configuring the server daemons consult your system documentation. An
example of relevant dhcpd options follows below.
Configuring the dhcpd DHCP server for booting TFTP bootimage:
host clientname {
next-server 0.0.0.0; # TFTP server IP
filename "/tftpboot/boot"; # bootimage location
}
Configuring the dhcpd DHCP server for booting TFTP kernel and NFS rootdisk:
host clientname {
next-server 0.0.0.0; # TFTP server IP
filename "/tftpboot/kernel-nfs"; # kernel location
option swap-server 0.0.0.0; # NFS server IP
option root-path "/nfs/rootdisk"; # rootdisk location
}
