HOWTO (re) Compile a Xandros Kernel with ACPI support.

Proceed at your own risk.

You may do serious harm to your system by performing these steps, and may
need to re-install your system.

Notes are at the bottom.

This document assumes the following things:

A) The following applications/packages have been installed on your system:

    1) make
    2) gcc (the C/C++ Compiler)
    3) Xandros Kernel Source package (called xandros-kernel-source-2.4.19)
    4) flex

These packages are all available on the Xandros 1.0 installation CD, and are
typically part of a "FULL" system install.  If you did an express, or custom
minimal or standard install, you can use the "Xandros Update" package to
install them from your CD.

    5) libdb3-dev
    6) byacc

These packages will need to be downloaded from a debian woody apt-source.

B) That you understand how to use a text editor such as "vi" or "mcedit" to
edit files.

C) You wish to compile a kernel for a single-CPU system.  If you wish to
compile a kernel for an SMP system, adjust steps 8 & 11 as noted.

D) You realize that if you compile and install your own kernel, you may have
problems with future official updates from Xandros.  You have been warned.


----------------------------------------------------------------------------------------------------------

Once you have installed the Kernel Source package, follow these steps:

1) login as Administrator
2) Startup Mozilla and download the following file from the Internet:

http://umn.dl.sourceforge.net/sourceforge/acpi/acpi-20020918-2.4.19.diff.gz

Save it in the /usr/src/ directory.

3) Start a console (Launch -> Applications -> System -> Console)
4) Type:

     cd /usr/src/
     ls -l

This directory should contain a file called
"xandros-kernel-source-2.4.19.tar.bz2".  If not, please install the package
from your CD.  It should also include the acpi file just downloaded.

4) Type:

    tar jxf xandros-kernel-source-2.4.19.tar.bz2
    
This will uncompress the kernel sources into a directory called:
xandros-kernel-source-2.4.19

5) Type:

   ln -s xandros-kernel-source-2.4.19 linux
   
This command creates a link so frequently used path of /usr/src/linux/ goes
to the Xandros Source directory.  If you already have a /usr/src/linux/
directory, please rename it before doing the above "link".

6) Type:

   cd /usr/src/linux/
   zcat /usr/src/acpi-20020918-2.4.19.diff.gz | patch -p1


7) Open the file "Makefile" in your editor.
8) Change line 4 from:

    EXTRAVERSION =
    
   to
   
    EXTRAVERSION = -x1
    
   (-x1-smp for SMP systems)
   
9) Save the changed file.
10) Type:

   make mrproper
   
11) Type:

   cp /boot/config-2.4.19-x1 .config
   
   (/boot/config-2.4.19-x1-smp for SMP systems)
   
12) Type:

    make oldconfig
    
It will ask you some questions, answer M) module for all of them.    

13) Type:

    make dep
    make bzImage
    make install
    make modules
    make modules_install
    
    /sbin/mkinitrd


14) Open the file "/etc/devices/devices.inf" in your editor
15) Find the [image.XandrosDesktop*] section
16) Change the kernel_args line from:

    kernel_args = "rw acpi=off "
    
    to
    
    kernel_args = "rw acpi=on "
    
Note: Do not change all [image.*] sections like this.  If there are problems
with your system and the acpi patches, you should be able to boot into the
rescue console to fix it.

17) Save the changed file.
18) Type:

    /sbin/fooze

19) Open the file "/etc/devices/drivers" in your editor

20) Add the following lines:

     94 processor
     94 button
     94 fan
     94 thermal

If you are using a laptop, also add these lines:

     94 battery
     94 ac
     
If you are using a toshiba "legacy free" laptop, also add this line:

     94 toshiba_acpi

21) Save the changed file.
22) Type:

     /sbin/xangenmodules

23) Reboot your system.

------------------------------------------------------------------

Some Notes:

1) If you wish to make other configuration changes to your kernel, you may
execute one of the standard kernel configuration options before step 13.  
Note: "make menuconfig" may require other development packages to be
installed such as libncurses-dev.

2) For further notes, please go to: http://acpi.sourceforge.net/documentation/

3) If your system failed while compiling the modules, you may not have
installed the libdb3-dev package.

4) ACPI information on your system will be in the /proc/acpi/ directory.