LMLM4 software package notes

   Copyright (C) 2003 Linux Media Labs LLC <vleo@linuxmedialabs.com>

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

Notational: 

commands issued as user start with $, like in:
$ ls

commands issued as root (after su -) start with #, like in:
# rmmod lmlm4-linvs

====================== PREPAIRING KERNEL FOR DRIVER BUILD ============
Unfortunately, even is you install kernel-src rpm on current RedHat 
distibutions (RH8, RH9) you need to do some preparation before you can
build LMLM4 driver (as well as any other driver) from source. 
We provide examples for RH9.

1. Check if there is a symlynk from /usr/src/linux to the source of the
kernel you are running and create it if needed.

ln -s /usr/src/linux-2.4 /usr/src/linux

2. Make sure you have kernel sources RPM installed.

rpm -q kernel-source

should return the version of RPM installed - for example:
kernel-source-2.4.20-6

3. Bring source code tree to a known, clean condition:

cd /usr/src/linux 
make distclean

4. Make kernel configuration the same as for prebuild kernel provided by
Red Hat. For example, if you are running single CPU PIII system :

cp configs/kernel-2.4.20-i686.config .config

5. Edit the Makefile to have EXTRAVARSION line read:

EXTRAVERSION = -6

if your running kernel is -6. You can check this by 'uname -r' command on 
your running kernel.

6. Generate files needed to build the kernel with configuration provided : 

make menuconfig

this will bring curses based GUI dialog, just exit with 'save' option.

7. Build the kernel:

make dep; make; make modules

each phase should complete without errors.


====================== DRIVER INSTALL ================================

In order to build the driver for LMLM4: 

$ cd LMLM4/linvs
$ make

As root create /dev nodes for LinVS (you only need to do that once):
# ./mkvidnodes

As root insert the driver with:

# insmod ./lmlm4-linvs.o

check the results with: 

$ dmesg | grep bootcode

that should give something like:

lmlm4-linvs: boot operation success! bootcode=0x0e59

also, check device status with:

$ cat /dev/mvideo/status

======================= LMLM4 use notes ==============================

You can now capture sample MPEG4 stream with:

$ dd if=/dev/mvideo/stream0 of=/tmp/x.divx bs=64k count=20

in order to encapsulate raw MPEG4/MP3 stream into .AVI file 
you need to build 'aviencap' utility.

go to LMLM4/lmlM4tools and say:

$ ./build.sh

this builds both 'aviencap' and 'lmlm4capture' utilities.

use 'aviencap' like that:

$ ./aviencap < /dev/mvideo/stream0

to start capture/encapsulation process. Use ^C to stop it.

in order to playback the sample, under X11:

$ mplayer divxoutput.avi

'lmlm4capture' is a GUI based utility using lmlm4-linvs ioctls which allows
to set various LMLM4 modes. Since GUIs are self-documenting it should
be obvious how to use it. Selections that are grayed out are not implemented
at this time.

In order to play D1 interlaced streams with mplayer you should run it with
deinterlacing plugin:

$ mplayer -npp lb divxoutput.avi
   

===================== Windows package ==================================

We even provide full set of software for using LMLM4 under Windows -
WindowsSoftPack.zip.

This is truly amazing, but MS-WinXX is 2nd tier platform for us,
so use at your own risk. It works...

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

Check for the updates at:

http://linuxmedialabs.com/LMLCD/LMLM4