include/drm/i915_mei_hdcp_interface.h

   1 /* SPDX-License-Identifier: (GPL-2.0+) */
   2 /*
   3  * Copyright © 2017-2018 Intel Corporation
   4  *
   5  * Authors:
   6  * Ramalingam C <ramalingam.c@intel.com>
   7  */
   8
   9 #ifndef _I915_MEI_HDCP_INTERFACE_H_
  10 #define _I915_MEI_HDCP_INTERFACE_H_
  11
  12 #include <linux/mutex.h>
  13 #include <linux/device.h>
  14 #include <drm/drm_hdcp.h>
  15 #include <drm/i915_drm.h>
  16
  17 /**
  18  * enum hdcp_port_type - HDCP port implementation type defined by ME FW
  19  * @HDCP_PORT_TYPE_INVALID: Invalid hdcp port type
  20  * @HDCP_PORT_TYPE_INTEGRATED: In-Host HDCP2.x port
  21  * @HDCP_PORT_TYPE_LSPCON: HDCP2.2 discrete wired Tx port with LSPCON
  22  *                         (HDMI 2.0) solution
  23  * @HDCP_PORT_TYPE_CPDP: HDCP2.2 discrete wired Tx port using the CPDP (DP 1.3)
  24  *                       solution
  25  */
  26 enum hdcp_port_type {
  27         HDCP_PORT_TYPE_INVALID,
  28         HDCP_PORT_TYPE_INTEGRATED,
  29         HDCP_PORT_TYPE_LSPCON,
  30         HDCP_PORT_TYPE_CPDP
  31 };
  32
  33 /**
  34  * enum hdcp_wired_protocol - HDCP adaptation used on the port
  35  * @HDCP_PROTOCOL_INVALID: Invalid HDCP adaptation protocol
  36  * @HDCP_PROTOCOL_HDMI: HDMI adaptation of HDCP used on the port
  37  * @HDCP_PROTOCOL_DP: DP adaptation of HDCP used on the port
  38  */
  39 enum hdcp_wired_protocol {
  40         HDCP_PROTOCOL_INVALID,
  41         HDCP_PROTOCOL_HDMI,
  42         HDCP_PROTOCOL_DP
  43 };
  44
  45 /**
  46  * struct hdcp_port_data - intel specific HDCP port data
  47  * @port: port index as per I915
  48  * @port_type: HDCP port type as per ME FW classification
  49  * @protocol: HDCP adaptation as per ME FW
  50  * @k: No of streams transmitted on a port. Only on DP MST this is != 1
  51  * @seq_num_m: Count of RepeaterAuth_Stream_Manage msg propagated.
  52  *             Initialized to 0 on AKE_INIT. Incremented after every successful
  53  *             transmission of RepeaterAuth_Stream_Manage message. When it rolls
  54  *             over re-Auth has to be triggered.
  55  * @streams: struct hdcp2_streamid_type[k]. Defines the type and id for the
  56  *           streams
  57  */
  58 struct hdcp_port_data {
  59         enum port port;
  60         u8 port_type;
  61         u8 protocol;
  62         u16 k;
  63         u32 seq_num_m;
  64         struct hdcp2_streamid_type *streams;
  65 };
  66
  67 /**
  68  * struct i915_hdcp_component_ops- ops for HDCP2.2 services.
  69  * @owner: Module providing the ops
  70  * @initiate_hdcp2_session: Initiate a Wired HDCP2.2 Tx Session.
  71  *                          And Prepare AKE_Init.
  72  * @verify_receiver_cert_prepare_km: Verify the Receiver Certificate
  73  *                                   AKE_Send_Cert and prepare
  74                                      AKE_Stored_Km/AKE_No_Stored_Km
  75  * @verify_hprime: Verify AKE_Send_H_prime
  76  * @store_pairing_info: Store pairing info received
  77  * @initiate_locality_check: Prepare LC_Init
  78  * @verify_lprime: Verify lprime
  79  * @get_session_key: Prepare SKE_Send_Eks
  80  * @repeater_check_flow_prepare_ack: Validate the Downstream topology
  81  *                                   and prepare rep_ack
  82  * @verify_mprime: Verify mprime
  83  * @enable_hdcp_authentication:  Mark a port as authenticated.
  84  * @close_hdcp_session: Close the Wired HDCP Tx session per port.
  85  *                      This also disables the authenticated state of the port.
  86  */
  87 struct i915_hdcp_component_ops {
  88         /**
  89          * @owner: mei_hdcp module
  90          */
  91         struct module *owner;
  92
  93         int (*initiate_hdcp2_session)(struct device *dev,
  94                                       struct hdcp_port_data *data,
  95                                       struct hdcp2_ake_init *ake_data);
  96         int (*verify_receiver_cert_prepare_km)(struct device *dev,
  97                                                struct hdcp_port_data *data,
  98                                                struct hdcp2_ake_send_cert
  99                                                                 *rx_cert,
 100                                                bool *km_stored,
 101                                                struct hdcp2_ake_no_stored_km
 102                                                                 *ek_pub_km,
 103                                                size_t *msg_sz);
 104         int (*verify_hprime)(struct device *dev,
 105                              struct hdcp_port_data *data,
 106                              struct hdcp2_ake_send_hprime *rx_hprime);
 107         int (*store_pairing_info)(struct device *dev,
 108                                   struct hdcp_port_data *data,
 109                                   struct hdcp2_ake_send_pairing_info
 110                                                                 *pairing_info);
 111         int (*initiate_locality_check)(struct device *dev,
 112                                        struct hdcp_port_data *data,
 113                                        struct hdcp2_lc_init *lc_init_data);
 114         int (*verify_lprime)(struct device *dev,
 115                              struct hdcp_port_data *data,
 116                              struct hdcp2_lc_send_lprime *rx_lprime);
 117         int (*get_session_key)(struct device *dev,
 118                                struct hdcp_port_data *data,
 119                                struct hdcp2_ske_send_eks *ske_data);
 120         int (*repeater_check_flow_prepare_ack)(struct device *dev,
 121                                                struct hdcp_port_data *data,
 122                                                struct hdcp2_rep_send_receiverid_list
 123                                                                 *rep_topology,
 124                                                struct hdcp2_rep_send_ack
 125                                                                 *rep_send_ack);
 126         int (*verify_mprime)(struct device *dev,
 127                              struct hdcp_port_data *data,
 128                              struct hdcp2_rep_stream_ready *stream_ready);
 129         int (*enable_hdcp_authentication)(struct device *dev,
 130                                           struct hdcp_port_data *data);
 131         int (*close_hdcp_session)(struct device *dev,
 132                                   struct hdcp_port_data *data);
 133 };
 134
 135 /**
 136  * struct i915_hdcp_component_master - Used for communication between i915
 137  * and mei_hdcp drivers for the HDCP2.2 services
 138  * @mei_dev: device that provide the HDCP2.2 service from MEI Bus.
 139  * @hdcp_ops: Ops implemented by mei_hdcp driver, used by i915 driver.
 140  */
 141 struct i915_hdcp_comp_master {
 142         struct device *mei_dev;
 143         const struct i915_hdcp_component_ops *ops;
 144
 145         /* To protect the above members. */
 146         struct mutex mutex;
 147 };
 148
 149 #endif /* _I915_MEI_HDCP_INTERFACE_H_ */