media: vimc: documentation for lens

Add documentation for vimc-lens.
Add a lens into the vimc topology graph.

Signed-off-by: Yunke Cao <yunkec@google.com>
Signed-off-by: Shuah Khan <skhan@linuxfoundation.org>
Signed-off-by: Mauro Carvalho Chehab <mchehab@kernel.org>

diff --git a/Documentation/admin-guide/media/vimc.dot b/Documentation/admin-guide/media/vimc.dot
index 8e829c1..92a5bb6 100644 (file)
--- a/Documentation/admin-guide/media/vimc.dot
+++ b/Documentation/admin-guide/media/vimc.dot
@@ -5,9 +5,13 @@ digraph board {
        n00000001 [label="{{} | Sensor A\n/dev/v4l-subdev0 | {<port0> 0}}", shape=Mrecord, style=filled, fillcolor=green]
        n00000001:port0 -> n00000005:port0 [style=bold]
        n00000001:port0 -> n0000000b [style=bold]
+       n00000001 -> n00000002
+       n00000002 [label="{{} | Lens A\n/dev/v4l-subdev5 | {<port0>}}", shape=Mrecord, style=filled, fillcolor=green]
        n00000003 [label="{{} | Sensor B\n/dev/v4l-subdev1 | {<port0> 0}}", shape=Mrecord, style=filled, fillcolor=green]
        n00000003:port0 -> n00000008:port0 [style=bold]
        n00000003:port0 -> n0000000f [style=bold]
+       n00000003 -> n00000004
+       n00000004 [label="{{} | Lens B\n/dev/v4l-subdev6 | {<port0>}}", shape=Mrecord, style=filled, fillcolor=green]
        n00000005 [label="{{<port0> 0} | Debayer A\n/dev/v4l-subdev2 | {<port1> 1}}", shape=Mrecord, style=filled, fillcolor=green]
        n00000005:port1 -> n00000015:port0
        n00000008 [label="{{<port0> 0} | Debayer B\n/dev/v4l-subdev3 | {<port1> 1}}", shape=Mrecord, style=filled, fillcolor=green]

diff --git a/Documentation/admin-guide/media/vimc.rst b/Documentation/admin-guide/media/vimc.rst
index 0b07f05..3b4d2b3 100644 (file)
--- a/Documentation/admin-guide/media/vimc.rst
+++ b/Documentation/admin-guide/media/vimc.rst
@@ -53,6 +53,25 @@ vimc-sensor:
 
        * 1 Pad source
 
+vimc-lens:
+       Ancillary lens for a sensor. Supports auto focus control. Linked to
+       a vimc-sensor using an ancillary link. The lens supports FOCUS_ABSOLUTE
+       control.
+
+.. code-block:: bash
+
+       media-ctl -p
+       ...
+       - entity 28: Lens A (0 pad, 0 link)
+                       type V4L2 subdev subtype Lens flags 0
+                       device node name /dev/v4l-subdev6
+       - entity 29: Lens B (0 pad, 0 link)
+                       type V4L2 subdev subtype Lens flags 0
+                       device node name /dev/v4l-subdev7
+       v4l2-ctl -d /dev/v4l-subdev7 -C focus_absolute
+       focus_absolute: 0
+
+
 vimc-debayer:
        Transforms images in bayer format into a non-bayer format.
        Exposes: