README.md
1 # Android Kernel Config Fragments
2
3 The files in these directories are meant to be used as a base for an Android
4 kernel config. All devices must have the options in `android-base.cfg` configured
5 as specified. If an `android-base-ARCH.cfg` file exists for the architecture of
6 your device, the options in that file must be configured as specified also.
7
8 While not mandatory, the options in `android-recommended.cfg` enable advanced
9 Android features.
10
11 Assuming you already have a minimalist defconfig for your device, a possible
12 way to enable these options would be to use the `merge_config.sh` script in the
13 kernel tree. From the root of the kernel tree:
14
15 ```sh
16 ARCH=<arch> scripts/kconfig/merge_config.sh <...>/<device>_defconfig <...>/android-base.cfg <...>/android-base-<arch>.cfg <...>/android-recommended.cfg
17 ```
18
19 This will generate a `.config` that can then be used to save a new defconfig or
20 compile a new kernel with Android features enabled.
21
22 Because there is no tool to consistently generate these config fragments,
23 lets keep them alphabetically sorted instead of random.
24