mirror of
git://nv-tegra.nvidia.com/linux-nv-oot.git
synced 2025-12-22 17:25:35 +03:00
pci: tegra264: Add EP driver ICD documentation
JIRA NET-2663 Signed-off-by: Nagarjuna Kristam <nkristam@nvidia.com> Change-Id: I5855c28c7834fe6ca8f0571321b04a4997dc6185 Reviewed-on: https://git-master.nvidia.com/r/c/linux-nv-oot/+/3293557 GVS: buildbot_gerritrpt <buildbot_gerritrpt@nvidia.com> Reviewed-by: Bitan Biswas <bbiswas@nvidia.com>
This commit is contained in:
Nagarjuna Kristam
committed by
Jon Hunter
Jon Hunter
parent
9297cd7cfd
commit
789e70d35e
185
drivers/pci/controller/private-soc/pcie-tegra-calib-info.h
Normal file
185
drivers/pci/controller/private-soc/pcie-tegra-calib-info.h
Normal file
@@ -0,0 +1,185 @@
|
|||||||
|
/* SPDX-License-Identifier: GPL-2.0-only */
|
||||||
|
/* Copyright (c) 2025, NVIDIA CORPORATION & AFFILIATES. All rights reserved */
|
||||||
|
|
||||||
|
/* No header guards as this file doesnot define any. Added for documentation only */
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @defgroup CalPcieEpLinux PCIe_EP_Linux_Device_Tree
|
||||||
|
*
|
||||||
|
* **PCIe Controller DT properties**
|
||||||
|
*
|
||||||
|
* `compatible`:
|
||||||
|
*
|
||||||
|
* - **Description:** Compatibility string name.
|
||||||
|
*
|
||||||
|
* - **Range:** "nvidia,tegra264-pcie-ep".
|
||||||
|
*
|
||||||
|
* - **Resolution:**:
|
||||||
|
*
|
||||||
|
* * Customizable: No.
|
||||||
|
*
|
||||||
|
* * Optional: No.
|
||||||
|
*
|
||||||
|
* `status`:
|
||||||
|
*
|
||||||
|
* - **Description:** Enabled status of PCIe controller.
|
||||||
|
*
|
||||||
|
* - **Range:** "okay" or "disabled"
|
||||||
|
*
|
||||||
|
* - **Resolution:**
|
||||||
|
*
|
||||||
|
* - Customizable: No.
|
||||||
|
*
|
||||||
|
* * Optional: No.
|
||||||
|
*
|
||||||
|
* `reg`:
|
||||||
|
*
|
||||||
|
* - **Description:** A list of physical base address and length pairs for each set of controller
|
||||||
|
* registers. Must contain an entry for each entry in the reg-names property in same order.
|
||||||
|
*
|
||||||
|
* - **Range:** Values for EP Controller (C2, C4, C5) respectively are
|
||||||
|
*
|
||||||
|
reg = <0xa8 0x08420000 0x0 0x00004000
|
||||||
|
0xa8 0x08500000 0x0 0x00001000
|
||||||
|
0xa8 0x08510000 0x0 0x00001000
|
||||||
|
0xa8 0x08511000 0x0 0x00001000
|
||||||
|
0xa8 0x08520000 0x0 0x00010000
|
||||||
|
0xa8 0x08430000 0x0 0x00010000
|
||||||
|
0xb0 0x80000000 0x8 0x00000000>;
|
||||||
|
|
||||||
|
reg = <0xa8 0x08460000 0x0 0x00004000
|
||||||
|
0xa8 0x08530000 0x0 0x00001000
|
||||||
|
0xa8 0x08540000 0x0 0x00001000
|
||||||
|
0xa8 0x08541000 0x0 0x00001000
|
||||||
|
0xa8 0x08550000 0x0 0x00010000
|
||||||
|
0xa8 0x08470000 0x0 0x00010000
|
||||||
|
0xc0 0x80000000 0x8 0x00000000>;
|
||||||
|
|
||||||
|
reg = <0xa8 0x08480000 0x0 0x00004000
|
||||||
|
0xa8 0x08560000 0x0 0x00001000
|
||||||
|
0xa8 0x08570000 0x0 0x00001000
|
||||||
|
0xa8 0x08571000 0x0 0x00001000
|
||||||
|
0xa8 0x08580000 0x0 0x00010000
|
||||||
|
0xa8 0x08490000 0x0 0x00010000
|
||||||
|
0xc8 0x80000000 0x8 0x00000000>;
|
||||||
|
* - **Resolution:**:
|
||||||
|
*
|
||||||
|
* * Customizable: No.
|
||||||
|
*
|
||||||
|
* * Optional: No.
|
||||||
|
*
|
||||||
|
* `reg-names`:
|
||||||
|
*
|
||||||
|
* - **Description:** Names of the registers defined in `reg` property. Details explained in the
|
||||||
|
* range.
|
||||||
|
*
|
||||||
|
* - **Range:** Must include the following entries in same order:
|
||||||
|
* - xal: Controller's application logic registers.
|
||||||
|
* - xal-ep-dm: Controller's transport layer
|
||||||
|
* - xtl-ep-pri: Controller's transport layer private registers.
|
||||||
|
* - xtl-ep-cfg: Controller's PCIe config registers.
|
||||||
|
* - xpl: Controller's physical layer registers.
|
||||||
|
* - xdma: Controller's XDMA registers.
|
||||||
|
* - addr_space: Used to map remote RC address space
|
||||||
|
*
|
||||||
|
* - **Resolution:**:
|
||||||
|
*
|
||||||
|
* * Customizable: No.
|
||||||
|
*
|
||||||
|
* * Optional: No.
|
||||||
|
*
|
||||||
|
* `intr`:
|
||||||
|
*
|
||||||
|
* - **Description:** A list of interrupt outputs of the controller. Must contain an entry for
|
||||||
|
* each entry in the interrupt-names property
|
||||||
|
*
|
||||||
|
* - **Range:** Values for EP Controller (C2, C4, C5) are 0x391, 0x3a4 and 0x3ad respectively.
|
||||||
|
*
|
||||||
|
* - **Resolution:**:
|
||||||
|
*
|
||||||
|
* * Customizable: No.
|
||||||
|
*
|
||||||
|
* * Optional: No.
|
||||||
|
*
|
||||||
|
* `intr-names`:
|
||||||
|
*
|
||||||
|
* - **Description:** Names of the registers defined in `intr` property. Details explained in the
|
||||||
|
* range.
|
||||||
|
*
|
||||||
|
* - **Range:** Must include the "intr" entry
|
||||||
|
*
|
||||||
|
* - **Resolution:**:
|
||||||
|
*
|
||||||
|
* * Customizable: No.
|
||||||
|
*
|
||||||
|
* * Optional: No.
|
||||||
|
*
|
||||||
|
* `nvidia,bpmp`:
|
||||||
|
*
|
||||||
|
* - **Description:** Contains phanldle of bpmp node and controller ID of the PCIe controller.
|
||||||
|
*
|
||||||
|
* - **Range:** Supported values for controller ID are 2, 4, 5.
|
||||||
|
*
|
||||||
|
* - **Resolution:**:
|
||||||
|
*
|
||||||
|
* * Customizable: No.
|
||||||
|
*
|
||||||
|
* * Optional: No.
|
||||||
|
*
|
||||||
|
* `dma-coherent`:
|
||||||
|
*
|
||||||
|
* - **Description:** boolean flag which indicates whether PCIe is DMA coherent or not.
|
||||||
|
*
|
||||||
|
* - **Resolution:**:
|
||||||
|
*
|
||||||
|
* * Customizable: No.
|
||||||
|
*
|
||||||
|
* * Optional: No.
|
||||||
|
*
|
||||||
|
* `reset-gpios`:
|
||||||
|
*
|
||||||
|
* - **Description:** Must contain a phandle to a GPIO controller followed by GPIO that is being
|
||||||
|
* used as PERST input signal.
|
||||||
|
*
|
||||||
|
* - **Resolution:**:
|
||||||
|
*
|
||||||
|
* * Customizable: Yes, based on the platform design.
|
||||||
|
*
|
||||||
|
* * Optional: No.
|
||||||
|
*
|
||||||
|
* `nvidia,pex-prsnt-gpios`:
|
||||||
|
*
|
||||||
|
* - **Description:** Must contain a phandle to a GPIO controller followed by GPIO that is being
|
||||||
|
* used as PRSNT output signal.
|
||||||
|
* This GPIO is used to generate hot-plug events to the connected root port device.
|
||||||
|
*
|
||||||
|
* - **Resolution:**:
|
||||||
|
*
|
||||||
|
* * Customizable: Yes, based on the platform design.
|
||||||
|
*
|
||||||
|
* * Optional: Yes.
|
||||||
|
*
|
||||||
|
|
||||||
|
* Example:
|
||||||
|
@verbatim
|
||||||
|
pcie-ep@a808460000 {
|
||||||
|
status = "disabled";
|
||||||
|
compatible = "nvidia,tegra264-pcie-ep";
|
||||||
|
reg = <0xa8 0x08460000 0x0 0x00004000
|
||||||
|
0xa8 0x08530000 0x0 0x00001000
|
||||||
|
0xa8 0x08540000 0x0 0x00001000
|
||||||
|
0xa8 0x08541000 0x0 0x00001000
|
||||||
|
0xa8 0x08550000 0x0 0x00010000
|
||||||
|
0xa8 0x08470000 0x0 0x00010000
|
||||||
|
0xc0 0x80000000 0x8 0x00000000>;
|
||||||
|
reg-names = "xal", "xal-ep-dm", "xtl-ep-pri", "xtl-ep-cfg", "xdma", "xpl", "addr_space";
|
||||||
|
interrupts = <GIC_SPI 0x3a4 IRQ_TYPE_LEVEL_HIGH>;
|
||||||
|
interrupt-names = "intr";
|
||||||
|
reset-gpios = <&gpio_uphy TEGRA264_UPHY_GPIO(D, 1) GPIO_ACTIVE_LOW>;
|
||||||
|
iommus = <&smmu1_mmu 0x40000>;
|
||||||
|
dma-coherent;
|
||||||
|
msi-parent = <&its 0x140000>;
|
||||||
|
nvidia,bpmp = <&bpmp 0x4>;
|
||||||
|
};
|
||||||
|
@endverbatim
|
||||||
|
*/
|
||||||
@@ -1,5 +1,5 @@
|
|||||||
// SPDX-License-Identifier: GPL-2.0-only
|
// SPDX-License-Identifier: GPL-2.0-only
|
||||||
// SPDX-FileCopyrightText: Copyright (c) 2024, NVIDIA CORPORATION. All rights reserved.
|
// SPDX-FileCopyrightText: Copyright (c) 2024-2025, NVIDIA CORPORATION. All rights reserved.
|
||||||
/*
|
/*
|
||||||
* PCIe EP controller driver for Tegra264 SoC
|
* PCIe EP controller driver for Tegra264 SoC
|
||||||
*
|
*
|
||||||
@@ -29,6 +29,8 @@
|
|||||||
#include <soc/tegra/bpmp.h>
|
#include <soc/tegra/bpmp.h>
|
||||||
#include <soc/tegra/bpmp-abi.h>
|
#include <soc/tegra/bpmp-abi.h>
|
||||||
|
|
||||||
|
#include "pcie-tegra264-ep.h"
|
||||||
|
|
||||||
/* 5 msec PERST# gpio debounce */
|
/* 5 msec PERST# gpio debounce */
|
||||||
#define PERST_DEBOUNCE_TIME 5000
|
#define PERST_DEBOUNCE_TIME 5000
|
||||||
|
|
||||||
|
|||||||
577
drivers/pci/controller/private-soc/pcie-tegra264-ep.h
Normal file
577
drivers/pci/controller/private-soc/pcie-tegra264-ep.h
Normal file
@@ -0,0 +1,577 @@
|
|||||||
|
/* SPDX-License-Identifier: GPL-2.0-only */
|
||||||
|
/* Copyright (c) 2025, NVIDIA CORPORATION & AFFILIATES. All rights reserved */
|
||||||
|
|
||||||
|
#ifndef PCIE_TEGRAT264_EP_H
|
||||||
|
#define PCIE_TEGRAT264_EP_H
|
||||||
|
|
||||||
|
#ifdef DOXYGEN_ICD
|
||||||
|
/**
|
||||||
|
* @dir
|
||||||
|
* - forward
|
||||||
|
*/
|
||||||
|
#endif
|
||||||
|
/**
|
||||||
|
* @brief
|
||||||
|
* callback API from Linux System to perform Tegra264 SoC's PCIe EP controller
|
||||||
|
* platform driver probe.
|
||||||
|
*
|
||||||
|
* @param[in] pdev Platform device associated with platform driver.
|
||||||
|
*
|
||||||
|
* @calib
|
||||||
|
* - CAL_NET_PIF$CalPcieEp
|
||||||
|
*
|
||||||
|
* @usage
|
||||||
|
* - Allowed context for the API call
|
||||||
|
* - Interrupt: No
|
||||||
|
* - Signal handler: No
|
||||||
|
* - Thread-Safe: No
|
||||||
|
* - Sync/Async: Sync
|
||||||
|
* - Re-entrant: No
|
||||||
|
* - Required Privileges: None.
|
||||||
|
* - Operation Mode
|
||||||
|
* - Initialization: Yes
|
||||||
|
* - Run time: No
|
||||||
|
* - De-initialization: No
|
||||||
|
*
|
||||||
|
* @return
|
||||||
|
* - 0 on success
|
||||||
|
* - "negative value" on failure.
|
||||||
|
*
|
||||||
|
*/
|
||||||
|
static int tegra264_pcie_ep_probe(struct platform_device *pdev);
|
||||||
|
|
||||||
|
#ifdef DOXYGEN_ICD
|
||||||
|
/**
|
||||||
|
* @dir
|
||||||
|
* - forward
|
||||||
|
*/
|
||||||
|
#endif
|
||||||
|
/**
|
||||||
|
* @brief
|
||||||
|
* callback API from Linux System to perform Tegra264 SoC's PCIe EP controller
|
||||||
|
* platform driver remove.
|
||||||
|
*
|
||||||
|
* @param[in] pdev Platform device associated with platform driver.
|
||||||
|
*
|
||||||
|
* @usage
|
||||||
|
* - Allowed context for the API call
|
||||||
|
* - Interrupt: No
|
||||||
|
* - Signal handler: No
|
||||||
|
* - Thread-Safe: No
|
||||||
|
* - Sync/Async: Sync
|
||||||
|
* - Re-entrant: No
|
||||||
|
* - Required Privileges: None.
|
||||||
|
* - Operation Mode
|
||||||
|
* - Initialization: No
|
||||||
|
* - Run time: No
|
||||||
|
* - De-initialization: Yes
|
||||||
|
*
|
||||||
|
* @return
|
||||||
|
* - 0 always
|
||||||
|
*
|
||||||
|
* @outcome
|
||||||
|
* - EP controller driver is de-registered.
|
||||||
|
* - EP controller is de-initialized(if initialized).
|
||||||
|
*/
|
||||||
|
#if defined(NV_PLATFORM_DRIVER_STRUCT_REMOVE_RETURNS_VOID) /* Linux v6.11 */
|
||||||
|
static void tegra264_pcie_ep_remove_wrapper(struct platform_device *pdev);
|
||||||
|
#else
|
||||||
|
static int tegra264_pcie_ep_remove_wrapper(struct platform_device *pdev);
|
||||||
|
#endif
|
||||||
|
|
||||||
|
#ifdef DOXYGEN_ICD
|
||||||
|
/**
|
||||||
|
* @dir
|
||||||
|
* - forward
|
||||||
|
*/
|
||||||
|
#endif
|
||||||
|
/**
|
||||||
|
* @brief
|
||||||
|
* callback API from Linux System to perform Tegra264 SoC's PCIe EP controller
|
||||||
|
* driver suspend.
|
||||||
|
*
|
||||||
|
* @param[in] dev Device structure associated with driver.
|
||||||
|
*
|
||||||
|
* @usage
|
||||||
|
* - Allowed context for the API call
|
||||||
|
* - Interrupt: No
|
||||||
|
* - Signal handler: No
|
||||||
|
* - Thread-Safe: No
|
||||||
|
* - Sync/Async: Sync
|
||||||
|
* - Re-entrant: No
|
||||||
|
* - Required Privileges: None.
|
||||||
|
* - Operation Mode
|
||||||
|
* - Initialization: No
|
||||||
|
* - Run time: No
|
||||||
|
* - De-initialization: Yes
|
||||||
|
*
|
||||||
|
* @return
|
||||||
|
* - 0 on success
|
||||||
|
* - -EPERM if PCIE EP controller is enabled.
|
||||||
|
*
|
||||||
|
*/
|
||||||
|
static int tegra264_pcie_ep_suspend(struct device *dev);
|
||||||
|
|
||||||
|
#ifdef DOXYGEN_ICD
|
||||||
|
/**
|
||||||
|
* @dir
|
||||||
|
* - forward
|
||||||
|
*/
|
||||||
|
#endif
|
||||||
|
/**
|
||||||
|
* @brief
|
||||||
|
* callback API from Linux System to perform Tegra264 SoC's PCIe EP controller
|
||||||
|
* driver resume.
|
||||||
|
*
|
||||||
|
* @param[in] dev Device structure associated with driver.
|
||||||
|
*
|
||||||
|
* @usage
|
||||||
|
* - Allowed context for the API call
|
||||||
|
* - Interrupt: No
|
||||||
|
* - Signal handler: No
|
||||||
|
* - Thread-Safe: No
|
||||||
|
* - Sync/Async: Sync
|
||||||
|
* - Re-entrant: No
|
||||||
|
* - Required Privileges: None.
|
||||||
|
* - Operation Mode
|
||||||
|
* - Initialization: Yes
|
||||||
|
* - Run time: No
|
||||||
|
* - De-initialization: No
|
||||||
|
*
|
||||||
|
* @return
|
||||||
|
* - 0 always
|
||||||
|
*
|
||||||
|
* @outcome
|
||||||
|
* - Reset IRQ is enabled.
|
||||||
|
*/
|
||||||
|
static int tegra264_pcie_ep_resume(struct device *dev);
|
||||||
|
|
||||||
|
#ifdef DOXYGEN_ICD
|
||||||
|
/**
|
||||||
|
* @dir
|
||||||
|
* - forward
|
||||||
|
*/
|
||||||
|
#endif
|
||||||
|
/**
|
||||||
|
* @brief
|
||||||
|
* Callback API from PCIe EP controller framework to provide config space header info.
|
||||||
|
*
|
||||||
|
* @param[in] epc EP controller structure pointer. This is used to retrieve Drive specific
|
||||||
|
* internal data structures.
|
||||||
|
* @param[in] fn Function number. Unused parameter.
|
||||||
|
* @param[in] vfn Virtual Function number. Unused parameter.
|
||||||
|
* @param[in] hdr Pointer to the struct pci_epf_header containing header info.
|
||||||
|
* Header information supported are:
|
||||||
|
* - LSB 7 bits of deviceid.
|
||||||
|
* - baseclass_code, subclass_code, progif_code.
|
||||||
|
* - Other not supported and ignored.
|
||||||
|
*
|
||||||
|
* @usage
|
||||||
|
* - Allowed context for the API call
|
||||||
|
* - Interrupt: No
|
||||||
|
* - Signal handler: No
|
||||||
|
* - Thread-Safe: No
|
||||||
|
* - Sync/Async: Sync
|
||||||
|
* - Re-entrant: No
|
||||||
|
* - Required Privileges: None.
|
||||||
|
* - Operation Mode
|
||||||
|
* - Initialization: Yes
|
||||||
|
* - Run time: Yes
|
||||||
|
* - De-initialization: Yes
|
||||||
|
*
|
||||||
|
* @return
|
||||||
|
* - 0 always.
|
||||||
|
*
|
||||||
|
* @pre
|
||||||
|
* - Must be called before <a href="#tegra264-pcie-ep-start">(tegra264_pcie_ep_start())</a>.
|
||||||
|
* - Failure to call will result in HW power on reset values for header info.
|
||||||
|
*
|
||||||
|
* @outcome
|
||||||
|
* - Header information is configured during EP controller initialization.
|
||||||
|
*/
|
||||||
|
static int tegra264_pcie_ep_write_header(struct pci_epc *epc, u8 fn,
|
||||||
|
#if defined(NV_PCI_EPC_WRITE_HEADER_HAS_VFN_ARG)
|
||||||
|
u8 vfn,
|
||||||
|
#endif
|
||||||
|
struct pci_epf_header *hdr);
|
||||||
|
|
||||||
|
#ifdef DOXYGEN_ICD
|
||||||
|
/**
|
||||||
|
* @dir
|
||||||
|
* - forward
|
||||||
|
*/
|
||||||
|
#endif
|
||||||
|
/**
|
||||||
|
* @brief
|
||||||
|
* Callback API from PCIe EP controller framework to set Bar configuration.
|
||||||
|
*
|
||||||
|
* @param[in] epc EP controller structure pointer. This is used to retrieve Drive specific
|
||||||
|
* internal data structures.
|
||||||
|
* @param[in] fn Function number. Unused parameter.
|
||||||
|
* @param[in] vfn Virtual Function number. Unused parameter.
|
||||||
|
* @param[in] epf_bar Pointer to the struct pci_epf_bar containing BAR configuration.
|
||||||
|
* Supported configuration are:
|
||||||
|
* - Only 64-bit pre-fetch memory type
|
||||||
|
* - Bar number 1 and 2.
|
||||||
|
* - Bar 1 must of minimum 64MB and Max 64GB, must be power of 2.
|
||||||
|
* - Bar 2 must be of size 32MB.
|
||||||
|
*
|
||||||
|
* @usage
|
||||||
|
* - Allowed context for the API call
|
||||||
|
* - Interrupt: No
|
||||||
|
* - Signal handler: No
|
||||||
|
* - Thread-Safe: No
|
||||||
|
* - Sync/Async: Sync
|
||||||
|
* - Re-entrant: No
|
||||||
|
* - Required Privileges: None.
|
||||||
|
* - Operation Mode
|
||||||
|
* - Initialization: Yes
|
||||||
|
* - Run time: Yes
|
||||||
|
* - De-initialization: Yes
|
||||||
|
*
|
||||||
|
* @pre
|
||||||
|
* - Must be called before <a href="#tegra264-pcie-ep-start">(tegra264_pcie_ep_start())</a>.
|
||||||
|
* - Failure to call will result in
|
||||||
|
* <a href="#tegra264-pcie-ep-start">(tegra264_pcie_ep_start())</a> failure.
|
||||||
|
*
|
||||||
|
* @return
|
||||||
|
* - 0 on If Bar details are in range..
|
||||||
|
* - -EINVAL if Bar configuration is not supported
|
||||||
|
*/
|
||||||
|
static int tegra264_pcie_ep_set_bar(struct pci_epc *epc, u8 fn,
|
||||||
|
#if defined(NV_PCI_EPC_WRITE_HEADER_HAS_VFN_ARG)
|
||||||
|
u8 vfn,
|
||||||
|
#endif
|
||||||
|
struct pci_epf_bar *epf_bar);
|
||||||
|
|
||||||
|
#ifdef DOXYGEN_ICD
|
||||||
|
/**
|
||||||
|
* @dir
|
||||||
|
* - forward
|
||||||
|
*/
|
||||||
|
#endif
|
||||||
|
/**
|
||||||
|
* @brief
|
||||||
|
* Callback API from PCIe EP controller framework to clear BAR configuration.
|
||||||
|
*
|
||||||
|
* @param[in] epc EP controller structure pointer. This is used to retrieve Drive specific
|
||||||
|
* internal data structures.
|
||||||
|
* @param[in] fn Function number. Unused parameter.
|
||||||
|
* @param[in] vfn Virtual Function number. Unused parameter.
|
||||||
|
* @param[in] epf_bar Pointer to the struct pci_epf_bar containing BAR configuration.
|
||||||
|
* Supported configuration are:
|
||||||
|
* - BAR number 0 and 1.
|
||||||
|
*
|
||||||
|
* @usage
|
||||||
|
* - Allowed context for the API call
|
||||||
|
* - Interrupt: No
|
||||||
|
* - Signal handler: No
|
||||||
|
* - Thread-Safe: No
|
||||||
|
* - Sync/Async: Sync
|
||||||
|
* - Re-entrant: No
|
||||||
|
* - Required Privileges: None.
|
||||||
|
* - Operation Mode
|
||||||
|
* - Initialization: Yes
|
||||||
|
* - Run time: Yes
|
||||||
|
* - De-initialization: Yes
|
||||||
|
*
|
||||||
|
* @outcome
|
||||||
|
* - BAR mapping details of supported BAR number are cleared.
|
||||||
|
* - No AI taken for unsupported BAR number or when called before controller
|
||||||
|
* is initialized.
|
||||||
|
*
|
||||||
|
*/
|
||||||
|
static void tegra264_pcie_ep_clear_bar(struct pci_epc *epc, u8 fn,
|
||||||
|
#if defined(NV_PCI_EPC_WRITE_HEADER_HAS_VFN_ARG)
|
||||||
|
u8 vfn,
|
||||||
|
#endif
|
||||||
|
struct pci_epf_bar *epf_bar);
|
||||||
|
|
||||||
|
#ifdef DOXYGEN_ICD
|
||||||
|
/**
|
||||||
|
* @dir
|
||||||
|
* - forward
|
||||||
|
*/
|
||||||
|
#endif
|
||||||
|
/**
|
||||||
|
* @brief
|
||||||
|
* Callback API from PCIe EP controller framework to map outbound address to controller aperture.
|
||||||
|
*
|
||||||
|
* @param[in] epc EP controller structure pointer. This is used to retrieve Drive specific
|
||||||
|
* internal data structures.
|
||||||
|
* @param[in] func_no Function number. Unused parameter
|
||||||
|
* @param[in] vfunc_no Virtual Function number. Unused parameter
|
||||||
|
* @param[in] addr Host memory address to map.
|
||||||
|
* @param[in] pci_addr Aperture controller address to map 'addr' parameter.
|
||||||
|
* @param[in] size The size of the mapping.
|
||||||
|
*
|
||||||
|
* @usage
|
||||||
|
* - Allowed context for the API call
|
||||||
|
* - Interrupt: No
|
||||||
|
* - Signal handler: No
|
||||||
|
* - Thread-Safe: No
|
||||||
|
* - Sync/Async: Sync
|
||||||
|
* - Re-entrant: No
|
||||||
|
* - Required Privileges: None.
|
||||||
|
* - Operation Mode
|
||||||
|
* - Initialization: Yes
|
||||||
|
* - Run time: Yes
|
||||||
|
* - De-initialization: Yes
|
||||||
|
*
|
||||||
|
* @return
|
||||||
|
* - 0 on success.
|
||||||
|
* - EINVAL if there are no aperture windows available to program the mapping or
|
||||||
|
* if called before controller is initialized.
|
||||||
|
*
|
||||||
|
* @outcome
|
||||||
|
* - On success, mapping details in Tegra264 EP controller register is updated.
|
||||||
|
*/
|
||||||
|
static int tegra264_pcie_ep_map_addr(struct pci_epc *epc, u8 func_no,
|
||||||
|
#if defined(NV_PCI_EPC_WRITE_HEADER_HAS_VFN_ARG)
|
||||||
|
u8 vfunc_no,
|
||||||
|
#endif
|
||||||
|
phys_addr_t addr, u64 pci_addr, size_t size);
|
||||||
|
|
||||||
|
#ifdef DOXYGEN_ICD
|
||||||
|
/**
|
||||||
|
* @dir
|
||||||
|
* - forward
|
||||||
|
*/
|
||||||
|
#endif
|
||||||
|
/**
|
||||||
|
* @brief
|
||||||
|
* Callback API from PCIe EP controller framework to un-map outbound address to
|
||||||
|
* controller aperture.
|
||||||
|
*
|
||||||
|
* @param[in] epc EP controller structure pointer. This is used to retrieve Drive specific
|
||||||
|
* internal data structures.
|
||||||
|
* @param[in] func_no Function number. Unused parameter
|
||||||
|
* @param[in] vfunc_no Virtual Function number. Unused parameter
|
||||||
|
* @param[in] addr Aperture controller address to unmap.
|
||||||
|
*
|
||||||
|
* @usage
|
||||||
|
* - Allowed context for the API call
|
||||||
|
* - Interrupt: No
|
||||||
|
* - Signal handler: No
|
||||||
|
* - Thread-Safe: No
|
||||||
|
* - Sync/Async: Sync
|
||||||
|
* - Re-entrant: No
|
||||||
|
* - Required Privileges: None.
|
||||||
|
* - Operation Mode
|
||||||
|
* - Initialization: Yes
|
||||||
|
* - Run time: Yes
|
||||||
|
* - De-initialization: Yes
|
||||||
|
*
|
||||||
|
* @outcome
|
||||||
|
* - If controller is initialized and Aperture is mapped, then mapping details in Tegra264 EP
|
||||||
|
* controller register is cleared. Else, no AI taken.
|
||||||
|
*/
|
||||||
|
static void tegra264_pcie_ep_unmap_addr(struct pci_epc *epc, u8 func_no,
|
||||||
|
#if defined(NV_PCI_EPC_WRITE_HEADER_HAS_VFN_ARG)
|
||||||
|
u8 vfunc_no,
|
||||||
|
#endif
|
||||||
|
phys_addr_t addr);
|
||||||
|
|
||||||
|
/** MSI is expected not to be decomposed, hence no ICD documentation planned yet */
|
||||||
|
static int tegra264_pcie_ep_set_msi(struct pci_epc *epc, u8 fn,
|
||||||
|
#if defined(NV_PCI_EPC_WRITE_HEADER_HAS_VFN_ARG)
|
||||||
|
u8 vfn,
|
||||||
|
#endif
|
||||||
|
u8 mmc);
|
||||||
|
|
||||||
|
static int tegra264_pcie_ep_get_msi(struct pci_epc *epc,
|
||||||
|
#if defined(NV_PCI_EPC_WRITE_HEADER_HAS_VFN_ARG)
|
||||||
|
u8 fn, u8 vfn);
|
||||||
|
#else
|
||||||
|
u8 fn);
|
||||||
|
#endif
|
||||||
|
|
||||||
|
static int tegra264_pcie_ep_raise_irq(struct pci_epc *epc, u8 fn,
|
||||||
|
#if defined(NV_PCI_EPC_WRITE_HEADER_HAS_VFN_ARG)
|
||||||
|
u8 vfn,
|
||||||
|
#endif
|
||||||
|
#if defined(PCI_EPC_IRQ_TYPE_ENUM_PRESENT) /* Dropped from Linux 6.8 */
|
||||||
|
enum pci_epc_irq_type type,
|
||||||
|
#else
|
||||||
|
unsigned int type,
|
||||||
|
#endif
|
||||||
|
u16 irq_num);
|
||||||
|
|
||||||
|
#ifdef DOXYGEN_ICD
|
||||||
|
/**
|
||||||
|
* @dir
|
||||||
|
* - forward
|
||||||
|
*/
|
||||||
|
#endif
|
||||||
|
/**
|
||||||
|
* @brief
|
||||||
|
* Callback API from PCIe EP controller framework to start EP controller functionality.
|
||||||
|
*
|
||||||
|
* @param[in] epc EP controller structure pointer. This is used to retrieve Drive specific
|
||||||
|
* internal data structures.
|
||||||
|
*
|
||||||
|
* @usage
|
||||||
|
* - Allowed context for the API call
|
||||||
|
* - Interrupt: No
|
||||||
|
* - Signal handler: No
|
||||||
|
* - Thread-Safe: No
|
||||||
|
* - Sync/Async: Sync
|
||||||
|
* - Re-entrant: No
|
||||||
|
* - Required Privileges: None.
|
||||||
|
* - Operation Mode
|
||||||
|
* - Initialization: Yes
|
||||||
|
* - Run time: Yes
|
||||||
|
* - De-initialization: Yes
|
||||||
|
*
|
||||||
|
* @return
|
||||||
|
* - 0 on success.
|
||||||
|
* - -EINVAL if controller is failed to initialize
|
||||||
|
*
|
||||||
|
* @pre
|
||||||
|
* - Must be called after <a href="#tegra264-pcie-ep-set-bar">(tegra264_pcie_ep_set_bar())</a>.
|
||||||
|
*
|
||||||
|
* @outcome
|
||||||
|
* - Tegra264 EP controller is initialized, if
|
||||||
|
* - reset GPIO is already de-asserted.
|
||||||
|
* - pre-conditions met.
|
||||||
|
* - pex-prsnt GPIO is de-asserted if specified in CAL_NET_PIF$CalPcieEp.
|
||||||
|
*/
|
||||||
|
static int tegra264_pcie_ep_start(struct pci_epc *epc);
|
||||||
|
|
||||||
|
#ifdef DOXYGEN_ICD
|
||||||
|
/**
|
||||||
|
* @dir
|
||||||
|
* - forward
|
||||||
|
*/
|
||||||
|
#endif
|
||||||
|
/**
|
||||||
|
* @brief
|
||||||
|
* Callback API from PCIe EP controller framework to stop EP controller functionality.
|
||||||
|
*
|
||||||
|
* @param[in] epc EP controller structure pointer. This is used to retrieve Drive specific
|
||||||
|
* internal data structures.
|
||||||
|
*
|
||||||
|
* @usage
|
||||||
|
* - Allowed context for the API call
|
||||||
|
* - Interrupt: No
|
||||||
|
* - Signal handler: No
|
||||||
|
* - Thread-Safe: No
|
||||||
|
* - Sync/Async: Sync
|
||||||
|
* - Re-entrant: No
|
||||||
|
* - Required Privileges: None.
|
||||||
|
* - Operation Mode
|
||||||
|
* - Initialization: Yes
|
||||||
|
* - Run time: Yes
|
||||||
|
* - De-initialization: Yes
|
||||||
|
*
|
||||||
|
* @outcome
|
||||||
|
* - pex-prsnt GPIO is de-asserted if specified in CAL_NET_PIF$CalPcieEp.
|
||||||
|
* - Tegra264 EP controller is de-initialized, if controller is initialized.
|
||||||
|
*/
|
||||||
|
static void tegra264_pcie_ep_stop(struct pci_epc *epc);
|
||||||
|
|
||||||
|
#ifdef DOXYGEN_ICD
|
||||||
|
/**
|
||||||
|
* @dir
|
||||||
|
* - forward
|
||||||
|
*/
|
||||||
|
#endif
|
||||||
|
/**
|
||||||
|
* @brief
|
||||||
|
* Interrupt Callback API for PCIe EP controller interrupt.
|
||||||
|
*
|
||||||
|
* @param[in] irq un-used data
|
||||||
|
* @param[in] arg This is used to retrieve Drive specific internal data structures.
|
||||||
|
*
|
||||||
|
* @usage
|
||||||
|
* - Allowed context for the API call
|
||||||
|
* - Interrupt: Yes
|
||||||
|
* - Signal handler: No
|
||||||
|
* - Thread-Safe: No
|
||||||
|
* - Sync/Async: Sync
|
||||||
|
* - Re-entrant: No
|
||||||
|
* - Required Privileges: None.
|
||||||
|
* - Operation Mode
|
||||||
|
* - Initialization: Yes
|
||||||
|
* - Run time: Yes
|
||||||
|
* - De-initialization: Yes
|
||||||
|
*
|
||||||
|
* @return
|
||||||
|
* - IRQ_WAKE_THREAD - If interrupt notifies about EP reset state
|
||||||
|
* - IRQ_HANDLED - everything else
|
||||||
|
*
|
||||||
|
*/
|
||||||
|
static irqreturn_t tegra264_pcie_ep_irq_handler(int irq, void *arg);
|
||||||
|
|
||||||
|
#ifdef DOXYGEN_ICD
|
||||||
|
/**
|
||||||
|
* @dir
|
||||||
|
* - forward
|
||||||
|
*/
|
||||||
|
#endif
|
||||||
|
/**
|
||||||
|
* @brief
|
||||||
|
* Threaded interrupt Callback API for PCIe EP controller interrupt.
|
||||||
|
*
|
||||||
|
* @param[in] irq un-used data
|
||||||
|
* @param[in] arg This is used to retrieve Drive specific internal data structures.
|
||||||
|
*
|
||||||
|
* @usage
|
||||||
|
* - Allowed context for the API call
|
||||||
|
* - Interrupt: Yes
|
||||||
|
* - Signal handler: No
|
||||||
|
* - Thread-Safe: No
|
||||||
|
* - Sync/Async: Sync
|
||||||
|
* - Re-entrant: No
|
||||||
|
* - Required Privileges: None.
|
||||||
|
* - Operation Mode
|
||||||
|
* - Initialization: Yes
|
||||||
|
* - Run time: Yes
|
||||||
|
* - De-initialization: Yes
|
||||||
|
*
|
||||||
|
* @return
|
||||||
|
* - IRQ_HANDLED - always
|
||||||
|
*
|
||||||
|
* @outcome
|
||||||
|
* - PCIe EP controller is de-initialized and initialized.
|
||||||
|
*
|
||||||
|
*/
|
||||||
|
static irqreturn_t tegra264_pcie_ep_irq_thread(int irq, void *arg);
|
||||||
|
|
||||||
|
#ifdef DOXYGEN_ICD
|
||||||
|
/**
|
||||||
|
* @dir
|
||||||
|
* - forward
|
||||||
|
*/
|
||||||
|
#endif
|
||||||
|
/**
|
||||||
|
* @brief
|
||||||
|
* Interrupt Callback API for PCIe EP reset-gpio changes.
|
||||||
|
*
|
||||||
|
* @param[in] irq un-used data
|
||||||
|
* @param[in] arg This is used to retrieve Drive specific internal data structures.
|
||||||
|
*
|
||||||
|
* @usage
|
||||||
|
* - Allowed context for the API call
|
||||||
|
* - Interrupt: Yes
|
||||||
|
* - Signal handler: No
|
||||||
|
* - Thread-Safe: No
|
||||||
|
* - Sync/Async: Sync
|
||||||
|
* - Re-entrant: No
|
||||||
|
* - Required Privileges: None.
|
||||||
|
* - Operation Mode
|
||||||
|
* - Initialization: Yes
|
||||||
|
* - Run time: Yes
|
||||||
|
* - De-initialization: Yes
|
||||||
|
*
|
||||||
|
* @return
|
||||||
|
* - IRQ_HANDLED - always
|
||||||
|
*
|
||||||
|
* @outcome
|
||||||
|
* - PCIe EP controller is de-initialized if reset GPIO status is asserted.
|
||||||
|
* - PCIe EP controller is Initialized if reset GPIO status and pex-prsnt GPIO
|
||||||
|
* are de-asserted.
|
||||||
|
*
|
||||||
|
*/
|
||||||
|
static irqreturn_t tegra264_pcie_ep_rst_irq(int irq, void *arg);
|
||||||
|
#endif /* PCIE_TEGRAT264_EP_H */
|
||||||
Reference in New Issue
Block a user