opendreambox 2.6
This is the build system of the opendreambox distribution, an embedded Linux distribution for Set-Top-Boxes manufactured by Dream Property GmbH.
It is based on the OpenEmbedded build framework, which uses BitBake to transform build instructions into distributable firmware images and software packages.
The current version is based on the Yocto Project release 2.3 „Pyro“, an umbrella project for OpenEmbedded and related tools.
We highly recommend taking a look at the Yocto Project Reference Manual.
Contributions
Maintainers of this release are:
Andreas Monzner
Andreas Oberritter
Stephan Reichholf
Bug reports
Please use GitHub's issue tracker to create bug reports, or send a mail to [email protected] or one of the maintainers listed above.
Patches
We accept pull-requests on GitHub as well as patches submitted by mail to [email protected] or one of the maintainers listed above.
When sending patches by mail, please use something like git send-email -M -1 --to [email protected] to let git send it, or git format-patch -M -1 and send the resulting file as attachment, after all changes have been committed to your local copy of the repository.
Supported products
This release includes support for the following products:
Product name Environment variable
Dreambox One MACHINE=dreamone
License
Copyright (c) 2019 Dream Property GmbH, Germany
https://dreambox.de/
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in
all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
THE SOFTWARE.
Obtaining the source code
To initially download the source into the current directory, issue the following command:
git clone -b pyro https://github.com/opendreambox/opendreambox.git
Quick start
For the impatient:
make -C opendreambox image
If this command fails, prerequisites may be missing. See section „Prerequisites“ below.
Directory structure
Currently, these layers are used:
****-dreambox
****-games
****-golang
****-opendreambox
****-openembedded/****-filesystems
****-openembedded/****-multimedia
****-openembedded/****-networking
****-openembedded/****-oe
****-openembedded/****-python
****-openembedded/****-webserver
****-qt5
openembedded-core/****
If a recipe for the same package exists in multiple layers, then the higher priority layer takes precedence over the lower priority layer.
For example, if libmad_0.15.1b.bb existed in both ****-openembedded and openembedded-core, the recipe in ****-openembedded would be used, because openembedded-core has lower priority. Priority values are determined by the variable BBFILE_PRIORITY in conf/layer.conf of each layer.
NOTE: This would still be true even if the version of libmad in openembeded-core was higher than the version in ****-openembedded, unless PREFERRED_VERSION_libmad was set to the version in openembedded-core. There is currently no way to prefer a version of a lower priority layer, if the same version is present in a higher priority layer.
openembedded-core and ****-openembedded
These directories contain copies of Git repositories from git.openembedded.org, including the OpenEmbedded-Core layer and the (****-)OpenEmbedded layers. They get created automatically when building the distribution for the first time.
Throughout this document, the combination of these directories will be referred to as OpenEmbedded.
The latest changes to these Git repositories can be seen at:
https://git.openembedded.org/openembedded-core-contrib/log/?h=obi/pyro
https://git.openembedded.org/****-openembedded-contrib/log/?h=obi/pyro
****-opendreambox
This directory contains:
Recipes for packages written specifically for the opendreambox distribution
Modifications to recipes from OpenEmbedded
Recipes for different software versions than those available from OpenEmbedded
****-dreambox
The directory ****-dreambox contains Board Support Packages (BSP) for the supported Dreambox models. This includes:
Hardware drivers
Machine specific overrides
The Linux kernel
The boot loader
Splash images
Prerequisites
The OpenEmbedded project provides a general list of prerequisites for many Linux distributions and also for some other operating systems.
https://www.openembedded.org/wiki/Getting_started#Required_software
It is highly recommended to use Linux to build opendreambox. In theory, any recent distribution will do, but not many distributions have been verified to build opendreambox without errors. Tested distributions include:
Debian 9 „Stretch“ [amd64]
Ubuntu 18.04 LTS „Bionic Beaver“ [amd64]
https://github.com/opendreambox/opendreambox#license
This is the build system of the opendreambox distribution, an embedded Linux distribution for Set-Top-Boxes manufactured by Dream Property GmbH.
It is based on the OpenEmbedded build framework, which uses BitBake to transform build instructions into distributable firmware images and software packages.
The current version is based on the Yocto Project release 2.3 „Pyro“, an umbrella project for OpenEmbedded and related tools.
We highly recommend taking a look at the Yocto Project Reference Manual.
Contributions
Maintainers of this release are:
Andreas Monzner
Andreas Oberritter
Stephan Reichholf
Bug reports
Please use GitHub's issue tracker to create bug reports, or send a mail to [email protected] or one of the maintainers listed above.
Patches
We accept pull-requests on GitHub as well as patches submitted by mail to [email protected] or one of the maintainers listed above.
When sending patches by mail, please use something like git send-email -M -1 --to [email protected] to let git send it, or git format-patch -M -1 and send the resulting file as attachment, after all changes have been committed to your local copy of the repository.
Supported products
This release includes support for the following products:
Product name Environment variable
Dreambox One MACHINE=dreamone
License
Copyright (c) 2019 Dream Property GmbH, Germany
https://dreambox.de/
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in
all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
THE SOFTWARE.
Obtaining the source code
To initially download the source into the current directory, issue the following command:
git clone -b pyro https://github.com/opendreambox/opendreambox.git
Quick start
For the impatient:
make -C opendreambox image
If this command fails, prerequisites may be missing. See section „Prerequisites“ below.
Directory structure
Currently, these layers are used:
****-dreambox
****-games
****-golang
****-opendreambox
****-openembedded/****-filesystems
****-openembedded/****-multimedia
****-openembedded/****-networking
****-openembedded/****-oe
****-openembedded/****-python
****-openembedded/****-webserver
****-qt5
openembedded-core/****
If a recipe for the same package exists in multiple layers, then the higher priority layer takes precedence over the lower priority layer.
For example, if libmad_0.15.1b.bb existed in both ****-openembedded and openembedded-core, the recipe in ****-openembedded would be used, because openembedded-core has lower priority. Priority values are determined by the variable BBFILE_PRIORITY in conf/layer.conf of each layer.
NOTE: This would still be true even if the version of libmad in openembeded-core was higher than the version in ****-openembedded, unless PREFERRED_VERSION_libmad was set to the version in openembedded-core. There is currently no way to prefer a version of a lower priority layer, if the same version is present in a higher priority layer.
openembedded-core and ****-openembedded
These directories contain copies of Git repositories from git.openembedded.org, including the OpenEmbedded-Core layer and the (****-)OpenEmbedded layers. They get created automatically when building the distribution for the first time.
Throughout this document, the combination of these directories will be referred to as OpenEmbedded.
The latest changes to these Git repositories can be seen at:
https://git.openembedded.org/openembedded-core-contrib/log/?h=obi/pyro
https://git.openembedded.org/****-openembedded-contrib/log/?h=obi/pyro
****-opendreambox
This directory contains:
Recipes for packages written specifically for the opendreambox distribution
Modifications to recipes from OpenEmbedded
Recipes for different software versions than those available from OpenEmbedded
****-dreambox
The directory ****-dreambox contains Board Support Packages (BSP) for the supported Dreambox models. This includes:
Hardware drivers
Machine specific overrides
The Linux kernel
The boot loader
Splash images
Prerequisites
The OpenEmbedded project provides a general list of prerequisites for many Linux distributions and also for some other operating systems.
https://www.openembedded.org/wiki/Getting_started#Required_software
It is highly recommended to use Linux to build opendreambox. In theory, any recent distribution will do, but not many distributions have been verified to build opendreambox without errors. Tested distributions include:
Debian 9 „Stretch“ [amd64]
Ubuntu 18.04 LTS „Bionic Beaver“ [amd64]
https://github.com/opendreambox/opendreambox#license