0001 .. SPDX-License-Identifier: GPL-2.0
0002
0003 .. include:: <isonum.txt>
0004
0005 Vaio Picturebook Motion Eye Camera Driver
0006 =========================================
0007
0008 Copyright |copy| 2001-2004 Stelian Pop <stelian@popies.net>
0009
0010 Copyright |copy| 2001-2002 Alcôve <www.alcove.com>
0011
0012 Copyright |copy| 2000 Andrew Tridgell <tridge@samba.org>
0013
0014 This driver enable the use of video4linux compatible applications with the
0015 Motion Eye camera. This driver requires the "Sony Laptop Extras" driver (which
0016 can be found in the "Misc devices" section of the kernel configuration utility)
0017 to be compiled and installed (using its "camera=1" parameter).
0018
0019 It can do at maximum 30 fps @ 320x240 or 15 fps @ 640x480.
0020
0021 Grabbing is supported in packed YUV colorspace only.
0022
0023 MJPEG hardware grabbing is supported via a private API (see below).
0024
0025 Hardware supported
0026 ------------------
0027
0028 This driver supports the 'second' version of the MotionEye camera :)
0029
0030 The first version was connected directly on the video bus of the Neomagic
0031 video card and is unsupported.
0032
0033 The second one, made by Kawasaki Steel is fully supported by this
0034 driver (PCI vendor/device is 0x136b/0xff01)
0035
0036 The third one, present in recent (more or less last year) Picturebooks
0037 (C1M* models), is not supported. The manufacturer has given the specs
0038 to the developers under a NDA (which allows the development of a GPL
0039 driver however), but things are not moving very fast (see
0040 http://r-engine.sourceforge.net/) (PCI vendor/device is 0x10cf/0x2011).
0041
0042 There is a forth model connected on the USB bus in TR1* Vaio laptops.
0043 This camera is not supported at all by the current driver, in fact
0044 little information if any is available for this camera
0045 (USB vendor/device is 0x054c/0x0107).
0046
0047 Driver options
0048 --------------
0049
0050 Several options can be passed to the meye driver using the standard
0051 module argument syntax (<param>=<value> when passing the option to the
0052 module or meye.<param>=<value> on the kernel boot line when meye is
0053 statically linked into the kernel). Those options are:
0054
0055 .. code-block:: none
0056
0057 gbuffers: number of capture buffers, default is 2 (32 max)
0058
0059 gbufsize: size of each capture buffer, default is 614400
0060
0061 video_nr: video device to register (0 = /dev/video0, etc)
0062
0063 Module use
0064 ----------
0065
0066 In order to automatically load the meye module on use, you can put those lines
0067 in your /etc/modprobe.d/meye.conf file:
0068
0069 .. code-block:: none
0070
0071 alias char-major-81 videodev
0072 alias char-major-81-0 meye
0073 options meye gbuffers=32
0074
0075 Usage:
0076 ------
0077
0078 .. code-block:: none
0079
0080 xawtv >= 3.49 (<http://bytesex.org/xawtv/>)
0081 for display and uncompressed video capture:
0082
0083 xawtv -c /dev/video0 -geometry 640x480
0084 or
0085 xawtv -c /dev/video0 -geometry 320x240
0086
0087 motioneye (<http://popies.net/meye/>)
0088 for getting ppm or jpg snapshots, mjpeg video
0089
0090 Bugs / Todo
0091 -----------
0092
0093 - 'motioneye' still uses the meye private v4l1 API extensions.
