docs/customize-kernel-config.txt

   1 // -*- mode:doc; -*-
   2 // vim: set syntax=asciidoc:
   3
   4 [[kernel-custom]]
   5 Customizing the Linux kernel configuration
   6 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
   7
   8 The Linux kernel can be configured in the following manners by choosing the
   9 desired "Kernel configuration" option in the OpenADK configuration menu:
  10
  11 * using +make menuconfig+ in conjunction with an OpenADK minimal configuration
  12 * choosing a Linux kernel in-tree default configuration
  13 * providing an extern kernel configuration file
  14
  15 Choosing the first option, OpenADK uses a combination of Linux miniconfig
  16 feature and user defined features to generate a valid Linux configuration for
  17 your target. Some features and drivers are not selectable via
  18 +make menuconfig+, either because your choosen target system does not have
  19 support for it or the option is not implemented, yet. OpenADK uses some kind of
  20 abstraction layer between the real full featured and complicated Linux kernel
  21 configuration and you. It is not perfect and does include a lot of manual work
  22 in +target/linux/config+, but it works in an acceptable way.
  23
  24 If you just want to view the Linux configuration, which is actually
  25 used for your target, you can execute following command:
  26
  27 ---------------
  28  $ make kernelconfig
  29 ---------------
  30
  31 Any changes here will get lost and will not be used to generate a kernel for
  32 your target. If you want to change the existing kernel configuration you need
  33 to follow these steps.
  34
  35 The basic kernel configuration used for your choosen target is concatenated from
  36 following two files:
  37 +target/linux/kernel.config+ and +target/<arch>/kernel/<system>+.
  38
  39 So if you would like to change any basic stuff, just edit the files and recreate your
  40 firmware via:
  41
  42 ---------------
  43  $ make
  44 ---------------
  45
  46 OpenADK automatically recognizes any change and will rebuild the kernel.
  47
  48 The base kernel configuration for your target generated by OpenADK is normally just enough to
  49 bootup the system with support for your board, serial console, network card and boot medium.
  50 (like a hard disk, sd card or flash partition)
  51
  52 If you need to enable some new optional drivers or features, which are not available in
  53 +make menuconfig+, you need to dig in +target/linux/config+. There is the abstraction layer
  54 for the real kernel configuration.
  55
  56 The defconfig option will choose a kernel in-tree default configuration
  57 specific to your target architecture. You won't be able to do further
  58 customization.
  59
  60 Choosing the external configuration option, the OpenADK menu will prompt for
  61 the location of a Linux +.config+ file relative to the OpenADK root directory.
  62 You will be able to alter the configuration by +make kernelconfig+. But the
  63 changes will get lost unless you save your changes by executing
  64
  65 ---------------
  66  $ make savekconfig
  67 ---------------
  68
  69 after completing the Linux kernel configuration dialog. Despite this is the
  70 most flexible way to configure the kernel, keep in mind that you are fully
  71 responsible to enable all kernel features needed to mount your filesystems
  72 and required by your applications.