
                              -(( S-Jog ))-


Before running S-Jog you will need to load a kernel driver to handle the
special Jog Dial device. This driver is included in recent 2.4.x kernel (>
2.4.5), you must have enabled it at kernel compile time (CONFIG_SONYPI=m) - If
you did not compile your kernel yourself but are using a package instead, check
for sonypi.o file in /lib/modules/<kernel_version>/kernel/drivers/char.

If you don't have a recent kernel, you can still use the legacy driver provided
with S-Jog in the spicdriver directory.


-[ Using the Sony Programmable I/O Driver ]-------------------------------------

To load the sonypi driver, type modprobe sonypi and look for the auto-allocated
minor number in /proc/misc then create the corresponding charater device:

# modprobe sonypi
# cat /proc/misc 
 63 sonypi                <--- 63 will be our minor number
135 rtc
  1 psaux
134 apm_bios
# mknod /dev/sonypi c 10 63


-[ Using the Spic Driver ]------------------------------------------------------

1st you need to compile the driver (it is not done by default). Go to
spicdriver/ directory and type "make", that should be enough.

To load the spicdriver.o module located in the spicdriver/ directory by typing
as root (see next section for compile instruction):

    mknod /dev/spic c 60 0
    insmod spicdriver/spicdriver.o

You will probably want to load the SPIC driver module at runtime, to do so
type:

    cp spicdriver/spicdriver.o /lib/modules/
    echo "insmod /lib/modules/spicdriver.o" >> /etc/rc.d/rc.local


-[ Compiling, Installing S-Jog ]------------------------------------------------

To compile and install S-Jog, type:
    ./configure
    make
    make install   <-- must be root for this one

To run S-Jog, just type "sjog". If everything goes well, you will see a small
window appear in the middle of the screen, enjoy ;)


-[ Note ]-----------------------------------------------------------------------

S-Jog uses the setbrightness external program to set the brightness of the
screen. This program has been taken from the picturebook utilities suite
written by Andrew Tridgell <tridge@linuxcare.com>. A custom version of
setbrightness is located in the setbrightness/ directory of S-Jog repository.
It will be compiled and installed in the same time as S-Jog itself.


