From: Sagar Arun Kamble Subject: Re: [PATCH v6 1/1] Documentation: drm: describing drm properties exposed by various drivers Date: Tue, 11 Mar 2014 19:37:58 +0530 Message-ID: <1394546878.18918.7.camel@sagar-desktop> References: <6398512.6Zeryzgla0@avalon> <1394534255-32530-1-git-send-email-sagar.a.kamble@intel.com> Mime-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: QUOTED-PRINTABLE Return-path: In-Reply-To: Sender: linux-doc-owner@vger.kernel.org To: "Deucher, Alexander" Cc: "intel-gfx@lists.freedesktop.org" , Rob Landley , Dave Airlie , Daniel Vetter , Laurent Pinchart , David Herrmann , Ville =?ISO-8859-1?Q?Syrj=E4l=E4?= , "Purushothaman, Vijay A" , "linux-doc@vger.kernel.org" , "dri-devel@lists.freedesktop.org" List-Id: dri-devel@lists.freedesktop.org On Tue, 2014-03-11 at 13:13 +0000, Deucher, Alexander wrote: >=20 > > -----Original Message----- > > From: sagar.a.kamble@intel.com [mailto:sagar.a.kamble@intel.com] > > Sent: Tuesday, March 11, 2014 6:38 AM > > To: intel-gfx@lists.freedesktop.org > > Cc: Sagar Kamble; Rob Landley; Dave Airlie; Daniel Vetter; Laurent = Pinchart; > > David Herrmann; Deucher, Alexander; Ville Syrj=C3=A4l=C3=A4; Purush= othaman, Vijay A; > > linux-doc@vger.kernel.org; dri-devel@lists.freedesktop.org > > Subject: [PATCH v6 1/1] Documentation: drm: describing drm properti= es > > exposed by various drivers > >=20 > > From: Sagar Kamble > >=20 > > Started documenting drm properties for drm drivers. This patch prov= ides > > information about properties in drm, i915, psb and cdv/gma-500. Inf= ormation > > about other properties can be added on top of these. > >=20 > > v2: Added description of drm properties in armada, exynos, i2c/ch70= 06, > > noveau, > > omap, qxl, radeon, rcar-du > >=20 > > v3: Removed "Property Object" column since it is implementation rel= ated. > > Property > > type column refined.[Ville's review comments] > >=20 > > v4: Removed whitespace warnings and minor nits. [Randy's review > > comments] > >=20 > > v5: Restructured output for ENUM properties > >=20 > > v6: Review comments on formatting the table. [Laurent's review comm= ents] > >=20 > > Cc: Rob Landley > > Cc: Dave Airlie > > Cc: Daniel Vetter > > Cc: Laurent Pinchart > > Cc: David Herrmann > > Cc: Alex Deucher > > Cc: "Ville Syrj=C3=A4l=C3=A4" > > Cc: Sagar Kamble > > Cc: "Purushothaman, Vijay A" > > Cc: linux-doc@vger.kernel.org > > Cc: dri-devel@lists.freedesktop.org > >=20 > > Signed-off-by: Sagar Kamble > > --- > > Documentation/DocBook/drm.tmpl | 848 > > +++++++++++++++++++++++++++++++++++++++++ > > 1 file changed, 848 insertions(+) > >=20 > > diff --git a/Documentation/DocBook/drm.tmpl > > b/Documentation/DocBook/drm.tmpl > > index ed1d6d2..ae5e606 100644 > > --- a/Documentation/DocBook/drm.tmpl > > +++ b/Documentation/DocBook/drm.tmpl > > @@ -2317,6 +2317,854 @@ void intel_crt_init(struct drm_device *dev) > > pointer to the target object, a pointer to the previously cr= eated property > > and an initial instance value. > > > > + > > + > > + The following table gives description of drm properties exp= osed by > > various > > + modules/drivers. > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + >=20 > The coherent option is available on both DVI-I and DVI-D connectors u= nless I'm misunderstanding the table layout. >=20 > Alex Yes. The column "Group" is logical group of properties like TV-properties, CRTC properties, Overlay properties etc. I haven't gone in details of where all these properties are applicable. In this case I am seeing DVIHDMIA amd DVIHDMIB also associated with thi= s property. We can keep adding/refining this table with incremental patches on top of this one.=20 >=20 > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > + > > +
Owner Module/DriversGroupProperty NameTypeProperty ValuesObject attachedDescription/Restrictions
DRMGeneric=E2=80=9CEDID=E2=80=9DBLOB | IMMUTABLE0ConnectorContains id of edid blob ptr object.
=E2=80=9CDPMS=E2=80=9DENUM{ =E2=80=9COn=E2=80=9D, =E2=80=9CStandby=E2=80= =9D, =E2=80=9CSuspend=E2=80=9D, =E2=80=9COff=E2=80=9D }ConnectorContains DPMS operation mode value.
DVI-I=E2=80=9Csubconnector=E2=80=9DENUM{ =E2=80=9CUnknown=E2=80=9D, =E2=80=9CDVI-D=E2= =80=9D, =E2=80=9CDVI-A=E2=80=9D }ConnectorTBD
=E2=80=9Cselect subconnector=E2=80=9DENUM{ =E2=80=9CAutomatic=E2=80=9D, =E2=80=9CDVI-D=E2= =80=9D, =E2=80=9CDVI-A=E2=80=9D }ConnectorTBD
TV=E2=80=9Csubconnector=E2=80=9DENUM{ "Unknown", "Composite", "SVIDEO", "Component= ", > > "SCART" }ConnectorTBD
=E2=80=9Cselect subconnector=E2=80=9DENUM{ "Automatic", "Composite", "SVIDEO", "Compone= nt", > > "SCART" }ConnectorTBD
=E2=80=9Cmode=E2=80=9DENUM{ "NTSC_M", "NTSC_J", "NTSC_443", "PAL_B" } et= c.ConnectorTBD
=E2=80=9Cleft margin=E2=80=9DRANGEMin=3D0, Max=3D100ConnectorTBD
=E2=80=9Cright margin=E2=80=9DRANGEMin=3D0, Max=3D100ConnectorTBD
=E2=80=9Ctop margin=E2=80=9DRANGEMin=3D0, Max=3D100ConnectorTBD
=E2=80=9Cbottom margin=E2=80=9DRANGEMin=3D0, Max=3D100ConnectorTBD
=E2=80=9Cbrightness=E2=80=9DRANGEMin=3D0, Max=3D100ConnectorTBD
=E2=80=9Ccontrast=E2=80=9DRANGEMin=3D0, Max=3D100ConnectorTBD
=E2=80=9Cflicker reduction=E2=80=9DRANGEMin=3D0, Max=3D100ConnectorTBD
=E2=80=9Coverscan=E2=80=9DRANGEMin=3D0, Max=3D100ConnectorTBD
=E2=80=9Csaturation=E2=80=9DRANGEMin=3D0, Max=3D100ConnectorTBD
=E2=80=9Chue=E2=80=9DRANGEMin=3D0, Max=3D100ConnectorTBD
Optional=E2=80=9Cscaling mode=E2=80=9DENUM{ "None", "Full", "Center", "Full aspect" } > > +ConnectorTBD
=E2=80=9Cdirty=E2=80=9DENUM | IMMUTABLE{ "Off", "On", "Annotate" }ConnectorTBD
i915Generic"Broadcast RGB"ENUM{ "Automatic", "Full", "Limited 16:235" }ConnectorTBD
=E2=80=9Caudio=E2=80=9DENUM{ "force-dvi", "off", "auto", "on" }ConnectorTBD
Standard name as in DRMStandard type as in DRMStandard value as in DRMStandard Object as in DRMTBD
SDVO-TV=E2=80=9Cmode=E2=80=9DENUM{ "NTSC_M", "NTSC_J", "NTSC_443", "PAL_B" } et= c.ConnectorTBD
"left_margin"RANGEMin=3D0, Max=3D SDVO dependentConnectorTBD
"right_margin"RANGEMin=3D0, Max=3D SDVO dependentConnectorTBD
"top_margin"RANGEMin=3D0, Max=3D SDVO dependentConnectorTBD
"bottom_margin"RANGEMin=3D0, Max=3D SDVO dependentConnectorTBD
=E2=80=9Chpos=E2=80=9DRANGEMin=3D0, Max=3D SDVO dependentConnectorTBD
=E2=80=9Cvpos=E2=80=9DRANGEMin=3D0, Max=3D SDVO dependentConnectorTBD
=E2=80=9Ccontrast=E2=80=9DRANGEMin=3D0, Max=3D SDVO dependentConnectorTBD
=E2=80=9Csaturation=E2=80=9DRANGEMin=3D0, Max=3D SDVO dependentConnectorTBD
=E2=80=9Chue=E2=80=9DRANGEMin=3D0, Max=3D SDVO dependentConnectorTBD
=E2=80=9Csharpness=E2=80=9DRANGEMin=3D0, Max=3D SDVO dependentConnectorTBD
=E2=80=9Cflicker_filter=E2=80=9DRANGEMin=3D0, Max=3D SDVO dependentConnectorTBD
=E2=80=9Cflicker_filter_adaptive=E2=80=9DRANGEMin=3D0, Max=3D SDVO dependentConnectorTBD
=E2=80=9Cflicker_filter_2d=E2=80=9DRANGEMin=3D0, Max=3D SDVO dependentConnectorTBD
=E2=80=9Ctv_chroma_filter=E2=80=9DRANGEMin=3D0, Max=3D SDVO dependentConnectorTBD
=E2=80=9Ctv_luma_filter=E2=80=9DRANGEMin=3D0, Max=3D SDVO dependentConnectorTBD
=E2=80=9Cdot_crawl=E2=80=9DRANGEMin=3D0, Max=3D1ConnectorTBD
SDVO-TV/LVDS=E2=80=9Cbrightness=E2=80=9DRANGEMin=3D0, Max=3D SDVO dependentConnectorTBD
CDV gma-500Generic"Broadcast RGB"ENUM{ =E2=80=9CFull=E2=80=9D, =E2=80=9CLimited 16:= 235=E2=80=9D }ConnectorTBD
"Broadcast RGB"ENUM{ =E2=80=9Coff=E2=80=9D, =E2=80=9Cauto=E2=80=9D= , =E2=80=9Con=E2=80=9D }ConnectorTBD
Standard name as in DRMStandard type as in DRMStandard value as in DRMStandard Object as in DRMTBD
PoulsboGeneric=E2=80=9Cbacklight=E2=80=9DRANGEMin=3D0, Max=3D100ConnectorTBD
Standard name as in DRMStandard type as in DRMStandard value as in DRMStandard Object as in DRMTBD
SDVO-TV=E2=80=9Cmode=E2=80=9DENUM{ "NTSC_M", "NTSC_J", "NTSC_443", "PAL_B" } et= c.ConnectorTBD
"left_margin"RANGEMin=3D0, Max=3D SDVO dependentConnectorTBD
"right_margin"RANGEMin=3D0, Max=3D SDVO dependentConnectorTBD
"top_margin"RANGEMin=3D0, Max=3D SDVO dependentConnectorTBD
"bottom_margin"RANGEMin=3D0, Max=3D SDVO dependentConnectorTBD
=E2=80=9Chpos=E2=80=9DRANGEMin=3D0, Max=3D SDVO dependentConnectorTBD
=E2=80=9Cvpos=E2=80=9DRANGEMin=3D0, Max=3D SDVO dependentConnectorTBD
=E2=80=9Ccontrast=E2=80=9DRANGEMin=3D0, Max=3D SDVO dependentConnectorTBD
=E2=80=9Csaturation=E2=80=9DRANGEMin=3D0, Max=3D SDVO dependentConnectorTBD
=E2=80=9Chue=E2=80=9DRANGEMin=3D0, Max=3D SDVO dependentConnectorTBD
=E2=80=9Csharpness=E2=80=9DRANGEMin=3D0, Max=3D SDVO dependentConnectorTBD
=E2=80=9Cflicker_filter=E2=80=9DRANGEMin=3D0, Max=3D SDVO dependentConnectorTBD
=E2=80=9Cflicker_filter_adaptive=E2=80=9DRANGEMin=3D0, Max=3D SDVO dependentConnectorTBD
=E2=80=9Cflicker_filter_2d=E2=80=9DRANGEMin=3D0, Max=3D SDVO dependentConnectorTBD
=E2=80=9Ctv_chroma_filter=E2=80=9DRANGEMin=3D0, Max=3D SDVO dependentConnectorTBD
=E2=80=9Ctv_luma_filter=E2=80=9DRANGEMin=3D0, Max=3D SDVO dependentConnectorTBD
=E2=80=9Cdot_crawl=E2=80=9DRANGEMin=3D0, Max=3D1ConnectorTBD
SDVO-TV/LVDS=E2=80=9Cbrightness=E2=80=9DRANGEMin=3D0, Max=3D SDVO dependentConnectorTBD
armadaCRTC"CSC_YUV"ENUM{ "Auto" , "CCIR601", "CCIR709" }CRTCTBD
"CSC_RGB"ENUM{ "Auto", "Computer system", "Studio" }CRTCTBD
Overlay"colorkey"RANGEMin=3D0, Max=3D0xffffffPlaneTBD
"colorkey_min"RANGEMin=3D0, Max=3D0xffffffPlaneTBD
"colorkey_max"RANGEMin=3D0, Max=3D0xffffffPlaneTBD
"colorkey_val"RANGEMin=3D0, Max=3D0xffffffPlaneTBD
"colorkey_alpha"RANGEMin=3D0, Max=3D0xffffffPlaneTBD
"colorkey_mode"ENUM{ "disabled", "Y component", "U component" > > +, "V component", "RGB", =E2=80=9CR component", "G component", "B c= omponent" > > }PlaneTBD
"brightness"RANGEMin=3D0, Max=3D256 + 255PlaneTBD
"contrast"RANGEMin=3D0, Max=3D0x7fffPlaneTBD
"saturation"RANGEMin=3D0, Max=3D0x7fffPlaneTBD
exynosCRTC=E2=80=9Cmode=E2=80=9DENUM{ "normal", "blank" }CRTCTBD
Overlay=E2=80=9Czpos=E2=80=9DRANGEMin=3D0, Max=3DMAX_PLANE-1PlaneTBD
i2c/ch7006_drvGeneric=E2=80=9Cscale=E2=80=9DRANGEMin=3D0, Max=3D2ConnectorTBD
TVStandard names as in DRMStandard types as in DRMStandard Values as in DRMStandard object as in DRMTBD
=E2=80=9Cmode=E2=80=9DENUM{ "PAL", "PAL-M","PAL-N"}, =E2=80=9DPAL-Nc" > > +, "PAL-60", "NTSC-M", "NTSC-J" }ConnectorTBD
noveauNV10 Overlay"colorkey"RANGEMin=3D0, Max=3D0x01ffffffPlaneTBD
=E2=80=9Ccontrast=E2=80=9DRANGEMin=3D0, Max=3D8192-1PlaneTBD
=E2=80=9Cbrightness=E2=80=9DRANGEMin=3D0, Max=3D1024PlaneTBD
=E2=80=9Chue=E2=80=9DRANGEMin=3D0, Max=3D359PlaneTBD
=E2=80=9Csaturation=E2=80=9DRANGEMin=3D0, Max=3D8192-1PlaneTBD
=E2=80=9Citurbt_709=E2=80=9DRANGEMin=3D0, Max=3D1PlaneTBD
Nv04 Overlay=E2=80=9Ccolorkey=E2=80=9DRANGEMin=3D0, Max=3D0x01ffffffPlaneTBD
=E2=80=9Cbrightness=E2=80=9DRANGEMin=3D0, Max=3D1024PlaneTBD
Display=E2=80=9Cdithering mode=E2=80=9DENUM{ "auto", "off", "on" }ConnectorTBD
=E2=80=9Cdithering depth=E2=80=9DENUM{ "auto", "off", "on", "static 2x2", "dynamic = 2x2", > > "temporal" }ConnectorTBD
=E2=80=9Cunderscan=E2=80=9DENUM{ "auto", "6 bpc", "8 bpc" }ConnectorTBD
=E2=80=9Cunderscan hborder=E2=80=9DRANGEMin=3D0, Max=3D128ConnectorTBD
=E2=80=9Cunderscan vborder=E2=80=9DRANGEMin=3D0, Max=3D128ConnectorTBD
=E2=80=9Cvibrant hue=E2=80=9DRANGEMin=3D0, Max=3D180ConnectorTBD
=E2=80=9Ccolor vibrance=E2=80=9DRANGEMin=3D0, Max=3D200ConnectorTBD
GenericStandard name as in DRMStandard type as in DRMStandard value as in DRMStandard Object as in DRMTBD
omapGeneric=E2=80=9Crotation=E2=80=9DBITMASK{ 0, "rotate-0" }, > > +{ 1, "rotate-90" }, > > +{ 2, "rotate-180" }, > > +{ 3, "rotate-270" }, > > +{ 4, "reflect-x" }, > > +{ 5, "reflect-y" }CRTC, PlaneTBD
=E2=80=9Czorder=E2=80=9DRANGEMin=3D0, Max=3D3CRTC, PlaneTBD
qxlGeneric=E2=80=9Chotplug_mode_update"RANGEMin=3D0, Max=3D1ConnectorTBD
radeonDVI-I=E2=80=9Ccoherent=E2=80=9DRANGEMin=3D0, Max=3D1ConnectorTBD
DAC enable load detect=E2=80=9Cload detection=E2=80=9DRANGEMin=3D0, Max=3D1ConnectorTBD
TV Standard"tv standard"ENUM{ "ntsc", "pal", "pal-m", "pal-60", "ntsc-j" > > +, "scart-pal", "pal-cn", "secam" }ConnectorTBD
legacy TMDS PLL detect"tmds_pll"ENUM{ "driver", "bios" }-TBD
Underscan"underscan"ENUM{ "off", "on", "auto" }ConnectorTBD
"underscan hborder"RANGEMin=3D0, Max=3D128ConnectorTBD
"underscan vborder"RANGEMin=3D0, Max=3D128ConnectorTBD
Audio=E2=80=9Caudio=E2=80=9DENUM{ "off", "on", "auto" }ConnectorTBD
FMT Dithering=E2=80=9Cdither=E2=80=9DENUM{ "off", "on" }ConnectorTBD
GenericStandard name as in DRMStandard type as in DRMStandard value as in DRMStandard Object as in DRMTBD
rcar-duGeneric"alpha"RANGEMin=3D0, Max=3D255PlaneTBD
"colorkey"RANGEMin=3D0, Max=3D0x01ffffffPlaneTBD
"zpos"RANGEMin=3D1, Max=3D7PlaneTBD
> > > >=20 > > > > -- > > 1.8.5 > >=20 >=20