文件
android_kernel_samsung_sm86…/cnss2/pci_platform.h
Jiani Liu ae1e042498 cnss2: Set and retrain PCIe link for PCIe switch
When WLAN is attached to PCIe switch, set and retrain DSP <-> EP link
in BW scale callback function. It avoids touching RC <-> USP link which
may impact other devices.
With this change, it could support Hamilton PCIe Gen3 on PCIe switch
platform.

Change-Id: Id444ac847613971545bf66db9bb1a6e427028802
CRs-Fixed: 3848272
2024-08-07 03:59:45 -07:00

254 行
7.4 KiB
C

/* SPDX-License-Identifier: GPL-2.0-only */
/* Copyright (c) 2022-2024 Qualcomm Innovation Center, Inc. All rights reserved. */
#ifndef _CNSS_PCI_PLATFORM_H
#define _CNSS_PCI_PLATFORM_H
#include "pci.h"
#if IS_ENABLED(CONFIG_PCI_MSM)
/**
* _cnss_pci_enumerate() - Enumerate PCIe endpoints
* @plat_priv: driver platform context pointer
* @rc_num: root complex index that an endpoint connects to
*
* This function shall call corresponding PCIe root complex driver APIs
* to power on root complex and enumerate the endpoint connected to it.
*
* Return: 0 for success, negative value for error
*/
int _cnss_pci_enumerate(struct cnss_plat_data *plat_priv, u32 rc_num);
/**
* cnss_pci_assert_perst() - Assert PCIe PERST GPIO
* @pci_priv: driver PCI bus context pointer
*
* This function shall call corresponding PCIe root complex driver APIs
* to assert PCIe PERST GPIO.
*
* Return: 0 for success, negative value for error
*/
int cnss_pci_assert_perst(struct cnss_pci_data *pci_priv);
/**
* cnss_pci_disable_pc() - Disable PCIe link power collapse from RC driver
* @pci_priv: driver PCI bus context pointer
* @vote: value to indicate disable (true) or enable (false)
*
* This function shall call corresponding PCIe root complex driver APIs
* to disable PCIe power collapse. The purpose of this API is to avoid
* root complex driver still controlling PCIe link from callbacks of
* system suspend/resume. Device driver itself should take full control
* of the link in such cases.
*
* Return: 0 for success, negative value for error
*/
int cnss_pci_disable_pc(struct cnss_pci_data *pci_priv, bool vote);
/**
* cnss_pci_set_link_bandwidth() - Update number of lanes and speed of
* PCIe link
* @pci_priv: driver PCI bus context pointer
* @link_speed: PCIe link gen speed
* @link_width: number of lanes for PCIe link
*
* This function shall call corresponding PCIe root complex driver APIs
* to update number of lanes and speed of the link.
*
* Return: 0 for success, negative value for error
*/
int cnss_pci_set_link_bandwidth(struct cnss_pci_data *pci_priv,
u16 link_speed, u16 link_width);
/**
* cnss_pci_set_max_link_speed() - Set the maximum speed PCIe can link up with
* @pci_priv: driver PCI bus context pointer
* @rc_num: root complex index that an endpoint connects to
* @link_speed: PCIe link gen speed
*
* This function shall call corresponding PCIe root complex driver APIs
* to update the maximum speed that PCIe can link up with.
*
* Return: 0 for success, negative value for error
*/
int cnss_pci_set_max_link_speed(struct cnss_pci_data *pci_priv,
u32 rc_num, u16 link_speed);
/**
* cnss_reg_pci_event() - Register for PCIe events
* @pci_priv: driver PCI bus context pointer
*
* This function shall call corresponding PCIe root complex driver APIs
* to register for PCIe events like link down or WAKE GPIO toggling etc.
* The events should be based on PCIe root complex driver's capability.
*
* Return: 0 for success, negative value for error
*/
int cnss_reg_pci_event(struct cnss_pci_data *pci_priv);
void cnss_dereg_pci_event(struct cnss_pci_data *pci_priv);
/**
* cnss_wlan_adsp_pc_enable: Control ADSP power collapse setup
* @dev: Platform driver pci private data structure
* @control: Power collapse enable / disable
*
* This function controls ADSP power collapse (PC). It must be called
* based on wlan state. ADSP power collapse during wlan RTPM suspend state
* results in delay during periodic QMI stats PCI link up/down. This delay
* causes additional power consumption.
*
* Result: 0 Success. negative error codes.
*/
int cnss_wlan_adsp_pc_enable(struct cnss_pci_data *pci_priv,
bool control);
int cnss_set_pci_link(struct cnss_pci_data *pci_priv, bool link_up);
int cnss_pci_prevent_l1(struct device *dev);
void cnss_pci_allow_l1(struct device *dev);
int cnss_pci_get_msi_assignment(struct cnss_pci_data *pci_priv);
int cnss_pci_get_one_msi_assignment(struct cnss_pci_data *pci_priv);
bool cnss_pci_fallback_one_msi(struct cnss_pci_data *pci_priv,
int *num_vectors);
bool cnss_pci_is_one_msi(struct cnss_pci_data *pci_priv);
int cnss_pci_get_one_msi_mhi_irq_array_size(struct cnss_pci_data *pci_priv);
bool cnss_pci_is_force_one_msi(struct cnss_pci_data *pci_priv);
int cnss_pci_init_smmu(struct cnss_pci_data *pci_priv);
void cnss_pci_update_drv_supported(struct cnss_pci_data *pci_priv);
int cnss_pci_dsp_link_control(struct cnss_pci_data *pci_priv,
bool link_enable);
/**
* _cnss_pci_get_reg_dump() - Dump PCIe RC registers for debug
* @pci_priv: driver PCI bus context pointer
* @buf: destination buffer pointer
* @len: length of the buffer
*
* This function shall call corresponding PCIe root complex driver API
* to dump PCIe RC registers for debug purpose.
*
* Return: 0 for success, negative value for error
*/
int _cnss_pci_get_reg_dump(struct cnss_pci_data *pci_priv,
u8 *buf, u32 len);
int cnss_pci_set_dsp_link_status(struct cnss_pci_data *pci_priv,
bool link_enable);
int cnss_pci_get_dsp_link_status(struct cnss_pci_data *pci_priv);
int cnss_pci_dsp_link_enable(struct cnss_pci_data *pci_priv);
int cnss_pci_dsp_link_retrain(struct cnss_pci_data *pci_priv,
u16 target_link_speed);
#else
int _cnss_pci_enumerate(struct cnss_plat_data *plat_priv, u32 rc_num)
{
return -EOPNOTSUPP;
}
int cnss_pci_assert_perst(struct cnss_pci_data *pci_priv)
{
return -EOPNOTSUPP;
}
int cnss_pci_disable_pc(struct cnss_pci_data *pci_priv, bool vote)
{
return 0;
}
int cnss_pci_set_link_bandwidth(struct cnss_pci_data *pci_priv,
u16 link_speed, u16 link_width)
{
return 0;
}
int cnss_pci_set_max_link_speed(struct cnss_pci_data *pci_priv,
u32 rc_num, u16 link_speed)
{
return 0;
}
int cnss_reg_pci_event(struct cnss_pci_data *pci_priv)
{
return 0;
}
void cnss_dereg_pci_event(struct cnss_pci_data *pci_priv) {}
int cnss_wlan_adsp_pc_enable(struct cnss_pci_data *pci_priv, bool control)
{
return 0;
}
int cnss_set_pci_link(struct cnss_pci_data *pci_priv, bool link_up)
{
return 0;
}
int cnss_pci_prevent_l1(struct device *dev)
{
return 0;
}
EXPORT_SYMBOL(cnss_pci_prevent_l1);
void cnss_pci_allow_l1(struct device *dev)
{
}
EXPORT_SYMBOL(cnss_pci_allow_l1);
int cnss_pci_get_msi_assignment(struct cnss_pci_data *pci_priv)
{
return 0;
}
int cnss_pci_init_smmu(struct cnss_pci_data *pci_priv)
{
return 0;
}
int _cnss_pci_get_reg_dump(struct cnss_pci_data *pci_priv,
u8 *buf, u32 len)
{
return 0;
}
void cnss_pci_update_drv_supported(struct cnss_pci_data *pci_priv)
{
pci_priv->drv_supported = false;
}
int cnss_pci_dsp_link_control(struct cnss_pci_data *pci_priv,
bool link_enable)
{
return -EOPNOTSUPP;
}
int cnss_pci_set_dsp_link_status(struct cnss_pci_data *pci_priv,
bool link_enable)
{
return -EOPNOTSUPP;
}
int cnss_pci_get_dsp_link_status(struct cnss_pci_data *pci_priv)
{
return -EOPNOTSUPP;
}
int cnss_pci_dsp_link_enable(struct cnss_pci_data *pci_priv)
{
return -EOPNOTSUPP;
}
int cnss_pci_dsp_link_retrain(struct cnss_pci_data *pci_priv,
u16 target_link_speed)
{
return -EOPNOTSUPP;
}
#endif /* CONFIG_PCI_MSM */
static inline bool cnss_pci_get_drv_supported(struct cnss_pci_data *pci_priv)
{
return pci_priv->drv_supported;
}
#if IS_ENABLED(CONFIG_ARCH_QCOM)
int cnss_pci_of_reserved_mem_device_init(struct cnss_pci_data *pci_priv);
int cnss_pci_wake_gpio_init(struct cnss_pci_data *pci_priv);
void cnss_pci_wake_gpio_deinit(struct cnss_pci_data *pci_priv);
#endif /* CONFIG_ARCH_QCOM */
#endif /* _CNSS_PCI_PLATFORM_H*/