<html>
  <head>
    <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
  </head>
  <body text="#000000" bgcolor="#FFFFFF">
    <p><tt>Hi all,<br>
        <br>
        As we discussed in this review thread before, "UNSUPPORTED"
        state is added to the HDCP property to indicate a situation when
        HDCP is not possible, though hdcp property is attached to
        connector obj. In such case I would prefer to detach the hdcp
        property from connector, which would have been clear indication
        of no support. Since that is not possible at present in our
        kernel, I have added this state in the property.<br>
        <br>
        In v4 of the uAPI RFC, </tt><tt><tt>"UNSUPPORTED" state of Enum
          is assigned with</tt> "-1", so that it doesn't alter the
        existing CrOS user space HDCP uAPI states {UNDESIRED=0,
        DESIRED=1, ENABLED=2}. Current CrOS User space need not change
        anything to use proposed uAPI. v4 of this uAPI RFC posted should
        be compatible for downstream uAPI of CrOS. So in current state
        of CrOS user space, as usual it can set the property for DESIRED
        for enabling the HDCP. But it will be rejected as no HDCP is
        possible in the platform. Please share if there is any concern.
        This can be removed as it is not a compulsory state for
        functionality.<br>
      </tt></p>
    <p><tt>Multiple questions are asked in off line discussions, on why
        can't we make uAPI as HDCP version agnostic. Sharing the
        reasoning with community, so that we all can be on same page.</tt></p>
    <p><tt>For first phase of HDCP2.2 development, uAPI proposed is
        version agnostic. Thats the reason we are able to use the CrOS's
        HDCP1.4 support as user space consumer for Phase 1. But in Phase
        2 when we enable complete HDCP2.2 spec in kernel along with
        required user space consumer, uAPI will be extended to support
        required interface. Such uAPI extension will expose the
        platforms HDCP v2.2 capability to the user, and in some cases,
        allows the users to mandate the HDCP v2.2 encryption only for
        their content. I am bringing this up as we need community
        agreement for this second phase of uAPI also. Reasoning for such
        extension is as follow:<br>
        <br>
        HDCPv2.2 Spec provides an option to the content provider, to tag
        a stream, such that it will be given to HDCP2.2(or latest)
        compliant devices only through out the distribution chain. This
        tagging is nothing but calling the stream as Type 1. </tt><tt><tt>In
          Other words, Type 1 streams are always encrypted with
          HDCPv2.2. </tt>This stream type info will be passed </tt><tt><tt>to
          the All HDCP2.2 sinks </tt>as part of authentication. So that
        sinks such as repeaters/converters wont be transmitting the
        received encrypted stream to the HDCP device which is
        non-compliant with HDCP V2.2.<br>
      </tt></p>
    <p><tt>If a stream can be distributed to HDCP1.4 compliant devices
        also, that is tagged as Type 0. Refer the below diagram for
        pictorial representation for flow of encrypted stream tagged as
        Type 0 and 1. <br>
      </tt></p>
    <p><br>
    </p>
    <p><tt>       
        +-----------+                                                   
        HDCP v2.2 protected<br>
                | HDCP v2.2 |                       Type 0
        Content                  Type 1 Content<br>
                |Transmitter|                          flow
        path                       flow path<br>
                +-----+-----+<br>
                      |                                   
        |                               |<br>
                      | v2.2 link                         
        |                               |<br>
                      v                                   
        v                               v<br>
                 +----+----+                              
        |                               |<br>
                 |HDCP v2.2|                              
        |                               |<br>
                 | Repeater|                              
        |                               |<br>
                 +--+---+--+                              
        |                               |<br>
                    |   |                               
        +-+-+                           +-+<br>
         v2.2 link  |   |    v1.4 link                   |  
        |                           |<br>
             +------+   +-------+                 +------+  
        +-------+            +------+<br>
             |                  |                 |                 
        |            |<br>
             v                  v                 v                 
        v            v<br>
        +----+----+        +----+----+<br>
        |HDCP v2.2|        |HDCP v1.4|<br>
        |  Panel  |        |  Panel  |<br>
        +---------+        +---------+</tt></p>
    <p><tt><br>
      </tt></p>
    <p><tt>Note: none of the protected content streams Type0/1 will be
        shared to panels which are non HDCP compliant.</tt></p>
    <p><tt>We need uAPI to pass the type of stream from user space to
        kernel because:<br>
      </tt></p>
    <ol>
      <li><tt>When Digital Right Management(DRM) wants HDCP2.2
          encryption, it will tag the stream as Type 0/1.</tt></li>
      <li><tt>One of the parameter for encryption formula of HDCP v2.2
          is this Type info. So Type classification of stream defined by
          DRM should be passed to kernel.<br>
        </tt></li>
      <li><tt>Many content providers(DRM) want their content to be
          encrypted only in V2.2, as v1.4 is already compromised. To
          fulfill such </tt><tt><tt>requirement, we need to expose the
            capability of HDCP v2.2 to user space and also interface to
            set such </tt>requirement to kernel. Adding option to set
          type info of stream clears both requirements.<br>
        </tt></li>
    </ol>
    <tt>Option 1: All of the above requirements can be fulfilled just by
      adding a property state to a existing hdcp property to represent
      the type info of the stream. such as {UNDESIRED, DESIRED, ENABLED,
      TYPE1_DESIRED, TYPE1_ENABLED}.</tt><br>
    <tt>Option 2: Assume still we prefer HDCP version agnostic uAPI, as
    </tt><tt><tt>Enum property with {UNDESIRED, DESIRED, ENABLED}</tt>.
      For HDCP enable request, latest HDCP version supported will be
      invoked for encryption. When the latest version capable is v2.2,
      still we have to pass the type info along with version agnostic
      enable request, through separate HDCP ver2.2+ specific Enum
      property as {TYPE0, TYPE1}.<br>
      <br>
      Bottom line is For HDCP v2.2 either way we need to pass the Type
      info from user space to kernel.<br>
      <br>
      If there is a concern or doubt about this interface requirement
      please express it here.<br>
    </tt>
    <p><tt>Example of protected content provider, who mandates the HDCP
        v2.2 encryption only is </tt><tt>Netflix. It imposes that 4k
        content can be played only on HDCP2.2 HDMI monitors.</tt></p>
    <br>
    <div class="moz-cite-prefix">On Wednesday 02 August 2017 09:23 PM,
      Ramalingam C wrote:<br>
    </div>
    <blockquote type="cite"
      cite="mid:1501689185-24949-1-git-send-email-ramalingam.c@intel.com">
      <pre wrap="">Default connector property called "Content Protection" is added to
represent the content protection state of a connector and to
configure the same.

Userspace can request for enable or disable of content protection
on a connector. Set "DESIRED" for Enable and "UNDESIRED" for disable.

Content protection states defined:
        DRM_MODE_CONTENT_PROTECTION_UNSUPPORTED         - Unsupported
        DRM_MODE_CONTENT_PROTECTION_UNDESIRED           - Undesired
        DRM_MODE_CONTENT_PROTECTION_DESIRED             - Desired
        DRM_MODE_CONTENT_PROTECTION_ENABLED             - Enabled

v2: Redesigned the property to match with CP needs of CrOS [Sean].
v3: Renamed the state names. Header is removed [Sean].
v4: Aligned with existing userspace(CrOS's usage) [Sean].

Signed-off-by: Ramalingam C <a class="moz-txt-link-rfc2396E" href="mailto:ramalingam.c@intel.com"><ramalingam.c@intel.com></a>
---
 drivers/gpu/drm/drm_connector.c | 24 ++++++++++++++++++++++++
 include/drm/drm_mode_config.h   |  5 +++++
 include/uapi/drm/drm_mode.h     |  7 +++++++
 3 files changed, 36 insertions(+)

diff --git a/drivers/gpu/drm/drm_connector.c b/drivers/gpu/drm/drm_connector.c
index 8072e6e4c62c..f4ce0af63ad3 100644
--- a/drivers/gpu/drm/drm_connector.c
+++ b/drivers/gpu/drm/drm_connector.c
@@ -617,6 +617,14 @@ static const struct drm_prop_enum_list drm_link_status_enum_list[] = {
 };
 DRM_ENUM_NAME_FN(drm_get_link_status_name, drm_link_status_enum_list)
 
+static const struct drm_prop_enum_list drm_cp_enum_list[] = {
+       { DRM_MODE_CONTENT_PROTECTION_UNSUPPORTED,      "Unsupported" },
+       { DRM_MODE_CONTENT_PROTECTION_UNDESIRED,        "Undesired" },
+       { DRM_MODE_CONTENT_PROTECTION_DESIRED,          "Desired" },
+       { DRM_MODE_CONTENT_PROTECTION_ENABLED,          "Enabled" },
+};
+DRM_ENUM_NAME_FN(drm_get_cp_status_name, drm_cp_enum_list)
+
 /**
  * drm_display_info_set_bus_formats - set the supported bus formats
  * @info: display info to store bus formats in
@@ -741,6 +749,15 @@ DRM_ENUM_NAME_FN(drm_get_tv_subconnector_name,
  *      value of link-status is "GOOD". If something fails during or after modeset,
  *      the kernel driver may set this to "BAD" and issue a hotplug uevent. Drivers
  *      should update this value using drm_mode_connector_set_link_status_property().
+ * Content Protection:
+ *      Connector Content Protection property to indicate the content protection
+ *      status of a connector. Default value is "UNDESIRED". Kernel will set
+ *      to "UNSUPPORTED" if there is no common HDCP ver supported between Src
+ *      and Sink. User space could set this to "DESIRED" to enabled the content
+ *      protection on the connector. If content protection setup process is
+ *      success, kernel will set this property to "ENABLED". To Disable the
+ *      content protection on the connector userspace could set this property to
+ *      "UNDESIRED".
  *
  * Connectors also have one standardized atomic property:
  *
@@ -789,6 +806,13 @@ int drm_connector_create_standard_properties(struct drm_device *dev)
                return -ENOMEM;
        dev->mode_config.link_status_property = prop;
 
+       prop = drm_property_create_enum(dev, 0, "Content Protection",
+                                       drm_cp_enum_list,
+                                       ARRAY_SIZE(drm_cp_enum_list));
+       if (!prop)
+               return -ENOMEM;
+       dev->mode_config.cp_property = prop;
+
        return 0;
 }
 
diff --git a/include/drm/drm_mode_config.h b/include/drm/drm_mode_config.h
index 42981711189b..72e2b4e6d51d 100644
--- a/include/drm/drm_mode_config.h
+++ b/include/drm/drm_mode_config.h
@@ -538,6 +538,11 @@ struct drm_mode_config {
         */
        struct drm_property *link_status_property;
        /**
+        * @cp_property: Default connector property for content protection
+        * status of a connector
+        */
+       struct drm_property *cp_property;
+       /**
         * @plane_type_property: Default plane property to differentiate
         * CURSOR, PRIMARY and OVERLAY legacy uses of planes.
         */
diff --git a/include/uapi/drm/drm_mode.h b/include/uapi/drm/drm_mode.h
index 403339f98a92..61685a64cd6a 100644
--- a/include/uapi/drm/drm_mode.h
+++ b/include/uapi/drm/drm_mode.h
@@ -173,6 +173,13 @@ extern "C" {
                DRM_MODE_REFLECT_X | \
                DRM_MODE_REFLECT_Y)
 
+/* Content Protection options */
+enum cp_state {
+       DRM_MODE_CONTENT_PROTECTION_UNSUPPORTED = -1,
+       DRM_MODE_CONTENT_PROTECTION_UNDESIRED,
+       DRM_MODE_CONTENT_PROTECTION_DESIRED,
+       DRM_MODE_CONTENT_PROTECTION_ENABLED,
+};
 
 struct drm_mode_modeinfo {
        __u32 clock;
</pre>
    </blockquote>
    <br>
    <pre class="moz-signature" cols="72">-- 
Regards,
--Ram.</pre>
  </body>
</html>