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
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
|
# Copyright 2020 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.
menuconfig PLATFORM_EC_USBC
bool "USB Type-C"
default y if PLATFORM_EC_BATTERY
help
Enable this to support various USB Type-C features chosen by the
options below. USB-C is widely used on modern Chromebooks and the EC's
role is to negotiate power contracts (for sourcing or sinking power
over USB). The EC is also responsible for discovering the capabilities
of attached USB-C partners and enabling alternate operational modes,
including Display Port, Thunderbolt, and USB4.
if PLATFORM_EC_USBC
config PLATFORM_EC_CHARGE_MANAGER
bool "Charge manager"
default y
help
The EC charge manager manages charging the battery from all supported
power sources. This includes dedicated charge ports (such as a
barrel jack connector), BC1.2 (Battery Charging 1.2) sources, and
USB-C sources. When multiple charge sources are connected to a
Chromebook simultaneously, the charge manager is responsible for
picking the best source.
Note that the charge manager assumes that at least one USB-C power
source is available on the hardware, so cannot be built without
PLATFORM_EC_USBC.
config PLATFORM_EC_CHARGER_INPUT_CURRENT
int "Charger input current in mA"
depends on PLATFORM_EC_CHARGE_MANAGER
default 512
help
This is the default input current for the board in mA. Many boards
also use this as the least maximum input current during transients.
This value should depend on external power adapter, designed charging
voltage, and the maximum power of the running system. For type-C
chargers, this should be set to 512 mA in order to not brown-out
low-current USB charge ports in accordance with USB-PD r3.0 Sec. 7.3
config PLATFORM_EC_USBC_OCP
bool
help
USB-C overcurrent protection: Enable this to detect when a connected
USB-C partner draws too much power from the Chromebook and
automatically shut off power to the USB-C partner.
This should be enabled by drivers which can detect over-current. It
cannot be set otherwise, even in prj.conf
config PLATFORM_EC_USB_PID
hex "USB Product ID"
help
Each platform (e.g. baseboard set) should have a single VID/PID
combination. If there is a big enough change within a platform,
then we can differentiate USB topologies by varying the hardware
version field in the Sink and Source Capabilities Extended messages.
To reserve a new PID within Google, use go/usb and see
http://google3/hardware/standards/usb
menuconfig PLATFORM_EC_USB_POWER_DELIVERY
bool "USB Type-C Power Delivery (PD)"
default y
help
USB has always provided basic power to an attached peripheral. USB-C
PD is part of the USB 3.0 standard and allows a lot more functionality
than the basic 500mA @ 5V. It allows negotiating power delivery over
the USB cable to select voltages up to 20V with current up to 5A.
This option also enables the Type-C Port Manager (TCPM) on the EC. The
TCPM deals with the various state changes in the system as devices are
plugged and unplugged, as well as changes in power requirements from
those devices.
if PLATFORM_EC_USB_POWER_DELIVERY
config PLATFORM_EC_USB_PD_HOST_CMD
bool "Host commands related to USB Power Delivery"
default y
help
This enables host commands which allow finding out the capabilities
of USB PD, checking is status and controlling how it operates. For
devices which support firmware update, this is provided as well,
with the firmware being sent from the AP.
config PLATFORM_EC_USB_PD_PORT_MAX_COUNT
int "Maximum number of USB PD ports supported"
default 2
help
This sets the limit on the number of PD ports supported on the
device. This is used to set the size for tables used by devices.
TODO(b/176237074): Can we calculate this from the devicetree at some
point? Or update the sn5S330 driver to use an 8-bit flag byte for
source_enabled[] so that plenty of ports are supported without this
configuration option?
choice "Measuring VBUS voltage"
prompt "Select how VBUS voltage is measured"
config PLATFORM_EC_USB_PD_VBUS_MEASURE_NOT_PRESENT
bool "VBUS voltage cannot be read"
help
Enable this if the board does not provide any mechanism for the EC to
read the analog VBUS voltage.
config PLATFORM_EC_USB_PD_VBUS_MEASURE_CHARGER
bool "On-board charger supports VBUS measurement"
help
Enable this if the VBUS voltage can be read using a charger on the
board.
config PLATFORM_EC_USB_PD_VBUS_MEASURE_TCPC
bool "Type-C Port Controller supports VBUS measurement"
help
Enable this if the VBUS voltage can be read using the on-board
TCPC.
config PLATFORM_EC_USB_PD_VBUS_MEASURE_ADC_EACH_PORT
bool "VBUS on each port is measured using an ADC channel"
help
Enable this is there is a separate ADC channel for each USB-C VBUS
voltage.
endchoice # Measuring VBUS voltage
config PLATFORM_EC_USB_PD_DUAL_ROLE
bool "Board can act as a dual-role Power Delivery port"
default y
help
This enables support for switching between source and sink during
operation. This means that the port can accept power (e.g. to charge
up its battery), or send out power to an attached device on the same
port.
config PLATFORM_EC_USB_PD_DUAL_ROLE_AUTO_TOGGLE
bool "Board can use TCPC-controlled DRP toggle"
depends on PLATFORM_EC_USB_PD_DUAL_ROLE
default y
help
Enable this if the USB Type-C Port Controllers (TCPC) used on the
board supports toggling of the power role autonomously. When this is
disabled, the USB power delivery task is responsible for manually
toggling the power role.
config PLATFORM_EC_USB_PD_DISCHARGE
bool "Board can discharge VBUS"
default y
help
Enable this if the board can enable VBUS discharge (eg. through a
GPIO-controlled discharge circuit, or through port controller
registers) to discharge VBUS rapidly on disconnect
choice "Discharge method"
prompt "Select the discharge method"
depends on PLATFORM_EC_USB_PD_DISCHARGE
config PLATFORM_EC_USB_PD_DISCHARGE_GPIO
bool "GPIO control"
help
Enable this if the discharge circuit is controlled by a GPIO
TODO: How to specify the GPIO?
config PLATFORM_EC_USB_PD_DISCHARGE_TCPC
bool "Discharge circuit is provided by the TCPC"
help
Enable this if the discharge circuit is provided by Power-Delivery
resistors on the USB Type-C Port Controller (TCPC).
config PLATFORM_EC_USB_PD_DISCHARGE_PPC
bool "Discharge circuit is provided by the PPC"
help
Enable this if the discharge circuit is using Power Delivery
resistors on the Power Path Controller.
endchoice # Discharge method
config PLATFORM_EC_CONFIG_USB_PD_REV30
bool "USB PD Rev3.0 functionality"
default y
help
Enable this to allow Rev3.0 functionality, including features such as
Fast Role Swap, advertising the available power across all ports of a
multi-port charger, and USB4. If disabled, only USB Power Delivery
Rev2.0 functionality is supported.
This defaults to y because PD Rev3.0 is required for USB4
functionality.
config PLATFORM_EC_USB_PD_ALT_MODE
bool "USB Power Delivery alternate mode"
default y
help
Enable this to support USB PD alternate mode. This allows negotiation
of a different mode of operation to allow non-USB traffic to pass over
a USB Type-C link. This makes use of some or all of the USB 3.0 bus
differential pairs. If all are used for the alternate mode, then USB
transmission is not available at all while in this mode.
config PLATFORM_EC_USB_PD_ALT_MODE_DFP
bool "Downward Facing Port support"
default y
help
Enable support for USB Power Delivery alternate mode of Downward
Facing Port.
TODO: Add more help here
choice "VBUS detection method"
prompt "Select the method to detect VBUS"
config PLATFORM_EC_USB_PD_VBUS_DETECT_TCPC
bool "TCPC detects VBUS"
help
Choose this option if the TCPC can detect the presence of VBUS
config PLATFORM_EC_USB_PD_VBUS_DETECT_CHARGER
bool "Charger detects VBUS"
help
Choose this option if the battery charger can detect the presence
of VBUS
config PLATFORM_EC_USB_PD_VBUS_DETECT_PPC
bool "PPC detects VBUS"
help
Choose this option if the Power-Path Controller (PPC) can detect the
presence of VBUS
config PLATFORM_EC_USB_PD_VBUS_DETECT_NONE
bool "No way to detect VBUS"
help
Choose this option if it is not possible to detect VBUS.
endchoice # VBUS detection method
config PLATFORM_EC_USB_TYPEC_SM
bool "Type-C (TC) physical-layer state machine"
default y
help
This enables the bottom layer of the TCPMv2 state machine which
handles using CC lines to set the voltage-level of the power supplied.
You should normally define this unless you want to override it in your
board code, which is not recommended.
config PLATFORM_EC_USB_PRL_SM
bool "Protocol layer (PRL) state machine"
default y
help
This enables the middle layer of the power-delivery (PD) protocol,
which deals with the flow of power messages across the USB Type-C
interface. You should normally define this unless you want to override
it in your board code, which is not recommended.
config PLATFORM_EC_USB_PE_SM
bool "Policy engine (PE) state machine"
default y
help
This enables the top layer of the power-delivery (PD) protocol, which
deals with the actually PD messages that are exchanged with attached
USB devices. You should normally define this unless you want to
override it in your board code, which is not recommended.
config PLATFORM_EC_USB_PD_DECODE_SOP
def_bool y # Required for TCPMV2
help
This enables support for encoding of the message's Start Of Packet
(SOP, SOP' and SOP'', collectively called SOP*) in bits 31-28 of the
32-bit msg header type.
choice "USB-C device type"
prompt "Select the USB-C device type"
default PLATFORM_EC_USB_DRP_ACC_TRYSRC
config PLATFORM_EC_USB_VPD
bool "VCONN-Powered Device"
help
This enables support for supplying power to devices that accept power
over the USB VCONN line.
See here for details:
https://www.usb.org/sites/default/files/D1T2-3a%20-%20CTVPDs%20and%20Making%20Your%20Own%20USB-C%20Thingamajig.pdf
config PLATFORM_EC_USB_CTVPD
bool "Charge-Through VCONN-Powered Device"
help
This enables support for supplying power to devices, with a circuit
that deals with this without needing the involvement of the main
device.
config PLATFORM_EC_USB_DRP_ACC_TRYSRC
bool "Dual-Role Port, Audio Accessory, and Try.SRC Device"
help
This is the most flexible option, allowing the port to operate in
a dual-role capacity, so that power can be accepted or supplied on
a port.
endchoice # USB-C device type
endif # PLATFORM_EC_USB_POWER_DELIVERY
menuconfig PLATFORM_EC_USBC_PPC
bool "USB Type-C Power Path Controller"
default y
help
Enable this to support the USB Type-C PPC on your board. This enables
common routines for things like figuring out whether power is being
supplied to the Chromebook over USB-C, whether the Chromebook is
supplying power to another device, etc.
if PLATFORM_EC_USBC_PPC
config PLATFORM_EC_USBC_PPC_SN5S330
bool "TI SN5S330 PD 3.0 power mux"
select PLATFORM_EC_USBC_OCP
help
This is a USB Type-C Power Delivery 3.0 Bidirectional Power Mux with
CC and SBU short-to-VBUS Protection and Integrated Dead Battery
LDO. This chips provides protection against pins shorting to Vbus as
well as ESD (Electostatic discharge) protection. It provides a simple
I2C interface for for Mode Selection, Fast Role Swap, and Fault
Reporting.
config PLATFORM_EC_USBC_PPC_SYV682X
bool "SYV682X which is a Power Mux for USB PD"
select PLATFORM_EC_USBC_OCP
help
The SYV682A is a 2 to 1 power mux switch for USB PD applications. The
SYV682A supports dead battery wake up function and Fast Role Swap
features. It provides protection against overcurrent, overvoltage,
thermal shutdown, and undervoltage conditions.
config PLATFORM_EC_USB_PD_TCPM_TUSB422
bool "TI TUSB422 Port Control with USB PD"
help
This is a a USB PD PHY that enables a USB Type-C port with the
Configuration Channel (CC) logic needed for USB Type-C ecosystems. It
integrates the physical layer of the USB BMC power delivery (PD)
protocol to allow up to 100-W of power and support for alternate mode
interfaces. An external microprocessor, containing USB Type-C Port
Manager (TCPM), communicates with the TUSB422 through an I2C
interface.
choice "Type-C Port Manager (TCPM)"
prompt "Choose a Type-C Port Manager (TCPM) to manage TCPC"
config PLATFORM_EC_USB_PD_TCPM_TCPCI
bool "Use TCPCI"
help
Enable a TCPC compatible with the Type-C Port Controller Interface
(TCPCI) Specification. This driver supports both Rev1 v1.2 and Rev2
v1.0 of the TCPCI specification. Select this driver directly only
if your specific TCPC chip is not listed as a separate config option.
Note: most of the TCPC will depend on PLATFORM_EC_USB_PD_TCPM_TCPCI.
# TODO: Add other choices:
# CONFIG_USB_PD_TCPM_STUB
# CONFIG_USB_PD_TCPM_FUSB302
# CONFIG_USB_PD_TCPM_ITE_ON_CHIP
# CONFIG_USB_PD_TCPM_ANX3429
# CONFIG_USB_PD_TCPM_ANX740X
# CONFIG_USB_PD_TCPM_ANX741X
# CONFIG_USB_PD_TCPM_ANX7447
# CONFIG_USB_PD_TCPM_ANX7688
# CONFIG_USB_PD_TCPM_NCT38XX
# CONFIG_USB_PD_TCPM_MT6370
# CONFIG_USB_PD_TCPM_TUSB422
# CONFIG_USB_PD_TCPM_RAA489000
# CONFIG_USB_PD_TCPM_RT1715
# CONFIG_USB_PD_TCPM_FUSB307
# CONFIG_USB_PD_TCPM_STM32GX
endchoice # Type-C Port Manager (TCPM)
menuconfig PLATFORM_EC_USB_MUX
bool "USB muxes"
default y
help
Enables support for USB muxes. These allow multiplexing
if PLATFORM_EC_USB_MUX
config PLATFORM_EC_USB_MUX_RUNTIME_CONFIG
bool "USB mux runtime config"
default y
help
Allows the configuration of the USB mux to be set up at runtime. This
makes the usb_muxes[] array writable, i.e. not const. It should be
declared as such in the board config.
This is useful when the board has runtime information that changes
the configuration, such as Chromium OS Board Info (CBI set in the
factory. Without this, multiple EC images would need to be installed
depending on the board.
endif # PLATFORM_EC_USB_MUX
config PLATFORM_EC_CONSOLE_CMD_PPC_DUMP
bool "Console command: ppc_dump"
depends on PLATFORM_EC_USBC_PPC
default y
help
Allows dumping of the Power Path Controller (PPC) state, which is
basically a list of registers and their values. The actual dump
function is driver-specific (the reg_dump member of ppc_drv). By
reference to the datasheet for the part this can help you figure out
what is going on.
if PLATFORM_EC_USB_PD_TCPM_TCPCI
config PLATFORM_EC_USB_PD_TCPC_RUNTIME_CONFIG
bool "Type-C Port Controller runtime config"
default y
help
Allows the configuration of the TCPC to be set up at runtime. This
makes the tcpc_config[] array writable, i.e. not const. It should be
declared as such in the board config.
This is useful when the board has runtime information that sets
the configuration, such as Chromium OS Board Info (CBI set in the
factory. Without this, multiple EC images would need to be installed
depending on the board.
config PLATFORM_EC_CMD_TCPC_DUMP
bool "Console command: tcpc_dump"
# anx7447 also supports this command, but is not yet enabled
default y
help
Allows dumping of the Type-C Port Controller (TCPC) state, which is
basically a list of registers and their values. By reference to the
Universal Serial Bus Type-C Port Controller Interface Specification
this can help you figure out what is going on.
endif # PLATFORM_EC_USB_PD_TCPM_TCPCI
endif # PLATFORM_EC_USBC_PPC
config PLATFORM_EC_USB_CHARGER
bool "Support charging from a USB-C port"
default y
select HAS_TASK_USB_CHG_P0
help
This enables common BC1.2 (Battery-Charging Specification Rev1.2)
charger-detection routines. With this is possible to negotiate a
power contract with an attached battery charger and use this to
charge the device's battery.
if PLATFORM_EC_USB_CHARGER
config PLATFORM_EC_BC12_DETECT_PI3USB9201
bool "Enable support for Pericom PI3USB9201"
help
This is a Dual-Role USB Charging-Type Detector. It can operate in
host or client mode. It supports Battery Charging Specification, rev
1.2 (BC1.2) with Standard/Charging/Dedicated downstream port
(SDP/CDP/DCP) advertisement when in host mode. In client mode it
starts BC1.2 detection to detect the attached host type. It provides
an I2C interface to report detection results.
endif # PLATFORM_EC_USB_CHARGER
endif # PLATFORM_EC_USBC
|