diff mbox

[13/37] drm: better document how to send out the crtc disable event

Message ID 20170524145212.27837-14-daniel.vetter@ffwll.ch (mailing list archive)
State New, archived
Headers show

Commit Message

Daniel Vetter May 24, 2017, 2:51 p.m. UTC
The kernel doc explained what needs to happen, but not how to most
easily accomplish that using the functions. Fix that.

Cc: Boris Brezillon <boris.brezillon@free-electrons.com>
Signed-off-by: Daniel Vetter <daniel.vetter@intel.com>
---
 include/drm/drm_crtc.h | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

Comments

Boris BREZILLON May 24, 2017, 2:54 p.m. UTC | #1
On Wed, 24 May 2017 16:51:48 +0200
Daniel Vetter <daniel.vetter@ffwll.ch> wrote:

> The kernel doc explained what needs to happen, but not how to most
> easily accomplish that using the functions. Fix that.
> 
> Cc: Boris Brezillon <boris.brezillon@free-electrons.com>
> Signed-off-by: Daniel Vetter <daniel.vetter@intel.com>

Reviewed-by: Boris Brezillon <boris.brezillon@free-electrons.com>

> ---
>  include/drm/drm_crtc.h | 4 +++-
>  1 file changed, 3 insertions(+), 1 deletion(-)
> 
> diff --git a/include/drm/drm_crtc.h b/include/drm/drm_crtc.h
> index 5f5d53973ca5..3a911a64c257 100644
> --- a/include/drm/drm_crtc.h
> +++ b/include/drm/drm_crtc.h
> @@ -214,7 +214,9 @@ struct drm_crtc_state {
>  	 *    atomic commit. In that case the event can be send out any time
>  	 *    after the hardware has stopped scanning out the current
>  	 *    framebuffers. It should contain the timestamp and counter for the
> -	 *    last vblank before the display pipeline was shut off.
> +	 *    last vblank before the display pipeline was shut off. The simplest
> +	 *    way to achieve that is calling drm_crtc_send_vblank_event()
> +	 *    somewhen after drm_crtc_vblank_off() has been called.
>  	 *
>  	 *  - For a CRTC which is enabled at the end of the commit (even when it
>  	 *    undergoes an full modeset) the vblank timestamp and counter must
Neil Armstrong May 30, 2017, 7:35 a.m. UTC | #2
On 05/24/2017 04:51 PM, Daniel Vetter wrote:
> The kernel doc explained what needs to happen, but not how to most
> easily accomplish that using the functions. Fix that.
> 
> Cc: Boris Brezillon <boris.brezillon@free-electrons.com>
> Signed-off-by: Daniel Vetter <daniel.vetter@intel.com>
> ---
>  include/drm/drm_crtc.h | 4 +++-
>  1 file changed, 3 insertions(+), 1 deletion(-)
> 
> diff --git a/include/drm/drm_crtc.h b/include/drm/drm_crtc.h
> index 5f5d53973ca5..3a911a64c257 100644
> --- a/include/drm/drm_crtc.h
> +++ b/include/drm/drm_crtc.h
> @@ -214,7 +214,9 @@ struct drm_crtc_state {
>  	 *    atomic commit. In that case the event can be send out any time
>  	 *    after the hardware has stopped scanning out the current
>  	 *    framebuffers. It should contain the timestamp and counter for the
> -	 *    last vblank before the display pipeline was shut off.
> +	 *    last vblank before the display pipeline was shut off. The simplest
> +	 *    way to achieve that is calling drm_crtc_send_vblank_event()
> +	 *    somewhen after drm_crtc_vblank_off() has been called.
>  	 *
>  	 *  - For a CRTC which is enabled at the end of the commit (even when it
>  	 *    undergoes an full modeset) the vblank timestamp and counter must
> 

Reviewed-by: Neil Armstrong <narmstrong@baylibre.com>
diff mbox

Patch

diff --git a/include/drm/drm_crtc.h b/include/drm/drm_crtc.h
index 5f5d53973ca5..3a911a64c257 100644
--- a/include/drm/drm_crtc.h
+++ b/include/drm/drm_crtc.h
@@ -214,7 +214,9 @@  struct drm_crtc_state {
 	 *    atomic commit. In that case the event can be send out any time
 	 *    after the hardware has stopped scanning out the current
 	 *    framebuffers. It should contain the timestamp and counter for the
-	 *    last vblank before the display pipeline was shut off.
+	 *    last vblank before the display pipeline was shut off. The simplest
+	 *    way to achieve that is calling drm_crtc_send_vblank_event()
+	 *    somewhen after drm_crtc_vblank_off() has been called.
 	 *
 	 *  - For a CRTC which is enabled at the end of the commit (even when it
 	 *    undergoes an full modeset) the vblank timestamp and counter must