liSight Documentation

liSight Documentation

Home Download Code Documentation Contact

Basic Installation

===========================

1. Obtain a fresh linux kernel sourcetree and uncompress it somewhere


  - cd /usr/src
  - tar jxvf linux-source-2.6.x.tar.bz2

2. Apply the lisight patch

  - cd /usr/src/linux-2.6.x
  - patch -p 1 < /path/to/lisight/lisight-kernel.patch

3. Build patched ieee1394 modules

3.1

make sure you have already configured the kernel to enable ieee1394 and ohci1394
support as modules (and obviously alsa support)

  - make modules
  - make modules install

3.2

if you don't want to rebuild all modules, but you prefer to compile only ieee1394 stuff

  - make SUBDIRS=drivers/ieee1394 modules
  - cp drivers/ieee1394/*.ko in /lib/modules/2.6.x/kernel/drivers/ieee1394/
   (or whatever is the module directory on your system)

4. Build the liSight kernel module

 - cd /path/to/lisight

edit Makefile to define the right path to kernel sources (check for KDIR variable)
and to eventually setup variables to fit your environment (check also for HOSTCFLAGS
and DEST ones)

 - make

Now, if everything is ok in the Makefile, you should have obtained lisight.ko in your current dir.
Be sure to have unloaded previous versions of ieee1394 and ohci1394 modules
and then execute :

5. Test the liSight module you have just built

 - modprobe ohci1394
 - insmod ./lisight.ko

now try :
 - dmesg

and check for this line : "liSight: liSight module loaded"
if it's there...the module was loaded successfully

try to connect your isight.
Check dmesg again and if you don't see the following message :
"Sight_0: Found new iSight. Register file is at offset 0x00008000"
probably you have still loaded an unpatched ohci1394.ko module.
Reload the new one or check if the patch was applied properly.

Now, if everything is working properly you can exec:

 - cat /dev/sndstat

and see the iSight enumerated within audio devices

If you haven't already done, enable alsa-oss emulation
modprobe snd-pcm-oss

If you have a local soundcard,
you should find one /dev/dspN associated to your local soundcard
and one /dev/dspM associated to your isight
(N and M are the numbers you saw when "cat /dev/sndstat" was executed)
Now you can simply execute :
cat /dev/dspM > /dev/dspN (read from the isight and write to your local soundcard)
and you will hear the audio coming from the isight microphone.

If you have alsa-tools installed you can also try:
arecord -Dhw:M,0 -c 2 -f S16_BE -r 48000 | aplay

6. Install the liSight module

 - cp /path/to/lisight/lisight.ko /lib/modules/2.6.x/kernel/drivers/misc/
 - depmod -a

7. NOTES

If you use initrd during boot process, remeber to update the image to make it
contain new ieee1394/ohci1394 modules and also the isight one