Re: [PATCH] drm/komeda: Adds VRR support

[james qian wang (Arm Technology China)]

On Thu, Jul 04, 2019 at 11:41:38PM +0800, Brian Starkey wrote:
> Hi,
> 
> On Thu, Jul 04, 2019 at 11:57:00AM +0100, james qian wang (Arm Technology China) wrote:
> > On Wed, Jul 03, 2019 at 12:01:49PM +0200, Daniel Vetter wrote:
> > > 
> > > Uh, what exactly are you doing reinventing uapi properties that we already
> > > standardized?
> > > 
> > 
> > Sorry, Will use the mode_config->VRR_ENABLED
> 
> Let's have a chat about what you're planning here. The upstream VRR
> properties aren't a direct match for our HW (which we discussed
> before) - so either we need to hide that in the kernel with some frame
> timing heuristics, or we shouldn't expose our feature via the existing
> properties.

@Brian:

	/**
	 * @vrr_enabled:
	 *
	 * Indicates if variable refresh rate should be enabled for the CRTC.
	 * Support for the requested vrr state will depend on driver and
	 * hardware capabiltiy - lacking support is not treated as failure.
	 */
	bool vrr_enabled;

It's not HW specific flag (like AMD freesync), I think can use this standard
flag. 

> IMO, it's better for Komeda to just allow setting a new CRTC mode to
> one with a different VFP (but everything else the same) without a full
> modeset.
> 
> You could try and implement the upstream VRR properties too - but you
> can get the functionality added by this patch without changing any
> UAPI.
> 
> (Note the only reason we ever added the idea of passing in VFP by
> itself is because in ADF, modeset was a separate ioctl entirely, so we
> couldn't do it atomically)

Yes, we can.
But DRM-KMS (the helpers) default doesn't support such light mode-set.
we can not rely on the helpers, but need to implement by ourselves.
Is it worth to do it?

My plan is:

First:
I think the key problem here is not how to enable VRR for our display,
but how to pass the VRR caps from the connector to our display.

And it's not only the VRR prblem but like the command_mode/dual-link
all the none standard connector features that needed by our HW.

Unlike the intel/amd/NV mostly they have their own transmitter HW
(and connector driver), So they can easily pass the info between
connector and display.

But for us that's the third part, and we can not do any assumption to
them, and for us they are the drm_connector, but we can not got these
infos via a drm_connector.

So I think we need a standard way to pass these private infos.

I plan to add a new query function to drm_bridge like

  (*query)(u64 query_id, xxx-type return_va);

and query_id is like the modifiers: first 8bit is vendor_id.

when the third part connector integrats to our display, if the
transmitter HW support the features that our display needed, they
can supply this query function to notify the caps support to us.
If the connector doesn't have this query, or query fail we treat
the feature is not support by this connector.

And For this VRR.

User only need to En/Dis VRR, Once komeda received Enable command
- query the connector for VFP range
  1. connector doesn't support VRR,  ignore or return error ?.
  2. got the VFP range, configure the display according the range.

Once the disable received, restore the mode vfp.

Thanks
James

> > 
> > we use this private property because we're switching to in-tree, before
> > finish the switch, we still need to maintain our out-of-tree driver which
> > depend on a older and doesn't have the VRR_ENABLED property. for avoid
> > diverging the two branch. my old plan is first switch to in-tree, then drop
> > the out-of-tree driver and then unify the usage.
> > 
> > > > +	if (!prop)
> > > > +		return -ENOMEM;
> > > > +
> > > > +	drm_object_attach_property(&crtc->base, prop, 0);
> > > > +	kcrtc->vrr_enable_property = prop;
> > > > +
> > > > +	return 0;
> > > > +}
> > > > +
> > > >  static struct drm_plane *
> > > >  get_crtc_primary(struct komeda_kms_dev *kms, struct komeda_crtc *crtc)
> > > >  {
> > > > @@ -659,6 +717,10 @@ static int komeda_crtc_add(struct komeda_kms_dev *kms,
> > > >  	if (err)
> > > >  		return err;
> > > >  
> > > > +	err = komeda_crtc_create_vrr_property(kcrtc);
> > > > +	if (err)
> > > > +		return err;
> > > > +
> > > >  	return err;
> > > >  }
> > > >  
> > > > diff --git a/drivers/gpu/drm/arm/display/komeda/komeda_kms.h b/drivers/gpu/drm/arm/display/komeda/komeda_kms.h
> > > > index dc1d436..d0cf838 100644
> > > > --- a/drivers/gpu/drm/arm/display/komeda/komeda_kms.h
> > > > +++ b/drivers/gpu/drm/arm/display/komeda/komeda_kms.h
> > > > @@ -98,6 +98,12 @@ struct komeda_crtc {
> > > >  
> > > >  	/** @slave_planes_property: property for slaves of the planes */
> > > >  	struct drm_property *slave_planes_property;
> > > 
> > > And this seems to not be the first time this happened. Looking at komeda
> > > with a quick git grep on properties you've actually accumulated quite a
> > > pile of such driver properties already. Where's the userspace for this?
> > > Where's the uapi discussions for this stuff? Where's the igt tests for
> > > this (yes a bunch are after we agreed to have testcases for this).
> > > 
> > > I know that in the past we've been somewhat sloppy properties, but that
> > > was a mistake and we've cranked down on this hard. Probably need to fix
> > > this with a pile of reverts and start over.
> > > -Daniel
> > 
> > Sorry again.
> > 
> > First I'll send some patches to remove these private properties.
> > 
> > and then discuss for how to impelement them.
> > 
> > The current komeda privates are:
> > 
> > crtc:
> >    clock_ratio
> >    slave_planes
> > 
> > plane:
> >    img_enhancement
> >    layer_split
> > 
> > Layer_split: it can be deleted and computed in kernel.
> > 
> > img_enhancement:
> >   it is for image enhancement, can be removed and computed in kernel.
> >   but I'd like to have it, since it's a seperated function (NOT only
> >   for scaling or YUV format), I think only user can real know if need
> >   to enable it.
> > 
> > 
> > img_enhancement:
> >   it is for image enhancement, can be removed and computed in kernel.
> >   but I'd like to have it, since it's a seperated function (NOT only
> >   for scaling or YUV format), I think only user can real know if need
> >   to enable it.
> >   I think maybe we can add it CORE as an optional drm_plane property.
> 
> I really don't think we should be exposing this. It's purely there to
> help improve an image after scaling (effectively, sharpening). It's
> not a general purpose "image enhancer". Exposing a property which says
> "image enhancement" isn't useful to any application - what kind of
> enhancement is it doing?
> 
> > 
> > clock_ratio:
> >   It's the clock ratio of (main engine lock/output pixel clk) for
> >   komeda HW's downscaling restriction, as below:
> > 
> >   D71 downscaling must satisfy the following equation
> > 
> >   MCLK                   h_in * v_in
> >  ------- >= ---------------------------------------------
> >  PXLCLK     (h_total - (1 + 2 * v_in / v_out)) * v_out
> > 
> >  In only horizontal downscaling situation, the right side should be
> >  multiplied by (h_total - 3) / (h_active - 3), then equation becomes
> > 
> >   MCLK          h_in
> >  ------- >= ----------------
> >   PXLCLK     (h_active - 3)
> > 
> > slave_planes:
> >   it's not only for the zpos, but most importantly for notify the user
> >   to group the planes to two resource sets (pipeline-0 resources and pipeline1).
> >   Per our HW design the two pipelines can be dynamic assigned to CRTC
> >   according to the usage.
> >   - like user only enable one CRTC which can use all two pipelines
> >     (two resource resource sets)
> >   - but if enabled two CRTCs, only one resource set available for
> >     each CRTC.
> > 
> > komeda user need to known the clock_ratio and slave_planes, but how
> > to expose them: private_property, sysfs or other ways, seems we need
> > to disscuss. :)
> 
> @Daniel,
> 
> These two are a symptom of a fundamental impedance mismatch between
> how KMS works and actually making optimal use of HW (or: how Android
> works).
> 
> HWComposer is expected to have good knowledge of how the underlying HW
> operates, so that it can effectively schedule a scene. "TEST_ONLY til
> it works" isn't a viable strategy, and it absolutely shouldn't be
> needed for a piece of code which has been written _specifically_ to
> drive komeda.
> 
> It's acknowledged that HW-specific planners may be needed even in
> drm-hwcomposer, and those planners are going to need to get told some
> stuff about the HW. Whether that info should go through atomic
> properties or not is up for debate (adding properties without
> following the rules notwithstanding).
> 
> What's certain is that debugfs is not workable, because it's not
> available in a production Android device (nor should it be).
> 
> And of course, there's room for making the information more generic as
> far as possible, at which point they might be better candidates for
> DRM UAPI.
> 
> Thanks,
> -Brian
> 
> > 
> > Thanks
> > James
> > 
> > > > +
> > > > +	/** @vrr_property: property for variable refresh rate */
> > > > +	struct drm_property *vrr_property;
> > > > +
> > > > +	/** @vrr_enable_property: property for enable/disable the vrr */
> > > > +	struct drm_property *vrr_enable_property;
> > > >  };
> > > >  
> > > >  /**
> > > > @@ -126,6 +132,12 @@ struct komeda_crtc_state {
> > > >  
> > > >  	/** @max_slave_zorder: the maximum of slave zorder */
> > > >  	u32 max_slave_zorder;
> > > > +
> > > > +	/** @vfp: the value of vertical front porch */
> > > > +	u32 vfp;
> > > > +
> > > > +	/** @en_vrr: enable status of variable refresh rate */
> > > > +	u8 en_vrr : 1;
> > > >  };
> > > >  
> > > >  /** struct komeda_kms_dev - for gather KMS related things */
> > > > diff --git a/drivers/gpu/drm/arm/display/komeda/komeda_pipeline.h b/drivers/gpu/drm/arm/display/komeda/komeda_pipeline.h
> > > > index 00e8083..66d7664 100644
> > > > --- a/drivers/gpu/drm/arm/display/komeda/komeda_pipeline.h
> > > > +++ b/drivers/gpu/drm/arm/display/komeda/komeda_pipeline.h
> > > > @@ -336,7 +336,9 @@ struct komeda_improc_state {
> > > >  /* display timing controller */
> > > >  struct komeda_timing_ctrlr {
> > > >  	struct komeda_component base;
> > > > -	u8 supports_dual_link : 1;
> > > > +	u8 supports_dual_link : 1,
> > > > +	   supports_vrr : 1;
> > > > +	struct malidp_range vfp_range;
> > > >  };
> > > >  
> > > >  struct komeda_timing_ctrlr_state {
> > > > -- 
> > > > 1.9.1
> > > > 
> > > > _______________________________________________
> > > > dri-devel mailing list
> > > > dri-devel@xxxxxxxxxxxxxxxxxxxxx
> > > > https://lists.freedesktop.org/mailman/listinfo/dri-devel
> > > 
> > > -- 
> > > Daniel Vetter
> > > Software Engineer, Intel Corporation
> > > http://blog.ffwll.ch