From patchwork Sat Mar 8 06:33:20 2014 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: sagar.a.kamble@intel.com X-Patchwork-Id: 3797251 Return-Path: X-Original-To: patchwork-dri-devel@patchwork.kernel.org Delivered-To: patchwork-parsemail@patchwork1.web.kernel.org Received: from mail.kernel.org (mail.kernel.org [198.145.19.201]) by patchwork1.web.kernel.org (Postfix) with ESMTP id C6D2F9F1CD for ; Sat, 8 Mar 2014 06:32:40 +0000 (UTC) Received: from mail.kernel.org (localhost [127.0.0.1]) by mail.kernel.org (Postfix) with ESMTP id B39C320306 for ; Sat, 8 Mar 2014 06:32:38 +0000 (UTC) Received: from gabe.freedesktop.org (gabe.freedesktop.org [131.252.210.177]) by mail.kernel.org (Postfix) with ESMTP id 56073202E9 for ; Sat, 8 Mar 2014 06:32:36 +0000 (UTC) Received: from gabe.freedesktop.org (localhost [127.0.0.1]) by gabe.freedesktop.org (Postfix) with ESMTP id 16A8EFAD3B; Fri, 7 Mar 2014 22:32:32 -0800 (PST) X-Original-To: dri-devel@lists.freedesktop.org Delivered-To: dri-devel@lists.freedesktop.org Received: from mga09.intel.com (mga09.intel.com [134.134.136.24]) by gabe.freedesktop.org (Postfix) with ESMTP id 87EADFAD3B; Fri, 7 Mar 2014 22:32:29 -0800 (PST) Received: from orsmga002.jf.intel.com ([10.7.209.21]) by orsmga102.jf.intel.com with ESMTP; 07 Mar 2014 22:28:01 -0800 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="4.97,613,1389772800"; d="scan'208";a="496230296" Received: from sagar-desktop.iind.intel.com ([10.223.82.31]) by orsmga002.jf.intel.com with ESMTP; 07 Mar 2014 22:32:24 -0800 From: sagar.a.kamble@intel.com To: intel-gfx@lists.freedesktop.org Subject: [PATCH v4 1/1] Documentation: drm: describing drm properties exposed by various drivers Date: Sat, 8 Mar 2014 12:03:20 +0530 Message-Id: <1394260400-7104-1-git-send-email-sagar.a.kamble@intel.com> X-Mailer: git-send-email 1.8.5 In-Reply-To: <1394116069-18603-1-git-send-email-sagar.a.kamble@intel.com> References: <1394116069-18603-1-git-send-email-sagar.a.kamble@intel.com> MIME-Version: 1.0 Cc: Laurent Pinchart , linux-doc@vger.kernel.org, Daniel Vetter , dri-devel@lists.freedesktop.org, "Purushothaman, Vijay A" , Rob Landley , Alex Deucher , Dave Airlie , Sagar Kamble X-BeenThere: dri-devel@lists.freedesktop.org X-Mailman-Version: 2.1.13 Precedence: list List-Id: Direct Rendering Infrastructure - Development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: dri-devel-bounces@lists.freedesktop.org Errors-To: dri-devel-bounces@lists.freedesktop.org X-Spam-Status: No, score=-4.2 required=5.0 tests=BAYES_00, RCVD_IN_DNSWL_MED, T_RP_MATCHES_RCVD, UNPARSEABLE_RELAY autolearn=unavailable version=3.3.1 X-Spam-Checker-Version: SpamAssassin 3.3.1 (2010-03-16) on mail.kernel.org X-Virus-Scanned: ClamAV using ClamSMTP From: Sagar Kamble 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 v3: Removed "Property Object" column since it is implementation related. Property type column refined.[Ville's review comments] v4: Removed whitespace warnings and minor nits. Cc: Rob Landley Cc: Dave Airlie Cc: Daniel Vetter Cc: Laurent Pinchart Cc: David Herrmann Cc: Alex Deucher Cc: "Ville Syrjälä" Cc: Sagar Kamble Cc: "Purushothaman, Vijay A" Cc: linux-doc@vger.kernel.org Cc: dri-devel@lists.freedesktop.org Signed-off-by: Sagar Kamble --- Documentation/DocBook/drm.tmpl | 913 +++++++++++++++++++++++++++++++++++++++++ 1 file changed, 913 insertions(+) diff --git a/Documentation/DocBook/drm.tmpl b/Documentation/DocBook/drm.tmpl index ed1d6d2..b810c77 100644 --- a/Documentation/DocBook/drm.tmpl +++ b/Documentation/DocBook/drm.tmpl @@ -2317,6 +2317,919 @@ 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. + + The following table gives description of drm properties exposed by various + modules/drivers. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Owner Module/DriversGroupProperty NameTypeProperty ValuesObject attachedDescription/Restrictions
DRMGeneric“EDID”BLOB | IMMUTABLE0ConnectorContains id of edid blob ptr object.
“DPMS”ENUM{ DRM_MODE_DPMS_ON, “On”}, +{ DRM_MODE_DPMS_STANDBY, “Standby”}, +{ DRM_MODE_DPMS_SUSPEND, “Suspend”}, +{ DRM_MODE_DPMS_OFF, “Off”}ConnectorContains DPMS operation mode value.
DVI-I“subconnector”ENUM{ DRM_MODE_SUBCONNECTOR_Unknown, “Unknown”}, +{ DRM_MODE_SUBCONNECTOR_DVID, “DVI-D”}, +{ DRM_MODE_SUBCONNECTOR_DVIA, “DVI-A”}ConnectorTBD
“select subconnector”ENUM{ DRM_MODE_SUBCONNECTOR_Automatic, “Automatic”}, +{ DRM_MODE_SUBCONNECTOR_DVID, “DVI-D”}, +{ DRM_MODE_SUBCONNECTOR_DVIA, “DVI-A”}ConnectorTBD
TV“subconnector”ENUM{ 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"}ConnectorTBD
“select subconnector”ENUM{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"}ConnectorTBD
“mode”ENUM{0, "NTSC_M"} , {1, "NTSC_J"} , +{2, "NTSC_443"}, {3, "PAL_B"} etc.ConnectorTBD
“left margin”RANGEMin=0, Max=100ConnectorTBD
“right margin”RANGEMin=0, Max=100ConnectorTBD
“top margin”RANGEMin=0, Max=100ConnectorTBD
“bottom margin”RANGEMin=0, Max=100ConnectorTBD
“brightness”RANGEMin=0, Max=100ConnectorTBD
“contrast”RANGEMin=0, Max=100ConnectorTBD
“flicker reduction”RANGEMin=0, Max=100ConnectorTBD
“overscan”RANGEMin=0, Max=100ConnectorTBD
“saturation”RANGEMin=0, Max=100ConnectorTBD
“hue”RANGEMin=0, Max=100ConnectorTBD
Optional“scaling mode”ENUM{ DRM_MODE_SCALE_NONE, "None" }, +{ DRM_MODE_SCALE_FULLSCREEN, "Full" }, +{ DRM_MODE_SCALE_CENTER, "Center" }, +{ DRM_MODE_SCALE_ASPECT, "Full aspect" }ConnectorTBD
“dirty”ENUM | IMMUTABLE{ DRM_MODE_DIRTY_OFF, "Off" }, +{ DRM_MODE_DIRTY_ON, "On" }, +{ DRM_MODE_DIRTY_ANNOTATE, "Annotate" }ConnectorTBD
i915Generic"Broadcast RGB"ENUM{ INTEL_BROADCAST_RGB_AUTO, "Automatic" }, +{ INTEL_BROADCAST_RGB_FULL, "Full" }, +{ INTEL_BROADCAST_RGB_LIMITED, "Limited 16:235" }ConnectorTBD
“audio”ENUM{ HDMI_AUDIO_OFF_DVI, "force-dvi" }, +{ HDMI_AUDIO_OFF, "off" }, +{ HDMI_AUDIO_AUTO, "auto" }, +{ HDMI_AUDIO_ON, "on" }ConnectorTBD
Standard name as in DRMStandard type as in DRMStandard value as in DRMStandard Object as in DRMTBD
SDVO-TV“mode”ENUM{0, "NTSC_M"} , {1, "NTSC_J"} , +{2, "NTSC_443"}, {3, "PAL_B"} etc.ConnectorTBD
"left_margin"RANGEMin=0, Max= SDVO dependentConnectorTBD
"right_margin"RANGEMin=0, Max= SDVO dependentConnectorTBD
"top_margin"RANGEMin=0, Max= SDVO dependentConnectorTBD
"bottom_margin"RANGEMin=0, Max= SDVO dependentConnectorTBD
“hpos”RANGEMin=0, Max= SDVO dependentConnectorTBD
“vpos”RANGEMin=0, Max= SDVO dependentConnectorTBD
“contrast”RANGEMin=0, Max= SDVO dependentConnectorTBD
“saturation”RANGEMin=0, Max= SDVO dependentConnectorTBD
“hue”RANGEMin=0, Max= SDVO dependentConnectorTBD
“sharpness”RANGEMin=0, Max= SDVO dependentConnectorTBD
“flicker_filter”RANGEMin=0, Max= SDVO dependentConnectorTBD
“flicker_filter_adaptive”RANGEMin=0, Max= SDVO dependentConnectorTBD
“flicker_filter_2d”RANGEMin=0, Max= SDVO dependentConnectorTBD
“tv_chroma_filter”RANGEMin=0, Max= SDVO dependentConnectorTBD
“tv_luma_filter”RANGEMin=0, Max= SDVO dependentConnectorTBD
“dot_crawl”RANGEMin=0, Max=1ConnectorTBD
SDVO-TV/LVDS“brightness”RANGEMin=0, Max= SDVO dependentConnectorTBD
CDV gma-500Generic"Broadcast RGB"ENUM{ 0, “Full”}, +{ 1, “Limited 16:235”}ConnectorTBD
"Broadcast RGB"ENUM{ -1, “off”}, +{ 0, “auto”}, +{ 1, “on”}ConnectorTBD
Standard name as in DRMStandard type as in DRMStandard value as in DRMStandard Object as in DRMTBD
PoulsboGeneric“backlight”RANGEMin=0, Max=100ConnectorTBD
Standard name as in DRMStandard type as in DRMStandard value as in DRMStandard Object as in DRMTBD
SDVO-TV“mode”ENUM{0, "NTSC_M"} , {1, "NTSC_J"} , +{2, "NTSC_443"}, {3, "PAL_B"} etc.ConnectorTBD
"left_margin"RANGEMin=0, Max= SDVO dependentConnectorTBD
"right_margin"RANGEMin=0, Max= SDVO dependentConnectorTBD
"top_margin"RANGEMin=0, Max= SDVO dependentConnectorTBD
"bottom_margin"RANGEMin=0, Max= SDVO dependentConnectorTBD
“hpos”RANGEMin=0, Max= SDVO dependentConnectorTBD
“vpos”RANGEMin=0, Max= SDVO dependentConnectorTBD
“contrast”RANGEMin=0, Max= SDVO dependentConnectorTBD
“saturation”RANGEMin=0, Max= SDVO dependentConnectorTBD
“hue”RANGEMin=0, Max= SDVO dependentConnectorTBD
“sharpness”RANGEMin=0, Max= SDVO dependentConnectorTBD
“flicker_filter”RANGEMin=0, Max= SDVO dependentConnectorTBD
“flicker_filter_adaptive”RANGEMin=0, Max= SDVO dependentConnectorTBD
“flicker_filter_2d”RANGEMin=0, Max= SDVO dependentConnectorTBD
“tv_chroma_filter”RANGEMin=0, Max= SDVO dependentConnectorTBD
“tv_luma_filter”RANGEMin=0, Max= SDVO dependentConnectorTBD
“dot_crawl”RANGEMin=0, Max=1ConnectorTBD
SDVO-TV/LVDS“brightness”RANGEMin=0, Max= SDVO dependentConnectorTBD
armadaCRTC"CSC_YUV"ENUM{ CSC_AUTO, "Auto" }, +{ CSC_YUV_CCIR601, "CCIR601" }, +{ CSC_YUV_CCIR709, "CCIR709" }CRTCTBD
"CSC_RGB"ENUM{ CSC_AUTO, "Auto" }, +{ CSC_RGB_COMPUTER, "Computer system" }, +{ CSC_RGB_STUDIO, "Studio" }CRTCTBD
Overlay"colorkey"RANGEMin=0, Max=0xffffffPlaneTBD
"colorkey_min"RANGEMin=0, Max=0xffffffPlaneTBD
"colorkey_max"RANGEMin=0, Max=0xffffffPlaneTBD
"colorkey_val"RANGEMin=0, Max=0xffffffPlaneTBD
"colorkey_alpha"RANGEMin=0, Max=0xffffffPlaneTBD
"colorkey_mode"ENUM{ 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" }PlaneTBD
"brightness"RANGEMin=0, Max=256 + 255PlaneTBD
"contrast"RANGEMin=0, Max=0x7fffPlaneTBD
"saturation"RANGEMin=0, Max=0x7fffPlaneTBD
exynosCRTC“mode”ENUM{ CRTC_MODE_NORMAL, "normal" }, +{ CRTC_MODE_BLANK, "blank" }CRTCTBD
Overlay“zpos”RANGEMin=0, Max=MAX_PLANE-1PlaneTBD
i2c/ch7006_drvGeneric“scale”RANGEMin=0, Max=2ConnectorTBD
TVStandard names as in DRMStandard types as in DRMStandard Values as in DRMStandard object as in DRMTBD
“mode”ENUM{0, "PAL"}, {1, "PAL-M"}, {2,"PAL-N"}, +{2,”PAL-Nc"}, {3, "PAL-60"}, {4, "NTSC-M"}, +{5,"NTSC-J"}ConnectorTBD
noveauNV10 Overlay"colorkey"RANGEMin=0, Max=0x01ffffffPlaneTBD
“contrast”RANGEMin=0, Max=8192-1PlaneTBD
“brightness”RANGEMin=0, Max=1024PlaneTBD
“hue”RANGEMin=0, Max=359PlaneTBD
“saturation”RANGEMin=0, Max=8192-1PlaneTBD
“iturbt_709”RANGEMin=0, Max=1PlaneTBD
Nv04 Overlay“colorkey”RANGEMin=0, Max=0x01ffffffPlaneTBD
“brightness”RANGEMin=0, Max=1024PlaneTBD
Display“dithering mode”ENUMCustom values which has gen info as well. +{ 6, UNDERSCAN_AUTO, "auto" }, +{ 6, UNDERSCAN_OFF, "off" }, +{ 6, UNDERSCAN_ON, "on" }ConnectorTBD
“dithering depth”ENUMCustom 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" }ConnectorTBD
“underscan”ENUMCustom values which has gen info as well. +{ 6, DITHERING_DEPTH_AUTO, "auto" }, +{ 6, DITHERING_DEPTH_6BPC, "6 bpc" }, +{ 6, DITHERING_DEPTH_8BPC, "8 bpc" }ConnectorTBD
“underscan hborder”RANGEMin=0, Max=128ConnectorTBD
“underscan vborder”RANGEMin=0, Max=128ConnectorTBD
“vibrant hue”RANGEMin=0, Max=180ConnectorTBD
“color vibrance”RANGEMin=0, Max=200ConnectorTBD
GenericStandard name as in DRMStandard type as in DRMStandard value as in DRMStandard Object as in DRMTBD
omapGeneric“rotation”BITMASK{ 0, "rotate-0" }, +{ 1, "rotate-90" }, +{ 2, "rotate-180" }, +{ 3, "rotate-270" }, +{ 4, "reflect-x" }, +{ 5, "reflect-y" }CRTC, PlaneTBD
“zorder”RANGEMin=0, Max=3CRTC, PlaneTBD
qxlGeneric“hotplug_mode_update"RANGEMin=0, Max=1ConnectorTBD
radeonDVI-I“coherent”RANGEMin=0, Max=1ConnectorTBD
DAC enable load detect“load detection”RANGEMin=0, Max=1ConnectorTBD
TV Standard"tv standard"ENUM{ 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" }ConnectorTBD
legacy TMDS PLL detect"tmds_pll"ENUM{ 0, "driver" }, +{ 1, "bios" }-TBD
Underscan"underscan"ENUM{ UNDERSCAN_OFF, "off" }, +{ UNDERSCAN_ON, "on" }, +{ UNDERSCAN_AUTO, "auto" }ConnectorTBD
"underscan hborder"RANGEMin=0, Max=128ConnectorTBD
"underscan vborder"RANGEMin=0, Max=128ConnectorTBD
Audio“audio”ENUM{ RADEON_AUDIO_DISABLE, "off" }, +{ RADEON_AUDIO_ENABLE, "on" }, +{ RADEON_AUDIO_AUTO, "auto" }ConnectorTBD
FMT Dithering“dither”ENUM{ RADEON_FMT_DITHER_DISABLE, "off" }, +{ RADEON_FMT_DITHER_ENABLE, "on" }ConnectorTBD
GenericStandard name as in DRMStandard type as in DRMStandard value as in DRMStandard Object as in DRMTBD
rcar-duGeneric"alpha"RANGEMin=0, Max=255PlaneTBD
"colorkey"RANGEMin=0, Max=0x01ffffffPlaneTBD
"zpos"RANGEMin=1, Max=7PlaneTBD