17#include "../../../../src/system/driver/pd/tcpm_driver.h"
18#include "../../../../src/system/driver/pd/usb_pd_driver.h"
21#define MSEC_US (1000ul)
22#define SECOND_US (1000000ul)
23#define MINUTE_US (60000000ul)
24#define HOUR_US (3600000000ul)
27#define PD_HOST_COMMAND_TIMEOUT_US SECOND_US
32 PD_RX_ERR_HARD_RESET = -2,
35 PD_RX_ERR_UNSUPPORTED_SOP = -5,
36 PD_RX_ERR_CABLE_RESET = -6
40#define PD_EVENT_TX (1 << 3)
41#define PD_EVENT_CC (1 << 4)
42#define PD_EVENT_TCPC_RESET (1 << 5)
43#define PD_EVENT_UPDATE_DUAL_ROLE (1 << 6)
44#define PD_EVENT_DEVICE_ACCESSED (1 << 7)
45#define PD_EVENT_POWER_STATE_CHANGE (1 << 8)
46#define PD_EVENT_RX_HARD_RESET (1 << 11)
47#define PD_EVENT_RESET_ALLOWED (1 << 12)
50#define PDO_MAX_OBJECTS 7
51#define PDO_MODES (PDO_MAX_OBJECTS - 1)
65#define PDO_TYPE_FIXED (0 << 30)
66#define PDO_TYPE_BATTERY (1 << 30)
67#define PDO_TYPE_VARIABLE (2 << 30)
68#define PDO_TYPE_AUGMENTED (3 << 30)
69#define PDO_TYPE_MASK (3 << 30)
71#define PDO_FIXED_DUAL_ROLE (1L << 29)
72#define PDO_FIXED_SUSPEND (1L << 28)
73#define PDO_FIXED_EXTERNAL (1L << 27)
74#define PDO_FIXED_COMM_CAP (1L << 26)
75#define PDO_FIXED_DATA_SWAP (1L << 25)
76#define PDO_FIXED_PEAK_CURR ()
77#define PDO_FIXED_VOLT(mv) (((mv) / 50L) << 10)
78#define PDO_FIXED_CURR(ma) (((ma) / 10L) << 0)
80#define PDO_FIXED(mv, ma, flags) (PDO_FIXED_VOLT(mv) | PDO_FIXED_CURR(ma) | (flags))
82#define PDO_VAR_MAX_VOLT(mv) ((((mv) / 50L) & 0x3FF) << 20)
83#define PDO_VAR_MIN_VOLT(mv) ((((mv) / 50L) & 0x3FF) << 10)
84#define PDO_VAR_OP_CURR(ma) ((((ma) / 10L) & 0x3FF) << 0)
86#define PDO_VAR(min_mv, max_mv, op_ma) \
87 (PDO_VAR_MIN_VOLT(min_mv) | PDO_VAR_MAX_VOLT(max_mv) | PDO_VAR_OP_CURR(op_ma) | PDO_TYPE_VARIABLE)
89#define PDO_BATT_MAX_VOLT(mv) ((((mv) / 50L) & 0x3FF) << 20)
90#define PDO_BATT_MIN_VOLT(mv) ((((mv) / 50L) & 0x3FF) << 10)
91#define PDO_BATT_OP_POWER(mw) ((((mw) / 250L) & 0x3FF) << 0)
93#define PDO_BATT(min_mv, max_mv, op_mw) \
94 (PDO_BATT_MIN_VOLT(min_mv) | PDO_BATT_MAX_VOLT(max_mv) | PDO_BATT_OP_POWER(op_mw) | PDO_TYPE_BATTERY)
97#define RDO_OBJ_POS(n) (((n) & 0x7) << 28)
98#define RDO_POS(rdo) (((rdo) >> 28) & 0x7)
99#define RDO_GIVE_BACK (1 << 27)
100#define RDO_CAP_MISMATCH (1 << 26)
101#define RDO_COMM_CAP (1 << 25)
102#define RDO_NO_SUSPEND (1 << 24)
103#define RDO_FIXED_VAR_OP_CURR(ma) ((((ma) / 10) & 0x3FF) << 10)
104#define RDO_FIXED_VAR_MAX_CURR(ma) ((((ma) / 10) & 0x3FF) << 0)
106#define RDO_BATT_OP_POWER(mw) ((((mw) / 250) & 0x3FF) << 10)
107#define RDO_BATT_MAX_POWER(mw) ((((mw) / 250) & 0x3FF) << 10)
109#define RDO_FIXED(n, op_ma, max_ma, flags) \
110 (RDO_OBJ_POS(n) | (flags) | RDO_FIXED_VAR_OP_CURR(op_ma) | RDO_FIXED_VAR_MAX_CURR(max_ma))
112#define RDO_BATT(n, op_mw, max_mw, flags) \
113 (RDO_OBJ_POS(n) | (flags) | RDO_BATT_OP_POWER(op_mw) | RDO_BATT_MAX_POWER(max_mw))
116#define BDO_MODE_RECV (0 << 28)
117#define BDO_MODE_TRANSMIT (1 << 28)
118#define BDO_MODE_COUNTERS (2 << 28)
119#define BDO_MODE_CARRIER0 (3 << 28)
120#define BDO_MODE_CARRIER1 (4 << 28)
121#define BDO_MODE_CARRIER2 (5 << 28)
122#define BDO_MODE_CARRIER3 (6 << 28)
123#define BDO_MODE_EYE (7 << 28)
125#define BDO(mode, cnt) ((mode) | ((cnt) & 0xFFFF))
127#define SVID_DISCOVERY_MAX 16
130#define PD_T_SINK_TX (18 * MSEC_US)
131#define PD_T_CHUNKING_NOT_SUPPORTED (45 * MSEC_US)
132#define PD_T_CHUNK_SENDER_RSP (24 * MSEC_US)
133#define PD_T_CHUNK_SENDER_REQ (24 * MSEC_US)
134#define PD_T_HARD_RESET_COMPLETE (5 * MSEC_US)
135#define PD_T_HARD_RESET_RETRY (1 * MSEC_US)
136#define PD_T_SEND_SOURCE_CAP (100 * MSEC_US)
137#define PD_T_SINK_WAIT_CAP (600 * MSEC_US)
138#define PD_T_SINK_TRANSITION (35 * MSEC_US)
139#define PD_T_SRC_PS_RDY_MAX (400 * MSEC_US)
140#define PD_T_SOURCE_ACTIVITY (45 * MSEC_US)
141#define PD_T_SENDER_RESPONSE (30 * MSEC_US)
142#define PD_T_PS_TRANSITION (500 * MSEC_US)
143#define PD_T_PS_SOURCE_ON (480 * MSEC_US)
144#define PD_T_PS_SOURCE_OFF (920 * MSEC_US)
145#define PD_T_PS_HARD_RESET (25 * MSEC_US)
146#define PD_T_ERROR_RECOVERY (240 * MSEC_US)
147#define PD_T_CC_DEBOUNCE (100 * MSEC_US)
149#define PD_T_DRP_SNK (40 * MSEC_US)
150#define PD_T_DRP_SRC (30 * MSEC_US)
151#define PD_T_DEBOUNCE (15 * MSEC_US)
152#define PD_T_TRY_CC_DEBOUNCE (15 * MSEC_US)
153#define PD_T_SINK_ADJ (55 * MSEC_US)
154#define PD_T_SRC_RECOVER (760 * MSEC_US)
155#define PD_T_SRC_RECOVER_MAX (1000 * MSEC_US)
156#define PD_T_SRC_TURN_ON (275 * MSEC_US)
157#define PD_T_SAFE_0V (650 * MSEC_US)
158#define PD_T_NO_RESPONSE (5500 * MSEC_US)
159#define PD_T_BIST_TRANSMIT (50 * MSEC_US)
160#define PD_T_BIST_RECEIVE (60 * MSEC_US)
161#define PD_T_BIST_CONT_MODE (60 * MSEC_US)
162#define PD_T_VCONN_SOURCE_ON (100 * MSEC_US)
163#define PD_T_DRP_TRY (125 * MSEC_US)
164#define PD_T_TRY_TIMEOUT (550 * MSEC_US)
165#define PD_T_TRY_WAIT (600 * MSEC_US)
166#define PD_T_SINK_REQUEST (100 * MSEC_US)
167#define PD_T_PD_DEBOUNCE (15 * MSEC_US)
168#define PD_T_CHUNK_SENDER_RESPONSE (25 * MSEC_US)
169#define PD_T_CHUNK_SENDER_REQUEST (25 * MSEC_US)
170#define PD_T_SWAP_SOURCE_START (25 * MSEC_US)
171#define PD_T_RP_VALUE_CHANGE (20 * MSEC_US)
172#define PD_T_SRC_DISCONNECT (15 * MSEC_US)
173#define PD_T_VCONN_STABLE (50 * MSEC_US)
174#define PD_T_DISCOVER_IDENTITY (45 * MSEC_US)
175#define PD_T_SYSJUMP (1000 * MSEC_US)
176#define PD_T_PR_SWAP_WAIT (100 * MSEC_US)
178#define PD_T_SWAP_NEW_SRC_MAX (380 * MSEC_US)
181#define PD_RX_TRANSITION_COUNT 3
182#define PD_RX_TRANSITION_WINDOW 20
185#define PD_T_AME (1 * SECOND_US)
188#define PD_T_VDM_BUSY (100 * MSEC_US)
189#define PD_T_VDM_E_MODE (25 * MSEC_US)
190#define PD_T_VDM_RCVR_RSP (15 * MSEC_US)
191#define PD_T_VDM_SNDR_RSP (30 * MSEC_US)
192#define PD_T_VDM_WAIT_MODE_E (100 * MSEC_US)
194 enum pd_drp_next_states
197 DRP_TC_UNATTACHED_SNK,
198 DRP_TC_ATTACHED_WAIT_SNK,
199 DRP_TC_UNATTACHED_SRC,
200 DRP_TC_ATTACHED_WAIT_SRC,
201 DRP_TC_DRP_AUTO_TOGGLE
207 int (*status)(uint32_t* payload);
208 int (*config)(uint32_t* payload);
214 int (*identity)(uint32_t* payload);
215 int (*svids)(uint32_t* payload);
216 int (*modes)(uint32_t* payload);
217 int (*enter_mode)(uint32_t* payload);
218 int (*exit_mode)(uint32_t* payload);
226 uint32_t mode_vdo[PDO_MODES];
232 int (*enter)(uint32_t mode_caps);
233 int (*status)(uint32_t* payload);
234 int (*config)(uint32_t* payload);
235 void (*post_config)();
236 int (*attention)(uint32_t* payload);
245 extern const int supported_modes_cnt;
266#define DP_FLAGS_DP_ON (1 << 0)
267#define DP_FLAGS_HPD_HI_PENDING (1 << 1)
270 enum pd_alternate_modes
273 PD_AMODE_DISPLAYPORT,
286 uint32_t identity[PDO_MAX_OBJECTS - 1];
300#define VDO_MAX_SIZE 7
317#define VDO(vid, type, custom) (((vid) << 16) | ((type) << 15) | ((custom) & 0x7FFF))
319#define VDO_SVDM_TYPE (1 << 15)
320#define VDO_SVDM_VERS(x) (x << 13)
321#define VDO_OPOS(x) (x << 8)
322#define VDO_CMDT(x) (x << 6)
323#define VDO_OPOS_MASK VDO_OPOS(0x7)
324#define VDO_CMDT_MASK VDO_CMDT(0x3)
327#define CMDT_RSP_ACK 1
328#define CMDT_RSP_NAK 2
329#define CMDT_RSP_BUSY 3
332#define VDO_SRC_INITIATOR (0 << 5)
333#define VDO_SRC_RESPONDER (1 << 5)
335#define CMD_DISCOVER_IDENT 1
336#define CMD_DISCOVER_SVID 2
337#define CMD_DISCOVER_MODES 3
338#define CMD_ENTER_MODE 4
339#define CMD_EXIT_MODE 5
340#define CMD_ATTENTION 6
341#define CMD_DP_STATUS 16
342#define CMD_DP_CONFIG 17
344#define VDO_CMD_VENDOR(x) (((10 + (x)) & 0x1f))
347#define VDO_CMD_VERSION VDO_CMD_VENDOR(0)
348#define VDO_CMD_SEND_INFO VDO_CMD_VENDOR(1)
349#define VDO_CMD_READ_INFO VDO_CMD_VENDOR(2)
350#define VDO_CMD_REBOOT VDO_CMD_VENDOR(5)
351#define VDO_CMD_FLASH_ERASE VDO_CMD_VENDOR(6)
352#define VDO_CMD_FLASH_WRITE VDO_CMD_VENDOR(7)
353#define VDO_CMD_ERASE_SIG VDO_CMD_VENDOR(8)
354#define VDO_CMD_PING_ENABLE VDO_CMD_VENDOR(10)
355#define VDO_CMD_CURRENT VDO_CMD_VENDOR(11)
356#define VDO_CMD_FLIP VDO_CMD_VENDOR(12)
357#define VDO_CMD_GET_LOG VDO_CMD_VENDOR(13)
358#define VDO_CMD_CCD_EN VDO_CMD_VENDOR(14)
360#define PD_VDO_VID(vdo) ((vdo) >> 16)
361#define PD_VDO_SVDM(vdo) (((vdo) >> 15) & 1)
362#define PD_VDO_OPOS(vdo) (((vdo) >> 8) & 0x7)
363#define PD_VDO_CMD(vdo) ((vdo) & 0x1f)
364#define PD_VDO_CMDT(vdo) (((vdo) >> 6) & 0x3)
379#define VDO_INDEX_HDR 0
380#define VDO_INDEX_IDH 1
381#define VDO_INDEX_CSTAT 2
382#define VDO_INDEX_CABLE 3
383#define VDO_INDEX_PRODUCT 3
384#define VDO_INDEX_AMA 4
385#define VDO_I(name) VDO_INDEX_##name
397#define IDH_PTYPE_UNDEF 0
398#define IDH_PTYPE_HUB 1
399#define IDH_PTYPE_PERIPH 2
400#define IDH_PTYPE_PCABLE 3
401#define IDH_PTYPE_ACABLE 4
402#define IDH_PTYPE_AMA 5
404#define VDO_IDH(usbh, usbd, ptype, is_modal, vid) \
405 ((usbh) << 31 | (usbd) << 30 | ((ptype) & 0x7) << 27 | (is_modal) << 26 | ((vid) & 0xffff))
407#define PD_IDH_PTYPE(vdo) (((vdo) >> 27) & 0x7)
408#define PD_IDH_VID(vdo) ((vdo) & 0xffff)
416#define VDO_CSTAT(tid) ((tid) & 0xfffff)
417#define PD_CSTAT_TID(vdo) ((vdo) & 0xfffff)
425#define VDO_PRODUCT(pid, bcd) (((pid) & 0xffff) << 16 | ((bcd) & 0xffff))
426#define PD_PRODUCT_PID(vdo) (((vdo) >> 16) & 0xffff)
433#define INVALID_MSG_ID_COUNTER 0xff
450#define VDO_AMA(hw, fw, tx1d, tx2d, rx1d, rx2d, vcpwr, vcr, vbr, usbss) \
451 (((hw) & 0x7) << 28 | ((fw) & 0x7) << 24 | (tx1d) << 11 | (tx2d) << 10 | (rx1d) << 9 | (rx2d) << 8 | \
452 ((vcpwr) & 0x3) << 5 | (vcr) << 4 | (vbr) << 3 | ((usbss) & 0x7))
454#define PD_VDO_AMA_VCONN_REQ(vdo) (((vdo) >> 4) & 1)
455#define PD_VDO_AMA_VBUS_REQ(vdo) (((vdo) >> 3) & 1)
465#define VDO_SVID(svid0, svid1) (((svid0) & 0xffff) << 16 | ((svid1) & 0xffff))
466#define PD_VDO_SVID_SVID0(vdo) ((vdo) >> 16)
467#define PD_VDO_SVID_SVID1(vdo) ((vdo) & 0xffff)
481#define VDO_MODE_DP(snkp, srcp, usb, gdr, sign, sdir) \
482 (((snkp) & 0xff) << 16 | ((srcp) & 0xff) << 8 | ((usb) & 1) << 7 | ((gdr) & 1) << 6 | ((sign) & 0xF) << 2 | \
484#define PD_DP_PIN_CAPS(x) ((((x) >> 6) & 0x1) ? (((x) >> 16) & 0x3f) : (((x) >> 8) & 0x3f))
486#define MODE_DP_PIN_A 0x01
487#define MODE_DP_PIN_B 0x02
488#define MODE_DP_PIN_C 0x04
489#define MODE_DP_PIN_D 0x08
490#define MODE_DP_PIN_E 0x10
491#define MODE_DP_PIN_F 0x20
494#define MODE_DP_PIN_MF_MASK 0x2a
496#define MODE_DP_PIN_BR2_MASK 0x3
498#define MODE_DP_PIN_DP_MASK 0x3c
500#define MODE_DP_V13 0x1
501#define MODE_DP_GEN2 0x2
503#define MODE_DP_SNK 0x1
504#define MODE_DP_SRC 0x2
505#define MODE_DP_BOTH 0x3
521#define VDO_DP_STATUS(irq, lvl, amode, usbc, mf, en, lp, conn) \
522 (((irq) & 1) << 8 | ((lvl) & 1) << 7 | ((amode) & 1) << 6 | ((usbc) & 1) << 5 | ((mf) & 1) << 4 | ((en) & 1) << 3 | \
523 ((lp) & 1) << 2 | ((conn & 0x3) << 0))
525#define PD_VDO_DPSTS_HPD_IRQ(x) (((x) >> 8) & 1)
526#define PD_VDO_DPSTS_HPD_LVL(x) (((x) >> 7) & 1)
527#define PD_VDO_DPSTS_MF_PREF(x) (((x) >> 4) & 1)
530#define HPD_USTREAM_DEBOUNCE_LVL (2 * MSEC_US)
531#define HPD_USTREAM_DEBOUNCE_IRQ (250)
532#define HPD_DSTREAM_DEBOUNCE_IRQ (500)
545#define VDO_DP_CFG(pin, sig, cfg) (((pin) & 0xff) << 8 | ((sig) & 0xf) << 2 | ((cfg) & 0x3))
547#define PD_DP_CFG_DPON(x) (((x & 0x3) == 1) || ((x & 0x3) == 2))
553#define PD_DP_CFG_PIN(x) ((((x) >> 8) & 0xff) ? (((x) >> 8) & 0xff) : (((x) >> 16) & 0xff))
558#define USB_PD_HW_DEV_ID_RESERVED 0
559#define USB_PD_HW_DEV_ID_ZINGER 1
560#define USB_PD_HW_DEV_ID_MINIMUFFIN 2
561#define USB_PD_HW_DEV_ID_DINGDONG 3
562#define USB_PD_HW_DEV_ID_HOHO 4
563#define USB_PD_HW_DEV_ID_HONEYBUNS 5
573#define VDO_INFO(id, id_minor, ver, is_rw) \
574 ((id_minor) << 26 | ((id) & 0x3ff) << 16 | ((ver) & 0x7fff) << 1 | ((is_rw) & 1))
575#define VDO_INFO_HW_DEV_ID(x) ((x) >> 16)
576#define VDO_INFO_SW_DBG_VER(x) (((x) >> 1) & 0x7fff)
577#define VDO_INFO_IS_RW(x) ((x) & 1)
579#define HW_DEV_ID_MAJ(x) (x & 0x3ff)
580#define HW_DEV_ID_MIN(x) ((x) >> 10)
583#define USB_SID_PD 0xff00
584#define USB_SID_DISPLAYPORT 0xff01
586#define USB_GOOGLE_TYPEC_URL "http://www.google.com/chrome/devices/typec"
588#define USB_VID_GOOGLE 0x18d1
591#define USB_VID_APPLE 0x05ac
594#define USB_PD_RX_TMOUT_US 1800
602#ifdef CONFIG_USB_PD_DUAL_ROLE
603 PD_STATE_SNK_DISCONNECTED,
604 PD_STATE_SNK_DISCONNECTED_DEBOUNCE,
605 PD_STATE_SNK_HARD_RESET_RECOVER,
606 PD_STATE_SNK_DISCOVERY,
607 PD_STATE_SNK_REQUESTED,
608 PD_STATE_SNK_TRANSITION,
611 PD_STATE_SNK_SWAP_INIT,
612 PD_STATE_SNK_SWAP_SNK_DISABLE,
613 PD_STATE_SNK_SWAP_SRC_DISABLE,
614 PD_STATE_SNK_SWAP_STANDBY,
615 PD_STATE_SNK_SWAP_COMPLETE,
617 PD_STATE_SRC_SWAP_INIT,
618 PD_STATE_SRC_SWAP_SNK_DISABLE,
619 PD_STATE_SRC_SWAP_SRC_DISABLE,
620 PD_STATE_SRC_SWAP_STANDBY,
623 PD_STATE_SRC_DISCONNECTED,
624 PD_STATE_SRC_DISCONNECTED_DEBOUNCE,
625 PD_STATE_SRC_HARD_RESET_RECOVER,
626 PD_STATE_SRC_STARTUP,
627 PD_STATE_SRC_DISCOVERY,
628 PD_STATE_SRC_NEGOCIATE,
629 PD_STATE_SRC_ACCEPTED,
630 PD_STATE_SRC_POWERED,
631 PD_STATE_SRC_TRANSITION,
633 PD_STATE_SRC_GET_SINK_CAP,
636#ifdef CONFIG_USB_PD_DUAL_ROLE
637#ifdef CONFIG_USBC_VCONN_SWAP
638 PD_STATE_VCONN_SWAP_SEND,
639 PD_STATE_VCONN_SWAP_INIT,
640 PD_STATE_VCONN_SWAP_READY,
645 PD_STATE_HARD_RESET_SEND,
646 PD_STATE_HARD_RESET_EXECUTE,
647#ifdef CONFIG_COMMON_RUNTIME
652#ifdef CONFIG_USB_PD_DUAL_ROLE_AUTO_TOGGLE
653 PD_STATE_DRP_AUTO_TOGGLE,
660#define PD_FLAGS_PING_ENABLED (1 << 0)
661#define PD_FLAGS_PARTNER_DR_POWER (1 << 1)
662#define PD_FLAGS_PARTNER_DR_DATA (1 << 2)
663#define PD_FLAGS_CHECK_IDENTITY (1 << 3)
664#define PD_FLAGS_SNK_CAP_RECVD (1 << 4)
665#define PD_FLAGS_TCPC_DRP_TOGGLE (1 << 5)
666#define PD_FLAGS_EXPLICIT_CONTRACT (1 << 6)
667#define PD_FLAGS_VBUS_NEVER_LOW (1 << 7)
668#define PD_FLAGS_PREVIOUS_PD_CONN (1 << 8)
669#define PD_FLAGS_CHECK_PR_ROLE (1 << 9)
670#define PD_FLAGS_CHECK_DR_ROLE (1 << 10)
671#define PD_FLAGS_PARTNER_UNCONSTR (1 << 11)
672#define PD_FLAGS_VCONN_ON (1 << 12)
673#define PD_FLAGS_TRY_SRC (1 << 13)
674#define PD_FLAGS_PARTNER_USB_COMM (1 << 14)
675#define PD_FLAGS_UPDATE_SRC_CAPS (1 << 15)
676#define PD_FLAGS_TS_DTS_PARTNER (1 << 16)
684#ifdef CONFIG_USB_PD_TCPC_LOW_POWER
685#define PD_FLAGS_LPM_REQUESTED (1 << 17)
686#define PD_FLAGS_LPM_ENGAGED (1 << 18)
687#define PD_FLAGS_LPM_TRANSITION (1 << 19)
688#define PD_FLAGS_LPM_EXIT (1 << 19)
694#define PD_FLAGS_SNK_WAITING_BATT (1 << 21)
696#define PD_FLAGS_CHECK_VCONN_STATE (1 << 22)
698#ifdef CONFIG_USB_PD_DUAL_ROLE
701#define PD_BBRMFLG_EXPLICIT_CONTRACT (1 << 0)
702#define PD_BBRMFLG_POWER_ROLE (1 << 1)
703#define PD_BBRMFLG_DATA_ROLE (1 << 2)
704#define PD_BBRMFLG_VCONN_ROLE (1 << 3)
705#define PD_BBRMFLG_DBGACC_ROLE (1 << 4)
708#define PD_CC_UNSET -1
710 enum pd_dual_role_states
728 enum pd_dual_role_states pd_get_dual_role(
void);
730#ifndef CONFIG_CHARGER
734 int board_get_battery_soc();
737 void pd_set_dual_role_no_wakeup(
enum pd_dual_role_states state);
745 void pd_set_dual_role(
enum pd_dual_role_states state);
757 enum pd_ctrl_msg_type
760 PD_CTRL_GOOD_CRC = 1,
761 PD_CTRL_GOTO_MIN = 2,
766 PD_CTRL_GET_SOURCE_CAP = 7,
767 PD_CTRL_GET_SINK_CAP = 8,
769 PD_CTRL_PR_SWAP = 10,
770 PD_CTRL_VCONN_SWAP = 11,
772 PD_CTRL_SOFT_RESET = 13,
776 PD_CTRL_NOT_SUPPORTED = 16,
777 PD_CTRL_GET_SOURCE_CAP_EXT = 17,
778 PD_CTRL_GET_STATUS = 18,
779 PD_CTRL_FR_SWAP = 19,
780 PD_CTRL_GET_PPS_STATUS = 20,
781 PD_CTRL_GET_COUNTRY_CODES = 21,
786#define PD_CTRL_AMS_START_MASK \
787 ((1 << PD_CTRL_GOTO_MIN) | (1 << PD_CTRL_GET_SOURCE_CAP) | (1 << PD_CTRL_GET_SINK_CAP) | (1 << PD_CTRL_DR_SWAP) | \
788 (1 << PD_CTRL_PR_SWAP) | (1 << PD_CTRL_VCONN_SWAP) | (1 << PD_CTRL_GET_SOURCE_CAP_EXT) | \
789 (1 << PD_CTRL_GET_STATUS) | (1 << PD_CTRL_FR_SWAP) | (1 << PD_CTRL_GET_PPS_STATUS) | \
790 (1 << PD_CTRL_GET_COUNTRY_CODES))
793#define BSDO_CAP_UNKNOWN 0xffff
794#define BSDO_CAP(n) (((n) & 0xffff) << 16)
795#define BSDO_INVALID (1 << 8)
796#define BSDO_PRESENT (1 << 9)
797#define BSDO_DISCHARGING (1 << 10)
798#define BSDO_IDLE (1 << 11)
801#define BATT_CAP_REF(n) (((n) >> 16) & 0xff)
807 PD_EXT_SOURCE_CAP = 1,
809 PD_EXT_GET_BATTERY_CAP = 3,
810 PD_EXT_GET_BATTERY_STATUS = 4,
811 PD_EXT_BATTERY_CAP = 5,
812 PD_EXT_GET_MANUFACTURER_INFO = 6,
813 PD_EXT_MANUFACTURER_INFO = 7,
814 PD_EXT_SECURITY_REQUEST = 8,
815 PD_EXT_SECURITY_RESPONSE = 9,
816 PD_EXT_FIRMWARE_UPDATE_REQUEST = 10,
817 PD_EXT_FIRMWARE_UPDATE_RESPONSE = 11,
818 PD_EXT_PPS_STATUS = 12,
819 PD_EXT_COUNTRY_INFO = 13,
820 PD_EXT_COUNTRY_CODES = 14,
825 enum pd_data_msg_type
828 PD_DATA_SOURCE_CAP = 1,
831 PD_DATA_SINK_CAP = 4,
833 PD_DATA_BATTERY_STATUS = 5,
835 PD_DATA_GET_COUNTRY_INFO = 7,
837 PD_DATA_ENTER_USB = 8,
838 PD_DATA_VENDOR_DEF = 15,
847 PD_PLUG_FROM_DFP_UFP = 0,
848 PD_PLUG_FROM_CABLE = 1
854 CABLE_RECEPTACLE = 1,
863#define PD_ROLE_SINK 0
864#define PD_ROLE_SOURCE 1
869#define PD_ROLE_VCONN_OFF 0
870#define PD_ROLE_VCONN_ON 1
873#define CHUNK_RESPONSE 0
874#define CHUNK_REQUEST 1
881#define SINK_TX_OK TYPEC_RP_3A0
882#define SINK_TX_NG TYPEC_RP_1A5
885#ifndef PD_ROLE_DEFAULT
886#ifdef CONFIG_USB_PD_DUAL_ROLE
887#define PD_ROLE_DEFAULT() PD_ROLE_SINK
889#define PD_ROLE_DEFAULT() PD_ROLE_SOURCE
894#ifdef CONFIG_USB_PD_DUAL_ROLE
895#define PD_DEFAULT_STATE() \
896 ((PD_ROLE_DEFAULT() == PD_ROLE_SOURCE) ? PD_STATE_SRC_DISCONNECTED : PD_STATE_SNK_DISCONNECTED)
898#define PD_DEFAULT_STATE() PD_STATE_SRC_DISCONNECTED
903#define PD_EXT_HEADER(cnum, rchk, dsize) ((1 << 15) | ((cnum) << 11) | ((rchk) << 10) | (dsize))
906#define PD_HEADER(type, prole, drole, id, cnt, rev, ext) \
907 ((type) | ((rev) << 6) | ((drole) << 5) | ((prole) << 8) | ((id) << 9) | ((cnt) << 12) | ((ext) << 15))
910#define PD_HEADER_EXT(header) (((header) >> 15) & 1)
911#define PD_HEADER_CNT(header) (((header) >> 12) & 7)
916#define PD_HEADER_TYPE(header) ((header) & 0x1F)
917#define PD_HEADER_ID(header) (((header) >> 9) & 7)
918#define PD_HEADER_PROLE(header) (((header) >> 8) & 1)
919#define PD_HEADER_REV(header) (((header) >> 6) & 3)
920#define PD_HEADER_DROLE(header) (((header) >> 5) & 1)
927#define PD_HEADER_GET_SOP(header) (((header) >> 28) & 0xf)
928#define PD_HEADER_SOP(sop) (((sop) & 0xf) << 28)
934 PD_MSG_SOP_PRIME_PRIME,
935 PD_MSG_SOP_DBG_PRIME,
936 PD_MSG_SOP_DBG_PRIME_PRIME,
941#define PD_EXT_HEADER_CHUNKED(header) (((header) >> 15) & 1)
942#define PD_EXT_HEADER_CHUNK_NUM(header) (((header) >> 11) & 0xf)
943#define PD_EXT_HEADER_REQ_CHUNK(header) (((header) >> 10) & 1)
944#define PD_EXT_HEADER_DATA_SIZE(header) ((header) & 0x1ff)
958#define PD_MIN_MV 5000
961#define PD_SRC_DEF_VNC_MV 1600
962#define PD_SRC_1_5_VNC_MV 1600
963#define PD_SRC_3_0_VNC_MV 2600
966#define PD_SRC_DEF_RD_THRESH_MV 200
967#define PD_SRC_1_5_RD_THRESH_MV 400
968#define PD_SRC_3_0_RD_THRESH_MV 800
971#define PD_SNK_VA_MV 250
982#ifdef CONFIG_USB_PD_REV30
997 int pd_get_vdo_ver();
999#define pd_get_rev(n) PD_REV20
1000#define pd_get_vdo_ver(n) VDM_VER10
1012 int pd_build_request(uint32_t* rdo, uint32_t* ma, uint32_t* mv,
enum pd_request_type req_type);
1020 int pd_is_max_request_allowed(
void);
1026 int tcpm_enqueue_message();
1027 int tcpm_has_pending_message();
1028 int tcpm_dequeue_message(uint32_t*
const payload,
int*
const header);
1029 void tcpm_clear_pending_messages();
1031 int consume_sop_prime_repeat_msg(uint8_t msg_id);
1032 int consume_sop_prime_prime_repeat_msg(uint8_t msg_id);
1033 void reset_pd_cable();
1042 void pd_process_source_cap_callback(
int cnt, uint32_t* src_caps);
1051 void pd_process_source_cap(
int cnt, uint32_t* src_caps);
1062 int pd_find_pdo_index(
int max_mv, uint32_t* pdo);
1069 int is_sink_ready();
1075 int is_sink_negotiating();
1081 int is_sink_hard_resetting();
1093 int is_power_role_swapping();
1106 uint32_t soft_resets_failed;
1109 uint32_t hard_resets_tx_failed;
1116 uint32_t src_caps_acked;
1121 uint32_t pr_swaps_rejected;
1124 uint32_t pr_swaps_to_sink;
1130 uint32_t pd_get_last_run_ms(
void);
1137 int is_explicit_contract;
1140 int is_vbus_never_low;
1143 uint32_t requested_ma;
1157 void pd_set_reset_allowed(
int allowed);
1159 int pd_is_reset_allowed();
1166 const char* get_state_cstr();
1175 void pd_extract_pdo_power(uint32_t pdo, uint32_t* ma, uint32_t* mv);
1184 void pd_snk_give_back(uint32_t*
const ma, uint32_t*
const mv);
1190 void pd_set_max_voltage(
unsigned mv);
1196 unsigned pd_get_max_voltage(
void);
1204 int pd_is_valid_input_voltage(
int mv);
1213 int pd_check_requested_voltage(uint32_t rdo);
1222 int pd_board_check_request(uint32_t rdo,
int pdo_cnt);
1229 void pd_transition_voltage(
int idx);
1236 void pd_power_supply_reset();
1244 int pd_set_power_supply_ready();
1251 int pd_is_source_voltage_ready();
1260 void pd_request_source_voltage(
int mv);
1269 void pd_set_external_voltage_limit(
int mv);
1278 void pd_set_input_current_limit(uint32_t max_ma, uint32_t supply_voltage);
1285 void pd_update_contract();
1288 typedef uint32_t typec_current_t;
1289#define TYPEC_CURRENT_DTS_MASK (1 << 31)
1290#define TYPEC_CURRENT_ILIM_MASK (~TYPEC_CURRENT_DTS_MASK)
1299 void typec_set_input_current_limit(typec_current_t max_ma, uint32_t supply_voltage);
1307 void typec_set_source_current_limit(
int rp);
1314 int pd_board_checks(
void);
1329 int pd_is_power_swap_succesful();
1338 int pd_check_data_swap(
int data_role);
1347 int pd_check_vconn_swap();
1356 void pd_check_pr_role(
int pr_role,
int flags);
1362 void pd_request_pr_role_check();
1371 void pd_check_dr_role(
int dr_role,
int flags);
1379 void pd_execute_data_swap(
int data_role);
1386 void pd_get_info(uint32_t* info_data);
1397 int pd_custom_vdm(
int cnt, uint32_t* payload, uint32_t** rpayload);
1408 int pd_svdm(
int cnt, uint32_t* payload, uint32_t** rpayload);
1418 uint32_t pd_dfp_enter_mode(uint16_t svid,
int opos);
1428 int pd_dfp_exit_mode(uint16_t svid,
int opos);
1435 void pd_dfp_pe_init();
1443 uint16_t pd_get_identity_vid();
1455 int pd_dev_store_rw_hash(uint16_t dev_id, uint32_t* rw_hash, uint32_t ec_current_image);
1466 void pd_send_vdm(uint32_t vid,
int cmd,
const uint32_t* data,
int count);
1469 extern const uint32_t pd_src_pdo[];
1470 extern const int pd_src_pdo_cnt;
1471 extern const uint32_t pd_snk_pdo[];
1472 extern const int pd_snk_pdo_cnt;
1479#if defined(HAS_TASK_HOSTCMD) && !defined(TEST_BUILD)
1480 void pd_send_host_event(
int mask);
1482static inline void pd_send_host_event(
int mask) {}
1492 int pd_alt_mode(uint16_t svid);
1500 void pd_send_hpd(
enum hpd_event hpd);
1505 extern const struct deferred_data pd_usb_billboard_deferred_data;
1519 void pd_set_suspend(
int enable);
1528 int pd_is_port_enabled();
1531 void pd_rx_disable_monitoring();
1538 void pd_hw_release();
1546 void pd_hw_init(
int role);
1558 void pd_run_state_machine();
1567 int pd_comm_is_enabled();
1575 int pd_is_connected();
1582 int pd_is_vbus_present();
1589 void pd_execute_hard_reset();
1597 void pd_transmit_complete(
int status);
1604 enum pd_data_role pd_get_data_role();
1611 enum pd_power_role pd_get_power_role();
1618 int pd_is_battery_capable(
void);
1625 int pd_is_try_source_capable(
void);
1632 void pd_request_vconn_swap();
1640 enum pd_cc_states pd_get_task_cc_state();
1650 uint8_t pd_get_task_state();
1658 const char* pd_get_task_state_name();
1666 int pd_get_vconn_state();
1674 int pd_get_partner_dual_role_power();
1682 int pd_get_partner_unconstr_power();
1689 int pd_get_polarity();
1696 int pd_get_partner_data_swap_capable();
1698 int pd_is_disconnected();
1705 void pd_request_power_swap();
1713 void pd_try_vconn_src();
1720 void pd_request_data_swap();
1730 void pd_comm_enable(
int enable);
1740 void pd_ping_enable(
int enable);
1743 void pd_soft_reset(
void);
1750 void pd_set_new_power_request();
1758 int pd_ts_dts_plugged();
1761 static inline void pd_log_event(uint8_t type, uint8_t size_port, uint16_t data,
void* payload) {}
1762 static inline int pd_vdm_get_log_entry(uint32_t* payload) {
return 0; }
bool is_source_hard_resetting()
return true when we are a source in a hard reset: VBUS must be cut until the end of the recovery time
Definition: power_delivery.cpp:644
Details on the current contract, for debug.
Definition: usb_pd.h:1134
int is_pd_capable
the partner sent at least one PD message
Definition: usb_pd.h:1139
uint32_t requested_mv
last request sent (contract when an explicit contract is in place)
Definition: usb_pd.h:1142
int hard_reset_count
hard resets sent since the attach
Definition: usb_pd.h:1145
Debug counters of the PD negociation events, since boot.
Definition: usb_pd.h:1097
uint32_t hard_resets_received
hard resets received from the partner
Definition: usb_pd.h:1111
uint32_t src_contracts
contracts established as source (PS_RDY sent and acknowledged)
Definition: usb_pd.h:1118
uint32_t hard_resets_sent
hard resets sent, and the ones whose transmission never completed (assumed sent, as the spec says)
Definition: usb_pd.h:1108
uint32_t pr_swaps_to_source
power role swaps completed: we became the source, we became the sink
Definition: usb_pd.h:1123
uint32_t src_caps_received
source capabilities messages received (and answered with a request)
Definition: usb_pd.h:1101
uint32_t src_caps_sent
source capabilities sent while we are source, and the ones acknowledged by a GoodCRC
Definition: usb_pd.h:1115
uint32_t contracts
contracts established as sink (PS_RDY received)
Definition: usb_pd.h:1103
uint32_t attaches
source attached (CC debounced, VBUS present)
Definition: usb_pd.h:1099
uint32_t src_attaches
sink attached while we are source (CC debounced)
Definition: usb_pd.h:1113
uint32_t soft_resets_sent
soft resets sent, and the ones that were not acknowledged
Definition: usb_pd.h:1105
uint32_t pr_swaps_vbus_timeout
swaps to source abandoned because our VBUS did not come up in time
Definition: usb_pd.h:1126
uint32_t pr_swaps_accepted
power role swaps requested by the partner: accepted, rejected
Definition: usb_pd.h:1120