Re: [Intel-gfx] [PATCH 4/5] Documentation: drm: Convert KMS Properties HTML table to CALS

26 Aug 2015

On Tue, Aug 25, 2015 at 05:10:54PM +0100, Graham Whaley wrote:
...
On Tue, 2015-08-25 at 16:29 +0200, Daniel Vetter wrote:
...
On Tue, Aug 25, 2015 at 10:26:44AM +0100, Graham Whaley wrote:
...
The KMS Properties table is in HTML format, which is not supported
for building pdfdocs, resulting in the following types of errors:
jade:/Documentation/DocBook/drm.xml:34413:15:E: there is no
attribute
 "border"
 jade:/Documentation/DocBook/drm.xml:34413:31:E: there is no
attribute
 "cellpadding"
 jade:/Documentation/DocBook/drm.xml:34413:47:E: there is no
attribute
 "cellspacing"
 jade:/Documentation/DocBook/drm.xml:34414:7:E: document type does
not
 allow element "tbody" here
Convert the table over to a CALS format table
Hm, long-term plan was to move this table into DOC: comments in the
source-code using markdown, which we now have (at least in
drm-intel-nightly and also planned to be merged into 4.4). Since this
is
both a lot of churn I'd like to get there in just 1 step ...
-Daniel
First - I've just noted an erroneous debug comment (or two) left in
this patch as well, so looks like I will have to re-issue the series
anyway.
OK. I guess this comes down to a matter of timing...
From Danilos patch of: f6d6913 (drm/doc: Convert to markdown)
we can see markdown does not natively support tables, and we'd have to
make this a fixed width layout like the one in that patch I suspect.
Danilo - any advice on how you did that other table conversion? I just
did a pandoc docbook->markdown_github and it looks some way there - but
of course seems to have not honored the multi-column items, of which
there are a few. It's probably not too bad to fix up by hand - I'll see
if I can get that to work...
Any clue to where in the source file DOC: sections it would want to
live if I get it formatted - I don't see an obvious !include near the
table in the .tmpl file to piggyback.
Yeah it's a bit more involved and probably a bigger series. We might even
want to split up this table into per-feature stuff since the current one
doesn't really scale. Otoh that can be done later on.
What I'd do is split it into sections (generic, i915, ...) so that we can
avoid the row-spanning as much as possible, and then just place it
somewhere into drm_crtc.c - that's the grab-bag for all things modeset
(which properties are a part of). Maybe longer-term we want to split out a
drm_properties.c or something like that with the pile of support code we
have already, plus this kerneldoc.
-Daniel
...
Graham
...
...
Signed-off-by: Graham Whaley graham.whaley@linux.intel.com
Documentation/DocBook/drm.tmpl | 1866 ++++++++++++++++++++--------
1 file changed, 937 insertions(+), 929 deletions(-)

diff --git a/Documentation/DocBook/drm.tmpl
b/Documentation/DocBook/drm.tmpl
index 2e05a79..e5bfdd8 100644
--- a/Documentation/DocBook/drm.tmpl
+++ b/Documentation/DocBook/drm.tmpl
@@ -2580,935 +2580,943 @@ void intel_crt_init(struct drm_device
*dev)
       and an initial instance value.
     </para>
     <sect2>

<title>Existing KMS Properties</title>

<para>

The following table gives description of drm properties

exposed by various

modules/drivers.
</para>

<table border="1" cellpadding="0" cellspacing="0">

<tbody>

<tr style="font-weight: bold;">

<td valign="top" >Owner Module/Drivers</td>

<td valign="top" >Group</td>

<td valign="top" >Property Name</td>

<td valign="top" >Type</td>

<td valign="top" >Property Values</td>

<td valign="top" >Object attached</td>

<td valign="top" >Description/Restrictions</td>

</tr>

<tr>

<td rowspan="37" valign="top" >DRM</td>

<td valign="top" >Generic</td>

<td valign="top" >“rotation”</td>

<td valign="top" >BITMASK</td>

<td valign="top" >{ 0, "rotate-0" },

{ 1, "rotate-90" },
{ 2, "rotate-180" },
{ 3, "rotate-270" },
{ 4, "reflect-x" },
{ 5, "reflect-y" }</td>
<td valign="top" >CRTC, Plane</td>

<td valign="top" >rotate-(degrees) rotates the image by


the specified amount in degrees

in counter clockwise direction. reflect-x and reflect-y

reflects the

image along the specified axis prior to rotation</td>
</tr>

<tr>

<td rowspan="5" valign="top" >Connector</td>

<td valign="top" >“EDID”</td>

<td valign="top" >BLOB | IMMUTABLE</td>

<td valign="top" >0</td>

<td valign="top" >Connector</td>

<td valign="top" >Contains id of edid blob ptr


object.</td>

</tr>

<tr>

<td valign="top" >“DPMS”</td>

<td valign="top" >ENUM</td>

<td valign="top" >{ “On”, “Standby”, “Suspend”, “Off”


}</td>

<td valign="top" >Connector</td>

<td valign="top" >Contains DPMS operation mode value.</td>

</tr>

<tr>

<td valign="top" >“PATH”</td>

<td valign="top" >BLOB | IMMUTABLE</td>

<td valign="top" >0</td>

<td valign="top" >Connector</td>

<td valign="top" >Contains topology path to a


connector.</td>

</tr>

<tr>

<td valign="top" >“TILE”</td>

<td valign="top" >BLOB | IMMUTABLE</td>

<td valign="top" >0</td>

<td valign="top" >Connector</td>

<td valign="top" >Contains tiling information for a


connector.</td>

</tr>

<tr>

<td valign="top" >“CRTC_ID”</td>

<td valign="top" >OBJECT</td>

<td valign="top" >DRM_MODE_OBJECT_CRTC</td>

<td valign="top" >Connector</td>

<td valign="top" >CRTC that connector is attached to


(atomic)</td>

</tr>

<tr>

<td rowspan="11" valign="top" >Plane</td>

<td valign="top" >“type”</td>

<td valign="top" >ENUM | IMMUTABLE</td>

<td valign="top" >{ "Overlay", "Primary", "Cursor" }</td>

<td valign="top" >Plane</td>

<td valign="top" >Plane type</td>

</tr>

<tr>

<td valign="top" >“SRC_X”</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max=UINT_MAX</td>

<td valign="top" >Plane</td>

<td valign="top" >Scanout source x coordinate in 16.16


fixed point (atomic)</td>

</tr>

<tr>

<td valign="top" >“SRC_Y”</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max=UINT_MAX</td>

<td valign="top" >Plane</td>

<td valign="top" >Scanout source y coordinate in 16.16


fixed point (atomic)</td>

</tr>

<tr>

<td valign="top" >“SRC_W”</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max=UINT_MAX</td>

<td valign="top" >Plane</td>

<td valign="top" >Scanout source width in 16.16 fixed


point (atomic)</td>

</tr>

<tr>

<td valign="top" >“SRC_H”</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max=UINT_MAX</td>

<td valign="top" >Plane</td>

<td valign="top" >Scanout source height in 16.16 fixed


point (atomic)</td>

</tr>

<tr>

<td valign="top" >“CRTC_X”</td>

<td valign="top" >SIGNED_RANGE</td>

<td valign="top" >Min=INT_MIN, Max=INT_MAX</td>

<td valign="top" >Plane</td>

<td valign="top" >Scanout CRTC (destination) x coordinate


(atomic)</td>

</tr>

<tr>

<td valign="top" >“CRTC_Y”</td>

<td valign="top" >SIGNED_RANGE</td>

<td valign="top" >Min=INT_MIN, Max=INT_MAX</td>

<td valign="top" >Plane</td>

<td valign="top" >Scanout CRTC (destination) y coordinate


(atomic)</td>

</tr>

<tr>

<td valign="top" >“CRTC_W”</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max=UINT_MAX</td>

<td valign="top" >Plane</td>

<td valign="top" >Scanout CRTC (destination) width


(atomic)</td>

</tr>

<tr>

<td valign="top" >“CRTC_H”</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max=UINT_MAX</td>

<td valign="top" >Plane</td>

<td valign="top" >Scanout CRTC (destination) height


(atomic)</td>

</tr>

<tr>

<td valign="top" >“FB_ID”</td>

<td valign="top" >OBJECT</td>

<td valign="top" >DRM_MODE_OBJECT_FB</td>

<td valign="top" >Plane</td>

<td valign="top" >Scanout framebuffer (atomic)</td>

</tr>

<tr>

<td valign="top" >“CRTC_ID”</td>

<td valign="top" >OBJECT</td>

<td valign="top" >DRM_MODE_OBJECT_CRTC</td>

<td valign="top" >Plane</td>

<td valign="top" >CRTC that plane is attached to


(atomic)</td>

</tr>

<tr>

<td rowspan="2" valign="top" >DVI-I</td>

<td valign="top" >“subconnector”</td>

<td valign="top" >ENUM</td>

<td valign="top" >{ “Unknown”, “DVI-D”, “DVI-A” }</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >“select subconnector”</td>

<td valign="top" >ENUM</td>

<td valign="top" >{ “Automatic”, “DVI-D”, “DVI-A” }</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td rowspan="13" valign="top" >TV</td>

<td valign="top" >“subconnector”</td>

<td valign="top" >ENUM</td>

<td valign="top" >{ "Unknown", "Composite", "SVIDEO",


"Component", "SCART" }</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >“select subconnector”</td>

<td valign="top" >ENUM</td>

<td valign="top" >{ "Automatic", "Composite", "SVIDEO",


"Component", "SCART" }</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >“mode”</td>

<td valign="top" >ENUM</td>

<td valign="top" >{ "NTSC_M", "NTSC_J", "NTSC_443",


"PAL_B" } etc.</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >“left margin”</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max=100</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >“right margin”</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max=100</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >“top margin”</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max=100</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >“bottom margin”</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max=100</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >“brightness”</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max=100</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >“contrast”</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max=100</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >“flicker reduction”</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max=100</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >“overscan”</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max=100</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >“saturation”</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max=100</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >“hue”</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max=100</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td rowspan="2" valign="top" >Virtual GPU</td>

<td valign="top" >“suggested X”</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max=0xffffffff</td>

<td valign="top" >Connector</td>

<td valign="top" >property to suggest an X offset for a


connector</td>

</tr>

<tr>

<td valign="top" >“suggested Y”</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max=0xffffffff</td>

<td valign="top" >Connector</td>

<td valign="top" >property to suggest an Y offset for a


connector</td>

</tr>

<tr>

<td rowspan="3" valign="top" >Optional</td>

<td valign="top" >“scaling mode”</td>

<td valign="top" >ENUM</td>

<td valign="top" >{ "None", "Full", "Center", "Full


aspect" }</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >"aspect ratio"</td>

<td valign="top" >ENUM</td>

<td valign="top" >{ "None", "4:3", "16:9" }</td>

<td valign="top" >Connector</td>

<td valign="top" >DRM property to set aspect ratio from


user space app.

This enum is made generic to allow addition of



custom aspect

ratios.</td>


</tr>

<tr>

<td valign="top" >“dirty”</td>

<td valign="top" >ENUM | IMMUTABLE</td>

<td valign="top" >{ "Off", "On", "Annotate" }</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td rowspan="20" valign="top" >i915</td>

<td rowspan="2" valign="top" >Generic</td>

<td valign="top" >"Broadcast RGB"</td>

<td valign="top" >ENUM</td>

<td valign="top" >{ "Automatic", "Full", "Limited 16:235"


}</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >“audio”</td>

<td valign="top" >ENUM</td>

<td valign="top" >{ "force-dvi", "off", "auto", "on"


}</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td rowspan="17" valign="top" >SDVO-TV</td>

<td valign="top" >“mode”</td>

<td valign="top" >ENUM</td>

<td valign="top" >{ "NTSC_M", "NTSC_J", "NTSC_443",


"PAL_B" } etc.</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >"left_margin"</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max= SDVO dependent</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >"right_margin"</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max= SDVO dependent</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >"top_margin"</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max= SDVO dependent</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >"bottom_margin"</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max= SDVO dependent</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >“hpos”</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max= SDVO dependent</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >“vpos”</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max= SDVO dependent</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >“contrast”</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max= SDVO dependent</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >“saturation”</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max= SDVO dependent</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >“hue”</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max= SDVO dependent</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >“sharpness”</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max= SDVO dependent</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >“flicker_filter”</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max= SDVO dependent</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >“flicker_filter_adaptive”</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max= SDVO dependent</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >“flicker_filter_2d”</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max= SDVO dependent</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >“tv_chroma_filter”</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max= SDVO dependent</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >“tv_luma_filter”</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max= SDVO dependent</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >“dot_crawl”</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max=1</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >SDVO-TV/LVDS</td>

<td valign="top" >“brightness”</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max= SDVO dependent</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td rowspan="2" valign="top" >CDV gma-500</td>

<td rowspan="2" valign="top" >Generic</td>

<td valign="top" >"Broadcast RGB"</td>

<td valign="top" >ENUM</td>

<td valign="top" >{ “Full”, “Limited 16:235” }</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >"Broadcast RGB"</td>

<td valign="top" >ENUM</td>

<td valign="top" >{ “off”, “auto”, “on” }</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td rowspan="19" valign="top" >Poulsbo</td>

<td rowspan="1" valign="top" >Generic</td>

<td valign="top" >“backlight”</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max=100</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td rowspan="17" valign="top" >SDVO-TV</td>

<td valign="top" >“mode”</td>

<td valign="top" >ENUM</td>

<td valign="top" >{ "NTSC_M", "NTSC_J", "NTSC_443",


"PAL_B" } etc.</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >"left_margin"</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max= SDVO dependent</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >"right_margin"</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max= SDVO dependent</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >"top_margin"</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max= SDVO dependent</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >"bottom_margin"</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max= SDVO dependent</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >“hpos”</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max= SDVO dependent</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >“vpos”</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max= SDVO dependent</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >“contrast”</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max= SDVO dependent</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >“saturation”</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max= SDVO dependent</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >“hue”</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max= SDVO dependent</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >“sharpness”</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max= SDVO dependent</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >“flicker_filter”</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max= SDVO dependent</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >“flicker_filter_adaptive”</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max= SDVO dependent</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >“flicker_filter_2d”</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max= SDVO dependent</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >“tv_chroma_filter”</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max= SDVO dependent</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >“tv_luma_filter”</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max= SDVO dependent</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >“dot_crawl”</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max=1</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >SDVO-TV/LVDS</td>

<td valign="top" >“brightness”</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max= SDVO dependent</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td rowspan="11" valign="top" >armada</td>

<td rowspan="2" valign="top" >CRTC</td>

<td valign="top" >"CSC_YUV"</td>

<td valign="top" >ENUM</td>

<td valign="top" >{ "Auto" , "CCIR601", "CCIR709" }</td>

<td valign="top" >CRTC</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >"CSC_RGB"</td>

<td valign="top" >ENUM</td>

<td valign="top" >{ "Auto", "Computer system", "Studio"


}</td>

<td valign="top" >CRTC</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td rowspan="9" valign="top" >Overlay</td>

<td valign="top" >"colorkey"</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max=0xffffff</td>

<td valign="top" >Plane</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >"colorkey_min"</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max=0xffffff</td>

<td valign="top" >Plane</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >"colorkey_max"</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max=0xffffff</td>

<td valign="top" >Plane</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >"colorkey_val"</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max=0xffffff</td>

<td valign="top" >Plane</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >"colorkey_alpha"</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max=0xffffff</td>

<td valign="top" >Plane</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >"colorkey_mode"</td>

<td valign="top" >ENUM</td>

<td valign="top" >{ "disabled", "Y component", "U


component"

, "V component", "RGB", “R component", "G component", "B

component" }</td>

<td valign="top" >Plane</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >"brightness"</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max=256 + 255</td>

<td valign="top" >Plane</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >"contrast"</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max=0x7fff</td>

<td valign="top" >Plane</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >"saturation"</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max=0x7fff</td>

<td valign="top" >Plane</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td rowspan="2" valign="top" >exynos</td>

<td valign="top" >CRTC</td>

<td valign="top" >“mode”</td>

<td valign="top" >ENUM</td>

<td valign="top" >{ "normal", "blank" }</td>

<td valign="top" >CRTC</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >Overlay</td>

<td valign="top" >“zpos”</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max=MAX_PLANE-1</td>

<td valign="top" >Plane</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td rowspan="2" valign="top" >i2c/ch7006_drv</td>

<td valign="top" >Generic</td>

<td valign="top" >“scale”</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max=2</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td rowspan="1" valign="top" >TV</td>

<td valign="top" >“mode”</td>

<td valign="top" >ENUM</td>

<td valign="top" >{ "PAL", "PAL-M","PAL-N"}, ”PAL-Nc"

, "PAL-60", "NTSC-M", "NTSC-J" }</td>
<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td rowspan="15" valign="top" >nouveau</td>

<td rowspan="6" valign="top" >NV10 Overlay</td>

<td valign="top" >"colorkey"</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max=0x01ffffff</td>

<td valign="top" >Plane</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >“contrast”</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max=8192-1</td>

<td valign="top" >Plane</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >“brightness”</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max=1024</td>

<td valign="top" >Plane</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >“hue”</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max=359</td>

<td valign="top" >Plane</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >“saturation”</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max=8192-1</td>

<td valign="top" >Plane</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >“iturbt_709”</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max=1</td>

<td valign="top" >Plane</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td rowspan="2" valign="top" >Nv04 Overlay</td>

<td valign="top" >“colorkey”</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max=0x01ffffff</td>

<td valign="top" >Plane</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >“brightness”</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max=1024</td>

<td valign="top" >Plane</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td rowspan="7" valign="top" >Display</td>

<td valign="top" >“dithering mode”</td>

<td valign="top" >ENUM</td>

<td valign="top" >{ "auto", "off", "on" }</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >“dithering depth”</td>

<td valign="top" >ENUM</td>

<td valign="top" >{ "auto", "off", "on", "static 2x2",


"dynamic 2x2", "temporal" }</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >“underscan”</td>

<td valign="top" >ENUM</td>

<td valign="top" >{ "auto", "6 bpc", "8 bpc" }</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >“underscan hborder”</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max=128</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >“underscan vborder”</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max=128</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >“vibrant hue”</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max=180</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >“color vibrance”</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max=200</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >omap</td>

<td valign="top" >Generic</td>

<td valign="top" >“zorder”</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max=3</td>

<td valign="top" >CRTC, Plane</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >qxl</td>

<td valign="top" >Generic</td>

<td valign="top" >“hotplug_mode_update"</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max=1</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td rowspan="9" valign="top" >radeon</td>

<td valign="top" >DVI-I</td>

<td valign="top" >“coherent”</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max=1</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >DAC enable load detect</td>

<td valign="top" >“load detection”</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max=1</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >TV Standard</td>

<td valign="top" >"tv standard"</td>

<td valign="top" >ENUM</td>

<td valign="top" >{ "ntsc", "pal", "pal-m", "pal-60",


"ntsc-j"

, "scart-pal", "pal-cn", "secam" }</td>
<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >legacy TMDS PLL detect</td>

<td valign="top" >"tmds_pll"</td>

<td valign="top" >ENUM</td>

<td valign="top" >{ "driver", "bios" }</td>

<td valign="top" >-</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td rowspan="3" valign="top" >Underscan</td>

<td valign="top" >"underscan"</td>

<td valign="top" >ENUM</td>

<td valign="top" >{ "off", "on", "auto" }</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >"underscan hborder"</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max=128</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >"underscan vborder"</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max=128</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >Audio</td>

<td valign="top" >“audio”</td>

<td valign="top" >ENUM</td>

<td valign="top" >{ "off", "on", "auto" }</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >FMT Dithering</td>

<td valign="top" >“dither”</td>

<td valign="top" >ENUM</td>

<td valign="top" >{ "off", "on" }</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td rowspan="3" valign="top" >rcar-du</td>

<td rowspan="3" valign="top" >Generic</td>

<td valign="top" >"alpha"</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max=255</td>

<td valign="top" >Plane</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >"colorkey"</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max=0x01ffffff</td>

<td valign="top" >Plane</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >"zpos"</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=1, Max=7</td>

<td valign="top" >Plane</td>

<td valign="top" >TBD</td>

</tr>

</tbody>

</table>


+<!-- Graham -->

 <title>Existing KMS Properties</title>


 <para>


   The following table gives description of drm properties



exposed by various

   modules/drivers.


 </para>


 <table>


   <title>Existing KMS Properties</title>


   <tgroup cols="7">


     <thead>


       <row>


         <entry>Owner Module/Drivers</entry>


         <entry>Group</entry>


         <entry>Property Name</entry>


         <entry>Type</entry>


         <entry>Property Values</entry>


         <entry>Object attached</entry>


         <entry>Description/Restrictions</entry>


       </row>


     </thead>


     <tbody valign="top">


     <row>


       <entry morerows="36">DRM</entry>


       <entry>Generic</entry>


       <entry>“rotation”</entry>


       <entry>BITMASK</entry>


       <entry>{ 0, &quot;rotate-0&quot; },


         { 1, &quot;rotate-90&quot; },


         { 2, &quot;rotate-180&quot; },


         { 3, &quot;rotate-270&quot; },


         { 4, &quot;reflect-x&quot; },


         { 5, &quot;reflect-y&quot; }</entry>


       <entry>CRTC, Plane</entry>


       <entry>rotate-(degrees) rotates the image by the



specified amount

         in degrees in counter clockwise direction. reflect-x



and reflect-y

         reflects the image along the specified axis prior to


         rotation</entry>


     </row>


     <row>


       <entry morerows="4" >Connector</entry>


       <entry>“EDID”</entry>


       <entry>BLOB | IMMUTABLE</entry>


       <entry>0</entry>


       <entry>Connector</entry>


       <entry>Contains id of edid blob ptr object.</entry>


     </row>


     <row>


       <entry>“DPMS”</entry>


       <entry>ENUM</entry>


       <entry>{ “On”, “Standby”, “Suspend”, “Off” }</entry>


       <entry>Connector</entry>


       <entry>Contains DPMS operation mode value.</entry>


     </row>


     <row>


       <entry>“PATH”</entry>


       <entry>BLOB | IMMUTABLE</entry>


       <entry>0</entry>


       <entry>Connector</entry>


       <entry>Contains topology path to a connector.</entry>


     </row>


     <row>


       <entry>“TILE”</entry>


       <entry>BLOB | IMMUTABLE</entry>


       <entry>0</entry>


       <entry>Connector</entry>


       <entry>Contains tiling information for a



connector.</entry>

     </row>


     <row>


       <entry>“CRTC_ID”</entry>


       <entry>OBJECT</entry>


       <entry>DRM_MODE_OBJECT_CRTC</entry>


       <entry>Connector</entry>


       <entry>CRTC that connector is attached to



(atomic)</entry>

     </row>


     <row>


       <entry morerows="10">Plane</entry>


       <entry>“type”</entry>


       <entry>ENUM | IMMUTABLE</entry>


       <entry>{ &quot;Overlay&quot;, &quot;Primary&quot;,



&quot;Cursor&quot; }</entry>

       <entry>Plane</entry>


       <entry>Plane type</entry>


     </row>


     <row>


       <entry>“SRC_X”</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max=UINT_MAX</entry>


       <entry>Plane</entry>


       <entry>Scanout source x coordinate in 16.16 fixed



point (atomic)</entry>

     </row>


     <row>


       <entry>“SRC_Y”</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max=UINT_MAX</entry>


       <entry>Plane</entry>


       <entry>Scanout source y coordinate in 16.16 fixed



point (atomic)</entry>

     </row>


     <row>


       <entry>“SRC_W”</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max=UINT_MAX</entry>


       <entry>Plane</entry>


       <entry>Scanout source width in 16.16 fixed point



(atomic)</entry>

     </row>


     <row>


       <entry>“SRC_H”</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max=UINT_MAX</entry>


       <entry>Plane</entry>


       <entry>Scanout source height in 16.16 fixed point



(atomic)</entry>

     </row>


     <row>


       <entry>“CRTC_X”</entry>


       <entry>SIGNED_RANGE</entry>


       <entry>Min=INT_MIN, Max=INT_MAX</entry>


       <entry>Plane</entry>


       <entry>Scanout CRTC (destination) x coordinate



(atomic)</entry>

     </row>


     <row>


       <entry>“CRTC_Y”</entry>


       <entry>SIGNED_RANGE</entry>


       <entry>Min=INT_MIN, Max=INT_MAX</entry>


       <entry>Plane</entry>


       <entry>Scanout CRTC (destination) y coordinate



(atomic)</entry>

     </row>


     <row>


       <entry>“CRTC_W”</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max=UINT_MAX</entry>


       <entry>Plane</entry>


       <entry>Scanout CRTC (destination) width



(atomic)</entry>

     </row>


     <row>


       <entry>“CRTC_H”</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max=UINT_MAX</entry>


       <entry>Plane</entry>


       <entry>Scanout CRTC (destination) height



(atomic)</entry>

     </row>


     <row>


       <entry>“FB_ID”</entry>


       <entry>OBJECT</entry>


       <entry>DRM_MODE_OBJECT_FB</entry>


       <entry>Plane</entry>


       <entry>Scanout framebuffer (atomic)</entry>


     </row>


     <row>


       <entry>“CRTC_ID”</entry>


       <entry>OBJECT</entry>


       <entry>DRM_MODE_OBJECT_CRTC</entry>


       <entry>Plane</entry>


       <entry>CRTC that plane is attached to (atomic)</entry>


     </row>


     <row>


       <entry morerows="1">DVI-I</entry>


       <entry>“subconnector”</entry>


       <entry>ENUM</entry>


       <entry>{ “Unknown”, “DVI-D”, “DVI-A” }</entry>


       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>“select subconnector”</entry>


       <entry>ENUM</entry>


       <entry>{ “Automatic”, “DVI-D”, “DVI-A” }</entry>


       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry morerows="12">TV</entry>


       <entry>“subconnector”</entry>


       <entry>ENUM</entry>


       <entry>{ &quot;Unknown&quot;, &quot;Composite&quot;,



&quot;SVIDEO&quot;, &quot;Component&quot;, &quot;SCART&quot;
}</entry>

       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>“select subconnector”</entry>


       <entry>ENUM</entry>


       <entry>{ &quot;Automatic&quot;, &quot;Composite&quot;,



&quot;SVIDEO&quot;, &quot;Component&quot;, &quot;SCART&quot;
}</entry>

       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>“mode”</entry>


       <entry>ENUM</entry>


       <entry>{ &quot;NTSC_M&quot;, &quot;NTSC_J&quot;,



&quot;NTSC_443&quot;, &quot;PAL_B&quot; } etc.</entry>

       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>“left margin”</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max=100</entry>


       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>“right margin”</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max=100</entry>


       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>“top margin”</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max=100</entry>


       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>“bottom margin”</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max=100</entry>


       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>“brightness”</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max=100</entry>


       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>“contrast”</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max=100</entry>


       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>“flicker reduction”</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max=100</entry>


       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>“overscan”</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max=100</entry>


       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>“saturation”</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max=100</entry>


       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>“hue”</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max=100</entry>


       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry morerows="1">Virtual GPU</entry>


       <entry>“suggested X”</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max=0xffffffff</entry>


       <entry>Connector</entry>


       <entry>property to suggest an X offset for a



connector</entry>

     </row>


     <row>


       <entry>“suggested Y”</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max=0xffffffff</entry>


       <entry>Connector</entry>


       <entry>property to suggest an Y offset for a



connector</entry>

     </row>


     <row>


       <entry morerows="2">Optional</entry>


       <entry>“scaling mode”</entry>


       <entry>ENUM</entry>


       <entry>{ &quot;None&quot;, &quot;Full&quot;,



&quot;Center&quot;, &quot;Full aspect&quot; }</entry>

       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>&quot;aspect ratio&quot;</entry>


       <entry>ENUM</entry>


       <entry>{ &quot;None&quot;, &quot;4:3&quot;,



&quot;16:9&quot; }</entry>

       <entry>Connector</entry>


       <entry>DRM property to set aspect ratio from user



space app.

         This enum is made generic to allow addition of



custom aspect

         ratios.</entry>


     </row>


     <row>


       <entry>“dirty”</entry>


       <entry>ENUM | IMMUTABLE</entry>


       <entry>{ &quot;Off&quot;, &quot;On&quot;,



&quot;Annotate&quot; }</entry>

       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry morerows="19">i915</entry>


       <entry morerows="1">Generic</entry>


       <entry>&quot;Broadcast RGB&quot;</entry>


       <entry>ENUM</entry>


       <entry>{ &quot;Automatic&quot;, &quot;Full&quot;,



&quot;Limited 16:235&quot; }</entry>

       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>“audio”</entry>


       <entry>ENUM</entry>


       <entry>{ &quot;force-dvi&quot;, &quot;off&quot;,



&quot;auto&quot;, &quot;on&quot; }</entry>

       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry morerows="16">SDVO-TV</entry>


       <entry>“mode”</entry>


       <entry>ENUM</entry>


       <entry>{ &quot;NTSC_M&quot;, &quot;NTSC_J&quot;,



&quot;NTSC_443&quot;, &quot;PAL_B&quot; } etc.</entry>

       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>&quot;left_margin&quot;</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max= SDVO dependent</entry>


       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>&quot;right_margin&quot;</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max= SDVO dependent</entry>


       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>&quot;top_margin&quot;</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max= SDVO dependent</entry>


       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>&quot;bottom_margin&quot;</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max= SDVO dependent</entry>


       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>“hpos”</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max= SDVO dependent</entry>


       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>“vpos”</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max= SDVO dependent</entry>


       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>“contrast”</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max= SDVO dependent</entry>


       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>“saturation”</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max= SDVO dependent</entry>


       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>“hue”</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max= SDVO dependent</entry>


       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>“sharpness”</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max= SDVO dependent</entry>


       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>“flicker_filter”</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max= SDVO dependent</entry>


       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>“flicker_filter_adaptive”</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max= SDVO dependent</entry>


       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>“flicker_filter_2d”</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max= SDVO dependent</entry>


       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>“tv_chroma_filter”</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max= SDVO dependent</entry>


       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>“tv_luma_filter”</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max= SDVO dependent</entry>


       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>“dot_crawl”</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max=1</entry>


       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>SDVO-TV/LVDS</entry>


       <entry>“brightness”</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max= SDVO dependent</entry>


       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry morerows="1">CDV gma-500</entry>


       <entry morerows="1">Generic</entry>


       <entry>&quot;Broadcast RGB&quot;</entry>


       <entry>ENUM</entry>


       <entry>{ “Full”, “Limited 16:235” }</entry>


       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>&quot;Broadcast RGB&quot;</entry>


       <entry>ENUM</entry>


       <entry>{ “off”, “auto”, “on” }</entry>


       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry morerows="18">Poulsbo</entry>


       <entry>Generic</entry>


       <entry>“backlight”</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max=100</entry>


       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry morerows="16">SDVO-TV</entry>


       <entry>“mode”</entry>


       <entry>ENUM</entry>


       <entry>{ &quot;NTSC_M&quot;, &quot;NTSC_J&quot;,



&quot;NTSC_443&quot;, &quot;PAL_B&quot; } etc.</entry>

       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>&quot;left_margin&quot;</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max= SDVO dependent</entry>


       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>&quot;right_margin&quot;</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max= SDVO dependent</entry>


       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>&quot;top_margin&quot;</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max= SDVO dependent</entry>


       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>&quot;bottom_margin&quot;</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max= SDVO dependent</entry>


       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>“hpos”</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max= SDVO dependent</entry>


       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>“vpos”</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max= SDVO dependent</entry>


       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>“contrast”</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max= SDVO dependent</entry>


       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>“saturation”</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max= SDVO dependent</entry>


       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>“hue”</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max= SDVO dependent</entry>


       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>“sharpness”</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max= SDVO dependent</entry>


       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>“flicker_filter”</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max= SDVO dependent</entry>


       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>“flicker_filter_adaptive”</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max= SDVO dependent</entry>


       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>“flicker_filter_2d”</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max= SDVO dependent</entry>


       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>“tv_chroma_filter”</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max= SDVO dependent</entry>


       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>“tv_luma_filter”</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max= SDVO dependent</entry>


       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>“dot_crawl”</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max=1</entry>


       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>SDVO-TV/LVDS</entry>


       <entry>“brightness”</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max= SDVO dependent</entry>


       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry morerows="10">armada</entry>


       <entry morerows="1">CRTC</entry>


       <entry>&quot;CSC_YUV&quot;</entry>


       <entry>ENUM</entry>


       <entry>{ &quot;Auto&quot; , &quot;CCIR601&quot;,



&quot;CCIR709&quot; }</entry>

       <entry>CRTC</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>&quot;CSC_RGB&quot;</entry>


       <entry>ENUM</entry>


       <entry>{ &quot;Auto&quot;, &quot;Computer



system&quot;, &quot;Studio&quot; }</entry>

       <entry>CRTC</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry morerows="8">Overlay</entry>


       <entry>&quot;colorkey&quot;</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max=0xffffff</entry>


       <entry>Plane</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>&quot;colorkey_min&quot;</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max=0xffffff</entry>


       <entry>Plane</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>&quot;colorkey_max&quot;</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max=0xffffff</entry>


       <entry>Plane</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>&quot;colorkey_val&quot;</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max=0xffffff</entry>


       <entry>Plane</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>&quot;colorkey_alpha&quot;</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max=0xffffff</entry>


       <entry>Plane</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>&quot;colorkey_mode&quot;</entry>


       <entry>ENUM</entry>


       <entry>{ &quot;disabled&quot;, &quot;Y



component&quot;, &quot;U component&quot;

   , &quot;V component&quot;, &quot;RGB&quot;, “R



component&quot;, &quot;G component&quot;, &quot;B component&quot;
}</entry>

       <entry>Plane</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>&quot;brightness&quot;</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max=256 + 255</entry>


       <entry>Plane</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>&quot;contrast&quot;</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max=0x7fff</entry>


       <entry>Plane</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>&quot;saturation&quot;</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max=0x7fff</entry>


       <entry>Plane</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry morerows="1">exynos</entry>


       <entry>CRTC</entry>


       <entry>“mode”</entry>


       <entry>ENUM</entry>


       <entry>{ &quot;normal&quot;, &quot;blank&quot;



}</entry>

       <entry>CRTC</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>Overlay</entry>


       <entry>“zpos”</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max=MAX_PLANE-1</entry>


       <entry>Plane</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry morerows="1">i2c/ch7006_drv</entry>


       <entry>Generic</entry>


       <entry>“scale”</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max=2</entry>


       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>TV</entry>


       <entry>“mode”</entry>


       <entry>ENUM</entry>


       <entry>{ &quot;PAL&quot;, &quot;PAL-M&quot;,&quot;PAL



-N&quot;}, ”PAL-Nc&quot;

   , &quot;PAL-60&quot;, &quot;NTSC-M&quot;, &quot;NTSC



-J&quot; }</entry>

       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry morerows="14">nouveau</entry>


       <entry morerows="5">NV10 Overlay</entry>


       <entry>&quot;colorkey&quot;</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max=0x01ffffff</entry>


       <entry>Plane</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>“contrast”</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max=8192-1</entry>


       <entry>Plane</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>“brightness”</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max=1024</entry>


       <entry>Plane</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>“hue”</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max=359</entry>


       <entry>Plane</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>“saturation”</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max=8192-1</entry>


       <entry>Plane</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>“iturbt_709”</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max=1</entry>


       <entry>Plane</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry morerows="1">Nv04 Overlay</entry>


       <entry>“colorkey”</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max=0x01ffffff</entry>


       <entry>Plane</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>“brightness”</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max=1024</entry>


       <entry>Plane</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry morerows="6">Display</entry>


       <entry>“dithering mode”</entry>


       <entry>ENUM</entry>


       <entry>{ &quot;auto&quot;, &quot;off&quot;,



&quot;on&quot; }</entry>

       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>“dithering depth”</entry>


       <entry>ENUM</entry>


       <entry>{ &quot;auto&quot;, &quot;off&quot;,



&quot;on&quot;, &quot;static 2x2&quot;, &quot;dynamic 2x2&quot;,
&quot;temporal&quot; }</entry>

       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>“underscan”</entry>


       <entry>ENUM</entry>


       <entry>{ &quot;auto&quot;, &quot;6 bpc&quot;, &quot;8



bpc&quot; }</entry>

       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>“underscan hborder”</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max=128</entry>


       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>“underscan vborder”</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max=128</entry>


       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>“vibrant hue”</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max=180</entry>


       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>“color vibrance”</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max=200</entry>


       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>omap</entry>


       <entry>Generic</entry>


       <entry>“zorder”</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max=3</entry>


       <entry>CRTC, Plane</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>qxl</entry>


       <entry>Generic</entry>


       <entry>“hotplug_mode_update&quot;</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max=1</entry>


       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry morerows="8">radeon</entry>


       <entry>DVI-I</entry>


       <entry>“coherent”</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max=1</entry>


       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>DAC enable load detect</entry>


       <entry>“load detection”</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max=1</entry>


       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>TV Standard</entry>


       <entry>&quot;tv standard&quot;</entry>


       <entry>ENUM</entry>


       <entry>{ &quot;ntsc&quot;, &quot;pal&quot;, &quot;pal



-m&quot;, &quot;pal-60&quot;, &quot;ntsc-j&quot;

   , &quot;scart-pal&quot;, &quot;pal-cn&quot;,



&quot;secam&quot; }</entry>

       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>legacy TMDS PLL detect</entry>


       <entry>&quot;tmds_pll&quot;</entry>


       <entry>ENUM</entry>


       <entry>{ &quot;driver&quot;, &quot;bios&quot;



}</entry>

       <entry>-</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry morerows="2">Underscan</entry>


       <entry>&quot;underscan&quot;</entry>


       <entry>ENUM</entry>


       <entry>{ &quot;off&quot;, &quot;on&quot;,



&quot;auto&quot; }</entry>

       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>&quot;underscan hborder&quot;</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max=128</entry>


       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>&quot;underscan vborder&quot;</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max=128</entry>


       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>Audio</entry>


       <entry>“audio”</entry>


       <entry>ENUM</entry>


       <entry>{ &quot;off&quot;, &quot;on&quot;,



&quot;auto&quot; }</entry>

       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>FMT Dithering</entry>


       <entry>“dither”</entry>


       <entry>ENUM</entry>


       <entry>{ &quot;off&quot;, &quot;on&quot; }</entry>


       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry morerows="2">rcar-du</entry>


       <entry morerows="2">Generic</entry>


       <entry>&quot;alpha&quot;</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max=255</entry>


       <entry>Plane</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>&quot;colorkey&quot;</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max=0x01ffffff</entry>


       <entry>Plane</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>&quot;zpos&quot;</entry>


       <entry>RANGE</entry>


       <entry>Min=1, Max=7</entry>


       <entry>Plane</entry>


       <entry>TBD</entry>


     </row>


   </tbody>


 </tgroup>


</table>


+<!-- Graham -->
     </sect2>
   </sect1>
-- 
2.4.3

Intel-gfx mailing list
Intel-gfx@lists.freedesktop.org
http://lists.freedesktop.org/mailman/listinfo/intel-gfx
-- 
Daniel Vetter
Software Engineer, Intel Corporation
http://blog.ffwll.ch

    

2025

2024

2023

2022

2021

2020

2019

2018

2017

2016

2015

2014

2013

2012

2011

2010

Re: [Intel-gfx] [PATCH 4/5] Documentation: drm: Convert KMS Properties HTML table to CALS

Signed-off-by: Graham Whaley graham.whaley@linux.intel.com

Documentation/DocBook/drm.tmpl | 1866 ++++++++++++++++++++--------