annotate README @ 6:d3fdefea8bce

Update info and add a little fix to clean
author AngelCarpintero
date Sat, 12 Jul 2008 17:12:25 +0000
parents bcf5fe83f332
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
0
5f21a4dddc0c Initial checkin
KennethLavrsen
parents:
diff changeset
1 vloopback is a video4linux driver providing video pipes.
5f21a4dddc0c Initial checkin
KennethLavrsen
parents:
diff changeset
2 With the driver you can use the output of a user program to feed a program that
5f21a4dddc0c Initial checkin
KennethLavrsen
parents:
diff changeset
3 would normally communicate with a video4linux device.
5f21a4dddc0c Initial checkin
KennethLavrsen
parents:
diff changeset
4 To achieve this a video pipe consists out of two video4linux devices:
5f21a4dddc0c Initial checkin
KennethLavrsen
parents:
diff changeset
5 one for the generating program to write its data to and one for a normal
5f21a4dddc0c Initial checkin
KennethLavrsen
parents:
diff changeset
6 video4linux program to read from.
5f21a4dddc0c Initial checkin
KennethLavrsen
parents:
diff changeset
7
5f21a4dddc0c Initial checkin
KennethLavrsen
parents:
diff changeset
8 At the moment there are only few programs that can feed the input of the pipe:
5f21a4dddc0c Initial checkin
KennethLavrsen
parents:
diff changeset
9 invert and resize, the example programs with the driver and
5f21a4dddc0c Initial checkin
KennethLavrsen
parents:
diff changeset
10 motion, my motion detection program.
5f21a4dddc0c Initial checkin
KennethLavrsen
parents:
diff changeset
11
5f21a4dddc0c Initial checkin
KennethLavrsen
parents:
diff changeset
12 Just type 'make' and then 'insmod vloopback'.
5f21a4dddc0c Initial checkin
KennethLavrsen
parents:
diff changeset
13 If you want more pipes use 'insmod vloopback pipes=N' with N between 1 and 16.
5f21a4dddc0c Initial checkin
KennethLavrsen
parents:
diff changeset
14 If you want to create spare pipes use 'spares=N'.
5f21a4dddc0c Initial checkin
KennethLavrsen
parents:
diff changeset
15
5f21a4dddc0c Initial checkin
KennethLavrsen
parents:
diff changeset
16 Type 'dmesg' to see which video devices have been created as input and output.
5f21a4dddc0c Initial checkin
KennethLavrsen
parents:
diff changeset
17 For example: if you have a camera on /dev/video0 the input pipe will most likely
5f21a4dddc0c Initial checkin
KennethLavrsen
parents:
diff changeset
18 be /dev/video1 and the output on /dev/video2.
5f21a4dddc0c Initial checkin
KennethLavrsen
parents:
diff changeset
19 e.g. if you want to watch an inverted image of the camera you would start invert
5f21a4dddc0c Initial checkin
KennethLavrsen
parents:
diff changeset
20 with /dev/video0 as its input and /dev/video1 as its output.
5f21a4dddc0c Initial checkin
KennethLavrsen
parents:
diff changeset
21 Then start a viewing app (such as camstream or xawtv) with as input /dev/video2
5f21a4dddc0c Initial checkin
KennethLavrsen
parents:
diff changeset
22 and you can see yourself inverted.
5f21a4dddc0c Initial checkin
KennethLavrsen
parents:
diff changeset
23
5f21a4dddc0c Initial checkin
KennethLavrsen
parents:
diff changeset
24 This is a very experimental device driver!
5f21a4dddc0c Initial checkin
KennethLavrsen
parents:
diff changeset
25 SMP should work from 0.2 on..... but is untested!
5f21a4dddc0c Initial checkin
KennethLavrsen
parents:
diff changeset
26 If it troubles you fix it or tell me how to fix it :)
5f21a4dddc0c Initial checkin
KennethLavrsen
parents:
diff changeset
27
5f21a4dddc0c Initial checkin
KennethLavrsen
parents:
diff changeset
28 Using vloopback with xawtv:
5f21a4dddc0c Initial checkin
KennethLavrsen
parents:
diff changeset
29 As of 0.83 xawtv will work with vloopback outputs, but you will have to specify
5f21a4dddc0c Initial checkin
KennethLavrsen
parents:
diff changeset
30 the size to use. For example: 'xawtv -c /dev/video2 -geometry 320x240'
5f21a4dddc0c Initial checkin
KennethLavrsen
parents:
diff changeset
31
5f21a4dddc0c Initial checkin
KennethLavrsen
parents:
diff changeset
32 Jeroen Vreeken, pe1rxq@amsat.org
5f21a4dddc0c Initial checkin
KennethLavrsen
parents:
diff changeset
33
5f21a4dddc0c Initial checkin
KennethLavrsen
parents:
diff changeset
34 -------------------------------------------------------------------------------
5f21a4dddc0c Initial checkin
KennethLavrsen
parents:
diff changeset
35
1
bcf5fe83f332 Altering some text to check email message from SVN
KennethLavrsen
parents: 0
diff changeset
36 Module now supports kernel 2.6.x .
6
d3fdefea8bce Update info and add a little fix to clean
AngelCarpintero
parents: 1
diff changeset
37 The current version 1.0 has been tested with kernel 2.6.x ( up to 2.6.25 ).
0
5f21a4dddc0c Initial checkin
KennethLavrsen
parents:
diff changeset
38
5f21a4dddc0c Initial checkin
KennethLavrsen
parents:
diff changeset
39 To compile and install :
5f21a4dddc0c Initial checkin
KennethLavrsen
parents:
diff changeset
40
5f21a4dddc0c Initial checkin
KennethLavrsen
parents:
diff changeset
41 make ; su - ; make install
5f21a4dddc0c Initial checkin
KennethLavrsen
parents:
diff changeset
42 /sbin/modprobe videodev
5f21a4dddc0c Initial checkin
KennethLavrsen
parents:
diff changeset
43 /sbin/modprobe vloopback
5f21a4dddc0c Initial checkin
KennethLavrsen
parents:
diff changeset
44
5f21a4dddc0c Initial checkin
KennethLavrsen
parents:
diff changeset
45 To uninstall :
5f21a4dddc0c Initial checkin
KennethLavrsen
parents:
diff changeset
46
5f21a4dddc0c Initial checkin
KennethLavrsen
parents:
diff changeset
47 make uninstall ( as root ).
5f21a4dddc0c Initial checkin
KennethLavrsen
parents:
diff changeset
48
5f21a4dddc0c Initial checkin
KennethLavrsen
parents:
diff changeset
49 - Problems :
5f21a4dddc0c Initial checkin
KennethLavrsen
parents:
diff changeset
50
5f21a4dddc0c Initial checkin
KennethLavrsen
parents:
diff changeset
51 * If you got this message after 'insmod ./vloopback.ko' :
5f21a4dddc0c Initial checkin
KennethLavrsen
parents:
diff changeset
52
5f21a4dddc0c Initial checkin
KennethLavrsen
parents:
diff changeset
53 "insmod: error inserting './vloopback.ko': -1 Unknown symbol in module"
5f21a4dddc0c Initial checkin
KennethLavrsen
parents:
diff changeset
54
5f21a4dddc0c Initial checkin
KennethLavrsen
parents:
diff changeset
55 Solution : You must load videodev module :
5f21a4dddc0c Initial checkin
KennethLavrsen
parents:
diff changeset
56
5f21a4dddc0c Initial checkin
KennethLavrsen
parents:
diff changeset
57 'insmod videodev ; insmod ./vloopback.ko'
5f21a4dddc0c Initial checkin
KennethLavrsen
parents:
diff changeset
58
5f21a4dddc0c Initial checkin
KennethLavrsen
parents:
diff changeset
59 * If you got this message after 'modprobe vloopback [options]' :
5f21a4dddc0c Initial checkin
KennethLavrsen
parents:
diff changeset
60
5f21a4dddc0c Initial checkin
KennethLavrsen
parents:
diff changeset
61 "FATAL: Error inserting vloopback (/lib/modules/2.6.8-1-k7/kernel/drivers/misc/vloopback.ko): Too many open files in system"
5f21a4dddc0c Initial checkin
KennethLavrsen
parents:
diff changeset
62
5f21a4dddc0c Initial checkin
KennethLavrsen
parents:
diff changeset
63 You probably used dev_offset= as a option , but the video device that vloopback was trying to register was already in use, maybe the value used for dev_offeset was too high.
5f21a4dddc0c Initial checkin
KennethLavrsen
parents:
diff changeset
64
5f21a4dddc0c Initial checkin
KennethLavrsen
parents:
diff changeset
65 Solution : Try to use a lower value for dev_offset= or even better don't use it .
5f21a4dddc0c Initial checkin
KennethLavrsen
parents:
diff changeset
66
5f21a4dddc0c Initial checkin
KennethLavrsen
parents:
diff changeset
67 Angel Carpintero, ack@telefonica.net
5f21a4dddc0c Initial checkin
KennethLavrsen
parents:
diff changeset
68 Kenneth Lavrsen, kenneth@lavrsen.dk