Home | History | Annotate | Line # | Download | only in hw
      1 /*	$NetBSD: link_encoder.h,v 1.2 2021/12/18 23:45:05 riastradh Exp $	*/
      2 
      3 /*
      4  * Copyright 2017 Advanced Micro Devices, Inc.
      5  *
      6  * Permission is hereby granted, free of charge, to any person obtaining a
      7  * copy of this software and associated documentation files (the "Software"),
      8  * to deal in the Software without restriction, including without limitation
      9  * the rights to use, copy, modify, merge, publish, distribute, sublicense,
     10  * and/or sell copies of the Software, and to permit persons to whom the
     11  * Software is furnished to do so, subject to the following conditions:
     12  *
     13  * The above copyright notice and this permission notice shall be included in
     14  * all copies or substantial portions of the Software.
     15  *
     16  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
     17  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
     18  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
     19  * THE COPYRIGHT HOLDER(S) OR AUTHOR(S) BE LIABLE FOR ANY CLAIM, DAMAGES OR
     20  * OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
     21  * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
     22  * OTHER DEALINGS IN THE SOFTWARE.
     23  *
     24  */
     25 /*
     26  * link_encoder.h
     27  *
     28  *  Created on: Oct 6, 2015
     29  *      Author: yonsun
     30  */
     31 
     32 #ifndef LINK_ENCODER_H_
     33 #define LINK_ENCODER_H_
     34 
     35 #include "grph_object_defs.h"
     36 #include "signal_types.h"
     37 #include "dc_types.h"
     38 
     39 struct dc_context;
     40 struct encoder_set_dp_phy_pattern_param;
     41 struct link_mst_stream_allocation_table;
     42 struct dc_link_settings;
     43 struct link_training_settings;
     44 struct pipe_ctx;
     45 
     46 struct encoder_init_data {
     47 	enum channel_id channel;
     48 	struct graphics_object_id connector;
     49 	enum hpd_source_id hpd_source;
     50 	/* TODO: in DAL2, here was pointer to EventManagerInterface */
     51 	struct graphics_object_id encoder;
     52 	struct dc_context *ctx;
     53 	enum transmitter transmitter;
     54 };
     55 
     56 struct encoder_feature_support {
     57 	union {
     58 		struct {
     59 			uint32_t IS_HBR2_CAPABLE:1;
     60 			uint32_t IS_HBR3_CAPABLE:1;
     61 			uint32_t IS_TPS3_CAPABLE:1;
     62 			uint32_t IS_TPS4_CAPABLE:1;
     63 			uint32_t HDMI_6GB_EN:1;
     64 			uint32_t DP_IS_USB_C:1;
     65 		} bits;
     66 		uint32_t raw;
     67 	} flags;
     68 
     69 	enum dc_color_depth max_hdmi_deep_color;
     70 	unsigned int max_hdmi_pixel_clock;
     71 	bool hdmi_ycbcr420_supported;
     72 	bool dp_ycbcr420_supported;
     73 };
     74 
     75 union dpcd_psr_configuration {
     76 	struct {
     77 		unsigned char ENABLE                    : 1;
     78 		unsigned char TRANSMITTER_ACTIVE_IN_PSR : 1;
     79 		unsigned char CRC_VERIFICATION          : 1;
     80 		unsigned char FRAME_CAPTURE_INDICATION  : 1;
     81 		/* For eDP 1.4, PSR v2*/
     82 		unsigned char LINE_CAPTURE_INDICATION   : 1;
     83 		/* For eDP 1.4, PSR v2*/
     84 		unsigned char IRQ_HPD_WITH_CRC_ERROR    : 1;
     85 		unsigned char RESERVED                  : 2;
     86 	} bits;
     87 	unsigned char raw;
     88 };
     89 
     90 union psr_error_status {
     91 	struct {
     92 		unsigned char LINK_CRC_ERROR        :1;
     93 		unsigned char RFB_STORAGE_ERROR     :1;
     94 		unsigned char RESERVED              :6;
     95 	} bits;
     96 	unsigned char raw;
     97 };
     98 
     99 union psr_sink_psr_status {
    100 	struct {
    101 	unsigned char SINK_SELF_REFRESH_STATUS  :3;
    102 	unsigned char RESERVED                  :5;
    103 	} bits;
    104 	unsigned char raw;
    105 };
    106 
    107 struct link_encoder {
    108 	const struct link_encoder_funcs *funcs;
    109 	int32_t aux_channel_offset;
    110 	struct dc_context *ctx;
    111 	struct graphics_object_id id;
    112 	struct graphics_object_id connector;
    113 	uint32_t output_signals;
    114 	enum engine_id preferred_engine;
    115 	struct encoder_feature_support features;
    116 	enum transmitter transmitter;
    117 	enum hpd_source_id hpd_source;
    118 	bool usbc_combo_phy;
    119 };
    120 
    121 struct link_enc_state {
    122 
    123 		uint32_t dphy_fec_en;
    124 		uint32_t dphy_fec_ready_shadow;
    125 		uint32_t dphy_fec_active_status;
    126 		uint32_t dp_link_training_complete;
    127 
    128 };
    129 
    130 struct link_encoder_funcs {
    131 	void (*read_state)(
    132 			struct link_encoder *enc, struct link_enc_state *s);
    133 	bool (*validate_output_with_stream)(
    134 		struct link_encoder *enc, const struct dc_stream_state *stream);
    135 	void (*hw_init)(struct link_encoder *enc);
    136 	void (*setup)(struct link_encoder *enc,
    137 		enum signal_type signal);
    138 	void (*enable_tmds_output)(struct link_encoder *enc,
    139 		enum clock_source_id clock_source,
    140 		enum dc_color_depth color_depth,
    141 		enum signal_type signal,
    142 		uint32_t pixel_clock);
    143 	void (*enable_dp_output)(struct link_encoder *enc,
    144 		const struct dc_link_settings *link_settings,
    145 		enum clock_source_id clock_source);
    146 	void (*enable_dp_mst_output)(struct link_encoder *enc,
    147 		const struct dc_link_settings *link_settings,
    148 		enum clock_source_id clock_source);
    149 	void (*enable_lvds_output)(struct link_encoder *enc,
    150 		enum clock_source_id clock_source,
    151 		uint32_t pixel_clock);
    152 	void (*disable_output)(struct link_encoder *link_enc,
    153 		enum signal_type signal);
    154 	void (*dp_set_lane_settings)(struct link_encoder *enc,
    155 		const struct link_training_settings *link_settings);
    156 	void (*dp_set_phy_pattern)(struct link_encoder *enc,
    157 		const struct encoder_set_dp_phy_pattern_param *para);
    158 	void (*update_mst_stream_allocation_table)(
    159 		struct link_encoder *enc,
    160 		const struct link_mst_stream_allocation_table *table);
    161 	void (*psr_program_dp_dphy_fast_training)(struct link_encoder *enc,
    162 			bool exit_link_training_required);
    163 	void (*psr_program_secondary_packet)(struct link_encoder *enc,
    164 				unsigned int sdp_transmit_line_num_deadline);
    165 	void (*connect_dig_be_to_fe)(struct link_encoder *enc,
    166 		enum engine_id engine,
    167 		bool connect);
    168 	void (*enable_hpd)(struct link_encoder *enc);
    169 	void (*disable_hpd)(struct link_encoder *enc);
    170 	bool (*is_dig_enabled)(struct link_encoder *enc);
    171 	unsigned int (*get_dig_frontend)(struct link_encoder *enc);
    172 	void (*destroy)(struct link_encoder **enc);
    173 
    174 	void (*fec_set_enable)(struct link_encoder *enc,
    175 		bool enable);
    176 
    177 	void (*fec_set_ready)(struct link_encoder *enc,
    178 		bool ready);
    179 
    180 	bool (*fec_is_active)(struct link_encoder *enc);
    181 	bool (*is_in_alt_mode) (struct link_encoder *enc);
    182 
    183 	void (*get_max_link_cap)(struct link_encoder *enc,
    184 		struct dc_link_settings *link_settings);
    185 
    186 	enum signal_type (*get_dig_mode)(
    187 		struct link_encoder *enc);
    188 };
    189 
    190 #endif /* LINK_ENCODER_H_ */
    191