(C) 2005  Alexander Shaposhnikov  <shaposh@isp.nsc.ru>

Licensed under the terms of the GNU GPL License version 2.
Based upon reverse engineered information.

Driver version "0.1".


BIG FAT DISCLAIMER: Work in progress code. Possibly *dangerous*.



			1. Introduction.
This is a first version of cpu frequency changing driver for AMD Athlon64 
and Opteron processors on Force4-based motherboards. Unlike powernow-k8 driver,
which you may find in the kernel tree, this driver changes FSB speed on the
motherboard, so it allows for overclocking your processor(s). It is currently
only tested on ASUS K8N-DL motherboard, with two Dualcore Opterons 265. I hope
it will work on other nForce4 motherboards as well. I was not able to test
it yet.

			2. How to use it.
First, you must have full set of GNU development tools, including gcc and make.
All modern Linux distributions should allow you to choose appropriate options
during installation, so it is not a problem. Next, you must have the kernel
source tree for the current working kernel. You have to enable  cpufreq
support in the "Power management options/Cpu Frequency scaling", and disable
"AMD Opteron/Athlon64 PowerNow!" as "CPUFreq procesor driver". You may compile
this driver as a module, but make sure it is not loaded if you want to use
cpufreq_nForce4.

Then, type in the directory there the source code resides:

>make prep 
>make

If everything went well,you will find the cpufreq_nForce4.ko kernel module
in this directory. Become a root, and load it with the command 

>insmod cpufreq_nForce4.ko

If module inserting was successfull, you can start to change speed of
your processor(s) :). See
<Path To Your Kernel Source>/Documentation/cpu-freq/user-guide.txt for
the further instructions.

The module accepts two arguments, STARTVOLT=integer value for cpu voltage
in millivolts, and STARTMULT=integer value for multiplier. For example:

>insmod cpufreq_nForce4.ko STARTVOLT=1400 STARTMULT=10

will set voltage to 1.4V and multiplier to 10.

The minimum and maximum possible values for voltage and multiplier
depends on CPU. For example, DualCore Opteron (stepping E6) has default
voltage of 1.3 or 1.35 and max of 1.4, minimum is 0.8. Maximum multiplier
is default multiplier (except for engineering samples), minimum is 4.

After testing, you may wish to schedule the driver loading through some
scripting system appropriate for your distribution. You may also want to
create some helper script to access sysfs interface, or use any userspace
utility appropriate.


		    3. Troubleshooting.
At this stage I really cannot provide a troubleshooting tips or help.
Remember that CPU overclocking is dangerous and may lead to system hang
and data loss. If you have some consistent problems with the driver and
believe its not your hardware, contact me and describe the problem.
But I cannot guarantee I can help. Good luck!






