blob: 1adcbc01671ad782afdd1d811ec87e669ea0578a (
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
|
/* SPDX-License-Identifier: GPL-2.0-only */
#ifndef SOC_INTEL_COMMON_BLOCK_XHCI_H
#define SOC_INTEL_COMMON_BLOCK_XHCI_H
#include <device/device.h>
#include <elog.h>
#include <stdint.h>
/*
* struct xhci_usb_info - Data containing number of USB ports & offset.
* @usb2_port_status_reg: Offset to USB2 port status register.
* @num_usb2_ports: Number of USB2 ports.
* @usb3_port_status_reg: Offset to USB3 port status register.
* @num_usb3_ports: Number of USB3 ports.
*/
struct xhci_usb_info {
uint32_t usb2_port_status_reg;
uint32_t num_usb2_ports;
uint32_t usb3_port_status_reg;
uint32_t num_usb3_ports;
};
/*
* struct xhci_wake_info - Relates an XHCI device to registers and wake types
* @xhci_dev: devfn of the XHCI device
* @elog_wake_type_host: the wake type for the controller device
*/
struct xhci_wake_info {
pci_devfn_t xhci_dev;
uint8_t elog_wake_type_host;
};
/*
* xhci_update_wake_event() - Identify and log XHCI wake events.
* @wake_info: A mapping of XHCI devfn to elog wake types
* @wake_info_count: Count of items in wake_info
* @info: Information about number of USB ports and their status reg offset.
*
* This function goes through individual USB port status registers within the
* XHCI block and identifies if any of those USB ports triggered a wake-up and
* log information about those ports to the event log.
*
* Return: True if any port is identified as a wake source, false if none.
*/
bool xhci_update_wake_event(const struct xhci_wake_info *wake_info,
size_t wake_info_count);
void soc_xhci_init(struct device *dev);
/*
* soc_get_xhci_usb_info() - Get the information about USB2 & USB3 ports.
*
* This function is used to get USB ports and status register offset information
* within a XHCI controller.
*
* Return: USB ports and status register offset info for the SoC.
*/
const struct xhci_usb_info *soc_get_xhci_usb_info(pci_devfn_t xhci_dev);
/*
* usb_xhci_disable_unused() - Disable unused USB devices
* @ext_usb_xhci_en_cb: Callback function to be invoked, supplied by mainboard,
* to identify the status of externally visible USB ports.
* (Return true if port is present, false if port is absent)
*
* This function is used to disable unused USB devices/ports that are configured
* in the device tree. For the internal USB ports, the connect status of the port
* is probed from the XHCI controller block and the port is disabled if it is not
* connected. For the external USB ports, the mainboard provides the connect status
* of the concerned port depending on the variants and their SKUs. If the mainboard
* supplied callback function is NULL, then all the externally visible USB devices
* in the device tree are enabled.
*/
void usb_xhci_disable_unused(bool (*ext_usb_xhci_en_cb)(unsigned int port_type,
unsigned int port_id));
#endif /* SOC_INTEL_COMMON_BLOCK_XHCI_H */
|
