drivers/usb/typec/tipd/tps6598x.h

   1 /* SPDX-License-Identifier: GPL-2.0+ */
   2 /*
   3  * Driver for TI TPS6598x USB Power Delivery controller family
   4  *
   5  * Copyright (C) 2017, Intel Corporation
   6  * Author: Heikki Krogerus <heikki.krogerus@linux.intel.com>
   7  */
   8
   9 #include <linux/bits.h>
  10 #include <linux/bitfield.h>
  11
  12 #ifndef __TPS6598X_H__
  13 #define __TPS6598X_H__
  14
  15 #define TPS_FIELD_GET(_mask, _reg) ((typeof(_mask))(((_reg) & (_mask)) >> __bf_shf(_mask)))
  16
  17 /* TPS_REG_STATUS bits */
  18 #define TPS_STATUS_PLUG_PRESENT         BIT(0)
  19 #define TPS_STATUS_PLUG_UPSIDE_DOWN     BIT(4)
  20 #define TPS_STATUS_PORTROLE             BIT(5)
  21 #define TPS_STATUS_TO_TYPEC_PORTROLE(s) (!!((s) & TPS_STATUS_PORTROLE))
  22 #define TPS_STATUS_DATAROLE             BIT(6)
  23 #define TPS_STATUS_TO_TYPEC_DATAROLE(s) (!!((s) & TPS_STATUS_DATAROLE))
  24 #define TPS_STATUS_VCONN                BIT(7)
  25 #define TPS_STATUS_TO_TYPEC_VCONN(s)    (!!((s) & TPS_STATUS_VCONN))
  26 #define TPS_STATUS_OVERCURRENT          BIT(16)
  27 #define TPS_STATUS_GOTO_MIN_ACTIVE      BIT(26)
  28 #define TPS_STATUS_BIST                 BIT(27)
  29 #define TPS_STATUS_HIGH_VOLAGE_WARNING  BIT(28)
  30 #define TPS_STATUS_HIGH_LOW_VOLTAGE_WARNING BIT(29)
  31
  32 #define TPS_STATUS_CONN_STATE_MASK              GENMASK(3, 1)
  33 #define TPS_STATUS_CONN_STATE(x)                TPS_FIELD_GET(TPS_STATUS_CONN_STATE_MASK, (x))
  34 #define TPS_STATUS_PP_5V0_SWITCH_MASK           GENMASK(9, 8)
  35 #define TPS_STATUS_PP_5V0_SWITCH(x)             TPS_FIELD_GET(TPS_STATUS_PP_5V0_SWITCH_MASK, (x))
  36 #define TPS_STATUS_PP_HV_SWITCH_MASK            GENMASK(11, 10)
  37 #define TPS_STATUS_PP_HV_SWITCH(x)              TPS_FIELD_GET(TPS_STATUS_PP_HV_SWITCH_MASK, (x))
  38 #define TPS_STATUS_PP_EXT_SWITCH_MASK           GENMASK(13, 12)
  39 #define TPS_STATUS_PP_EXT_SWITCH(x)             TPS_FIELD_GET(TPS_STATUS_PP_EXT_SWITCH_MASK, (x))
  40 #define TPS_STATUS_PP_CABLE_SWITCH_MASK         GENMASK(15, 14)
  41 #define TPS_STATUS_PP_CABLE_SWITCH(x)           TPS_FIELD_GET(TPS_STATUS_PP_CABLE_SWITCH_MASK, (x))
  42 #define TPS_STATUS_POWER_SOURCE_MASK            GENMASK(19, 18)
  43 #define TPS_STATUS_POWER_SOURCE(x)              TPS_FIELD_GET(TPS_STATUS_POWER_SOURCE_MASK, (x))
  44 #define TPS_STATUS_VBUS_STATUS_MASK             GENMASK(21, 20)
  45 #define TPS_STATUS_VBUS_STATUS(x)               TPS_FIELD_GET(TPS_STATUS_VBUS_STATUS_MASK, (x))
  46 #define TPS_STATUS_USB_HOST_PRESENT_MASK        GENMASK(23, 22)
  47 #define TPS_STATUS_USB_HOST_PRESENT(x)          TPS_FIELD_GET(TPS_STATUS_USB_HOST_PRESENT_MASK, (x))
  48 #define TPS_STATUS_LEGACY_MASK                  GENMASK(25, 24)
  49 #define TPS_STATUS_LEGACY(x)                    TPS_FIELD_GET(TPS_STATUS_LEGACY_MASK, (x))
  50
  51 #define TPS_STATUS_CONN_STATE_NO_CONN           0
  52 #define TPS_STATUS_CONN_STATE_DISABLED          1
  53 #define TPS_STATUS_CONN_STATE_AUDIO_CONN        2
  54 #define TPS_STATUS_CONN_STATE_DEBUG_CONN        3
  55 #define TPS_STATUS_CONN_STATE_NO_CONN_R_A       4
  56 #define TPS_STATUS_CONN_STATE_RESERVED          5
  57 #define TPS_STATUS_CONN_STATE_CONN_NO_R_A       6
  58 #define TPS_STATUS_CONN_STATE_CONN_WITH_R_A     7
  59
  60 #define TPS_STATUS_PP_SWITCH_STATE_DISABLED     0
  61 #define TPS_STATUS_PP_SWITCH_STATE_FAULT        1
  62 #define TPS_STATUS_PP_SWITCH_STATE_OUT          2
  63 #define TPS_STATUS_PP_SWITCH_STATE_IN           3
  64
  65 #define TPS_STATUS_POWER_SOURCE_UNKNOWN         0
  66 #define TPS_STATUS_POWER_SOURCE_VIN_3P3         1
  67 #define TPS_STATUS_POWER_SOURCE_DEAD_BAT        2
  68 #define TPS_STATUS_POWER_SOURCE_VBUS            3
  69
  70 #define TPS_STATUS_VBUS_STATUS_VSAFE0V          0
  71 #define TPS_STATUS_VBUS_STATUS_VSAFE5V          1
  72 #define TPS_STATUS_VBUS_STATUS_PD               2
  73 #define TPS_STATUS_VBUS_STATUS_FAULT            3
  74
  75 #define TPS_STATUS_USB_HOST_PRESENT_NO          0
  76 #define TPS_STATUS_USB_HOST_PRESENT_PD_NO_USB   1
  77 #define TPS_STATUS_USB_HOST_PRESENT_NO_PD       2
  78 #define TPS_STATUS_USB_HOST_PRESENT_PD_USB      3
  79
  80 #define TPS_STATUS_LEGACY_NO                    0
  81 #define TPS_STATUS_LEGACY_SINK                  1
  82 #define TPS_STATUS_LEGACY_SOURCE                2
  83
  84 /* TPS_REG_INT_* bits */
  85 #define TPS_REG_INT_USER_VID_ALT_MODE_OTHER_VDM         BIT_ULL(27+32)
  86 #define TPS_REG_INT_USER_VID_ALT_MODE_ATTN_VDM          BIT_ULL(26+32)
  87 #define TPS_REG_INT_USER_VID_ALT_MODE_EXIT              BIT_ULL(25+32)
  88 #define TPS_REG_INT_USER_VID_ALT_MODE_ENTERED           BIT_ULL(24+32)
  89 #define TPS_REG_INT_EXIT_MODES_COMPLETE                 BIT_ULL(20+32)
  90 #define TPS_REG_INT_DISCOVER_MODES_COMPLETE             BIT_ULL(19+32)
  91 #define TPS_REG_INT_VDM_MSG_SENT                        BIT_ULL(18+32)
  92 #define TPS_REG_INT_VDM_ENTERED_MODE                    BIT_ULL(17+32)
  93 #define TPS_REG_INT_ERROR_UNABLE_TO_SOURCE              BIT_ULL(14+32)
  94 #define TPS_REG_INT_SRC_TRANSITION                      BIT_ULL(10+32)
  95 #define TPS_REG_INT_ERROR_DISCHARGE_FAILED              BIT_ULL(9+32)
  96 #define TPS_REG_INT_ERROR_MESSAGE_DATA                  BIT_ULL(7+32)
  97 #define TPS_REG_INT_ERROR_PROTOCOL_ERROR                BIT_ULL(6+32)
  98 #define TPS_REG_INT_ERROR_MISSING_GET_CAP_MESSAGE       BIT_ULL(4+32)
  99 #define TPS_REG_INT_ERROR_POWER_EVENT_OCCURRED          BIT_ULL(3+32)
 100 #define TPS_REG_INT_ERROR_CAN_PROVIDE_PWR_LATER         BIT_ULL(2+32)
 101 #define TPS_REG_INT_ERROR_CANNOT_PROVIDE_PWR            BIT_ULL(1+32)
 102 #define TPS_REG_INT_ERROR_DEVICE_INCOMPATIBLE           BIT_ULL(0+32)
 103 #define TPS_REG_INT_CMD2_COMPLETE                       BIT(31)
 104 #define TPS_REG_INT_CMD1_COMPLETE                       BIT(30)
 105 #define TPS_REG_INT_ADC_HIGH_THRESHOLD                  BIT(29)
 106 #define TPS_REG_INT_ADC_LOW_THRESHOLD                   BIT(28)
 107 #define TPS_REG_INT_PD_STATUS_UPDATE                    BIT(27)
 108 #define TPS_REG_INT_STATUS_UPDATE                       BIT(26)
 109 #define TPS_REG_INT_DATA_STATUS_UPDATE                  BIT(25)
 110 #define TPS_REG_INT_POWER_STATUS_UPDATE                 BIT(24)
 111 #define TPS_REG_INT_PP_SWITCH_CHANGED                   BIT(23)
 112 #define TPS_REG_INT_HIGH_VOLTAGE_WARNING                BIT(22)
 113 #define TPS_REG_INT_USB_HOST_PRESENT_NO_LONGER          BIT(21)
 114 #define TPS_REG_INT_USB_HOST_PRESENT                    BIT(20)
 115 #define TPS_REG_INT_GOTO_MIN_RECEIVED                   BIT(19)
 116 #define TPS_REG_INT_PR_SWAP_REQUESTED                   BIT(17)
 117 #define TPS_REG_INT_SINK_CAP_MESSAGE_READY              BIT(15)
 118 #define TPS_REG_INT_SOURCE_CAP_MESSAGE_READY            BIT(14)
 119 #define TPS_REG_INT_NEW_CONTRACT_AS_PROVIDER            BIT(13)
 120 #define TPS_REG_INT_NEW_CONTRACT_AS_CONSUMER            BIT(12)
 121 #define TPS_REG_INT_VDM_RECEIVED                        BIT(11)
 122 #define TPS_REG_INT_ATTENTION_RECEIVED                  BIT(10)
 123 #define TPS_REG_INT_OVERCURRENT                         BIT(9)
 124 #define TPS_REG_INT_BIST                                BIT(8)
 125 #define TPS_REG_INT_RDO_RECEIVED_FROM_SINK              BIT(7)
 126 #define TPS_REG_INT_DR_SWAP_COMPLETE                    BIT(5)
 127 #define TPS_REG_INT_PR_SWAP_COMPLETE                    BIT(4)
 128 #define TPS_REG_INT_PLUG_EVENT                          BIT(3)
 129 #define TPS_REG_INT_HARD_RESET                          BIT(1)
 130 #define TPS_REG_INT_PD_SOFT_RESET                       BIT(0)
 131
 132 /* Apple-specific TPS_REG_INT_* bits */
 133 #define APPLE_CD_REG_INT_DATA_STATUS_UPDATE             BIT(10)
 134 #define APPLE_CD_REG_INT_POWER_STATUS_UPDATE            BIT(9)
 135 #define APPLE_CD_REG_INT_STATUS_UPDATE                  BIT(8)
 136 #define APPLE_CD_REG_INT_PLUG_EVENT                     BIT(1)
 137
 138 /* TPS_REG_SYSTEM_POWER_STATE states */
 139 #define TPS_SYSTEM_POWER_STATE_S0       0x00
 140 #define TPS_SYSTEM_POWER_STATE_S3       0x03
 141 #define TPS_SYSTEM_POWER_STATE_S4       0x04
 142 #define TPS_SYSTEM_POWER_STATE_S5       0x05
 143
 144 /* TPS_REG_POWER_STATUS bits */
 145 #define TPS_POWER_STATUS_CONNECTION(x)  TPS_FIELD_GET(BIT(0), (x))
 146 #define TPS_POWER_STATUS_SOURCESINK(x)  TPS_FIELD_GET(BIT(1), (x))
 147 #define TPS_POWER_STATUS_BC12_DET(x)    TPS_FIELD_GET(BIT(2), (x))
 148
 149 #define TPS_POWER_STATUS_TYPEC_CURRENT_MASK GENMASK(3, 2)
 150 #define TPS_POWER_STATUS_PWROPMODE(p)       TPS_FIELD_GET(TPS_POWER_STATUS_TYPEC_CURRENT_MASK, (p))
 151 #define TPS_POWER_STATUS_BC12_STATUS_MASK   GENMASK(6, 5)
 152 #define TPS_POWER_STATUS_BC12_STATUS(p)     TPS_FIELD_GET(TPS_POWER_STATUS_BC12_STATUS_MASK, (p))
 153
 154 #define TPS_POWER_STATUS_TYPEC_CURRENT_USB     0
 155 #define TPS_POWER_STATUS_TYPEC_CURRENT_1A5     1
 156 #define TPS_POWER_STATUS_TYPEC_CURRENT_3A0     2
 157 #define TPS_POWER_STATUS_TYPEC_CURRENT_PD      3
 158
 159 #define TPS_POWER_STATUS_BC12_STATUS_SDP 0
 160 #define TPS_POWER_STATUS_BC12_STATUS_CDP 2
 161 #define TPS_POWER_STATUS_BC12_STATUS_DCP 3
 162
 163 /* TPS_REG_DATA_STATUS bits */
 164 #define TPS_DATA_STATUS_DATA_CONNECTION      BIT(0)
 165 #define TPS_DATA_STATUS_UPSIDE_DOWN          BIT(1)
 166 #define TPS_DATA_STATUS_ACTIVE_CABLE         BIT(2)
 167 #define TPS_DATA_STATUS_USB2_CONNECTION      BIT(4)
 168 #define TPS_DATA_STATUS_USB3_CONNECTION      BIT(5)
 169 #define TPS_DATA_STATUS_USB3_GEN2            BIT(6)
 170 #define TPS_DATA_STATUS_USB_DATA_ROLE        BIT(7)
 171 #define TPS_DATA_STATUS_DP_CONNECTION        BIT(8)
 172 #define TPS_DATA_STATUS_DP_SINK              BIT(9)
 173 #define TPS_DATA_STATUS_TBT_CONNECTION       BIT(16)
 174 #define TPS_DATA_STATUS_TBT_TYPE             BIT(17)
 175 #define TPS_DATA_STATUS_OPTICAL_CABLE        BIT(18)
 176 #define TPS_DATA_STATUS_ACTIVE_LINK_TRAIN    BIT(20)
 177 #define TPS_DATA_STATUS_FORCE_LSX            BIT(23)
 178 #define TPS_DATA_STATUS_POWER_MISMATCH       BIT(24)
 179
 180 #define TPS_DATA_STATUS_DP_PIN_ASSIGNMENT_MASK GENMASK(11, 10)
 181 #define TPS_DATA_STATUS_DP_PIN_ASSIGNMENT(x) \
 182         TPS_FIELD_GET(TPS_DATA_STATUS_DP_PIN_ASSIGNMENT_MASK, (x))
 183 #define TPS_DATA_STATUS_TBT_CABLE_SPEED_MASK   GENMASK(27, 25)
 184 #define TPS_DATA_STATUS_TBT_CABLE_SPEED \
 185         TPS_FIELD_GET(TPS_DATA_STATUS_TBT_CABLE_SPEED_MASK, (x))
 186 #define TPS_DATA_STATUS_TBT_CABLE_GEN_MASK     GENMASK(29, 28)
 187 #define TPS_DATA_STATUS_TBT_CABLE_GEN \
 188         TPS_FIELD_GET(TPS_DATA_STATUS_TBT_CABLE_GEN_MASK, (x))
 189
 190 /* Map data status to DP spec assignments */
 191 #define TPS_DATA_STATUS_DP_SPEC_PIN_ASSIGNMENT(x) \
 192         ((TPS_DATA_STATUS_DP_PIN_ASSIGNMENT(x) << 1) | \
 193                 TPS_FIELD_GET(TPS_DATA_STATUS_USB3_CONNECTION, (x)))
 194 #define TPS_DATA_STATUS_DP_SPEC_PIN_ASSIGNMENT_E    0
 195 #define TPS_DATA_STATUS_DP_SPEC_PIN_ASSIGNMENT_F    BIT(0)
 196 #define TPS_DATA_STATUS_DP_SPEC_PIN_ASSIGNMENT_C    BIT(1)
 197 #define TPS_DATA_STATUS_DP_SPEC_PIN_ASSIGNMENT_D    (BIT(1) | BIT(0))
 198 #define TPS_DATA_STATUS_DP_SPEC_PIN_ASSIGNMENT_A    BIT(2)
 199 #define TPS_DATA_STATUS_DP_SPEC_PIN_ASSIGNMENT_B    (BIT(2) | BIT(1))
 200
 201 #endif /* __TPS6598X_H__ */