Please note that User Registration has been temporarily disabled due to a recent increase in automated registrations. If anyone needs an account, please request one here: RequestAccount. Thanks for your patience!--Wmat (talk)
Please email User:Wmat if you experience any issues with the Request Account form.

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

From eLinux.org
Jump to: navigation, search
(GUI Editor)
 
(16 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 
== Summary ==
 
== 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_.
+
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.
 
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 ==
== GUI Editor ==
+
 
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 run the command
+
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
  
[[image:Make_menuconfig.png|500px|left|thumb|make menuconfig start screen]]
+
[[image:Make_menuconfig.png|500px]]
  
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.
+
 
 +
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 ==
 
== Manual Config Editing ==
If you would prefer to use a text editor, you can open the .config file in your editor of choice. Or copy one of the predefined ones to your main directory and rename it .config and then open it in your text editor. You will see a long list of options. Comment out to deselect the option, or uncomment and change "#OPTION is not set" to "OPTION=y" to enable it.
+
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.
 +
 
 +
 
 +
[[Category:Didj]]
 +
[[Category:Leapster Explorer]]
 +
[[Category:LeapPad Explorer]]
 +
[[Category:LeapFrog Pollux Platform]]

Latest revision as of 02:57, 21 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.