iv/linux
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

media: Documentation: LP-11 and LP-111 are states, not modes

Browse Source 
LP-11 and LP-111 are CSI-2 bus states, not modes. Fix this.

Signed-off-by: Sakari Ailus <sakari.ailus@linux.intel.com>
Reviewed-by: Laurent Pinchart <laurent.pinchart@ideasonboard.com>
Signed-off-by: Hans Verkuil <hverkuil-cisco@xs4all.nl>
This commit is contained in:
Sakari Ailus
2023-10-17 13:33:59 +03:00
committed by Hans Verkuil
parent cff18d8f8b
commit 16be18d71c
1 changed files with 6 additions and 6 deletions
Download Patch File Download Diff File Expand all files Collapse all files

12
Documentation/driver-api/media/tx-rx.rst
View File

@ -91,8 +91,8 @@ where
pixel rate on the camera sensor's pixel array which is indicated by the pixel rate on the camera sensor's pixel array which is indicated by the
:ref:`V4L2_CID_PIXEL_RATE <v4l2-cid-pixel-rate>` control. :ref:`V4L2_CID_PIXEL_RATE <v4l2-cid-pixel-rate>` control.
LP-11 and LP-111 modes LP-11 and LP-111 states
^^^^^^^^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^^^^^^^^^
As part of transitioning to high speed mode, a CSI-2 transmitter typically As part of transitioning to high speed mode, a CSI-2 transmitter typically
briefly sets the bus to LP-11 or LP-111 state, depending on the PHY. This period briefly sets the bus to LP-11 or LP-111 state, depending on the PHY. This period
@ -106,7 +106,7 @@ in software, especially when there is no interrupt telling something is
happening. happening.
One way to address this is to configure the transmitter side explicitly to LP-11 One way to address this is to configure the transmitter side explicitly to LP-11
or LP-111 mode, which requires support from the transmitter hardware. This is or LP-111 state, which requires support from the transmitter hardware. This is
not universally available. Many devices return to this state once streaming is not universally available. Many devices return to this state once streaming is
stopped while the state after power-on is LP-00 or LP-000. stopped while the state after power-on is LP-00 or LP-000.
@ -117,11 +117,11 @@ transitioning to streaming state, but not yet start streaming. Similarly, the
to call ``.post_streamoff()`` for each successful call of ``.pre_streamon()``. to call ``.post_streamoff()`` for each successful call of ``.pre_streamon()``.
In the context of CSI-2, the ``.pre_streamon()`` callback is used to transition In the context of CSI-2, the ``.pre_streamon()`` callback is used to transition
the transmitter to the LP-11 or LP-111 mode. This also requires powering on the the transmitter to the LP-11 or LP-111 state. This also requires powering on the
device, so this should be only done when it is needed. device, so this should be only done when it is needed.
Receiver drivers that do not need explicit LP-11 or LP-111 mode setup are waived Receiver drivers that do not need explicit LP-11 or LP-111 state setup are
from calling the two callbacks. waived from calling the two callbacks.
Stopping the transmitter Stopping the transmitter
^^^^^^^^^^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^^^^^^^^^^