usbc: tcpc: Add generic TCPCI related functions

Add generic functions that will be common to TCPCI compliant drivers.

Signed-off-by: Jianxiong Gu <[email protected]>

Author: recalci

drivers/usb_c/tcpc/tcpci.c

@@ -684,3 +684,54 @@ int tcpci_tcpm_mask_status_register(const struct i2c_dt_spec *bus, enum tcpc_sta
 		return -EINVAL;
 	}
 }
+
+int tcpci_tcpm_set_snk_ctrl(const struct i2c_dt_spec *bus, bool enable)
+{
+	return tcpci_write_reg8(bus, TCPC_REG_COMMAND,
+			enable ? TCPC_REG_COMMAND_SNK_CTRL_HIGH : TCPC_REG_COMMAND_SNK_CTRL_LOW);
+}
+
+int tcpci_tcpm_set_src_ctrl(const struct i2c_dt_spec *bus, bool enable)
+{
+	return tcpci_write_reg8(bus, TCPC_REG_COMMAND,
+			enable ? TCPC_REG_COMMAND_SRC_CTRL_DEF : TCPC_REG_COMMAND_SRC_CTRL_LOW);
+}
+
+int tcpci_tcpm_get_snk_ctrl(const struct i2c_dt_spec *bus, bool *sinking)
+{
+	uint16_t reg;
+	int ret;
+
+	ret = tcpci_tcpm_get_status_register(bus, TCPC_REG_POWER_STATUS, &reg);
+	if (ret == 0) {
+		*sinking = reg & TCPC_REG_POWER_STATUS_SINKING_VBUS;
+	}
+
+	return ret;
+}
+
+int tcpci_tcpm_get_src_ctrl(const struct i2c_dt_spec *bus, bool *sourcing)
+{
+	uint16_t reg;
+	int ret;
+
+	ret = tcpci_tcpm_get_status_register(bus, TCPC_REG_POWER_STATUS, &reg);
+	if (ret == 0) {
+		*sourcing = reg & TCPC_REG_POWER_STATUS_SOURCING_VBUS;
+	}
+
+	return ret;
+}
+
+int tcpci_tcpm_set_debug_accessory(const struct i2c_dt_spec *bus, bool enable)
+{
+	return tcpci_update_reg8(bus, TCPC_REG_CONFIG_STD_OUTPUT,
+				 TCPC_REG_CONFIG_STD_OUTPUT_DBG_ACC_CONN_N,
+				 enable ? 0 : TCPC_REG_CONFIG_STD_OUTPUT_DBG_ACC_CONN_N);
+}
+
+int tcpci_tcpm_set_low_power_mode(const struct i2c_dt_spec *bus, bool enable)
+{
+	return tcpci_write_reg8(bus, TCPC_REG_COMMAND,
+			enable ? TCPC_REG_COMMAND_I2CIDLE : TCPC_REG_COMMAND_WAKE_I2C);
+}

include/zephyr/drivers/usb_c/tcpci_priv.h

@@ -262,4 +262,62 @@ int tcpci_tcpm_clear_status_register(const struct i2c_dt_spec *bus, enum tcpc_st
 int tcpci_tcpm_mask_status_register(const struct i2c_dt_spec *bus, enum tcpc_status_reg reg,
 				    uint16_t mask);
 
+/**
+ * @brief Queries the current sinking state of the TCPCI.
+ *
+ * This function checks if the device is sinking VBUS to the system load.
+ *
+ * @param bus I2C bus
+ * @param sinking Pointer to variable where sinking state will be stored
+ * @return int Status of I2C operation, 0 in case of success
+ */
+int tcpci_tcpm_get_snk_ctrl(const struct i2c_dt_spec *bus, bool *sinking);
+
+/**
+ * @brief Queries the current sourcing state of the TCPCI.
+ *
+ * This function checks if the device is sourcing VBUS.
+ *
+ * @param bus I2C bus
+ * @param sourcing Pointer to variable where sourcing state will be stored
+ * @return int Status of I2C operation, 0 in case of success
+ */
+int tcpci_tcpm_get_src_ctrl(const struct i2c_dt_spec *bus, bool *sourcing);
+
+/**
+ * @brief Function to enable or disable sinking power over VBUS.
+ *
+ * @param bus I2C bus
+ * @param enable Boolean flag to enable (true) or disable (false) sinking power
+ * @return int Status of I2C operation, 0 in case of success
+ */
+int tcpci_tcpm_set_snk_ctrl(const struct i2c_dt_spec *bus, bool enable);
+
+/**
+ * @brief Function to enable or disable sourcing power over VBUS.
+ *
+ * @param bus I2C bus
+ * @param enable Boolean flag to enable (true) or disable (false) sourcing power
+ * @return int Status of I2C operation, 0 in case of success
+ */
+int tcpci_tcpm_set_src_ctrl(const struct i2c_dt_spec *bus, bool enable);
+
+/**
+ * @brief Function to enable or disable the debug accessory mode.
+ *
+ * @param bus I2C bus
+ * @param enable Boolean flag to enable (true) or disable (false) debug accessory mode
+ * @return int Status of I2C operation, 0 in case of success
+ */
+int tcpci_tcpm_set_debug_accessory(const struct i2c_dt_spec *bus, bool enable);
+
+/**
+ * @brief Function to enable or disable the low power mode.
+ *
+ * @param bus I2C bus
+ * @param enable Boolean flag to enable (true) or disable (false) low power mode
+ * @return int Status of I2C operation, 0 in case of success
+ */
+int tcpci_tcpm_set_low_power_mode(const struct i2c_dt_spec *bus, bool enable);
+
 #endif /* ZEPHYR_INCLUDE_DRIVERS_USBC_TCPCI_PRIV_H_ */