1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
|
/* Copyright 2019 The Chromium OS Authors. All rights reserved.
* Use of this source code is governed by a BSD-style license that can be
* found in the LICENSE file.
*/
#ifndef __CROS_EC_USB_COMMON_H
#define __CROS_EC_USB_COMMON_H
/* Functions that are shared between old and new PD stacks */
#include "usb_pd.h"
#include "usb_pd_tcpm.h"
enum pd_drp_next_states {
DRP_TC_DEFAULT,
DRP_TC_UNATTACHED_SNK,
DRP_TC_ATTACHED_WAIT_SNK,
DRP_TC_UNATTACHED_SRC,
DRP_TC_ATTACHED_WAIT_SRC,
DRP_TC_DRP_AUTO_TOGGLE
};
/**
* Returns the next state to transition to while in the drp auto toggle state.
*
* @param drp_sink_time timer for handling TOGGLE_OFF/FORCE_SINK mode when
* auto-toggle enabled. This is an in/out variable.
* @param power_role current power role
* @param drp_state dual role states
* @param cc1 value of CC1 set by tcpm_get_cc
* @param cc2 value of CC2 set by tcpm_get_cc
* @param auto_toggle_supported indicates hardware auto toggle support.
* Hardware auto toggle support will perform the
* unattached to attached debouncing before notifying
* us of a connection.
*
*/
enum pd_drp_next_states drp_auto_toggle_next_state(uint64_t *drp_sink_time,
enum pd_power_role power_role, enum pd_dual_role_states drp_state,
enum tcpc_cc_voltage_status cc1, enum tcpc_cc_voltage_status cc2,
bool auto_toggle_supported);
enum pd_pref_type {
/* prefer voltage larger than or equal to pd_pref_config.mv */
PD_PREFER_BUCK,
/* prefer voltage less than or equal to pd_pref_config.mv */
PD_PREFER_BOOST,
};
struct pd_pref_config_t {
/* Preferred PD voltage in mV */
int mv;
/* above which percent the battery is in constant voltage stage */
int cv;
/* System PLT (minimum consuming) power in mW. */
int plt_mw;
/* Preferred PD voltage pick strategy */
enum pd_pref_type type;
};
/*
* This function converts an 8 character ascii string with hex digits, without
* the 0x prefix, into a signed 32-bit number.
*
* @param str pointer to hex string to convert
* @param val pointer to where the integer version is stored
* @return EC_SUCCSSS on success else EC_ERROR_INVAL on failure
*/
int hex8tou32(char *str, uint32_t *val);
/*
* Flash a USB PD device using the ChromeOS Vendor Defined Command.
*
* @param argc number arguments in argv. Must be greater than 3.
* @param argv [1] is the usb port
* [2] unused
* [3] is the command {"erase", "rebooot", "signature",
* "info", "version", "write"}
* [4] if command was "write", then this will be the
* start of the data that will be written.
* @return EC_SUCCESS on success, else EC_ERROR_PARAM_COUNT or EC_ERROR_PARAM2
* on failure.
*/
int remote_flashing(int argc, char **argv);
/* Returns the battery percentage [0-100] of the system. */
int usb_get_battery_soc(void);
/*
* Returns type C current limit (mA), potentially with the DTS flag, based upon
* states of the CC lines on the partner side.
*
* @param polarity port polarity
* @param cc1 value of CC1 set by tcpm_get_cc
* @param cc2 value of CC2 set by tcpm_get_cc
* @return current limit (mA) with DTS flag set if appropriate
*/
typec_current_t usb_get_typec_current_limit(enum tcpc_cc_polarity polarity,
enum tcpc_cc_voltage_status cc1, enum tcpc_cc_voltage_status cc2);
/**
* Returns the polarity of a Sink.
*
* @param cc1 value of CC1 set by tcpm_get_cc
* @param cc2 value of CC2 set by tcpm_get_cc
* @return polarity
*/
enum tcpc_cc_polarity get_snk_polarity(enum tcpc_cc_voltage_status cc1,
enum tcpc_cc_voltage_status cc2);
/**
* Returns the polarity of a Source.
*
* @param cc1 value of CC1 set by tcpm_get_cc
* @param cc2 value of CC2 set by tcpm_get_cc
* @return polarity
*/
enum tcpc_cc_polarity get_src_polarity(enum tcpc_cc_voltage_status cc1,
enum tcpc_cc_voltage_status cc2);
/**
* Find PDO index that offers the most amount of power and stays within
* max_mv voltage.
*
* @param src_cap_cnt
* @param src_caps
* @param max_mv maximum voltage (or -1 if no limit)
* @param pdo raw pdo corresponding to index, or index 0 on error (output)
* @return index of PDO within source cap packet
*/
int pd_find_pdo_index(uint32_t src_cap_cnt, const uint32_t * const src_caps,
int max_mv, uint32_t *selected_pdo);
/**
* Extract power information out of a Power Data Object (PDO)
*
* @param pdo raw pdo to extract
* @param ma current of the PDO (output)
* @param mv voltage of the PDO (output)
*/
void pd_extract_pdo_power(uint32_t pdo, uint32_t *ma, uint32_t *mv);
/**
* Decide which PDO to choose from the source capabilities.
*
* @param vpd_vdo VPD VDO
* @param rdo requested Request Data Object.
* @param ma selected current limit (stored on success)
* @param mv selected supply voltage (stored on success)
* @param port USB-C port number
*/
void pd_build_request(int32_t vpd_vdo, uint32_t *rdo, uint32_t *ma,
uint32_t *mv, int port);
/**
* Notifies a task that is waiting on a system jump, that it's complete.
*/
void notify_sysjump_ready(void);
/**
* Set USB MUX with current data role
*
* @param port USB-C port number
*/
void set_usb_mux_with_current_data_role(int port);
/**
* Get the PD flags stored in BB Ram
*
* @param port USB-C port number
* @param flags pointer where flags are written to
* @return EC_SUCCESS on success
*/
int pd_get_saved_port_flags(int port, uint8_t *flags);
/**
* Update the flag in BB Ram with the give value
*
* @param port USB-C port number
* @param flag BB Ram flag to update
* @param do_set value written to the BB Ram flag
*/
void pd_update_saved_port_flags(int port, uint8_t flag, uint8_t do_set);
#endif /* __CROS_EC_USB_COMMON_H */
|
