Skip to content

GitLab

T
tangled
Commit 049107b2 authored by Jeffrey Kardatzke's avatar Jeffrey Kardatzke Committed by Commit Bot
Browse files
Options

Add third_party/libva_protected_content 

This is an additional header file for using libva in protected content
mode that was supplied by Intel. This will not be merged into libva
directly as it pertains to closed source functionality in the iHD
driver. libva is able to pass through these details without knowing
about them.

BUG=b:153111783
TEST=None

Change-Id: I10759537cd653e9a541b30931c6474c014dbb256
Reviewed-on: https://chromium-review.googlesource.com/c/chromium/src/+/2523100Reviewed-by: default avatarJohn Abd-El-Malek <jam@chromium.org>
Commit-Queue: Jeffrey Kardatzke <jkardatzke@google.com>
Cr-Commit-Position: refs/heads/master@{#825379}
parent 6e8f1f65
Show whitespace changes
Inline Side-by-side
Showing with 554 additions and 0 deletions
third_party/libva_protected_content/LICENSE 0 → 100644
View file @ 049107b2
Permission is hereby granted, free of charge, to any person obtaining a
copy of this software and associated documentation files (the
"Software"), to deal in the Software without restriction, including
without limitation the rights to use, copy, modify, merge, publish,
distribute, sub license, and/or sell copies of the Software, and to
permit persons to whom the Software is furnished to do so, subject to
the following conditions:
The above copyright notice and this permission notice (including the
next paragraph) shall be included in all copies or substantial portions
of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT.
IN NO EVENT SHALL PRECISION INSIGHT AND/OR ITS SUPPLIERS BE LIABLE FOR
ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
third_party/libva_protected_content/OWNERS 0 → 100644
View file @ 049107b2
jkardatzke@chromium.org
marcheu@chromium.org
third_party/libva_protected_content/README.chromium 0 → 100644
View file @ 049107b2
Name: Protected Content Interface for libva
Short Name: libva_protected_content
Version: 2.9.0
Date: 2020-11-02
License: MIT
License File: LICENSE
Security Critical: no
Description:
This contains a header file supplied by Intel that is used for protected content
functionality with libva. All the functional pieces are contained within libva
and the corresponding driver implementation beneath libva. The entrypoints,
attributes and buffers defined here are passed through by libva to the driver
implementation which utilizes these as part of a closed source implementation
for Chrome OS for playing back protected content.
\ No newline at end of file
third_party/libva_protected_content/va_protected_content.h 0 → 100644
View file @ 049107b2
/*
* Copyright (c) 2018-2020 Intel Corporation. All Rights Reserved.
*
* Permission is hereby granted, free of charge, to any person obtaining a
* copy of this software and associated documentation files (the
* "Software"), to deal in the Software without restriction, including
* without limitation the rights to use, copy, modify, merge, publish,
* distribute, sub license, and/or sell copies of the Software, and to
* permit persons to whom the Software is furnished to do so, subject to
* the following conditions:
*
* The above copyright notice and this permission notice (including the
* next paragraph) shall be included in all copies or substantial portions
* of the Software.
*
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
* OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
* MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT.
* IN NO EVENT SHALL INTEL AND/OR ITS SUPPLIERS BE LIABLE FOR
* ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
* TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
* SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
*/
/**
* \file va_protected_content.h
* \brief Protection content general interface
*
* This file contains the \ref api_protected_content "Protected Content
* Interface".
*/
#ifndef VA_PROTECTED_CONTENT_H
#define VA_PROTECTED_CONTENT_H
#include <stdint.h>
#include <va/va.h>
#ifdef __cplusplus
extern "C" {
#endif
/**
* \defgroup api_intel Protected Content(PC) API
*
* @{
*/
/**
*
* A protected content function for processing cipher protected content.
*
**/
#define VAEntrypointProtectedContent ((VAEntrypoint)0x1000)
/**
* \brief Cipher algorithm of the protected session.
*
* This attribute specifies the cipher algorithm of the protected session. It
* could be AES, etc.... It depends on IHV's implementation.
*/
#define VAConfigAttribProtectedContentCipherAlgorithm \
((VAConfigAttribType)0x10003)
/**
* \brief Cipher block size of the protected session.
*
* This attribute specifies the block size of the protected session. It could be
* 128, 192, or 256. It depends on IHV's implementation.
*/
#define VAConfigAttribProtectedContentCipherBlockSize \
((VAConfigAttribType)0x10004)
/**
* \brief Cipher mode of the protected session.
*
* This attribute specifies the cipher mode of the protected session. It could
* be CBC, CTR, etc... It depends on IHV's implementation.
*/
#define VAConfigAttribProtectedContentCipherMode ((VAConfigAttribType)0x10005)
/**
* \brief Decryption sample type of the protected session.
*
* This attribute specifies the decryption sample type of the protected session.
* It could be fullsample or subsample. It depends on IHV's implementation.
*/
#define VAConfigAttribProtectedContentCipherSampleType \
((VAConfigAttribType)0x10006)
/**
* \brief Special usage attribute of the protected session.
*
* The attribute specifies the flow for the protected session could be used. For
* example, it could be Widevine usages or something else. It dpends on IHV's
* implementation.
*/
#define VAConfigAttribProtectedContentUsage ((VAConfigAttribType)0x10007)
/** \brief Encryption parameters buffer for content protection usage */
#define VAEncryptionParameterBufferType ((VABufferType)0x20001)
/**\brief CENC status paramter, used for vendor content protection only.
* The buffer corresponds to #VACencStatusParameters for va/cp*/
#define VACencStatusParameterBufferType ((VABufferType)0x20002)
/** attribute values for VAConfigAttribEncryption */
#define VA_ENCRYPTION_TYPE_NONE 0x00000000
#define VA_ENCRYPTION_TYPE_CENC_CBC 0x00000002
#define VA_ENCRYPTION_TYPE_CENC_CTR 0x00000008
#define VA_ENCRYPTION_TYPE_CTR_128 0x00000010
#define VA_ENCRYPTION_TYPE_CBC 0x00000020
/** attribute values for VAConfigAttribContentProtectionSessionMode */
#define VA_PC_SESSION_MODE_NONE 0x00000000
/** attribute values for VAConfigAttribContentProtectionSessionType */
#define VA_PC_SESSION_TYPE_NONE 0x00000000
/** attribute values for VAConfigAttribContentProtectionCipherAlgorithm */
#define VA_PC_CIPHER_AES 0x00000001
/** attribute values for VAConfigAttribContentProtectionCipherBlockSize */
#define VA_PC_BLOCK_SIZE_128 0x00000001
#define VA_PC_BLOCK_SIZE_256 0x00000004
/** attribute values for VAConfigAttribContentProtectionCipherMode */
#define VA_PC_CIPHER_MODE_CBC 0x00000002
#define VA_PC_CIPHER_MODE_CTR 0x00000004
/** attribute values for VAConfigAttribContentProtectionUsage */
#define VA_PC_USAGE_DEFAULT 0x00000000
/** attribute values for VAConfigAttribContentProtectionCipherSampleType */
#define VA_PC_SAMPLE_TYPE_FULLSAMPLE 0x00000001
#define VA_PC_SAMPLE_TYPE_SUBSAMPLE 0x00000002
/** \brief TeeExec Function Codes. */
typedef enum _VA_TEE_EXEC_FUNCTION_ID {
VA_TEE_EXEC_TEE_FUNCID_PASS_THROUGH_NONE = 0x0,
// 0x40000000~0x400000FFF reserved for TEE Exec GPU function
VA_TEE_EXEC_GPU_FUNCID_ENCRYPTION_BLT = 0x40000000,
VA_TEE_EXEC_GPU_FUNCID_DECRYPTION_BLT = 0x40000001,
// 0x40001000~0x400001FFF reserved for TEE Exec TEE function
VA_TEE_EXEC_TEE_FUNCID_PASS_THROUGH = 0x40001000,
} VA_TEE_EXEC_FUNCTION_ID;
/** \brief values for the encryption return status. */
typedef enum {
/** \brief Indicate encryption operation is successful.*/
VA_ENCRYPTION_STATUS_SUCCESSFUL = 0,
/** \brief Indicate encryption operation is incomplete. */
VA_ENCRYPTION_STATUS_INCOMPLETE,
/** \brief Indicate encryption operation is error.*/
VA_ENCRYPTION_STATUS_ERROR,
/** \brief Indicate the buf in VACencStatusBuf is full. */
VA_ENCRYPTION_STATUS_BUFFER_FULL,
/** \brief Indicate encryption operation is unsupport. */
VA_ENCRYPTION_STATUS_UNSUPPORT
} VAEncryptionStatus;
/** \brief structure for encrypted segment info. */
typedef struct _VAEncryptionSegmentInfo {
/** \brief The offset relative to the start of the bitstream input in
* bytes of the start of the segment*/
uint32_t segment_start_offset;
/** \brief The length of the segments in bytes*/
uint32_t segment_length;
/** \brief The length in bytes of the remainder of an incomplete block
* from a previous segment*/
uint32_t partial_aes_block_size;
/** \brief The length in bytes of the initial clear data */
uint32_t init_byte_length;
/** \brief This will be AES 128 counter for secure decode and secure
* encode when numSegments equals 1 */
uint8_t aes_cbc_iv_or_ctr[16];
/** \brief Reserved bytes for future use, must be zero */
uint32_t va_reserved[VA_PADDING_MEDIUM];
} VAEncryptionSegmentInfo;
/** \brief encrytpion parameters, corresonding to
* #VAEncryptionParameterBufferType*/
typedef struct _VAEncryptionParameters {
/** \brief Encryption type, attribute values. */
uint32_t encryption_type;
/** \brief The number of sengments */
uint32_t num_segments;
/** \brief Pointer of segments */
VAEncryptionSegmentInfo* segment_info;
/** \brief The status report index for CENC workload.
* The value is to indicate CENC workload and needs to be
* different for each CENC workload */
uint32_t status_report_index;
/** \brief CENC counter length */
uint32_t size_of_length;
/** \brief Wrapped decrypt blob (Snd)kb */
uint8_t wrapped_decrypt_blob[16];
/** \brief Wrapped Key blob info (Sne)kb */
uint8_t wrapped_encrypt_blob[16];
/** \brief Reserved bytes for future use, must be zero */
uint32_t va_reserved[VA_PADDING_MEDIUM];
} VAEncryptionParameters;
/** \brief structure for VA_TEE_EXEC_GPU_FUNCID_ENCRYPTION_BLT */
typedef struct _VA_PROTECTED_BLT_PARAMS {
uint8_t* src_resource; // The source resource which contains the clear data.
uint8_t*
dst_resource; // The Destination resource. This resource will contain the
// encrypted data. It should be allocated by the caller.
uint32_t width; // The width of the surface in Bytes.
uint32_t height; // The height of the surface in Bytes (pay attention that
// for NV12 the height(Bytes) = 1.5*height(Pixel)).
VAEncryptionParameters*
enc_params; // The encryption parameters as defined by application
void* reserved_extension; // The reserved extension for future BLT operations
} VA_PROTECTED_BLT_PARAMS;
/** \brief cenc status parameters, corresonding to
* #VACencStatusParameterBufferType*/
typedef struct _VACencStatusParameters {
/** \brief The status report index feedback. */
uint32_t status_report_index_feedback;
/** \brief Reserved bytes for future use, must be zero */
uint32_t va_reserved[VA_PADDING_MEDIUM];
} VACencStatusParameters;
/**
* \brief Slice parameter for H.264 cenc decode in baseline, main & high
* profiles.
*
* This structure holds information for \c
* slice_layer_without_partitioning_rbsp() and nal_unit()of the slice
* as defined by the H.264 specification.
*
*/
typedef struct _VACencSliceParameterBufferH264 {
/** \brief Parameters from \c nal_unit() of the slice.*/
/**@{*/
/** \brief Same as the H.264 bitstream syntax element. */
uint8_t nal_ref_idc;
/** \brief Indicate if this is coded slice of an IDR picture.
* Corresponds to IdrPicFlag as the H.264 specification.*/
uint8_t idr_pic_flag;
/**@}*/
/** \brief Same as the H.264 bitstream syntax element. */
uint8_t slice_type;
/** \brief Indicate if this is a field or frame picture.
* \c VA_FRAME_PICTURE, \c VA_TOP_FIELD, \c VA_BOTTOM_FIELD*/
uint8_t field_frame_flag;
/** \brief Same as the H.264 bitstream syntax element. */
uint32_t frame_number;
/** \brief Same as the H.264 bitstream syntax element. */
uint32_t idr_pic_id;
/** \brief Same as the H.264 bitstream syntax element. */
int32_t pic_order_cnt_lsb;
/** \brief Same as the H.264 bitstream syntax element. */
int32_t delta_pic_order_cnt_bottom;
/** \brief Same as the H.264 bitstream syntax element. */
int32_t delta_pic_order_cnt[2];
/**
* \brief decoded reference picture marking. Information for \c
* dec_ref_pic_marking() as defined by the H.264 specification.
*/
/**@{*/
union {
struct {
/** \brief Same as the H.264 bitstream syntax element. */
uint32_t no_output_of_prior_pics_flag : 1;
/** \brief Same as the H.264 bitstream syntax element. */
uint32_t long_term_reference_flag : 1;
/** \brief Same as the H.264 bitstream syntax element. */
uint32_t adaptive_ref_pic_marking_mode_flag : 1;
/** \brief number of decode reference picture marking. */
uint32_t dec_ref_pic_marking_count : 8;
/** \brief Reserved for future use, must be zero */
uint32_t reserved : 21;
} bits;
uint32_t value;
} ref_pic_fields;
/** \brief Same as the H.264 bitstream syntax element. */
uint8_t memory_management_control_operation[32];
/** \brief Same as the H.264 bitstream syntax element. */
int32_t difference_of_pic_nums_minus1[32];
/** \brief Same as the H.264 bitstream syntax element. */
int32_t long_term_pic_num[32];
/** \brief Same as the H.264 bitstream syntax element. */
int32_t max_long_term_frame_idx_plus1[32];
/** \brief Same as the H.264 bitstream syntax element. */
int32_t long_term_frame_idx[32];
/**@}*/
/** \brief Pointer to the next #VACencSliceParameterBufferH264 element,
* or \c nullptr if there is none.*/
void* next;
/** \brief Reserved bytes for future use, must be zero */
uint32_t va_reserved[VA_PADDING_MEDIUM];
} VACencSliceParameterBufferH264;
/**
* \brief Slice parameter for HEVC cenc decode in main & main 10 profiles.
*
* This structure holds information for \c
* slice_segment_header() and nal_unit_header() of the slice as
* defined by the HEVC specification.
*
*/
typedef struct _VACencSliceParameterBufferHEVC {
/** \brief Same as the HEVC bitstream syntax element. */
uint8_t nal_unit_type;
/** \brief Corresponds to the HEVC bitstream syntax element.
* Same as nuh_temporal_id_plus1 - 1*/
uint8_t nuh_temporal_id;
/** \brief Slice type.
* Corresponds to HEVC syntax element of the same name. */
uint8_t slice_type;
/** \brief Same as the HEVC bitstream syntax element. */
uint16_t slice_pic_order_cnt_lsb;
/** \brief Indicates EOS_NUT or EOB_NUT is detected in picture. */
uint16_t has_eos_or_eob;
union {
struct {
/** \brief Same as the HEVC bitstream syntax element */
uint32_t no_output_of_prior_pics_flag : 1;
/** \brief Same as the HEVC bitstream syntax element */
uint32_t pic_output_flag : 1;
/** \brief Same as the HEVC bitstream syntax element */
uint32_t colour_plane_id : 2;
/** \brief Reserved for future use, must be zero */
uint32_t reserved : 19;
} bits;
uint32_t value;
} slice_fields;
/** \brief Parameters for driver reference frame set */
/**@{*/
/** \brief number of entries as current before in short-term rps
* Corresponds to NumPocStCurrBefore as the HEVC specification. */
uint8_t num_of_curr_before;
/** \brief number of entries as current after in short-term rps
* Corresponds to NumPocStCurrAfter as the HEVC specification. */
uint8_t num_of_curr_after;
/** \brief number of entries as current total in short-term rps*/
uint8_t num_of_curr_total;
/** \brief number of entries as foll in short-term rps
* Corresponds to NumPocStFoll as the HEVC specification.*/
uint8_t num_of_foll_st;
/** \brief number of entries as current in long-term rps
* Corresponds to NumPocLtCurr as the HEVC specification. */
uint8_t num_of_curr_lt;
/** \brief number of entries as foll in long-term rps
* Corresponds to NumPocLtFoll as the HEVC specification.*/
uint8_t num_of_foll_lt;
/** \brief delta poc as short-term current before
* Corresponds to PocStCurrBefore as the HEVC specification. */
int32_t delta_poc_curr_before[8];
/** \brief delta poc as short-term current after
* Corresponds to PocStCurrAfter, as the HEVC specification.*/
int32_t delta_poc_curr_after[8];
/** \brief delta poc as short-term current total */
int32_t delta_poc_curr_total[8];
/** \brief delta poc as short-term foll
* Corresponds to PocStFoll as the HEVC specification.*/
int32_t delta_poc_foll_st[16];
/** \brief delta poc as long-term current
* Corresponds to PocLtCurr as the HEVC specification.*/
int32_t delta_poc_curr_lt[8];
/** \brief delta poc as long-term foll
* Corresponds to PocLtFoll, as the HEVC specification.*/
int32_t delta_poc_foll_lt[16];
/** \brief delta poc msb present flag
* Same as the HEVC bitstream syntax element. */
uint8_t delta_poc_msb_present_flag[16];
/** \brief long-term reference RPS is used for reference by current picture*/
uint8_t is_lt_curr_total[8];
/** \brief index of reference picture list. [0] is for P and B slice, [1] is
* for B slice*/
uint8_t ref_list_idx[2][16];
/**@}*/
/** \brief Pointer to the next #VACencSliceParameterBufferHEVC element,
* or \c nullptr if there is none.*/
void* next;
/** \brief Reserved bytes for future use, must be zero */
uint32_t va_reserved[VA_PADDING_MEDIUM];
} VACencSliceParameterBufferHEVC;
/**
* \brief uncompressed header for VP9 cenc decode
*
* This structure holds information for \c
* uncompressed_header() as defined by the VP9 specification.
*
*/
typedef struct _VACencSliceParameterBufferVP9 {
union {
struct {
/** \brief Same as the VP9 bitstream syntax element. */
uint32_t profile : 2;
/** \brief Same as the VP9 bitstream syntax element. */
uint32_t show_existing_frame_flag : 1;
/** \brief Same as the VP9 bitstream syntax element. */
uint32_t frame_to_show_map_idx : 3;
/** \brief Same as the VP9 bitstream syntax element. */
uint32_t frame_type : 1;
/** \brief Same as the VP9 bitstream syntax element. */
uint32_t show_frame : 1;
/** \brief Same as the VP9 bitstream syntax element. */
uint32_t error_resilient_mode : 1;
/** \brief Same as the VP9 bitstream syntax element. */
uint32_t intra_only : 1;
/** \brief Same as the VP9 bitstream syntax element. */
uint32_t ten_or_twelve_bit : 1;
/** \brief Same as the VP9 bitstream syntax element. */
uint32_t color_space : 3;
/** \brief Same as the VP9 bitstream syntax element. */
uint32_t color_range : 1;
/** \brief Same as the VP9 bitstream syntax element. */
uint32_t subsampling_x : 1;
/** \brief Same as the VP9 bitstream syntax element. */
uint32_t subsampling_y : 1;
/** \brief Corresponds to ref_frame_idx[0]
* as the VP9 specification */
uint32_t ref_frame_idx0 : 3;
/** \brief Corresponds to ref_frame_sign_bias[LAST_FRAME]
* as the VP9 specification */
uint32_t ref_frame_sign_bias0 : 1;
/** \brief Corresponds to ref_frame_idx[1]
* as the VP9 specification */
uint32_t ref_frame_idx1 : 3;
/** \brief Corresponds to ref_frame_sign_bias[GOLDEN_FRAME]
* as the VP9 specification */
uint32_t ref_frame_sign_bias1 : 1;
/** \brief Corresponds to ref_frame_idx[2]
* as the VP9 specification */
uint32_t ref_frame_idx2 : 3;
/** \brief Corresponds to ref_frame_sign_bias[ALTREF_FRAME]
* as the VP9 specification */
uint32_t ref_frame_sign_bias2 : 1;
/** \brief Same as the VP9 bitstream syntax element. */
uint32_t frame_parallel_decoding_mode : 1;
/** \brief Same as the VP9 bitstream syntax element. */
uint32_t render_and_frame_size_different : 1;
/** \brief Reserved for future use, must be zero */
uint32_t reserved : 1;
} bits;
uint32_t value;
} header_fields;
/** \brief Same as the VP9 bitstream syntax element. */
uint16_t frame_width_minus1;
/** \brief Same as the VP9 bitstream syntax element. */
uint16_t frame_height_minus1;
/** \brief Same as the VP9 bitstream syntax element. */
uint16_t render_width_minus1;
/** \brief Same as the VP9 bitstream syntax element. */
uint16_t render_height_minus1;
/** \brief Same as the VP9 bitstream syntax element. */
uint8_t refresh_frame_flags;
/** \brief Parameters for super frame*/
/**@{*/
/** \brief Superframe index, from 0 to frames_in_superframe_minus_1.
* as the VP9 specification */
uint8_t sf_index;
/** \brief Superframe size, corresponds to frame_sizes[ sf_index ]
* as the VP9 specification */
uint32_t sf_frame_size;
/**@}*/
/** \brief Pointer to the next #VACencSliceParameterBufferVP9 element,
* or \c nullptr if there is none.*/
void* next;
/** \brief Reserved bytes for future use, must be zero */
uint32_t va_reserved[VA_PADDING_MEDIUM];
} VACencSliceParameterBufferVP9;
/** \brief Cenc Slice Buffer Type*/
typedef enum {
/** \brief Parsed slice parameters \c VACencSliceParameterBuffer* */
VaCencSliceBufParamter = 1,
/** \brief Raw slice header of bitstream*/
VaCencSliceBufRaw = 2
} VACencSliceBufType;
/** \brief Buffer for CENC status reporting*/
typedef struct _VACencStatusBuf {
/** \brief Encryption status. VA_ENCRYPTION_STATUS_SUCCESSFUL if
* hardware has returned detailed inforamtion, others mean the
* CENC result is invalid */
VAEncryptionStatus status;
/* \brief feedback of status report index
* This value is the feedback of status_report_number of
* \ref VAEncryptionParameters to indicate the CENC workload*/
uint32_t status_report_index_feedback;
/** \brief Buf size in bytes. 0 means buf is invalid*/
uint32_t buf_size;
/** \brief Buffer formatted as raw data from bitstream for sequence parameter,
* picture parameter, SEI parameters. Or \c nullptr means buf is invalid.*/
void* buf;
/** \brief Slice buffer type, see \c VACencSliceBufTypex */
VACencSliceBufType slice_buf_type;
/** \brief Slice buffer size in bytes. 0 means slice_buf is invalid*/
uint32_t slice_buf_size;
/** \brief Slice buffer, parsed slice header information. Or \c nullptr
* means slice_buf is invalid.*/
void* slice_buf;
/** \brief Reserved bytes for future use, must be zero */
uint32_t va_reserved[VA_PADDING_MEDIUM];
} VACencStatusBuf;
/**@}*/
#ifdef __cplusplus
}
#endif
#endif // VA_PROTECTED_CONTENT_H
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment