1 .. SPDX-License-Identifier: GPL-2.0 1 .. SPDX-License-Identifier: GPL-2.0
2 2
3 .. include:: <isonum.txt> 3 .. include:: <isonum.txt>
4 4
5 OMAP 3 Image Signal Processor (ISP) driver 5 OMAP 3 Image Signal Processor (ISP) driver
6 ========================================== 6 ==========================================
7 7
8 Copyright |copy| 2010 Nokia Corporation 8 Copyright |copy| 2010 Nokia Corporation
9 9
10 Copyright |copy| 2009 Texas Instruments, Inc. 10 Copyright |copy| 2009 Texas Instruments, Inc.
11 11
12 Contacts: Laurent Pinchart <laurent.pinchart@id 12 Contacts: Laurent Pinchart <laurent.pinchart@ideasonboard.com>,
13 Sakari Ailus <sakari.ailus@iki.fi>, David Cohen 13 Sakari Ailus <sakari.ailus@iki.fi>, David Cohen <dacohen@gmail.com>
14 14
15 15
16 Introduction 16 Introduction
17 ------------ 17 ------------
18 18
19 This file documents the Texas Instruments OMAP 19 This file documents the Texas Instruments OMAP 3 Image Signal Processor (ISP)
20 driver located under drivers/media/platform/ti 20 driver located under drivers/media/platform/ti/omap3isp. The original driver was
21 written by Texas Instruments but since that it 21 written by Texas Instruments but since that it has been rewritten (twice) at
22 Nokia. 22 Nokia.
23 23
24 The driver has been successfully used on the f 24 The driver has been successfully used on the following versions of OMAP 3:
25 25
26 - 3430 26 - 3430
27 - 3530 27 - 3530
28 - 3630 28 - 3630
29 29
30 The driver implements V4L2, Media controller a 30 The driver implements V4L2, Media controller and v4l2_subdev interfaces.
31 Sensor, lens and flash drivers using the v4l2_ 31 Sensor, lens and flash drivers using the v4l2_subdev interface in the kernel
32 are supported. 32 are supported.
33 33
34 34
35 Split to subdevs 35 Split to subdevs
36 ---------------- 36 ----------------
37 37
38 The OMAP 3 ISP is split into V4L2 subdevs, eac 38 The OMAP 3 ISP is split into V4L2 subdevs, each of the blocks inside the ISP
39 having one subdev to represent it. Each of the 39 having one subdev to represent it. Each of the subdevs provide a V4L2 subdev
40 interface to userspace. 40 interface to userspace.
41 41
42 - OMAP3 ISP CCP2 42 - OMAP3 ISP CCP2
43 - OMAP3 ISP CSI2a 43 - OMAP3 ISP CSI2a
44 - OMAP3 ISP CCDC 44 - OMAP3 ISP CCDC
45 - OMAP3 ISP preview 45 - OMAP3 ISP preview
46 - OMAP3 ISP resizer 46 - OMAP3 ISP resizer
47 - OMAP3 ISP AEWB 47 - OMAP3 ISP AEWB
48 - OMAP3 ISP AF 48 - OMAP3 ISP AF
49 - OMAP3 ISP histogram 49 - OMAP3 ISP histogram
50 50
51 Each possible link in the ISP is modelled by a 51 Each possible link in the ISP is modelled by a link in the Media controller
52 interface. For an example program see [#]_. 52 interface. For an example program see [#]_.
53 53
54 54
55 Controlling the OMAP 3 ISP 55 Controlling the OMAP 3 ISP
56 -------------------------- 56 --------------------------
57 57
58 In general, the settings given to the OMAP 3 I 58 In general, the settings given to the OMAP 3 ISP take effect at the beginning
59 of the following frame. This is done when the 59 of the following frame. This is done when the module becomes idle during the
60 vertical blanking period on the sensor. In mem 60 vertical blanking period on the sensor. In memory-to-memory operation the pipe
61 is run one frame at a time. Applying the setti 61 is run one frame at a time. Applying the settings is done between the frames.
62 62
63 All the blocks in the ISP, excluding the CSI-2 63 All the blocks in the ISP, excluding the CSI-2 and possibly the CCP2 receiver,
64 insist on receiving complete frames. Sensors m 64 insist on receiving complete frames. Sensors must thus never send the ISP
65 partial frames. 65 partial frames.
66 66
67 Autoidle does have issues with some ISP blocks 67 Autoidle does have issues with some ISP blocks on the 3430, at least.
68 Autoidle is only enabled on 3630 when the omap 68 Autoidle is only enabled on 3630 when the omap3isp module parameter autoidle
69 is non-zero. 69 is non-zero.
70 70
71 Technical reference manuals (TRMs) and other d 71 Technical reference manuals (TRMs) and other documentation
72 ---------------------------------------------- 72 ----------------------------------------------------------
73 73
74 OMAP 3430 TRM: 74 OMAP 3430 TRM:
75 <URL:http://focus.ti.com/pdfs/wtbu/OMAP34xx_ES 75 <URL:http://focus.ti.com/pdfs/wtbu/OMAP34xx_ES3.1.x_PUBLIC_TRM_vZM.zip>
76 Referenced 2011-03-05. 76 Referenced 2011-03-05.
77 77
78 OMAP 35xx TRM: 78 OMAP 35xx TRM:
79 <URL:http://www.ti.com/litv/pdf/spruf98o> Refe 79 <URL:http://www.ti.com/litv/pdf/spruf98o> Referenced 2011-03-05.
80 80
81 OMAP 3630 TRM: 81 OMAP 3630 TRM:
82 <URL:http://focus.ti.com/pdfs/wtbu/OMAP36xx_ES 82 <URL:http://focus.ti.com/pdfs/wtbu/OMAP36xx_ES1.x_PUBLIC_TRM_vQ.zip>
83 Referenced 2011-03-05. 83 Referenced 2011-03-05.
84 84
85 DM 3730 TRM: 85 DM 3730 TRM:
86 <URL:http://www.ti.com/litv/pdf/sprugn4h> Refe 86 <URL:http://www.ti.com/litv/pdf/sprugn4h> Referenced 2011-03-06.
87 87
88 88
89 References 89 References
90 ---------- 90 ----------
91 91
92 .. [#] http://git.ideasonboard.org/?p=media-ct 92 .. [#] http://git.ideasonboard.org/?p=media-ctl.git;a=summary
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.