doky

Description

Doky is a Yocto distribution based on the Yocto reference distribution, Poky. It is intended to be used as the base for proprietary projects, and therefore aims to avoid problematic licenses in the resulting firmware.

It is beginning life as a learning / testing playground, but hopes to become more widely useful.

Table of Contents

1. Description
2. Table of Contents
3. Build prerequisites
   1. On Debian
   2. Locale note
4. Integration layer
   1. Based on the Yocto Project and OpenEmbedded
      1. A note on LLVM as runtime
   2. Contains additional support layers
   3. Additional out-of-tree layers may be added
5. Miscellany
6. Authors and acknowledgment
7. License
8. Project status

Build prerequisites

See Yocto Project Quick Build

On Debian

sudo apt install build-essential chrpath cpio debianutils diffstat file gawk gcc git iputils-ping libacl1 liblz4-tool locales python3 python3-git python3-jinja2 python3-pexpect python3-pip python3-subunit socat texinfo unzip wget xz-utils zstd python3-websockets

Locale note

Requires en_US.UTF-8 locale be available on system.

Integration layer

Based on the Yocto Project and OpenEmbedded

As an integration layer Doky consists of several upstream projects such as BitBake, OpenEmbedded-Core layer, CLang Layer layer, and Raspberry Pi BSP layer which have configuration and hardware support components. These components are all part of the Yocto Project and OpenEmbedded ecosystems.

The Yocto Project has extensive documentation about the system including a reference manual which can be found at https://docs.yoctoproject.org/

OpenEmbedded is the build architecture used by Poky and the Yocto project. For information about OpenEmbedded, see the OpenEmbedded website.

A note on LLVM as runtime

This project began using LLVM from meta-clang as the default toolchain and C++ runtime, however due to a number of incompatibilities this approach has been deferred and the default toolchain is GCC and GNU libstdc++.

Contains additional support layers

1. TODO: Add repo and link
2. TODO: Add repo and link for tweaked BSP

Additional out-of-tree layers may be added

E.g. ../meta-proprietary can be a directory containing a layer which is not to be published publicly, and added via bitbake-layers add-layer ../meta-proprietary.

Miscellany

Doky is pronounced Doh-key, unlike Poky, which is pronounced Paw-key, because the original author's brain always wants to call Poky Poke-y.

Authors and acknowledgment

Doky is currently authored by Daniel F. Dickinson, with much code from the Yocto Project and OpenEmbedded

License

Doky itself is licensed under the Apache-2.0 license. Other project's licenses are indicated in their respective folders.

Project status

Learning / testing mode, very part-time.