Orange Pi5 kernel

Deprecated Linux kernel 5.10.110 for OrangePi 5/5B/5+ boards

3 Commits   0 Branches   0 Tags
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  1) .. SPDX-License-Identifier: GPL-2.0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  2) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  3) .. include:: <isonum.txt>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  4) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  5) Vaio Picturebook Motion Eye Camera Driver
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  6) =========================================
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  7) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  8) Copyright |copy| 2001-2004 Stelian Pop <stelian@popies.net>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  9) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 10) Copyright |copy| 2001-2002 Alcôve <www.alcove.com>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 11) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 12) Copyright |copy| 2000 Andrew Tridgell <tridge@samba.org>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 13) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 14) This driver enable the use of video4linux compatible applications with the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 15) Motion Eye camera. This driver requires the "Sony Laptop Extras" driver (which
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 16) can be found in the "Misc devices" section of the kernel configuration utility)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 17) to be compiled and installed (using its "camera=1" parameter).
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 18) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 19) It can do at maximum 30 fps @ 320x240 or 15 fps @ 640x480.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 20) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 21) Grabbing is supported in packed YUV colorspace only.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 22) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 23) MJPEG hardware grabbing is supported via a private API (see below).
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 24) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 25) Hardware supported
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 26) ------------------
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 27) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 28) This driver supports the 'second' version of the MotionEye camera :)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 29) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 30) The first version was connected directly on the video bus of the Neomagic
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 31) video card and is unsupported.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 32) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 33) The second one, made by Kawasaki Steel is fully supported by this
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 34) driver (PCI vendor/device is 0x136b/0xff01)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 35) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 36) The third one, present in recent (more or less last year) Picturebooks
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 37) (C1M* models), is not supported. The manufacturer has given the specs
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 38) to the developers under a NDA (which allows the development of a GPL
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 39) driver however), but things are not moving very fast (see
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 40) http://r-engine.sourceforge.net/) (PCI vendor/device is 0x10cf/0x2011).
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 41) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 42) There is a forth model connected on the USB bus in TR1* Vaio laptops.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 43) This camera is not supported at all by the current driver, in fact
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 44) little information if any is available for this camera
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 45) (USB vendor/device is 0x054c/0x0107).
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 46) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 47) Driver options
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 48) --------------
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 49) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 50) Several options can be passed to the meye driver using the standard
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 51) module argument syntax (<param>=<value> when passing the option to the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 52) module or meye.<param>=<value> on the kernel boot line when meye is
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 53) statically linked into the kernel). Those options are:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 54) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 55) .. code-block:: none
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 56) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 57) 	gbuffers:	number of capture buffers, default is 2 (32 max)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 58) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 59) 	gbufsize:	size of each capture buffer, default is 614400
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 60) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 61) 	video_nr:	video device to register (0 = /dev/video0, etc)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 62) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 63) Module use
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 64) ----------
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 65) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 66) In order to automatically load the meye module on use, you can put those lines
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 67) in your /etc/modprobe.d/meye.conf file:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 68) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 69) .. code-block:: none
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 70) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 71) 	alias char-major-81 videodev
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 72) 	alias char-major-81-0 meye
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 73) 	options meye gbuffers=32
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 74) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 75) Usage:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 76) ------
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 77) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 78) .. code-block:: none
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 79) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 80) 	xawtv >= 3.49 (<http://bytesex.org/xawtv/>)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 81) 		for display and uncompressed video capture:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 82) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 83) 			xawtv -c /dev/video0 -geometry 640x480
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 84) 				or
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 85) 			xawtv -c /dev/video0 -geometry 320x240
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 86) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 87) 	motioneye (<http://popies.net/meye/>)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 88) 		for getting ppm or jpg snapshots, mjpeg video
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 89) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 90) Bugs / Todo
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 91) -----------
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 92) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 93) - 'motioneye' still uses the meye private v4l1 API extensions.