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