blob: ce6612590530479448a77e70eaa04aa4d83feb2a (
plain)
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
|
# Zephyr USBA Configuration
[TOC]
## Overview
[USBA] is used to configure the number of USB Type-A ports in the system and
optional control of the power supplied by said ports.
## Kconfig Options
`CONFIG_PLATFORM_EC_USBA` enables support for USB-A ports in the EC application.
Refer to [Kconfig.usba] for all sub-options controlling USB-A ports.
## Devicetree Nodes
By default, for each USB Type-A port, a GPIO pin is required to control when power
is supplied to the port. The GPIO pins are described in Device Tree nodes.
Refer to the [named-gpios.yaml] and [cros-ec,usba-port-enable-pins.yaml] child-binding
files for details about gpio properties.
## Board Specific Code
none
## Threads
When `CONFIG_PLATFORM_EC_USB_PORT_POWER_DUMB=y`, then the EC application automatically
powers up USB-A ports when the AP chipset starts up and powers off the USB-A ports
when the AP chipset shuts down.
## Testing and Debugging
Use the gpioset console command to manually enable and disable the USB Type-A port power.
`gpioset` usage: gpioset <pin_name> <0 | 1>
The `usbchargemode` console command is used to enable and disable charging
from the USB Type-A port.
* For dumb power ports: `usbchargemode` <port> <on | off>
* For smart power ports: `usbchargemode` <port> <0 | 1 | 2 | 3> <0 | 1>
Charging from USB Type-A ports can be controlled from the AP using ectool `usbchargemode`.
`ectool usbchargemode` <port> <disabled | SDP | CDP | DCP> [inhibit_charge]
Refer to the Application Processor to EC communication for more information about using[ ectool].
## Example
The Herobrine board has one USB Type-A port:
The following configures the project for one port.
```
`CONFIG_PLATFORM_EC_USB_PORT_POWER_DUMB=y`
```
The following device tree node configures the gpio pin.
```
gpio_en_usb_a_5v: en_usb_a_5v {
gpios = <&gpiof 0 GPIO_OUT_LOW>;
};
usba-port-enable-list {
compatible = "cros-ec,usba-port-enable-pins";
enable-pins = <&gpio_en_usb_a_5v>;
};
```
[USBA]: ../ec_terms.md#usba
[Kconfig.usba]: https://source.chromium.org/chromiumos/chromiumos/codesearch/+/main:src/platform/ec/zephyr/Kconfig.usba
[named-gpios.yaml]: ../../zephyr/dts/bindings/gpio/named-gpios.yaml
[cros-ec,usba-port-enable-pins.yaml]: ../../zephyr/dts/bindings/gpio/cros-ec,usba-port-enable-pins.yaml
[ectool]: https://source.chromium.org/chromiumos/chromiumos/codesearch/+/main:src/platform/ec/util/ectool.c;?q=function:ms_help&ss=chromiumos
|
