[media] doc-rst: add meye documentation
authorMauro Carvalho Chehab <mchehab@s-opensource.com>
Sun, 17 Jul 2016 21:20:51 +0000 (18:20 -0300)
committerMauro Carvalho Chehab <mchehab@s-opensource.com>
Mon, 18 Jul 2016 01:49:59 +0000 (22:49 -0300)
Convert the meye documentation to rst and add it to the
media/v4l-drivers book.

Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
Documentation/media/v4l-drivers/index.rst
Documentation/media/v4l-drivers/meye.rst

index 99409c6e2518ee2401efb87c4acd09f5958b68fe..8c6f4745aa07411d1bffef46d1915b7371e7c3a1 100644 (file)
@@ -27,4 +27,5 @@ License".
        davinci-vpbe
        fimc
        ivtv
+       meye
        zr364xx
index a051152ea99c27b895890a2d94d27743b17cec3d..cfaba602185041cab74a88929f6382d18787d67a 100644 (file)
@@ -1,8 +1,13 @@
-Vaio Picturebook Motion Eye Camera Driver Readme
-------------------------------------------------
-       Copyright (C) 2001-2004 Stelian Pop <stelian@popies.net>
-       Copyright (C) 2001-2002 Alcôve <www.alcove.com>
-       Copyright (C) 2000 Andrew Tridgell <tridge@samba.org>
+.. include:: <isonum.txt>
+
+Vaio Picturebook Motion Eye Camera Driver
+=========================================
+
+Copyright |copy| 2001-2004 Stelian Pop <stelian@popies.net>
+
+Copyright |copy| 2001-2002 Alcôve <www.alcove.com>
+
+Copyright |copy| 2000 Andrew Tridgell <tridge@samba.org>
 
 This driver enable the use of video4linux compatible applications with the
 Motion Eye camera. This driver requires the "Sony Laptop Extras" driver (which
@@ -15,8 +20,8 @@ Grabbing is supported in packed YUV colorspace only.
 
 MJPEG hardware grabbing is supported via a private API (see below).
 
-Hardware supported:
--------------------
+Hardware supported
+------------------
 
 This driver supports the 'second' version of the MotionEye camera :)
 
@@ -37,26 +42,30 @@ This camera is not supported at all by the current driver, in fact
 little information if any is available for this camera
 (USB vendor/device is 0x054c/0x0107).
 
-Driver options:
----------------
+Driver options
+--------------
 
 Several options can be passed to the meye driver using the standard
 module argument syntax (<param>=<value> when passing the option to the
 module or meye.<param>=<value> on the kernel boot line when meye is
 statically linked into the kernel). Those options are:
 
+.. code-block:: none
+
        gbuffers:       number of capture buffers, default is 2 (32 max)
 
        gbufsize:       size of each capture buffer, default is 614400
 
        video_nr:       video device to register (0 = /dev/video0, etc)
 
-Module use:
------------
+Module use
+----------
 
 In order to automatically load the meye module on use, you can put those lines
 in your /etc/modprobe.d/meye.conf file:
 
+.. code-block:: none
+
        alias char-major-81 videodev
        alias char-major-81-0 meye
        options meye gbuffers=32
@@ -64,6 +73,8 @@ in your /etc/modprobe.d/meye.conf file:
 Usage:
 ------
 
+.. code-block:: none
+
        xawtv >= 3.49 (<http://bytesex.org/xawtv/>)
                for display and uncompressed video capture:
 
@@ -74,50 +85,48 @@ Usage:
        motioneye (<http://popies.net/meye/>)
                for getting ppm or jpg snapshots, mjpeg video
 
-Private API:
-------------
+Private API
+-----------
 
-       The driver supports frame grabbing with the video4linux API,
-       so all video4linux tools (like xawtv) should work with this driver.
+The driver supports frame grabbing with the video4linux API,
+so all video4linux tools (like xawtv) should work with this driver.
 
-       Besides the video4linux interface, the driver has a private interface
-       for accessing the Motion Eye extended parameters (camera sharpness,
-       agc, video framerate), the shapshot and the MJPEG capture facilities.
+Besides the video4linux interface, the driver has a private interface
+for accessing the Motion Eye extended parameters (camera sharpness,
+agc, video framerate), the shapshot and the MJPEG capture facilities.
 
-       This interface consists of several ioctls (prototypes and structures
-       can be found in include/linux/meye.h):
+This interface consists of several ioctls (prototypes and structures
+can be found in include/linux/meye.h):
 
-       MEYEIOC_G_PARAMS
-       MEYEIOC_S_PARAMS
-               Get and set the extended parameters of the motion eye camera.
-               The user should always query the current parameters with
-               MEYEIOC_G_PARAMS, change what he likes and then issue the
-               MEYEIOC_S_PARAMS call (checking for -EINVAL). The extended
-               parameters are described by the meye_params structure.
+MEYEIOC_G_PARAMS and MEYEIOC_S_PARAMS
+       Get and set the extended parameters of the motion eye camera.
+       The user should always query the current parameters with
+       MEYEIOC_G_PARAMS, change what he likes and then issue the
+       MEYEIOC_S_PARAMS call (checking for -EINVAL). The extended
+       parameters are described by the meye_params structure.
 
 
-       MEYEIOC_QBUF_CAPT
-               Queue a buffer for capture (the buffers must have been
-               obtained with a VIDIOCGMBUF call and mmap'ed by the
-               application). The argument to MEYEIOC_QBUF_CAPT is the
-               buffer number to queue (or -1 to end capture). The first
-               call to MEYEIOC_QBUF_CAPT starts the streaming capture.
+MEYEIOC_QBUF_CAPT
+       Queue a buffer for capture (the buffers must have been
+       obtained with a VIDIOCGMBUF call and mmap'ed by the
+       application). The argument to MEYEIOC_QBUF_CAPT is the
+       buffer number to queue (or -1 to end capture). The first
+       call to MEYEIOC_QBUF_CAPT starts the streaming capture.
 
-       MEYEIOC_SYNC
-               Takes as an argument the buffer number you want to sync.
-               This ioctl blocks until the buffer is filled and ready
-               for the application to use. It returns the buffer size.
+MEYEIOC_SYNC
+       Takes as an argument the buffer number you want to sync.
+       This ioctl blocks until the buffer is filled and ready
+       for the application to use. It returns the buffer size.
 
-       MEYEIOC_STILLCAPT
-       MEYEIOC_STILLJCAPT
-               Takes a snapshot in an uncompressed or compressed jpeg format.
-               This ioctl blocks until the snapshot is done and returns (for
-               jpeg snapshot) the size of the image. The image data is
-               available from the first mmap'ed buffer.
+MEYEIOC_STILLCAPT and MEYEIOC_STILLJCAPT
+       Takes a snapshot in an uncompressed or compressed jpeg format.
+       This ioctl blocks until the snapshot is done and returns (for
+       jpeg snapshot) the size of the image. The image data is
+       available from the first mmap'ed buffer.
 
-       Look at the 'motioneye' application code for an actual example.
+Look at the 'motioneye' application code for an actual example.
 
-Bugs / Todo:
-------------
+Bugs / Todo
+-----------
 
-       - 'motioneye' still uses the meye private v4l1 API extensions.
+- 'motioneye' still uses the meye private v4l1 API extensions.