Re: [PATCH v2 1/1] Documentation: drm: describing drm properties exposed by various drivers

6 Mar 2014

On Thu, Mar 06, 2014 at 12:45:25PM +0530, sagar.a.kamble@intel.com wrote:
...
From: Sagar Kamble sagar.a.kamble@intel.com
Started documenting drm properties for drm drivers. This patch provides
information about properties in drm, i915, psb and cdv/gma-500. Information
about other properties can be added on top of these.
v2: Added description of drm properties in armada, exynos, i2c/ch7006, noveau,
omap, qxl, radeon, rcar-du
Looks like dri-devel wasn't cc:d, so I'm adding that...
Thanks for tackling this.
I think one change I would do is drop the "Property Object" column.
It's purely an implementation detail and thus has no bearing on any
ABI/API issues, and there's a risk of it getting stale due to code
changes. It should also make the table a bit less crowded.
Another way to maybe make the table a bit less wide is to drop
the DRM_MODE_PROP_ prefix from the type information. Just saying
BLOB, ENUM, etc. should be enough. But if people prefer to see the
whole type name there, I'm fine with leaving it as is.
With this documentation I can immediately spot several more or less
identical same properties but with slightly different names :( I
really hope we can now start to avoid that mistake by making sure
that people add all new properties to this document. And before
adding a new property people should check the document to see if
something similar might already exist.
...
Cc: Rob Landley rob@landley.net
Cc: Dave Airlie airlied@redhat.com
Cc: Daniel Vetter daniel.vetter@ffwll.ch
Cc: Laurent Pinchart laurent.pinchart+renesas@ideasonboard.com
Cc: David Herrmann dh.herrmann@gmail.com
Cc: Alex Deucher alexander.deucher@amd.com
Cc: "Ville Syrjälä" ville.syrjala@linux.intel.com
Cc: Sagar Kamble sagar.a.kamble@intel.com
Cc: "Purushothaman, Vijay A" vijay.a.purushothaman@intel.com
Cc: linux-doc@vger.kernel.org
Signed-off-by: Sagar Kamble sagar.a.kamble@intel.com
Documentation/DocBook/drm.tmpl | 1163 ++++++++++++++++++++++++++++++++++++++++
 1 file changed, 1163 insertions(+)

diff --git a/Documentation/DocBook/drm.tmpl b/Documentation/DocBook/drm.tmpl
index ed1d6d2..477263e 100644
--- a/Documentation/DocBook/drm.tmpl
+++ b/Documentation/DocBook/drm.tmpl
@@ -2317,6 +2317,1169 @@ void intel_crt_init(struct drm_device *dev)
       pointer to the target object, a pointer to the previously created property
       and an initial instance value.
     </para>

<para>

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 Object</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="19" valign="top" >DRM</td>
+<td rowspan="2" valign="top" >Generic Properties</td>
+<td valign="top" >edid_property</td>
+<td valign="top" >“EDID”</td>
+<td valign="top" >DRM_MODE_PROP_BLOB | DRM_MODE_PROP_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_property</td>
+<td valign="top" >“DPMS”</td>
+<td valign="top" >DRM_MODE_PROP_ENUM</td>
+<td valign="top" >{ DRM_MODE_DPMS_ON, “On”},
+{ DRM_MODE_DPMS_STANDBY, “Standby”},
+{ DRM_MODE_DPMS_SUSPEND, “Suspend”},
+{ DRM_MODE_DPMS_OFF, “Off”}</td>
+<td valign="top" >Connector</td>
+<td valign="top" >Contains DPMS operation mode value.</td>
+</tr>



+<tr>
+<td rowspan="2" valign="top" >DVI-I Properties</td>
+<td valign="top" >dvi_i_subconnector_property</td>
+<td valign="top" >“subconnector”</td>
+<td valign="top" >DRM_MODE_PROP_ENUM</td>
+<td valign="top" >{ DRM_MODE_SUBCONNECTOR_Unknown, “Unknown”},
+{ DRM_MODE_SUBCONNECTOR_DVID, “DVI-D”},
+{ DRM_MODE_SUBCONNECTOR_DVIA, “DVI-A”}</td>
+<td valign="top" >Connector</td>
+<td valign="top" >TBD</td>
+</tr>



+<tr>
+<td valign="top" >dvi_i_select_subconnector_property</td>
+<td valign="top" >“select subconnector”</td>
+<td valign="top" >DRM_MODE_PROP_ENUM</td>
+<td valign="top" >{ DRM_MODE_SUBCONNECTOR_Automatic, “Automatic”},
+{ DRM_MODE_SUBCONNECTOR_DVID, “DVI-D”},
+{ DRM_MODE_SUBCONNECTOR_DVIA, “DVI-A”}</td>
+<td valign="top" >Connector</td>
+<td valign="top" >TBD</td>
+</tr>



+<tr>
+<td rowspan="13" valign="top" >TV Properties</td>
+<td valign="top" >tv_subconnector_property</td>
+<td valign="top" >“subconnector”</td>
+<td valign="top" >DRM_MODE_PROP_ENUM</td>
+<td valign="top" >{ DRM_MODE_SUBCONNECTOR_Unknown, "Unknown"},
+{ DRM_MODE_SUBCONNECTOR_Composite, "Composite" },
+{ DRM_MODE_SUBCONNECTOR_SVIDEO, "SVIDEO"},
+{ DRM_MODE_SUBCONNECTOR_Component , "Component"},
+{ DRM_MODE_SUBCONNECTOR_SCART, "SCART"}</td>
+<td valign="top" >Connector</td>
+<td valign="top" >TBD</td>
+</tr>



+<tr>
+<td valign="top" >tv_select_subconnector_property</td>
+<td valign="top" >“select subconnector”</td>
+<td valign="top" >DRM_MODE_PROP_ENUM</td>
+<td valign="top" >{DRM_MODE_SUBCONNECTOR_Automatic, "Automatic"},
+{DRM_MODE_SUBCONNECTOR_Composite, "Composite"},
+{DRM_MODE_SUBCONNECTOR_SVIDEO, "SVIDEO"},
+{DRM_MODE_SUBCONNECTOR_Component, "Component"},
+{DRM_MODE_SUBCONNECTOR_SCART, "SCART"}</td>
+<td valign="top" >Connector</td>
+<td valign="top" >TBD</td>
+</tr>



+<tr>
+<td valign="top" >tv_mode_property</td>
+<td valign="top" >“mode”</td>
+<td valign="top" >DRM_MODE_PROP_ENUM</td>
+<td valign="top" >{0, "NTSC_M"} , {1, "NTSC_J"} ,
+{2, "NTSC_443"}, {3, "PAL_B"} etc.</td>
+<td valign="top" >Connector</td>
+<td valign="top" >TBD</td>
+</tr>



+<tr>
+<td valign="top" >tv_left_margin_property</td>
+<td valign="top" >“left margin”</td>
+<td valign="top" >DRM_MODE_PROP_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" >tv_right_margin_property</td>
+<td valign="top" >“right margin”</td>
+<td valign="top" >DRM_MODE_PROP_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" >tv_top_margin_property</td>
+<td valign="top" >“top margin”</td>
+<td valign="top" >DRM_MODE_PROP_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" >tv_bottom_margin_property</td>
+<td valign="top" >“bottom margin”</td>
+<td valign="top" >DRM_MODE_PROP_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" >tv_brightness_property</td>
+<td valign="top" >“brightness”</td>
+<td valign="top" >DRM_MODE_PROP_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" >tv_contrast_property</td>
+<td valign="top" >“contrast”</td>
+<td valign="top" >DRM_MODE_PROP_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" >tv_flicker_reduction_property</td>
+<td valign="top" >“flicker reduction”</td>
+<td valign="top" >DRM_MODE_PROP_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" >tv_overscan_property</td>
+<td valign="top" >“overscan”</td>
+<td valign="top" >DRM_MODE_PROP_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" >tv_saturation_property</td>
+<td valign="top" >“saturation”</td>
+<td valign="top" >DRM_MODE_PROP_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" >tv_hue_property</td>
+<td valign="top" >“hue”</td>
+<td valign="top" >DRM_MODE_PROP_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" >Optional Properties</td>
+<td valign="top" >scaling_mode_property</td>
+<td valign="top" >“scaling mode”</td>
+<td valign="top" >DRM_MODE_PROP_ENUM</td>
+<td valign="top" >{ DRM_MODE_SCALE_NONE, "None" },
+{ DRM_MODE_SCALE_FULLSCREEN, "Full" },
+{ DRM_MODE_SCALE_CENTER, "Center" },
+{ DRM_MODE_SCALE_ASPECT, "Full aspect" }</td>
+<td valign="top" >Connector</td>
+<td valign="top" >TBD</td>
+</tr>



+<tr>
+<td valign="top" >dirty_info_property</td>
+<td valign="top" >“dirty”</td>
+<td valign="top" >DRM_MODE_PROP_ENUM | DRM_MODE_PROP_IMMUTABLE</td>
+<td valign="top" >{ DRM_MODE_DIRTY_OFF, "Off" },
+{ DRM_MODE_DIRTY_ON, "On" },
+{ DRM_MODE_DIRTY_ANNOTATE, "Annotate" }</td>
+<td valign="top" >Connector</td>
+<td valign="top" >TBD</td>
+</tr>



+<tr>
+<td rowspan="21" valign="top">i915</td>
+<td rowspan="3" valign="top">Generic</td>
+<td valign="top" >broadcast_rgb_property</td>
+<td valign="top" >"Broadcast RGB"</td>
+<td valign="top" >DRM_MODE_PROP_ENUM</td>
+<td valign="top" >{ INTEL_BROADCAST_RGB_AUTO, "Automatic" },
+{ INTEL_BROADCAST_RGB_FULL, "Full" },
+{ INTEL_BROADCAST_RGB_LIMITED, "Limited 16:235" }</td>
+<td valign="top" >Connector</td>
+<td valign="top" >TBD</td>
+</tr>



+<tr>
+<td valign="top" >force_audio_property</td>
+<td valign="top" >“audio”</td>
+<td valign="top" >DRM_MODE_PROP_ENUM</td>
+<td valign="top" >{ HDMI_AUDIO_OFF_DVI, "force-dvi" },
+{ HDMI_AUDIO_OFF, "off" },
+{ HDMI_AUDIO_AUTO, "auto" },
+{ HDMI_AUDIO_ON, "on" }</td>
+<td valign="top" >Connector</td>
+<td valign="top" >TBD</td>
+</tr>



+<tr>
+<td valign="top" >scaling_mode_property



+</td>
+<td valign="top" >Standard name as in DRM</td>
+<td valign="top" >Standard type as in DRM</td>
+<td valign="top" >Standard value as in DRM</td>
+<td valign="top" >Standard Object as in DRM</td>
+<td valign="top" >TBD</td>
+</tr>



+<tr>
+<td rowspan="17" valign="top">SDVO-TV</td>
+<td valign="top" >tv_format</td>
+<td valign="top" >“mode”</td>
+<td valign="top" >DRM_MODE_PROP_ENUM</td>
+<td valign="top" >{0, "NTSC_M"} , {1, "NTSC_J"} ,
+{2, "NTSC_443"}, {3, "PAL_B"} etc.</td>
+<td valign="top" >Connector</td>
+<td valign="top" >TBD</td>
+</tr>



+<tr>
+<td valign="top" >left</td>
+<td valign="top" >"left_margin"</td>
+<td valign="top" >DRM_MODE_PROP_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</td>
+<td valign="top" >"right_margin"</td>
+<td valign="top" >DRM_MODE_PROP_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</td>
+<td valign="top" >"top_margin"</td>
+<td valign="top" >DRM_MODE_PROP_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</td>
+<td valign="top" >"bottom_margin"</td>
+<td valign="top" >DRM_MODE_PROP_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" >“hpos”</td>
+<td valign="top" >DRM_MODE_PROP_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" >“vpos”</td>
+<td valign="top" >DRM_MODE_PROP_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" >“contrast”</td>
+<td valign="top" >DRM_MODE_PROP_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" >“saturation”</td>
+<td valign="top" >DRM_MODE_PROP_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" >“hue”</td>
+<td valign="top" >DRM_MODE_PROP_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" >“sharpness”</td>
+<td valign="top" >DRM_MODE_PROP_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" >“flicker_filter”</td>
+<td valign="top" >DRM_MODE_PROP_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" >“flicker_filter_adaptive”</td>
+<td valign="top" >DRM_MODE_PROP_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" >“flicker_filter_2d”</td>
+<td valign="top" >DRM_MODE_PROP_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" >“tv_chroma_filter”</td>
+<td valign="top" >DRM_MODE_PROP_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" >“tv_luma_filter”</td>
+<td valign="top" >DRM_MODE_PROP_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" >“dot_crawl”</td>
+<td valign="top" >DRM_MODE_PROP_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" >“brightness”</td>
+<td valign="top" >DRM_MODE_PROP_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="3" valign="top">CDV gma-500</td>
+<td rowspan="3" valign="top">Generic</td>
+<td valign="top" >broadcast_rgb_property</td>
+<td valign="top" >"Broadcast RGB"</td>
+<td valign="top" >DRM_MODE_PROP_ENUM</td>
+<td valign="top" >{ 0, “Full”},
+{ 1, “Limited 16:235”}</td>
+<td valign="top" >Connector</td>
+<td valign="top" >TBD</td>
+</tr>



+<tr>
+<td valign="top" >force_audio_property</td>
+<td valign="top" >"Broadcast RGB"</td>
+<td valign="top" >DRM_MODE_PROP_ENUM</td>
+<td valign="top" >{ -1, “off”},
+{ 0, “auto”},
+{ 1, “on”}</td>
+<td valign="top" >Connector</td>
+<td valign="top" >TBD</td>
+</tr>



+<tr>
+<td valign="top" >scaling_mode_property



+</td>
+<td valign="top" >Standard name as in DRM</td>
+<td valign="top" >Standard type as in DRM</td>
+<td valign="top" >Standard value as in DRM</td>
+<td valign="top" >Standard Object as in DRM</td>
+<td valign="top" >TBD</td>
+</tr>



+<tr>
+<td rowspan="20" valign="top">Poulsbo</td>
+<td rowspan="2" valign="top">Generic</td>
+<td valign="top" >backlight_property</td>
+<td valign="top" >“backlight”</td>
+<td valign="top" >DRM_MODE_PROP_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" >scaling_mode_property



+</td>
+<td valign="top" >Standard name as in DRM</td>
+<td valign="top" >Standard type as in DRM</td>
+<td valign="top" >Standard value as in DRM</td>
+<td valign="top" >Standard Object as in DRM</td>
+<td valign="top" >TBD</td>
+</tr>



+<tr>
+<td rowspan="17" valign="top">SDVO-TV</td>
+<td valign="top" >tv_format</td>
+<td valign="top" >“mode”</td>
+<td valign="top" >DRM_MODE_PROP_ENUM</td>
+<td valign="top" >{0, "NTSC_M"} , {1, "NTSC_J"} ,



+{2, "NTSC_443"}, {3, "PAL_B"} etc.</td>
+<td valign="top" >Connector</td>
+<td valign="top" >TBD</td>
+</tr>



+<tr>
+<td valign="top" >left</td>
+<td valign="top" >"left_margin"</td>
+<td valign="top" >DRM_MODE_PROP_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</td>
+<td valign="top" >"right_margin"</td>
+<td valign="top" >DRM_MODE_PROP_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</td>
+<td valign="top" >"top_margin"</td>
+<td valign="top" >DRM_MODE_PROP_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</td>
+<td valign="top" >"bottom_margin"</td>
+<td valign="top" >DRM_MODE_PROP_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" >“hpos”</td>
+<td valign="top" >DRM_MODE_PROP_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" >“vpos”</td>
+<td valign="top" >DRM_MODE_PROP_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" >“contrast”</td>
+<td valign="top" >DRM_MODE_PROP_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" >“saturation”</td>
+<td valign="top" >DRM_MODE_PROP_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" >“hue”</td>
+<td valign="top" >DRM_MODE_PROP_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" >“sharpness”</td>
+<td valign="top" >DRM_MODE_PROP_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" >“flicker_filter”</td>
+<td valign="top" >DRM_MODE_PROP_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" >“flicker_filter_adaptive”</td>
+<td valign="top" >DRM_MODE_PROP_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" >“flicker_filter_2d”</td>
+<td valign="top" >DRM_MODE_PROP_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" >“tv_chroma_filter”</td>
+<td valign="top" >DRM_MODE_PROP_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" >“tv_luma_filter”</td>
+<td valign="top" >DRM_MODE_PROP_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" >“dot_crawl”</td>
+<td valign="top" >DRM_MODE_PROP_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" >“brightness”</td>
+<td valign="top" >DRM_MODE_PROP_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_prop</td>
+<td valign="top" >"CSC_YUV"</td>
+<td valign="top" >DRM_MODE_PROP_ENUM</td>
+<td valign="top" >{ CSC_AUTO, "Auto" },
+{ CSC_YUV_CCIR601, "CCIR601" },
+{ CSC_YUV_CCIR709, "CCIR709" }</td>
+<td valign="top" >CRTC</td>
+<td valign="top" >TBD</td>
+</tr>



+<tr>
+<td valign="top" >csc_rgb_prop</td>
+<td valign="top" >"CSC_RGB"</td>
+<td valign="top" >DRM_MODE_PROP_ENUM</td>
+<td valign="top" >{ CSC_AUTO, "Auto" },
+{ CSC_RGB_COMPUTER, "Computer system" },
+{ CSC_RGB_STUDIO, "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_prop</td>
+<td valign="top" >"colorkey"</td>
+<td valign="top" >DRM_MODE_PROP_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_prop</td>
+<td valign="top" >"colorkey_min"</td>
+<td valign="top" >DRM_MODE_PROP_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_prop</td>
+<td valign="top" >"colorkey_max"</td>
+<td valign="top" >DRM_MODE_PROP_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_prop</td>
+<td valign="top" >"colorkey_val"</td>
+<td valign="top" >DRM_MODE_PROP_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_prop</td>
+<td valign="top" >"colorkey_alpha"</td>
+<td valign="top" >DRM_MODE_PROP_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_prop</td>
+<td valign="top" >"colorkey_mode"</td>
+<td valign="top" >DRM_MODE_PROP_ENUM</td>
+<td valign="top" >{ CKMODE_DISABLE, "disabled" },
+{ CKMODE_Y, "Y component" },
+{ CKMODE_U, "U component" },
+{ CKMODE_V, "V component" },
+{ CKMODE_RGB, "RGB" },
+{ CKMODE_R, “R component" },
+{ CKMODE_G, "G component" },
+{ CKMODE_B, "B component" }</td>
+<td valign="top" >Plane</td>
+<td valign="top" >TBD</td>
+</tr>



+<tr>
+<td valign="top" >brightness_prop</td>
+<td valign="top" >"brightness"</td>
+<td valign="top" >DRM_MODE_PROP_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_prop</td>
+<td valign="top" >"contrast"</td>
+<td valign="top" >DRM_MODE_PROP_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_prop</td>
+<td valign="top" >"saturation"</td>
+<td valign="top" >DRM_MODE_PROP_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" >crtc_mode_property</td>
+<td valign="top" >“mode”</td>
+<td valign="top" >DRM_MODE_PROP_ENUM</td>
+<td valign="top" >{ CRTC_MODE_NORMAL, "normal" },
+{ CRTC_MODE_BLANK, "blank" }</td>
+<td valign="top" >CRTC</td>
+<td valign="top" >TBD</td>
+</tr>



+<tr>
+<td valign="top">Overlay</td>
+<td valign="top" >plane_zpos_property</td>
+<td valign="top" >“zpos”</td>
+<td valign="top" >DRM_MODE_PROP_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="3" valign="top">i2c/ch7006_drv</td>
+<td valign="top">Generic</td>
+<td valign="top" >scale_property</td>
+<td valign="top" >“scale”</td>
+<td valign="top" >DRM_MODE_PROP_RANGE</td>
+<td valign="top" >Min=0, Max=2</td>
+<td valign="top" >Connector</td>
+<td valign="top" >TBD</td>
+</tr>



+<tr>
+<td rowspan="2" valign="top">TV-Properties</td>
+<td valign="top" >left,
+right,
+top,
+bottom,
+hpos,
+vpos,
+contrast,
+saturation,
+hue,
+sharpness,
+flicker_filter,
+flicker_filter_adaptive,
+flicker_filter_2d,
+tv_chroma_filter,
+tv_luma_filter,
+dot_crawl,</td>
+<td valign="top" >Standard names as in DRM</td>
+<td valign="top" >Standard types as in DRM</td>
+<td valign="top" >Standard Values as in DRM</td>
+<td valign="top" >Standard object as in DRM</td>
+<td valign="top" >TBD</td>
+</tr>



+<tr>
+<td valign="top" >tv_format</td>
+<td valign="top" >“mode”</td>
+<td valign="top" >DRM_MODE_PROP_ENUM</td>
+<td valign="top" >{0, "PAL"}, {1, "PAL-M"}, {2,"PAL-N"},
+{2,”PAL-Nc"}, {3, "PAL-60"}, {4, "NTSC-M"},
+{5,"NTSC-J"}</td>
+<td valign="top" >Connector</td>
+<td valign="top" >TBD</td>
+</tr>



+<tr>
+<td rowspan="16" valign="top">noveau</td>
+<td rowspan="6" valign="top">NV10 Overlay</td>
+<td valign="top" >colorkey</td>
+<td valign="top" >"colorkey"</td>
+<td valign="top" >DRM_MODE_PROP_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" >“contrast”</td>
+<td valign="top" >DRM_MODE_PROP_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" >“brightness”</td>
+<td valign="top" >DRM_MODE_PROP_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" >“hue”</td>
+<td valign="top" >DRM_MODE_PROP_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" >“saturation”</td>
+<td valign="top" >DRM_MODE_PROP_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" >“iturbt_709”</td>
+<td valign="top" >DRM_MODE_PROP_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" >“colorkey”</td>
+<td valign="top" >DRM_MODE_PROP_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" >“brightness”</td>
+<td valign="top" >DRM_MODE_PROP_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" >“dithering mode”</td>
+<td valign="top" >DRM_MODE_PROP_ENUM</td>
+<td valign="top" >Custom values which has gen info as well.
+{ 6, UNDERSCAN_AUTO, "auto" },
+{ 6, UNDERSCAN_OFF, "off" },
+{ 6, UNDERSCAN_ON, "on" }</td>
+<td valign="top" >Connector</td>
+<td valign="top" >TBD</td>
+</tr>



+<tr>
+<td valign="top" >dithering_depth</td>
+<td valign="top" >“dithering depth”</td>
+<td valign="top" >DRM_MODE_PROP_ENUM</td>
+<td valign="top" >Custom values which has gen info as well.
+{ 7, DITHERING_MODE_AUTO, "auto" },
+{ 7, DITHERING_MODE_OFF, "off" },
+{ 1, DITHERING_MODE_ON, "on" },
+{ 6, DITHERING_MODE_STATIC2X2, "static 2x2" },
+{ 6, DITHERING_MODE_DYNAMIC2X2, "dynamic 2x2" },
+{ 4, DITHERING_MODE_TEMPORAL, "temporal" }</td>
+<td valign="top" >Connector</td>
+<td valign="top" >TBD</td>
+</tr>



+<tr>
+<td valign="top" >underscan_property</td>
+<td valign="top" >“underscan”</td>
+<td valign="top" >DRM_MODE_PROP_ENUM</td>
+<td valign="top" >Custom values which has gen info as well.
+{ 6, DITHERING_DEPTH_AUTO, "auto" },
+{ 6, DITHERING_DEPTH_6BPC, "6 bpc" },
+{ 6, DITHERING_DEPTH_8BPC, "8 bpc" }</td>
+<td valign="top" >Connector</td>
+<td valign="top" >TBD</td>
+</tr>



+<tr>
+<td valign="top" >underscan_hborder_property</td>
+<td valign="top" >“underscan hborder”</td>
+<td valign="top" >DRM_MODE_PROP_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_property</td>
+<td valign="top" >“underscan vborder”</td>
+<td valign="top" >DRM_MODE_PROP_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_property</td>
+<td valign="top" >“vibrant hue”</td>
+<td valign="top" >DRM_MODE_PROP_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_property</td>
+<td valign="top" >“color vibrance”</td>
+<td valign="top" >DRM_MODE_PROP_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">Generic</td>
+<td valign="top" >scaling_mode_property



+</td>
+<td valign="top" >Standard name as in DRM</td>
+<td valign="top" >Standard type as in DRM</td>
+<td valign="top" >Standard value as in DRM</td>
+<td valign="top" >Standard Object as in DRM</td>
+<td valign="top" >TBD</td>
+</tr>



+<tr>
+<td rowspan="2" valign="top">omap</td>
+<td rowspan="2" valign="top">Generic</td>
+<td valign="top" >rotation_prop</td>
+<td valign="top" >“rotation”</td>
+<td valign="top" >DRM_MODE_PROP_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" >TBD</td>
+</tr>



+<tr>
+<td valign="top" >zorder_prop</td>
+<td valign="top" >“zorder”</td>
+<td valign="top" >DRM_MODE_PROP_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_property</td>
+<td valign="top" >“hotplug_mode_update"</td>
+<td valign="top" >DRM_MODE_PROP_RANGE</td>
+<td valign="top" >Min=0, Max=1</td>
+<td valign="top" >Connector</td>
+<td valign="top" >TBD</td>
+</tr>



+<tr>
+<td rowspan="10" valign="top">radeon</td>
+<td valign="top">DVI-I</td>
+<td valign="top" >coherent_mode_property</td>
+<td valign="top" >“coherent”</td>
+<td valign="top" >DRM_MODE_PROP_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_detect_property</td>
+<td valign="top" >“load detection”</td>
+<td valign="top" >DRM_MODE_PROP_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_std_property</td>
+<td valign="top" >"tv standard"</td>
+<td valign="top" >DRM_MODE_PROP_ENUM</td>
+<td valign="top" >{ TV_STD_NTSC, "ntsc" },
+{ TV_STD_PAL, "pal" },
+{ TV_STD_PAL_M, "pal-m" },
+{ TV_STD_PAL_60, "pal-60" },
+{ TV_STD_NTSC_J, "ntsc-j" },
+{ TV_STD_SCART_PAL, "scart-pal" },
+{ TV_STD_PAL_CN, "pal-cn" },
+{ TV_STD_SECAM, "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_property</td>
+<td valign="top" >"tmds_pll"</td>
+<td valign="top" >DRM_MODE_PROP_ENUM</td>
+<td valign="top" >{ 0, "driver" },
+{ 1, "bios" }</td>
+<td valign="top" >-</td>
+<td valign="top" >TBD</td>
+</tr>



+<tr>
+<td rowspan="3" valign="top">Underscan</td>
+<td valign="top" >underscan_property</td>
+<td valign="top" >"underscan"</td>
+<td valign="top" >DRM_MODE_PROP_ENUM</td>
+<td valign="top" >{ UNDERSCAN_OFF, "off" },
+{ UNDERSCAN_ON, "on" },
+{ UNDERSCAN_AUTO, "auto" }</td>
+<td valign="top" >Connector</td>
+<td valign="top" >TBD</td>
+</tr>



+<tr>
+<td valign="top" >underscan_hborder_property</td>
+<td valign="top" >"underscan hborder"</td>
+<td valign="top" >DRM_MODE_PROP_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_property</td>
+<td valign="top" >"underscan vborder"</td>
+<td valign="top" >DRM_MODE_PROP_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_property</td>
+<td valign="top" >“audio”</td>
+<td valign="top" >DRM_MODE_PROP_ENUM</td>
+<td valign="top" >{ RADEON_AUDIO_DISABLE, "off" },
+{ RADEON_AUDIO_ENABLE, "on" },
+{ RADEON_AUDIO_AUTO, "auto" }</td>
+<td valign="top" >Connector</td>
+<td valign="top" >TBD</td>
+</tr>



+<tr>
+<td valign="top">FMT Dithering</td>
+<td valign="top" >dither_property</td>
+<td valign="top" >“dither”</td>
+<td valign="top" >DRM_MODE_PROP_ENUM</td>
+<td valign="top" >{ RADEON_FMT_DITHER_DISABLE, "off" },
+{ RADEON_FMT_DITHER_ENABLE, "on" }</td>
+<td valign="top" >Connector</td>
+<td valign="top" >TBD</td>
+</tr>



+<tr>
+<td valign="top">Generic</td>
+<td valign="top" >scaling_mode_property



+</td>
+<td valign="top" >Standard name as in DRM</td>
+<td valign="top" >Standard type as in DRM</td>
+<td valign="top" >Standard value as in DRM</td>
+<td valign="top" >Standard Object as in DRM</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" >"alpha"</td>
+<td valign="top" >DRM_MODE_PROP_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" >"colorkey"</td>
+<td valign="top" >DRM_MODE_PROP_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" >"zpos"</td>
+<td valign="top" >DRM_MODE_PROP_RANGE</td>
+<td valign="top" >Min=1, Max=7</td>
+<td valign="top" >Plane</td>
+<td valign="top" >TBD</td>
+</tr>



+</tbody>
+</table>
   </sect1>
   <!-- Internals: vertical blanking -->
-- 
1.8.5
-- 
Ville Syrjälä
Intel OTC

    

2025

2024

2023

2022

2021

2020

2019

2018

2017

2016

2015

2014

2013

2012

2011

2010

Re: [PATCH v2 1/1] Documentation: drm: describing drm properties exposed by various drivers

Signed-off-by: Sagar Kamble sagar.a.kamble@intel.com