1. Technical Field
The present application relates generally to an improved data processing system and method. More specifically, the present application is directed to an apparatus and method for communicating with an I/O device or endpoint using a queue data structure and pre-translated addresses, which may be cached in the I/O device or endpoint.
2. Description of Related Art
On some systems, with current Peripheral Component Interconnect (PCI) protocols, when performing direct memory access (DMA) operations, address translation and access checks are performed using an address translation and protection table (ATPT). Though ATPTs have been in use for several decades, they are new to lower end systems and are known by several other names, such as a Direct Memory Access (DMA) Remapping Resource or an Input/Output Memory Management Unit (IOMMU). The ATPT stores entries for translating PCI bus addresses, utilized in DMA transactions, to real memory addresses used to access the real memory resources. The entries in the ATPT store protection information identifying which devices may access corresponding portions of memory and the particular operations that such devices may perform on these portions of memory.
Recently, the PCI-SIG (www.pcisig.com/home) has been in the process of standardizing mechanisms that allow the address translations resident in an ATPT to be cached in a PCI family adapter. These mechanisms are known as Address Translation Services (ATS). ATS allows a PCI family adapter to request a translation for an untranslated PCI Bus address, where a successful completion of such a request on a system that supports ATS returns the translated, i.e. real memory address, to the PCI family adapter. ATS allows a PCI family adapter to then mark PCI bus addresses used in DMA operations as translated. A system that supports ATS will then use the translated addresses to bypass the ATPT. ATS also provides a mechanism by which the host side (e.g. hardware or virtualization intermediary) can invalidate a previously advertised address translation.
As shown in
The PCIe endpoint includes internal routing circuitry 142, configuration management logic 144, one or more physical functions (PFs) 146 and zero or more virtual functions (VFs) 148-152, where each VF is associated with a PF. ATS permits each virtual function to make use of an address translation cache (ATC) 160-164 for caching PCI memory addresses that have already been translated and can be used by the virtual function to bypass the host ATPT 130 when performing DMA operations.
In operation, the PCIe endpoint 140 may invoke PCIe ATS transactions to request a translation of a given PCI bus address into a system bus address and indicate that a subsequent transaction, e.g., a DMA operation, has been translated and can bypass the ATPT. The root complex 120 may invoke PCIe ATS transactions to invalidate a translation that was provided to the PCIe endpoint 140 so that the translation is no longer used by the physical and/or virtual function(s) of the PCIe endpoint 140.
For example, when a DMA operation is to be performed, the address of the DMA operation may be looked-up in the ATC 160-164 of the particular virtual function 148-152 handling the DMA operation. If an address translation is not present in the ATC 160-164, then a translation request may be made by the PCIe endpoint 140 to the root complex 120. The root complex 120 may then perform address translation using the ATPT 130 and return the translated address to the PCIe endpoint 140. The PCIe endpoint 140 may then store the translation in an appropriate ATC 160-164 corresponding to the physical and/or virtual function that is handling the DMA operation. The DMA operation may be passed onto the system bus 115 using the translated address.
If a translation for this address is already present in the ATC 160-164, then the translated address is used with the DMA operation. A bit may be set in the DMA header to indicate that the address is already translated and that the ATPT 130 in the root complex 120 may be bypassed for this DMA. As a result, the DMA operation is performed directly between the PCIe endpoint 140 and the host CPUs and memory 110 via the PCIe link 135 and system bus 115. Access checks may still be performed by the root complex 120 to ensure that the particular BDF number of the virtual function of the PCIe endpoint corresponds to a BDF that is permitted to access the address in the manner requested by the DMA operation.
At some time later, if the translation that was provided to the PCIe endpoint 140 is no longer to be used by the PCIe endpoint 140, such as when a translation has changed within the ATPT 130, the root complex 120 must issue an ATS invalidation request to the PCIe endpoint 140. The PCIe endpoint 140 does not immediately flush all pending requests directed to the invalid address. Rather, the PCIe endpoint 140 waits for all outstanding read requests that reference the invalid translated address to retire and releases the translation in the ATC 160-164, such as by setting a bit to mark the entry in the ATC 160-164 to be invalid. The PCIe endpoint 140 returns an ATS invalidation completion message to the root complex 120 indicating completion of the invalidating of the translation in the ATC 160-164. The PCIe endpoint 140 ensures that the invalidation completion indication arrives at the root complex 120 after any previously posted writes that use the invalidated address.
Typically, the ATPT 130 may be provided as tree-structured translation tables in system memory. A different tree-structure may be provided for each PCI Bus/Device/Function (BDF) of the computing system. Using these ATPT data structures, devices may share a device address space and devices may have dedicated address spaces. Thus, not all devices may perform all DMA operations on all address spaces of the system memory.
The accessing of the ATPT 130 is done synchronously as part of the DMA transaction. This involves utilizing a time consuming translation mechanism for: translating the untranslated PCI bus memory addresses of the DMA transactions to translated real memory addresses used to access the host's memory; and checking the ATPT to ensure that the device submitting the DMA transaction has sufficient permissions for accessing the translated real memory addresses and has sufficient permissions to perform the desired DMA operation on the translated real memory addresses.
As part of accessing the ATPT 130, the correct ATPT tree data structure corresponding to a particular BDF must be identified and the tree data structure must be walked in order to perform the translation and access checking. The location of the ATPT tree data structure may require one or two accesses to find the address of the tree data structure associated with the BDF. Once found, it may take 3 or 4 accesses of the tree data structure to walk the tree. Thus, this translation and access checking is responsible for the large latencies associated with DMA operations. These latencies may cause serious issues with endpoints that require low communication latency.
As a way of mitigating these latencies, the ATS implemented in the PCIe endpoint 140 utilizes the ATCs 160-164 to store already performed address translations so that these translations need not be performed again. Thus, through a combination of the ATPT and the ATCs, the PCI ATS performs address translations and access checks in such a manner as to reduce the latency associated with DMA operations. While the PCI SiG has set forth a specification for the PCIe ATS, the PCI SiG has not specified how the responsibilities for performing address translation using ATS and managing ATS structures, such as the ATPT and ATCs, are to be apportioned in a system implementing the PCIe ATS.
The illustrative embodiments provide an apparatus and method for communicating with an input/output (I/O) device or endpoint using a queue data structure and pre-translated addresses, which may be cached in the I/O device or endpoint. With the apparatus and method, responsibilities for cache management of address translation information associated with the queue data structure are distributed between a device driver and device driver services. The device driver may be provided in an untrusted mission logical partition (LPAR) while the device driver services may be provided in a trusted virtualization intermediary, such as a virtualization intermediary operating system, hypervisor, service partition, or the like.
The device driver is responsible for managing queues for communicating requests between applications in the LPAR and the PCIe endpoint, and vice versa. The device driver is further responsible for invoking memory management via the device driver services. The device driver services are responsible for managing memory accessible by the PCIe endpoint, including the address translation and protection table (ATPT) and the address translation caches (ATCs) of the PCIe endpoint.
By splitting the responsibilities for communicating with the PCIe endpoint between the device driver and the device driver services, a device driver running within an OS cannot provide the PCIe endpoint with a translation that is associated with another OS's memory. As a result, the trust model associated with system virtualization is maintained. That is, placing the address translation cache management responsibilities in device driver services prevents one OS from requesting that the endpoint perform a DMA operation to another OS's memory.
In one illustrative embodiment, during initialization of a device driver in an untrusted mission logical partition (LPAR) system image of a host system, the device driver for the PCIe endpoint, invokes device driver services (hereafter referred to as simply “driver services”) to initialize address translation and protection table (ATPT) entries and return PCI memory addresses to the device driver for adapter resources resident in system memory, such as command, response, and event queues, and accessible by the PCIe endpoint through direct memory access (DMA) operations. The device driver and PCIe endpoint communicate through the command, response, and event queues. In this document these queues will be referred to as the “device driver's queues.”
Essentially, the device driver services pin the host memory for the device driver's queue(s), assigns DMA addresses for the device driver's queue(s), programs the ATPT entries for these DMA addresses, and enables a bit stating that the ATPT entries are cacheable, i.e. cacheable in queue context, e.g., an address translation cache, on the PCIe endpoint. The device driver services then return the untranslated PCIe memory address(es), i.e. the DMA address(es) to the device driver for the ATPT entries e.g., a starting address for the device driver's queue(s) which, along with an offset, may be used to identify a particular entry in the queue. The untranslated PCIe memory address is an address that is not in the system's memory space and must be translated before it can be used to access system memory.
Using the mechanisms of the illustrative embodiments, this untranslated PCIe memory address may be provided to the PCIe endpoint and used by the PCIe endpoint to send a translation request to the root complex. That is, the PCIe endpoint can request the root complex to return a translated PCIe memory address, or addresses, associated with the untranslated PCIe memory address. The PCIe endpoint may then store the translated PCIe memory address or addresses in the context associated with the device driver's queue(s), e.g., one or more address translation caches associated with one or more virtual functions in the PCIe endpoint.
Storing the translation of the untranslated PCIe memory address in the adapter's device driver queue context allows the PCIe endpoint to bypass the root complex's ATPT on DMAs that target device driver queue entries. Thus, when the root complex receives a PCIe DMA transaction marked as translated, the root complex verifies that translation caching is enabled for the endpoint and uses the translated PCIe memory address directly to access the host's real memory.
At some point in time later, such as after the PCIe endpoint is removed from the system, after the function (physical or virtual) associated with the device driver is removed from the system, or the like, the ATPT entries and ATC entries corresponding to the untranslated PCIe memory address may need to be invalidated. In order to perform such invalidation, the device driver or some higher level entity, such as a hypervisor management component, invokes the device driver services to unpin the host memory and release the DMA address, i.e. the untranslated PCIe memory address. The device driver services then clears the ATPT entries corresponding to the untranslated PCIe memory address and the root complex issues an ATC entry invalidation request to the PCIe endpoint. The PCIe endpoint then performs operations to invalidate any ATC entries corresponding to the untranslated PCIe memory address and, after the untranslated PCIe memory addresses are no longer in use, returns an ATC invalidation completion response to the device services. The device services then return control to the device driver. In an alternative implementation, the device driver services may issue the ATC entry invalidation request to the PCIe endpoint and, after the PCIe endpoint completes the ATC entry invalidation, the device driver services may clear the ATPT entries and returns to the device driver.
As mentioned above, the mechanisms of the illustrative embodiments may be utilized to establish ATPT entries for use in communicating between the system image, applications running in the system image, etc., and the PCIe endpoint using one or more queue data structures. In such an implementation of the illustrative embodiments, the ATPT entries for the one or more queue data structures are initialized in the manner previously described above. During the PCIe endpoint's initialization phase, the PCIe endpoint verifies that the device driver has been initialized. This may be done, for example, by reading information from a PCI configuration space, a Vital Product Data (VPD) field, or a memory mapped input/output (MMIO) field of the PCIe endpoint.
The device driver may provide the start and ending addresses, the starting address and a length, or the like, of the one or more queues to the PCIe endpoint. For example, the device driver may write these addresses into a PCI configuration space field, VPD or MMIO field of the PCIe endpoint corresponding to a queue configuration space. These addresses are untranslated PCIe addresses. The PCIe endpoint may invoke a PCIe ATS request for translation of the queue addresses. As a result, the root complex may use the ATPT to perform address translation and return the result to the PCIe endpoint which may cache the translated addresses in a queue context for use in retrieving items from the one or more queues and to place items in the one or more queues.
In one illustrative embodiment, the device driver generates queue data structures for communicating with a PCIe endpoint. The queue data structures may comprise, for example, a command queue and a response queue. The queue data structures may be small component system interface (SCSI) queues for communicating with SCSI I/O devices coupled to a PCIe endpoint, for example. These queue data structures may be configured in any manner including linked list queues, circular buffer queues, or the like.
As part of the operation performed by the device driver in generating these queue data structures, the device driver invokes the device driver services to program the ATPT entries for the queue data structures and return an untranslated PCIe address, i.e. a DMA address, for the queues to the device driver. The programming of the ATPT entries may involve pinning the host memory space used for the queue data structures, programming the ATPT entries in the ATPT of the root complex with the translation information for translating from a untranslated PCIe address to a system memory address, and setting a cache enable bit in the ATPT entries indicating that the address translations corresponding to the ATPT entries are cacheable in an ATC of the PCIe endpoint. After performing such operations, the untranslated PCIe address(es) for the ATPT entry or entries are returned to the device driver. These untranslated PCIe address(es) may identify, for example, the start and end addresses of the queue data structures.
The untranslated PCIe address(es) are provided by the device driver to the PCIe endpoint, such as by writing the addresses to a queue configuration space in the PCIe endpoint. The queue configuration space may be, for example, a PCI configuration space, one or more VPD fields, one or more MMIO fields, or the like. In response to receiving these untranslated PCIe address(es) for the queue data structures, the PCIe endpoint may issue a PCIe ATS request for the queue addresses to the root complex. As a result, the root complex may perform address translation and access checks for the untranslated PCIe addresses of the queue data structures and return the translated addresses to the PCIe endpoint. The PCIe endpoint may then store these address translations in a queue context provided by the ATC of the PCIe endpoint.
As a result of the above, since the PCIe endpoint now has access to the translations for the addresses associated with the queue data structures, the PCIe endpoint may now perform DMA operations to submit or retrieve queue entries to/from the queue data structures without having to go through the root complex ATPT address translation.
Once the queue data structures are no longer to be utilized by the PCIe endpoint, the ATPT and ATC entries corresponding to the addresses for these queue data structures may be invalidated in the manner previously described above. Such invalidation may be performed, for example, when the PCIe endpoint is to be removed from the system, after the function (physical or virtual) associated with the device driver is removed from the host system, or the like. This process of invalidation may involve the device driver invoking the device driver services to unpin the host system memory corresponding to the queue data structures, releasing the DMA addresses for these queue data structures, clearing the ATPT entries for these DMA addresses, and issuing an ATC entry invalidation request to the PCIe endpoint. When the ATC entry invalidation operation is completed by the PCIe endpoint, the device driver services returns control to the device driver and at this point the PCIe endpoint may be removed from the system.
As described above, the mechanisms of the illustrative embodiments may be utilized to establish queue data structures in a device driver and their corresponding ATPT entries in the root complex of a data processing system. Once such queue data structures are initialized through the mechanisms described above, communication between the application instances, system image, and the like, of a logical partition of the host system and a PCIe endpoint may be performed using these queue data structures and ATPT entries.
These queue data structures and corresponding ATPT entries may be utilized with PCIe endpoints of different types. For example, the PCIe endpoint may be a networking adapter, such as an Ethernet adapter, Fibre Channel adapter, InfiniBand™ adapter, or the like, for communicating with other devices over one or more data networks. With such networking adapters, data that is being transmitted or received is placed into a buffer associated with the host system's device driver and fetched by either the host system's system image or the PCIe adapter, depending upon whether the data is being received or transmitted. The mechanisms of the illustrative embodiments provide for the establishment of queue data structures and the caching of translated addresses corresponding to the queues so that data may be sent directly to the transmit and/or receive buffers using these translated addresses and a DMA operation without having to undergo address translation by the root complex at the time of the transmission/reception of the data. Hence, the mechanisms reduce the latency associated with data transmission and reception via network adapters.
In addition to use with networking adapters, the mechanisms of the illustrative embodiments may further be used with other types of PCIe endpoints for communicating with locally available devices. For example, the PCIe endpoint may be a small component system interface (SCSI) adapter for communicating with storage devices directly attached to the PCIe endpoint. The mechanisms of the illustrative embodiments may be utilized to reduce the DMA read latency of SCSI adapters by providing a mechanism for caching address information for SCSI reads/writes in the SCSI adapter.
In one illustrative embodiment, a method for establishing address translations for communicating between a device driver and an input/output (I/O) device is provided. The method may comprise creating, by the device driver, a queue data structure used to contain queue elements associated with communication between the device driver and the I/O device. The method may further comprise initializing one or more address translation entries in an address translation data structure associated with a root complex of the data processing system for the queue data structure, in response to the device driver invoking device driver services. The one or more address translation entries may specify one or more translations from one or more untranslated addresses to one or more translated memory addresses associated with the queue data structure.
The method may also comprise providing translation information, from the address translation data structure, for the one or more address translations associated with the queue data structure to the I/O device. Moreover, the method may comprise caching the address translation information in the I/O device for processing communications associated with the queue data structure. The I/O device may request the address translation information associated with one or more untranslated addresses of the queue data structures used to communicate between the device driver and the I/O device.
Providing the address translation information associated with the queue data structure to the I/O device may comprise passing, by the device driver services, the one or more untranslated addresses to the device driver and providing, by the device driver, the one or more untranslated addresses of the queue data structure to the I/O device. Providing the address translation information may further comprise sending, by the I/O device, an address translation request to the root complex in response to receiving the one or more untranslated addresses and receiving, from the root complex, the one or more translated addresses associated with the one or more untranslated addresses based on the one or more address translation entries in the root complex associated with the queue data structure. Providing the one or more untranslated addresses of the queue data structure to the I/O device may comprise writing, by one of the device driver or the device driver services, the one or more untranslated addresses into one of an I/O device configuration space or an I/O memory mapped input/output (MMIO) memory space.
The I/O device may store the one or more translated addresses of the queue data structures used to communicate between the device driver and the I/O device. Moreover, the I/O device may use one or more previously stored translated addresses when performing a DMA transaction to access one or more entries of the queue data structures used to communicate between the device driver and the I/O device.
The method may comprise receiving, in the I/O device, an invalidation request that targets the translation information for the one or more address translations associated with the queue data structure. The method may further comprise invalidating the translation information for the one or more address translations in the cache of the I/O device in response to receiving the invalidation request.
The queue data structures may store queue entries specifying control information to be communicated between the device driver and one of a storage device or network device. The storage device or network device may be a Peripheral Component Interconnect Extended (PCIe) adapter.
The queue data structure may be configured as one of a linked list queue data structure or a circular buffer queue data structure. The one or more untranslated addresses may comprise at least an untranslated starting address for the queue data structure and optionally comprise one of an untranslated ending address for the queue data structure or a length of the queue data structure. The device driver may be provided in a system image or untrusted logical partition of the data processing system and the device driver services are provided in a trusted virtualization intermediary.
In other illustrative embodiments, a computer program product comprising a computer useable medium having a computer readable program is provided. The computer readable program, when executed on a computing device, causes the computing device to perform various ones, and combinations of, the operations outlined above with regard to the method illustrative embodiment.
In yet another illustrative embodiment, an apparatus is provided. The apparatus may comprise a processor and an input/output (I/O) endpoint coupled to the processor. The processor may execute instructions that cause the processor to create, by the device driver, a queue data structure used to contain queue elements associated with communication between the device driver and the I/O device. The instructions may further cause the processor to initialize one or more address translation entries in an address translation data structure associated with a root complex of the data processing system for the queue data structure, in response to the device driver invoking device driver services. The one or more address translation entries may specify one or more translations from one or more untranslated addresses to one or more translated memory addresses associated with the queue data structure.
The instructions may further cause the processor to provide translation information, from the address translation data structure, for the one or more address translations associated with the queue data structure to the I/O device and cache the address translation information in the I/O device for processing communications associated with the queue data structure.
These and other features and advantages of the present invention will be described in, or will become apparent to those of ordinary skill in the art in view of, the following detailed description of the exemplary embodiments of the present invention.
The invention, as well as a preferred mode of use and further objectives and advantages thereof, will best be understood by reference to the following detailed description of illustrative embodiments when read in conjunction with the accompanying drawings, wherein:
The illustrative embodiments provide mechanisms by which endpoint address translation management responsibilities are distributed across a device driver and device driver services in order to facilitate more efficient Direct Memory Access (DMA) operations between an endpoint and a host system. As such, the illustrative embodiments may be implemented in any computing device in which DMA operations may be performed utilizing a device driver and device driver services, as described hereafter. Such computing devices may take many forms and may have various configurations.
With reference now to the figures and in particular with reference to
With reference now to the figures,
In the depicted example, server 204 and server 206 are connected to network 202 along with storage unit 208. In addition, clients 210, 212, and 214 are also connected to network 202. These clients 210, 212, and 214 may be, for example, personal computers, network computers, or the like. In the depicted example, server 204 provides data, such as boot files, operating system images, and applications to the clients 210, 212, and 214. Clients 210, 212, and 214 are clients to server 204 in the depicted example. Distributed data processing system 200 may include additional servers, clients, and other devices not shown.
In the depicted example, distributed data processing system 200 is the Internet with network 202 representing a worldwide collection of networks and gateways that use the Transmission Control Protocol/Internet Protocol (TCP/IP) suite of protocols to communicate with one another. At the heart of the Internet is a backbone of high-speed data communication lines between major nodes or host computers, consisting of thousands of commercial, governmental, educational and other computer systems that route data and messages. Of course, the distributed data processing system 200 may also be implemented to include a number of different types of networks, such as for example, an intranet, a local area network (LAN), a wide area network (WAN), or the like. As stated above,
With reference now to
In the depicted example, data processing system 200 employs a hub architecture including north bridge and memory controller hub (NB/MCH) 302 and south bridge and input/output (I/O) controller hub (SB/ICH) 304. Processing unit 306, main memory 308, and graphics processor 310 are connected to NB/MCH 302. Graphics processor 310 may be connected to NB/MCH 302 through an accelerated graphics port (AGP).
In the depicted example, local area network (LAN) adapter 312 connects to SB/ICH 304. Audio adapter 316, keyboard and mouse adapter 220, modem 322, read only memory (ROM) 324, hard disk drive (HDD) 326, CD-ROM drive 330, universal serial bus (USB) ports and other communication ports 232, and PCI/PCIe devices 334 connect to SB/ICH 304 through bus 338 and bus 340. PCI/PCIe devices may include, for example, Ethernet adapters, add-in cards, and PC cards for notebook computers. PCI uses a card bus controller, while PCIe does not. ROM 324 may be, for example, a flash binary input/output system (BIOS).
HDD 326 and CD-ROM drive 330 connect to SB/ICH 304 through bus 340. HDD 326 and CD-ROM drive 330 may use, for example, an integrated drive electronics (IDE) or serial advanced technology attachment (SATA) interface. Super I/O (SIO) device 336 may be connected to SB/ICH 204.
An operating system runs on processing unit 306. The operating system coordinates and provides control of various components within the data processing system 300 in
As a server, data processing system 300 may be, for example, an IBN® eServer™ pSeries® computer system, running the Advanced Interactive Executive (AIX®) operating system or the LINUX® operating system (eServer, pSeries and AIX are trademarks of International Business Machines Corporation in the United States, other countries, or both while LINUX is a trademark of Linus Torvalds in the United States, other countries, or both). Data processing system 300 may be a symmetric multiprocessor (SMP) system including a plurality of processors in processing unit 306. Alternatively, a single processor system may be employed.
Instructions for the operating system, the object-oriented programming system, and applications or programs are located on storage devices, such as HDD 326, and may be loaded into main memory 308 for execution by processing unit 306. The processes for illustrative embodiments of the present invention may be performed by processing unit 306 using computer usable program code, which may be located in a memory such as, for example, main memory 308, ROM 324, or in one or more peripheral devices 326 and 330, for example.
A bus system, such as bus 338 or bus 340 as shown in
Those of ordinary skill in the art will appreciate that the hardware in
Moreover, the data processing system 300 may take the form of any of a number of different data processing systems including client computing devices, server computing devices, a tablet computer, laptop computer, telephone or other communication device, a personal digital assistant (PDA), or the like. In some illustrative examples, data processing system 300 may be a portable computing device which is configured with flash memory to provide non-volatile memory for storing operating system files and/or user-generated data, for example. Essentially, data processing system 300 may be any known or later developed data processing system without architectural limitation.
As mentioned above, the illustrative embodiments provide a system and method for distributing the responsibilities for endpoint address translation cache management between a device driver and device driver services. The device driver may be provided, for example, in an untrusted mission logical partition (LPAR) and the device driver services may be provided, for example, in a trusted input/output (I/O) virtualization intermediary (VI). While PCIe endpoints and the PCIe communication protocol will be used in the description of the illustrative embodiments, it should be appreciated that the illustrative embodiments are not limited to such and any communication protocol may be utilized without departing from the spirit and scope of the present invention.
With regard to the illustrative embodiments, the device driver is responsible for managing and utilizing queue structures for communicating between user applications/libraries and PCIe endpoints. The device driver is further responsible for invoking memory management services provided by the device driver services. The device driver services initialize and manage the address translation and protection table (ATPT) of the PCIe root complex of the computing system as well as address translation caches (ATCs) of the PCIe endpoints. The manner by which such initialization and management is performed will be described hereafter.
In one illustrative embodiment, during initialization of a device driver for a PCIe endpoint in a system image of a logical partition of the host system, the device driver for the PCIe endpoint invokes device driver services to initialize address translation and protection table (ATPT) entries and return a PCI memory address to the device driver. In one illustrative embodiment, these ATPT entries and PCI memory addresses are associated with one or more queues of the device driver, referred to as the “device driver's queues,” for communicating with the PCIe adapter.
Essentially, the device driver services pin the host system memory for the one or more queues, assign DMA addresses to the one or more queues, program the ATPT entries and enable a bit stating that the ATPT entries are cacheable, i.e. cacheable in an address translation cache on the PCIe endpoint. The device driver services then return one or more untranslated PCIe memory addresses to the device driver for the ATPT entries that may be utilized, for example, as the addresses associated with the one or more queues (e.g., a starting address and, optionally, an ending queue address of a queue). An untranslated PCIe memory address is an address that is not in the system's real memory address space and must be translated before it can be used to access the system's real memory.
Using the mechanisms of the illustrative embodiments, the untranslated PCIe memory address(es) may be provided to the PCIe endpoint and used by the PCIe endpoint to perform a translation request operation with the root complex. That is, the PCIe endpoint may request that the root complex return a translated PCIe memory address or addresses corresponding to the untranslated PCIe memory address. The PCIe endpoint may then store the translated PCIe memory address or addresses in the context associated with the device driver's queue, e.g., in an address translation cache (ATC) of a virtual function in the PCIe endpoint.
Storing the translation of the untranslated PCIe memory address in the adapter's device driver queue context allows the PCIe endpoint to bypass the root complex's ATPT on DMAs that target device driver queue entries. Thus, when the root complex receives a PCIe DMA transaction marked as translated, the root complex verifies that translation caching is enabled for the endpoint and uses the translated PCIe memory address directly to access the host's real memory.
At some point in time later, such as after the PCIe endpoint is removed from the system, after the function (physical or virtual) associated with the device driver is removed from the system, or the like, the ATPT entries and ATC entries corresponding to the untranslated PCIe memory address may need to be invalidated. In order to perform such invalidation, the device driver or some higher level entity, such as a hypervisor management component, invokes the device driver services to unpin the host memory and release the DMA address, i.e. the untranslated PCIe memory address. The device services then clear the ATPT entries corresponding to the untranslated PCIe memory address and the root complex issues an ATC entry invalidation request to the PCIe endpoint.
The PCIe endpoint then performs operations to invalidate any ATC entries corresponding to the untranslated PCIe memory address and, after the untranslated PCIe memory addresses are no longer in use, returns an ATC invalidation completion response to the device services. The device driver services then return control to the device driver. An alternate implementation consists of having the driver services issue the ATC entry invalidation request to the PCIe endpoint and, after the PCIe endpoint completes the ATC entry invalidation, device driver services clear the ATPT entries and returns to the device driver.
The device driver 450 further has an associated response queue 422 through which the user application 430, system image 420, and the like, may communicate with a PCIe endpoint 490. The response queue 422 has response queue entries (RQEs) 424 for operations the PCIe endpoint 490 wants to be performed by the device driver 450, user application 430, system image 420, host system memory, and other host system resources. A doorbell storage device 426 is provided in association with the response queue 422 and system image 420 for informing the system image 420 when the response queue 422 has a response queue entry 424 that needs to be processed. Examples of work that may be performed by such a queue include completion processing associated with work system image 420 requested from the PCIe endpoint 490, asynchronous event processing associated with errors or events surfaced by the PCIe endpoint 490 to system image 420, and the like.
Similarly, the PCIe endpoint 490 may have an associated PCIe endpoint command queue 498 in which command queue entries (CQEs) 499 may be provided for informing the PCIe endpoint 490 of operations the system image 420, user applications 430, or the like, wants to be performed by the PCIe endpoint 490. The PCIe endpoint 490 command queue 498 may be implemented in the PCIe endpoint 490 itself or, more commonly, in a system image 420 memory location that is accessible by the PCIe endpoint 490, as depicted. A doorbell storage device 496 may be provided in the PCIe endpoint 490 for informing the PCIe endpoint 490 of when a CQE 499 is present in the PCIe endpoint command queue 498 for processing.
The PCIe endpoint 490 further has one or more physical functions (not shown) and virtual functions 492. The virtual functions 492 may further maintain an address translation cache (ATC) 494 for caching translated addresses for use in performing direct memory access (DMA) operations with host system memory, for example. The ATCs 494 may be stored in a device driver's queue context at the PCIe endpoint 490.
The PCIe endpoint 490 is coupled to the host system via a PCI fabric 485, which may be comprised of communication links, one or more PCI switches, and the like. The host system has a PCIe root complex 480 for communicating with the PCIe endpoint 490 via the PCI fabric 485. The root complex 480 maintains an address translation and protection table (ATPT) 482 which is used to translate untranslated PCIe memory addresses into translated addresses used in the system's real memory address space.
Management of the ATPT 482 and the ATC 494 is performed by device driver services 470 provided in an input/output (I/O) virtualization intermediary (VI) 460. The IOVI 460 may be, for example, a hypervisor or other virtualization management component, such as a trusted service partition. The device driver services 470 may be invoked by the device driver 450 when needed to initialize and invalidate entries in the ATPT 482 and the ATC 494.
The responsibilities for managing communications between the host system and the PCIe endpoint are split between the device driver 450 and the device driver services 470. Specifically, the device driver 450 is responsible for managing its response queue 422 and the PCIe endpoint's command queue 498. The device driver 450 is further responsible for invoking the device driver services 470 when needed to perform the necessary functions for initializing address translation entries in the ATPT 482 and for invalidating entries in the ATPT 482 and the ATC 494 when the translations are no longer to be used by the PCIe endpoint 490.
During initialization of the device driver 450, the device driver 450 may initialize a DMA address space for one or more queues, such as a device driver response queue 422, a PCIe endpoint's command queue 498 that resides in system image 420 for communicating with the PCIe endpoint 490, and the like. In turn, the device driver 450 for the PCIe endpoint 490 invokes device driver services 470 to initialize ATPT 482 entries for translating PCIe addresses into DMA address space addresses for accessing portions of system memory. Each ATPT entry is for one set of contiguous PCI bus addresses. The mechanism for initialization address translation and protection table entries is generally known in the art. For example, a mechanism for initializing such entries is described in commonly assigned U.S. Pat. No. 6,629,162. The device driver services 470 then return one or more PCI memory address to the device driver 450.
Essentially, in the depicted example, the device driver services 470 pin the host system memory for the response queue 422 and the PCIe endpoint's command queue 498, if it resides in system image 420. The device driver services 470 assign DMA addresses, which are untranslated PCIe memory addresses, to the device driver's response queue 422 and the PCIe endpoint's command queue 498, if it resides in system image 420. The device driver services 470 program the ATPT entries and enable a bit stating that the ATPT entries for the device driver's response queue 422 and the PCIe endpoint's command queue 498, if it resides in system image 420, are cacheable, i.e. cacheable in the ATC 494 on the PCIe endpoint 490. The device driver services 470 then return an untranslated PCIe memory address to the device driver 450 for the ATPT entries.
Using the mechanisms of the illustrative embodiments, the untranslated PCIe memory address(es) may then be provided to the PCIe endpoint 490 to inform the PCIe endpoint 490 of the location of queues 422 and 498. The untranslated PCIe memory address(es) may be used by the PCIe endpoint 490 to send a translation request operation to the root complex 480. That is, the PCIe endpoint 490 may request that the root complex 480 return translated PCIe memory address(es) associated with the untranslated PCIe memory address. The PCIe endpoint 490 may then store the translated PCIe memory address(es) in the context associated with the device driver's queues, e.g., ATC 494. As a result, the storing of the translation of the untranslated PCIe memory address in the PCIe endpoint's device driver queue context or ATC 494 allows the PCIe endpoint 490 to bypass the root complex's ATPT 482 on DMAs that target device driver queue entries, e.g., RQE 424 in response queue 422. That is, when the root complex 480 receives a PCIe DMA transaction marked as translated, it will verify that translation caching is enabled for the PCIe endpoint 490 and use the translated PCIe memory address directly to access the host system's real memory.
At some point in time later, such as after the PCIe endpoint 490 is removed from the system, after the function (physical or virtual) associated with the device driver 450 is removed from the host system, or the like, the ATPT entries and ATC entries corresponding to the untranslated PCIe memory address(es) may need to be invalidated. In order to perform such invalidation, the device driver 450, hypervisor management component, or the like, invokes the device driver services 470 to unpin the host memory and release the DMA address(es), i.e. the untranslated PCIe memory address(es). The device driver services 470 then clears the ATPT entries in the ATPT 482 corresponding to the untranslated PCIe memory address(es), e.g., by setting a bit in the ATPT 482 stating that the entry is no longer valid or by “zero'ing” the ATPT entry to indicate it is no longer valid.
The root complex 480 then issues an ATC entry invalidation request to the PCIe endpoint 490. The PCIe endpoint 490 then performs operations to invalidate any ATC entries in the ATC 494 corresponding to the untranslated PCIe memory address(es). Such invalidation may involve, for example, removing the cached translation from the queue contexts, e.g., ATC 494, of any virtual functions that were caching the translation. After the untranslated PCIe memory addresses are no longer in use, i.e. when all outstanding DMA operations that reference the untranslated PCIe memory address complete, the PCIe endpoint 490 returns an ATC invalidation completion response to the device driver services 470. The device driver services 470 then return control to the device driver 450. In an alternate implementation, the device driver services 470 may issue the ATC entry invalidation request to the PCIe endpoint 490 and, after the PCIe endpoint 490 completes the ATC entry invalidation, the device driver services 470 may clear the ATPT entries in the ATPT 482 and return to the device driver 450.
As shown in
For untranslated PCIe DMAs 510, since the untranslated PCIe address is not in the host system memory address space, it is necessary to first translate the untranslated PCIe address into a host system memory address. This translation is done by the root complex 530, using the ATPT. In addition, the root complex 530 further performs an access check based on the BDF number of the PCIe endpoint 505 and the entries in the ATPT. That is, the root complex 530 looks up an entry corresponding to the untranslated PCIe address in the ATPT 540, gets the translated host system memory addresses corresponding to the untranslated PCIe address, and the corresponding protection information for the translated host system memory address. The protection information may identify which BDF numbers may access the corresponding host system addresses, and the particular operations that they may perform on the portions of system memory corresponding to these host system memory addresses.
If the PCIe endpoint 505 is permitted to access the portion of system memory corresponding to the translated system memory address and is permitted to perform the requested DMA operation (e.g., read/write), then the DMA operation request is forwarded to the CPUs and memory 560 using the translated system memory address 570. If the PCIe endpoint 505 is not permitted to access the portion of system memory, an error message may be returned and the DMA operation request may not be forwarded on to the CPUs and memory 560.
The translated system memory address for the untranslated PCIe address may be returned to the PCIe endpoint 505. The PCIe endpoint 505 may then store the translation in the ATC of the virtual function that submitted the DMA operation request, as described above with regard to
For a translated PCIe DMA 520, since the PCIe address has already been translated into a system memory address by virtue of the ATC of the virtual function in the PCIe endpoint 505, the DMA operation may pass directly through the root complex 530 to the CPUs and memory 560. For example, the translated PCIe DMA 520 has a bit set in the DMA header (e.g., set by the PCIe endpoint 505) indicating that the address specified in the header of the DMA operation request is a translated address. The root complex 530 may read this bit and determine whether the bit indicates the address in the DMA operation request to be a translated or untranslated address.
If the root complex 530 determines the address to be an untranslated address, the operation outlined above with regard to the untranslated PCIe DMA operation request 510 is performed. If the root complex 530 determines that the address is a translated address, then the root complex 530 may pass the DMA operation request 520 through to the CPUs and memory 560. Optionally, an access check based on the BDF number of the PCIe endpoint 505 may still be performed to ensure that the PCIe endpoint is permitted to access the portion of system memory corresponding to the translated system memory address. This access check may be very simple, such as a general check to determine if the BDF number is allowed to cache address translations and if so, the check is successful. If the BDF number is not permitted to cache address translations, then the access check fails.
Accordingly, blocks of the flowchart illustrations support combinations of means for performing the specified functions, combinations of steps for performing the specified functions and program instruction means for performing the specified functions. It will also be understood that each block of the flowchart illustrations, and combinations of blocks in the flowchart illustrations, can be implemented by special purpose hardware-based computer systems which perform the specified functions or steps, or by combinations of special purpose hardware and computer instructions.
The device driver services assign DMA addresses to the PCIe endpoint (step 640). The device driver services program the ATPT entries for the DMA addresses and set the cache enable bit, if appropriate, in the ATPT entries (step 650). The device driver services then return the untranslated PCIe memory address(es) to the device driver (step 660) and the operation terminates.
The root complex issues an ATC entry invalidation request to PCIe endpoint (step 740). The PCIe endpoint invalidates the ATC entry corresponding to the DMA address that is to be invalidated (step 750). The device driver services wait for an ATC invalidation completion response to be received (step 760). Once the ATC invalidation completion response is received, the device driver services may unpin the host system memory (step 770) and return control to the device driver once the ATC invalidation is completed (step 780). The operation then terminates.
Thereafter, two paths of operation are followed. In a first path, a determination is made as to whether the source of the DMA operation is permitted to perform the translated DMA operation, i.e. a determination as to whether the access checks complete successfully (step 840). If not, an error is returned (step 860). If the source is permitted to perform the translated DMA operation, then the root complex performs the DMA (step 850). The operation then terminates.
If the translated bit is set (step 820), an optional BDF number access check may be performed (step 870). The operation continues to step 840 bypassing the address translation of step 830.
Thus, the illustrative embodiments provide a mechanism by which device driver services are invoked to initialize and invalidate address translations in an address translation data structure of a root complex of a host system. These device driver services may be provided in an I/O virtualization intermediary and may be invoked by a device driver provided in a logical partition in association with a system image. The device driver services may, through the root complex, create address translation data structure entries for translating virtual addresses, e.g., untranslated PCIe addresses, into system memory addresses. Moreover, the device driver services may, through the root complex, clear address translation entries from the address translation data structure and, through the PCIe endpoint, invalidate entries in any address translation caches of the PCIe endpoint.
As mentioned above, the mechanisms of the illustrative embodiments may be utilized to establish ATPT entries for use in communicating between the system image, applications running in the system image, etc., and the PCIe endpoint using one or more queue data structures. In such an implementation of the illustrative embodiments, the ATPT entries for the one or more queue data structures are initialized in the manner previously described above. During the PCIe endpoint's initialization phase, the PCIe endpoint verifies that the device driver has been initialized. This may be done, for example, by reading information from a PCI configuration space, a Vital Product Data (VPD) field, or a memory mapped input/output (MMIO) field of the PCIe endpoint.
The device driver may provide the start and ending addresses, the starting address and a length, or the like, of the one or more queues to the PCIe endpoint. For example, the device driver may write these addresses into a PCI configuration space field, VPD or MMIO field of the PCIe endpoint corresponding to a queue configuration space. These addresses are untranslated PCIe addresses. The PCIe endpoint may invoke a PCIe ATS request for translation of the queue addresses. As a result, the root complex may use the ATPT to perform address translation and return the result to the PCIe endpoint which may cache the translated addresses in a queue context for use in retrieving items from the one or more queues and to place items in the one or more queues. By pre-translating the queue addresses in this way, the latency involved in starting an I/O operation is reduced by moving the latency of the translation operation from the start of each operation to prior to any operation starting, thus improving the overall performance of DMA operations of the endpoint.
The queue data structures 920-930 may be small component system interface (SCSI) queues for communicating with SCSI I/O devices coupled to the PCIe endpoint 990, for example. These queue data structures may be configured in any manner including linked list queues, circular buffer queues, or the like.
As part of the operation performed by the device driver 910 in generating these queue data structures 920-930, the device driver 910 invokes the device driver services 940 to program the ATPT entries for the queue data structures 920-930 and return an untranslated PCIe address for the queues to the device driver 910. As previously described above, in the illustrative embodiments, the programming of the ATPT entries may involve pinning the host memory space 950 used for the queue data structures, programming the ATPT entries in the ATPT 960 of the root complex 970 with the translation information for translating from a untranslated PCIe address to a system memory address, and setting a cache enable bit in the ATPT entries indicating that the address translations corresponding to the ATPT entries are cacheable in an ATC 992 of the PCIe endpoint 990. After performing such operations, the untranslated PCIe addresses for the ATPT entries are returned to the device driver 910. These untranslated PCIe addresses may identify, for example, the start and end addresses of the queue data structures 920-930.
The untranslated PCIe addresses are provided by the device driver 910 to the PCIe endpoint 990, such as by writing the addresses to a queue configuration space 994 in the PCIe endpoint 990. The queue configuration space 994 may be, for example, a PCI configuration space, one or more VPD fields, one or more MMIO fields, or the like. In response to receiving these untranslated PCIe addresses for the queue data structures 920-930, the PCIe endpoint 990 may issue a PCIe ATS request for the queue addresses to the root complex 970. As a result, the root complex 970 may perform address translation and access checks for the untranslated PCIe addresses of the queue data structures 920-930 and return the translated addresses to the PCIe endpoint 990. The PCIe endpoint 990 may then store these address translations in a queue context provided by the address translation cache (ATC) 992 of the PCIe endpoint 990.
As a result of the above, since the PCIe endpoint now has access to the translations for the addresses associated with the queue data structures 920-930, the PCIe endpoint may now perform DMA operations to submit or retrieve queue entries to/from the queue data structures 920-930 without having to go through the root complex 970 ATPT address translation.
Once the queue data structures 920-930 are no longer to be utilized by the PCIe endpoint 990, the ATPT and ATC entries corresponding to the addresses for these queue data structures 920-930 may be invalidated in the manner previously described above. Such invalidation may be performed, for example, when the PCIe endpoint is to be removed from the system, after the function (physical or virtual) associated with the device driver is removed from the host system, or the like. As described previously, this process of invalidation may involve the device driver 910 invoking the device driver services 940 to unpin the host system memory 950 corresponding to the queue data structures 920-930, releasing the DMA addresses for these queue data structures 920-930, clearing the ATPT entries for these DMA addresses, and issuing an ATC entry invalidation request to the PCIe endpoint 990. When the ATC entry invalidation operation is completed by the PCIe endpoint 990, the device driver services 940 returns control to the device driver 910 and at this point the PCIe endpoint 990 may be removed from the system.
As shown in
The device driver services assign untranslated DMA addresses, i.e. untranslated PCIe memory addresses, to the queue data structure(s) (step 1040). The device driver services program the ATPT entries for the untranslated DMA addresses and set the cache enable bit, if appropriate, in the ATPT entries (step 1050). The device driver services then return the untranslated DMA addresses, i.e. the untranslated PCIe memory addresses for the queue data structures to the device driver (step 1060).
The device driver then provides the untranslated DMA addresses for the queue data structures to the PCIe endpoint (step 1070). The PCIe endpoint issues an ATS address translation request to the root complex (step 1080). The root complex uses the ATPT to perform address translation of the untranslated DMA addresses and returns the translated addresses to the PCIe endpoint (step 1090). The PCIe endpoint stores the translated addresses in a queue context for the queue data structures (step 1095) and the operation terminates. Thereafter, the PCIe endpoint may use the translated addresses in the queue context to DMA requests to and from the queue data structures.
Thus, the illustrative embodiments provide a mechanism by which one or more queues for communicating between a system image, applications running in the system image, or the like, and a PCIe endpoint, e.g., an I/O adapter, may be created. The mechanisms of the illustrative embodiments provide for the initialization and usage of ATPT entries in a root complex for translating addresses associated with the one or more queues from an untranslated address space, e.g., PCIe bus address space, to a translated address space, e.g., system bus address space. Moreover, the illustrative embodiments provide mechanisms for storing translations in the PCIe endpoint as part of an address translation cache so that requests using untranslated addresses matching these translations may be directly forwarded to the one or more queues without having to go through formal translation in the root complex.
As described above, the mechanisms of the illustrative embodiments may be utilized to establish queue data structures in a device driver and their corresponding ATPT entries in the root complex of a data processing system. Once such queue data structures are initialized through the mechanisms described above, communication between the application instances, system image, and the like, of a logical partition of the host system and a PCIe endpoint may be performed using these queue data structures and ATPT entries.
These queue data structures and corresponding ATPT entries may be utilized with PCIe endpoints of different types. For example, the PCIe endpoint may be a networking adapter, such as an Ethernet adapter, Fibre Channel adapter, InfiniBand™ adapter, or the like, for communicating with other devices over one or more data networks. With such networking adapters, data that is being transmitted or received is placed into a buffer in the host system's device driver and fetched by either the host system's system image or the network adapter, depending upon whether the data is being received or transmitted. By pre-translating the data buffer addresses, the latency involved in starting an I/O operation is reduced by moving the latency of the translation operation from the start of each operation to prior to any operation starting, thus improving the overall performance of DMA operations of the endpoint.
The processes for reception and transmission of data using the structures of the illustrative embodiments in association with a networking adapter will now be described with reference to
After initializing the queue data structure, the device driver creates a CQE 1122 which contains a pointer, i.e. address, to a buffer 1124 that the PCIe endpoint is to use to store data from incoming data packets. The address for the buffer is an untranslated PCIe address.
The device driver 1110 then writes a doorbell value to a doorbell storage device 1192, e.g., a register, in the PCIe endpoint 1190. The doorbell value indicates to the PCIe endpoint 1190 that a CQE 1122 is available. The PCIe endpoint 1190, in response to the setting of the doorbell value in the doorbell storage device 1192, fetches the CQE 1122, and thus the buffer address, from the command queue data structure 1120.
Having fetched the untranslated PCIe address for the buffer 1124, the PCIe endpoint 1190 issues a request to the root complex 1150 for address translation of the untranslated PCIe address for the buffer 1124. The root complex 1150 uses the ATPT 1160 to translate the untranslated PCIe address into a translated system memory address and returns the translated system memory address to the PCIe endpoint 1190. The PCIe endpoint 1190 stores the translated system memory address in a local copy of the CQE 1194 in the PCIe endpoint 1190.
It should be appreciated that the translation and storing of the translated address, i.e. the system memory or real memory address, in a local copy of the CQE 1194 may be performed prior to receiving data packets from an external network attached device (not shown) for the CQE 1194. Thus, by the time that the data packet(s) are sent by the external network attached device and received in the PCIe endpoint 1190, the translated PCIe address may be stored in the local copy of the CQE 1194.
Once a result data packet is received in the PCIe endpoint 1190, the PCIe endpoint 1190 issues a DMA operation request to place the data in the buffer 1124 using the locally stored cached translated address, i.e. the system memory address corresponding to the untranslated PCIe address of the buffer 1124 stored in the local copy of the CQE 1194. The DMA operation request is performed with a bit set in the header of the DMA operation request to indicate that the address utilized in the DMA operation request is a translated system memory address. As a result, the root complex 1150 passes the DMA operation request through without address translation using the ATPT 1160 such that the data is written directly into the buffer 1124.
Once all of the data that is to be written to the buffer 1124 has been DMA'd to the buffer 1124 in this manner, the PCIe endpoint 1190 may DMA a response queue entry (RQE) 1132 to a response queue data structure 1130 in a similar manner. Once the device driver 1110 receives and processes the RQE 1132, the device driver 1110 invokes the device driver services 1140 to unpin the host memory for the data buffer 1124. The device driver services 1140 releases the DMA address for the data buffer 1124 and clears the ATPT entries for the data buffer 1124. The root complex 1150 issues an ATC entry invalidation request to the PCIe endpoint 1190 for clearing the address information in the local copy of the CQE 1194. The PCIe endpoint 1190 returns an ATC entry invalidation completion response to the root complex 1150 which informs the device driver services 1140 of the completion. The device driver services 1140 then returns control to the device driver 1110 and the operation is complete until the need to create the next CQE. It is also possible to reuse a data buffer for multiple operations (e.g., multiple CQEs), in which case the device driver services 1140 would not be called (e.g., to invalidate the data buffer address and unpin the memory), until the data buffer is no longer needed for other operations.
The device driver creates a CQE 1222 which contains a pointer, i.e. address, to the buffer 1224 from which the PCIe endpoint 1290 is to transmit data via one or more of its ports. The address for the buffer 1224 is an untranslated PCIe address.
The device driver 1210 then writes a doorbell value to a doorbell storage device 1292, e.g., a register, in the PCIe endpoint 1290. The doorbell value indicates to the PCIe endpoint 1290 that a CQE 1222 is available. The PCIe endpoint 1290, in response to the setting of the doorbell value in the doorbell storage device 1292, fetches the CQE 1222, and thus the buffer address, from the command queue data structure 1220.
If the data buffers in the PCIe endpoint 1290 are full, e.g., downstream port is saturated, then the PCIe endpoint 1290 issues a ATS translation request to the root complex 1250. When the PCIe endpoint 1290 receives the translated address as a result of this ATS translation request, it stores the translated address in a local copy of the CQE 1294. After the PCIe endpoint 1290 DMA's the transmit data from the data buffer 1224 (e.g., when the port becomes available to transmit the data) and transmits the data, the PCIe endpoint 1290 then DMA's a RQE 1232 to the response queue 1230 to indicate that the transmit operation has completed and, if requested, may also generate an interrupt.
Once the device driver 1210 retrieves the RQE 1232, the device driver 1210 invokes the device driver services 1240 to unpin the host memory for the buffer 1224, releases the DMA addresses, and clears the ATPT entries for the untranslated addresses of the buffer 1224. The root complex 1250 then issues an ATC entry invalidation request to the PCIe endpoint 1290 and awaits a completion message from the PCIe endpoint 1290. Once the ATC entry invalidation operation is performed by the PCIe endpoint 1290, the device driver services 1240 return control to the device driver 1210. It is also possible to reuse a data buffer for multiple operations (e.g., multiple CQEs), in which case the device driver services 1140 would not be called (e.g., to invalidate the data buffer address and unpin the memory), until the data buffer is no longer needed for other operations.
The PCIe endpoint, in response to the setting of the doorbell value in the doorbell storage device, fetches the queue entry, and thus the untranslated PCIe buffer memory address, from the queue data structure (step 1325). Having fetched the untranslated PCIe memory address for the buffer, the PCIe endpoint issues a request to the root complex for address translation of the untranslated PCIe address for the buffer (step 1330). The root complex uses the ATPT to translate the untranslated PCIe address into a translated system memory address and returns the translated system memory address to the PCIe endpoint (step 1335). The PCIe endpoint stores the translated system memory address in a local copy of the queue entry in the PCIe endpoint (step 1340).
The PCIe endpoint determines if a data packet is received (step 1345). If not, the operation waits for a data packet to be received by returning to step 1345. If a data packet is received in the PCIe endpoint, the PCIe endpoint issues a DMA operation request, with a translation bit in the header of the DMA operation request set, to place the data in the buffer of the host system using the locally stored cached system memory address (step 1350). The root complex passes the DMA operation request through without address translation using the ATPT such that the data is written directly into the buffer (step 1355). A determination is made as to whether all of the data that is to be written to the buffer has been DMA'd to the buffer (step 1360). If not, the operation returns to step 1345.
Once all of the data that is to be written to the buffer has been DMA'd to the buffer, the PCIe endpoint DMA's a response queue entry to a response queue data structure (step 1365). In response to receiving the RQE, the device driver invokes the device driver services to unpin the host memory for the data buffer structures (step 1370). The device driver services release the DMA address, i.e. the untranslated PCIe memory address, for the queue data structure (step 1375) and clears the ATPT entries for the queue data structure (step 1380). The root complex issues an ATC entry invalidation request to the PCIe endpoint for clearing the address information in the local copy of the queue entry (step 1385). The PCIe endpoint then invalidates the address information in the local copy of the queue entry and returns an ATC entry invalidation completion response to the root complex which informs the device driver services of the completion (step 1390). The device driver services then unpins the host memory associated with the data buffers (step 1392). The device driver services then returns control to the device driver (step 1395) and the operation terminates.
The device driver creates a queue entry which contains a pointer, i.e. an untranslated PCIe memory address, to the buffer from which the PCIe endpoint is to transmit data via one or more of its ports (step 1425). The device driver then writes a doorbell value to a doorbell storage device in the PCIe endpoint (step 1430). The PCIe endpoint, in response to the setting of the doorbell value in the doorbell storage device, fetches the queue entry, and thus the untranslated PCIe memory address of the buffer, from the queue data structure (step 1435).
A determination is made as to whether data buffers in the PCIe endpoint are full (step 1440). If the data buffers are not full, the data is transferred via DMA and is placed in the data buffers of the PCIe endpoint for transmission (step 1460) and the PCIe endpoint transmits the data accordingly (step 1465).
If the data buffers are full, then the PCIe endpoint issues an ATS translation request to the root complex (step 1445). When the PCIe endpoint receives the translated address as a result of this ATS translation request (step 1450), the PCIe endpoint stores the translated address in a local copy of the queue entry (step 1455). The endpoint waits for available buffers (step 1457), the data is transferred via DMA and is placed in the data buffers of the PCIe endpoint for transmission (step 1460), and the PCIe endpoint then transmits the data accordingly (step 1465).
The PCIe endpoint then DMA's a response queue entry (RQE) to the response queue to indicate that the transmit operation has completed and, if requested, may also generate an interrupt (step 1470).
Once the device driver retrieves the RQE, the device driver invokes the device driver services to unpin the host memory for the buffer, release the DMA addresses, and clear the ATPT entries for the untranslated addresses of the buffer (step 1475). The root complex then issues an ATC entry invalidation request to the PCIe endpoint (step 1480) and awaits a completion message from the PCIe endpoint (step 1485). Once the ATC entry invalidation operation is performed by the PCIe endpoint, the device driver services unpins the host memory associated with the data buffer (step 1490) and then return control to the device driver (step 1495) and the operation terminates.
Thus, the illustrative embodiments provide a mechanism by which command queues and command queue entries may be generated for the reception and/or transmission of data via a network adapter PCIe endpoint into a buffer of the device driver in the host system. ATPT entries for the buffer may be established with the translations for the addresses corresponding to the buffer being cacheable in the PCIe endpoint for use in directly accessing the buffer without having to perform address translation in the root complex.
In addition to use with networking adapters, the mechanisms of the illustrative embodiments may further be used with other types of PCIe endpoints for communicating with locally available devices. For example, the PCIe endpoint may be a small component system interface (SCSI) adapter for communicating with storage devices directly attached to the PCIe endpoint. The mechanisms of the illustrative embodiments may be utilized to reduce the DMA read latency of SCSI adapters by providing a mechanism for caching address information for SCSI reads/writes in the SCSI adapter.
The device driver 1510 creates a command queue entry (CQE) 1522 in the command queue data structure 1520. The CQE 1522 contains the SCSI command and pointers, i.e. untranslated addresses, to the buffers, e.g., buffer 1524, associated with the command. The device driver 1510 then writes a doorbell value into a doorbell storage device 1592 which indicates to the PCIe endpoint 1590 that there are incoming requests.
In response to the doorbell value being set in the doorbell storage device 1592, the PCIe endpoint, which again may be a SCSI adapter, fetches the CQE 1522 from the command queue data structure 1520, and determines what type of command is being requested. This determination may be made, for example, based on a value provided in a header of the CQE 1522. If the CQE 1522 contains a SCSI command that is a read command for reading from disk, the PCIe endpoint 1590 issues a disk read operation followed by an ATS address translation request which requests that the root complex 1550 on the host system perform address translation on pointers, i.e. untranslated addresses, in the CQE 1522. When the PCIe endpoint 1590 receives the results of the address translation, the results are stored in a local copy of the CQE 1594 in the PCIe endpoint 1590. Thus, address translation of the pointers in the CQE 1522 may be performed at substantially the same time as the read operation is being performed. No translation is needed as part of the read operation since the untranslated addresses are used to access the SCSI device coupled to the PCIe endpoint 1590.
Once the SCSI device returns the data to the PCIe endpoint 1590, the PCIe endpoint 1590 issues a DMA operation to return the data to the host system using the locally stored cached translated address in the CQE 1594, i.e. the system bus address for the buffer 1524. The DMA is performed with the header bit set indicating that the address being utilized in the DMA is a translated address. As a result, no translation is performed by the root complex 1550 using the ATPT 1560 and the DMA is passed through to the buffer 1524.
The PCIe endpoint 1590 also DMA's a response queue entry (RQE) 1532 to the response queue data structure 1530 to indicate that the read from disk operation has been completed. If requested, the PCIe endpoint 1590 may also generate an interrupt.
Once the device driver 1510 retrieves the RQE 1532 of the read from disk operation, the device driver 1510 invokes the device driver services 1540 to unpin the host memory for the data buffer 1524. The device driver services 1540 further release the DMA addresses for the data buffer 1524 and clears the ATPT entries for the data buffer 1524. The root complex 1550 issues an ATC entry invalidation request to the PCIe endpoint 1590 thereby causing the PCIe endpoint 1590 to invalidate ATC entries, i.e. local copy of CQE 1594, corresponding to the cleared ATPT entries. When the ATC invalidation operation is complete, the device driver services 1540 return control to the device driver 1510.
The device driver creates a command queue entry (CQE) in the command queue data structure (step 1612), the CQE containing the SCSI command and pointers to the buffers associated with the command. The device driver then writes a doorbell value into a doorbell storage device (step 1614). In response to the doorbell value being set in the doorbell storage device, the PCIe endpoint fetches the CQE from the command queue data structure (step 1616), and determines whether the command in the CQE is a read command (step 1620).
If the CQE contains a SCSI command that is a read command for reading from disk, the PCIe endpoint issues a disk read operation followed by an ATS address translation request which requests that the root complex 1550 on the host system perform address translation on pointers in the CQE (step 1622). When the PCIe endpoint receives the results of the address translation, the results are stored in a local copy of the CQE in the PCIe endpoint (step 1624).
Once the SCSI device returns the data to the PCIe endpoint, the PCIe endpoint issues a DMA operation to return the data to the host system using the locally stored cached translated address in the CQE (step 1626). The DMA is performed with the header bit set indicating that the address being utilized in the DMA is a translated address (step 1628). As a result, no translation is performed by the root complex using the ATPT and the DMA is passed through to the buffer.
The PCIe endpoint also DMA's a response queue entry (RQE) to the response queue data structure to indicate that the read from disk operation has been completed (step 1630). If requested, the PCIe endpoint may also generate an interrupt.
Once the device driver retrieves the RQE of the read from disk operation, the device driver invokes the device driver services to unpin memory, release DMA addresses, and clear ATPT entries for the data buffer (step 1632). The device driver services further release the DMA addresses for the command queue and clear the ATPT entries for the command queue (step 1634). The root complex issues an ATC entry invalidation request to the PCIe endpoint thereby causing the PCIe endpoint to invalidate ATC entries corresponding to the cleared ATPT entries (step 1636). When the ATC invalidation operation is complete, device driver services unpins host memory for the buffer (step 1638) and the device driver services return control to the device driver (step 1640).
Returning to step 1620, as shown in
When the endpoint receives the translated address(es) from the root complex, the endpoint stores these translated address(es) in a local copy of the CQE (step 1652). The endpoint then sets a DMA header to indicate that translated addresses are being utilized in the DMA request and performs the DMA operation to get data to be written from the data buffer in system memory using the locally cached translated address(es) in the local copy of the CQE (step 1654). The endpoint then waits for the SCSI device to indicate that the previous disk seek operation is complete (step 1656). In response to a message from the SCSI device indicating that the disk seek operation is complete, the endpoint transfers the previously DMA'd data to the SCSI device (step 1658). The operation then returns to step 1630 described above.
Thus, the illustrative embodiments provide mechanisms for communication with different types of PCIe endpoints, including network adapters, SCSI adapters, InfiniBand™ adapters, and the like, in such a manner as to distribute the responsibilities of this communication across a device driver and device driver services. The illustrative embodiments facilitate the use of caching of translated addresses in these various types of PCIe endpoints in different ways depending upon the type of PCIe endpoint utilized. The caching of these translated addresses permits the PCIe endpoint to directly access queues, buffers, and system memory of the host system without having to go through an address translation operation in the root complex of the host system.
It should be appreciated that the illustrative embodiments may take the form of an entirely hardware embodiment, an entirely software embodiment or an embodiment containing both hardware and software elements. In one exemplary embodiment, the mechanisms of the illustrative embodiments are implemented in software, which includes but is not limited to firmware, resident software, microcode, etc.
Furthermore, the illustrative embodiments may take the form of a computer program product accessible from a computer-usable or computer-readable medium providing program code for use by or in connection with a computer or any instruction execution system. For the purposes of this description, a computer-usable or computer-readable medium can be any apparatus that can contain, store, communicate, propagate, or transport the program for use by or in connection with the instruction execution system, apparatus, or device.
The medium may be an electronic, magnetic, optical, electromagnetic, infrared, or semiconductor system (or apparatus or device) or a propagation medium. Examples of a computer-readable medium include a semiconductor or solid state memory, magnetic tape, a removable computer diskette, a random access memory (RAM), a read-only memory (ROM), a rigid magnetic disk and an optical disk. Current examples of optical disks include compact disk-read only memory (CD-ROM), compact disk-read/write (CD-R/W) and DVD.
A data processing system suitable for storing and/or executing program code will include at least one processor coupled directly or indirectly to memory elements through a system bus. The memory elements can include local memory employed during actual execution of the program code, bulk storage, and cache memories which provide temporary storage of at least some program code in order to reduce the number of times code must be retrieved from bulk storage during execution.
Input/output or I/O devices (including but not limited to keyboards, displays, pointing devices, etc.) can be coupled to the system either directly or through intervening I/O controllers. Network adapters may also be coupled to the system to enable the data processing system to become coupled to other data processing systems or remote printers or storage devices through intervening private or public networks. Modems, cable modem and Ethernet cards are just a few of the currently available types of network adapters.
The description of the present invention has been presented for purposes of illustration and description, and is not intended to be exhaustive or limited to the invention in the form disclosed. Many modifications and variations will be apparent to those of ordinary skill in the art. The embodiment was chosen and described in order to best explain the principles of the invention, the practical application, and to enable others of ordinary skill in the art to understand the invention for various embodiments with various modifications as are suited to the particular use contemplated.