root/arch/powerpc/include/asm/pci-bridge.h
/* SPDX-License-Identifier: GPL-2.0-or-later */
#ifndef _ASM_POWERPC_PCI_BRIDGE_H
#define _ASM_POWERPC_PCI_BRIDGE_H
#ifdef __KERNEL__
/*
 */
#include <linux/pci.h>
#include <linux/list.h>
#include <linux/ioport.h>
#include <linux/numa.h>
#include <linux/iommu.h>

struct device_node;

/*
 * PCI controller operations
 */
struct pci_controller_ops {
        void            (*dma_dev_setup)(struct pci_dev *pdev);
        void            (*dma_bus_setup)(struct pci_bus *bus);
        bool            (*iommu_bypass_supported)(struct pci_dev *pdev,
                                u64 mask);

        int             (*probe_mode)(struct pci_bus *bus);

        /* Called when pci_enable_device() is called. Returns true to
         * allow assignment/enabling of the device. */
        bool            (*enable_device_hook)(struct pci_dev *pdev);

        void            (*disable_device)(struct pci_dev *pdev);

        void            (*release_device)(struct pci_dev *pdev);

        /* Called during PCI resource reassignment */
        resource_size_t (*window_alignment)(struct pci_bus *bus,
                                            unsigned long type);
        void            (*setup_bridge)(struct pci_bus *bus,
                                        unsigned long type);
        void            (*reset_secondary_bus)(struct pci_dev *pdev);

#ifdef CONFIG_PCI_MSI
        int             (*setup_msi_irqs)(struct pci_dev *pdev,
                                          int nvec, int type);
        void            (*teardown_msi_irqs)(struct pci_dev *pdev);
#endif

        void            (*shutdown)(struct pci_controller *hose);

        struct iommu_group *(*device_group)(struct pci_controller *hose,
                                            struct pci_dev *pdev);
};

/*
 * Structure of a PCI controller (host bridge)
 */
struct pci_controller {
        struct pci_bus *bus;
        char is_dynamic;
#ifdef CONFIG_PPC64
        int node;
#endif
        struct device_node *dn;
        struct list_head list_node;
        struct device *parent;

        int first_busno;
        int last_busno;
        int self_busno;
        struct resource busn;

        void __iomem *io_base_virt;
#ifdef CONFIG_PPC64
        void __iomem *io_base_alloc;
#endif
        resource_size_t io_base_phys;
        resource_size_t pci_io_size;

        /* Some machines have a special region to forward the ISA
         * "memory" cycles such as VGA memory regions. Left to 0
         * if unsupported
         */
        resource_size_t isa_mem_phys;
        resource_size_t isa_mem_size;

        struct pci_controller_ops controller_ops;
        struct pci_ops *ops;
        unsigned int __iomem *cfg_addr;
        void __iomem *cfg_data;

        /*
         * Used for variants of PCI indirect handling and possible quirks:
         *  SET_CFG_TYPE - used on 4xx or any PHB that does explicit type0/1
         *  EXT_REG - provides access to PCI-e extended registers
         *  SURPRESS_PRIMARY_BUS - we suppress the setting of PCI_PRIMARY_BUS
         *   on Freescale PCI-e controllers since they used the PCI_PRIMARY_BUS
         *   to determine which bus number to match on when generating type0
         *   config cycles
         *  NO_PCIE_LINK - the Freescale PCI-e controllers have issues with
         *   hanging if we don't have link and try to do config cycles to
         *   anything but the PHB.  Only allow talking to the PHB if this is
         *   set.
         *  BIG_ENDIAN - cfg_addr is a big endian register
         *  BROKEN_MRM - the 440EPx/GRx chips have an errata that causes hangs on
         *   the PLB4.  Effectively disable MRM commands by setting this.
         *  FSL_CFG_REG_LINK - Freescale controller version in which the PCIe
         *   link status is in a RC PCIe cfg register (vs being a SoC register)
         */
#define PPC_INDIRECT_TYPE_SET_CFG_TYPE          0x00000001
#define PPC_INDIRECT_TYPE_EXT_REG               0x00000002
#define PPC_INDIRECT_TYPE_SURPRESS_PRIMARY_BUS  0x00000004
#define PPC_INDIRECT_TYPE_NO_PCIE_LINK          0x00000008
#define PPC_INDIRECT_TYPE_BIG_ENDIAN            0x00000010
#define PPC_INDIRECT_TYPE_BROKEN_MRM            0x00000020
#define PPC_INDIRECT_TYPE_FSL_CFG_REG_LINK      0x00000040
        u32 indirect_type;
        /* Currently, we limit ourselves to 1 IO range and 3 mem
         * ranges since the common pci_bus structure can't handle more
         */
        struct resource io_resource;
        struct resource mem_resources[3];
        resource_size_t mem_offset[3];
        int global_number;              /* PCI domain number */

        resource_size_t dma_window_base_cur;
        resource_size_t dma_window_size;

#ifdef CONFIG_PPC64
        unsigned long buid;
        struct pci_dn *pci_data;
#endif  /* CONFIG_PPC64 */

        void *private_data;

        /* IRQ domain hierarchy */
        struct irq_domain       *dev_domain;

        /* iommu_ops support */
        struct iommu_device     iommu;
};

/* These are used for config access before all the PCI probing
   has been done. */
extern int early_read_config_byte(struct pci_controller *hose, int bus,
                        int dev_fn, int where, u8 *val);
extern int early_read_config_word(struct pci_controller *hose, int bus,
                        int dev_fn, int where, u16 *val);
extern int early_read_config_dword(struct pci_controller *hose, int bus,
                        int dev_fn, int where, u32 *val);
extern int early_write_config_byte(struct pci_controller *hose, int bus,
                        int dev_fn, int where, u8 val);
extern int early_write_config_word(struct pci_controller *hose, int bus,
                        int dev_fn, int where, u16 val);
extern int early_write_config_dword(struct pci_controller *hose, int bus,
                        int dev_fn, int where, u32 val);

extern int early_find_capability(struct pci_controller *hose, int bus,
                                 int dev_fn, int cap);

extern void setup_indirect_pci(struct pci_controller* hose,
                               resource_size_t cfg_addr,
                               resource_size_t cfg_data, u32 flags);

extern int indirect_read_config(struct pci_bus *bus, unsigned int devfn,
                                int offset, int len, u32 *val);

extern int __indirect_read_config(struct pci_controller *hose,
                                  unsigned char bus_number, unsigned int devfn,
                                  int offset, int len, u32 *val);

extern int indirect_write_config(struct pci_bus *bus, unsigned int devfn,
                                 int offset, int len, u32 val);

static inline struct pci_controller *pci_bus_to_host(const struct pci_bus *bus)
{
        return bus->sysdata;
}

#ifdef CONFIG_PPC_PMAC
extern int pci_device_from_OF_node(struct device_node *node,
                                   u8 *bus, u8 *devfn);
#endif
#ifndef CONFIG_PPC64

#ifdef CONFIG_PPC_PCI_OF_BUS_MAP
extern void pci_create_OF_bus_map(void);
#else
static inline void pci_create_OF_bus_map(void) {}
#endif

#else   /* CONFIG_PPC64 */

/*
 * PCI stuff, for nodes representing PCI devices, pointed to
 * by device_node->data.
 */
struct iommu_table;

struct pci_dn {
        int     flags;
#define PCI_DN_FLAG_IOV_VF      0x01
#define PCI_DN_FLAG_DEAD        0x02    /* Device has been hot-removed */

        int     busno;                  /* pci bus number */
        int     devfn;                  /* pci device and function number */
        int     vendor_id;              /* Vendor ID */
        int     device_id;              /* Device ID */
        int     class_code;             /* Device class code */

        struct  pci_dn *parent;
        struct  pci_controller *phb;    /* for pci devices */
        struct  iommu_table_group *table_group; /* for phb's or bridges */

        int     pci_ext_config_space;   /* for pci devices */
#ifdef CONFIG_EEH
        struct eeh_dev *edev;           /* eeh device */
#endif
#define IODA_INVALID_PE         0xFFFFFFFF
        unsigned int pe_number;
#ifdef CONFIG_PCI_IOV
        u16     vfs_expanded;           /* number of VFs IOV BAR expanded */
        u16     num_vfs;                /* number of VFs enabled*/
        unsigned int *pe_num_map;       /* PE# for the first VF PE or array */
        bool    m64_single_mode;        /* Use M64 BAR in Single Mode */
#define IODA_INVALID_M64        (-1)
        int     (*m64_map)[PCI_SRIOV_NUM_BARS]; /* Only used on powernv */
        int     last_allow_rc;                  /* Only used on pseries */
#endif /* CONFIG_PCI_IOV */
        int     mps;                    /* Maximum Payload Size */
        struct list_head child_list;
        struct list_head list;
        struct resource holes[PCI_SRIOV_NUM_BARS];
};

/* Get the pointer to a device_node's pci_dn */
#define PCI_DN(dn)      ((struct pci_dn *) (dn)->data)

extern struct pci_dn *pci_get_pdn_by_devfn(struct pci_bus *bus,
                                           int devfn);
extern struct pci_dn *pci_get_pdn(struct pci_dev *pdev);
extern struct pci_dn *pci_add_device_node_info(struct pci_controller *hose,
                                               struct device_node *dn);
extern void pci_remove_device_node_info(struct device_node *dn);

#ifdef CONFIG_PCI_IOV
struct pci_dn *add_sriov_vf_pdns(struct pci_dev *pdev);
void remove_sriov_vf_pdns(struct pci_dev *pdev);
#endif

#if defined(CONFIG_EEH)
static inline struct eeh_dev *pdn_to_eeh_dev(struct pci_dn *pdn)
{
        return pdn ? pdn->edev : NULL;
}
#else
#define pdn_to_eeh_dev(x)       (NULL)
#endif

/** Find the bus corresponding to the indicated device node */
extern struct pci_bus *pci_find_bus_by_node(struct device_node *dn);

/** Remove all of the PCI devices under this bus */
extern void pci_hp_remove_devices(struct pci_bus *bus);

/** Discover new pci devices under this bus, and add them */
extern void pci_hp_add_devices(struct pci_bus *bus);

extern int pcibios_unmap_io_space(struct pci_bus *bus);
extern int pcibios_map_io_space(struct pci_bus *bus);

#ifdef CONFIG_NUMA
#define PHB_SET_NODE(PHB, NODE)         ((PHB)->node = (NODE))
#else
#define PHB_SET_NODE(PHB, NODE)         ((PHB)->node = NUMA_NO_NODE)
#endif

#endif  /* CONFIG_PPC64 */

/* Get the PCI host controller for an OF device */
extern struct pci_controller *pci_find_hose_for_OF_device(
                        struct device_node* node);

extern struct pci_controller *pci_find_controller_for_domain(int domain_nr);

/* Fill up host controller resources from the OF node */
extern void pci_process_bridge_OF_ranges(struct pci_controller *hose,
                        struct device_node *dev, int primary);

/* Allocate & free a PCI host bridge structure */
extern struct pci_controller *pcibios_alloc_controller(struct device_node *dev);
extern void pcibios_free_controller(struct pci_controller *phb);
extern void pcibios_free_controller_deferred(struct pci_host_bridge *bridge);

#ifdef CONFIG_PCI
extern int pcibios_vaddr_is_ioport(void __iomem *address);
#else
static inline int pcibios_vaddr_is_ioport(void __iomem *address)
{
        return 0;
}
#endif  /* CONFIG_PCI */

#endif  /* __KERNEL__ */
#endif  /* _ASM_POWERPC_PCI_BRIDGE_H */