2022-12-28 01:34:20

by Prashant Malani

[permalink] [raw]
Subject: [PATCH 02/10] platform_chrome: cros_ec: Add Type-C VDM defines

Add the EC header changes need to support USB Type-C VDM (Vendor Defined
Messages) communication between the system and USB PD-enabled
peripherals.

The headers are already present in the EC code base, from which they've
been ported [1].

[1] https://source.chromium.org/chromium/chromiumos/platform/ec/+/main:include/ec_commands.h

Signed-off-by: Prashant Malani <[email protected]>
---
.../linux/platform_data/cros_ec_commands.h | 51 +++++++++++++++++++
1 file changed, 51 insertions(+)

diff --git a/include/linux/platform_data/cros_ec_commands.h b/include/linux/platform_data/cros_ec_commands.h
index 7c94bf5c8f05..6665e7da6ee2 100644
--- a/include/linux/platform_data/cros_ec_commands.h
+++ b/include/linux/platform_data/cros_ec_commands.h
@@ -1300,6 +1300,18 @@ enum ec_feature_code {
* mux.
*/
EC_FEATURE_TYPEC_MUX_REQUIRE_AP_ACK = 43,
+ /*
+ * The EC supports entering and residing in S4.
+ */
+ EC_FEATURE_S4_RESIDENCY = 44,
+ /*
+ * The EC supports the AP directing mux sets for the board.
+ */
+ EC_FEATURE_TYPEC_AP_MUX_SET = 45,
+ /*
+ * The EC supports the AP composing VDMs for us to send.
+ */
+ EC_FEATURE_TYPEC_AP_VDM_SEND = 46,
};

#define EC_FEATURE_MASK_0(event_code) BIT(event_code % 32)
@@ -5724,6 +5736,8 @@ enum typec_control_command {
TYPEC_CONTROL_COMMAND_ENTER_MODE,
TYPEC_CONTROL_COMMAND_TBT_UFP_REPLY,
TYPEC_CONTROL_COMMAND_USB_MUX_SET,
+ TYPEC_CONTROL_COMMAND_BIST_SHARE_MODE,
+ TYPEC_CONTROL_COMMAND_SEND_VDM_REQ,
};

/* Replies the AP may specify to the TBT EnterMode command as a UFP */
@@ -5737,6 +5751,17 @@ struct typec_usb_mux_set {
uint8_t mux_flags; /* USB_PD_MUX_*-encoded USB mux state to set */
} __ec_align1;

+#define VDO_MAX_SIZE 7
+
+struct typec_vdm_req {
+ /* VDM data, including VDM header */
+ uint32_t vdm_data[VDO_MAX_SIZE];
+ /* Number of 32-bit fields filled in */
+ uint8_t vdm_data_objects;
+ /* Partner to address - see enum typec_partner_type */
+ uint8_t partner_type;
+} __ec_align1;
+
struct ec_params_typec_control {
uint8_t port;
uint8_t command; /* enum typec_control_command */
@@ -5752,6 +5777,8 @@ struct ec_params_typec_control {
uint8_t mode_to_enter; /* enum typec_mode */
uint8_t tbt_ufp_reply; /* enum typec_tbt_ufp_reply */
struct typec_usb_mux_set mux_params;
+ /* Used for VMD_REQ */
+ struct typec_vdm_req vdm_req_params;
uint8_t placeholder[128];
};
} __ec_align1;
@@ -5833,6 +5860,8 @@ enum tcpc_cc_polarity {
#define PD_STATUS_EVENT_DISCONNECTED BIT(3)
#define PD_STATUS_EVENT_MUX_0_SET_DONE BIT(4)
#define PD_STATUS_EVENT_MUX_1_SET_DONE BIT(5)
+#define PD_STATUS_EVENT_VDM_REQ_REPLY BIT(6)
+#define PD_STATUS_EVENT_VDM_REQ_FAILED BIT(7)

struct ec_params_typec_status {
uint8_t port;
@@ -5876,6 +5905,28 @@ struct ec_response_typec_status {
uint32_t sink_cap_pdos[7]; /* Max 7 PDOs can be present */
} __ec_align1;

+/*
+ * Gather the response to the most recent VDM REQ from the AP
+ */
+#define EC_CMD_TYPEC_VDM_RESPONSE 0x013C
+
+struct ec_params_typec_vdm_response {
+ uint8_t port;
+} __ec_align1;
+
+struct ec_response_typec_vdm_response {
+ /* Number of 32-bit fields filled in */
+ uint8_t vdm_data_objects;
+ /* Partner to address - see enum typec_partner_type */
+ uint8_t partner_type;
+ /* Reserved */
+ uint16_t reserved;
+ /* VDM data, including VDM header */
+ uint32_t vdm_response[VDO_MAX_SIZE];
+} __ec_align1;
+
+#undef VDO_MAX_SIZE
+
/*****************************************************************************/
/* The command range 0x200-0x2FF is reserved for Rotor. */

--
2.39.0.314.g84b9a713c41-goog


2023-01-09 20:14:14

by Benson Leung

[permalink] [raw]
Subject: Re: [PATCH 02/10] platform_chrome: cros_ec: Add Type-C VDM defines

On Wed, Dec 28, 2022 at 12:45:05AM +0000, Prashant Malani wrote:
> Add the EC header changes need to support USB Type-C VDM (Vendor Defined
> Messages) communication between the system and USB PD-enabled
> peripherals.
>
> The headers are already present in the EC code base, from which they've
> been ported [1].
>
> [1] https://source.chromium.org/chromium/chromiumos/platform/ec/+/main:include/ec_commands.h
>
> Signed-off-by: Prashant Malani <[email protected]>

Reviewed-by: Benson Leung <[email protected]>

> ---
> .../linux/platform_data/cros_ec_commands.h | 51 +++++++++++++++++++
> 1 file changed, 51 insertions(+)
>
> diff --git a/include/linux/platform_data/cros_ec_commands.h b/include/linux/platform_data/cros_ec_commands.h
> index 7c94bf5c8f05..6665e7da6ee2 100644
> --- a/include/linux/platform_data/cros_ec_commands.h
> +++ b/include/linux/platform_data/cros_ec_commands.h
> @@ -1300,6 +1300,18 @@ enum ec_feature_code {
> * mux.
> */
> EC_FEATURE_TYPEC_MUX_REQUIRE_AP_ACK = 43,
> + /*
> + * The EC supports entering and residing in S4.
> + */
> + EC_FEATURE_S4_RESIDENCY = 44,
> + /*
> + * The EC supports the AP directing mux sets for the board.
> + */
> + EC_FEATURE_TYPEC_AP_MUX_SET = 45,
> + /*
> + * The EC supports the AP composing VDMs for us to send.
> + */
> + EC_FEATURE_TYPEC_AP_VDM_SEND = 46,
> };
>
> #define EC_FEATURE_MASK_0(event_code) BIT(event_code % 32)
> @@ -5724,6 +5736,8 @@ enum typec_control_command {
> TYPEC_CONTROL_COMMAND_ENTER_MODE,
> TYPEC_CONTROL_COMMAND_TBT_UFP_REPLY,
> TYPEC_CONTROL_COMMAND_USB_MUX_SET,
> + TYPEC_CONTROL_COMMAND_BIST_SHARE_MODE,
> + TYPEC_CONTROL_COMMAND_SEND_VDM_REQ,
> };
>
> /* Replies the AP may specify to the TBT EnterMode command as a UFP */
> @@ -5737,6 +5751,17 @@ struct typec_usb_mux_set {
> uint8_t mux_flags; /* USB_PD_MUX_*-encoded USB mux state to set */
> } __ec_align1;
>
> +#define VDO_MAX_SIZE 7
> +
> +struct typec_vdm_req {
> + /* VDM data, including VDM header */
> + uint32_t vdm_data[VDO_MAX_SIZE];
> + /* Number of 32-bit fields filled in */
> + uint8_t vdm_data_objects;
> + /* Partner to address - see enum typec_partner_type */
> + uint8_t partner_type;
> +} __ec_align1;
> +
> struct ec_params_typec_control {
> uint8_t port;
> uint8_t command; /* enum typec_control_command */
> @@ -5752,6 +5777,8 @@ struct ec_params_typec_control {
> uint8_t mode_to_enter; /* enum typec_mode */
> uint8_t tbt_ufp_reply; /* enum typec_tbt_ufp_reply */
> struct typec_usb_mux_set mux_params;
> + /* Used for VMD_REQ */
> + struct typec_vdm_req vdm_req_params;
> uint8_t placeholder[128];
> };
> } __ec_align1;
> @@ -5833,6 +5860,8 @@ enum tcpc_cc_polarity {
> #define PD_STATUS_EVENT_DISCONNECTED BIT(3)
> #define PD_STATUS_EVENT_MUX_0_SET_DONE BIT(4)
> #define PD_STATUS_EVENT_MUX_1_SET_DONE BIT(5)
> +#define PD_STATUS_EVENT_VDM_REQ_REPLY BIT(6)
> +#define PD_STATUS_EVENT_VDM_REQ_FAILED BIT(7)
>
> struct ec_params_typec_status {
> uint8_t port;
> @@ -5876,6 +5905,28 @@ struct ec_response_typec_status {
> uint32_t sink_cap_pdos[7]; /* Max 7 PDOs can be present */
> } __ec_align1;
>
> +/*
> + * Gather the response to the most recent VDM REQ from the AP
> + */
> +#define EC_CMD_TYPEC_VDM_RESPONSE 0x013C
> +
> +struct ec_params_typec_vdm_response {
> + uint8_t port;
> +} __ec_align1;
> +
> +struct ec_response_typec_vdm_response {
> + /* Number of 32-bit fields filled in */
> + uint8_t vdm_data_objects;
> + /* Partner to address - see enum typec_partner_type */
> + uint8_t partner_type;
> + /* Reserved */
> + uint16_t reserved;
> + /* VDM data, including VDM header */
> + uint32_t vdm_response[VDO_MAX_SIZE];
> +} __ec_align1;
> +
> +#undef VDO_MAX_SIZE
> +
> /*****************************************************************************/
> /* The command range 0x200-0x2FF is reserved for Rotor. */
>
> --
> 2.39.0.314.g84b9a713c41-goog
>
>

--
Benson Leung
Staff Software Engineer
Chrome OS Kernel
Google Inc.
[email protected]
Chromium OS Project
[email protected]


Attachments:
(No filename) (4.10 kB)
signature.asc (235.00 B)
Download all attachments