linux/drivers/gpu/drm/amd/display/dc/dce/dce_aux.h
<<
>>
Prefs
   1/*
   2 * Copyright 2012-15 Advanced Micro Devices, Inc.
   3 *
   4 * Permission is hereby granted, free of charge, to any person obtaining a
   5 * copy of this software and associated documentation files (the "Software"),
   6 * to deal in the Software without restriction, including without limitation
   7 * the rights to use, copy, modify, merge, publish, distribute, sublicense,
   8 * and/or sell copies of the Software, and to permit persons to whom the
   9 * Software is furnished to do so, subject to the following conditions:
  10 *
  11 * The above copyright notice and this permission notice shall be included in
  12 * all copies or substantial portions of the Software.
  13 *
  14 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  15 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  16 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
  17 * THE COPYRIGHT HOLDER(S) OR AUTHOR(S) BE LIABLE FOR ANY CLAIM, DAMAGES OR
  18 * OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
  19 * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
  20 * OTHER DEALINGS IN THE SOFTWARE.
  21 *
  22 * Authors: AMD
  23 *
  24 */
  25
  26#ifndef __DAL_AUX_ENGINE_DCE110_H__
  27#define __DAL_AUX_ENGINE_DCE110_H__
  28
  29#include "i2caux_interface.h"
  30#include "inc/hw/aux_engine.h"
  31
  32enum aux_return_code_type;
  33
  34#define AUX_COMMON_REG_LIST0(id)\
  35        SRI(AUX_CONTROL, DP_AUX, id), \
  36        SRI(AUX_ARB_CONTROL, DP_AUX, id), \
  37        SRI(AUX_SW_DATA, DP_AUX, id), \
  38        SRI(AUX_SW_CONTROL, DP_AUX, id), \
  39        SRI(AUX_INTERRUPT_CONTROL, DP_AUX, id), \
  40        SRI(AUX_DPHY_RX_CONTROL1, DP_AUX, id), \
  41        SRI(AUX_SW_STATUS, DP_AUX, id)
  42
  43#define AUX_COMMON_REG_LIST(id)\
  44        SRI(AUX_CONTROL, DP_AUX, id), \
  45        SRI(AUX_ARB_CONTROL, DP_AUX, id), \
  46        SRI(AUX_SW_DATA, DP_AUX, id), \
  47        SRI(AUX_SW_CONTROL, DP_AUX, id), \
  48        SRI(AUX_INTERRUPT_CONTROL, DP_AUX, id), \
  49        SRI(AUX_SW_STATUS, DP_AUX, id), \
  50        SR(AUXN_IMPCAL), \
  51        SR(AUXP_IMPCAL)
  52
  53struct dce110_aux_registers {
  54        uint32_t AUX_CONTROL;
  55        uint32_t AUX_ARB_CONTROL;
  56        uint32_t AUX_SW_DATA;
  57        uint32_t AUX_SW_CONTROL;
  58        uint32_t AUX_INTERRUPT_CONTROL;
  59        uint32_t AUX_DPHY_RX_CONTROL1;
  60        uint32_t AUX_SW_STATUS;
  61        uint32_t AUXN_IMPCAL;
  62        uint32_t AUXP_IMPCAL;
  63
  64        uint32_t AUX_RESET_MASK;
  65};
  66
  67#define DCE_AUX_REG_FIELD_LIST(type)\
  68        type AUX_EN;\
  69        type AUX_RESET;\
  70        type AUX_RESET_DONE;\
  71        type AUX_REG_RW_CNTL_STATUS;\
  72        type AUX_SW_USE_AUX_REG_REQ;\
  73        type AUX_SW_DONE_USING_AUX_REG;\
  74        type AUX_SW_AUTOINCREMENT_DISABLE;\
  75        type AUX_SW_DATA_RW;\
  76        type AUX_SW_INDEX;\
  77        type AUX_SW_GO;\
  78        type AUX_SW_DATA;\
  79        type AUX_SW_REPLY_BYTE_COUNT;\
  80        type AUX_SW_DONE;\
  81        type AUX_SW_DONE_ACK;\
  82        type AUXN_IMPCAL_ENABLE;\
  83        type AUXP_IMPCAL_ENABLE;\
  84        type AUXN_IMPCAL_OVERRIDE_ENABLE;\
  85        type AUXP_IMPCAL_OVERRIDE_ENABLE;\
  86        type AUX_RX_TIMEOUT_LEN;\
  87        type AUX_RX_TIMEOUT_LEN_MUL;\
  88        type AUXN_CALOUT_ERROR_AK;\
  89        type AUXP_CALOUT_ERROR_AK;\
  90        type AUX_SW_START_DELAY;\
  91        type AUX_SW_WR_BYTES
  92
  93#define DCE10_AUX_MASK_SH_LIST(mask_sh)\
  94        AUX_SF(AUX_CONTROL, AUX_EN, mask_sh),\
  95        AUX_SF(AUX_ARB_CONTROL, AUX_REG_RW_CNTL_STATUS, mask_sh),\
  96        AUX_SF(AUX_ARB_CONTROL, AUX_SW_USE_AUX_REG_REQ, mask_sh),\
  97        AUX_SF(AUX_ARB_CONTROL, AUX_SW_DONE_USING_AUX_REG, mask_sh),\
  98        AUX_SF(AUX_SW_CONTROL, AUX_SW_START_DELAY, mask_sh),\
  99        AUX_SF(AUX_SW_CONTROL, AUX_SW_WR_BYTES, mask_sh),\
 100        AUX_SF(AUX_SW_CONTROL, AUX_SW_GO, mask_sh),\
 101        AUX_SF(AUX_SW_DATA, AUX_SW_AUTOINCREMENT_DISABLE, mask_sh),\
 102        AUX_SF(AUX_SW_DATA, AUX_SW_DATA_RW, mask_sh),\
 103        AUX_SF(AUX_SW_DATA, AUX_SW_INDEX, mask_sh),\
 104        AUX_SF(AUX_SW_DATA, AUX_SW_DATA, mask_sh),\
 105        AUX_SF(AUX_SW_STATUS, AUX_SW_REPLY_BYTE_COUNT, mask_sh),\
 106        AUX_SF(AUX_SW_STATUS, AUX_SW_DONE, mask_sh),\
 107        AUX_SF(AUX_INTERRUPT_CONTROL, AUX_SW_DONE_ACK, mask_sh),\
 108        AUX_SF(AUXN_IMPCAL, AUXN_CALOUT_ERROR_AK, mask_sh),\
 109        AUX_SF(AUXP_IMPCAL, AUXP_CALOUT_ERROR_AK, mask_sh),\
 110        AUX_SF(AUXN_IMPCAL, AUXN_IMPCAL_ENABLE, mask_sh),\
 111        AUX_SF(AUXP_IMPCAL, AUXP_IMPCAL_ENABLE, mask_sh),\
 112        AUX_SF(AUXP_IMPCAL, AUXP_IMPCAL_OVERRIDE_ENABLE, mask_sh),\
 113        AUX_SF(AUXN_IMPCAL, AUXN_IMPCAL_OVERRIDE_ENABLE, mask_sh)
 114
 115#define DCE_AUX_MASK_SH_LIST(mask_sh)\
 116        AUX_SF(AUX_CONTROL, AUX_EN, mask_sh),\
 117        AUX_SF(AUX_CONTROL, AUX_RESET, mask_sh),\
 118        AUX_SF(AUX_CONTROL, AUX_RESET_DONE, mask_sh),\
 119        AUX_SF(AUX_ARB_CONTROL, AUX_REG_RW_CNTL_STATUS, mask_sh),\
 120        AUX_SF(AUX_ARB_CONTROL, AUX_SW_USE_AUX_REG_REQ, mask_sh),\
 121        AUX_SF(AUX_ARB_CONTROL, AUX_SW_DONE_USING_AUX_REG, mask_sh),\
 122        AUX_SF(AUX_SW_CONTROL, AUX_SW_START_DELAY, mask_sh),\
 123        AUX_SF(AUX_SW_CONTROL, AUX_SW_WR_BYTES, mask_sh),\
 124        AUX_SF(AUX_SW_CONTROL, AUX_SW_GO, mask_sh),\
 125        AUX_SF(AUX_SW_DATA, AUX_SW_AUTOINCREMENT_DISABLE, mask_sh),\
 126        AUX_SF(AUX_SW_DATA, AUX_SW_DATA_RW, mask_sh),\
 127        AUX_SF(AUX_SW_DATA, AUX_SW_INDEX, mask_sh),\
 128        AUX_SF(AUX_SW_DATA, AUX_SW_DATA, mask_sh),\
 129        AUX_SF(AUX_SW_STATUS, AUX_SW_REPLY_BYTE_COUNT, mask_sh),\
 130        AUX_SF(AUX_SW_STATUS, AUX_SW_DONE, mask_sh),\
 131        AUX_SF(AUX_INTERRUPT_CONTROL, AUX_SW_DONE_ACK, mask_sh),\
 132        AUX_SF(AUXN_IMPCAL, AUXN_CALOUT_ERROR_AK, mask_sh),\
 133        AUX_SF(AUXP_IMPCAL, AUXP_CALOUT_ERROR_AK, mask_sh),\
 134        AUX_SF(AUXN_IMPCAL, AUXN_IMPCAL_ENABLE, mask_sh),\
 135        AUX_SF(AUXP_IMPCAL, AUXP_IMPCAL_ENABLE, mask_sh),\
 136        AUX_SF(AUXP_IMPCAL, AUXP_IMPCAL_OVERRIDE_ENABLE, mask_sh),\
 137        AUX_SF(AUXN_IMPCAL, AUXN_IMPCAL_OVERRIDE_ENABLE, mask_sh)
 138
 139#define DCE12_AUX_MASK_SH_LIST(mask_sh)\
 140        AUX_SF(DP_AUX0_AUX_CONTROL, AUX_EN, mask_sh),\
 141        AUX_SF(DP_AUX0_AUX_CONTROL, AUX_RESET, mask_sh),\
 142        AUX_SF(DP_AUX0_AUX_CONTROL, AUX_RESET_DONE, mask_sh),\
 143        AUX_SF(DP_AUX0_AUX_ARB_CONTROL, AUX_REG_RW_CNTL_STATUS, mask_sh),\
 144        AUX_SF(DP_AUX0_AUX_ARB_CONTROL, AUX_SW_USE_AUX_REG_REQ, mask_sh),\
 145        AUX_SF(DP_AUX0_AUX_ARB_CONTROL, AUX_SW_DONE_USING_AUX_REG, mask_sh),\
 146        AUX_SF(DP_AUX0_AUX_SW_CONTROL, AUX_SW_START_DELAY, mask_sh),\
 147        AUX_SF(DP_AUX0_AUX_SW_CONTROL, AUX_SW_WR_BYTES, mask_sh),\
 148        AUX_SF(DP_AUX0_AUX_SW_CONTROL, AUX_SW_GO, mask_sh),\
 149        AUX_SF(DP_AUX0_AUX_SW_DATA, AUX_SW_AUTOINCREMENT_DISABLE, mask_sh),\
 150        AUX_SF(DP_AUX0_AUX_SW_DATA, AUX_SW_DATA_RW, mask_sh),\
 151        AUX_SF(DP_AUX0_AUX_SW_DATA, AUX_SW_AUTOINCREMENT_DISABLE, mask_sh),\
 152        AUX_SF(DP_AUX0_AUX_SW_DATA, AUX_SW_INDEX, mask_sh),\
 153        AUX_SF(DP_AUX0_AUX_SW_DATA, AUX_SW_DATA, mask_sh),\
 154        AUX_SF(DP_AUX0_AUX_SW_STATUS, AUX_SW_REPLY_BYTE_COUNT, mask_sh),\
 155        AUX_SF(DP_AUX0_AUX_SW_STATUS, AUX_SW_DONE, mask_sh),\
 156        AUX_SF(DP_AUX0_AUX_INTERRUPT_CONTROL, AUX_SW_DONE_ACK, mask_sh),\
 157        AUX_SF(AUXN_IMPCAL, AUXN_CALOUT_ERROR_AK, mask_sh),\
 158        AUX_SF(AUXP_IMPCAL, AUXP_CALOUT_ERROR_AK, mask_sh),\
 159        AUX_SF(AUXN_IMPCAL, AUXN_IMPCAL_ENABLE, mask_sh),\
 160        AUX_SF(AUXP_IMPCAL, AUXP_IMPCAL_ENABLE, mask_sh),\
 161        AUX_SF(AUXP_IMPCAL, AUXP_IMPCAL_OVERRIDE_ENABLE, mask_sh),\
 162        AUX_SF(AUXN_IMPCAL, AUXN_IMPCAL_OVERRIDE_ENABLE, mask_sh)
 163
 164/* DCN10 MASK */
 165#define DCN10_AUX_MASK_SH_LIST(mask_sh)\
 166        AUX_SF(DP_AUX0_AUX_CONTROL, AUX_EN, mask_sh),\
 167        AUX_SF(DP_AUX0_AUX_CONTROL, AUX_RESET, mask_sh),\
 168        AUX_SF(DP_AUX0_AUX_CONTROL, AUX_RESET_DONE, mask_sh),\
 169        AUX_SF(DP_AUX0_AUX_ARB_CONTROL, AUX_REG_RW_CNTL_STATUS, mask_sh),\
 170        AUX_SF(DP_AUX0_AUX_ARB_CONTROL, AUX_SW_USE_AUX_REG_REQ, mask_sh),\
 171        AUX_SF(DP_AUX0_AUX_ARB_CONTROL, AUX_SW_DONE_USING_AUX_REG, mask_sh),\
 172        AUX_SF(DP_AUX0_AUX_SW_CONTROL, AUX_SW_START_DELAY, mask_sh),\
 173        AUX_SF(DP_AUX0_AUX_SW_CONTROL, AUX_SW_WR_BYTES, mask_sh),\
 174        AUX_SF(DP_AUX0_AUX_SW_CONTROL, AUX_SW_GO, mask_sh),\
 175        AUX_SF(DP_AUX0_AUX_SW_DATA, AUX_SW_AUTOINCREMENT_DISABLE, mask_sh),\
 176        AUX_SF(DP_AUX0_AUX_SW_DATA, AUX_SW_DATA_RW, mask_sh),\
 177        AUX_SF(DP_AUX0_AUX_SW_DATA, AUX_SW_AUTOINCREMENT_DISABLE, mask_sh),\
 178        AUX_SF(DP_AUX0_AUX_SW_DATA, AUX_SW_INDEX, mask_sh),\
 179        AUX_SF(DP_AUX0_AUX_SW_DATA, AUX_SW_DATA, mask_sh),\
 180        AUX_SF(DP_AUX0_AUX_SW_STATUS, AUX_SW_REPLY_BYTE_COUNT, mask_sh),\
 181        AUX_SF(DP_AUX0_AUX_SW_STATUS, AUX_SW_DONE, mask_sh),\
 182        AUX_SF(DP_AUX0_AUX_INTERRUPT_CONTROL, AUX_SW_DONE_ACK, mask_sh),\
 183        AUX_SF(AUXN_IMPCAL, AUXN_CALOUT_ERROR_AK, mask_sh),\
 184        AUX_SF(AUXP_IMPCAL, AUXP_CALOUT_ERROR_AK, mask_sh),\
 185        AUX_SF(AUXN_IMPCAL, AUXN_IMPCAL_ENABLE, mask_sh),\
 186        AUX_SF(AUXP_IMPCAL, AUXP_IMPCAL_ENABLE, mask_sh),\
 187        AUX_SF(AUXP_IMPCAL, AUXP_IMPCAL_OVERRIDE_ENABLE, mask_sh),\
 188        AUX_SF(AUXN_IMPCAL, AUXN_IMPCAL_OVERRIDE_ENABLE, mask_sh)
 189
 190/* for all other DCN */
 191#define DCN_AUX_MASK_SH_LIST(mask_sh)\
 192        AUX_SF(DP_AUX0_AUX_CONTROL, AUX_EN, mask_sh),\
 193        AUX_SF(DP_AUX0_AUX_CONTROL, AUX_RESET, mask_sh),\
 194        AUX_SF(DP_AUX0_AUX_CONTROL, AUX_RESET_DONE, mask_sh),\
 195        AUX_SF(DP_AUX0_AUX_ARB_CONTROL, AUX_REG_RW_CNTL_STATUS, mask_sh),\
 196        AUX_SF(DP_AUX0_AUX_ARB_CONTROL, AUX_SW_USE_AUX_REG_REQ, mask_sh),\
 197        AUX_SF(DP_AUX0_AUX_ARB_CONTROL, AUX_SW_DONE_USING_AUX_REG, mask_sh),\
 198        AUX_SF(DP_AUX0_AUX_SW_CONTROL, AUX_SW_START_DELAY, mask_sh),\
 199        AUX_SF(DP_AUX0_AUX_SW_CONTROL, AUX_SW_WR_BYTES, mask_sh),\
 200        AUX_SF(DP_AUX0_AUX_SW_CONTROL, AUX_SW_GO, mask_sh),\
 201        AUX_SF(DP_AUX0_AUX_SW_DATA, AUX_SW_AUTOINCREMENT_DISABLE, mask_sh),\
 202        AUX_SF(DP_AUX0_AUX_SW_DATA, AUX_SW_DATA_RW, mask_sh),\
 203        AUX_SF(DP_AUX0_AUX_SW_DATA, AUX_SW_AUTOINCREMENT_DISABLE, mask_sh),\
 204        AUX_SF(DP_AUX0_AUX_SW_DATA, AUX_SW_INDEX, mask_sh),\
 205        AUX_SF(DP_AUX0_AUX_SW_DATA, AUX_SW_DATA, mask_sh),\
 206        AUX_SF(DP_AUX0_AUX_SW_STATUS, AUX_SW_REPLY_BYTE_COUNT, mask_sh),\
 207        AUX_SF(DP_AUX0_AUX_SW_STATUS, AUX_SW_DONE, mask_sh),\
 208        AUX_SF(DP_AUX0_AUX_INTERRUPT_CONTROL, AUX_SW_DONE_ACK, mask_sh),\
 209        AUX_SF(DP_AUX0_AUX_DPHY_RX_CONTROL1, AUX_RX_TIMEOUT_LEN, mask_sh),\
 210        AUX_SF(DP_AUX0_AUX_DPHY_RX_CONTROL1, AUX_RX_TIMEOUT_LEN_MUL, mask_sh)
 211
 212#define AUX_SF(reg_name, field_name, post_fix)\
 213        .field_name = reg_name ## __ ## field_name ## post_fix
 214
 215enum {  /* This is the timeout as defined in DP 1.2a,
 216         * 2.3.4 "Detailed uPacket TX AUX CH State Description".
 217         */
 218        AUX_TIMEOUT_PERIOD = 400,
 219
 220        /* Ideally, the SW timeout should be just above 550usec
 221         * which is programmed in HW.
 222         * But the SW timeout of 600usec is not reliable,
 223         * because on some systems, delay_in_microseconds()
 224         * returns faster than it should.
 225         * EPR #379763: by trial-and-error on different systems,
 226         * 700usec is the minimum reliable SW timeout for polling
 227         * the AUX_SW_STATUS.AUX_SW_DONE bit.
 228         * This timeout expires *only* when there is
 229         * AUX Error or AUX Timeout conditions - not during normal operation.
 230         * During normal operation, AUX_SW_STATUS.AUX_SW_DONE bit is set
 231         * at most within ~240usec. That means,
 232         * increasing this timeout will not affect normal operation,
 233         * and we'll timeout after
 234         * SW_AUX_TIMEOUT_PERIOD_MULTIPLIER * AUX_TIMEOUT_PERIOD = 2400usec.
 235         * This timeout is especially important for
 236         * converters, resume from S3, and CTS.
 237         */
 238        SW_AUX_TIMEOUT_PERIOD_MULTIPLIER = 6
 239};
 240
 241struct dce_aux {
 242        uint32_t inst;
 243        struct ddc *ddc;
 244        struct dc_context *ctx;
 245        /* following values are expressed in milliseconds */
 246        uint32_t delay;
 247        uint32_t max_defer_write_retry;
 248
 249        bool acquire_reset;
 250        struct dce_aux_funcs *funcs;
 251};
 252
 253struct dce110_aux_registers_mask {
 254        DCE_AUX_REG_FIELD_LIST(uint32_t);
 255};
 256
 257struct dce110_aux_registers_shift {
 258        DCE_AUX_REG_FIELD_LIST(uint8_t);
 259};
 260
 261
 262struct aux_engine_dce110 {
 263        struct dce_aux base;
 264        const struct dce110_aux_registers *regs;
 265        const struct dce110_aux_registers_mask *mask;
 266        const struct dce110_aux_registers_shift *shift;
 267        struct {
 268                uint32_t aux_control;
 269                uint32_t aux_arb_control;
 270                uint32_t aux_sw_data;
 271                uint32_t aux_sw_control;
 272                uint32_t aux_interrupt_control;
 273                uint32_t aux_dphy_rx_control1;
 274                uint32_t aux_dphy_rx_control0;
 275                uint32_t aux_sw_status;
 276        } addr;
 277        uint32_t polling_timeout_period;
 278};
 279
 280struct aux_engine_dce110_init_data {
 281        uint32_t engine_id;
 282        uint32_t timeout_period;
 283        struct dc_context *ctx;
 284        const struct dce110_aux_registers *regs;
 285};
 286
 287struct dce_aux *dce110_aux_engine_construct(struct aux_engine_dce110 *aux_engine110,
 288                struct dc_context *ctx,
 289                uint32_t inst,
 290                uint32_t timeout_period,
 291                const struct dce110_aux_registers *regs,
 292
 293                const struct dce110_aux_registers_mask *mask,
 294                const struct dce110_aux_registers_shift *shift,
 295                bool is_ext_aux_timeout_configurable);
 296
 297void dce110_engine_destroy(struct dce_aux **engine);
 298
 299bool dce110_aux_engine_acquire(
 300        struct dce_aux *aux_engine,
 301        struct ddc *ddc);
 302
 303int dce_aux_transfer_raw(struct ddc_service *ddc,
 304                struct aux_payload *cmd,
 305                enum aux_return_code_type *operation_result);
 306
 307int dce_aux_transfer_dmub_raw(struct ddc_service *ddc,
 308                struct aux_payload *payload,
 309                enum aux_return_code_type *operation_result);
 310bool dce_aux_transfer_with_retries(struct ddc_service *ddc,
 311                struct aux_payload *cmd);
 312
 313struct dce_aux_funcs {
 314        uint32_t (*configure_timeout)
 315                (struct ddc_service *ddc,
 316                 uint32_t timeout);
 317        void (*destroy)
 318                (struct aux_engine **ptr);
 319};
 320
 321#endif
 322