From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mail-wm0-x22b.google.com (mail-wm0-x22b.google.com [IPv6:2a00:1450:400c:c09::22b]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by ml01.01.org (Postfix) with ESMTPS id 1790C81E4E for ; Wed, 16 Nov 2016 08:59:37 -0800 (PST) Received: by mail-wm0-x22b.google.com with SMTP id t79so85568872wmt.0 for ; Wed, 16 Nov 2016 08:59:42 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linaro.org; s=google; h=from:to:cc:subject:date:message-id; bh=zYKyIg7IC/T1W50rdW4uciJQIzOOb3aS/UxV6GcmUVU=; b=gAgKb3gUjKSDe9eCDd5TAg2tmsMWi8Q7uuivYRPZtG+heHWTYcFRdVOgadmOq9Ahjf HJvmz6bFb0ZBLcLjfLrjwQvWwKOCRkqYTCu4rtb1WQ1UJ7wlRuLIPS3sroHKrGYXNkP3 OzOWRcG8jiTBSU+E79kWtP9g/qSPLqUsMASiE= X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20130820; h=x-gm-message-state:from:to:cc:subject:date:message-id; bh=zYKyIg7IC/T1W50rdW4uciJQIzOOb3aS/UxV6GcmUVU=; b=X+SHpGT/8cIRxMwcq5h2eTt2+PmJlYhbm51tLQ1tF28RKhagmMbKfqiHjHP+Bgh4Bu wZQ775VBEm1bQ7EF5hb9z3zQy5Ck/qXj44lwWBKOpJrPHAOwZP5kdA6B3hNFATB1ko7u JkIe8fYZYDNfhkN1Jo0KOY23oJdnN4vAvfTUknCItIg85TEf7kt445AE2RQT2wgqBwTk WSApRrr2UMN1rnoLkOl9ngQ8Rh+BpuyWkQLHpHqDl0W/vVrxEx8h+GN5cL13luQJ3gAM ohO1Lkqga3gGEDo9dgwjCVp1oVBmB6sxCwjPPhp0ztrZBb0J0w48/NHHTAYt85xoTsPD p+Lw== X-Gm-Message-State: ABUngvcmeA6kc4VZN2U5uurBvTpKQngj49M0VhDfqICi+tO8N40CMmYj7z3yFBbRH45pC3Xk X-Received: by 10.28.7.130 with SMTP id 124mr10327272wmh.18.1479315579027; Wed, 16 Nov 2016 08:59:39 -0800 (PST) Received: from localhost.localdomain ([105.137.104.147]) by smtp.gmail.com with ESMTPSA id gk6sm41485516wjc.21.2016.11.16.08.59.37 (version=TLS1_2 cipher=ECDHE-RSA-AES128-SHA bits=128/128); Wed, 16 Nov 2016 08:59:38 -0800 (PST) From: Ard Biesheuvel To: edk2-devel@lists.01.org, liming.gao@intel.com, ruiyu.ni@intel.com, michael.d.kinney@intel.com Cc: afish@apple.com, mw@semihalf.com, leif.lindholm@linaro.org, Ard Biesheuvel Date: Wed, 16 Nov 2016 16:59:26 +0000 Message-Id: <1479315571-14953-1-git-send-email-ard.biesheuvel@linaro.org> X-Mailer: git-send-email 2.7.4 Subject: [PATCH v3 0/5] MdeModulePkg: add support for non-discoverable devices X-BeenThere: edk2-devel@lists.01.org X-Mailman-Version: 2.1.21 Precedence: list List-Id: EDK II Development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 16 Nov 2016 16:59:37 -0000 The rationale for this series is the fact that many ARM platforms implement some form of PCI 'emulation', to allow non-discoverable devices that implement standardized host controller interfaces (i.e., EHCI, AHCI) to be controlled by the generic EDK2 drivers, which are layered on top of the PCI I/O protocols (even though the respective host controller specifications don't mandate that) There are a couple of problems with that approach: - Most implementations are based on the original code created for BeagleBoard, which is a 32-bit platform. Unlike x86, which usually does not perform PCI DMA above 4 GB, the ARM ecosystem is much more heterogeneous, and platforms that have memory both above and below the 4 GB mark may ship with, e.g., EHCI controllers that do not implement 64-bit DMA addressing. - Implementations depend on the DmaLib library class in EmbeddedPkg, of which coherent and non-coherent implementations exists. However, both types of devices may appear on a single platform, requiring several instances of the same driver. - Existing implementations do not follow the UEFI driver model, but instantiate a fixed number of PCI I/O protocol handles, and bring up all the devices when doing so. However, the UEFI philosophy is to only instantiate (and thus initialize) devices that are involved in booting. So instead, let's define a base protocol that simply asserts the presence of a certain kind of device at a certain memory offset, allowing platforms to instantiate any number of these statically, and leave it to post-DXE driver dispatch to actually bind the drivers as usual. This is implemented in patch #1. Note that it includes an AMBA device type, which we intend to use in the future to move ARM AMBA drivers to the UEFI driver model as well (i.e., LCD controller, SD/MMC controller) Patch #2 implements a utility library to register non-discoverable devices. Patch #3 implements the UEFI driver that instantiates PCI I/O protocol handles for non-discoverable devices that we know can be driven by a generic driver in EDK2. The initial version implements coherent DMA only. Patch #4 implements non-coherent DMA for the driver added in patch #3. Patch #5 is included for reference. It ports the BeagleBoard platform to the new driver stack. Changes in v3: - Modified the base protocol to describe any number of resources using ACPI resource descriptors. The current crop of targeted peripherals does not require that, but it allows for much more flexibility in the future. This also means that the MMIO region sizes are no longer hard-coded base on the controller type (EHCI, AHCI, etc) but need to be declared when the devices are registered. - Update the registration library API to allow multiple MMIO regions to be declared. - When performing uncached allocations, record the original memory region attributes so we can restore them correctly on free. - Some fixes in the 4GB boundary checks for Map/Unmap - Rename gNonDiscoverableDeviceProtocolGuid to gEdkiiNonDiscoverableDeviceProtocolGuid Ard Biesheuvel (5): MdeModulePkg: introduce non-discoverable device protocol MdeModule: introduce helper library to register non-discoverable devices MdeModulePkg: implement generic PCI I/O driver for non-discoverable devices MdeModulePkg/NonDiscoverablePciDeviceDxe: add support for non-coherent DMA Omap35xxPkg/PciEmulation: port to new non-discoverable device infrastructure BeagleBoardPkg/BeagleBoardPkg.dsc | 2 + BeagleBoardPkg/BeagleBoardPkg.fdf | 1 + MdeModulePkg/Bus/Pci/NonDiscoverablePciDeviceDxe/ComponentName.c | 75 ++ MdeModulePkg/Bus/Pci/NonDiscoverablePciDeviceDxe/NonDiscoverablePciDeviceDxe.c | 226 ++++ MdeModulePkg/Bus/Pci/NonDiscoverablePciDeviceDxe/NonDiscoverablePciDeviceDxe.inf | 44 + MdeModulePkg/Bus/Pci/NonDiscoverablePciDeviceDxe/NonDiscoverablePciDeviceIo.c | 1187 ++++++++++++++++++++ MdeModulePkg/Bus/Pci/NonDiscoverablePciDeviceDxe/NonDiscoverablePciDeviceIo.h | 113 ++ MdeModulePkg/Include/Library/NonDiscoverableDeviceRegistrationLib.h | 49 + MdeModulePkg/Include/Protocol/NonDiscoverableDevice.h | 90 ++ MdeModulePkg/Library/NonDiscoverableDeviceRegistrationLib/NonDiscoverableDeviceRegistrationLib.c | 161 +++ MdeModulePkg/Library/NonDiscoverableDeviceRegistrationLib/NonDiscoverableDeviceRegistrationLib.inf | 34 + MdeModulePkg/MdeModulePkg.dec | 7 + MdeModulePkg/MdeModulePkg.dsc | 3 + Omap35xxPkg/Omap35xxPkg.dsc | 2 +- Omap35xxPkg/PciEmulation/PciEmulation.c | 578 +--------- Omap35xxPkg/PciEmulation/PciEmulation.h | 292 ----- Omap35xxPkg/PciEmulation/PciEmulation.inf | 16 +- Omap35xxPkg/PciEmulation/PciRootBridgeIo.c | 306 ----- 18 files changed, 2025 insertions(+), 1161 deletions(-) create mode 100644 MdeModulePkg/Bus/Pci/NonDiscoverablePciDeviceDxe/ComponentName.c create mode 100644 MdeModulePkg/Bus/Pci/NonDiscoverablePciDeviceDxe/NonDiscoverablePciDeviceDxe.c create mode 100644 MdeModulePkg/Bus/Pci/NonDiscoverablePciDeviceDxe/NonDiscoverablePciDeviceDxe.inf create mode 100644 MdeModulePkg/Bus/Pci/NonDiscoverablePciDeviceDxe/NonDiscoverablePciDeviceIo.c create mode 100644 MdeModulePkg/Bus/Pci/NonDiscoverablePciDeviceDxe/NonDiscoverablePciDeviceIo.h create mode 100644 MdeModulePkg/Include/Library/NonDiscoverableDeviceRegistrationLib.h create mode 100644 MdeModulePkg/Include/Protocol/NonDiscoverableDevice.h create mode 100644 MdeModulePkg/Library/NonDiscoverableDeviceRegistrationLib/NonDiscoverableDeviceRegistrationLib.c create mode 100644 MdeModulePkg/Library/NonDiscoverableDeviceRegistrationLib/NonDiscoverableDeviceRegistrationLib.inf delete mode 100644 Omap35xxPkg/PciEmulation/PciEmulation.h delete mode 100644 Omap35xxPkg/PciEmulation/PciRootBridgeIo.c -- 2.7.4