################################## # Introduction ################################## Using config fragments in the Linux kernel is a supported model in the Linux kernel main line. TI has taken advantage of this model to be able to take a base defconfig and add or remove configuration flags based contained within a config fragment. This allows the base defconfig to be left in tact and helps facilitate and understanding of what config flags can be enabled or disabled. The config fragments drastically reduces the number of merge conflicts when the Linux stable dot release (LTS) is merged back to the integration point as well as merges for TI domain trees. But alas this creates another issue as with the config fragments there is no direct defconfig for customers to build just many, many, many options. Therefore the defconfig_builder script was derived to take a defconfig map file and present a command line interface to the customer to to create a standard defconfig based off the TI integration branches. The customer is walked through steps and if successful a defconfig will be created in the arch/arm/configs directory that can be built. ################################## # Requirements ################################## * awk v1.2 or greater. * bash shell 4.3.11(1)-release or greater. * Coreutils package v8.1 or greater. * grep (GNU grep) v2.16 or greater. * Linux kernel with merge_config script. * sed (GNU sed) v4.2.2 or greater. ################################## # Usage ################################## There is only one option for this script. This option defines the working path to where the Linux kernel resides. -w - Location of the TI Linux kernel -t - Indicates the type of defconfig to build. This will force the defconfig to build without user interaction. -l - List all buildable defconfig options Command line example to generate the TI SDK AM335x processor defconfig automatically without user interaction: ti_config_fragments/defconfig_builder.sh -t ti_sdk_am3x_release Command line Example if building from the ti_config_fragments directory: defconfig_builder.sh -w ../. User interactive command line example: ################################## # Defconfig Map File ################################## The defconfig map file contains the mapping of the defconfig options and the assembly instructions for the defconfig to be created. The file contains keywords and all are *required* to be filled out. classification: - Defines the class of the defconfig which can be Release, Debug, System Test. type: - Defines the type of build. Like debug build, LSK build or RT build defconfig: - Defines the base defconfig config to append the config fragments to config_file: - Defines a file that contains a list of config fragments. If there is not a list then declare "None" for this field. extra_configs: - These are individual config fragments that can be appended to the defconfig by themselves or in addition to the config_file. A Note on ordering of "extra_configs": In general, config fragments should be listed such that the fragment with more restrictive options goes towards the end of the list. This makes sure that those options are not inadvertently overridden by more generically applicable options. More concretely, the following ordering is recommended: 1) Pruning of non-TI features 2) Introduce domain specific features 3) Optimize for an SoC family 4) Optimize for a particular SoC 5) Introduce distribution specific features. (example: Android) Example: This is an example of an AM335x entry that will create a defconfig only for AM335x processors, based on the omap2plus_defconfig. The defconfig_fragment file adds features that have been enabled in the TI integrated kernel. The extra_configs will add in the debug options as well as undefine all processors that are not AM335x. classification: SDK_release type: ti_sdk_am3x_release defconfig: multi_v7_defconfig config_file: None extra_configs: multi_v7_prune.cfg baseport.cfg ipc.cfg connectivity.cfg audio_display.cfg omap_soc.cfg am33xx_only.cfg systemd.cfg ################################## # Defconfig Mapping ################################## #Processor Specific Defconfig options These defconfig options enable the Linux kernel for the targer processor only. Other processor platforms are disabled. The base for each of these defconfigs is the omap2plus_defconfig contained in the arch/arm/configs directory of the kernel. TI Base Integrated Kernel: am335x_only - Adds the configs from the files contained in the defconfig_fragment file. am335x_debug_only - Adds the configs from the files contained in the defconfig_fragment file and adds in the debug options from the debug_options.cfg am43x_only - Adds the configs from the files contained in the defconfig_fragment file. am43x_debug_only - Adds the configs from the files contained in the defconfig_fragment file and adds in the debug options from the debug_options.cfg dra7xx_only - Adds the configs from the files contained in the defconfig_fragment file. dra7xx_debug_only - Adds the configs from the files contained in the defconfig_fragment file and adds in the debug options from the debug_options.cfg Linaro Stable Kernel builds: (These configurations are only available on the TI LSK branch.) am335x_lsk_only - Adds the configs from the files contained in the defconfig_fragment file and adds in the linaro options from the linaro/configs directory am335x_lsk_debug_only - Adds the configs from the files contained in the defconfig_fragment file and adds in the debug options from the debug_options.cfg as well as the linaro options from the linaro/configs directory am43x_lsk_only - Adds the configs from the files contained in the defconfig_fragment file and adds in the linaro options from the linaro/configs directory am43x_lsk_debug_only - Adds the configs from the files contained in the defconfig_fragment file and adds in the debug options from the debug_options.cfg as well as the linaro options from the linaro/configs directory dra7xx_lsk_only - Adds the configs from the files contained in the defconfig_fragment file and adds in the linaro options from the linaro/configs directory dra7xx_lsk_debug_only - Adds the configs from the files contained in the defconfig_fragment file and adds in the debug options from the debug_options.cfg as well as the linaro options from the linaro/configs directory TI Based Real Time Kernel: (These configurations are only available on the TI RT branch.) am335x_rt_only - Adds the configs from the files contained in the rt_defconfig_fragment file. am335x_rt_debug_only - Adds the configs from the files contained in the rt_defconfig_fragment file and adds in the debug options from the debug_options.cfg. am43x_rt_only - Adds the configs from the files contained in the rt_defconfig_fragment file. am43x_rt_debug_only - Adds the configs from the files contained in the rt_defconfig_fragment file and adds in the debug options from the debug_options.cfg. dra7xx_rt_only - Adds the configs from the files contained in the rt_defconfig_fragment file. dra7xx_rt_debug_only - Adds the configs from the files contained in the rt_defconfig_fragment file and adds in the debug options from the debug_options.cfg. #OMAP2+ Defconfig Options These defconfig options use the omap2plus_defconfig in the arch/arm/configs directory as the base defconfig. These options do not disable any processor's or platforms but add additional features that TI Base Integrated Kernel: omap2plus_debug - Takes the omap2plus_defconfig and only adds the debug options from the debug_options.cfg. ti_omap2plus - Adds the configs from the files contained in the defconfig_fragment file. ti_omap2plus_debug - Adds the configs from the files contained in the defconfig_fragment file and adds in the debug options from the debug_options.cfg Linaro Stable Kernel builds: (These configurations are only available on the TI LSK branch.) ti_lsk_omap2plus - Adds the configs from the files contained in the defconfig_fragment file and adds in the linaro options from the linaro/configs directory. ti_lsk_omap2plus_debug - Adds the configs from the files contained in the defconfig_fragment file and adds in the debug options from the debug_options.cfg as well as the linaro options from the linaro/configs directory TI Based Real Time Kernel: (These configurations are only available on the TI RT branch.) ti_rt_omap2plus - Adds the configs from the files contained in the rt_defconfig_fragment file. ti_rt_omap2plus_debug - Adds the configs from the files contained in the rt_defconfig_fragment file and adds in the debug options from the debug_options.cfg. #Keystone Defconfig Options These defconfig options use the keystone_defconfig in the arch/arm/configs directory as the base defconfig. These options do not disable any processor's or platforms but add additional features that TI Base Integrated Kernel: base_keystone_debug - Takes the keystone_defconfig and only adds the debug options from the debug_options.cfg. ti_keystone defconfig - Adds the configs from the files contained in the multi_core_defconfig_fragment file. ti_keystone_debug - Adds the configs from the files contained in the multi_core_defconfig_fragment file and adds in the debug options from the debug_options.cfg. Linaro Stable Kernel builds: (These configurations are only available on the TI LSK branch.) ti_lsk_keystone - Adds the configs from the files contained in the multi_core_defconfig_fragment file and adds in the linaro options from the linaro/configs directory ti_lsk_keystone_debug_only - Adds the configs from the files contained in the multi_core_defconfig_fragment file and adds in the debug options from the debug_options.cfg as well as the linaro options from the linaro/configs directory TI Based Real Time Kernel: (These configurations are only available on the TI RT branch.) ti_rt_keystone - Adds the configs from the files contained in the rt_defconfig_fragment file. ti_rt_keystone_debug - Adds the configs from the files contained in the rt_defconfig_fragment file and adds in the debug options from the debug_options.cfg.