mfd: cros_ec: Complete Power and USB PD API
authorGwendal Grignou <gwendal@chromium.org>
Mon, 3 Jun 2019 18:33:50 +0000 (11:33 -0700)
committerLee Jones <lee.jones@linaro.org>
Mon, 10 Jun 2019 08:15:08 +0000 (09:15 +0100)
Improve API for USB Powe delivery and power management.

Signed-off-by: Gwendal Grignou <gwendal@chromium.org>
Acked-by: Enric Balletbo i Serra <enric.balletbo@collabora.com>
Acked-by: Benson Leung <bleung@chromium.org>
Reviewed-by: Fabien Lahoudere <fabien.lahoudere@collabora.com>
Signed-off-by: Lee Jones <lee.jones@linaro.org>
include/linux/mfd/cros_ec_commands.h

index 9a84aad7475ab03190c5776d7f54658bffcca3a5..e05cdcb124812190b4d0771d52ff3565e557f915 100644 (file)
@@ -2796,7 +2796,8 @@ struct ec_params_config_power_button {
 
 struct ec_params_usb_charge_set_mode {
        uint8_t usb_port_id;
-       uint8_t mode;
+       uint8_t mode:7;
+       uint8_t inhibit_charge:1;
 } __ec_align1;
 
 /*****************************************************************************/
@@ -3933,6 +3934,11 @@ enum charge_state_params {
        CS_PARAM_CHG_INPUT_CURRENT,   /* charger input current limit */
        CS_PARAM_CHG_STATUS,          /* charger-specific status */
        CS_PARAM_CHG_OPTION,          /* charger-specific options */
+       CS_PARAM_LIMIT_POWER,         /*
+                                      * Check if power is limited due to
+                                      * low battery and / or a weak external
+                                      * charger. READ ONLY.
+                                      */
        /* How many so far? */
        CS_NUM_BASE_PARAMS,
 
@@ -3940,6 +3946,17 @@ enum charge_state_params {
        CS_PARAM_CUSTOM_PROFILE_MIN = 0x10000,
        CS_PARAM_CUSTOM_PROFILE_MAX = 0x1ffff,
 
+       /* Range for CONFIG_CHARGE_STATE_DEBUG params */
+       CS_PARAM_DEBUG_MIN = 0x20000,
+       CS_PARAM_DEBUG_CTL_MODE = 0x20000,
+       CS_PARAM_DEBUG_MANUAL_MODE,
+       CS_PARAM_DEBUG_SEEMS_DEAD,
+       CS_PARAM_DEBUG_SEEMS_DISCONNECTED,
+       CS_PARAM_DEBUG_BATT_REMOVED,
+       CS_PARAM_DEBUG_MANUAL_CURRENT,
+       CS_PARAM_DEBUG_MANUAL_VOLTAGE,
+       CS_PARAM_DEBUG_MAX = 0x2ffff,
+
        /* Other custom param ranges go here... */
 };
 
@@ -4000,6 +4017,16 @@ struct ec_params_external_power_limit_v1 {
 
 #define EC_POWER_LIMIT_NONE 0xffff
 
+/*
+ * Set maximum voltage & current of a dedicated charge port
+ */
+#define EC_CMD_OVERRIDE_DEDICATED_CHARGER_LIMIT 0x00A3
+
+struct ec_params_dedicated_charger_limit {
+       uint16_t current_lim; /* in mA */
+       uint16_t voltage_lim; /* in mV */
+} __ec_align2;
+
 /* Inform the EC when entering a sleep state */
 #define EC_CMD_HOST_SLEEP_EVENT 0x00A9
 
@@ -4385,18 +4412,53 @@ struct ec_params_reboot_ec {
 
 /* EC to PD MCU exchange status command */
 #define EC_CMD_PD_EXCHANGE_STATUS 0x0100
+#define EC_VER_PD_EXCHANGE_STATUS 2
+
+enum pd_charge_state {
+       PD_CHARGE_NO_CHANGE = 0, /* Don't change charge state */
+       PD_CHARGE_NONE,          /* No charging allowed */
+       PD_CHARGE_5V,            /* 5V charging only */
+       PD_CHARGE_MAX            /* Charge at max voltage */
+};
 
 /* Status of EC being sent to PD */
+#define EC_STATUS_HIBERNATING  BIT(0)
+
 struct ec_params_pd_status {
-       int8_t batt_soc; /* battery state of charge */
+       uint8_t status;       /* EC status */
+       int8_t batt_soc;      /* battery state of charge */
+       uint8_t charge_state; /* charging state (from enum pd_charge_state) */
 } __ec_align1;
 
 /* Status of PD being sent back to EC */
+#define PD_STATUS_HOST_EVENT      BIT(0) /* Forward host event to AP */
+#define PD_STATUS_IN_RW           BIT(1) /* Running RW image */
+#define PD_STATUS_JUMPED_TO_IMAGE BIT(2) /* Current image was jumped to */
+#define PD_STATUS_TCPC_ALERT_0    BIT(3) /* Alert active in port 0 TCPC */
+#define PD_STATUS_TCPC_ALERT_1    BIT(4) /* Alert active in port 1 TCPC */
+#define PD_STATUS_TCPC_ALERT_2    BIT(5) /* Alert active in port 2 TCPC */
+#define PD_STATUS_TCPC_ALERT_3    BIT(6) /* Alert active in port 3 TCPC */
+#define PD_STATUS_EC_INT_ACTIVE  (PD_STATUS_TCPC_ALERT_0 | \
+                                     PD_STATUS_TCPC_ALERT_1 | \
+                                     PD_STATUS_HOST_EVENT)
 struct ec_response_pd_status {
-       int8_t status;        /* PD MCU status */
-       uint32_t curr_lim_ma; /* input current limit */
+       uint32_t curr_lim_ma;       /* input current limit */
+       uint16_t status;            /* PD MCU status */
+       int8_t active_charge_port;  /* active charging port */
 } __ec_align_size1;
 
+/* AP to PD MCU host event status command, cleared on read */
+#define EC_CMD_PD_HOST_EVENT_STATUS 0x0104
+
+/* PD MCU host event status bits */
+#define PD_EVENT_UPDATE_DEVICE     BIT(0)
+#define PD_EVENT_POWER_CHANGE      BIT(1)
+#define PD_EVENT_IDENTITY_RECEIVED BIT(2)
+#define PD_EVENT_DATA_SWAP         BIT(3)
+struct ec_response_host_event_status {
+       uint32_t status;      /* PD MCU host event status */
+} __ec_align4;
+
 /* Set USB type-C port role and muxes */
 #define EC_CMD_USB_PD_CONTROL 0x0101
 
@@ -4406,6 +4468,8 @@ enum usb_pd_control_role {
        USB_PD_CTRL_ROLE_TOGGLE_OFF = 2,
        USB_PD_CTRL_ROLE_FORCE_SINK = 3,
        USB_PD_CTRL_ROLE_FORCE_SOURCE = 4,
+       USB_PD_CTRL_ROLE_FREEZE = 5,
+       USB_PD_CTRL_ROLE_COUNT
 };
 
 enum usb_pd_control_mux {
@@ -4415,6 +4479,7 @@ enum usb_pd_control_mux {
        USB_PD_CTRL_MUX_DP = 3,
        USB_PD_CTRL_MUX_DOCK = 4,
        USB_PD_CTRL_MUX_AUTO = 5,
+       USB_PD_CTRL_MUX_COUNT
 };
 
 enum usb_pd_control_swap {
@@ -4444,6 +4509,13 @@ struct ec_params_usb_pd_control {
 #define PD_CTRL_RESP_ROLE_USB_COMM      BIT(5) /* Partner USB comm capable */
 #define PD_CTRL_RESP_ROLE_EXT_POWERED   BIT(6) /* Partner externally powerd */
 
+struct ec_response_usb_pd_control {
+       uint8_t enabled;
+       uint8_t role;
+       uint8_t polarity;
+       uint8_t state;
+} __ec_align1;
+
 struct ec_response_usb_pd_control_v1 {
        uint8_t enabled;
        uint8_t role;
@@ -4451,6 +4523,25 @@ struct ec_response_usb_pd_control_v1 {
        char state[32];
 } __ec_align1;
 
+/* Values representing usbc PD CC state */
+#define USBC_PD_CC_NONE                0 /* No accessory connected */
+#define USBC_PD_CC_NO_UFP      1 /* No UFP accessory connected */
+#define USBC_PD_CC_AUDIO_ACC   2 /* Audio accessory connected */
+#define USBC_PD_CC_DEBUG_ACC   3 /* Debug accessory connected */
+#define USBC_PD_CC_UFP_ATTACHED        4 /* UFP attached to usbc */
+#define USBC_PD_CC_DFP_ATTACHED        5 /* DPF attached to usbc */
+
+struct ec_response_usb_pd_control_v2 {
+       uint8_t enabled;
+       uint8_t role;
+       uint8_t polarity;
+       char state[32];
+       uint8_t cc_state; /* USBC_PD_CC_*Encoded cc state */
+       uint8_t dp_mode;  /* Current DP pin mode (MODE_DP_PIN_[A-E]) */
+       /* CL:1500994 Current cable type */
+       uint8_t reserved_cable_type;
+} __ec_align1;
+
 #define EC_CMD_USB_PD_PORTS 0x0102
 
 /* Maximum number of PD ports on a device, num_ports will be <= this */
@@ -4478,6 +4569,7 @@ enum usb_chg_type {
        USB_CHG_TYPE_OTHER,
        USB_CHG_TYPE_VBUS,
        USB_CHG_TYPE_UNKNOWN,
+       USB_CHG_TYPE_DEDICATED,
 };
 enum usb_power_roles {
        USB_PD_PORT_POWER_DISCONNECTED,
@@ -4502,9 +4594,6 @@ struct ec_response_usb_pd_power_info {
        uint32_t max_power;
 } __ec_align4;
 
-struct ec_params_usb_pd_info_request {
-       uint8_t port;
-} __ec_align1;
 
 /*
  * This command will return the number of USB PD charge port + the number
@@ -4516,6 +4605,46 @@ struct ec_response_charge_port_count {
        uint8_t port_count;
 } __ec_align1;
 
+/* Write USB-PD device FW */
+#define EC_CMD_USB_PD_FW_UPDATE 0x0110
+
+enum usb_pd_fw_update_cmds {
+       USB_PD_FW_REBOOT,
+       USB_PD_FW_FLASH_ERASE,
+       USB_PD_FW_FLASH_WRITE,
+       USB_PD_FW_ERASE_SIG,
+};
+
+struct ec_params_usb_pd_fw_update {
+       uint16_t dev_id;
+       uint8_t cmd;
+       uint8_t port;
+       uint32_t size;     /* Size to write in bytes */
+       /* Followed by data to write */
+} __ec_align4;
+
+/* Write USB-PD Accessory RW_HASH table entry */
+#define EC_CMD_USB_PD_RW_HASH_ENTRY 0x0111
+/* RW hash is first 20 bytes of SHA-256 of RW section */
+#define PD_RW_HASH_SIZE 20
+struct ec_params_usb_pd_rw_hash_entry {
+       uint16_t dev_id;
+       uint8_t dev_rw_hash[PD_RW_HASH_SIZE];
+       uint8_t reserved;        /*
+                                 * For alignment of current_image
+                                 * TODO(rspangler) but it's not aligned!
+                                 * Should have been reserved[2].
+                                 */
+       uint32_t current_image;  /* One of ec_current_image */
+} __ec_align1;
+
+/* Read USB-PD Accessory info */
+#define EC_CMD_USB_PD_DEV_INFO 0x0112
+
+struct ec_params_usb_pd_info_request {
+       uint8_t port;
+} __ec_align1;
+
 /* Read USB-PD Device discovery info */
 #define EC_CMD_USB_PD_DISCOVERY 0x0113
 struct ec_params_usb_pd_discovery_entry {
@@ -4538,7 +4667,11 @@ struct ec_params_charge_port_override {
        int16_t override_port; /* Override port# */
 } __ec_align2;
 
-/* Read (and delete) one entry of PD event log */
+/*
+ * Read (and delete) one entry of PD event log.
+ * TODO(crbug.com/751742): Make this host command more generic to accommodate
+ * future non-PD logs that use the same internal EC event_log.
+ */
 #define EC_CMD_PD_GET_LOG_ENTRY 0x0115
 
 struct ec_response_pd_log {
@@ -4626,6 +4759,60 @@ struct mcdp_info {
 #define MCDP_CHIPID(chipid) ((chipid[0] << 8) | chipid[1])
 #define MCDP_FAMILY(family) ((family[0] << 8) | family[1])
 
+/* Get/Set USB-PD Alternate mode info */
+#define EC_CMD_USB_PD_GET_AMODE 0x0116
+struct ec_params_usb_pd_get_mode_request {
+       uint16_t svid_idx; /* SVID index to get */
+       uint8_t port;      /* port */
+} __ec_align_size1;
+
+struct ec_params_usb_pd_get_mode_response {
+       uint16_t svid;   /* SVID */
+       uint16_t opos;    /* Object Position */
+       uint32_t vdo[6]; /* Mode VDOs */
+} __ec_align4;
+
+#define EC_CMD_USB_PD_SET_AMODE 0x0117
+
+enum pd_mode_cmd {
+       PD_EXIT_MODE = 0,
+       PD_ENTER_MODE = 1,
+       /* Not a command.  Do NOT remove. */
+       PD_MODE_CMD_COUNT,
+};
+
+struct ec_params_usb_pd_set_mode_request {
+       uint32_t cmd;  /* enum pd_mode_cmd */
+       uint16_t svid; /* SVID to set */
+       uint8_t opos;  /* Object Position */
+       uint8_t port;  /* port */
+} __ec_align4;
+
+/* Ask the PD MCU to record a log of a requested type */
+#define EC_CMD_PD_WRITE_LOG_ENTRY 0x0118
+
+struct ec_params_pd_write_log_entry {
+       uint8_t type; /* event type : see PD_EVENT_xx above */
+       uint8_t port; /* port#, or 0 for events unrelated to a given port */
+} __ec_align1;
+
+
+/* Control USB-PD chip */
+#define EC_CMD_PD_CONTROL 0x0119
+
+enum ec_pd_control_cmd {
+       PD_SUSPEND = 0,      /* Suspend the PD chip (EC: stop talking to PD) */
+       PD_RESUME,           /* Resume the PD chip (EC: start talking to PD) */
+       PD_RESET,            /* Force reset the PD chip */
+       PD_CONTROL_DISABLE,  /* Disable further calls to this command */
+       PD_CHIP_ON,          /* Power on the PD chip */
+};
+
+struct ec_params_pd_control {
+       uint8_t chip;         /* chip id */
+       uint8_t subcmd;
+} __ec_align1;
+
 /* Get info about USB-C SS muxes */
 #define EC_CMD_USB_PD_MUX_INFO 0x011A
 
@@ -4638,10 +4825,43 @@ struct ec_params_usb_pd_mux_info {
 #define USB_PD_MUX_DP_ENABLED        BIT(1) /* DP connected */
 #define USB_PD_MUX_POLARITY_INVERTED BIT(2) /* CC line Polarity inverted */
 #define USB_PD_MUX_HPD_IRQ           BIT(3) /* HPD IRQ is asserted */
+#define USB_PD_MUX_HPD_LVL           BIT(4) /* HPD level is asserted */
 
 struct ec_response_usb_pd_mux_info {
        uint8_t flags; /* USB_PD_MUX_*-encoded USB mux state */
 } __ec_align1;
+
+#define EC_CMD_PD_CHIP_INFO            0x011B
+
+struct ec_params_pd_chip_info {
+       uint8_t port;   /* USB-C port number */
+       uint8_t renew;  /* Force renewal */
+} __ec_align1;
+
+struct ec_response_pd_chip_info {
+       uint16_t vendor_id;
+       uint16_t product_id;
+       uint16_t device_id;
+       union {
+               uint8_t fw_version_string[8];
+               uint64_t fw_version_number;
+       };
+} __ec_align2;
+
+struct ec_response_pd_chip_info_v1 {
+       uint16_t vendor_id;
+       uint16_t product_id;
+       uint16_t device_id;
+       union {
+               uint8_t fw_version_string[8];
+               uint64_t fw_version_number;
+       };
+       union {
+               uint8_t min_req_fw_version_string[8];
+               uint64_t min_req_fw_version_number;
+       };
+} __ec_align2;
+
 /*****************************************************************************/
 /*
  * Reserve a range of host commands for board-specific, experimental, or