Difference between revisions of "LeapFrog Pollux Platform: Kernel Configuration"

From eLinux.org
Jump to: navigation, search
(Make Menuconfig)
 
(7 intermediate revisions by 2 users not shown)
Line 4: Line 4:
 
There is two ways to edit your configuration files, either with a text editor, or the make menuconfig GUI. This tutorial will go over the basics of editing your config file. Tutorials referencing this, should supply you with the options you need to configure, which this guide will help you apply.
 
There is two ways to edit your configuration files, either with a text editor, or the make menuconfig GUI. This tutorial will go over the basics of editing your config file. Tutorials referencing this, should supply you with the options you need to configure, which this guide will help you apply.
  
 +
== Prerequisites ==
 +
[[LeapFrog_Pollux_Platform:_Build_Environment| Setup Build Environment]]
 +
 +
== Software Needed ==
 +
[[LeapFrog_Pollux_Platform:_Source_Code| Source Code]]
  
 
== Using Preexisting Config ==
 
== Using Preexisting Config ==
LeapFrog provides a couple different config files in their sources, listed in the SOURCE_CODE/linux-2.6/arch/arm/configs directory, prefixed with lf1000_. If one of these files has all the settings you need, or atleast a good start on the ones you want to set, you can easily make it your default config file by running this command.
+
LeapFrog provides a couple different config files in their sources, listed in the SOURCE_CODE/linux-2.6/arch/arm/configs directory, with names like lf1000_<options>_defconfig. If one of these files has all the settings you need, you can easily make it your default config file by running this command.
  make <config_file>
+
  make lf1000_<options>_defconfig
This copies the lf1000_<config> file to the main directory and renames it .config, you can then proceed to build your kernel from here, or if you require some more options to be set, continue on.
+
This copies the lf1000_<options>_defconfig file to the main directory and renames it .config, you can then proceed to build your kernel from here, or if you require some more options to be set, continue on.
 
 
  
 
== Make Menuconfig ==
 
== Make Menuconfig ==
 
The GUI editor makes it rather easy to edit your config file, as everything is categorized for you, making options easy to find. To start the menuconfig program, in a terminal move to your LeapFrog Linux source directory of choice, and into the main kernel directory, usually named something like linux-2.6/
 
The GUI editor makes it rather easy to edit your config file, as everything is categorized for you, making options easy to find. To start the menuconfig program, in a terminal move to your LeapFrog Linux source directory of choice, and into the main kernel directory, usually named something like linux-2.6/
  
From the command line you'll need to import one of the preexisting config files located in /linux-2.6/arch/arm/configs, then you can change it. Run the commands
+
You'll need to import one of the preexisting config files located in SOURCE_CODE/linux-2.6/arch/arm/configs, if this is your first time building this source tree, if not, you can omit this step.
$ make menu lf1000_<options>_defconfig
+
  $ make lf1000_<options>_defconfig
 +
 
 +
Once you've got a .config file you can then change it by running make menuconfig.
 +
 
 
  $ make menuconfig
 
  $ make menuconfig
  
Line 21: Line 28:
  
  
This is the first screen you will see after the program loads. Up/Down arrows move the selection and space enters or selects, while Right/Left moves between Select/Exit/Help. You can use the space bar or Y, N, or M to make your selections. Y=include, N=exclude, and M=Module. Include makes it part of the kernel, while module requires loading it from user space. To navigate out of a category highlight Exit, and hit return, this will back you out until you get to the main screen, if you hit Exit at the main screen it will ask if you would like to save, hit Yes if you're all done and want to keep the changes, or No to close and discard all changes.
+
This is the first screen you will see after the program loads. Up/Down arrows move the selection and space enters or selects, while Right/Left moves between Select/Exit/Help. You can use the space bar or Y, N, or M to make your selections. Y=include, N=exclude, and M=Module. Include makes it part of the kernel, while module requires loading it from user space. To navigate out of a category highlight Exit, and hit Return, repeat this until you get to the main screen (Linux Kernel Configuration). Exiting at the main screen it will ask if you would like to save, hit Yes if you're all done and want to keep the changes, or No to close and discard all changes.
  
  
Once you are done, and save your configuration, it will update the .config file, and you are ready to compile your kernel with its new options.
+
Once you are done, and save your configuration, it will update the .config file, and you are ready to compile your kernel with its new options. Once you are happy that your configuration works it's a sensible idea to backup your .config, give it a memorable name like lf1000_my_special_defconfig, keep a copy safe somewhere and put a copy of it in linux-2.6/arch/arm/configs, you will then be able to make whatever changes you like to your working .config and be able to call it with:
 +
make lf1000_my_special_defconfig
  
 
== Manual Config Editing ==
 
== Manual Config Editing ==

Latest revision as of 19:57, 20 July 2011

Summary

There are various options that can be set when compiling a Linux kernel for the LeapFrog Pollux Platform. In the linux-2.6/ kernel directory you will find a file called .config, you may need to turn on "View Hidden Files" or ls -al in terminal to see it. This file is where your configuration options are stored. There are also several default config files listed in the SOURCE_CODE/linux-2.6/arch/arm/configs directory. The ones we are interested in are prefixed with lf1000_. It is recommended that you back up your .config file before making changes or replacing it.

There is two ways to edit your configuration files, either with a text editor, or the make menuconfig GUI. This tutorial will go over the basics of editing your config file. Tutorials referencing this, should supply you with the options you need to configure, which this guide will help you apply.

Prerequisites

Setup Build Environment

Software Needed

Source Code

Using Preexisting Config

LeapFrog provides a couple different config files in their sources, listed in the SOURCE_CODE/linux-2.6/arch/arm/configs directory, with names like lf1000_<options>_defconfig. If one of these files has all the settings you need, you can easily make it your default config file by running this command.

make lf1000_<options>_defconfig

This copies the lf1000_<options>_defconfig file to the main directory and renames it .config, you can then proceed to build your kernel from here, or if you require some more options to be set, continue on.

Make Menuconfig

The GUI editor makes it rather easy to edit your config file, as everything is categorized for you, making options easy to find. To start the menuconfig program, in a terminal move to your LeapFrog Linux source directory of choice, and into the main kernel directory, usually named something like linux-2.6/

You'll need to import one of the preexisting config files located in SOURCE_CODE/linux-2.6/arch/arm/configs, if this is your first time building this source tree, if not, you can omit this step.

 $ make lf1000_<options>_defconfig

Once you've got a .config file you can then change it by running make menuconfig.

$ make menuconfig

Make menuconfig.png


This is the first screen you will see after the program loads. Up/Down arrows move the selection and space enters or selects, while Right/Left moves between Select/Exit/Help. You can use the space bar or Y, N, or M to make your selections. Y=include, N=exclude, and M=Module. Include makes it part of the kernel, while module requires loading it from user space. To navigate out of a category highlight Exit, and hit Return, repeat this until you get to the main screen (Linux Kernel Configuration). Exiting at the main screen it will ask if you would like to save, hit Yes if you're all done and want to keep the changes, or No to close and discard all changes.


Once you are done, and save your configuration, it will update the .config file, and you are ready to compile your kernel with its new options. Once you are happy that your configuration works it's a sensible idea to backup your .config, give it a memorable name like lf1000_my_special_defconfig, keep a copy safe somewhere and put a copy of it in linux-2.6/arch/arm/configs, you will then be able to make whatever changes you like to your working .config and be able to call it with:

make lf1000_my_special_defconfig

Manual Config Editing

If you would prefer to use a text editor, you can open one of the lf1000_<options>_defconfig files in SOURCE_CODE/linux-2.6/arch/arm/configs with your editor of choice. Then save it to your /linux-2.6 directory renaming it .config. You will see a long list of options. Comment out with a # to deselect the option, or uncomment and change "#OPTION is not set" to "OPTION=y" to enable it.