Commit b4a5f46c authored by Mauro Carvalho Chehab's avatar Mauro Carvalho Chehab
Browse files

media: docs: split uAPI info from fimc.rst 



This file contains both driver develompent documentation and
userspace API.

Split on two, as they're usually read by different audiences.

Signed-off-by: default avatarMauro Carvalho Chehab <mchehab+huawei@kernel.org>
parent d81c969b

Documentation/media/v4l-drivers/fimc-devel.rst

0 → 100644
+33 −0
Original line number Diff line number Diff line 
.. SPDX-License-Identifier: GPL-2.0



.. include:: <isonum.txt>



The Samsung S5P/EXYNOS4 FIMC driver

===================================



Copyright |copy| 2012 - 2013 Samsung Electronics Co., Ltd.



Files partitioning

------------------



- media device driver



  drivers/media/platform/exynos4-is/media-dev.[ch]



- camera capture video device driver



  drivers/media/platform/exynos4-is/fimc-capture.c



- MIPI-CSI2 receiver subdev



  drivers/media/platform/exynos4-is/mipi-csis.[ch]



- video post-processor (mem-to-mem)



  drivers/media/platform/exynos4-is/fimc-core.c



- common files



  drivers/media/platform/exynos4-is/fimc-core.h

  drivers/media/platform/exynos4-is/fimc-reg.h

  drivers/media/platform/exynos4-is/regs-fimc.h

Documentation/media/v4l-drivers/fimc.rst

+2 −20
Original line number Diff line number Diff line
@@ -38,26 +38,6 @@ Not currently supported 
- LCD writeback input

- per frame clock gating (mem-to-mem)



Files partitioning

------------------



- media device driver

  drivers/media/platform/exynos4-is/media-dev.[ch]



- camera capture video device driver

  drivers/media/platform/exynos4-is/fimc-capture.c



- MIPI-CSI2 receiver subdev

  drivers/media/platform/exynos4-is/mipi-csis.[ch]



- video post-processor (mem-to-mem)

  drivers/media/platform/exynos4-is/fimc-core.c



- common files

  drivers/media/platform/exynos4-is/fimc-core.h

  drivers/media/platform/exynos4-is/fimc-reg.h

  drivers/media/platform/exynos4-is/regs-fimc.h



User space interfaces

---------------------
@@ -74,6 +54,7 @@ connections of the MIPI-CSIS device(s) to the FIMC entities. 
The media device interface allows to configure the SoC for capturing image

data from the sensor through more than one FIMC instance (e.g. for simultaneous

viewfinder and still capture setup).



Reconfiguration is done by enabling/disabling media links created by the driver

during initialization. The internal device topology can be easily discovered

through media entity and links enumeration.
@@ -116,6 +97,7 @@ sensor subdev -> mipi-csi subdev -> fimc subdev -> video node 
When we configure these devices through sub-device API at user space, the

configuration flow must be from left to right, and the video node is

configured as last one.



When we don't use sub-device user space API the whole configuration of all

devices belonging to the pipeline is done at the video node driver.

The sysfs entry allows to instruct the capture node driver not to configure

Documentation/media/v4l-drivers/index.rst

+1 −0
Original line number Diff line number Diff line
@@ -70,6 +70,7 @@ For more details see the file COPYING in the source distribution of Linux. 
	cx2341x-devel

	cx88-devel

	davinci-vpbe-devel

	fimc-devel

	vimc-devel



	cx2341x-uapi