USBC Type-C Port Controller device APIs. More...

#include <zephyr/types.h>
#include <zephyr/device.h>
#include <errno.h>
#include "usbc_tc.h"
#include "usbc_pd.h"

Data Structures
struct	tcpc_chip_info
	TCPC Chip Information. More...

struct	tcpc_driver_api

Typedefs
typedef int(*	tcpc_vconn_control_cb_t) (const struct device *dev, enum tc_cc_polarity pol, bool enable)

typedef int(*	tcpc_vconn_discharge_cb_t) (const struct device *dev, enum tc_cc_polarity pol, bool enable)

typedef void(*	tcpc_alert_handler_cb_t) (const struct device dev, void data, enum tcpc_alert alert)

Enumerations
enum	tcpc_alert { TCPC_ALERT_CC_STATUS , TCPC_ALERT_POWER_STATUS , TCPC_ALERT_MSG_STATUS , TCPC_ALERT_HARD_RESET_RECEIVED , TCPC_ALERT_TRANSMIT_MSG_FAILED , TCPC_ALERT_TRANSMIT_MSG_DISCARDED , TCPC_ALERT_TRANSMIT_MSG_SUCCESS , TCPC_ALERT_VBUS_ALARM_HI , TCPC_ALERT_VBUS_ALARM_LO , TCPC_ALERT_FAULT_STATUS , TCPC_ALERT_RX_BUFFER_OVERFLOW , TCPC_ALERT_VBUS_SNK_DISCONNECT , TCPC_ALERT_BEGINNING_MSG_STATUS , TCPC_ALERT_EXTENDED_STATUS , TCPC_ALERT_EXTENDED , TCPC_ALERT_VENDOR_DEFINED }
	TCPC Alert bits. More...

enum	tcpc_status_reg { TCPC_CC_STATUS , TCPC_POWER_STATUS , TCPC_FAULT_STATUS , TCPC_EXTENDED_STATUS , TCPC_EXTENDED_ALERT_STATUS , TCPC_VENDOR_DEFINED_STATUS }
	TCPC Status register. More...

Functions
static int	tcpc_is_cc_rp (enum tc_cc_voltage_state cc)
	Returns whether the sink has detected a Rp resistor on the other side.

static int	tcpc_is_cc_open (enum tc_cc_voltage_state cc1, enum tc_cc_voltage_state cc2)
	Returns true if both CC lines are completely open.

static int	tcpc_is_cc_snk_dbg_acc (enum tc_cc_voltage_state cc1, enum tc_cc_voltage_state cc2)
	Returns true if we detect the port partner is a snk debug accessory.

static int	tcpc_is_cc_src_dbg_acc (enum tc_cc_voltage_state cc1, enum tc_cc_voltage_state cc2)
	Returns true if we detect the port partner is a src debug accessory.

static int	tcpc_is_cc_audio_acc (enum tc_cc_voltage_state cc1, enum tc_cc_voltage_state cc2)
	Returns true if the port partner is an audio accessory.

static int	tcpc_is_cc_at_least_one_rd (enum tc_cc_voltage_state cc1, enum tc_cc_voltage_state cc2)
	Returns true if the port partner is presenting at least one Rd.

static int	tcpc_is_cc_only_one_rd (enum tc_cc_voltage_state cc1, enum tc_cc_voltage_state cc2)
	Returns true if the port partner is presenting Rd on only one CC line.

static int	tcpc_init (const struct device *dev)
	Initializes the TCPC.

static int	tcpc_get_cc (const struct device dev, enum tc_cc_voltage_state cc1, enum tc_cc_voltage_state *cc2)
	Reads the status of the CC lines.

static int	tcpc_select_rp_value (const struct device *dev, enum tc_rp_value rp)
	Sets the value of CC pull up resistor used when operating as a Source.

static int	tcpc_get_rp_value (const struct device dev, enum tc_rp_value rp)
	Gets the value of the CC pull up resistor used when operating as a Source.

static int	tcpc_set_cc (const struct device *dev, enum tc_cc_pull pull)
	Sets the CC pull resistor and sets the role as either Source or Sink.

static void	tcpc_set_vconn_cb (const struct device *dev, tcpc_vconn_control_cb_t vconn_cb)
	Sets a callback that can enable or disable VCONN if the TCPC is unable to or the system is configured in a way that does not use the VCONN control capabilities of the TCPC.

static void	tcpc_set_vconn_discharge_cb (const struct device *dev, tcpc_vconn_discharge_cb_t cb)
	Sets a callback that can enable or discharge VCONN if the TCPC is unable to or the system is configured in a way that does not use the VCONN control capabilities of the TCPC.

static int	tcpc_vconn_discharge (const struct device *dev, bool enable)
	Discharges VCONN.

static int	tcpc_set_vconn (const struct device *dev, bool enable)
	Enables or disables VCONN.

static int	tcpc_set_roles (const struct device *dev, enum tc_power_role power_role, enum tc_data_role data_role)
	Sets the Power and Data Role of the PD message header.

static int	tcpc_get_rx_pending_msg (const struct device dev, struct pd_msg buf)
	Retrieves the Power Delivery message from the TCPC.

static int	tcpc_set_rx_enable (const struct device *dev, bool enable)
	Enables the reception of SOP* message types.

static int	tcpc_set_cc_polarity (const struct device *dev, enum tc_cc_polarity polarity)
	Sets the polarity of the CC lines.

static int	tcpc_transmit_data (const struct device dev, struct pd_msg msg)
	Transmits a Power Delivery message.

static int	tcpc_dump_std_reg (const struct device *dev)
	Dump a set of TCPC registers.

static int	tcpc_set_alert_handler_cb (const struct device dev, tcpc_alert_handler_cb_t handler, void data)
	Sets the alert function that's called when an interrupt is triggered due to an alert bit.

static int	tcpc_get_status_register (const struct device dev, enum tcpc_status_reg reg, int32_t status)
	Gets a status register.

static int	tcpc_clear_status_register (const struct device *dev, enum tcpc_status_reg reg, uint32_t mask)
	Clears a TCPC status register.

static int	tcpc_mask_status_register (const struct device *dev, enum tcpc_status_reg reg, uint32_t mask)
	Sets the mask of a TCPC status register.

static int	tcpc_set_debug_accessory (const struct device *dev, bool enable)
	Manual control of TCPC DebugAccessory control.

static int	tcpc_set_debug_detach (const struct device *dev)
	Detach from a debug connection.

static int	tcpc_set_drp_toggle (const struct device *dev, bool enable)
	Enable TCPC auto dual role toggle.

static int	tcpc_get_snk_ctrl (const struct device *dev)
	Queries the current sinking state of the TCPC.

static int	tcpc_set_snk_ctrl (const struct device *dev, bool enable)
	Set the VBUS sinking state of the TCPC.

static int	tcpc_get_src_ctrl (const struct device *dev)
	Queries the current sourcing state of the TCPC.

static int	tcpc_set_src_ctrl (const struct device *dev, bool enable)
	Set the VBUS sourcing state of the TCPC.

static int	tcpc_set_bist_test_mode (const struct device *dev, bool enable)
	Controls the BIST Mode of the TCPC.

static int	tcpc_get_chip_info (const struct device dev, struct tcpc_chip_info chip_info)
	Gets the TCPC firmware version.

static int	tcpc_set_low_power_mode (const struct device *dev, bool enable)
	Instructs the TCPC to enter or exit low power mode.

static int	tcpc_sop_prime_enable (const struct device *dev, bool enable)
	Enables the reception of SOP Prime messages.

Detailed Description

USBC Type-C Port Controller device APIs.

This file contains the USB Type-C Port Controller device APIs. All Type-C Port Controller device drivers should implement the APIs described in this file.

Data Structures

Typedefs

Enumerations

Functions

Detailed Description