On 2021-06-07 2:01 p.m., Shankar, Uma wrote: > > >> -----Original Message----- >> From: Harry Wentland <harry.wentland@xxxxxxx> >> Sent: Saturday, June 5, 2021 12:21 AM >> To: Shankar, Uma <uma.shankar@xxxxxxxxx>; intel-gfx@xxxxxxxxxxxxxxxxxxxxx; dri- >> devel@xxxxxxxxxxxxxxxxxxxxx >> Cc: Modem, Bhanuprakash <bhanuprakash.modem@xxxxxxxxx>; Cyr, Aric >> <Aric.Cyr@xxxxxxx> >> Subject: Re: [PATCH 0/9] Enhance pipe color support for multi segmented luts >> >> On 2021-06-01 6:41 a.m., Uma Shankar wrote: >>> Modern hardwares have multi segmented lut approach to prioritize the >>> darker regions of the spectrum. This series introduces a new UAPI to >>> define the lut ranges supported by the respective hardware. >>> >>> This also enables Pipe Color Management Support for Intel's XE_LPD hw. >>> Enable Support for Pipe Degamma with the increased lut samples >>> supported by hardware. This also adds support for newly introduced >>> Logarithmic Gamma for XE_LPD. Also added the gamma readout support. >>> >>> The Logarithmic gamma implementation on XE_LPD is non linear and adds >>> 25 segments with non linear lut samples in each segment. The >>> expectation is userspace will create the luts as per this distribution >>> and pass the final samples to driver to be programmed in hardware. >>> >> >> Is this design targetting Intel XE_LPD HW in particular or is it intended to be generic? >> >> If this is intended to be generic I think it would benefit from a lot more >> documentation. At this point it's difficult for me to see how to adapt this to AMD >> HW. It would take me a while to be comfortable to make a call on whether we can >> use it or not. And what about other vendors? > > This is expected to be generic for all vendors. XE_LPD is just a reference implementation. > It's basically an extension of what we have for crtc color but designing the UAPI to have it > more scalable for future hardware. The legacy hardware implementation which we have in > crtc properties can easily fit in this new UAPI and this can help represent hardware better > with more precision and scalability. Credits to Ville as to this is his idea of how we can represent > hardware generically and advertise to userspace. > > Sure, I will add more documentation to make this clearer. > >> I think we need to be cautious in directly exposing HW functionality through UAPI. >> The CM parts of AMD HW seem to be changing in some way each generation and it >> looks like the same is true for Intel. The trouble we have with adapting the old >> gamma/degamma properties to modern HW is some indication to me that this >> approach is somewhat problematic. >> > > The advantage of having flexibility in userspace is that we give access of hardware to > userspace.It can then control things based on various usecases and not limited by just > a subset of operations what we define (in the lack of such an implementation). > >> It would be useful to understand and document the specific use-cases we want to >> provide to userspace implementers with this functionality. Do we want to support >> modern transfer functions such as PQ or HLG? If so, it might be beneficial to have an >> API to explicitly specify that, and then use LUT tables in drivers that are optimized for >> the implementing HW. Or is the use case tone mapping? If so, would a parametric >> definition of tone mapping be easier to manage? >> > > Yes right, ideally this is what intend to achieve here. We cant have fixed tables for operations > like Tone mapping as it will depend on mastering luminance values which can vary along with > other attributes of metadata. Eventually this operation would be done by the gamma block > (non linear luts), the values for which would be calculated and send by userspace. Thus making > all this very generic. Also we can't do any color math in driver as it has lot of floating operations. > > So here the trade-off is between having a UAPI where userspace controls hw, computes and sends > values vs having just a fixed function operations with hard coded lut tables in driver. > > Maybe we can have both the options in order to give flexibility to hardware vendors. We can > document the usage of the UAPI we create which can help things co-exist. Userspace can query > the supported properties and implement based on the properties exposed by the respective > vendor driver implementation. > > My personal preference would be to go with generic option (expose hardware to userspace) which > will make life easier for userspace developers. This will help use hardware for any color operation not > just limited to linearization, CSC conversions and tone mapping. Also this is already done for crtc, so it just > need to be extended to planes. > Thanks for providing more background. How would a driver handle this segmented LUT when the implementing HW doesn't have 512 points, but uses more, or less, or differently distributed points? What about HW that doesn't support RAM LUTs and only supports ROMs? Obviously such HW would likely not be able to do tone mapping in HW but could still linearize the content. Harry >>> +-----+------------------------------+ >>> | x | 2 pow x segment|No of Entries >>> | | 0 | 1 | >>> | 0 | 1 | 1 | >>> | 1 | 2 | 2 | >>> | 2 | 4 | 2 | >>> | 3 | 8 | 2 | >>> | 4 | 16 | 2 | >>> | 5 | 32 | 4 | >>> | 6 | 64 | 4 | >>> | 7 | 128 | 4 | >>> | 8 | 256 | 8 | >>> | 9 | 512 | 8 | >>> | 10 | 1024 | 8 | >>> | 11 | 2048 | 16 | >>> | 12 | 4096 | 16 | >>> | 13 | 8192 | 16 | >>> | 14 | 16384 | 32 | >>> | 15 | 32768 | 32 | >>> | 16 | 65536 | 64 | >>> | 17 | 131072 | 64 | >>> | 18 | 262144 | 64 | >>> | 19 | 524288 | 32 | >>> | 20 | 1048576 | 32 | >>> | 21 | 2097152 | 32 | >>> | 22 | 4194304 | 32 | >>> | 23 | 8388608 | 32 | >>> | 24 | 16777216 | 1 | >>> | | Total Entries | 511 | >>> -----+-----------------+------------+ >>> >>> Credits: Special mention and credits to Ville Syrjala for coming up >>> with a design for this feature and inputs. This series is based on his >>> original design. >>> >>> Note: Userspace support for this new UAPI will be done on Chrome and >>> plan is to get this supported on mutter as well. We will notify the >>> list once we have that ready for review. >>> >> >> Is this an RFC? If so it would be good to mark it as such. > > Yes, sure will update the tag. > > Thanks Harry for the feedback. > > Regards, > Uma Shankar > >> Harry >> >>> Uma Shankar (9): >>> drm: Add gamma mode property >>> drm/i915/xelpd: Define color lut range structure >>> drm/i915/xelpd: Add support for Logarithmic gamma mode >>> drm/i915/xelpd: Attach gamma mode property >>> drm: Add Client Cap for advance gamma mode >>> drm/i915/xelpd: logarithmic gamma enabled only with advance gamma mode >>> drm/i915/xelpd: Enable Pipe Degamma >>> drm/i915/xelpd: Add Pipe Color Lut caps to platform config >>> drm/i915/xelpd: Enable XE_LPD Gamma Lut readout >>> >>> drivers/gpu/drm/drm_atomic_uapi.c | 8 + >>> drivers/gpu/drm/drm_color_mgmt.c | 75 ++++ >>> drivers/gpu/drm/drm_ioctl.c | 5 + >>> drivers/gpu/drm/i915/display/intel_color.c | 454 ++++++++++++++++++++- >>> drivers/gpu/drm/i915/i915_pci.c | 3 +- >>> drivers/gpu/drm/i915/i915_reg.h | 7 + >>> include/drm/drm_atomic.h | 1 + >>> include/drm/drm_color_mgmt.h | 8 + >>> include/drm/drm_crtc.h | 25 ++ >>> include/drm/drm_file.h | 8 + >>> include/uapi/drm/drm.h | 8 + >>> include/uapi/drm/drm_mode.h | 43 ++ >>> 12 files changed, 630 insertions(+), 15 deletions(-) >>> >