Add option to mount debugfs at startup
[openadk.git] / docs / customize-kernel-config.txt
blob44f04ef2d113c8c3ba1dfb50910fec0a552cd3da
1 // -*- mode:doc; -*-
2 // vim: set syntax=asciidoc:
4 [[kernel-custom]]
5 Customizing the Linux kernel configuration
6 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
8 The Linux kernel can be configured in the following manners by choosing the
9 desired "Kernel configuration" option in the OpenADK configuration menu:
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
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.
24 If you just want to view the Linux configuration, which is actually
25 used for your target, you can execute following command:
27 ---------------
28  $ make kernelconfig
29 ---------------
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.
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>+.
39 So if you would like to change any basic stuff, just edit the files and recreate your
40 firmware via:
42 ---------------
43  $ make
44 ---------------
46 OpenADK automatically recognizes any change and will rebuild the kernel.
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)
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.
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.
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
65 ---------------
66  $ make savekconfig
67 ---------------
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.