Merge tag 'tags/bcm2835-defconfig-next-2018-11-27' into defconfig/next
[sfrench/cifs-2.6.git] / Documentation / media / v4l-drivers / omap4_camera.rst
1 .. SPDX-License-Identifier: GPL-2.0
2
3 OMAP4 ISS Driver
4 ================
5
6 Author: Sergio Aguirre <sergio.a.aguirre@gmail.com>
7
8 Copyright (C) 2012, Texas Instruments
9
10 Introduction
11 ------------
12
13 The OMAP44XX family of chips contains the Imaging SubSystem (a.k.a. ISS),
14 Which contains several components that can be categorized in 3 big groups:
15
16 - Interfaces (2 Interfaces: CSI2-A & CSI2-B/CCP2)
17 - ISP (Image Signal Processor)
18 - SIMCOP (Still Image Coprocessor)
19
20 For more information, please look in [#f1]_ for latest version of:
21 "OMAP4430 Multimedia Device Silicon Revision 2.x"
22
23 As of Revision AB, the ISS is described in detail in section 8.
24
25 This driver is supporting **only** the CSI2-A/B interfaces for now.
26
27 It makes use of the Media Controller framework [#f2]_, and inherited most of the
28 code from OMAP3 ISP driver (found under drivers/media/platform/omap3isp/\*),
29 except that it doesn't need an IOMMU now for ISS buffers memory mapping.
30
31 Supports usage of MMAP buffers only (for now).
32
33 Tested platforms
34 ----------------
35
36 - OMAP4430SDP, w/ ES2.1 GP & SEVM4430-CAM-V1-0 (Contains IMX060 & OV5640, in
37   which only the last one is supported, outputting YUV422 frames).
38
39 - TI Blaze MDP, w/ OMAP4430 ES2.2 EMU (Contains 1 IMX060 & 2 OV5650 sensors, in
40   which only the OV5650 are supported, outputting RAW10 frames).
41
42 - PandaBoard, Rev. A2, w/ OMAP4430 ES2.1 GP & OV adapter board, tested with
43   following sensors:
44   * OV5640
45   * OV5650
46
47 - Tested on mainline kernel:
48
49         http://git.kernel.org/?p=linux/kernel/git/torvalds/linux.git;a=summary
50
51   Tag: v3.3 (commit c16fa4f2ad19908a47c63d8fa436a1178438c7e7)
52
53 File list
54 ---------
55 drivers/staging/media/omap4iss/
56 include/linux/platform_data/media/omap4iss.h
57
58 References
59 ----------
60
61 .. [#f1] http://focus.ti.com/general/docs/wtbu/wtbudocumentcenter.tsp?navigationId=12037&templateId=6123#62
62 .. [#f2] http://lwn.net/Articles/420485/