···1717 $nodename:1818 pattern: "^pcie-ep@"19192020+ iommu-map:2121+ $ref: /schemas/types.yaml#/definitions/uint32-matrix2222+ items:2323+ items:2424+ - description: Device ID (see msi-map) base2525+ maximum: 0x7ffff2626+ - description: phandle to IOMMU2727+ - description: IOMMU specifier base (currently always 1 cell)2828+ - description: Number of Device IDs2929+ maximum: 0x800003030+3131+ iommu-map-mask:3232+ description:3333+ A mask to be applied to each Device ID prior to being mapped to an3434+ IOMMU specifier per the iommu-map property.3535+ $ref: /schemas/types.yaml#/definitions/uint323636+ maximum: 0x7ffff3737+2038 max-functions:2139 description: Maximum number of functions that can be configured2240 $ref: /schemas/types.yaml#/definitions/uint8···5234 max-link-speed:5335 $ref: /schemas/types.yaml#/definitions/uint325436 enum: [ 1, 2, 3, 4 ]3737+3838+ msi-map:3939+ description: |4040+ Maps a Device ID to an MSI and associated MSI specifier data.4141+4242+ A PCI Endpoint (EP) can use MSI as a doorbell function. This is achieved by4343+ mapping the MSI controller's address into PCI BAR<n>. The PCI Root Complex4444+ can write to this BAR<n>, triggering the EP to generate IRQ. This notifies4545+ the EP-side driver of an event, eliminating the need for the driver to4646+ continuously poll for status changes.4747+4848+ However, the EP cannot rely on Requester ID (RID) because the RID is4949+ determined by the PCI topology of the host system. Since the EP may be5050+ connected to different PCI hosts, the RID can vary between systems and is5151+ therefore not a reliable identifier.5252+5353+ Each EP can support up to 8 physical functions and up to 65,536 virtual5454+ functions. To uniquely identify each child device, a device ID is defined5555+ as5656+ - Bits [2:0] for the function number (func)5757+ - Bits [18:3] for the virtual function index (vfunc)5858+5959+ The resulting device ID is computed as:6060+6161+ (func & 0x7) | (vfunc << 3)6262+6363+ The property is an arbitrary number of tuples of6464+ (device-id-base, msi, msi-base,length).6565+6666+ Any Device ID id in the interval [id-base, id-base + length) is6767+ associated with the listed MSI, with the MSI specifier6868+ (id - id-base + msi-base).6969+ $ref: /schemas/types.yaml#/definitions/uint32-matrix7070+ items:7171+ items:7272+ - description: The Device ID base matched by the entry7373+ maximum: 0x7ffff7474+ - description: phandle to msi-controller node7575+ - description: (optional) The msi-specifier produced for the first7676+ Device ID matched by the entry. Currently, msi-specifier is 0 or7777+ 1 cells.7878+ - description: The length of consecutive Device IDs following the7979+ Device ID base8080+ maximum: 0x800008181+8282+ msi-map-mask:8383+ description: A mask to be applied to each Device ID prior to being8484+ mapped to an msi-specifier per the msi-map property.8585+ $ref: /schemas/types.yaml#/definitions/uint328686+ maximum: 0x7ffff55875688 num-lanes:5789 description: maximum number of lanes