docs/introduction.txt

   1 // -*- mode:doc; -*-
   2 // vim: set syntax=asciidoc:
   3
   4 About OpenADK
   5 =============
   6
   7 OpenADK is a tool that simplifies and automates the process of
   8 building a complete Linux system for an embedded system, using
   9 cross-compilation. ADK stands for appliance development kit.
  10
  11 In order to achieve this, OpenADK is able to generate a
  12 cross-compilation toolchain, a root filesystem, a Linux kernel image
  13 and a bootloader for your target.
  14
  15 OpenADK is useful mainly for people working with embedded systems,
  16 but can be used by people playing with emulators or small netbooks
  17 needing a fast and small Linux system.
  18
  19 OpenADK can also be used to generate a cross-toolchain for any kind
  20 of architecture and C library combination. It supports uClibc-ng, musl,
  21 GNU libc and newlib. With newlib support you can build bare-metal toolchains
  22 without need for Linux as operating system.
  23
  24 Embedded systems often use processors that are not the regular x86
  25 processors everyone is used to having in his PC.
  26
  27 OpenADK supports 40 different architectures:
  28 AARCH64, Alpha, ARC, ARM, AVR32, Blackfin, C6X, CR16, CRIS, Epiphany, FR-V,
  29 H8/300, HPPA, IA64, LM32, M32R, M68K, METAG, Microblaze, MIPS, MIPS64, MN10300,
  30 Moxie, MSP430, NDS32, NIOS2, OR1K, PPC, PPC64, RiscV, RX, S/390, SH, SPARC, SPARC64, Tile,
  31 V850, X86, X86_64 and Xtensa.
  32
  33 OpenADK supports numerous processors and their variants; it also comes
  34 with sample configurations for many embedded systems, emulators and netbooks.
  35
  36 OpenADK is not a Linux distribution and there are no releases or binary
  37 packages available. If you need something like that, better switch to
  38 something else. OpenADK builds everything from source. There are only a
  39 few exceptions to this rule (f.e. some bootloaders and firmware files for
  40 wireless network cards).