tcpci.h 7.6 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240
  1. /* SPDX-License-Identifier: GPL-2.0+ */
  2. /*
  3. * Copyright 2015-2017 Google, Inc
  4. *
  5. * USB Type-C Port Controller Interface.
  6. */
  7. #ifndef __LINUX_USB_TCPCI_H
  8. #define __LINUX_USB_TCPCI_H
  9. #include <linux/usb/typec.h>
  10. #include <linux/usb/tcpm.h>
  11. #define TCPC_VENDOR_ID 0x0
  12. #define TCPC_PRODUCT_ID 0x2
  13. #define TCPC_BCD_DEV 0x4
  14. #define TCPC_TC_REV 0x6
  15. #define TCPC_PD_REV 0x8
  16. #define TCPC_PD_INT_REV 0xa
  17. #define TCPC_ALERT 0x10
  18. #define TCPC_ALERT_EXTND BIT(14)
  19. #define TCPC_ALERT_EXTENDED_STATUS BIT(13)
  20. #define TCPC_ALERT_VBUS_DISCNCT BIT(11)
  21. #define TCPC_ALERT_RX_BUF_OVF BIT(10)
  22. #define TCPC_ALERT_FAULT BIT(9)
  23. #define TCPC_ALERT_V_ALARM_LO BIT(8)
  24. #define TCPC_ALERT_V_ALARM_HI BIT(7)
  25. #define TCPC_ALERT_TX_SUCCESS BIT(6)
  26. #define TCPC_ALERT_TX_DISCARDED BIT(5)
  27. #define TCPC_ALERT_TX_FAILED BIT(4)
  28. #define TCPC_ALERT_RX_HARD_RST BIT(3)
  29. #define TCPC_ALERT_RX_STATUS BIT(2)
  30. #define TCPC_ALERT_POWER_STATUS BIT(1)
  31. #define TCPC_ALERT_CC_STATUS BIT(0)
  32. #define TCPC_ALERT_MASK 0x12
  33. #define TCPC_POWER_STATUS_MASK 0x14
  34. #define TCPC_FAULT_STATUS_MASK 0x15
  35. #define TCPC_EXTENDED_STATUS_MASK 0x16
  36. #define TCPC_EXTENDED_STATUS_MASK_VSAFE0V BIT(0)
  37. #define TCPC_ALERT_EXTENDED_MASK 0x17
  38. #define TCPC_SINK_FAST_ROLE_SWAP BIT(0)
  39. #define TCPC_CONFIG_STD_OUTPUT 0x18
  40. #define TCPC_TCPC_CTRL 0x19
  41. #define TCPC_TCPC_CTRL_ORIENTATION BIT(0)
  42. #define PLUG_ORNT_CC1 0
  43. #define PLUG_ORNT_CC2 1
  44. #define TCPC_TCPC_CTRL_BIST_TM BIT(1)
  45. #define TCPC_TCPC_CTRL_EN_LK4CONN_ALRT BIT(6)
  46. #define TCPC_EXTENDED_STATUS 0x20
  47. #define TCPC_EXTENDED_STATUS_VSAFE0V BIT(0)
  48. #define TCPC_ROLE_CTRL 0x1a
  49. #define TCPC_ROLE_CTRL_DRP BIT(6)
  50. #define TCPC_ROLE_CTRL_RP_VAL_SHIFT 4
  51. #define TCPC_ROLE_CTRL_RP_VAL_MASK 0x3
  52. #define TCPC_ROLE_CTRL_RP_VAL_DEF 0x0
  53. #define TCPC_ROLE_CTRL_RP_VAL_1_5 0x1
  54. #define TCPC_ROLE_CTRL_RP_VAL_3_0 0x2
  55. #define TCPC_ROLE_CTRL_CC2_SHIFT 2
  56. #define TCPC_ROLE_CTRL_CC2_MASK 0x3
  57. #define TCPC_ROLE_CTRL_CC1_SHIFT 0
  58. #define TCPC_ROLE_CTRL_CC1_MASK 0x3
  59. #define TCPC_ROLE_CTRL_CC_RA 0x0
  60. #define TCPC_ROLE_CTRL_CC_RP 0x1
  61. #define TCPC_ROLE_CTRL_CC_RD 0x2
  62. #define TCPC_ROLE_CTRL_CC_OPEN 0x3
  63. #define TCPC_FAULT_CTRL 0x1b
  64. #define TCPC_POWER_CTRL 0x1c
  65. #define TCPC_POWER_CTRL_VCONN_ENABLE BIT(0)
  66. #define TCPC_POWER_CTRL_BLEED_DISCHARGE BIT(3)
  67. #define TCPC_POWER_CTRL_AUTO_DISCHARGE BIT(4)
  68. #define TCPC_DIS_VOLT_ALRM BIT(5)
  69. #define TCPC_POWER_CTRL_VBUS_VOLT_MON BIT(6)
  70. #define TCPC_FAST_ROLE_SWAP_EN BIT(7)
  71. #define TCPC_CC_STATUS 0x1d
  72. #define TCPC_CC_STATUS_TOGGLING BIT(5)
  73. #define TCPC_CC_STATUS_TERM BIT(4)
  74. #define TCPC_CC_STATUS_TERM_RP 0
  75. #define TCPC_CC_STATUS_TERM_RD 1
  76. #define TCPC_CC_STATE_SRC_OPEN 0
  77. #define TCPC_CC_STATUS_CC2_SHIFT 2
  78. #define TCPC_CC_STATUS_CC2_MASK 0x3
  79. #define TCPC_CC_STATUS_CC1_SHIFT 0
  80. #define TCPC_CC_STATUS_CC1_MASK 0x3
  81. #define TCPC_POWER_STATUS 0x1e
  82. #define TCPC_POWER_STATUS_DBG_ACC_CON BIT(7)
  83. #define TCPC_POWER_STATUS_UNINIT BIT(6)
  84. #define TCPC_POWER_STATUS_SOURCING_VBUS BIT(4)
  85. #define TCPC_POWER_STATUS_VBUS_DET BIT(3)
  86. #define TCPC_POWER_STATUS_VBUS_PRES BIT(2)
  87. #define TCPC_POWER_STATUS_VCONN_PRES BIT(1)
  88. #define TCPC_POWER_STATUS_SINKING_VBUS BIT(0)
  89. #define TCPC_FAULT_STATUS 0x1f
  90. #define TCPC_FAULT_STATUS_ALL_REG_RST_TO_DEFAULT BIT(7)
  91. #define TCPC_ALERT_EXTENDED 0x21
  92. #define TCPC_COMMAND 0x23
  93. #define TCPC_CMD_WAKE_I2C 0x11
  94. #define TCPC_CMD_DISABLE_VBUS_DETECT 0x22
  95. #define TCPC_CMD_ENABLE_VBUS_DETECT 0x33
  96. #define TCPC_CMD_DISABLE_SINK_VBUS 0x44
  97. #define TCPC_CMD_SINK_VBUS 0x55
  98. #define TCPC_CMD_DISABLE_SRC_VBUS 0x66
  99. #define TCPC_CMD_SRC_VBUS_DEFAULT 0x77
  100. #define TCPC_CMD_SRC_VBUS_HIGH 0x88
  101. #define TCPC_CMD_LOOK4CONNECTION 0x99
  102. #define TCPC_CMD_RXONEMORE 0xAA
  103. #define TCPC_CMD_I2C_IDLE 0xFF
  104. #define TCPC_DEV_CAP_1 0x24
  105. #define TCPC_DEV_CAP_2 0x26
  106. #define TCPC_STD_INPUT_CAP 0x28
  107. #define TCPC_STD_OUTPUT_CAP 0x29
  108. #define TCPC_MSG_HDR_INFO 0x2e
  109. #define TCPC_MSG_HDR_INFO_DATA_ROLE BIT(3)
  110. #define TCPC_MSG_HDR_INFO_PWR_ROLE BIT(0)
  111. #define TCPC_MSG_HDR_INFO_REV_SHIFT 1
  112. #define TCPC_MSG_HDR_INFO_REV_MASK 0x3
  113. #define TCPC_RX_DETECT 0x2f
  114. #define TCPC_RX_DETECT_HARD_RESET BIT(5)
  115. #define TCPC_RX_DETECT_SOP BIT(0)
  116. #define TCPC_RX_DETECT_SOP1 BIT(1)
  117. #define TCPC_RX_DETECT_SOP2 BIT(2)
  118. #define TCPC_RX_DETECT_DBG1 BIT(3)
  119. #define TCPC_RX_DETECT_DBG2 BIT(4)
  120. #define TCPC_RX_BYTE_CNT 0x30
  121. #define TCPC_RX_BUF_FRAME_TYPE 0x31
  122. #define TCPC_RX_BUF_FRAME_TYPE_SOP 0
  123. #define TCPC_RX_HDR 0x32
  124. #define TCPC_RX_DATA 0x34 /* through 0x4f */
  125. #define TCPC_TRANSMIT 0x50
  126. #define TCPC_TRANSMIT_RETRY_SHIFT 4
  127. #define TCPC_TRANSMIT_RETRY_MASK 0x3
  128. #define TCPC_TRANSMIT_TYPE_SHIFT 0
  129. #define TCPC_TRANSMIT_TYPE_MASK 0x7
  130. #define TCPC_TX_BYTE_CNT 0x51
  131. #define TCPC_TX_HDR 0x52
  132. #define TCPC_TX_DATA 0x54 /* through 0x6f */
  133. #define TCPC_VBUS_VOLTAGE 0x70
  134. #define TCPC_VBUS_VOLTAGE_MASK 0x3ff
  135. #define TCPC_VBUS_VOLTAGE_LSB_MV 25
  136. #define TCPC_VBUS_SINK_DISCONNECT_THRESH 0x72
  137. #define TCPC_VBUS_SINK_DISCONNECT_THRESH_LSB_MV 25
  138. #define TCPC_VBUS_SINK_DISCONNECT_THRESH_MAX 0x3ff
  139. #define TCPC_VBUS_STOP_DISCHARGE_THRESH 0x74
  140. #define TCPC_VBUS_VOLTAGE_ALARM_HI_CFG 0x76
  141. #define TCPC_VBUS_VOLTAGE_ALARM_LO_CFG 0x78
  142. /* I2C_WRITE_BYTE_COUNT + 1 when TX_BUF_BYTE_x is only accessible I2C_WRITE_BYTE_COUNT */
  143. #define TCPC_TRANSMIT_BUFFER_MAX_LEN 31
  144. #define tcpc_presenting_rd(reg, cc) \
  145. (!(TCPC_ROLE_CTRL_DRP & (reg)) && \
  146. (((reg) & (TCPC_ROLE_CTRL_## cc ##_MASK << TCPC_ROLE_CTRL_## cc ##_SHIFT)) == \
  147. (TCPC_ROLE_CTRL_CC_RD << TCPC_ROLE_CTRL_## cc ##_SHIFT)))
  148. struct tcpci;
  149. /*
  150. * @TX_BUF_BYTE_x_hidden:
  151. * optional; Set when TX_BUF_BYTE_x can only be accessed through I2C_WRITE_BYTE_COUNT.
  152. * @frs_sourcing_vbus:
  153. * Optional; Callback to perform chip specific operations when FRS
  154. * is sourcing vbus.
  155. * @auto_discharge_disconnect:
  156. * Optional; Enables TCPC to autonously discharge vbus on disconnect.
  157. * @vbus_vsafe0v:
  158. * optional; Set when TCPC can detect whether vbus is at VSAFE0V.
  159. * @set_partner_usb_comm_capable:
  160. * Optional; The USB Communications Capable bit indicates if port
  161. * partner is capable of communication over the USB data lines
  162. * (e.g. D+/- or SS Tx/Rx). Called to notify the status of the bit.
  163. * @check_contaminant:
  164. * Optional; The callback is invoked when chiplevel drivers indicated
  165. * that the USB port needs to be checked for contaminant presence.
  166. * Chip level drivers are expected to check for contaminant and call
  167. * tcpm_clean_port when the port is clean to put the port back into
  168. * toggling state.
  169. */
  170. struct tcpci_data {
  171. struct regmap *regmap;
  172. unsigned char TX_BUF_BYTE_x_hidden:1;
  173. unsigned char auto_discharge_disconnect:1;
  174. unsigned char vbus_vsafe0v:1;
  175. int (*init)(struct tcpci *tcpci, struct tcpci_data *data);
  176. int (*set_vconn)(struct tcpci *tcpci, struct tcpci_data *data,
  177. bool enable);
  178. int (*start_drp_toggling)(struct tcpci *tcpci, struct tcpci_data *data,
  179. enum typec_cc_status cc);
  180. int (*set_vbus)(struct tcpci *tcpci, struct tcpci_data *data, bool source, bool sink);
  181. void (*frs_sourcing_vbus)(struct tcpci *tcpci, struct tcpci_data *data);
  182. void (*set_partner_usb_comm_capable)(struct tcpci *tcpci, struct tcpci_data *data,
  183. bool capable);
  184. void (*check_contaminant)(struct tcpci *tcpci, struct tcpci_data *data);
  185. };
  186. struct tcpci *tcpci_register_port(struct device *dev, struct tcpci_data *data);
  187. void tcpci_unregister_port(struct tcpci *tcpci);
  188. irqreturn_t tcpci_irq(struct tcpci *tcpci);
  189. struct tcpm_port;
  190. struct tcpm_port *tcpci_get_tcpm_port(struct tcpci *tcpci);
  191. static inline enum typec_cc_status tcpci_to_typec_cc(unsigned int cc, bool sink)
  192. {
  193. switch (cc) {
  194. case 0x1:
  195. return sink ? TYPEC_CC_RP_DEF : TYPEC_CC_RA;
  196. case 0x2:
  197. return sink ? TYPEC_CC_RP_1_5 : TYPEC_CC_RD;
  198. case 0x3:
  199. if (sink)
  200. return TYPEC_CC_RP_3_0;
  201. fallthrough;
  202. case 0x0:
  203. default:
  204. return TYPEC_CC_OPEN;
  205. }
  206. }
  207. #endif /* __LINUX_USB_TCPCI_H */