xref: /openbmc/linux/Documentation/admin-guide/media/omap4_camera.rst (revision 4f2c0a4acffbec01079c28f839422e64ddeff004)
132e2eae2SMauro Carvalho Chehab.. SPDX-License-Identifier: GPL-2.0
232e2eae2SMauro Carvalho Chehab
332e2eae2SMauro Carvalho ChehabOMAP4 ISS Driver
432e2eae2SMauro Carvalho Chehab================
532e2eae2SMauro Carvalho Chehab
632e2eae2SMauro Carvalho ChehabAuthor: Sergio Aguirre <sergio.a.aguirre@gmail.com>
732e2eae2SMauro Carvalho Chehab
832e2eae2SMauro Carvalho ChehabCopyright (C) 2012, Texas Instruments
932e2eae2SMauro Carvalho Chehab
1032e2eae2SMauro Carvalho ChehabIntroduction
1132e2eae2SMauro Carvalho Chehab------------
1232e2eae2SMauro Carvalho Chehab
1332e2eae2SMauro Carvalho ChehabThe OMAP44XX family of chips contains the Imaging SubSystem (a.k.a. ISS),
1432e2eae2SMauro Carvalho ChehabWhich contains several components that can be categorized in 3 big groups:
1532e2eae2SMauro Carvalho Chehab
1632e2eae2SMauro Carvalho Chehab- Interfaces (2 Interfaces: CSI2-A & CSI2-B/CCP2)
1732e2eae2SMauro Carvalho Chehab- ISP (Image Signal Processor)
1832e2eae2SMauro Carvalho Chehab- SIMCOP (Still Image Coprocessor)
1932e2eae2SMauro Carvalho Chehab
2032e2eae2SMauro Carvalho ChehabFor more information, please look in [#f1]_ for latest version of:
2132e2eae2SMauro Carvalho Chehab"OMAP4430 Multimedia Device Silicon Revision 2.x"
2232e2eae2SMauro Carvalho Chehab
2332e2eae2SMauro Carvalho ChehabAs of Revision AB, the ISS is described in detail in section 8.
2432e2eae2SMauro Carvalho Chehab
2532e2eae2SMauro Carvalho ChehabThis driver is supporting **only** the CSI2-A/B interfaces for now.
2632e2eae2SMauro Carvalho Chehab
2732e2eae2SMauro Carvalho ChehabIt makes use of the Media Controller framework [#f2]_, and inherited most of the
28*ceafdaacSMauro Carvalho Chehabcode from OMAP3 ISP driver (found under drivers/media/platform/ti/omap3isp/\*),
2932e2eae2SMauro Carvalho Chehabexcept that it doesn't need an IOMMU now for ISS buffers memory mapping.
3032e2eae2SMauro Carvalho Chehab
3132e2eae2SMauro Carvalho ChehabSupports usage of MMAP buffers only (for now).
3232e2eae2SMauro Carvalho Chehab
3332e2eae2SMauro Carvalho ChehabTested platforms
3432e2eae2SMauro Carvalho Chehab----------------
3532e2eae2SMauro Carvalho Chehab
3632e2eae2SMauro Carvalho Chehab- OMAP4430SDP, w/ ES2.1 GP & SEVM4430-CAM-V1-0 (Contains IMX060 & OV5640, in
3732e2eae2SMauro Carvalho Chehab  which only the last one is supported, outputting YUV422 frames).
3832e2eae2SMauro Carvalho Chehab
3932e2eae2SMauro Carvalho Chehab- TI Blaze MDP, w/ OMAP4430 ES2.2 EMU (Contains 1 IMX060 & 2 OV5650 sensors, in
4032e2eae2SMauro Carvalho Chehab  which only the OV5650 are supported, outputting RAW10 frames).
4132e2eae2SMauro Carvalho Chehab
4232e2eae2SMauro Carvalho Chehab- PandaBoard, Rev. A2, w/ OMAP4430 ES2.1 GP & OV adapter board, tested with
4332e2eae2SMauro Carvalho Chehab  following sensors:
4432e2eae2SMauro Carvalho Chehab  * OV5640
4532e2eae2SMauro Carvalho Chehab  * OV5650
4632e2eae2SMauro Carvalho Chehab
4732e2eae2SMauro Carvalho Chehab- Tested on mainline kernel:
4832e2eae2SMauro Carvalho Chehab
4932e2eae2SMauro Carvalho Chehab	http://git.kernel.org/?p=linux/kernel/git/torvalds/linux.git;a=summary
5032e2eae2SMauro Carvalho Chehab
5132e2eae2SMauro Carvalho Chehab  Tag: v3.3 (commit c16fa4f2ad19908a47c63d8fa436a1178438c7e7)
5232e2eae2SMauro Carvalho Chehab
5332e2eae2SMauro Carvalho ChehabFile list
5432e2eae2SMauro Carvalho Chehab---------
5532e2eae2SMauro Carvalho Chehabdrivers/staging/media/omap4iss/
5632e2eae2SMauro Carvalho Chehabinclude/linux/platform_data/media/omap4iss.h
5732e2eae2SMauro Carvalho Chehab
5832e2eae2SMauro Carvalho ChehabReferences
5932e2eae2SMauro Carvalho Chehab----------
6032e2eae2SMauro Carvalho Chehab
6132e2eae2SMauro Carvalho Chehab.. [#f1] http://focus.ti.com/general/docs/wtbu/wtbudocumentcenter.tsp?navigationId=12037&templateId=6123#62
6232e2eae2SMauro Carvalho Chehab.. [#f2] http://lwn.net/Articles/420485/
63