public inbox for devel@edk2.groups.io
 help / color / mirror / Atom feed
* [PATCH v5 edk2-platforms 00/22] Platform/RaspberryPi: Add Raspberry Pi 3 support
@ 2019-02-05 16:25 Pete Batard
  2019-02-05 16:25 ` [PATCH v5 edk2-platforms 01/22] Silicon/Broadcom/Bcm283x: Add interrupt driver Pete Batard
                   ` (23 more replies)
  0 siblings, 24 replies; 34+ messages in thread
From: Pete Batard @ 2019-02-05 16:25 UTC (permalink / raw)
  To: edk2-devel

Changes for v5:

* Raspberry/Pi3 -> RaspberryPi/RPi3
* Remove VirtualRealTimeClockLib as well as BUILD_EPOCH macro (use the upcoming
  EmbeddedPkg Virtual RTC from EDK2 instead)
* Use $(PLATFORM_NAME) where possible in .dsc and .fdf
* Update Readme to remove build instructions, describe ACPI limitations, fix
  ATF Readme link and split OS installation & test notes into a separate file.
* Add -Wl,--fix-cortex-a53-843419 to LINK_FLAGS

IMPORTANT: Due to the removal of VirtualRealTimeClockLib this series requires
https://lists.01.org/pipermail/edk2-devel/2019-February/036301.html to have
been applied to your edk2 repository.

Regards,

/Pete


Pete Batard (22):
  Silicon/Broadcom/Bcm283x: Add interrupt driver
  Silicon/Broadcom/Bcm283x: Add GpioLib
  Platform/RaspberryPi/RPi3: Add ACPI tables
  Platform/RaspberryPi/RPi3: Add reset and memory init libraries
  Platform/RaspberryPi/RPi3: Add platform library
  Platform/RaspberryPi/RPi3: Add firmware driver
  Platform/RaspberryPi/RPi3: Add platform config driver
  Platform/RaspberryPi/RPi3: Add SMBIOS driver
  Platform/RaspberryPi/RPi3: Add display driver
  Platform/RaspberryPi/RPi3: Add console driver
  Platform/RaspberryPi/RPi3: Add NV storage driver
  Platform/RaspberryPi/RPi3: Add Device Tree driver
  Platform/RaspberryPi/RPi3: Add base MMC driver
  Platform/RaspberryPi/RPi3: Add Arasan MMC driver
  Platform/RaspberryPi/RPi3: Add SD Host driver
  Platform/RaspberryPi/RPi3: Add platform boot manager and helper libs
  Platform/RaspberryPi/RPi3: Add USB host driver
  Platform/RaspberryPi/RPi3 *NON-OSI*: Add ATF binaries
  Platform/RaspberryPi/RPi3 *NON-OSI*: Add Device Tree binaries
  Platform/RaspberryPi/RPi3 *NON-OSI*: Add logo driver
  Platform/RaspberryPi/RPi3: Add platform
  Platform/RaspberryPi/RPi3: Add platform readme's

 .../RaspberryPi/RPi3/AcpiTables/AcpiTables.h  |   82 +
 .../RPi3/AcpiTables/AcpiTables.inf            |   46 +
 .../RaspberryPi/RPi3/AcpiTables/Csrt.aslc     |  332 +++
 .../RaspberryPi/RPi3/AcpiTables/Dbg2.aslc     |   34 +
 Platform/RaspberryPi/RPi3/AcpiTables/Dsdt.asl |  511 +++++
 .../RaspberryPi/RPi3/AcpiTables/Fadt.aslc     |   52 +
 .../RaspberryPi/RPi3/AcpiTables/Gtdt.aslc     |   33 +
 .../RaspberryPi/RPi3/AcpiTables/Madt.aslc     |   62 +
 Platform/RaspberryPi/RPi3/AcpiTables/Pep.asl  |   95 +
 Platform/RaspberryPi/RPi3/AcpiTables/Pep.c    |   84 +
 Platform/RaspberryPi/RPi3/AcpiTables/Pep.h    |  126 ++
 Platform/RaspberryPi/RPi3/AcpiTables/Rhpx.asl |  201 ++
 Platform/RaspberryPi/RPi3/AcpiTables/Sdhc.asl |  105 +
 Platform/RaspberryPi/RPi3/AcpiTables/Spcr.asl |   53 +
 Platform/RaspberryPi/RPi3/AcpiTables/Uart.asl |  158 ++
 .../RaspberryPi/RPi3/DeviceTree/License.txt   |  340 +++
 .../RPi3/DeviceTree/bcm2710-rpi-3-b-plus.dtb  |  Bin 0 -> 25617 bytes
 .../RPi3/DeviceTree/bcm2710-rpi-3-b-plus.dts  | 1263 ++++++++++++
 .../RPi3/DeviceTree/bcm2710-rpi-3-b.dtb       |  Bin 0 -> 25354 bytes
 .../RPi3/DeviceTree/bcm2710-rpi-3-b.dts       | 1259 +++++++++++
 .../ArasanMmcHostDxe/ArasanMmcHostDxe.c       |  723 +++++++
 .../ArasanMmcHostDxe/ArasanMmcHostDxe.h       |   50 +
 .../ArasanMmcHostDxe/ArasanMmcHostDxe.inf     |   52 +
 .../RPi3/Drivers/ConfigDxe/ConfigDxe.c        |  351 ++++
 .../RPi3/Drivers/ConfigDxe/ConfigDxe.inf      |   78 +
 .../Drivers/ConfigDxe/ConfigDxeFormSetGuid.h  |   23 +
 .../RPi3/Drivers/ConfigDxe/ConfigDxeHii.uni   |  100 +
 .../RPi3/Drivers/ConfigDxe/ConfigDxeHii.vfr   |  306 +++
 .../RPi3/Drivers/DisplayDxe/ComponentName.c   |  222 ++
 .../RPi3/Drivers/DisplayDxe/DisplayDxe.c      |  606 ++++++
 .../RPi3/Drivers/DisplayDxe/DisplayDxe.h      |   42 +
 .../RPi3/Drivers/DisplayDxe/DisplayDxe.inf    |   71 +
 .../RPi3/Drivers/DisplayDxe/Screenshot.c      |  375 ++++
 .../RPi3/Drivers/DwUsbHostDxe/ComponentName.c |  225 ++
 .../RPi3/Drivers/DwUsbHostDxe/DriverBinding.c |  274 +++
 .../RPi3/Drivers/DwUsbHostDxe/DwUsbHostDxe.c  | 1635 +++++++++++++++
 .../RPi3/Drivers/DwUsbHostDxe/DwUsbHostDxe.h  |  162 ++
 .../Drivers/DwUsbHostDxe/DwUsbHostDxe.inf     |   59 +
 .../RPi3/Drivers/DwUsbHostDxe/DwcHw.h         |  788 +++++++
 .../RaspberryPi/RPi3/Drivers/FdtDxe/FdtDxe.c  |  364 ++++
 .../RPi3/Drivers/FdtDxe/FdtDxe.inf            |   53 +
 .../GraphicsConsoleDxe/ComponentName.c        |  183 ++
 .../GraphicsConsoleDxe/GraphicsConsole.c      | 1837 +++++++++++++++++
 .../GraphicsConsoleDxe/GraphicsConsole.h      |  591 ++++++
 .../GraphicsConsoleDxe/GraphicsConsoleDxe.inf |   75 +
 .../GraphicsConsoleDxe/GraphicsConsoleDxe.uni |   18 +
 .../GraphicsConsoleDxeExtra.uni               |   18 +
 .../RPi3/Drivers/GraphicsConsoleDxe/NewFont.c |  287 +++
 .../RPi3/Drivers/LogoDxe/License.txt          |   10 +
 .../RaspberryPi/RPi3/Drivers/LogoDxe/Logo.bmp |  Bin 0 -> 185398 bytes
 .../RaspberryPi/RPi3/Drivers/LogoDxe/Logo.c   |  159 ++
 .../RaspberryPi/RPi3/Drivers/LogoDxe/Logo.eps |  Bin 0 -> 250982 bytes
 .../RaspberryPi/RPi3/Drivers/LogoDxe/Logo.idf |   18 +
 .../RaspberryPi/RPi3/Drivers/LogoDxe/Logo.inf |   34 +
 .../RaspberryPi/RPi3/Drivers/LogoDxe/Logo.uni |   20 +
 .../RPi3/Drivers/LogoDxe/LogoDxe.inf          |   63 +
 .../RPi3/Drivers/LogoDxe/LogoDxe.uni          |   19 +
 .../RPi3/Drivers/LogoDxe/LogoDxeExtra.uni     |   19 +
 .../RPi3/Drivers/LogoDxe/LogoExtra.uni        |   19 +
 .../RPi3/Drivers/MmcDxe/ComponentName.c       |  163 ++
 .../RPi3/Drivers/MmcDxe/Diagnostics.c         |  263 +++
 .../RaspberryPi/RPi3/Drivers/MmcDxe/Mmc.c     |  460 +++++
 .../RaspberryPi/RPi3/Drivers/MmcDxe/Mmc.h     |  533 +++++
 .../RPi3/Drivers/MmcDxe/MmcBlockIo.c          |  469 +++++
 .../RPi3/Drivers/MmcDxe/MmcDebug.c            |  170 ++
 .../RPi3/Drivers/MmcDxe/MmcDxe.inf            |   58 +
 .../RPi3/Drivers/MmcDxe/MmcIdentification.c   |  980 +++++++++
 .../PlatformSmbiosDxe/PlatformSmbiosDxe.c     |  903 ++++++++
 .../PlatformSmbiosDxe/PlatformSmbiosDxe.inf   |   56 +
 .../Drivers/RpiFirmwareDxe/RpiFirmwareDxe.c   | 1084 ++++++++++
 .../Drivers/RpiFirmwareDxe/RpiFirmwareDxe.inf |   50 +
 .../RPi3/Drivers/SdHostDxe/SdHostDxe.c        |  787 +++++++
 .../RPi3/Drivers/SdHostDxe/SdHostDxe.inf      |   55 +
 .../RPi3/Drivers/VarBlockServiceDxe/FileIo.c  |  196 ++
 .../RPi3/Drivers/VarBlockServiceDxe/FvbInfo.c |  115 ++
 .../VarBlockServiceDxe/VarBlockService.c      |  971 +++++++++
 .../VarBlockServiceDxe/VarBlockService.h      |  217 ++
 .../VarBlockServiceDxe/VarBlockServiceDxe.c   |  331 +++
 .../VarBlockServiceDxe/VarBlockServiceDxe.inf |   93 +
 .../RPi3/Include/IndustryStandard/RpiMbox.h   |  108 +
 .../RaspberryPi/RPi3/Include/Protocol/DwUsb.h |   53 +
 .../RPi3/Include/Protocol/ExtendedTextOut.h   |   36 +
 .../RPi3/Include/Protocol/RpiFirmware.h       |  131 ++
 .../RPi3/Include/Protocol/RpiMmcHost.h        |  206 ++
 .../MemoryInitPeiLib/MemoryInitPeiLib.c       |  162 ++
 .../MemoryInitPeiLib/MemoryInitPeiLib.inf     |   51 +
 .../PlatformBootManagerLib/PlatformBm.c       |  793 +++++++
 .../PlatformBootManagerLib/PlatformBm.h       |   60 +
 .../PlatformBootManagerLib.inf                |   90 +
 .../PlatformLib/AArch64/RaspberryPiHelper.S   |  107 +
 .../RPi3/Library/PlatformLib/PlatformLib.inf  |   65 +
 .../RPi3/Library/PlatformLib/RaspberryPi.c    |   99 +
 .../RPi3/Library/PlatformLib/RaspberryPiMem.c |  160 ++
 .../PlatformUiAppLib/PlatformUiAppLib.c       |  120 ++
 .../PlatformUiAppLib/PlatformUiAppLib.inf     |   34 +
 .../RPi3/Library/ResetLib/ResetLib.c          |  104 +
 .../RPi3/Library/ResetLib/ResetLib.inf        |   46 +
 Platform/RaspberryPi/RPi3/RPi3.dec            |   58 +
 Platform/RaspberryPi/RPi3/RPi3.dsc            |  629 ++++++
 Platform/RaspberryPi/RPi3/RPi3.fdf            |  449 ++++
 Platform/RaspberryPi/RPi3/Readme.md           |  167 ++
 Platform/RaspberryPi/RPi3/Systems.md          |   65 +
 .../RPi3/TrustedFirmware/License.txt          |   26 +
 .../RPi3/TrustedFirmware/Readme.md            |   42 +
 .../RaspberryPi/RPi3/TrustedFirmware/bl1.bin  |  Bin 0 -> 18801 bytes
 .../RaspberryPi/RPi3/TrustedFirmware/fip.bin  |  Bin 0 -> 41714 bytes
 Readme.md                                     |    3 +
 Silicon/Broadcom/Bcm283x/Bcm283x.dec          |   23 +
 .../Drivers/InterruptDxe/InterruptDxe.c       |  367 ++++
 .../Drivers/InterruptDxe/InterruptDxe.inf     |   48 +
 .../Include/IndustryStandard/Bcm2836.h        |   72 +
 .../Include/IndustryStandard/Bcm2836Gpio.h    |   49 +
 .../Include/IndustryStandard/Bcm2836SdHost.h  |   92 +
 .../Include/IndustryStandard/Bcm2836Sdio.h    |  199 ++
 .../Bcm283x/Include/Library/GpioLib.h         |   33 +
 .../Bcm283x/Library/GpioLib/GpioLib.c         |   89 +
 .../Bcm283x/Library/GpioLib/GpioLib.inf       |   39 +
 117 files changed, 27594 insertions(+)
 create mode 100644 Platform/RaspberryPi/RPi3/AcpiTables/AcpiTables.h
 create mode 100644 Platform/RaspberryPi/RPi3/AcpiTables/AcpiTables.inf
 create mode 100644 Platform/RaspberryPi/RPi3/AcpiTables/Csrt.aslc
 create mode 100644 Platform/RaspberryPi/RPi3/AcpiTables/Dbg2.aslc
 create mode 100644 Platform/RaspberryPi/RPi3/AcpiTables/Dsdt.asl
 create mode 100644 Platform/RaspberryPi/RPi3/AcpiTables/Fadt.aslc
 create mode 100644 Platform/RaspberryPi/RPi3/AcpiTables/Gtdt.aslc
 create mode 100644 Platform/RaspberryPi/RPi3/AcpiTables/Madt.aslc
 create mode 100644 Platform/RaspberryPi/RPi3/AcpiTables/Pep.asl
 create mode 100644 Platform/RaspberryPi/RPi3/AcpiTables/Pep.c
 create mode 100644 Platform/RaspberryPi/RPi3/AcpiTables/Pep.h
 create mode 100644 Platform/RaspberryPi/RPi3/AcpiTables/Rhpx.asl
 create mode 100644 Platform/RaspberryPi/RPi3/AcpiTables/Sdhc.asl
 create mode 100644 Platform/RaspberryPi/RPi3/AcpiTables/Spcr.asl
 create mode 100644 Platform/RaspberryPi/RPi3/AcpiTables/Uart.asl
 create mode 100644 Platform/RaspberryPi/RPi3/DeviceTree/License.txt
 create mode 100644 Platform/RaspberryPi/RPi3/DeviceTree/bcm2710-rpi-3-b-plus.dtb
 create mode 100644 Platform/RaspberryPi/RPi3/DeviceTree/bcm2710-rpi-3-b-plus.dts
 create mode 100644 Platform/RaspberryPi/RPi3/DeviceTree/bcm2710-rpi-3-b.dtb
 create mode 100644 Platform/RaspberryPi/RPi3/DeviceTree/bcm2710-rpi-3-b.dts
 create mode 100644 Platform/RaspberryPi/RPi3/Drivers/ArasanMmcHostDxe/ArasanMmcHostDxe.c
 create mode 100644 Platform/RaspberryPi/RPi3/Drivers/ArasanMmcHostDxe/ArasanMmcHostDxe.h
 create mode 100644 Platform/RaspberryPi/RPi3/Drivers/ArasanMmcHostDxe/ArasanMmcHostDxe.inf
 create mode 100644 Platform/RaspberryPi/RPi3/Drivers/ConfigDxe/ConfigDxe.c
 create mode 100644 Platform/RaspberryPi/RPi3/Drivers/ConfigDxe/ConfigDxe.inf
 create mode 100644 Platform/RaspberryPi/RPi3/Drivers/ConfigDxe/ConfigDxeFormSetGuid.h
 create mode 100644 Platform/RaspberryPi/RPi3/Drivers/ConfigDxe/ConfigDxeHii.uni
 create mode 100644 Platform/RaspberryPi/RPi3/Drivers/ConfigDxe/ConfigDxeHii.vfr
 create mode 100644 Platform/RaspberryPi/RPi3/Drivers/DisplayDxe/ComponentName.c
 create mode 100644 Platform/RaspberryPi/RPi3/Drivers/DisplayDxe/DisplayDxe.c
 create mode 100644 Platform/RaspberryPi/RPi3/Drivers/DisplayDxe/DisplayDxe.h
 create mode 100644 Platform/RaspberryPi/RPi3/Drivers/DisplayDxe/DisplayDxe.inf
 create mode 100644 Platform/RaspberryPi/RPi3/Drivers/DisplayDxe/Screenshot.c
 create mode 100644 Platform/RaspberryPi/RPi3/Drivers/DwUsbHostDxe/ComponentName.c
 create mode 100644 Platform/RaspberryPi/RPi3/Drivers/DwUsbHostDxe/DriverBinding.c
 create mode 100644 Platform/RaspberryPi/RPi3/Drivers/DwUsbHostDxe/DwUsbHostDxe.c
 create mode 100644 Platform/RaspberryPi/RPi3/Drivers/DwUsbHostDxe/DwUsbHostDxe.h
 create mode 100644 Platform/RaspberryPi/RPi3/Drivers/DwUsbHostDxe/DwUsbHostDxe.inf
 create mode 100644 Platform/RaspberryPi/RPi3/Drivers/DwUsbHostDxe/DwcHw.h
 create mode 100644 Platform/RaspberryPi/RPi3/Drivers/FdtDxe/FdtDxe.c
 create mode 100644 Platform/RaspberryPi/RPi3/Drivers/FdtDxe/FdtDxe.inf
 create mode 100644 Platform/RaspberryPi/RPi3/Drivers/GraphicsConsoleDxe/ComponentName.c
 create mode 100644 Platform/RaspberryPi/RPi3/Drivers/GraphicsConsoleDxe/GraphicsConsole.c
 create mode 100644 Platform/RaspberryPi/RPi3/Drivers/GraphicsConsoleDxe/GraphicsConsole.h
 create mode 100644 Platform/RaspberryPi/RPi3/Drivers/GraphicsConsoleDxe/GraphicsConsoleDxe.inf
 create mode 100644 Platform/RaspberryPi/RPi3/Drivers/GraphicsConsoleDxe/GraphicsConsoleDxe.uni
 create mode 100644 Platform/RaspberryPi/RPi3/Drivers/GraphicsConsoleDxe/GraphicsConsoleDxeExtra.uni
 create mode 100644 Platform/RaspberryPi/RPi3/Drivers/GraphicsConsoleDxe/NewFont.c
 create mode 100644 Platform/RaspberryPi/RPi3/Drivers/LogoDxe/License.txt
 create mode 100644 Platform/RaspberryPi/RPi3/Drivers/LogoDxe/Logo.bmp
 create mode 100644 Platform/RaspberryPi/RPi3/Drivers/LogoDxe/Logo.c
 create mode 100644 Platform/RaspberryPi/RPi3/Drivers/LogoDxe/Logo.eps
 create mode 100644 Platform/RaspberryPi/RPi3/Drivers/LogoDxe/Logo.idf
 create mode 100644 Platform/RaspberryPi/RPi3/Drivers/LogoDxe/Logo.inf
 create mode 100644 Platform/RaspberryPi/RPi3/Drivers/LogoDxe/Logo.uni
 create mode 100644 Platform/RaspberryPi/RPi3/Drivers/LogoDxe/LogoDxe.inf
 create mode 100644 Platform/RaspberryPi/RPi3/Drivers/LogoDxe/LogoDxe.uni
 create mode 100644 Platform/RaspberryPi/RPi3/Drivers/LogoDxe/LogoDxeExtra.uni
 create mode 100644 Platform/RaspberryPi/RPi3/Drivers/LogoDxe/LogoExtra.uni
 create mode 100644 Platform/RaspberryPi/RPi3/Drivers/MmcDxe/ComponentName.c
 create mode 100644 Platform/RaspberryPi/RPi3/Drivers/MmcDxe/Diagnostics.c
 create mode 100644 Platform/RaspberryPi/RPi3/Drivers/MmcDxe/Mmc.c
 create mode 100644 Platform/RaspberryPi/RPi3/Drivers/MmcDxe/Mmc.h
 create mode 100644 Platform/RaspberryPi/RPi3/Drivers/MmcDxe/MmcBlockIo.c
 create mode 100644 Platform/RaspberryPi/RPi3/Drivers/MmcDxe/MmcDebug.c
 create mode 100644 Platform/RaspberryPi/RPi3/Drivers/MmcDxe/MmcDxe.inf
 create mode 100644 Platform/RaspberryPi/RPi3/Drivers/MmcDxe/MmcIdentification.c
 create mode 100644 Platform/RaspberryPi/RPi3/Drivers/PlatformSmbiosDxe/PlatformSmbiosDxe.c
 create mode 100644 Platform/RaspberryPi/RPi3/Drivers/PlatformSmbiosDxe/PlatformSmbiosDxe.inf
 create mode 100644 Platform/RaspberryPi/RPi3/Drivers/RpiFirmwareDxe/RpiFirmwareDxe.c
 create mode 100644 Platform/RaspberryPi/RPi3/Drivers/RpiFirmwareDxe/RpiFirmwareDxe.inf
 create mode 100644 Platform/RaspberryPi/RPi3/Drivers/SdHostDxe/SdHostDxe.c
 create mode 100644 Platform/RaspberryPi/RPi3/Drivers/SdHostDxe/SdHostDxe.inf
 create mode 100644 Platform/RaspberryPi/RPi3/Drivers/VarBlockServiceDxe/FileIo.c
 create mode 100644 Platform/RaspberryPi/RPi3/Drivers/VarBlockServiceDxe/FvbInfo.c
 create mode 100644 Platform/RaspberryPi/RPi3/Drivers/VarBlockServiceDxe/VarBlockService.c
 create mode 100644 Platform/RaspberryPi/RPi3/Drivers/VarBlockServiceDxe/VarBlockService.h
 create mode 100644 Platform/RaspberryPi/RPi3/Drivers/VarBlockServiceDxe/VarBlockServiceDxe.c
 create mode 100644 Platform/RaspberryPi/RPi3/Drivers/VarBlockServiceDxe/VarBlockServiceDxe.inf
 create mode 100644 Platform/RaspberryPi/RPi3/Include/IndustryStandard/RpiMbox.h
 create mode 100644 Platform/RaspberryPi/RPi3/Include/Protocol/DwUsb.h
 create mode 100644 Platform/RaspberryPi/RPi3/Include/Protocol/ExtendedTextOut.h
 create mode 100644 Platform/RaspberryPi/RPi3/Include/Protocol/RpiFirmware.h
 create mode 100644 Platform/RaspberryPi/RPi3/Include/Protocol/RpiMmcHost.h
 create mode 100644 Platform/RaspberryPi/RPi3/Library/MemoryInitPeiLib/MemoryInitPeiLib.c
 create mode 100644 Platform/RaspberryPi/RPi3/Library/MemoryInitPeiLib/MemoryInitPeiLib.inf
 create mode 100644 Platform/RaspberryPi/RPi3/Library/PlatformBootManagerLib/PlatformBm.c
 create mode 100644 Platform/RaspberryPi/RPi3/Library/PlatformBootManagerLib/PlatformBm.h
 create mode 100644 Platform/RaspberryPi/RPi3/Library/PlatformBootManagerLib/PlatformBootManagerLib.inf
 create mode 100644 Platform/RaspberryPi/RPi3/Library/PlatformLib/AArch64/RaspberryPiHelper.S
 create mode 100644 Platform/RaspberryPi/RPi3/Library/PlatformLib/PlatformLib.inf
 create mode 100644 Platform/RaspberryPi/RPi3/Library/PlatformLib/RaspberryPi.c
 create mode 100644 Platform/RaspberryPi/RPi3/Library/PlatformLib/RaspberryPiMem.c
 create mode 100644 Platform/RaspberryPi/RPi3/Library/PlatformUiAppLib/PlatformUiAppLib.c
 create mode 100644 Platform/RaspberryPi/RPi3/Library/PlatformUiAppLib/PlatformUiAppLib.inf
 create mode 100644 Platform/RaspberryPi/RPi3/Library/ResetLib/ResetLib.c
 create mode 100644 Platform/RaspberryPi/RPi3/Library/ResetLib/ResetLib.inf
 create mode 100644 Platform/RaspberryPi/RPi3/RPi3.dec
 create mode 100644 Platform/RaspberryPi/RPi3/RPi3.dsc
 create mode 100644 Platform/RaspberryPi/RPi3/RPi3.fdf
 create mode 100644 Platform/RaspberryPi/RPi3/Readme.md
 create mode 100644 Platform/RaspberryPi/RPi3/Systems.md
 create mode 100644 Platform/RaspberryPi/RPi3/TrustedFirmware/License.txt
 create mode 100644 Platform/RaspberryPi/RPi3/TrustedFirmware/Readme.md
 create mode 100644 Platform/RaspberryPi/RPi3/TrustedFirmware/bl1.bin
 create mode 100644 Platform/RaspberryPi/RPi3/TrustedFirmware/fip.bin
 create mode 100644 Silicon/Broadcom/Bcm283x/Bcm283x.dec
 create mode 100644 Silicon/Broadcom/Bcm283x/Drivers/InterruptDxe/InterruptDxe.c
 create mode 100644 Silicon/Broadcom/Bcm283x/Drivers/InterruptDxe/InterruptDxe.inf
 create mode 100644 Silicon/Broadcom/Bcm283x/Include/IndustryStandard/Bcm2836.h
 create mode 100644 Silicon/Broadcom/Bcm283x/Include/IndustryStandard/Bcm2836Gpio.h
 create mode 100644 Silicon/Broadcom/Bcm283x/Include/IndustryStandard/Bcm2836SdHost.h
 create mode 100644 Silicon/Broadcom/Bcm283x/Include/IndustryStandard/Bcm2836Sdio.h
 create mode 100644 Silicon/Broadcom/Bcm283x/Include/Library/GpioLib.h
 create mode 100644 Silicon/Broadcom/Bcm283x/Library/GpioLib/GpioLib.c
 create mode 100644 Silicon/Broadcom/Bcm283x/Library/GpioLib/GpioLib.inf

-- 
2.17.0.windows.1



^ permalink raw reply	[flat|nested] 34+ messages in thread

* [PATCH v5 edk2-platforms 01/22] Silicon/Broadcom/Bcm283x: Add interrupt driver
  2019-02-05 16:25 [PATCH v5 edk2-platforms 00/22] Platform/RaspberryPi: Add Raspberry Pi 3 support Pete Batard
@ 2019-02-05 16:25 ` Pete Batard
  2019-02-05 16:25 ` [PATCH v5 edk2-platforms 02/22] Silicon/Broadcom/Bcm283x: Add GpioLib Pete Batard
                   ` (22 subsequent siblings)
  23 siblings, 0 replies; 34+ messages in thread
From: Pete Batard @ 2019-02-05 16:25 UTC (permalink / raw)
  To: edk2-devel

This currently only implements support for the architected timer
interrupts on the per-CPU interrupt controllers.

Contributed-under: TianoCore Contribution Agreement 1.1
Signed-off-by: Pete Batard <pete@akeo.ie>

Reviewed-by: Ard Biesheuvel <ard.biesheuvel@linaro.org>
---
 Silicon/Broadcom/Bcm283x/Bcm283x.dec                           |  23 ++
 Silicon/Broadcom/Bcm283x/Drivers/InterruptDxe/InterruptDxe.c   | 367 ++++++++++++++++++++
 Silicon/Broadcom/Bcm283x/Drivers/InterruptDxe/InterruptDxe.inf |  48 +++
 Silicon/Broadcom/Bcm283x/Include/IndustryStandard/Bcm2836.h    |  72 ++++
 4 files changed, 510 insertions(+)

diff --git a/Silicon/Broadcom/Bcm283x/Bcm283x.dec b/Silicon/Broadcom/Bcm283x/Bcm283x.dec
new file mode 100644
index 000000000000..d193da4c0e1e
--- /dev/null
+++ b/Silicon/Broadcom/Bcm283x/Bcm283x.dec
@@ -0,0 +1,23 @@
+## @file
+#
+#  Copyright (c) 2019, Pete Batard <pete@akeo.ie>
+#
+#  This program and the accompanying materials are licensed and made available
+#  under the terms and conditions of the BSD License which accompanies this
+#  distribution. The full text of the license may be found at
+#  http://opensource.org/licenses/bsd-license.php
+#
+#  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+#  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR
+#  IMPLIED.
+#
+##
+
+[Defines]
+  DEC_SPECIFICATION              = 0x0001001A
+  PACKAGE_NAME                   = Bcm283xPkg
+  PACKAGE_GUID                   = 900C0F44-1152-4FF9-B9C5-933E2918C831
+  PACKAGE_VERSION                = 1.0
+
+[Includes]
+  Include
diff --git a/Silicon/Broadcom/Bcm283x/Drivers/InterruptDxe/InterruptDxe.c b/Silicon/Broadcom/Bcm283x/Drivers/InterruptDxe/InterruptDxe.c
new file mode 100644
index 000000000000..9058aa94ffb9
--- /dev/null
+++ b/Silicon/Broadcom/Bcm283x/Drivers/InterruptDxe/InterruptDxe.c
@@ -0,0 +1,367 @@
+/** @file
+ *
+ *  Copyright (c) 2016, Linaro, Ltd. All rights reserved.
+ *
+ *  This program and the accompanying materials
+ *  are licensed and made available under the terms and conditions of the BSD License
+ *  which accompanies this distribution.  The full text of the license may be found at
+ *  http://opensource.org/licenses/bsd-license.php
+ *
+ *  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+ *  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+ *
+ **/
+
+#include <PiDxe.h>
+
+#include <Library/BaseLib.h>
+#include <Library/DebugLib.h>
+#include <Library/IoLib.h>
+#include <Library/UefiBootServicesTableLib.h>
+#include <Library/UefiLib.h>
+
+#include <IndustryStandard/Bcm2836.h>
+
+#include <Protocol/Cpu.h>
+#include <Protocol/HardwareInterrupt.h>
+
+//
+// This currently only implements support for the architected timer interrupts
+// on the per-CPU interrupt controllers.
+//
+#define NUM_IRQS                    (4)
+
+#ifdef MDE_CPU_AARCH64
+#define ARM_ARCH_EXCEPTION_IRQ      EXCEPT_AARCH64_IRQ
+#else
+#define ARM_ARCH_EXCEPTION_IRQ      EXCEPT_ARM_IRQ
+#endif
+
+STATIC CONST
+EFI_PHYSICAL_ADDRESS RegBase = FixedPcdGet32 (PcdInterruptBaseAddress);
+
+//
+// Notifications
+//
+STATIC EFI_EVENT                    mExitBootServicesEvent;
+STATIC HARDWARE_INTERRUPT_HANDLER   mRegisteredInterruptHandlers[NUM_IRQS];
+
+/**
+  Shutdown our hardware
+
+  DXE Core will disable interrupts and turn off the timer and disable interrupts
+  after all the event handlers have run.
+
+  @param[in]  Event   The Event that is being processed
+  @param[in]  Context Event Context
+**/
+STATIC
+VOID
+EFIAPI
+ExitBootServicesEvent (
+  IN EFI_EVENT  Event,
+  IN VOID       *Context
+  )
+{
+  // Disable all interrupts
+  MmioWrite32 (RegBase + BCM2836_INTC_TIMER_CONTROL_OFFSET, 0);
+}
+
+/**
+  Enable interrupt source Source.
+
+  @param This     Instance pointer for this protocol
+  @param Source   Hardware source of the interrupt
+
+  @retval EFI_SUCCESS       Source interrupt enabled.
+  @retval EFI_DEVICE_ERROR  Hardware could not be programmed.
+
+**/
+STATIC
+EFI_STATUS
+EFIAPI
+EnableInterruptSource (
+  IN EFI_HARDWARE_INTERRUPT_PROTOCOL    *This,
+  IN HARDWARE_INTERRUPT_SOURCE          Source
+  )
+{
+  if (Source >= NUM_IRQS) {
+    ASSERT (FALSE);
+    return EFI_UNSUPPORTED;
+  }
+
+  MmioOr32 (RegBase + BCM2836_INTC_TIMER_CONTROL_OFFSET, 1 << Source);
+
+  return EFI_SUCCESS;
+}
+
+
+/**
+  Disable interrupt source Source.
+
+  @param This     Instance pointer for this protocol
+  @param Source   Hardware source of the interrupt
+
+  @retval EFI_SUCCESS       Source interrupt disabled.
+  @retval EFI_DEVICE_ERROR  Hardware could not be programmed.
+
+**/
+STATIC
+EFI_STATUS
+EFIAPI
+DisableInterruptSource (
+  IN EFI_HARDWARE_INTERRUPT_PROTOCOL    *This,
+  IN HARDWARE_INTERRUPT_SOURCE          Source
+  )
+{
+  if (Source >= NUM_IRQS) {
+    ASSERT (FALSE);
+    return EFI_UNSUPPORTED;
+  }
+
+  MmioAnd32 (RegBase + BCM2836_INTC_TIMER_CONTROL_OFFSET, ~(1 << Source));
+
+  return EFI_SUCCESS;
+}
+
+/**
+  Register Handler for the specified interrupt source.
+
+  @param This     Instance pointer for this protocol
+  @param Source   Hardware source of the interrupt
+  @param Handler  Callback for interrupt. NULL to unregister
+
+  @retval EFI_SUCCESS Source was updated to support Handler.
+  @retval EFI_DEVICE_ERROR  Hardware could not be programmed.
+
+**/
+STATIC
+EFI_STATUS
+EFIAPI
+RegisterInterruptSource (
+  IN EFI_HARDWARE_INTERRUPT_PROTOCOL    *This,
+  IN HARDWARE_INTERRUPT_SOURCE          Source,
+  IN HARDWARE_INTERRUPT_HANDLER         Handler
+  )
+{
+  if (Source >= NUM_IRQS) {
+    ASSERT (FALSE);
+    return EFI_UNSUPPORTED;
+  }
+
+  if (Handler == NULL && mRegisteredInterruptHandlers[Source] == NULL) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  if (Handler != NULL && mRegisteredInterruptHandlers[Source] != NULL) {
+    return EFI_ALREADY_STARTED;
+  }
+
+  mRegisteredInterruptHandlers[Source] = Handler;
+  return EnableInterruptSource (This, Source);
+}
+
+
+/**
+  Return current state of interrupt source Source.
+
+  @param This     Instance pointer for this protocol
+  @param Source   Hardware source of the interrupt
+  @param InterruptState  TRUE: source enabled, FALSE: source disabled.
+
+  @retval EFI_SUCCESS       InterruptState is valid
+  @retval EFI_DEVICE_ERROR  InterruptState is not valid
+
+**/
+STATIC
+EFI_STATUS
+EFIAPI
+GetInterruptSourceState (
+  IN EFI_HARDWARE_INTERRUPT_PROTOCOL    *This,
+  IN HARDWARE_INTERRUPT_SOURCE          Source,
+  IN BOOLEAN                            *InterruptState
+  )
+{
+  if (InterruptState == NULL) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  if (Source >= NUM_IRQS) {
+    ASSERT (FALSE);
+    return EFI_UNSUPPORTED;
+  }
+
+  *InterruptState = (MmioRead32 (RegBase + BCM2836_INTC_TIMER_CONTROL_OFFSET) &
+                     (1 << Source)) != 0;
+
+  return EFI_SUCCESS;
+}
+
+/**
+  Signal to the hardware that the End Of Intrrupt state
+  has been reached.
+
+  @param This     Instance pointer for this protocol
+  @param Source   Hardware source of the interrupt
+
+  @retval EFI_SUCCESS       Source interrupt EOI'ed.
+  @retval EFI_DEVICE_ERROR  Hardware could not be programmed.
+
+**/
+STATIC
+EFI_STATUS
+EFIAPI
+EndOfInterrupt (
+  IN EFI_HARDWARE_INTERRUPT_PROTOCOL    *This,
+  IN HARDWARE_INTERRUPT_SOURCE          Source
+  )
+{
+  return EFI_SUCCESS;
+}
+
+
+/**
+  EFI_CPU_INTERRUPT_HANDLER that is called when a processor interrupt occurs.
+
+  @param  InterruptType    Defines the type of interrupt or exception that
+                           occurred on the processor.This parameter is processor
+                           architecture specific.
+  @param  SystemContext    A pointer to the processor context when
+                           the interrupt occurred on the processor.
+
+  @return None
+
+**/
+STATIC
+VOID
+EFIAPI
+IrqInterruptHandler (
+  IN EFI_EXCEPTION_TYPE           InterruptType,
+  IN EFI_SYSTEM_CONTEXT           SystemContext
+  )
+{
+  HARDWARE_INTERRUPT_HANDLER  InterruptHandler;
+  HARDWARE_INTERRUPT_SOURCE   Source;
+  UINT32                      RegVal;
+
+  RegVal = MmioRead32 (RegBase + BCM2836_INTC_TIMER_PENDING_OFFSET) &
+    ((1 << NUM_IRQS) - 1);
+  Source = HighBitSet32 (RegVal);
+  if (Source < 0) {
+    return;
+  }
+
+  InterruptHandler = mRegisteredInterruptHandlers[Source];
+  if (InterruptHandler != NULL) {
+    // Call the registered interrupt handler.
+    InterruptHandler (Source, SystemContext);
+  }
+}
+
+//
+// The protocol instance produced by this driver
+//
+STATIC EFI_HARDWARE_INTERRUPT_PROTOCOL gHardwareInterruptProtocol = {
+  RegisterInterruptSource,
+  EnableInterruptSource,
+  DisableInterruptSource,
+  GetInterruptSourceState,
+  EndOfInterrupt
+};
+
+STATIC VOID *mCpuArchProtocolNotifyEventRegistration;
+
+STATIC
+VOID
+EFIAPI
+CpuArchEventProtocolNotify (
+  IN  EFI_EVENT       Event,
+  IN  VOID            *Context
+  )
+{
+  EFI_CPU_ARCH_PROTOCOL   *Cpu;
+  EFI_STATUS              Status;
+
+  //
+  // Get the CPU protocol that this driver requires.
+  //
+  Status = gBS->LocateProtocol (&gEfiCpuArchProtocolGuid, NULL, (VOID**)&Cpu);
+  if (EFI_ERROR (Status)) {
+    return;
+  }
+
+  //
+  // Unregister the default exception handler.
+  //
+  Status = Cpu->RegisterInterruptHandler (Cpu, ARM_ARCH_EXCEPTION_IRQ, NULL);
+  if (EFI_ERROR (Status)) {
+    DEBUG ((DEBUG_ERROR, "%a: Cpu->RegisterInterruptHandler() - %r\n",
+      __FUNCTION__, Status));
+    ASSERT (FALSE);
+    return;
+  }
+
+  //
+  // Register to receive interrupts
+  //
+  Status = Cpu->RegisterInterruptHandler (Cpu, ARM_ARCH_EXCEPTION_IRQ, IrqInterruptHandler);
+  if (EFI_ERROR (Status)) {
+    DEBUG ((DEBUG_ERROR, "%a: Cpu->RegisterInterruptHandler() - %r\n",
+      __FUNCTION__, Status));
+    ASSERT (FALSE);
+    return;
+  }
+}
+
+
+/**
+  Initialize the state information for the CPU Architectural Protocol
+
+  @param  ImageHandle   of the loaded driver
+  @param  SystemTable   Pointer to the System Table
+
+  @retval EFI_SUCCESS           Protocol registered
+  @retval EFI_OUT_OF_RESOURCES  Cannot allocate protocol data structure
+  @retval EFI_DEVICE_ERROR      Hardware problems
+
+**/
+EFI_STATUS
+InterruptDxeInitialize (
+  IN EFI_HANDLE         ImageHandle,
+  IN EFI_SYSTEM_TABLE   *SystemTable
+  )
+{
+  EFI_STATUS Status;
+  EFI_EVENT  CpuArchEvent;
+
+  // Make sure the Interrupt Controller Protocol is not already installed in the system.
+  ASSERT_PROTOCOL_ALREADY_INSTALLED (NULL, &gHardwareInterruptProtocolGuid);
+
+  Status = gBS->InstallMultipleProtocolInterfaces (
+                  &ImageHandle,
+                  &gHardwareInterruptProtocolGuid,
+                  &gHardwareInterruptProtocol,
+                  NULL
+                );
+  ASSERT_EFI_ERROR (Status);
+
+  //
+  // Install the interrupt handler as soon as the CPU arch protocol appears.
+  //
+  CpuArchEvent = EfiCreateProtocolNotifyEvent (
+                   &gEfiCpuArchProtocolGuid,
+                   TPL_CALLBACK,
+                   CpuArchEventProtocolNotify,
+                   NULL,
+                   &mCpuArchProtocolNotifyEventRegistration
+                 );
+  ASSERT (CpuArchEvent != NULL);
+
+  // Register for an ExitBootServicesEvent
+  Status = gBS->CreateEvent (EVT_SIGNAL_EXIT_BOOT_SERVICES, TPL_NOTIFY,
+                  ExitBootServicesEvent, NULL, &mExitBootServicesEvent);
+
+  ASSERT_EFI_ERROR (Status);
+
+  return Status;
+}
diff --git a/Silicon/Broadcom/Bcm283x/Drivers/InterruptDxe/InterruptDxe.inf b/Silicon/Broadcom/Bcm283x/Drivers/InterruptDxe/InterruptDxe.inf
new file mode 100644
index 000000000000..5812e48dbb7a
--- /dev/null
+++ b/Silicon/Broadcom/Bcm283x/Drivers/InterruptDxe/InterruptDxe.inf
@@ -0,0 +1,48 @@
+#/** @file
+#
+#  Copyright (c) 2017, Andrei Warkentin <andrey.warkentin@gmail.com>
+#  Copyright (c) 2016 Linaro, Ltd. All rights reserved.
+#
+#  This program and the accompanying materials
+#  are licensed and made available under the terms and conditions of the BSD License
+#  which accompanies this distribution.  The full text of the license may be found at
+#  http://opensource.org/licenses/bsd-license.php
+#
+#  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+#  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+#
+#**/
+
+[Defines]
+  INF_VERSION                    = 0x0001001A
+  BASE_NAME                      = InterruptDxe
+  FILE_GUID                      = 3944f2d7-2e09-4fc0-9e98-008375641453
+  MODULE_TYPE                    = DXE_DRIVER
+  VERSION_STRING                 = 1.0
+  ENTRY_POINT                    = InterruptDxeInitialize
+
+[Sources]
+  InterruptDxe.c
+
+[Packages]
+  MdePkg/MdePkg.dec
+  EmbeddedPkg/EmbeddedPkg.dec
+  Silicon/Broadcom/Bcm283x/Bcm283x.dec
+
+[LibraryClasses]
+  BaseLib
+  DebugLib
+  IoLib
+  UefiBootServicesTableLib
+  UefiLib
+  UefiDriverEntryPoint
+
+[Protocols]
+  gHardwareInterruptProtocolGuid  ## PRODUCES
+  gEfiCpuArchProtocolGuid         ## CONSUMES ## NOTIFY
+
+[FixedPcd]
+  gEmbeddedTokenSpaceGuid.PcdInterruptBaseAddress
+
+[Depex]
+  TRUE
diff --git a/Silicon/Broadcom/Bcm283x/Include/IndustryStandard/Bcm2836.h b/Silicon/Broadcom/Bcm283x/Include/IndustryStandard/Bcm2836.h
new file mode 100644
index 000000000000..f9fffb764649
--- /dev/null
+++ b/Silicon/Broadcom/Bcm283x/Include/IndustryStandard/Bcm2836.h
@@ -0,0 +1,72 @@
+/** @file
+ *
+ *  Copyright (c) 2017, Andrei Warkentin <andrey.warkentin@gmail.com>
+ *  Copyright (c) 2016, Linaro Limited. All rights reserved.
+ *
+ *  Redistribution and use in source and binary forms, with or without
+ *  modification, are permitted provided that the following conditions are met:
+ *
+ *  Redistributions of source code must retain the above copyright notice, this
+ *  list of conditions and the following disclaimer.
+ *
+ *  Redistributions in binary form must reproduce the above copyright notice,
+ *  this list of conditions and the following disclaimer in the documentation
+ *  and/or other materials provided with the distribution.
+ *
+ *  Neither the name of ARM nor the names of its contributors may be used
+ *  to endorse or promote products derived from this software without specific
+ *  prior written permission.
+ *
+ *  THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+ *  AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+ *  IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ *  ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
+ *  LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+ *  CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+ *  SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ *  INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+ *  CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ *  ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+ *  POSSIBILITY OF SUCH DAMAGE.
+ *
+ **/
+
+#ifndef __BCM2836_H__
+#define __BCM2836_H__
+
+/*
+ * Both "core" and SoC perpherals (1M each).
+ */
+#define BCM2836_SOC_REGISTERS                               0x3f000000
+#define BCM2836_SOC_REGISTER_LENGTH                         0x02000000
+
+/*
+ * Offset between the CPU's view and the VC's view of system memory.
+ */
+#define BCM2836_DMA_DEVICE_OFFSET                           0xc0000000
+
+/* watchdog constants */
+#define BCM2836_WDOG_BASE_ADDRESS                           0x3f100000
+#define BCM2836_WDOG_PASSWORD                               0x5a000000
+#define BCM2836_WDOG_RSTC_OFFSET                            0x0000001c
+#define BCM2836_WDOG_WDOG_OFFSET                            0x00000024
+#define BCM2836_WDOG_RSTC_WRCFG_MASK                        0x00000030
+#define BCM2836_WDOG_RSTC_WRCFG_FULL_RESET                  0x00000020
+
+/* mailbox interface constants */
+#define BCM2836_MBOX_BASE_ADDRESS                           0x3f00b880
+#define BCM2836_MBOX_READ_OFFSET                            0x00000000
+#define BCM2836_MBOX_STATUS_OFFSET                          0x00000018
+#define BCM2836_MBOX_CONFIG_OFFSET                          0x0000001c
+#define BCM2836_MBOX_WRITE_OFFSET                           0x00000020
+
+#define BCM2836_MBOX_STATUS_FULL                            0x1f
+#define BCM2836_MBOX_STATUS_EMPTY                           0x1e
+
+#define BCM2836_MBOX_NUM_CHANNELS                           16
+
+/* interrupt controller constants */
+#define BCM2836_INTC_TIMER_CONTROL_OFFSET                   0x00000040
+#define BCM2836_INTC_TIMER_PENDING_OFFSET                   0x00000060
+
+#endif /*__BCM2836_H__ */
-- 
2.17.0.windows.1



^ permalink raw reply related	[flat|nested] 34+ messages in thread

* [PATCH v5 edk2-platforms 02/22] Silicon/Broadcom/Bcm283x: Add GpioLib
  2019-02-05 16:25 [PATCH v5 edk2-platforms 00/22] Platform/RaspberryPi: Add Raspberry Pi 3 support Pete Batard
  2019-02-05 16:25 ` [PATCH v5 edk2-platforms 01/22] Silicon/Broadcom/Bcm283x: Add interrupt driver Pete Batard
@ 2019-02-05 16:25 ` Pete Batard
  2019-02-05 16:25 ` [PATCH v5 edk2-platforms 03/22] Platform/RaspberryPi/RPi3: Add ACPI tables Pete Batard
                   ` (21 subsequent siblings)
  23 siblings, 0 replies; 34+ messages in thread
From: Pete Batard @ 2019-02-05 16:25 UTC (permalink / raw)
  To: edk2-devel

This library is meant to be used by Bcm283x-based platforms, such
as the Raspberry Pi, to control the GPIO port pins on said platform.

Contributed-under: TianoCore Contribution Agreement 1.1
Signed-off-by: Pete Batard <pete@akeo.ie>
---
 Silicon/Broadcom/Bcm283x/Include/IndustryStandard/Bcm2836Gpio.h | 49 +++++++++++
 Silicon/Broadcom/Bcm283x/Include/Library/GpioLib.h              | 33 ++++++++
 Silicon/Broadcom/Bcm283x/Library/GpioLib/GpioLib.c              | 89 ++++++++++++++++++++
 Silicon/Broadcom/Bcm283x/Library/GpioLib/GpioLib.inf            | 39 +++++++++
 4 files changed, 210 insertions(+)

diff --git a/Silicon/Broadcom/Bcm283x/Include/IndustryStandard/Bcm2836Gpio.h b/Silicon/Broadcom/Bcm283x/Include/IndustryStandard/Bcm2836Gpio.h
new file mode 100644
index 000000000000..5fc43ddaa27b
--- /dev/null
+++ b/Silicon/Broadcom/Bcm283x/Include/IndustryStandard/Bcm2836Gpio.h
@@ -0,0 +1,49 @@
+/** @file
+ *
+ *  Copyright (c) 2018, Andrei Warkentin <andrey.warkentin@gmail.com>
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *
+ *  This program and the accompanying materials
+ *  are licensed and made available under the terms and conditions of the BSD License
+ *  which accompanies this distribution.  The full text of the license may be found at
+ *  http://opensource.org/licenses/bsd-license.php
+ *
+ *  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+ *  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+ *
+ **/
+
+#ifndef __BCM2836_GPIO_H__
+#define __BCM2836_GPIO_H__
+
+#define GPIO_BASE_ADDRESS  (BCM2836_SOC_REGISTERS + 0x00200000)
+
+#define GPIO_GPFSEL0       (GPIO_BASE_ADDRESS + 0x00)
+#define GPIO_GPFSEL1       (GPIO_BASE_ADDRESS + 0x04)
+#define GPIO_GPFSEL2       (GPIO_BASE_ADDRESS + 0x08)
+#define GPIO_GPFSEL3       (GPIO_BASE_ADDRESS + 0x0C)
+#define GPIO_GPFSEL4       (GPIO_BASE_ADDRESS + 0x10)
+#define GPIO_GPFSEL5       (GPIO_BASE_ADDRESS + 0x14)
+
+#define GPIO_GPCLR0        (GPIO_BASE_ADDRESS + 0x28)
+#define GPIO_GPCLR1        (GPIO_BASE_ADDRESS + 0x2C)
+
+#define GPIO_GPSET0        (GPIO_BASE_ADDRESS + 0x1C)
+#define GPIO_GPSET1        (GPIO_BASE_ADDRESS + 0x20)
+
+#define GPIO_FSEL_INPUT    0x0
+#define GPIO_FSEL_OUTPUT   0x1
+#define GPIO_FSEL_ALT0     0x4
+#define GPIO_FSEL_ALT1     0x5
+#define GPIO_FSEL_ALT2     0x6
+#define GPIO_FSEL_ALT3     0x7
+#define GPIO_FSEL_ALT4     0x3
+#define GPIO_FSEL_ALT5     0x2
+
+#define GPIO_FSEL_PINS_PER_REGISTER 10
+#define GPIO_FSEL_BITS_PER_PIN      3
+#define GPIO_FSEL_MASK              ((1 << GPIO_FSEL_BITS_PER_PIN) - 1)
+
+#define GPIO_PINS          54
+
+#endif /* __BCM2836_GPIO_H__ */
diff --git a/Silicon/Broadcom/Bcm283x/Include/Library/GpioLib.h b/Silicon/Broadcom/Bcm283x/Include/Library/GpioLib.h
new file mode 100644
index 000000000000..c3e1fc21bf8d
--- /dev/null
+++ b/Silicon/Broadcom/Bcm283x/Include/Library/GpioLib.h
@@ -0,0 +1,33 @@
+/** @file
+ *
+ *  GPIO manipulation.
+ *
+ *  Copyright (c) 2018, Andrei Warkentin <andrey.warkentin@gmail.com>
+ *
+ *  This program and the accompanying materials
+ *  are licensed and made available under the terms and conditions of the BSD License
+ *  which accompanies this distribution.  The full text of the license may be found at
+ *  http://opensource.org/licenses/bsd-license.php
+ *
+ *  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+ *  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+ *
+ **/
+
+#ifndef __GPIO_LIB__
+#define __GPIO_LIB__
+
+#include <IndustryStandard/Bcm2836Gpio.h>
+
+VOID
+GpioPinFuncSet (
+  IN  UINTN Pin,
+  IN  UINTN Function
+  );
+
+UINTN
+GpioPinFuncGet (
+  IN  UINTN Pin
+  );
+
+#endif /* __GPIO_LIB__ */
diff --git a/Silicon/Broadcom/Bcm283x/Library/GpioLib/GpioLib.c b/Silicon/Broadcom/Bcm283x/Library/GpioLib/GpioLib.c
new file mode 100644
index 000000000000..8cf560e4fcc5
--- /dev/null
+++ b/Silicon/Broadcom/Bcm283x/Library/GpioLib/GpioLib.c
@@ -0,0 +1,89 @@
+/** @file
+ *
+ *  GPIO manipulation.
+ *
+ *  Copyright (c) 2018, Andrei Warkentin <andrey.warkentin@gmail.com>
+ *
+ *  This program and the accompanying materials
+ *  are licensed and made available under the terms and conditions of the BSD License
+ *  which accompanies this distribution.  The full text of the license may be found at
+ *  http://opensource.org/licenses/bsd-license.php
+ *
+ *  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+ *  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+ *
+ **/
+
+#include <Uefi.h>
+#include <Library/BaseLib.h>
+#include <Library/DebugLib.h>
+#include <Library/IoLib.h>
+#include <Library/GpioLib.h>
+#include <IndustryStandard/Bcm2836.h>
+#include <IndustryStandard/Bcm2836Gpio.h>
+
+STATIC
+VOID
+GpioFSELModify (
+  IN  UINTN RegIndex,
+  IN  UINT32 ModifyMask,
+  IN  UINT32 FunctionMask
+  )
+{
+  UINT32 Val;
+  EFI_PHYSICAL_ADDRESS Reg;
+
+  Reg = RegIndex * sizeof (UINT32) + GPIO_GPFSEL0;
+
+  ASSERT (Reg <= GPIO_GPFSEL5);
+  ASSERT ((~ModifyMask & FunctionMask) == 0);
+
+  Val = MmioRead32 (Reg);
+  Val &= ~ModifyMask;
+  Val |= FunctionMask;
+  MmioWrite32 (Reg, Val);
+}
+
+VOID
+GpioPinFuncSet (
+  IN  UINTN Pin,
+  IN  UINTN Function
+  )
+{
+  UINTN RegIndex;
+  UINTN SelIndex;
+  UINT32 ModifyMask;
+  UINT32 FunctionMask;
+
+  ASSERT (Pin < GPIO_PINS);
+  ASSERT (Function <= GPIO_FSEL_MASK);
+
+  RegIndex = Pin / 10;
+  SelIndex = Pin % 10;
+
+  ModifyMask = GPIO_FSEL_MASK << (SelIndex * GPIO_FSEL_BITS_PER_PIN);
+  FunctionMask = Function << (SelIndex * GPIO_FSEL_BITS_PER_PIN);
+  GpioFSELModify (RegIndex, ModifyMask, FunctionMask);
+}
+
+UINTN
+GpioPinFuncGet (
+  IN  UINTN Pin
+  )
+{
+  UINT32 Val;
+  UINTN RegIndex;
+  UINTN SelIndex;
+  EFI_PHYSICAL_ADDRESS Reg;
+
+  ASSERT (Pin < GPIO_PINS);
+
+  RegIndex = Pin / 10;
+  SelIndex = Pin % 10;
+  Reg = RegIndex * sizeof (UINT32) + GPIO_GPFSEL0;
+
+  Val = MmioRead32 (Reg);
+  Val >>= SelIndex * GPIO_FSEL_BITS_PER_PIN;
+  Val &= GPIO_FSEL_MASK;
+  return Val;
+}
diff --git a/Silicon/Broadcom/Bcm283x/Library/GpioLib/GpioLib.inf b/Silicon/Broadcom/Bcm283x/Library/GpioLib/GpioLib.inf
new file mode 100644
index 000000000000..68ebe44e3d1c
--- /dev/null
+++ b/Silicon/Broadcom/Bcm283x/Library/GpioLib/GpioLib.inf
@@ -0,0 +1,39 @@
+#/** @file
+#
+#  Manipulate GPIOs.
+#
+#  Copyright (c) 2018, Andrei Warkentin <andrey.warkentin@gmail.com>
+#
+#  This program and the accompanying materials
+#  are licensed and made available under the terms and conditions of the BSD License
+#  which accompanies this distribution.  The full text of the license may be found at
+#  http://opensource.org/licenses/bsd-license.php
+#
+#  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+#  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+#
+#**/
+
+[Defines]
+  INF_VERSION                    = 0x0001001A
+  BASE_NAME                      = GpioLib
+  FILE_GUID                      = B9F59B6B-B105-41C7-8F5A-2C60DD7FD7AB
+  MODULE_TYPE                    = BASE
+  VERSION_STRING                 = 1.0
+  LIBRARY_CLASS                  = GpioLib
+
+[Sources]
+  GpioLib.c
+
+[Packages]
+  ArmPkg/ArmPkg.dec
+  MdePkg/MdePkg.dec
+  EmbeddedPkg/EmbeddedPkg.dec
+  Silicon/Broadcom/Bcm283x/Bcm283x.dec
+
+[LibraryClasses]
+  BaseLib
+  DebugLib
+  IoLib
+
+[Guids]
-- 
2.17.0.windows.1



^ permalink raw reply related	[flat|nested] 34+ messages in thread

* [PATCH v5 edk2-platforms 03/22] Platform/RaspberryPi/RPi3: Add ACPI tables
  2019-02-05 16:25 [PATCH v5 edk2-platforms 00/22] Platform/RaspberryPi: Add Raspberry Pi 3 support Pete Batard
  2019-02-05 16:25 ` [PATCH v5 edk2-platforms 01/22] Silicon/Broadcom/Bcm283x: Add interrupt driver Pete Batard
  2019-02-05 16:25 ` [PATCH v5 edk2-platforms 02/22] Silicon/Broadcom/Bcm283x: Add GpioLib Pete Batard
@ 2019-02-05 16:25 ` Pete Batard
  2019-02-05 16:25 ` [PATCH v5 edk2-platforms 04/22] Platform/RaspberryPi/RPi3: Add reset and memory init libraries Pete Batard
                   ` (20 subsequent siblings)
  23 siblings, 0 replies; 34+ messages in thread
From: Pete Batard @ 2019-02-05 16:25 UTC (permalink / raw)
  To: edk2-devel

These ACPI tables were mostly derived or copied from the MS-IoT ones.

This means that they are targetting Windows OSes, rather than Linux ones,
and aren't ACPI compliant, especially when it comes to their descriptors.

Contributed-under: TianoCore Contribution Agreement 1.1
Signed-off-by: Pete Batard <pete@akeo.ie>
---
 Platform/RaspberryPi/RPi3/AcpiTables/AcpiTables.h   |  82 ++++
 Platform/RaspberryPi/RPi3/AcpiTables/AcpiTables.inf |  46 ++
 Platform/RaspberryPi/RPi3/AcpiTables/Csrt.aslc      | 332 +++++++++++++
 Platform/RaspberryPi/RPi3/AcpiTables/Dbg2.aslc      |  34 ++
 Platform/RaspberryPi/RPi3/AcpiTables/Dsdt.asl       | 511 ++++++++++++++++++++
 Platform/RaspberryPi/RPi3/AcpiTables/Fadt.aslc      |  52 ++
 Platform/RaspberryPi/RPi3/AcpiTables/Gtdt.aslc      |  33 ++
 Platform/RaspberryPi/RPi3/AcpiTables/Madt.aslc      |  62 +++
 Platform/RaspberryPi/RPi3/AcpiTables/Pep.asl        |  95 ++++
 Platform/RaspberryPi/RPi3/AcpiTables/Pep.c          |  84 ++++
 Platform/RaspberryPi/RPi3/AcpiTables/Pep.h          | 126 +++++
 Platform/RaspberryPi/RPi3/AcpiTables/Rhpx.asl       | 201 ++++++++
 Platform/RaspberryPi/RPi3/AcpiTables/Sdhc.asl       | 105 ++++
 Platform/RaspberryPi/RPi3/AcpiTables/Spcr.asl       |  53 ++
 Platform/RaspberryPi/RPi3/AcpiTables/Uart.asl       | 158 ++++++
 15 files changed, 1974 insertions(+)

diff --git a/Platform/RaspberryPi/RPi3/AcpiTables/AcpiTables.h b/Platform/RaspberryPi/RPi3/AcpiTables/AcpiTables.h
new file mode 100644
index 000000000000..be28b6decefd
--- /dev/null
+++ b/Platform/RaspberryPi/RPi3/AcpiTables/AcpiTables.h
@@ -0,0 +1,82 @@
+/** @file
+ *
+ *  RPi3 defines for constructing ACPI tables
+ *
+ *  Copyright (c) 2018, Andrei Warkentin <andrey.warkentin@gmail.com>
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *
+ *  This program and the accompanying materials
+ *  are licensed and made available under the terms and conditions of the BSD License
+ *  which accompanies this distribution.  The full text of the license may be found at
+ *  http://opensource.org/licenses/bsd-license.php
+ *
+ *  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+ *  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+ *
+ **/
+
+#ifndef __ACPITABLES_H__
+#define __ACPITABLES_H__
+
+#include <IndustryStandard/Acpi50.h>
+
+#define EFI_ACPI_OEM_ID                       {'M','C','R','S','F','T'} // OEMID 6 bytes long
+#define EFI_ACPI_OEM_TABLE_ID                 SIGNATURE_64 ('R','P','I','3','E','D','K','2') // OEM table id 8 bytes long
+#define EFI_ACPI_OEM_REVISION                 0x02000820
+#define EFI_ACPI_CREATOR_ID                   SIGNATURE_32 ('R','P','I','3')
+#define EFI_ACPI_CREATOR_REVISION             0x00000097
+
+#define EFI_ACPI_VENDOR_ID                    SIGNATURE_32 ('M','S','F','T')
+#define EFI_ACPI_CSRT_REVISION                0x00000005
+#define EFI_ACPI_CSRT_DEVICE_ID_DMA           0x00000009 // Fixed id
+#define EFI_ACPI_CSRT_RESOURCE_ID_IN_DMA_GRP  0x0 // Count up from 0
+
+#define RPI3_DMA_CHANNEL_COUNT                10 // All 10 DMA channels are listed, including the reserved ones
+#define RPI3_DMA_USED_CHANNEL_COUNT           5  // Use 5 DMA channels
+
+#define EFI_ACPI_5_0_CSRT_REVISION            0x00000000
+
+typedef enum
+{
+  EFI_ACPI_CSRT_RESOURCE_TYPE_RESERVED,           // 0
+  EFI_ACPI_CSRT_RESOURCE_TYPE_INTERRUPT,          // 1
+  EFI_ACPI_CSRT_RESOURCE_TYPE_TIMER,              // 2
+  EFI_ACPI_CSRT_RESOURCE_TYPE_DMA,                // 3
+  EFI_ACPI_CSRT_RESOURCE_TYPE_CACHE,              // 4
+}
+CSRT_RESOURCE_TYPE;
+
+typedef enum
+{
+  EFI_ACPI_CSRT_RESOURCE_SUBTYPE_DMA_CHANNEL,     // 0
+  EFI_ACPI_CSRT_RESOURCE_SUBTYPE_DMA_CONTROLLER   // 1
+}
+CSRT_DMA_SUBTYPE;
+
+//------------------------------------------------------------------------
+// CSRT Resource Group header 24 bytes long
+//------------------------------------------------------------------------
+typedef struct
+{
+  UINT32 Length;                  // Length
+  UINT32 VendorID;                // 4 bytes
+  UINT32 SubVendorId;             // 4 bytes
+  UINT16 DeviceId;                // 2 bytes
+  UINT16 SubdeviceId;             // 2 bytes
+  UINT16 Revision;                // 2 bytes
+  UINT16 Reserved;                // 2 bytes
+  UINT32 SharedInfoLength;        // 4 bytes
+} EFI_ACPI_5_0_CSRT_RESOURCE_GROUP_HEADER;
+
+//------------------------------------------------------------------------
+// CSRT Resource Descriptor 12 bytes total
+//------------------------------------------------------------------------
+typedef struct
+{
+  UINT32 Length;                  // 4 bytes
+  UINT16 ResourceType;            // 2 bytes
+  UINT16 ResourceSubType;         // 2 bytes
+  UINT32 UID;                     // 4 bytes
+} EFI_ACPI_5_0_CSRT_RESOURCE_DESCRIPTOR_HEADER;
+
+#endif // __ACPITABLES_H__
diff --git a/Platform/RaspberryPi/RPi3/AcpiTables/AcpiTables.inf b/Platform/RaspberryPi/RPi3/AcpiTables/AcpiTables.inf
new file mode 100644
index 000000000000..62de9c072052
--- /dev/null
+++ b/Platform/RaspberryPi/RPi3/AcpiTables/AcpiTables.inf
@@ -0,0 +1,46 @@
+#/** @file
+#
+#  ACPI table data and ASL sources required to boot the platform.
+#
+#  Copyright (c) 2017, Andrey Warkentin <andrey.warkentin@gmail.com>
+#  Copyright (c) Microsoft Corporation. All rights reserved.
+#
+#  This program and the accompanying materials
+#  are licensed and made available under the terms and conditions of the BSD License
+#  which accompanies this distribution.  The full text of the license may be found at
+#  http://opensource.org/licenses/bsd-license.php
+#
+#  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+#  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+#
+#**/
+
+[Defines]
+  INF_VERSION                    = 0x0001001A
+  BASE_NAME                      = AcpiTables
+  FILE_GUID                      = 7E374E25-8E01-4FEE-87F2-390C23C606CD
+  MODULE_TYPE                    = USER_DEFINED
+  VERSION_STRING                 = 1.0
+
+#
+# The following information is for reference only and not required by the build tools.
+#
+#  VALID_ARCHITECTURES           = AARCH64
+#
+
+[Sources]
+  AcpiTables.h
+  Madt.aslc
+  Fadt.aslc
+  Dbg2.aslc
+  Gtdt.aslc
+  Dsdt.asl
+  Csrt.aslc
+  Spcr.asl
+
+[Packages]
+  MdePkg/MdePkg.dec
+  EmbeddedPkg/EmbeddedPkg.dec
+
+[FixedPcd]
+  gEmbeddedTokenSpaceGuid.PcdInterruptBaseAddress
diff --git a/Platform/RaspberryPi/RPi3/AcpiTables/Csrt.aslc b/Platform/RaspberryPi/RPi3/AcpiTables/Csrt.aslc
new file mode 100644
index 000000000000..1b593bd29c10
--- /dev/null
+++ b/Platform/RaspberryPi/RPi3/AcpiTables/Csrt.aslc
@@ -0,0 +1,332 @@
+/** @file
+ *
+ *  Core System Resource Table (CSRT)
+ *
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *
+ *  This program and the accompanying materials
+ *  are licensed and made available under the terms and conditions of the BSD License
+ *  which accompanies this distribution.  The full text of the license may be found at
+ *  http://opensource.org/licenses/bsd-license.php
+ *
+ *  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+ *  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+ *
+ **/
+
+#include "AcpiTables.h"
+
+#define DMA_MAX_REQ_LINES 32
+
+#pragma pack (push, 1)
+
+//------------------------------------------------------------------------
+// DMA Controller Vendor Data for RPi3
+//------------------------------------------------------------------------
+typedef struct
+{
+  UINT32 Length;
+  UINT32 Type;
+  UINT64 ChannelsBaseAddress;
+  UINT32 ChannelsBaseSize;
+  UINT64 ControllerBaseAddress;
+  UINT32 ControllerBaseSize;
+  UINT32 ChannelCount;
+  UINT32 ControllerInterrupt;
+  UINT32 MinimumRequestLine;
+  UINT32 MaximumRequestLine;
+  BOOLEAN CacheCoherent;
+} DMA_CONTROLLER_VENDOR_DATA;
+
+//------------------------------------------------------------------------
+// DMA Controller on RPi3
+//------------------------------------------------------------------------
+typedef struct
+{
+  EFI_ACPI_5_0_CSRT_RESOURCE_DESCRIPTOR_HEADER DmaControllerHeader;
+  DMA_CONTROLLER_VENDOR_DATA ControllerVendorData;
+} RD_DMA_CONTROLLER;
+
+//------------------------------------------------------------------------
+// DMA Channel Vendor Data for RPi3
+//------------------------------------------------------------------------
+typedef struct
+{
+  UINT32 ChannelNumber;
+  UINT32 ChannelInterrupt;
+  UINT16 IsReservedChannel;
+  UINT16 NoSrcNoDestAddrIncr;
+} DMA_CHANNEL_VENDOR_DATA;
+
+//------------------------------------------------------------------------
+// DMA Channel on RPi3
+//------------------------------------------------------------------------
+typedef struct
+{
+  EFI_ACPI_5_0_CSRT_RESOURCE_DESCRIPTOR_HEADER DmaChannelHeader;
+  DMA_CHANNEL_VENDOR_DATA ChannelVendorData;
+} RD_DMA_CHANNEL;
+
+//------------------------------------------------------------------------
+// DMA Resource Group on RPi3
+//------------------------------------------------------------------------
+
+typedef struct
+{
+  EFI_ACPI_5_0_CSRT_RESOURCE_GROUP_HEADER ResGroupHeader;
+  RD_DMA_CONTROLLER DmaController;
+  RD_DMA_CHANNEL DmaChannels[RPI3_DMA_CHANNEL_COUNT];
+} RG_DMA;
+
+//----------------------------------------------------------------------------
+// CSRT table structure for RPi3 platform - current revision only includes DMA
+//----------------------------------------------------------------------------
+typedef struct
+{
+// Standard ACPI Header
+  EFI_ACPI_DESCRIPTION_HEADER CsrtHeader;
+
+// DMA Resource Group
+  RG_DMA DmaResourceGroup;
+
+} EFI_ACPI_5_0_CSRT_TABLE;
+
+EFI_ACPI_5_0_CSRT_TABLE Csrt =
+{
+  //------------------------------------------------------------------------
+  // ACPI Table Header
+  //------------------------------------------------------------------------
+  {
+    EFI_ACPI_5_0_CORE_SYSTEM_RESOURCE_TABLE_SIGNATURE,       // Signature "CSRT"
+    sizeof (EFI_ACPI_DESCRIPTION_HEADER) + sizeof (RG_DMA),  // Length
+    EFI_ACPI_5_0_CSRT_REVISION,     // Revision
+    0x00,                           // Checksum calculated at runtime.
+    EFI_ACPI_OEM_ID,                // OEMID is a 6 bytes long field "BC2836"
+    EFI_ACPI_OEM_TABLE_ID,          // OEM table identification(8 bytes long) "RPI3EDK2"
+    EFI_ACPI_OEM_REVISION,          // OEM revision number.
+    EFI_ACPI_CREATOR_ID,            // ASL compiler vendor ID.
+    EFI_ACPI_CREATOR_REVISION       // ASL compiler revision number.
+  },
+
+  //------------------------------------------------------------------------
+  // DMA Resource Group
+  //------------------------------------------------------------------------
+  {
+
+    //------------------------------------------------------------------------
+    // DMA Resource Group Header
+    //------------------------------------------------------------------------
+    {
+      sizeof (RG_DMA),                // Resource Group Length
+      EFI_ACPI_VENDOR_ID,             // VendorId
+      0,                              // SubvendorId
+      EFI_ACPI_CSRT_DEVICE_ID_DMA,    // DeviceId 9
+      0,                              // SubdeviceId
+      0,                              // Revision
+      0,                              // Reserved
+      0                               // SharedInfoLength
+    },
+
+    //-------------------------------------------------------------------------------
+    // Resource Descriptor - DMA Controller
+    //-------------------------------------------------------------------------------
+    {
+      {
+        sizeof (RD_DMA_CONTROLLER),                    // Length of this Resource Descriptor
+        EFI_ACPI_CSRT_RESOURCE_TYPE_DMA,               // Type for this resource 3=DMA
+        EFI_ACPI_CSRT_RESOURCE_SUBTYPE_DMA_CONTROLLER, // Subtype for this resource 1=DMA Controller
+        EFI_ACPI_CSRT_RESOURCE_ID_IN_DMA_GRP + 0,        // ResourceId - 1st DMA controller
+      },
+      {
+        sizeof (DMA_CONTROLLER_VENDOR_DATA),  // Controller vendor data here
+        1,
+        0x3F007000,                   // Base address for channels
+        RPI3_DMA_CHANNEL_COUNT * 0x100, // Base size = Number of channels x 0x100 size for each channel
+        0x3F007FE0,                   // Base address for controller
+        8,                            // Base size = two registers
+        RPI3_DMA_USED_CHANNEL_COUNT,
+        0,                            // cannot use controller interrupt
+        0,                            // Minimum Request Line
+        DMA_MAX_REQ_LINES - 1,          // Maximum Request Line
+        FALSE,
+      },
+    },
+
+    //------------------------------------------------------------------------
+    // Resource Descriptor(s) - DMA Channels 0 to n-1
+    //------------------------------------------------------------------------
+    {
+
+      // Channel 0
+      {
+        {
+          sizeof (RD_DMA_CHANNEL),                    // Length of this Resource Descriptor
+          EFI_ACPI_CSRT_RESOURCE_TYPE_DMA,            // Type for this resource 3=DMA
+          EFI_ACPI_CSRT_RESOURCE_SUBTYPE_DMA_CHANNEL, // Subtype for this resource 0=DMA Channel
+          EFI_ACPI_CSRT_RESOURCE_ID_IN_DMA_GRP + 1,     // ResourceId
+        },
+        {
+          0,        // Channel vendor data here
+          0x30,     // 16+32 dma_int[0]
+          0,
+          0
+        },
+      },
+
+      // Channel 1 reserved
+      {
+        {
+          sizeof (RD_DMA_CHANNEL),
+          EFI_ACPI_CSRT_RESOURCE_TYPE_DMA,
+          EFI_ACPI_CSRT_RESOURCE_SUBTYPE_DMA_CHANNEL,
+          EFI_ACPI_CSRT_RESOURCE_ID_IN_DMA_GRP + 2,     // ResourceId
+        },
+        {
+          1,        // Channel vendor data here
+          0x31,     // 17+32 dma_int[1]
+          1,
+          0
+        },
+      },
+
+      // Channel 2 - VC4 use only
+      {
+        {
+          sizeof (RD_DMA_CHANNEL),
+          EFI_ACPI_CSRT_RESOURCE_TYPE_DMA,
+          EFI_ACPI_CSRT_RESOURCE_SUBTYPE_DMA_CHANNEL,
+          EFI_ACPI_CSRT_RESOURCE_ID_IN_DMA_GRP + 3,        // ResourceId
+        },
+        {
+          2,        // Channel vendor data here
+          0x32,     // 18+32 dma_int[2]
+          1,
+          0
+        },
+      },
+
+      // Channel 3 - VC4 use only
+      {
+        {
+          sizeof (RD_DMA_CHANNEL),
+          EFI_ACPI_CSRT_RESOURCE_TYPE_DMA,
+          EFI_ACPI_CSRT_RESOURCE_SUBTYPE_DMA_CHANNEL,
+          EFI_ACPI_CSRT_RESOURCE_ID_IN_DMA_GRP + 4,
+        },
+        {
+          3,        // Channel vendor data here
+          0x33,     // 19+32 dma_int[3]
+          1,
+          0
+        },
+      },
+
+      // channel 4
+      {
+        {
+          sizeof (RD_DMA_CHANNEL),
+          EFI_ACPI_CSRT_RESOURCE_TYPE_DMA,
+          EFI_ACPI_CSRT_RESOURCE_SUBTYPE_DMA_CHANNEL,
+          EFI_ACPI_CSRT_RESOURCE_ID_IN_DMA_GRP + 5,
+        },
+        {
+          4,        // Channel vendor data here
+          0x34,     // 20+32 dma_int[4]
+          0,
+          1         // SD host controller candidate
+        },
+      },
+
+      // Channel 5
+      {
+        {
+          sizeof (RD_DMA_CHANNEL),
+          EFI_ACPI_CSRT_RESOURCE_TYPE_DMA,
+          EFI_ACPI_CSRT_RESOURCE_SUBTYPE_DMA_CHANNEL,
+          EFI_ACPI_CSRT_RESOURCE_ID_IN_DMA_GRP + 6,
+        },
+        {
+          5,        // Channel vendor data here
+          0x35,     // 21+32 dma_int[5]
+          0,
+          0
+        },
+      },
+
+      // Channel 6 is reserved
+      {
+        {
+          sizeof (RD_DMA_CHANNEL),
+          EFI_ACPI_CSRT_RESOURCE_TYPE_DMA,
+          EFI_ACPI_CSRT_RESOURCE_SUBTYPE_DMA_CHANNEL,
+          EFI_ACPI_CSRT_RESOURCE_ID_IN_DMA_GRP + 7,
+        },
+        {
+          6,        // Channel vendor data here
+          0x36,     // 22+32 dma_int[6]
+          1,
+          0
+        },
+      },
+
+      // Channel 7 is reserved
+      {
+        {
+          sizeof (RD_DMA_CHANNEL),
+          EFI_ACPI_CSRT_RESOURCE_TYPE_DMA,
+          EFI_ACPI_CSRT_RESOURCE_SUBTYPE_DMA_CHANNEL,
+          EFI_ACPI_CSRT_RESOURCE_ID_IN_DMA_GRP + 8,
+        },
+        {
+          7,        // Channel vendor data here
+          0x37,     // 23+32 dma_int[7]
+          1,
+          0
+        },
+      },
+
+      // Channel 8
+      {
+        {
+          sizeof (RD_DMA_CHANNEL),
+          EFI_ACPI_CSRT_RESOURCE_TYPE_DMA,
+          EFI_ACPI_CSRT_RESOURCE_SUBTYPE_DMA_CHANNEL,
+          EFI_ACPI_CSRT_RESOURCE_ID_IN_DMA_GRP + 9,
+        },
+        {
+          8,        // Channel vendor data here
+          0x38,     // 24+32 dma_int[8]
+          0,
+          0
+        },
+      },
+
+      // Channel 9
+      {
+        {
+          sizeof (RD_DMA_CHANNEL),
+          EFI_ACPI_CSRT_RESOURCE_TYPE_DMA,
+          EFI_ACPI_CSRT_RESOURCE_SUBTYPE_DMA_CHANNEL,
+          EFI_ACPI_CSRT_RESOURCE_ID_IN_DMA_GRP + 10,
+        },
+        {
+          9,        // channel vendor data here
+          0x39,     // 25+32 dma_int[9]
+          0,
+          0
+        },
+      }
+
+    } // End DMA Channels 0 to 14
+
+  } // End DMA Resource group
+
+};
+
+#pragma pack(pop)
+
+//
+// Reference the table being generated to prevent the optimizer from removing the
+// data structure from the executable
+//
+VOID* CONST ReferenceAcpiTable = &Csrt;
diff --git a/Platform/RaspberryPi/RPi3/AcpiTables/Dbg2.aslc b/Platform/RaspberryPi/RPi3/AcpiTables/Dbg2.aslc
new file mode 100644
index 000000000000..dc2d2dfb2881
--- /dev/null
+++ b/Platform/RaspberryPi/RPi3/AcpiTables/Dbg2.aslc
@@ -0,0 +1,34 @@
+/** @file
+ *
+ *  Debug Port Table (DBG2)
+ *
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *
+ *  This program and the accompanying materials
+ *  are licensed and made available under the terms and conditions of the BSD License
+ *  which accompanies this distribution.  The full text of the license may be found at
+ *  http://opensource.org/licenses/bsd-license.php
+ *
+ *  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+ *  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+ *
+ **/
+
+UINT8 Dbg2[92] = {
+  0x44, 0x42, 0x47, 0x32, 0x5C, 0x00, 0x00, 0x00, 0x00, 0x00,
+  0x4D, 0x53, 0x46, 0x54, 0x20, 0x20, 0x45, 0x44, 0x4B, 0x32,
+  0x20, 0x20, 0x20, 0x20, 0x01, 0x00, 0x00, 0x00, 0x4D, 0x53,
+  0x46, 0x54, 0x01, 0x00, 0x00, 0x00, 0x2C, 0x00, 0x00, 0x00,
+  0x01, 0x00, 0x00, 0x00, 0x00, 0x30, 0x00, 0x01, 0x0A, 0x00,
+  0x26, 0x00, 0x00, 0x00, 0x30, 0x00, 0x00, 0x80, 0x10, 0x00,
+  0x00, 0x00, 0x16, 0x00, 0x22, 0x00, 0x00, 0x20, 0x00, 0x10,
+  0x00, 0x50, 0x21, 0x3F, 0x00, 0x00, 0x00, 0x00, 0x6C, 0x00,
+  0x00, 0x00, '\\',  '_',  'S',  'B',  '.',  'U',  'R',  'T',
+  'M', 0x00,
+};
+
+//
+// Reference the table being generated to prevent the optimizer from removing the
+// data structure from the executable
+//
+VOID* CONST ReferenceAcpiTable = &Dbg2;
diff --git a/Platform/RaspberryPi/RPi3/AcpiTables/Dsdt.asl b/Platform/RaspberryPi/RPi3/AcpiTables/Dsdt.asl
new file mode 100644
index 000000000000..be2c4db7ccc9
--- /dev/null
+++ b/Platform/RaspberryPi/RPi3/AcpiTables/Dsdt.asl
@@ -0,0 +1,511 @@
+/** @file
+ *
+ *  Differentiated System Definition Table (DSDT)
+ *
+ *  Copyright (c) 2018, Andrey Warkentin <andrey.warkentin@gmail.com>
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *
+ *  This program and the accompanying materials
+ *  are licensed and made available under the terms and conditions of the BSD License
+ *  which accompanies this distribution.  The full text of the license may be found at
+ *  http://opensource.org/licenses/bsd-license.php
+ *
+ *  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+ *  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+ *
+ **/
+
+#define BCM_ALT0 0x4
+#define BCM_ALT1 0x5
+#define BCM_ALT2 0x6
+#define BCM_ALT3 0x7
+#define BCM_ALT4 0x3
+#define BCM_ALT5 0x2
+
+DefinitionBlock ("Dsdt.aml", "DSDT", 5, "MSFT", "EDK2", 2)
+{
+  Scope (\_SB_)
+  {
+    include ("Sdhc.asl")
+    include ("Pep.asl")
+
+    Device (CPU0)
+    {
+      Name (_HID, "ACPI0007")
+      Name (_UID, 0x0)
+      Method (_STA)
+      {
+        Return (0xf)
+      }
+    }
+
+    Device (CPU1)
+    {
+      Name (_HID, "ACPI0007")
+      Name (_UID, 0x1)
+      Method (_STA)
+      {
+        Return (0xf)
+      }
+    }
+
+    Device (CPU2)
+    {
+      Name (_HID, "ACPI0007")
+      Name (_UID, 0x2)
+      Method (_STA)
+      {
+        Return (0xf)
+      }
+    }
+
+    Device (CPU3)
+    {
+      Name (_HID, "ACPI0007")
+      Name (_UID, 0x3)
+      Method (_STA)
+      {
+        Return (0xf)
+      }
+    }
+
+    // DWC OTG Controller
+    Device (USB0)
+    {
+      Name (_HID, "BCM2848")
+      Name (_CID, Package() { "DWC_OTG", "DWC2_OTG"})
+      Name (_UID, 0x0)
+      Name (_CCA, 0x0)
+      Method (_STA)
+      {
+        Return (0xf)
+      }
+      Method (_CRS, 0x0, Serialized)
+      {
+        Name (RBUF, ResourceTemplate ()
+        {
+          MEMORY32FIXED(ReadWrite, 0x3F980000, 0x10000,)
+          Interrupt(ResourceConsumer, Level, ActiveHigh, Exclusive) { 0x29 }
+        })
+        Return(RBUF)
+      }
+    }
+
+    // Video Core 4 GPU
+    Device (GPU0)
+    {
+      Name (_HID, "BCM2850")
+      Name (_CID, "VC4")
+      Name (_UID, 0x0)
+      Name (_CCA, 0x0)
+      Method (_STA)
+      {
+        Return(0xf)
+      }
+      Method (_CRS, 0x0, Serialized)
+      {
+        Name (RBUF, ResourceTemplate ()
+        {
+          // Memory and interrupt for the GPU
+          MEMORY32FIXED(ReadWrite, 0x3FC00000, 0x1000,)
+          Interrupt (ResourceConsumer, Level, ActiveHigh, Exclusive) { 0x2A }
+
+          // HVS - Hardware Video Scalar
+          MEMORY32FIXED (ReadWrite, 0x3F400000, 0x6000,)
+          // The HVS interrupt is reserved by the VPU
+          // Interrupt (ResourceConsumer, Level, ActiveHigh, Exclusive) { 0x41 }
+
+          // PixelValve0 - DSI0 or DPI
+          // MEMORY32FIXED (ReadWrite, 0x3F206000, 0x100,)
+          // Interrupt (ResourceConsumer, Level, ActiveHigh, Exclusive) { 0x4D }
+
+          // PixelValve1 - DS1 or SMI
+          // MEMORY32FIXED (ReadWrite, 0x73F207000, 0x100,)
+          // Interrupt (ResourceConsumer, Level, ActiveHigh, Exclusive) { 0x4E }
+
+          // PixelValve2 - HDMI output - connected to HVS display FIFO 1
+          MEMORY32FIXED (ReadWrite, 0x3F807000, 0x100,)
+          Interrupt (ResourceConsumer, Level, ActiveHigh, Exclusive) { 0x4A }
+
+          // HDMI registers
+          MEMORY32FIXED (ReadWrite, 0x3F902000, 0x600,)   // HDMI registers
+          MEMORY32FIXED (ReadWrite, 0x3F808000, 0x100,)   // HD registers
+          // hdmi_int[0]
+          // Interrupt (ResourceConsumer, Level, ActiveHigh, Exclusive) { 0x48 }
+          // hdmi_int[1]
+          // Interrupt (ResourceConsumer, Level, ActiveHigh, Exclusive) { 0x49 }
+
+          // HDMI DDC connection
+          I2CSerialBus (0x50,, 100000,, "\\_SB.I2C2",,,,)  // EDID
+          I2CSerialBus (0x30,, 100000,, "\\_SB.I2C2",,,,)  // E-DDC Segment Pointer
+        })
+        Return(RBUF)
+      }
+
+      // GPU Power Management Component Data
+      // Reference : https://github.com/Microsoft/graphics-driver-samples/wiki/Install-Driver-in-a-Windows-VM
+      Method (PMCD, 0, Serialized)
+      {
+        Name (RBUF, Package ()
+        {
+          1,                  // Version
+          1,                  // Number of graphics power components
+          Package ()          // Power components package
+          {
+            Package ()        // GPU component package
+            {
+              0,              // Component Index
+              0,              // DXGK_POWER_COMPONENT_MAPPING.ComponentType (0 = DXGK_POWER_COMPONENT_ENGINE)
+              0,              // DXGK_POWER_COMPONENT_MAPPING.NodeIndex
+
+              Buffer ()       // DXGK_POWER_RUNTIME_COMPONENT.ComponentGuid
+              {               // 9B2D1E26-1575-4747-8FC0-B9EB4BAA2D2B
+                0x26, 0x1E, 0x2D, 0x9B, 0x75, 0x15, 0x47, 0x47,
+                0x8f, 0xc0, 0xb9, 0xeb, 0x4b, 0xaa, 0x2d, 0x2b
+              },
+
+              "VC4_Engine_00",// DXGK_POWER_RUNTIME_COMPONENT.ComponentName
+              2,              // DXGK_POWER_RUNTIME_COMPONENT.StateCount
+
+              Package ()      // DXGK_POWER_RUNTIME_COMPONENT.States[] package
+              {
+                Package ()   // F0
+                {
+                  0,         // DXGK_POWER_RUNTIME_STATE.TransitionLatency
+                  0,         // DXGK_POWER_RUNTIME_STATE.ResidencyRequirement
+                  1210000,   // DXGK_POWER_RUNTIME_STATE.NominalPower (microwatt)
+                },
+
+                Package ()   // F1 - Placeholder
+                {
+                  10000,     // DXGK_POWER_RUNTIME_STATE.TransitionLatency
+                  10000,     // DXGK_POWER_RUNTIME_STATE.ResidencyRequirement
+                  4,         // DXGK_POWER_RUNTIME_STATE.NominalPower
+                },
+              }
+            }
+          }
+        })
+        Return (RBUF)
+      }
+    }
+
+    // PiQ Mailbox Driver
+    Device (RPIQ)
+    {
+      Name (_HID, "BCM2849")
+      Name (_CID, "RPIQ")
+      Name (_UID, 0)
+      Name (_CCA, 0x0)
+      Method (_STA)
+      {
+        Return (0xf)
+      }
+      Method (_CRS, 0x0, Serialized)
+      {
+        Name (RBUF, ResourceTemplate ()
+        {
+          Memory32Fixed (ReadWrite, 0x3F00B880, 0x00000024,)
+          Interrupt(ResourceConsumer, Level, ActiveHigh, Exclusive) { 0x61 }
+        })
+        Return (RBUF)
+      }
+    }
+
+    // VCHIQ Driver
+    Device (VCIQ)
+    {
+      Name (_HID, "BCM2835")
+      Name (_CID, "VCIQ")
+      Name (_UID, 0)
+      Name (_CCA, 0x0)
+      Name (_DEP, Package() { \_SB.RPIQ })
+      Method (_STA)
+      {
+         Return (0xf)
+      }
+      Method (_CRS, 0x0, Serialized)
+      {
+        Name (RBUF, ResourceTemplate ()
+        {
+          Memory32Fixed (ReadWrite, 0x3F00B840, 0x00000010,)
+          Interrupt(ResourceConsumer, Level, ActiveHigh, Exclusive) { 0x62 }
+        })
+        Return (RBUF)
+      }
+    }
+
+    // VC Shared Memory Driver
+    Device (VCSM)
+    {
+      Name (_HID, "BCM2856")
+      Name (_CID, "VCSM")
+      Name (_UID, 0)
+      Name (_CCA, 0x0)
+      Name (_DEP, Package() { \_SB.VCIQ })
+      Method (_STA)
+      {
+        Return (0xf)
+      }
+    }
+
+    // Description: GPIO
+    Device (GPI0)
+    {
+      Name (_HID, "BCM2845")
+      Name (_CID, "BCMGPIO")
+      Name (_UID, 0x0)
+      Name (_CCA, 0x0)
+      Method (_STA)
+      {
+        Return(0xf)
+      }
+      Method (_CRS, 0x0, Serialized)
+      {
+        Name (RBUF, ResourceTemplate ()
+        {
+          MEMORY32FIXED (ReadWrite, 0x3F200000, 0xB4, )
+          Interrupt (ResourceConsumer, Level, ActiveHigh, Shared) { 0x51 }
+          Interrupt (ResourceConsumer, Level, ActiveHigh, Shared) { 0x53 }
+        })
+        Return (RBUF)
+      }
+    }
+
+    // Description: I2C
+    Device (I2C1)
+    {
+      Name (_HID, "BCM2841")
+      Name (_CID, "BCMI2C")
+      Name (_UID, 0x1)
+      Name (_CCA, 0x0)
+      Method (_STA)
+      {
+        Return(0xf)
+      }
+      Method (_CRS, 0x0, Serialized)
+      {
+        Name (RBUF, ResourceTemplate ()
+        {
+          Memory32Fixed(ReadWrite, 0x3F804000, 0x20)
+          Interrupt(ResourceConsumer, Level, ActiveHigh, Shared) {0x55}
+
+          //
+          // MsftFunctionConfig is encoded as the VendorLong.
+          //
+          // MsftFunctionConfig (Exclusive, PullUp, BCM_ALT0, "\\_SB.GPI0", 0, ResourceConsumer,) {2, 3}
+          //
+          VendorLong ()      // Length = 0x31
+          {
+            /* 0000 */  0x00, 0x60, 0x44, 0xD5, 0xF3, 0x1F, 0x11, 0x60,  // .`D....`
+            /* 0008 */  0x4A, 0xB8, 0xB0, 0x9C, 0x2D, 0x23, 0x30, 0xDD,  // J...-#0.
+            /* 0010 */  0x2F, 0x8D, 0x1D, 0x00, 0x01, 0x10, 0x00, 0x01,  // /.......
+            /* 0018 */  0x04, 0x00, 0x12, 0x00, 0x00, 0x16, 0x00, 0x20,  // ........
+            /* 0020 */  0x00, 0x00, 0x00, 0x02, 0x00, 0x03, 0x00, 0x5C,  // ........
+            /* 0028 */  0x5F, 0x53, 0x42, 0x2E, 0x47, 0x50, 0x49, 0x30,  // _SB.GPI0
+            /* 0030 */  0x00                                             // .
+          }
+        })
+        Return (RBUF)
+      }
+    }
+
+    // I2C2 is the HDMI DDC connection
+    Device (I2C2)
+    {
+      Name (_HID, "BCM2841")
+      Name (_CID, "BCMI2C")
+      Name (_UID, 0x2)
+      Name (_CCA, 0x0)
+      Method (_STA)
+      {
+        Return (0xf)
+      }
+      Method (_CRS, 0x0, Serialized)
+      {
+        Name (RBUF, ResourceTemplate()
+        {
+          Memory32Fixed (ReadWrite, 0x3F805000, 0x20)
+          Interrupt (ResourceConsumer, Level, ActiveHigh, Shared) {0x55}
+        })
+        Return (RBUF)
+      }
+    }
+
+    // SPI
+    Device (SPI0)
+    {
+      Name (_HID, "BCM2838")
+      Name (_CID, "BCMSPI0")
+      Name (_UID, 0x0)
+      Name (_CCA, 0x0)
+      Method (_STA)
+      {
+        Return (0xf)
+      }
+      Method (_CRS, 0x0, Serialized)
+      {
+        Name (RBUF, ResourceTemplate ()
+        {
+          MEMORY32FIXED (ReadWrite, 0x3F204000, 0x20,)
+          Interrupt(ResourceConsumer, Level, ActiveHigh, Shared) {0x56}
+
+          //
+          // MsftFunctionConfig is encoded as the VendorLong.
+          //
+          // MsftFunctionConfig (Exclusive, PullDown, BCM_ALT0, "\\_SB.GPI0", 0, ResourceConsumer, ) {9, 10, 11} // MISO, MOSI, SCLK
+          VendorLong ()      // Length = 0x33
+          {
+            /* 0000 */  0x00, 0x60, 0x44, 0xD5, 0xF3, 0x1F, 0x11, 0x60,  // .`D....`
+            /* 0008 */  0x4A, 0xB8, 0xB0, 0x9C, 0x2D, 0x23, 0x30, 0xDD,  // J...-#0.
+            /* 0010 */  0x2F, 0x8D, 0x1F, 0x00, 0x01, 0x10, 0x00, 0x02,  // /.......
+            /* 0018 */  0x04, 0x00, 0x12, 0x00, 0x00, 0x18, 0x00, 0x22,  // ......."
+            /* 0020 */  0x00, 0x00, 0x00, 0x09, 0x00, 0x0A, 0x00, 0x0B,  // ........
+            /* 0028 */  0x00, 0x5C, 0x5F, 0x53, 0x42, 0x2E, 0x47, 0x50,  // .\_SB.GP
+            /* 0030 */  0x49, 0x30, 0x00                                 // I0.
+          }
+
+          //
+          // MsftFunctionConfig is encoded as the VendorLong.
+          //
+          // MsftFunctionConfig (Exclusive, PullUp, BCM_ALT0, "\\_SB.GPI0", 0, ResourceConsumer, ) {8}     // CE0
+          VendorLong ()      // Length = 0x2F
+          {
+            /* 0000 */  0x00, 0x60, 0x44, 0xD5, 0xF3, 0x1F, 0x11, 0x60,  // .`D....`
+            /* 0008 */  0x4A, 0xB8, 0xB0, 0x9C, 0x2D, 0x23, 0x30, 0xDD,  // J...-#0.
+            /* 0010 */  0x2F, 0x8D, 0x1B, 0x00, 0x01, 0x10, 0x00, 0x01,  // /.......
+            /* 0018 */  0x04, 0x00, 0x12, 0x00, 0x00, 0x14, 0x00, 0x1E,  // ........
+            /* 0020 */  0x00, 0x00, 0x00, 0x08, 0x00, 0x5C, 0x5F, 0x53,  // .....\_S
+            /* 0028 */  0x42, 0x2E, 0x47, 0x50, 0x49, 0x30, 0x00         // B.GPI0.
+          }
+
+          //
+          // MsftFunctionConfig is encoded as the VendorLong.
+          //
+          // MsftFunctionConfig (Exclusive, PullUp, BCM_ALT0, "\\_SB.GPI0", 0, ResourceConsumer, ) {7}     // CE1
+          VendorLong ()      // Length = 0x2F
+          {
+            /* 0000 */  0x00, 0x60, 0x44, 0xD5, 0xF3, 0x1F, 0x11, 0x60,  // .`D....`
+            /* 0008 */  0x4A, 0xB8, 0xB0, 0x9C, 0x2D, 0x23, 0x30, 0xDD,  // J...-#0.
+            /* 0010 */  0x2F, 0x8D, 0x1B, 0x00, 0x01, 0x10, 0x00, 0x01,  // /.......
+            /* 0018 */  0x04, 0x00, 0x12, 0x00, 0x00, 0x14, 0x00, 0x1E,  // ........
+            /* 0020 */  0x00, 0x00, 0x00, 0x07, 0x00, 0x5C, 0x5F, 0x53,  // .....\_S
+            /* 0028 */  0x42, 0x2E, 0x47, 0x50, 0x49, 0x30, 0x00         // B.GPI0.
+          }
+        })
+        Return (RBUF)
+      }
+    }
+
+    Device (SPI1)
+    {
+      Name (_HID, "BCM2839")
+      Name (_CID, "BCMAUXSPI")
+      Name (_UID, 0x1)
+      Name (_CCA, 0x0)
+      Name (_DEP, Package() { \_SB.RPIQ })
+      Method (_STA)
+      {
+        Return (0xf)
+      }
+      Method (_CRS, 0x0, Serialized)
+      {
+        Name (RBUF, ResourceTemplate ()
+        {
+          MEMORY32FIXED (ReadWrite, 0x3F215080, 0x40,)
+          Interrupt (ResourceConsumer, Level, ActiveHigh, Shared,) {0x3D}
+
+          //
+          // MsftFunctionConfig is encoded as the VendorLong.
+          //
+          // MsftFunctionConfig(Exclusive, PullDown, BCM_ALT4, "\\_SB.GPI0", 0, ResourceConsumer, ) {19, 20, 21} // MISO, MOSI, SCLK
+          VendorLong ()      // Length = 0x33
+          {
+            /* 0000 */  0x00, 0x60, 0x44, 0xD5, 0xF3, 0x1F, 0x11, 0x60,  // .`D....`
+            /* 0008 */  0x4A, 0xB8, 0xB0, 0x9C, 0x2D, 0x23, 0x30, 0xDD,  // J...-#0.
+            /* 0010 */  0x2F, 0x8D, 0x1F, 0x00, 0x01, 0x10, 0x00, 0x02,  // /.......
+            /* 0018 */  0x03, 0x00, 0x12, 0x00, 0x00, 0x18, 0x00, 0x22,  // ......."
+            /* 0020 */  0x00, 0x00, 0x00, 0x13, 0x00, 0x14, 0x00, 0x15,  // ........
+            /* 0028 */  0x00, 0x5C, 0x5F, 0x53, 0x42, 0x2E, 0x47, 0x50,  // .\_SB.GP
+            /* 0030 */  0x49, 0x30, 0x00                                 // I0.
+          }
+
+          //
+          // MsftFunctionConfig is encoded as the VendorLong.
+          //
+          // MsftFunctionConfig(Exclusive, PullDown, BCM_ALT4, "\\_SB.GPI0", 0, ResourceConsumer, ) {16} // CE2
+          VendorLong ()      // Length = 0x2F
+          {
+            /* 0000 */  0x00, 0x60, 0x44, 0xD5, 0xF3, 0x1F, 0x11, 0x60,  // .`D....`
+            /* 0008 */  0x4A, 0xB8, 0xB0, 0x9C, 0x2D, 0x23, 0x30, 0xDD,  // J...-#0.
+            /* 0010 */  0x2F, 0x8D, 0x1B, 0x00, 0x01, 0x10, 0x00, 0x02,  // /.......
+            /* 0018 */  0x03, 0x00, 0x12, 0x00, 0x00, 0x14, 0x00, 0x1E,  // ........
+            /* 0020 */  0x00, 0x00, 0x00, 0x10, 0x00, 0x5C, 0x5F, 0x53,  // .....\_S
+            /* 0028 */  0x42, 0x2E, 0x47, 0x50, 0x49, 0x30, 0x00         // B.GPI0.
+          }
+        })
+        Return (RBUF)
+      }
+    }
+
+    // SPI2 has no pins on GPIO header
+    // Device (SPI2)
+    // {
+    //   Name (_HID, "BCM2839")
+    //   Name (_CID, "BCMAUXSPI")
+    //   Name (_UID, 0x2)
+    //   Name (_CCA, 0x0)
+    //   Name (_DEP, Package() { \_SB.RPIQ })
+    //   Method (_STA)
+    //   {
+    //     Return (0xf)     // Disabled
+    //   }
+    //   Method (_CRS, 0x0, Serialized)
+    //   {
+    //     Name (RBUF, ResourceTemplate ()
+    //     {
+    //       MEMORY32FIXED (ReadWrite, 0x3F2150C0, 0x40,)
+    //       Interrupt (ResourceConsumer, Level, ActiveHigh, Shared,) {0x3D}
+    //     })
+    //     Return (RBUF)
+    //   }
+    // }
+
+    // PWM Driver
+    Device (PWM0)
+    {
+      Name (_HID, "BCM2844")
+      Name (_CID, "BCM2844")
+      Name (_UID, 0)
+      Name (_CCA, 0x0)
+      Method (_STA)
+      {
+        Return (0xf)
+      }
+      Method (_CRS, 0x0, Serialized)
+      {
+        Name (RBUF, ResourceTemplate ()
+        {
+          // DMA channel 11 control
+          Memory32Fixed (ReadWrite, 0x3F007B00, 0x00000100,)
+          // PWM control
+          Memory32Fixed (ReadWrite, 0x3F20C000, 0x00000028,)
+          // PWM control bus
+          Memory32Fixed (ReadWrite, 0x7E20C000, 0x00000028,)
+          // PWM control uncached
+          Memory32Fixed (ReadWrite, 0xFF20C000, 0x00000028,)
+          // PWM clock control
+          Memory32Fixed (ReadWrite, 0x3F1010A0, 0x00000008,)
+          // Interrupt DMA channel 11
+          Interrupt (ResourceConsumer, Level, ActiveHigh, Exclusive) { 0x3B }
+          // DMA channel 11, DREQ 5 for PWM
+          FixedDMA (5, 11, Width32Bit, )
+        })
+        Return (RBUF)
+      }
+    }
+
+    include ("Uart.asl")
+    include ("Rhpx.asl")
+  }
+}
diff --git a/Platform/RaspberryPi/RPi3/AcpiTables/Fadt.aslc b/Platform/RaspberryPi/RPi3/AcpiTables/Fadt.aslc
new file mode 100644
index 000000000000..eb1873993c7f
--- /dev/null
+++ b/Platform/RaspberryPi/RPi3/AcpiTables/Fadt.aslc
@@ -0,0 +1,52 @@
+/** @file
+ *
+ *  Fixed ACPI Description Table (FADT)
+ *
+ *  Copyright (c) 2018, Andrey Warkentin <andrey.warkentin@gmail.com>
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *
+ *  This program and the accompanying materials
+ *  are licensed and made available under the terms and conditions of the BSD License
+ *  which accompanies this distribution.  The full text of the license may be found at
+ *  http://opensource.org/licenses/bsd-license.php
+ *
+ *  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+ *  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+ *
+ **/
+
+UINT8 Fadt[268] = {
+  0x46, 0x41, 0x43, 0x50, 0x0C, 0x01, 0x00, 0x00, 0x05, 0x00, /*   0 */
+  0x42, 0x43, 0x32, 0x38, 0x33, 0x36, 0x45, 0x44, 0x4B, 0x32, /*  10 */
+  0x20, 0x20, 0x20, 0x20, 0x01, 0x00, 0x00, 0x00, 0x4D, 0x53, /*  20 */
+  0x46, 0x54, 0x01, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /*  30 */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x08, 0x00, 0x00, 0x00, 0x00, /*  40 */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /*  50 */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /*  60 */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /*  70 */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /*  80 */
+  0x00, 0x04, 0x00, 0x00, 0x00, 0xE3, 0x00, 0x00, 0x00, 0x00, /*  90 */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x3C, /* 100 */
+  0x00, 0x00, 0x21, 0x00, 0x10, 0x00, 0x00, 0x00, 0x00, 0x00, /* 110 */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x01, /* 120 */
+  0x00, 0x01, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 130 */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 140 */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 150 */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 160 */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 170 */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 180 */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 190 */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 200 */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 210 */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 220 */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 230 */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 240 */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 250 */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00              /* 268 */
+};
+
+//
+// Reference the table being generated to prevent the optimizer from removing the
+// data structure from the executable
+//
+VOID* CONST ReferenceAcpiTable = &Fadt;
diff --git a/Platform/RaspberryPi/RPi3/AcpiTables/Gtdt.aslc b/Platform/RaspberryPi/RPi3/AcpiTables/Gtdt.aslc
new file mode 100644
index 000000000000..611eed2881e0
--- /dev/null
+++ b/Platform/RaspberryPi/RPi3/AcpiTables/Gtdt.aslc
@@ -0,0 +1,33 @@
+/** @file
+ *
+ *  Generic Timer Description Table (GTDT)
+ *  Automatically generated by AutoAcpi
+ *
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *
+ *  This program and the accompanying materials
+ *  are licensed and made available under the terms and conditions of the BSD License
+ *  which accompanies this distribution.  The full text of the license may be found at
+ *  http://opensource.org/licenses/bsd-license.php
+ *
+ *  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+ *  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+ *
+ **/
+
+UINT8 Gtdt[80] = {
+  0x47, 0x54, 0x44, 0x54, 0x50, 0x00, 0x00, 0x00, 0x01, 0x00,
+  0x4D, 0x53, 0x46, 0x54, 0x20, 0x20, 0x45, 0x44, 0x4B, 0x32,
+  0x20, 0x20, 0x20, 0x20, 0x01, 0x00, 0x00, 0x00, 0x4D, 0x53,
+  0x46, 0x54, 0x01, 0x00, 0x00, 0x00, 0x1C, 0x00, 0x00, 0x40,
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x01, 0x00, 0x00, 0x00,
+  0x00, 0x00, 0x00, 0x00, 0x03, 0x00, 0x00, 0x00, 0x00, 0x00,
+  0x00, 0x00, 0x02, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00
+};
+
+//
+// Reference the table being generated to prevent the optimizer from removing the
+// data structure from the executable
+//
+VOID* CONST ReferenceAcpiTable = &Gtdt;
diff --git a/Platform/RaspberryPi/RPi3/AcpiTables/Madt.aslc b/Platform/RaspberryPi/RPi3/AcpiTables/Madt.aslc
new file mode 100644
index 000000000000..69c96273f579
--- /dev/null
+++ b/Platform/RaspberryPi/RPi3/AcpiTables/Madt.aslc
@@ -0,0 +1,62 @@
+/** @file
+ *
+ *  Multiple APIC Description Table (MADT)
+ *
+ *  Copyright (c) 2018, Andrey Warkentin <andrey.warkentin@gmail.com>
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *
+ *  This program and the accompanying materials
+ *  are licensed and made available under the terms and conditions of the BSD License
+ *  which accompanies this distribution.  The full text of the license may be found at
+ *  http://opensource.org/licenses/bsd-license.php
+ *
+ *  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+ *  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+ *
+ **/
+
+/*
+ * Even though the BCM283x don't contain a GIC, these
+ * GICC definitions enable multi-core support (with PSCI).
+ *
+ * Mind the signatures in the header, they must be kept.
+ */
+UINT8 Madt[] = {
+  0x41, 0x50, 0x49, 0x43, 0x6c, 0x01, 0x00, 0x00, 0x03, 0xaf, 0x42, 0x43,
+  0x32, 0x38, 0x33, 0x36, 0x45, 0x44, 0x4b, 0x32, 0x20, 0x20, 0x20, 0x20,
+  0x01, 0x00, 0x00, 0x00, 0x4d, 0x53, 0x46, 0x54, 0x01, 0x00, 0x00, 0x00,
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x0b, 0x50, 0x00, 0x00,
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x01, 0x00, 0x00, 0x00,
+  0x00, 0x00, 0x00, 0x00, 0x09, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x40, 0x00, 0x00, 0x00, 0x00,
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
+  0x01, 0x00, 0x00, 0x00, 0x0b, 0x50, 0x00, 0x00, 0x01, 0x00, 0x00, 0x00,
+  0x01, 0x00, 0x00, 0x00, 0x01, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
+  0x09, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
+  0x00, 0x00, 0x00, 0x40, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
+  0x01, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x01, 0x00, 0x00, 0x00,
+  0x0b, 0x50, 0x00, 0x00, 0x02, 0x00, 0x00, 0x00, 0x02, 0x00, 0x00, 0x00,
+  0x01, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x09, 0x00, 0x00, 0x00,
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x40,
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x02, 0x00, 0x00, 0x00,
+  0x00, 0x00, 0x00, 0x00, 0x01, 0x00, 0x00, 0x00, 0x0b, 0x50, 0x00, 0x00,
+  0x03, 0x00, 0x00, 0x00, 0x03, 0x00, 0x00, 0x00, 0x01, 0x00, 0x00, 0x00,
+  0x00, 0x00, 0x00, 0x00, 0x09, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x40, 0x00, 0x00, 0x00, 0x00,
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
+  0x00, 0x00, 0x00, 0x00, 0x03, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
+  0x01, 0x00, 0x00, 0x00
+};
+
+//
+// Reference the table being generated to prevent the optimizer from removing the
+// data structure from the executable
+//
+VOID* CONST ReferenceAcpiTable = &Madt;
diff --git a/Platform/RaspberryPi/RPi3/AcpiTables/Pep.asl b/Platform/RaspberryPi/RPi3/AcpiTables/Pep.asl
new file mode 100644
index 000000000000..c0c5fca4c38a
--- /dev/null
+++ b/Platform/RaspberryPi/RPi3/AcpiTables/Pep.asl
@@ -0,0 +1,95 @@
+/** @file
+ *
+ *  Platform Extension Plugin (PEP).
+ *
+ *  Copyright (c) 2018, Andrey Warkentin <andrey.warkentin@gmail.com>
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *
+ *  This program and the accompanying materials
+ *  are licensed and made available under the terms and conditions of the BSD License
+ *  which accompanies this distribution.  The full text of the license may be found at
+ *  http://opensource.org/licenses/bsd-license.php
+ *
+ *  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+ *  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+ *
+ **/
+
+Device(PEPD)
+{
+  //
+  // RPI3 PEP virtual device.
+  //
+  Name (_HID, "BCM2854") // Note: since pep on rpi3 is virtual device,
+  Name (_CID, "BCM2854") // its device id needs to be generated by Microsoft
+  Name (_UID, 0x0)
+  Name (_CRS, ResourceTemplate ()
+  {
+    // No hardware resources for PEP driver are needed.
+  })
+
+  //
+  // Processor info. PEP proprietary method to return
+  // PEP_PROCESSOR_TABLE_PLAT structure.
+  //
+  // See Pep.h and Pep.c.
+  //
+  Name (_GPI, Buffer()
+  {
+    0x01, 0x00, 0x00, 0x00, 0x01, 0x00, 0x00, 0x00, 0x5C, 0x00, 0x5F, 0x00, 0x53,
+    0x00, 0x42, 0x00, 0x2E, 0x00, 0x43, 0x00, 0x50, 0x00, 0x55, 0x00, 0x30,
+    0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
+    0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
+    0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
+    0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00
+  })
+
+  //
+  // Coordinated state info. PEP proprietary method to return
+  // PEP_COORDINATED_STATE_TABLE_PLAT structure.
+  //
+  // See Pep.h and Pep.c.
+  //
+  Name (_GCI, Buffer()
+  {
+    0x01, 0x00, 0x00, 0x00, 0x01, 0x00, 0x00, 0x00, 0x01, 0x00, 0x00, 0x00, 0x00,
+    0x00, 0x00, 0x00, 0x06, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
+    0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
+    0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
+    0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
+    0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
+    0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
+    0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
+    0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
+    0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
+    0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
+    0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
+    0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
+    0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
+    0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
+    0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
+    0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x02, 0x00, 0x00, 0x00, 0x01,
+    0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x01,
+    0x00, 0x00, 0x00, 0x01, 0x00, 0x00, 0x00
+  })
+
+  //
+  // Device info. PEP proprietary method to return
+  // PEP_DEVICE_TABLE_PLAT structure.
+  //
+  // See Pep.h and Pep.c.
+  //
+  Name (_GDI, Buffer()
+  {
+    0x01, 0x00, 0x00, 0x00, 0x01, 0x00, 0x00, 0x00, 0x5C, 0x00, 0x5F, 0x00, 0x53,
+    0x00, 0x42, 0x00, 0x2E, 0x00, 0x49, 0x00, 0x32, 0x00, 0x43, 0x00, 0x30,
+    0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
+    0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
+    0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
+    0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x09,
+    0x00, 0x00, 0x00, 0x01, 0x00, 0x00, 0x00, 0x04, 0x00, 0x00, 0x00, 0x00,
+    0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
+    0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
+    0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00
+  })
+}
diff --git a/Platform/RaspberryPi/RPi3/AcpiTables/Pep.c b/Platform/RaspberryPi/RPi3/AcpiTables/Pep.c
new file mode 100644
index 000000000000..bf96178a7c11
--- /dev/null
+++ b/Platform/RaspberryPi/RPi3/AcpiTables/Pep.c
@@ -0,0 +1,84 @@
+/** @file
+ *
+ *  PEP device tables
+ *
+ *  Copyright (c) 2018, Andrei Warkentin <andrey.warkentin@gmail.com>
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *
+ *  This program and the accompanying materials
+ *  are licensed and made available under the terms and conditions of the BSD License
+ *  which accompanies this distribution.  The full text of the license may be found at
+ *  http://opensource.org/licenses/bsd-license.php
+ *
+ *  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+ *  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+ *
+ **/
+
+#include "Pep.h"
+
+PEP_PROCESSOR_TABLE_PLAT RPI3Processors = {
+  1, // Version
+  1, // NumberProcessors
+  {  // ProcessorInfo
+    { // [0]
+      L"\\_SB.CPU0", // DevicePath, wchar_t[16]
+      0, // FeedbackCounterCount
+      0x00000000, // Flags
+      0, // NumberIdleStates
+      0, // NumberPerfStates
+      { // IdleInfo
+      },
+      { // perfinfo
+      }
+    }
+  }
+};
+
+PEP_COORDINATED_STATE_TABLE_PLAT RPI3CoordinatedStates = {
+  1, // Version
+  1, // CoordinatedStateCount
+  { // CordinatedStates[]
+    { // [0]
+      { // DependencyInfo
+        { // [0]
+          1, // ExpectedState
+          0, // TargetProcessor
+          0x0 | 0x2 | 0x4, // LooseDependency = FALSE, InitialState = TRUE, DependentState = TRUE
+        }
+      },
+      SOC_STATE_TYPE, // StateType
+      0x1, // Flags
+      0, // Latency
+      0, // BreakEvenDuration
+      1, // DependencyCount
+      1, // MaximumDependencySize
+    }
+  }
+};
+
+PEP_DEVICE_TABLE_PLAT RPI3Devices = {
+  1, // Version
+  1, // NumberDevices
+  { // DeviceInfo
+    { // [1]
+      L"\\_SB.I2C0", // DevicePath, wchar_t[16]
+      0x1 | (1 << 3), // DStateSupportMask (D0 and D3)
+      1, // NumberCompoenents
+      { // DStateRequirement
+        { // [0]
+          PowerDeviceD3 // DState
+        }
+      },
+      { // FStateRequirement
+        { // [0]
+          { // FState
+            { // [0]
+              0
+            }
+          }
+        }
+      }
+    }
+  }
+};
diff --git a/Platform/RaspberryPi/RPi3/AcpiTables/Pep.h b/Platform/RaspberryPi/RPi3/AcpiTables/Pep.h
new file mode 100644
index 000000000000..08fee8ce5704
--- /dev/null
+++ b/Platform/RaspberryPi/RPi3/AcpiTables/Pep.h
@@ -0,0 +1,126 @@
+/** @file
+ *
+ *  PEP device defines
+ *
+ *  Copyright (c) 2018, Andrei Warkentin <andrey.warkentin@gmail.com>
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *
+ *  This program and the accompanying materials
+ *  are licensed and made available under the terms and conditions of the BSD License
+ *  which accompanies this distribution.  The full text of the license may be found at
+ *  http://opensource.org/licenses/bsd-license.php
+ *
+ *  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+ *  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+ *
+ **/
+
+/*
+ * Note: Not everything is here. At least SOC_STATE_TYPE is missing.
+ */
+
+#ifndef _RPI3PEP_H_INCLUDED_
+#define _RPI3PEP_H_INCLUDED_
+
+#include <IndustryStandard/Acpi50.h>
+
+#define PEP_MAX_DEPENDENCIES_PER_STATE 16
+#define MAX_PROCESSOR_PATH_LENGTH 16
+#define MAX_DEVICE_PATH_LENGTH 32
+#define MAX_COMPONENT_COUNT 8
+#define P_NUMBER_PROCESSORS 1
+#define P_NUMBER_IDLE_STATES 1
+#define P_NUMBER_PERF_STATES 0
+#define P_NUMBER_DEVICES 1
+#define P_NUMBER_COORDINATED_STATS 1
+
+typedef struct _PEP_PROCESSOR_IDLE_STATE_INFO {
+  UINT32 Ulong;
+  UINT32 Latency;
+  UINT32 BreakEvenDuration;
+} PEP_PROCESSOR_IDLE_STATE_INFO, *PEP_PROCESSOR_IDLE_STATE_INFO;
+
+typedef struct _PEP_PROCESSOR_IDLE_INFO_PLAT {
+  //
+  // Processor idle states.
+  //
+  PEP_PROCESSOR_IDLE_STATE_INFO IdleStates[P_NUMBER_IDLE_STATES];
+} PEP_PROCESSOR_IDLE_INFO_PLAT, *PPEP_PROCESSOR_IDLE_INFO_PLAT;
+
+typedef struct COORDINATED_DEPENDENCY_INFO {
+  UINT32 ExpectedState;
+  UINT32 TargetProcessor;
+  UINT32 Ulong;
+} COORDINATED_DEPENDENCY_INFO, *PCOORDINATED_DEPENDENCY_INFO;
+
+typedef struct {
+  COORDINATED_DEPENDENCY_INFO DependencyInfo[PEP_MAX_DEPENDENCIES_PER_STATE];
+  UINT32 StateType;
+  UINT32 Ulong;
+  UINT32 Latency;
+  UINT32 BreakEvenDuration;
+  UINT32 DependencyCount;
+  UINT32 MaximumDependencySize;
+} COORDINATED_STATE_INFO;
+
+typedef struct {
+  UINT32 Unused;
+} PEP_PROCESSOR_PERF_INFO;
+
+typedef struct {
+  UINT32 FState[MAX_COMPONENT_COUNT];
+} COORDINATED_FSTATE_REQUIREMENT;
+
+typedef struct {
+  UINT32 DState;
+} COORDINATED_DSTATE_REQUIREMENT;
+
+//
+// Top level device table
+// *N.B. The exact length of the structure is determined by the NumberIdleStates/NumberPerfStates variables.
+//
+
+typedef struct _PEP_PROCESSOR_INFO_PLAT {
+  WCHAR DevicePath[MAX_PROCESSOR_PATH_LENGTH]; // Null-terminated ACPI name
+  ULONG FeedbackCounterCount;
+  ULONG Flags;
+
+  //
+  // We are putting the idle/perf state count here (instead
+  // of the PEP_PROCESSOR_xxx_INFO structure for the ease of parsing.
+  //
+  ULONG NumberIdleStates;
+  ULONG NumberPerfStates;
+
+  PEP_PROCESSOR_IDLE_INFO_PLAT IdleInfo;
+  PEP_PROCESSOR_PERF_INFO PerfInfo;
+} PEP_PROCESSOR_INFO_PLAT, *PPEP_PROCESSOR_INFO_PLAT;
+
+typedef struct _PEP_PROCESSOR_TABLE_PLAT {
+  UINT32 Version;
+  UINT32 NumberProcessors;
+  PEP_PROCESSOR_INFO_PLAT ProcessorInfo[P_NUMBER_PROCESSORS];
+} PEP_PROCESSOR_TABLE_PLAT;
+
+typedef struct _PEP_COORDINATED_STATE_TABLE_PLAT {
+  ULONG Version;
+  ULONG CoordinatedStateCount;
+  COORDINATED_STATE_INFO CoordinatedStates[P_NUMBER_COORDINATED_STATS];
+} PEP_COORDINATED_STATE_TABLE_PLAT, *PPEP_COORDINATED_STATE_TABLE_PLAT;
+
+typedef struct _PEP_DEVICE_INFO_PLAT {
+  WCHAR DevicePath[MAX_DEVICE_PATH_LENGTH]; // Null-terminated ACPI name
+  ULONG DStateSupportMask;
+  ULONG NumberComponents;
+
+  COORDINATED_DSTATE_REQUIREMENT DStateRequirement[P_NUMBER_COORDINATED_STATS];
+  COORDINATED_FSTATE_REQUIREMENT FStateRequirement[P_NUMBER_COORDINATED_STATS];
+} PEP_DEVICE_INFO_PLAT, *PPEP_DEVICE_INFO_PLAT;
+
+typedef struct _PEP_DEVICE_TABLE_PLAT {
+  ULONG Version;
+  ULONG NumberDevices;
+  PEP_DEVICE_INFO_PLAT DeviceInfo[P_NUMBER_DEVICES];
+} PEP_DEVICE_TABLE_PLAT, *PPEP_DEVICE_TABLE_PLAT;
+
+#endif // _RPI3PEP_H_INCLUDED_
diff --git a/Platform/RaspberryPi/RPi3/AcpiTables/Rhpx.asl b/Platform/RaspberryPi/RPi3/AcpiTables/Rhpx.asl
new file mode 100644
index 000000000000..b2127c02e927
--- /dev/null
+++ b/Platform/RaspberryPi/RPi3/AcpiTables/Rhpx.asl
@@ -0,0 +1,201 @@
+/** @file
+ *
+ *  [DSDT] RHProxy device to enable WinRT API (RHPX)
+ *
+ *  Copyright (c) 2018, Andrey Warkentin <andrey.warkentin@gmail.com>
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *
+ *  This program and the accompanying materials
+ *  are licensed and made available under the terms and conditions of the BSD License
+ *  which accompanies this distribution.  The full text of the license may be found at
+ *  http://opensource.org/licenses/bsd-license.php
+ *
+ *  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+ *  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+ *
+ **/
+
+Device (RHPX)
+{
+  Name (_HID, "MSFT8000")
+  Name (_CID, "MSFT8000")
+  Name (_UID, 1)
+
+  Name(_CRS, ResourceTemplate ()
+  {
+    // Index 0
+    SPISerialBus (           // SCKL - GPIO 11 - Pin 23
+                             // MOSI - GPIO 10 - Pin 19
+                             // MISO - GPIO 9  - Pin 21
+                             // CE0  - GPIO 8  - Pin 24
+      0,                     // Device selection (CE0)
+      PolarityLow,           // Device selection polarity
+      FourWireMode,          // WireMode
+      8,                     // DataBit len
+      ControllerInitiated,   // Slave mode
+      4000000,               // Connection speed
+      ClockPolarityLow,      // Clock polarity
+      ClockPhaseFirst,       // Clock phase
+      "\\_SB.SPI0",          // ResourceSource: SPI bus controller name
+      0,                     // ResourceSourceIndex
+                             // Resource usage
+                             // DescriptorName: creates name for offset of resource descriptor
+    )                        // Vendor Data
+
+    // Index 1
+    SPISerialBus (           // SCKL - GPIO 11 - Pin 23
+                             // MOSI - GPIO 10 - Pin 19
+                             // MISO - GPIO 9  - Pin 21
+                             // CE1  - GPIO 7  - Pin 26
+      1,                     // Device selection (CE1)
+      PolarityLow,           // Device selection polarity
+      FourWireMode,          // WireMode
+      8,                     // DataBit len
+      ControllerInitiated,   // Slave mode
+      4000000,               // Connection speed
+      ClockPolarityLow,      // Clock polarity
+      ClockPhaseFirst,       // Clock phase
+      "\\_SB.SPI0",          // ResourceSource: SPI bus controller name
+      0,                     // ResourceSourceIndex
+                             // Resource usage
+                             // DescriptorName: creates name for offset of resource descriptor
+    )                        // Vendor Data
+
+    // Index 2
+    I2CSerialBus (           // Pin 3 (GPIO2, SDA1), 5 (GPIO3, SCL1)
+      0xFFFF,                // SlaveAddress: placeholder
+      ,                      // SlaveMode: default to ControllerInitiated
+      0,                     // ConnectionSpeed: placeholder
+      ,                      // Addressing Mode: default to 7 bit
+      "\\_SB.I2C1",          // ResourceSource: I2C bus controller name
+      ,
+      ,
+      ,                      // Descriptor Name: creates name for offset of resource descriptor
+    )                        // Vendor Data
+
+    // Index 3
+    SPISerialBus (           // SPI1_SCLK - GPIO21
+                             // SPI1_MOSI - GPIO20
+                             // SPI1_MISO - GPIO19
+                             // SPI1_CE2_N - GPIO16
+      2,                     // Device selection (CE2)
+      PolarityLow,           // Device selection polarity
+      FourWireMode,          // WireMode
+      8,                     // DataBit len
+      ControllerInitiated,   // Slave mode
+      4000000,               // Connection speed
+      ClockPolarityLow,      // Clock polarity
+      ClockPhaseFirst,       // Clock phase
+      "\\_SB.SPI1",          // ResourceSource: SPI bus controller name
+      0,                     // ResourceSourceIndex
+                             // Resource usage
+                             // DescriptorName: creates name for offset of resource descriptor
+    )                        // Vendor Data
+
+    // GPIO 2
+    GpioIO (Shared, PullUp, 0, 0, IoRestrictionNone, "\\_SB.GPI0", 0, ResourceConsumer,,) { 2 }
+    GpioInt (Edge, ActiveBoth, Shared, PullUp, 0, "\\_SB.GPI0",)                          { 2 }
+    // GPIO 3
+    GpioIO (Shared, PullUp, 0, 0, IoRestrictionNone, "\\_SB.GPI0", 0, ResourceConsumer,,) { 3 }
+    GpioInt (Edge, ActiveBoth, Shared, PullUp, 0, "\\_SB.GPI0",)                          { 3 }
+    // GPIO 4
+    GpioIO (Shared, PullUp, 0, 0, IoRestrictionNone, "\\_SB.GPI0", 0, ResourceConsumer,,) { 4 }
+    GpioInt (Edge, ActiveBoth, Shared, PullUp, 0, "\\_SB.GPI0",)                          { 4 }
+    // GPIO 5
+    GpioIO (Shared, PullUp, 0, 0, IoRestrictionNone, "\\_SB.GPI0", 0, ResourceConsumer,,) { 5 }
+    GpioInt (Edge, ActiveBoth, Shared, PullUp, 0, "\\_SB.GPI0",)                          { 5 }
+    // GPIO 6
+    GpioIO (Shared, PullUp, 0, 0, IoRestrictionNone, "\\_SB.GPI0", 0, ResourceConsumer,,) { 6 }
+    GpioInt (Edge, ActiveBoth, Shared, PullUp, 0, "\\_SB.GPI0",)                          { 6 }
+    // GPIO 7
+    GpioIO (Shared, PullUp, 0, 0, IoRestrictionNone, "\\_SB.GPI0", 0, ResourceConsumer,,) { 7 }
+    GpioInt (Edge, ActiveBoth, Shared, PullUp, 0, "\\_SB.GPI0",)                          { 7 }
+    // GPIO 8
+    GpioIO (Shared, PullUp, 0, 0, IoRestrictionNone, "\\_SB.GPI0", 0, ResourceConsumer,,) { 8 }
+    GpioInt (Edge, ActiveBoth, Shared, PullUp, 0, "\\_SB.GPI0",)                          { 8 }
+    // GPIO 9
+    GpioIO (Shared, PullDown, 0, 0, IoRestrictionNone, "\\_SB.GPI0", 0, ResourceConsumer,,) { 9 }
+    GpioInt (Edge, ActiveBoth, Shared, PullDown, 0, "\\_SB.GPI0",)                          { 9 }
+    // GPIO 10
+    GpioIO (Shared, PullDown, 0, 0, IoRestrictionNone, "\\_SB.GPI0", 0, ResourceConsumer,,) { 10 }
+    GpioInt (Edge, ActiveBoth, Shared, PullDown, 0, "\\_SB.GPI0",)                          { 10 }
+    // GPIO 11
+    GpioIO (Shared, PullDown, 0, 0, IoRestrictionNone, "\\_SB.GPI0", 0, ResourceConsumer,,) { 11 }
+    GpioInt (Edge, ActiveBoth, Shared, PullDown, 0, "\\_SB.GPI0",)                          { 11 }
+    // GPIO 12
+    GpioIO (Shared, PullDown, 0, 0, IoRestrictionNone, "\\_SB.GPI0", 0, ResourceConsumer,,) { 12 }
+    GpioInt (Edge, ActiveBoth, Shared, PullDown, 0, "\\_SB.GPI0",)                          { 12 }
+    // GPIO 13
+    GpioIO (Shared, PullDown, 0, 0, IoRestrictionNone, "\\_SB.GPI0", 0, ResourceConsumer,,) { 13 }
+    GpioInt (Edge, ActiveBoth, Shared, PullDown, 0, "\\_SB.GPI0",)                          { 13 }
+    // NTRAID#MSFT-7141401-2016/04/7-jordanrh - disable UART muxing
+    // until a proper solution can be created for the dmap conflict
+    // GPIO 14 - UART TX
+    // GpioIO (Shared, PullDown, 0, 0, IoRestrictionNone, "\\_SB.GPI0", 0, ResourceConsumer,,) { 14 }
+    // GpioInt (Edge, ActiveBoth, Shared, PullDown, 0, "\\_SB.GPI0",)                          { 14 }
+    // GPIO 15 - UART RX
+    // GpioIO (Shared, PullDown, 0, 0, IoRestrictionNone, "\\_SB.GPI0", 0, ResourceConsumer,,) { 15 }
+    // GpioInt (Edge, ActiveBoth, Shared, PullDown, 0, "\\_SB.GPI0",)                          { 15 }
+    // GPIO 16
+    GpioIO (Shared, PullDown, 0, 0, IoRestrictionNone, "\\_SB.GPI0", 0, ResourceConsumer,,) { 16 }
+    GpioInt (Edge, ActiveBoth, Shared, PullDown, 0, "\\_SB.GPI0",)                          { 16 }
+    // GPIO 17
+    GpioIO (Shared, PullDown, 0, 0, IoRestrictionNone, "\\_SB.GPI0", 0, ResourceConsumer,,) { 17 }
+    GpioInt (Edge, ActiveBoth, Shared, PullDown, 0, "\\_SB.GPI0",)                          { 17 }
+    // GPIO 18
+    GpioIO (Shared, PullDown, 0, 0, IoRestrictionNone, "\\_SB.GPI0", 0, ResourceConsumer,,) { 18 }
+    GpioInt (Edge, ActiveBoth, Shared, PullDown, 0, "\\_SB.GPI0",)                          { 18 }
+    // GPIO 19
+    GpioIO (Shared, PullDown, 0, 0, IoRestrictionNone, "\\_SB.GPI0", 0, ResourceConsumer,,) { 19 }
+    GpioInt (Edge, ActiveBoth, Shared, PullDown, 0, "\\_SB.GPI0",)                          { 19 }
+    // GPIO 20
+    GpioIO (Shared, PullDown, 0, 0, IoRestrictionNone, "\\_SB.GPI0", 0, ResourceConsumer,,) { 20 }
+    GpioInt (Edge, ActiveBoth, Shared, PullDown, 0, "\\_SB.GPI0",)                          { 20 }
+    // GPIO 21
+    GpioIO (Shared, PullDown, 0, 0, IoRestrictionNone, "\\_SB.GPI0", 0, ResourceConsumer,,) { 21 }
+    GpioInt (Edge, ActiveBoth, Shared, PullDown, 0, "\\_SB.GPI0",)                          { 21 }
+    // GPIO 22
+    GpioIO (Shared, PullDown, 0, 0, IoRestrictionNone, "\\_SB.GPI0", 0, ResourceConsumer,,) { 22 }
+    GpioInt (Edge, ActiveBoth, Shared, PullDown, 0, "\\_SB.GPI0",)                          { 22 }
+    // GPIO 23
+    GpioIO (Shared, PullDown, 0, 0, IoRestrictionNone, "\\_SB.GPI0", 0, ResourceConsumer,,) { 23 }
+    GpioInt (Edge, ActiveBoth, Shared, PullDown, 0, "\\_SB.GPI0",)                          { 23 }
+    // GPIO 24
+    GpioIO (Shared, PullDown, 0, 0, IoRestrictionNone, "\\_SB.GPI0", 0, ResourceConsumer,,) { 24 }
+    GpioInt (Edge, ActiveBoth, Shared, PullDown, 0, "\\_SB.GPI0",)                          { 24 }
+    // GPIO 25
+    GpioIO (Shared, PullDown, 0, 0, IoRestrictionNone, "\\_SB.GPI0", 0, ResourceConsumer,,) { 25 }
+    GpioInt (Edge, ActiveBoth, Shared, PullDown, 0, "\\_SB.GPI0",)                          { 25 }
+    // GPIO 26
+    GpioIO (Shared, PullDown, 0, 0, IoRestrictionNone, "\\_SB.GPI0", 0, ResourceConsumer,,) { 26 }
+    GpioInt (Edge, ActiveBoth, Shared, PullDown, 0, "\\_SB.GPI0",)                          { 26 }
+    // GPIO 27
+    GpioIO (Shared, PullDown, 0, 0, IoRestrictionNone, "\\_SB.GPI0", 0, ResourceConsumer,,) { 27 }
+    GpioInt (Edge, ActiveBoth, Shared, PullDown, 0, "\\_SB.GPI0",)                          { 27 }
+  })
+
+  Name (_DSD, Package()
+  {
+    ToUUID ("daffd814-6eba-4d8c-8a91-bc9bbf4aa301"),
+    Package ()
+    {
+      // Reference http://www.raspberrypi.org/documentation/hardware/raspberrypi/spi/README.md
+      // SPI 0
+      Package (2) { "bus-SPI-SPI0", Package() { 0, 1 } },                   // Index 0 & 1
+      Package (2) { "SPI0-MinClockInHz", 7629 },                            // 7629 Hz
+      Package (2) { "SPI0-MaxClockInHz", 125000000 },                       // 125 MHz
+      Package (2) { "SPI0-SupportedDataBitLengths", Package() { 8 } },      // Data Bit Length
+      // I2C1
+      Package (2) { "bus-I2C-I2C1", Package() { 2 } },
+      // GPIO Pin Count and supported drive modes
+      Package (2) { "GPIO-PinCount", 54 },
+      Package (2) { "GPIO-UseDescriptorPinNumbers", 1 },
+      Package (2) { "GPIO-SupportedDriveModes", 0xf },                      // InputHighImpedance, InputPullUp, InputPullDown, OutputCmos
+      // SPI 1
+      Package (2) { "bus-SPI-SPI1", Package() { 3 }},                       // Index 3
+      Package (2) { "SPI1-MinClockInHz", 30511 },                           // 30.5 kHz
+      Package (2) { "SPI1-MaxClockInHz", 20000000 },                        // 20 MHz
+      Package (2) { "SPI1-SupportedDataBitLengths", Package() { 8 } },      // Data Bit Length
+    }
+  })
+}
diff --git a/Platform/RaspberryPi/RPi3/AcpiTables/Sdhc.asl b/Platform/RaspberryPi/RPi3/AcpiTables/Sdhc.asl
new file mode 100644
index 000000000000..e912b16c5ff7
--- /dev/null
+++ b/Platform/RaspberryPi/RPi3/AcpiTables/Sdhc.asl
@@ -0,0 +1,105 @@
+/** @file
+ *
+ *  [DSDT] SD controller/card definition (SDHC)
+ *
+ *  Copyright (c) 2018, Andrey Warkentin <andrey.warkentin@gmail.com>
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *
+ *  This program and the accompanying materials
+ *  are licensed and made available under the terms and conditions of the BSD License
+ *  which accompanies this distribution.  The full text of the license may be found at
+ *  http://opensource.org/licenses/bsd-license.php
+ *
+ *  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+ *  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+ *
+ **/
+
+//
+// Note: UEFI can use either SDHost or Arasan. We expose both to the OS.
+//
+
+// ArasanSD 3.0 SD Host Controller.
+Device (SDC1)
+{
+  Name (_HID, "BCM2847")
+  Name (_CID, "ARASAN")
+  Name (_UID, 0x0)
+  Name (_CCA, 0x0)
+  Name (_S1D, 0x1)
+  Name (_S2D, 0x1)
+  Name (_S3D, 0x1)
+  Name (_S4D, 0x1)
+  Method (_STA)
+  {
+    Return(0xf)
+  }
+  Method (_CRS, 0x0, Serialized)
+  {
+    Name (RBUF, ResourceTemplate ()
+    {
+      MEMORY32FIXED (ReadWrite, 0x3F300000, 0x100,)
+      Interrupt (ResourceConsumer, Level, ActiveHigh, Exclusive) { 0x5E }
+    })
+    Return (RBUF)
+  }
+
+  //
+  // A child device that represents the
+  // sd card, which is marked as non-removable.
+  //
+  Device (SDMM)
+  {
+    Method (_ADR)
+    {
+      Return (0)
+    }
+    Method (_RMV) // Is removable
+    {
+      Return (0) // 0 - fixed
+    }
+  }
+}
+
+
+// Broadcom SDHost 2.0 SD Host Controller
+Device (SDC2)
+{
+  Name (_HID, "BCM2855")
+  Name (_CID, "SDHST")
+  Name (_UID, 0x0)
+  Name (_CCA, 0x0)
+  Name (_S1D, 0x1)
+  Name (_S2D, 0x1)
+  Name (_S3D, 0x1)
+  Name (_S4D, 0x1)
+  Method (_STA)
+  {
+    Return (0xf)
+  }
+  Method (_CRS, 0x0, Serialized)
+  {
+    Name (RBUF, ResourceTemplate ()
+    {
+      MEMORY32FIXED (ReadWrite, 0x3F202000, 0x100,)
+      Interrupt (ResourceConsumer, Level, ActiveHigh, Exclusive) { 0x58 }
+    })
+    Return (RBUF)
+  }
+
+  //
+  // A child device that represents the
+  // sd card, which is marked as non-removable.
+  //
+  Device (SDMM)
+  {
+    Method (_ADR)
+    {
+      Return (0)
+    }
+    Method (_RMV) // Is removable
+    {
+      Return (0) // 0 - fixed
+    }
+  }
+}
diff --git a/Platform/RaspberryPi/RPi3/AcpiTables/Spcr.asl b/Platform/RaspberryPi/RPi3/AcpiTables/Spcr.asl
new file mode 100644
index 000000000000..c5a5f6e0af00
--- /dev/null
+++ b/Platform/RaspberryPi/RPi3/AcpiTables/Spcr.asl
@@ -0,0 +1,53 @@
+/** @file
+ *
+ *  Serial Port Console Redirection Table (SPCR)
+ *
+ *  Copyright (c) 2017-2018, Andrey Warkentin <andrey.warkentin@gmail.com>
+ *
+ *  This program and the accompanying materials
+ *  are licensed and made available under the terms and conditions of the BSD License
+ *  which accompanies this distribution.  The full text of the license may be found at
+ *  http://opensource.org/licenses/bsd-license.php
+ *
+ *  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+ *  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+ *
+ **/
+
+[000h 0000   4]                    Signature : "SPCR"    [Serial Port Console Redirection table]
+[004h 0004   4]                 Table Length : 00000050
+[008h 0008   1]                     Revision : 02
+[009h 0009   1]                     Checksum : 00
+[00Ah 0010   6]                       Oem ID : "RPiEFI"
+[010h 0016   8]                 Oem Table ID : "RPi3UEFI"
+[018h 0024   4]                 Oem Revision : 00000001
+[01Ch 0028   4]              Asl Compiler ID : "----"
+[020h 0032   4]        Asl Compiler Revision : 00000000
+
+[024h 0036   1]               Interface Type : 10
+[025h 0037   3]                     Reserved : 000000
+
+[028h 0040  12]         Serial Port Register : [Generic Address Structure]
+[028h 0040   1]                     Space ID : 00 [SystemMemory]
+[029h 0041   1]                    Bit Width : 20
+[02Ah 0042   1]                   Bit Offset : 00
+[02Bh 0043   1]         Encoded Access Width : 03 [DWord Access:32]
+[02Ch 0044   8]                      Address : 000000003f215000
+
+[034h 0052   1]               Interrupt Type : 0E
+[035h 0053   1]          PCAT-compatible IRQ : 00
+[036h 0054   4]                    Interrupt : 3D
+[03Ah 0058   1]                    Baud Rate : 07
+[03Bh 0059   1]                       Parity : 00
+[03Ch 0060   1]                    Stop Bits : 01
+[03Dh 0061   1]                 Flow Control : 00
+[03Eh 0062   1]                Terminal Type : 00
+[04Ch 0076   1]                     Reserved : 00
+[040h 0064   2]                PCI Device ID : FFFF
+[042h 0066   2]                PCI Vendor ID : FFFF
+[044h 0068   1]                      PCI Bus : 00
+[045h 0069   1]                   PCI Device : 00
+[046h 0070   1]                 PCI Function : 00
+[047h 0071   4]                    PCI Flags : 00000000
+[04Bh 0075   1]                  PCI Segment : 00
+[04Ch 0076   4]                     Reserved : 00000000
diff --git a/Platform/RaspberryPi/RPi3/AcpiTables/Uart.asl b/Platform/RaspberryPi/RPi3/AcpiTables/Uart.asl
new file mode 100644
index 000000000000..26fcef131758
--- /dev/null
+++ b/Platform/RaspberryPi/RPi3/AcpiTables/Uart.asl
@@ -0,0 +1,158 @@
+/** @file
+ *
+ *  [DSDT] Serial devices (UART).
+ *
+ *  Copyright (c) 2018, Andrey Warkentin <andrey.warkentin@gmail.com>
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *
+ *  This program and the accompanying materials
+ *  are licensed and made available under the terms and conditions of the BSD License
+ *  which accompanies this distribution.  The full text of the license may be found at
+ *  http://opensource.org/licenses/bsd-license.php
+ *
+ *  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+ *  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+ *
+ **/
+
+// PL011 based UART.
+Device (URT0)
+{
+  Name (_HID, "BCM2837")
+  Name (_CID, "HID3123")
+  Name (_UID, 0x4)
+  Name (_CCA, 0x0)
+  Method (_STA)
+  {
+    Return (0xf)
+  }
+  Method (_CRS, 0x0, Serialized)
+  {
+    Name (RBUF, ResourceTemplate ()
+    {
+      MEMORY32FIXED (ReadWrite, 0x3F201000, 0x1000,)
+      Interrupt (ResourceConsumer, Level, ActiveHigh, Exclusive) { 0x59 }
+    })
+    Return (RBUF)
+  }
+
+  Name (CLCK, 3000000)
+
+  Name (_DSD, Package ()
+  {
+    ToUUID ("daffd814-6eba-4d8c-8a91-bc9bbf4aa301"), Package ()
+    {
+      Package (2) { "clock-frequency", CLCK },
+    }
+  })
+}
+
+//
+// UART Mini.
+//
+// This device is referenced in the DBG2 table, which will cause the system to
+// not start the driver when the debugger is enabled and to mark the device
+// with problem code 53 (CM_PROB_USED_BY_DEBUGGER).
+//
+
+Device (URTM)
+{
+  Name (_HID, "BCM2836")
+  Name (_CID, "MINIUART")
+  Name (_UID, 0x0)
+  Name (_CCA, 0x0)
+  Method (_STA)
+  {
+    Return (0xf)
+  }
+  Method (_CRS, 0x0, Serialized)
+  {
+    Name (RBUF, ResourceTemplate ()
+    {
+      MEMORY32FIXED (ReadWrite, 0x3F215000, 0x70,)
+      Interrupt(ResourceConsumer, Level, ActiveHigh, Shared) {0x3D}
+
+      // NTRAID#MSFT-7141401-2016/04/7-jordanrh - disable UART muxing
+      // until a proper solution can be created for the dmap conflict.
+      // When muxing is enabled, must consider DBG2 table conflict.
+      // The alternate function resource needs to be reserved when
+      // the kernel debugger is enabled to prevent another client
+      // from muxing the pins away.
+
+      //
+      // MsftFunctionConfig is encoded as the VendorLong.
+      //
+      // MsftFunctionConfig(Exclusive, PullDown, BCM_ALT5, "\\_SB.GPI0", 0, ResourceConsumer, ) {14, 15}
+      // VendorLong  ()      // Length = 0x31
+      // {
+      //   /* 0000 */  0x00, 0x60, 0x44, 0xD5, 0xF3, 0x1F, 0x11, 0x60,  // .`D....`
+      //   /* 0008 */  0x4A, 0xB8, 0xB0, 0x9C, 0x2D, 0x23, 0x30, 0xDD,  // J...-#0.
+      //   /* 0010 */  0x2F, 0x8D, 0x1D, 0x00, 0x01, 0x10, 0x00, 0x02,  // /.......
+      //   /* 0018 */  0x02, 0x00, 0x12, 0x00, 0x00, 0x16, 0x00, 0x20,  // .......
+      //   /* 0020 */  0x00, 0x00, 0x00, 0x0E, 0x00, 0x0F, 0x00, 0x5C,  // .......\
+      //   /* 0028 */  0x5F, 0x53, 0x42, 0x2E, 0x47, 0x50, 0x49, 0x30,  // _SB.GPI0
+      //   /* 0030 */  0x00                                             // .
+      //}
+
+    })
+    Return (RBUF)
+  }
+}
+
+//
+// Multifunction serial bus device to support Bluetooth function.
+//
+Device(BTH0)
+{
+  Name (_HID, "BCM2EA6")
+  Name (_CID, "BCM2EA6")
+  Method (_STA)
+  {
+    Return (0xf)
+  }
+  Method (_CRS, 0x0, Serialized)
+  {
+    Name (RBUF, ResourceTemplate ()
+    {
+      // BT UART: UART0 (PL011)
+      UARTSerialBus(
+        115200,        // InitialBaudRate: in BPS
+        ,              // BitsPerByte: default to 8 bits
+        ,              // StopBits: Defaults to one bit
+        0x00,          // LinesInUse: 8 1-bit flags to
+                       //   declare enabled control lines.
+                       //   Raspberry Pi does not exposed
+                       //   HW control signals -> not supported.
+                       //   Optional bits:
+                       //   - Bit 7 (0x80) Request To Send (RTS)
+                       //   - Bit 6 (0x40) Clear To Send (CTS)
+                       //   - Bit 5 (0x20) Data Terminal Ready (DTR)
+                       //   - Bit 4 (0x10) Data Set Ready (DSR)
+                       //   - Bit 3 (0x08) Ring Indicator (RI)
+                       //   - Bit 2 (0x04) Data Carrier Detect (DTD)
+                       //   - Bit 1 (0x02) Reserved. Must be 0.
+                       //   - Bit 0 (0x01) Reserved. Must be 0.
+        ,              // IsBigEndian:
+                       //   default to LittleEndian.
+        ,              // Parity: Defaults to no parity
+        ,              // FlowControl: Defaults to
+                       //   no flow control.
+        16,            // ReceiveBufferSize
+        16,            // TransmitBufferSize
+        "\\_SB.URT0",  // ResourceSource:
+                       //   UART bus controller name
+        ,              // ResourceSourceIndex: assumed to be 0
+        ,              // ResourceUsage: assumed to be
+                       //   ResourceConsumer
+        UAR0,          // DescriptorName: creates name
+                       //   for offset of resource descriptor
+      )                // Vendor data
+
+      //
+      // RPIQ connection for BT_ON/OFF
+      //
+      GpioIO (Shared, PullUp, 0, 0, IoRestrictionNone, "\\_SB.RPIQ", 0, ResourceConsumer, , ) { 128 }
+    })
+    Return (RBUF)
+  }
+}
-- 
2.17.0.windows.1



^ permalink raw reply related	[flat|nested] 34+ messages in thread

* [PATCH v5 edk2-platforms 04/22] Platform/RaspberryPi/RPi3: Add reset and memory init libraries
  2019-02-05 16:25 [PATCH v5 edk2-platforms 00/22] Platform/RaspberryPi: Add Raspberry Pi 3 support Pete Batard
                   ` (2 preceding siblings ...)
  2019-02-05 16:25 ` [PATCH v5 edk2-platforms 03/22] Platform/RaspberryPi/RPi3: Add ACPI tables Pete Batard
@ 2019-02-05 16:25 ` Pete Batard
  2019-02-05 16:25 ` [PATCH v5 edk2-platforms 05/22] Platform/RaspberryPi/RPi3: Add platform library Pete Batard
                   ` (19 subsequent siblings)
  23 siblings, 0 replies; 34+ messages in thread
From: Pete Batard @ 2019-02-05 16:25 UTC (permalink / raw)
  To: edk2-devel

The memory init library ensures that relevant memory regions are
reserved on boot.

The reset library supports the ResetSystem runtime call using PSCI
and signals the gRaspberryPiEventResetGuid event group on reset,
which we need to save modified configuration vars to NVRAM.

Note that we tried to drop ResetLib altogether, and use the reset
notification event provided by the EDK2, but this results in
Linux kernel panics, for which we have no workaround.

Contributed-under: TianoCore Contribution Agreement 1.1
Signed-off-by: Pete Batard <pete@akeo.ie>
---
 Platform/RaspberryPi/RPi3/Library/MemoryInitPeiLib/MemoryInitPeiLib.c   | 162 ++++++++++++++++++++
 Platform/RaspberryPi/RPi3/Library/MemoryInitPeiLib/MemoryInitPeiLib.inf |  51 ++++++
 Platform/RaspberryPi/RPi3/Library/ResetLib/ResetLib.c                   | 104 +++++++++++++
 Platform/RaspberryPi/RPi3/Library/ResetLib/ResetLib.inf                 |  46 ++++++
 4 files changed, 363 insertions(+)

diff --git a/Platform/RaspberryPi/RPi3/Library/MemoryInitPeiLib/MemoryInitPeiLib.c b/Platform/RaspberryPi/RPi3/Library/MemoryInitPeiLib/MemoryInitPeiLib.c
new file mode 100644
index 000000000000..903364e08b15
--- /dev/null
+++ b/Platform/RaspberryPi/RPi3/Library/MemoryInitPeiLib/MemoryInitPeiLib.c
@@ -0,0 +1,162 @@
+/** @file
+ *
+ *  Copyright (c) 2017-2018, Andrey Warkentin <andrey.warkentin@gmail.com>
+ *  Copyright (c) 2011-2015, ARM Limited. All rights reserved.
+ *
+ *  This program and the accompanying materials
+ *  are licensed and made available under the terms and conditions of the BSD License
+ *  which accompanies this distribution.  The full text of the license may be found at
+ *  http://opensource.org/licenses/bsd-license.php
+ *
+ *  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+ *  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+ *
+ **/
+
+#include <PiPei.h>
+
+#include <Library/ArmMmuLib.h>
+#include <Library/ArmPlatformLib.h>
+#include <Library/DebugLib.h>
+#include <Library/HobLib.h>
+#include <Library/MemoryAllocationLib.h>
+#include <Library/PcdLib.h>
+
+extern UINT64 mSystemMemoryEnd;
+
+VOID
+BuildMemoryTypeInformationHob (
+  VOID
+  );
+
+STATIC
+VOID
+InitMmu (
+  IN ARM_MEMORY_REGION_DESCRIPTOR  *MemoryTable
+  )
+{
+  RETURN_STATUS Status;
+
+  //Note: Because we called PeiServicesInstallPeiMemory() before to call InitMmu() the MMU Page Table
+  //      resides in DRAM (even at the top of DRAM as it is the first permanent memory allocation)
+  Status = ArmConfigureMmu (MemoryTable, NULL, NULL);
+  if (EFI_ERROR (Status)) {
+    DEBUG ((DEBUG_ERROR, "Error: Failed to enable MMU\n"));
+  }
+}
+
+STATIC
+VOID
+AddRuntimeServicesRegion (
+  IN ARM_MEMORY_REGION_DESCRIPTOR *Desc
+)
+{
+  BuildResourceDescriptorHob (
+    EFI_RESOURCE_SYSTEM_MEMORY,
+    EFI_RESOURCE_ATTRIBUTE_PRESENT |
+    EFI_RESOURCE_ATTRIBUTE_INITIALIZED |
+    EFI_RESOURCE_ATTRIBUTE_WRITE_COMBINEABLE |
+    EFI_RESOURCE_ATTRIBUTE_WRITE_THROUGH_CACHEABLE |
+    EFI_RESOURCE_ATTRIBUTE_WRITE_BACK_CACHEABLE |
+    EFI_RESOURCE_ATTRIBUTE_TESTED,
+    Desc->PhysicalBase,
+    Desc->Length
+  );
+
+  BuildMemoryAllocationHob (
+    Desc->PhysicalBase,
+    Desc->Length,
+    EfiRuntimeServicesData
+  );
+}
+
+STATIC
+VOID
+AddReservedMemoryRegion (
+  IN ARM_MEMORY_REGION_DESCRIPTOR *Desc
+  )
+{
+  BuildResourceDescriptorHob (
+    EFI_RESOURCE_SYSTEM_MEMORY,
+    EFI_RESOURCE_ATTRIBUTE_PRESENT |
+    EFI_RESOURCE_ATTRIBUTE_INITIALIZED |
+    EFI_RESOURCE_ATTRIBUTE_WRITE_COMBINEABLE |
+    EFI_RESOURCE_ATTRIBUTE_WRITE_THROUGH_CACHEABLE |
+    EFI_RESOURCE_ATTRIBUTE_WRITE_BACK_CACHEABLE |
+    EFI_RESOURCE_ATTRIBUTE_TESTED,
+    Desc->PhysicalBase,
+    Desc->Length
+  );
+
+  BuildMemoryAllocationHob (
+    Desc->PhysicalBase,
+    Desc->Length,
+    EfiReservedMemoryType
+  );
+}
+
+/*++
+
+Routine Description:
+
+
+
+Arguments:
+
+  FileHandle  - Handle of the file being invoked.
+  PeiServices - Describes the list of possible PEI Services.
+
+Returns:
+
+  Status -  EFI_SUCCESS if the boot mode could be set
+
+--*/
+EFI_STATUS
+EFIAPI
+MemoryPeim (
+  IN EFI_PHYSICAL_ADDRESS  UefiMemoryBase,
+  IN UINT64                UefiMemorySize
+  )
+{
+  ARM_MEMORY_REGION_DESCRIPTOR *MemoryTable;
+
+  // Get Virtual Memory Map from the Platform Library
+  ArmPlatformGetVirtualMemoryMap (&MemoryTable);
+
+  // Ensure PcdSystemMemorySize has been set
+  ASSERT (PcdGet64 (PcdSystemMemorySize) != 0);
+
+  // FD without variable store
+  AddReservedMemoryRegion (&MemoryTable[0]);
+
+  // Variable store.
+  AddRuntimeServicesRegion (&MemoryTable[1]);
+
+  // Trusted Firmware region
+  AddReservedMemoryRegion (&MemoryTable[2]);
+
+  // Usable memory.
+  BuildResourceDescriptorHob (
+    EFI_RESOURCE_SYSTEM_MEMORY,
+    EFI_RESOURCE_ATTRIBUTE_PRESENT |
+    EFI_RESOURCE_ATTRIBUTE_INITIALIZED |
+    EFI_RESOURCE_ATTRIBUTE_WRITE_COMBINEABLE |
+    EFI_RESOURCE_ATTRIBUTE_WRITE_THROUGH_CACHEABLE |
+    EFI_RESOURCE_ATTRIBUTE_WRITE_BACK_CACHEABLE |
+    EFI_RESOURCE_ATTRIBUTE_TESTED,
+    MemoryTable[3].PhysicalBase,
+    MemoryTable[3].Length
+  );
+
+  AddReservedMemoryRegion (&MemoryTable[4]);
+
+  // Build Memory Allocation Hob
+  InitMmu (MemoryTable);
+
+  if (FeaturePcdGet (PcdPrePiProduceMemoryTypeInformationHob)) {
+    // Optional feature that helps prevent EFI memory map fragmentation.
+    BuildMemoryTypeInformationHob ();
+  }
+
+  return EFI_SUCCESS;
+}
diff --git a/Platform/RaspberryPi/RPi3/Library/MemoryInitPeiLib/MemoryInitPeiLib.inf b/Platform/RaspberryPi/RPi3/Library/MemoryInitPeiLib/MemoryInitPeiLib.inf
new file mode 100644
index 000000000000..8e44f2e39408
--- /dev/null
+++ b/Platform/RaspberryPi/RPi3/Library/MemoryInitPeiLib/MemoryInitPeiLib.inf
@@ -0,0 +1,51 @@
+#/** @file
+#
+#  Copyright (c) 2016, Linaro, Ltd. All rights reserved.
+#  Copyright (c) 2011-2014, ARM Ltd. All rights reserved.
+#
+#  This program and the accompanying materials
+#  are licensed and made available under the terms and conditions of the BSD License
+#  which accompanies this distribution.  The full text of the license may be found at
+#  http://opensource.org/licenses/bsd-license.php
+#
+#  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+#  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+#
+#**/
+
+[Defines]
+  INF_VERSION                    = 0x0001001A
+  BASE_NAME                      = MemoryInitPeiLib
+  FILE_GUID                      = 4bbc9c10-a100-43fb-8311-332ba497d1b4
+  MODULE_TYPE                    = BASE
+  VERSION_STRING                 = 1.0
+  LIBRARY_CLASS                  = MemoryInitPeiLib|SEC PEIM
+
+[Sources]
+  MemoryInitPeiLib.c
+
+[Packages]
+  MdePkg/MdePkg.dec
+  MdeModulePkg/MdeModulePkg.dec
+  EmbeddedPkg/EmbeddedPkg.dec
+  ArmPkg/ArmPkg.dec
+  ArmPlatformPkg/ArmPlatformPkg.dec
+
+[LibraryClasses]
+  DebugLib
+  HobLib
+  ArmMmuLib
+  ArmPlatformLib
+
+[Guids]
+  gEfiMemoryTypeInformationGuid
+
+[FeaturePcd]
+  gEmbeddedTokenSpaceGuid.PcdPrePiProduceMemoryTypeInformationHob
+
+[FixedPcd]
+  gArmTokenSpaceGuid.PcdSystemMemoryBase
+  gArmTokenSpaceGuid.PcdSystemMemorySize
+
+[Depex]
+  TRUE
diff --git a/Platform/RaspberryPi/RPi3/Library/ResetLib/ResetLib.c b/Platform/RaspberryPi/RPi3/Library/ResetLib/ResetLib.c
new file mode 100644
index 000000000000..465bb8babf25
--- /dev/null
+++ b/Platform/RaspberryPi/RPi3/Library/ResetLib/ResetLib.c
@@ -0,0 +1,104 @@
+/** @file
+ *
+ *  Support ResetSystem Runtime call using PSCI calls.
+ *  Signals the gRaspberryPiEventResetGuid event group on reset.
+ *
+ *  Copyright (c) 2018, Andrei Warkentin <andrey.warkentin@gmail.com>
+ *  Copyright (c) 2014, Linaro Ltd. All rights reserved.
+ *  Copyright (c) 2013-2015, ARM Ltd. All rights reserved.
+ *  Copyright (c) 2008-2009, Apple Inc. All rights reserved.
+ *
+ *  This program and the accompanying materials
+ *  are licensed and made available under the terms and conditions of the BSD License
+ *  which accompanies this distribution.  The full text of the license may be found at
+ *  http://opensource.org/licenses/bsd-license.php
+ *
+ *  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+ *  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+ *
+ **/
+
+#include <PiDxe.h>
+
+#include <Library/BaseLib.h>
+#include <Library/DebugLib.h>
+#include <Library/EfiResetSystemLib.h>
+#include <Library/ArmSmcLib.h>
+#include <Library/UefiLib.h>
+#include <Library/UefiRuntimeLib.h>
+
+#include <IndustryStandard/ArmStdSmc.h>
+
+/**
+  Resets the entire platform.
+
+  @param  ResetType             The type of reset to perform.
+  @param  ResetStatus           The status code for the reset.
+  @param  DataSize              The size, in bytes, of WatchdogData.
+  @param  ResetData             For a ResetType of EfiResetCold, EfiResetWarm, or
+                                EfiResetShutdown the data buffer starts with a Null-terminated
+                                Unicode string, optionally followed by additional binary data.
+
+**/
+EFI_STATUS
+EFIAPI
+LibResetSystem (
+  IN EFI_RESET_TYPE   ResetType,
+  IN EFI_STATUS       ResetStatus,
+  IN UINTN            DataSize,
+  IN CHAR16           *ResetData OPTIONAL
+  )
+{
+  ARM_SMC_ARGS ArmSmcArgs;
+
+  if (!EfiAtRuntime ()) {
+    /*
+     * Only if still in UEFI.
+     */
+    EfiEventGroupSignal (&gRaspberryPiEventResetGuid);
+  }
+
+  switch (ResetType) {
+  case EfiResetPlatformSpecific:
+    // Map the platform specific reset as reboot
+  case EfiResetWarm:
+    // Map a warm reset into a cold reset
+  case EfiResetCold:
+    // Send a PSCI 0.2 SYSTEM_RESET command
+    ArmSmcArgs.Arg0 = ARM_SMC_ID_PSCI_SYSTEM_RESET;
+    break;
+  case EfiResetShutdown:
+    // Send a PSCI 0.2 SYSTEM_OFF command
+    ArmSmcArgs.Arg0 = ARM_SMC_ID_PSCI_SYSTEM_OFF;
+    break;
+  default:
+    ASSERT (FALSE);
+    return EFI_UNSUPPORTED;
+  }
+
+  ArmCallSmc (&ArmSmcArgs);
+
+  // We should never be here
+  DEBUG ((DEBUG_ERROR, "%a: PSCI Reset failed\n", __FUNCTION__));
+  CpuDeadLoop ();
+  return EFI_UNSUPPORTED;
+}
+
+/**
+  Initialize any infrastructure required for LibResetSystem () to function.
+
+  @param  ImageHandle   The firmware allocated handle for the EFI image.
+  @param  SystemTable   A pointer to the EFI System Table.
+
+  @retval EFI_SUCCESS   The constructor always returns EFI_SUCCESS.
+
+**/
+EFI_STATUS
+EFIAPI
+LibInitializeResetSystem (
+  IN EFI_HANDLE        ImageHandle,
+  IN EFI_SYSTEM_TABLE  *SystemTable
+  )
+{
+  return EFI_SUCCESS;
+}
diff --git a/Platform/RaspberryPi/RPi3/Library/ResetLib/ResetLib.inf b/Platform/RaspberryPi/RPi3/Library/ResetLib/ResetLib.inf
new file mode 100644
index 000000000000..31ec5a3c17a8
--- /dev/null
+++ b/Platform/RaspberryPi/RPi3/Library/ResetLib/ResetLib.inf
@@ -0,0 +1,46 @@
+#/** @file
+#
+#  Reset System lib using PSCI hypervisor or secure monitor calls.
+#  Signals the gRaspberryPiEventResetGuid event group on reset.
+#
+#  Copyright (c) 2018, Andrei Warkentin <andrey.warkentin@gmail.com>
+#  Copyright (c) 2014, Linaro Ltd. All rights reserved.
+#  Copyright (c) 2014, ARM Ltd. All rights reserved.
+#  Copyright (c) 2008, Apple Inc. All rights reserved.
+#
+#  This program and the accompanying materials
+#  are licensed and made available under the terms and conditions of the BSD License
+#  which accompanies this distribution.  The full text of the license may be found at
+#  http://opensource.org/licenses/bsd-license.php
+#
+#  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+#  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+#
+#**/
+
+[Defines]
+  INF_VERSION                    = 0x0001001A
+  BASE_NAME                      = ResetLib
+  FILE_GUID                      = B9F59B69-A105-41C7-8F5A-2C60DD7FD7AB
+  MODULE_TYPE                    = BASE
+  VERSION_STRING                 = 1.0
+  LIBRARY_CLASS                  = EfiResetSystemLib
+
+[Sources]
+  ResetLib.c
+
+[Packages]
+  ArmPkg/ArmPkg.dec
+  MdePkg/MdePkg.dec
+  EmbeddedPkg/EmbeddedPkg.dec
+  Platform/RaspberryPi/RPi3/RPi3.dec
+
+[LibraryClasses]
+  DebugLib
+  BaseLib
+  ArmSmcLib
+  UefiLib
+  UefiRuntimeLib
+
+[Guids]
+  gRaspberryPiEventResetGuid
-- 
2.17.0.windows.1



^ permalink raw reply related	[flat|nested] 34+ messages in thread

* [PATCH v5 edk2-platforms 05/22] Platform/RaspberryPi/RPi3: Add platform library
  2019-02-05 16:25 [PATCH v5 edk2-platforms 00/22] Platform/RaspberryPi: Add Raspberry Pi 3 support Pete Batard
                   ` (3 preceding siblings ...)
  2019-02-05 16:25 ` [PATCH v5 edk2-platforms 04/22] Platform/RaspberryPi/RPi3: Add reset and memory init libraries Pete Batard
@ 2019-02-05 16:25 ` Pete Batard
  2019-02-05 16:25 ` [PATCH v5 edk2-platforms 06/22] Platform/RaspberryPi/RPi3: Add firmware driver Pete Batard
                   ` (18 subsequent siblings)
  23 siblings, 0 replies; 34+ messages in thread
From: Pete Batard @ 2019-02-05 16:25 UTC (permalink / raw)
  To: edk2-devel

A platform helper library, relying on low level Mailbox messaging
between the CPU and VideoCore to obtain current platform information,
that is used by various services and drivers.

Contributed-under: TianoCore Contribution Agreement 1.1
Signed-off-by: Pete Batard <pete@akeo.ie>
---
 Platform/RaspberryPi/RPi3/Include/IndustryStandard/RpiMbox.h              | 108 +++++++++++++
 Platform/RaspberryPi/RPi3/Library/PlatformLib/AArch64/RaspberryPiHelper.S | 107 +++++++++++++
 Platform/RaspberryPi/RPi3/Library/PlatformLib/PlatformLib.inf             |  65 ++++++++
 Platform/RaspberryPi/RPi3/Library/PlatformLib/RaspberryPi.c               |  99 ++++++++++++
 Platform/RaspberryPi/RPi3/Library/PlatformLib/RaspberryPiMem.c            | 160 ++++++++++++++++++++
 5 files changed, 539 insertions(+)

diff --git a/Platform/RaspberryPi/RPi3/Include/IndustryStandard/RpiMbox.h b/Platform/RaspberryPi/RPi3/Include/IndustryStandard/RpiMbox.h
new file mode 100644
index 000000000000..8547ad05ba61
--- /dev/null
+++ b/Platform/RaspberryPi/RPi3/Include/IndustryStandard/RpiMbox.h
@@ -0,0 +1,108 @@
+/** @file
+ *
+ * Copyright (c) 2019, Pete Batard <pete@akeo.ie>
+ * Copyright (c) 2016, Linaro Limited. All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions are met:
+ *
+ * Redistributions of source code must retain the above copyright notice, this
+ * list of conditions and the following disclaimer.
+ *
+ * Redistributions in binary form must reproduce the above copyright notice,
+ * this list of conditions and the following disclaimer in the documentation
+ * and/or other materials provided with the distribution.
+ *
+ * Neither the name of ARM nor the names of its contributors may be used
+ * to endorse or promote products derived from this software without specific
+ * prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+ * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+ * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
+ * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+ * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+ * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+ * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+ * POSSIBILITY OF SUCH DAMAGE.
+ *
+ **/
+
+#ifndef __RASPBERRY_PI_MAILBOX_H__
+#define __RASPBERRY_PI_MAILBOX_H__
+
+/* Mailbox channels */
+#define RPI_MBOX_PM_CHANNEL                                   0
+#define RPI_MBOX_FB_CHANNEL                                   1
+#define RPI_MBOX_VUART_CHANNEL                                2
+#define RPI_MBOX_VCHIQ_CHANNEL                                3
+#define RPI_MBOX_LED_CHANNEL                                  4
+#define RPI_MBOX_BUTTON_CHANNEL                               5
+#define RPI_MBOX_TOUCHSCREEN_CHANNEL                          6
+/* Request from ARM for response by VideoCore */
+#define RPI_MBOX_VC_CHANNEL                                   8
+/* Request from VideoCore for response by ARM */
+#define RPI_MBOX_ARM_CHANNEL                                  9
+
+#define RPI_MBOX_RESP_SUCCESS                                 0x80000000
+#define RPI_MBOX_RESP_FAILURE                                 0x80000001
+
+#define RPI_MBOX_VALUE_SIZE_RESPONSE_MASK                     BIT31
+
+#define RPI_MBOX_GET_REVISION                                 0x00000001
+#define RPI_MBOX_GET_BOARD_MODEL                              0x00010001
+#define RPI_MBOX_GET_BOARD_REVISION                           0x00010002
+#define RPI_MBOX_GET_MAC_ADDRESS                              0x00010003
+#define RPI_MBOX_GET_BOARD_SERIAL                             0x00010004
+#define RPI_MBOX_GET_ARM_MEMSIZE                              0x00010005
+
+#define RPI_MBOX_SET_POWER_STATE                              0x00028001
+
+#define RPI_MBOX_POWER_STATE_SDHCI                            0x00000000
+#define RPI_MBOX_POWER_STATE_UART0                            0x00000001
+#define RPI_MBOX_POWER_STATE_UART1                            0x00000002
+#define RPI_MBOX_POWER_STATE_USB_HCD                          0x00000003
+#define RPI_MBOX_POWER_STATE_I2C0                             0x00000004
+#define RPI_MBOX_POWER_STATE_I2C1                             0x00000005
+#define RPI_MBOX_POWER_STATE_I2C2                             0x00000006
+#define RPI_MBOX_POWER_STATE_SPI                              0x00000007
+#define RPI_MBOX_POWER_STATE_CCP2TX                           0x00000008
+
+#define RPI_MBOX_GET_CLOCK_RATE                               0x00030002
+#define RPI_MBOX_GET_MAX_CLOCK_RATE                           0x00030004
+#define RPI_MBOX_GET_MIN_CLOCK_RATE                           0x00030007
+
+#define RPI_MBOX_SET_CLOCK_RATE                               0x00038002
+#define RPI_MBOX_SET_GPIO                                     0x00038041
+
+#define RPI_MBOX_GET_FB_GEOMETRY                              0x00040003
+#define RPI_MBOX_GET_FB_LINELENGTH                            0x00040008
+#define RPI_MBOX_GET_FB_COLOR_DEPTH                           0x00040005
+#define RPI_MBOX_GET_FB_REGION                                0x00040001
+
+#define RPI_MBOX_SET_FB_PGEOM                                 0x00048003
+#define RPI_MBOX_SET_FB_VGEOM                                 0x00048004
+#define RPI_MBOX_SET_FB_DEPTH                                 0x00048005
+#define RPI_MBOX_ALLOC_FB                                     0x00040001
+#define RPI_MBOX_FREE_FB                                      0x00048001
+
+#define RPI_MBOX_GET_COMMAND_LINE                             0x00050001
+
+#define RPI_MBOX_POWER_STATE_ENABLE                           BIT0
+#define RPI_MBOX_POWER_STATE_WAIT                             BIT1
+
+#define RPI_MBOX_CLOCK_RATE_EMMC                              0x000000001
+#define RPI_MBOX_CLOCK_RATE_UART                              0x000000002
+#define RPI_MBOX_CLOCK_RATE_ARM                               0x000000003
+#define RPI_MBOX_CLOCK_RATE_CORE                              0x000000004
+#define RPI_MBOX_CLOCK_RATE_V3D                               0x000000005
+#define RPI_MBOX_CLOCK_RATE_H264                              0x000000006
+#define RPI_MBOX_CLOCK_RATE_ISP                               0x000000007
+#define RPI_MBOX_CLOCK_RATE_SDRAM                             0x000000008
+#define RPI_MBOX_CLOCK_RATE_PIXEL                             0x000000009
+#define RPI_MBOX_CLOCK_RATE_PWM                               0x00000000a
+
+#endif /* __RASPBERRY_PI_MAILBOX_H__ */
diff --git a/Platform/RaspberryPi/RPi3/Library/PlatformLib/AArch64/RaspberryPiHelper.S b/Platform/RaspberryPi/RPi3/Library/PlatformLib/AArch64/RaspberryPiHelper.S
new file mode 100644
index 000000000000..9638259700db
--- /dev/null
+++ b/Platform/RaspberryPi/RPi3/Library/PlatformLib/AArch64/RaspberryPiHelper.S
@@ -0,0 +1,107 @@
+/** @file
+ *
+ *  Copyright (c) 2016, Linaro Limited. All rights reserved.
+ *  Copyright (c) 2011-2013, ARM Limited. All rights reserved.
+ *
+ *  This program and the accompanying materials
+ *  are licensed and made available under the terms and conditions of the BSD License
+ *  which accompanies this distribution.  The full text of the license may be found at
+ *  http://opensource.org/licenses/bsd-license.php
+ *
+ *  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+ *  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+ *
+ **/
+
+#include <AsmMacroIoLibV8.h>
+#include <Library/ArmLib.h>
+#include <IndustryStandard/Bcm2836.h>
+#include <IndustryStandard/RpiMbox.h>
+
+#define MAX_TRIES     0x100000
+
+    .macro  drain
+    mov     x5, #MAX_TRIES
+0:  ldr     w6, [x4, #BCM2836_MBOX_STATUS_OFFSET]
+    tbnz    w6, #BCM2836_MBOX_STATUS_EMPTY, 1f
+    dmb     ld
+    ldr     wzr, [x4, #BCM2836_MBOX_READ_OFFSET]
+    subs    x5, x5, #1
+    b.ne    0b
+1:
+    .endm
+
+    .macro  poll, status
+    mov     x5, #MAX_TRIES
+0:  ldr     w6, [x4, #BCM2836_MBOX_STATUS_OFFSET]
+    tbz     w6, #\status, 1f
+    dmb     ld
+    subs    x5, x5, #1
+    b.ne    0b
+1:
+    .endm
+
+ASM_FUNC (ArmPlatformPeiBootAction)
+    adr     x0, .Lmeminfo_buffer
+    mov     x1, #FixedPcdGet64 (PcdDmaDeviceOffset)
+    orr     x0, x0, #RPI_MBOX_VC_CHANNEL
+    add     x0, x0, x1
+
+    MOV32   (x4, BCM2836_MBOX_BASE_ADDRESS)
+
+    drain
+    poll    BCM2836_MBOX_STATUS_FULL
+    str     w0, [x4, #BCM2836_MBOX_WRITE_OFFSET]
+    dmb     sy
+    poll    BCM2836_MBOX_STATUS_EMPTY
+    dmb     sy
+    ldr     wzr, [x4, #BCM2836_MBOX_READ_OFFSET]
+    dmb     ld
+
+    ldr     w0, .Lmemsize
+    sub     x0, x0, #1
+    adr     x1, mSystemMemoryEnd
+    str     x0, [x1]
+    ret
+
+    .align  4
+.Lmeminfo_buffer:
+    .long   .Lbuffer_size
+    .long   0x0
+    .long   RPI_MBOX_GET_ARM_MEMSIZE
+    .long   8                           // buf size
+    .long   0                           // input len
+    .long   0                           // mem base
+.Lmemsize:
+    .long   0                           // mem size
+    .long   0                           // end tag
+    .set    .Lbuffer_size, . - .Lmeminfo_buffer
+
+//UINTN
+//ArmPlatformGetPrimaryCoreMpId (
+//  VOID
+//  );
+ASM_FUNC (ArmPlatformGetPrimaryCoreMpId)
+    MOV32  (w0, FixedPcdGet32 (PcdArmPrimaryCore))
+    ret
+
+//UINTN
+//ArmPlatformIsPrimaryCore (
+//  IN UINTN MpId
+//  );
+ASM_FUNC (ArmPlatformIsPrimaryCore)
+    mov   x0, #1
+    ret
+
+//UINTN
+//ArmPlatformGetCorePosition (
+//  IN UINTN MpId
+//  );
+// With this function: CorePos = (ClusterId * 4) + CoreId
+ASM_FUNC (ArmPlatformGetCorePosition)
+    and   x1, x0, #ARM_CORE_MASK
+    and   x0, x0, #ARM_CLUSTER_MASK
+    add   x0, x1, x0, LSR #6
+    ret
+
+ASM_FUNCTION_REMOVE_IF_UNREFERENCED
diff --git a/Platform/RaspberryPi/RPi3/Library/PlatformLib/PlatformLib.inf b/Platform/RaspberryPi/RPi3/Library/PlatformLib/PlatformLib.inf
new file mode 100644
index 000000000000..a4506888f1a7
--- /dev/null
+++ b/Platform/RaspberryPi/RPi3/Library/PlatformLib/PlatformLib.inf
@@ -0,0 +1,65 @@
+#/** @file
+#
+#  Copyright (c) 2017-2018, Andrei Warkentin <andrey.warkentin@gmail.com>
+#  Copyright (c) 2014-2016, Linaro Limited. All rights reserved.
+#  Copyright (c) 2011-2014, ARM Limited. All rights reserved.
+#
+#  This program and the accompanying materials
+#  are licensed and made available under the terms and conditions of the BSD License
+#  which accompanies this distribution.  The full text of the license may be found at
+#  http://opensource.org/licenses/bsd-license.php
+#
+#  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+#  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+#
+#**/
+
+[Defines]
+  INF_VERSION                    = 0x0001001A
+  BASE_NAME                      = PlatformLib
+  FILE_GUID                      = 050182ef-f708-4148-b4bc-256cabf74fea
+  MODULE_TYPE                    = BASE
+  VERSION_STRING                 = 1.0
+  LIBRARY_CLASS                  = ArmPlatformLib|SEC PEIM
+
+[Packages]
+  MdePkg/MdePkg.dec
+  MdeModulePkg/MdeModulePkg.dec
+  EmbeddedPkg/EmbeddedPkg.dec
+  ArmPkg/ArmPkg.dec
+  ArmPlatformPkg/ArmPlatformPkg.dec
+  Silicon/Broadcom/Bcm283x/Bcm283x.dec
+  Platform/RaspberryPi/RPi3/RPi3.dec
+
+[LibraryClasses]
+  ArmLib
+  FdtLib
+  IoLib
+  MemoryAllocationLib
+  PcdLib
+  PrintLib
+
+[Sources.common]
+  RaspberryPi.c
+  RaspberryPiMem.c
+
+[Sources.AARCH64]
+  AArch64/RaspberryPiHelper.S
+
+[FixedPcd]
+  gArmTokenSpaceGuid.PcdFdBaseAddress
+  gArmTokenSpaceGuid.PcdFvBaseAddress
+  gArmPlatformTokenSpaceGuid.PcdCoreCount
+  gArmTokenSpaceGuid.PcdArmPrimaryCoreMask
+  gArmTokenSpaceGuid.PcdArmPrimaryCore
+  gArmTokenSpaceGuid.PcdFdSize
+  gEmbeddedTokenSpaceGuid.PcdDmaDeviceOffset
+  gArmTokenSpaceGuid.PcdSystemMemoryBase
+  gArmTokenSpaceGuid.PcdSystemMemorySize
+  gRaspberryPiTokenSpaceGuid.PcdNvStorageEventLogSize
+  gEfiMdeModulePkgTokenSpaceGuid.PcdFlashNvStorageVariableSize
+  gEfiMdeModulePkgTokenSpaceGuid.PcdFlashNvStorageFtwWorkingSize
+  gEfiMdeModulePkgTokenSpaceGuid.PcdFlashNvStorageFtwSpareSize
+
+[Ppis]
+  gArmMpCoreInfoPpiGuid
diff --git a/Platform/RaspberryPi/RPi3/Library/PlatformLib/RaspberryPi.c b/Platform/RaspberryPi/RPi3/Library/PlatformLib/RaspberryPi.c
new file mode 100644
index 000000000000..758ebda844ab
--- /dev/null
+++ b/Platform/RaspberryPi/RPi3/Library/PlatformLib/RaspberryPi.c
@@ -0,0 +1,99 @@
+/** @file
+ *
+ *  Copyright (c) 2014-2016, Linaro Limited. All rights reserved.
+ *  Copyright (c) 2014, Red Hat, Inc.
+ *  Copyright (c) 2011-2013, ARM Limited. All rights reserved.
+ *
+ *
+ *  This program and the accompanying materials
+ *  are licensed and made available under the terms and conditions of the BSD License
+ *  which accompanies this distribution.  The full text of the license may be found at
+ *  http://opensource.org/licenses/bsd-license.php
+ *
+ *  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+ *  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+ *
+ **/
+
+#include <Library/IoLib.h>
+#include <Library/ArmPlatformLib.h>
+#include <Library/DebugLib.h>
+#include <Pi/PiBootMode.h>
+
+#include <Ppi/ArmMpCoreInfo.h>
+
+/**
+  Return the current Boot Mode
+
+  This function returns the boot reason on the platform
+
+  @return   Return the current Boot Mode of the platform
+
+**/
+EFI_BOOT_MODE
+ArmPlatformGetBootMode (
+  VOID
+  )
+{
+  return BOOT_WITH_FULL_CONFIGURATION;
+}
+
+/**
+  This function is called by PrePeiCore, in the SEC phase.
+**/
+RETURN_STATUS
+ArmPlatformInitialize (
+  IN  UINTN  MpId
+  )
+{
+  return RETURN_SUCCESS;
+}
+
+VOID
+ArmPlatformInitializeSystemMemory (
+  VOID
+  )
+{
+}
+
+STATIC ARM_CORE_INFO mRpi3InfoTable[] = {
+  { 0x0, 0x0, },             // Cluster 0, Core 0
+  { 0x0, 0x1, },             // Cluster 0, Core 1
+  { 0x0, 0x2, },             // Cluster 0, Core 2
+  { 0x0, 0x3, },             // Cluster 0, Core 3
+};
+
+STATIC
+EFI_STATUS
+PrePeiCoreGetMpCoreInfo (
+  OUT UINTN          *CoreCount,
+  OUT ARM_CORE_INFO  **ArmCoreTable
+  )
+{
+  // Only support one cluster
+  *CoreCount = sizeof (mRpi3InfoTable) / sizeof (ARM_CORE_INFO);
+  *ArmCoreTable = mRpi3InfoTable;
+
+  return EFI_SUCCESS;
+}
+
+STATIC ARM_MP_CORE_INFO_PPI mMpCoreInfoPpi = {
+  PrePeiCoreGetMpCoreInfo
+};
+STATIC EFI_PEI_PPI_DESCRIPTOR mPlatformPpiTable[] = {
+  {
+    EFI_PEI_PPI_DESCRIPTOR_PPI,
+    &gArmMpCoreInfoPpiGuid,
+    &mMpCoreInfoPpi
+  }
+};
+
+VOID
+ArmPlatformGetPlatformPpiList (
+  OUT UINTN                   *PpiListSize,
+  OUT EFI_PEI_PPI_DESCRIPTOR  **PpiList
+  )
+{
+  *PpiListSize = sizeof (mPlatformPpiTable);
+  *PpiList = mPlatformPpiTable;
+}
diff --git a/Platform/RaspberryPi/RPi3/Library/PlatformLib/RaspberryPiMem.c b/Platform/RaspberryPi/RPi3/Library/PlatformLib/RaspberryPiMem.c
new file mode 100644
index 000000000000..6d7c04498230
--- /dev/null
+++ b/Platform/RaspberryPi/RPi3/Library/PlatformLib/RaspberryPiMem.c
@@ -0,0 +1,160 @@
+/** @file
+ *
+ *  Copyright (c) 2017-2018, Andrey Warkentin <andrey.warkentin@gmail.com>
+ *  Copyright (c) 2014, Linaro Limited. All rights reserved.
+ *
+ *  This program and the accompanying materials
+ *  are licensed and made available under the terms and conditions of the BSD License
+ *  which accompanies this distribution.  The full text of the license may be found at
+ *  http://opensource.org/licenses/bsd-license.php
+ *
+ *  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+ *  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+ *
+ **/
+
+#include <Library/ArmPlatformLib.h>
+#include <Library/DebugLib.h>
+#include <IndustryStandard/Bcm2836.h>
+#include <Library/PcdLib.h>
+
+extern UINT64 mSystemMemoryEnd;
+extern UINT64 mGPUMemoryBase;
+extern UINT64 mGPUMemoryLength;
+
+#define VariablesSize (FixedPcdGet32(PcdFlashNvStorageVariableSize) +   \
+                       FixedPcdGet32(PcdFlashNvStorageFtwWorkingSize) + \
+                       FixedPcdGet32(PcdFlashNvStorageFtwSpareSize) +  \
+                       FixedPcdGet32(PcdNvStorageEventLogSize))
+
+#define VariablesBase (FixedPcdGet64(PcdFdBaseAddress) + \
+                       FixedPcdGet32(PcdFdSize) - \
+                       VariablesSize)
+
+#define ATFBase (FixedPcdGet64(PcdFdBaseAddress) + FixedPcdGet32(PcdFdSize))
+
+STATIC ARM_MEMORY_REGION_DESCRIPTOR RaspberryPiMemoryRegionDescriptor[] = {
+  {
+    /* Firmware Volume. */
+    FixedPcdGet64 (PcdFdBaseAddress), FixedPcdGet64 (PcdFdBaseAddress),
+    FixedPcdGet32 (PcdFdSize) - VariablesSize,
+    ARM_MEMORY_REGION_ATTRIBUTE_WRITE_BACK
+  },
+  {
+    /* Variables Volume. */
+    VariablesBase, VariablesBase,
+    VariablesSize,
+    ARM_MEMORY_REGION_ATTRIBUTE_WRITE_BACK
+  },
+  {
+    /* ATF reserved RAM. */
+    ATFBase, ATFBase,
+    FixedPcdGet64 (PcdSystemMemoryBase) - ATFBase,
+    ARM_MEMORY_REGION_ATTRIBUTE_WRITE_BACK
+  },
+  {
+    /* System RAM. */
+    FixedPcdGet64 (PcdSystemMemoryBase), FixedPcdGet64 (PcdSystemMemoryBase),
+    0,
+    ARM_MEMORY_REGION_ATTRIBUTE_WRITE_BACK
+  },
+  {
+    /* Reserved GPU RAM. */
+    0,
+    0,
+    0,
+    ARM_MEMORY_REGION_ATTRIBUTE_DEVICE
+  },
+  {
+    /* SOC registers. */
+    BCM2836_SOC_REGISTERS,
+    BCM2836_SOC_REGISTERS,
+    BCM2836_SOC_REGISTER_LENGTH,
+    ARM_MEMORY_REGION_ATTRIBUTE_DEVICE
+  },
+  {
+  }
+};
+
+/**
+  Return the Virtual Memory Map of your platform
+
+  This Virtual Memory Map is used by MemoryInitPei Module to initialize the MMU
+  on your platform.
+
+  @param[out]   VirtualMemoryMap    Array of ARM_MEMORY_REGION_DESCRIPTOR
+                                    describing a Physical-to-Virtual Memory
+                                    mapping. This array must be ended by a
+                                    zero-filled entry
+
+**/
+VOID
+ArmPlatformGetVirtualMemoryMap (
+  IN ARM_MEMORY_REGION_DESCRIPTOR** VirtualMemoryMap
+  )
+{
+  RaspberryPiMemoryRegionDescriptor[3].Length = mSystemMemoryEnd + 1 -
+    FixedPcdGet64 (PcdSystemMemoryBase);
+
+  RaspberryPiMemoryRegionDescriptor[4].PhysicalBase =
+    RaspberryPiMemoryRegionDescriptor[3].PhysicalBase +
+    RaspberryPiMemoryRegionDescriptor[3].Length;
+
+  RaspberryPiMemoryRegionDescriptor[4].VirtualBase =
+    RaspberryPiMemoryRegionDescriptor[4].PhysicalBase;
+
+  RaspberryPiMemoryRegionDescriptor[4].Length =
+    RaspberryPiMemoryRegionDescriptor[5].PhysicalBase -
+    RaspberryPiMemoryRegionDescriptor[4].PhysicalBase;
+
+  DEBUG ((DEBUG_INFO, "FD:\n"
+    "\tPhysicalBase: 0x%lX\n"
+    "\tVirtualBase: 0x%lX\n"
+    "\tLength: 0x%lX\n",
+    RaspberryPiMemoryRegionDescriptor[0].PhysicalBase,
+    RaspberryPiMemoryRegionDescriptor[0].VirtualBase,
+    RaspberryPiMemoryRegionDescriptor[0].Length +
+    RaspberryPiMemoryRegionDescriptor[1].Length));
+
+  DEBUG ((DEBUG_INFO, "Variables (part of FD):\n"
+    "\tPhysicalBase: 0x%lX\n"
+    "\tVirtualBase: 0x%lX\n"
+    "\tLength: 0x%lX\n",
+    RaspberryPiMemoryRegionDescriptor[1].PhysicalBase,
+    RaspberryPiMemoryRegionDescriptor[1].VirtualBase,
+    RaspberryPiMemoryRegionDescriptor[1].Length));
+
+  DEBUG ((DEBUG_INFO, "ATF RAM:\n"
+    "\tPhysicalBase: 0x%lX\n"
+    "\tVirtualBase: 0x%lX\n"
+    "\tLength: 0x%lX\n",
+    RaspberryPiMemoryRegionDescriptor[2].PhysicalBase,
+    RaspberryPiMemoryRegionDescriptor[2].VirtualBase,
+    RaspberryPiMemoryRegionDescriptor[2].Length));
+
+  DEBUG ((DEBUG_INFO, "System RAM:\n"
+    "\tPhysicalBase: 0x%lX\n"
+    "\tVirtualBase: 0x%lX\n"
+    "\tLength: 0x%lX\n",
+    RaspberryPiMemoryRegionDescriptor[3].PhysicalBase,
+    RaspberryPiMemoryRegionDescriptor[3].VirtualBase,
+    RaspberryPiMemoryRegionDescriptor[3].Length));
+
+  DEBUG ((DEBUG_INFO, "GPU Reserved:\n"
+    "\tPhysicalBase: 0x%lX\n"
+    "\tVirtualBase: 0x%lX\n"
+    "\tLength: 0x%lX\n",
+    RaspberryPiMemoryRegionDescriptor[4].PhysicalBase,
+    RaspberryPiMemoryRegionDescriptor[4].VirtualBase,
+    RaspberryPiMemoryRegionDescriptor[4].Length));
+
+  DEBUG ((DEBUG_INFO, "SoC reserved:\n"
+    "\tPhysicalBase: 0x%lX\n"
+    "\tVirtualBase: 0x%lX\n"
+    "\tLength: 0x%lX\n",
+    RaspberryPiMemoryRegionDescriptor[5].PhysicalBase,
+    RaspberryPiMemoryRegionDescriptor[5].VirtualBase,
+    RaspberryPiMemoryRegionDescriptor[5].Length));
+
+  *VirtualMemoryMap = RaspberryPiMemoryRegionDescriptor;
+}
-- 
2.17.0.windows.1



^ permalink raw reply related	[flat|nested] 34+ messages in thread

* [PATCH v5 edk2-platforms 06/22] Platform/RaspberryPi/RPi3: Add firmware driver
  2019-02-05 16:25 [PATCH v5 edk2-platforms 00/22] Platform/RaspberryPi: Add Raspberry Pi 3 support Pete Batard
                   ` (4 preceding siblings ...)
  2019-02-05 16:25 ` [PATCH v5 edk2-platforms 05/22] Platform/RaspberryPi/RPi3: Add platform library Pete Batard
@ 2019-02-05 16:25 ` Pete Batard
  2019-02-05 16:25 ` [PATCH v5 edk2-platforms 07/22] Platform/RaspberryPi/RPi3: Add platform config driver Pete Batard
                   ` (17 subsequent siblings)
  23 siblings, 0 replies; 34+ messages in thread
From: Pete Batard @ 2019-02-05 16:25 UTC (permalink / raw)
  To: edk2-devel

Implements the base driver that is used to provide or set platform
specific configuration data.

Contributed-under: TianoCore Contribution Agreement 1.1
Signed-off-by: Pete Batard <pete@akeo.ie>

Reviewed-by: Ard Biesheuvel <ard.biesheuvel@linaro.org>
---
 Platform/RaspberryPi/RPi3/Drivers/RpiFirmwareDxe/RpiFirmwareDxe.c   | 1084 ++++++++++++++++++++
 Platform/RaspberryPi/RPi3/Drivers/RpiFirmwareDxe/RpiFirmwareDxe.inf |   50 +
 Platform/RaspberryPi/RPi3/Include/Protocol/RpiFirmware.h            |  131 +++
 3 files changed, 1265 insertions(+)

diff --git a/Platform/RaspberryPi/RPi3/Drivers/RpiFirmwareDxe/RpiFirmwareDxe.c b/Platform/RaspberryPi/RPi3/Drivers/RpiFirmwareDxe/RpiFirmwareDxe.c
new file mode 100644
index 000000000000..d330e45fdc4c
--- /dev/null
+++ b/Platform/RaspberryPi/RPi3/Drivers/RpiFirmwareDxe/RpiFirmwareDxe.c
@@ -0,0 +1,1084 @@
+/** @file
+ *
+ *  Copyright (c) 2017-2018, Andrei Warkentin <andrey.warkentin@gmail.com>
+ *  Copyright (c) 2016, Linaro, Ltd. All rights reserved.
+ *
+ *  This program and the accompanying materials
+ *  are licensed and made available under the terms and conditions of the BSD License
+ *  which accompanies this distribution.  The full text of the license may be found at
+ *  http://opensource.org/licenses/bsd-license.php
+ *
+ *  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+ *  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+ *
+ **/
+
+#include <PiDxe.h>
+
+#include <Library/ArmLib.h>
+#include <Library/DmaLib.h>
+#include <Library/BaseLib.h>
+#include <Library/BaseMemoryLib.h>
+#include <Library/DebugLib.h>
+#include <Library/IoLib.h>
+#include <Library/SynchronizationLib.h>
+#include <Library/UefiBootServicesTableLib.h>
+#include <Library/UefiLib.h>
+
+#include <IndustryStandard/Bcm2836.h>
+#include <IndustryStandard/RpiMbox.h>
+
+#include <Protocol/RpiFirmware.h>
+
+//
+// The number of statically allocated buffer pages
+//
+#define NUM_PAGES   1
+
+//
+// The number of iterations to perform when waiting for the mailbox
+// status to change
+//
+#define MAX_TRIES   0x100000
+
+STATIC VOID  *mDmaBuffer;
+STATIC VOID  *mDmaBufferMapping;
+STATIC UINTN mDmaBufferBusAddress;
+
+STATIC SPIN_LOCK mMailboxLock;
+
+STATIC
+BOOLEAN
+DrainMailbox (
+  VOID
+  )
+{
+  INTN    Tries;
+  UINT32  Val;
+
+  //
+  // Get rid of stale response data in the mailbox
+  //
+  Tries = 0;
+  do {
+    Val = MmioRead32 (BCM2836_MBOX_BASE_ADDRESS + BCM2836_MBOX_STATUS_OFFSET);
+    if (Val & (1U << BCM2836_MBOX_STATUS_EMPTY)) {
+      return TRUE;
+    }
+    ArmDataSynchronizationBarrier ();
+    MmioRead32 (BCM2836_MBOX_BASE_ADDRESS + BCM2836_MBOX_READ_OFFSET);
+  } while (++Tries < MAX_TRIES);
+
+  return FALSE;
+}
+
+STATIC
+BOOLEAN
+MailboxWaitForStatusCleared (
+  IN  UINTN   StatusMask
+  )
+{
+  INTN    Tries;
+  UINT32  Val;
+
+  //
+  // Get rid of stale response data in the mailbox
+  //
+  Tries = 0;
+  do {
+    Val = MmioRead32 (BCM2836_MBOX_BASE_ADDRESS + BCM2836_MBOX_STATUS_OFFSET);
+    if ((Val & StatusMask) == 0) {
+      return TRUE;
+    }
+    ArmDataSynchronizationBarrier ();
+  } while (++Tries < MAX_TRIES);
+
+  return FALSE;
+}
+
+STATIC
+EFI_STATUS
+MailboxTransaction (
+  IN    UINTN   Length,
+  IN    UINTN   Channel,
+  OUT   UINT32  *Result
+  )
+{
+  if (Channel >= BCM2836_MBOX_NUM_CHANNELS) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  //
+  // Get rid of stale response data in the mailbox
+  //
+  if (!DrainMailbox ()) {
+    DEBUG ((DEBUG_ERROR, "%a: timeout waiting for mailbox to drain\n",
+      __FUNCTION__));
+    return EFI_TIMEOUT;
+  }
+
+  //
+  // Wait for the 'output register full' bit to become clear
+  //
+  if (!MailboxWaitForStatusCleared (1U << BCM2836_MBOX_STATUS_FULL)) {
+    DEBUG ((DEBUG_ERROR, "%a: timeout waiting for outbox to become empty\n",
+      __FUNCTION__));
+    return EFI_TIMEOUT;
+  }
+
+  ArmDataSynchronizationBarrier ();
+
+  //
+  // Start the mailbox transaction
+  //
+  MmioWrite32 (BCM2836_MBOX_BASE_ADDRESS + BCM2836_MBOX_WRITE_OFFSET,
+    (UINT32)((UINTN)mDmaBufferBusAddress | Channel));
+
+  ArmDataSynchronizationBarrier ();
+
+  //
+  // Wait for the 'input register empty' bit to clear
+  //
+  if (!MailboxWaitForStatusCleared (1U << BCM2836_MBOX_STATUS_EMPTY)) {
+    DEBUG ((DEBUG_ERROR, "%a: timeout waiting for inbox to become full\n",
+      __FUNCTION__));
+    return EFI_TIMEOUT;
+  }
+
+  //
+  // Read back the result
+  //
+  ArmDataSynchronizationBarrier ();
+  *Result = MmioRead32 (BCM2836_MBOX_BASE_ADDRESS + BCM2836_MBOX_READ_OFFSET);
+  ArmDataSynchronizationBarrier ();
+
+  return EFI_SUCCESS;
+}
+
+#pragma pack(1)
+typedef struct {
+  UINT32    BufferSize;
+  UINT32    Response;
+} RPI_FW_BUFFER_HEAD;
+
+typedef struct {
+  UINT32    TagId;
+  UINT32    TagSize;
+  UINT32    TagValueSize;
+} RPI_FW_TAG_HEAD;
+
+typedef struct {
+  UINT32                    DeviceId;
+  UINT32                    PowerState;
+} RPI_FW_POWER_STATE_TAG;
+
+typedef struct {
+  RPI_FW_BUFFER_HEAD        BufferHead;
+  RPI_FW_TAG_HEAD           TagHead;
+  RPI_FW_POWER_STATE_TAG    TagBody;
+  UINT32                    EndTag;
+} RPI_FW_SET_POWER_STATE_CMD;
+#pragma pack()
+
+STATIC
+EFI_STATUS
+EFIAPI
+RpiFirmwareSetPowerState (
+  IN  UINT32    DeviceId,
+  IN  BOOLEAN   PowerState,
+  IN  BOOLEAN   Wait
+  )
+{
+  RPI_FW_SET_POWER_STATE_CMD  *Cmd;
+  EFI_STATUS                  Status;
+  UINT32                      Result;
+
+  if (!AcquireSpinLockOrFail (&mMailboxLock)) {
+    DEBUG ((DEBUG_ERROR, "%a: failed to acquire spinlock\n", __FUNCTION__));
+    return EFI_DEVICE_ERROR;
+  }
+
+  Cmd = mDmaBuffer;
+  ZeroMem (Cmd, sizeof (*Cmd));
+
+  Cmd->BufferHead.BufferSize  = sizeof (*Cmd);
+  Cmd->BufferHead.Response    = 0;
+  Cmd->TagHead.TagId          = RPI_MBOX_SET_POWER_STATE;
+  Cmd->TagHead.TagSize        = sizeof (Cmd->TagBody);
+  Cmd->TagHead.TagValueSize   = 0;
+  Cmd->TagBody.DeviceId       = DeviceId;
+  Cmd->TagBody.PowerState     = (PowerState ? RPI_MBOX_POWER_STATE_ENABLE : 0) |
+                                (Wait ? RPI_MBOX_POWER_STATE_WAIT : 0);
+  Cmd->EndTag                 = 0;
+
+  Status = MailboxTransaction (Cmd->BufferHead.BufferSize, RPI_MBOX_VC_CHANNEL, &Result);
+
+  ReleaseSpinLock (&mMailboxLock);
+
+  if (EFI_ERROR (Status) ||
+      Cmd->BufferHead.Response != RPI_MBOX_RESP_SUCCESS) {
+    DEBUG ((DEBUG_ERROR,
+      "%a: mailbox transaction error: Status == %r, Response == 0x%x\n",
+      __FUNCTION__, Status, Cmd->BufferHead.Response));
+    Status = EFI_DEVICE_ERROR;
+  }
+
+  if (!EFI_ERROR (Status) &&
+      PowerState ^ (Cmd->TagBody.PowerState & RPI_MBOX_POWER_STATE_ENABLE)) {
+    DEBUG ((DEBUG_ERROR, "%a: failed to %sable power for device %d\n",
+      __FUNCTION__, PowerState ? "en" : "dis", DeviceId));
+    Status = EFI_DEVICE_ERROR;
+  }
+
+  return Status;
+}
+
+#pragma pack()
+typedef struct {
+  UINT32                    Base;
+  UINT32                    Size;
+} RPI_FW_ARM_MEMORY_TAG;
+
+typedef struct {
+  RPI_FW_BUFFER_HEAD        BufferHead;
+  RPI_FW_TAG_HEAD           TagHead;
+  RPI_FW_ARM_MEMORY_TAG     TagBody;
+  UINT32                    EndTag;
+} RPI_FW_GET_ARM_MEMORY_CMD;
+#pragma pack()
+
+STATIC
+EFI_STATUS
+EFIAPI
+RpiFirmwareGetArmMemory (
+  OUT   UINT32 *Base,
+  OUT   UINT32 *Size
+  )
+{
+  RPI_FW_GET_ARM_MEMORY_CMD   *Cmd;
+  EFI_STATUS                  Status;
+  UINT32                      Result;
+
+  if (!AcquireSpinLockOrFail (&mMailboxLock)) {
+    DEBUG ((DEBUG_ERROR, "%a: failed to acquire spinlock\n", __FUNCTION__));
+    return EFI_DEVICE_ERROR;
+  }
+
+  Cmd = mDmaBuffer;
+  ZeroMem (Cmd, sizeof (*Cmd));
+
+  Cmd->BufferHead.BufferSize  = sizeof (*Cmd);
+  Cmd->BufferHead.Response    = 0;
+  Cmd->TagHead.TagId          = RPI_MBOX_GET_ARM_MEMSIZE;
+  Cmd->TagHead.TagSize        = sizeof (Cmd->TagBody);
+  Cmd->TagHead.TagValueSize   = 0;
+  Cmd->EndTag                 = 0;
+
+  Status = MailboxTransaction (Cmd->BufferHead.BufferSize, RPI_MBOX_VC_CHANNEL, &Result);
+
+  ReleaseSpinLock (&mMailboxLock);
+
+  if (EFI_ERROR (Status) ||
+      Cmd->BufferHead.Response != RPI_MBOX_RESP_SUCCESS) {
+    DEBUG ((DEBUG_ERROR,
+      "%a: mailbox transaction error: Status == %r, Response == 0x%x\n",
+      __FUNCTION__, Status, Cmd->BufferHead.Response));
+    return EFI_DEVICE_ERROR;
+  }
+
+  *Base = Cmd->TagBody.Base;
+  *Size = Cmd->TagBody.Size;
+  return EFI_SUCCESS;
+}
+
+#pragma pack()
+typedef struct {
+  UINT8                     MacAddress[6];
+  UINT32                    Padding;
+} RPI_FW_MAC_ADDR_TAG;
+
+typedef struct {
+  RPI_FW_BUFFER_HEAD        BufferHead;
+  RPI_FW_TAG_HEAD           TagHead;
+  RPI_FW_MAC_ADDR_TAG       TagBody;
+  UINT32                    EndTag;
+} RPI_FW_GET_MAC_ADDR_CMD;
+#pragma pack()
+
+STATIC
+EFI_STATUS
+EFIAPI
+RpiFirmwareGetMacAddress (
+  OUT   UINT8   MacAddress[6]
+  )
+{
+  RPI_FW_GET_MAC_ADDR_CMD     *Cmd;
+  EFI_STATUS                  Status;
+  UINT32                      Result;
+
+  if (!AcquireSpinLockOrFail (&mMailboxLock)) {
+    DEBUG ((DEBUG_ERROR, "%a: failed to acquire spinlock\n", __FUNCTION__));
+    return EFI_DEVICE_ERROR;
+  }
+
+  Cmd = mDmaBuffer;
+  ZeroMem (Cmd, sizeof (*Cmd));
+
+  Cmd->BufferHead.BufferSize  = sizeof (*Cmd);
+  Cmd->BufferHead.Response    = 0;
+  Cmd->TagHead.TagId          = RPI_MBOX_GET_MAC_ADDRESS;
+  Cmd->TagHead.TagSize        = sizeof (Cmd->TagBody);
+  Cmd->TagHead.TagValueSize   = 0;
+  Cmd->EndTag                 = 0;
+
+  Status = MailboxTransaction (Cmd->BufferHead.BufferSize, RPI_MBOX_VC_CHANNEL, &Result);
+
+  ReleaseSpinLock (&mMailboxLock);
+
+  if (EFI_ERROR (Status) ||
+      Cmd->BufferHead.Response != RPI_MBOX_RESP_SUCCESS) {
+    DEBUG ((DEBUG_ERROR,
+      "%a: mailbox transaction error: Status == %r, Response == 0x%x\n",
+      __FUNCTION__, Status, Cmd->BufferHead.Response));
+    return EFI_DEVICE_ERROR;
+  }
+
+  CopyMem (MacAddress, Cmd->TagBody.MacAddress, sizeof (Cmd->TagBody.MacAddress));
+  return EFI_SUCCESS;
+}
+
+#pragma pack()
+typedef struct {
+  UINT64                    Serial;
+} RPI_FW_SERIAL_TAG;
+
+typedef struct {
+  RPI_FW_BUFFER_HEAD        BufferHead;
+  RPI_FW_TAG_HEAD           TagHead;
+  RPI_FW_SERIAL_TAG         TagBody;
+  UINT32                    EndTag;
+} RPI_FW_GET_SERIAL_CMD;
+#pragma pack()
+
+STATIC
+EFI_STATUS
+EFIAPI
+RpiFirmwareGetSerial (
+  OUT   UINT64 *Serial
+  )
+{
+  RPI_FW_GET_SERIAL_CMD       *Cmd;
+  EFI_STATUS                  Status;
+  UINT32                      Result;
+
+  if (!AcquireSpinLockOrFail (&mMailboxLock)) {
+    DEBUG ((DEBUG_ERROR, "%a: failed to acquire spinlock\n", __FUNCTION__));
+    return EFI_DEVICE_ERROR;
+  }
+
+  Cmd = mDmaBuffer;
+  ZeroMem (Cmd, sizeof (*Cmd));
+
+  Cmd->BufferHead.BufferSize  = sizeof (*Cmd);
+  Cmd->BufferHead.Response    = 0;
+  Cmd->TagHead.TagId          = RPI_MBOX_GET_BOARD_SERIAL;
+  Cmd->TagHead.TagSize        = sizeof (Cmd->TagBody);
+  Cmd->TagHead.TagValueSize   = 0;
+  Cmd->EndTag                 = 0;
+
+  Status = MailboxTransaction (Cmd->BufferHead.BufferSize, RPI_MBOX_VC_CHANNEL, &Result);
+
+  ReleaseSpinLock (&mMailboxLock);
+
+  if (EFI_ERROR (Status) ||
+      Cmd->BufferHead.Response != RPI_MBOX_RESP_SUCCESS) {
+    DEBUG ((DEBUG_ERROR,
+      "%a: mailbox transaction error: Status == %r, Response == 0x%x\n",
+      __FUNCTION__, Status, Cmd->BufferHead.Response));
+    return EFI_DEVICE_ERROR;
+  }
+
+  *Serial = Cmd->TagBody.Serial;
+  return EFI_SUCCESS;
+}
+
+#pragma pack()
+typedef struct {
+  UINT32                    Model;
+} RPI_FW_MODEL_TAG;
+
+typedef struct {
+  RPI_FW_BUFFER_HEAD        BufferHead;
+  RPI_FW_TAG_HEAD           TagHead;
+  RPI_FW_MODEL_TAG          TagBody;
+  UINT32                    EndTag;
+} RPI_FW_GET_MODEL_CMD;
+#pragma pack()
+
+STATIC
+EFI_STATUS
+EFIAPI
+RpiFirmwareGetModel (
+  OUT   UINT32 *Model
+  )
+{
+  RPI_FW_GET_MODEL_CMD       *Cmd;
+  EFI_STATUS                  Status;
+  UINT32                      Result;
+
+  if (!AcquireSpinLockOrFail (&mMailboxLock)) {
+    DEBUG ((DEBUG_ERROR, "%a: failed to acquire spinlock\n", __FUNCTION__));
+    return EFI_DEVICE_ERROR;
+  }
+
+  Cmd = mDmaBuffer;
+  ZeroMem (Cmd, sizeof (*Cmd));
+
+  Cmd->BufferHead.BufferSize  = sizeof (*Cmd);
+  Cmd->BufferHead.Response    = 0;
+  Cmd->TagHead.TagId          = RPI_MBOX_GET_BOARD_MODEL;
+  Cmd->TagHead.TagSize        = sizeof (Cmd->TagBody);
+  Cmd->TagHead.TagValueSize   = 0;
+  Cmd->EndTag                 = 0;
+
+  Status = MailboxTransaction (Cmd->BufferHead.BufferSize, RPI_MBOX_VC_CHANNEL, &Result);
+
+  ReleaseSpinLock (&mMailboxLock);
+
+  if (EFI_ERROR (Status) ||
+      Cmd->BufferHead.Response != RPI_MBOX_RESP_SUCCESS) {
+    DEBUG ((DEBUG_ERROR,
+      "%a: mailbox transaction error: Status == %r, Response == 0x%x\n",
+      __FUNCTION__, Status, Cmd->BufferHead.Response));
+    return EFI_DEVICE_ERROR;
+  }
+
+  *Model = Cmd->TagBody.Model;
+  return EFI_SUCCESS;
+}
+
+#pragma pack()
+typedef struct {
+  UINT32                    Revision;
+} RPI_FW_MODEL_REVISION_TAG;
+
+typedef struct {
+  RPI_FW_BUFFER_HEAD        BufferHead;
+  RPI_FW_TAG_HEAD           TagHead;
+  RPI_FW_MODEL_REVISION_TAG TagBody;
+  UINT32                    EndTag;
+} RPI_FW_GET_MODEL_REVISION_CMD;
+#pragma pack()
+
+STATIC
+EFI_STATUS
+EFIAPI
+RpiFirmwareGetModelRevision (
+  OUT   UINT32 *Revision
+  )
+{
+  RPI_FW_GET_MODEL_REVISION_CMD *Cmd;
+  EFI_STATUS                    Status;
+  UINT32                        Result;
+
+  if (!AcquireSpinLockOrFail (&mMailboxLock)) {
+    DEBUG ((DEBUG_ERROR, "%a: failed to acquire spinlock\n", __FUNCTION__));
+    return EFI_DEVICE_ERROR;
+  }
+
+  Cmd = mDmaBuffer;
+  ZeroMem (Cmd, sizeof (*Cmd));
+
+  Cmd->BufferHead.BufferSize  = sizeof (*Cmd);
+  Cmd->BufferHead.Response    = 0;
+  Cmd->TagHead.TagId          = RPI_MBOX_GET_BOARD_REVISION;
+  Cmd->TagHead.TagSize        = sizeof (Cmd->TagBody);
+  Cmd->TagHead.TagValueSize   = 0;
+  Cmd->EndTag                 = 0;
+
+  Status = MailboxTransaction (Cmd->BufferHead.BufferSize, RPI_MBOX_VC_CHANNEL, &Result);
+
+  ReleaseSpinLock (&mMailboxLock);
+
+  if (EFI_ERROR (Status) ||
+      Cmd->BufferHead.Response != RPI_MBOX_RESP_SUCCESS) {
+    DEBUG ((DEBUG_ERROR,
+      "%a: mailbox transaction error: Status == %r, Response == 0x%x\n",
+      __FUNCTION__, Status, Cmd->BufferHead.Response));
+    return EFI_DEVICE_ERROR;
+  }
+
+  *Revision = Cmd->TagBody.Revision;
+  return EFI_SUCCESS;
+}
+
+#pragma pack()
+typedef struct {
+  UINT32 Width;
+  UINT32 Height;
+} RPI_FW_FB_SIZE_TAG;
+
+typedef struct {
+  RPI_FW_BUFFER_HEAD        BufferHead;
+  RPI_FW_TAG_HEAD           TagHead;
+  RPI_FW_FB_SIZE_TAG        TagBody;
+  UINT32                    EndTag;
+} RPI_FW_GET_FB_SIZE_CMD;
+
+typedef struct {
+  UINT32 Depth;
+} RPI_FW_FB_DEPTH_TAG;
+
+typedef struct {
+  UINT32 Pitch;
+} RPI_FW_FB_PITCH_TAG;
+
+typedef struct {
+  UINT32 AlignmentBase;
+  UINT32 Size;
+} RPI_FW_FB_ALLOC_TAG;
+
+typedef struct {
+  RPI_FW_BUFFER_HEAD        BufferHead;
+  RPI_FW_TAG_HEAD           FreeFbTag;
+  UINT32                    EndTag;
+} RPI_FW_FREE_FB_CMD;
+
+typedef struct {
+  RPI_FW_BUFFER_HEAD        BufferHead;
+  RPI_FW_TAG_HEAD           PhysSizeTag;
+  RPI_FW_FB_SIZE_TAG        PhysSize;
+  RPI_FW_TAG_HEAD           VirtSizeTag;
+  RPI_FW_FB_SIZE_TAG        VirtSize;
+  RPI_FW_TAG_HEAD           DepthTag;
+  RPI_FW_FB_DEPTH_TAG       Depth;
+  RPI_FW_TAG_HEAD           AllocFbTag;
+  RPI_FW_FB_ALLOC_TAG       AllocFb;
+  RPI_FW_TAG_HEAD           PitchTag;
+  RPI_FW_FB_PITCH_TAG       Pitch;
+  UINT32                    EndTag;
+} RPI_FW_INIT_FB_CMD;
+#pragma pack()
+
+STATIC
+EFI_STATUS
+EFIAPI
+RpiFirmwareGetFbSize (
+  OUT   UINT32 *Width,
+  OUT   UINT32 *Height
+  )
+{
+  RPI_FW_GET_FB_SIZE_CMD     *Cmd;
+  EFI_STATUS                  Status;
+  UINT32                      Result;
+
+  if (!AcquireSpinLockOrFail (&mMailboxLock)) {
+    DEBUG ((DEBUG_ERROR, "%a: failed to acquire spinlock\n", __FUNCTION__));
+    return EFI_DEVICE_ERROR;
+  }
+
+  Cmd = mDmaBuffer;
+  ZeroMem (Cmd, sizeof (*Cmd));
+
+  Cmd->BufferHead.BufferSize  = sizeof (*Cmd);
+  Cmd->BufferHead.Response    = 0;
+  Cmd->TagHead.TagId          = RPI_MBOX_GET_FB_GEOMETRY;
+  Cmd->TagHead.TagSize        = sizeof (Cmd->TagBody);
+  Cmd->TagHead.TagValueSize   = 0;
+  Cmd->EndTag                 = 0;
+
+  Status = MailboxTransaction (Cmd->BufferHead.BufferSize, RPI_MBOX_VC_CHANNEL, &Result);
+
+  ReleaseSpinLock (&mMailboxLock);
+
+  if (EFI_ERROR (Status) ||
+      Cmd->BufferHead.Response != RPI_MBOX_RESP_SUCCESS) {
+    DEBUG ((DEBUG_ERROR,
+      "%a: mailbox  transaction error: Status == %r, Response == 0x%x\n",
+      __FUNCTION__, Status, Cmd->BufferHead.Response));
+    return EFI_DEVICE_ERROR;
+  }
+
+  *Width = Cmd->TagBody.Width;
+  *Height = Cmd->TagBody.Height;
+  return EFI_SUCCESS;
+}
+
+STATIC
+EFI_STATUS
+EFIAPI
+RpiFirmwareFreeFb (VOID)
+{
+  RPI_FW_FREE_FB_CMD *Cmd;
+  EFI_STATUS         Status;
+  UINT32             Result;
+
+  if (!AcquireSpinLockOrFail (&mMailboxLock)) {
+    DEBUG ((DEBUG_ERROR, "%a: failed to acquire spinlock\n", __FUNCTION__));
+    return EFI_DEVICE_ERROR;
+  }
+
+  Cmd = mDmaBuffer;
+  ZeroMem (Cmd, sizeof (*Cmd));
+
+  Cmd->BufferHead.BufferSize   = sizeof (*Cmd);
+  Cmd->BufferHead.Response     = 0;
+
+  Cmd->FreeFbTag.TagId         = RPI_MBOX_FREE_FB;
+  Cmd->FreeFbTag.TagSize       = 0;
+  Cmd->FreeFbTag.TagValueSize  = 0;
+  Cmd->EndTag                  = 0;
+
+  Status = MailboxTransaction (Cmd->BufferHead.BufferSize, RPI_MBOX_VC_CHANNEL, &Result);
+  ReleaseSpinLock (&mMailboxLock);
+
+  if (EFI_ERROR (Status) ||
+      Cmd->BufferHead.Response != RPI_MBOX_RESP_SUCCESS) {
+    DEBUG ((DEBUG_ERROR,
+      "%a: mailbox transaction error: Status == %r, Response == 0x%x\n",
+      __FUNCTION__, Status, Cmd->BufferHead.Response));
+    return EFI_DEVICE_ERROR;
+  }
+
+  return EFI_SUCCESS;
+}
+
+STATIC
+EFI_STATUS
+EFIAPI
+RpiFirmwareAllocFb (
+  IN  UINT32 Width,
+  IN  UINT32 Height,
+  IN  UINT32 Depth,
+  OUT EFI_PHYSICAL_ADDRESS *FbBase,
+  OUT UINTN *FbSize,
+  OUT UINTN *Pitch
+  )
+{
+  RPI_FW_INIT_FB_CMD *Cmd;
+  EFI_STATUS         Status;
+  UINT32             Result;
+
+  ASSERT (FbSize != NULL);
+  ASSERT (FbBase != NULL);
+
+  if (!AcquireSpinLockOrFail (&mMailboxLock)) {
+    DEBUG ((DEBUG_ERROR, "%a: failed to acquire spinlock\n", __FUNCTION__));
+    return EFI_DEVICE_ERROR;
+  }
+
+  Cmd = mDmaBuffer;
+  ZeroMem (Cmd, sizeof (*Cmd));
+
+  Cmd->BufferHead.BufferSize  = sizeof (*Cmd);
+  Cmd->BufferHead.Response    = 0;
+
+  Cmd->PhysSizeTag.TagId      = RPI_MBOX_SET_FB_PGEOM;
+  Cmd->PhysSizeTag.TagSize    = sizeof (Cmd->PhysSize);
+  Cmd->PhysSize.Width         = Width;
+  Cmd->PhysSize.Height        = Height;
+  Cmd->VirtSizeTag.TagId      = RPI_MBOX_SET_FB_VGEOM;
+  Cmd->VirtSizeTag.TagSize    = sizeof (Cmd->VirtSize);
+  Cmd->VirtSize.Width         = Width;
+  Cmd->VirtSize.Height        = Height;
+  Cmd->DepthTag.TagId         = RPI_MBOX_SET_FB_DEPTH;
+  Cmd->DepthTag.TagSize       = sizeof (Cmd->Depth);
+  Cmd->Depth.Depth            = Depth;
+  Cmd->AllocFbTag.TagId       = RPI_MBOX_ALLOC_FB;
+  Cmd->AllocFbTag.TagSize     = sizeof (Cmd->AllocFb);
+  Cmd->AllocFb.AlignmentBase  = 32;
+  Cmd->PitchTag.TagId         = RPI_MBOX_GET_FB_LINELENGTH;
+  Cmd->PitchTag.TagSize       = sizeof (Cmd->Pitch);
+  Cmd->EndTag                 = 0;
+
+  Status = MailboxTransaction (Cmd->BufferHead.BufferSize, RPI_MBOX_VC_CHANNEL, &Result);
+
+  ReleaseSpinLock (&mMailboxLock);
+
+  if (EFI_ERROR (Status) ||
+      Cmd->BufferHead.Response != RPI_MBOX_RESP_SUCCESS) {
+    DEBUG ((DEBUG_ERROR,
+      "%a: mailbox transaction error: Status == %r, Response == 0x%x\n",
+      __FUNCTION__, Status, Cmd->BufferHead.Response));
+    return EFI_DEVICE_ERROR;
+  }
+
+  *Pitch = Cmd->Pitch.Pitch;
+  *FbBase = Cmd->AllocFb.AlignmentBase - BCM2836_DMA_DEVICE_OFFSET;
+  *FbSize = Cmd->AllocFb.Size;
+  return EFI_SUCCESS;
+}
+
+#pragma pack()
+typedef struct {
+  RPI_FW_BUFFER_HEAD        BufferHead;
+  RPI_FW_TAG_HEAD           TagHead;
+  UINT8                     CommandLine[0];
+} RPI_FW_GET_COMMAND_LINE_CMD;
+#pragma pack()
+
+STATIC
+EFI_STATUS
+EFIAPI
+RpiFirmwareGetCommmandLine (
+  IN  UINTN               BufferSize,
+  OUT CHAR8               CommandLine[]
+  )
+{
+  RPI_FW_GET_COMMAND_LINE_CMD  *Cmd;
+  EFI_STATUS                    Status;
+  UINT32                        Result;
+
+  if ((BufferSize % sizeof (UINT32)) != 0) {
+    DEBUG ((DEBUG_ERROR, "%a: BufferSize must be a multiple of 4\n",
+      __FUNCTION__));
+    return EFI_INVALID_PARAMETER;
+  }
+
+  if (sizeof (*Cmd) + BufferSize > EFI_PAGES_TO_SIZE (NUM_PAGES)) {
+    DEBUG ((DEBUG_ERROR, "%a: BufferSize exceeds size of DMA buffer\n",
+      __FUNCTION__));
+    return EFI_OUT_OF_RESOURCES;
+  }
+
+  if (!AcquireSpinLockOrFail (&mMailboxLock)) {
+    DEBUG ((DEBUG_ERROR, "%a: failed to acquire spinlock\n", __FUNCTION__));
+    return EFI_DEVICE_ERROR;
+  }
+
+  Cmd = mDmaBuffer;
+  ZeroMem (Cmd, sizeof (*Cmd) + BufferSize + sizeof (UINT32));
+
+  Cmd->BufferHead.BufferSize  = sizeof (*Cmd) + BufferSize + sizeof (UINT32);
+  Cmd->BufferHead.Response    = 0;
+  Cmd->TagHead.TagId          = RPI_MBOX_GET_COMMAND_LINE;
+  Cmd->TagHead.TagSize        = BufferSize;
+  Cmd->TagHead.TagValueSize   = 0;
+
+  Status = MailboxTransaction (Cmd->BufferHead.BufferSize, RPI_MBOX_VC_CHANNEL, &Result);
+
+  ReleaseSpinLock (&mMailboxLock);
+
+  if (EFI_ERROR (Status) ||
+      Cmd->BufferHead.Response != RPI_MBOX_RESP_SUCCESS) {
+    DEBUG ((DEBUG_ERROR,
+      "%a: mailbox transaction error: Status == %r, Response == 0x%x\n",
+      __FUNCTION__, Status, Cmd->BufferHead.Response));
+    return EFI_DEVICE_ERROR;
+  }
+
+  Cmd->TagHead.TagValueSize &= ~RPI_MBOX_VALUE_SIZE_RESPONSE_MASK;
+  if (Cmd->TagHead.TagValueSize >= BufferSize &&
+      Cmd->CommandLine[Cmd->TagHead.TagValueSize - 1] != '\0') {
+    DEBUG ((DEBUG_ERROR, "%a: insufficient buffer size\n", __FUNCTION__));
+    return EFI_OUT_OF_RESOURCES;
+  }
+
+  CopyMem (CommandLine, Cmd->CommandLine, Cmd->TagHead.TagValueSize);
+
+  if (CommandLine[Cmd->TagHead.TagValueSize - 1] != '\0') {
+    //
+    // Add a NUL terminator if required.
+    //
+    CommandLine[Cmd->TagHead.TagValueSize] = '\0';
+  }
+
+  return EFI_SUCCESS;
+}
+
+#pragma pack()
+typedef struct {
+  UINT32                    ClockId;
+  UINT32                    ClockRate;
+  UINT32                    SkipTurbo;
+} RPI_FW_SET_CLOCK_RATE_TAG;
+
+typedef struct {
+  RPI_FW_BUFFER_HEAD        BufferHead;
+  RPI_FW_TAG_HEAD           TagHead;
+  RPI_FW_SET_CLOCK_RATE_TAG TagBody;
+  UINT32                    EndTag;
+} RPI_FW_SET_CLOCK_RATE_CMD;
+#pragma pack()
+
+STATIC
+EFI_STATUS
+EFIAPI
+RpiFirmwareSetClockRate (
+  IN  UINT32 ClockId,
+  IN  UINT32 ClockRate
+  )
+{
+  RPI_FW_SET_CLOCK_RATE_CMD   *Cmd;
+  EFI_STATUS                  Status;
+  UINT32                      Result;
+
+  if (!AcquireSpinLockOrFail (&mMailboxLock)) {
+    DEBUG ((DEBUG_ERROR, "%a: failed to acquire spinlock\n", __FUNCTION__));
+    return EFI_DEVICE_ERROR;
+  }
+
+  Cmd = mDmaBuffer;
+  ZeroMem (Cmd, sizeof (*Cmd));
+
+  Cmd->BufferHead.BufferSize  = sizeof (*Cmd);
+  Cmd->BufferHead.Response    = 0;
+  Cmd->TagHead.TagId          = RPI_MBOX_SET_CLOCK_RATE;
+  Cmd->TagHead.TagSize        = sizeof (Cmd->TagBody);
+  Cmd->TagHead.TagValueSize   = 0;
+  Cmd->TagBody.ClockId        = ClockId;
+  Cmd->TagBody.ClockRate      = ClockRate;
+  Cmd->EndTag                 = 0;
+
+  Status = MailboxTransaction (Cmd->BufferHead.BufferSize, RPI_MBOX_VC_CHANNEL, &Result);
+
+  ReleaseSpinLock (&mMailboxLock);
+
+  if (EFI_ERROR (Status) ||
+      Cmd->BufferHead.Response != RPI_MBOX_RESP_SUCCESS) {
+    DEBUG ((DEBUG_ERROR,
+      "%a: mailbox transaction error: Status == %r, Response == 0x%x\n",
+      __FUNCTION__, Status, Cmd->BufferHead.Response));
+    return EFI_DEVICE_ERROR;
+  }
+
+  return EFI_SUCCESS;
+}
+
+
+#pragma pack()
+typedef struct {
+  UINT32                    ClockId;
+  UINT32                    ClockRate;
+} RPI_FW_CLOCK_RATE_TAG;
+
+typedef struct {
+  RPI_FW_BUFFER_HEAD        BufferHead;
+  RPI_FW_TAG_HEAD           TagHead;
+  RPI_FW_CLOCK_RATE_TAG     TagBody;
+  UINT32                    EndTag;
+} RPI_FW_GET_CLOCK_RATE_CMD;
+#pragma pack()
+
+STATIC
+EFI_STATUS
+EFIAPI
+RpiFirmwareGetClockRate (
+  IN  UINT32 ClockId,
+  IN  UINT32 ClockKind,
+  OUT UINT32 *ClockRate
+  )
+{
+  RPI_FW_GET_CLOCK_RATE_CMD   *Cmd;
+  EFI_STATUS                  Status;
+  UINT32                      Result;
+
+  if (!AcquireSpinLockOrFail (&mMailboxLock)) {
+    DEBUG ((DEBUG_ERROR, "%a: failed to acquire spinlock\n", __FUNCTION__));
+    return EFI_DEVICE_ERROR;
+  }
+
+  Cmd = mDmaBuffer;
+  ZeroMem (Cmd, sizeof (*Cmd));
+
+  Cmd->BufferHead.BufferSize  = sizeof (*Cmd);
+  Cmd->BufferHead.Response    = 0;
+  Cmd->TagHead.TagId          = ClockKind;
+  Cmd->TagHead.TagSize        = sizeof (Cmd->TagBody);
+  Cmd->TagHead.TagValueSize   = 0;
+  Cmd->TagBody.ClockId        = ClockId;
+  Cmd->EndTag                 = 0;
+
+  Status = MailboxTransaction (Cmd->BufferHead.BufferSize, RPI_MBOX_VC_CHANNEL, &Result);
+
+  ReleaseSpinLock (&mMailboxLock);
+
+  if (EFI_ERROR (Status) ||
+      Cmd->BufferHead.Response != RPI_MBOX_RESP_SUCCESS) {
+    DEBUG ((DEBUG_ERROR,
+      "%a: mailbox transaction error: Status == %r, Response == 0x%x\n",
+      __FUNCTION__, Status, Cmd->BufferHead.Response));
+    return EFI_DEVICE_ERROR;
+  }
+
+  *ClockRate = Cmd->TagBody.ClockRate;
+  return EFI_SUCCESS;
+}
+
+STATIC
+EFI_STATUS
+EFIAPI
+RpiFirmwareGetCurrentClockRate (
+  IN  UINT32    ClockId,
+  OUT UINT32    *ClockRate
+  )
+{
+  return RpiFirmwareGetClockRate (ClockId, RPI_MBOX_GET_CLOCK_RATE, ClockRate);
+}
+
+STATIC
+EFI_STATUS
+EFIAPI
+RpiFirmwareGetMaxClockRate (
+  IN  UINT32    ClockId,
+  OUT UINT32    *ClockRate
+  )
+{
+  return RpiFirmwareGetClockRate (ClockId, RPI_MBOX_GET_MAX_CLOCK_RATE, ClockRate);
+}
+
+STATIC
+EFI_STATUS
+EFIAPI
+RpiFirmwareGetMinClockRate (
+  IN  UINT32    ClockId,
+  OUT UINT32    *ClockRate
+  )
+{
+  return RpiFirmwareGetClockRate (ClockId, RPI_MBOX_GET_MIN_CLOCK_RATE, ClockRate);
+}
+
+#pragma pack()
+typedef struct {
+  UINT32 Pin;
+  UINT32 State;
+} RPI_FW_SET_GPIO_TAG;
+
+typedef struct {
+  RPI_FW_BUFFER_HEAD        BufferHead;
+  RPI_FW_TAG_HEAD           TagHead;
+  RPI_FW_SET_GPIO_TAG       TagBody;
+  UINT32                    EndTag;
+} RPI_FW_SET_GPIO_CMD;
+#pragma pack()
+
+STATIC
+VOID
+RpiFirmwareSetLed (
+  IN  BOOLEAN On
+  )
+{
+  RPI_FW_SET_GPIO_CMD *Cmd;
+  EFI_STATUS          Status;
+  UINT32              Result;
+
+  if (!AcquireSpinLockOrFail (&mMailboxLock)) {
+    DEBUG ((DEBUG_ERROR, "%a: failed to acquire spinlock\n", __FUNCTION__));
+    return;
+  }
+
+  Cmd = mDmaBuffer;
+  ZeroMem (Cmd, sizeof (*Cmd));
+
+  Cmd->BufferHead.BufferSize  = sizeof (*Cmd);
+  Cmd->BufferHead.Response    = 0;
+  Cmd->TagHead.TagId          = RPI_MBOX_SET_GPIO;
+  Cmd->TagHead.TagSize        = sizeof (Cmd->TagBody);
+  /*
+   * GPIO_PIN_2 = Activity LED
+   * GPIO_PIN_4 = HDMI Detect (Input / Active Low)
+   * GPIO_PIN_7 = Power LED (Input / Active Low)
+   *
+   * There's also a 128 pin offset.
+   */
+  Cmd->TagBody.Pin = 128 + 2;
+  Cmd->TagBody.State = On;
+  Cmd->TagHead.TagValueSize   = 0;
+  Cmd->EndTag                 = 0;
+
+  Status = MailboxTransaction (Cmd->BufferHead.BufferSize, RPI_MBOX_VC_CHANNEL, &Result);
+
+  ReleaseSpinLock (&mMailboxLock);
+
+  if (EFI_ERROR (Status) ||
+      Cmd->BufferHead.Response != RPI_MBOX_RESP_SUCCESS) {
+    DEBUG ((DEBUG_ERROR,
+      "%a: mailbox  transaction error: Status == %r, Response == 0x%x\n",
+      __FUNCTION__, Status, Cmd->BufferHead.Response));
+  }
+}
+
+STATIC RASPBERRY_PI_FIRMWARE_PROTOCOL mRpiFirmwareProtocol = {
+  RpiFirmwareSetPowerState,
+  RpiFirmwareGetMacAddress,
+  RpiFirmwareGetCommmandLine,
+  RpiFirmwareGetCurrentClockRate,
+  RpiFirmwareGetMaxClockRate,
+  RpiFirmwareGetMinClockRate,
+  RpiFirmwareSetClockRate,
+  RpiFirmwareAllocFb,
+  RpiFirmwareFreeFb,
+  RpiFirmwareGetFbSize,
+  RpiFirmwareSetLed,
+  RpiFirmwareGetSerial,
+  RpiFirmwareGetModel,
+  RpiFirmwareGetModelRevision,
+  RpiFirmwareGetArmMemory
+};
+
+/**
+  Initialize the state information for the CPU Architectural Protocol
+
+  @param  ImageHandle   of the loaded driver
+  @param  SystemTable   Pointer to the System Table
+
+  @retval EFI_SUCCESS           Protocol registered
+  @retval EFI_OUT_OF_RESOURCES  Cannot allocate protocol data structure
+  @retval EFI_DEVICE_ERROR      Hardware problems
+
+**/
+EFI_STATUS
+RpiFirmwareDxeInitialize (
+  IN EFI_HANDLE         ImageHandle,
+  IN EFI_SYSTEM_TABLE   *SystemTable
+  )
+{
+  EFI_STATUS      Status;
+  UINTN           BufferSize;
+
+  //
+  // We only need one of these
+  //
+  ASSERT_PROTOCOL_ALREADY_INSTALLED (NULL, &gRaspberryPiFirmwareProtocolGuid);
+
+  InitializeSpinLock (&mMailboxLock);
+
+  Status = DmaAllocateBuffer (EfiBootServicesData, NUM_PAGES, &mDmaBuffer);
+  if (EFI_ERROR (Status)) {
+    DEBUG ((DEBUG_ERROR, "%a: failed to allocate DMA buffer (Status == %r)\n", __FUNCTION__));
+    return Status;
+  }
+
+  BufferSize = EFI_PAGES_TO_SIZE (NUM_PAGES);
+  Status = DmaMap (MapOperationBusMasterCommonBuffer, mDmaBuffer, &BufferSize,
+             &mDmaBufferBusAddress, &mDmaBufferMapping);
+  if (EFI_ERROR (Status)) {
+    DEBUG ((DEBUG_ERROR, "%a: failed to map DMA buffer (Status == %r)\n", __FUNCTION__));
+    goto FreeBuffer;
+  }
+
+  //
+  // The channel index is encoded in the low bits of the bus address,
+  // so make sure these are cleared.
+  //
+  ASSERT (!(mDmaBufferBusAddress & (BCM2836_MBOX_NUM_CHANNELS - 1)));
+
+  Status = gBS->InstallProtocolInterface (&ImageHandle,
+                  &gRaspberryPiFirmwareProtocolGuid, EFI_NATIVE_INTERFACE,
+                  &mRpiFirmwareProtocol);
+  if (EFI_ERROR (Status)) {
+    DEBUG ((DEBUG_ERROR,
+      "%a: failed to install RPI firmware protocol (Status == %r)\n",
+      __FUNCTION__, Status));
+    goto UnmapBuffer;
+  }
+
+  return EFI_SUCCESS;
+
+UnmapBuffer:
+  DmaUnmap (mDmaBufferMapping);
+FreeBuffer:
+  DmaFreeBuffer (NUM_PAGES, mDmaBuffer);
+
+  return Status;
+}
diff --git a/Platform/RaspberryPi/RPi3/Drivers/RpiFirmwareDxe/RpiFirmwareDxe.inf b/Platform/RaspberryPi/RPi3/Drivers/RpiFirmwareDxe/RpiFirmwareDxe.inf
new file mode 100644
index 000000000000..45af4d08b228
--- /dev/null
+++ b/Platform/RaspberryPi/RPi3/Drivers/RpiFirmwareDxe/RpiFirmwareDxe.inf
@@ -0,0 +1,50 @@
+#/** @file
+#
+#  Copyright (c) 2017-2018, Andrei Warkentin <andrey.warkentin@gmail.com>
+#  Copyright (c) 2016, Linaro, Ltd. All rights reserved.
+#
+#  This program and the accompanying materials
+#  are licensed and made available under the terms and conditions of the BSD License
+#  which accompanies this distribution.  The full text of the license may be found at
+#  http://opensource.org/licenses/bsd-license.php
+#
+#  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+#  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+#
+#**/
+
+[Defines]
+  INF_VERSION                    = 0x0001001A
+  BASE_NAME                      = RpiFirmwareDxe
+  FILE_GUID                      = 6d4628df-49a0-4b67-a325-d5af35c65745
+  MODULE_TYPE                    = DXE_DRIVER
+  VERSION_STRING                 = 1.0
+  ENTRY_POINT                    = RpiFirmwareDxeInitialize
+
+[Sources]
+  RpiFirmwareDxe.c
+
+[Packages]
+  ArmPkg/ArmPkg.dec
+  MdePkg/MdePkg.dec
+  EmbeddedPkg/EmbeddedPkg.dec
+  Silicon/Broadcom/Bcm283x/Bcm283x.dec
+  Platform/RaspberryPi/RPi3/RPi3.dec
+
+[LibraryClasses]
+  ArmLib
+  BaseLib
+  BaseMemoryLib
+  DebugLib
+  DmaLib
+  IoLib
+  SynchronizationLib
+  UefiBootServicesTableLib
+  UefiDriverEntryPoint
+  UefiLib
+
+[Protocols]
+  gRaspberryPiFirmwareProtocolGuid    ## PRODUCES
+
+[Depex]
+  TRUE
diff --git a/Platform/RaspberryPi/RPi3/Include/Protocol/RpiFirmware.h b/Platform/RaspberryPi/RPi3/Include/Protocol/RpiFirmware.h
new file mode 100644
index 000000000000..7583d7e1fcee
--- /dev/null
+++ b/Platform/RaspberryPi/RPi3/Include/Protocol/RpiFirmware.h
@@ -0,0 +1,131 @@
+/** @file
+ *
+ *  Copyright (c) 2016, Linaro Limited. All rights reserved.
+ *
+ *  This program and the accompanying materials
+ *  are licensed and made available under the terms and conditions of the BSD License
+ *  which accompanies this distribution.  The full text of the license may be found at
+ *  http://opensource.org/licenses/bsd-license.php
+ *
+ *  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+ *  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+ *
+ **/
+
+#ifndef __RASPBERRY_PI_FIRMWARE_PROTOCOL_H__
+#define __RASPBERRY_PI_FIRMWARE_PROTOCOL_H__
+
+#define RASPBERRY_PI_FIRMWARE_PROTOL_GUID \
+  { 0x0ACA9535, 0x7AD0, 0x4286, { 0xB0, 0x2E, 0x87, 0xFA, 0x7E, 0x2A, 0x57, 0x11 } }
+
+typedef
+EFI_STATUS
+(EFIAPI *SET_POWER_STATE) (
+  IN  UINT32    DeviceId,
+  IN  BOOLEAN   PowerState,
+  IN  BOOLEAN   Wait
+  );
+
+typedef
+EFI_STATUS
+(EFIAPI *GET_MAC_ADDRESS) (
+  OUT UINT8     MacAddress[6]
+  );
+
+typedef
+EFI_STATUS
+(EFIAPI *GET_COMMAND_LINE) (
+  IN  UINTN     BufferSize,
+  OUT CHAR8     CommandLine[]
+  );
+
+typedef
+EFI_STATUS
+(EFIAPI *GET_CLOCK_RATE) (
+  IN  UINT32    ClockId,
+  OUT UINT32    *ClockRate
+  );
+
+typedef
+EFI_STATUS
+(EFIAPI *SET_CLOCK_RATE) (
+  IN  UINT32    ClockId,
+  OUT UINT32    ClockRate
+  );
+
+typedef
+EFI_STATUS
+(EFIAPI *GET_FB) (
+  IN  UINT32 Width,
+  IN  UINT32 Height,
+  IN  UINT32 Depth,
+  OUT EFI_PHYSICAL_ADDRESS *FbBase,
+  OUT UINTN *FbSize,
+  OUT UINTN *Pitch
+  );
+
+typedef
+EFI_STATUS
+(EFIAPI *GET_FB_SIZE) (
+  OUT   UINT32 *Width,
+  OUT   UINT32 *Height
+  );
+
+typedef
+EFI_STATUS
+(EFIAPI *FREE_FB) (
+  VOID
+  );
+
+typedef
+VOID
+(EFIAPI *SET_LED) (
+  BOOLEAN On
+  );
+
+typedef
+EFI_STATUS
+(EFIAPI *GET_SERIAL) (
+  UINT64 *Serial
+  );
+
+typedef
+EFI_STATUS
+(EFIAPI *GET_MODEL) (
+  UINT32 *Model
+  );
+
+typedef
+EFI_STATUS
+(EFIAPI *GET_MODEL_REVISION) (
+  UINT32 *Revision
+  );
+
+typedef
+EFI_STATUS
+(EFIAPI *GET_ARM_MEM) (
+  UINT32 *Base,
+  UINT32 *Size
+  );
+
+typedef struct {
+  SET_POWER_STATE    SetPowerState;
+  GET_MAC_ADDRESS    GetMacAddress;
+  GET_COMMAND_LINE   GetCommandLine;
+  GET_CLOCK_RATE     GetClockRate;
+  GET_CLOCK_RATE     GetMaxClockRate;
+  GET_CLOCK_RATE     GetMinClockRate;
+  SET_CLOCK_RATE     SetClockRate;
+  GET_FB             GetFB;
+  FREE_FB            FreeFB;
+  GET_FB_SIZE        GetFBSize;
+  SET_LED            SetLed;
+  GET_SERIAL         GetSerial;
+  GET_MODEL          GetModel;
+  GET_MODEL_REVISION GetModelRevision;
+  GET_ARM_MEM        GetArmMem;
+} RASPBERRY_PI_FIRMWARE_PROTOCOL;
+
+extern EFI_GUID gRaspberryPiFirmwareProtocolGuid;
+
+#endif /* __RASPBERRY_PI_FIRMWARE_PROTOCOL_H__ */
-- 
2.17.0.windows.1



^ permalink raw reply related	[flat|nested] 34+ messages in thread

* [PATCH v5 edk2-platforms 07/22] Platform/RaspberryPi/RPi3: Add platform config driver
  2019-02-05 16:25 [PATCH v5 edk2-platforms 00/22] Platform/RaspberryPi: Add Raspberry Pi 3 support Pete Batard
                   ` (5 preceding siblings ...)
  2019-02-05 16:25 ` [PATCH v5 edk2-platforms 06/22] Platform/RaspberryPi/RPi3: Add firmware driver Pete Batard
@ 2019-02-05 16:25 ` Pete Batard
  2019-02-05 16:25 ` [PATCH v5 edk2-platforms 08/22] Platform/RaspberryPi/RPi3: Add SMBIOS driver Pete Batard
                   ` (16 subsequent siblings)
  23 siblings, 0 replies; 34+ messages in thread
From: Pete Batard @ 2019-02-05 16:25 UTC (permalink / raw)
  To: edk2-devel

Provides the user-visible configuration options for the
firmware UI.

Contributed-under: TianoCore Contribution Agreement 1.1
Signed-off-by: Pete Batard <pete@akeo.ie>
---
 Platform/RaspberryPi/RPi3/Drivers/ConfigDxe/ConfigDxe.c            | 351 ++++++++++++++++++++
 Platform/RaspberryPi/RPi3/Drivers/ConfigDxe/ConfigDxe.inf          |  78 +++++
 Platform/RaspberryPi/RPi3/Drivers/ConfigDxe/ConfigDxeFormSetGuid.h |  23 ++
 Platform/RaspberryPi/RPi3/Drivers/ConfigDxe/ConfigDxeHii.uni       | 100 ++++++
 Platform/RaspberryPi/RPi3/Drivers/ConfigDxe/ConfigDxeHii.vfr       | 306 +++++++++++++++++
 5 files changed, 858 insertions(+)

diff --git a/Platform/RaspberryPi/RPi3/Drivers/ConfigDxe/ConfigDxe.c b/Platform/RaspberryPi/RPi3/Drivers/ConfigDxe/ConfigDxe.c
new file mode 100644
index 000000000000..b78d7deae402
--- /dev/null
+++ b/Platform/RaspberryPi/RPi3/Drivers/ConfigDxe/ConfigDxe.c
@@ -0,0 +1,351 @@
+/** @file
+ *
+ *  Copyright (c) 2018, Andrei Warkentin <andrey.warkentin@gmail.com>
+ *
+ *  This program and the accompanying materials
+ *  are licensed and made available under the terms and conditions of the BSD License
+ *  which accompanies this distribution.  The full text of the license may be found at
+ *  http://opensource.org/licenses/bsd-license.php
+ *
+ *  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+ *  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+ *
+ **/
+
+#include <Uefi.h>
+#include <Library/HiiLib.h>
+#include <Library/DebugLib.h>
+#include <Library/UefiBootServicesTableLib.h>
+#include <Library/UefiRuntimeServicesTableLib.h>
+#include <Library/DevicePathLib.h>
+#include <IndustryStandard/RpiMbox.h>
+#include <IndustryStandard/Bcm2836Gpio.h>
+#include <Library/GpioLib.h>
+#include <Protocol/RpiFirmware.h>
+#include "ConfigDxeFormSetGuid.h"
+
+extern UINT8 ConfigDxeHiiBin[];
+extern UINT8 ConfigDxeStrings[];
+
+STATIC RASPBERRY_PI_FIRMWARE_PROTOCOL *mFwProtocol;
+
+typedef struct {
+  VENDOR_DEVICE_PATH VendorDevicePath;
+  EFI_DEVICE_PATH_PROTOCOL End;
+} HII_VENDOR_DEVICE_PATH;
+
+STATIC HII_VENDOR_DEVICE_PATH mVendorDevicePath = {
+  {
+    {
+      HARDWARE_DEVICE_PATH,
+      HW_VENDOR_DP,
+      {
+        (UINT8)(sizeof (VENDOR_DEVICE_PATH)),
+        (UINT8)((sizeof (VENDOR_DEVICE_PATH)) >> 8)
+      }
+    },
+    CONFIGDXE_FORM_SET_GUID
+  },
+  {
+    END_DEVICE_PATH_TYPE,
+    END_ENTIRE_DEVICE_PATH_SUBTYPE,
+    {
+      (UINT8)(END_DEVICE_PATH_LENGTH),
+      (UINT8)((END_DEVICE_PATH_LENGTH) >> 8)
+    }
+  }
+};
+
+
+STATIC EFI_STATUS
+InstallHiiPages (
+  VOID
+  )
+{
+  EFI_STATUS     Status;
+  EFI_HII_HANDLE HiiHandle;
+  EFI_HANDLE     DriverHandle;
+
+  DriverHandle = NULL;
+  Status = gBS->InstallMultipleProtocolInterfaces (&DriverHandle,
+                  &gEfiDevicePathProtocolGuid,
+                  &mVendorDevicePath,
+                  NULL);
+  if (EFI_ERROR (Status)) {
+    return Status;
+  }
+
+  HiiHandle = HiiAddPackages (&gConfigDxeFormSetGuid,
+                DriverHandle,
+                ConfigDxeStrings,
+                ConfigDxeHiiBin,
+                NULL);
+
+  if (HiiHandle == NULL) {
+    gBS->UninstallMultipleProtocolInterfaces (DriverHandle,
+           &gEfiDevicePathProtocolGuid,
+           &mVendorDevicePath,
+           NULL);
+    return EFI_OUT_OF_RESOURCES;
+  }
+  return EFI_SUCCESS;
+}
+
+
+STATIC EFI_STATUS
+SetupVariables (
+  VOID
+  )
+{
+  UINTN Size;
+  UINT32 Var32;
+  EFI_STATUS Status;
+
+  /*
+   * Create the vars with default value.
+   * If we don't, forms won't be able to update.
+   */
+
+  Size = sizeof (UINT32);
+  Status = gRT->GetVariable (L"CpuClock",
+                  &gConfigDxeFormSetGuid,
+                  NULL, &Size, &Var32);
+  if (EFI_ERROR (Status)) {
+    PcdSet32 (PcdCpuClock, PcdGet32 (PcdCpuClock));
+  }
+
+  Size = sizeof (UINT32);
+  Status = gRT->GetVariable (L"SdIsArasan",
+                  &gConfigDxeFormSetGuid,
+                  NULL, &Size, &Var32);
+  if (EFI_ERROR (Status)) {
+    PcdSet32 (PcdSdIsArasan, PcdGet32 (PcdSdIsArasan));
+  }
+
+  Size = sizeof (UINT32);
+  Status = gRT->GetVariable (L"MmcDisableMulti",
+                  &gConfigDxeFormSetGuid,
+                  NULL, &Size, &Var32);
+  if (EFI_ERROR (Status)) {
+    PcdSet32 (PcdMmcDisableMulti, PcdGet32 (PcdMmcDisableMulti));
+  }
+
+  Size = sizeof (UINT32);
+  Status = gRT->GetVariable (L"MmcForce1Bit",
+                  &gConfigDxeFormSetGuid,
+                  NULL, &Size, &Var32);
+  if (EFI_ERROR (Status)) {
+    PcdSet32 (PcdMmcForce1Bit, PcdGet32 (PcdMmcForce1Bit));
+  }
+
+  Size = sizeof (UINT32);
+  Status = gRT->GetVariable (L"MmcForceDefaultSpeed",
+                  &gConfigDxeFormSetGuid,
+                  NULL, &Size, &Var32);
+  if (EFI_ERROR (Status)) {
+    PcdSet32 (PcdMmcForceDefaultSpeed, PcdGet32 (PcdMmcForceDefaultSpeed));
+  }
+
+  Size = sizeof (UINT32);
+  Status = gRT->GetVariable (L"MmcSdDefaultSpeedMHz",
+                  &gConfigDxeFormSetGuid,
+                  NULL, &Size, &Var32);
+  if (EFI_ERROR (Status)) {
+    PcdSet32 (PcdMmcSdDefaultSpeedMHz, PcdGet32 (PcdMmcSdDefaultSpeedMHz));
+  }
+
+  Size = sizeof (UINT32);
+  Status = gRT->GetVariable (L"MmcSdHighSpeedMHz",
+                  &gConfigDxeFormSetGuid,
+                  NULL, &Size, &Var32);
+  if (EFI_ERROR (Status)) {
+    PcdSet32 (PcdMmcSdHighSpeedMHz, PcdGet32 (PcdMmcSdHighSpeedMHz));
+  }
+
+  Size = sizeof (UINT32);
+  Status = gRT->GetVariable (L"DebugEnableJTAG",
+                  &gConfigDxeFormSetGuid,
+                  NULL, &Size, &Var32);
+  if (EFI_ERROR (Status)) {
+    PcdSet32 (PcdDebugEnableJTAG, PcdGet32 (PcdDebugEnableJTAG));
+  }
+
+  Size = sizeof (UINT32);
+  Status = gRT->GetVariable (L"DebugShowUEFIExit",
+                  &gConfigDxeFormSetGuid,
+                  NULL, &Size, &Var32);
+  if (EFI_ERROR (Status)) {
+    PcdSet32 (PcdDebugShowUEFIExit, PcdGet32 (PcdDebugShowUEFIExit));
+  }
+
+  Size = sizeof (UINT32);
+  Status = gRT->GetVariable (L"DisplayEnableVModes",
+                  &gConfigDxeFormSetGuid,
+                  NULL, &Size, &Var32);
+  if (EFI_ERROR (Status)) {
+    PcdSet32 (PcdDisplayEnableVModes, PcdGet32 (PcdDisplayEnableVModes));
+  }
+
+  Size = sizeof (UINT32);
+  Status = gRT->GetVariable (L"DisplayEnableSShot",
+                  &gConfigDxeFormSetGuid,
+                  NULL, &Size, &Var32);
+  if (EFI_ERROR (Status)) {
+    PcdSet32 (PcdDisplayEnableSShot, PcdGet32 (PcdDisplayEnableSShot));
+  }
+
+  return EFI_SUCCESS;
+}
+
+
+STATIC VOID
+ApplyVariables (
+  VOID
+  )
+{
+  UINTN Gpio34Group;
+  UINTN Gpio48Group;
+  EFI_STATUS Status;
+  UINT32 CpuClock = PcdGet32 (PcdCpuClock);
+  UINT32 Rate = 0;
+
+  if (CpuClock != 0) {
+    if (CpuClock == 2) {
+      /*
+       * Maximum: 1.2GHz on RPi 3, 1.4GHz on RPi 3B+, unless
+       * overridden with arm_freq=xxx in config.txt.
+       */
+      Status = mFwProtocol->GetMaxClockRate (RPI_MBOX_CLOCK_RATE_ARM, &Rate);
+      if (Status != EFI_SUCCESS) {
+        DEBUG ((DEBUG_ERROR, "Couldn't get the max CPU speed, leaving as is: %r\n", Status));
+      }
+    } else {
+      Rate = 600 * 1000000;
+    }
+  }
+
+  if (Rate != 0) {
+    DEBUG ((DEBUG_INFO, "Setting CPU speed to %uHz\n", Rate));
+    Status = mFwProtocol->SetClockRate (RPI_MBOX_CLOCK_RATE_ARM, Rate);
+    if (Status != EFI_SUCCESS) {
+      DEBUG ((DEBUG_ERROR, "Couldn't set the CPU speed: %r\n", Status));
+    }
+  }
+
+  Status = mFwProtocol->GetClockRate (RPI_MBOX_CLOCK_RATE_ARM, &Rate);
+  if (Status != EFI_SUCCESS) {
+    DEBUG ((DEBUG_ERROR, "Couldn't get the CPU speed: %r\n", Status));
+  } else {
+    DEBUG ((DEBUG_INFO, "Current CPU speed is %uHz\n", Rate));
+  }
+
+  /*
+   * Switching two groups around, so disable both first.
+   *
+   * No, I've not seen a problem, but having a group be
+   * routed to two sets of pins seems like asking for trouble.
+   */
+  GpioPinFuncSet (34, GPIO_FSEL_INPUT);
+  GpioPinFuncSet (35, GPIO_FSEL_INPUT);
+  GpioPinFuncSet (36, GPIO_FSEL_INPUT);
+  GpioPinFuncSet (37, GPIO_FSEL_INPUT);
+  GpioPinFuncSet (38, GPIO_FSEL_INPUT);
+  GpioPinFuncSet (39, GPIO_FSEL_INPUT);
+  GpioPinFuncSet (48, GPIO_FSEL_INPUT);
+  GpioPinFuncSet (49, GPIO_FSEL_INPUT);
+  GpioPinFuncSet (50, GPIO_FSEL_INPUT);
+  GpioPinFuncSet (51, GPIO_FSEL_INPUT);
+  GpioPinFuncSet (52, GPIO_FSEL_INPUT);
+  GpioPinFuncSet (53, GPIO_FSEL_INPUT);
+  if (PcdGet32 (PcdSdIsArasan)) {
+    DEBUG ((DEBUG_INFO, "Routing SD to Arasan\n"));
+    Gpio48Group = GPIO_FSEL_ALT3;
+    /*
+     * Route SDIO to SdHost.
+     */
+    Gpio34Group = GPIO_FSEL_ALT0;
+  } else {
+    DEBUG ((DEBUG_INFO, "Routing SD to SdHost\n"));
+    Gpio48Group = GPIO_FSEL_ALT0;
+    /*
+     * Route SDIO to Arasan.
+     */
+    Gpio34Group = GPIO_FSEL_ALT3;
+  }
+  GpioPinFuncSet (34, Gpio34Group);
+  GpioPinFuncSet (35, Gpio34Group);
+  GpioPinFuncSet (36, Gpio34Group);
+  GpioPinFuncSet (37, Gpio34Group);
+  GpioPinFuncSet (38, Gpio34Group);
+  GpioPinFuncSet (39, Gpio34Group);
+  GpioPinFuncSet (48, Gpio48Group);
+  GpioPinFuncSet (49, Gpio48Group);
+  GpioPinFuncSet (50, Gpio48Group);
+  GpioPinFuncSet (51, Gpio48Group);
+  GpioPinFuncSet (52, Gpio48Group);
+  GpioPinFuncSet (53, Gpio48Group);
+
+  /*
+   * JTAG pin    JTAG sig    GPIO      Mode    Header pin
+   * 1           VREF        N/A               1
+   * 3           nTRST       GPIO22    ALT4    15
+   * 4           GND         N/A               9
+   * 5           TDI         GPIO4     ALT5    7
+   * 7           TMS         GPIO27    ALT4    13
+   * 9           TCK         GPIO25    ALT4    22
+   * 11          RTCK        GPIO23    ALT4    16
+   * 13          TDO         GPIO24    ALT4    18
+   */
+  if (PcdGet32 (PcdDebugEnableJTAG)) {
+    GpioPinFuncSet (22, GPIO_FSEL_ALT4);
+    GpioPinFuncSet (4, GPIO_FSEL_ALT5);
+    GpioPinFuncSet (27, GPIO_FSEL_ALT4);
+    GpioPinFuncSet (25, GPIO_FSEL_ALT4);
+    GpioPinFuncSet (23, GPIO_FSEL_ALT4);
+    GpioPinFuncSet (24, GPIO_FSEL_ALT4);
+  } else {
+    GpioPinFuncSet (22, GPIO_FSEL_INPUT);
+    GpioPinFuncSet (4, GPIO_FSEL_INPUT);
+    GpioPinFuncSet (27, GPIO_FSEL_INPUT);
+    GpioPinFuncSet (25, GPIO_FSEL_INPUT);
+    GpioPinFuncSet (23, GPIO_FSEL_INPUT);
+    GpioPinFuncSet (24, GPIO_FSEL_INPUT);
+  }
+}
+
+
+EFI_STATUS
+EFIAPI
+ConfigInitialize (
+  IN EFI_HANDLE ImageHandle,
+  IN EFI_SYSTEM_TABLE *SystemTable
+  )
+{
+  EFI_STATUS Status;
+
+  Status = gBS->LocateProtocol (&gRaspberryPiFirmwareProtocolGuid,
+                  NULL, (VOID**)&mFwProtocol);
+  ASSERT_EFI_ERROR (Status);
+  if (EFI_ERROR (Status)) {
+    return Status;
+  }
+
+  Status = SetupVariables ();
+  if (Status != EFI_SUCCESS) {
+    DEBUG ((DEBUG_ERROR, "Couldn't not setup NV vars: %r\n", Status));
+  }
+
+  ApplyVariables ();
+  Status = gBS->InstallProtocolInterface (&ImageHandle,
+                  &gRaspberryPiConfigAppliedProtocolGuid,
+                  EFI_NATIVE_INTERFACE,
+                  NULL);
+  ASSERT_EFI_ERROR (Status);
+
+  Status = InstallHiiPages ();
+  if (Status != EFI_SUCCESS) {
+    DEBUG ((DEBUG_ERROR, "Couldn't install ConfigDxe configuration pages: %r\n", Status));
+  }
+
+  return EFI_SUCCESS;
+}
diff --git a/Platform/RaspberryPi/RPi3/Drivers/ConfigDxe/ConfigDxe.inf b/Platform/RaspberryPi/RPi3/Drivers/ConfigDxe/ConfigDxe.inf
new file mode 100644
index 000000000000..68eaec25abe0
--- /dev/null
+++ b/Platform/RaspberryPi/RPi3/Drivers/ConfigDxe/ConfigDxe.inf
@@ -0,0 +1,78 @@
+#/** @file
+#
+#  Copyright (c) 2018, Andrei Warkentin <andrey.warkentin@gmail.com>
+#
+#  This program and the accompanying materials are licensed and made available
+#  under the terms and conditions of the BSD License which accompanies this
+#  distribution. The full text of the license may be found at
+#  http://opensource.org/licenses/bsd-license.php
+#
+#  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+#  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR
+#  IMPLIED.
+#
+#**/
+
+[Defines]
+  INF_VERSION                    = 0x0001001A
+  BASE_NAME                      = ConfigDxe
+  FILE_GUID                      = 755cbac2-b23f-4b92-bc8e-fb01ce5907b7
+  MODULE_TYPE                    = DXE_DRIVER
+  VERSION_STRING                 = 1.0
+  ENTRY_POINT                    = ConfigInitialize
+
+#
+# The following information is for reference only and not required by the build
+# tools.
+#
+#  VALID_ARCHITECTURES           = AARCH64
+#
+
+[Sources]
+  ConfigDxe.c
+  ConfigDxeHii.vfr
+  ConfigDxeHii.uni
+
+[Packages]
+  ArmPkg/ArmPkg.dec
+  ArmPlatformPkg/ArmPlatformPkg.dec
+  MdePkg/MdePkg.dec
+  MdeModulePkg/MdeModulePkg.dec
+  Silicon/Broadcom/Bcm283x/Bcm283x.dec
+  Platform/RaspberryPi/RPi3/RPi3.dec
+
+[LibraryClasses]
+  BaseLib
+  DebugLib
+  DxeServicesTableLib
+  PcdLib
+  UefiBootServicesTableLib
+  UefiRuntimeServicesTableLib
+  UefiDriverEntryPoint
+  HiiLib
+  GpioLib
+
+[Guids]
+  gConfigDxeFormSetGuid
+
+[Protocols]
+  gRaspberryPiFirmwareProtocolGuid ## CONSUMES
+  gRaspberryPiConfigAppliedProtocolGuid ## PRODUCES
+
+[Pcd]
+  gRaspberryPiTokenSpaceGuid.PcdCpuClock
+  gRaspberryPiTokenSpaceGuid.PcdSdIsArasan
+  gRaspberryPiTokenSpaceGuid.PcdMmcForce1Bit
+  gRaspberryPiTokenSpaceGuid.PcdMmcForceDefaultSpeed
+  gRaspberryPiTokenSpaceGuid.PcdMmcSdDefaultSpeedMHz
+  gRaspberryPiTokenSpaceGuid.PcdMmcSdHighSpeedMHz
+  gRaspberryPiTokenSpaceGuid.PcdMmcDisableMulti
+  gRaspberryPiTokenSpaceGuid.PcdDebugEnableJTAG
+  gRaspberryPiTokenSpaceGuid.PcdDebugShowUEFIExit
+  gRaspberryPiTokenSpaceGuid.PcdDisplayEnableVModes
+  gRaspberryPiTokenSpaceGuid.PcdDisplayEnableSShot
+
+[FeaturePcd]
+
+[Depex]
+  gPcdProtocolGuid AND gRaspberryPiFirmwareProtocolGuid
diff --git a/Platform/RaspberryPi/RPi3/Drivers/ConfigDxe/ConfigDxeFormSetGuid.h b/Platform/RaspberryPi/RPi3/Drivers/ConfigDxe/ConfigDxeFormSetGuid.h
new file mode 100644
index 000000000000..b29ae3a42461
--- /dev/null
+++ b/Platform/RaspberryPi/RPi3/Drivers/ConfigDxe/ConfigDxeFormSetGuid.h
@@ -0,0 +1,23 @@
+/** @file
+ *
+ *  Copyright (c) 2018 Andrei Warkentin <andrey.warkentin@gmail.com>
+ *
+ *  This program and the accompanying materials
+ *  are licensed and made available under the terms and conditions of the BSD License
+ *  which accompanies this distribution.  The full text of the license may be found at
+ *  http://opensource.org/licenses/bsd-license.php
+ *
+ *  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+ *  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+ *
+ **/
+
+#ifndef CONFIGDXE_FORM_SET_GUID_H
+#define CONFIGDXE_FORM_SET_GUID_H
+
+#define CONFIGDXE_FORM_SET_GUID \
+  {0xCD7CC258, 0x31DB, 0x22E6, {0x9F, 0x22, 0x63, 0xB0, 0xB8, 0xEE, 0xD6, 0xB5}}
+
+extern EFI_GUID gConfigDxeFormSetGuid;
+
+#endif /* CONFIGDXE_FORM_SET_GUID_H */
diff --git a/Platform/RaspberryPi/RPi3/Drivers/ConfigDxe/ConfigDxeHii.uni b/Platform/RaspberryPi/RPi3/Drivers/ConfigDxe/ConfigDxeHii.uni
new file mode 100644
index 000000000000..bf09261d5e4a
--- /dev/null
+++ b/Platform/RaspberryPi/RPi3/Drivers/ConfigDxe/ConfigDxeHii.uni
@@ -0,0 +1,100 @@
+/** @file
+ *
+ *  Copyright (c) 2018, Andrei Warkentin <andrey.warkentin@gmail.com>
+ *
+ *  This program and the accompanying materials
+ *  are licensed and made available under the terms and conditions of the BSD License
+ *  which accompanies this distribution.  The full text of the license may be found at
+ *  http://opensource.org/licenses/bsd-license.php
+ *
+ *  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+ *  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+ *
+ **/
+
+#langdef en-US  "English"
+
+#string STR_NULL_STRING          #language en-US ""
+
+#string STR_FORM_SET_TITLE       #language en-US "Raspberry Pi Configuration"
+#string STR_FORM_SET_TITLE_HELP  #language en-US "Press <Enter> to configure system settings."
+
+/*
+ * Chipset config.
+ */
+
+#string STR_CHIPSET_FORM_TITLE      #language en-US "Chipset Configuration"
+#string STR_CHIPSET_FORM_SUBTITLE   #language en-US "Note: OS may override settings when booted."
+
+#string STR_CHIPSET_CLOCK_CPU_PROMPT #language en-US "CPU Clock"
+#string STR_CHIPSET_CLOCK_CPU_HELP   #language en-US "CPU Speed"
+#string STR_CHIPSET_CLOCK_CPU_NA     #language en-US "Don't Override"
+#string STR_CHIPSET_CLOCK_CPU_600MHZ #language en-US "Min (600MHz)"
+#string STR_CHIPSET_CLOCK_CPU_MAX    #language en-US "Max"
+
+#string STR_CHIPSET_SD_PROMPT        #language en-US "uSD Routing"
+#string STR_CHIPSET_SD_HELP          #language en-US "Choose host controller to drive uSD slot"
+#string STR_CHIPSET_SD_SDHOST        #language en-US "Broadcom SDHOST"
+#string STR_CHIPSET_SD_ARASAN        #language en-US "Arasan SDHCI"
+
+/*
+ * MMC/SD configuration.
+ */
+
+#string STR_MMC_FORM_TITLE       #language en-US "SD/MMC Tweaks"
+#string STR_MMC_FORM_SUBTITLE    #language en-US "Note: UEFI only, OS will override settings when booted."
+
+#string STR_MMC_DISMULTI_PROMPT  #language en-US "Multi-Block Support"
+#string STR_MMC_DISMULTI_HELP    #language en-US "Use CMD18/CMD25 for transfers when possible"
+#string STR_MMC_DISMULTI_N       #language en-US "Multi-block transfers"
+#string STR_MMC_DISMULTI_Y       #language en-US "Single-block transfers"
+
+#string STR_MMC_FORCE1BIT_PROMPT #language en-US "uSD Max Bus Width"
+#string STR_MMC_FORCE1BIT_HELP   #language en-US "Tweak for bad media"
+#string STR_MMC_FORCE1BIT_Y      #language en-US "1 Bit Mode"
+#string STR_MMC_FORCE1BIT_N      #language en-US "4 Bit Mode"
+
+#string STR_MMC_FORCEDS_PROMPT   #language en-US "uSD Force Default Speed"
+#string STR_MMC_FORCEDS_HELP     #language en-US "Tweak for bad media"
+#string STR_MMC_FORCEDS_Y        #language en-US "Force Default Speed"
+#string STR_MMC_FORCEDS_N        #language en-US "Allow High Speed"
+
+#string STR_MMC_SD_DS_PROMPT     #language en-US "SD Default Speed (MHz)"
+#string STR_MMC_SD_DS_HELP       #language en-US "Override default 25Mhz"
+
+#string STR_MMC_SD_HS_PROMPT     #language en-US "SD High Speed (MHz)"
+#string STR_MMC_SD_HS_HELP       #language en-US "Override default 50Mhz"
+
+
+/*
+ * Display settings.
+ */
+
+#string STR_DISPLAY_FORM_TITLE      #language en-US "Display"
+#string STR_DISPLAY_FORM_SUBTITLE   #language en-US "UEFI video driver settings"
+
+#string STR_DISPLAY_VMODES_PROMPT   #language en-US "Resolutions"
+#string STR_DISPLAY_VMODES_HELP     #language en-US "Support for non-native modes"
+#string STR_DISPLAY_VMODES_ENABLE   #language en-US "Also support 640x480, 800x600, 1024x768, 720p and 1080p"
+#string STR_DISPLAY_VMODES_DISABLE  #language en-US "Only native resolution"
+
+#string STR_DISPLAY_SSHOT_PROMPT    #language en-US "Screenshot Support"
+#string STR_DISPLAY_SSHOT_HELP      #language en-US "Save screen capture as a BMP on the first writable file system found"
+#string STR_DISPLAY_SSHOT_ENABLE    #language en-US "Control-Alt-F12"
+#string STR_DISPLAY_SSHOT_DISABLE   #language en-US "Not Enabled"
+
+/*
+ * Debugging settings go here.
+ */
+#string STR_DEBUG_FORM_TITLE        #language en-US "Debugging"
+#string STR_DEBUG_FORM_SUBTITLE     #language en-US "For UEFI/OS Developers"
+
+#string STR_DEBUG_JTAG_PROMPT       #language en-US "JTAG Routing"
+#string STR_DEBUG_JTAG_HELP         #language en-US "Signals (nTRST, TDI, TMS, TCK, RTCK, TDO) -> Header pins (15, 7, 13, 22, 16, 18)"
+#string STR_DEBUG_JTAG_ENABLE       #language en-US "Enable JTAG via GPIO"
+#string STR_DEBUG_JTAG_DISABLE      #language en-US "Disable JTAG"
+
+#string STR_DEBUG_EXIT_SHOW_PROMPT  #language en-US "Verbose ExitBootServices"
+#string STR_DEBUG_EXIT_SHOW_HELP    #language en-US "Show message when UEFI hands off to OS"
+#string STR_DEBUG_EXIT_SHOW_NO      #language en-US "Do nothing"
+#string STR_DEBUG_EXIT_SHOW_YES     #language en-US "Show farewell message"
diff --git a/Platform/RaspberryPi/RPi3/Drivers/ConfigDxe/ConfigDxeHii.vfr b/Platform/RaspberryPi/RPi3/Drivers/ConfigDxe/ConfigDxeHii.vfr
new file mode 100644
index 000000000000..d3d98acc2edf
--- /dev/null
+++ b/Platform/RaspberryPi/RPi3/Drivers/ConfigDxe/ConfigDxeHii.vfr
@@ -0,0 +1,306 @@
+/** @file
+ *
+ *  Copyright (c) 2018 Andrei Warkentin <andrey.warkentin@gmail.com>
+ *
+ *  This program and the accompanying materials
+ *  are licensed and made available under the terms and conditions of the BSD License
+ *  which accompanies this distribution.  The full text of the license may be found at
+ *  http://opensource.org/licenses/bsd-license.php
+ *
+ *  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+ *  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+ *
+ **/
+
+#include <Guid/HiiPlatformSetupFormset.h>
+#include "ConfigDxeFormSetGuid.h"
+
+typedef struct {
+  /*
+   * 0 - One mode for the boot resolution.
+   * 1 - Adds additional "typical" resolutions like
+   *     640x480, 800x600, 1024 x 768, 720p and 1080p.
+   */
+   UINT32 Enable;
+} DISPLAY_ENABLE_VMODES_VARSTORE_DATA;
+
+typedef struct {
+  /*
+   * 0 - No screenshot support.
+   * 1 - Screenshot support via hotkey.
+   */
+   UINT32 Enable;
+} DISPLAY_ENABLE_SSHOT_VARSTORE_DATA;
+
+typedef struct {
+  /*
+   * 0 - No JTAG.
+   * 1 - JTAG mode.
+   */
+   UINT32 Enable;
+} DEBUG_ENABLE_JTAG_VARSTORE_DATA;
+
+typedef struct {
+  /*
+   * 0 - Don't show UEFI exit message.
+   * 1 - Show UEFI exit message.
+   */
+   UINT32 Show;
+} DEBUG_SHOW_UEFI_EXIT_VARSTORE_DATA;
+
+typedef struct {
+  /*
+   * 0 - don't change the clock rate.
+   * 1 - 600MHz.
+   * 2 - maximum.
+   */
+  UINT32 Clock;
+} CHIPSET_CPU_CLOCK_VARSTORE_DATA;
+
+typedef struct {
+  /*
+   * 0 - uSD slot routed to Broadcom SDHOST.
+   * 1 - uSD slot routed to Arasan SDHCI.
+   */
+  UINT32 Routing;
+} CHIPSET_SD_VARSTORE_DATA;
+
+typedef struct {
+  /*
+   * 0 - Don't disable multi-block.
+   * 1 - Disable multi-block commands.
+   */
+  UINT32 DisableMulti;
+} MMC_DISMULTI_VARSTORE_DATA;
+
+typedef struct {
+  /*
+   * 0 - Don't force 1 bit mode.
+   * 1 - Force 1 bit mode.
+   */
+  UINT32 Force1Bit;
+} MMC_FORCE1BIT_VARSTORE_DATA;
+
+typedef struct {
+  /*
+   * 0 - Don't force default speed.
+   * 1 - Force default speed.
+   */
+  UINT32 ForceDS;
+} MMC_FORCEDS_VARSTORE_DATA;
+
+typedef struct {
+  /*
+   * Default Speed MHz override (25MHz default).
+   */
+  UINT32 MHz;
+} MMC_SD_DS_MHZ_VARSTORE_DATA;
+
+typedef struct {
+  /*
+   * High Speed MHz override (50MHz default).
+   */
+  UINT32 MHz;
+} MMC_SD_HS_MHZ_VARSTORE_DATA;
+
+//
+// EFI Variable attributes
+//
+#define EFI_VARIABLE_NON_VOLATILE       0x00000001
+#define EFI_VARIABLE_BOOTSERVICE_ACCESS 0x00000002
+#define EFI_VARIABLE_RUNTIME_ACCESS     0x00000004
+#define EFI_VARIABLE_READ_ONLY          0x00000008
+
+formset
+    guid      = CONFIGDXE_FORM_SET_GUID,
+    title     = STRING_TOKEN(STR_FORM_SET_TITLE),
+    help      = STRING_TOKEN(STR_FORM_SET_TITLE_HELP),
+    classguid = EFI_HII_PLATFORM_SETUP_FORMSET_GUID,
+
+    efivarstore CHIPSET_CPU_CLOCK_VARSTORE_DATA,
+      attribute = EFI_VARIABLE_BOOTSERVICE_ACCESS | EFI_VARIABLE_RUNTIME_ACCESS | EFI_VARIABLE_NON_VOLATILE,
+      name  = CpuClock,
+      guid  = CONFIGDXE_FORM_SET_GUID;
+
+    efivarstore CHIPSET_SD_VARSTORE_DATA,
+      attribute = EFI_VARIABLE_BOOTSERVICE_ACCESS | EFI_VARIABLE_RUNTIME_ACCESS | EFI_VARIABLE_NON_VOLATILE,
+      name  = SdIsArasan,
+      guid  = CONFIGDXE_FORM_SET_GUID;
+
+    efivarstore MMC_DISMULTI_VARSTORE_DATA,
+      attribute = EFI_VARIABLE_BOOTSERVICE_ACCESS | EFI_VARIABLE_RUNTIME_ACCESS | EFI_VARIABLE_NON_VOLATILE,
+      name  = MmcDisableMulti,
+      guid  = CONFIGDXE_FORM_SET_GUID;
+
+    efivarstore MMC_FORCE1BIT_VARSTORE_DATA,
+      attribute = EFI_VARIABLE_BOOTSERVICE_ACCESS | EFI_VARIABLE_RUNTIME_ACCESS | EFI_VARIABLE_NON_VOLATILE,
+      name  = MmcForce1Bit,
+      guid  = CONFIGDXE_FORM_SET_GUID;
+
+    efivarstore MMC_FORCEDS_VARSTORE_DATA,
+      attribute = EFI_VARIABLE_BOOTSERVICE_ACCESS | EFI_VARIABLE_RUNTIME_ACCESS | EFI_VARIABLE_NON_VOLATILE,
+      name  = MmcForceDefaultSpeed,
+      guid  = CONFIGDXE_FORM_SET_GUID;
+
+    efivarstore MMC_SD_DS_MHZ_VARSTORE_DATA,
+      attribute = EFI_VARIABLE_BOOTSERVICE_ACCESS | EFI_VARIABLE_RUNTIME_ACCESS | EFI_VARIABLE_NON_VOLATILE,
+      name  = MmcSdDefaultSpeedMHz,
+      guid  = CONFIGDXE_FORM_SET_GUID;
+
+    efivarstore MMC_SD_HS_MHZ_VARSTORE_DATA,
+      attribute = EFI_VARIABLE_BOOTSERVICE_ACCESS | EFI_VARIABLE_RUNTIME_ACCESS | EFI_VARIABLE_NON_VOLATILE,
+      name  = MmcSdHighSpeedMHz,
+      guid  = CONFIGDXE_FORM_SET_GUID;
+
+    efivarstore DEBUG_ENABLE_JTAG_VARSTORE_DATA,
+      attribute = EFI_VARIABLE_BOOTSERVICE_ACCESS | EFI_VARIABLE_RUNTIME_ACCESS | EFI_VARIABLE_NON_VOLATILE,
+      name  = DebugEnableJTAG,
+      guid  = CONFIGDXE_FORM_SET_GUID;
+
+    efivarstore DEBUG_SHOW_UEFI_EXIT_VARSTORE_DATA,
+      attribute = EFI_VARIABLE_BOOTSERVICE_ACCESS | EFI_VARIABLE_RUNTIME_ACCESS | EFI_VARIABLE_NON_VOLATILE,
+      name  = DebugShowUEFIExit,
+      guid  = CONFIGDXE_FORM_SET_GUID;
+
+    efivarstore DISPLAY_ENABLE_VMODES_VARSTORE_DATA,
+      attribute = EFI_VARIABLE_BOOTSERVICE_ACCESS | EFI_VARIABLE_RUNTIME_ACCESS | EFI_VARIABLE_NON_VOLATILE,
+      name  = DisplayEnableVModes,
+      guid  = CONFIGDXE_FORM_SET_GUID;
+
+    efivarstore DISPLAY_ENABLE_SSHOT_VARSTORE_DATA,
+      attribute = EFI_VARIABLE_BOOTSERVICE_ACCESS | EFI_VARIABLE_RUNTIME_ACCESS | EFI_VARIABLE_NON_VOLATILE,
+      name  = DisplayEnableSShot,
+      guid  = CONFIGDXE_FORM_SET_GUID;
+
+    form formid = 1,
+        title  = STRING_TOKEN(STR_FORM_SET_TITLE);
+        subtitle text = STRING_TOKEN(STR_NULL_STRING);
+
+        goto 0x1002,
+           prompt = STRING_TOKEN(STR_CHIPSET_FORM_TITLE),
+           help = STRING_TOKEN(STR_NULL_STRING);
+
+        goto 0x1003,
+           prompt = STRING_TOKEN(STR_MMC_FORM_TITLE),
+           help = STRING_TOKEN(STR_NULL_STRING);
+
+        goto 0x1004,
+            prompt = STRING_TOKEN(STR_DISPLAY_FORM_TITLE),
+            help = STRING_TOKEN(STR_NULL_STRING);
+
+        goto 0x1005,
+            prompt = STRING_TOKEN(STR_DEBUG_FORM_TITLE),
+            help = STRING_TOKEN(STR_NULL_STRING);
+    endform;
+
+    form formid = 0x1002,
+        title  = STRING_TOKEN(STR_CHIPSET_FORM_TITLE);
+        subtitle text = STRING_TOKEN(STR_CHIPSET_FORM_SUBTITLE);
+
+        oneof varid = CpuClock.Clock,
+            prompt      = STRING_TOKEN(STR_CHIPSET_CLOCK_CPU_PROMPT),
+            help        = STRING_TOKEN(STR_CHIPSET_CLOCK_CPU_HELP),
+            flags       = NUMERIC_SIZE_4 | INTERACTIVE | RESET_REQUIRED,
+            option text = STRING_TOKEN(STR_CHIPSET_CLOCK_CPU_NA), value = 0, flags = DEFAULT;
+            option text = STRING_TOKEN(STR_CHIPSET_CLOCK_CPU_600MHZ), value = 1, flags = 0;
+            option text = STRING_TOKEN(STR_CHIPSET_CLOCK_CPU_MAX), value = 2, flags = 0;
+        endoneof;
+
+        oneof varid = SdIsArasan.Routing,
+            prompt      = STRING_TOKEN(STR_CHIPSET_SD_PROMPT),
+            help        = STRING_TOKEN(STR_CHIPSET_SD_HELP),
+            flags       = NUMERIC_SIZE_4 | INTERACTIVE | RESET_REQUIRED,
+            option text = STRING_TOKEN(STR_CHIPSET_SD_ARASAN), value = 1, flags = 0;
+            option text = STRING_TOKEN(STR_CHIPSET_SD_SDHOST), value = 0, flags = DEFAULT;
+        endoneof;
+    endform;
+
+    form formid = 0x1003,
+        title  = STRING_TOKEN(STR_MMC_FORM_TITLE);
+        subtitle text = STRING_TOKEN(STR_MMC_FORM_SUBTITLE);
+
+        oneof varid = MmcDisableMulti.DisableMulti,
+            prompt      = STRING_TOKEN(STR_MMC_DISMULTI_PROMPT),
+            help        = STRING_TOKEN(STR_MMC_DISMULTI_HELP),
+            flags       = NUMERIC_SIZE_4 | INTERACTIVE | RESET_REQUIRED,
+            option text = STRING_TOKEN(STR_MMC_DISMULTI_N), value = 0, flags = DEFAULT;
+            option text = STRING_TOKEN(STR_MMC_DISMULTI_Y), value = 1, flags = 0;
+        endoneof;
+
+        oneof varid = MmcForce1Bit.Force1Bit,
+            prompt      = STRING_TOKEN(STR_MMC_FORCE1BIT_PROMPT),
+            help        = STRING_TOKEN(STR_MMC_FORCE1BIT_HELP),
+            flags       = NUMERIC_SIZE_4 | INTERACTIVE | RESET_REQUIRED,
+            option text = STRING_TOKEN(STR_MMC_FORCE1BIT_N), value = 0, flags = DEFAULT;
+            option text = STRING_TOKEN(STR_MMC_FORCE1BIT_Y), value = 1, flags = 0;
+        endoneof;
+
+        oneof varid = MmcForceDefaultSpeed.ForceDS,
+            prompt      = STRING_TOKEN(STR_MMC_FORCEDS_PROMPT),
+            help        = STRING_TOKEN(STR_MMC_FORCEDS_HELP),
+            flags       = NUMERIC_SIZE_4 | INTERACTIVE | RESET_REQUIRED,
+            option text = STRING_TOKEN(STR_MMC_FORCEDS_N), value = 0, flags = DEFAULT;
+            option text = STRING_TOKEN(STR_MMC_FORCEDS_Y), value = 1, flags = 0;
+        endoneof;
+
+        numeric varid = MmcSdDefaultSpeedMHz.MHz,
+             prompt  = STRING_TOKEN(STR_MMC_SD_DS_PROMPT),
+             help    = STRING_TOKEN(STR_MMC_SD_DS_HELP),
+             flags   = DISPLAY_UINT_DEC | NUMERIC_SIZE_4 | INTERACTIVE | RESET_REQUIRED,
+             minimum = 25,
+             maximum = 100,
+             default = 25,
+        endnumeric;
+
+        numeric varid = MmcSdHighSpeedMHz.MHz,
+             prompt  = STRING_TOKEN(STR_MMC_SD_HS_PROMPT),
+             help    = STRING_TOKEN(STR_MMC_SD_HS_HELP),
+             flags   = DISPLAY_UINT_DEC | NUMERIC_SIZE_4 | INTERACTIVE | RESET_REQUIRED,
+             minimum = 50,
+             maximum = 100,
+             default = 50,
+        endnumeric;
+    endform;
+
+    form formid = 0x1004,
+        title  = STRING_TOKEN(STR_DISPLAY_FORM_TITLE);
+        subtitle text = STRING_TOKEN(STR_DISPLAY_FORM_SUBTITLE);
+
+        oneof varid = DisplayEnableVModes.Enable,
+            prompt      = STRING_TOKEN(STR_DISPLAY_VMODES_PROMPT),
+            help        = STRING_TOKEN(STR_DISPLAY_VMODES_HELP),
+            flags       = NUMERIC_SIZE_4 | INTERACTIVE | RESET_REQUIRED,
+            option text = STRING_TOKEN(STR_DISPLAY_VMODES_ENABLE), value = 1, flags = DEFAULT;
+            option text = STRING_TOKEN(STR_DISPLAY_VMODES_DISABLE), value = 0, flags = 0;
+        endoneof;
+
+        oneof varid = DisplayEnableSShot.Enable,
+            prompt      = STRING_TOKEN(STR_DISPLAY_SSHOT_PROMPT),
+            help        = STRING_TOKEN(STR_DISPLAY_SSHOT_HELP),
+            flags       = NUMERIC_SIZE_4 | INTERACTIVE | RESET_REQUIRED,
+            option text = STRING_TOKEN(STR_DISPLAY_SSHOT_ENABLE), value = 1, flags = DEFAULT;
+            option text = STRING_TOKEN(STR_DISPLAY_SSHOT_DISABLE), value = 0, flags = 0;
+        endoneof;
+    endform;
+
+    form formid = 0x1005,
+        title  = STRING_TOKEN(STR_DEBUG_FORM_TITLE);
+        subtitle text = STRING_TOKEN(STR_DEBUG_FORM_SUBTITLE);
+
+        oneof varid = DebugEnableJTAG.Enable,
+            prompt      = STRING_TOKEN(STR_DEBUG_JTAG_PROMPT),
+            help        = STRING_TOKEN(STR_DEBUG_JTAG_HELP),
+            flags       = NUMERIC_SIZE_4 | INTERACTIVE | RESET_REQUIRED,
+            option text = STRING_TOKEN(STR_DEBUG_JTAG_ENABLE), value = 1, flags = 0;
+            option text = STRING_TOKEN(STR_DEBUG_JTAG_DISABLE), value = 0, flags = DEFAULT;
+        endoneof;
+
+        oneof varid = DebugShowUEFIExit.Show,
+            prompt      = STRING_TOKEN(STR_DEBUG_EXIT_SHOW_PROMPT),
+            help        = STRING_TOKEN(STR_DEBUG_EXIT_SHOW_HELP),
+            flags       = NUMERIC_SIZE_4 | INTERACTIVE,
+            option text = STRING_TOKEN(STR_DEBUG_EXIT_SHOW_NO), value = 0, flags = DEFAULT;
+            option text = STRING_TOKEN(STR_DEBUG_EXIT_SHOW_YES), value = 1, flags = 0;
+        endoneof;
+    endform;
+endformset;
-- 
2.17.0.windows.1



^ permalink raw reply related	[flat|nested] 34+ messages in thread

* [PATCH v5 edk2-platforms 08/22] Platform/RaspberryPi/RPi3: Add SMBIOS driver
  2019-02-05 16:25 [PATCH v5 edk2-platforms 00/22] Platform/RaspberryPi: Add Raspberry Pi 3 support Pete Batard
                   ` (6 preceding siblings ...)
  2019-02-05 16:25 ` [PATCH v5 edk2-platforms 07/22] Platform/RaspberryPi/RPi3: Add platform config driver Pete Batard
@ 2019-02-05 16:25 ` Pete Batard
  2019-02-05 16:25 ` [PATCH v5 edk2-platforms 09/22] Platform/RaspberryPi/RPi3: Add display driver Pete Batard
                   ` (15 subsequent siblings)
  23 siblings, 0 replies; 34+ messages in thread
From: Pete Batard @ 2019-02-05 16:25 UTC (permalink / raw)
  To: edk2-devel

Static SMBIOS Table for the ARM platform, derived from EmulatorPkg.
Implements SMBIOS 2.7.1 required structures.

Contributed-under: TianoCore Contribution Agreement 1.1
Signed-off-by: Pete Batard <pete@akeo.ie>
---
 Platform/RaspberryPi/RPi3/Drivers/PlatformSmbiosDxe/PlatformSmbiosDxe.c   | 903 ++++++++++++++++++++
 Platform/RaspberryPi/RPi3/Drivers/PlatformSmbiosDxe/PlatformSmbiosDxe.inf |  56 ++
 2 files changed, 959 insertions(+)

diff --git a/Platform/RaspberryPi/RPi3/Drivers/PlatformSmbiosDxe/PlatformSmbiosDxe.c b/Platform/RaspberryPi/RPi3/Drivers/PlatformSmbiosDxe/PlatformSmbiosDxe.c
new file mode 100644
index 000000000000..7707763e4332
--- /dev/null
+++ b/Platform/RaspberryPi/RPi3/Drivers/PlatformSmbiosDxe/PlatformSmbiosDxe.c
@@ -0,0 +1,903 @@
+/** @file
+ *
+ *  Static SMBIOS Table for ARM platform
+ *  Derived from EmulatorPkg package
+ *
+ *  Note SMBIOS 2.7.1 Required structures:
+ *  BIOS Information (Type 0)
+ *  System Information (Type 1)
+ *  Board Information (Type 2)
+ *  System Enclosure (Type 3)
+ *  Processor Information (Type 4) - CPU Driver
+ *  Cache Information (Type 7) - For cache that is external to processor
+ *  System Slots (Type 9) - If system has slots
+ *  Physical Memory Array (Type 16)
+ *  Memory Device (Type 17) - For each socketed system-memory Device
+ *  Memory Array Mapped Address (Type 19) - One per contiguous block per Physical Memroy Array
+ *  System Boot Information (Type 32)
+ *
+ *  Copyright (c) 2017-2018, Andrey Warkentin <andrey.warkentin@gmail.com>
+ *  Copyright (c) 2013, Linaro.org
+ *  Copyright (c) 2012, Apple Inc. All rights reserved.<BR>
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *
+ *  This program and the accompanying materials
+ *  are licensed and made available under the terms and conditions of the BSD License
+ *  which accompanies this distribution.  The full text of the license may be found at
+ *  http://opensource.org/licenses/bsd-license.php
+ *
+ *  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+ *  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+ *
+ **/
+
+#include <Base.h>
+#include <IndustryStandard/SmBios.h>
+#include <IndustryStandard/RpiMbox.h>
+#include <Protocol/Smbios.h>
+#include <Protocol/RpiFirmware.h>
+#include <Guid/SmBios.h>
+#include <Library/DebugLib.h>
+#include <Library/UefiDriverEntryPoint.h>
+#include <Library/UefiLib.h>
+#include <Library/BaseLib.h>
+#include <Library/BaseMemoryLib.h>
+#include <Library/MemoryAllocationLib.h>
+#include <Library/UefiBootServicesTableLib.h>
+#include <Library/PrintLib.h>
+
+STATIC RASPBERRY_PI_FIRMWARE_PROTOCOL *mFwProtocol;
+
+/***********************************************************************
+        SMBIOS data definition  TYPE0  BIOS Information
+************************************************************************/
+SMBIOS_TABLE_TYPE0 mBIOSInfoType0 = {
+  { EFI_SMBIOS_TYPE_BIOS_INFORMATION, sizeof (SMBIOS_TABLE_TYPE0), 0 },
+  1,                    // Vendor String
+  2,                    // BiosVersion String
+  0x0,                  // BiosSegment
+  3,                    // BiosReleaseDate String
+  0x1F,                 // BiosSize
+  {                     // BiosCharacteristics
+    0,    //  Reserved                          :2;  ///< Bits 0-1.
+    0,    //  Unknown                           :1;
+    0,    //  BiosCharacteristicsNotSupported   :1;
+    0,    //  IsaIsSupported                    :1;
+    0,    //  McaIsSupported                    :1;
+    0,    //  EisaIsSupported                   :1;
+    0,    //  PciIsSupported                    :1;
+    0,    //  PcmciaIsSupported                 :1;
+    0,    //  PlugAndPlayIsSupported            :1;
+    0,    //  ApmIsSupported                    :1;
+    0,    //  BiosIsUpgradable                  :1;
+    0,    //  BiosShadowingAllowed              :1;
+    0,    //  VlVesaIsSupported                 :1;
+    0,    //  EscdSupportIsAvailable            :1;
+    0,    //  BootFromCdIsSupported             :1;
+    1,    //  SelectableBootIsSupported         :1;
+    0,    //  RomBiosIsSocketed                 :1;
+    0,    //  BootFromPcmciaIsSupported         :1;
+    0,    //  EDDSpecificationIsSupported       :1;
+    0,    //  JapaneseNecFloppyIsSupported      :1;
+    0,    //  JapaneseToshibaFloppyIsSupported  :1;
+    0,    //  Floppy525_360IsSupported          :1;
+    0,    //  Floppy525_12IsSupported           :1;
+    0,    //  Floppy35_720IsSupported           :1;
+    0,    //  Floppy35_288IsSupported           :1;
+    0,    //  PrintScreenIsSupported            :1;
+    0,    //  Keyboard8042IsSupported           :1;
+    0,    //  SerialIsSupported                 :1;
+    0,    //  PrinterIsSupported                :1;
+    0,    //  CgaMonoIsSupported                :1;
+    0,    //  NecPc98                           :1;
+    0     //  ReservedForVendor                 :32; ///< Bits 32-63. Bits 32-47 reserved for BIOS vendor
+    ///< and bits 48-63 reserved for System Vendor.
+  },
+  {       // BIOSCharacteristicsExtensionBytes[]
+    0x01, //  AcpiIsSupported                   :1;
+          //  UsbLegacyIsSupported              :1;
+          //  AgpIsSupported                    :1;
+          //  I2OBootIsSupported                :1;
+          //  Ls120BootIsSupported              :1;
+          //  AtapiZipDriveBootIsSupported      :1;
+          //  Boot1394IsSupported               :1;
+          //  SmartBatteryIsSupported           :1;
+          //  BIOSCharacteristicsExtensionBytes[1]
+    0x0e, //  BiosBootSpecIsSupported              :1;
+          //  FunctionKeyNetworkBootIsSupported    :1;
+          //  TargetContentDistributionEnabled     :1;
+          //  UefiSpecificationSupported           :1;
+          //  VirtualMachineSupported              :1;
+          //  ExtensionByte2Reserved               :3;
+  },
+  0xFF,                    // SystemBiosMajorRelease
+  0xFF,                    // SystemBiosMinorRelease
+  0xFF,                    // EmbeddedControllerFirmwareMajorRelease
+  0xFF,                    // EmbeddedControllerFirmwareMinorRelease
+};
+
+CHAR8 *mBIOSInfoType0Strings[] = {
+  "https://github.com/andreiw/RaspberryPiPkg",             // Vendor String
+  "Raspberry Pi 64-bit UEFI (" __DATE__ " " __TIME__ ")",  // BiosVersion String
+  __DATE__,
+  NULL
+};
+
+/***********************************************************************
+        SMBIOS data definition  TYPE1  System Information
+************************************************************************/
+SMBIOS_TABLE_TYPE1 mSysInfoType1 = {
+  { EFI_SMBIOS_TYPE_SYSTEM_INFORMATION, sizeof (SMBIOS_TABLE_TYPE1), 0 },
+  1,    // Manufacturer String
+  2,    // ProductName String
+  3,    // Version String
+  4,    // SerialNumber String
+  { 0x25EF0280, 0xEC82, 0x42B0, { 0x8F, 0xB6, 0x10, 0xAD, 0xCC, 0xC6, 0x7C, 0x02 } },
+  SystemWakeupTypePowerSwitch,
+  5,    // SKUNumber String
+  6,    // Family String
+};
+
+#define PROD_BASE     8
+#define PROD_KNOWN   13
+#define PROD_UNKNOWN 11
+CHAR8 *ProductNames[] = {
+  /* 8 */ "3",
+  /* 9 */ "Zero",
+  /* 10 */ "CM3",
+  /* 11 */ "???",
+  /* 12 */ "Zero W",
+  /* 13 */ "3B+"
+};
+
+#define MANU_UNKNOWN 0
+#define MANU_KNOWN   4
+#define MANU_BASE    1
+CHAR8 *ManufNames[] = {
+  "???",
+  /* 0 */ "Sony",
+  /* 1 */ "Egoman",
+  /* 2 */ "Embest",
+  /* 3 */ "Sony Japan",
+  /* 4 */ "Embest"
+};
+
+CHAR8 mSysInfoManufName[sizeof ("Sony Japan")];
+CHAR8 mSysInfoProductName[sizeof ("64-bit Raspberry Pi XXXXXX (rev. xxxxxxxx)")];
+CHAR8 mSysInfoSerial[sizeof (UINT64) * 2 + 1];
+CHAR8 mSysInfoSKU[sizeof (UINT64) * 2 + 1];
+
+CHAR8 *mSysInfoType1Strings[] = {
+  mSysInfoManufName,
+  mSysInfoProductName,
+  mSysInfoProductName,
+  mSysInfoSerial,
+  mSysInfoSKU,
+  "edk2",
+  NULL
+};
+
+/***********************************************************************
+        SMBIOS data definition  TYPE2  Board Information
+************************************************************************/
+SMBIOS_TABLE_TYPE2 mBoardInfoType2 = {
+  { EFI_SMBIOS_TYPE_BASEBOARD_INFORMATION, sizeof (SMBIOS_TABLE_TYPE2), 0 },
+  1,    // Manufacturer String
+  2,    // ProductName String
+  3,    // Version String
+  4,    // SerialNumber String
+  5,    // AssetTag String
+  {     // FeatureFlag
+    1,    //  Motherboard           :1;
+    0,    //  RequiresDaughterCard  :1;
+    0,    //  Removable             :1;
+    0,    //  Replaceable           :1;
+    0,    //  HotSwappable          :1;
+    0,    //  Reserved              :3;
+  },
+  6,    // LocationInChassis String
+  0,                        // ChassisHandle;
+  BaseBoardTypeMotherBoard, // BoardType;
+  0,                        // NumberOfContainedObjectHandles;
+  { 0 }                     // ContainedObjectHandles[1];
+};
+CHAR8 *mBoardInfoType2Strings[] = {
+  mSysInfoManufName,
+  mSysInfoProductName,
+  mSysInfoProductName,
+  mSysInfoSerial,
+  "None",
+  mSysInfoSKU,
+  NULL
+};
+
+/***********************************************************************
+        SMBIOS data definition  TYPE3  Enclosure Information
+************************************************************************/
+SMBIOS_TABLE_TYPE3 mEnclosureInfoType3 = {
+  { EFI_SMBIOS_TYPE_SYSTEM_ENCLOSURE, sizeof (SMBIOS_TABLE_TYPE3), 0 },
+  1,                        // Manufacturer String
+  MiscChassisEmbeddedPc,    // Type;
+  2,                        // Version String
+  3,                        // SerialNumber String
+  4,                        // AssetTag String
+  ChassisStateSafe,         // BootupState;
+  ChassisStateSafe,         // PowerSupplyState;
+  ChassisStateSafe,         // ThermalState;
+  ChassisSecurityStatusNone,// SecurityStatus;
+  { 0, 0, 0, 0 },           // OemDefined[4];
+  0,    // Height;
+  0,    // NumberofPowerCords;
+  0,    // ContainedElementCount;
+  0,    // ContainedElementRecordLength;
+  { { 0 } },    // ContainedElements[1];
+};
+CHAR8 *mEnclosureInfoType3Strings[] = {
+  mSysInfoManufName,
+  mSysInfoProductName,
+  mSysInfoSerial,
+  "None",
+  NULL
+};
+
+/***********************************************************************
+        SMBIOS data definition  TYPE4  Processor Information
+************************************************************************/
+SMBIOS_TABLE_TYPE4 mProcessorInfoType4 = {
+  { EFI_SMBIOS_TYPE_PROCESSOR_INFORMATION, sizeof (SMBIOS_TABLE_TYPE4), 0},
+  1,                    // Socket String
+  CentralProcessor,       // ProcessorType;                                   ///< The enumeration value from PROCESSOR_TYPE_DATA.
+  ProcessorFamilyIndicatorFamily2, // ProcessorFamily;        ///< The enumeration value from PROCESSOR_FAMILY2_DATA.
+  2,                    // ProcessorManufacture String;
+  {                     // ProcessorId;
+    {  // PROCESSOR_SIGNATURE
+      0, //  ProcessorSteppingId:4;
+      0, //  ProcessorModel:     4;
+      0, //  ProcessorFamily:    4;
+      0, //  ProcessorType:      2;
+      0, //  ProcessorReserved1: 2;
+      0, //  ProcessorXModel:    4;
+      0, //  ProcessorXFamily:   8;
+      0, //  ProcessorReserved2: 4;
+    },
+
+    {  // PROCESSOR_FEATURE_FLAGS
+      0, //  ProcessorFpu       :1;
+      0, //  ProcessorVme       :1;
+      0, //  ProcessorDe        :1;
+      0, //  ProcessorPse       :1;
+      0, //  ProcessorTsc       :1;
+      0, //  ProcessorMsr       :1;
+      0, //  ProcessorPae       :1;
+      0, //  ProcessorMce       :1;
+      0, //  ProcessorCx8       :1;
+      0, //  ProcessorApic      :1;
+      0, //  ProcessorReserved1 :1;
+      0, //  ProcessorSep       :1;
+      0, //  ProcessorMtrr      :1;
+      0, //  ProcessorPge       :1;
+      0, //  ProcessorMca       :1;
+      0, //  ProcessorCmov      :1;
+      0, //  ProcessorPat       :1;
+      0, //  ProcessorPse36     :1;
+      0, //  ProcessorPsn       :1;
+      0, //  ProcessorClfsh     :1;
+      0, //  ProcessorReserved2 :1;
+      0, //  ProcessorDs        :1;
+      0, //  ProcessorAcpi      :1;
+      0, //  ProcessorMmx       :1;
+      0, //  ProcessorFxsr      :1;
+      0, //  ProcessorSse       :1;
+      0, //  ProcessorSse2      :1;
+      0, //  ProcessorSs        :1;
+      0, //  ProcessorReserved3 :1;
+      0, //  ProcessorTm        :1;
+      0, //  ProcessorReserved4 :2;
+    }
+  },
+  3,                    // ProcessorVersion String;
+  {                     // Voltage;
+    1,  // ProcessorVoltageCapability5V        :1;
+    1,  // ProcessorVoltageCapability3_3V      :1;
+    1,  // ProcessorVoltageCapability2_9V      :1;
+    0,  // ProcessorVoltageCapabilityReserved  :1; ///< Bit 3, must be zero.
+    0,  // ProcessorVoltageReserved            :3; ///< Bits 4-6, must be zero.
+    0   // ProcessorVoltageIndicateLegacy      :1;
+  },
+  0,                      // ExternalClock;
+  0,                      // MaxSpeed;
+  0,                      // CurrentSpeed;
+  0x41,                   // Status;
+  ProcessorUpgradeOther,  // ProcessorUpgrade;      ///< The enumeration value from PROCESSOR_UPGRADE.
+  0,                      // L1CacheHandle;
+  0,                      // L2CacheHandle;
+  0,                      // L3CacheHandle;
+  4,                      // SerialNumber;
+  5,                      // AssetTag;
+  6,                      // PartNumber;
+  4,                      // CoreCount;
+  4,                      // EnabledCoreCount;
+  4,                      // ThreadCount;
+  0x6C,                   // ProcessorCharacteristics;
+  ProcessorFamilyARM,     // ARM Processor Family;
+};
+
+CHAR8 *mProcessorInfoType4Strings[] = {
+  "Socket",
+  "ARM",
+  "BCM2837 ARMv8",
+  "1.0",
+  "1.0",
+  "1.0",
+  NULL
+};
+
+/***********************************************************************
+        SMBIOS data definition  TYPE7  Cache Information
+************************************************************************/
+SMBIOS_TABLE_TYPE7 mCacheInfoType7 = {
+  { EFI_SMBIOS_TYPE_CACHE_INFORMATION, sizeof (SMBIOS_TABLE_TYPE7), 0 },
+  1,                        // SocketDesignation String
+  0x018A,                                       // Cache Configuration
+  0x00FF,                                       // Maximum Size 256k
+  0x00FF,                                       // Install Size 256k
+  {                         // Supported SRAM Type
+    0,  //Other             :1
+    0,  //Unknown           :1
+    0,  //NonBurst          :1
+    1,  //Burst             :1
+    0,  //PiplelineBurst    :1
+    1,  //Synchronous       :1
+    0,  //Asynchronous      :1
+    0   //Reserved          :9
+  },
+  {                         // Current SRAM Type
+    0,  //Other             :1
+    0,  //Unknown           :1
+    0,  //NonBurst          :1
+    1,  //Burst             :1
+    0,  //PiplelineBurst    :1
+    1,  //Synchronous       :1
+    0,  //Asynchronous      :1
+    0   //Reserved          :9
+  },
+  0,                                            // Cache Speed unknown
+  CacheErrorMultiBit,           // Error Correction Multi
+  CacheTypeUnknown,                     // System Cache Type
+  CacheAssociativity2Way        // Associativity
+};
+CHAR8  *mCacheInfoType7Strings[] = {
+  "Cache1",
+  NULL
+};
+
+/***********************************************************************
+        SMBIOS data definition  TYPE9  System Slot Information
+************************************************************************/
+SMBIOS_TABLE_TYPE9  mSysSlotInfoType9 = {
+  { EFI_SMBIOS_TYPE_SYSTEM_SLOTS, sizeof (SMBIOS_TABLE_TYPE9), 0 },
+  1,    // SlotDesignation String
+  SlotTypeOther,          // SlotType;                 ///< The enumeration value from MISC_SLOT_TYPE.
+  SlotDataBusWidthOther,  // SlotDataBusWidth;         ///< The enumeration value from MISC_SLOT_DATA_BUS_WIDTH.
+  SlotUsageAvailable,     // CurrentUsage;             ///< The enumeration value from MISC_SLOT_USAGE.
+  SlotLengthOther,        // SlotLength;               ///< The enumeration value from MISC_SLOT_LENGTH.
+  0,    // SlotID;
+  {    // SlotCharacteristics1;
+    1,  // CharacteristicsUnknown  :1;
+    0,  // Provides50Volts         :1;
+    0,  // Provides33Volts         :1;
+    0,  // SharedSlot              :1;
+    0,  // PcCard16Supported       :1;
+    0,  // CardBusSupported        :1;
+    0,  // ZoomVideoSupported      :1;
+    0,  // ModemRingResumeSupported:1;
+  },
+  {     // SlotCharacteristics2;
+    0,  // PmeSignalSupported      :1;
+    0,  // HotPlugDevicesSupported :1;
+    0,  // SmbusSignalSupported    :1;
+    0,  // Reserved                :5;  ///< Set to 0.
+  },
+  0,    // SegmentGroupNum;
+  0,    // BusNum;
+  0,    // DevFuncNum;
+};
+CHAR8 *mSysSlotInfoType9Strings[] = {
+  "SD Card",
+  NULL
+};
+
+/***********************************************************************
+        SMBIOS data definition  TYPE16  Physical Memory ArrayInformation
+************************************************************************/
+SMBIOS_TABLE_TYPE16 mPhyMemArrayInfoType16 = {
+  { EFI_SMBIOS_TYPE_PHYSICAL_MEMORY_ARRAY, sizeof (SMBIOS_TABLE_TYPE16), 0 },
+  MemoryArrayLocationSystemBoard, // Location;                       ///< The enumeration value from MEMORY_ARRAY_LOCATION.
+  MemoryArrayUseSystemMemory,     // Use;                            ///< The enumeration value from MEMORY_ARRAY_USE.
+  MemoryErrorCorrectionUnknown,   // MemoryErrorCorrection;          ///< The enumeration value from MEMORY_ERROR_CORRECTION.
+  0x40000000,                     // MaximumCapacity;
+  0xFFFE,                         // MemoryErrorInformationHandle;
+  1,                              // NumberOfMemoryDevices;
+  0x40000000ULL,                  // ExtendedMaximumCapacity;
+};
+CHAR8 *mPhyMemArrayInfoType16Strings[] = {
+  NULL
+};
+
+/***********************************************************************
+        SMBIOS data definition  TYPE17  Memory Device Information
+************************************************************************/
+SMBIOS_TABLE_TYPE17 mMemDevInfoType17 = {
+  { EFI_SMBIOS_TYPE_MEMORY_DEVICE, sizeof (SMBIOS_TABLE_TYPE17), 0 },
+  0,          // MemoryArrayHandle; // Should match SMBIOS_TABLE_TYPE16.Handle, initialized at runtime, refer to PhyMemArrayInfoUpdateSmbiosType16()
+  0xFFFE,     // MemoryErrorInformationHandle;
+  0xFFFF,     // TotalWidth;
+  0xFFFF,     // DataWidth;
+  0x0400,     // Size; // When bit 15 is 0: Size in MB
+              // When bit 15 is 1: Size in KB, and continues in ExtendedSize
+  MemoryFormFactorUnknown, // FormFactor;                     ///< The enumeration value from MEMORY_FORM_FACTOR.
+  0xff,       // DeviceSet;
+  1,          // DeviceLocator String
+  2,          // BankLocator String
+  MemoryTypeDram,         // MemoryType;                     ///< The enumeration value from MEMORY_DEVICE_TYPE.
+  {           // TypeDetail;
+    0,  // Reserved        :1;
+    0,  // Other           :1;
+    1,  // Unknown         :1;
+    0,  // FastPaged       :1;
+    0,  // StaticColumn    :1;
+    0,  // PseudoStatic    :1;
+    0,  // Rambus          :1;
+    0,  // Synchronous     :1;
+    0,  // Cmos            :1;
+    0,  // Edo             :1;
+    0,  // WindowDram      :1;
+    0,  // CacheDram       :1;
+    0,  // Nonvolatile     :1;
+    0,  // Registered      :1;
+    0,  // Unbuffered      :1;
+    0,  // Reserved1       :1;
+  },
+  0,          // Speed;
+  3,          // Manufacturer String
+  0,          // SerialNumber String
+  0,          // AssetTag String
+  0,          // PartNumber String
+  0,          // Attributes;
+  0,          // ExtendedSize;
+  0,          // ConfiguredMemoryClockSpeed;
+};
+CHAR8 *mMemDevInfoType17Strings[] = {
+  "OS Virtual Memory",
+  "malloc",
+  "OSV",
+  NULL
+};
+
+/***********************************************************************
+        SMBIOS data definition  TYPE19  Memory Array Mapped Address Information
+************************************************************************/
+SMBIOS_TABLE_TYPE19 mMemArrMapInfoType19 = {
+  { EFI_SMBIOS_TYPE_MEMORY_ARRAY_MAPPED_ADDRESS, sizeof (SMBIOS_TABLE_TYPE19), 0 },
+  0x00000000, // StartingAddress;
+  0x00000000, // EndingAddress;
+  0,          // MemoryArrayHandle;
+  1,          // PartitionWidth;
+  0,          // ExtendedStartingAddress;
+  0,          // ExtendedEndingAddress;
+};
+CHAR8 *mMemArrMapInfoType19Strings[] = {
+  NULL
+};
+
+/***********************************************************************
+        SMBIOS data definition  TYPE32  Boot Information
+************************************************************************/
+SMBIOS_TABLE_TYPE32 mBootInfoType32 = {
+  { EFI_SMBIOS_TYPE_SYSTEM_BOOT_INFORMATION, sizeof (SMBIOS_TABLE_TYPE32), 0 },
+  { 0, 0, 0, 0, 0, 0 },         // Reserved[6];
+  BootInformationStatusNoError  // BootStatus
+};
+
+CHAR8 *mBootInfoType32Strings[] = {
+  NULL
+};
+
+
+/**
+
+   Create SMBIOS record.
+
+   Converts a fixed SMBIOS structure and an array of pointers to strings into
+   an SMBIOS record where the strings are cat'ed on the end of the fixed record
+   and terminated via a double NULL and add to SMBIOS table.
+
+   SMBIOS_TABLE_TYPE32 gSmbiosType12 = {
+   { EFI_SMBIOS_TYPE_SYSTEM_CONFIGURATION_OPTIONS, sizeof (SMBIOS_TABLE_TYPE12), 0 },
+   1 // StringCount
+   };
+
+   CHAR8 *gSmbiosType12Strings[] = {
+   "Not Found",
+   NULL
+   };
+
+   ...
+
+   LogSmbiosData (
+   (EFI_SMBIOS_TABLE_HEADER*)&gSmbiosType12,
+   gSmbiosType12Strings
+   );
+
+   @param  Template    Fixed SMBIOS structure, required.
+   @param  StringPack  Array of strings to convert to an SMBIOS string pack.
+   NULL is OK.
+   @param  DataSmbiosHande  The new SMBIOS record handle .
+   NULL is OK.
+**/
+
+EFI_STATUS
+EFIAPI
+LogSmbiosData (
+  IN  EFI_SMBIOS_TABLE_HEADER *Template,
+  IN  CHAR8                   **StringPack,
+  OUT EFI_SMBIOS_HANDLE       *DataSmbiosHande
+  )
+{
+  EFI_STATUS                Status;
+  EFI_SMBIOS_PROTOCOL       *Smbios;
+  EFI_SMBIOS_HANDLE         SmbiosHandle;
+  EFI_SMBIOS_TABLE_HEADER   *Record;
+  UINTN                     Index;
+  UINTN                     StringSize;
+  UINTN                     Size;
+  CHAR8                     *Str;
+
+  //
+  // Locate Smbios protocol.
+  //
+  Status = gBS->LocateProtocol (&gEfiSmbiosProtocolGuid, NULL, (VOID**)&Smbios);
+
+  if (EFI_ERROR (Status)) {
+    return Status;
+  }
+
+  // Calculate the size of the fixed record and optional string pack
+
+  Size = Template->Length;
+  if (StringPack == NULL) {
+    // At least a double null is required
+    Size += 2;
+  } else {
+    for (Index = 0; StringPack[Index] != NULL; Index++) {
+      StringSize = AsciiStrSize (StringPack[Index]);
+      Size += StringSize;
+    }
+    if (StringPack[0] == NULL) {
+      // At least a double null is required
+      Size += 1;
+    }
+
+    // Don't forget the terminating double null
+    Size += 1;
+  }
+
+  // Copy over Template
+  Record = (EFI_SMBIOS_TABLE_HEADER*)AllocateZeroPool (Size);
+  if (Record == NULL) {
+    return EFI_OUT_OF_RESOURCES;
+  }
+  CopyMem (Record, Template, Template->Length);
+
+  // Append string pack
+  Str = ((CHAR8*)Record) + Record->Length;
+
+  for (Index = 0; StringPack[Index] != NULL; Index++) {
+    StringSize = AsciiStrSize (StringPack[Index]);
+    CopyMem (Str, StringPack[Index], StringSize);
+    Str += StringSize;
+  }
+
+  *Str = 0;
+  SmbiosHandle = SMBIOS_HANDLE_PI_RESERVED;
+  Status = Smbios->Add (
+                     Smbios,
+                     gImageHandle,
+                     &SmbiosHandle,
+                     Record
+                   );
+
+  if ((Status == EFI_SUCCESS) && (DataSmbiosHande != NULL)) {
+    *DataSmbiosHande = SmbiosHandle;
+  }
+
+  ASSERT_EFI_ERROR (Status);
+  FreePool (Record);
+  return Status;
+}
+
+/***********************************************************************
+        SMBIOS data update  TYPE0  BIOS Information
+************************************************************************/
+VOID
+BIOSInfoUpdateSmbiosType0 (
+  VOID
+  )
+{
+  LogSmbiosData ((EFI_SMBIOS_TABLE_HEADER*)&mBIOSInfoType0, mBIOSInfoType0Strings, NULL);
+}
+
+/***********************************************************************
+        SMBIOS data update  TYPE1  System Information
+************************************************************************/
+VOID
+I64ToHexString (
+  IN OUT CHAR8* TargetStringSz,
+  IN UINT32 TargetStringSize,
+  IN UINT64 Value
+  )
+{
+  static CHAR8 ItoH[] = { '0','1','2','3','4','5','6','7','8','9','A','B','C','D','E','F' };
+  UINT8 StringInx;
+  INT8 NibbleInx;
+
+  ZeroMem ((void*)TargetStringSz, TargetStringSize);
+
+  //
+  // Convert each nibble to hex string, starting from
+  // the highest non-zero nibble.
+  //
+  StringInx = 0;
+  for (NibbleInx = sizeof (UINT64) * 2; NibbleInx > 0; --NibbleInx) {
+    UINT64 NibbleMask = (((UINT64)0xF) << ((NibbleInx - 1) * 4));
+    UINT8 Nibble = (UINT8)((Value & NibbleMask) >> ((NibbleInx - 1) * 4));
+
+    ASSERT (Nibble <= 0xF);
+
+    if (StringInx < (TargetStringSize - 1)) {
+      TargetStringSz[StringInx++] = ItoH[Nibble];
+    } else {
+      break;
+    }
+  }
+}
+
+VOID
+SysInfoUpdateSmbiosType1 (
+  VOID
+  )
+{
+  UINT32 BoardRevision = 0;
+  EFI_STATUS Status = EFI_SUCCESS;
+  UINT64 BoardSerial = 0;
+  UINTN Prod = PROD_UNKNOWN;
+  UINTN Manu = MANU_UNKNOWN;
+
+  Status = mFwProtocol->GetModelRevision (&BoardRevision);
+  if (EFI_ERROR (Status)) {
+    DEBUG ((DEBUG_ERROR, "Failed to get board model: %r\n", Status));
+  } else {
+    Prod = (BoardRevision >> 4) & 0xFF;
+  }
+
+  if (Prod > PROD_KNOWN) {
+    Prod = PROD_UNKNOWN;
+  }
+  Prod -= PROD_BASE;
+  AsciiSPrint (mSysInfoProductName, sizeof (mSysInfoProductName),
+    "64-bit Raspberry Pi %a (rev. %x)", ProductNames[Prod], BoardRevision);
+
+  Manu = (BoardRevision >> 16) & 0xF;
+  if (Manu > MANU_KNOWN) {
+    Manu = MANU_UNKNOWN;
+  } else {
+    Manu += MANU_BASE;
+  }
+  AsciiSPrint (mSysInfoManufName, sizeof (mSysInfoManufName), "%a", ManufNames[Manu]);
+
+  I64ToHexString (mSysInfoSKU,
+    sizeof (mSysInfoSKU),
+    BoardRevision);
+
+  Status = mFwProtocol->GetSerial (&BoardSerial);
+  if (EFI_ERROR (Status)) {
+    DEBUG ((DEBUG_ERROR, "Failed to get board serial: %r\n", Status));
+  }
+
+  I64ToHexString (mSysInfoSerial, sizeof (mSysInfoSerial), BoardSerial);
+
+  DEBUG ((DEBUG_ERROR, "Board Serial Number: %a\n", mSysInfoSerial));
+
+  mSysInfoType1.Uuid.Data1 = *(UINT32*)"RPi3";
+  mSysInfoType1.Uuid.Data2 = 0x0;
+  mSysInfoType1.Uuid.Data3 = 0x0;
+  CopyMem (mSysInfoType1.Uuid.Data4, &BoardSerial, sizeof (BoardSerial));
+
+  LogSmbiosData ((EFI_SMBIOS_TABLE_HEADER*)&mSysInfoType1, mSysInfoType1Strings, NULL);
+}
+
+/***********************************************************************
+        SMBIOS data update  TYPE2  Board Information
+************************************************************************/
+VOID
+BoardInfoUpdateSmbiosType2 (
+  VOID
+  )
+{
+  LogSmbiosData ((EFI_SMBIOS_TABLE_HEADER*)&mBoardInfoType2, mBoardInfoType2Strings, NULL);
+}
+
+/***********************************************************************
+        SMBIOS data update  TYPE3  Enclosure Information
+************************************************************************/
+VOID
+EnclosureInfoUpdateSmbiosType3 (
+  VOID
+  )
+{
+  LogSmbiosData ((EFI_SMBIOS_TABLE_HEADER*)&mEnclosureInfoType3, mEnclosureInfoType3Strings, NULL);
+}
+
+/***********************************************************************
+        SMBIOS data update  TYPE4  Processor Information
+************************************************************************/
+VOID
+ProcessorInfoUpdateSmbiosType4 (
+  IN UINTN MaxCpus
+  )
+{
+  EFI_STATUS Status;
+  UINT32 Rate;
+
+  mProcessorInfoType4.CoreCount = (UINT8)MaxCpus;
+  mProcessorInfoType4.EnabledCoreCount = (UINT8)MaxCpus;
+  mProcessorInfoType4.ThreadCount = (UINT8)MaxCpus;
+
+  Status = mFwProtocol->GetMaxClockRate (RPI_MBOX_CLOCK_RATE_ARM, &Rate);
+  if (Status != EFI_SUCCESS) {
+    DEBUG ((DEBUG_ERROR, "Couldn't get the max CPU speed: %r\n", Status));
+  } else {
+    mProcessorInfoType4.MaxSpeed = Rate / 1000000;
+    DEBUG ((DEBUG_INFO, "Max CPU speed: %uHz\n", Rate));
+  }
+
+  Status = mFwProtocol->GetClockRate (RPI_MBOX_CLOCK_RATE_ARM, &Rate);
+  if (Status != EFI_SUCCESS) {
+    DEBUG ((DEBUG_ERROR, "Couldn't get the current CPU speed: %r\n", Status));
+  } else {
+    mProcessorInfoType4.CurrentSpeed = Rate / 1000000;
+    DEBUG ((DEBUG_INFO, "Current CPU speed: %uHz\n", Rate));
+  }
+
+  LogSmbiosData ((EFI_SMBIOS_TABLE_HEADER*)&mProcessorInfoType4, mProcessorInfoType4Strings, NULL);
+}
+
+/***********************************************************************
+        SMBIOS data update  TYPE7  Cache Information
+************************************************************************/
+VOID
+CacheInfoUpdateSmbiosType7 (
+  VOID
+  )
+{
+  LogSmbiosData ((EFI_SMBIOS_TABLE_HEADER*)&mCacheInfoType7, mCacheInfoType7Strings, NULL);
+}
+
+/***********************************************************************
+        SMBIOS data update  TYPE9  System Slot Information
+************************************************************************/
+VOID
+SysSlotInfoUpdateSmbiosType9 (
+  VOID
+  )
+{
+  LogSmbiosData ((EFI_SMBIOS_TABLE_HEADER*)&mSysSlotInfoType9, mSysSlotInfoType9Strings, NULL);
+}
+
+/***********************************************************************
+        SMBIOS data update  TYPE16  Physical Memory Array Information
+************************************************************************/
+VOID
+PhyMemArrayInfoUpdateSmbiosType16 (
+  VOID
+  )
+{
+  EFI_SMBIOS_HANDLE MemArraySmbiosHande;
+
+  LogSmbiosData ((EFI_SMBIOS_TABLE_HEADER*)&mPhyMemArrayInfoType16, mPhyMemArrayInfoType16Strings, &MemArraySmbiosHande);
+
+  //
+  // Update the memory device information
+  //
+  mMemDevInfoType17.MemoryArrayHandle = MemArraySmbiosHande;
+}
+
+/***********************************************************************
+        SMBIOS data update  TYPE17  Memory Device Information
+************************************************************************/
+VOID
+MemDevInfoUpdateSmbiosType17 (
+  VOID
+  )
+{
+  LogSmbiosData ((EFI_SMBIOS_TABLE_HEADER*)&mMemDevInfoType17, mMemDevInfoType17Strings, NULL);
+}
+
+/***********************************************************************
+        SMBIOS data update  TYPE19  Memory Array Map Information
+************************************************************************/
+VOID
+MemArrMapInfoUpdateSmbiosType19 (
+  VOID
+  )
+{
+  EFI_STATUS Status;
+  UINT32 Base;
+  UINT32 Size;
+
+  Status = mFwProtocol->GetArmMem (&Base, &Size);
+  if (Status != EFI_SUCCESS) {
+    DEBUG ((DEBUG_ERROR, "Couldn't get the ARM memory size: %r\n", Status));
+  } else {
+    mMemArrMapInfoType19.StartingAddress = Base / 1024;
+    mMemArrMapInfoType19.EndingAddress = (Base + Size - 1) / 1024;
+  }
+
+  LogSmbiosData ((EFI_SMBIOS_TABLE_HEADER*)&mMemArrMapInfoType19, mMemArrMapInfoType19Strings, NULL);
+}
+
+
+/***********************************************************************
+        SMBIOS data update  TYPE32  Boot Information
+************************************************************************/
+VOID
+BootInfoUpdateSmbiosType32 (
+  VOID
+  )
+{
+  LogSmbiosData ((EFI_SMBIOS_TABLE_HEADER*)&mBootInfoType32, mBootInfoType32Strings, NULL);
+}
+
+/***********************************************************************
+        Driver Entry
+************************************************************************/
+EFI_STATUS
+EFIAPI
+PlatformSmbiosDriverEntryPoint (
+  IN EFI_HANDLE        ImageHandle,
+  IN EFI_SYSTEM_TABLE  *SystemTable
+  )
+{
+  EFI_STATUS Status;
+
+  Status = gBS->LocateProtocol (&gRaspberryPiFirmwareProtocolGuid, NULL,
+    (VOID**)&mFwProtocol);
+  ASSERT_EFI_ERROR (Status);
+  if (EFI_ERROR (Status)) {
+    return Status;
+  }
+
+  BIOSInfoUpdateSmbiosType0 ();
+
+  SysInfoUpdateSmbiosType1 ();
+
+  BoardInfoUpdateSmbiosType2 ();
+
+  EnclosureInfoUpdateSmbiosType3 ();
+
+  ProcessorInfoUpdateSmbiosType4 (4);   //One example for creating and updating
+
+  CacheInfoUpdateSmbiosType7 ();
+
+  SysSlotInfoUpdateSmbiosType9 ();
+
+  PhyMemArrayInfoUpdateSmbiosType16 ();
+
+  MemDevInfoUpdateSmbiosType17 ();
+
+  MemArrMapInfoUpdateSmbiosType19 ();
+
+  BootInfoUpdateSmbiosType32 ();
+
+  return EFI_SUCCESS;
+}
diff --git a/Platform/RaspberryPi/RPi3/Drivers/PlatformSmbiosDxe/PlatformSmbiosDxe.inf b/Platform/RaspberryPi/RPi3/Drivers/PlatformSmbiosDxe/PlatformSmbiosDxe.inf
new file mode 100644
index 000000000000..4ae41c038294
--- /dev/null
+++ b/Platform/RaspberryPi/RPi3/Drivers/PlatformSmbiosDxe/PlatformSmbiosDxe.inf
@@ -0,0 +1,56 @@
+#/** @file
+#
+#  SMBIOS Table for ARM platform
+#
+#  Copyright (c) 2017, Andrei Warkentin <andrey.warkentin@gmail.com>
+#  Copyright (c) Microsoft Corporation. All rights reserved.
+#  Copyright (c) 2013 Linaro.org
+#
+#  This program and the accompanying materials
+#  are licensed and made available under the terms and conditions of the BSD License
+#  which accompanies this distribution.  The full text of the license may be found at
+#  http://opensource.org/licenses/bsd-license.php
+#
+#  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+#  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+#
+#**/
+
+[Defines]
+  INF_VERSION                    = 0x0001001A
+  BASE_NAME                      = PlatformSmbiosDxe
+  FILE_GUID                      = BAD0554E-22E9-4D83-9AFD-CC87727A1A45
+  MODULE_TYPE                    = DXE_DRIVER
+  VERSION_STRING                 = 1.0
+  ENTRY_POINT                    = PlatformSmbiosDriverEntryPoint
+
+[Sources]
+  PlatformSmbiosDxe.c
+
+[Packages]
+  MdePkg/MdePkg.dec
+  MdeModulePkg/MdeModulePkg.dec
+  ArmPlatformPkg/ArmPlatformPkg.dec
+  ArmPkg/ArmPkg.dec
+  Platform/RaspberryPi/RPi3/RPi3.dec
+
+[LibraryClasses]
+  UefiBootServicesTableLib
+  MemoryAllocationLib
+  BaseMemoryLib
+  BaseLib
+  UefiLib
+  UefiDriverEntryPoint
+  DebugLib
+  PrintLib
+
+[Protocols]
+  gEfiSmbiosProtocolGuid           # PROTOCOL SOMETIMES_CONSUMED
+  gRaspberryPiFirmwareProtocolGuid ## CONSUMES
+[Guids]
+
+[Depex]
+  gEfiSmbiosProtocolGuid AND gRaspberryPiFirmwareProtocolGuid
+
+[Pcd]
+  gArmTokenSpaceGuid.PcdSystemMemorySize
-- 
2.17.0.windows.1



^ permalink raw reply related	[flat|nested] 34+ messages in thread

* [PATCH v5 edk2-platforms 09/22] Platform/RaspberryPi/RPi3: Add display driver
  2019-02-05 16:25 [PATCH v5 edk2-platforms 00/22] Platform/RaspberryPi: Add Raspberry Pi 3 support Pete Batard
                   ` (7 preceding siblings ...)
  2019-02-05 16:25 ` [PATCH v5 edk2-platforms 08/22] Platform/RaspberryPi/RPi3: Add SMBIOS driver Pete Batard
@ 2019-02-05 16:25 ` Pete Batard
  2019-02-05 16:25 ` [PATCH v5 edk2-platforms 10/22] Platform/RaspberryPi/RPi3: Add console driver Pete Batard
                   ` (14 subsequent siblings)
  23 siblings, 0 replies; 34+ messages in thread
From: Pete Batard @ 2019-02-05 16:25 UTC (permalink / raw)
  To: edk2-devel

Implements the EFI_GRAPHICS_OUTPUT_PROTOCOL for the Raspberry
Pi platform, through framebuffer, including resolution querying
and screenshot support.

Contributed-under: TianoCore Contribution Agreement 1.1
Signed-off-by: Pete Batard <pete@akeo.ie>
---
 Platform/RaspberryPi/RPi3/Drivers/DisplayDxe/ComponentName.c | 222 +++++++
 Platform/RaspberryPi/RPi3/Drivers/DisplayDxe/DisplayDxe.c    | 606 ++++++++++++++++++++
 Platform/RaspberryPi/RPi3/Drivers/DisplayDxe/DisplayDxe.h    |  42 ++
 Platform/RaspberryPi/RPi3/Drivers/DisplayDxe/DisplayDxe.inf  |  71 +++
 Platform/RaspberryPi/RPi3/Drivers/DisplayDxe/Screenshot.c    | 375 ++++++++++++
 5 files changed, 1316 insertions(+)

diff --git a/Platform/RaspberryPi/RPi3/Drivers/DisplayDxe/ComponentName.c b/Platform/RaspberryPi/RPi3/Drivers/DisplayDxe/ComponentName.c
new file mode 100644
index 000000000000..9a84aea511f4
--- /dev/null
+++ b/Platform/RaspberryPi/RPi3/Drivers/DisplayDxe/ComponentName.c
@@ -0,0 +1,222 @@
+/** @file
+ *
+ *  Copyright (c) 2018, Andrei Warkentin <andrey.warkentin@gmail.com>
+ *  Copyright (c) 2006-2016, Intel Corporation. All rights reserved.
+ *
+ *  This program and the accompanying materials
+ *  are licensed and made available under the terms and conditions of the BSD License
+ *  which accompanies this distribution.  The full text of the license may be found at
+ *  http://opensource.org/licenses/bsd-license.php
+ *
+ *  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+ *  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+ *
+ **/
+
+#include "DisplayDxe.h"
+
+STATIC
+EFI_STATUS
+EFIAPI
+ComponentNameGetDriverName (
+  IN  EFI_COMPONENT_NAME_PROTOCOL  *This,
+  IN  CHAR8                        *Language,
+  OUT CHAR16                       **DriverName
+  );
+
+STATIC
+EFI_STATUS
+EFIAPI
+ComponentNameGetControllerName (
+  IN  EFI_COMPONENT_NAME_PROTOCOL *This,
+  IN  EFI_HANDLE                  ControllerHandle,
+  IN  EFI_HANDLE                  ChildHandle,
+  IN  CHAR8                       *Language,
+  OUT CHAR16                      **ControllerName
+  );
+
+//
+// EFI Component Name Protocol
+//
+GLOBAL_REMOVE_IF_UNREFERENCED EFI_COMPONENT_NAME_PROTOCOL gComponentName = {
+  ComponentNameGetDriverName,
+  ComponentNameGetControllerName,
+  "eng"
+};
+
+//
+// EFI Component Name 2 Protocol
+//
+GLOBAL_REMOVE_IF_UNREFERENCED EFI_COMPONENT_NAME2_PROTOCOL gComponentName2 = {
+  (EFI_COMPONENT_NAME2_GET_DRIVER_NAME)ComponentNameGetDriverName,
+  (EFI_COMPONENT_NAME2_GET_CONTROLLER_NAME)ComponentNameGetControllerName,
+  "en"
+};
+
+
+STATIC EFI_UNICODE_STRING_TABLE mDriverName[] = {
+  {
+    "eng;en",
+    (CHAR16*)L"Raspberry Pi Display Driver"
+  },
+  {
+    NULL,
+    NULL
+  }
+};
+
+STATIC EFI_UNICODE_STRING_TABLE mDeviceName[] = {
+  {
+    "eng;en",
+    (CHAR16*)L"Raspberry Pi Framebuffer"
+  },
+  {
+    NULL,
+    NULL
+  }
+};
+
+/**
+  Retrieves a Unicode string that is the user readable name of the driver.
+
+  This function retrieves the user readable name of a driver in the form of a
+  Unicode string. If the driver specified by This has a user readable name in
+  the language specified by Language, then a pointer to the driver name is
+  returned in DriverName, and EFI_SUCCESS is returned. If the driver specified
+  by This does not support the language specified by Language,
+  then EFI_UNSUPPORTED is returned.
+
+  @param  This[in]              A pointer to the EFI_COMPONENT_NAME2_PROTOCOL or
+                                EFI_COMPONENT_NAME_PROTOCOL instance.
+
+  @param  Language[in]          A pointer to a Null-terminated ASCII string
+                                array indicating the language. This is the
+                                language of the driver name that the caller is
+                                requesting, and it must match one of the
+                                languages specified in SupportedLanguages. The
+                                number of languages supported by a driver is up
+                                to the driver writer. Language is specified
+                                in RFC 4646 or ISO 639-2 language code format.
+
+  @param  DriverName[out]       A pointer to the Unicode string to return.
+                                This Unicode string is the name of the
+                                driver specified by This in the language
+                                specified by Language.
+
+  @retval EFI_SUCCESS           The Unicode string for the Driver specified by
+                                This and the language specified by Language was
+                                returned in DriverName.
+
+  @retval EFI_INVALID_PARAMETER Language is NULL.
+
+  @retval EFI_INVALID_PARAMETER DriverName is NULL.
+
+  @retval EFI_UNSUPPORTED       The driver specified by This does not support
+                                the language specified by Language.
+
+**/
+STATIC
+EFI_STATUS
+EFIAPI
+ComponentNameGetDriverName (
+  IN  EFI_COMPONENT_NAME_PROTOCOL  *This,
+  IN  CHAR8                        *Language,
+  OUT CHAR16                       **DriverName
+  )
+{
+  return LookupUnicodeString2 (
+           Language,
+           This->SupportedLanguages,
+           mDriverName,
+           DriverName,
+           (BOOLEAN)(This == &gComponentName)
+         );
+}
+
+/**
+  Retrieves a Unicode string that is the user readable name of the controller
+  that is being managed by a driver.
+
+  This function retrieves the user readable name of the controller specified by
+  ControllerHandle and ChildHandle in the form of a Unicode string. If the
+  driver specified by This has a user readable name in the language specified by
+  Language, then a pointer to the controller name is returned in ControllerName,
+  and EFI_SUCCESS is returned.  If the driver specified by This is not currently
+  managing the controller specified by ControllerHandle and ChildHandle,
+  then EFI_UNSUPPORTED is returned.  If the driver specified by This does not
+  support the language specified by Language, then EFI_UNSUPPORTED is returned.
+
+  @param  This[in]              A pointer to the EFI_COMPONENT_NAME2_PROTOCOL or
+                                EFI_COMPONENT_NAME_PROTOCOL instance.
+
+  @param  ControllerHandle[in]  The handle of a controller that the driver
+                                specified by This is managing.  This handle
+                                specifies the controller whose name is to be
+                                returned.
+
+  @param  ChildHandle[in]       The handle of the child controller to retrieve
+                                the name of.  This is an optional parameter that
+                                may be NULL.  It will be NULL for device
+                                drivers.  It will also be NULL for a bus drivers
+                                that wish to retrieve the name of the bus
+                                controller.  It will not be NULL for a bus
+                                driver that wishes to retrieve the name of a
+                                child controller.
+
+  @param  Language[in]          A pointer to a Null-terminated ASCII string
+                                array indicating the language.  This is the
+                                language of the driver name that the caller is
+                                requesting, and it must match one of the
+                                languages specified in SupportedLanguages. The
+                                number of languages supported by a driver is up
+                                to the driver writer. Language is specified in
+                                RFC 4646 or ISO 639-2 language code format.
+
+  @param  ControllerName[out]   A pointer to the Unicode string to return.
+                                This Unicode string is the name of the
+                                controller specified by ControllerHandle and
+                                ChildHandle in the language specified by
+                                Language from the point of view of the driver
+                                specified by This.
+
+  @retval EFI_SUCCESS           The Unicode string for the user readable name in
+                                the language specified by Language for the
+                                driver specified by This was returned in
+                                DriverName.
+
+  @retval EFI_INVALID_PARAMETER ControllerHandle is NULL.
+
+  @retval EFI_INVALID_PARAMETER ChildHandle is not NULL and it is not a valid
+                                EFI_HANDLE.
+
+  @retval EFI_INVALID_PARAMETER Language is NULL.
+
+  @retval EFI_INVALID_PARAMETER ControllerName is NULL.
+
+  @retval EFI_UNSUPPORTED       The driver specified by This is not currently
+                                managing the controller specified by
+                                ControllerHandle and ChildHandle.
+
+  @retval EFI_UNSUPPORTED       The driver specified by This does not support
+                                the language specified by Language.
+
+**/
+STATIC
+EFI_STATUS
+EFIAPI
+ComponentNameGetControllerName (
+  IN  EFI_COMPONENT_NAME_PROTOCOL *This,
+  IN  EFI_HANDLE                  ControllerHandle,
+  IN  EFI_HANDLE                  ChildHandle,
+  IN  CHAR8                       *Language,
+  OUT CHAR16                      **ControllerName
+  )
+{
+  return LookupUnicodeString2 (
+           Language,
+           This->SupportedLanguages,
+           mDeviceName,
+           ControllerName,
+           (BOOLEAN)(This == &gComponentName)
+         );
+}
diff --git a/Platform/RaspberryPi/RPi3/Drivers/DisplayDxe/DisplayDxe.c b/Platform/RaspberryPi/RPi3/Drivers/DisplayDxe/DisplayDxe.c
new file mode 100644
index 000000000000..0e99194e8576
--- /dev/null
+++ b/Platform/RaspberryPi/RPi3/Drivers/DisplayDxe/DisplayDxe.c
@@ -0,0 +1,606 @@
+/** @file
+ *
+ *  Copyright (c) 2017-2018, Andrei Warkentin <andrey.warkentin@gmail.com>
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *
+ *  This program and the accompanying materials
+ *  are licensed and made available under the terms and conditions of the BSD License
+ *  which accompanies this distribution.  The full text of the license may be found at
+ *  http://opensource.org/licenses/bsd-license.php
+ *
+ *  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+ *  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+ *
+ **/
+
+#include <Base.h>
+#include "DisplayDxe.h"
+
+#define POS_TO_FB(posX, posY) ((UINT8*)                                 \
+                               ((UINTN)This->Mode->FrameBufferBase +    \
+                                (posY) * This->Mode->Info->PixelsPerScanLine * \
+                                PI3_BYTES_PER_PIXEL +                   \
+                                (posX) * PI3_BYTES_PER_PIXEL))
+
+STATIC
+EFI_STATUS
+EFIAPI
+DriverSupported (
+  IN EFI_DRIVER_BINDING_PROTOCOL *This,
+  IN EFI_HANDLE                  Controller,
+  IN EFI_DEVICE_PATH_PROTOCOL    *RemainingDevicePath
+  );
+
+STATIC
+EFI_STATUS
+EFIAPI
+DriverStart (
+  IN EFI_DRIVER_BINDING_PROTOCOL *This,
+  IN EFI_HANDLE                  Controller,
+  IN EFI_DEVICE_PATH_PROTOCOL    *RemainingDevicePath
+  );
+
+STATIC
+EFI_STATUS
+EFIAPI
+DriverStop (
+  IN EFI_DRIVER_BINDING_PROTOCOL *This,
+  IN EFI_HANDLE                  Controller,
+  IN UINTN                       NumberOfChildren,
+  IN EFI_HANDLE                  *ChildHandleBuffer
+  );
+
+STATIC
+EFI_STATUS
+EFIAPI
+DisplayQueryMode (
+  IN  EFI_GRAPHICS_OUTPUT_PROTOCOL          *This,
+  IN  UINT32                                ModeNumber,
+  OUT UINTN                                 *SizeOfInfo,
+  OUT EFI_GRAPHICS_OUTPUT_MODE_INFORMATION  **Info
+  );
+
+STATIC
+EFI_STATUS
+EFIAPI
+DisplaySetMode (
+  IN  EFI_GRAPHICS_OUTPUT_PROTOCOL *This,
+  IN  UINT32                       ModeNumber
+  );
+
+STATIC
+EFI_STATUS
+EFIAPI
+DisplayBlt (
+  IN  EFI_GRAPHICS_OUTPUT_PROTOCOL            *This,
+  IN  EFI_GRAPHICS_OUTPUT_BLT_PIXEL           *BltBuffer, OPTIONAL
+  IN  EFI_GRAPHICS_OUTPUT_BLT_OPERATION       BltOperation,
+  IN  UINTN                                   SourceX,
+  IN  UINTN                                   SourceY,
+  IN  UINTN                                   DestinationX,
+  IN  UINTN                                   DestinationY,
+  IN  UINTN                                   Width,
+  IN  UINTN                                   Height,
+  IN  UINTN                                   Delta         OPTIONAL
+  );
+
+STATIC EFI_DRIVER_BINDING_PROTOCOL mDriverBinding = {
+  DriverSupported,
+  DriverStart,
+  DriverStop,
+  0xa,
+  NULL,
+  NULL
+};
+
+typedef struct {
+  VENDOR_DEVICE_PATH DisplayDevicePath;
+  EFI_DEVICE_PATH EndDevicePath;
+} DISPLAY_DEVICE_PATH;
+
+typedef struct {
+  UINT32 Width;
+  UINT32 Height;
+} GOP_MODE_DATA;
+
+STATIC UINT32 mBootWidth;
+STATIC UINT32 mBootHeight;
+STATIC EFI_HANDLE mDevice;
+STATIC RASPBERRY_PI_FIRMWARE_PROTOCOL *mFwProtocol;
+STATIC EFI_CPU_ARCH_PROTOCOL *mCpu;
+
+STATIC UINTN mLastMode;
+STATIC GOP_MODE_DATA mGopModeData[] = {
+  { 800,  600  }, /* Legacy */
+  { 640,  480  }, /* Legacy */
+  { 1024, 768  }, /* Legacy */
+  { 1280, 720  }, /* 720p */
+  { 1920, 1080 }, /* 1080p */
+  { 0,    0    }, /* Physical */
+};
+
+STATIC DISPLAY_DEVICE_PATH mDisplayProtoDevicePath =
+{
+  {
+    {
+      HARDWARE_DEVICE_PATH,
+      HW_VENDOR_DP,
+      {
+        (UINT8)(sizeof (VENDOR_DEVICE_PATH)),
+        (UINT8)((sizeof (VENDOR_DEVICE_PATH)) >> 8),
+      }
+    },
+    EFI_CALLER_ID_GUID,
+  },
+  {
+    END_DEVICE_PATH_TYPE,
+    END_ENTIRE_DEVICE_PATH_SUBTYPE,
+    {
+      sizeof (EFI_DEVICE_PATH_PROTOCOL),
+      0
+    }
+  }
+};
+
+#define PI3_BITS_PER_PIXEL              (32)
+#define PI3_BYTES_PER_PIXEL             (PI3_BITS_PER_PIXEL / 8)
+
+EFI_GRAPHICS_OUTPUT_PROTOCOL gDisplayProto = {
+  DisplayQueryMode,
+  DisplaySetMode,
+  DisplayBlt,
+  NULL
+};
+
+STATIC
+EFI_STATUS
+EFIAPI
+DisplayQueryMode (
+  IN  EFI_GRAPHICS_OUTPUT_PROTOCOL          *This,
+  IN  UINT32                                ModeNumber,
+  OUT UINTN                                 *SizeOfInfo,
+  OUT EFI_GRAPHICS_OUTPUT_MODE_INFORMATION  **Info
+  )
+{
+  EFI_STATUS Status;
+  GOP_MODE_DATA *Mode;
+
+  if (ModeNumber > mLastMode) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  Status = gBS->AllocatePool (
+                  EfiBootServicesData,
+                  sizeof (EFI_GRAPHICS_OUTPUT_MODE_INFORMATION),
+                  (VOID**)Info
+                );
+  if (EFI_ERROR (Status)) {
+    return Status;
+  }
+
+  Mode = &mGopModeData[ModeNumber];
+
+  *SizeOfInfo = sizeof (EFI_GRAPHICS_OUTPUT_MODE_INFORMATION);
+  (*Info)->Version = This->Mode->Info->Version;
+  (*Info)->HorizontalResolution = Mode->Width;
+  (*Info)->VerticalResolution = Mode->Height;
+  (*Info)->PixelFormat = This->Mode->Info->PixelFormat;
+  (*Info)->PixelsPerScanLine = Mode->Width;
+
+  return EFI_SUCCESS;
+}
+
+STATIC
+VOID
+ClearScreen (
+  IN  EFI_GRAPHICS_OUTPUT_PROTOCOL *This
+  )
+{
+  EFI_GRAPHICS_OUTPUT_BLT_PIXEL Fill;
+
+  Fill.Red = 0x00;
+  Fill.Green = 0x00;
+  Fill.Blue = 0x00;
+  This->Blt (This, &Fill, EfiBltVideoFill,
+          0, 0, 0, 0, This->Mode->Info->HorizontalResolution,
+          This->Mode->Info->VerticalResolution,
+          This->Mode->Info->HorizontalResolution *
+          sizeof (EFI_GRAPHICS_OUTPUT_BLT_PIXEL));
+}
+
+STATIC
+EFI_STATUS
+EFIAPI
+DisplaySetMode (
+  IN  EFI_GRAPHICS_OUTPUT_PROTOCOL *This,
+  IN  UINT32                       ModeNumber
+  )
+{
+  UINTN FbSize;
+  UINTN FbPitch;
+  EFI_STATUS Status;
+  EFI_PHYSICAL_ADDRESS FbBase;
+  GOP_MODE_DATA *Mode = &mGopModeData[ModeNumber];
+
+  if (ModeNumber > mLastMode) {
+    return EFI_UNSUPPORTED;
+  }
+
+  DEBUG ((DEBUG_INFO, "Setting mode %u from %u: %u x %u\n",
+    ModeNumber, This->Mode->Mode, Mode->Width, Mode->Height));
+  Status = mFwProtocol->GetFB (Mode->Width, Mode->Height,
+                          PI3_BITS_PER_PIXEL, &FbBase,
+                          &FbSize, &FbPitch);
+  if (EFI_ERROR (Status)) {
+    DEBUG ((DEBUG_ERROR, "Could not set mode %u\n", ModeNumber));
+    return EFI_DEVICE_ERROR;
+  }
+
+  DEBUG ((DEBUG_INFO, "Mode %u: %u x %u framebuffer is %u bytes at %p\n",
+    ModeNumber, Mode->Width, Mode->Height, FbSize, FbBase));
+
+  if (FbPitch / PI3_BYTES_PER_PIXEL != Mode->Width) {
+    DEBUG ((DEBUG_ERROR, "Error: Expected width %u, got width %u\n",
+      Mode->Width, FbPitch / PI3_BYTES_PER_PIXEL));
+    return EFI_DEVICE_ERROR;
+  }
+
+  /*
+   * WT, because certain OS loaders access the frame buffer directly
+   * and we don't want to see corruption due to missing WB cache
+   * maintenance. Performance with WT is good.
+   */
+  Status = mCpu->SetMemoryAttributes (mCpu, FbBase,
+                   ALIGN_VALUE (FbSize, EFI_PAGE_SIZE),
+                   EFI_MEMORY_WT);
+  if (Status != EFI_SUCCESS) {
+    DEBUG ((DEBUG_ERROR, "Couldn't set framebuffer attributes: %r\n", Status));
+    return Status;
+  }
+
+  This->Mode->Mode = ModeNumber;
+  This->Mode->Info->Version = 0;
+  This->Mode->Info->HorizontalResolution = Mode->Width;
+  This->Mode->Info->VerticalResolution = Mode->Height;
+  /*
+   * NOTE: Windows REQUIRES BGR in 32 or 24 bit format.
+   */
+  This->Mode->Info->PixelFormat = PixelBlueGreenRedReserved8BitPerColor;
+  This->Mode->Info->PixelsPerScanLine = Mode->Width;
+  This->Mode->SizeOfInfo = sizeof (*This->Mode->Info);
+  This->Mode->FrameBufferBase = FbBase;
+  This->Mode->FrameBufferSize = FbSize;
+
+  ClearScreen (This);
+  return EFI_SUCCESS;
+}
+
+STATIC
+EFI_STATUS
+EFIAPI
+DisplayBlt (
+  IN  EFI_GRAPHICS_OUTPUT_PROTOCOL      *This,
+  IN  EFI_GRAPHICS_OUTPUT_BLT_PIXEL     *BltBuffer, OPTIONAL
+  IN  EFI_GRAPHICS_OUTPUT_BLT_OPERATION BltOperation,
+  IN  UINTN                             SourceX,
+  IN  UINTN                             SourceY,
+  IN  UINTN                             DestinationX,
+  IN  UINTN                             DestinationY,
+  IN  UINTN                             Width,
+  IN  UINTN                             Height,
+  IN  UINTN                             Delta         OPTIONAL
+  )
+{
+  UINT8 *VidBuf, *BltBuf, *VidBuf1;
+  UINTN i;
+
+  switch (BltOperation) {
+  case EfiBltVideoFill:
+    BltBuf = (UINT8*)BltBuffer;
+
+    for (i = 0; i < Height; i++) {
+      VidBuf = POS_TO_FB (DestinationX, DestinationY + i);
+
+      SetMem32 (VidBuf, Width * PI3_BYTES_PER_PIXEL, *(UINT32*)BltBuf);
+    }
+    break;
+
+  case EfiBltVideoToBltBuffer:
+    if (Delta == 0) {
+      Delta = Width * PI3_BYTES_PER_PIXEL;
+    }
+
+    for (i = 0; i < Height; i++) {
+      VidBuf = POS_TO_FB (SourceX, SourceY + i);
+
+      BltBuf = (UINT8*)((UINTN)BltBuffer + (DestinationY + i) * Delta +
+        DestinationX * PI3_BYTES_PER_PIXEL);
+
+      gBS->CopyMem ((VOID*)BltBuf, (VOID*)VidBuf, PI3_BYTES_PER_PIXEL * Width);
+    }
+    break;
+
+  case EfiBltBufferToVideo:
+    if (Delta == 0) {
+      Delta = Width * PI3_BYTES_PER_PIXEL;
+    }
+
+    for (i = 0; i < Height; i++) {
+      VidBuf = POS_TO_FB (DestinationX, DestinationY + i);
+      BltBuf = (UINT8*)((UINTN)BltBuffer + (SourceY + i) * Delta +
+        SourceX * PI3_BYTES_PER_PIXEL);
+
+      gBS->CopyMem ((VOID*)VidBuf, (VOID*)BltBuf, Width * PI3_BYTES_PER_PIXEL);
+    }
+    break;
+
+  case EfiBltVideoToVideo:
+    for (i = 0; i < Height; i++) {
+      VidBuf = POS_TO_FB (SourceX, SourceY + i);
+      VidBuf1 = POS_TO_FB (DestinationX, DestinationY + i);
+
+      gBS->CopyMem ((VOID*)VidBuf1, (VOID*)VidBuf, Width * PI3_BYTES_PER_PIXEL);
+    }
+    break;
+
+  default:
+    ASSERT_EFI_ERROR (EFI_SUCCESS);
+    break;
+  }
+
+  return EFI_SUCCESS;
+}
+
+/**
+   Initialize the state information for the Display Dxe
+
+   @param  ImageHandle   of the loaded driver
+   @param  SystemTable   Pointer to the System Table
+
+   @retval EFI_SUCCESS           Protocol registered
+   @retval EFI_OUT_OF_RESOURCES  Cannot allocate protocol data structure
+   @retval EFI_DEVICE_ERROR      Hardware problems
+
+**/
+EFI_STATUS
+EFIAPI
+DisplayDxeInitialize (
+  IN EFI_HANDLE         ImageHandle,
+  IN EFI_SYSTEM_TABLE   *SystemTable
+  )
+{
+  EFI_STATUS Status;
+
+  Status = gBS->LocateProtocol (&gRaspberryPiFirmwareProtocolGuid, NULL,
+                  (VOID**)&mFwProtocol);
+  ASSERT_EFI_ERROR (Status);
+  if (EFI_ERROR (Status)) {
+    return Status;
+  }
+
+  Status = gBS->LocateProtocol (&gEfiCpuArchProtocolGuid, NULL,
+                  (VOID**)&mCpu);
+  ASSERT_EFI_ERROR (Status);
+  if (EFI_ERROR (Status)) {
+    return Status;
+  }
+
+  // Query the current display resolution from mailbox
+  Status = mFwProtocol->GetFBSize (&mBootWidth, &mBootHeight);
+  if (EFI_ERROR (Status)) {
+    return Status;
+  }
+
+  DEBUG ((DEBUG_INFO, "Display boot mode is %u x %u\n",
+    mBootWidth, mBootHeight));
+
+  Status = gBS->InstallMultipleProtocolInterfaces (
+    &mDevice, &gEfiDevicePathProtocolGuid,
+    &mDisplayProtoDevicePath, &gEfiCallerIdGuid,
+    NULL, NULL);
+  ASSERT_EFI_ERROR (Status);
+  if (EFI_ERROR (Status)) {
+    return Status;
+  }
+
+  Status = EfiLibInstallDriverBindingComponentName2 (
+             ImageHandle,
+             SystemTable,
+             &mDriverBinding,
+             ImageHandle,
+             &gComponentName,
+             &gComponentName2
+           );
+  ASSERT_EFI_ERROR (Status);
+  if (EFI_ERROR (Status)) {
+    return Status;
+  }
+
+  return Status;
+}
+
+STATIC
+EFI_STATUS
+EFIAPI
+DriverSupported (
+  IN EFI_DRIVER_BINDING_PROTOCOL *This,
+  IN EFI_HANDLE                  Controller,
+  IN EFI_DEVICE_PATH_PROTOCOL    *RemainingDevicePath
+  )
+{
+  VOID *Temp;
+
+  if (Controller != mDevice) {
+    return EFI_UNSUPPORTED;
+  }
+
+  if (gBS->HandleProtocol (Controller, &gEfiGraphicsOutputProtocolGuid,
+             (VOID**)&Temp) == EFI_SUCCESS) {
+    return EFI_ALREADY_STARTED;
+  }
+
+  return EFI_SUCCESS;
+}
+
+STATIC
+EFI_STATUS
+EFIAPI
+DriverStart (
+  IN EFI_DRIVER_BINDING_PROTOCOL *This,
+  IN EFI_HANDLE                  Controller,
+  IN EFI_DEVICE_PATH_PROTOCOL    *RemainingDevicePath
+  )
+{
+  UINTN Index;
+  EFI_STATUS Status;
+  VOID *Dummy;
+
+  Status = gBS->OpenProtocol (
+                  Controller,
+                  &gEfiCallerIdGuid,
+                  (VOID**)&Dummy,
+                  This->DriverBindingHandle,
+                  Controller,
+                  EFI_OPEN_PROTOCOL_BY_DRIVER
+                );
+  if (EFI_ERROR (Status)) {
+    return Status;
+  }
+
+  gDisplayProto.Mode = AllocateZeroPool (sizeof (EFI_GRAPHICS_OUTPUT_PROTOCOL_MODE));
+  if (gDisplayProto.Mode == NULL) {
+    Status = EFI_OUT_OF_RESOURCES;
+    goto Done;
+  }
+
+  gDisplayProto.Mode->Info = AllocateZeroPool (sizeof (EFI_GRAPHICS_OUTPUT_MODE_INFORMATION));
+  if (gDisplayProto.Mode->Info == NULL) {
+    Status = EFI_OUT_OF_RESOURCES;
+    goto Done;
+  }
+
+
+  if (PcdGet32 (PcdDisplayEnableVModes)) {
+    mLastMode = ARRAY_SIZE (mGopModeData) - 1;
+  } else {
+    mLastMode = 0;
+    /*
+     * mBootWidth x mBootHeight may not be sensible,
+     * so clean it up, since we won't be adding
+     * any other extra vmodes.
+     */
+    if (mBootWidth < 640 || mBootHeight < 480) {
+      mBootWidth = 640;
+      mBootHeight = 480;
+    }
+  }
+
+  mGopModeData[mLastMode].Width = mBootWidth;
+  mGopModeData[mLastMode].Height = mBootHeight;
+
+  for (Index = 0; Index <= mLastMode; Index++) {
+    UINTN FbSize;
+    UINTN FbPitch;
+    EFI_PHYSICAL_ADDRESS FbBase;
+
+    GOP_MODE_DATA *Mode = &mGopModeData[Index];
+
+    Status = mFwProtocol->GetFB (Mode->Width, Mode->Height,
+                            PI3_BITS_PER_PIXEL, &FbBase,
+                            &FbSize, &FbPitch);
+    if (EFI_ERROR (Status)) {
+      goto Done;
+    }
+
+    //
+    // There is no way to communicate pitch back to OS. OS and even UEFI
+    // expect a fully linear frame buffer. So the width should
+    // be based on the frame buffer's pitch value. In some cases VC
+    // firmware would allocate ao frame buffer with some padding
+    // presumably to be 8 byte align.
+    //
+    Mode->Width = FbPitch / PI3_BYTES_PER_PIXEL;
+
+    DEBUG ((DEBUG_INFO, "Mode %u: %u x %u framebuffer is %u bytes at %p\n",
+      Index, Mode->Width, Mode->Height, FbSize, FbBase));
+
+    ASSERT (FbPitch != 0);
+    ASSERT (FbBase != 0);
+    ASSERT (FbSize != 0);
+  }
+
+  // Both set the mode and initialize current mode information.
+  gDisplayProto.Mode->MaxMode = mLastMode + 1;
+  DisplaySetMode (&gDisplayProto, 0);
+
+  Status = gBS->InstallMultipleProtocolInterfaces (
+    &Controller, &gEfiGraphicsOutputProtocolGuid,
+    &gDisplayProto, NULL);
+  if (EFI_ERROR (Status)) {
+    goto Done;
+  }
+
+  if (PcdGet32 (PcdDisplayEnableSShot)) {
+    RegisterScreenshotHandlers ();
+  } else {
+    DEBUG ((DEBUG_INFO, "Screenshot capture disabled\n"));
+  }
+
+Done:
+  if (EFI_ERROR (Status)) {
+    DEBUG ((DEBUG_ERROR, "Could not start DisplayDxe: %r\n", Status));
+    if (gDisplayProto.Mode->Info != NULL) {
+      FreePool (gDisplayProto.Mode->Info);
+      gDisplayProto.Mode->Info = NULL;
+    }
+
+    if (gDisplayProto.Mode != NULL) {
+      FreePool (gDisplayProto.Mode);
+      gDisplayProto.Mode = NULL;
+    }
+
+    gBS->CloseProtocol (
+           Controller,
+           &gEfiCallerIdGuid,
+           This->DriverBindingHandle,
+           Controller
+         );
+  }
+  return Status;
+}
+
+STATIC
+EFI_STATUS
+EFIAPI
+DriverStop (
+  IN EFI_DRIVER_BINDING_PROTOCOL *This,
+  IN EFI_HANDLE                  Controller,
+  IN UINTN                       NumberOfChildren,
+  IN EFI_HANDLE                  *ChildHandleBuffer
+  )
+{
+  EFI_STATUS Status;
+
+  ClearScreen (&gDisplayProto);
+
+  Status = gBS->UninstallMultipleProtocolInterfaces (
+    Controller, &gEfiGraphicsOutputProtocolGuid,
+    &gDisplayProto, NULL);
+  if (EFI_ERROR (Status)) {
+    return Status;
+  }
+
+  FreePool (gDisplayProto.Mode->Info);
+  gDisplayProto.Mode->Info = NULL;
+  FreePool (gDisplayProto.Mode);
+  gDisplayProto.Mode = NULL;
+
+  gBS->CloseProtocol (
+         Controller,
+         &gEfiCallerIdGuid,
+         This->DriverBindingHandle,
+         Controller
+       );
+
+  return Status;
+}
diff --git a/Platform/RaspberryPi/RPi3/Drivers/DisplayDxe/DisplayDxe.h b/Platform/RaspberryPi/RPi3/Drivers/DisplayDxe/DisplayDxe.h
new file mode 100644
index 000000000000..48a049de31d8
--- /dev/null
+++ b/Platform/RaspberryPi/RPi3/Drivers/DisplayDxe/DisplayDxe.h
@@ -0,0 +1,42 @@
+/** @file
+ *
+ *  Copyright (c) 2017-2018, Andrei Warkentin <andrey.warkentin@gmail.com>
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *
+ *  This program and the accompanying materials
+ *  are licensed and made available under the terms and conditions of the BSD License
+ *  which accompanies this distribution.  The full text of the license may be found at
+ *  http://opensource.org/licenses/bsd-license.php
+ *
+ *  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+ *  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+ *
+ **/
+
+#ifndef _DISPLAY_H_
+#define _DISPLAY_H_
+
+#include <Library/BaseLib.h>
+#include <Library/DebugLib.h>
+#include <Library/BaseMemoryLib.h>
+#include <Library/UefiBootServicesTableLib.h>
+#include <Library/UefiLib.h>
+#include <Library/PcdLib.h>
+#include <Library/IoLib.h>
+#include <Library/TimerLib.h>
+#include <Library/MemoryAllocationLib.h>
+#include <Protocol/Cpu.h>
+#include <Protocol/GraphicsOutput.h>
+#include <Protocol/DevicePath.h>
+#include <Protocol/RpiFirmware.h>
+
+extern EFI_GRAPHICS_OUTPUT_PROTOCOL gDisplayProto;
+extern EFI_COMPONENT_NAME_PROTOCOL  gComponentName;
+extern EFI_COMPONENT_NAME2_PROTOCOL gComponentName2;
+
+VOID
+RegisterScreenshotHandlers (
+  VOID
+  );
+
+#endif /* _DISPLAY_H_ */
diff --git a/Platform/RaspberryPi/RPi3/Drivers/DisplayDxe/DisplayDxe.inf b/Platform/RaspberryPi/RPi3/Drivers/DisplayDxe/DisplayDxe.inf
new file mode 100644
index 000000000000..2e716ff779b5
--- /dev/null
+++ b/Platform/RaspberryPi/RPi3/Drivers/DisplayDxe/DisplayDxe.inf
@@ -0,0 +1,71 @@
+#/** @file
+#
+#  Component description file for Graphics Output module
+#
+#  Copyright (c) 2017, Andrei Warkentin <andrey.warkentin@gmail.com>
+#  Copyright (c) Microsoft Corporation. All rights reserved.
+#
+#  This program and the accompanying materials
+#  are licensed and made available under the terms and conditions of the BSD License
+#  which accompanies this distribution.  The full text of the license may be found at
+#  http://opensource.org/licenses/bsd-license.php
+#
+#  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+#  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+#
+#**/
+
+[Defines]
+  INF_VERSION                    = 0x0001001A
+  BASE_NAME                      = DisplayDxe
+  FILE_GUID                      = c5deae31-fad2-4030-841b-cfc9644d2c5b
+  MODULE_TYPE                    = UEFI_DRIVER
+  VERSION_STRING                 = 1.0
+  ENTRY_POINT                    = DisplayDxeInitialize
+
+#
+# The following information is for reference only and not required by the build tools.
+#
+#  DRIVER_BINDING                =  gGraphicsConsoleDriverBinding
+#  COMPONENT_NAME                =  gGraphicsConsoleComponentName
+#  COMPONENT_NAME2               =  gGraphicsConsoleComponentName2
+#
+
+[Sources]
+  DisplayDxe.c
+  Screenshot.c
+  ComponentName.c
+
+[Packages]
+  MdePkg/MdePkg.dec
+  MdeModulePkg/MdeModulePkg.dec
+  ArmPkg/ArmPkg.dec
+  Platform/RaspberryPi/RPi3/RPi3.dec
+
+[LibraryClasses]
+  BaseLib
+  UefiLib
+  MemoryAllocationLib
+  UefiDriverEntryPoint
+  IoLib
+  TimerLib
+  BmpSupportLib
+  UefiRuntimeServicesTableLib
+
+[Protocols]
+  gEfiLoadedImageProtocolGuid
+  gEfiDevicePathProtocolGuid
+  gEfiGraphicsOutputProtocolGuid
+  gEfiCpuArchProtocolGuid
+  gEfiSimpleFileSystemProtocolGuid
+  gEfiSimpleTextInputExProtocolGuid
+  gRaspberryPiFirmwareProtocolGuid
+
+[Pcd]
+  gRaspberryPiTokenSpaceGuid.PcdDisplayEnableVModes
+  gRaspberryPiTokenSpaceGuid.PcdDisplayEnableSShot
+
+[Guids]
+
+[Depex]
+  gEfiCpuArchProtocolGuid AND gRaspberryPiFirmwareProtocolGuid
diff --git a/Platform/RaspberryPi/RPi3/Drivers/DisplayDxe/Screenshot.c b/Platform/RaspberryPi/RPi3/Drivers/DisplayDxe/Screenshot.c
new file mode 100644
index 000000000000..a5d32d59c38a
--- /dev/null
+++ b/Platform/RaspberryPi/RPi3/Drivers/DisplayDxe/Screenshot.c
@@ -0,0 +1,375 @@
+/** @file
+ *
+ *  Copyright (c) 2006 - 2016, Intel Corporation. All rights reserved.
+ *  Copyright (c) 2018, Andrei Warkentin <andrey.warkentin@gmail.com>
+ *
+ *  This program and the accompanying materials
+ *  are licensed and made available under the terms and conditions of the BSD License
+ *  which accompanies this distribution.  The full text of the license may be found at
+ *  http://opensource.org/licenses/bsd-license.php
+ *
+ *  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+ *  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+ *
+ **/
+
+/*
+ * Loosely based on CrScreenShotDxe (https://github.com/LongSoft/CrScreenshotDxe).
+ *
+ * Copyright (c) 2016, Nikolaj Schlej, All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions are met:
+ * - Redistributions of source code must retain the above copyright notice,
+ *   this list of conditions and the following disclaimer.
+ * - Redistributions in binary form must reproduce the above copyright notice,
+ *   this list of conditions and the following disclaimer in the documentation
+ * and/or other materials provided with the distribution.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+ * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
+ * THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+ * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR
+ * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
+ * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
+ * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
+ * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
+ * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+ * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
+ * EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ */
+
+#include "DisplayDxe.h"
+#include <Protocol/SimpleFileSystem.h>
+#include <Library/PrintLib.h>
+#include <Library/BmpSupportLib.h>
+#include <Library/UefiRuntimeServicesTableLib.h>
+
+/*
+ * ShowStatus defs.
+ */
+#define STATUS_SQUARE_SIDE 5
+#define STATUS_YELLOW 0xff, 0xff, 0x00
+#define STATUS_GREEN  0x00, 0xff, 0x00
+#define STATUS_BLUE   0x00, 0x00, 0xff
+#define STATUS_RED    0xff, 0x00, 0x00
+
+EFI_STATUS
+ShowStatus (
+  IN EFI_GRAPHICS_OUTPUT_PROTOCOL *GraphicsOutput,
+  IN UINT8 Red,
+  IN UINT8 Green,
+  IN UINT8 Blue
+  )
+{
+  UINTN Index;
+  EFI_GRAPHICS_OUTPUT_BLT_PIXEL Square[STATUS_SQUARE_SIDE * STATUS_SQUARE_SIDE];
+  EFI_GRAPHICS_OUTPUT_BLT_PIXEL Backup[STATUS_SQUARE_SIDE * STATUS_SQUARE_SIDE];
+
+  for (Index = 0; Index < STATUS_SQUARE_SIDE * STATUS_SQUARE_SIDE; Index++) {
+    Square[Index].Blue = Blue;
+    Square[Index].Green = Green;
+    Square[Index].Red = Red;
+    Square[Index].Reserved = 0x00;
+  }
+
+  // Backup current image.
+  GraphicsOutput->Blt (GraphicsOutput, Backup,
+                    EfiBltVideoToBltBuffer, 0, 0, 0, 0,
+                    STATUS_SQUARE_SIDE, STATUS_SQUARE_SIDE, 0);
+
+  // Draw the status square.
+  GraphicsOutput->Blt (GraphicsOutput, Square,
+                    EfiBltBufferToVideo, 0, 0, 0, 0,
+                    STATUS_SQUARE_SIDE, STATUS_SQUARE_SIDE, 0);
+
+  // Wait 500ms.
+  gBS->Stall (500 * 1000);
+
+  // Restore the backup.
+  GraphicsOutput->Blt (GraphicsOutput, Backup,
+                    EfiBltBufferToVideo, 0, 0, 0, 0,
+                    STATUS_SQUARE_SIDE, STATUS_SQUARE_SIDE, 0);
+  return EFI_SUCCESS;
+}
+
+STATIC
+EFI_STATUS
+FindWritableFs (
+  OUT EFI_FILE_PROTOCOL **WritableFs
+  )
+{
+  EFI_FILE_PROTOCOL *Fs = NULL;
+  EFI_HANDLE *HandleBuffer = NULL;
+  UINTN      HandleCount;
+  UINTN      Index;
+
+  EFI_STATUS Status = gBS->LocateHandleBuffer (ByProtocol,
+                             &gEfiSimpleFileSystemProtocolGuid,
+                             NULL, &HandleCount, &HandleBuffer);
+  if (EFI_ERROR (Status)) {
+    return Status;
+  }
+
+  for (Index = 0; Index < HandleCount; Index++) {
+    EFI_SIMPLE_FILE_SYSTEM_PROTOCOL *SimpleFs = NULL;
+    EFI_FILE_PROTOCOL *File = NULL;
+
+    Status = gBS->HandleProtocol (HandleBuffer[Index],
+                    &gEfiSimpleFileSystemProtocolGuid,
+                    (VOID**)&SimpleFs);
+    if (EFI_ERROR (Status)) {
+      ASSERT_EFI_ERROR (Status);
+      /*
+       * Not supposed to happen.
+       */
+      continue;
+    }
+
+    Status = SimpleFs->OpenVolume (SimpleFs, &Fs);
+    if (EFI_ERROR (Status)) {
+      DEBUG ((DEBUG_ERROR, "%a OpenVolume[%u] returned %r\n", __FUNCTION__, Index, Status));
+      continue;
+    }
+
+    Status = Fs->Open (Fs, &File, L"--------.---",
+                   EFI_FILE_MODE_CREATE | EFI_FILE_MODE_READ |
+                   EFI_FILE_MODE_WRITE, 0);
+    if (EFI_ERROR (Status)) {
+      DEBUG ((DEBUG_ERROR, "%a Open[%u] returned %r\n", __FUNCTION__, Index, Status));
+      continue;
+    }
+
+    /*
+     * Okay, we have a writable filesystem!
+     */
+    Fs->Delete (File);
+    *WritableFs = Fs;
+    Status = EFI_SUCCESS;
+    break;
+  }
+
+  if (HandleBuffer) {
+    FreePool (HandleBuffer);
+  }
+
+  return Status;
+}
+
+STATIC
+VOID
+TakeScreenshot (
+  VOID
+  )
+{
+  VOID *BmpImage = NULL;
+  EFI_FILE_PROTOCOL *Fs = NULL;
+  EFI_FILE_PROTOCOL *File = NULL;
+  EFI_GRAPHICS_OUTPUT_PROTOCOL *GraphicsOutput = &gDisplayProto;
+  EFI_GRAPHICS_OUTPUT_BLT_PIXEL *Image = NULL;
+  EFI_STATUS Status;
+  CHAR16 FileName[8 + 1 + 3 + 1];
+  UINT32 ScreenWidth;
+  UINT32 ScreenHeight;
+  UINTN ImageSize;
+  UINTN BmpSize;
+  UINTN Index;
+  EFI_TIME Time;
+
+  Status = FindWritableFs (&Fs);
+  if (EFI_ERROR (Status)) {
+    ShowStatus (GraphicsOutput, STATUS_YELLOW);
+  }
+
+  ScreenWidth = GraphicsOutput->Mode->Info->HorizontalResolution;
+  ScreenHeight = GraphicsOutput->Mode->Info->VerticalResolution;
+  ImageSize = ScreenWidth * ScreenHeight;
+
+  Status = gRT->GetTime (&Time, NULL);
+  if (!EFI_ERROR (Status)) {
+    UnicodeSPrint (FileName, sizeof (FileName), L"%02d%02d%02d%02d.bmp",
+      Time.Day, Time.Hour, Time.Minute, Time.Second);
+  } else {
+    UnicodeSPrint (FileName, sizeof (FileName), L"scrnshot.bmp");
+  }
+
+  Image = AllocatePool (ImageSize * sizeof (EFI_GRAPHICS_OUTPUT_BLT_PIXEL));
+  if (Image == NULL) {
+    Status = EFI_OUT_OF_RESOURCES;
+    ShowStatus (GraphicsOutput, STATUS_RED);
+    goto Done;
+  }
+
+  Status = GraphicsOutput->Blt (GraphicsOutput, Image,
+                             EfiBltVideoToBltBuffer, 0, 0, 0, 0,
+                             ScreenWidth, ScreenHeight, 0);
+  if (EFI_ERROR (Status)) {
+    ShowStatus (GraphicsOutput, STATUS_RED);
+    goto Done;
+  }
+
+  for (Index = 0; Index < ImageSize; Index++) {
+    if (Image[Index].Red != 0x00 ||
+        Image[Index].Green != 0x00 ||
+        Image[Index].Blue != 0x00) {
+      break;
+    }
+  }
+
+  if (Index == ImageSize) {
+    ShowStatus (GraphicsOutput, STATUS_BLUE);
+    goto Done;
+  }
+
+  Status = TranslateGopBltToBmp (Image, ScreenHeight, ScreenWidth,
+             &BmpImage, (UINT32*)&BmpSize);
+  if (EFI_ERROR (Status)) {
+    ShowStatus (GraphicsOutput, STATUS_RED);
+    goto Done;
+  }
+
+  Status = Fs->Open (Fs, &File, FileName, EFI_FILE_MODE_CREATE |
+                 EFI_FILE_MODE_READ | EFI_FILE_MODE_WRITE, 0);
+  if (EFI_ERROR (Status)) {
+    ShowStatus (GraphicsOutput, STATUS_RED);
+    goto Done;
+  }
+
+  Status = File->Write (File, &BmpSize, BmpImage);
+  File->Close (File);
+  if (EFI_ERROR (Status)) {
+    ShowStatus (GraphicsOutput, STATUS_RED);
+    goto Done;
+  }
+
+  ShowStatus (GraphicsOutput, STATUS_GREEN);
+
+Done:
+  if (BmpImage != NULL) {
+    FreePool (BmpImage);
+  }
+
+  if (Image != NULL) {
+    FreePool (Image);
+  }
+}
+
+STATIC
+EFI_STATUS
+EFIAPI
+ScreenshotKeyHandler (
+  IN EFI_KEY_DATA *KeyData
+  )
+{
+  TakeScreenshot ();
+  return EFI_SUCCESS;
+}
+
+STATIC
+EFI_STATUS
+ProcessScreenshotHandler (
+  IN EFI_SIMPLE_TEXT_INPUT_EX_PROTOCOL *SimpleTextInEx
+  )
+{
+  EFI_STATUS Status;
+  EFI_HANDLE Handle;
+  EFI_KEY_DATA ScreenshotKey;
+
+  /*
+   * LCtrl+LAlt+F12
+   */
+  ScreenshotKey.Key.ScanCode = SCAN_F12;
+  ScreenshotKey.Key.UnicodeChar = 0;
+  ScreenshotKey.KeyState.KeyShiftState = EFI_SHIFT_STATE_VALID |
+    EFI_LEFT_CONTROL_PRESSED | EFI_LEFT_ALT_PRESSED;
+  ScreenshotKey.KeyState.KeyToggleState = 0;
+
+  Status = SimpleTextInEx->RegisterKeyNotify (
+                             SimpleTextInEx,
+                             &ScreenshotKey,
+                             ScreenshotKeyHandler,
+                             &Handle
+                           );
+  if (EFI_ERROR (Status)) {
+    DEBUG ((DEBUG_ERROR, "%a: couldn't register key notification: %r\n", __FUNCTION__, Status));
+    return Status;
+  }
+
+  return EFI_SUCCESS;
+}
+
+STATIC
+VOID
+ProcessScreenshotHandlers (
+  VOID
+  )
+{
+  UINTN Index;
+  EFI_STATUS Status;
+  UINTN HandleCount;
+  EFI_HANDLE *HandleBuffer;
+  EFI_SIMPLE_TEXT_INPUT_EX_PROTOCOL *SimpleTextInEx;
+
+  Status = gBS->LocateHandleBuffer (ByProtocol, &gEfiSimpleTextInputExProtocolGuid,
+                  NULL, &HandleCount, &HandleBuffer);
+  if (EFI_ERROR (Status)) {
+    return;
+  }
+
+  for (Index = 0; Index < HandleCount; Index++) {
+    Status = gBS->HandleProtocol (HandleBuffer[Index],
+                    &gEfiSimpleTextInputExProtocolGuid,
+                    (VOID**)&SimpleTextInEx);
+    if (EFI_ERROR (Status)) {
+      ASSERT_EFI_ERROR (Status);
+      /*
+       * Not supposed to happen.
+       */
+      continue;
+    }
+
+    Status = ProcessScreenshotHandler (SimpleTextInEx);
+    if (EFI_ERROR (Status)) {
+      continue;
+    }
+  }
+}
+
+STATIC
+VOID
+EFIAPI
+OnTextInExInstall (
+  IN EFI_EVENT Event,
+  IN VOID *Context
+  )
+{
+  ProcessScreenshotHandlers ();
+}
+
+VOID
+RegisterScreenshotHandlers (
+  VOID
+)
+{
+  EFI_STATUS Status;
+  EFI_EVENT TextInExInstallEvent;
+  VOID *TextInExInstallRegistration;
+
+  ProcessScreenshotHandlers ();
+
+  Status = gBS->CreateEvent (EVT_NOTIFY_SIGNAL, TPL_CALLBACK,
+                  OnTextInExInstall, NULL,
+                  &TextInExInstallEvent);
+  if (EFI_ERROR (Status)) {
+    DEBUG ((DEBUG_ERROR, "%a: couldn't create protocol install event: %r\n", __FUNCTION__, Status));
+    return;
+  }
+
+  Status = gBS->RegisterProtocolNotify (&gEfiSimpleTextInputExProtocolGuid,
+                  TextInExInstallEvent,
+                  &TextInExInstallRegistration);
+  if (EFI_ERROR (Status)) {
+    DEBUG ((DEBUG_ERROR, "%a: couldn't register protocol install notify: %r\n", __FUNCTION__, Status));
+    return;
+  }
+}
-- 
2.17.0.windows.1



^ permalink raw reply related	[flat|nested] 34+ messages in thread

* [PATCH v5 edk2-platforms 10/22] Platform/RaspberryPi/RPi3: Add console driver
  2019-02-05 16:25 [PATCH v5 edk2-platforms 00/22] Platform/RaspberryPi: Add Raspberry Pi 3 support Pete Batard
                   ` (8 preceding siblings ...)
  2019-02-05 16:25 ` [PATCH v5 edk2-platforms 09/22] Platform/RaspberryPi/RPi3: Add display driver Pete Batard
@ 2019-02-05 16:25 ` Pete Batard
  2019-02-05 16:25 ` [PATCH v5 edk2-platforms 11/22] Platform/RaspberryPi/RPi3: Add NV storage driver Pete Batard
                   ` (13 subsequent siblings)
  23 siblings, 0 replies; 34+ messages in thread
From: Pete Batard @ 2019-02-05 16:25 UTC (permalink / raw)
  To: edk2-devel

Implements the graphic console (extended text output) needed
for user interaction.

Contributed-under: TianoCore Contribution Agreement 1.1
Signed-off-by: Pete Batard <pete@akeo.ie>
---
 Platform/RaspberryPi/RPi3/Drivers/GraphicsConsoleDxe/ComponentName.c             |  183 ++
 Platform/RaspberryPi/RPi3/Drivers/GraphicsConsoleDxe/GraphicsConsole.c           | 1837 ++++++++++++++++++++
 Platform/RaspberryPi/RPi3/Drivers/GraphicsConsoleDxe/GraphicsConsole.h           |  591 +++++++
 Platform/RaspberryPi/RPi3/Drivers/GraphicsConsoleDxe/GraphicsConsoleDxe.inf      |   75 +
 Platform/RaspberryPi/RPi3/Drivers/GraphicsConsoleDxe/GraphicsConsoleDxe.uni      |   18 +
 Platform/RaspberryPi/RPi3/Drivers/GraphicsConsoleDxe/GraphicsConsoleDxeExtra.uni |   18 +
 Platform/RaspberryPi/RPi3/Drivers/GraphicsConsoleDxe/NewFont.c                   |  287 +++
 Platform/RaspberryPi/RPi3/Include/Protocol/ExtendedTextOut.h                     |   36 +
 8 files changed, 3045 insertions(+)

diff --git a/Platform/RaspberryPi/RPi3/Drivers/GraphicsConsoleDxe/ComponentName.c b/Platform/RaspberryPi/RPi3/Drivers/GraphicsConsoleDxe/ComponentName.c
new file mode 100644
index 000000000000..3ae639ad3d97
--- /dev/null
+++ b/Platform/RaspberryPi/RPi3/Drivers/GraphicsConsoleDxe/ComponentName.c
@@ -0,0 +1,183 @@
+/** @file
+ *
+ *  Copyright (c) 2018, Andrei Warkentin <andrey.warkentin@gmail.com>
+ *  Copyright (c) 2006-2016, Intel Corporation. All rights reserved.
+ *
+ *  This program and the accompanying materials
+ *  are licensed and made available under the terms and conditions of the BSD License
+ *  which accompanies this distribution.  The full text of the license may be found at
+ *  http://opensource.org/licenses/bsd-license.php
+ *
+ *  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+ *  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+ *
+ **/
+
+#include "GraphicsConsole.h"
+
+//
+// EFI Component Name Protocol
+//
+GLOBAL_REMOVE_IF_UNREFERENCED EFI_COMPONENT_NAME_PROTOCOL  gGraphicsConsoleComponentName = {
+  GraphicsConsoleComponentNameGetDriverName,
+  GraphicsConsoleComponentNameGetControllerName,
+  "eng"
+};
+
+//
+// EFI Component Name 2 Protocol
+//
+GLOBAL_REMOVE_IF_UNREFERENCED EFI_COMPONENT_NAME2_PROTOCOL gGraphicsConsoleComponentName2 = {
+  (EFI_COMPONENT_NAME2_GET_DRIVER_NAME)GraphicsConsoleComponentNameGetDriverName,
+  (EFI_COMPONENT_NAME2_GET_CONTROLLER_NAME)GraphicsConsoleComponentNameGetControllerName,
+  "en"
+};
+
+
+GLOBAL_REMOVE_IF_UNREFERENCED EFI_UNICODE_STRING_TABLE mGraphicsConsoleDriverNameTable[] = {
+  {
+    "eng;en",
+    (CHAR16*)L"Graphics Console Driver"
+  },
+  {
+    NULL,
+    NULL
+  }
+};
+
+/**
+  Retrieves a Unicode string that is the user readable name of the driver.
+
+  This function retrieves the user readable name of a driver in the form of a
+  Unicode string. If the driver specified by This has a user readable name in
+  the language specified by Language, then a pointer to the driver name is
+  returned in DriverName, and EFI_SUCCESS is returned. If the driver specified
+  by This does not support the language specified by Language,
+  then EFI_UNSUPPORTED is returned.
+
+  @param  This[in]              A pointer to the EFI_COMPONENT_NAME2_PROTOCOL or
+                                EFI_COMPONENT_NAME_PROTOCOL instance.
+
+  @param  Language[in]          A pointer to a Null-terminated ASCII string
+                                array indicating the language. This is the
+                                language of the driver name that the caller is
+                                requesting, and it must match one of the
+                                languages specified in SupportedLanguages. The
+                                number of languages supported by a driver is up
+                                to the driver writer. Language is specified
+                                in RFC 4646 or ISO 639-2 language code format.
+
+  @param  DriverName[out]       A pointer to the Unicode string to return.
+                                This Unicode string is the name of the
+                                driver specified by This in the language
+                                specified by Language.
+
+  @retval EFI_SUCCESS           The Unicode string for the Driver specified by
+                                This and the language specified by Language was
+                                returned in DriverName.
+
+  @retval EFI_INVALID_PARAMETER Language is NULL.
+
+  @retval EFI_INVALID_PARAMETER DriverName is NULL.
+
+  @retval EFI_UNSUPPORTED       The driver specified by This does not support
+                                the language specified by Language.
+
+**/
+EFI_STATUS
+EFIAPI
+GraphicsConsoleComponentNameGetDriverName (
+  IN  EFI_COMPONENT_NAME_PROTOCOL  *This,
+  IN  CHAR8                        *Language,
+  OUT CHAR16                       **DriverName
+  )
+{
+  return LookupUnicodeString2 (
+           Language,
+           This->SupportedLanguages,
+           mGraphicsConsoleDriverNameTable,
+           DriverName,
+           (BOOLEAN)(This == &gGraphicsConsoleComponentName)
+         );
+}
+
+/**
+  Retrieves a Unicode string that is the user readable name of the controller
+  that is being managed by a driver.
+
+  This function retrieves the user readable name of the controller specified by
+  ControllerHandle and ChildHandle in the form of a Unicode string. If the
+  driver specified by This has a user readable name in the language specified by
+  Language, then a pointer to the controller name is returned in ControllerName,
+  and EFI_SUCCESS is returned.  If the driver specified by This is not currently
+  managing the controller specified by ControllerHandle and ChildHandle,
+  then EFI_UNSUPPORTED is returned.  If the driver specified by This does not
+  support the language specified by Language, then EFI_UNSUPPORTED is returned.
+
+  @param  This[in]              A pointer to the EFI_COMPONENT_NAME2_PROTOCOL or
+                                EFI_COMPONENT_NAME_PROTOCOL instance.
+
+  @param  ControllerHandle[in]  The handle of a controller that the driver
+                                specified by This is managing.  This handle
+                                specifies the controller whose name is to be
+                                returned.
+
+  @param  ChildHandle[in]       The handle of the child controller to retrieve
+                                the name of.  This is an optional parameter that
+                                may be NULL.  It will be NULL for device
+                                drivers.  It will also be NULL for a bus drivers
+                                that wish to retrieve the name of the bus
+                                controller.  It will not be NULL for a bus
+                                driver that wishes to retrieve the name of a
+                                child controller.
+
+  @param  Language[in]          A pointer to a Null-terminated ASCII string
+                                array indicating the language.  This is the
+                                language of the driver name that the caller is
+                                requesting, and it must match one of the
+                                languages specified in SupportedLanguages. The
+                                number of languages supported by a driver is up
+                                to the driver writer. Language is specified in
+                                RFC 4646 or ISO 639-2 language code format.
+
+  @param  ControllerName[out]   A pointer to the Unicode string to return.
+                                This Unicode string is the name of the
+                                controller specified by ControllerHandle and
+                                ChildHandle in the language specified by
+                                Language from the point of view of the driver
+                                specified by This.
+
+  @retval EFI_SUCCESS           The Unicode string for the user readable name in
+                                the language specified by Language for the
+                                driver specified by This was returned in
+                                DriverName.
+
+  @retval EFI_INVALID_PARAMETER ControllerHandle is NULL.
+
+  @retval EFI_INVALID_PARAMETER ChildHandle is not NULL and it is not a valid
+                                EFI_HANDLE.
+
+  @retval EFI_INVALID_PARAMETER Language is NULL.
+
+  @retval EFI_INVALID_PARAMETER ControllerName is NULL.
+
+  @retval EFI_UNSUPPORTED       The driver specified by This is not currently
+                                managing the controller specified by
+                                ControllerHandle and ChildHandle.
+
+  @retval EFI_UNSUPPORTED       The driver specified by This does not support
+                                the language specified by Language.
+
+**/
+EFI_STATUS
+EFIAPI
+GraphicsConsoleComponentNameGetControllerName (
+  IN  EFI_COMPONENT_NAME_PROTOCOL  *This,
+  IN  EFI_HANDLE                   ControllerHandle,
+  IN  EFI_HANDLE                   ChildHandle        OPTIONAL,
+  IN  CHAR8                        *Language,
+  OUT CHAR16                       **ControllerName
+  )
+{
+  return EFI_UNSUPPORTED;
+}
diff --git a/Platform/RaspberryPi/RPi3/Drivers/GraphicsConsoleDxe/GraphicsConsole.c b/Platform/RaspberryPi/RPi3/Drivers/GraphicsConsoleDxe/GraphicsConsole.c
new file mode 100644
index 000000000000..246f4ad52b98
--- /dev/null
+++ b/Platform/RaspberryPi/RPi3/Drivers/GraphicsConsoleDxe/GraphicsConsole.c
@@ -0,0 +1,1837 @@
+/** @file
+ *
+ *  Copyright (c) 2018, Andrei Warkentin <andrey.warkentin@gmail.com>
+ *  Copyright (c) 2006-2016, Intel Corporation. All rights reserved.
+ *
+ *  This program and the accompanying materials
+ *  are licensed and made available under the terms and conditions of the BSD License
+ *  which accompanies this distribution.  The full text of the license may be found at
+ *  http://opensource.org/licenses/bsd-license.php
+ *
+ *  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+ *  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+ *
+ **/
+
+#include "GraphicsConsole.h"
+
+//
+// Graphics Console Device Private Data template
+//
+GRAPHICS_CONSOLE_DEV mGraphicsConsoleDevTemplate = {
+  GRAPHICS_CONSOLE_DEV_SIGNATURE,
+  (EFI_GRAPHICS_OUTPUT_PROTOCOL*)NULL,
+  {
+    GraphicsConsoleConOutReset,
+    GraphicsConsoleConOutOutputString,
+    GraphicsConsoleConOutTestString,
+    GraphicsConsoleConOutQueryMode,
+    GraphicsConsoleConOutSetMode,
+    GraphicsConsoleConOutSetAttribute,
+    GraphicsConsoleConOutClearScreen,
+    GraphicsConsoleConOutSetCursorPosition,
+    GraphicsConsoleConOutEnableCursor,
+    (EFI_SIMPLE_TEXT_OUTPUT_MODE*)NULL
+  },
+  {
+    0,
+    -1,
+    EFI_TEXT_ATTR (EFI_LIGHTGRAY, EFI_BLACK),
+    0,
+    0,
+    TRUE
+  },
+  (GRAPHICS_CONSOLE_MODE_DATA*)NULL,
+  (EFI_GRAPHICS_OUTPUT_BLT_PIXEL*)NULL,
+  {
+    (EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL*)NULL,
+    (EFI_GRAPHICS_OUTPUT_PROTOCOL*)NULL,
+    TRUE,
+  }
+};
+
+GRAPHICS_CONSOLE_MODE_DATA mGraphicsConsoleModeData[] = {
+  {100, 31},
+  //
+  // New modes can be added here.
+  // The last entry is specific for full screen mode.
+  //
+  {0, 0}
+};
+
+EFI_HII_DATABASE_PROTOCOL   *mHiiDatabase;
+EFI_HII_FONT_PROTOCOL       *mHiiFont;
+EFI_HII_HANDLE              mHiiHandle;
+VOID                        *mHiiRegistration;
+
+EFI_GUID             mFontPackageListGuid = { 0xf5f219d3, 0x7006, 0x4648, {0xac, 0x8d, 0xd6, 0x1d, 0xfb, 0x7b, 0xc6, 0xad} };
+
+CHAR16               mCrLfString[3] = { CHAR_CARRIAGE_RETURN, CHAR_LINEFEED, CHAR_NULL };
+
+EFI_GRAPHICS_OUTPUT_BLT_PIXEL mGraphicsEfiColors[16] = {
+  //
+  // B    G    R   reserved
+  //
+  {0x00, 0x00, 0x00, 0x00},  // BLACK
+  {0x98, 0x00, 0x00, 0x00},  // LIGHTBLUE
+  {0x00, 0x98, 0x00, 0x00},  // LIGHGREEN
+  {0x98, 0x98, 0x00, 0x00},  // LIGHCYAN
+  {0x00, 0x00, 0x98, 0x00},  // LIGHRED
+  {0x98, 0x00, 0x98, 0x00},  // MAGENTA
+  {0x00, 0x98, 0x98, 0x00},  // BROWN
+  {0x98, 0x98, 0x98, 0x00},  // LIGHTGRAY
+  {0x30, 0x30, 0x30, 0x00},  // DARKGRAY - BRIGHT BLACK
+  {0xff, 0x00, 0x00, 0x00},  // BLUE
+  {0x00, 0xff, 0x00, 0x00},  // LIME
+  {0xff, 0xff, 0x00, 0x00},  // CYAN
+  {0x00, 0x00, 0xff, 0x00},  // RED
+  {0xff, 0x00, 0xff, 0x00},  // FUCHSIA
+  {0x00, 0xff, 0xff, 0x00},  // YELLOW
+  {0xff, 0xff, 0xff, 0x00}   // WHITE
+};
+
+EFI_NARROW_GLYPH mCursorGlyph = {
+  0x0000,
+  0x00,
+  { 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0xFF, 0xFF, 0xFF }
+};
+
+CHAR16 SpaceStr[] = { NARROW_CHAR, ' ', 0 };
+
+EFI_DRIVER_BINDING_PROTOCOL gGraphicsConsoleDriverBinding = {
+  GraphicsConsoleControllerDriverSupported,
+  GraphicsConsoleControllerDriverStart,
+  GraphicsConsoleControllerDriverStop,
+  0xa,
+  NULL,
+  NULL
+};
+
+/**
+  Test to see if Graphics Console could be supported on the Controller.
+
+  Graphics Console could be supported if Graphics Output Protocol
+  exists on the Controller.
+
+  @param  This                Protocol instance pointer.
+  @param  Controller          Handle of device to test.
+  @param  RemainingDevicePath Optional parameter use to pick a specific child
+                              device to start.
+
+  @retval EFI_SUCCESS         This driver supports this device.
+  @retval other               This driver does not support this device.
+
+**/
+EFI_STATUS
+EFIAPI
+GraphicsConsoleControllerDriverSupported (
+  IN EFI_DRIVER_BINDING_PROTOCOL    *This,
+  IN EFI_HANDLE                     Controller,
+  IN EFI_DEVICE_PATH_PROTOCOL       *RemainingDevicePath
+  )
+{
+  EFI_STATUS                   Status;
+  EFI_GRAPHICS_OUTPUT_PROTOCOL *GraphicsOutput;
+  EFI_DEVICE_PATH_PROTOCOL     *DevicePath;
+
+  GraphicsOutput = NULL;
+  //
+  // Open the IO Abstraction(s) needed to perform the supported test
+  //
+  Status = gBS->OpenProtocol (
+                  Controller,
+                  &gEfiGraphicsOutputProtocolGuid,
+                  (VOID**)&GraphicsOutput,
+                  This->DriverBindingHandle,
+                  Controller,
+                  EFI_OPEN_PROTOCOL_BY_DRIVER
+                );
+  if (EFI_ERROR (Status)) {
+    return Status;
+  }
+
+  ASSERT (GraphicsOutput != NULL);
+
+  //
+  // We need to ensure that we do not layer on top of a virtual handle.
+  // We need to ensure that the handles produced by the conspliter do not
+  // get used.
+  //
+  Status = gBS->OpenProtocol (
+                  Controller,
+                  &gEfiDevicePathProtocolGuid,
+                  (VOID**)&DevicePath,
+                  This->DriverBindingHandle,
+                  Controller,
+                  EFI_OPEN_PROTOCOL_BY_DRIVER
+                );
+  if (!EFI_ERROR (Status)) {
+    gBS->CloseProtocol (
+           Controller,
+           &gEfiDevicePathProtocolGuid,
+           This->DriverBindingHandle,
+           Controller
+         );
+  } else {
+    goto Error;
+  }
+
+  //
+  // Does Hii Exist?  If not, we aren't ready to run
+  //
+  Status = EfiLocateHiiProtocol ();
+
+  //
+  // Close the I/O Abstraction(s) used to perform the supported test
+  //
+Error:
+  gBS->CloseProtocol (
+         Controller,
+         &gEfiGraphicsOutputProtocolGuid,
+         This->DriverBindingHandle,
+         Controller
+       );
+  return Status;
+}
+
+/**
+  Initialize all the text modes which the graphics console supports.
+
+  It returns information for available text modes that the graphics can support.
+
+  @param[in]  HorizontalResolution     The size of video screen in pixels in the X dimension.
+  @param[in]  VerticalResolution       The size of video screen in pixels in the Y dimension.
+  @param[in]  GopModeNumber            The graphics mode number which graphis console is based on.
+  @param[out] TextModeCount            The total number of text modes that graphics console supports.
+  @param[out] TextModeData             The buffer to the text modes column and row information.
+                                       Caller is responsible to free it when it's non-NULL.
+
+  @retval EFI_SUCCESS                  The supporting mode information is returned.
+  @retval EFI_INVALID_PARAMETER        The parameters are invalid.
+
+**/
+EFI_STATUS
+InitializeGraphicsConsoleTextMode (
+  IN UINT32                        HorizontalResolution,
+  IN UINT32                        VerticalResolution,
+  IN UINT32                        GopModeNumber,
+  OUT UINTN                        *TextModeCount,
+  OUT GRAPHICS_CONSOLE_MODE_DATA   **TextModeData
+  )
+{
+  UINTN                       Index;
+  UINTN                       Count;
+  GRAPHICS_CONSOLE_MODE_DATA  *ModeBuffer;
+  GRAPHICS_CONSOLE_MODE_DATA  *NewModeBuffer;
+  UINTN                       ValidCount;
+  UINTN                       ValidIndex;
+  UINTN                       MaxColumns;
+  UINTN                       MaxRows;
+
+  if ((TextModeCount == NULL) || (TextModeData == NULL)) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  Count = sizeof (mGraphicsConsoleModeData) / sizeof (GRAPHICS_CONSOLE_MODE_DATA);
+
+  //
+  // Compute the maximum number of text Rows and Columns that this current graphics mode can support.
+  // To make graphics console work well, MaxColumns and MaxRows should not be zero.
+  //
+  MaxColumns = HorizontalResolution / EFI_GLYPH_WIDTH;
+  MaxRows    = VerticalResolution / EFI_GLYPH_HEIGHT;
+
+  //
+  // According to UEFI spec, all output devices support at least 80x25 text mode.
+  //
+  ASSERT ((MaxColumns >= 80) && (MaxRows >= 25));
+
+  //
+  // Add full screen mode to the last entry.
+  //
+  mGraphicsConsoleModeData[Count - 1].Columns = MaxColumns;
+  mGraphicsConsoleModeData[Count - 1].Rows    = MaxRows;
+
+  //
+  // Get defined mode buffer pointer.
+  //
+  ModeBuffer = mGraphicsConsoleModeData;
+
+  //
+  // Here we make sure that the final mode exposed does not include the duplicated modes,
+  // and does not include the invalid modes which exceed the max column and row.
+  // Reserve 2 modes for 80x25, 80x50 of graphics console.
+  //
+  NewModeBuffer = AllocateZeroPool (sizeof (GRAPHICS_CONSOLE_MODE_DATA) * (Count + 2));
+  ASSERT (NewModeBuffer != NULL);
+
+  //
+  // Mode 0 and mode 1 is for 80x25, 80x50 according to UEFI spec.
+  //
+  ValidCount = 0;
+
+  NewModeBuffer[ValidCount].Columns       = 80;
+  NewModeBuffer[ValidCount].Rows          = 25;
+  NewModeBuffer[ValidCount].GopWidth      = HorizontalResolution;
+  NewModeBuffer[ValidCount].GopHeight     = VerticalResolution;
+  NewModeBuffer[ValidCount].GopModeNumber = GopModeNumber;
+  NewModeBuffer[ValidCount].DeltaX        = (HorizontalResolution - (NewModeBuffer[ValidCount].Columns * EFI_GLYPH_WIDTH)) >> 1;
+  NewModeBuffer[ValidCount].DeltaY        = (VerticalResolution - (NewModeBuffer[ValidCount].Rows * EFI_GLYPH_HEIGHT)) >> 1;
+  ValidCount++;
+
+  if ((MaxColumns >= 80) && (MaxRows >= 50)) {
+    NewModeBuffer[ValidCount].Columns = 80;
+    NewModeBuffer[ValidCount].Rows    = 50;
+    NewModeBuffer[ValidCount].DeltaX  = (HorizontalResolution - (80 * EFI_GLYPH_WIDTH)) >> 1;
+    NewModeBuffer[ValidCount].DeltaY  = (VerticalResolution - (50 * EFI_GLYPH_HEIGHT)) >> 1;
+  }
+  NewModeBuffer[ValidCount].GopWidth      = HorizontalResolution;
+  NewModeBuffer[ValidCount].GopHeight     = VerticalResolution;
+  NewModeBuffer[ValidCount].GopModeNumber = GopModeNumber;
+  ValidCount++;
+
+  //
+  // Start from mode 2 to put the valid mode other than 80x25 and 80x50 in the output mode buffer.
+  //
+  for (Index = 0; Index < Count; Index++) {
+    if ((ModeBuffer[Index].Columns == 0) || (ModeBuffer[Index].Rows == 0) ||
+        (ModeBuffer[Index].Columns > MaxColumns) || (ModeBuffer[Index].Rows > MaxRows)) {
+      //
+      // Skip the pre-defined mode which is invalid or exceeds the max column and row.
+      //
+      continue;
+    }
+    for (ValidIndex = 0; ValidIndex < ValidCount; ValidIndex++) {
+      if ((ModeBuffer[Index].Columns == NewModeBuffer[ValidIndex].Columns) &&
+          (ModeBuffer[Index].Rows == NewModeBuffer[ValidIndex].Rows)) {
+        //
+        // Skip the duplicated mode.
+        //
+        break;
+      }
+    }
+    if (ValidIndex == ValidCount) {
+      NewModeBuffer[ValidCount].Columns       = ModeBuffer[Index].Columns;
+      NewModeBuffer[ValidCount].Rows          = ModeBuffer[Index].Rows;
+      NewModeBuffer[ValidCount].GopWidth      = HorizontalResolution;
+      NewModeBuffer[ValidCount].GopHeight     = VerticalResolution;
+      NewModeBuffer[ValidCount].GopModeNumber = GopModeNumber;
+      NewModeBuffer[ValidCount].DeltaX        = (HorizontalResolution - (NewModeBuffer[ValidCount].Columns * EFI_GLYPH_WIDTH)) >> 1;
+      NewModeBuffer[ValidCount].DeltaY        = (VerticalResolution - (NewModeBuffer[ValidCount].Rows * EFI_GLYPH_HEIGHT)) >> 1;
+      ValidCount++;
+    }
+  }
+
+  DEBUG_CODE (
+    for (Index = 0; Index < ValidCount; Index++) {
+      DEBUG ((DEBUG_INFO, "Graphics - Mode %d, Column = %d, Row = %d\n",
+        Index, NewModeBuffer[Index].Columns, NewModeBuffer[Index].Rows));
+    }
+  );
+
+  //
+  // Return valid mode count and mode information buffer.
+  //
+  *TextModeCount = ValidCount;
+  *TextModeData  = NewModeBuffer;
+  return EFI_SUCCESS;
+}
+
+/**
+  Start this driver on Controller by opening Graphics Output Protocol,
+  and installing Simple Text Out protocol on Controller.
+
+  @param  This                 Protocol instance pointer.
+  @param  Controller           Handle of device to bind driver to
+  @param  RemainingDevicePath  Optional parameter use to pick a specific child
+                               device to start.
+
+  @retval EFI_SUCCESS          This driver is added to Controller.
+  @retval other                This driver does not support this device.
+
+**/
+EFI_STATUS
+EFIAPI
+GraphicsConsoleControllerDriverStart (
+  IN EFI_DRIVER_BINDING_PROTOCOL    *This,
+  IN EFI_HANDLE                     Controller,
+  IN EFI_DEVICE_PATH_PROTOCOL       *RemainingDevicePath
+  )
+{
+  EFI_STATUS                           Status;
+  GRAPHICS_CONSOLE_DEV                 *Private;
+  UINT32                               HorizontalResolution;
+  UINT32                               VerticalResolution;
+  UINT32                               ModeIndex;
+  UINTN                                MaxMode;
+  UINT32                               ModeNumber;
+  EFI_GRAPHICS_OUTPUT_PROTOCOL_MODE    *Mode;
+  UINTN                                SizeOfInfo;
+  EFI_GRAPHICS_OUTPUT_MODE_INFORMATION *Info;
+
+  ModeNumber = 0;
+
+  //
+  // Initialize the Graphics Console device instance
+  //
+  Private = AllocateCopyPool (
+              sizeof (GRAPHICS_CONSOLE_DEV),
+              &mGraphicsConsoleDevTemplate
+            );
+  if (Private == NULL) {
+    return EFI_OUT_OF_RESOURCES;
+  }
+
+  Private->SimpleTextOutput.Mode = &(Private->SimpleTextOutputMode);
+
+  Status = gBS->OpenProtocol (
+                  Controller,
+                  &gEfiGraphicsOutputProtocolGuid,
+                  (VOID**)&Private->GraphicsOutput,
+                  This->DriverBindingHandle,
+                  Controller,
+                  EFI_OPEN_PROTOCOL_BY_DRIVER
+                );
+  if (EFI_ERROR (Status)) {
+    goto Error;
+  }
+
+  Private->ExtendedTextOutput.TextOut = &(Private->SimpleTextOutput);
+  Private->ExtendedTextOutput.GraphicsOutput = Private->GraphicsOutput;
+
+  HorizontalResolution = PcdGet32 (PcdVideoHorizontalResolution);
+  VerticalResolution   = PcdGet32 (PcdVideoVerticalResolution);
+
+  ASSERT (Private->GraphicsOutput != NULL);
+  //
+  // The console is build on top of Graphics Output Protocol, find the mode number
+  // for the user-defined mode; if there are multiple video devices,
+  // graphic console driver will set all the video devices to the same mode.
+  //
+  if ((HorizontalResolution == 0x0) || (VerticalResolution == 0x0)) {
+    //
+    // Find the highest resolution which GOP supports.
+    //
+    MaxMode = Private->GraphicsOutput->Mode->MaxMode;
+
+    for (ModeIndex = 0; ModeIndex < MaxMode; ModeIndex++) {
+      Status = Private->GraphicsOutput->QueryMode (
+                                          Private->GraphicsOutput,
+                                          ModeIndex,
+                                          &SizeOfInfo,
+                                          &Info
+                                        );
+      if (!EFI_ERROR (Status)) {
+        if ((Info->HorizontalResolution > HorizontalResolution) ||
+            ((Info->HorizontalResolution == HorizontalResolution) && (Info->VerticalResolution > VerticalResolution))) {
+          HorizontalResolution = Info->HorizontalResolution;
+          VerticalResolution = Info->VerticalResolution;
+          ModeNumber = ModeIndex;
+        }
+        FreePool (Info);
+      }
+    }
+    if ((HorizontalResolution == 0x0) || (VerticalResolution == 0x0)) {
+      Status = EFI_UNSUPPORTED;
+      goto Error;
+    }
+  } else {
+    //
+    // Use user-defined resolution
+    //
+    Status = CheckModeSupported (
+               Private->GraphicsOutput,
+               HorizontalResolution,
+               VerticalResolution,
+               &ModeNumber
+             );
+    if (EFI_ERROR (Status)) {
+      //
+      // if not supporting current mode, try 800x600 which is required by UEFI/EFI spec.
+      //
+      HorizontalResolution = 800;
+      VerticalResolution = 600;
+      Status = CheckModeSupported (
+                 Private->GraphicsOutput,
+                 HorizontalResolution,
+                 VerticalResolution,
+                 &ModeNumber
+               );
+      Mode = Private->GraphicsOutput->Mode;
+      if (EFI_ERROR (Status) && Mode->MaxMode != 0) {
+        //
+        // Set default mode failed or device don't support default mode, then get the current mode information.
+        //
+        HorizontalResolution = Mode->Info->HorizontalResolution;
+        VerticalResolution = Mode->Info->VerticalResolution;
+        ModeNumber = Mode->Mode;
+      }
+    }
+  }
+  if (ModeNumber != Private->GraphicsOutput->Mode->Mode) {
+    //
+    // Current graphics mode is not set or is not set to the mode which we has found,
+    // set the new graphic mode.
+    //
+    Status = Private->GraphicsOutput->SetMode (Private->GraphicsOutput, ModeNumber);
+    if (EFI_ERROR (Status)) {
+      //
+      // The mode set operation failed
+      //
+      goto Error;
+    }
+  }
+
+  DEBUG ((DEBUG_INFO, "GraphicsConsole video resolution %d x %d\n", HorizontalResolution, VerticalResolution));
+
+  //
+  // Initialize the mode which GraphicsConsole supports.
+  //
+  Status = InitializeGraphicsConsoleTextMode (
+             HorizontalResolution,
+             VerticalResolution,
+             ModeNumber,
+             &MaxMode,
+             &Private->ModeData
+           );
+
+  if (EFI_ERROR (Status)) {
+    goto Error;
+  }
+
+  //
+  // Update the maximum number of modes
+  //
+  Private->SimpleTextOutputMode.MaxMode = (INT32)MaxMode;
+
+  DEBUG_CODE_BEGIN ();
+  Status = GraphicsConsoleConOutSetMode (&Private->SimpleTextOutput, 0);
+  if (EFI_ERROR (Status)) {
+    goto Error;
+  }
+  Status = GraphicsConsoleConOutOutputString (&Private->SimpleTextOutput,
+             (CHAR16*)L"Graphics Console Started\n\r");
+  if (EFI_ERROR (Status)) {
+    goto Error;
+  }
+  DEBUG_CODE_END ();
+
+  //
+  // Install protocol interfaces for the Graphics Console device.
+  //
+  Status = gBS->InstallMultipleProtocolInterfaces (
+                  &Controller,
+                  &gEfiSimpleTextOutProtocolGuid,
+                  &Private->SimpleTextOutput,
+                  &gExtendedTextOutputProtocolGuid,
+                  &Private->ExtendedTextOutput,
+                  NULL
+                );
+
+Error:
+  if (EFI_ERROR (Status)) {
+    //
+    // Close GOP.
+    //
+    gBS->CloseProtocol (
+           Controller,
+           &gEfiGraphicsOutputProtocolGuid,
+           This->DriverBindingHandle,
+           Controller
+         );
+
+    if (Private->LineBuffer != NULL) {
+      FreePool (Private->LineBuffer);
+    }
+
+    if (Private->ModeData != NULL) {
+      FreePool (Private->ModeData);
+    }
+
+    //
+    // Free private data
+    //
+    FreePool (Private);
+  }
+
+  return Status;
+}
+
+/**
+  Stop this driver on Controller by removing Simple Text Out protocol
+  and closing the Graphics Output Protocol on Controller.
+
+
+  @param  This              Protocol instance pointer.
+  @param  Controller        Handle of device to stop driver on
+  @param  NumberOfChildren  Number of Handles in ChildHandleBuffer. If number of
+                            children is zero stop the entire bus driver.
+  @param  ChildHandleBuffer List of Child Handles to Stop.
+
+  @retval EFI_SUCCESS       This driver is removed Controller.
+  @retval EFI_NOT_STARTED   Simple Text Out protocol could not be found the
+                            Controller.
+  @retval other             This driver was not removed from this device.
+
+**/
+EFI_STATUS
+EFIAPI
+GraphicsConsoleControllerDriverStop (
+  IN  EFI_DRIVER_BINDING_PROTOCOL   *This,
+  IN  EFI_HANDLE                    Controller,
+  IN  UINTN                         NumberOfChildren,
+  IN  EFI_HANDLE                    *ChildHandleBuffer
+  )
+{
+  EFI_STATUS                       Status;
+  EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL  *SimpleTextOutput;
+  GRAPHICS_CONSOLE_DEV             *Private;
+
+  Status = gBS->OpenProtocol (
+                  Controller,
+                  &gEfiSimpleTextOutProtocolGuid,
+                  (VOID**)&SimpleTextOutput,
+                  This->DriverBindingHandle,
+                  Controller,
+                  EFI_OPEN_PROTOCOL_GET_PROTOCOL
+                );
+  if (EFI_ERROR (Status)) {
+    return EFI_NOT_STARTED;
+  }
+
+  Private = GRAPHICS_CONSOLE_CON_OUT_DEV_FROM_THIS (SimpleTextOutput);
+
+  Status = gBS->UninstallMultipleProtocolInterfaces (
+                  Controller,
+                  &gEfiSimpleTextOutProtocolGuid,
+                  &Private->SimpleTextOutput,
+                  &gExtendedTextOutputProtocolGuid,
+                  &Private->ExtendedTextOutput,
+                  NULL
+                );
+
+  if (!EFI_ERROR (Status)) {
+    //
+    // Close GOP.
+    //
+    gBS->CloseProtocol (
+           Controller,
+           &gEfiGraphicsOutputProtocolGuid,
+           This->DriverBindingHandle,
+           Controller
+         );
+
+    if (Private->LineBuffer != NULL) {
+      FreePool (Private->LineBuffer);
+    }
+
+    if (Private->ModeData != NULL) {
+      FreePool (Private->ModeData);
+    }
+
+    //
+    // Free our instance data
+    //
+    FreePool (Private);
+  }
+
+  return Status;
+}
+
+/**
+  Check if the current specific mode supported the user defined resolution
+  for the Graphics Console device based on Graphics Output Protocol.
+
+  If yes, set the graphic devcice's current mode to this specific mode.
+
+  @param  GraphicsOutput        Graphics Output Protocol instance pointer.
+  @param  HorizontalResolution  User defined horizontal resolution
+  @param  VerticalResolution    User defined vertical resolution.
+  @param  CurrentModeNumber     Current specific mode to be check.
+
+  @retval EFI_SUCCESS       The mode is supported.
+  @retval EFI_UNSUPPORTED   The specific mode is out of range of graphics
+                            device supported.
+  @retval other             The specific mode does not support user defined
+                            resolution or failed to set the current mode to the
+                            specific mode on graphics device.
+
+**/
+EFI_STATUS
+CheckModeSupported (
+  EFI_GRAPHICS_OUTPUT_PROTOCOL  *GraphicsOutput,
+  IN  UINT32                    HorizontalResolution,
+  IN  UINT32                    VerticalResolution,
+  OUT UINT32                    *CurrentModeNumber
+  )
+{
+  UINT32     ModeNumber;
+  EFI_STATUS Status;
+  UINTN      SizeOfInfo;
+  EFI_GRAPHICS_OUTPUT_MODE_INFORMATION *Info;
+  UINT32     MaxMode;
+
+  Status = EFI_SUCCESS;
+  MaxMode = GraphicsOutput->Mode->MaxMode;
+
+  for (ModeNumber = 0; ModeNumber < MaxMode; ModeNumber++) {
+    Status = GraphicsOutput->QueryMode (
+                               GraphicsOutput,
+                               ModeNumber,
+                               &SizeOfInfo,
+                               &Info
+                             );
+    if (!EFI_ERROR (Status)) {
+      if ((Info->HorizontalResolution == HorizontalResolution) &&
+          (Info->VerticalResolution == VerticalResolution)) {
+        if ((GraphicsOutput->Mode->Info->HorizontalResolution == HorizontalResolution) &&
+            (GraphicsOutput->Mode->Info->VerticalResolution == VerticalResolution)) {
+          //
+          // If video device has been set to this mode, we do not need to SetMode again
+          //
+          FreePool (Info);
+          break;
+        } else {
+          Status = GraphicsOutput->SetMode (GraphicsOutput, ModeNumber);
+          if (!EFI_ERROR (Status)) {
+            FreePool (Info);
+            break;
+          }
+        }
+      }
+      FreePool (Info);
+    }
+  }
+
+  if (ModeNumber == GraphicsOutput->Mode->MaxMode) {
+    Status = EFI_UNSUPPORTED;
+  }
+
+  *CurrentModeNumber = ModeNumber;
+  return Status;
+}
+
+
+/**
+  Locate HII Database protocol and HII Font protocol.
+
+  @retval  EFI_SUCCESS     HII Database protocol and HII Font protocol
+                           are located successfully.
+  @return  other           Failed to locate HII Database protocol or
+                           HII Font protocol.
+
+**/
+EFI_STATUS
+EfiLocateHiiProtocol (
+  VOID
+  )
+{
+  EFI_STATUS  Status;
+
+  Status = gBS->LocateProtocol (&gEfiHiiDatabaseProtocolGuid, NULL, (VOID**)&mHiiDatabase);
+  if (EFI_ERROR (Status)) {
+    return Status;
+  }
+
+  Status = gBS->LocateProtocol (&gEfiHiiFontProtocolGuid, NULL, (VOID**)&mHiiFont);
+  return Status;
+}
+
+//
+// Body of the STO functions
+//
+
+/**
+  Reset the text output device hardware and optionally run diagnostics.
+
+  Implements SIMPLE_TEXT_OUTPUT.Reset().
+  If ExtendeVerification is TRUE, then perform dependent Graphics Console
+  device reset, and set display mode to mode 0.
+  If ExtendedVerification is FALSE, only set display mode to mode 0.
+
+  @param  This                  Protocol instance pointer.
+  @param  ExtendedVerification  Indicates that the driver may perform a more
+                                exhaustive verification operation of the device
+                                during reset.
+
+  @retval EFI_SUCCESS          The text output device was reset.
+  @retval EFI_DEVICE_ERROR     The text output device is not functioning correctly and
+                               could not be reset.
+
+**/
+EFI_STATUS
+EFIAPI
+GraphicsConsoleConOutReset (
+  IN  EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL  *This,
+  IN  BOOLEAN                          ExtendedVerification
+  )
+{
+  EFI_STATUS    Status;
+  Status = This->SetMode (This, 0);
+  if (EFI_ERROR (Status)) {
+    return Status;
+  }
+  Status = This->SetAttribute (This, EFI_TEXT_ATTR (This->Mode->Attribute & 0x0F, EFI_BACKGROUND_BLACK));
+  return Status;
+}
+
+
+/**
+  Write a Unicode string to the output device.
+
+  Implements SIMPLE_TEXT_OUTPUT.OutputString().
+  The Unicode string will be converted to Glyphs and will be
+  sent to the Graphics Console.
+
+  @param  This                    Protocol instance pointer.
+  @param  WString                 The NULL-terminated Unicode string to be displayed
+                                  on the output device(s). All output devices must
+                                  also support the Unicode drawing defined in this file.
+
+  @retval EFI_SUCCESS             The string was output to the device.
+  @retval EFI_DEVICE_ERROR        The device reported an error while attempting to output
+                                  the text.
+  @retval EFI_UNSUPPORTED         The output device's mode is not currently in a
+                                  defined text mode.
+  @retval EFI_WARN_UNKNOWN_GLYPH  This warning code indicates that some of the
+                                  characters in the Unicode string could not be
+                                  rendered and were skipped.
+
+**/
+EFI_STATUS
+EFIAPI
+GraphicsConsoleConOutOutputString (
+  IN  EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL  *This,
+  IN  CHAR16                           *WString
+  )
+{
+  GRAPHICS_CONSOLE_DEV  *Private;
+  EFI_GRAPHICS_OUTPUT_PROTOCOL   *GraphicsOutput;
+  INTN                  Mode;
+  UINTN                 MaxColumn;
+  UINTN                 MaxRow;
+  UINTN                 Width;
+  UINTN                 Height;
+  UINTN                 Delta;
+  EFI_STATUS            Status;
+  BOOLEAN               Warning;
+  EFI_GRAPHICS_OUTPUT_BLT_PIXEL  Foreground;
+  EFI_GRAPHICS_OUTPUT_BLT_PIXEL  Background;
+  UINTN                 DeltaX;
+  UINTN                 DeltaY;
+  UINTN                 Count;
+  UINTN                 Index;
+  INT32                 OriginAttribute;
+  EFI_TPL               OldTpl;
+
+  if (This->Mode->Mode == -1) {
+    //
+    // If current mode is not valid, return error.
+    //
+    return EFI_UNSUPPORTED;
+  }
+
+  Status = EFI_SUCCESS;
+
+  OldTpl = gBS->RaiseTPL (TPL_NOTIFY);
+  //
+  // Current mode
+  //
+  Mode      = This->Mode->Mode;
+  Private   = GRAPHICS_CONSOLE_CON_OUT_DEV_FROM_THIS (This);
+  GraphicsOutput = Private->GraphicsOutput;
+
+  MaxColumn = Private->ModeData[Mode].Columns;
+  MaxRow    = Private->ModeData[Mode].Rows;
+  DeltaX    = (UINTN) Private->ModeData[Mode].DeltaX;
+  DeltaY    = (UINTN) Private->ModeData[Mode].DeltaY;
+  Width     = MaxColumn * EFI_GLYPH_WIDTH;
+  Height    = (MaxRow - 1) * EFI_GLYPH_HEIGHT;
+  Delta     = Width * sizeof (EFI_GRAPHICS_OUTPUT_BLT_PIXEL);
+
+  //
+  // The Attributes won't change when during the time OutputString is called
+  //
+  GetTextColors (This, &Foreground, &Background);
+
+  FlushCursor (This);
+
+  Warning = FALSE;
+
+  //
+  // Backup attribute
+  //
+  OriginAttribute = This->Mode->Attribute;
+
+  while (*WString != L'\0') {
+
+    if (*WString == CHAR_BACKSPACE) {
+      //
+      // If the cursor is at the left edge of the display, then move the cursor
+      // one row up.
+      //
+      if (This->Mode->CursorColumn == 0 && This->Mode->CursorRow > 0) {
+        This->Mode->CursorRow--;
+        This->Mode->CursorColumn = (INT32)(MaxColumn - 1);
+        This->OutputString (This, SpaceStr);
+        FlushCursor (This);
+        This->Mode->CursorRow--;
+        This->Mode->CursorColumn = (INT32)(MaxColumn - 1);
+      } else if (This->Mode->CursorColumn > 0) {
+        //
+        // If the cursor is not at the left edge of the display, then move the cursor
+        // left one column.
+        //
+        This->Mode->CursorColumn--;
+        This->OutputString (This, SpaceStr);
+        FlushCursor (This);
+        This->Mode->CursorColumn--;
+      }
+
+      WString++;
+
+    } else if (*WString == CHAR_LINEFEED) {
+      //
+      // If the cursor is at the bottom of the display, then scroll the display one
+      // row, and do not update the cursor position. Otherwise, move the cursor
+      // down one row.
+      //
+      if (This->Mode->CursorRow == (INT32)(MaxRow - 1)) {
+        //
+        // Scroll Screen Up One Row
+        //
+        GraphicsOutput->Blt (
+                          GraphicsOutput,
+                          NULL,
+                          EfiBltVideoToVideo,
+                          DeltaX,
+                          DeltaY + EFI_GLYPH_HEIGHT,
+                          DeltaX,
+                          DeltaY,
+                          Width,
+                          Height,
+                          Delta
+                        );
+
+        //
+        // Print Blank Line at last line
+        //
+        GraphicsOutput->Blt (
+                          GraphicsOutput,
+                          &Background,
+                          EfiBltVideoFill,
+                          0,
+                          0,
+                          DeltaX,
+                          DeltaY + Height,
+                          Width,
+                          EFI_GLYPH_HEIGHT,
+                          Delta
+                        );
+      } else {
+        This->Mode->CursorRow++;
+      }
+
+      WString++;
+
+    } else if (*WString == CHAR_CARRIAGE_RETURN) {
+      //
+      // Move the cursor to the beginning of the current row.
+      //
+      This->Mode->CursorColumn = 0;
+      WString++;
+
+    } else if (*WString == WIDE_CHAR) {
+
+      This->Mode->Attribute |= EFI_WIDE_ATTRIBUTE;
+      WString++;
+
+    } else if (*WString == NARROW_CHAR) {
+
+      This->Mode->Attribute &= (~(UINT32)EFI_WIDE_ATTRIBUTE);
+      WString++;
+
+    } else {
+      //
+      // Print the character at the current cursor position and move the cursor
+      // right one column. If this moves the cursor past the right edge of the
+      // display, then the line should wrap to the beginning of the next line. This
+      // is equivalent to inserting a CR and an LF. Note that if the cursor is at the
+      // bottom of the display, and the line wraps, then the display will be scrolled
+      // one line.
+      // If wide char is going to be displayed, need to display one character at a time
+      // Or, need to know the display length of a certain string.
+      //
+      // Index is used to determine how many character width units (wide = 2, narrow = 1)
+      // Count is used to determine how many characters are used regardless of their attributes
+      //
+      for (Count = 0, Index = 0; (This->Mode->CursorColumn + Index) < MaxColumn; Count++, Index++) {
+        if (WString[Count] == CHAR_NULL ||
+            WString[Count] == CHAR_BACKSPACE ||
+            WString[Count] == CHAR_LINEFEED ||
+            WString[Count] == CHAR_CARRIAGE_RETURN ||
+            WString[Count] == WIDE_CHAR ||
+            WString[Count] == NARROW_CHAR) {
+          break;
+        }
+        //
+        // Is the wide attribute on?
+        //
+        if ((This->Mode->Attribute & EFI_WIDE_ATTRIBUTE) != 0) {
+          //
+          // If wide, add one more width unit than normal since we are going to increment at the end of the for loop
+          //
+          Index++;
+          //
+          // This is the end-case where if we are at column 79 and about to print a wide character
+          // We should prevent this from happening because we will wrap inappropriately.  We should
+          // not print this character until the next line.
+          //
+          if ((This->Mode->CursorColumn + Index + 1) > MaxColumn) {
+            Index++;
+            break;
+          }
+        }
+      }
+
+      Status = DrawUnicodeWeightAtCursorN (This, WString, Count);
+      if (EFI_ERROR (Status)) {
+        Warning = TRUE;
+      }
+      //
+      // At the end of line, output carriage return and line feed
+      //
+      WString += Count;
+      This->Mode->CursorColumn += (INT32)Index;
+      if (This->Mode->CursorColumn > (INT32)MaxColumn) {
+        This->Mode->CursorColumn -= 2;
+        This->OutputString (This, SpaceStr);
+      }
+
+      if (This->Mode->CursorColumn >= (INT32)MaxColumn) {
+        FlushCursor (This);
+        if (!Private->ExtendedTextOutput.AutoWrap) {
+          This->Mode->CursorColumn = MaxColumn - 1;
+        } else {
+          This->OutputString (This, mCrLfString);
+        }
+        FlushCursor (This);
+      }
+    }
+  }
+
+  This->Mode->Attribute = OriginAttribute;
+
+  FlushCursor (This);
+
+  if (Warning) {
+    Status = EFI_WARN_UNKNOWN_GLYPH;
+  }
+
+  gBS->RestoreTPL (OldTpl);
+  return Status;
+
+}
+
+/**
+  Verifies that all characters in a Unicode string can be output to the
+  target device.
+
+  Implements SIMPLE_TEXT_OUTPUT.TestString().
+  If one of the characters in the *Wstring is neither valid valid Unicode
+  drawing characters, not ASCII code, then this function will return
+  EFI_UNSUPPORTED
+
+  @param  This    Protocol instance pointer.
+  @param  WString The NULL-terminated Unicode string to be examined for the output
+                  device(s).
+
+  @retval EFI_SUCCESS      The device(s) are capable of rendering the output string.
+  @retval EFI_UNSUPPORTED  Some of the characters in the Unicode string cannot be
+                           rendered by one or more of the output devices mapped
+                           by the EFI handle.
+
+**/
+EFI_STATUS
+EFIAPI
+GraphicsConsoleConOutTestString (
+  IN  EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL  *This,
+  IN  CHAR16                           *WString
+  )
+{
+  EFI_STATUS            Status;
+  UINT16                Count;
+
+  EFI_IMAGE_OUTPUT      *Blt;
+
+  Blt = NULL;
+  Count = 0;
+
+  while (WString[Count] != 0) {
+    Status = mHiiFont->GetGlyph (
+                         mHiiFont,
+                         WString[Count],
+                         NULL,
+                         &Blt,
+                         NULL
+                       );
+    if (Blt != NULL) {
+      FreePool (Blt);
+      Blt = NULL;
+    }
+    Count++;
+
+    if (EFI_ERROR (Status)) {
+      return EFI_UNSUPPORTED;
+    }
+  }
+
+  return EFI_SUCCESS;
+}
+
+
+/**
+  Returns information for an available text mode that the output device(s)
+  supports
+
+  Implements SIMPLE_TEXT_OUTPUT.QueryMode().
+  It returnes information for an available text mode that the Graphics Console supports.
+  In this driver,we only support text mode 80x25, which is defined as mode 0.
+
+  @param  This                  Protocol instance pointer.
+  @param  ModeNumber            The mode number to return information on.
+  @param  Columns               The returned columns of the requested mode.
+  @param  Rows                  The returned rows of the requested mode.
+
+  @retval EFI_SUCCESS           The requested mode information is returned.
+  @retval EFI_UNSUPPORTED       The mode number is not valid.
+
+**/
+EFI_STATUS
+EFIAPI
+GraphicsConsoleConOutQueryMode (
+  IN  EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL  *This,
+  IN  UINTN                            ModeNumber,
+  OUT UINTN                            *Columns,
+  OUT UINTN                            *Rows
+  )
+{
+  GRAPHICS_CONSOLE_DEV  *Private;
+  EFI_STATUS            Status;
+  EFI_TPL               OldTpl;
+
+  if (ModeNumber >= (UINTN)This->Mode->MaxMode) {
+    return EFI_UNSUPPORTED;
+  }
+
+  OldTpl = gBS->RaiseTPL (TPL_NOTIFY);
+  Status = EFI_SUCCESS;
+
+  Private   = GRAPHICS_CONSOLE_CON_OUT_DEV_FROM_THIS (This);
+
+  *Columns  = Private->ModeData[ModeNumber].Columns;
+  *Rows     = Private->ModeData[ModeNumber].Rows;
+
+  if (*Columns <= 0 || *Rows <= 0) {
+    Status = EFI_UNSUPPORTED;
+    goto Done;
+
+  }
+
+Done:
+  gBS->RestoreTPL (OldTpl);
+  return Status;
+}
+
+
+/**
+  Sets the output device(s) to a specified mode.
+
+  Implements SIMPLE_TEXT_OUTPUT.SetMode().
+  Set the Graphics Console to a specified mode. In this driver, we only support mode 0.
+
+  @param  This                  Protocol instance pointer.
+  @param  ModeNumber            The text mode to set.
+
+  @retval EFI_SUCCESS           The requested text mode is set.
+  @retval EFI_DEVICE_ERROR      The requested text mode cannot be set because of
+                                Graphics Console device error.
+  @retval EFI_UNSUPPORTED       The text mode number is not valid.
+
+**/
+EFI_STATUS
+EFIAPI
+GraphicsConsoleConOutSetMode (
+  IN  EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL  *This,
+  IN  UINTN                            ModeNumber
+  )
+{
+  EFI_STATUS                      Status;
+  GRAPHICS_CONSOLE_DEV            *Private;
+  GRAPHICS_CONSOLE_MODE_DATA      *ModeData;
+  EFI_GRAPHICS_OUTPUT_BLT_PIXEL   *NewLineBuffer;
+  EFI_GRAPHICS_OUTPUT_PROTOCOL    *GraphicsOutput;
+  EFI_TPL                         OldTpl;
+
+  OldTpl = gBS->RaiseTPL (TPL_NOTIFY);
+
+  Private = GRAPHICS_CONSOLE_CON_OUT_DEV_FROM_THIS (This);
+  GraphicsOutput = Private->GraphicsOutput;
+
+  //
+  // Make sure the requested mode number is supported
+  //
+  if (ModeNumber >= (UINTN)This->Mode->MaxMode) {
+    Status = EFI_UNSUPPORTED;
+    goto Done;
+  }
+
+  ModeData = &(Private->ModeData[ModeNumber]);
+
+  if (ModeData->Columns <= 0 && ModeData->Rows <= 0) {
+    Status = EFI_UNSUPPORTED;
+    goto Done;
+  }
+
+  //
+  // If the mode has been set at least one other time, then LineBuffer will not be NULL
+  //
+  if (Private->LineBuffer != NULL) {
+    //
+    // If the new mode is the same as the old mode, then just return EFI_SUCCESS
+    //
+    if ((INT32)ModeNumber == This->Mode->Mode) {
+      //
+      // Clear the current text window on the current graphics console
+      //
+      This->ClearScreen (This);
+      Status = EFI_SUCCESS;
+      goto Done;
+    }
+    //
+    // Otherwise, the size of the text console and/or the GOP mode will
+    // be changed, so erase the cursor, and free the LineBuffer for the
+    // current mode
+    //
+    FlushCursor (This);
+
+    FreePool (Private->LineBuffer);
+  }
+
+  //
+  // Attempt to allocate a line buffer for the requested mode number
+  //
+  NewLineBuffer = AllocatePool (sizeof (EFI_GRAPHICS_OUTPUT_BLT_PIXEL) * ModeData->Columns * EFI_GLYPH_WIDTH * EFI_GLYPH_HEIGHT);
+
+  if (NewLineBuffer == NULL) {
+    //
+    // The new line buffer could not be allocated, so return an error.
+    // No changes to the state of the current console have been made, so the current console is still valid
+    //
+    Status = EFI_OUT_OF_RESOURCES;
+    goto Done;
+  }
+
+  //
+  // Assign the current line buffer to the newly allocated line buffer
+  //
+  Private->LineBuffer = NewLineBuffer;
+
+  if (ModeData->GopModeNumber != GraphicsOutput->Mode->Mode) {
+    //
+    // Either no graphics mode is currently set, or it is set
+    // to the wrong resolution, so set the new graphics mode
+    //
+    Status = GraphicsOutput->SetMode (GraphicsOutput, ModeData->GopModeNumber);
+    if (EFI_ERROR (Status)) {
+      //
+      // The mode set operation failed
+      //
+      goto Done;
+    }
+  } else {
+    //
+    // The current graphics mode is correct, so simply clear the entire display
+    //
+    Status = GraphicsOutput->Blt (
+                               GraphicsOutput,
+                               &mGraphicsEfiColors[0],
+                               EfiBltVideoFill,
+                               0,
+                               0,
+                               0,
+                               0,
+                               ModeData->GopWidth,
+                               ModeData->GopHeight,
+                               0
+                             );
+  }
+
+  //
+  // The new mode is valid, so commit the mode change
+  //
+  This->Mode->Mode = (INT32)ModeNumber;
+
+  //
+  // Move the text cursor to the upper left hand corner of the display and flush it
+  //
+  This->Mode->CursorColumn = 0;
+  This->Mode->CursorRow    = 0;
+
+  FlushCursor (This);
+
+  Status = EFI_SUCCESS;
+
+Done:
+  gBS->RestoreTPL (OldTpl);
+  return Status;
+}
+
+
+/**
+  Sets the background and foreground colors for the OutputString () and
+  ClearScreen () functions.
+
+  Implements SIMPLE_TEXT_OUTPUT.SetAttribute().
+
+  @param  This                  Protocol instance pointer.
+  @param  Attribute             The attribute to set. Bits 0..3 are the foreground
+                                color, and bits 4..6 are the background color.
+                                All other bits are undefined and must be zero.
+
+  @retval EFI_SUCCESS           The requested attribute is set.
+  @retval EFI_DEVICE_ERROR      The requested attribute cannot be set due to Graphics Console port error.
+  @retval EFI_UNSUPPORTED       The attribute requested is not defined.
+
+**/
+EFI_STATUS
+EFIAPI
+GraphicsConsoleConOutSetAttribute (
+  IN  EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL  *This,
+  IN  UINTN                            Attribute
+  )
+{
+  EFI_TPL               OldTpl;
+
+  if ((Attribute | 0x7F) != 0x7F) {
+    return EFI_UNSUPPORTED;
+  }
+
+  if ((INT32)Attribute == This->Mode->Attribute) {
+    return EFI_SUCCESS;
+  }
+
+  OldTpl = gBS->RaiseTPL (TPL_NOTIFY);
+
+  FlushCursor (This);
+
+  This->Mode->Attribute = (INT32)Attribute;
+
+  FlushCursor (This);
+
+  gBS->RestoreTPL (OldTpl);
+
+  return EFI_SUCCESS;
+}
+
+
+/**
+  Clears the output device(s) display to the currently selected background
+  color.
+
+  Implements SIMPLE_TEXT_OUTPUT.ClearScreen().
+
+  @param  This                  Protocol instance pointer.
+
+  @retval  EFI_SUCCESS      The operation completed successfully.
+  @retval  EFI_DEVICE_ERROR The device had an error and could not complete the request.
+  @retval  EFI_UNSUPPORTED  The output device is not in a valid text mode.
+
+**/
+EFI_STATUS
+EFIAPI
+GraphicsConsoleConOutClearScreen (
+  IN  EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL  *This
+  )
+{
+  EFI_STATUS                    Status;
+  GRAPHICS_CONSOLE_DEV          *Private;
+  GRAPHICS_CONSOLE_MODE_DATA    *ModeData;
+  EFI_GRAPHICS_OUTPUT_PROTOCOL  *GraphicsOutput;
+  EFI_GRAPHICS_OUTPUT_BLT_PIXEL Foreground;
+  EFI_GRAPHICS_OUTPUT_BLT_PIXEL Background;
+  EFI_TPL                       OldTpl;
+
+  if (This->Mode->Mode == -1) {
+    //
+    // If current mode is not valid, return error.
+    //
+    return EFI_UNSUPPORTED;
+  }
+
+  OldTpl = gBS->RaiseTPL (TPL_NOTIFY);
+
+  Private = GRAPHICS_CONSOLE_CON_OUT_DEV_FROM_THIS (This);
+  GraphicsOutput = Private->GraphicsOutput;
+  ModeData = &(Private->ModeData[This->Mode->Mode]);
+
+  GetTextColors (This, &Foreground, &Background);
+  Status = GraphicsOutput->Blt (
+                             GraphicsOutput,
+                             &Background,
+                             EfiBltVideoFill,
+                             0,
+                             0,
+                             0,
+                             0,
+                             ModeData->GopWidth,
+                             ModeData->GopHeight,
+                             0
+                           );
+
+  This->Mode->CursorColumn = 0;
+  This->Mode->CursorRow = 0;
+
+  FlushCursor (This);
+
+  gBS->RestoreTPL (OldTpl);
+
+  return Status;
+}
+
+
+/**
+  Sets the current coordinates of the cursor position.
+
+  Implements SIMPLE_TEXT_OUTPUT.SetCursorPosition().
+
+  @param  This        Protocol instance pointer.
+  @param  Column      The position to set the cursor to. Must be greater than or
+                      equal to zero and less than the number of columns and rows
+                      by QueryMode ().
+  @param  Row         The position to set the cursor to. Must be greater than or
+                      equal to zero and less than the number of columns and rows
+                      by QueryMode ().
+
+  @retval EFI_SUCCESS      The operation completed successfully.
+  @retval EFI_DEVICE_ERROR The device had an error and could not complete the request.
+  @retval EFI_UNSUPPORTED  The output device is not in a valid text mode, or the
+                           cursor position is invalid for the current mode.
+
+**/
+EFI_STATUS
+EFIAPI
+GraphicsConsoleConOutSetCursorPosition (
+  IN  EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL  *This,
+  IN  UINTN                            Column,
+  IN  UINTN                            Row
+  )
+{
+  GRAPHICS_CONSOLE_DEV        *Private;
+  GRAPHICS_CONSOLE_MODE_DATA  *ModeData;
+  EFI_STATUS                  Status;
+  EFI_TPL                     OldTpl;
+
+  if (This->Mode->Mode == -1) {
+    //
+    // If current mode is not valid, return error.
+    //
+    return EFI_UNSUPPORTED;
+  }
+
+  Status = EFI_SUCCESS;
+
+  OldTpl = gBS->RaiseTPL (TPL_NOTIFY);
+
+  Private = GRAPHICS_CONSOLE_CON_OUT_DEV_FROM_THIS (This);
+  ModeData = &(Private->ModeData[This->Mode->Mode]);
+
+  if ((Column >= ModeData->Columns) || (Row >= ModeData->Rows)) {
+    Status = EFI_UNSUPPORTED;
+    goto Done;
+  }
+
+  if ((This->Mode->CursorColumn == (INT32)Column) && (This->Mode->CursorRow == (INT32)Row)) {
+    Status = EFI_SUCCESS;
+    goto Done;
+  }
+
+  FlushCursor (This);
+
+  This->Mode->CursorColumn = (INT32)Column;
+  This->Mode->CursorRow = (INT32)Row;
+
+  FlushCursor (This);
+
+Done:
+  gBS->RestoreTPL (OldTpl);
+
+  return Status;
+}
+
+
+/**
+  Makes the cursor visible or invisible.
+
+  Implements SIMPLE_TEXT_OUTPUT.EnableCursor().
+
+  @param  This                  Protocol instance pointer.
+  @param  Visible               If TRUE, the cursor is set to be visible, If FALSE,
+                                the cursor is set to be invisible.
+
+  @retval EFI_SUCCESS           The operation completed successfully.
+  @retval EFI_UNSUPPORTED       The output device's mode is not currently in a
+                                defined text mode.
+
+**/
+EFI_STATUS
+EFIAPI
+GraphicsConsoleConOutEnableCursor (
+  IN  EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL  *This,
+  IN  BOOLEAN                          Visible
+  )
+{
+  EFI_TPL               OldTpl;
+
+  if (This->Mode->Mode == -1) {
+    //
+    // If current mode is not valid, return error.
+    //
+    return EFI_UNSUPPORTED;
+  }
+
+  OldTpl = gBS->RaiseTPL (TPL_NOTIFY);
+
+  FlushCursor (This);
+
+  This->Mode->CursorVisible = Visible;
+
+  FlushCursor (This);
+
+  gBS->RestoreTPL (OldTpl);
+  return EFI_SUCCESS;
+}
+
+/**
+  Gets Graphics Console devcie's foreground color and background color.
+
+  @param  This                  Protocol instance pointer.
+  @param  Foreground            Returned text foreground color.
+  @param  Background            Returned text background color.
+
+  @retval EFI_SUCCESS           It returned always.
+
+**/
+EFI_STATUS
+GetTextColors (
+  IN  EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL  *This,
+  OUT EFI_GRAPHICS_OUTPUT_BLT_PIXEL    *Foreground,
+  OUT EFI_GRAPHICS_OUTPUT_BLT_PIXEL    *Background
+  )
+{
+  INTN  Attribute;
+
+  Attribute = This->Mode->Attribute & 0x7F;
+
+  *Foreground = mGraphicsEfiColors[Attribute & 0x0f];
+  *Background = mGraphicsEfiColors[Attribute >> 4];
+
+  return EFI_SUCCESS;
+}
+
+/**
+  Draw Unicode string on the Graphics Console device's screen.
+
+  @param  This                  Protocol instance pointer.
+  @param  UnicodeWeight         One Unicode string to be displayed.
+  @param  Count                 The count of Unicode string.
+
+  @retval EFI_OUT_OF_RESOURCES  If no memory resource to use.
+  @retval EFI_UNSUPPORTED       If no Graphics Output Protocol exists.
+  @retval EFI_SUCCESS           Drawing Unicode string implemented successfully.
+
+**/
+EFI_STATUS
+DrawUnicodeWeightAtCursorN (
+  IN  EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL  *This,
+  IN  CHAR16                           *UnicodeWeight,
+  IN  UINTN                            Count
+  )
+{
+  EFI_STATUS                        Status;
+  GRAPHICS_CONSOLE_DEV              *Private;
+  EFI_IMAGE_OUTPUT                  *Blt;
+  EFI_STRING                        String;
+  EFI_FONT_DISPLAY_INFO             *FontInfo;
+
+  Private = GRAPHICS_CONSOLE_CON_OUT_DEV_FROM_THIS (This);
+  Blt = (EFI_IMAGE_OUTPUT*)AllocateZeroPool (sizeof (EFI_IMAGE_OUTPUT));
+  if (Blt == NULL) {
+    return EFI_OUT_OF_RESOURCES;
+  }
+
+  Blt->Width  = (UINT16)(Private->ModeData[This->Mode->Mode].GopWidth);
+  Blt->Height = (UINT16)(Private->ModeData[This->Mode->Mode].GopHeight);
+
+  String = AllocateCopyPool ((Count + 1) * sizeof (CHAR16), UnicodeWeight);
+  if (String == NULL) {
+    FreePool (Blt);
+    return EFI_OUT_OF_RESOURCES;
+  }
+  //
+  // Set the end character
+  //
+  *(String + Count) = L'\0';
+
+  FontInfo = (EFI_FONT_DISPLAY_INFO*)AllocateZeroPool (sizeof (EFI_FONT_DISPLAY_INFO));
+  if (FontInfo == NULL) {
+    FreePool (Blt);
+    FreePool (String);
+    return EFI_OUT_OF_RESOURCES;
+  }
+  //
+  // Get current foreground and background colors.
+  //
+  GetTextColors (This, &FontInfo->ForegroundColor, &FontInfo->BackgroundColor);
+
+  //
+  // If Graphics Output protocol exists, using HII Font protocol to draw.
+  //
+  Blt->Image.Screen = Private->GraphicsOutput;
+
+  Status = mHiiFont->StringToImage (
+                       mHiiFont,
+                       EFI_HII_IGNORE_IF_NO_GLYPH | EFI_HII_DIRECT_TO_SCREEN | EFI_HII_IGNORE_LINE_BREAK,
+                       String,
+                       FontInfo,
+                       &Blt,
+                       This->Mode->CursorColumn * EFI_GLYPH_WIDTH + Private->ModeData[This->Mode->Mode].DeltaX,
+                       This->Mode->CursorRow * EFI_GLYPH_HEIGHT + Private->ModeData[This->Mode->Mode].DeltaY,
+                       NULL,
+                       NULL,
+                       NULL
+                     );
+
+  if (Blt != NULL) {
+    FreePool (Blt);
+  }
+  if (String != NULL) {
+    FreePool (String);
+  }
+  if (FontInfo != NULL) {
+    FreePool (FontInfo);
+  }
+  return Status;
+}
+
+/**
+  Flush the cursor on the screen.
+
+  If CursorVisible is FALSE, nothing to do and return directly.
+  If CursorVisible is TRUE,
+     i) If the cursor shows on screen, it will be erased.
+    ii) If the cursor does not show on screen, it will be shown.
+
+  @param  This                  Protocol instance pointer.
+
+  @retval EFI_SUCCESS           The cursor is erased successfully.
+
+**/
+EFI_STATUS
+FlushCursor (
+  IN  EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL  *This
+  )
+{
+  GRAPHICS_CONSOLE_DEV                *Private;
+  EFI_SIMPLE_TEXT_OUTPUT_MODE         *CurrentMode;
+  INTN                                GlyphX;
+  INTN                                GlyphY;
+  EFI_GRAPHICS_OUTPUT_PROTOCOL        *GraphicsOutput;
+  EFI_GRAPHICS_OUTPUT_BLT_PIXEL_UNION Foreground;
+  EFI_GRAPHICS_OUTPUT_BLT_PIXEL_UNION Background;
+  EFI_GRAPHICS_OUTPUT_BLT_PIXEL_UNION BltChar[EFI_GLYPH_HEIGHT][EFI_GLYPH_WIDTH];
+  UINTN                               PosX;
+  UINTN                               PosY;
+
+  CurrentMode = This->Mode;
+
+  if (!CurrentMode->CursorVisible) {
+    return EFI_SUCCESS;
+  }
+
+  Private = GRAPHICS_CONSOLE_CON_OUT_DEV_FROM_THIS (This);
+  GraphicsOutput = Private->GraphicsOutput;
+
+  //
+  // In this driver, only narrow character was supported.
+  //
+  //
+  // Blt a character to the screen
+  //
+  GlyphX = (CurrentMode->CursorColumn * EFI_GLYPH_WIDTH) + Private->ModeData[CurrentMode->Mode].DeltaX;
+  GlyphY = (CurrentMode->CursorRow * EFI_GLYPH_HEIGHT) + Private->ModeData[CurrentMode->Mode].DeltaY;
+
+  GraphicsOutput->Blt (
+                    GraphicsOutput,
+                    (EFI_GRAPHICS_OUTPUT_BLT_PIXEL*)BltChar,
+                    EfiBltVideoToBltBuffer,
+                    GlyphX,
+                    GlyphY,
+                    0,
+                    0,
+                    EFI_GLYPH_WIDTH,
+                    EFI_GLYPH_HEIGHT,
+                    EFI_GLYPH_WIDTH * sizeof (EFI_GRAPHICS_OUTPUT_BLT_PIXEL)
+                  );
+
+  GetTextColors (This, &Foreground.Pixel, &Background.Pixel);
+
+  //
+  // Convert Monochrome bitmap of the Glyph to BltBuffer structure
+  //
+  for (PosY = 0; PosY < EFI_GLYPH_HEIGHT; PosY++) {
+    for (PosX = 0; PosX < EFI_GLYPH_WIDTH; PosX++) {
+      if ((mCursorGlyph.GlyphCol1[PosY] & (BIT0 << PosX)) != 0) {
+        BltChar[PosY][EFI_GLYPH_WIDTH - PosX - 1].Raw ^= Foreground.Raw;
+      }
+    }
+  }
+
+  GraphicsOutput->Blt (
+                    GraphicsOutput,
+                    (EFI_GRAPHICS_OUTPUT_BLT_PIXEL*)BltChar,
+                    EfiBltBufferToVideo,
+                    0,
+                    0,
+                    GlyphX,
+                    GlyphY,
+                    EFI_GLYPH_WIDTH,
+                    EFI_GLYPH_HEIGHT,
+                    EFI_GLYPH_WIDTH * sizeof (EFI_GRAPHICS_OUTPUT_BLT_PIXEL)
+                  );
+
+  return EFI_SUCCESS;
+}
+
+/**
+  HII Database Protocol notification event handler.
+
+  Register font package when HII Database Protocol has been installed.
+
+  @param[in] Event    Event whose notification function is being invoked.
+  @param[in] Context  Pointer to the notification function's context.
+**/
+VOID
+EFIAPI
+RegisterFontPackage (
+  IN  EFI_EVENT       Event,
+  IN  VOID            *Context
+  )
+{
+  EFI_STATUS                           Status;
+  EFI_HII_SIMPLE_FONT_PACKAGE_HDR      *SimplifiedFont;
+  UINT32                               PackageLength;
+  UINT8                                *Package;
+  UINT8                                *Location;
+  EFI_HII_DATABASE_PROTOCOL            *HiiDatabase;
+
+  //
+  // Locate HII Database Protocol
+  //
+  Status = gBS->LocateProtocol (
+                  &gEfiHiiDatabaseProtocolGuid,
+                  NULL,
+                  (VOID**)&HiiDatabase
+                );
+  if (EFI_ERROR (Status)) {
+    return;
+  }
+
+  //
+  // Add 4 bytes to the header for entire length for HiiAddPackages use only.
+  //
+  //    +--------------------------------+ <-- Package
+  //    |                                |
+  //    |    PackageLength(4 bytes)      |
+  //    |                                |
+  //    |--------------------------------| <-- SimplifiedFont
+  //    |                                |
+  //    |EFI_HII_SIMPLE_FONT_PACKAGE_HDR |
+  //    |                                |
+  //    |--------------------------------| <-- Location
+  //    |                                |
+  //    |     gUsStdNarrowGlyphData      |
+  //    |                                |
+  //    +--------------------------------+
+
+  PackageLength = sizeof (EFI_HII_SIMPLE_FONT_PACKAGE_HDR) + mNarrowFontSize + 4;
+  Package = AllocateZeroPool (PackageLength);
+  ASSERT (Package != NULL);
+
+  WriteUnaligned32 ((UINT32*)Package, PackageLength);
+  SimplifiedFont = (EFI_HII_SIMPLE_FONT_PACKAGE_HDR*)(Package + 4);
+  SimplifiedFont->Header.Length = (UINT32)(PackageLength - 4);
+  SimplifiedFont->Header.Type = EFI_HII_PACKAGE_SIMPLE_FONTS;
+  SimplifiedFont->NumberOfNarrowGlyphs = (UINT16)(mNarrowFontSize / sizeof (EFI_NARROW_GLYPH));
+
+  Location = (UINT8*)(&SimplifiedFont->NumberOfWideGlyphs + 1);
+  CopyMem (Location, gUsStdNarrowGlyphData, mNarrowFontSize);
+
+  //
+  // Add this simplified font package to a package list then install it.
+  //
+  mHiiHandle = HiiAddPackages (
+                 &mFontPackageListGuid,
+                 NULL,
+                 Package,
+                 NULL
+               );
+  ASSERT (mHiiHandle != NULL);
+  FreePool (Package);
+}
+
+/**
+  The user Entry Point for module GraphicsConsole. The user code starts with this function.
+
+  @param[in] ImageHandle    The firmware allocated handle for the EFI image.
+  @param[in] SystemTable    A pointer to the EFI System Table.
+
+  @retval  EFI_SUCCESS       The entry point is executed successfully.
+  @return  other             Some error occurs when executing this entry point.
+
+**/
+EFI_STATUS
+EFIAPI
+InitializeGraphicsConsole (
+  IN EFI_HANDLE           ImageHandle,
+  IN EFI_SYSTEM_TABLE     *SystemTable
+  )
+{
+  EFI_STATUS              Status;
+
+  //
+  // Register notify function on HII Database Protocol to add font package.
+  //
+  EfiCreateProtocolNotifyEvent (
+    &gEfiHiiDatabaseProtocolGuid,
+    TPL_CALLBACK,
+    RegisterFontPackage,
+    NULL,
+    &mHiiRegistration
+  );
+
+  //
+  // Install driver model protocol(s).
+  //
+  Status = EfiLibInstallDriverBindingComponentName2 (
+             ImageHandle,
+             SystemTable,
+             &gGraphicsConsoleDriverBinding,
+             ImageHandle,
+             &gGraphicsConsoleComponentName,
+             &gGraphicsConsoleComponentName2
+           );
+  ASSERT_EFI_ERROR (Status);
+
+  return Status;
+}
diff --git a/Platform/RaspberryPi/RPi3/Drivers/GraphicsConsoleDxe/GraphicsConsole.h b/Platform/RaspberryPi/RPi3/Drivers/GraphicsConsoleDxe/GraphicsConsole.h
new file mode 100644
index 000000000000..ba93cab86bf3
--- /dev/null
+++ b/Platform/RaspberryPi/RPi3/Drivers/GraphicsConsoleDxe/GraphicsConsole.h
@@ -0,0 +1,591 @@
+/** @file
+ *
+ *  Copyright (c) 2018, Andrei Warkentin <andrey.warkentin@gmail.com>
+ *  Copyright (c) 2006-2016, Intel Corporation. All rights reserved.
+ *
+ *  This program and the accompanying materials
+ *  are licensed and made available under the terms and conditions of the BSD License
+ *  which accompanies this distribution.  The full text of the license may be found at
+ *  http://opensource.org/licenses/bsd-license.php
+ *
+ *  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+ *  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+ *
+ **/
+
+#ifndef _GRAPHICS_CONSOLE_H_
+#define _GRAPHICS_CONSOLE_H_
+
+#include <Uefi.h>
+#include <Protocol/ExtendedTextOut.h>
+#include <Protocol/DevicePath.h>
+#include <Protocol/HiiFont.h>
+#include <Protocol/HiiDatabase.h>
+#include <Library/DebugLib.h>
+#include <Library/UefiDriverEntryPoint.h>
+#include <Library/UefiLib.h>
+#include <Library/BaseMemoryLib.h>
+#include <Library/MemoryAllocationLib.h>
+#include <Library/UefiBootServicesTableLib.h>
+#include <Library/HiiLib.h>
+#include <Library/BaseLib.h>
+#include <Library/PcdLib.h>
+#include <Guid/MdeModuleHii.h>
+
+extern EFI_COMPONENT_NAME_PROTOCOL   gGraphicsConsoleComponentName;
+extern EFI_COMPONENT_NAME2_PROTOCOL  gGraphicsConsoleComponentName2;
+extern EFI_DRIVER_BINDING_PROTOCOL   gGraphicsConsoleDriverBinding;
+extern EFI_NARROW_GLYPH              gUsStdNarrowGlyphData[];
+
+extern UINT32 mNarrowFontSize;
+
+typedef union {
+  EFI_NARROW_GLYPH  NarrowGlyph;
+  EFI_WIDE_GLYPH    WideGlyph;
+} GLYPH_UNION;
+
+//
+// Device Structure
+//
+#define GRAPHICS_CONSOLE_DEV_SIGNATURE  SIGNATURE_32 ('g', 's', 't', 'o')
+
+typedef struct {
+  UINTN   Columns;
+  UINTN   Rows;
+  INTN    DeltaX;
+  INTN    DeltaY;
+  UINT32  GopWidth;
+  UINT32  GopHeight;
+  UINT32  GopModeNumber;
+} GRAPHICS_CONSOLE_MODE_DATA;
+
+typedef struct {
+  UINTN                            Signature;
+  EFI_GRAPHICS_OUTPUT_PROTOCOL     *GraphicsOutput;
+  EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL  SimpleTextOutput;
+  EFI_SIMPLE_TEXT_OUTPUT_MODE      SimpleTextOutputMode;
+  GRAPHICS_CONSOLE_MODE_DATA       *ModeData;
+  EFI_GRAPHICS_OUTPUT_BLT_PIXEL    *LineBuffer;
+  EXTENDED_TEXT_OUTPUT_PROTOCOL    ExtendedTextOutput;
+} GRAPHICS_CONSOLE_DEV;
+
+#define GRAPHICS_CONSOLE_CON_OUT_DEV_FROM_THIS(a) \
+  CR (a, GRAPHICS_CONSOLE_DEV, SimpleTextOutput, GRAPHICS_CONSOLE_DEV_SIGNATURE)
+
+
+//
+// EFI Component Name Functions
+//
+/**
+  Retrieves a Unicode string that is the user readable name of the driver.
+
+  This function retrieves the user readable name of a driver in the form of a
+  Unicode string. If the driver specified by This has a user readable name in
+  the language specified by Language, then a pointer to the driver name is
+  returned in DriverName, and EFI_SUCCESS is returned. If the driver specified
+  by This does not support the language specified by Language,
+  then EFI_UNSUPPORTED is returned.
+
+  @param  This[in]              A pointer to the EFI_COMPONENT_NAME2_PROTOCOL or
+                                EFI_COMPONENT_NAME_PROTOCOL instance.
+
+  @param  Language[in]          A pointer to a Null-terminated ASCII string
+                                array indicating the language. This is the
+                                language of the driver name that the caller is
+                                requesting, and it must match one of the
+                                languages specified in SupportedLanguages. The
+                                number of languages supported by a driver is up
+                                to the driver writer. Language is specified
+                                in RFC 4646 or ISO 639-2 language code format.
+
+  @param  DriverName[out]       A pointer to the Unicode string to return.
+                                This Unicode string is the name of the
+                                driver specified by This in the language
+                                specified by Language.
+
+  @retval EFI_SUCCESS           The Unicode string for the Driver specified by
+                                This and the language specified by Language was
+                                returned in DriverName.
+
+  @retval EFI_INVALID_PARAMETER Language is NULL.
+
+  @retval EFI_INVALID_PARAMETER DriverName is NULL.
+
+  @retval EFI_UNSUPPORTED       The driver specified by This does not support
+                                the language specified by Language.
+
+**/
+EFI_STATUS
+EFIAPI
+GraphicsConsoleComponentNameGetDriverName (
+  IN  EFI_COMPONENT_NAME_PROTOCOL  *This,
+  IN  CHAR8                        *Language,
+  OUT CHAR16                       **DriverName
+  );
+
+
+/**
+  Retrieves a Unicode string that is the user readable name of the controller
+  that is being managed by a driver.
+
+  This function retrieves the user readable name of the controller specified by
+  ControllerHandle and ChildHandle in the form of a Unicode string. If the
+  driver specified by This has a user readable name in the language specified by
+  Language, then a pointer to the controller name is returned in ControllerName,
+  and EFI_SUCCESS is returned.  If the driver specified by This is not currently
+  managing the controller specified by ControllerHandle and ChildHandle,
+  then EFI_UNSUPPORTED is returned.  If the driver specified by This does not
+  support the language specified by Language, then EFI_UNSUPPORTED is returned.
+
+  @param  This[in]              A pointer to the EFI_COMPONENT_NAME2_PROTOCOL or
+                                EFI_COMPONENT_NAME_PROTOCOL instance.
+
+  @param  ControllerHandle[in]  The handle of a controller that the driver
+                                specified by This is managing.  This handle
+                                specifies the controller whose name is to be
+                                returned.
+
+  @param  ChildHandle[in]       The handle of the child controller to retrieve
+                                the name of.  This is an optional parameter that
+                                may be NULL.  It will be NULL for device
+                                drivers.  It will also be NULL for a bus drivers
+                                that wish to retrieve the name of the bus
+                                controller.  It will not be NULL for a bus
+                                driver that wishes to retrieve the name of a
+                                child controller.
+
+  @param  Language[in]          A pointer to a Null-terminated ASCII string
+                                array indicating the language.  This is the
+                                language of the driver name that the caller is
+                                requesting, and it must match one of the
+                                languages specified in SupportedLanguages. The
+                                number of languages supported by a driver is up
+                                to the driver writer. Language is specified in
+                                RFC 4646 or ISO 639-2 language code format.
+
+  @param  ControllerName[out]   A pointer to the Unicode string to return.
+                                This Unicode string is the name of the
+                                controller specified by ControllerHandle and
+                                ChildHandle in the language specified by
+                                Language from the point of view of the driver
+                                specified by This.
+
+  @retval EFI_SUCCESS           The Unicode string for the user readable name in
+                                the language specified by Language for the
+                                driver specified by This was returned in
+                                DriverName.
+
+  @retval EFI_INVALID_PARAMETER ControllerHandle is NULL.
+
+  @retval EFI_INVALID_PARAMETER ChildHandle is not NULL and it is not a valid
+                                EFI_HANDLE.
+
+  @retval EFI_INVALID_PARAMETER Language is NULL.
+
+  @retval EFI_INVALID_PARAMETER ControllerName is NULL.
+
+  @retval EFI_UNSUPPORTED       The driver specified by This is not currently
+                                managing the controller specified by
+                                ControllerHandle and ChildHandle.
+
+  @retval EFI_UNSUPPORTED       The driver specified by This does not support
+                                the language specified by Language.
+
+**/
+EFI_STATUS
+EFIAPI
+GraphicsConsoleComponentNameGetControllerName (
+  IN  EFI_COMPONENT_NAME_PROTOCOL                     *This,
+  IN  EFI_HANDLE                                      ControllerHandle,
+  IN  EFI_HANDLE                                      ChildHandle        OPTIONAL,
+  IN  CHAR8                                           *Language,
+  OUT CHAR16                                          **ControllerName
+  );
+
+
+/**
+  Reset the text output device hardware and optionally run diagnostics.
+
+  Implements SIMPLE_TEXT_OUTPUT.Reset().
+  If ExtendeVerification is TRUE, then perform dependent Graphics Console
+  device reset, and set display mode to mode 0.
+  If ExtendedVerification is FALSE, only set display mode to mode 0.
+
+  @param  This                  Protocol instance pointer.
+  @param  ExtendedVerification  Indicates that the driver may perform a more
+                                exhaustive verification operation of the device
+                                during reset.
+
+  @retval EFI_SUCCESS          The text output device was reset.
+  @retval EFI_DEVICE_ERROR     The text output device is not functioning correctly and
+                               could not be reset.
+
+**/
+EFI_STATUS
+EFIAPI
+GraphicsConsoleConOutReset (
+  IN  EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL    *This,
+  IN  BOOLEAN                            ExtendedVerification
+  );
+
+/**
+  Write a Unicode string to the output device.
+
+  Implements SIMPLE_TEXT_OUTPUT.OutputString().
+  The Unicode string will be converted to Glyphs and will be
+  sent to the Graphics Console.
+
+  @param  This                    Protocol instance pointer.
+  @param  WString                 The NULL-terminated Unicode string to be displayed
+                                  on the output device(s). All output devices must
+                                  also support the Unicode drawing defined in this file.
+
+  @retval EFI_SUCCESS             The string was output to the device.
+  @retval EFI_DEVICE_ERROR        The device reported an error while attempting to output
+                                  the text.
+  @retval EFI_UNSUPPORTED         The output device's mode is not currently in a
+                                  defined text mode.
+  @retval EFI_WARN_UNKNOWN_GLYPH  This warning code indicates that some of the
+                                  characters in the Unicode string could not be
+                                  rendered and were skipped.
+
+**/
+EFI_STATUS
+EFIAPI
+GraphicsConsoleConOutOutputString (
+  IN  EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL  *This,
+  IN  CHAR16                           *WString
+  );
+
+/**
+  Verifies that all characters in a Unicode string can be output to the
+  target device.
+
+  Implements SIMPLE_TEXT_OUTPUT.TestString().
+  If one of the characters in the *Wstring is neither valid valid Unicode
+  drawing characters, not ASCII code, then this function will return
+  EFI_UNSUPPORTED
+
+  @param  This    Protocol instance pointer.
+  @param  WString The NULL-terminated Unicode string to be examined for the output
+                  device(s).
+
+  @retval EFI_SUCCESS      The device(s) are capable of rendering the output string.
+  @retval EFI_UNSUPPORTED  Some of the characters in the Unicode string cannot be
+                           rendered by one or more of the output devices mapped
+                           by the EFI handle.
+
+**/
+EFI_STATUS
+EFIAPI
+GraphicsConsoleConOutTestString (
+  IN  EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL  *This,
+  IN  CHAR16                           *WString
+  );
+
+/**
+  Returns information for an available text mode that the output device(s)
+  supports
+
+  Implements SIMPLE_TEXT_OUTPUT.QueryMode().
+  It returnes information for an available text mode that the Graphics Console supports.
+  In this driver,we only support text mode 80x25, which is defined as mode 0.
+
+  @param  This                  Protocol instance pointer.
+  @param  ModeNumber            The mode number to return information on.
+  @param  Columns               The returned columns of the requested mode.
+  @param  Rows                  The returned rows of the requested mode.
+
+  @retval EFI_SUCCESS           The requested mode information is returned.
+  @retval EFI_UNSUPPORTED       The mode number is not valid.
+
+**/
+EFI_STATUS
+EFIAPI
+GraphicsConsoleConOutQueryMode (
+  IN  EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL  *This,
+  IN  UINTN                            ModeNumber,
+  OUT UINTN                            *Columns,
+  OUT UINTN                            *Rows
+  );
+
+
+/**
+  Sets the output device(s) to a specified mode.
+
+  Implements SIMPLE_TEXT_OUTPUT.SetMode().
+  Set the Graphics Console to a specified mode. In this driver, we only support mode 0.
+
+  @param  This                  Protocol instance pointer.
+  @param  ModeNumber            The text mode to set.
+
+  @retval EFI_SUCCESS           The requested text mode is set.
+  @retval EFI_DEVICE_ERROR      The requested text mode cannot be set because of
+                                Graphics Console device error.
+  @retval EFI_UNSUPPORTED       The text mode number is not valid.
+
+**/
+EFI_STATUS
+EFIAPI
+GraphicsConsoleConOutSetMode (
+  IN  EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL  *This,
+  IN  UINTN                            ModeNumber
+  );
+
+/**
+  Sets the background and foreground colors for the OutputString () and
+  ClearScreen () functions.
+
+  Implements SIMPLE_TEXT_OUTPUT.SetAttribute().
+
+  @param  This                  Protocol instance pointer.
+  @param  Attribute             The attribute to set. Bits 0..3 are the foreground
+                                color, and bits 4..6 are the background color.
+                                All other bits are undefined and must be zero.
+
+  @retval EFI_SUCCESS           The requested attribute is set.
+  @retval EFI_DEVICE_ERROR      The requested attribute cannot be set due to Graphics Console port error.
+  @retval EFI_UNSUPPORTED       The attribute requested is not defined.
+
+**/
+EFI_STATUS
+EFIAPI
+GraphicsConsoleConOutSetAttribute (
+  IN  EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL  *This,
+  IN  UINTN                            Attribute
+  );
+
+/**
+  Clears the output device(s) display to the currently selected background
+  color.
+
+  Implements SIMPLE_TEXT_OUTPUT.ClearScreen().
+
+  @param  This                  Protocol instance pointer.
+
+  @retval  EFI_SUCCESS      The operation completed successfully.
+  @retval  EFI_DEVICE_ERROR The device had an error and could not complete the request.
+  @retval  EFI_UNSUPPORTED  The output device is not in a valid text mode.
+
+**/
+EFI_STATUS
+EFIAPI
+GraphicsConsoleConOutClearScreen (
+  IN  EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL  *This
+  );
+
+/**
+  Sets the current coordinates of the cursor position.
+
+  Implements SIMPLE_TEXT_OUTPUT.SetCursorPosition().
+
+  @param  This        Protocol instance pointer.
+  @param  Column      The position to set the cursor to. Must be greater than or
+                      equal to zero and less than the number of columns and rows
+                      by QueryMode ().
+  @param  Row         The position to set the cursor to. Must be greater than or
+                      equal to zero and less than the number of columns and rows
+                      by QueryMode ().
+
+  @retval EFI_SUCCESS      The operation completed successfully.
+  @retval EFI_DEVICE_ERROR The device had an error and could not complete the request.
+  @retval EFI_UNSUPPORTED  The output device is not in a valid text mode, or the
+                           cursor position is invalid for the current mode.
+
+**/
+EFI_STATUS
+EFIAPI
+GraphicsConsoleConOutSetCursorPosition (
+  IN  EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL  *This,
+  IN  UINTN                            Column,
+  IN  UINTN                            Row
+  );
+
+
+/**
+  Makes the cursor visible or invisible.
+
+  Implements SIMPLE_TEXT_OUTPUT.EnableCursor().
+
+  @param  This                  Protocol instance pointer.
+  @param  Visible               If TRUE, the cursor is set to be visible, If FALSE,
+                                the cursor is set to be invisible.
+
+  @retval EFI_SUCCESS           The operation completed successfully.
+
+**/
+EFI_STATUS
+EFIAPI
+GraphicsConsoleConOutEnableCursor (
+  IN  EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL  *This,
+  IN  BOOLEAN                          Visible
+  );
+
+/**
+  Test to see if Graphics Console could be supported on the Controller.
+
+  Graphics Console could be supported if Graphics Output Protocol exists
+  on the Controller.
+
+  @param  This                Protocol instance pointer.
+  @param  Controller          Handle of device to test.
+  @param  RemainingDevicePath Optional parameter use to pick a specific child
+                              device to start.
+
+  @retval EFI_SUCCESS         This driver supports this device.
+  @retval other               This driver does not support this device.
+
+**/
+EFI_STATUS
+EFIAPI
+GraphicsConsoleControllerDriverSupported (
+  IN EFI_DRIVER_BINDING_PROTOCOL    *This,
+  IN EFI_HANDLE                     Controller,
+  IN EFI_DEVICE_PATH_PROTOCOL       *RemainingDevicePath
+  );
+
+
+/**
+  Start this driver on Controller by opening the Graphics Output Protocol,
+  and installing Simple Text Out protocol on Controller.
+
+  @param  This                 Protocol instance pointer.
+  @param  Controller           Handle of device to bind driver to
+  @param  RemainingDevicePath  Optional parameter use to pick a specific child
+                               device to start.
+
+  @retval EFI_SUCCESS          This driver is added to Controller.
+  @retval other                This driver does not support this device.
+
+**/
+EFI_STATUS
+EFIAPI
+GraphicsConsoleControllerDriverStart (
+  IN EFI_DRIVER_BINDING_PROTOCOL    *This,
+  IN EFI_HANDLE                     Controller,
+  IN EFI_DEVICE_PATH_PROTOCOL       *RemainingDevicePath
+  );
+
+/**
+  Stop this driver on Controller by removing Simple Text Out protocol
+  and closing the Graphics Output Protocol on Controller.
+
+  @param  This              Protocol instance pointer.
+  @param  Controller        Handle of device to stop driver on
+  @param  NumberOfChildren  Number of Handles in ChildHandleBuffer. If number of
+                            children is zero stop the entire bus driver.
+  @param  ChildHandleBuffer List of Child Handles to Stop.
+
+  @retval EFI_SUCCESS       This driver is removed Controller.
+  @retval EFI_NOT_STARTED   Simple Text Out protocol could not be found the
+                            Controller.
+  @retval other             This driver was not removed from this device.
+
+**/
+EFI_STATUS
+EFIAPI
+GraphicsConsoleControllerDriverStop (
+  IN  EFI_DRIVER_BINDING_PROTOCOL    *This,
+  IN  EFI_HANDLE                     Controller,
+  IN  UINTN                          NumberOfChildren,
+  IN  EFI_HANDLE                     *ChildHandleBuffer
+  );
+
+
+/**
+  Locate HII Database protocol and HII Font protocol.
+
+  @retval  EFI_SUCCESS     HII Database protocol and HII Font protocol
+                           are located successfully.
+  @return  other           Failed to locate HII Database protocol or
+                           HII Font protocol.
+
+**/
+EFI_STATUS
+EfiLocateHiiProtocol (
+  VOID
+  );
+
+
+/**
+  Gets Graphics Console devcie's foreground color and background color.
+
+  @param  This                  Protocol instance pointer.
+  @param  Foreground            Returned text foreground color.
+  @param  Background            Returned text background color.
+
+  @retval EFI_SUCCESS           It returned always.
+
+**/
+EFI_STATUS
+GetTextColors (
+  IN  EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL  *This,
+  OUT EFI_GRAPHICS_OUTPUT_BLT_PIXEL    *Foreground,
+  OUT EFI_GRAPHICS_OUTPUT_BLT_PIXEL    *Background
+  );
+
+/**
+  Draw Unicode string on the Graphics Console device's screen.
+
+  @param  This                  Protocol instance pointer.
+  @param  UnicodeWeight         One Unicode string to be displayed.
+  @param  Count                 The count of Unicode string.
+
+  @retval EFI_OUT_OF_RESOURCES  If no memory resource to use.
+  @retval EFI_UNSUPPORTED       If no Graphics Output Protocol exists.
+  @retval EFI_SUCCESS           Drawing Unicode string implemented successfully.
+
+**/
+EFI_STATUS
+DrawUnicodeWeightAtCursorN (
+  IN  EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL  *This,
+  IN  CHAR16                           *UnicodeWeight,
+  IN  UINTN                            Count
+  );
+
+/**
+  Flush the cursor on the screen.
+
+  If CursorVisible is FALSE, nothing to do and return directly.
+  If CursorVisible is TRUE,
+     i) If the cursor shows on screen, it will be erased.
+    ii) If the cursor does not show on screen, it will be shown.
+
+  @param  This                  Protocol instance pointer.
+
+  @retval EFI_SUCCESS           The cursor is erased successfully.
+
+**/
+EFI_STATUS
+FlushCursor (
+  IN  EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL  *This
+  );
+
+/**
+  Check if the current specific mode supported the user defined resolution
+  for the Graphics Console device based on Graphics Output Protocol.
+
+  If yes, set the graphic device's current mode to this specific mode.
+
+  @param  GraphicsOutput        Graphics Output Protocol instance pointer.
+  @param  HorizontalResolution  User defined horizontal resolution
+  @param  VerticalResolution    User defined vertical resolution.
+  @param  CurrentModeNumber     Current specific mode to be check.
+
+  @retval EFI_SUCCESS       The mode is supported.
+  @retval EFI_UNSUPPORTED   The specific mode is out of range of graphics
+                            device supported.
+  @retval other             The specific mode does not support user defined
+                            resolution or failed to set the current mode to the
+                            specific mode on graphics device.
+
+**/
+EFI_STATUS
+CheckModeSupported (
+  EFI_GRAPHICS_OUTPUT_PROTOCOL  *GraphicsOutput,
+  IN  UINT32  HorizontalResolution,
+  IN  UINT32  VerticalResolution,
+  OUT UINT32  *CurrentModeNumber
+  );
+
+#endif
diff --git a/Platform/RaspberryPi/RPi3/Drivers/GraphicsConsoleDxe/GraphicsConsoleDxe.inf b/Platform/RaspberryPi/RPi3/Drivers/GraphicsConsoleDxe/GraphicsConsoleDxe.inf
new file mode 100644
index 000000000000..11c1a3ae0e5c
--- /dev/null
+++ b/Platform/RaspberryPi/RPi3/Drivers/GraphicsConsoleDxe/GraphicsConsoleDxe.inf
@@ -0,0 +1,75 @@
+#/** @file
+#
+#  Copyright (c) 2006-2014, Intel Corporation. All rights reserved.
+#  Copyright (c) 2018, Andrei Warkentin <andrey.warkentin@gmail.com>
+#
+#  This program and the accompanying materials are licensed and made available
+#  under the terms and conditions of the BSD License which accompanies this
+#  distribution. The full text of the license may be found at
+#  http://opensource.org/licenses/bsd-license.php
+#
+#  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+#  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR
+#  IMPLIED.
+#
+#**/
+
+[Defines]
+  INF_VERSION                    = 0x0001001A
+  BASE_NAME                      = GraphicsConsoleDxe
+  MODULE_UNI_FILE                = GraphicsConsoleDxe.uni
+  FILE_GUID                      = CCCB0C28-4B24-11d5-9A5A-0090273FC14D
+  MODULE_TYPE                    = UEFI_DRIVER
+  VERSION_STRING                 = 1.1
+  ENTRY_POINT                    = InitializeGraphicsConsole
+
+#
+# The following information is for reference only and not required by the build tools.
+#
+#  VALID_ARCHITECTURES           = IA32 X64 IPF EBC AARCH64
+#
+#  DRIVER_BINDING                =  gGraphicsConsoleDriverBinding
+#  COMPONENT_NAME                =  gGraphicsConsoleComponentName
+#  COMPONENT_NAME2               =  gGraphicsConsoleComponentName2
+#
+
+[Sources]
+  ComponentName.c
+  NewFont.c
+  GraphicsConsole.c
+  GraphicsConsole.h
+
+[Packages]
+  MdePkg/MdePkg.dec
+  MdeModulePkg/MdeModulePkg.dec
+  Silicon/Broadcom/Bcm283x/Bcm283x.dec
+  Platform/RaspberryPi/RPi3/RPi3.dec
+
+[LibraryClasses]
+  UefiBootServicesTableLib
+  UefiRuntimeServicesTableLib
+  MemoryAllocationLib
+  BmpSupportLib
+  BaseMemoryLib
+  UefiLib
+  UefiDriverEntryPoint
+  DebugLib
+  HiiLib
+  PcdLib
+
+[Protocols]
+  gEfiDevicePathProtocolGuid
+  gEfiSimpleTextOutProtocolGuid
+  gEfiGraphicsOutputProtocolGuid
+  gEfiHiiFontProtocolGuid
+  gEfiHiiDatabaseProtocolGuid
+  gExtendedTextOutputProtocolGuid
+
+[FeaturePcd]
+
+[Pcd]
+  gEfiMdeModulePkgTokenSpaceGuid.PcdVideoHorizontalResolution ## SOMETIMES_CONSUMES
+  gEfiMdeModulePkgTokenSpaceGuid.PcdVideoVerticalResolution   ## SOMETIMES_CONSUMES
+
+[UserExtensions.TianoCore."ExtraFiles"]
+  GraphicsConsoleDxeExtra.uni
diff --git a/Platform/RaspberryPi/RPi3/Drivers/GraphicsConsoleDxe/GraphicsConsoleDxe.uni b/Platform/RaspberryPi/RPi3/Drivers/GraphicsConsoleDxe/GraphicsConsoleDxe.uni
new file mode 100644
index 000000000000..0957c5795f59
--- /dev/null
+++ b/Platform/RaspberryPi/RPi3/Drivers/GraphicsConsoleDxe/GraphicsConsoleDxe.uni
@@ -0,0 +1,18 @@
+/** @file
+ *
+ *  Copyright (c) 2006-2014, Intel Corporation. All rights reserved.
+ *  Copyright (c) 2018, Andrei Warkentin <andrey.warkentin@gmail.com>
+ *
+ *  This program and the accompanying materials
+ *  are licensed and made available under the terms and conditions of the BSD License
+ *  which accompanies this distribution.  The full text of the license may be found at
+ *  http://opensource.org/licenses/bsd-license.php
+ *
+ *  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+ *  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+ *
+ **/
+
+#string STR_MODULE_ABSTRACT             #language en-US "Console support on graphic devices"
+
+#string STR_MODULE_DESCRIPTION          #language en-US "Install SimpleTextOutputProtocol on GraphicsOutputProtocol devices\n"
diff --git a/Platform/RaspberryPi/RPi3/Drivers/GraphicsConsoleDxe/GraphicsConsoleDxeExtra.uni b/Platform/RaspberryPi/RPi3/Drivers/GraphicsConsoleDxe/GraphicsConsoleDxeExtra.uni
new file mode 100644
index 000000000000..9aa9af4de6c7
--- /dev/null
+++ b/Platform/RaspberryPi/RPi3/Drivers/GraphicsConsoleDxe/GraphicsConsoleDxeExtra.uni
@@ -0,0 +1,18 @@
+/** @file
+ *
+ *  Copyright (c) 2006-2014, Intel Corporation. All rights reserved.
+ *  Copyright (c) 2018, Andrei Warkentin <andrey.warkentin@gmail.com>
+ *
+ *  This program and the accompanying materials
+ *  are licensed and made available under the terms and conditions of the BSD License
+ *  which accompanies this distribution.  The full text of the license may be found at
+ *  http://opensource.org/licenses/bsd-license.php
+ *
+ *  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+ *  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+ *
+ **/
+
+#string STR_PROPERTIES_MODULE_NAME
+#language en-US
+"Graphics Console DXE Driver"
diff --git a/Platform/RaspberryPi/RPi3/Drivers/GraphicsConsoleDxe/NewFont.c b/Platform/RaspberryPi/RPi3/Drivers/GraphicsConsoleDxe/NewFont.c
new file mode 100644
index 000000000000..c4840a66378f
--- /dev/null
+++ b/Platform/RaspberryPi/RPi3/Drivers/GraphicsConsoleDxe/NewFont.c
@@ -0,0 +1,287 @@
+/** @file
+ *
+ *  Copyright (c) 2018, Andrei Warkentin <andrey.warkentin@gmail.com>
+ *
+ *  This program and the accompanying materials
+ *  are licensed and made available under the terms and conditions of the BSD License
+ *  which accompanies this distribution.  The full text of the license may be found at
+ *  http://opensource.org/licenses/bsd-license.php
+ *
+ *  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+ *  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+ *
+ **/
+
+/*
+ * Based on ftp://www.unicode.org/Public/MAPPINGS/VENDORS/MICSFT/PC/CP437.TXT and
+ * https://en.wikipedia.org/wiki/Code_page_437 for the cp437 Unicode equivalents
+ * and the cp437 8x19 font from that_editor.
+ *
+ * https://github.com/bisqwit/that_editor/blob/master/8x19.inc
+ * https://github.com/bisqwit/that_editor/blob/master/sourcematerial/vga8x19.bdf
+ * https://github.com/stsp/dosemu2/blob/master/COPYING.DOSEMU
+ */
+
+#include "GraphicsConsole.h"
+
+EFI_NARROW_GLYPH  gUsStdNarrowGlyphData[] = {
+  { 0x263a, 0x00, {0x00, 0x00, 0x7E, 0x81, 0xA5, 0xA5, 0x81, 0x81, 0xA5, 0xA5, 0x99, 0x81, 0x81, 0x7E, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x263b, 0x00, {0x00, 0x00, 0x7E, 0xFF, 0xDB, 0xFF, 0xFF, 0xFF, 0xDB, 0xE7, 0xFF, 0xFF, 0xFF, 0x7E, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x2665, 0x00, {0x00, 0x00, 0x00, 0x00, 0x00, 0x6C, 0xFE, 0xFE, 0xFE, 0xFE, 0x7C, 0x38, 0x10, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x2666, 0x00, {0x00, 0x00, 0x00, 0x00, 0x00, 0x10, 0x38, 0x7C, 0xFE, 0xFE, 0x7C, 0x38, 0x10, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x2663, 0x00, {0x00, 0x00, 0x00, 0x18, 0x3C, 0x3C, 0xFF, 0xE7, 0xE7, 0xE7, 0xFF, 0x18, 0x18, 0x3C, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x2660, 0x00, {0x00, 0x00, 0x00, 0x18, 0x3C, 0x7E, 0xFF, 0xFF, 0xFF, 0x7E, 0x7E, 0x18, 0x18, 0x3C, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x2022, 0x00, {0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x18, 0x3C, 0x3C, 0x3C, 0x18, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x25d8, 0x00, {0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xE7, 0xC3, 0xC3, 0xE7, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF}},
+  { 0x25cb, 0x00, {0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x3C, 0x66, 0x66, 0x42, 0x66, 0x66, 0x3C, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x25d9, 0x00, {0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xDB, 0x99, 0xBD, 0xBD, 0x99, 0xDB, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF}},
+  { 0x2642, 0x00, {0x00, 0x00, 0x1E, 0x06, 0x0E, 0x0A, 0x1A, 0x78, 0xCC, 0xCC, 0xCC, 0xCC, 0xCC, 0x78, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x2640, 0x00, {0x00, 0x00, 0x3C, 0x66, 0x66, 0x66, 0x66, 0x66, 0x3C, 0x18, 0x18, 0x7E, 0x18, 0x18, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x266a, 0x00, {0x00, 0x00, 0x3F, 0x33, 0x33, 0x3F, 0x30, 0x30, 0x30, 0x30, 0x30, 0x70, 0xF0, 0xE0, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x266b, 0x00, {0x00, 0x00, 0x7F, 0x63, 0x63, 0x7F, 0x63, 0x63, 0x63, 0x63, 0x63, 0x67, 0xE7, 0xE6, 0xC0, 0x00, 0x00, 0x00, 0x00}},
+  { 0x263c, 0x00, {0x00, 0x00, 0x00, 0x18, 0x18, 0xDB, 0xFF, 0x3C, 0xE7, 0x3C, 0xFF, 0xDB, 0x18, 0x18, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x25ba, 0x00, {0x00, 0x80, 0xC0, 0xE0, 0xF0, 0xF8, 0xFC, 0xFE, 0xFC, 0xF8, 0xF0, 0xE0, 0xC0, 0x80, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x25c4, 0x00, {0x00, 0x02, 0x06, 0x0E, 0x1E, 0x3E, 0x7E, 0xFE, 0x7E, 0x3E, 0x1E, 0x0E, 0x06, 0x02, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x2195, 0x00, {0x00, 0x00, 0x18, 0x3C, 0x7E, 0x18, 0x18, 0x18, 0x18, 0x18, 0x7E, 0x3C, 0x18, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x203c, 0x00, {0x00, 0x00, 0x66, 0x66, 0x66, 0x66, 0x66, 0x66, 0x66, 0x66, 0x66, 0x00, 0x66, 0x66, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x00b6, 0x00, {0x00, 0x00, 0x7F, 0xDB, 0xDB, 0xDB, 0xDB, 0x7B, 0x1B, 0x1B, 0x1B, 0x1B, 0x1B, 0x1B, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x00a7, 0x00, {0x00, 0x00, 0x7C, 0xC6, 0x62, 0x30, 0x78, 0x4C, 0x64, 0x3C, 0x18, 0x8C, 0xC6, 0x7C, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x25ac, 0x00, {0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0xFE, 0xFE, 0xFE, 0xFE, 0xFE, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x21a8, 0x00, {0x00, 0x00, 0x18, 0x3C, 0x7E, 0x18, 0x18, 0x18, 0x18, 0x18, 0x7E, 0x3C, 0x18, 0x7E, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x2191, 0x00, {0x00, 0x00, 0x18, 0x3C, 0x7E, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x2193, 0x00, {0x00, 0x00, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x7E, 0x3C, 0x18, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x2192, 0x00, {0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x18, 0x0C, 0xFE, 0x0C, 0x18, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x2190, 0x00, {0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x30, 0x60, 0xFE, 0x60, 0x30, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x221f, 0x00, {0x00, 0x00, 0x00, 0x00, 0x00, 0xC0, 0xC0, 0xC0, 0xC0, 0xFE, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x2194, 0x00, {0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x28, 0x6C, 0xFE, 0x6C, 0x28, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x25b2, 0x00, {0x00, 0x00, 0x00, 0x00, 0x00, 0x10, 0x38, 0x38, 0x7C, 0x7C, 0xFE, 0xFE, 0xFE, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x25bc, 0x00, {0x00, 0x00, 0x00, 0x00, 0x00, 0xFE, 0xFE, 0xFE, 0x7C, 0x7C, 0x38, 0x38, 0x10, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x0020, 0x00, {0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x0021, 0x00, {0x00, 0x00, 0x18, 0x3C, 0x3C, 0x3C, 0x3C, 0x18, 0x18, 0x18, 0x18, 0x00, 0x18, 0x18, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x0022, 0x00, {0x66, 0x66, 0x66, 0x66, 0x24, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x0023, 0x00, {0x00, 0x00, 0x00, 0x6C, 0x6C, 0x6C, 0xFE, 0x6C, 0x6C, 0x6C, 0xFE, 0x6C, 0x6C, 0x6C, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x0024, 0x00, {0x10, 0x10, 0x7C, 0xD6, 0xD6, 0xD2, 0x70, 0x38, 0x1C, 0x16, 0x96, 0xD6, 0xD6, 0x7C, 0x10, 0x10, 0x00, 0x00, 0x00}},
+  { 0x0025, 0x00, {0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0xC2, 0xC6, 0x0C, 0x18, 0x30, 0x60, 0xC6, 0x86, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x0026, 0x00, {0x00, 0x00, 0x38, 0x6C, 0x6C, 0x6C, 0x38, 0x76, 0xDC, 0xCC, 0xCC, 0xCC, 0xCC, 0x76, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x0027, 0x00, {0x30, 0x30, 0x30, 0x30, 0x60, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x0028, 0x00, {0x00, 0x00, 0x0C, 0x18, 0x30, 0x30, 0x30, 0x30, 0x30, 0x30, 0x30, 0x30, 0x18, 0x0C, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x0029, 0x00, {0x00, 0x00, 0x30, 0x18, 0x0C, 0x0C, 0x0C, 0x0C, 0x0C, 0x0C, 0x0C, 0x0C, 0x18, 0x30, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x002a, 0x00, {0x00, 0x00, 0x00, 0x00, 0x00, 0x66, 0x24, 0x3C, 0xFF, 0x3C, 0x24, 0x66, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x002b, 0x00, {0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x18, 0x18, 0x7E, 0x18, 0x18, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x002c, 0x00, {0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x18, 0x18, 0x18, 0x18, 0x30, 0x00, 0x00, 0x00, 0x00}},
+  { 0x002d, 0x00, {0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0xFE, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x002e, 0x00, {0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x18, 0x18, 0x18, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x002f, 0x00, {0x00, 0x00, 0x00, 0x00, 0x00, 0x02, 0x06, 0x0C, 0x18, 0x30, 0x60, 0xC0, 0x80, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x0030, 0x00, {0x00, 0x00, 0x38, 0x6C, 0xC6, 0xC6, 0xC6, 0xD6, 0xD6, 0xC6, 0xC6, 0xC6, 0x6C, 0x38, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x0031, 0x00, {0x00, 0x00, 0x18, 0x38, 0x78, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x7E, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x0032, 0x00, {0x00, 0x00, 0x7C, 0xC6, 0x06, 0x06, 0x0C, 0x18, 0x30, 0x60, 0xC0, 0xC0, 0xC6, 0xFE, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x0033, 0x00, {0x00, 0x00, 0x7C, 0xC6, 0x06, 0x06, 0x06, 0x3C, 0x06, 0x06, 0x06, 0x06, 0xC6, 0x7C, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x0034, 0x00, {0x00, 0x00, 0x0C, 0x1C, 0x3C, 0x6C, 0xCC, 0xFE, 0x0C, 0x0C, 0x0C, 0x0C, 0x0C, 0x1E, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x0035, 0x00, {0x00, 0x00, 0xFE, 0xC0, 0xC0, 0xC0, 0xC0, 0xFC, 0x06, 0x06, 0x06, 0x06, 0xC6, 0x7C, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x0036, 0x00, {0x00, 0x00, 0x38, 0x60, 0xC0, 0xC0, 0xC0, 0xFC, 0xC6, 0xC6, 0xC6, 0xC6, 0xC6, 0x7C, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x0037, 0x00, {0x00, 0x00, 0xFE, 0xC6, 0x06, 0x06, 0x06, 0x0C, 0x18, 0x30, 0x30, 0x30, 0x30, 0x30, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x0038, 0x00, {0x00, 0x00, 0x7C, 0xC6, 0xC6, 0xC6, 0xC6, 0x7C, 0xC6, 0xC6, 0xC6, 0xC6, 0xC6, 0x7C, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x0039, 0x00, {0x00, 0x00, 0x7C, 0xC6, 0xC6, 0xC6, 0xC6, 0x7E, 0x06, 0x06, 0x06, 0x06, 0x0C, 0x78, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x003a, 0x00, {0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x18, 0x18, 0x00, 0x00, 0x00, 0x18, 0x18, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x003b, 0x00, {0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x18, 0x18, 0x00, 0x00, 0x00, 0x18, 0x18, 0x18, 0x30, 0x00, 0x00, 0x00, 0x00}},
+  { 0x003c, 0x00, {0x00, 0x00, 0x00, 0x06, 0x0C, 0x18, 0x30, 0x60, 0xC0, 0x60, 0x30, 0x18, 0x0C, 0x06, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x003d, 0x00, {0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x7E, 0x00, 0x7E, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x003e, 0x00, {0x00, 0x00, 0x00, 0xC0, 0x60, 0x30, 0x18, 0x0C, 0x06, 0x0C, 0x18, 0x30, 0x60, 0xC0, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x003f, 0x00, {0x00, 0x00, 0x7C, 0xC6, 0x86, 0x06, 0x0C, 0x18, 0x18, 0x18, 0x18, 0x00, 0x18, 0x18, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x0040, 0x00, {0x00, 0x00, 0x00, 0x7C, 0xC6, 0xC6, 0xCE, 0xDE, 0xDE, 0xDE, 0xDE, 0xCC, 0xC0, 0x7C, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x0041, 0x00, {0x00, 0x00, 0x10, 0x38, 0x6C, 0xC6, 0xC6, 0xC6, 0xFE, 0xC6, 0xC6, 0xC6, 0xC6, 0xC6, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x0042, 0x00, {0x00, 0x00, 0xFC, 0x66, 0x66, 0x66, 0x66, 0x7C, 0x66, 0x66, 0x66, 0x66, 0x66, 0xFC, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x0043, 0x00, {0x00, 0x00, 0x3C, 0x66, 0xC2, 0xC0, 0xC0, 0xC0, 0xC0, 0xC0, 0xC0, 0xC2, 0x66, 0x3C, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x0044, 0x00, {0x00, 0x00, 0xF8, 0x6C, 0x66, 0x66, 0x66, 0x66, 0x66, 0x66, 0x66, 0x66, 0x6C, 0xF8, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x0045, 0x00, {0x00, 0x00, 0xFE, 0x66, 0x62, 0x62, 0x68, 0x78, 0x68, 0x60, 0x62, 0x62, 0x66, 0xFE, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x0046, 0x00, {0x00, 0x00, 0xFE, 0x66, 0x62, 0x62, 0x68, 0x78, 0x68, 0x60, 0x60, 0x60, 0x60, 0xF0, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x0047, 0x00, {0x00, 0x00, 0x3C, 0x66, 0xC2, 0xC0, 0xC0, 0xC0, 0xC0, 0xDE, 0xC6, 0xC6, 0x66, 0x3A, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x0048, 0x00, {0x00, 0x00, 0xC6, 0xC6, 0xC6, 0xC6, 0xC6, 0xFE, 0xC6, 0xC6, 0xC6, 0xC6, 0xC6, 0xC6, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x0049, 0x00, {0x00, 0x00, 0x3C, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x3C, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x004a, 0x00, {0x00, 0x00, 0x1E, 0x0C, 0x0C, 0x0C, 0x0C, 0x0C, 0x0C, 0xCC, 0xCC, 0xCC, 0xCC, 0x78, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x004b, 0x00, {0x00, 0x00, 0xE6, 0x66, 0x66, 0x66, 0x6C, 0x78, 0x78, 0x6C, 0x66, 0x66, 0x66, 0xE6, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x004c, 0x00, {0x00, 0x00, 0xF0, 0x60, 0x60, 0x60, 0x60, 0x60, 0x60, 0x60, 0x62, 0x62, 0x66, 0xFE, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x004d, 0x00, {0x00, 0x00, 0xC6, 0xEE, 0xFE, 0xD6, 0xD6, 0xD6, 0xC6, 0xC6, 0xC6, 0xC6, 0xC6, 0xC6, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x004e, 0x00, {0x00, 0x00, 0xC6, 0xE6, 0xF6, 0xDE, 0xCE, 0xC6, 0xC6, 0xC6, 0xC6, 0xC6, 0xC6, 0xC6, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x004f, 0x00, {0x00, 0x00, 0x7C, 0xC6, 0xC6, 0xC6, 0xC6, 0xC6, 0xC6, 0xC6, 0xC6, 0xC6, 0xC6, 0x7C, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x0050, 0x00, {0x00, 0x00, 0xFC, 0x66, 0x66, 0x66, 0x66, 0x7C, 0x60, 0x60, 0x60, 0x60, 0x60, 0xF0, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x0051, 0x00, {0x00, 0x00, 0x7C, 0xC6, 0xC6, 0xC6, 0xC6, 0xC6, 0xC6, 0xC6, 0xC6, 0xD6, 0xDE, 0x7C, 0x0C, 0x0E, 0x00, 0x00, 0x00}},
+  { 0x0052, 0x00, {0x00, 0x00, 0xFC, 0x66, 0x66, 0x66, 0x66, 0x7C, 0x6C, 0x66, 0x66, 0x66, 0x66, 0xE6, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x0053, 0x00, {0x00, 0x00, 0x7C, 0xC6, 0xC6, 0xC2, 0x60, 0x38, 0x0C, 0x06, 0x86, 0xC6, 0xC6, 0x7C, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x0054, 0x00, {0x00, 0x00, 0x7E, 0x7E, 0x5A, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x3C, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x0055, 0x00, {0x00, 0x00, 0xC6, 0xC6, 0xC6, 0xC6, 0xC6, 0xC6, 0xC6, 0xC6, 0xC6, 0xC6, 0xC6, 0x7C, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x0056, 0x00, {0x00, 0x00, 0xC6, 0xC6, 0xC6, 0xC6, 0xC6, 0xC6, 0xC6, 0xC6, 0xC6, 0x6C, 0x38, 0x10, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x0057, 0x00, {0x00, 0x00, 0xC6, 0xC6, 0xC6, 0xC6, 0xC6, 0xC6, 0xD6, 0xD6, 0xD6, 0xFE, 0xEE, 0x6C, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x0058, 0x00, {0x00, 0x00, 0xC6, 0xC6, 0x6C, 0x6C, 0x38, 0x38, 0x38, 0x38, 0x6C, 0x6C, 0xC6, 0xC6, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x0059, 0x00, {0x00, 0x00, 0x66, 0x66, 0x66, 0x66, 0x66, 0x3C, 0x18, 0x18, 0x18, 0x18, 0x18, 0x3C, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x005a, 0x00, {0x00, 0x00, 0xFE, 0xC6, 0x86, 0x86, 0x0C, 0x18, 0x30, 0x60, 0xC2, 0xC2, 0xC6, 0xFE, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x005b, 0x00, {0x00, 0x00, 0x3C, 0x30, 0x30, 0x30, 0x30, 0x30, 0x30, 0x30, 0x30, 0x30, 0x30, 0x3C, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x005c, 0x00, {0x00, 0x00, 0x00, 0x00, 0x00, 0x80, 0xC0, 0x60, 0x30, 0x18, 0x0C, 0x06, 0x02, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x005d, 0x00, {0x00, 0x00, 0x3C, 0x0C, 0x0C, 0x0C, 0x0C, 0x0C, 0x0C, 0x0C, 0x0C, 0x0C, 0x0C, 0x3C, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x005e, 0x00, {0x00, 0x10, 0x38, 0x6C, 0xC6, 0x82, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x005f, 0x00, {0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0xFF, 0x00, 0x00, 0x00}},
+  { 0x0060, 0x00, {0x30, 0x30, 0x30, 0x30, 0x18, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x0061, 0x00, {0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x78, 0x0C, 0x0C, 0x7C, 0xCC, 0xCC, 0xCC, 0x76, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x0062, 0x00, {0x00, 0x00, 0xE0, 0x60, 0x60, 0x60, 0x78, 0x6C, 0x66, 0x66, 0x66, 0x66, 0x66, 0x7C, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x0063, 0x00, {0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x7C, 0xC6, 0xC0, 0xC0, 0xC0, 0xC0, 0xC6, 0x7C, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x0064, 0x00, {0x00, 0x00, 0x1C, 0x0C, 0x0C, 0x0C, 0x3C, 0x6C, 0xCC, 0xCC, 0xCC, 0xCC, 0xCC, 0x76, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x0065, 0x00, {0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x7C, 0xC6, 0xC6, 0xFE, 0xC0, 0xC0, 0xC6, 0x7C, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x0066, 0x00, {0x00, 0x00, 0x1C, 0x36, 0x32, 0x30, 0x78, 0x30, 0x30, 0x30, 0x30, 0x30, 0x30, 0x78, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x0067, 0x00, {0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x76, 0xCC, 0xCC, 0xCC, 0xCC, 0xCC, 0xCC, 0x7C, 0x0C, 0x0C, 0xCC, 0x78, 0x00}},
+  { 0x0068, 0x00, {0x00, 0x00, 0xE0, 0x60, 0x60, 0x60, 0x6C, 0x76, 0x66, 0x66, 0x66, 0x66, 0x66, 0xE6, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x0069, 0x00, {0x00, 0x00, 0x00, 0x18, 0x18, 0x00, 0x38, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x3C, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x006a, 0x00, {0x00, 0x00, 0x00, 0x0C, 0x0C, 0x00, 0x1C, 0x0C, 0x0C, 0x0C, 0x0C, 0x0C, 0x0C, 0x0C, 0xCC, 0xCC, 0xCC, 0x78, 0x00}},
+  { 0x006b, 0x00, {0x00, 0x00, 0xE0, 0x60, 0x60, 0x60, 0x66, 0x6C, 0x78, 0x78, 0x6C, 0x66, 0x66, 0xE6, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x006c, 0x00, {0x00, 0x00, 0x38, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x3C, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x006d, 0x00, {0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x6C, 0xFE, 0xD6, 0xD6, 0xD6, 0xD6, 0xC6, 0xC6, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x006e, 0x00, {0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0xDC, 0x66, 0x66, 0x66, 0x66, 0x66, 0x66, 0x66, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x006f, 0x00, {0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x7C, 0xC6, 0xC6, 0xC6, 0xC6, 0xC6, 0xC6, 0x7C, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x0070, 0x00, {0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0xDC, 0x66, 0x66, 0x66, 0x66, 0x66, 0x66, 0x7C, 0x60, 0x60, 0x60, 0xF0, 0x00}},
+  { 0x0071, 0x00, {0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x76, 0xCC, 0xCC, 0xCC, 0xCC, 0xCC, 0xCC, 0x7C, 0x0C, 0x0C, 0x0C, 0x1E, 0x00}},
+  { 0x0072, 0x00, {0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0xDC, 0x76, 0x66, 0x60, 0x60, 0x60, 0x60, 0xF0, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x0073, 0x00, {0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x7C, 0xC6, 0xC2, 0x78, 0x0C, 0x86, 0xC6, 0x7C, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x0074, 0x00, {0x00, 0x00, 0x10, 0x30, 0x30, 0x30, 0xFC, 0x30, 0x30, 0x30, 0x30, 0x30, 0x36, 0x1C, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x0075, 0x00, {0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0xCC, 0xCC, 0xCC, 0xCC, 0xCC, 0xCC, 0xCC, 0x76, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x0076, 0x00, {0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x66, 0x66, 0x66, 0x66, 0x66, 0x66, 0x3C, 0x18, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x0077, 0x00, {0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0xC6, 0xC6, 0xC6, 0xD6, 0xD6, 0xD6, 0xFE, 0x6C, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x0078, 0x00, {0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0xC6, 0x6C, 0x38, 0x10, 0x38, 0x6C, 0xC6, 0x82, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x0079, 0x00, {0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0xC6, 0xC6, 0xC6, 0xC6, 0xC6, 0xC6, 0xC6, 0x7E, 0x06, 0x06, 0x0C, 0xF8, 0x00}},
+  { 0x007a, 0x00, {0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0xFE, 0xCC, 0x18, 0x30, 0x60, 0xC0, 0xC6, 0xFE, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x007b, 0x00, {0x00, 0x00, 0x0E, 0x18, 0x18, 0x18, 0x18, 0x70, 0x18, 0x18, 0x18, 0x18, 0x18, 0x0E, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x007c, 0x00, {0x00, 0x00, 0x18, 0x18, 0x18, 0x18, 0x18, 0x00, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x007d, 0x00, {0x00, 0x00, 0x70, 0x18, 0x18, 0x18, 0x18, 0x0E, 0x18, 0x18, 0x18, 0x18, 0x18, 0x70, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x007e, 0x00, {0x00, 0x76, 0xD4, 0x9C, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x2302, 0x00, {0x00, 0x00, 0x00, 0x00, 0x00, 0x10, 0x38, 0x6C, 0xC6, 0xC6, 0xC6, 0xC6, 0xFE, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x00c7, 0x00, {0x00, 0x00, 0x3C, 0x66, 0xC2, 0xC0, 0xC0, 0xC0, 0xC0, 0xC0, 0xC2, 0x66, 0x3C, 0x0C, 0x06, 0x7C, 0x00, 0x00, 0x00}},
+  { 0x00fc, 0x00, {0x00, 0x00, 0x00, 0xCC, 0xCC, 0x00, 0xCC, 0xCC, 0xCC, 0xCC, 0xCC, 0xCC, 0xCC, 0x76, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x00e9, 0x00, {0x00, 0x0C, 0x18, 0x30, 0x00, 0x00, 0x7C, 0xC6, 0xC6, 0xFE, 0xC0, 0xC0, 0xC6, 0x7C, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x00e2, 0x00, {0x00, 0x10, 0x38, 0x6C, 0x00, 0x00, 0x78, 0x0C, 0x0C, 0x7C, 0xCC, 0xCC, 0xCC, 0x76, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x00e4, 0x00, {0x00, 0x00, 0x00, 0xCC, 0xCC, 0x00, 0x78, 0x0C, 0x0C, 0x7C, 0xCC, 0xCC, 0xCC, 0x76, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x00e0, 0x00, {0x00, 0x60, 0x30, 0x18, 0x0C, 0x00, 0x78, 0x0C, 0x0C, 0x7C, 0xCC, 0xCC, 0xCC, 0x76, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x00e5, 0x00, {0x00, 0x38, 0x6C, 0x6C, 0x38, 0x00, 0x78, 0x0C, 0x0C, 0x7C, 0xCC, 0xCC, 0xCC, 0x76, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x00e7, 0x00, {0x00, 0x00, 0x00, 0x00, 0x3C, 0x66, 0x62, 0x60, 0x60, 0x66, 0x64, 0x3C, 0x0C, 0x06, 0x3C, 0x00, 0x00, 0x00, 0x00}},
+  { 0x00ea, 0x00, {0x00, 0x10, 0x38, 0x6C, 0x44, 0x00, 0x7C, 0xC6, 0xC6, 0xFE, 0xC0, 0xC0, 0xC6, 0x7C, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x00eb, 0x00, {0x00, 0x00, 0x00, 0xC6, 0xC6, 0x00, 0x7C, 0xC6, 0xC6, 0xFE, 0xC0, 0xC0, 0xC6, 0x7C, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x00e8, 0x00, {0x00, 0x60, 0x30, 0x18, 0x0C, 0x00, 0x7C, 0xC6, 0xC6, 0xFE, 0xC0, 0xC0, 0xC6, 0x7C, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x00ef, 0x00, {0x00, 0x00, 0x00, 0x66, 0x66, 0x00, 0x38, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x3C, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x00ee, 0x00, {0x00, 0x18, 0x3C, 0x66, 0x42, 0x00, 0x38, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x3C, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x00ec, 0x00, {0x00, 0x60, 0x30, 0x18, 0x08, 0x00, 0x38, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x3C, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x00c4, 0x00, {0xC6, 0xC6, 0x10, 0x38, 0x6C, 0xC6, 0xC6, 0xC6, 0xFE, 0xC6, 0xC6, 0xC6, 0xC6, 0xC6, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x00c5, 0x00, {0x38, 0x28, 0x38, 0x10, 0x38, 0x6C, 0xC6, 0xC6, 0xFE, 0xC6, 0xC6, 0xC6, 0xC6, 0xC6, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x00c9, 0x00, {0x18, 0x30, 0x60, 0x00, 0xFE, 0x66, 0x62, 0x68, 0x78, 0x68, 0x60, 0x62, 0x66, 0xFE, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x00e6, 0x00, {0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0xCC, 0x76, 0x36, 0x36, 0x7E, 0xD8, 0xD8, 0x6E, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x00c6, 0x00, {0x00, 0x00, 0x3E, 0x6C, 0xCC, 0xCC, 0xFE, 0xCC, 0xCC, 0xCC, 0xCC, 0xCC, 0xCC, 0xCE, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x00f4, 0x00, {0x00, 0x10, 0x38, 0x6C, 0x44, 0x00, 0x7C, 0xC6, 0xC6, 0xC6, 0xC6, 0xC6, 0xC6, 0x7C, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x00f6, 0x00, {0x00, 0x00, 0x00, 0xC6, 0xC6, 0x00, 0x7C, 0xC6, 0xC6, 0xC6, 0xC6, 0xC6, 0xC6, 0x7C, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x00f2, 0x00, {0x00, 0x60, 0x30, 0x18, 0x0C, 0x00, 0x7C, 0xC6, 0xC6, 0xC6, 0xC6, 0xC6, 0xC6, 0x7C, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x00fb, 0x00, {0x00, 0x30, 0x78, 0xCC, 0x84, 0x00, 0xCC, 0xCC, 0xCC, 0xCC, 0xCC, 0xCC, 0xCC, 0x76, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x00f9, 0x00, {0x00, 0x60, 0x30, 0x18, 0x0C, 0x00, 0xCC, 0xCC, 0xCC, 0xCC, 0xCC, 0xCC, 0xCC, 0x76, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x00ff, 0x00, {0x00, 0x00, 0x00, 0xC6, 0xC6, 0x00, 0xC6, 0xC6, 0xC6, 0xC6, 0xC6, 0xC6, 0xC6, 0x7E, 0x06, 0x06, 0x0C, 0x78, 0x00}},
+  { 0x00d6, 0x00, {0xC6, 0xC6, 0x00, 0x7C, 0xC6, 0xC6, 0xC6, 0xC6, 0xC6, 0xC6, 0xC6, 0xC6, 0xC6, 0x7C, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x00dc, 0x00, {0xC6, 0xC6, 0x00, 0xC6, 0xC6, 0xC6, 0xC6, 0xC6, 0xC6, 0xC6, 0xC6, 0xC6, 0xC6, 0x7C, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x00a2, 0x00, {0x08, 0x08, 0x3C, 0x6E, 0xCA, 0xC8, 0xC8, 0xC8, 0xC8, 0xC8, 0xC8, 0xCA, 0x6E, 0x3C, 0x08, 0x08, 0x00, 0x00, 0x00}},
+  { 0x00a3, 0x00, {0x00, 0x38, 0x6C, 0x64, 0x64, 0x60, 0xF0, 0x60, 0x60, 0x60, 0x60, 0x62, 0xE6, 0xFC, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x00a5, 0x00, {0x00, 0x00, 0x66, 0x66, 0x66, 0x66, 0x3C, 0x18, 0x7E, 0x18, 0x7E, 0x18, 0x18, 0x18, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x20a7, 0x00, {0x00, 0xF8, 0xCC, 0xCC, 0xFC, 0xF8, 0xC4, 0xCC, 0xDE, 0xCC, 0xCC, 0xCC, 0xCC, 0xC6, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x0192, 0x00, {0x00, 0x0E, 0x1B, 0x19, 0x18, 0x18, 0x18, 0x7E, 0x18, 0x18, 0x18, 0x18, 0x18, 0x98, 0xD8, 0x70, 0x00, 0x00, 0x00}},
+  { 0x00e1, 0x00, {0x00, 0x18, 0x30, 0x60, 0xC0, 0x00, 0x78, 0x0C, 0x0C, 0x7C, 0xCC, 0xCC, 0xCC, 0x76, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x00ed, 0x00, {0x00, 0x0C, 0x18, 0x30, 0x20, 0x00, 0x38, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x3C, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x00f3, 0x00, {0x00, 0x18, 0x30, 0x60, 0x40, 0x00, 0x7C, 0xC6, 0xC6, 0xC6, 0xC6, 0xC6, 0xC6, 0x7C, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x00fa, 0x00, {0x00, 0x18, 0x30, 0x60, 0x40, 0x00, 0xCC, 0xCC, 0xCC, 0xCC, 0xCC, 0xCC, 0xCC, 0x76, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x00f1, 0x00, {0x00, 0x00, 0x36, 0xD4, 0x88, 0x00, 0xDC, 0x66, 0x66, 0x66, 0x66, 0x66, 0x66, 0x66, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x00d1, 0x00, {0x36, 0xCC, 0x00, 0xC6, 0xE6, 0xF6, 0xDE, 0xCE, 0xC6, 0xC6, 0xC6, 0xC6, 0xC6, 0xC6, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x00aa, 0x00, {0x00, 0x3C, 0x6C, 0x6C, 0x6C, 0x3E, 0x00, 0x7E, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x00ba, 0x00, {0x00, 0x38, 0x6C, 0x6C, 0x6C, 0x38, 0x00, 0x7C, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x00bf, 0x00, {0x00, 0x00, 0x30, 0x30, 0x00, 0x30, 0x30, 0x30, 0x60, 0xC0, 0xC6, 0xC6, 0xC6, 0x7C, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x2310, 0x00, {0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0xFE, 0xC0, 0xC0, 0xC0, 0xC0, 0xC0, 0xC0, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x00ac, 0x00, {0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0xFE, 0x06, 0x06, 0x06, 0x06, 0x06, 0x06, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x00bd, 0x00, {0x00, 0xC0, 0xC0, 0xC0, 0xC2, 0xC6, 0x0C, 0x18, 0x30, 0x60, 0xC0, 0x9C, 0x06, 0x0C, 0x18, 0x3E, 0x00, 0x00, 0x00}},
+  { 0x00bc, 0x00, {0x00, 0xC0, 0xC0, 0xC0, 0xC2, 0xC6, 0x0C, 0x18, 0x30, 0x66, 0xCE, 0x9A, 0x32, 0x3E, 0x06, 0x06, 0x00, 0x00, 0x00}},
+  { 0x00a1, 0x00, {0x00, 0x00, 0x18, 0x18, 0x00, 0x18, 0x18, 0x18, 0x18, 0x3C, 0x3C, 0x3C, 0x3C, 0x18, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x00ab, 0x00, {0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x36, 0x6C, 0xD8, 0xD8, 0x6C, 0x36, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x00bb, 0x00, {0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0xD8, 0x6C, 0x36, 0x36, 0x6C, 0xD8, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x2591, 0x00, {0x11, 0x44, 0x11, 0x44, 0x11, 0x44, 0x11, 0x44, 0x11, 0x44, 0x11, 0x44, 0x11, 0x44, 0x11, 0x44, 0x11, 0x44, 0x11}},
+  { 0x2592, 0x00, {0x55, 0xAA, 0x55, 0xAA, 0x55, 0xAA, 0x55, 0xAA, 0x55, 0xAA, 0x55, 0xAA, 0x55, 0xAA, 0x55, 0xAA, 0x55, 0xAA, 0x55}},
+  { 0x2593, 0x00, {0xDD, 0x77, 0xDD, 0x77, 0xDD, 0x77, 0xDD, 0x77, 0xDD, 0x77, 0xDD, 0x77, 0xDD, 0x77, 0xDD, 0x77, 0xDD, 0x77, 0xDD}},
+  { 0x2502, 0x00, {0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18}},
+  { 0x2524, 0x00, {0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0xF8, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18}},
+  { 0x2561, 0x00, {0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0xF8, 0x18, 0xF8, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18}},
+  { 0x2562, 0x00, {0x36, 0x36, 0x36, 0x36, 0x36, 0x36, 0x36, 0x36, 0x36, 0xF6, 0x36, 0x36, 0x36, 0x36, 0x36, 0x36, 0x36, 0x36, 0x36}},
+  { 0x2556, 0x00, {0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0xFE, 0x36, 0x36, 0x36, 0x36, 0x36, 0x36, 0x36, 0x36, 0x36}},
+  { 0x2555, 0x00, {0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0xF8, 0x18, 0xF8, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18}},
+  { 0x2563, 0x00, {0x36, 0x36, 0x36, 0x36, 0x36, 0x36, 0x36, 0x36, 0xF6, 0x06, 0xF6, 0x36, 0x36, 0x36, 0x36, 0x36, 0x36, 0x36, 0x36}},
+  { 0x2551, 0x00, {0x36, 0x36, 0x36, 0x36, 0x36, 0x36, 0x36, 0x36, 0x36, 0x36, 0x36, 0x36, 0x36, 0x36, 0x36, 0x36, 0x36, 0x36, 0x36}},
+  { 0x2557, 0x00, {0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0xFE, 0x06, 0xF6, 0x36, 0x36, 0x36, 0x36, 0x36, 0x36, 0x36, 0x36}},
+  { 0x255d, 0x00, {0x36, 0x36, 0x36, 0x36, 0x36, 0x36, 0x36, 0x36, 0xF6, 0x06, 0xFE, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x255c, 0x00, {0x36, 0x36, 0x36, 0x36, 0x36, 0x36, 0x36, 0x36, 0x36, 0xFE, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x255b, 0x00, {0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0xF8, 0x18, 0xF8, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x2510, 0x00, {0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0xF8, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18}},
+  { 0x2514, 0x00, {0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x1F, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x2534, 0x00, {0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0xFF, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x252c, 0x00, {0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0xFF, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18}},
+  { 0x251c, 0x00, {0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x1F, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18}},
+  { 0x2500, 0x00, {0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0xFF, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x253c, 0x00, {0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0xFF, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18}},
+  { 0x255e, 0x00, {0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x1F, 0x18, 0x1F, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18}},
+  { 0x255f, 0x00, {0x36, 0x36, 0x36, 0x36, 0x36, 0x36, 0x36, 0x36, 0x36, 0x37, 0x36, 0x36, 0x36, 0x36, 0x36, 0x36, 0x36, 0x36, 0x36}},
+  { 0x255a, 0x00, {0x36, 0x36, 0x36, 0x36, 0x36, 0x36, 0x36, 0x36, 0x37, 0x30, 0x3F, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x2554, 0x00, {0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x3F, 0x30, 0x37, 0x36, 0x36, 0x36, 0x36, 0x36, 0x36, 0x36, 0x36}},
+  { 0x2569, 0x00, {0x36, 0x36, 0x36, 0x36, 0x36, 0x36, 0x36, 0x36, 0xF7, 0x00, 0xFF, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x2566, 0x00, {0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0xFF, 0x00, 0xF7, 0x36, 0x36, 0x36, 0x36, 0x36, 0x36, 0x36, 0x36}},
+  { 0x2560, 0x00, {0x36, 0x36, 0x36, 0x36, 0x36, 0x36, 0x36, 0x36, 0x37, 0x30, 0x37, 0x36, 0x36, 0x36, 0x36, 0x36, 0x36, 0x36, 0x36}},
+  { 0x2550, 0x00, {0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0xFF, 0x00, 0xFF, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x256c, 0x00, {0x36, 0x36, 0x36, 0x36, 0x36, 0x36, 0x36, 0x36, 0xF7, 0x00, 0xF7, 0x36, 0x36, 0x36, 0x36, 0x36, 0x36, 0x36, 0x36}},
+  { 0x2567, 0x00, {0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0xFF, 0x00, 0xFF, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x2568, 0x00, {0x36, 0x36, 0x36, 0x36, 0x36, 0x36, 0x36, 0x36, 0x36, 0xFF, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x2564, 0x00, {0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0xFF, 0x00, 0xFF, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18}},
+  { 0x2565, 0x00, {0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0xFF, 0x36, 0x36, 0x36, 0x36, 0x36, 0x36, 0x36, 0x36, 0x36}},
+  { 0x2559, 0x00, {0x36, 0x36, 0x36, 0x36, 0x36, 0x36, 0x36, 0x36, 0x36, 0x3F, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x2558, 0x00, {0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x1F, 0x18, 0x1F, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x2552, 0x00, {0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x1F, 0x18, 0x1F, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18}},
+  { 0x2553, 0x00, {0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x3F, 0x36, 0x36, 0x36, 0x36, 0x36, 0x36, 0x36, 0x36, 0x36}},
+  { 0x256b, 0x00, {0x36, 0x36, 0x36, 0x36, 0x36, 0x36, 0x36, 0x36, 0x36, 0xFF, 0x36, 0x36, 0x36, 0x36, 0x36, 0x36, 0x36, 0x36, 0x36}},
+  { 0x256a, 0x00, {0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0xFF, 0x18, 0xFF, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18}},
+  { 0x2518, 0x00, {0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0xF8, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x250c, 0x00, {0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x1F, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18}},
+  { 0x2588, 0x00, {0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF}},
+  { 0x2584, 0x00, {0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF}},
+  { 0x258c, 0x00, {0xF0, 0xF0, 0xF0, 0xF0, 0xF0, 0xF0, 0xF0, 0xF0, 0xF0, 0xF0, 0xF0, 0xF0, 0xF0, 0xF0, 0xF0, 0xF0, 0xF0, 0xF0, 0xF0}},
+  { 0x2590, 0x00, {0x0F, 0x0F, 0x0F, 0x0F, 0x0F, 0x0F, 0x0F, 0x0F, 0x0F, 0x0F, 0x0F, 0x0F, 0x0F, 0x0F, 0x0F, 0x0F, 0x0F, 0x0F, 0x0F}},
+  { 0x2580, 0x00, {0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x03b1, 0x00, {0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x76, 0xDC, 0xD8, 0xD8, 0xD8, 0xD8, 0xDC, 0x76, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x00df, 0x00, {0x00, 0x00, 0x78, 0xCC, 0xCC, 0xCC, 0xCC, 0xD8, 0xCC, 0xC6, 0xC6, 0xC6, 0xC6, 0xCC, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x0393, 0x00, {0x00, 0x00, 0xFE, 0xC6, 0xC6, 0xC6, 0xC0, 0xC0, 0xC0, 0xC0, 0xC0, 0xC0, 0xC0, 0xC0, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x03c0, 0x00, {0x00, 0x00, 0x00, 0x00, 0xFE, 0x6C, 0x6C, 0x6C, 0x6C, 0x6C, 0x6C, 0x6C, 0x6C, 0x6C, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x03a3, 0x00, {0x00, 0x00, 0x00, 0xFE, 0xC6, 0xC2, 0x60, 0x30, 0x18, 0x30, 0x60, 0xC2, 0xC6, 0xFE, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x03c3, 0x00, {0x00, 0x00, 0x00, 0x00, 0x00, 0x7E, 0xD8, 0xD8, 0xD8, 0xD8, 0xD8, 0xD8, 0xD8, 0x70, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x00b5, 0x00, {0x00, 0x00, 0x00, 0x00, 0x66, 0x66, 0x66, 0x66, 0x66, 0x66, 0x66, 0x7C, 0x60, 0x60, 0xC0, 0x00, 0x00, 0x00, 0x00}},
+  { 0x03c4, 0x00, {0x00, 0x00, 0x00, 0x00, 0x76, 0xDC, 0x98, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x03a6, 0x00, {0x00, 0x00, 0x00, 0x7E, 0x18, 0x3C, 0x66, 0x66, 0x66, 0x66, 0x66, 0x3C, 0x18, 0x7E, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x0398, 0x00, {0x00, 0x00, 0x00, 0x38, 0x6C, 0xC6, 0xC6, 0xC6, 0xFE, 0xC6, 0xC6, 0xC6, 0x6C, 0x38, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x03a9, 0x00, {0x00, 0x00, 0x38, 0x6C, 0xC6, 0xC6, 0xC6, 0xC6, 0x6C, 0x6C, 0x6C, 0x6C, 0x6C, 0xEE, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x03b4, 0x00, {0x00, 0x00, 0x1E, 0x20, 0x30, 0x18, 0x0C, 0x3E, 0x66, 0x66, 0x66, 0x66, 0x66, 0x3C, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x221e, 0x00, {0x00, 0x00, 0x00, 0x00, 0x00, 0x7E, 0xDB, 0xDB, 0xDB, 0xDB, 0xDB, 0x7E, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x03c6, 0x00, {0x00, 0x00, 0x00, 0x03, 0x06, 0x7E, 0xDB, 0xDB, 0xDB, 0xDB, 0xD3, 0x7E, 0x60, 0xC0, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x03b5, 0x00, {0x00, 0x00, 0x1C, 0x30, 0x60, 0x60, 0x60, 0x7C, 0x60, 0x60, 0x60, 0x60, 0x30, 0x1C, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x2229, 0x00, {0x00, 0x00, 0x00, 0x7C, 0xC6, 0xC6, 0xC6, 0xC6, 0xC6, 0xC6, 0xC6, 0xC6, 0xC6, 0xC6, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x2261, 0x00, {0x00, 0x00, 0x00, 0x00, 0x00, 0xFE, 0x00, 0x00, 0xFE, 0x00, 0x00, 0xFE, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x00b1, 0x00, {0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x18, 0x18, 0x7E, 0x18, 0x18, 0x00, 0x00, 0xFF, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x2265, 0x00, {0x00, 0x00, 0x00, 0x60, 0x30, 0x18, 0x0C, 0x06, 0x0C, 0x18, 0x30, 0x60, 0x00, 0x7E, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x2264, 0x00, {0x00, 0x00, 0x00, 0x06, 0x0C, 0x18, 0x30, 0x60, 0x30, 0x18, 0x0C, 0x06, 0x00, 0x7E, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x2320, 0x00, {0x00, 0x00, 0x0E, 0x1B, 0x1B, 0x1B, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18}},
+  { 0x2321, 0x00, {0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0xD8, 0xD8, 0xD8, 0x70, 0x00, 0x00}},
+  { 0x00f7, 0x00, {0x00, 0x00, 0x00, 0x00, 0x00, 0x18, 0x18, 0x00, 0x7E, 0x00, 0x18, 0x18, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x2248, 0x00, {0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x76, 0xDC, 0x00, 0x76, 0xDC, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x00b0, 0x00, {0x00, 0x38, 0x6C, 0x6C, 0x6C, 0x38, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x2219, 0x00, {0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x18, 0x18, 0x18, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x00b7, 0x00, {0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x18, 0x18, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x221a, 0x00, {0x00, 0x0F, 0x0C, 0x0C, 0x0C, 0x0C, 0x0C, 0x0C, 0xEC, 0x6C, 0x6C, 0x6C, 0x3C, 0x1C, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x207f, 0x00, {0x00, 0xD8, 0x6C, 0x6C, 0x6C, 0x6C, 0x6C, 0x6C, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x00b2, 0x00, {0x00, 0x70, 0xD8, 0x10, 0x30, 0x60, 0xC8, 0xF8, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x25a0, 0x00, {0x00, 0x00, 0x00, 0x00, 0x00, 0x7C, 0x7C, 0x7C, 0x7C, 0x7C, 0x7C, 0x7C, 0x7C, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x00a0, 0x00, {0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}},
+  { 0x0000, 0x00, {0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}} //EOL
+};
+
+// Get available Unicode glyphs narrow fonts(8*19 pixels) size.
+UINT32 mNarrowFontSize = sizeof (gUsStdNarrowGlyphData);
diff --git a/Platform/RaspberryPi/RPi3/Include/Protocol/ExtendedTextOut.h b/Platform/RaspberryPi/RPi3/Include/Protocol/ExtendedTextOut.h
new file mode 100644
index 000000000000..f79cd8589f42
--- /dev/null
+++ b/Platform/RaspberryPi/RPi3/Include/Protocol/ExtendedTextOut.h
@@ -0,0 +1,36 @@
+/** @file
+ *
+ *  Copyright (c) 2018, Andrei Warkentin <andrey.warkentin@gmail.com>
+ *
+ *  This program and the accompanying materials
+ *  are licensed and made available under the terms and conditions of the BSD License
+ *  which accompanies this distribution.  The full text of the license may be found at
+ *  http://opensource.org/licenses/bsd-license.php
+ *
+ *  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+ *  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+ *
+ **/
+
+#ifndef __EXTENDED_TEXT_OUT_PROTOCOL_H__
+#define __EXTENDED_TEXT_OUT_PROTOCOL_H__
+
+#include <Protocol/SimpleTextOut.h>
+#include <Protocol/GraphicsOutput.h>
+
+#define EXTENDED_TEXT_OUTPUT_PROTOCOL_GUID \
+  { \
+    0x387477ff, 0xffc7, 0xffd2, {0x8e, 0x39, 0x0, 0xff, 0xc9, 0x69, 0x72, 0x3b } \
+  }
+
+typedef struct _EXTENDED_TEXT_OUTPUT_PROTOCOL EXTENDED_TEXT_OUTPUT_PROTOCOL;
+
+struct _EXTENDED_TEXT_OUTPUT_PROTOCOL {
+  EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL *TextOut;
+  EFI_GRAPHICS_OUTPUT_PROTOCOL    *GraphicsOutput;
+  BOOLEAN                         AutoWrap;
+};
+
+extern EFI_GUID gExtendedTextOutputProtocolGuid;
+
+#endif /* __EXTENDED_TEXT_OUT_PROTOCOL_H__ */
-- 
2.17.0.windows.1



^ permalink raw reply related	[flat|nested] 34+ messages in thread

* [PATCH v5 edk2-platforms 11/22] Platform/RaspberryPi/RPi3: Add NV storage driver
  2019-02-05 16:25 [PATCH v5 edk2-platforms 00/22] Platform/RaspberryPi: Add Raspberry Pi 3 support Pete Batard
                   ` (9 preceding siblings ...)
  2019-02-05 16:25 ` [PATCH v5 edk2-platforms 10/22] Platform/RaspberryPi/RPi3: Add console driver Pete Batard
@ 2019-02-05 16:25 ` Pete Batard
  2019-02-05 16:25 ` [PATCH v5 edk2-platforms 12/22] Platform/RaspberryPi/RPi3: Add Device Tree driver Pete Batard
                   ` (12 subsequent siblings)
  23 siblings, 0 replies; 34+ messages in thread
From: Pete Batard @ 2019-02-05 16:25 UTC (permalink / raw)
  To: edk2-devel

Since the Raspberry Pi doesn't have a NVRAM, this driver is used to store
non-volatile user configuration settings into the firmware volume itself.

Contributed-under: TianoCore Contribution Agreement 1.1
Signed-off-by: Pete Batard <pete@akeo.ie>
---
 Platform/RaspberryPi/RPi3/Drivers/VarBlockServiceDxe/FileIo.c               | 196 ++++
 Platform/RaspberryPi/RPi3/Drivers/VarBlockServiceDxe/FvbInfo.c              | 115 +++
 Platform/RaspberryPi/RPi3/Drivers/VarBlockServiceDxe/VarBlockService.c      | 971 ++++++++++++++++++++
 Platform/RaspberryPi/RPi3/Drivers/VarBlockServiceDxe/VarBlockService.h      | 217 +++++
 Platform/RaspberryPi/RPi3/Drivers/VarBlockServiceDxe/VarBlockServiceDxe.c   | 331 +++++++
 Platform/RaspberryPi/RPi3/Drivers/VarBlockServiceDxe/VarBlockServiceDxe.inf |  93 ++
 6 files changed, 1923 insertions(+)

diff --git a/Platform/RaspberryPi/RPi3/Drivers/VarBlockServiceDxe/FileIo.c b/Platform/RaspberryPi/RPi3/Drivers/VarBlockServiceDxe/FileIo.c
new file mode 100644
index 000000000000..0e8cd516f65e
--- /dev/null
+++ b/Platform/RaspberryPi/RPi3/Drivers/VarBlockServiceDxe/FileIo.c
@@ -0,0 +1,196 @@
+/** @file
+ *
+ *  Copyright (c) 2018, Andrei Warkentin <andrey.warkentin@gmail.com>
+ *  Copyright (c) 2007-2009, Intel Corporation. All rights reserved.
+ *
+ *  This program and the accompanying materials
+ *  are licensed and made available under the terms and conditions of the BSD License
+ *  which accompanies this distribution.  The full text of the license may be found at
+ *  http://opensource.org/licenses/bsd-license.php
+ *
+ *  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+ *  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+ *
+ **/
+
+#include "VarBlockService.h"
+
+
+EFI_STATUS
+FileWrite (
+  IN EFI_FILE_PROTOCOL *File,
+  IN UINTN Offset,
+  IN UINTN Buffer,
+  IN UINTN Size
+  )
+{
+  EFI_STATUS Status;
+
+  Status = File->SetPosition (File, Offset);
+  ASSERT_EFI_ERROR (Status);
+  if (!EFI_ERROR (Status)) {
+    Status = File->Write (File, &Size, (VOID*)Buffer);
+    ASSERT_EFI_ERROR (Status);
+  }
+  return Status;
+}
+
+
+VOID
+FileClose (
+  IN  EFI_FILE_PROTOCOL *File
+  )
+{
+  File->Flush (File);
+  File->Close (File);
+}
+
+
+EFI_STATUS
+FileOpen (
+  IN  EFI_DEVICE_PATH_PROTOCOL *Device,
+  IN  CHAR16 *MappedFile,
+  OUT EFI_FILE_PROTOCOL **File,
+  IN  UINT64 OpenMode
+  )
+{
+  EFI_HANDLE                        Handle;
+  EFI_FILE_HANDLE                   Root;
+  EFI_SIMPLE_FILE_SYSTEM_PROTOCOL   *Volume;
+  EFI_STATUS                        Status;
+
+  *File = NULL;
+
+  Status = gBS->LocateDevicePath (
+                  &gEfiSimpleFileSystemProtocolGuid,
+                  &Device,
+                  &Handle
+                );
+
+  if (EFI_ERROR (Status)) {
+    return Status;
+  }
+
+  Status = gBS->HandleProtocol (
+                  Handle,
+                  &gEfiSimpleFileSystemProtocolGuid,
+                  (VOID**)&Volume
+                );
+  ASSERT_EFI_ERROR (Status);
+  if (EFI_ERROR (Status)) {
+    return Status;
+  }
+
+  //
+  // Open the root directory of the volume
+  //
+  Root = NULL;
+  Status = Volume->OpenVolume (
+                     Volume,
+                     &Root
+                   );
+  ASSERT_EFI_ERROR (Status);
+  ASSERT (Root != NULL);
+
+  //
+  // Open file
+  //
+  Status = Root->Open (
+                   Root,
+                   File,
+                   MappedFile,
+                   OpenMode,
+                   0
+                 );
+  if (EFI_ERROR (Status)) {
+    *File = NULL;
+  }
+
+  //
+  // Close the Root directory
+  //
+  Root->Close (Root);
+  return Status;
+}
+
+
+EFI_STATUS
+CheckStore (
+  IN  EFI_HANDLE SimpleFileSystemHandle,
+  OUT EFI_DEVICE_PATH_PROTOCOL **Device
+  )
+{
+  EFI_STATUS Status;
+  EFI_BLOCK_IO_PROTOCOL *BlkIo;
+  EFI_FILE_PROTOCOL *File;
+
+  *Device = NULL;
+  Status = gBS->HandleProtocol (
+                  SimpleFileSystemHandle,
+                  &gEfiBlockIoProtocolGuid,
+                  (VOID*)&BlkIo
+                );
+
+  if (EFI_ERROR (Status)) {
+    goto ErrHandle;
+  }
+  if (!BlkIo->Media->MediaPresent) {
+    DEBUG ((DEBUG_ERROR, "FwhMappedFile: Media not present!\n"));
+    Status = EFI_NO_MEDIA;
+    goto ErrHandle;
+  }
+  if (BlkIo->Media->ReadOnly) {
+    DEBUG ((DEBUG_ERROR, "FwhMappedFile: Media is read-only!\n"));
+    Status = EFI_ACCESS_DENIED;
+    goto ErrHandle;
+  }
+
+  Status = FileOpen (DevicePathFromHandle (SimpleFileSystemHandle),
+             mFvInstance->MappedFile, &File,
+             EFI_FILE_MODE_READ);
+  if (EFI_ERROR (Status)) {
+    goto ErrHandle;
+  }
+
+  /* We found it! Maybe do more checks...? */
+
+  FileClose (File);
+  *Device = DuplicateDevicePath (DevicePathFromHandle (SimpleFileSystemHandle));
+
+  ASSERT (*Device != NULL);
+
+ErrHandle:
+  return Status;
+}
+
+
+EFI_STATUS
+CheckStoreExists (
+  IN  EFI_DEVICE_PATH_PROTOCOL *Device
+  )
+{
+  EFI_HANDLE Handle;
+  EFI_SIMPLE_FILE_SYSTEM_PROTOCOL *Volume;
+  EFI_STATUS Status;
+
+  Status = gBS->LocateDevicePath (
+                  &gEfiSimpleFileSystemProtocolGuid,
+                  &Device,
+                  &Handle
+                );
+
+  if (EFI_ERROR (Status)) {
+    return Status;
+  }
+
+  Status = gBS->HandleProtocol (
+                  Handle,
+                  &gEfiSimpleFileSystemProtocolGuid,
+                  (VOID**)&Volume
+                );
+  if (EFI_ERROR (Status)) {
+    return Status;
+  }
+
+  return EFI_SUCCESS;
+}
diff --git a/Platform/RaspberryPi/RPi3/Drivers/VarBlockServiceDxe/FvbInfo.c b/Platform/RaspberryPi/RPi3/Drivers/VarBlockServiceDxe/FvbInfo.c
new file mode 100644
index 000000000000..14341def4ccd
--- /dev/null
+++ b/Platform/RaspberryPi/RPi3/Drivers/VarBlockServiceDxe/FvbInfo.c
@@ -0,0 +1,115 @@
+/** @file
+ *
+ *  Copyright (c) 2018, Andrei Warkentin <andrey.warkentin@gmail.com>
+ *  Copyright (c) 2006-2014, Intel Corporation. All rights reserved.
+ *
+ *  This program and the accompanying materials
+ *  are licensed and made available under the terms and conditions of the BSD License
+ *  which accompanies this distribution.  The full text of the license may be found at
+ *  http://opensource.org/licenses/bsd-license.php
+ *
+ *  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+ *  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+ *
+ **/
+
+#include <Pi/PiFirmwareVolume.h>
+#include <Guid/SystemNvDataGuid.h>
+#include <Library/BaseLib.h>
+#include <Library/PcdLib.h>
+
+typedef struct {
+  UINT64                      FvLength;
+  EFI_FIRMWARE_VOLUME_HEADER  FvbInfo;
+  EFI_FV_BLOCK_MAP_ENTRY      End[1];
+} EFI_FVB_MEDIA_INFO;
+
+EFI_FVB_MEDIA_INFO  mPlatformFvbMediaInfo[] = {
+  //
+  // System NvStorage FVB
+  //
+  {
+    FixedPcdGet32 (PcdFlashNvStorageVariableSize) +
+    FixedPcdGet32 (PcdFlashNvStorageFtwWorkingSize) +
+    FixedPcdGet32 (PcdFlashNvStorageFtwSpareSize) +
+    FixedPcdGet32 (PcdNvStorageEventLogSize),
+    {
+      {
+        0,
+      },  // ZeroVector[16]
+      EFI_SYSTEM_NV_DATA_FV_GUID,
+      FixedPcdGet32 (PcdFlashNvStorageVariableSize) +
+      FixedPcdGet32 (PcdFlashNvStorageFtwWorkingSize) +
+      FixedPcdGet32 (PcdFlashNvStorageFtwSpareSize) +
+      FixedPcdGet32 (PcdNvStorageEventLogSize),
+      EFI_FVH_SIGNATURE,
+      EFI_FVB2_MEMORY_MAPPED |
+        EFI_FVB2_READ_ENABLED_CAP |
+        EFI_FVB2_READ_STATUS |
+        EFI_FVB2_WRITE_ENABLED_CAP |
+        EFI_FVB2_WRITE_STATUS |
+        EFI_FVB2_ERASE_POLARITY |
+        EFI_FVB2_ALIGNMENT_16,
+      sizeof (EFI_FIRMWARE_VOLUME_HEADER) + sizeof (EFI_FV_BLOCK_MAP_ENTRY),
+      0,  // CheckSum
+      0,  // ExtHeaderOffset
+      {
+        0,
+      },  // Reserved[1]
+      2,  // Revision
+      {
+        {
+          (FixedPcdGet32 (PcdFlashNvStorageVariableSize) +
+           FixedPcdGet32 (PcdFlashNvStorageFtwWorkingSize) +
+           FixedPcdGet32 (PcdFlashNvStorageFtwSpareSize) +
+           FixedPcdGet32 (PcdNvStorageEventLogSize)) /
+          FixedPcdGet32 (PcdFirmwareBlockSize),
+          FixedPcdGet32 (PcdFirmwareBlockSize),
+        }
+      } // BlockMap[1]
+    },
+    {
+      {
+        0,
+        0
+      }
+    }  // End[1]
+  }
+};
+
+
+EFI_STATUS
+GetFvbInfo (
+  IN  UINT64 FvLength,
+  OUT EFI_FIRMWARE_VOLUME_HEADER **FvbInfo
+  )
+{
+  STATIC BOOLEAN Checksummed = FALSE;
+  UINTN Index;
+
+  if (!Checksummed) {
+    for (Index = 0;
+         Index < sizeof (mPlatformFvbMediaInfo) / sizeof (EFI_FVB_MEDIA_INFO);
+         Index += 1) {
+      UINT16 Checksum;
+      mPlatformFvbMediaInfo[Index].FvbInfo.Checksum = 0;
+      Checksum = CalculateCheckSum16 (
+                   (UINT16*)&mPlatformFvbMediaInfo[Index].FvbInfo,
+                   mPlatformFvbMediaInfo[Index].FvbInfo.HeaderLength
+                 );
+      mPlatformFvbMediaInfo[Index].FvbInfo.Checksum = Checksum;
+    }
+    Checksummed = TRUE;
+  }
+
+  for (Index = 0;
+       Index < sizeof (mPlatformFvbMediaInfo) / sizeof (EFI_FVB_MEDIA_INFO);
+       Index += 1) {
+    if (mPlatformFvbMediaInfo[Index].FvLength == FvLength) {
+      *FvbInfo = &mPlatformFvbMediaInfo[Index].FvbInfo;
+      return EFI_SUCCESS;
+    }
+  }
+
+  return EFI_NOT_FOUND;
+}
diff --git a/Platform/RaspberryPi/RPi3/Drivers/VarBlockServiceDxe/VarBlockService.c b/Platform/RaspberryPi/RPi3/Drivers/VarBlockServiceDxe/VarBlockService.c
new file mode 100644
index 000000000000..7ff5bd7a74cc
--- /dev/null
+++ b/Platform/RaspberryPi/RPi3/Drivers/VarBlockServiceDxe/VarBlockService.c
@@ -0,0 +1,971 @@
+/** @file
+ *
+ *  Copyright (c) 2018, Andrei Warkentin <andrey.warkentin@gmail.com>
+ *  Copyright (c) 2006-2014, Intel Corporation. All rights reserved.
+ *
+ *  This program and the accompanying materials
+ *  are licensed and made available under the terms and conditions of the BSD License
+ *  which accompanies this distribution.  The full text of the license may be found at
+ *  http://opensource.org/licenses/bsd-license.php
+ *
+ *  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+ *  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+ *
+ **/
+
+#include <Protocol/DevicePath.h>
+#include <Protocol/FirmwareVolumeBlock.h>
+
+#include <Library/BaseLib.h>
+#include <Library/BaseMemoryLib.h>
+#include <Library/DebugLib.h>
+#include <Library/DevicePathLib.h>
+#include <Library/DxeServicesTableLib.h>
+#include <Library/MemoryAllocationLib.h>
+#include <Library/UefiBootServicesTableLib.h>
+
+#include "VarBlockService.h"
+
+#define EFI_FVB2_STATUS \
+          (EFI_FVB2_READ_STATUS | EFI_FVB2_WRITE_STATUS | EFI_FVB2_LOCK_STATUS)
+
+EFI_FW_VOL_INSTANCE *mFvInstance;
+
+FV_MEMMAP_DEVICE_PATH mFvMemmapDevicePathTemplate = {
+  {
+    {
+      HARDWARE_DEVICE_PATH,
+      HW_MEMMAP_DP,
+      {
+        (UINT8)(sizeof (MEMMAP_DEVICE_PATH)),
+        (UINT8)(sizeof (MEMMAP_DEVICE_PATH) >> 8)
+      }
+    },
+    EfiMemoryMappedIO,
+    (EFI_PHYSICAL_ADDRESS)0,
+    (EFI_PHYSICAL_ADDRESS)0,
+  },
+  {
+    END_DEVICE_PATH_TYPE,
+    END_ENTIRE_DEVICE_PATH_SUBTYPE,
+    {
+      END_DEVICE_PATH_LENGTH,
+      0
+    }
+  }
+};
+
+FV_PIWG_DEVICE_PATH mFvPIWGDevicePathTemplate = {
+  {
+    {
+      MEDIA_DEVICE_PATH,
+      MEDIA_PIWG_FW_VOL_DP,
+      {
+        (UINT8)(sizeof (MEDIA_FW_VOL_DEVICE_PATH)),
+        (UINT8)(sizeof (MEDIA_FW_VOL_DEVICE_PATH) >> 8)
+      }
+    },
+    { 0 }
+  },
+  {
+    END_DEVICE_PATH_TYPE,
+    END_ENTIRE_DEVICE_PATH_SUBTYPE,
+    {
+      END_DEVICE_PATH_LENGTH,
+      0
+    }
+  }
+};
+
+EFI_FW_VOL_BLOCK_DEVICE mFvbDeviceTemplate = {
+  NULL,
+  {
+    FvbProtocolGetAttributes,
+    FvbProtocolSetAttributes,
+    FvbProtocolGetPhysicalAddress,
+    FvbProtocolGetBlockSize,
+    FvbProtocolRead,
+    FvbProtocolWrite,
+    FvbProtocolEraseBlocks,
+    NULL
+  }
+};
+
+
+EFI_STATUS
+VarStoreWrite (
+  IN     UINTN Address,
+  IN OUT UINTN *NumBytes,
+  IN     UINT8 *Buffer
+  )
+{
+  CopyMem ((VOID*)Address, Buffer, *NumBytes);
+  mFvInstance->Dirty = TRUE;
+
+  return EFI_SUCCESS;
+}
+
+
+EFI_STATUS
+VarStoreErase (
+  IN UINTN Address,
+  IN UINTN LbaLength
+  )
+{
+  SetMem ((VOID*)Address, LbaLength, 0xff);
+  mFvInstance->Dirty = TRUE;
+
+  return EFI_SUCCESS;
+}
+
+
+EFI_STATUS
+FvbGetVolumeAttributes (
+  OUT EFI_FVB_ATTRIBUTES_2 *Attributes
+  )
+{
+  *Attributes = mFvInstance->VolumeHeader->Attributes;
+  return EFI_SUCCESS;
+}
+
+
+EFI_STATUS
+FvbGetLbaAddress (
+  IN  EFI_LBA Lba,
+  OUT UINTN *LbaAddress,
+  OUT UINTN *LbaLength,
+  OUT UINTN *NumOfBlocks
+  )
+/*++
+
+  Routine Description:
+    Retrieves the starting address of an LBA in an FV
+
+  Arguments:
+    Lba                   - The logical block address
+    LbaAddress            - On output, contains the physical starting address
+                            of the Lba
+    LbaLength             - On output, contains the length of the block
+    NumOfBlocks           - A pointer to a caller allocated UINTN in which the
+                            number of consecutive blocks starting with Lba is
+                            returned. All blocks in this range have a size of
+                            BlockSize
+
+  Returns:
+    EFI_SUCCESS
+    EFI_INVALID_PARAMETER
+
+--*/
+{
+  UINT32 NumBlocks;
+  UINT32 BlockLength;
+  UINTN Offset;
+  EFI_LBA StartLba;
+  EFI_LBA NextLba;
+  EFI_FV_BLOCK_MAP_ENTRY *BlockMap;
+
+  StartLba = 0;
+  Offset = 0;
+  BlockMap = &(mFvInstance->VolumeHeader->BlockMap[0]);
+
+  //
+  // Parse the blockmap of the FV to find which map entry the Lba belongs to.
+  //
+  while (TRUE) {
+    NumBlocks = BlockMap->NumBlocks;
+    BlockLength = BlockMap->Length;
+
+    if (NumBlocks == 0 || BlockLength == 0) {
+      return EFI_INVALID_PARAMETER;
+    }
+
+    NextLba = StartLba + NumBlocks;
+
+    //
+    // The map entry found.
+    //
+    if (Lba >= StartLba && Lba < NextLba) {
+      Offset = Offset + (UINTN)MultU64x32 ((Lba - StartLba), BlockLength);
+      if (LbaAddress != NULL) {
+        *LbaAddress = mFvInstance->FvBase + Offset;
+      }
+
+      if (LbaLength != NULL) {
+        *LbaLength = BlockLength;
+      }
+
+      if (NumOfBlocks != NULL) {
+        *NumOfBlocks = (UINTN)(NextLba - Lba);
+      }
+
+      return EFI_SUCCESS;
+    }
+
+    StartLba = NextLba;
+    Offset = Offset + NumBlocks * BlockLength;
+    BlockMap++;
+  }
+}
+
+
+EFI_STATUS
+FvbEraseBlock (
+  IN EFI_LBA Lba
+  )
+/*++
+
+Routine Description:
+  Erases and initializes a firmware volume block
+
+Arguments:
+  Lba                   - The logical block index to be erased
+
+Returns:
+  EFI_SUCCESS           - The erase request was successfully completed
+  EFI_ACCESS_DENIED     - The firmware volume is in the WriteDisabled state
+  EFI_DEVICE_ERROR      - The block device is not functioning correctly and
+                          could not be written. Firmware device may have been
+                          partially erased
+  EFI_INVALID_PARAMETER
+
+--*/
+{
+  EFI_FVB_ATTRIBUTES_2 Attributes;
+  UINTN                LbaAddress;
+  UINTN                LbaLength;
+  EFI_STATUS           Status;
+
+  //
+  // Check if the FV is write enabled
+  //
+  FvbGetVolumeAttributes (&Attributes);
+
+  if ((Attributes & EFI_FVB2_WRITE_STATUS) == 0) {
+    return EFI_ACCESS_DENIED;
+  }
+  //
+  // Get the starting address of the block for erase. For debug reasons,
+  // LbaWriteAddress may not be the same as LbaAddress.
+  //
+  Status = FvbGetLbaAddress (Lba, &LbaAddress, &LbaLength, NULL);
+  if (EFI_ERROR (Status)) {
+    return Status;
+  }
+
+  return VarStoreErase (
+           LbaAddress,
+           LbaLength
+         );
+}
+
+
+EFI_STATUS
+FvbSetVolumeAttributes (
+  IN OUT EFI_FVB_ATTRIBUTES_2 *Attributes
+  )
+/*++
+
+  Routine Description:
+    Modifies the current settings of the firmware volume according to the
+    input parameter, and returns the new setting of the volume
+
+  Arguments:
+    Attributes            - On input, it is a pointer to EFI_FVB_ATTRIBUTES_2
+                            containing the desired firmware volume settings.
+                            On successful return, it contains the new setting.
+
+  Returns:
+    EFI_SUCCESS           - Successfully returns
+    EFI_ACCESS_DENIED     - The volume setting is locked and cannot be modified
+    EFI_INVALID_PARAMETER
+
+--*/
+{
+  EFI_FVB_ATTRIBUTES_2 OldAttributes;
+  EFI_FVB_ATTRIBUTES_2 *AttribPtr;
+  UINT32 Capabilities;
+  UINT32 OldStatus;
+  UINT32 NewStatus;
+  EFI_FVB_ATTRIBUTES_2 UnchangedAttributes;
+
+  AttribPtr =
+    (EFI_FVB_ATTRIBUTES_2*) &(mFvInstance->VolumeHeader->Attributes);
+  OldAttributes = *AttribPtr;
+  Capabilities = OldAttributes & (EFI_FVB2_READ_DISABLED_CAP | \
+                                  EFI_FVB2_READ_ENABLED_CAP |    \
+                                  EFI_FVB2_WRITE_DISABLED_CAP |  \
+                                  EFI_FVB2_WRITE_ENABLED_CAP |   \
+                                  EFI_FVB2_LOCK_CAP              \
+                                  );
+  OldStatus = OldAttributes & EFI_FVB2_STATUS;
+  NewStatus = *Attributes & EFI_FVB2_STATUS;
+
+  UnchangedAttributes = EFI_FVB2_READ_DISABLED_CAP  | \
+                        EFI_FVB2_READ_ENABLED_CAP   | \
+                        EFI_FVB2_WRITE_DISABLED_CAP | \
+                        EFI_FVB2_WRITE_ENABLED_CAP  | \
+                        EFI_FVB2_LOCK_CAP           | \
+                        EFI_FVB2_STICKY_WRITE       | \
+                        EFI_FVB2_MEMORY_MAPPED      | \
+                        EFI_FVB2_ERASE_POLARITY     | \
+                        EFI_FVB2_READ_LOCK_CAP      | \
+                        EFI_FVB2_WRITE_LOCK_CAP     | \
+                        EFI_FVB2_ALIGNMENT;
+
+  //
+  // Some attributes of FV is read only can *not* be set.
+  //
+  if ((OldAttributes & UnchangedAttributes) ^ (*Attributes & UnchangedAttributes)) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  //
+  // If firmware volume is locked, no status bit can be updated.
+  //
+  if (OldAttributes & EFI_FVB2_LOCK_STATUS) {
+    if (OldStatus ^ NewStatus) {
+      return EFI_ACCESS_DENIED;
+    }
+  }
+
+  //
+  // Test read disable.
+  //
+  if ((Capabilities & EFI_FVB2_READ_DISABLED_CAP) == 0) {
+    if ((NewStatus & EFI_FVB2_READ_STATUS) == 0) {
+      return EFI_INVALID_PARAMETER;
+    }
+  }
+
+  //
+  // Test read enable.
+  //
+  if ((Capabilities & EFI_FVB2_READ_ENABLED_CAP) == 0) {
+    if (NewStatus & EFI_FVB2_READ_STATUS) {
+      return EFI_INVALID_PARAMETER;
+    }
+  }
+
+  //
+  // Test write disable.
+  //
+  if ((Capabilities & EFI_FVB2_WRITE_DISABLED_CAP) == 0) {
+    if ((NewStatus & EFI_FVB2_WRITE_STATUS) == 0) {
+      return EFI_INVALID_PARAMETER;
+    }
+  }
+
+  //
+  // Test write enable.
+  //
+  if ((Capabilities & EFI_FVB2_WRITE_ENABLED_CAP) == 0) {
+    if (NewStatus & EFI_FVB2_WRITE_STATUS) {
+      return EFI_INVALID_PARAMETER;
+    }
+  }
+
+  //
+  // Test lock.
+  //
+  if ((Capabilities & EFI_FVB2_LOCK_CAP) == 0) {
+    if (NewStatus & EFI_FVB2_LOCK_STATUS) {
+      return EFI_INVALID_PARAMETER;
+    }
+  }
+
+  *AttribPtr = (*AttribPtr) & (0xFFFFFFFF & (~EFI_FVB2_STATUS));
+  *AttribPtr = (*AttribPtr) | NewStatus;
+  *Attributes = *AttribPtr;
+
+  return EFI_SUCCESS;
+}
+
+
+EFI_STATUS
+EFIAPI
+FvbProtocolGetPhysicalAddress (
+  IN CONST EFI_FIRMWARE_VOLUME_BLOCK_PROTOCOL *This,
+  OUT EFI_PHYSICAL_ADDRESS *Address
+  )
+{
+  *Address = mFvInstance->FvBase;
+  return EFI_SUCCESS;
+}
+
+
+EFI_STATUS
+EFIAPI
+FvbProtocolGetBlockSize (
+  IN CONST EFI_FIRMWARE_VOLUME_BLOCK_PROTOCOL *This,
+  IN CONST EFI_LBA Lba,
+  OUT UINTN *BlockSize,
+  OUT UINTN *NumOfBlocks
+  )
+/*++
+
+  Routine Description:
+    Retrieve the size of a logical block
+
+  Arguments:
+    This                  - Calling context
+    Lba                   - Indicates which block to return the size for.
+    BlockSize             - A pointer to a caller allocated UINTN in which
+                            the size of the block is returned
+    NumOfBlocks           - a pointer to a caller allocated UINTN in which the
+                            number of consecutive blocks starting with Lba is
+                            returned. All blocks in this range have a size of
+                            BlockSize
+
+  Returns:
+    EFI_SUCCESS           - The firmware volume was read successfully and
+                            contents are in Buffer
+
+--*/
+{
+  return FvbGetLbaAddress (
+           Lba,
+           NULL,
+           BlockSize,
+           NumOfBlocks
+         );
+}
+
+
+EFI_STATUS
+EFIAPI
+FvbProtocolGetAttributes (
+  IN CONST EFI_FIRMWARE_VOLUME_BLOCK_PROTOCOL *This,
+  OUT EFI_FVB_ATTRIBUTES_2 *Attributes
+  )
+/*++
+
+  Routine Description:
+      Retrieves Volume attributes.  No polarity translations are done.
+
+  Arguments:
+      This                - Calling context
+      Attributes          - output buffer which contains attributes
+
+  Returns:
+    EFI_SUCCESS           - Successfully returns
+
+--*/
+{
+  return FvbGetVolumeAttributes (Attributes);
+}
+
+
+EFI_STATUS
+EFIAPI
+FvbProtocolSetAttributes (
+  IN CONST EFI_FIRMWARE_VOLUME_BLOCK_PROTOCOL *This,
+  IN OUT EFI_FVB_ATTRIBUTES_2 *Attributes
+  )
+/*++
+
+  Routine Description:
+    Sets Volume attributes. No polarity translations are done.
+
+  Arguments:
+    This                  - Calling context
+    Attributes            - output buffer which contains attributes
+
+  Returns:
+    EFI_SUCCESS           - Successfully returns
+
+--*/
+{
+  return FvbSetVolumeAttributes (Attributes);
+}
+
+
+EFI_STATUS
+EFIAPI
+FvbProtocolEraseBlocks (
+  IN CONST EFI_FIRMWARE_VOLUME_BLOCK_PROTOCOL*This,
+  ...
+  )
+/*++
+
+  Routine Description:
+
+    The EraseBlock() function erases one or more blocks as denoted by the
+    variable argument list. The entire parameter list of blocks must be
+    verified prior to erasing any blocks.  If a block is requested that does
+    not exist within the associated firmware volume (it has a larger index than
+    the last block of the firmware volume), the EraseBlock() function must
+    return EFI_INVALID_PARAMETER without modifying the contents of the firmware
+    volume.
+
+  Arguments:
+    This                  - Calling context
+    ...                   - Starting LBA followed by Number of Lba to erase.
+                            a -1 to terminate the list.
+
+  Returns:
+    EFI_SUCCESS           - The erase request was successfully completed
+    EFI_ACCESS_DENIED     - The firmware volume is in the WriteDisabled state
+    EFI_DEVICE_ERROR      - The block device is not functioning correctly and
+                            could not be written. Firmware device may have been
+                            partially erased
+
+--*/
+{
+  UINTN NumOfBlocks;
+  VA_LIST args;
+  EFI_LBA StartingLba;
+  UINTN NumOfLba;
+  EFI_STATUS Status;
+
+  NumOfBlocks = mFvInstance->NumOfBlocks;
+  VA_START (args, This);
+
+  do {
+    StartingLba = VA_ARG (args, EFI_LBA);
+    if (StartingLba == EFI_LBA_LIST_TERMINATOR) {
+      break;
+    }
+
+    NumOfLba = VA_ARG (args, UINTN);
+
+    if ((NumOfLba == 0) || ((StartingLba + NumOfLba) > NumOfBlocks)) {
+      VA_END (args);
+      return EFI_INVALID_PARAMETER;
+    }
+  } while (1);
+
+  VA_END (args);
+
+  VA_START (args, This);
+  do {
+    StartingLba = VA_ARG (args, EFI_LBA);
+    if (StartingLba == EFI_LBA_LIST_TERMINATOR) {
+      break;
+    }
+
+    NumOfLba = VA_ARG (args, UINTN);
+
+    while (NumOfLba > 0) {
+      Status = FvbEraseBlock (StartingLba);
+      if (EFI_ERROR (Status)) {
+        VA_END (args);
+        return Status;
+      }
+
+      StartingLba++;
+      NumOfLba--;
+    }
+
+  } while (1);
+
+  VA_END (args);
+
+  return EFI_SUCCESS;
+}
+
+
+EFI_STATUS
+EFIAPI
+FvbProtocolWrite (
+  IN CONST EFI_FIRMWARE_VOLUME_BLOCK_PROTOCOL *This,
+  IN       EFI_LBA Lba,
+  IN       UINTN Offset,
+  IN OUT   UINTN *NumBytes,
+  IN       UINT8 *Buffer
+  )
+/*++
+
+  Routine Description:
+
+    Writes data beginning at Lba:Offset from FV. The write terminates either
+    when *NumBytes of data have been written, or when a block boundary is
+    reached.  *NumBytes is updated to reflect the actual number of bytes
+    written. The write opertion does not include erase. This routine will
+    attempt to write only the specified bytes. If the writes do not stick,
+    it will return an error.
+
+  Arguments:
+    This                  - Calling context
+    Lba                   - Block in which to begin write
+    Offset                - Offset in the block at which to begin write
+    NumBytes              - On input, indicates the requested write size. On
+                            output, indicates the actual number of bytes
+                            written
+    Buffer                - Buffer containing source data for the write.
+
+  Returns:
+    EFI_SUCCESS           - The firmware volume was written successfully
+    EFI_BAD_BUFFER_SIZE   - Write attempted across a LBA boundary. On output,
+                            NumBytes contains the total number of bytes
+                            actually written
+    EFI_ACCESS_DENIED     - The firmware volume is in the WriteDisabled state
+    EFI_DEVICE_ERROR      - The block device is not functioning correctly and
+                            could not be written
+    EFI_INVALID_PARAMETER - NumBytes or Buffer are NULL
+
+--*/
+{
+  EFI_FVB_ATTRIBUTES_2 Attributes;
+  UINTN LbaAddress;
+  UINTN LbaLength;
+  EFI_STATUS Status;
+  EFI_STATUS ReturnStatus;
+
+  //
+  // Check for invalid conditions.
+  //
+  if ((NumBytes == NULL) || (Buffer == NULL)) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  if (*NumBytes == 0) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  Status = FvbGetLbaAddress (Lba, &LbaAddress, &LbaLength, NULL);
+  if (EFI_ERROR (Status)) {
+    return Status;
+  }
+
+  //
+  // Check if the FV is write enabled.
+  //
+  FvbGetVolumeAttributes (&Attributes);
+
+  if ((Attributes & EFI_FVB2_WRITE_STATUS) == 0) {
+    return EFI_ACCESS_DENIED;
+  }
+
+  //
+  // Perform boundary checks and adjust NumBytes.
+  //
+  if (Offset > LbaLength) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  if (LbaLength < (*NumBytes + Offset)) {
+    *NumBytes = (UINT32)(LbaLength - Offset);
+    Status = EFI_BAD_BUFFER_SIZE;
+  }
+
+  ReturnStatus = VarStoreWrite (
+                   LbaAddress + Offset,
+                   NumBytes,
+                   Buffer
+                 );
+  if (EFI_ERROR (ReturnStatus)) {
+    return ReturnStatus;
+  }
+
+  return Status;
+}
+
+
+EFI_STATUS
+EFIAPI
+FvbProtocolRead (
+  IN CONST EFI_FIRMWARE_VOLUME_BLOCK_PROTOCOL *This,
+  IN CONST EFI_LBA Lba,
+  IN CONST UINTN Offset,
+  IN OUT UINTN *NumBytes,
+  IN UINT8 *Buffer
+  )
+/*++
+
+  Routine Description:
+
+    Reads data beginning at Lba:Offset from FV. The Read terminates either
+    when *NumBytes of data have been read, or when a block boundary is
+    reached.  *NumBytes is updated to reflect the actual number of bytes
+    written. The write opertion does not include erase. This routine will
+    attempt to write only the specified bytes. If the writes do not stick,
+    it will return an error.
+
+  Arguments:
+    This                  - Calling context
+    Lba                   - Block in which to begin Read
+    Offset                - Offset in the block at which to begin Read
+    NumBytes              - On input, indicates the requested write size. On
+                            output, indicates the actual number of bytes Read
+    Buffer                - Buffer containing source data for the Read.
+
+  Returns:
+    EFI_SUCCESS           - The firmware volume was read successfully and
+                            contents are in Buffer
+    EFI_BAD_BUFFER_SIZE   - Read attempted across a LBA boundary. On output,
+                            NumBytes contains the total number of bytes
+                            returned in Buffer
+    EFI_ACCESS_DENIED     - The firmware volume is in the ReadDisabled state
+    EFI_DEVICE_ERROR      - The block device is not functioning correctly and
+                            could not be read
+    EFI_INVALID_PARAMETER - NumBytes or Buffer are NULL
+
+--*/
+{
+  EFI_FVB_ATTRIBUTES_2 Attributes;
+  UINTN LbaAddress;
+  UINTN LbaLength;
+  EFI_STATUS Status;
+
+  //
+  // Check for invalid conditions.
+  //
+  if ((NumBytes == NULL) || (Buffer == NULL)) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  if (*NumBytes == 0) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  Status = FvbGetLbaAddress (Lba, &LbaAddress, &LbaLength, NULL);
+  if (EFI_ERROR (Status)) {
+    return Status;
+  }
+
+  //
+  // Check if the FV is read enabled.
+  //
+  FvbGetVolumeAttributes (&Attributes);
+
+  if ((Attributes & EFI_FVB2_READ_STATUS) == 0) {
+    return EFI_ACCESS_DENIED;
+  }
+
+  //
+  // Perform boundary checks and adjust NumBytes.
+  //
+  if (Offset > LbaLength) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  if (LbaLength < (*NumBytes + Offset)) {
+    *NumBytes = (UINT32)(LbaLength - Offset);
+    Status = EFI_BAD_BUFFER_SIZE;
+  }
+
+  CopyMem (Buffer, (VOID*)(LbaAddress + Offset), (UINTN)*NumBytes);
+
+  return Status;
+}
+
+
+EFI_STATUS
+ValidateFvHeader (
+  IN EFI_FIRMWARE_VOLUME_HEADER *FwVolHeader
+  )
+/*++
+
+  Routine Description:
+    Check the integrity of firmware volume header
+
+  Arguments:
+    FwVolHeader           - A pointer to a firmware volume header
+
+  Returns:
+    EFI_SUCCESS           - The firmware volume is consistent
+    EFI_NOT_FOUND         - The firmware volume has corrupted. So it is not an
+                            FV
+
+--*/
+{
+  UINT16 Checksum;
+
+  //
+  // Verify the header revision, header signature, length
+  // Length of FvBlock cannot be 2**64-1
+  // HeaderLength cannot be an odd number.
+  //
+  if ((FwVolHeader->Revision != EFI_FVH_REVISION) ||
+      (FwVolHeader->Signature != EFI_FVH_SIGNATURE) ||
+      (FwVolHeader->FvLength == ((UINTN)-1)) ||
+      ((FwVolHeader->HeaderLength & 0x01) != 0)
+      ) {
+    return EFI_NOT_FOUND;
+  }
+
+  //
+  // Verify the header checksum.
+  //
+
+  Checksum = CalculateSum16 ((UINT16*)FwVolHeader, FwVolHeader->HeaderLength);
+  if (Checksum != 0) {
+    UINT16 Expected;
+
+    Expected =
+      (UINT16)(((UINTN)FwVolHeader->Checksum + 0x10000 - Checksum) & 0xffff);
+
+    DEBUG ((DEBUG_INFO, "FV@%p Checksum is 0x%x, expected 0x%x\n",
+      FwVolHeader, FwVolHeader->Checksum, Expected));
+    return EFI_NOT_FOUND;
+  }
+
+  return EFI_SUCCESS;
+}
+
+
+EFI_STATUS
+EFIAPI
+FvbInitialize (
+  IN EFI_HANDLE         ImageHandle,
+  IN EFI_SYSTEM_TABLE   *SystemTable
+  )
+/*++
+
+  Routine Description:
+    This function does common initialization for FVB services
+
+  Arguments:
+
+  Returns:
+
+--*/
+{
+  EFI_STATUS Status;
+  UINT32 BufferSize;
+  EFI_FV_BLOCK_MAP_ENTRY *PtrBlockMapEntry;
+  EFI_FW_VOL_BLOCK_DEVICE *FvbDevice;
+  UINT32 MaxLbaSize;
+  EFI_PHYSICAL_ADDRESS BaseAddress;
+  UINTN Length;
+  UINTN NumOfBlocks;
+  RETURN_STATUS PcdStatus;
+  UINTN StartOffset;
+
+  BaseAddress = PcdGet32 (PcdNvStorageVariableBase);
+  Length = (FixedPcdGet32 (PcdFlashNvStorageVariableSize) +
+    FixedPcdGet32 (PcdFlashNvStorageFtwWorkingSize) +
+    FixedPcdGet32 (PcdFlashNvStorageFtwSpareSize) +
+    FixedPcdGet32 (PcdNvStorageEventLogSize));
+  StartOffset = BaseAddress - FixedPcdGet64 (PcdFdBaseAddress);
+
+  BufferSize = sizeof (EFI_FW_VOL_INSTANCE);
+
+  mFvInstance = AllocateRuntimeZeroPool (BufferSize);
+  if (mFvInstance == NULL) {
+    return EFI_OUT_OF_RESOURCES;
+  }
+
+  mFvInstance->FvBase = (UINTN)BaseAddress;
+  mFvInstance->FvLength = (UINTN)Length;
+  mFvInstance->Offset = StartOffset;
+  /*
+   * Should I parse config.txt instead and find the real name?
+   */
+  mFvInstance->MappedFile = L"RPI_EFI.FD";
+
+  Status = ValidateFvHeader (mFvInstance->VolumeHeader);
+  if (!EFI_ERROR (Status)) {
+    if (mFvInstance->VolumeHeader->FvLength != Length ||
+        mFvInstance->VolumeHeader->BlockMap[0].Length !=
+        PcdGet32 (PcdFirmwareBlockSize)) {
+      Status = EFI_VOLUME_CORRUPTED;
+    }
+  }
+  if (EFI_ERROR (Status)) {
+    EFI_FIRMWARE_VOLUME_HEADER *GoodFwVolHeader;
+    UINTN WriteLength;
+
+    DEBUG ((DEBUG_INFO,
+      "Variable FV header is not valid. It will be reinitialized.\n"));
+
+    //
+    // Get FvbInfo
+    //
+    Status = GetFvbInfo (Length, &GoodFwVolHeader);
+    ASSERT_EFI_ERROR (Status);
+
+    //
+    // Erase all the blocks
+    //
+    Status = VarStoreErase ((UINTN)mFvInstance->FvBase, mFvInstance->FvLength);
+    ASSERT_EFI_ERROR (Status);
+    //
+    // Write good FV header
+    //
+    WriteLength = GoodFwVolHeader->HeaderLength;
+    Status = VarStoreWrite ((UINTN)mFvInstance->FvBase, &WriteLength,
+               (UINT8*)GoodFwVolHeader);
+    ASSERT_EFI_ERROR (Status);
+    ASSERT (WriteLength == GoodFwVolHeader->HeaderLength);
+
+    Status = ValidateFvHeader (mFvInstance->VolumeHeader);
+    ASSERT_EFI_ERROR (Status);
+  }
+
+  MaxLbaSize = 0;
+  NumOfBlocks = 0;
+  for (PtrBlockMapEntry = mFvInstance->VolumeHeader->BlockMap;
+       PtrBlockMapEntry->NumBlocks != 0;
+       PtrBlockMapEntry++) {
+    //
+    // Get the maximum size of a block.
+    //
+    if (MaxLbaSize < PtrBlockMapEntry->Length) {
+      MaxLbaSize = PtrBlockMapEntry->Length;
+    }
+
+    NumOfBlocks = NumOfBlocks + PtrBlockMapEntry->NumBlocks;
+  }
+
+  //
+  // The total number of blocks in the FV.
+  //
+  mFvInstance->NumOfBlocks = NumOfBlocks;
+
+  //
+  // Add a FVB Protocol Instance
+  //
+  FvbDevice = AllocateRuntimePool (sizeof (EFI_FW_VOL_BLOCK_DEVICE));
+  ASSERT (FvbDevice != NULL);
+  CopyMem (FvbDevice, &mFvbDeviceTemplate, sizeof (EFI_FW_VOL_BLOCK_DEVICE));
+
+  //
+  // Set up the devicepath
+  //
+  if (mFvInstance->VolumeHeader->ExtHeaderOffset == 0) {
+    FV_MEMMAP_DEVICE_PATH *FvMemmapDevicePath;
+
+    //
+    // FV does not contains extension header, then produce MEMMAP_DEVICE_PATH
+    //
+    FvMemmapDevicePath = AllocateCopyPool (sizeof (FV_MEMMAP_DEVICE_PATH),
+                           &mFvMemmapDevicePathTemplate);
+    FvMemmapDevicePath->MemMapDevPath.StartingAddress = mFvInstance->FvBase;
+    FvMemmapDevicePath->MemMapDevPath.EndingAddress = mFvInstance->FvBase +
+      mFvInstance->FvLength - 1;
+    FvbDevice->DevicePath = (EFI_DEVICE_PATH_PROTOCOL*)FvMemmapDevicePath;
+  } else {
+    FV_PIWG_DEVICE_PATH *FvPiwgDevicePath;
+
+    FvPiwgDevicePath = AllocateCopyPool (sizeof (FV_PIWG_DEVICE_PATH),
+                         &mFvPIWGDevicePathTemplate);
+    CopyGuid (&FvPiwgDevicePath->FvDevPath.FvName,
+      (GUID*)(UINTN)(mFvInstance->FvBase + mFvInstance->VolumeHeader->ExtHeaderOffset));
+    FvbDevice->DevicePath = (EFI_DEVICE_PATH_PROTOCOL*)FvPiwgDevicePath;
+  }
+
+  //
+  // Module type specific hook.
+  //
+  InstallProtocolInterfaces (FvbDevice);
+
+  //
+  // Set several PCD values to point to flash.
+  //
+  PcdStatus = PcdSet64S (PcdFlashNvStorageVariableBase64,
+                (UINTN)PcdGet32 (PcdNvStorageVariableBase));
+  ASSERT_RETURN_ERROR (PcdStatus);
+  PcdStatus = PcdSet32S (PcdFlashNvStorageFtwWorkingBase,
+                PcdGet32 (PcdNvStorageFtwWorkingBase));
+  ASSERT_RETURN_ERROR (PcdStatus);
+  PcdStatus = PcdSet32S (PcdFlashNvStorageFtwSpareBase,
+                PcdGet32 (PcdNvStorageFtwSpareBase));
+  ASSERT_RETURN_ERROR (PcdStatus);
+
+  InstallFSNotifyHandler ();
+  InstallDumpVarEventHandlers ();
+  InstallVirtualAddressChangeHandler ();
+
+  return EFI_SUCCESS;
+}
diff --git a/Platform/RaspberryPi/RPi3/Drivers/VarBlockServiceDxe/VarBlockService.h b/Platform/RaspberryPi/RPi3/Drivers/VarBlockServiceDxe/VarBlockService.h
new file mode 100644
index 000000000000..3596c4ac55b9
--- /dev/null
+++ b/Platform/RaspberryPi/RPi3/Drivers/VarBlockServiceDxe/VarBlockService.h
@@ -0,0 +1,217 @@
+/** @file
+ *
+ *  Copyright (c) 2018, Andrei Warkentin <andrey.warkentin@gmail.com>
+ *  Copyright (c) 2007-2009, Intel Corporation. All rights reserved.
+ *
+ *  This program and the accompanying materials
+ *  are licensed and made available under the terms and conditions of the BSD License
+ *  which accompanies this distribution.  The full text of the license may be found at
+ *  http://opensource.org/licenses/bsd-license.php
+ *
+ *  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+ *  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+ *
+ **/
+
+#ifndef _FW_BLOCK_SERVICE_H
+#define _FW_BLOCK_SERVICE_H
+
+#include <Guid/EventGroup.h>
+#include <Library/DebugLib.h>
+#include <Library/DevicePathLib.h>
+#include <Library/PcdLib.h>
+#include <Library/UefiBootServicesTableLib.h>
+#include <Library/UefiRuntimeLib.h>
+#include <Protocol/DevicePath.h>
+#include <Protocol/FirmwareVolumeBlock.h>
+#include <Protocol/SimpleFileSystem.h>
+#include <Protocol/BlockIo.h>
+#include <Protocol/LoadedImage.h>
+
+typedef struct {
+  union {
+    UINTN                      FvBase;
+    EFI_FIRMWARE_VOLUME_HEADER *VolumeHeader;
+  };
+  UINTN                      FvLength;
+  UINTN                      Offset;
+  UINTN                      NumOfBlocks;
+  EFI_DEVICE_PATH_PROTOCOL   *Device;
+  CHAR16                     *MappedFile;
+  BOOLEAN                    Dirty;
+} EFI_FW_VOL_INSTANCE;
+
+extern EFI_FW_VOL_INSTANCE *mFvInstance;
+
+typedef struct {
+  MEDIA_FW_VOL_DEVICE_PATH  FvDevPath;
+  EFI_DEVICE_PATH_PROTOCOL  EndDevPath;
+} FV_PIWG_DEVICE_PATH;
+
+typedef struct {
+  MEMMAP_DEVICE_PATH          MemMapDevPath;
+  EFI_DEVICE_PATH_PROTOCOL    EndDevPath;
+} FV_MEMMAP_DEVICE_PATH;
+
+typedef struct {
+  EFI_DEVICE_PATH_PROTOCOL            *DevicePath;
+  EFI_FIRMWARE_VOLUME_BLOCK_PROTOCOL  FwVolBlockInstance;
+} EFI_FW_VOL_BLOCK_DEVICE;
+
+EFI_STATUS
+GetFvbInfo (
+  IN  UINT64                            FvLength,
+  OUT EFI_FIRMWARE_VOLUME_HEADER        **FvbInfo
+  );
+
+EFI_STATUS
+FvbSetVolumeAttributes (
+  IN OUT EFI_FVB_ATTRIBUTES_2 *Attributes
+  );
+
+EFI_STATUS
+FvbGetVolumeAttributes (
+  OUT EFI_FVB_ATTRIBUTES_2 *Attributes
+  );
+
+EFI_STATUS
+FvbGetPhysicalAddress (
+  OUT EFI_PHYSICAL_ADDRESS *Address
+  );
+
+EFI_STATUS
+EFIAPI
+FvbInitialize (
+  IN EFI_HANDLE         ImageHandle,
+  IN EFI_SYSTEM_TABLE   *SystemTable
+  );
+
+
+VOID
+EFIAPI
+FvbClassAddressChangeEvent (
+  IN EFI_EVENT        Event,
+  IN VOID             *Context
+  );
+
+EFI_STATUS
+FvbGetLbaAddress (
+  IN  EFI_LBA Lba,
+  OUT UINTN   *LbaAddress,
+  OUT UINTN   *LbaLength,
+  OUT UINTN   *NumOfBlocks
+  );
+
+//
+// Protocol APIs
+//
+EFI_STATUS
+EFIAPI
+FvbProtocolGetAttributes (
+  IN CONST EFI_FIRMWARE_VOLUME_BLOCK_PROTOCOL           *This,
+  OUT EFI_FVB_ATTRIBUTES_2                              *Attributes
+  );
+
+EFI_STATUS
+EFIAPI
+FvbProtocolSetAttributes (
+  IN CONST EFI_FIRMWARE_VOLUME_BLOCK_PROTOCOL           *This,
+  IN OUT EFI_FVB_ATTRIBUTES_2                           *Attributes
+  );
+
+EFI_STATUS
+EFIAPI
+FvbProtocolGetPhysicalAddress (
+  IN CONST EFI_FIRMWARE_VOLUME_BLOCK_PROTOCOL           *This,
+  OUT EFI_PHYSICAL_ADDRESS                        *Address
+  );
+
+EFI_STATUS
+EFIAPI
+FvbProtocolGetBlockSize (
+  IN CONST EFI_FIRMWARE_VOLUME_BLOCK_PROTOCOL           *This,
+  IN CONST EFI_LBA                                     Lba,
+  OUT UINTN                                       *BlockSize,
+  OUT UINTN                                       *NumOfBlocks
+  );
+
+EFI_STATUS
+EFIAPI
+FvbProtocolRead (
+  IN CONST EFI_FIRMWARE_VOLUME_BLOCK_PROTOCOL           *This,
+  IN CONST EFI_LBA                                      Lba,
+  IN CONST UINTN                                        Offset,
+  IN OUT UINTN                                    *NumBytes,
+  IN UINT8                                        *Buffer
+  );
+
+EFI_STATUS
+EFIAPI
+FvbProtocolWrite (
+  IN CONST EFI_FIRMWARE_VOLUME_BLOCK_PROTOCOL           *This,
+  IN       EFI_LBA                                      Lba,
+  IN       UINTN                                        Offset,
+  IN OUT   UINTN                                        *NumBytes,
+  IN       UINT8                                        *Buffer
+  );
+
+EFI_STATUS
+EFIAPI
+FvbProtocolEraseBlocks (
+  IN CONST EFI_FIRMWARE_VOLUME_BLOCK_PROTOCOL    *This,
+  ...
+  );
+
+VOID
+InstallProtocolInterfaces (
+  IN EFI_FW_VOL_BLOCK_DEVICE *FvbDevice
+  );
+
+VOID
+InstallVirtualAddressChangeHandler (
+  VOID
+  );
+
+VOID
+InstallFSNotifyHandler (
+  VOID
+  );
+
+VOID
+InstallDumpVarEventHandlers (
+  VOID
+);
+
+EFI_STATUS
+FileWrite (
+  IN EFI_FILE_PROTOCOL *File,
+  IN UINTN             Offset,
+  IN UINTN             Buffer,
+  IN UINTN             Size
+  );
+
+EFI_STATUS
+CheckStore (
+  IN  EFI_HANDLE SimpleFileSystemHandle,
+  OUT EFI_DEVICE_PATH_PROTOCOL **Device
+  );
+
+EFI_STATUS
+CheckStoreExists (
+  IN  EFI_DEVICE_PATH_PROTOCOL *Device
+  );
+
+EFI_STATUS
+FileOpen (
+  IN  EFI_DEVICE_PATH_PROTOCOL *Device,
+  IN  CHAR16 *MappedFile,
+  OUT EFI_FILE_PROTOCOL **File,
+  IN  UINT64 OpenMode
+  );
+
+VOID
+FileClose (
+  IN  EFI_FILE_PROTOCOL *File
+  );
+
+#endif
diff --git a/Platform/RaspberryPi/RPi3/Drivers/VarBlockServiceDxe/VarBlockServiceDxe.c b/Platform/RaspberryPi/RPi3/Drivers/VarBlockServiceDxe/VarBlockServiceDxe.c
new file mode 100644
index 000000000000..3c6ede74c21c
--- /dev/null
+++ b/Platform/RaspberryPi/RPi3/Drivers/VarBlockServiceDxe/VarBlockServiceDxe.c
@@ -0,0 +1,331 @@
+/** @file
+ *
+ *  Copyright (c) 2018, Andrei Warkentin <andrey.warkentin@gmail.com>
+ *  Copyright (C) 2015, Red Hat, Inc.
+ *  Copyright (c) 2006-2014, Intel Corporation. All rights reserved.
+ *
+ *  This program and the accompanying materials
+ *  are licensed and made available under the terms and conditions of the BSD License
+ *  which accompanies this distribution.  The full text of the license may be found at
+ *  http://opensource.org/licenses/bsd-license.php
+ *
+ *  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+ *  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+ *
+ **/
+
+#include "VarBlockService.h"
+
+VOID *mSFSRegistration;
+
+
+VOID
+InstallProtocolInterfaces (
+  IN EFI_FW_VOL_BLOCK_DEVICE *FvbDevice
+  )
+{
+  EFI_STATUS Status;
+  EFI_HANDLE FwbHandle;
+  EFI_FIRMWARE_VOLUME_BLOCK_PROTOCOL *OldFwbInterface;
+
+  //
+  // Find a handle with a matching device path that has supports FW Block
+  // protocol.
+  //
+  Status = gBS->LocateDevicePath (&gEfiFirmwareVolumeBlockProtocolGuid,
+                  &FvbDevice->DevicePath, &FwbHandle);
+  if (EFI_ERROR (Status)) {
+    //
+    // LocateDevicePath fails so install a new interface and device path.
+    //
+    FwbHandle = NULL;
+    Status = gBS->InstallMultipleProtocolInterfaces (
+                    &FwbHandle,
+                    &gEfiFirmwareVolumeBlockProtocolGuid,
+                    &FvbDevice->FwVolBlockInstance,
+                    &gEfiDevicePathProtocolGuid,
+                    FvbDevice->DevicePath,
+                    NULL
+                  );
+    ASSERT_EFI_ERROR (Status);
+  } else if (IsDevicePathEnd (FvbDevice->DevicePath)) {
+    //
+    // Device already exists, so reinstall the FVB protocol
+    //
+    Status = gBS->HandleProtocol (
+                    FwbHandle,
+                    &gEfiFirmwareVolumeBlockProtocolGuid,
+                    (VOID**)&OldFwbInterface
+                  );
+    ASSERT_EFI_ERROR (Status);
+
+    Status = gBS->ReinstallProtocolInterface (
+                    FwbHandle,
+                    &gEfiFirmwareVolumeBlockProtocolGuid,
+                    OldFwbInterface,
+                    &FvbDevice->FwVolBlockInstance
+                  );
+    ASSERT_EFI_ERROR (Status);
+  } else {
+    //
+    // There was a FVB protocol on an End Device Path node
+    //
+    ASSERT (FALSE);
+  }
+}
+
+
+STATIC
+VOID
+EFIAPI
+FvbVirtualAddressChangeEvent (
+  IN EFI_EVENT Event,
+  IN VOID *Context
+  )
+/*++
+
+  Routine Description:
+
+    Fixup internal data so that EFI can be called in virtual mode.
+
+  Arguments:
+
+    (Standard EFI notify event - EFI_EVENT_NOTIFY)
+
+  Returns:
+
+    None
+
+--*/
+{
+  EfiConvertPointer (0x0, (VOID**)&mFvInstance->FvBase);
+  EfiConvertPointer (0x0, (VOID**)&mFvInstance->VolumeHeader);
+  EfiConvertPointer (0x0, (VOID**)&mFvInstance);
+}
+
+
+VOID
+InstallVirtualAddressChangeHandler (
+  VOID
+  )
+{
+  EFI_STATUS Status;
+  EFI_EVENT VirtualAddressChangeEvent;
+
+  Status = gBS->CreateEventEx (
+                  EVT_NOTIFY_SIGNAL,
+                  TPL_NOTIFY,
+                  FvbVirtualAddressChangeEvent,
+                  NULL,
+                  &gEfiEventVirtualAddressChangeGuid,
+                  &VirtualAddressChangeEvent
+                );
+  ASSERT_EFI_ERROR (Status);
+}
+
+
+STATIC
+EFI_STATUS
+DoDump (
+  IN EFI_DEVICE_PATH_PROTOCOL *Device
+  )
+{
+  EFI_STATUS Status;
+  EFI_FILE_PROTOCOL *File;
+
+  Status = FileOpen (Device,
+             mFvInstance->MappedFile,
+             &File,
+             EFI_FILE_MODE_WRITE |
+             EFI_FILE_MODE_READ);
+  if (EFI_ERROR (Status)) {
+    return Status;
+  }
+
+  Status = FileWrite (File,
+             mFvInstance->Offset,
+             mFvInstance->FvBase,
+             mFvInstance->FvLength);
+  FileClose (File);
+  return Status;
+}
+
+
+STATIC
+VOID
+EFIAPI
+DumpVars (
+  IN EFI_EVENT Event,
+  IN VOID *Context
+  )
+{
+  EFI_STATUS Status;
+
+  if (mFvInstance->Device == NULL) {
+    DEBUG ((DEBUG_INFO, "Variable store not found?\n"));
+    return;
+  }
+
+  if (!mFvInstance->Dirty) {
+    DEBUG ((DEBUG_INFO, "Variables not dirty, not dumping!\n"));
+    return;
+  }
+
+  Status = DoDump (mFvInstance->Device);
+  if (EFI_ERROR (Status)) {
+    DEBUG ((DEBUG_ERROR, "Couldn't dump '%s'\n", mFvInstance->MappedFile));
+    ASSERT_EFI_ERROR (Status);
+    return;
+  }
+
+  DEBUG ((DEBUG_INFO, "Variables dumped!\n"));
+  mFvInstance->Dirty = FALSE;
+}
+
+
+VOID
+ReadyToBootHandler (
+  IN EFI_EVENT Event,
+  IN VOID *Context
+  )
+{
+  EFI_STATUS Status;
+  EFI_EVENT ImageInstallEvent;
+  VOID *ImageRegistration;
+
+  Status = gBS->CreateEvent (
+                  EVT_NOTIFY_SIGNAL,
+                  TPL_CALLBACK,
+                  DumpVars,
+                  NULL,
+                  &ImageInstallEvent
+                );
+  ASSERT_EFI_ERROR (Status);
+
+  Status = gBS->RegisterProtocolNotify (
+                  &gEfiLoadedImageProtocolGuid,
+                  ImageInstallEvent,
+                  &ImageRegistration
+                );
+  ASSERT_EFI_ERROR (Status);
+
+  DumpVars (NULL, NULL);
+  Status = gBS->CloseEvent (Event);
+  ASSERT_EFI_ERROR (Status);
+}
+
+
+VOID
+InstallDumpVarEventHandlers (
+  VOID
+  )
+{
+  EFI_STATUS Status;
+  EFI_EVENT ResetEvent;
+  EFI_EVENT ReadyToBootEvent;
+
+  Status = gBS->CreateEventEx (
+                  EVT_NOTIFY_SIGNAL,
+                  TPL_CALLBACK,
+                  DumpVars,
+                  NULL,
+                  &gRaspberryPiEventResetGuid,
+                  &ResetEvent
+                );
+  ASSERT_EFI_ERROR (Status);
+
+  Status = gBS->CreateEventEx (
+                  EVT_NOTIFY_SIGNAL,
+                  TPL_CALLBACK,
+                  ReadyToBootHandler,
+                  NULL,
+                  &gEfiEventReadyToBootGuid,
+                  &ReadyToBootEvent
+                );
+  ASSERT_EFI_ERROR (Status);
+}
+
+
+VOID
+EFIAPI
+OnSimpleFileSystemInstall (
+  IN EFI_EVENT Event,
+  IN VOID *Context
+  )
+{
+  EFI_STATUS Status;
+  UINTN HandleSize;
+  EFI_HANDLE Handle;
+  EFI_DEVICE_PATH_PROTOCOL *Device;
+
+  if ((mFvInstance->Device != NULL) &&
+      !EFI_ERROR (CheckStoreExists (mFvInstance->Device))) {
+    //
+    // We've already found the variable store before,
+    // and that device is not removed from the ssystem.
+    //
+    return;
+  }
+
+  while (TRUE) {
+    HandleSize = sizeof (EFI_HANDLE);
+    Status = gBS->LocateHandle (
+                    ByRegisterNotify,
+                    NULL,
+                    mSFSRegistration,
+                    &HandleSize,
+                    &Handle
+                  );
+    if (Status == EFI_NOT_FOUND) {
+      break;
+    }
+
+    ASSERT_EFI_ERROR (Status);
+
+    Status = CheckStore (Handle, &Device);
+    if (EFI_ERROR (Status)) {
+      continue;
+    }
+
+    Status = DoDump (Device);
+    if (EFI_ERROR (Status)) {
+      DEBUG ((DEBUG_ERROR, "Couldn't update '%s'\n", mFvInstance->MappedFile));
+      ASSERT_EFI_ERROR (Status);
+      continue;
+    }
+
+    if (mFvInstance->Device != NULL) {
+      gBS->FreePool (mFvInstance->Device);
+    }
+
+    DEBUG ((DEBUG_INFO, "Found variable store!\n"));
+    mFvInstance->Device = Device;
+    break;
+  }
+}
+
+
+VOID
+InstallFSNotifyHandler (
+  VOID
+  )
+{
+  EFI_STATUS Status;
+  EFI_EVENT Event;
+
+  Status = gBS->CreateEvent (
+                  EVT_NOTIFY_SIGNAL,
+                  TPL_CALLBACK,
+                  OnSimpleFileSystemInstall,
+                  NULL,
+                  &Event
+                );
+  ASSERT_EFI_ERROR (Status);
+
+  Status = gBS->RegisterProtocolNotify (
+                  &gEfiSimpleFileSystemProtocolGuid,
+                  Event,
+                  &mSFSRegistration
+                );
+  ASSERT_EFI_ERROR (Status);
+}
diff --git a/Platform/RaspberryPi/RPi3/Drivers/VarBlockServiceDxe/VarBlockServiceDxe.inf b/Platform/RaspberryPi/RPi3/Drivers/VarBlockServiceDxe/VarBlockServiceDxe.inf
new file mode 100644
index 000000000000..f440e4eee8f3
--- /dev/null
+++ b/Platform/RaspberryPi/RPi3/Drivers/VarBlockServiceDxe/VarBlockServiceDxe.inf
@@ -0,0 +1,93 @@
+#/** @file
+#
+#  Support for the FS-backed "flash" device.
+#  The trick is to keep it inside the RPI firmware file itself...
+#
+#  Copyright (c) 2018, Andrei Warkentin <andrey.warkentin@gmail.com>
+#  Copyright (c) 2006-2013, Intel Corporation. All rights reserved.
+#
+#  This program and the accompanying materials are licensed and made available
+#  under the terms and conditions of the BSD License which accompanies this
+#  distribution. The full text of the license may be found at
+#  http://opensource.org/licenses/bsd-license.php
+#
+#  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+#  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR
+#  IMPLIED.
+#
+#**/
+
+[Defines]
+  INF_VERSION                    = 0x0001001A
+  BASE_NAME                      = VarBlockServiceDxe
+  FILE_GUID                      = 733cbac2-b23f-4b92-bc8e-fb01ce5907b7
+  MODULE_TYPE                    = DXE_RUNTIME_DRIVER
+  VERSION_STRING                 = 1.0
+  ENTRY_POINT                    = FvbInitialize
+
+#
+# The following information is for reference only and not required by the build
+# tools.
+#
+#  VALID_ARCHITECTURES           = AARCH64
+#
+
+[Sources]
+  FvbInfo.c
+  VarBlockService.c
+  VarBlockServiceDxe.c
+  FileIo.c
+
+[Packages]
+  ArmPkg/ArmPkg.dec
+  MdePkg/MdePkg.dec
+  MdeModulePkg/MdeModulePkg.dec
+  Platform/RaspberryPi/RPi3/RPi3.dec
+
+[LibraryClasses]
+  BaseLib
+  BaseMemoryLib
+  DebugLib
+  DevicePathLib
+  DxeServicesTableLib
+  MemoryAllocationLib
+  PcdLib
+  UefiBootServicesTableLib
+  UefiDriverEntryPoint
+  UefiRuntimeLib
+
+[Guids]
+  gEfiEventVirtualAddressChangeGuid
+  gRaspberryPiEventResetGuid
+  gEfiEventReadyToBootGuid
+
+[Protocols]
+  gEfiSimpleFileSystemProtocolGuid
+  gEfiLoadedImageProtocolGuid
+  gEfiBlockIoProtocolGuid
+  gEfiFirmwareVolumeBlockProtocolGuid           # PROTOCOL SOMETIMES_PRODUCED
+  gEfiDevicePathProtocolGuid                    # PROTOCOL SOMETIMES_PRODUCED
+
+[FixedPcd]
+  gEfiMdeModulePkgTokenSpaceGuid.PcdFlashNvStorageVariableSize
+  gEfiMdeModulePkgTokenSpaceGuid.PcdFlashNvStorageFtwWorkingSize
+  gEfiMdeModulePkgTokenSpaceGuid.PcdFlashNvStorageFtwSpareSize
+  gRaspberryPiTokenSpaceGuid.PcdNvStorageVariableBase
+  gRaspberryPiTokenSpaceGuid.PcdNvStorageFtwWorkingBase
+  gRaspberryPiTokenSpaceGuid.PcdNvStorageFtwSpareBase
+  gRaspberryPiTokenSpaceGuid.PcdNvStorageEventLogSize
+  gRaspberryPiTokenSpaceGuid.PcdFirmwareBlockSize
+  gArmTokenSpaceGuid.PcdFdBaseAddress
+  gArmTokenSpaceGuid.PcdFdSize
+
+[Pcd]
+  gEfiMdeModulePkgTokenSpaceGuid.PcdFlashNvStorageFtwWorkingBase
+  gEfiMdeModulePkgTokenSpaceGuid.PcdFlashNvStorageFtwSpareBase
+  gEfiMdeModulePkgTokenSpaceGuid.PcdFlashNvStorageVariableBase
+  gRaspberryPiTokenSpaceGuid.PcdNvStorageEventLogBase
+  gEfiMdeModulePkgTokenSpaceGuid.PcdFlashNvStorageVariableBase64
+
+[FeaturePcd]
+
+[Depex]
+  TRUE
-- 
2.17.0.windows.1



^ permalink raw reply related	[flat|nested] 34+ messages in thread

* [PATCH v5 edk2-platforms 12/22] Platform/RaspberryPi/RPi3: Add Device Tree driver
  2019-02-05 16:25 [PATCH v5 edk2-platforms 00/22] Platform/RaspberryPi: Add Raspberry Pi 3 support Pete Batard
                   ` (10 preceding siblings ...)
  2019-02-05 16:25 ` [PATCH v5 edk2-platforms 11/22] Platform/RaspberryPi/RPi3: Add NV storage driver Pete Batard
@ 2019-02-05 16:25 ` Pete Batard
  2019-02-05 16:25 ` [PATCH v5 edk2-platforms 13/22] Platform/RaspberryPi/RPi3: Add base MMC driver Pete Batard
                   ` (11 subsequent siblings)
  23 siblings, 0 replies; 34+ messages in thread
From: Pete Batard @ 2019-02-05 16:25 UTC (permalink / raw)
  To: edk2-devel

This driver serves the device tree that is either embedded
in the firmware volume or was provided through config.txt.

Contributed-under: TianoCore Contribution Agreement 1.1
Signed-off-by: Pete Batard <pete@akeo.ie>
---
 Platform/RaspberryPi/RPi3/Drivers/FdtDxe/FdtDxe.c   | 364 ++++++++++++++++++++
 Platform/RaspberryPi/RPi3/Drivers/FdtDxe/FdtDxe.inf |  53 +++
 2 files changed, 417 insertions(+)

diff --git a/Platform/RaspberryPi/RPi3/Drivers/FdtDxe/FdtDxe.c b/Platform/RaspberryPi/RPi3/Drivers/FdtDxe/FdtDxe.c
new file mode 100644
index 000000000000..eb5698cb505b
--- /dev/null
+++ b/Platform/RaspberryPi/RPi3/Drivers/FdtDxe/FdtDxe.c
@@ -0,0 +1,364 @@
+/** @file
+ *
+ *  Copyright (c) 2017, Andrey Warkentin <andrey.warkentin@gmail.com>
+ *  Copyright (c) 2016, Linaro, Ltd. All rights reserved.
+ *
+ *  This program and the accompanying materials
+ *  are licensed and made available under the terms and conditions of the BSD License
+ *  which accompanies this distribution.  The full text of the license may be found at
+ *  http://opensource.org/licenses/bsd-license.php
+ *
+ *  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+ *  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+ *
+ **/
+#include <PiDxe.h>
+
+#include <Library/BaseLib.h>
+#include <Library/DebugLib.h>
+#include <Library/DxeServicesLib.h>
+#include <Library/MemoryAllocationLib.h>
+#include <Library/UefiBootServicesTableLib.h>
+#include <libfdt.h>
+
+#include <Protocol/RpiFirmware.h>
+
+#include <Guid/Fdt.h>
+
+STATIC VOID                             *mFdtImage;
+
+STATIC RASPBERRY_PI_FIRMWARE_PROTOCOL   *mFwProtocol;
+
+STATIC
+VOID
+UpdateMacAddress (
+  VOID
+  )
+{
+  INTN          Node;
+  INTN          Retval;
+  EFI_STATUS    Status;
+  UINT8         MacAddress[6];
+
+  //
+  // Locate the node that the 'ethernet' alias refers to
+  //
+  Node = fdt_path_offset (mFdtImage, "ethernet");
+  if (Node < 0) {
+    DEBUG ((DEBUG_ERROR, "%a: failed to locate 'ethernet' alias\n", __FUNCTION__));
+    return;
+  }
+
+  //
+  // Get the MAC address from the firmware
+  //
+  Status = mFwProtocol->GetMacAddress (MacAddress);
+  if (EFI_ERROR (Status)) {
+    DEBUG ((DEBUG_ERROR, "%a: failed to retrieve MAC address\n", __FUNCTION__));
+    return;
+  }
+
+  Retval = fdt_setprop (mFdtImage, Node, "mac-address", MacAddress,
+    sizeof MacAddress);
+  if (Retval != 0) {
+    DEBUG ((DEBUG_ERROR, "%a: failed to create 'mac-address' property (%d)\n",
+      __FUNCTION__, Retval));
+    return;
+  }
+
+  DEBUG ((DEBUG_INFO, "%a: setting MAC address to %02x:%02x:%02x:%02x:%02x:%02x\n",
+    __FUNCTION__, MacAddress[0], MacAddress[1], MacAddress[2], MacAddress[3],
+    MacAddress[4], MacAddress[5]));
+}
+
+STATIC
+VOID
+CleanMemoryNodes (
+  VOID
+  )
+{
+  INTN Node;
+  INT32 Retval;
+
+  Node = fdt_path_offset (mFdtImage, "/memory");
+  if (Node < 0) {
+    return;
+  }
+
+  /*
+   * Remove bogus memory nodes which can make the booted
+   * OS go crazy and ignore the UEFI map.
+   */
+  DEBUG ((DEBUG_INFO, "Removing bogus /memory\n"));
+  Retval = fdt_del_node (mFdtImage, Node);
+  if (Retval != 0) {
+    DEBUG ((DEBUG_ERROR, "Failed to remove /memory\n"));
+  }
+}
+
+STATIC
+VOID
+SanitizePSCI (
+  VOID
+  )
+{
+  INTN Node;
+  INTN Root;
+  INT32 Retval;
+
+  Root = fdt_path_offset (mFdtImage, "/");
+  ASSERT (Root >= 0);
+  if (Root < 0) {
+    return;
+  }
+
+  Node = fdt_path_offset (mFdtImage, "/psci");
+  if (Node < 0) {
+    Node = fdt_add_subnode (mFdtImage, Root, "psci");
+  }
+
+  ASSERT (Node >= 0);
+  if (Node < 0) {
+    DEBUG ((DEBUG_ERROR, "Couldn't find/create /psci\n"));
+    return;
+  }
+
+  Retval = fdt_setprop_string (mFdtImage, Node, "compatible", "arm,psci-1.0");
+  if (Retval != 0) {
+    DEBUG ((DEBUG_ERROR, "Couldn't set /psci compatible property\n"));
+    return;
+  }
+
+  Retval = fdt_setprop_string (mFdtImage, Node, "method", "smc");
+  if (Retval != 0) {
+    DEBUG ((DEBUG_ERROR, "Couldn't set /psci method property\n"));
+    return;
+  }
+
+  Root = fdt_path_offset (mFdtImage, "/cpus");
+  if (Root < 0) {
+    DEBUG ((DEBUG_ERROR, "No CPUs to update with PSCI enable-method?\n"));
+    return;
+  }
+
+  Node = fdt_first_subnode (mFdtImage, Root);
+  while (Node >= 0) {
+    if (fdt_setprop_string (mFdtImage, Node, "enable-method", "psci") != 0) {
+      DEBUG ((DEBUG_ERROR, "Failed to update enable-method for a CPU\n"));
+      return;
+    }
+
+    fdt_delprop (mFdtImage, Node, "cpu-release-addr");
+    Node = fdt_next_subnode (mFdtImage, Node);
+  }
+}
+
+STATIC
+VOID
+CleanSimpleFramebuffer (
+  VOID
+  )
+{
+  INTN Node;
+  INT32 Retval;
+
+  /*
+   * Should look for nodes by kind and remove aliases
+   * by matching against device.
+   */
+  Node = fdt_path_offset (mFdtImage, "display0");
+  if (Node < 0) {
+    return;
+  }
+
+  /*
+   * Remove bogus GPU-injected simple-framebuffer, which
+   * doesn't reflect the framebuffer built by UEFI.
+   */
+  DEBUG ((DEBUG_INFO, "Removing bogus display0\n"));
+  Retval = fdt_del_node (mFdtImage, Node);
+  if (Retval != 0) {
+    DEBUG ((DEBUG_ERROR, "Failed to remove display0\n"));
+    return;
+  }
+
+  Node = fdt_path_offset (mFdtImage, "/aliases");
+  if (Node < 0) {
+    DEBUG ((DEBUG_ERROR, "Couldn't find /aliases to remove display0\n"));
+    return;
+  }
+
+  Retval = fdt_delprop (mFdtImage, Node, "display0");
+  if (Retval != 0) {
+    DEBUG ((DEBUG_ERROR, "Failed to remove display0 alias\n"));
+  }
+}
+
+#define MAX_CMDLINE_SIZE    512
+
+STATIC
+VOID
+UpdateBootArgs (
+  VOID
+  )
+{
+  INTN          Node;
+  INTN          Retval;
+  EFI_STATUS    Status;
+  CHAR8         *CommandLine;
+
+  //
+  // Locate the /chosen node
+  //
+  Node = fdt_path_offset (mFdtImage, "/chosen");
+  if (Node < 0) {
+    DEBUG ((DEBUG_ERROR, "%a: failed to locate /chosen node\n", __FUNCTION__));
+    return;
+  }
+
+  //
+  // If /chosen/bootargs already exists, we want to add a space character
+  // before adding the firmware supplied arguments. However, the RpiFirmware
+  // protocol expects a 32-bit aligned buffer. So let's allocate 4 bytes of
+  // slack, and skip the first 3 when passing this buffer into libfdt.
+  //
+  CommandLine = AllocatePool (MAX_CMDLINE_SIZE) + 4;
+  if (!CommandLine) {
+    DEBUG ((DEBUG_ERROR, "%a: failed to allocate memory\n", __FUNCTION__));
+    return;
+  }
+
+  //
+  // Get the command line from the firmware
+  //
+  Status = mFwProtocol->GetCommandLine (MAX_CMDLINE_SIZE, CommandLine + 4);
+  if (EFI_ERROR (Status)) {
+    DEBUG ((DEBUG_ERROR, "%a: failed to retrieve command line\n", __FUNCTION__));
+    return;
+  }
+
+  if (AsciiStrLen (CommandLine + 4) == 0) {
+    DEBUG ((DEBUG_INFO, "%a: empty command line received\n", __FUNCTION__));
+    return;
+  }
+
+  CommandLine[3] = ' ';
+
+  Retval = fdt_appendprop_string (mFdtImage, Node, "bootargs", &CommandLine[3]);
+  if (Retval != 0) {
+    DEBUG ((DEBUG_ERROR, "%a: failed to set /chosen/bootargs property (%d)\n",
+      __FUNCTION__, Retval));
+  }
+
+  DEBUG_CODE_BEGIN ();
+    CONST CHAR8    *Prop;
+    INT32         Length;
+    INT32         Index;
+
+    Node = fdt_path_offset (mFdtImage, "/chosen");
+    ASSERT (Node >= 0);
+
+    Prop = fdt_getprop (mFdtImage, Node, "bootargs", &Length);
+    ASSERT (Prop != NULL);
+
+    DEBUG ((DEBUG_INFO, "Command line set from firmware (length %d):\n'", Length));
+
+    for (Index = 0; Index < Length; Index++, Prop++) {
+      if (*Prop == '\0') {
+        continue;
+      }
+      DEBUG ((DEBUG_INFO, "%c", *Prop));
+    }
+
+    DEBUG ((DEBUG_INFO, "'\n"));
+  DEBUG_CODE_END ();
+
+  FreePool (CommandLine - 4);
+}
+
+
+/**
+  @param  ImageHandle   of the loaded driver
+  @param  SystemTable   Pointer to the System Table
+
+  @retval EFI_SUCCESS           Protocol registered
+  @retval EFI_OUT_OF_RESOURCES  Cannot allocate protocol data structure
+  @retval EFI_DEVICE_ERROR      Hardware problems
+
+**/
+EFI_STATUS
+EFIAPI
+FdtDxeInitialize (
+  IN EFI_HANDLE         ImageHandle,
+  IN EFI_SYSTEM_TABLE   *SystemTable
+  )
+{
+  EFI_STATUS Status;
+  VOID       *FdtImage;
+  UINTN      FdtSize;
+  INT32      Retval;
+  BOOLEAN    Internal;
+
+  Status = gBS->LocateProtocol (&gRaspberryPiFirmwareProtocolGuid, NULL,
+                  (VOID**)&mFwProtocol);
+  ASSERT_EFI_ERROR (Status);
+
+  Internal = FALSE;
+  FdtImage = (VOID*)(UINTN)PcdGet32 (PcdFdtBaseAddress);
+  Retval = fdt_check_header (FdtImage);
+  if (Retval == 0) {
+    /*
+     * Have FDT passed via config.txt.
+     */
+    FdtSize = fdt_totalsize (FdtImage);
+    DEBUG ((DEBUG_INFO, "DTB passed via config.txt of 0x%lx bytes\n", FdtSize));
+    Status = EFI_SUCCESS;
+  } else {
+    Internal = TRUE;
+    DEBUG ((DEBUG_INFO, "No/bad FDT at %p (%a), trying internal DTB...\n",
+      FdtImage, fdt_strerror (Retval)));
+    Status = GetSectionFromAnyFv (&gRaspberryPiFdtFileGuid, EFI_SECTION_RAW, 0,
+               &FdtImage, &FdtSize);
+    if (Status == EFI_SUCCESS) {
+      if (fdt_check_header (FdtImage) != 0) {
+        Status = EFI_INCOMPATIBLE_VERSION;
+      }
+    }
+  }
+
+  if (EFI_ERROR (Status)) {
+    DEBUG ((DEBUG_ERROR, "Failed to locate device tree: %r\n", Status));
+    return Status;
+  }
+
+  /*
+   * Probably overkill.
+   */
+  FdtSize += EFI_PAGE_SIZE * 2;
+  Status = gBS->AllocatePages (AllocateAnyPages, EfiBootServicesData,
+                  EFI_SIZE_TO_PAGES (FdtSize), (EFI_PHYSICAL_ADDRESS*)&mFdtImage);
+  if (EFI_ERROR (Status)) {
+    DEBUG ((DEBUG_ERROR, "Failed to allocate new device tree: %r\n", Status));
+    return Status;
+  }
+
+  Retval = fdt_open_into (FdtImage, mFdtImage, FdtSize);
+  ASSERT (Retval == 0);
+
+  SanitizePSCI ();
+  CleanMemoryNodes ();
+  CleanSimpleFramebuffer ();
+  UpdateMacAddress ();
+  if (Internal) {
+    /*
+     * A GPU-provided DTB already has the full command line.
+     */
+    UpdateBootArgs ();
+  }
+
+  DEBUG ((DEBUG_INFO, "Installed FDT is at %p\n", mFdtImage));
+  Status = gBS->InstallConfigurationTable (&gFdtTableGuid, mFdtImage);
+  ASSERT_EFI_ERROR (Status);
+
+  return Status;
+}
diff --git a/Platform/RaspberryPi/RPi3/Drivers/FdtDxe/FdtDxe.inf b/Platform/RaspberryPi/RPi3/Drivers/FdtDxe/FdtDxe.inf
new file mode 100644
index 000000000000..d93a18019de1
--- /dev/null
+++ b/Platform/RaspberryPi/RPi3/Drivers/FdtDxe/FdtDxe.inf
@@ -0,0 +1,53 @@
+#/** @file
+#
+#  Copyright (c) 2017, Andrei Warkentin <andrey.warkentin@gmail.com>
+#  Copyright (c) 2016, Linaro, Ltd. All rights reserved.
+#
+#  This program and the accompanying materials
+#  are licensed and made available under the terms and conditions of the BSD License
+#  which accompanies this distribution.  The full text of the license may be found at
+#  http://opensource.org/licenses/bsd-license.php
+#
+#  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+#  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+#
+#**/
+
+[Defines]
+  INF_VERSION                    = 0x0001001A
+  BASE_NAME                      = FdtDxe
+  FILE_GUID                      = 8505280f-109e-437e-9fe4-1aa09c7074d9
+  MODULE_TYPE                    = DXE_DRIVER
+  VERSION_STRING                 = 1.0
+  ENTRY_POINT                    = FdtDxeInitialize
+
+[Sources]
+  FdtDxe.c
+
+[Packages]
+  EmbeddedPkg/EmbeddedPkg.dec
+  MdePkg/MdePkg.dec
+  MdeModulePkg/MdeModulePkg.dec
+  Platform/RaspberryPi/RPi3/RPi3.dec
+
+[LibraryClasses]
+  BaseLib
+  DebugLib
+  DxeServicesLib
+  FdtLib
+  MemoryAllocationLib
+  UefiBootServicesTableLib
+  UefiDriverEntryPoint
+
+[Guids]
+  gFdtTableGuid
+  gRaspberryPiFdtFileGuid
+
+[Protocols]
+  gRaspberryPiFirmwareProtocolGuid              ## CONSUMES
+
+[Depex]
+  gRaspberryPiFirmwareProtocolGuid
+
+[FixedPcd]
+  gRaspberryPiTokenSpaceGuid.PcdFdtBaseAddress
-- 
2.17.0.windows.1



^ permalink raw reply related	[flat|nested] 34+ messages in thread

* [PATCH v5 edk2-platforms 13/22] Platform/RaspberryPi/RPi3: Add base MMC driver
  2019-02-05 16:25 [PATCH v5 edk2-platforms 00/22] Platform/RaspberryPi: Add Raspberry Pi 3 support Pete Batard
                   ` (11 preceding siblings ...)
  2019-02-05 16:25 ` [PATCH v5 edk2-platforms 12/22] Platform/RaspberryPi/RPi3: Add Device Tree driver Pete Batard
@ 2019-02-05 16:25 ` Pete Batard
  2019-02-05 16:25 ` [PATCH v5 edk2-platforms 14/22] Platform/RaspberryPi/RPi3: Add Arasan " Pete Batard
                   ` (10 subsequent siblings)
  23 siblings, 0 replies; 34+ messages in thread
From: Pete Batard @ 2019-02-05 16:25 UTC (permalink / raw)
  To: edk2-devel

This implements the MMC Host protocol, which is used by the two
concurrent SD interface drivers that the Raspberry Pi 3 supports.

Contributed-under: TianoCore Contribution Agreement 1.1
Signed-off-by: Pete Batard <pete@akeo.ie>
---
 Platform/RaspberryPi/RPi3/Drivers/MmcDxe/ComponentName.c     | 163 ++++
 Platform/RaspberryPi/RPi3/Drivers/MmcDxe/Diagnostics.c       | 263 ++++++
 Platform/RaspberryPi/RPi3/Drivers/MmcDxe/Mmc.c               | 460 +++++++++
 Platform/RaspberryPi/RPi3/Drivers/MmcDxe/Mmc.h               | 533 +++++++++++
 Platform/RaspberryPi/RPi3/Drivers/MmcDxe/MmcBlockIo.c        | 469 ++++++++++
 Platform/RaspberryPi/RPi3/Drivers/MmcDxe/MmcDebug.c          | 170 ++++
 Platform/RaspberryPi/RPi3/Drivers/MmcDxe/MmcDxe.inf          |  58 ++
 Platform/RaspberryPi/RPi3/Drivers/MmcDxe/MmcIdentification.c | 980 ++++++++++++++++++++
 Platform/RaspberryPi/RPi3/Include/Protocol/RpiMmcHost.h      | 206 ++++
 9 files changed, 3302 insertions(+)

diff --git a/Platform/RaspberryPi/RPi3/Drivers/MmcDxe/ComponentName.c b/Platform/RaspberryPi/RPi3/Drivers/MmcDxe/ComponentName.c
new file mode 100644
index 000000000000..034da778cae2
--- /dev/null
+++ b/Platform/RaspberryPi/RPi3/Drivers/MmcDxe/ComponentName.c
@@ -0,0 +1,163 @@
+/** @file
+ *
+ *  Component Name Protocol implementation for the MMC DXE driver
+ *
+ *  Copyright (c) 2011, ARM Limited. All rights reserved.
+ *
+ *  This program and the accompanying materials
+ *  are licensed and made available under the terms and conditions of the BSD License
+ *  which accompanies this distribution.  The full text of the license may be found at
+ *  http://opensource.org/licenses/bsd-license.php
+ *
+ *  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+ *  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+ *
+ **/
+
+#include "Mmc.h"
+
+//
+// EFI Component Name Protocol
+//
+GLOBAL_REMOVE_IF_UNREFERENCED EFI_COMPONENT_NAME_PROTOCOL  gMmcComponentName = {
+  MmcGetDriverName,
+  MmcGetControllerName,
+  "eng"
+};
+
+//
+// EFI Component Name 2 Protocol
+//
+GLOBAL_REMOVE_IF_UNREFERENCED EFI_COMPONENT_NAME2_PROTOCOL gMmcComponentName2 = {
+  (EFI_COMPONENT_NAME2_GET_DRIVER_NAME)MmcGetDriverName,
+  (EFI_COMPONENT_NAME2_GET_CONTROLLER_NAME)MmcGetControllerName,
+  "en"
+};
+
+GLOBAL_REMOVE_IF_UNREFERENCED EFI_UNICODE_STRING_TABLE
+mMmcDriverNameTable[] = {
+  {"eng;en", L"MMC/SD Card Interface Driver"},
+  {NULL,  NULL}
+};
+
+/**
+  Retrieves a Unicode string that is the user readable name of the driver.
+
+  This function retrieves the user readable name of a driver in the form of a
+  Unicode string. If the driver specified by This has a user readable name in
+  the language specified by Language, then a pointer to the driver name is
+  returned in DriverName, and EFI_SUCCESS is returned. If the driver specified
+  by This does not support the language specified by Language,
+  then EFI_UNSUPPORTED is returned.
+
+  @param  This                  A pointer to the EFI_COMPONENT_NAME2_PROTOCOL or
+                                EFI_COMPONENT_NAME_PROTOCOL instance.
+  @param  Language              A pointer to a Null-terminated ASCII string
+                                array indicating the language. This is the
+                                language of the driver name that the caller is
+                                requesting, and it must match one of the
+                                languages specified in SupportedLanguages. The
+                                number of languages supported by a driver is up
+                                to the driver writer. Language is specified
+                                in RFC 4646 or ISO 639-2 language code format.
+  @param  DriverName            A pointer to the Unicode string to return.
+                                This Unicode string is the name of the
+                                driver specified by This in the language
+                                specified by Language.
+
+  @retval EFI_SUCCESS           The Unicode string for the Driver specified by
+                                This and the language specified by Language was
+                                returned in DriverName.
+  @retval EFI_INVALID_PARAMETER Language is NULL.
+  @retval EFI_INVALID_PARAMETER DriverName is NULL.
+  @retval EFI_UNSUPPORTED       The driver specified by This does not support
+                                the language specified by Language.
+
+**/
+EFI_STATUS
+EFIAPI
+MmcGetDriverName (
+  IN  EFI_COMPONENT_NAME_PROTOCOL  *This,
+  IN  CHAR8                        *Language,
+  OUT CHAR16                       **DriverName
+  )
+{
+  return LookupUnicodeString2 (
+           Language,
+           This->SupportedLanguages,
+           mMmcDriverNameTable,
+           DriverName,
+           (BOOLEAN)(This == &gMmcComponentName)
+         );
+}
+
+/**
+  Retrieves a Unicode string that is the user readable name of the controller
+  that is being managed by a driver.
+
+  This function retrieves the user readable name of the controller specified by
+  ControllerHandle and ChildHandle in the form of a Unicode string. If the
+  driver specified by This has a user readable name in the language specified by
+  Language, then a pointer to the controller name is returned in ControllerName,
+  and EFI_SUCCESS is returned.  If the driver specified by This is not currently
+  managing the controller specified by ControllerHandle and ChildHandle,
+  then EFI_UNSUPPORTED is returned.  If the driver specified by This does not
+  support the language specified by Language, then EFI_UNSUPPORTED is returned.
+
+  @param  This                  A pointer to the EFI_COMPONENT_NAME2_PROTOCOL or
+                                EFI_COMPONENT_NAME_PROTOCOL instance.
+  @param  ControllerHandle      The handle of a controller that the driver
+                                specified by This is managing.  This handle
+                                specifies the controller whose name is to be
+                                returned.
+  @param  ChildHandle           The handle of the child controller to retrieve
+                                the name of.  This is an optional parameter that
+                                may be NULL.  It will be NULL for device
+                                drivers.  It will also be NULL for a bus drivers
+                                that wish to retrieve the name of the bus
+                                controller.  It will not be NULL for a bus
+                                driver that wishes to retrieve the name of a
+                                child controller.
+  @param  Language              A pointer to a Null-terminated ASCII string
+                                array indicating the language.  This is the
+                                language of the driver name that the caller is
+                                requesting, and it must match one of the
+                                languages specified in SupportedLanguages. The
+                                number of languages supported by a driver is up
+                                to the driver writer. Language is specified in
+                                RFC 4646 or ISO 639-2 language code format.
+  @param  ControllerName        A pointer to the Unicode string to return.
+                                This Unicode string is the name of the
+                                controller specified by ControllerHandle and
+                                ChildHandle in the language specified by
+                                Language from the point of view of the driver
+                                specified by This.
+
+  @retval EFI_SUCCESS           The Unicode string for the user readable name in
+                                the language specified by Language for the
+                                driver specified by This was returned in
+                                DriverName.
+  @retval EFI_INVALID_PARAMETER ControllerHandle is not a valid EFI_HANDLE.
+  @retval EFI_INVALID_PARAMETER ChildHandle is not NULL and it is not a valid
+                                EFI_HANDLE.
+  @retval EFI_INVALID_PARAMETER Language is NULL.
+  @retval EFI_INVALID_PARAMETER ControllerName is NULL.
+  @retval EFI_UNSUPPORTED       The driver specified by This is not currently
+                                managing the controller specified by
+                                ControllerHandle and ChildHandle.
+  @retval EFI_UNSUPPORTED       The driver specified by This does not support
+                                the language specified by Language.
+
+**/
+EFI_STATUS
+EFIAPI
+MmcGetControllerName (
+  IN  EFI_COMPONENT_NAME_PROTOCOL                     *This,
+  IN  EFI_HANDLE                                      ControllerHandle,
+  IN  EFI_HANDLE                                      ChildHandle        OPTIONAL,
+  IN  CHAR8                                           *Language,
+  OUT CHAR16                                          **ControllerName
+  )
+{
+  return EFI_UNSUPPORTED;
+}
diff --git a/Platform/RaspberryPi/RPi3/Drivers/MmcDxe/Diagnostics.c b/Platform/RaspberryPi/RPi3/Drivers/MmcDxe/Diagnostics.c
new file mode 100644
index 000000000000..c019a85b48ee
--- /dev/null
+++ b/Platform/RaspberryPi/RPi3/Drivers/MmcDxe/Diagnostics.c
@@ -0,0 +1,263 @@
+/** @file
+ *
+ *  Diagnostics Protocol implementation for the MMC DXE driver
+ *
+ *  Copyright (c) 2011-2014, ARM Limited. All rights reserved.
+ *
+ *  This program and the accompanying materials
+ *  are licensed and made available under the terms and conditions of the BSD License
+ *  which accompanies this distribution.  The full text of the license may be found at
+ *  http://opensource.org/licenses/bsd-license.php
+ *
+ *  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+ *  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+ *
+ **/
+
+#include <Uefi.h>
+#include <Library/DebugLib.h>
+#include <Library/BaseMemoryLib.h>
+#include <Library/MemoryAllocationLib.h>
+#include <Library/BaseLib.h>
+
+#include "Mmc.h"
+
+#define DIAGNOSTIC_LOGBUFFER_MAXCHAR  1024
+
+CHAR16* mLogBuffer = NULL;
+UINTN   mLogRemainChar = 0;
+
+CHAR16*
+DiagnosticInitLog (
+  UINTN MaxBufferChar
+  )
+{
+  mLogRemainChar = MaxBufferChar;
+  mLogBuffer = AllocatePool ((UINTN)MaxBufferChar * sizeof (CHAR16));
+  return mLogBuffer;
+}
+
+UINTN
+DiagnosticLog (
+  CONST CHAR16* Str
+  )
+{
+  UINTN len = StrLen (Str);
+  if (len < mLogRemainChar) {
+    StrCpyS (mLogBuffer, mLogRemainChar, Str);
+    mLogRemainChar -= len;
+    mLogBuffer += len;
+    return len;
+  } else {
+    return 0;
+  }
+}
+
+VOID
+GenerateRandomBuffer (
+  VOID* Buffer,
+  UINTN BufferSize
+  )
+{
+  UINT64  i;
+  UINT64* Buffer64 = (UINT64*)Buffer;
+
+  for (i = 0; i < (BufferSize >> 3); i++) {
+    *Buffer64 = i | (~i << 32);
+    Buffer64++;
+  }
+}
+
+BOOLEAN
+CompareBuffer (
+  VOID  *BufferA,
+  VOID  *BufferB,
+  UINTN BufferSize
+  )
+{
+  UINTN i;
+  UINT64* BufferA64 = (UINT64*)BufferA;
+  UINT64* BufferB64 = (UINT64*)BufferB;
+
+  for (i = 0; i < (BufferSize >> 3); i++) {
+    if (*BufferA64 != *BufferB64) {
+      DEBUG ((DEBUG_ERROR, "CompareBuffer: Error at %i", i));
+      DEBUG ((DEBUG_ERROR, "(0x%lX) != (0x%lX)\n", *BufferA64, *BufferB64));
+      return FALSE;
+    }
+    BufferA64++;
+    BufferB64++;
+  }
+  return TRUE;
+}
+
+EFI_STATUS
+MmcReadWriteDataTest (
+  MMC_HOST_INSTANCE *MmcHostInstance,
+  EFI_LBA           Lba,
+  UINTN             BufferSize
+  )
+{
+  VOID                        *BackBuffer;
+  VOID                        *WriteBuffer;
+  VOID                        *ReadBuffer;
+  EFI_STATUS                  Status;
+
+  // Check if a Media is Present
+  if (!MmcHostInstance->BlockIo.Media->MediaPresent) {
+    DiagnosticLog (L"ERROR: No Media Present\n");
+    return EFI_NO_MEDIA;
+  }
+
+  if (MmcHostInstance->State != MmcTransferState) {
+    DiagnosticLog (L"ERROR: Not ready for Transfer state\n");
+    return EFI_NOT_READY;
+  }
+
+  BackBuffer = AllocatePool (BufferSize);
+  WriteBuffer = AllocatePool (BufferSize);
+  ReadBuffer = AllocatePool (BufferSize);
+
+  // Read (and save) buffer at a specific location
+  Status = MmcReadBlocks (&(MmcHostInstance->BlockIo),
+             MmcHostInstance->BlockIo.Media->MediaId, Lba, BufferSize, BackBuffer);
+  if (Status != EFI_SUCCESS) {
+    DiagnosticLog (L"ERROR: Fail to Read Block (1)\n");
+    return Status;
+  }
+
+  // Write buffer at the same location
+  GenerateRandomBuffer (WriteBuffer, BufferSize);
+  Status = MmcWriteBlocks (&(MmcHostInstance->BlockIo),
+             MmcHostInstance->BlockIo.Media->MediaId, Lba, BufferSize, WriteBuffer);
+  if (Status != EFI_SUCCESS) {
+    DiagnosticLog (L"ERROR: Fail to Write Block (1)\n");
+    return Status;
+  }
+
+  // Read the buffer at the same location
+  Status = MmcReadBlocks (&(MmcHostInstance->BlockIo),
+             MmcHostInstance->BlockIo.Media->MediaId, Lba, BufferSize, ReadBuffer);
+  if (Status != EFI_SUCCESS) {
+    DiagnosticLog (L"ERROR: Fail to Read Block (2)\n");
+    return Status;
+  }
+
+  // Check that is conform
+  if (!CompareBuffer (ReadBuffer, WriteBuffer, BufferSize)) {
+    DiagnosticLog (L"ERROR: Fail to Read/Write Block (1)\n");
+    return EFI_INVALID_PARAMETER;
+  }
+
+  // Restore content at the original location
+  Status = MmcWriteBlocks (&(MmcHostInstance->BlockIo),
+             MmcHostInstance->BlockIo.Media->MediaId, Lba, BufferSize, BackBuffer);
+  if (Status != EFI_SUCCESS) {
+    DiagnosticLog (L"ERROR: Fail to Write Block (2)\n");
+    return Status;
+  }
+
+  // Read the restored content
+  Status = MmcReadBlocks (&(MmcHostInstance->BlockIo),
+             MmcHostInstance->BlockIo.Media->MediaId, Lba, BufferSize, ReadBuffer);
+  if (Status != EFI_SUCCESS) {
+    DiagnosticLog (L"ERROR: Fail to Read Block (3)\n");
+    return Status;
+  }
+
+  // Check the content is correct
+  if (!CompareBuffer (ReadBuffer, BackBuffer, BufferSize)) {
+    DiagnosticLog (L"ERROR: Fail to Read/Write Block (2)\n");
+    return EFI_INVALID_PARAMETER;
+  }
+
+  return EFI_SUCCESS;
+}
+
+EFI_STATUS
+EFIAPI
+MmcDriverDiagnosticsRunDiagnostics (
+  IN  EFI_DRIVER_DIAGNOSTICS_PROTOCOL               *This,
+  IN  EFI_HANDLE                                    ControllerHandle,
+  IN  EFI_HANDLE                                    ChildHandle  OPTIONAL,
+  IN  EFI_DRIVER_DIAGNOSTIC_TYPE                    DiagnosticType,
+  IN  CHAR8                                         *Language,
+  OUT EFI_GUID                                      **ErrorType,
+  OUT UINTN                                         *BufferSize,
+  OUT CHAR16                                        **Buffer
+  )
+{
+  LIST_ENTRY              *CurrentLink;
+  MMC_HOST_INSTANCE       *MmcHostInstance;
+  EFI_STATUS              Status;
+
+  if ((Language         == NULL) ||
+      (ErrorType        == NULL) ||
+      (Buffer           == NULL) ||
+      (ControllerHandle == NULL) ||
+      (BufferSize       == NULL)) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  // Check Language is supported (i.e. is "en-*" - only English is supported)
+  if (AsciiStrnCmp (Language, "en", 2) != 0) {
+    return EFI_UNSUPPORTED;
+  }
+
+  Status = EFI_SUCCESS;
+  *ErrorType = NULL;
+  *BufferSize = DIAGNOSTIC_LOGBUFFER_MAXCHAR;
+  *Buffer = DiagnosticInitLog (DIAGNOSTIC_LOGBUFFER_MAXCHAR);
+
+  DiagnosticLog (L"MMC Driver Diagnostics\n");
+
+  // Find the MMC Host instance on which we have been asked to run diagnostics
+  MmcHostInstance = NULL;
+  CurrentLink = mMmcHostPool.ForwardLink;
+  while (CurrentLink != NULL && CurrentLink != &mMmcHostPool && (Status == EFI_SUCCESS)) {
+    MmcHostInstance = MMC_HOST_INSTANCE_FROM_LINK (CurrentLink);
+    ASSERT (MmcHostInstance != NULL);
+    if (MmcHostInstance->MmcHandle == ControllerHandle) {
+      break;
+    }
+    CurrentLink = CurrentLink->ForwardLink;
+  }
+
+  // If we didn't find the controller, return EFI_UNSUPPORTED
+  if ((MmcHostInstance == NULL)
+      || (MmcHostInstance->MmcHandle != ControllerHandle)) {
+    return EFI_UNSUPPORTED;
+  }
+
+  // LBA=1 Size=BlockSize
+  DiagnosticLog (L"MMC Driver Diagnostics - Test: First Block\n");
+  Status = MmcReadWriteDataTest (MmcHostInstance, 1, MmcHostInstance->BlockIo.Media->BlockSize);
+
+  // LBA=2 Size=BlockSize
+  DiagnosticLog (L"MMC Driver Diagnostics - Test: Second Block\n");
+  Status = MmcReadWriteDataTest (MmcHostInstance, 2, MmcHostInstance->BlockIo.Media->BlockSize);
+
+  // LBA=10 Size=BlockSize
+  DiagnosticLog (L"MMC Driver Diagnostics - Test: Any Block\n");
+  Status = MmcReadWriteDataTest (MmcHostInstance, MmcHostInstance->BlockIo.Media->LastBlock >> 1,
+             MmcHostInstance->BlockIo.Media->BlockSize);
+
+  // LBA=LastBlock Size=BlockSize
+  DiagnosticLog (L"MMC Driver Diagnostics - Test: Last Block\n");
+  Status = MmcReadWriteDataTest (MmcHostInstance, MmcHostInstance->BlockIo.Media->LastBlock,
+             MmcHostInstance->BlockIo.Media->BlockSize);
+
+  // LBA=1 Size=2*BlockSize
+  DiagnosticLog (L"MMC Driver Diagnostics - Test: First Block / 2 BlockSSize\n");
+  Status = MmcReadWriteDataTest (MmcHostInstance, 1, 2 * MmcHostInstance->BlockIo.Media->BlockSize);
+
+  return Status;
+}
+
+//
+// EFI Driver Diagnostics 2 Protocol
+//
+GLOBAL_REMOVE_IF_UNREFERENCED EFI_DRIVER_DIAGNOSTICS2_PROTOCOL gMmcDriverDiagnostics2 = {
+  (EFI_DRIVER_DIAGNOSTICS2_RUN_DIAGNOSTICS)MmcDriverDiagnosticsRunDiagnostics,
+  "en"
+};
diff --git a/Platform/RaspberryPi/RPi3/Drivers/MmcDxe/Mmc.c b/Platform/RaspberryPi/RPi3/Drivers/MmcDxe/Mmc.c
new file mode 100644
index 000000000000..1d75276b809a
--- /dev/null
+++ b/Platform/RaspberryPi/RPi3/Drivers/MmcDxe/Mmc.c
@@ -0,0 +1,460 @@
+/** @file
+ *
+ *  Main file of the MMC Dxe driver. The driver entrypoint is defined into this file.
+ *
+ *  Copyright (c) 2011-2013, ARM Limited. All rights reserved.
+ *
+ *  This program and the accompanying materials
+ *  are licensed and made available under the terms and conditions of the BSD License
+ *  which accompanies this distribution.  The full text of the license may be found at
+ *  http://opensource.org/licenses/bsd-license.php
+ *
+ *  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+ *  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+ *
+ **/
+
+#include <Protocol/DevicePath.h>
+
+#include <Library/BaseLib.h>
+#include <Library/BaseMemoryLib.h>
+#include <Library/MemoryAllocationLib.h>
+#include <Library/UefiBootServicesTableLib.h>
+#include <Library/DevicePathLib.h>
+
+#include "Mmc.h"
+
+EFI_BLOCK_IO_MEDIA mMmcMediaTemplate = {
+  SIGNATURE_32 ('m','m','c','o'),           // MediaId
+  TRUE,                                     // RemovableMedia
+  FALSE,                                    // MediaPresent
+  FALSE,                                    // LogicalPartition
+  FALSE,                                    // ReadOnly
+  FALSE,                                    // WriteCaching
+  512,                                      // BlockSize
+  4,                                        // IoAlign
+  0,                                        // Pad
+  0                                         // LastBlock
+};
+
+//
+// This device structure is serviced as a header.
+// Its next field points to the first root bridge device node.
+//
+LIST_ENTRY  mMmcHostPool;
+
+/**
+  Event triggered by the timer to check if any cards have been removed
+  or if new ones have been plugged in
+**/
+
+EFI_EVENT gCheckCardsEvent;
+
+/**
+  Initialize the MMC Host Pool to support multiple MMC devices
+**/
+VOID
+InitializeMmcHostPool (
+  VOID
+  )
+{
+  InitializeListHead (&mMmcHostPool);
+}
+
+/**
+  Insert a new Mmc Host controller to the pool
+**/
+VOID
+InsertMmcHost (
+  IN MMC_HOST_INSTANCE      *MmcHostInstance
+  )
+{
+  InsertTailList (&mMmcHostPool, &(MmcHostInstance->Link));
+}
+
+/*
+  Remove a new Mmc Host controller to the pool
+*/
+VOID
+RemoveMmcHost (
+  IN MMC_HOST_INSTANCE      *MmcHostInstance
+  )
+{
+  RemoveEntryList (&(MmcHostInstance->Link));
+}
+
+MMC_HOST_INSTANCE* CreateMmcHostInstance (
+  IN EFI_MMC_HOST_PROTOCOL* MmcHost
+  )
+{
+  EFI_STATUS          Status;
+  MMC_HOST_INSTANCE*  MmcHostInstance;
+  EFI_DEVICE_PATH_PROTOCOL    *NewDevicePathNode;
+  EFI_DEVICE_PATH_PROTOCOL    *DevicePath;
+
+  MmcHostInstance = AllocateZeroPool (sizeof (MMC_HOST_INSTANCE));
+  if (MmcHostInstance == NULL) {
+    return NULL;
+  }
+
+  MmcHostInstance->Signature = MMC_HOST_INSTANCE_SIGNATURE;
+
+  MmcHostInstance->State = MmcHwInitializationState;
+
+  MmcHostInstance->BlockIo.Media = AllocateCopyPool (sizeof (EFI_BLOCK_IO_MEDIA), &mMmcMediaTemplate);
+  if (MmcHostInstance->BlockIo.Media == NULL) {
+    goto FREE_INSTANCE;
+  }
+
+  MmcHostInstance->BlockIo.Revision = EFI_BLOCK_IO_INTERFACE_REVISION;
+  MmcHostInstance->BlockIo.Reset = MmcReset;
+  MmcHostInstance->BlockIo.ReadBlocks = MmcReadBlocks;
+  MmcHostInstance->BlockIo.WriteBlocks = MmcWriteBlocks;
+  MmcHostInstance->BlockIo.FlushBlocks = MmcFlushBlocks;
+
+  MmcHostInstance->MmcHost = MmcHost;
+
+  // Create DevicePath for the new MMC Host
+  Status = MmcHost->BuildDevicePath (MmcHost, &NewDevicePathNode);
+  if (EFI_ERROR (Status)) {
+    goto FREE_MEDIA;
+  }
+
+  DevicePath = (EFI_DEVICE_PATH_PROTOCOL*)AllocatePool (END_DEVICE_PATH_LENGTH);
+  if (DevicePath == NULL) {
+    goto FREE_MEDIA;
+  }
+
+  SetDevicePathEndNode (DevicePath);
+  MmcHostInstance->DevicePath = AppendDevicePathNode (DevicePath, NewDevicePathNode);
+
+  // Publish BlockIO protocol interface
+  Status = gBS->InstallMultipleProtocolInterfaces (
+                  &MmcHostInstance->MmcHandle,
+                  &gEfiBlockIoProtocolGuid, &MmcHostInstance->BlockIo,
+                  &gEfiDevicePathProtocolGuid, MmcHostInstance->DevicePath,
+                  NULL
+                );
+  if (EFI_ERROR (Status)) {
+    goto FREE_DEVICE_PATH;
+  }
+
+  return MmcHostInstance;
+
+FREE_DEVICE_PATH:
+  FreePool (DevicePath);
+
+FREE_MEDIA:
+  FreePool (MmcHostInstance->BlockIo.Media);
+
+FREE_INSTANCE:
+  FreePool (MmcHostInstance);
+
+  return NULL;
+}
+
+EFI_STATUS DestroyMmcHostInstance (
+  IN MMC_HOST_INSTANCE* MmcHostInstance
+  )
+{
+  EFI_STATUS Status;
+
+  // Uninstall Protocol Interfaces
+  Status = gBS->UninstallMultipleProtocolInterfaces (
+                  MmcHostInstance->MmcHandle,
+                  &gEfiBlockIoProtocolGuid, &(MmcHostInstance->BlockIo),
+                  &gEfiDevicePathProtocolGuid, MmcHostInstance->DevicePath,
+                  NULL
+                );
+  ASSERT_EFI_ERROR (Status);
+
+  // Free Memory allocated for the instance
+  if (MmcHostInstance->BlockIo.Media) {
+    FreePool (MmcHostInstance->BlockIo.Media);
+  }
+  if (MmcHostInstance->CardInfo.ECSDData) {
+    FreePages (MmcHostInstance->CardInfo.ECSDData, EFI_SIZE_TO_PAGES (sizeof (ECSD)));
+  }
+  FreePool (MmcHostInstance);
+
+  return Status;
+}
+
+/**
+  This function checks if the controller implement the Mmc Host and the Device Path Protocols
+**/
+EFI_STATUS
+EFIAPI
+MmcDriverBindingSupported (
+  IN EFI_DRIVER_BINDING_PROTOCOL    *This,
+  IN EFI_HANDLE                     Controller,
+  IN EFI_DEVICE_PATH_PROTOCOL       *RemainingDevicePath
+  )
+{
+  EFI_STATUS                      Status;
+  //EFI_DEVICE_PATH_PROTOCOL        *ParentDevicePath;
+  EFI_MMC_HOST_PROTOCOL           *MmcHost;
+  EFI_DEV_PATH_PTR                Node;
+
+  //
+  // Check RemainingDevicePath validation
+  //
+  if (RemainingDevicePath != NULL) {
+    //
+    // Check if RemainingDevicePath is the End of Device Path Node,
+    // if yes, go on checking other conditions
+    //
+    if (!IsDevicePathEnd (RemainingDevicePath)) {
+      //
+      // If RemainingDevicePath isn't the End of Device Path Node,
+      // check its validation
+      //
+      Node.DevPath = RemainingDevicePath;
+      if (Node.DevPath->Type != HARDWARE_DEVICE_PATH ||
+          Node.DevPath->SubType != HW_VENDOR_DP ||
+          DevicePathNodeLength (Node.DevPath) != sizeof (VENDOR_DEVICE_PATH)) {
+        return EFI_UNSUPPORTED;
+      }
+    }
+  }
+
+  //
+  // Check if Mmc Host protocol is installed by platform
+  //
+  Status = gBS->OpenProtocol (
+                  Controller,
+                  &gRaspberryPiMmcHostProtocolGuid,
+                  (VOID**)&MmcHost,
+                  This->DriverBindingHandle,
+                  Controller,
+                  EFI_OPEN_PROTOCOL_BY_DRIVER
+                );
+  if (Status == EFI_ALREADY_STARTED) {
+    return EFI_SUCCESS;
+  }
+  if (EFI_ERROR (Status)) {
+    return Status;
+  }
+
+  //
+  // Close the Mmc Host used to perform the supported test
+  //
+  gBS->CloseProtocol (
+         Controller,
+         &gRaspberryPiMmcHostProtocolGuid,
+         This->DriverBindingHandle,
+         Controller
+       );
+
+  return EFI_SUCCESS;
+}
+
+/**
+
+**/
+EFI_STATUS
+EFIAPI
+MmcDriverBindingStart (
+  IN EFI_DRIVER_BINDING_PROTOCOL  *This,
+  IN EFI_HANDLE                   Controller,
+  IN EFI_DEVICE_PATH_PROTOCOL     *RemainingDevicePath
+  )
+{
+  EFI_STATUS              Status;
+  MMC_HOST_INSTANCE       *MmcHostInstance;
+  EFI_MMC_HOST_PROTOCOL   *MmcHost;
+
+  //
+  // Check RemainingDevicePath validation
+  //
+  if (RemainingDevicePath != NULL) {
+    //
+    // Check if RemainingDevicePath is the End of Device Path Node,
+    // if yes, return EFI_SUCCESS
+    //
+    if (IsDevicePathEnd (RemainingDevicePath)) {
+      return EFI_SUCCESS;
+    }
+  }
+
+  //
+  // Get the Mmc Host protocol
+  //
+  Status = gBS->OpenProtocol (
+                  Controller,
+                  &gRaspberryPiMmcHostProtocolGuid,
+                  (VOID**)&MmcHost,
+                  This->DriverBindingHandle,
+                  Controller,
+                  EFI_OPEN_PROTOCOL_BY_DRIVER
+                );
+  if (EFI_ERROR (Status)) {
+    if (Status == EFI_ALREADY_STARTED) {
+      return EFI_SUCCESS;
+    }
+    return Status;
+  }
+
+  MmcHostInstance = CreateMmcHostInstance (MmcHost);
+  if (MmcHostInstance != NULL) {
+    // Add the handle to the pool
+    InsertMmcHost (MmcHostInstance);
+
+    MmcHostInstance->Initialized = FALSE;
+
+    // Detect card presence now
+    CheckCardsCallback (NULL, NULL);
+  }
+
+  return EFI_SUCCESS;
+}
+
+/**
+
+**/
+EFI_STATUS
+EFIAPI
+MmcDriverBindingStop (
+  IN  EFI_DRIVER_BINDING_PROTOCOL   *This,
+  IN  EFI_HANDLE                    Controller,
+  IN  UINTN                         NumberOfChildren,
+  IN  EFI_HANDLE                    *ChildHandleBuffer
+  )
+{
+  EFI_STATUS          Status = EFI_SUCCESS;
+  LIST_ENTRY          *CurrentLink;
+  MMC_HOST_INSTANCE   *MmcHostInstance;
+
+  MMC_TRACE ("MmcDriverBindingStop()");
+
+  // For each MMC instance
+  CurrentLink = mMmcHostPool.ForwardLink;
+  while (CurrentLink != NULL && CurrentLink != &mMmcHostPool && (Status == EFI_SUCCESS)) {
+    MmcHostInstance = MMC_HOST_INSTANCE_FROM_LINK (CurrentLink);
+    ASSERT (MmcHostInstance != NULL);
+
+    // Close gRaspberryPiMmcHostProtocolGuid
+    Status = gBS->CloseProtocol (
+                    Controller,
+                    &gRaspberryPiMmcHostProtocolGuid,
+                    (VOID**)&MmcHostInstance->MmcHost,
+                    This->DriverBindingHandle
+                  );
+
+    // Remove MMC Host Instance from the pool
+    RemoveMmcHost (MmcHostInstance);
+
+    // Destroy MmcHostInstance
+    DestroyMmcHostInstance (MmcHostInstance);
+  }
+
+  return Status;
+}
+
+VOID
+EFIAPI
+CheckCardsCallback (
+  IN  EFI_EVENT   Event,
+  IN  VOID        *Context
+  )
+{
+  LIST_ENTRY          *CurrentLink;
+  MMC_HOST_INSTANCE   *MmcHostInstance;
+  EFI_STATUS          Status;
+
+  CurrentLink = mMmcHostPool.ForwardLink;
+  while (CurrentLink != NULL && CurrentLink != &mMmcHostPool) {
+    MmcHostInstance = MMC_HOST_INSTANCE_FROM_LINK (CurrentLink);
+    ASSERT (MmcHostInstance != NULL);
+
+    if (MmcHostInstance->MmcHost->IsCardPresent (MmcHostInstance->MmcHost) == !MmcHostInstance->Initialized) {
+      MmcHostInstance->State = MmcHwInitializationState;
+      MmcHostInstance->BlockIo.Media->MediaPresent = !MmcHostInstance->Initialized;
+      MmcHostInstance->Initialized = !MmcHostInstance->Initialized;
+
+      if (MmcHostInstance->BlockIo.Media->MediaPresent) {
+        InitializeMmcDevice (MmcHostInstance);
+      }
+
+      Status = gBS->ReinstallProtocolInterface (
+                      (MmcHostInstance->MmcHandle),
+                      &gEfiBlockIoProtocolGuid,
+                      &(MmcHostInstance->BlockIo),
+                      &(MmcHostInstance->BlockIo)
+                    );
+
+      if (EFI_ERROR (Status)) {
+        Print (L"MMC Card: Error reinstalling BlockIo interface\n");
+      }
+    }
+
+    CurrentLink = CurrentLink->ForwardLink;
+  }
+}
+
+
+EFI_DRIVER_BINDING_PROTOCOL gMmcDriverBinding = {
+  MmcDriverBindingSupported,
+  MmcDriverBindingStart,
+  MmcDriverBindingStop,
+  0xa,
+  NULL,
+  NULL
+};
+
+/**
+
+**/
+EFI_STATUS
+EFIAPI
+MmcDxeInitialize (
+  IN EFI_HANDLE         ImageHandle,
+  IN EFI_SYSTEM_TABLE   *SystemTable
+  )
+{
+  EFI_STATUS  Status;
+
+  //
+  // Initializes MMC Host pool
+  //
+  InitializeMmcHostPool ();
+
+  //
+  // Install driver model protocol(s).
+  //
+  Status = EfiLibInstallDriverBindingComponentName2 (
+             ImageHandle,
+             SystemTable,
+             &gMmcDriverBinding,
+             ImageHandle,
+             &gMmcComponentName,
+             &gMmcComponentName2
+           );
+  ASSERT_EFI_ERROR (Status);
+
+  // Install driver diagnostics
+  Status = gBS->InstallMultipleProtocolInterfaces (
+                  &ImageHandle,
+                  &gEfiDriverDiagnostics2ProtocolGuid,
+                  &gMmcDriverDiagnostics2,
+                  NULL
+                );
+  ASSERT_EFI_ERROR (Status);
+
+  // Use a timer to detect if a card has been plugged in or removed
+  Status = gBS->CreateEvent (
+                  EVT_NOTIFY_SIGNAL | EVT_TIMER,
+                  TPL_CALLBACK,
+                  CheckCardsCallback,
+                  NULL,
+                  &gCheckCardsEvent
+                );
+  ASSERT_EFI_ERROR (Status);
+
+  Status = gBS->SetTimer (gCheckCardsEvent,
+                  TimerPeriodic,
+                  (UINT64)(10 * 1000 * 200)); // 200 ms
+  ASSERT_EFI_ERROR (Status);
+
+  return Status;
+}
diff --git a/Platform/RaspberryPi/RPi3/Drivers/MmcDxe/Mmc.h b/Platform/RaspberryPi/RPi3/Drivers/MmcDxe/Mmc.h
new file mode 100644
index 000000000000..f6a5a99928af
--- /dev/null
+++ b/Platform/RaspberryPi/RPi3/Drivers/MmcDxe/Mmc.h
@@ -0,0 +1,533 @@
+/** @file
+ *
+ *  Main Header file for the MMC DXE driver
+ *
+ *  Copyright (c) 2011-2015, ARM Limited. All rights reserved.
+ *
+ *  This program and the accompanying materials
+ *  are licensed and made available under the terms and conditions of the BSD License
+ *  which accompanies this distribution.  The full text of the license may be found at
+ *  http://opensource.org/licenses/bsd-license.php
+ *
+ *  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+ *  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+ *
+ **/
+
+#ifndef __MMC_H
+#define __MMC_H
+
+#include <Uefi.h>
+
+#include <Protocol/DiskIo.h>
+#include <Protocol/BlockIo.h>
+#include <Protocol/DevicePath.h>
+#include <Protocol/RpiMmcHost.h>
+
+#include <Library/UefiLib.h>
+#include <Library/DebugLib.h>
+#include <Library/UefiBootServicesTableLib.h>
+
+#define MMC_TRACE(txt)  DEBUG((DEBUG_BLKIO, "MMC: " txt "\n"))
+
+#define MMC_IOBLOCKS_READ       0
+#define MMC_IOBLOCKS_WRITE      1
+
+#define MMC_OCR_POWERUP             0x80000000
+
+#define MMC_OCR_ACCESS_MASK         0x3     /* bit[30-29] */
+#define MMC_OCR_ACCESS_BYTE         0x1     /* bit[29] */
+#define MMC_OCR_ACCESS_SECTOR       0x2     /* bit[30] */
+
+#define MMC_CSD_GET_CCC(Response)    (Response[2] >> 20)
+#define MMC_CSD_GET_TRANSPEED(Response)    (Response[3] & 0xFF)
+#define MMC_CSD_GET_READBLLEN(Response)    ((Response[2] >> 16) & 0xF)
+#define MMC_CSD_GET_WRITEBLLEN(Response)  ((Response[0] >> 22) & 0xF)
+#define MMC_CSD_GET_FILEFORMAT(Response)  ((Response[0] >> 10) & 0x3)
+#define MMC_CSD_GET_FILEFORMATGRP(Response)  ((Response[0] >> 15) & 0x1)
+#define MMC_CSD_GET_DEVICESIZE(csd)         (((Response[1] >> 30) & 0x3) | ((Response[2] & 0x3FF) << 2))
+#define HC_MMC_CSD_GET_DEVICESIZE(Response)    ((Response[1] >> 16) | ((Response[2] & 0x3F) << 16));
+#define MMC_CSD_GET_DEVICESIZEMULT(csd)     ((Response[1] >> 15) & 0x7)
+
+#define MMC_R0_READY_FOR_DATA               (1 << 8)
+
+#define MMC_R0_CURRENTSTATE(Response)       ((Response[0] >> 9) & 0xF)
+
+#define MMC_R0_STATE_IDLE       0
+#define MMC_R0_STATE_READY      1
+#define MMC_R0_STATE_IDENT      2
+#define MMC_R0_STATE_STDBY      3
+#define MMC_R0_STATE_TRAN       4
+#define MMC_R0_STATE_DATA       5
+#define MMC_R0_STATE_RECV       6
+#define MMC_R0_STATE_PROG       7
+#define MMC_R0_STATE_DIS        8
+
+
+#define EMMC_CMD6_ARG_ACCESS(x)             (((x) & 0x3) << 24)
+#define EMMC_CMD6_ARG_INDEX(x)              (((x) & 0xFF) << 16)
+#define EMMC_CMD6_ARG_VALUE(x)              (((x) & 0xFF) << 8)
+#define EMMC_CMD6_ARG_CMD_SET(x)            (((x) & 0x7) << 0)
+
+#define SWITCH_CMD_DATA_LENGTH              64
+#define SD_HIGH_SPEED_SUPPORTED             0x200
+#define SD_DEFAULT_SPEED                    25000000
+#define SD_HIGH_SPEED                       50000000
+#define SWITCH_CMD_SUCCESS_MASK             0xf
+
+#define BUSWIDTH_4                          4
+
+typedef enum {
+  UNKNOWN_CARD,
+  MMC_CARD,              //MMC card
+  MMC_CARD_HIGH,         //MMC Card with High capacity
+  EMMC_CARD,             //eMMC 4.41 card
+  SD_CARD,               //SD 1.1 card
+  SD_CARD_2,             //SD 2.0 or above standard card
+  SD_CARD_2_HIGH         //SD 2.0 or above high capacity card
+} CARD_TYPE;
+
+typedef struct {
+  UINT32  Reserved0:   7; // 0
+  UINT32  V170_V195:   1; // 1.70V - 1.95V
+  UINT32  V200_V260:   7; // 2.00V - 2.60V
+  UINT32  V270_V360:   9; // 2.70V - 3.60V
+  UINT32  RESERVED_1:  5; // Reserved
+  UINT32  AccessMode:  2; // 00b (byte mode), 10b (sector mode)
+  UINT32  PowerUp:     1; // This bit is set to LOW if the card has not finished the power up routine
+} OCR;
+
+typedef struct {
+  UINT8   SD_SPEC:               4; // SD Memory Card - Spec. Version [59:56]
+  UINT8   SCR_STRUCTURE:         4; // SCR Structure [63:60]
+  UINT8   SD_BUS_WIDTHS:         4; // DAT Bus widths supported [51:48]
+  UINT8   DATA_STAT_AFTER_ERASE: 1; // Data Status after erases [55]
+  UINT8   SD_SECURITY:           3; // CPRM Security Support [54:52]
+  UINT8   EX_SECURITY_1:         1; // Extended Security Support [43]
+  UINT8   SD_SPEC4:              1; // Spec. Version 4.00 or higher [42]
+  UINT8   RESERVED_1:            2; // Reserved [41:40]
+  UINT8   SD_SPEC3:              1; // Spec. Version 3.00 or higher [47]
+  UINT8   EX_SECURITY_2:         3; // Extended Security Support [46:44]
+  UINT8   CMD_SUPPORT:           4; // Command Support bits [35:32]
+  UINT8   RESERVED_2:            4; // Reserved [39:36]
+  UINT32  RESERVED_3;               // Manufacturer Usage [31:0]
+} SCR;
+
+typedef struct {
+  UINT32  NOT_USED;   // 1 [0:0]
+  UINT32  CRC;        // CRC7 checksum [7:1]
+
+  UINT32  MDT;        // Manufacturing date [19:8]
+  UINT32  RESERVED_1; // Reserved [23:20]
+  UINT32  PSN;        // Product serial number [55:24]
+  UINT8   PRV;        // Product revision [63:56]
+  UINT8   PNM[5];     // Product name [64:103]
+  UINT16  OID;        // OEM/Application ID [119:104]
+  UINT8   MID;        // Manufacturer ID [127:120]
+} CID;
+
+typedef struct {
+  UINT8   NOT_USED:           1; // Not used, always 1 [0:0]
+  UINT8   CRC:                7; // CRC [7:1]
+
+  UINT8   RESERVED_1:         2; // Reserved [9:8]
+  UINT8   FILE_FORMAT:        2; // File format [11:10]
+  UINT8   TMP_WRITE_PROTECT:  1; // Temporary write protection [12:12]
+  UINT8   PERM_WRITE_PROTECT: 1; // Permanent write protection [13:13]
+  UINT8   COPY:               1; // Copy flag (OTP) [14:14]
+  UINT8   FILE_FORMAT_GRP:    1; // File format group [15:15]
+
+  UINT16  RESERVED_2:         5; // Reserved [20:16]
+  UINT16  WRITE_BL_PARTIAL:   1; // Partial blocks for write allowed [21:21]
+  UINT16  WRITE_BL_LEN:       4; // Max. write data block length [25:22]
+  UINT16  R2W_FACTOR:         3; // Write speed factor [28:26]
+  UINT16  RESERVED_3:         2; // Reserved [30:29]
+  UINT16  WP_GRP_ENABLE:      1; // Write protect group enable [31:31]
+
+  UINT32  WP_GRP_SIZE:        7; // Write protect group size [38:32]
+  UINT32  SECTOR_SIZE:        7; // Erase sector size [45:39]
+  UINT32  ERASE_BLK_EN:       1; // Erase single block enable [46:46]
+  UINT32  C_SIZE_MULT:        3; // Device size multiplier [49:47]
+  UINT32  VDD_W_CURR_MAX:     3; // Max. write current @ VDD max [52:50]
+  UINT32  VDD_W_CURR_MIN:     3; // Max. write current @ VDD min [55:53]
+  UINT32  VDD_R_CURR_MAX:     3; // Max. read current @ VDD max [58:56]
+  UINT32  VDD_R_CURR_MIN:     3; // Max. read current @ VDD min [61:59]
+  UINT32  C_SIZELow2:         2; // Device size [63:62]
+
+  UINT32  C_SIZEHigh10:       10;// Device size [73:64]
+  UINT32  RESERVED_4:         2; // Reserved [75:74]
+  UINT32  DSR_IMP:            1; // DSR implemented [76:76]
+  UINT32  READ_BLK_MISALIGN:  1; // Read block misalignment [77:77]
+  UINT32  WRITE_BLK_MISALIGN: 1; // Write block misalignment [78:78]
+  UINT32  READ_BL_PARTIAL:    1; // Partial blocks for read allowed [79:79]
+  UINT32  READ_BL_LEN:        4; // Max. read data block length [83:80]
+  UINT32  CCC:                12;// Card command classes [95:84]
+
+  UINT8   TRAN_SPEED          ;  // Max. bus clock frequency [103:96]
+  UINT8   NSAC                ;  // Data read access-time 2 in CLK cycles (NSAC*100) [111:104]
+  UINT8   TAAC                ;  // Data read access-time 1 [119:112]
+
+  UINT8   RESERVED_5:         2; // Reserved [121:120]
+  UINT8   SPEC_VERS:          4; // System specification version [125:122]
+  UINT8   CSD_STRUCTURE:      2; // CSD structure [127:126]
+} CSD;
+
+typedef struct {
+  UINT8   RESERVED_1[16];                     // Reserved [15:0]
+  UINT8   SECURE_REMOVAL_TYPE;                // Secure Removal Type [16:16]
+  UINT8   PRODUCT_STATE_AWARENESS_ENABLEMENT; // Product state awareness enablement [17:17]
+  UINT8   MAX_PRE_LOADING_DATA_SIZE[4];       // MAX pre loading data size [21:18]
+  UINT8   PRE_LOADING_DATA_SIZE[4];           // Pre loading data size [25:22]
+  UINT8   FFU_STATUS;                         // FFU Status [26:26]
+  UINT8   RESERVED_2[2];                      // Reserved [28:27]
+  UINT8   MODE_OPERATION_CODES;               // Mode operation codes [29:29]
+  UINT8   MODE_CONFIG;                        // Mode config [30:30]
+  UINT8   RESERVED_3;                         // Reserved [31:31]
+  UINT8   FLUSH_CACHE;                        // Flushing of the cache [32:32]
+  UINT8   CACHE_CTRL;                         // Control to turn the cache ON/OFF [33:33]
+  UINT8   POWER_OFF_NOTIFICATION;             // Power Off Notification [34:34]
+  UINT8   PACKED_FAILURE_INDEX;               // Packed command failure index [35:35]
+  UINT8   PACKED_COMMAND_STATUS;              // Packed command status [36:36]
+  UINT8   CONTEXT_CONF[15];                   // Context configuration [51:37]
+  UINT8   EXT_PARTITIONS_ATTRIBUTE[2];        // Extended partitions attribute [53:52]
+  UINT8   EXCEPTION_EVENTS_STATUS[2];         // Exception events status [55:54]
+  UINT8   EXCEPTION_EVENTS_CTRL[2];           // Exception events control [57:56]
+  UINT8   DYNCAP_NEEDED;                      // Number of addressed group to be released [58:58]
+  UINT8   CLASS_6_CTRL;                       // Class 6 commands control [59:59]
+  UINT8   INI_TIMEOUT_EMU;                    // 1st initialization after disabling sector size emulation [60:60]
+  UINT8   DATA_SECTOR_SIZE;                   // Sector size [61:61]
+  UINT8   USE_NATIVE_SECTOR;                  // Sector size emulation [62:62]
+  UINT8   NATIVE_SECTOR_SIZE;                 // Native sector size [63:63]
+  UINT8   VENDOR_SPECIFIC_FIELD[64];          // Vendor specific fields [127:64]
+  UINT8   RESERVED_4[2];                      // Reserved [129:128]
+  UINT8   PROGRAM_CID_CSD_DDR_SUPPORT;        // Program CID/CSD in DDR mode support [130:130]
+  UINT8   PERIODIC_WAKEUP;                    // Periodic wake-up [131:131]
+  UINT8   TCASE_SUPPORT;                      // Package case temperature is controlled [132:132]
+  UINT8   PRODUCTION_STATE_AWARENESS;         // Production state awareness [133:133]
+  UINT8   SECTOR_BAD_BLK_MGMNT;               // Bad block management mode [134:134]
+  UINT8   RESERVED_5;                         // Reserved [135:135]
+  UINT8   ENH_START_ADDR[4];                  // Enhanced user data start address [139:136]
+  UINT8   ENH_SIZE_MULT[3];                   // Enhanced user data area size [142:140]
+  UINT8   GP_SIZE_MULT[12];                   // General purpose partition size [154:143]
+  UINT8   PARTITION_SETTING_COMPLETED;        // Partitioning setting [155:155]
+  UINT8   PARTITIONS_ATTRIBUTE;               // Partitions attribute [156:156]
+  UINT8   MAX_ENH_SIZE_MULT[3];               // Max enhanced area size [159:157]
+  UINT8   PARTITIONING_SUPPORT;               // Partitioning [160:160]
+  UINT8   HPI_MGMT;                           // HPI management [161:161]
+  UINT8   RST_N_FUNCTION;                     // H/W reset function [162:162]
+  UINT8   BKOPS_EN;                           // Enable background operations handshake [163:163]
+  UINT8   BKOPS_START;                        // Manually start background operations [164:164]
+  UINT8   SANITIZE_START;                     // Start sanitize operation [165:165]
+  UINT8   WR_REL_PARAM;                       // Write reliability parameter register [166:166]
+  UINT8   WR_REL_SET;                         // Write reliability setting register [167:167]
+  UINT8   RPMB_SIZE_MULT;                     // RPMB size [168:168]
+  UINT8   FW_CONFIG;                          // FW configuration [169:169]
+  UINT8   RESERVED_6;                         // Reserved [170:170]
+  UINT8   USER_WP;                            // User area write protection register [171:171]
+  UINT8   RESERVED_7;                         // Reserved [172:172]
+  UINT8   BOOT_WP;                            // Boot area write protection register [173:173]
+  UINT8   BOOT_WP_STATUS;                     // Boot write protection register [174:174]
+  UINT8   ERASE_GROUP_DEF;                    // High-density erase group definition [175:175]
+  UINT8   RESERVED_8;                         // Reserved [176:176]
+  UINT8   BOOT_BUS_CONDITIONS;                // Boot bus conditions [177:177]
+  UINT8   BOOT_CONFIG_PROT;                   // Boot config protection [178:178]
+  UINT8   PARTITION_CONFIG;                   // Partition config [179:179]
+  UINT8   RESERVED_9;                         // Reserved [180:180]
+  UINT8   ERASED_MEM_CONT;                    // Erased memory content [181:181]
+  UINT8   RESERVED_10;                        // Reserved [182:182]
+  UINT8   BUS_WIDTH;                          // Bus width mode [183:183]
+  UINT8   RESERVED_11;                        // Reserved [184:184]
+  UINT8   HS_TIMING;                          // High-speed interface timing [185:185]
+  UINT8   RESERVED_12;                        // Reserved [186:186]
+  UINT8   POWER_CLASS;                        // Power class [187:187]
+  UINT8   RESERVED_13;                        // Reserved [188:188]
+  UINT8   CMD_SET_REV;                        // Command set revision [189:189]
+  UINT8   RESERVED_14;                        // Reserved [190:190]
+  UINT8   CMD_SET;                            // Command set [191:191]
+  UINT8   EXT_CSD_REV;                        // Extended CSD revision [192:192]
+  UINT8   RESERVED_15;                        // Reserved [193:193]
+  UINT8   CSD_STRUCTURE;                      // CSD Structure [194:194]
+  UINT8   RESERVED_16;                        // Reserved [195:195]
+  UINT8   DEVICE_TYPE;                        // Device type [196:196]
+  UINT8   DRIVER_STRENGTH;                    // I/O Driver strength [197:197]
+  UINT8   OUT_OF_INTERRUPT_TIME;              // Out-of-interrupt busy timing [198:198]
+  UINT8   PARTITION_SWITCH_TIME;              // Partition switching timing [199:199]
+  UINT8   PWR_CL_52_195;                      // Power class for 52MHz at 1.95V 1 R [200:200]
+  UINT8   PWR_CL_26_195;                      // Power class for 26MHz at 1.95V 1 R [201:201]
+  UINT8   PWR_CL_52_360;                      // Power class for 52MHz at 3.6V 1 R [202:202]
+  UINT8   PWR_CL_26_360;                      // Power class for 26MHz at 3.6V 1 R [203:203]
+  UINT8   RESERVED_17;                        // Reserved [204:204]
+  UINT8   MIN_PERF_R_4_26;                    // Minimum read performance for 4bit at 26MHz [205:205]
+  UINT8   MIN_PERF_W_4_26;                    // Minimum write performance for 4bit at 26MHz [206:206]
+  UINT8   MIN_PERF_R_8_26_4_52;               // Minimum read performance for 8bit at 26MHz, for 4bit at 52MHz [207:207]
+  UINT8   MIN_PERF_W_8_26_4_52;               // Minimum write performance for 8bit at 26MHz, for 4bit at 52MHz [208:208]
+  UINT8   MIN_PERF_R_8_52;                    // Minimum read performance for 8bit at 52MHz [209:209]
+  UINT8   MIN_PERF_W_8_52;                    // Minimum write performance for 8bit at 52MHz [210:210]
+  UINT8   RESERVED_18;                        // Reserved [211:211]
+  UINT32  SECTOR_COUNT;                       // Sector count [215:212]
+  UINT8   SLEEP_NOTIFICATION_TIME;            // Sleep notification timout [216:216]
+  UINT8   S_A_TIMEOUT;                        // Sleep/awake timeout [217:217]
+  UINT8   PRODUCTION_STATE_AWARENESS_TIMEOUT; // Production state awareness timeout [218:218]
+  UINT8   S_C_VCCQ;                           // Sleep current (VCCQ) [219:219]
+  UINT8   S_C_VCC;                            // Sleep current (VCC) [220:220]
+  UINT8   HC_WP_GRP_SIZE;                     // High-capacity write protect group size [221:221]
+  UINT8   REL_WR_SECTOR_C;                    // Reliable write sector count [222:222]
+  UINT8   ERASE_TIMEOUT_MULT;                 // High-capacity erase timeout [223:223]
+  UINT8   HC_ERASE_GRP_SIZE;                  // High-capacity erase unit size [224:224]
+  UINT8   ACC_SIZE;                           // Access size [225:225]
+  UINT8   BOOT_SIZE_MULTI;                    // Boot partition size [226:226]
+  UINT8   RESERVED_19;                        // Reserved [227:227]
+  UINT8   BOOT_INFO;                          // Boot information [228:228]
+  UINT8   SECURE_TRIM_MULT;                   // Secure TRIM Multiplier [229:229]
+  UINT8   SECURE_ERASE_MULT;                  // Secure Erase Multiplier [230:230]
+  UINT8   SECURE_FEATURE_SUPPORT;             // Secure Feature Support [231:231]
+  UINT8   TRIM_MULT;                          // TRIM Multiplier [232:232]
+  UINT8   RESERVED_20;                        // Reserved [233:233]
+  UINT8   MIN_PREF_DDR_R_8_52;                // Minimum read performance for 8bit at 52MHz in DDR mode [234:234]
+  UINT8   MIN_PREF_DDR_W_8_52;                // Minimum write performance for 8bit at 52MHz in DDR mode [235:235]
+  UINT8   PWR_CL_200_130;                     // Power class for 200MHz at VCCQ=1.3V, VCC=3.6V [236:236]
+  UINT8   PWR_CL_200_195;                     // Power class for 200MHz at VCCQ=1.95V, VCC=3.6V [237:237]
+  UINT8   PWR_CL_DDR_52_195;                  // Power class for 52MHz, DDR at 1.95V [238:238]
+  UINT8   PWR_CL_DDR_52_360;                  // Power class for 52Mhz, DDR at 3.6V [239:239]
+  UINT8   RESERVED_21;                        // Reserved [240:240]
+  UINT8   INI_TIMEOUT_AP;                     // 1st initialization time after partitioning [241:241]
+  UINT8   CORRECTLY_PRG_SECTORS_NUM[4];       // Number of correctly programmed sectors [245:242]
+  UINT8   BKOPS_STATUS;                       // Background operations status [246:246]
+  UINT8   POWER_OFF_LONG_TIME;                // Power off notification (long) timeout [247:247]
+  UINT8   GENERIC_CMD6_TIME;                  // Generic CMD6 timeout [248:248]
+  UINT8   CACHE_SIZE[4];                      // Cache size [252:249]
+  UINT8   PWR_CL_DDR_200_360;                 // Power class for 200MHz, DDR at VCC=3.6V [253:253]
+  UINT8   FIRMWARE_VERSION[8];                // Firmware version [261:254]
+  UINT8   DEVICE_VERSION[2];                  // Device version [263:262]
+  UINT8   OPTIMAL_TRIM_UNIT_SIZE;             // Optimal trim unit size [264:264]
+  UINT8   OPTIMAL_WRITE_SIZE;                 // Optimal write size [265:265]
+  UINT8   OPTIMAL_READ_SIZE;                  // Optimal read size [266:266]
+  UINT8   PRE_EOL_INFO;                       // Pre EOL information [267:267]
+  UINT8   DEVICE_LIFE_TIME_EST_TYP_A;         // Device life time estimation type A [268:268]
+  UINT8   DEVICE_LIFE_TIME_EST_TYP_B;         // Device life time estimation type B [269:269]
+  UINT8   VENDOR_PROPRIETARY_HEALTH_REPORT[32];         // Vendor proprietary health report [301:270]
+  UINT8   NUMBER_OF_FW_SECTORS_CORRECTLY_PROGRAMMED[4]; // Number of FW sectors correctly programmed [305:302]
+  UINT8   RESERVED_22[181];                   // Reserved [486:306]
+  UINT8   FFU_ARG[4];                         // FFU argument [490:487]
+  UINT8   OPERATION_CODE_TIMEOUT;             // Operation codes timeout [491:491]
+  UINT8   FFU_FEATURES;                       // FFU features [492:492]
+  UINT8   SUPPORTED_MODES;                    // Supported modes [493:493]
+  UINT8   EXT_SUPPORT;                        // Extended partitions attribute support [494:494]
+  UINT8   LARGE_UNIT_SIZE_M1;                 // Large unit size [495:495]
+  UINT8   CONTEXT_CAPABILITIES;               // Context management capabilities [496:496]
+  UINT8   TAG_RES_SIZE;                       // Tag resource size [497:497]
+  UINT8   TAG_UNIT_SIZE;                      // Tag unit size [498:498]
+  UINT8   DATA_TAG_SUPPORT;                   // Data tag support [499:499]
+  UINT8   MAX_PACKED_WRITES;                  // Max packed write commands [500:500]
+  UINT8   MAX_PACKED_READS;                   // Max packed read commands [501:501]
+  UINT8   BKOPS_SUPPORT;                      // Background operations support [502:502]
+  UINT8   HPI_FEATURES;                       // HPI features [503:503]
+  UINT8   S_CMD_SET;                          // Supported command sets [504:504]
+  UINT8   EXT_SECURITY_ERR;                   // Extended security commands error [505:505]
+  UINT8   RESERVED_23[6];                     // Reserved [511:506]
+} ECSD;
+
+typedef struct {
+  UINT16    RCA;
+  CARD_TYPE CardType;
+  OCR       OCRData;
+  CID       CIDData;
+  CSD       CSDData;
+  ECSD      *ECSDData;                         // MMC V4 extended card specific
+} CARD_INFO;
+
+typedef struct _MMC_HOST_INSTANCE {
+  UINTN                     Signature;
+  LIST_ENTRY                Link;
+  EFI_HANDLE                MmcHandle;
+  EFI_DEVICE_PATH_PROTOCOL  *DevicePath;
+
+  MMC_STATE                 State;
+  EFI_BLOCK_IO_PROTOCOL     BlockIo;
+  CARD_INFO                 CardInfo;
+  EFI_MMC_HOST_PROTOCOL     *MmcHost;
+
+  BOOLEAN                   Initialized;
+} MMC_HOST_INSTANCE;
+
+#define MMC_HOST_INSTANCE_SIGNATURE                 SIGNATURE_32('m', 'm', 'c', 'h')
+#define MMC_HOST_INSTANCE_FROM_BLOCK_IO_THIS(a)     CR (a, MMC_HOST_INSTANCE, BlockIo, MMC_HOST_INSTANCE_SIGNATURE)
+#define MMC_HOST_INSTANCE_FROM_LINK(a)              CR (a, MMC_HOST_INSTANCE, Link, MMC_HOST_INSTANCE_SIGNATURE)
+
+
+EFI_STATUS
+EFIAPI
+MmcGetDriverName (
+  IN  EFI_COMPONENT_NAME_PROTOCOL  *This,
+  IN  CHAR8                        *Language,
+  OUT CHAR16                       **DriverName
+  );
+
+EFI_STATUS
+EFIAPI
+MmcGetControllerName (
+  IN  EFI_COMPONENT_NAME_PROTOCOL                     *This,
+  IN  EFI_HANDLE                                      ControllerHandle,
+  IN  EFI_HANDLE                                      ChildHandle        OPTIONAL,
+  IN  CHAR8                                           *Language,
+  OUT CHAR16                                          **ControllerName
+  );
+
+extern EFI_COMPONENT_NAME_PROTOCOL  gMmcComponentName;
+extern EFI_COMPONENT_NAME2_PROTOCOL gMmcComponentName2;
+
+extern EFI_DRIVER_DIAGNOSTICS2_PROTOCOL gMmcDriverDiagnostics2;
+
+extern LIST_ENTRY mMmcHostPool;
+
+/**
+  Reset the block device.
+
+  This function implements EFI_BLOCK_IO_PROTOCOL.Reset().
+  It resets the block device hardware.
+  ExtendedVerification is ignored in this implementation.
+
+  @param  This                   Indicates a pointer to the calling context.
+  @param  ExtendedVerification   Indicates that the driver may perform a more exhaustive
+                                 verification operation of the device during reset.
+
+  @retval EFI_SUCCESS            The block device was reset.
+  @retval EFI_DEVICE_ERROR       The block device is not functioning correctly and could not be reset.
+
+**/
+EFI_STATUS
+EFIAPI
+MmcReset (
+  IN EFI_BLOCK_IO_PROTOCOL    *This,
+  IN BOOLEAN                  ExtendedVerification
+  );
+
+/**
+  Reads the requested number of blocks from the device.
+
+  This function implements EFI_BLOCK_IO_PROTOCOL.ReadBlocks().
+  It reads the requested number of blocks from the device.
+  All the blocks are read, or an error is returned.
+
+  @param  This                   Indicates a pointer to the calling context.
+  @param  MediaId                The media ID that the read request is for.
+  @param  Lba                    The starting logical block address to read from on the device.
+  @param  BufferSize             The size of the Buffer in bytes.
+                                 This must be a multiple of the intrinsic block size of the device.
+  @param  Buffer                 A pointer to the destination buffer for the data. The caller is
+                                 responsible for either having implicit or explicit ownership of the buffer.
+
+  @retval EFI_SUCCESS            The data was read correctly from the device.
+  @retval EFI_DEVICE_ERROR       The device reported an error while attempting to perform the read operation.
+  @retval EFI_NO_MEDIA           There is no media in the device.
+  @retval EFI_MEDIA_CHANGED      The MediaId is not for the current media.
+  @retval EFI_BAD_BUFFER_SIZE    The BufferSize parameter is not a multiple of the intrinsic block size of the device.
+  @retval EFI_INVALID_PARAMETER  The read request contains LBAs that are not valid,
+                                 or the buffer is not on proper alignment.
+
+**/
+EFI_STATUS
+EFIAPI
+MmcReadBlocks (
+  IN EFI_BLOCK_IO_PROTOCOL    *This,
+  IN UINT32                   MediaId,
+  IN EFI_LBA                  Lba,
+  IN UINTN                    BufferSize,
+  OUT VOID                    *Buffer
+  );
+
+/**
+  Writes a specified number of blocks to the device.
+
+  This function implements EFI_BLOCK_IO_PROTOCOL.WriteBlocks().
+  It writes a specified number of blocks to the device.
+  All blocks are written, or an error is returned.
+
+  @param  This                   Indicates a pointer to the calling context.
+  @param  MediaId                The media ID that the write request is for.
+  @param  Lba                    The starting logical block address to be written.
+  @param  BufferSize             The size of the Buffer in bytes.
+                                 This must be a multiple of the intrinsic block size of the device.
+  @param  Buffer                 Pointer to the source buffer for the data.
+
+  @retval EFI_SUCCESS            The data were written correctly to the device.
+  @retval EFI_WRITE_PROTECTED    The device cannot be written to.
+  @retval EFI_NO_MEDIA           There is no media in the device.
+  @retval EFI_MEDIA_CHANGED      The MediaId is not for the current media.
+  @retval EFI_DEVICE_ERROR       The device reported an error while attempting to perform the write operation.
+  @retval EFI_BAD_BUFFER_SIZE    The BufferSize parameter is not a multiple of the intrinsic
+                                 block size of the device.
+  @retval EFI_INVALID_PARAMETER  The write request contains LBAs that are not valid,
+                                 or the buffer is not on proper alignment.
+
+**/
+EFI_STATUS
+EFIAPI
+MmcWriteBlocks (
+  IN EFI_BLOCK_IO_PROTOCOL    *This,
+  IN UINT32                   MediaId,
+  IN EFI_LBA                  Lba,
+  IN UINTN                    BufferSize,
+  IN VOID                     *Buffer
+  );
+
+/**
+  Flushes all modified data to a physical block device.
+
+  @param  This                   Indicates a pointer to the calling context.
+
+  @retval EFI_SUCCESS            All outstanding data were written correctly to the device.
+  @retval EFI_DEVICE_ERROR       The device reported an error while attempting to write data.
+  @retval EFI_NO_MEDIA           There is no media in the device.
+
+**/
+EFI_STATUS
+EFIAPI
+MmcFlushBlocks (
+  IN EFI_BLOCK_IO_PROTOCOL  *This
+  );
+
+EFI_STATUS
+MmcNotifyState (
+  IN MMC_HOST_INSTANCE      *MmcHostInstance,
+  IN MMC_STATE               State
+  );
+
+EFI_STATUS
+InitializeMmcDevice (
+  IN  MMC_HOST_INSTANCE     *MmcHost
+  );
+
+VOID
+EFIAPI
+CheckCardsCallback (
+  IN  EFI_EVENT   Event,
+  IN  VOID        *Context
+  );
+
+VOID
+PrintCSD (
+  IN UINT32* Csd
+  );
+
+VOID
+PrintRCA (
+  IN UINT32 Rca
+  );
+
+VOID
+PrintOCR (
+  IN UINT32 Ocr
+  );
+
+VOID
+PrintResponseR1 (
+  IN  UINT32 Response
+  );
+
+VOID
+PrintCID (
+  IN UINT32* Cid
+  );
+
+#endif
diff --git a/Platform/RaspberryPi/RPi3/Drivers/MmcDxe/MmcBlockIo.c b/Platform/RaspberryPi/RPi3/Drivers/MmcDxe/MmcBlockIo.c
new file mode 100644
index 000000000000..ede814dfa251
--- /dev/null
+++ b/Platform/RaspberryPi/RPi3/Drivers/MmcDxe/MmcBlockIo.c
@@ -0,0 +1,469 @@
+/** @file
+ *
+ *  Copyright (c) 2011-2015, ARM Limited. All rights reserved.
+ *
+ *  This program and the accompanying materials
+ *  are licensed and made available under the terms and conditions of the BSD License
+ *  which accompanies this distribution.  The full text of the license may be found at
+ *  http://opensource.org/licenses/bsd-license.php
+ *
+ *  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+ *  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+ *
+ **/
+
+#include <Library/BaseMemoryLib.h>
+
+#include "Mmc.h"
+
+#define MMCI0_BLOCKLEN 512
+#define MMCI0_TIMEOUT  1000
+
+STATIC
+EFI_STATUS
+R1TranAndReady (
+  UINT32 *Response
+  )
+{
+  if ((*Response & MMC_R0_READY_FOR_DATA) != 0 &&
+      MMC_R0_CURRENTSTATE (Response) == MMC_R0_STATE_TRAN) {
+    return EFI_SUCCESS;
+  }
+
+  return EFI_NOT_READY;
+}
+
+STATIC
+EFI_STATUS
+ValidateWrittenBlockCount (
+  IN  MMC_HOST_INSTANCE *MmcHostInstance,
+  IN  UINTN Count,
+  OUT UINTN *TransferredBlocks
+  )
+{
+  UINT32 R1;
+  UINT8 Data[4];
+  EFI_STATUS Status;
+  UINT32 BlocksWritten;
+  EFI_MMC_HOST_PROTOCOL *MmcHost = MmcHostInstance->MmcHost;
+
+  if (MmcHostInstance->CardInfo.CardType == MMC_CARD ||
+      MmcHostInstance->CardInfo.CardType == MMC_CARD_HIGH ||
+      MmcHostInstance->CardInfo.CardType == EMMC_CARD) {
+    /*
+     * Not on MMC.
+     */
+    return EFI_SUCCESS;
+  }
+
+  Status = MmcHost->SendCommand (MmcHost, MMC_CMD55,
+                      MmcHostInstance->CardInfo.RCA << 16);
+  if (EFI_ERROR (Status)) {
+    DEBUG ((DEBUG_ERROR, "%a(%u): error: %r\n", __FUNCTION__, __LINE__, Status));
+    return Status;
+  }
+
+  Status = MmcHost->SendCommand (MmcHost, MMC_ACMD22, 0);
+  if (EFI_ERROR (Status)) {
+    DEBUG ((DEBUG_ERROR, "%a(%u): error: %r\n",
+      __FUNCTION__, __LINE__, Status));
+    return Status;
+  }
+
+  MmcHost->ReceiveResponse (MmcHost, MMC_RESPONSE_TYPE_R1, &R1);
+  Status = R1TranAndReady (&R1);
+  if (EFI_ERROR (Status)) {
+    return Status;
+  }
+
+  // Read Data
+  Status = MmcHost->ReadBlockData (MmcHost, 0, sizeof (Data),
+                      (VOID*)Data);
+  if (EFI_ERROR (Status)) {
+    DEBUG ((DEBUG_ERROR, "%a(%u): error: %r\n", __FUNCTION__, __LINE__, Status));
+    return Status;
+  }
+
+  /*
+   * Big Endian.
+   */
+  BlocksWritten = ((UINT32)Data[0] << 24) |
+                  ((UINT32)Data[1] << 16) |
+                  ((UINT32)Data[2] << 8) |
+                  ((UINT32)Data[3] << 0);
+  if (BlocksWritten != Count) {
+    DEBUG ((DEBUG_ERROR, "%a(%u): expected %u != gotten %u\n",
+      __FUNCTION__, __LINE__, Count, BlocksWritten));
+    if (BlocksWritten == 0) {
+      return EFI_DEVICE_ERROR;
+    }
+  }
+
+  *TransferredBlocks = BlocksWritten;
+  return EFI_SUCCESS;
+}
+
+STATIC
+EFI_STATUS
+WaitUntilTran (
+  IN MMC_HOST_INSTANCE *MmcHostInstance
+  )
+{
+  INTN Timeout;
+  UINT32 Response[1];
+  EFI_STATUS Status = EFI_SUCCESS;
+  EFI_MMC_HOST_PROTOCOL *MmcHost = MmcHostInstance->MmcHost;
+
+  Timeout = MMCI0_TIMEOUT;
+  while (Timeout--) {
+    /*
+     * We expect CMD13 to timeout while card is programming,
+     * because the card holds DAT0 low (busy).
+     */
+    Status = MmcHost->SendCommand (MmcHost, MMC_CMD13,
+                        MmcHostInstance->CardInfo.RCA << 16);
+    if (EFI_ERROR (Status) && Status != EFI_TIMEOUT) {
+      DEBUG ((DEBUG_ERROR, "%a(%u) CMD13 failed: %r\n", __FUNCTION__, __LINE__, Status));
+      break;
+    }
+
+    if (Status == EFI_SUCCESS) {
+      MmcHost->ReceiveResponse (MmcHost, MMC_RESPONSE_TYPE_R1, Response);
+      Status = R1TranAndReady (Response);
+      if (!EFI_ERROR (Status)) {
+        break;
+      }
+    }
+
+    gBS->Stall (1000);
+  }
+
+  if (0 == Timeout) {
+    DEBUG ((DEBUG_ERROR, "%a(%u) card is busy\n", __FUNCTION__, __LINE__));
+    return EFI_NOT_READY;
+  }
+
+  return Status;
+}
+
+EFI_STATUS
+MmcNotifyState (
+  IN MMC_HOST_INSTANCE *MmcHostInstance,
+  IN MMC_STATE State
+  )
+{
+  MmcHostInstance->State = State;
+  return MmcHostInstance->MmcHost->NotifyState (MmcHostInstance->MmcHost, State);
+}
+
+EFI_STATUS
+EFIAPI
+MmcReset (
+  IN EFI_BLOCK_IO_PROTOCOL    *This,
+  IN BOOLEAN                  ExtendedVerification
+  )
+{
+  MMC_HOST_INSTANCE       *MmcHostInstance;
+
+  MmcHostInstance = MMC_HOST_INSTANCE_FROM_BLOCK_IO_THIS (This);
+
+  if (MmcHostInstance->MmcHost == NULL) {
+    // Nothing to do
+    return EFI_SUCCESS;
+  }
+
+  // If a card is not present then clear all media settings
+  if (!MmcHostInstance->MmcHost->IsCardPresent (MmcHostInstance->MmcHost)) {
+    MmcHostInstance->BlockIo.Media->MediaPresent = FALSE;
+    MmcHostInstance->BlockIo.Media->LastBlock    = 0;
+    MmcHostInstance->BlockIo.Media->BlockSize    = 512;  // Should be zero but there is a bug in DiskIo
+    MmcHostInstance->BlockIo.Media->ReadOnly     = FALSE;
+
+    // Indicate that the driver requires initialization
+    MmcHostInstance->State = MmcHwInitializationState;
+
+    return EFI_SUCCESS;
+  }
+
+  // Implement me. Either send a CMD0 (could not work for some MMC host)
+  // or just turn off/turn on power and restart Identification mode.
+  return EFI_SUCCESS;
+}
+
+EFI_STATUS
+MmcDetectCard (
+  EFI_MMC_HOST_PROTOCOL *MmcHost
+  )
+{
+  if (!MmcHost->IsCardPresent (MmcHost)) {
+    return EFI_NO_MEDIA;
+  } else {
+    return EFI_SUCCESS;
+  }
+}
+
+EFI_STATUS
+MmcStopTransmission (
+  EFI_MMC_HOST_PROTOCOL *MmcHost
+  )
+{
+  EFI_STATUS              Status;
+  UINT32                  Response[4];
+  // Command 12 - Stop transmission (ends read or write)
+  // Normally only needed for streaming transfers or after error.
+  Status = MmcHost->SendCommand (MmcHost, MMC_CMD12, 0);
+  if (!EFI_ERROR (Status)) {
+    MmcHost->ReceiveResponse (MmcHost, MMC_RESPONSE_TYPE_R1b, Response);
+  }
+  return Status;
+}
+
+STATIC
+EFI_STATUS
+MmcTransferBlock (
+  IN EFI_BLOCK_IO_PROTOCOL    *This,
+  IN UINTN                    Cmd,
+  IN UINTN                    Transfer,
+  IN UINT32                   MediaId,
+  IN EFI_LBA                  Lba,
+  IN UINTN                    BufferSize,
+  OUT VOID                    *Buffer,
+  OUT UINTN                   *TransferredSize
+  )
+{
+  EFI_STATUS              Status;
+  MMC_HOST_INSTANCE       *MmcHostInstance;
+  EFI_MMC_HOST_PROTOCOL   *MmcHost;
+  UINTN                   CmdArg;
+
+  MmcHostInstance = MMC_HOST_INSTANCE_FROM_BLOCK_IO_THIS (This);
+  MmcHost = MmcHostInstance->MmcHost;
+
+  //Set command argument based on the card access mode (Byte mode or Block mode)
+  if ((MmcHostInstance->CardInfo.OCRData.AccessMode & MMC_OCR_ACCESS_MASK) ==
+      MMC_OCR_ACCESS_SECTOR) {
+    CmdArg = Lba;
+  } else {
+    CmdArg = Lba * This->Media->BlockSize;
+  }
+
+  Status = MmcHost->SendCommand (MmcHost, Cmd, CmdArg);
+  if (EFI_ERROR (Status)) {
+    DEBUG ((DEBUG_ERROR, "%a(MMC_CMD%d): Error %r\n", __func__, MMC_INDX (Cmd), Status));
+    return Status;
+  }
+
+  if (Transfer == MMC_IOBLOCKS_READ) {
+    Status = MmcHost->ReadBlockData (MmcHost, Lba, BufferSize, Buffer);
+  } else {
+    Status = MmcHost->WriteBlockData (MmcHost, Lba, BufferSize, Buffer);
+    if (!EFI_ERROR (Status)) {
+      Status = MmcNotifyState (MmcHostInstance, MmcProgrammingState);
+      if (EFI_ERROR (Status)) {
+        DEBUG ((DEBUG_ERROR, "%a(): Error MmcProgrammingState\n", __func__));
+        return Status;
+      }
+    }
+  }
+
+  if (EFI_ERROR (Status) ||
+      BufferSize > This->Media->BlockSize) {
+    /*
+     * CMD12 needs to be set for multiblock (to transition from
+     * RECV to PROG) or for errors.
+     */
+    EFI_STATUS Status2 = MmcStopTransmission (MmcHost);
+    if (EFI_ERROR (Status2)) {
+      DEBUG ((DEBUG_ERROR, "MmcIoBlocks(): CMD12 error on Status %r: %r\n",
+        Status, Status2));
+      return Status2;
+    }
+
+    if (EFI_ERROR (Status)) {
+      DEBUG ((DEBUG_BLKIO, "%a(): Error %a Block Data and Status = %r\n",
+        __func__, Transfer == MMC_IOBLOCKS_READ ? "Read" : "Write", Status));
+      return Status;
+    }
+
+    ASSERT (Cmd == MMC_CMD25 || Cmd == MMC_CMD18);
+  }
+
+  //
+  // For reads, should be already in TRAN. For writes, wait
+  // until programming finishes.
+  //
+  Status = WaitUntilTran (MmcHostInstance);
+  if (EFI_ERROR (Status)) {
+    DEBUG ((DEBUG_ERROR, "WaitUntilTran after write failed\n"));
+    return Status;
+  }
+
+  Status = MmcNotifyState (MmcHostInstance, MmcTransferState);
+  if (EFI_ERROR (Status)) {
+    DEBUG ((DEBUG_ERROR, "MmcIoBlocks() : Error MmcTransferState\n"));
+    return Status;
+  }
+
+  if (Transfer != MMC_IOBLOCKS_READ) {
+    UINTN BlocksWritten = 0;
+
+    Status = ValidateWrittenBlockCount (MmcHostInstance,
+               BufferSize /
+               This->Media->BlockSize,
+               &BlocksWritten);
+    *TransferredSize = BlocksWritten * This->Media->BlockSize;
+  } else {
+    *TransferredSize = BufferSize;
+  }
+
+  return Status;
+}
+
+EFI_STATUS
+MmcIoBlocks (
+  IN EFI_BLOCK_IO_PROTOCOL    *This,
+  IN UINTN                    Transfer,
+  IN UINT32                   MediaId,
+  IN EFI_LBA                  Lba,
+  IN UINTN                    BufferSize,
+  OUT VOID                    *Buffer
+  )
+{
+  EFI_STATUS              Status;
+  UINTN                   Cmd;
+  MMC_HOST_INSTANCE       *MmcHostInstance;
+  EFI_MMC_HOST_PROTOCOL   *MmcHost;
+  UINTN                   BytesRemainingToBeTransfered;
+  UINTN                   BlockCount;
+  UINTN                   ConsumeSize;
+
+  BlockCount = 1;
+  MmcHostInstance = MMC_HOST_INSTANCE_FROM_BLOCK_IO_THIS (This);
+  ASSERT (MmcHostInstance != NULL);
+  MmcHost = MmcHostInstance->MmcHost;
+  ASSERT (MmcHost);
+
+  if (This->Media->MediaId != MediaId) {
+    return EFI_MEDIA_CHANGED;
+  }
+
+  if ((MmcHost == NULL) || (Buffer == NULL)) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  // Check if a Card is Present
+  if (!MmcHostInstance->BlockIo.Media->MediaPresent) {
+    return EFI_NO_MEDIA;
+  }
+
+  if (PcdGet32 (PcdMmcDisableMulti) == 0 &&
+      MMC_HOST_HAS_ISMULTIBLOCK (MmcHost) &&
+      MmcHost->IsMultiBlock (MmcHost)) {
+    BlockCount = (BufferSize + This->Media->BlockSize - 1) / This->Media->BlockSize;
+  }
+
+  // All blocks must be within the device
+  if ((Lba + (BufferSize / This->Media->BlockSize)) > (This->Media->LastBlock + 1)) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  if ((Transfer == MMC_IOBLOCKS_WRITE) && (This->Media->ReadOnly == TRUE)) {
+    return EFI_WRITE_PROTECTED;
+  }
+
+  // Reading 0 Byte is valid
+  if (BufferSize == 0) {
+    return EFI_SUCCESS;
+  }
+
+  // The buffer size must be an exact multiple of the block size
+  if ((BufferSize % This->Media->BlockSize) != 0) {
+    return EFI_BAD_BUFFER_SIZE;
+  }
+
+  // Check the alignment
+  if ((This->Media->IoAlign > 2) && (((UINTN)Buffer & (This->Media->IoAlign - 1)) != 0)) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  BytesRemainingToBeTransfered = BufferSize;
+  while (BytesRemainingToBeTransfered > 0) {
+    Status = WaitUntilTran (MmcHostInstance);
+    if (EFI_ERROR (Status)) {
+      DEBUG ((DEBUG_ERROR, "WaitUntilTran before IO failed"));
+      return Status;
+    }
+
+    if (Transfer == MMC_IOBLOCKS_READ) {
+      if (BlockCount == 1) {
+        // Read a single block
+        Cmd = MMC_CMD17;
+      } else {
+        // Read multiple blocks
+        Cmd = MMC_CMD18;
+      }
+    } else {
+      if (BlockCount == 1) {
+        // Write a single block
+        Cmd = MMC_CMD24;
+      } else {
+        // Write multiple blocks
+        Cmd = MMC_CMD25;
+      }
+    }
+
+    ConsumeSize = BlockCount * This->Media->BlockSize;
+    if (BytesRemainingToBeTransfered < ConsumeSize) {
+      ConsumeSize = BytesRemainingToBeTransfered;
+    }
+
+    Status = MmcTransferBlock (This, Cmd, Transfer, MediaId, Lba, ConsumeSize, Buffer, &ConsumeSize);
+    if (EFI_ERROR (Status)) {
+      DEBUG ((DEBUG_ERROR, "%a(): Failed to transfer block and Status:%r\n", __func__, Status));
+      return Status;
+    }
+
+    BytesRemainingToBeTransfered -= ConsumeSize;
+    if (BytesRemainingToBeTransfered > 0) {
+      Lba += BlockCount;
+      Buffer = (UINT8*)Buffer + ConsumeSize;
+    }
+  }
+
+  return EFI_SUCCESS;
+}
+
+EFI_STATUS
+EFIAPI
+MmcReadBlocks (
+  IN EFI_BLOCK_IO_PROTOCOL    *This,
+  IN UINT32                   MediaId,
+  IN EFI_LBA                  Lba,
+  IN UINTN                    BufferSize,
+  OUT VOID                    *Buffer
+  )
+{
+  return MmcIoBlocks (This, MMC_IOBLOCKS_READ, MediaId, Lba, BufferSize, Buffer);
+}
+
+EFI_STATUS
+EFIAPI
+MmcWriteBlocks (
+  IN EFI_BLOCK_IO_PROTOCOL    *This,
+  IN UINT32                   MediaId,
+  IN EFI_LBA                  Lba,
+  IN UINTN                    BufferSize,
+  IN VOID                     *Buffer
+  )
+{
+  return MmcIoBlocks (This, MMC_IOBLOCKS_WRITE, MediaId, Lba, BufferSize, Buffer);
+}
+
+EFI_STATUS
+EFIAPI
+MmcFlushBlocks (
+  IN EFI_BLOCK_IO_PROTOCOL  *This
+  )
+{
+  return EFI_SUCCESS;
+}
diff --git a/Platform/RaspberryPi/RPi3/Drivers/MmcDxe/MmcDebug.c b/Platform/RaspberryPi/RPi3/Drivers/MmcDxe/MmcDebug.c
new file mode 100644
index 000000000000..c0af5f6e8deb
--- /dev/null
+++ b/Platform/RaspberryPi/RPi3/Drivers/MmcDxe/MmcDebug.c
@@ -0,0 +1,170 @@
+/** @file
+ *
+ *  Copyright (c) 2011-2013, ARM Limited. All rights reserved.
+ *
+ *  This program and the accompanying materials
+ *  are licensed and made available under the terms and conditions of the BSD License
+ *  which accompanies this distribution.  The full text of the license may be found at
+ *  http://opensource.org/licenses/bsd-license.php
+ *
+ *  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+ *  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+ *
+ **/
+
+#include "Mmc.h"
+
+#if !defined(MDEPKG_NDEBUG)
+CONST CHAR8* mStrUnit[] = { "100kbit/s", "1Mbit/s", "10Mbit/s", "100MBit/s",
+                            "Unknown", "Unknown", "Unknown", "Unknown" };
+CONST CHAR8* mStrValue[] = { "1.0", "1.2", "1.3", "1.5", "2.0", "2.5",
+                             "3.0", "3.5", "4.0", "4.5", "5.0", "5.5",
+                             "6.0", "7.0", "8.0" };
+#endif
+
+VOID
+PrintCID (
+  IN UINT32* Cid
+  )
+{
+  DEBUG ((DEBUG_ERROR, "- PrintCID\n"));
+  DEBUG ((DEBUG_ERROR, "\t- Manufacturing date: %d/%d\n", (Cid[0] >> 8) & 0xF, (Cid[0] >> 12) & 0xFF));
+  DEBUG ((DEBUG_ERROR, "\t- Product serial number: 0x%X%X\n", Cid[1] & 0xFFFFFF, (Cid[0] >> 24) & 0xFF));
+  DEBUG ((DEBUG_ERROR, "\t- Product revision: %d\n", Cid[1] >> 24));
+  //DEBUG ((DEBUG_ERROR, "\t- Product name: %s\n", (char*)(Cid + 2)));
+  DEBUG ((DEBUG_ERROR, "\t- OEM ID: %c%c\n", (Cid[3] >> 8) & 0xFF, (Cid[3] >> 16) & 0xFF));
+}
+
+
+VOID
+PrintCSD (
+  IN UINT32* Csd
+  )
+{
+  UINTN Value;
+
+  if (((Csd[2] >> 30) & 0x3) == 0) {
+    DEBUG ((DEBUG_ERROR, "- PrintCSD Version 1.01-1.10/Version 2.00/Standard Capacity\n"));
+  } else if (((Csd[2] >> 30) & 0x3) == 1) {
+    DEBUG ((DEBUG_ERROR, "- PrintCSD Version 2.00/High Capacity\n"));
+  } else {
+    DEBUG ((DEBUG_ERROR, "- PrintCSD Version Higher than v3.3\n"));
+  }
+
+  DEBUG ((DEBUG_ERROR, "\t- Supported card command class: 0x%X\n", MMC_CSD_GET_CCC (Csd)));
+  DEBUG ((DEBUG_ERROR, "\t- Max Speed: %a * %a\n", mStrValue[(MMC_CSD_GET_TRANSPEED (Csd) >> 3) & 0xF],
+    mStrUnit[MMC_CSD_GET_TRANSPEED (Csd) & 7]));
+  DEBUG ((DEBUG_ERROR, "\t- Maximum Read Data Block: %d\n", 2 << (MMC_CSD_GET_READBLLEN (Csd) - 1)));
+  DEBUG ((DEBUG_ERROR, "\t- Maximum Write Data Block: %d\n", 2 << (MMC_CSD_GET_WRITEBLLEN (Csd) - 1)));
+
+  if (!MMC_CSD_GET_FILEFORMATGRP (Csd)) {
+    Value = MMC_CSD_GET_FILEFORMAT (Csd);
+    if (Value == 0) {
+      DEBUG ((DEBUG_ERROR, "\t- Format (0): Hard disk-like file system with partition table\n"));
+    } else if (Value == 1) {
+      DEBUG ((DEBUG_ERROR, "\t- Format (1): DOS FAT (floppy-like) with boot sector only (no partition table)\n"));
+    } else if (Value == 2) {
+      DEBUG ((DEBUG_ERROR, "\t- Format (2): Universal File Format\n"));
+    } else {
+      DEBUG ((DEBUG_ERROR, "\t- Format (3): Others/Unknown\n"));
+    }
+  } else {
+    DEBUG ((DEBUG_ERROR, "\t- Format: Reserved\n"));
+  }
+}
+
+VOID
+PrintRCA (
+  IN UINT32 Rca
+  )
+{
+  DEBUG ((DEBUG_ERROR, "- PrintRCA: 0x%X\n", Rca));
+  DEBUG ((DEBUG_ERROR, "\t- Status: 0x%X\n", Rca & 0xFFFF));
+  DEBUG ((DEBUG_ERROR, "\t- RCA: 0x%X\n", (Rca >> 16) & 0xFFFF));
+}
+
+VOID
+PrintOCR (
+  IN UINT32 Ocr
+  )
+{
+  UINTN MinV;
+  UINTN MaxV;
+  UINTN Volts;
+  UINTN Loop;
+
+  MinV  = 36;  // 3.6
+  MaxV  = 20;  // 2.0
+  Volts = 20;  // 2.0
+
+  // The MMC register bits [23:8] indicate the working range of the card
+  for (Loop = 8; Loop < 24; Loop++) {
+    if (Ocr & (1 << Loop)) {
+      if (MinV > Volts) {
+        MinV = Volts;
+      }
+      if (MaxV < Volts) {
+        MaxV = Volts + 1;
+      }
+    }
+    Volts++;
+  }
+
+  DEBUG ((DEBUG_ERROR, "- PrintOCR Ocr (0x%X)\n", Ocr));
+  DEBUG ((DEBUG_ERROR, "\t- Card operating voltage: %d.%d to %d.%d\n", MinV / 10, MinV % 10, MaxV / 10, MaxV % 10));
+  if (((Ocr >> 29) & 3) == 0) {
+    DEBUG ((DEBUG_ERROR, "\t- AccessMode: Byte Mode\n"));
+  } else {
+    DEBUG ((DEBUG_ERROR, "\t- AccessMode: Block Mode (0x%X)\n", ((Ocr >> 29) & 3)));
+  }
+
+  if (Ocr & MMC_OCR_POWERUP) {
+    DEBUG ((DEBUG_ERROR, "\t- PowerUp\n"));
+  } else {
+    DEBUG ((DEBUG_ERROR, "\t- Voltage Not Supported\n"));
+  }
+}
+
+VOID
+PrintResponseR1 (
+  IN  UINT32 Response
+  )
+{
+  DEBUG ((DEBUG_INFO, "Response: 0x%X\n", Response));
+  if (Response & MMC_R0_READY_FOR_DATA) {
+    DEBUG ((DEBUG_INFO, "\t- READY_FOR_DATA\n"));
+  }
+
+  switch ((Response >> 9) & 0xF) {
+  case 0:
+    DEBUG ((DEBUG_INFO, "\t- State: Idle\n"));
+    break;
+  case 1:
+    DEBUG ((DEBUG_INFO, "\t- State: Ready\n"));
+    break;
+  case 2:
+    DEBUG ((DEBUG_INFO, "\t- State: Ident\n"));
+    break;
+  case 3:
+    DEBUG ((DEBUG_INFO, "\t- State: StandBy\n"));
+    break;
+  case 4:
+    DEBUG ((DEBUG_INFO, "\t- State: Tran\n"));
+    break;
+  case 5:
+    DEBUG ((DEBUG_INFO, "\t- State: Data\n"));
+    break;
+  case 6:
+    DEBUG ((DEBUG_INFO, "\t- State: Rcv\n"));
+    break;
+  case 7:
+    DEBUG ((DEBUG_INFO, "\t- State: Prg\n"));
+    break;
+  case 8:
+    DEBUG ((DEBUG_INFO, "\t- State: Dis\n"));
+    break;
+  default:
+    DEBUG ((DEBUG_INFO, "\t- State: Reserved\n"));
+    break;
+  }
+}
diff --git a/Platform/RaspberryPi/RPi3/Drivers/MmcDxe/MmcDxe.inf b/Platform/RaspberryPi/RPi3/Drivers/MmcDxe/MmcDxe.inf
new file mode 100644
index 000000000000..c8e7fbf39cd4
--- /dev/null
+++ b/Platform/RaspberryPi/RPi3/Drivers/MmcDxe/MmcDxe.inf
@@ -0,0 +1,58 @@
+#/** @file
+#
+#  Copyright (c) 2018, Andrei Warkentin <andrey.warkentin@gmail.com>
+#  Copyright (c) 2011-2015, ARM Limited. All rights reserved.
+#
+#  This program and the accompanying materials
+#  are licensed and made available under the terms and conditions of the BSD License
+#  which accompanies this distribution.  The full text of the license may be found at
+#  http://opensource.org/licenses/bsd-license.php
+#
+#  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+#  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+#
+#**/
+
+[Defines]
+  INF_VERSION                    = 0x0001001A
+  BASE_NAME                      = MmcDxe
+  FILE_GUID                      = b6f44cc0-9e45-11df-be21-0002a5f5f51b
+  MODULE_TYPE                    = DXE_DRIVER
+  VERSION_STRING                 = 1.0
+
+  ENTRY_POINT                    = MmcDxeInitialize
+
+[Sources.common]
+  ComponentName.c
+  Mmc.c
+  MmcBlockIo.c
+  MmcIdentification.c
+  MmcDebug.c
+  Diagnostics.c
+
+[Packages]
+  Platform/RaspberryPi/RPi3/RPi3.dec
+  MdePkg/MdePkg.dec
+
+[LibraryClasses]
+  BaseLib
+  UefiLib
+  UefiDriverEntryPoint
+  BaseMemoryLib
+
+[Protocols]
+  gEfiDiskIoProtocolGuid
+  gEfiBlockIoProtocolGuid
+  gEfiDevicePathProtocolGuid
+  gEfiDriverDiagnostics2ProtocolGuid
+  gRaspberryPiMmcHostProtocolGuid
+
+[Pcd]
+  gRaspberryPiTokenSpaceGuid.PcdMmcForce1Bit
+  gRaspberryPiTokenSpaceGuid.PcdMmcForceDefaultSpeed
+  gRaspberryPiTokenSpaceGuid.PcdMmcSdDefaultSpeedMHz
+  gRaspberryPiTokenSpaceGuid.PcdMmcSdHighSpeedMHz
+  gRaspberryPiTokenSpaceGuid.PcdMmcDisableMulti
+
+[Depex]
+  TRUE
diff --git a/Platform/RaspberryPi/RPi3/Drivers/MmcDxe/MmcIdentification.c b/Platform/RaspberryPi/RPi3/Drivers/MmcDxe/MmcIdentification.c
new file mode 100644
index 000000000000..e9b8124d3ad5
--- /dev/null
+++ b/Platform/RaspberryPi/RPi3/Drivers/MmcDxe/MmcIdentification.c
@@ -0,0 +1,980 @@
+/** @file
+ *
+ *  Copyright (c) 2011-2015, ARM Limited. All rights reserved.
+ *
+ *  This program and the accompanying materials
+ *  are licensed and made available under the terms and conditions of the BSD License
+ *  which accompanies this distribution.  The full text of the license may be found at
+ *  http://opensource.org/licenses/bsd-license.php
+ *
+ *  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+ *  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+ *
+ **/
+
+#include <Library/BaseMemoryLib.h>
+#include <Library/MemoryAllocationLib.h>
+#include <Library/TimerLib.h>
+
+#include "Mmc.h"
+
+typedef union {
+  UINT32 Raw;
+  OCR    Ocr;
+} OCR_RESPONSE;
+
+#define MAX_RETRY_COUNT         1000
+#define CMD_RETRY_COUNT         20
+#define RCA_SHIFT_OFFSET        16
+#define EMMC_CARD_SIZE          512
+#define EMMC_ECSD_SIZE_OFFSET   53
+
+#define EXTCSD_BUS_WIDTH        183
+#define EXTCSD_HS_TIMING        185
+
+#define EMMC_TIMING_BACKWARD    0
+#define EMMC_TIMING_HS          1
+#define EMMC_TIMING_HS200       2
+#define EMMC_TIMING_HS400       3
+
+#define EMMC_BUS_WIDTH_1BIT     0
+#define EMMC_BUS_WIDTH_4BIT     1
+#define EMMC_BUS_WIDTH_8BIT     2
+#define EMMC_BUS_WIDTH_DDR_4BIT 5
+#define EMMC_BUS_WIDTH_DDR_8BIT 6
+
+#define EMMC_SWITCH_ERROR       (1 << 7)
+
+#define SD_BUS_WIDTH_1BIT       (1 << 0)
+#define SD_BUS_WIDTH_4BIT       (1 << 2)
+
+#define SD_CCC_SWITCH           (1 << 10)
+
+#define DEVICE_STATE(x)         (((x) >> 9) & 0xf)
+typedef enum _EMMC_DEVICE_STATE {
+  EMMC_IDLE_STATE = 0,
+  EMMC_READY_STATE,
+  EMMC_IDENT_STATE,
+  EMMC_STBY_STATE,
+  EMMC_TRAN_STATE,
+  EMMC_DATA_STATE,
+  EMMC_RCV_STATE,
+  EMMC_PRG_STATE,
+  EMMC_DIS_STATE,
+  EMMC_BTST_STATE,
+  EMMC_SLP_STATE
+} EMMC_DEVICE_STATE;
+
+UINT32 mEmmcRcaCount = 0;
+
+STATIC
+EFI_STATUS
+EFIAPI
+EmmcGetDeviceState (
+  IN  MMC_HOST_INSTANCE    *MmcHostInstance,
+  OUT EMMC_DEVICE_STATE    *State
+  )
+{
+  EFI_MMC_HOST_PROTOCOL *Host;
+  EFI_STATUS Status;
+  UINT32     Data, RCA;
+
+  if (State == NULL) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  Host = MmcHostInstance->MmcHost;
+  RCA = MmcHostInstance->CardInfo.RCA << RCA_SHIFT_OFFSET;
+  Status = Host->SendCommand (Host, MMC_CMD13, RCA);
+  if (EFI_ERROR (Status)) {
+    DEBUG ((DEBUG_ERROR, "EmmcGetDeviceState(): Failed to get card status, Status=%r.\n", Status));
+    return Status;
+  }
+  Status = Host->ReceiveResponse (Host, MMC_RESPONSE_TYPE_R1, &Data);
+  if (EFI_ERROR (Status)) {
+    DEBUG ((DEBUG_ERROR, "EmmcGetDeviceState(): Failed to get response of CMD13, Status=%r.\n", Status));
+    return Status;
+  }
+  if (Data & EMMC_SWITCH_ERROR) {
+    DEBUG ((DEBUG_ERROR, "EmmcGetDeviceState(): Failed to switch expected mode, Status=%r.\n", Status));
+    return EFI_DEVICE_ERROR;
+  }
+  *State = DEVICE_STATE (Data);
+  return EFI_SUCCESS;
+}
+
+STATIC
+EFI_STATUS
+EFIAPI
+EmmcSetEXTCSD (
+  IN MMC_HOST_INSTANCE     *MmcHostInstance,
+  UINT32                   ExtCmdIndex,
+  UINT32                   Value
+  )
+{
+  EFI_MMC_HOST_PROTOCOL *Host;
+  EMMC_DEVICE_STATE     State;
+  EFI_STATUS Status;
+  UINT32     Argument;
+
+  Host = MmcHostInstance->MmcHost;
+  Argument = EMMC_CMD6_ARG_ACCESS (3) | EMMC_CMD6_ARG_INDEX (ExtCmdIndex) |
+             EMMC_CMD6_ARG_VALUE (Value) | EMMC_CMD6_ARG_CMD_SET (1);
+  Status = Host->SendCommand (Host, MMC_CMD6, Argument);
+  if (EFI_ERROR (Status)) {
+    DEBUG ((DEBUG_ERROR, "EmmcSetEXTCSD(): Failed to send CMD6, Status=%r.\n", Status));
+    return Status;
+  }
+  // Make sure device exiting prog mode
+  do {
+    Status = EmmcGetDeviceState (MmcHostInstance, &State);
+    if (EFI_ERROR (Status)) {
+      DEBUG ((DEBUG_ERROR, "EmmcSetEXTCSD(): Failed to get device state, Status=%r.\n", Status));
+      return Status;
+    }
+  } while (State == EMMC_PRG_STATE);
+  return EFI_SUCCESS;
+}
+
+STATIC
+EFI_STATUS
+EFIAPI
+EmmcIdentificationMode (
+  IN MMC_HOST_INSTANCE     *MmcHostInstance,
+  IN OCR_RESPONSE           Response
+  )
+{
+  EFI_MMC_HOST_PROTOCOL *Host;
+  EFI_BLOCK_IO_MEDIA    *Media;
+  EFI_STATUS Status;
+  EMMC_DEVICE_STATE     State;
+  UINT32     RCA;
+
+  Host = MmcHostInstance->MmcHost;
+  Media = MmcHostInstance->BlockIo.Media;
+
+  // Fetch card identity register
+  Status = Host->SendCommand (Host, MMC_CMD2, 0);
+  if (EFI_ERROR (Status)) {
+    DEBUG ((DEBUG_ERROR, "EmmcIdentificationMode(): Failed to send CMD2, Status=%r.\n", Status));
+    return Status;
+  }
+
+  Status = Host->ReceiveResponse (Host, MMC_RESPONSE_TYPE_R2, (UINT32*)&(MmcHostInstance->CardInfo.CIDData));
+  if (EFI_ERROR (Status)) {
+    DEBUG ((DEBUG_ERROR, "EmmcIdentificationMode(): CID retrieval error, Status=%r.\n", Status));
+    return Status;
+  }
+
+  // Assign a relative address value to the card
+  MmcHostInstance->CardInfo.RCA = ++mEmmcRcaCount; // TODO: might need a more sophisticated way of doing this
+  RCA = MmcHostInstance->CardInfo.RCA << RCA_SHIFT_OFFSET;
+  Status = Host->SendCommand (Host, MMC_CMD3, RCA);
+  if (EFI_ERROR (Status)) {
+    DEBUG ((DEBUG_ERROR, "EmmcIdentificationMode(): RCA set error, Status=%r.\n", Status));
+    return Status;
+  }
+
+  // Fetch card specific data
+  Status = Host->SendCommand (Host, MMC_CMD9, RCA);
+  if (EFI_ERROR (Status)) {
+    DEBUG ((DEBUG_ERROR, "EmmcIdentificationMode(): Failed to send CMD9, Status=%r.\n", Status));
+    return Status;
+  }
+
+  Status = Host->ReceiveResponse (Host, MMC_RESPONSE_TYPE_R2, (UINT32*)&(MmcHostInstance->CardInfo.CSDData));
+  if (EFI_ERROR (Status)) {
+    DEBUG ((DEBUG_ERROR, "EmmcIdentificationMode(): CSD retrieval error, Status=%r.\n", Status));
+    return Status;
+  }
+
+  // Select the card
+  Status = Host->SendCommand (Host, MMC_CMD7, RCA);
+  if (EFI_ERROR (Status)) {
+    DEBUG ((DEBUG_ERROR, "EmmcIdentificationMode(): Card selection error, Status=%r.\n", Status));
+  }
+
+  if (MMC_HOST_HAS_SETIOS (Host)) {
+    // Set 1-bit bus width
+    Status = Host->SetIos (Host, 0, 1, EMMCBACKWARD);
+    if (EFI_ERROR (Status)) {
+      DEBUG ((DEBUG_ERROR, "EmmcIdentificationMode(): Set 1-bit bus width error, Status=%r.\n", Status));
+      return Status;
+    }
+
+    // Set 1-bit bus width for EXTCSD
+    Status = EmmcSetEXTCSD (MmcHostInstance, EXTCSD_BUS_WIDTH, EMMC_BUS_WIDTH_1BIT);
+    if (EFI_ERROR (Status)) {
+      DEBUG ((DEBUG_ERROR, "EmmcIdentificationMode(): Set extcsd bus width error, Status=%r.\n", Status));
+      return Status;
+    }
+  }
+
+  // Fetch ECSD
+  MmcHostInstance->CardInfo.ECSDData = AllocatePages (EFI_SIZE_TO_PAGES (sizeof (ECSD)));
+  if (MmcHostInstance->CardInfo.ECSDData == NULL) {
+    return EFI_OUT_OF_RESOURCES;
+  }
+  Status = Host->SendCommand (Host, MMC_CMD8, 0);
+  if (EFI_ERROR (Status)) {
+    DEBUG ((DEBUG_ERROR, "EmmcIdentificationMode(): ECSD fetch error, Status=%r.\n", Status));
+  }
+
+  Status = Host->ReadBlockData (Host, 0, 512, (UINT32*)MmcHostInstance->CardInfo.ECSDData);
+  if (EFI_ERROR (Status)) {
+    DEBUG ((DEBUG_ERROR, "EmmcIdentificationMode(): ECSD read error, Status=%r.\n", Status));
+    goto FreePageExit;
+  }
+
+  // Make sure device exiting data mode
+  do {
+    Status = EmmcGetDeviceState (MmcHostInstance, &State);
+    if (EFI_ERROR (Status)) {
+      DEBUG ((DEBUG_ERROR, "EmmcIdentificationMode(): Failed to get device state, Status=%r.\n", Status));
+      goto FreePageExit;
+    }
+  } while (State == EMMC_DATA_STATE);
+
+  // Set up media
+  Media->BlockSize = EMMC_CARD_SIZE; // 512-byte support is mandatory for eMMC cards
+  Media->MediaId = MmcHostInstance->CardInfo.CIDData.PSN;
+  Media->ReadOnly = MmcHostInstance->CardInfo.CSDData.PERM_WRITE_PROTECT;
+  Media->LogicalBlocksPerPhysicalBlock = 1;
+  Media->IoAlign = 4;
+  // Compute last block using bits [215:212] of the ECSD
+  Media->LastBlock = MmcHostInstance->CardInfo.ECSDData->SECTOR_COUNT - 1; // eMMC isn't supposed to report this for
+  // Cards <2GB in size, but the model does.
+
+  // Setup card type
+  MmcHostInstance->CardInfo.CardType = EMMC_CARD;
+  return EFI_SUCCESS;
+
+FreePageExit:
+  FreePages (MmcHostInstance->CardInfo.ECSDData, EFI_SIZE_TO_PAGES (sizeof (ECSD)));
+  return Status;
+}
+
+STATIC
+EFI_STATUS
+InitializeEmmcDevice (
+  IN  MMC_HOST_INSTANCE   *MmcHostInstance
+  )
+{
+  EFI_MMC_HOST_PROTOCOL *Host;
+  EFI_STATUS Status = EFI_SUCCESS;
+  ECSD       *ECSDData;
+  UINT32     BusClockFreq, Idx, BusMode;
+  UINT32     BusWidth = 8;
+  UINT32     TimingMode[4] = { EMMCHS52DDR1V2, EMMCHS52DDR1V8, EMMCHS52, EMMCHS26 };
+
+  Host = MmcHostInstance->MmcHost;
+  ECSDData = MmcHostInstance->CardInfo.ECSDData;
+  if (ECSDData->DEVICE_TYPE == EMMCBACKWARD) {
+    return EFI_SUCCESS;
+  }
+
+  if (PcdGet32 (PcdMmcForceDefaultSpeed)) {
+    DEBUG ((DEBUG_WARN, "Forcing default speed mode\n"));
+    return EFI_SUCCESS;
+  }
+
+  if (PcdGet32 (PcdMmcForce1Bit)) {
+    DEBUG ((DEBUG_WARN, "Forcing 1 bit mode\n"));
+    BusWidth = 1;
+  }
+
+  if (!MMC_HOST_HAS_SETIOS (Host)) {
+    DEBUG ((DEBUG_ERROR, "Controller doesn't support speed / bus width change\n"));
+    return EFI_SUCCESS;
+  }
+
+  Status = EmmcSetEXTCSD (MmcHostInstance, EXTCSD_HS_TIMING, EMMC_TIMING_HS);
+  if (EFI_ERROR (Status)) {
+    DEBUG ((DEBUG_ERROR, "InitializeEmmcDevice(): Failed to switch high speed mode, Status:%r.\n", Status));
+    return Status;
+  }
+
+  for (Idx = 0; Idx < 4; Idx++) {
+    switch (TimingMode[Idx]) {
+    case EMMCHS52DDR1V2:
+    case EMMCHS52DDR1V8:
+    case EMMCHS52:
+      BusClockFreq = 52000000;
+      break;
+    case EMMCHS26:
+      BusClockFreq = 26000000;
+      break;
+    default:
+      return EFI_UNSUPPORTED;
+    }
+    Status = Host->SetIos (Host, BusClockFreq, BusWidth, TimingMode[Idx]);
+    if (!EFI_ERROR (Status)) {
+      switch (TimingMode[Idx]) {
+      case EMMCHS52DDR1V2:
+      case EMMCHS52DDR1V8:
+        BusMode = EMMC_BUS_WIDTH_DDR_8BIT;
+        break;
+      case EMMCHS52:
+      case EMMCHS26:
+        BusMode = EMMC_BUS_WIDTH_8BIT;
+        break;
+      default:
+        return EFI_UNSUPPORTED;
+      }
+      Status = EmmcSetEXTCSD (MmcHostInstance, EXTCSD_BUS_WIDTH, BusMode);
+      if (EFI_ERROR (Status)) {
+        DEBUG ((DEBUG_ERROR, "InitializeEmmcDevice(): Failed to set EXTCSD bus width, Status:%r\n", Status));
+      }
+      return Status;
+    }
+  }
+  return Status;
+}
+
+STATIC
+UINT32
+SdSwitchCmdArgument (
+  IN     UINT32  AccessMode,
+  IN     UINT32  CommandSystem,
+  IN     UINT32  DriveStrength,
+  IN     UINT32  PowerLimit,
+  IN     BOOLEAN Mode
+  )
+{
+  return (AccessMode & 0xF) | ((PowerLimit & 0xF) << 4) |               \
+    ((DriveStrength & 0xF) << 8) | ((DriveStrength & 0xF) << 12) |      \
+    (Mode ? BIT31 : 0);
+}
+
+STATIC
+EFI_STATUS
+SdSelect (
+  IN  MMC_HOST_INSTANCE *MmcHostInstance
+  )
+{
+  /*
+   * Moves a card from standby to transfer state.
+   */
+  EFI_STATUS Status;
+  EFI_MMC_HOST_PROTOCOL *MmcHost = MmcHostInstance->MmcHost;
+
+  Status = MmcHost->SendCommand (MmcHost, MMC_CMD7,
+                      MmcHostInstance->CardInfo.RCA << 16);
+  if (EFI_ERROR (Status)) {
+    DEBUG ((DEBUG_ERROR, "%a: error: %r\n", __FUNCTION__, Status));
+  }
+
+  return Status;
+}
+
+STATIC
+EFI_STATUS
+SdDeselect (
+  IN  MMC_HOST_INSTANCE *MmcHostInstance
+  )
+{
+  /*
+   * Moves a card from transfer to standby.
+   */
+  EFI_STATUS Status;
+  EFI_MMC_HOST_PROTOCOL *MmcHost = MmcHostInstance->MmcHost;
+
+  Status = MmcHost->SendCommand (MmcHost, MMC_CMD7, 0);
+  if (EFI_ERROR (Status)) {
+    DEBUG ((DEBUG_ERROR, "%a: error: %r\n", __FUNCTION__, Status));
+  }
+
+  return Status;
+}
+
+STATIC
+EFI_STATUS
+SdGetCsd (
+  IN  MMC_HOST_INSTANCE *MmcHostInstance,
+  IN  UINT32 *Response,
+  IN  BOOLEAN Print
+  )
+{
+  EFI_STATUS Status;
+  EFI_MMC_HOST_PROTOCOL *MmcHost = MmcHostInstance->MmcHost;
+
+  Status = MmcHost->SendCommand (MmcHost, MMC_CMD9,
+                      MmcHostInstance->CardInfo.RCA << 16);
+  if (EFI_ERROR (Status)) {
+    DEBUG ((DEBUG_ERROR, "%a(%u): error: %r\n", __FUNCTION__, __LINE__, Status));
+    return Status;
+  }
+
+  Status = MmcHost->ReceiveResponse (MmcHost, MMC_RESPONSE_TYPE_CSD, Response);
+  if (EFI_ERROR (Status)) {
+    DEBUG ((DEBUG_ERROR, "%a(%u): error %r\n", __FUNCTION__,
+      __LINE__, Status));
+    return Status;
+  }
+
+  if (Print) {
+    PrintCSD (Response);
+  }
+
+  return EFI_SUCCESS;
+}
+
+STATIC
+EFI_STATUS
+SdSet4Bit (
+  IN  MMC_HOST_INSTANCE *MmcHostInstance
+)
+{
+  UINT32 CmdArg;
+  EFI_STATUS Status;
+  EFI_MMC_HOST_PROTOCOL *MmcHost = MmcHostInstance->MmcHost;
+
+  if (PcdGet32 (PcdMmcForce1Bit)) {
+    DEBUG ((DEBUG_WARN, "Forcing 1 bit mode\n"));
+    return EFI_SUCCESS;
+  }
+
+  if (!MMC_HOST_HAS_SETIOS (MmcHost)) {
+    DEBUG ((DEBUG_WARN, "Controller doesn't support bus width change\n"));
+    return EFI_SUCCESS;
+  }
+
+  CmdArg = MmcHostInstance->CardInfo.RCA << 16;
+  Status = MmcHost->SendCommand (MmcHost, MMC_CMD55, CmdArg);
+  if (EFI_ERROR (Status)) {
+    DEBUG ((DEBUG_ERROR, "%a(%u): error: %r\n", __FUNCTION__, __LINE__, Status));
+    return Status;
+  }
+
+  /* Width: 4 */
+  Status = MmcHost->SendCommand (MmcHost, MMC_CMD6, 2);
+  if (EFI_ERROR (Status)) {
+    DEBUG ((DEBUG_ERROR, "%a(%u): error %r\n", __FUNCTION__, __LINE__, Status));
+    return Status;
+  }
+
+  Status = MmcHost->SetIos (MmcHost, 0, BUSWIDTH_4, EMMCBACKWARD);
+  if (EFI_ERROR (Status)) {
+    DEBUG ((DEBUG_ERROR, "%a(%u): error: %r\n", __FUNCTION__, __LINE__, Status));
+    return Status;
+  }
+
+  return EFI_SUCCESS;
+}
+
+STATIC
+EFI_STATUS
+SdSetSpeed (
+  IN  MMC_HOST_INSTANCE *MmcHostInstance,
+  IN  BOOLEAN CccSwitch
+  )
+{
+  UINT32 Speed;
+  UINT32 CmdArg;
+  EFI_STATUS Status;
+  UINT32 Buffer[16];
+  UINT32 Response[4];
+  EFI_MMC_HOST_PROTOCOL *MmcHost = MmcHostInstance->MmcHost;
+
+  if (!MMC_HOST_HAS_SETIOS (MmcHost)) {
+    DEBUG ((DEBUG_WARN, "Controller doesn't support speed change\n"));
+    return EFI_SUCCESS;
+  }
+
+  Speed = PcdGet32 (PcdMmcSdDefaultSpeedMHz) * 1000000;
+  if (Speed == 0) {
+    Speed = SD_DEFAULT_SPEED;
+  } else {
+    DEBUG ((DEBUG_INFO, "Using default speed override %u Hz\n", Speed));
+  }
+
+  /*
+   * First set base speed. We'll then try HS.
+   */
+  Status = MmcHost->SetIos (MmcHost, Speed, 0, EMMCBACKWARD);
+  if (EFI_ERROR (Status)) {
+    DEBUG ((DEBUG_ERROR, "%a: error setting speed %u: %r\n", __FUNCTION__, Speed, Status));
+    return Status;
+  }
+
+  if (PcdGet32 (PcdMmcForceDefaultSpeed)) {
+    DEBUG ((DEBUG_WARN, "Forcing default speed mode\n"));
+    return EFI_SUCCESS;
+  }
+
+  if (!CccSwitch) {
+    return EFI_SUCCESS;
+  }
+
+  /* Query. */
+  CmdArg = SdSwitchCmdArgument (0xf, 0xf, 0xf, 0xf, FALSE);
+  Status = MmcHost->SendCommand (MmcHost, MMC_CMD6, CmdArg);
+  if (EFI_ERROR (Status)) {
+    DEBUG ((DEBUG_ERROR, "%a(%u): error: %r\n",
+      __FUNCTION__, __LINE__, Status));
+    return Status;
+  } else {
+    Status = MmcHost->ReadBlockData (MmcHost, 0, SWITCH_CMD_DATA_LENGTH,
+      Buffer);
+    if (EFI_ERROR (Status)) {
+      DEBUG ((DEBUG_ERROR, "%a(%u): error: %r\n",
+        __FUNCTION__, __LINE__, Status));
+      return Status;
+    }
+  }
+
+  if (!(Buffer[3] & SD_HIGH_SPEED_SUPPORTED)) {
+    DEBUG ((DEBUG_ERROR, "%a: High Speed not supported by Card\n"));
+    return EFI_SUCCESS;
+  }
+
+  /* Switch to high speed. */
+  CmdArg = SdSwitchCmdArgument (1, 0xf, 0xf, 0xf, TRUE);
+  Status = MmcHost->SendCommand (MmcHost, MMC_CMD6, CmdArg);
+  if (EFI_ERROR (Status)) {
+    DEBUG ((DEBUG_ERROR, "%a(%u): error: %r\n", __FUNCTION__, __LINE__, Status));
+    return Status;
+  } else {
+    Status = MmcHost->ReadBlockData (MmcHost, 0,
+      SWITCH_CMD_DATA_LENGTH, Buffer);
+    if (EFI_ERROR (Status)) {
+      DEBUG ((DEBUG_ERROR, "%a(%u): error: %r\n", __FUNCTION__, __LINE__, Status));
+      return Status;
+    }
+
+    if ((Buffer[4] & SWITCH_CMD_SUCCESS_MASK) != 0x1) {
+      DEBUG ((DEBUG_ERROR, "Problem switching SD card into HS mode\n"));
+      DEBUG ((DEBUG_ERROR, "%08x %08x %08x %08x\n",
+        Buffer[0], Buffer[1], Buffer[2], Buffer[3]));
+      DEBUG ((DEBUG_ERROR, "%08x %08x %08x %08x\n",
+        Buffer[4], Buffer[5], Buffer[6], Buffer[8]));
+      return Status;
+    }
+  }
+
+  DEBUG ((DEBUG_ERROR, "Dumping CSD after high-speed switch\n"));
+  SdDeselect (MmcHostInstance);
+  SdGetCsd (MmcHostInstance, Response, TRUE);
+  SdSelect (MmcHostInstance);
+
+  Speed = PcdGet32 (PcdMmcSdHighSpeedMHz) * 1000000;
+  if (Speed == 0) {
+    Speed = SD_HIGH_SPEED;
+  } else {
+    DEBUG ((DEBUG_INFO, "Using high speed override %u Hz\n", Speed));
+  }
+
+  Status = MmcHost->SetIos (MmcHost, Speed, 0, EMMCBACKWARD);
+  if (EFI_ERROR (Status)) {
+    DEBUG ((DEBUG_ERROR, "%a: error setting speed %u: %r\n", __FUNCTION__, Speed, Status));
+    return Status;
+  }
+
+  return EFI_SUCCESS;
+}
+
+STATIC
+EFI_STATUS
+InitializeSdMmcDevice (
+  IN  MMC_HOST_INSTANCE *MmcHostInstance
+  )
+{
+  UINT32        Response[4];
+  UINT32        Buffer[128];
+  UINTN         BlockSize;
+  UINTN         CardSize;
+  UINTN         NumBlocks;
+  BOOLEAN       CccSwitch;
+  SCR           Scr;
+  EFI_STATUS    Status;
+  EFI_MMC_HOST_PROTOCOL *MmcHost = MmcHostInstance->MmcHost;
+
+  Status = SdGetCsd (MmcHostInstance, Response, TRUE);
+  if (EFI_ERROR (Status)) {
+    return Status;
+  }
+
+  if (MMC_CSD_GET_CCC (Response) & SD_CCC_SWITCH) {
+    CccSwitch = TRUE;
+  } else {
+    CccSwitch = FALSE;
+  }
+
+  if (MmcHostInstance->CardInfo.CardType == SD_CARD_2_HIGH) {
+    CardSize = HC_MMC_CSD_GET_DEVICESIZE (Response);
+    NumBlocks = ((CardSize + 1) * 1024);
+    BlockSize = 1 << MMC_CSD_GET_READBLLEN (Response);
+  } else {
+    CardSize = MMC_CSD_GET_DEVICESIZE (Response);
+    NumBlocks = (CardSize + 1) * (1 << (MMC_CSD_GET_DEVICESIZEMULT (Response) + 2));
+    BlockSize = 1 << MMC_CSD_GET_READBLLEN (Response);
+  }
+
+  // For >=2G card, BlockSize may be 1K, but the transfer size is 512 bytes.
+  if (BlockSize > 512) {
+    NumBlocks = MultU64x32 (NumBlocks, BlockSize / 512);
+    BlockSize = 512;
+  }
+
+  MmcHostInstance->BlockIo.Media->LastBlock = (NumBlocks - 1);
+  MmcHostInstance->BlockIo.Media->BlockSize = BlockSize;
+  MmcHostInstance->BlockIo.Media->ReadOnly = MmcHost->IsReadOnly (MmcHost);
+  MmcHostInstance->BlockIo.Media->MediaPresent = TRUE;
+  MmcHostInstance->BlockIo.Media->MediaId++;
+
+  Status = SdSelect (MmcHostInstance);
+  if (EFI_ERROR (Status)) {
+    return Status;
+  }
+
+  Status = MmcHost->SendCommand (MmcHost, MMC_CMD55,
+                      MmcHostInstance->CardInfo.RCA << 16);
+  if (EFI_ERROR (Status)) {
+    DEBUG ((DEBUG_ERROR, "%a (MMC_CMD55): Error and Status = %r\n", __FUNCTION__, Status));
+    return Status;
+  }
+  Status = MmcHost->ReceiveResponse (MmcHost, MMC_RESPONSE_TYPE_R1, Response);
+  if (EFI_ERROR (Status)) {
+    DEBUG ((DEBUG_ERROR, "%a (MMC_CMD55): Error and Status = %r\n", __FUNCTION__, Status));
+    return Status;
+  }
+  if ((Response[0] & MMC_STATUS_APP_CMD) == 0) {
+    return EFI_SUCCESS;
+  }
+
+  /* SCR */
+  Status = MmcHost->SendCommand (MmcHost, MMC_ACMD51, 0);
+  if (EFI_ERROR (Status)) {
+    DEBUG ((DEBUG_ERROR, "%a(MMC_ACMD51): Error and Status = %r\n", __func__, Status));
+    return Status;
+  } else {
+    Status = MmcHost->ReadBlockData (MmcHost, 0, 8, Buffer);
+    if (EFI_ERROR (Status)) {
+      DEBUG ((DEBUG_ERROR, "%a(MMC_ACMD51): ReadBlockData Error and Status = %r\n", __func__, Status));
+      return Status;
+    }
+    CopyMem (&Scr, Buffer, 8);
+    if (Scr.SD_SPEC == 2) {
+      if (Scr.SD_SPEC3 == 1) {
+        if (Scr.SD_SPEC4 == 1) {
+          DEBUG ((DEBUG_INFO, "Found SD Card for Spec Version 4.xx\n"));
+        } else {
+          DEBUG ((DEBUG_INFO, "Found SD Card for Spec Version 3.0x\n"));
+        }
+      } else {
+        if (Scr.SD_SPEC4 == 0) {
+          DEBUG ((DEBUG_INFO, "Found SD Card for Spec Version 2.0\n"));
+        } else {
+          DEBUG ((DEBUG_ERROR, "Found invalid SD Card\n"));
+        }
+      }
+    } else {
+      if ((Scr.SD_SPEC3 == 0) && (Scr.SD_SPEC4 == 0)) {
+        if (Scr.SD_SPEC == 1) {
+          DEBUG ((DEBUG_INFO, "Found SD Card for Spec Version 1.10\n"));
+        } else {
+          DEBUG ((DEBUG_INFO, "Found SD Card for Spec Version 1.0\n"));
+        }
+      } else {
+        DEBUG ((DEBUG_ERROR, "Found invalid SD Card\n"));
+      }
+    }
+  }
+
+  Status = SdSetSpeed (MmcHostInstance, CccSwitch);
+  if (EFI_ERROR (Status)) {
+    return Status;
+  }
+
+  if (Scr.SD_BUS_WIDTHS & SD_BUS_WIDTH_4BIT) {
+    Status = SdSet4Bit (MmcHostInstance);
+    if (EFI_ERROR (Status)) {
+      return Status;
+    }
+  }
+
+  return EFI_SUCCESS;
+}
+
+STATIC
+EFI_STATUS
+EFIAPI
+MmcIdentificationMode (
+  IN MMC_HOST_INSTANCE     *MmcHostInstance
+  )
+{
+  EFI_STATUS              Status;
+  UINT32                  Response[4];
+  UINTN                   Timeout;
+  UINTN                   CmdArg;
+  BOOLEAN                 IsHCS;
+  EFI_MMC_HOST_PROTOCOL   *MmcHost;
+  OCR_RESPONSE            OcrResponse;
+
+  MmcHost = MmcHostInstance->MmcHost;
+  CmdArg = 0;
+  IsHCS = FALSE;
+
+  if (MmcHost == NULL) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  // We can get into this function if we restart the identification mode
+  if (MmcHostInstance->State == MmcHwInitializationState) {
+    // Initialize the MMC Host HW
+    Status = MmcNotifyState (MmcHostInstance, MmcHwInitializationState);
+    if (EFI_ERROR (Status)) {
+      DEBUG ((DEBUG_ERROR, "MmcIdentificationMode() : Error MmcHwInitializationState, Status=%r.\n", Status));
+      return Status;
+    }
+  }
+
+  Status = MmcHost->SendCommand (MmcHost, MMC_CMD0, 0);
+  if (EFI_ERROR (Status)) {
+    DEBUG ((DEBUG_ERROR, "MmcIdentificationMode(MMC_CMD0): Error, Status=%r.\n", Status));
+    return Status;
+  }
+  Status = MmcNotifyState (MmcHostInstance, MmcIdleState);
+  if (EFI_ERROR (Status)) {
+    DEBUG ((DEBUG_ERROR, "MmcIdentificationMode() : Error MmcIdleState, Status=%r.\n", Status));
+    return Status;
+  }
+
+  // Send CMD1 to get OCR (MMC)
+  // This command only valid for MMC and eMMC
+  Timeout = MAX_RETRY_COUNT;
+  do {
+    Status = MmcHost->SendCommand (MmcHost, MMC_CMD1, EMMC_CMD1_CAPACITY_GREATER_THAN_2GB);
+    if (EFI_ERROR (Status))
+      break;
+    Status = MmcHost->ReceiveResponse (MmcHost, MMC_RESPONSE_TYPE_OCR, (UINT32*)&OcrResponse);
+    if (EFI_ERROR (Status)) {
+      DEBUG ((DEBUG_ERROR, "MmcIdentificationMode() : Failed to receive OCR, Status=%r.\n", Status));
+      return Status;
+    }
+    Timeout--;
+  } while (!OcrResponse.Ocr.PowerUp && (Timeout > 0));
+  if (Status == EFI_SUCCESS) {
+    if (!OcrResponse.Ocr.PowerUp) {
+      DEBUG ((DEBUG_ERROR, "MmcIdentificationMode(MMC_CMD1): Card initialisation failure, Status=%r.\n", Status));
+      return EFI_DEVICE_ERROR;
+    }
+    OcrResponse.Ocr.PowerUp = 0;
+    if (OcrResponse.Raw == EMMC_CMD1_CAPACITY_GREATER_THAN_2GB) {
+      MmcHostInstance->CardInfo.OCRData.AccessMode = BIT1;
+    } else {
+      MmcHostInstance->CardInfo.OCRData.AccessMode = 0x0;
+    }
+    // Check whether MMC or eMMC
+    if (OcrResponse.Raw == EMMC_CMD1_CAPACITY_GREATER_THAN_2GB ||
+        OcrResponse.Raw == EMMC_CMD1_CAPACITY_LESS_THAN_2GB) {
+      return EmmcIdentificationMode (MmcHostInstance, OcrResponse);
+    }
+  }
+
+  // Are we using SDIO ?
+  Status = MmcHost->SendCommand (MmcHost, MMC_CMD5, 0);
+  if (Status == EFI_SUCCESS) {
+    DEBUG ((DEBUG_ERROR, "MmcIdentificationMode(MMC_CMD5): Error - SDIO not supported, Status=%r.\n", Status));
+    return EFI_UNSUPPORTED;
+  }
+
+  // Check which kind of card we are using. Ver2.00 or later SD Memory Card (PL180 is SD v1.1)
+  CmdArg = (0x0UL << 12 | BIT8 | 0xCEUL << 0);
+  Status = MmcHost->SendCommand (MmcHost, MMC_CMD8, CmdArg);
+  if (Status == EFI_SUCCESS) {
+    DEBUG ((DEBUG_ERROR, "Card is SD2.0 => Supports high capacity\n"));
+    IsHCS = TRUE;
+    Status = MmcHost->ReceiveResponse (MmcHost, MMC_RESPONSE_TYPE_R7, Response);
+    if (EFI_ERROR (Status)) {
+      DEBUG ((DEBUG_ERROR, "MmcIdentificationMode() : Failed to receive response to CMD8, Status=%r.\n", Status));
+      return Status;
+    }
+    PrintResponseR1 (Response[0]);
+    // Check if it is valid response
+    if (Response[0] != CmdArg) {
+      DEBUG ((DEBUG_ERROR, "The Card is not usable\n"));
+      return EFI_UNSUPPORTED;
+    }
+  } else {
+    DEBUG ((DEBUG_ERROR, "Not a SD2.0 Card\n"));
+  }
+
+  // We need to wait for the MMC or SD card is ready => (gCardInfo.OCRData.PowerUp == 1)
+  Timeout = MAX_RETRY_COUNT;
+  while (Timeout > 0) {
+    // SD Card or MMC Card ? CMD55 indicates to the card that the next command is an application specific command
+    Status = MmcHost->SendCommand (MmcHost, MMC_CMD55, 0);
+    if (Status == EFI_SUCCESS) {
+      DEBUG ((DEBUG_INFO, "Card should be SD\n"));
+      if (IsHCS) {
+        MmcHostInstance->CardInfo.CardType = SD_CARD_2;
+      } else {
+        MmcHostInstance->CardInfo.CardType = SD_CARD;
+      }
+
+      // Note: The first time CmdArg will be zero
+      CmdArg = ((UINTN*) &(MmcHostInstance->CardInfo.OCRData))[0];
+      if (IsHCS) {
+        CmdArg |= BIT30;
+      }
+      Status = MmcHost->SendCommand (MmcHost, MMC_ACMD41, CmdArg);
+      if (!EFI_ERROR (Status)) {
+        Status = MmcHost->ReceiveResponse (MmcHost, MMC_RESPONSE_TYPE_OCR, Response);
+        if (EFI_ERROR (Status)) {
+          DEBUG ((DEBUG_ERROR, "MmcIdentificationMode() : Failed to receive OCR, Status=%r.\n", Status));
+          return Status;
+        }
+        ((UINT32*) &(MmcHostInstance->CardInfo.OCRData))[0] = Response[0];
+      }
+    } else {
+      DEBUG ((DEBUG_INFO, "Card should be MMC\n"));
+      MmcHostInstance->CardInfo.CardType = MMC_CARD;
+
+      Status = MmcHost->SendCommand (MmcHost, MMC_CMD1, 0x800000);
+      if (!EFI_ERROR (Status)) {
+        Status = MmcHost->ReceiveResponse (MmcHost, MMC_RESPONSE_TYPE_OCR, Response);
+        if (EFI_ERROR (Status)) {
+          DEBUG ((DEBUG_ERROR, "MmcIdentificationMode() : Failed to receive OCR, Status=%r.\n", Status));
+          return Status;
+        }
+        ((UINT32*) &(MmcHostInstance->CardInfo.OCRData))[0] = Response[0];
+      }
+    }
+
+    if (!EFI_ERROR (Status)) {
+      if (!MmcHostInstance->CardInfo.OCRData.PowerUp) {
+        gBS->Stall (1);
+        Timeout--;
+      } else {
+        if ((MmcHostInstance->CardInfo.CardType == SD_CARD_2) && (MmcHostInstance->CardInfo.OCRData.AccessMode & BIT1)) {
+          MmcHostInstance->CardInfo.CardType = SD_CARD_2_HIGH;
+          DEBUG ((DEBUG_ERROR, "High capacity card.\n"));
+        }
+        break;  // The MMC/SD card is ready. Continue the Identification Mode
+      }
+    } else {
+      gBS->Stall (1);
+      Timeout--;
+    }
+  }
+
+  if (Timeout == 0) {
+    DEBUG ((DEBUG_ERROR, "MmcIdentificationMode(): No Card\n"));
+    return EFI_NO_MEDIA;
+  } else {
+    PrintOCR (Response[0]);
+  }
+
+  Status = MmcNotifyState (MmcHostInstance, MmcReadyState);
+  if (EFI_ERROR (Status)) {
+    DEBUG ((DEBUG_ERROR, "MmcIdentificationMode() : Error MmcReadyState\n"));
+    return Status;
+  }
+
+  Status = MmcHost->SendCommand (MmcHost, MMC_CMD2, 0);
+  if (EFI_ERROR (Status)) {
+    DEBUG ((DEBUG_ERROR, "MmcIdentificationMode(MMC_CMD2): Error\n"));
+    return Status;
+  }
+  Status = MmcHost->ReceiveResponse (MmcHost, MMC_RESPONSE_TYPE_CID, Response);
+  if (EFI_ERROR (Status)) {
+    DEBUG ((DEBUG_ERROR, "MmcIdentificationMode() : Failed to receive CID, Status=%r.\n", Status));
+    return Status;
+  }
+
+  PrintCID (Response);
+
+  Status = MmcHost->NotifyState (MmcHost, MmcIdentificationState);
+  if (EFI_ERROR (Status)) {
+    DEBUG ((DEBUG_ERROR, "MmcIdentificationMode() : Error MmcIdentificationState\n"));
+    return Status;
+  }
+
+  //
+  // Note, SD specifications say that "if the command execution causes a state change, it
+  // will be visible to the host in the response to the next command"
+  // The status returned for this CMD3 will be 2 - identification
+  //
+  CmdArg = 1;
+  Status = MmcHost->SendCommand (MmcHost, MMC_CMD3, CmdArg);
+  if (EFI_ERROR (Status)) {
+    DEBUG ((DEBUG_ERROR, "MmcIdentificationMode(MMC_CMD3): Error\n"));
+    return Status;
+  }
+
+  Status = MmcHost->ReceiveResponse (MmcHost, MMC_RESPONSE_TYPE_RCA, Response);
+  if (EFI_ERROR (Status)) {
+    DEBUG ((DEBUG_ERROR, "MmcIdentificationMode() : Failed to receive RCA, Status=%r.\n", Status));
+    return Status;
+  }
+  PrintRCA (Response[0]);
+
+  // For MMC card, RCA is assigned by CMD3 while CMD3 dumps the RCA for SD card
+  if (MmcHostInstance->CardInfo.CardType != MMC_CARD) {
+    MmcHostInstance->CardInfo.RCA = Response[0] >> 16;
+  } else {
+    MmcHostInstance->CardInfo.RCA = CmdArg;
+  }
+  Status = MmcNotifyState (MmcHostInstance, MmcStandByState);
+  if (EFI_ERROR (Status)) {
+    DEBUG ((DEBUG_ERROR, "MmcIdentificationMode() : Error MmcStandByState\n"));
+    return Status;
+  }
+
+  return EFI_SUCCESS;
+}
+
+EFI_STATUS
+InitializeMmcDevice (
+  IN  MMC_HOST_INSTANCE   *MmcHostInstance
+  )
+{
+  EFI_STATUS              Status;
+  EFI_MMC_HOST_PROTOCOL   *MmcHost;
+  UINTN                   BlockCount;
+
+  BlockCount = 1;
+  MmcHost = MmcHostInstance->MmcHost;
+
+  Status = MmcIdentificationMode (MmcHostInstance);
+  if (EFI_ERROR (Status)) {
+    DEBUG ((DEBUG_ERROR, "InitializeMmcDevice(): Error in Identification Mode, Status=%r\n", Status));
+    return Status;
+  }
+
+  Status = MmcNotifyState (MmcHostInstance, MmcTransferState);
+  if (EFI_ERROR (Status)) {
+    DEBUG ((DEBUG_ERROR, "InitializeMmcDevice(): Error MmcTransferState, Status=%r\n", Status));
+    return Status;
+  }
+
+  if (MmcHostInstance->CardInfo.CardType != EMMC_CARD) {
+    Status = InitializeSdMmcDevice (MmcHostInstance);
+  } else {
+    Status = InitializeEmmcDevice (MmcHostInstance);
+  }
+  if (EFI_ERROR (Status)) {
+    return Status;
+  }
+
+  // Set Block Length
+  Status = MmcHost->SendCommand (MmcHost, MMC_CMD16, MmcHostInstance->BlockIo.Media->BlockSize);
+  if (EFI_ERROR (Status)) {
+    DEBUG ((DEBUG_ERROR,
+      "InitializeMmcDevice(MMC_CMD16): Error MmcHostInstance->BlockIo.Media->BlockSize: %d and Error = %r\n",
+      MmcHostInstance->BlockIo.Media->BlockSize, Status));
+    return Status;
+  }
+
+  // Block Count (not used). Could return an error for SD card
+  if (MmcHostInstance->CardInfo.CardType == MMC_CARD) {
+    Status = MmcHost->SendCommand (MmcHost, MMC_CMD23, BlockCount);
+    if (EFI_ERROR (Status)) {
+      DEBUG ((DEBUG_ERROR, "InitializeMmcDevice(MMC_CMD23): Error, Status=%r\n", Status));
+      return Status;
+    }
+  }
+
+  return EFI_SUCCESS;
+}
diff --git a/Platform/RaspberryPi/RPi3/Include/Protocol/RpiMmcHost.h b/Platform/RaspberryPi/RPi3/Include/Protocol/RpiMmcHost.h
new file mode 100644
index 000000000000..2c0c7e0cdc21
--- /dev/null
+++ b/Platform/RaspberryPi/RPi3/Include/Protocol/RpiMmcHost.h
@@ -0,0 +1,206 @@
+/** @file
+ *
+ *  Copyright (c) 2018, Andrei Warkentin <andrey.warkentin@gmail.com>
+ *  Copyright (c) 2011-2014, ARM Limited. All rights reserved.
+ *
+ *  This program and the accompanying materials
+ *  are licensed and made available under the terms and conditions of the BSD License
+ *  which accompanies this distribution.  The full text of the license may be found at
+ *  http://opensource.org/licenses/bsd-license.php
+ *
+ *  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+ *  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+ *
+ **/
+
+#ifndef __RASPBERRY_PI_MMC_HOST_PROTOCOL_H__
+#define __RASPBERRY_PI_MMC_HOST_PROTOCOL_H__
+
+/*
+ * Global ID for the MMC Host Protocol
+ */
+#define RASPBERRY_PI_MMC_HOST_PROTOCOL_GUID \
+  { 0x3e591c00, 0x9e4a, 0x11df, {0x92, 0x44, 0x00, 0x02, 0xA5, 0xF5, 0xF5, 0x1B } }
+
+#define MMC_RESPONSE_TYPE_R1        0
+#define MMC_RESPONSE_TYPE_R1b       0
+#define MMC_RESPONSE_TYPE_R2        1
+#define MMC_RESPONSE_TYPE_R3        0
+#define MMC_RESPONSE_TYPE_R6        0
+#define MMC_RESPONSE_TYPE_R7        0
+#define MMC_RESPONSE_TYPE_OCR       0
+#define MMC_RESPONSE_TYPE_CID       1
+#define MMC_RESPONSE_TYPE_CSD       1
+#define MMC_RESPONSE_TYPE_RCA       0
+
+typedef UINT32  MMC_RESPONSE_TYPE;
+
+typedef UINT32 MMC_CMD;
+
+#define MMC_CMD_WAIT_RESPONSE      (1 << 16)
+#define MMC_CMD_LONG_RESPONSE      (1 << 17)
+#define MMC_CMD_NO_CRC_RESPONSE    (1 << 18)
+
+#define MMC_INDX(Index)       ((Index) & 0xFFFF)
+#define MMC_GET_INDX(MmcCmd)  ((MmcCmd) & 0xFFFF)
+
+#define MMC_CMD0              (MMC_INDX(0) | MMC_CMD_NO_CRC_RESPONSE)
+#define MMC_CMD1              (MMC_INDX(1) | MMC_CMD_WAIT_RESPONSE | MMC_CMD_NO_CRC_RESPONSE)
+#define MMC_CMD2              (MMC_INDX(2) | MMC_CMD_WAIT_RESPONSE | MMC_CMD_LONG_RESPONSE)
+#define MMC_CMD3              (MMC_INDX(3) | MMC_CMD_WAIT_RESPONSE)
+#define MMC_CMD5              (MMC_INDX(5) | MMC_CMD_WAIT_RESPONSE | MMC_CMD_NO_CRC_RESPONSE)
+#define MMC_CMD6              (MMC_INDX(6) | MMC_CMD_WAIT_RESPONSE)
+#define MMC_CMD7              (MMC_INDX(7) | MMC_CMD_WAIT_RESPONSE)
+#define MMC_CMD8              (MMC_INDX(8) | MMC_CMD_WAIT_RESPONSE)
+#define MMC_CMD9              (MMC_INDX(9) | MMC_CMD_WAIT_RESPONSE | MMC_CMD_LONG_RESPONSE)
+#define MMC_CMD11             (MMC_INDX(11) | MMC_CMD_WAIT_RESPONSE)
+#define MMC_CMD12             (MMC_INDX(12) | MMC_CMD_WAIT_RESPONSE)
+#define MMC_CMD13             (MMC_INDX(13) | MMC_CMD_WAIT_RESPONSE)
+#define MMC_CMD16             (MMC_INDX(16) | MMC_CMD_WAIT_RESPONSE)
+#define MMC_CMD17             (MMC_INDX(17) | MMC_CMD_WAIT_RESPONSE)
+#define MMC_CMD18             (MMC_INDX(18) | MMC_CMD_WAIT_RESPONSE)
+#define MMC_CMD20             (MMC_INDX(20) | MMC_CMD_WAIT_RESPONSE)
+#define MMC_CMD23             (MMC_INDX(23) | MMC_CMD_WAIT_RESPONSE)
+#define MMC_CMD24             (MMC_INDX(24) | MMC_CMD_WAIT_RESPONSE)
+#define MMC_CMD25             (MMC_INDX(25) | MMC_CMD_WAIT_RESPONSE)
+#define MMC_CMD55             (MMC_INDX(55) | MMC_CMD_WAIT_RESPONSE)
+#define MMC_ACMD22            (MMC_INDX(22) | MMC_CMD_WAIT_RESPONSE)
+#define MMC_ACMD41            (MMC_INDX(41) | MMC_CMD_WAIT_RESPONSE | MMC_CMD_NO_CRC_RESPONSE)
+#define MMC_ACMD51            (MMC_INDX(51) | MMC_CMD_WAIT_RESPONSE)
+
+// Valid responses for CMD1 in eMMC
+#define EMMC_CMD1_CAPACITY_LESS_THAN_2GB 0x00FF8080 // Capacity <= 2GB, byte addressing used
+#define EMMC_CMD1_CAPACITY_GREATER_THAN_2GB 0x40FF8080 // Capacity > 2GB, 512-byte sector addressing used
+
+#define MMC_STATUS_APP_CMD    (1 << 5)
+
+typedef enum _MMC_STATE {
+    MmcInvalidState = 0,
+    MmcHwInitializationState,
+    MmcIdleState,
+    MmcReadyState,
+    MmcIdentificationState,
+    MmcStandByState,
+    MmcTransferState,
+    MmcSendingDataState,
+    MmcReceiveDataState,
+    MmcProgrammingState,
+    MmcDisconnectState,
+} MMC_STATE;
+
+#define EMMCBACKWARD         (0)
+#define EMMCHS26             (1 << 0)      // High-Speed @26MHz at rated device voltages
+#define EMMCHS52             (1 << 1)      // High-Speed @52MHz at rated device voltages
+#define EMMCHS52DDR1V8       (1 << 2)      // High-Speed Dual Data Rate @52MHz 1.8V or 3V I/O
+#define EMMCHS52DDR1V2       (1 << 3)      // High-Speed Dual Data Rate @52MHz 1.2V I/O
+#define EMMCHS200SDR1V8      (1 << 4)      // HS200 Single Data Rate @200MHz 1.8V I/O
+#define EMMCHS200SDR1V2      (1 << 5)      // HS200 Single Data Rate @200MHz 1.2V I/O
+#define EMMCHS400DDR1V8      (1 << 6)      // HS400 Dual Data Rate @400MHz 1.8V I/O
+#define EMMCHS400DDR1V2      (1 << 7)      // HS400 Dual Data Rate @400MHz 1.2V I/O
+
+///
+/// Forward declaration for EFI_MMC_HOST_PROTOCOL
+///
+typedef struct _EFI_MMC_HOST_PROTOCOL  EFI_MMC_HOST_PROTOCOL;
+
+typedef
+BOOLEAN
+(EFIAPI *MMC_ISCARDPRESENT) (
+  IN  EFI_MMC_HOST_PROTOCOL   *This
+  );
+
+typedef
+BOOLEAN
+(EFIAPI *MMC_ISREADONLY) (
+  IN  EFI_MMC_HOST_PROTOCOL   *This
+  );
+
+typedef
+EFI_STATUS
+(EFIAPI *MMC_BUILDDEVICEPATH) (
+  IN  EFI_MMC_HOST_PROTOCOL     *This,
+  OUT EFI_DEVICE_PATH_PROTOCOL  **DevicePath
+  );
+
+typedef
+EFI_STATUS
+(EFIAPI *MMC_NOTIFYSTATE) (
+  IN  EFI_MMC_HOST_PROTOCOL     *This,
+  IN  MMC_STATE                 State
+  );
+
+typedef
+EFI_STATUS
+(EFIAPI *MMC_SENDCOMMAND) (
+  IN  EFI_MMC_HOST_PROTOCOL     *This,
+  IN  MMC_CMD                   Cmd,
+  IN  UINT32                    Argument
+  );
+
+typedef
+EFI_STATUS
+(EFIAPI *MMC_RECEIVERESPONSE) (
+  IN  EFI_MMC_HOST_PROTOCOL     *This,
+  IN  MMC_RESPONSE_TYPE         Type,
+  IN  UINT32                    *Buffer
+  );
+
+typedef
+EFI_STATUS
+(EFIAPI *MMC_READBLOCKDATA) (
+  IN  EFI_MMC_HOST_PROTOCOL     *This,
+  IN  EFI_LBA                   Lba,
+  IN  UINTN                     Length,
+  OUT UINT32                    *Buffer
+  );
+
+typedef
+EFI_STATUS
+(EFIAPI *MMC_WRITEBLOCKDATA) (
+  IN  EFI_MMC_HOST_PROTOCOL     *This,
+  IN  EFI_LBA                   Lba,
+  IN  UINTN                     Length,
+  IN  UINT32                    *Buffer
+  );
+
+typedef
+EFI_STATUS
+(EFIAPI *MMC_SETIOS) (
+  IN  EFI_MMC_HOST_PROTOCOL     *This,
+  IN  UINT32                    BusClockFreq,
+  IN  UINT32                    BusWidth,
+  IN  UINT32                    TimingMode
+  );
+
+typedef
+BOOLEAN
+(EFIAPI *MMC_ISMULTIBLOCK) (
+  IN  EFI_MMC_HOST_PROTOCOL     *This
+  );
+
+struct _EFI_MMC_HOST_PROTOCOL {
+  UINT32                  Revision;
+  MMC_ISCARDPRESENT       IsCardPresent;
+  MMC_ISREADONLY          IsReadOnly;
+  MMC_BUILDDEVICEPATH     BuildDevicePath;
+
+  MMC_NOTIFYSTATE         NotifyState;
+
+  MMC_SENDCOMMAND         SendCommand;
+  MMC_RECEIVERESPONSE     ReceiveResponse;
+
+  MMC_READBLOCKDATA       ReadBlockData;
+  MMC_WRITEBLOCKDATA      WriteBlockData;
+
+  MMC_SETIOS              SetIos;
+  MMC_ISMULTIBLOCK        IsMultiBlock;
+};
+
+#define MMC_HOST_PROTOCOL_REVISION    0x00010002    // 1.2
+
+#define MMC_HOST_HAS_SETIOS(Host)       (Host->Revision >= MMC_HOST_PROTOCOL_REVISION && \
+                                         Host->SetIos != NULL)
+#define MMC_HOST_HAS_ISMULTIBLOCK(Host) (Host->Revision >= MMC_HOST_PROTOCOL_REVISION && \
+                                         Host->IsMultiBlock != NULL)
+
+#endif /* __RASPBERRY_PI_MMC_HOST_PROTOCOL_H__ */
-- 
2.17.0.windows.1



^ permalink raw reply related	[flat|nested] 34+ messages in thread

* [PATCH v5 edk2-platforms 14/22] Platform/RaspberryPi/RPi3: Add Arasan MMC driver
  2019-02-05 16:25 [PATCH v5 edk2-platforms 00/22] Platform/RaspberryPi: Add Raspberry Pi 3 support Pete Batard
                   ` (12 preceding siblings ...)
  2019-02-05 16:25 ` [PATCH v5 edk2-platforms 13/22] Platform/RaspberryPi/RPi3: Add base MMC driver Pete Batard
@ 2019-02-05 16:25 ` Pete Batard
  2019-02-05 16:25 ` [PATCH v5 edk2-platforms 15/22] Platform/RaspberryPi/RPi3: Add SD Host driver Pete Batard
                   ` (9 subsequent siblings)
  23 siblings, 0 replies; 34+ messages in thread
From: Pete Batard @ 2019-02-05 16:25 UTC (permalink / raw)
  To: edk2-devel

The BCM283x family includes two SD card controllers, one being an Arasan
SDHCI compliant controller. This driver implements support for this one.

Contributed-under: TianoCore Contribution Agreement 1.1
Signed-off-by: Pete Batard <pete@akeo.ie>
---
 Platform/RaspberryPi/RPi3/Drivers/ArasanMmcHostDxe/ArasanMmcHostDxe.c   | 723 ++++++++++++++++++++
 Platform/RaspberryPi/RPi3/Drivers/ArasanMmcHostDxe/ArasanMmcHostDxe.h   |  50 ++
 Platform/RaspberryPi/RPi3/Drivers/ArasanMmcHostDxe/ArasanMmcHostDxe.inf |  52 ++
 Silicon/Broadcom/Bcm283x/Include/IndustryStandard/Bcm2836Sdio.h         | 199 ++++++
 4 files changed, 1024 insertions(+)

diff --git a/Platform/RaspberryPi/RPi3/Drivers/ArasanMmcHostDxe/ArasanMmcHostDxe.c b/Platform/RaspberryPi/RPi3/Drivers/ArasanMmcHostDxe/ArasanMmcHostDxe.c
new file mode 100644
index 000000000000..828b40f82a5f
--- /dev/null
+++ b/Platform/RaspberryPi/RPi3/Drivers/ArasanMmcHostDxe/ArasanMmcHostDxe.c
@@ -0,0 +1,723 @@
+/** @file
+ *
+ *  Copyright (c) 2017, Andrei Warkentin <andrey.warkentin@gmail.com>
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *
+ *  This program and the accompanying materials
+ *  are licensed and made available under the terms and conditions of the BSD License
+ *  which accompanies this distribution.  The full text of the license may be found at
+ *  http://opensource.org/licenses/bsd-license.php
+ *
+ *  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+ *  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+ *
+ **/
+
+#include "ArasanMmcHostDxe.h"
+
+#define DEBUG_MMCHOST_SD DEBUG_VERBOSE
+
+BOOLEAN PreviousIsCardPresent = FALSE;
+UINT32 LastExecutedCommand = (UINT32) -1;
+
+STATIC RASPBERRY_PI_FIRMWARE_PROTOCOL *mFwProtocol;
+
+/**
+   These SD commands are optional, according to the SD Spec
+**/
+BOOLEAN
+IgnoreCommand (
+  UINT32 Command
+  )
+{
+  switch (Command) {
+  case MMC_CMD20:
+    return TRUE;
+  default:
+    return FALSE;
+  }
+}
+
+/**
+   Translates a generic SD command into the format used by the Arasan SD Host Controller
+**/
+UINT32
+TranslateCommand (
+  UINT32 Command,
+  UINT32 Argument
+  )
+{
+  UINT32 Translation = 0xffffffff;
+
+  if (LastExecutedCommand == CMD55) {
+    switch (Command) {
+    case MMC_CMD6:
+      Translation = ACMD6;
+      DEBUG ((DEBUG_MMCHOST_SD, "ACMD6\n"));
+      break;
+    case MMC_ACMD22:
+      Translation = ACMD22;
+      DEBUG ((DEBUG_MMCHOST_SD, "ACMD22\n"));
+      break;
+    case MMC_ACMD41:
+      Translation = ACMD41;
+      DEBUG ((DEBUG_MMCHOST_SD, "ACMD41\n"));
+      break;
+    case MMC_ACMD51:
+      Translation = ACMD51;
+      DEBUG ((DEBUG_MMCHOST_SD, "ACMD51\n"));
+      break;
+    default:
+      DEBUG ((DEBUG_ERROR, "ArasanMMCHost: TranslateCommand(): Unrecognized App command: %d\n", Command));
+    }
+  } else {
+    switch (Command) {
+    case MMC_CMD0:
+      Translation = CMD0;
+      break;
+    case MMC_CMD1:
+      Translation = CMD1;
+      break;
+    case MMC_CMD2:
+      Translation = CMD2;
+      break;
+    case MMC_CMD3:
+      Translation = CMD3;
+      break;
+    case MMC_CMD5:
+      Translation = CMD5;
+      break;
+    case MMC_CMD6:
+      Translation = CMD6;
+      break;
+    case MMC_CMD7:
+      Translation = CMD7;
+      break;
+    case MMC_CMD8: {
+      if (Argument == CMD8_SD_ARG) {
+        Translation = CMD8_SD;
+        DEBUG ((DEBUG_MMCHOST_SD, "Sending SD CMD8 variant\n"));
+      } else {
+        ASSERT (Argument == CMD8_MMC_ARG);
+        Translation = CMD8_MMC;
+        DEBUG ((DEBUG_MMCHOST_SD, "Sending MMC CMD8 variant\n"));
+      }
+      break;
+    }
+    case MMC_CMD9:
+      Translation = CMD9;
+      break;
+    case MMC_CMD11:
+      Translation = CMD11;
+      break;
+    case MMC_CMD12:
+      Translation = CMD12;
+      break;
+    case MMC_CMD13:
+      Translation = CMD13;
+      break;
+    case MMC_CMD16:
+      Translation = CMD16;
+      break;
+    case MMC_CMD17:
+      Translation = CMD17;
+      break;
+    case MMC_CMD18:
+      Translation = CMD18;
+      break;
+    case MMC_CMD23:
+      Translation = CMD23;
+      break;
+    case MMC_CMD24:
+      Translation = CMD24;
+      break;
+    case MMC_CMD25:
+      Translation = CMD25;
+      break;
+    case MMC_CMD55:
+      Translation = CMD55;
+      break;
+    default:
+      DEBUG ((DEBUG_ERROR, "ArasanMMCHost: TranslateCommand(): Unrecognized Command: %d\n", Command));
+    }
+  }
+
+  return Translation;
+}
+
+/**
+   Repeatedly polls a register until its value becomes correct, or until MAX_RETRY_COUNT polls is reached
+**/
+EFI_STATUS
+PollRegisterWithMask (
+  IN UINTN Register,
+  IN UINTN Mask,
+  IN UINTN ExpectedValue
+  )
+{
+  UINTN RetryCount = 0;
+
+  while (RetryCount < MAX_RETRY_COUNT) {
+    if ((MmioRead32 (Register) & Mask) != ExpectedValue) {
+      RetryCount++;
+      gBS->Stall (STALL_AFTER_RETRY_US);
+    } else {
+      break;
+    }
+  }
+
+  if (RetryCount == MAX_RETRY_COUNT) {
+    return EFI_TIMEOUT;
+  }
+
+  return EFI_SUCCESS;
+}
+
+STATIC
+EFI_STATUS
+SoftReset (
+  IN UINT32 Mask
+  )
+{
+  MmioOr32 (MMCHS_SYSCTL, Mask);
+  if (PollRegisterWithMask (MMCHS_SYSCTL, Mask, 0) == EFI_TIMEOUT) {
+    DEBUG ((DEBUG_ERROR, "Failed to SoftReset with mask 0x%x\n", Mask));
+    return EFI_TIMEOUT;
+  }
+
+  return EFI_SUCCESS;
+}
+
+/**
+   Calculate the clock divisor
+**/
+EFI_STATUS
+CalculateClockFrequencyDivisor (
+  IN UINTN TargetFrequency,
+  OUT UINT32 *DivisorValue,
+  OUT UINTN *ActualFrequency
+  )
+{
+  EFI_STATUS Status;
+  UINT32 Divisor;
+  UINT32 BaseFrequency = 0;
+
+  Status = mFwProtocol->GetClockRate (RPI_MBOX_CLOCK_RATE_EMMC, &BaseFrequency);
+  if (EFI_ERROR (Status)) {
+    DEBUG ((DEBUG_ERROR, "Couldn't get RPI_MBOX_CLOCK_RATE_EMMC\n"));
+    return Status;
+  }
+
+  ASSERT (BaseFrequency != 0);
+  Divisor = BaseFrequency / TargetFrequency;
+
+  // Arasan controller is based on 3.0 spec so the div is multiple of 2
+  // Actual Frequency = BaseFequency/(Div*2)
+  Divisor /= 2;
+
+  if ((TargetFrequency < BaseFrequency) &&
+      (TargetFrequency * 2 * Divisor != BaseFrequency)) {
+    Divisor += 1;
+  }
+
+  if (Divisor > MAX_DIVISOR_VALUE) {
+    Divisor = MAX_DIVISOR_VALUE;
+  }
+
+  DEBUG ((DEBUG_MMCHOST_SD, "ArasanMMCHost: BaseFrequency 0x%x Divisor 0x%x\n", BaseFrequency, Divisor));
+
+  *DivisorValue = (Divisor & 0xFF) << 8;
+  Divisor >>= 8;
+  *DivisorValue |= (Divisor & 0x03) << 6;
+
+  if (ActualFrequency) {
+    if (Divisor == 0) {
+      *ActualFrequency = BaseFrequency;
+    } else {
+      *ActualFrequency = BaseFrequency / Divisor;
+      *ActualFrequency >>= 1;
+    }
+    DEBUG ((DEBUG_MMCHOST_SD, "ArasanMMCHost: *ActualFrequency 0x%x\n", *ActualFrequency));
+  }
+
+  DEBUG ((DEBUG_MMCHOST_SD, "ArasanMMCHost: *DivisorValue 0x%x\n", *DivisorValue));
+
+  return EFI_SUCCESS;
+}
+
+BOOLEAN
+MMCIsCardPresent (
+  IN EFI_MMC_HOST_PROTOCOL *This
+)
+{
+  return TRUE;
+}
+
+BOOLEAN
+MMCIsReadOnly (
+  IN EFI_MMC_HOST_PROTOCOL *This
+  )
+{
+  BOOLEAN IsReadOnly = !((MmioRead32 (MMCHS_PRES_STATE) & WRITE_PROTECT_OFF) == WRITE_PROTECT_OFF);
+  DEBUG ((DEBUG_MMCHOST_SD, "ArasanMMCHost: MMCIsReadOnly(): %d\n", IsReadOnly));
+  return IsReadOnly;
+}
+
+EFI_STATUS
+MMCBuildDevicePath (
+  IN EFI_MMC_HOST_PROTOCOL       *This,
+  IN EFI_DEVICE_PATH_PROTOCOL    **DevicePath
+  )
+{
+  EFI_DEVICE_PATH_PROTOCOL *NewDevicePathNode;
+  EFI_GUID DevicePathGuid = EFI_CALLER_ID_GUID;
+
+  DEBUG ((DEBUG_MMCHOST_SD, "ArasanMMCHost: MMCBuildDevicePath()\n"));
+
+  NewDevicePathNode = CreateDeviceNode (HARDWARE_DEVICE_PATH, HW_VENDOR_DP, sizeof (VENDOR_DEVICE_PATH));
+  CopyGuid (&((VENDOR_DEVICE_PATH*) NewDevicePathNode)->Guid, &DevicePathGuid);
+  *DevicePath = NewDevicePathNode;
+
+  return EFI_SUCCESS;
+}
+
+EFI_STATUS
+MMCSendCommand (
+  IN EFI_MMC_HOST_PROTOCOL    *This,
+  IN MMC_CMD                  MmcCmd,
+  IN UINT32                   Argument
+  )
+{
+  UINTN MmcStatus;
+  UINTN RetryCount = 0;
+  UINTN CmdSendOKMask;
+  EFI_STATUS Status = EFI_SUCCESS;
+  BOOLEAN IsAppCmd = (LastExecutedCommand == CMD55);
+  BOOLEAN IsDATCmd = FALSE;
+  BOOLEAN IsADTCCmd = FALSE;
+
+  DEBUG ((DEBUG_MMCHOST_SD, "ArasanMMCHost: MMCSendCommand(MmcCmd: %08x, Argument: %08x)\n", MmcCmd, Argument));
+
+  if (IgnoreCommand (MmcCmd)) {
+    return EFI_SUCCESS;
+  }
+
+  MmcCmd = TranslateCommand (MmcCmd, Argument);
+  if (MmcCmd == 0xffffffff) {
+    return EFI_UNSUPPORTED;
+  }
+
+  if ((MmcCmd & CMD_R1_ADTC) == CMD_R1_ADTC) {
+    IsADTCCmd = TRUE;
+  }
+  if (((MmcCmd & CMD_R1B) == CMD_R1B &&
+    /*
+     * Abort commands don't get inhibited by DAT.
+     */
+    (MmcCmd & TYPE (CMD_TYPE_ABORT)) != TYPE (CMD_TYPE_ABORT)) ||
+    IsADTCCmd ||
+    /*
+     * We want to detect BRR/BWR change.
+     */
+    MmcCmd == CMD_SEND_STATUS) {
+    IsDATCmd = TRUE;
+  }
+
+  CmdSendOKMask = CMDI_MASK;
+  if (IsDATCmd) {
+    CmdSendOKMask |= DATI_MASK;
+  }
+
+  if (PollRegisterWithMask (MMCHS_PRES_STATE,
+    CmdSendOKMask, 0) == EFI_TIMEOUT) {
+    DEBUG ((DEBUG_ERROR, "%a(%u): not ready for MMC_CMD%u PresState 0x%x MmcStatus 0x%x\n",
+      __FUNCTION__, __LINE__, MMC_CMD_NUM (MmcCmd),
+      MmioRead32 (MMCHS_PRES_STATE), MmioRead32 (MMCHS_INT_STAT)));
+    Status = EFI_TIMEOUT;
+    goto Exit;
+  }
+
+  if (IsAppCmd && MmcCmd == ACMD22) {
+    MmioWrite32 (MMCHS_BLK, 4);
+  } else if (IsAppCmd && MmcCmd == ACMD51) {
+    MmioWrite32 (MMCHS_BLK, 8);
+  } else if (!IsAppCmd && MmcCmd == CMD6) {
+    MmioWrite32 (MMCHS_BLK, 64);
+  } else if (IsADTCCmd) {
+    MmioWrite32 (MMCHS_BLK, BLEN_512BYTES);
+  }
+
+  // Set Data timeout counter value to max value.
+  MmioAndThenOr32 (MMCHS_SYSCTL, (UINT32) ~DTO_MASK, DTO_VAL);
+
+  //
+  // Clear Interrupt Status Register, but not the Card Inserted bit
+  // to avoid messing with card detection logic.
+  //
+  MmioWrite32 (MMCHS_INT_STAT, ALL_EN & ~(CARD_INS));
+
+  // Set command argument register
+  MmioWrite32 (MMCHS_ARG, Argument);
+
+  // Send the command
+  MmioWrite32 (MMCHS_CMD, MmcCmd);
+
+  // Check for the command status.
+  while (RetryCount < MAX_RETRY_COUNT) {
+    MmcStatus = MmioRead32 (MMCHS_INT_STAT);
+
+    // Read status of command response
+    if ((MmcStatus & ERRI) != 0) {
+      //
+      // CMD5 (CMD_IO_SEND_OP_COND) is only valid for SDIO
+      // cards and thus expected to fail.
+      //
+      if (MmcCmd != CMD_IO_SEND_OP_COND) {
+        DEBUG ((DEBUG_ERROR, "%a(%u): MMC_CMD%u ERRI MmcStatus 0x%x\n",
+          __FUNCTION__, __LINE__, MMC_CMD_NUM (MmcCmd), MmcStatus));
+      }
+
+      SoftReset (SRC);
+
+      Status = EFI_DEVICE_ERROR;
+      goto Exit;
+    }
+
+    // Check if command is completed.
+    if ((MmcStatus & CC) == CC) {
+      MmioWrite32 (MMCHS_INT_STAT, CC);
+      break;
+    }
+
+    RetryCount++;
+    gBS->Stall (STALL_AFTER_RETRY_US);
+  }
+
+  gBS->Stall (STALL_AFTER_SEND_CMD_US);
+
+  if (RetryCount == MAX_RETRY_COUNT) {
+    DEBUG ((DEBUG_ERROR, "%a(%u): MMC_CMD%u completion TIMEOUT PresState 0x%x MmcStatus 0x%x\n",
+      __FUNCTION__, __LINE__, MMC_CMD_NUM (MmcCmd),
+      MmioRead32 (MMCHS_PRES_STATE), MmcStatus));
+    Status = EFI_TIMEOUT;
+    goto Exit;
+  }
+
+Exit:
+  if (EFI_ERROR (Status)) {
+    LastExecutedCommand = (UINT32) -1;
+  } else {
+    LastExecutedCommand = MmcCmd;
+  }
+  return Status;
+}
+
+EFI_STATUS
+MMCNotifyState (
+  IN EFI_MMC_HOST_PROTOCOL    *This,
+  IN MMC_STATE                State
+  )
+{
+  EFI_STATUS Status;
+  UINTN ClockFrequency;
+  UINT32 Divisor;
+
+  DEBUG ((DEBUG_MMCHOST_SD, "ArasanMMCHost: MMCNotifyState(State: %d)\n", State));
+
+  switch (State) {
+  case MmcHwInitializationState:
+    {
+      EFI_STATUS Status;
+      UINT32 Divisor;
+
+      Status = SoftReset (SRA);
+      if (EFI_ERROR (Status)) {
+        return Status;
+      }
+
+      // Attempt to set the clock to 400Khz which is the expected initialization speed
+      Status = CalculateClockFrequencyDivisor (400000, &Divisor, NULL);
+      if (EFI_ERROR (Status)) {
+        DEBUG ((DEBUG_ERROR, "ArasanMMCHost: MMCNotifyState(): Fail to initialize SD clock\n"));
+        return Status;
+      }
+
+      // Set Data Timeout Counter value, set clock frequency, enable internal clock
+      MmioOr32 (MMCHS_SYSCTL, DTO_VAL | Divisor | CEN | ICS | ICE);
+
+      // Enable interrupts
+      MmioWrite32 (MMCHS_IE, ALL_EN);
+    }
+    break;
+  case MmcIdleState:
+    break;
+  case MmcReadyState:
+    break;
+  case MmcIdentificationState:
+    break;
+  case MmcStandByState:
+    ClockFrequency = 25000000;
+
+    // First turn off the clock
+    MmioAnd32 (MMCHS_SYSCTL, ~CEN);
+
+    Status = CalculateClockFrequencyDivisor (ClockFrequency, &Divisor, NULL);
+    if (EFI_ERROR (Status)) {
+      DEBUG ((DEBUG_ERROR, "ArasanMMCHost: MmcStandByState(): Fail to initialize SD clock to %u Hz\n",
+        ClockFrequency));
+      return Status;
+    }
+
+    // Setup new divisor
+    MmioAndThenOr32 (MMCHS_SYSCTL, (UINT32) ~CLKD_MASK, Divisor);
+
+    // Wait for the clock to stabilise
+    while ((MmioRead32 (MMCHS_SYSCTL) & ICS_MASK) != ICS);
+
+    // Set Data Timeout Counter value, set clock frequency, enable internal clock
+    MmioOr32 (MMCHS_SYSCTL, CEN);
+    break;
+  case MmcTransferState:
+    break;
+  case MmcSendingDataState:
+    break;
+  case MmcReceiveDataState:
+    break;
+  case MmcProgrammingState:
+    break;
+  case MmcDisconnectState:
+  case MmcInvalidState:
+  default:
+    DEBUG ((DEBUG_ERROR, "ArasanMMCHost: MMCNotifyState(): Invalid State: %d\n", State));
+    ASSERT (0);
+  }
+
+  return EFI_SUCCESS;
+}
+
+EFI_STATUS
+MMCReceiveResponse (
+  IN EFI_MMC_HOST_PROTOCOL    *This,
+  IN MMC_RESPONSE_TYPE        Type,
+  IN UINT32*                  Buffer
+  )
+{
+  ASSERT (Buffer != NULL);
+
+  if (Type == MMC_RESPONSE_TYPE_R2) {
+
+    // 16-byte response
+    Buffer[0] = MmioRead32 (MMCHS_RSP10);
+    Buffer[1] = MmioRead32 (MMCHS_RSP32);
+    Buffer[2] = MmioRead32 (MMCHS_RSP54);
+    Buffer[3] = MmioRead32 (MMCHS_RSP76);
+
+    Buffer[3] <<= 8;
+    Buffer[3] |= (Buffer[2] >> 24) & 0xFF;
+    Buffer[2] <<= 8;
+    Buffer[2] |= (Buffer[1] >> 24) & 0xFF;
+    Buffer[1] <<= 8;
+    Buffer[1] |= (Buffer[0] >> 24) & 0xFF;
+    Buffer[0] <<= 8;
+
+    DEBUG ((DEBUG_MMCHOST_SD,
+      "ArasanMMCHost: MMCReceiveResponse(Type: %x), Buffer[0-3]: %08x, %08x, %08x, %08x\n",
+      Type, Buffer[0], Buffer[1], Buffer[2], Buffer[3]));
+  } else {
+    // 4-byte response
+    Buffer[0] = MmioRead32 (MMCHS_RSP10);
+    DEBUG ((DEBUG_MMCHOST_SD, "ArasanMMCHost: MMCReceiveResponse(Type: %08x), Buffer[0]: %08x\n", Type, Buffer[0]));
+  }
+
+  gBS->Stall (STALL_AFTER_REC_RESP_US);
+  if (LastExecutedCommand == CMD_STOP_TRANSMISSION) {
+    DEBUG ((DEBUG_MMCHOST_SD, "ArasanMMCHost: soft-resetting after CMD12\n"));
+    return SoftReset (SRC | SRD);
+  }
+  return EFI_SUCCESS;
+}
+
+EFI_STATUS
+MMCReadBlockData (
+  IN EFI_MMC_HOST_PROTOCOL    *This,
+  IN EFI_LBA                  Lba,
+  IN UINTN                    Length,
+  IN UINT32*                  Buffer
+  )
+{
+  UINTN MmcStatus;
+  UINTN RemLength;
+  UINTN Count;
+
+  DEBUG ((DEBUG_VERBOSE, "%a(%u): LBA: 0x%x, Length: 0x%x, Buffer: 0x%x)\n",
+    __FUNCTION__, __LINE__, Lba, Length, Buffer));
+
+  if (Buffer == NULL) {
+    DEBUG ((DEBUG_ERROR, "%a(%u): NULL Buffer\n", __FUNCTION__, __LINE__));
+    return EFI_INVALID_PARAMETER;
+  }
+
+  if (Length % sizeof (UINT32) != 0) {
+    DEBUG ((DEBUG_ERROR, "%a(%u): bad Length %u\n", __FUNCTION__, __LINE__, Length));
+    return EFI_INVALID_PARAMETER;
+  }
+
+  RemLength = Length;
+  while (RemLength != 0) {
+    UINTN RetryCount = 0;
+    UINT32 BlockLen = MIN (RemLength, BLEN_512BYTES);
+
+    while (RetryCount < MAX_RETRY_COUNT) {
+      MmcStatus = MmioRead32 (MMCHS_INT_STAT);
+      if ((MmcStatus & BRR) != 0) {
+        MmioWrite32 (MMCHS_INT_STAT, BRR);
+        /*
+         * Data is ready.
+         */
+        mFwProtocol->SetLed (TRUE);
+        for (Count = 0; Count < BlockLen; Count += 4, Buffer++) {
+          *Buffer = MmioRead32 (MMCHS_DATA);
+        }
+
+        mFwProtocol->SetLed (FALSE);
+        break;
+      }
+
+      gBS->Stall (STALL_AFTER_RETRY_US);
+      RetryCount++;
+    }
+
+    if (RetryCount == MAX_RETRY_COUNT) {
+      DEBUG ((DEBUG_ERROR, "%a(%u): %lu/%lu MMCHS_INT_STAT: %08x\n",
+        __FUNCTION__, __LINE__, Length - RemLength, Length, MmcStatus));
+      return EFI_TIMEOUT;
+    }
+
+    RemLength -= BlockLen;
+    gBS->Stall (STALL_AFTER_READ_US);
+  }
+
+  MmioWrite32 (MMCHS_INT_STAT, BRR);
+  return EFI_SUCCESS;
+}
+
+EFI_STATUS
+MMCWriteBlockData (
+  IN EFI_MMC_HOST_PROTOCOL    *This,
+  IN EFI_LBA                  Lba,
+  IN UINTN                    Length,
+  IN UINT32*                  Buffer
+  )
+{
+  UINTN MmcStatus;
+  UINTN RemLength;
+  UINTN Count;
+
+  DEBUG ((DEBUG_VERBOSE, "%a(%u): LBA: 0x%x, Length: 0x%x, Buffer: 0x%x)\n",
+    __FUNCTION__, __LINE__, Lba, Length, Buffer));
+
+  if (Buffer == NULL) {
+    DEBUG ((DEBUG_ERROR, "%a(%u): NULL Buffer\n", __FUNCTION__, __LINE__));
+    return EFI_INVALID_PARAMETER;
+  }
+
+  if (Length % sizeof (UINT32) != 0) {
+    DEBUG ((DEBUG_ERROR, "%a(%u): bad Length %u\n", __FUNCTION__, __LINE__, Length));
+    return EFI_INVALID_PARAMETER;
+  }
+
+  RemLength = Length;
+  while (RemLength != 0) {
+    UINTN RetryCount = 0;
+    UINT32 BlockLen = MIN (RemLength, BLEN_512BYTES);
+
+    while (RetryCount < MAX_RETRY_COUNT) {
+      MmcStatus = MmioRead32 (MMCHS_INT_STAT);
+      if ((MmcStatus & BWR) != 0) {
+        MmioWrite32 (MMCHS_INT_STAT, BWR);
+        /*
+         * Can write data.
+         */
+        mFwProtocol->SetLed (TRUE);
+        for (Count = 0; Count < BlockLen; Count += 4, Buffer++) {
+          MmioWrite32 (MMCHS_DATA, *Buffer);
+        }
+
+        mFwProtocol->SetLed (FALSE);
+        break;
+      }
+
+      gBS->Stall (STALL_AFTER_RETRY_US);
+      RetryCount++;
+    }
+
+    if (RetryCount == MAX_RETRY_COUNT) {
+      DEBUG ((DEBUG_ERROR, "%a(%u): %lu/%lu MMCHS_INT_STAT: %08x\n",
+        __FUNCTION__, __LINE__, Length - RemLength, Length, MmcStatus));
+      return EFI_TIMEOUT;
+    }
+
+    RemLength -= BlockLen;
+    gBS->Stall (STALL_AFTER_WRITE_US);
+  }
+
+  MmioWrite32 (MMCHS_INT_STAT, BWR);
+  return EFI_SUCCESS;
+}
+
+BOOLEAN
+MMCIsMultiBlock (
+  IN EFI_MMC_HOST_PROTOCOL *This
+  )
+{
+  return TRUE;
+}
+
+EFI_MMC_HOST_PROTOCOL gMMCHost =
+{
+  MMC_HOST_PROTOCOL_REVISION,
+  MMCIsCardPresent,
+  MMCIsReadOnly,
+  MMCBuildDevicePath,
+  MMCNotifyState,
+  MMCSendCommand,
+  MMCReceiveResponse,
+  MMCReadBlockData,
+  MMCWriteBlockData,
+  NULL,
+  MMCIsMultiBlock
+};
+
+EFI_STATUS
+MMCInitialize (
+  IN EFI_HANDLE          ImageHandle,
+  IN EFI_SYSTEM_TABLE    *SystemTable
+  )
+{
+  EFI_STATUS Status;
+  EFI_HANDLE Handle = NULL;
+
+  DEBUG ((DEBUG_MMCHOST_SD, "ArasanMMCHost: MMCInitialize()\n"));
+
+  if (!PcdGet32 (PcdSdIsArasan)) {
+    DEBUG ((DEBUG_INFO, "SD is not routed to Arasan\n"));
+    return EFI_REQUEST_UNLOAD_IMAGE;
+  }
+
+  Status = gBS->LocateProtocol (&gRaspberryPiFirmwareProtocolGuid, NULL,
+                  (VOID**)&mFwProtocol);
+  ASSERT_EFI_ERROR (Status);
+  if (EFI_ERROR (Status)) {
+    return Status;
+  }
+
+  Status = gBS->InstallMultipleProtocolInterfaces (
+                  &Handle,
+                  &gRaspberryPiMmcHostProtocolGuid,
+                  &gMMCHost,
+                  NULL
+                );
+  ASSERT_EFI_ERROR (Status);
+
+  return Status;
+}
diff --git a/Platform/RaspberryPi/RPi3/Drivers/ArasanMmcHostDxe/ArasanMmcHostDxe.h b/Platform/RaspberryPi/RPi3/Drivers/ArasanMmcHostDxe/ArasanMmcHostDxe.h
new file mode 100644
index 000000000000..d1a3f014b45e
--- /dev/null
+++ b/Platform/RaspberryPi/RPi3/Drivers/ArasanMmcHostDxe/ArasanMmcHostDxe.h
@@ -0,0 +1,50 @@
+/** @file
+ *
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *
+ *  This program and the accompanying materials
+ *  are licensed and made available under the terms and conditions of the BSD License
+ *  which accompanies this distribution.  The full text of the license may be found at
+ *  http://opensource.org/licenses/bsd-license.php
+ *
+ *  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+ *  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+ *
+ **/
+
+#ifndef _MMC_HOST_DXE_H_
+#define _MMC_HOST_DXE_H_
+
+#include <Uefi.h>
+
+#include <Library/BaseLib.h>
+#include <Library/MemoryAllocationLib.h>
+#include <Library/DebugLib.h>
+#include <Library/DevicePathLib.h>
+#include <Library/IoLib.h>
+#include <Library/PcdLib.h>
+#include <Library/UefiBootServicesTableLib.h>
+#include <Library/BaseMemoryLib.h>
+#include <Library/DmaLib.h>
+
+#include <Protocol/EmbeddedExternalDevice.h>
+#include <Protocol/BlockIo.h>
+#include <Protocol/DevicePath.h>
+#include <Protocol/RpiMmcHost.h>
+#include <Protocol/RpiFirmware.h>
+
+#include <IndustryStandard/Bcm2836.h>
+#include <IndustryStandard/Bcm2836Sdio.h>
+#include <IndustryStandard/RpiMbox.h>
+
+#define MAX_RETRY_COUNT (1000 * 20)
+
+#define STALL_AFTER_SEND_CMD_US (200) // in microseconds
+#define STALL_AFTER_REC_RESP_US (50)
+#define STALL_AFTER_WRITE_US (200)
+#define STALL_AFTER_READ_US (20)
+#define STALL_AFTER_RETRY_US (20)
+
+#define MAX_DIVISOR_VALUE 1023
+
+#endif
diff --git a/Platform/RaspberryPi/RPi3/Drivers/ArasanMmcHostDxe/ArasanMmcHostDxe.inf b/Platform/RaspberryPi/RPi3/Drivers/ArasanMmcHostDxe/ArasanMmcHostDxe.inf
new file mode 100644
index 000000000000..1e3622194430
--- /dev/null
+++ b/Platform/RaspberryPi/RPi3/Drivers/ArasanMmcHostDxe/ArasanMmcHostDxe.inf
@@ -0,0 +1,52 @@
+#/** @file
+#
+#  Copyright (c) 2017, Andrei Warkentin <andrey.warkentin@gmail.com>
+#  Copyright (c) Microsoft Corporation. All rights reserved.
+#
+#  This program and the accompanying materials
+#  are licensed and made available under the terms and conditions of the BSD License
+#  which accompanies this distribution.  The full text of the license may be found at
+#  http://opensource.org/licenses/bsd-license.php
+#
+#  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+#  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+#
+#**/
+
+[Defines]
+  INF_VERSION                    = 0x0001001A
+  BASE_NAME                      = ArasanMMCHost
+  FILE_GUID                      = 100c2cfa-b586-4198-9b4c-1683d195b1da
+  MODULE_TYPE                    = DXE_DRIVER
+  VERSION_STRING                 = 1.0
+  ENTRY_POINT                    = MMCInitialize
+
+[Sources.common]
+  ArasanMmcHostDxe.c
+
+[Packages]
+  MdePkg/MdePkg.dec
+  EmbeddedPkg/EmbeddedPkg.dec
+  Silicon/Broadcom/Bcm283x/Bcm283x.dec
+  Platform/RaspberryPi/RPi3/RPi3.dec
+
+[LibraryClasses]
+  PcdLib
+  UefiLib
+  UefiDriverEntryPoint
+  MemoryAllocationLib
+  IoLib
+  DmaLib
+  CacheMaintenanceLib
+
+[Guids]
+
+[Protocols]
+  gRaspberryPiMmcHostProtocolGuid  ## PRODUCES
+  gRaspberryPiFirmwareProtocolGuid ## CONSUMES
+
+[Pcd]
+  gRaspberryPiTokenSpaceGuid.PcdSdIsArasan
+
+[Depex]
+  gRaspberryPiFirmwareProtocolGuid AND gRaspberryPiConfigAppliedProtocolGuid
diff --git a/Silicon/Broadcom/Bcm283x/Include/IndustryStandard/Bcm2836Sdio.h b/Silicon/Broadcom/Bcm283x/Include/IndustryStandard/Bcm2836Sdio.h
new file mode 100644
index 000000000000..502ccb498247
--- /dev/null
+++ b/Silicon/Broadcom/Bcm283x/Include/IndustryStandard/Bcm2836Sdio.h
@@ -0,0 +1,199 @@
+/** @file
+ *
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *
+ *  This program and the accompanying materials
+ *  are licensed and made available under the terms and conditions of the BSD License
+ *  which accompanies this distribution.  The full text of the license may be found at
+ *  http://opensource.org/licenses/bsd-license.php
+ *
+ *  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+ *  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+ *
+ **/
+
+#ifndef __BCM2836_SDIO_H__
+#define __BCM2836_SDIO_H__
+
+//MMC/SD/SDIO1 register definitions.
+#define MMCHS1BASE        0x3F300000
+
+#define MMCHS_BLK         (MMCHS1BASE + 0x4)
+#define BLEN_512BYTES     (0x200UL << 0)
+
+#define MMCHS_ARG         (MMCHS1BASE + 0x8)
+
+#define MMCHS_CMD         (MMCHS1BASE + 0xC)
+#define BCE_ENABLE        BIT1
+#define DDIR_READ         BIT4
+#define DDIR_WRITE        (0x0UL << 4)
+#define MSBS_SGLEBLK      (0x0UL << 5)
+#define MSBS_MULTBLK      BIT5
+#define RSP_TYPE_MASK     (0x3UL << 16)
+#define RSP_TYPE_136BITS  BIT16
+#define RSP_TYPE_48BITS   (0x2UL << 16)
+#define RSP_TYPE_48BUSY   (0x3UL << 16)
+#define CCCE_ENABLE       BIT19
+#define CICE_ENABLE       BIT20
+#define DP_ENABLE         BIT21
+
+#define CMD_TYPE_NORMAL      0
+#define CMD_TYPE_ABORT       3
+#define TYPE(CMD_TYPE)       (((CMD_TYPE) & 0x3) << 22)
+#define _INDX(CMD_INDX)      ((CMD_INDX & 0x3F) << 24)
+#define MMC_CMD_NUM(CMD)     (((CMD) >> 24) & 0x3F)
+#define INDX(CMD_INDX)       (TYPE(CMD_TYPE_NORMAL) | _INDX(CMD_INDX))
+#define INDX_ABORT(CMD_INDX) (TYPE(CMD_TYPE_ABORT) | _INDX(CMD_INDX))
+
+#define MMCHS_RSP10       (MMCHS1BASE + 0x10)
+#define MMCHS_RSP32       (MMCHS1BASE + 0x14)
+#define MMCHS_RSP54       (MMCHS1BASE + 0x18)
+#define MMCHS_RSP76       (MMCHS1BASE + 0x1C)
+#define MMCHS_DATA        (MMCHS1BASE + 0x20)
+
+#define MMCHS_PRES_STATE  (MMCHS1BASE + 0x24)
+#define CMDI_MASK         BIT0
+#define CMDI_ALLOWED      (0x0UL << 0)
+#define CMDI_NOT_ALLOWED  BIT0
+#define DATI_MASK         BIT1
+#define DATI_ALLOWED      (0x0UL << 1)
+#define DATI_NOT_ALLOWED  BIT1
+#define WRITE_PROTECT_OFF BIT19
+
+#define MMCHS_HCTL        (MMCHS1BASE + 0x28)
+#define DTW_1_BIT         (0x0UL << 1)
+#define DTW_4_BIT         BIT1
+#define SDBP_MASK         BIT8
+#define SDBP_OFF          (0x0UL << 8)
+#define SDBP_ON           BIT8
+#define SDVS_1_8_V        (0x5UL << 9)
+#define SDVS_3_0_V        (0x6UL << 9)
+#define IWE               BIT24
+
+#define MMCHS_SYSCTL      (MMCHS1BASE + 0x2C)
+#define ICE               BIT0
+#define ICS_MASK          BIT1
+#define ICS               BIT1
+#define CEN               BIT2
+#define CLKD_MASK         (0x3FFUL << 6)
+#define CLKD_80KHZ        (0x258UL) //(96*1000/80)/2
+#define CLKD_400KHZ       (0xF0UL)
+#define CLKD_12500KHZ     (0x200UL)
+#define DTO_MASK          (0xFUL << 16)
+#define DTO_VAL           (0xEUL << 16)
+#define SRA               BIT24
+#define SRC_MASK          BIT25
+#define SRC               BIT25
+#define SRD               BIT26
+
+#define MMCHS_INT_STAT    (MMCHS1BASE + 0x30)
+#define CC                BIT0
+#define TC                BIT1
+#define BWR               BIT4
+#define BRR               BIT5
+#define CARD_INS          BIT6
+#define ERRI              BIT15
+#define CTO               BIT16
+#define DTO               BIT20
+#define DCRC              BIT21
+#define DEB               BIT22
+
+#define MMCHS_IE          (MMCHS1BASE + 0x34)
+#define CC_EN             BIT0
+#define TC_EN             BIT1
+#define BWR_EN            BIT4
+#define BRR_EN            BIT5
+#define CTO_EN            BIT16
+#define CCRC_EN           BIT17
+#define CEB_EN            BIT18
+#define CIE_EN            BIT19
+#define DTO_EN            BIT20
+#define DCRC_EN           BIT21
+#define DEB_EN            BIT22
+#define CERR_EN           BIT28
+#define BADA_EN           BIT29
+#define ALL_EN            0xFFFFFFFF
+
+#define MMCHS_ISE         (MMCHS1BASE + 0x38)
+#define CC_SIGEN          BIT0
+#define TC_SIGEN          BIT1
+#define BWR_SIGEN         BIT4
+#define BRR_SIGEN         BIT5
+#define CTO_SIGEN         BIT16
+#define CCRC_SIGEN        BIT17
+#define CEB_SIGEN         BIT18
+#define CIE_SIGEN         BIT19
+#define DTO_SIGEN         BIT20
+#define DCRC_SIGEN        BIT21
+#define DEB_SIGEN         BIT22
+#define CERR_SIGEN        BIT28
+#define BADA_SIGEN        BIT29
+
+#define MMCHS_AC12        (MMCHS1BASE + 0x3C)
+
+#define MMCHS_CAPA        (MMCHS1BASE + 0x40)
+#define VS30              BIT25
+#define VS18              BIT26
+
+#define MMCHS_CUR_CAPA    (MMCHS1BASE + 0x48)
+#define MMCHS_REV         (MMCHS1BASE + 0xFC)
+
+#define BLOCK_COUNT_SHIFT 16
+#define RCA_SHIFT         16
+
+#define CMD_R1            (RSP_TYPE_48BITS | CCCE_ENABLE | CICE_ENABLE)
+#define CMD_R1B           (RSP_TYPE_48BUSY | CCCE_ENABLE | CICE_ENABLE)
+#define CMD_R2            (RSP_TYPE_136BITS | CCCE_ENABLE)
+#define CMD_R3            (RSP_TYPE_48BITS)
+#define CMD_R6            (RSP_TYPE_48BITS | CCCE_ENABLE | CICE_ENABLE)
+#define CMD_R7            (RSP_TYPE_48BITS | CCCE_ENABLE | CICE_ENABLE)
+
+#define CMD_R1_ADTC       (CMD_R1 | DP_ENABLE)
+#define CMD_R1_ADTC_READ  (CMD_R1_ADTC | DDIR_READ)
+#define CMD_R1_ADTC_WRITE (CMD_R1_ADTC | DDIR_WRITE)
+
+#define CMD0              (INDX(0)) // Go idle
+#define CMD1              (INDX(1) | CMD_R3) // MMC: Send Op Cond
+#define CMD2              (INDX(2) | CMD_R2) // Send CID
+#define CMD3              (INDX(3) | CMD_R6) // Set Relative Addr
+#define CMD4              (INDX(4)) // Set DSR
+#define CMD5              (INDX(5) | CMD_R1B) // SDIO: Sleep/Awake
+#define CMD6              (INDX(6) | CMD_R1_ADTC_READ) // Switch
+#define CMD7              (INDX(7) | CMD_R1B) // Select/Deselect
+#define CMD8_SD           (INDX(8) | CMD_R7) // Send If Cond
+#define CMD8_SD_ARG       (0x0UL << 12 | BIT8 | 0xCEUL << 0)
+#define CMD8_MMC          (INDX(8) | CMD_R1_ADTC_READ) // Send Ext Csd
+#define CMD8_MMC_ARG      (0)
+#define CMD9              (INDX(9) | CMD_R2) // Send CSD
+#define CMD10             (INDX(10) | CMD_R2) // Send CID
+#define CMD11             (INDX(11) | CMD_R1) // Voltage Switch
+#define CMD12             (INDX_ABORT(12) | CMD_R1B) // Stop Transmission
+#define CMD13             (INDX(13) | CMD_R1) // Send Status
+#define CMD15             (INDX(15)) // Go inactive state
+#define CMD16             (INDX(16) | CMD_R1) // Set Blocklen
+#define CMD17             (INDX(17) | CMD_R1_ADTC_READ) // Read Single Block
+#define CMD18             (INDX(18) | CMD_R1_ADTC_READ | MSBS_MULTBLK) // Read Multiple Blocks
+#define CMD19             (INDX(19) | CMD_R1_ADTC_READ) // SD: Send Tuning Block (64 bytes)
+#define CMD20             (INDX(20) | CMD_R1B) // SD: Speed Class Control
+#define CMD23             (INDX(23) | CMD_R1) // Set Block Count for CMD18 and CMD25
+#define CMD24             (INDX(24) | CMD_R1_ADTC_WRITE) // Write Block
+#define CMD25             (INDX(25) | CMD_R1_ADTC_WRITE | MSBS_MULTBLK) // Write Multiple Blocks
+#define CMD55             (INDX(55) | CMD_R1) // App Cmd
+
+#define ACMD6             (INDX(6) | CMD_R1) // Set Bus Width
+#define ACMD22            (INDX(22) | CMD_R1_ADTC_READ) // SEND_NUM_WR_BLOCKS
+#define ACMD41            (INDX(41) | CMD_R3) // Send Op Cond
+#define ACMD51            (INDX(51) | CMD_R1_ADTC_READ) // Send SCR
+
+// User-friendly command names
+#define CMD_IO_SEND_OP_COND      CMD5
+#define CMD_SEND_CSD             CMD9  // CSD: Card-Specific Data
+#define CMD_STOP_TRANSMISSION    CMD12
+#define CMD_SEND_STATUS          CMD13
+#define CMD_READ_SINGLE_BLOCK    CMD17
+#define CMD_READ_MULTIPLE_BLOCK  CMD18
+#define CMD_SET_BLOCK_COUNT      CMD23
+#define CMD_WRITE_SINGLE_BLOCK   CMD24
+#define CMD_WRITE_MULTIPLE_BLOCK CMD25
+
+#endif /* __BCM2836_SDIO_H__ */
-- 
2.17.0.windows.1



^ permalink raw reply related	[flat|nested] 34+ messages in thread

* [PATCH v5 edk2-platforms 15/22] Platform/RaspberryPi/RPi3: Add SD Host driver
  2019-02-05 16:25 [PATCH v5 edk2-platforms 00/22] Platform/RaspberryPi: Add Raspberry Pi 3 support Pete Batard
                   ` (13 preceding siblings ...)
  2019-02-05 16:25 ` [PATCH v5 edk2-platforms 14/22] Platform/RaspberryPi/RPi3: Add Arasan " Pete Batard
@ 2019-02-05 16:25 ` Pete Batard
  2019-02-05 16:25 ` [PATCH v5 edk2-platforms 16/22] Platform/RaspberryPi/RPi3: Add platform boot manager and helper libs Pete Batard
                   ` (8 subsequent siblings)
  23 siblings, 0 replies; 34+ messages in thread
From: Pete Batard @ 2019-02-05 16:25 UTC (permalink / raw)
  To: edk2-devel

The BCM283x family includes two SD card controllers, the second one
being the "internal" SD HOST controller. This driver implements support
for this one.

Contributed-under: TianoCore Contribution Agreement 1.1
Signed-off-by: Pete Batard <pete@akeo.ie>
---
 Platform/RaspberryPi/RPi3/Drivers/SdHostDxe/SdHostDxe.c           | 787 ++++++++++++++++++++
 Platform/RaspberryPi/RPi3/Drivers/SdHostDxe/SdHostDxe.inf         |  55 ++
 Silicon/Broadcom/Bcm283x/Include/IndustryStandard/Bcm2836SdHost.h |  92 +++
 3 files changed, 934 insertions(+)

diff --git a/Platform/RaspberryPi/RPi3/Drivers/SdHostDxe/SdHostDxe.c b/Platform/RaspberryPi/RPi3/Drivers/SdHostDxe/SdHostDxe.c
new file mode 100644
index 000000000000..3bf789f96b27
--- /dev/null
+++ b/Platform/RaspberryPi/RPi3/Drivers/SdHostDxe/SdHostDxe.c
@@ -0,0 +1,787 @@
+/** @file
+ *
+ *  Copyright (c) 2017, Andrei Warkentin <andrey.warkentin@gmail.com>
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *
+ *  This program and the accompanying materials
+ *  are licensed and made available under the terms and conditions of the BSD License
+ *  which accompanies this distribution.  The full text of the license may be found at
+ *  http://opensource.org/licenses/bsd-license.php
+ *
+ *  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+ *  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+ *
+ **/
+
+#include <Uefi.h>
+#include <Library/BaseLib.h>
+#include <Library/MemoryAllocationLib.h>
+#include <Library/DebugLib.h>
+#include <Library/DevicePathLib.h>
+#include <Library/IoLib.h>
+#include <Library/PcdLib.h>
+#include <Library/UefiBootServicesTableLib.h>
+#include <Library/BaseMemoryLib.h>
+#include <Library/DmaLib.h>
+#include <Library/TimerLib.h>
+
+#include <Protocol/EmbeddedExternalDevice.h>
+#include <Protocol/BlockIo.h>
+#include <Protocol/DevicePath.h>
+#include <Protocol/RpiMmcHost.h>
+#include <Protocol/RpiFirmware.h>
+
+#include <IndustryStandard/Bcm2836.h>
+#include <IndustryStandard/RpiMbox.h>
+#include <IndustryStandard/Bcm2836SdHost.h>
+
+#define SDHOST_BLOCK_BYTE_LENGTH            512
+
+// Driver Timing Parameters
+#define CMD_STALL_AFTER_POLL_US             1
+#define CMD_MIN_POLL_TOTAL_TIME_US          100000 // 100ms
+#define CMD_MAX_POLL_COUNT                  (CMD_MIN_POLL_TOTAL_TIME_US / CMD_STALL_AFTER_POLL_US)
+#define CMD_MAX_RETRY_COUNT                 3
+#define CMD_STALL_AFTER_RETRY_US            20 // 20us
+#define FIFO_MAX_POLL_COUNT                 1000000
+#define STALL_TO_STABILIZE_US               10000 // 10ms
+
+#define IDENT_MODE_SD_CLOCK_FREQ_HZ         400000 // 400KHz
+
+// Macros adopted from MmcDxe internal header
+#define SDHOST_R0_READY_FOR_DATA            BIT8
+#define SDHOST_R0_CURRENTSTATE(Response)    ((Response >> 9) & 0xF)
+
+#define DEBUG_MMCHOST_SD       DEBUG_VERBOSE
+#define DEBUG_MMCHOST_SD_INFO  DEBUG_INFO
+#define DEBUG_MMCHOST_SD_ERROR DEBUG_ERROR
+
+STATIC RASPBERRY_PI_FIRMWARE_PROTOCOL   *mFwProtocol;
+
+// Per Physical Layer Simplified Specs
+#ifndef NDEBUG
+STATIC CONST CHAR8* mStrSdState[] = { "idle", "ready", "ident", "stby",
+                                      "tran", "data", "rcv", "prg", "dis",
+                                      "ina" };
+STATIC CONST CHAR8 *mFsmState[] = { "identmode", "datamode", "readdata",
+                                    "writedata", "readwait", "readcrc",
+                                    "writecrc", "writewait1", "powerdown",
+                                    "powerup", "writestart1", "writestart2",
+                                    "genpulses", "writewait2", "?",
+                                    "startpowdown" };
+#endif /* NDEBUG */
+STATIC UINT32 mLastGoodCmd = MMC_GET_INDX (MMC_CMD0);
+
+STATIC inline BOOLEAN
+IsAppCmd (
+  VOID
+  )
+{
+  return mLastGoodCmd == MMC_CMD55;
+}
+
+STATIC BOOLEAN
+IsBusyCmd (
+  IN  UINT32 MmcCmd
+  )
+{
+  if (IsAppCmd ()) {
+    return FALSE;
+  }
+
+  return MmcCmd == MMC_CMD7 || MmcCmd == MMC_CMD12;
+}
+
+STATIC BOOLEAN
+IsWriteCmd (
+  IN  UINT32 MmcCmd
+  )
+{
+  if (IsAppCmd ()) {
+    return FALSE;
+  }
+
+  return MmcCmd == MMC_CMD24 || MmcCmd == MMC_CMD25;
+}
+
+STATIC BOOLEAN
+IsReadCmd (
+  IN  UINT32 MmcCmd,
+  IN  UINT32 Argument
+  )
+{
+  if (MmcCmd == MMC_CMD8 && !IsAppCmd ()) {
+    if (Argument == CMD8_MMC_ARG) {
+      DEBUG ((DEBUG_MMCHOST_SD, "Sending MMC CMD8 variant\n"));
+      return TRUE;
+    } else {
+      ASSERT (Argument == CMD8_SD_ARG);
+      DEBUG ((DEBUG_MMCHOST_SD, "Sending SD CMD8 variant\n"));
+      return FALSE;
+    }
+  }
+
+  return
+    (MmcCmd == MMC_CMD6 && !IsAppCmd ()) ||
+    (MmcCmd == MMC_CMD17 && !IsAppCmd ()) ||
+    (MmcCmd == MMC_CMD18 && !IsAppCmd ()) ||
+    (MmcCmd == MMC_CMD13 && IsAppCmd ()) ||
+    (MmcCmd == MMC_ACMD22 && IsAppCmd ()) ||
+    (MmcCmd == MMC_ACMD51 && IsAppCmd ());
+}
+
+STATIC VOID
+SdHostDumpRegisters (
+  VOID
+  )
+{
+  DEBUG ((DEBUG_MMCHOST_SD, "SdHost: Registers Dump:\n"));
+  DEBUG ((DEBUG_MMCHOST_SD, "  CMD:  0x%8.8X\n", MmioRead32 (SDHOST_CMD)));
+  DEBUG ((DEBUG_MMCHOST_SD, "  ARG:  0x%8.8X\n", MmioRead32 (SDHOST_ARG)));
+  DEBUG ((DEBUG_MMCHOST_SD, "  TOUT: 0x%8.8X\n", MmioRead32 (SDHOST_TOUT)));
+  DEBUG ((DEBUG_MMCHOST_SD, "  CDIV: 0x%8.8X\n", MmioRead32 (SDHOST_CDIV)));
+  DEBUG ((DEBUG_MMCHOST_SD, "  RSP0: 0x%8.8X\n", MmioRead32 (SDHOST_RSP0)));
+  DEBUG ((DEBUG_MMCHOST_SD, "  RSP1: 0x%8.8X\n", MmioRead32 (SDHOST_RSP1)));
+  DEBUG ((DEBUG_MMCHOST_SD, "  RSP2: 0x%8.8X\n", MmioRead32 (SDHOST_RSP2)));
+  DEBUG ((DEBUG_MMCHOST_SD, "  RSP3: 0x%8.8X\n", MmioRead32 (SDHOST_RSP3)));
+  DEBUG ((DEBUG_MMCHOST_SD, "  HSTS: 0x%8.8X\n", MmioRead32 (SDHOST_HSTS)));
+  DEBUG ((DEBUG_MMCHOST_SD, "  VDD:  0x%8.8X\n", MmioRead32 (SDHOST_VDD)));
+  DEBUG ((DEBUG_MMCHOST_SD, "  EDM:  0x%8.8X\n", MmioRead32 (SDHOST_EDM)));
+  DEBUG ((DEBUG_MMCHOST_SD, "  HCFG: 0x%8.8X\n", MmioRead32 (SDHOST_HCFG)));
+  DEBUG ((DEBUG_MMCHOST_SD, "  HBCT: 0x%8.8X\n", MmioRead32 (SDHOST_HBCT)));
+  DEBUG ((DEBUG_MMCHOST_SD, "  HBLC: 0x%8.8X\n\n", MmioRead32 (SDHOST_HBLC)));
+}
+
+#ifndef NDEBUG
+STATIC EFI_STATUS
+SdHostGetSdStatus (
+  UINT32* SdStatus
+  )
+{
+  ASSERT (SdStatus != NULL);
+
+  // On command completion with R1 or R1b response type
+  // the SDCard status will be in RSP0
+  UINT32 Rsp0 = MmioRead32 (SDHOST_RSP0);
+  if (Rsp0 != 0xFFFFFFFF) {
+    *SdStatus = Rsp0;
+    return EFI_SUCCESS;
+  }
+
+  return EFI_NO_RESPONSE;
+}
+#endif /* NDEBUG */
+
+STATIC VOID
+SdHostDumpSdCardStatus (
+  VOID
+  )
+{
+#ifndef NDEBUG
+  UINT32 SdCardStatus;
+  EFI_STATUS Status = SdHostGetSdStatus (&SdCardStatus);
+  if (!EFI_ERROR (Status)) {
+    UINT32 CurrState = SDHOST_R0_CURRENTSTATE (SdCardStatus);
+    DEBUG ((DEBUG_MMCHOST_SD,
+      "SdHost: SdCardStatus 0x%8.8X: ReadyForData?%d, State[%d]: %a\n",
+      SdCardStatus,
+      ((SdCardStatus & SDHOST_R0_READY_FOR_DATA) ? 1 : 0),
+      CurrState,
+      ((CurrState < (sizeof (mStrSdState) / sizeof (*mStrSdState))) ?
+        mStrSdState[CurrState] : "UNDEF")));
+  }
+#endif /* NDEBUG */
+}
+
+STATIC VOID
+SdHostDumpStatus (
+  VOID
+  )
+{
+  SdHostDumpRegisters ();
+
+#ifndef NDEBUG
+  UINT32 Hsts = MmioRead32 (SDHOST_HSTS);
+
+  if (Hsts & SDHOST_HSTS_ERROR) {
+    DEBUG ((DEBUG_MMCHOST_SD_ERROR, "SdHost: Diagnose HSTS: 0x%8.8X\n", Hsts));
+
+    DEBUG ((DEBUG_MMCHOST_SD_ERROR, "SdHost: Last Good CMD = %u\n", MMC_GET_INDX (mLastGoodCmd)));
+    if (Hsts & SDHOST_HSTS_FIFO_ERROR)
+      DEBUG ((DEBUG_MMCHOST_SD_ERROR, "  - Fifo Error\n"));
+    if (Hsts & SDHOST_HSTS_CRC7_ERROR)
+      DEBUG ((DEBUG_MMCHOST_SD_ERROR, "  - CRC7 Error\n"));
+    if (Hsts & SDHOST_HSTS_CRC16_ERROR)
+      DEBUG ((DEBUG_MMCHOST_SD_ERROR, "  - CRC16 Error\n"));
+    if (Hsts & SDHOST_HSTS_CMD_TIME_OUT)
+      DEBUG ((DEBUG_MMCHOST_SD_ERROR, "  - CMD Timeout (TOUT %x)\n", MmioRead32 (SDHOST_TOUT)));
+    if (Hsts & SDHOST_HSTS_REW_TIME_OUT)
+      DEBUG ((DEBUG_MMCHOST_SD_ERROR, "  - Read/Erase/Write Transfer Timeout\n"));
+  }
+
+  UINT32 Edm = MmioRead32 (SDHOST_EDM);
+  DEBUG (((Hsts & SDHOST_HSTS_ERROR) ? DEBUG_MMCHOST_SD_ERROR : DEBUG_MMCHOST_SD,
+    "SdHost: Diagnose EDM: 0x%8.8X\n", Edm));
+  DEBUG (((Hsts & SDHOST_HSTS_ERROR) ? DEBUG_MMCHOST_SD_ERROR : DEBUG_MMCHOST_SD,
+    "  - FSM: 0x%x (%a)\n", (Edm & 0xF), mFsmState[Edm & 0xF]));
+  DEBUG (((Hsts & SDHOST_HSTS_ERROR) ? DEBUG_MMCHOST_SD_ERROR : DEBUG_MMCHOST_SD,
+    "  - Fifo Count: %d\n", ((Edm >> 4) & 0x1F)));
+  DEBUG (((Hsts & SDHOST_HSTS_ERROR) ? DEBUG_MMCHOST_SD_ERROR : DEBUG_MMCHOST_SD,
+    "  - Fifo Write Threshold: %d\n",
+    ((Edm >> SDHOST_EDM_WRITE_THRESHOLD_SHIFT) & SDHOST_EDM_THRESHOLD_MASK)));
+  DEBUG (((Hsts & SDHOST_HSTS_ERROR) ? DEBUG_MMCHOST_SD_ERROR : DEBUG_MMCHOST_SD,
+     "  - Fifo Read Threshold: %d\n",
+    ((Edm >> SDHOST_EDM_READ_THRESHOLD_SHIFT) & SDHOST_EDM_THRESHOLD_MASK)));
+#endif
+
+  SdHostDumpSdCardStatus ();
+}
+
+STATIC EFI_STATUS
+SdHostSetClockFrequency (
+  IN UINTN TargetSdFreqHz
+  )
+{
+  EFI_STATUS Status;
+  UINT32 CoreClockFreqHz = 0;
+
+  // First figure out the core clock
+  Status = mFwProtocol->GetClockRate (RPI_MBOX_CLOCK_RATE_CORE, &CoreClockFreqHz);
+  if (EFI_ERROR (Status)) {
+    return Status;
+  }
+
+  ASSERT (CoreClockFreqHz != 0);
+
+  // fSDCLK = fcore_pclk/(ClockDiv+2)
+  UINT32 ClockDiv = (CoreClockFreqHz - (2 * TargetSdFreqHz)) / TargetSdFreqHz;
+  UINT32 ActualSdFreqHz = CoreClockFreqHz / (ClockDiv + 2);
+
+  DEBUG ((DEBUG_MMCHOST_SD_INFO,
+    "SdHost: CoreClock=%dHz, CDIV=%d, Requested SdClock=%dHz, Actual SdClock=%dHz\n",
+    CoreClockFreqHz, ClockDiv, TargetSdFreqHz, ActualSdFreqHz));
+
+  MmioWrite32 (SDHOST_CDIV, ClockDiv);
+  // Set timeout after 1 second, i.e ActualSdFreqHz SD clock cycles
+  MmioWrite32 (SDHOST_TOUT, ActualSdFreqHz);
+
+  gBS->Stall (STALL_TO_STABILIZE_US);
+
+  return Status;
+}
+
+STATIC BOOLEAN
+SdIsCardPresent (
+  IN EFI_MMC_HOST_PROTOCOL *This
+  )
+{
+  return TRUE;
+}
+
+STATIC BOOLEAN
+SdIsReadOnly (
+  IN EFI_MMC_HOST_PROTOCOL *This
+  )
+{
+  return FALSE;
+}
+
+STATIC EFI_STATUS
+SdBuildDevicePath (
+  IN EFI_MMC_HOST_PROTOCOL       *This,
+  IN EFI_DEVICE_PATH_PROTOCOL    **DevicePath
+  )
+{
+  EFI_DEVICE_PATH_PROTOCOL *NewDevicePathNode;
+  EFI_GUID DevicePathGuid = EFI_CALLER_ID_GUID;
+
+  DEBUG ((DEBUG_MMCHOST_SD, "SdHost: SdBuildDevicePath()\n"));
+
+  NewDevicePathNode = CreateDeviceNode (HARDWARE_DEVICE_PATH, HW_VENDOR_DP, sizeof (VENDOR_DEVICE_PATH));
+  CopyGuid (&((VENDOR_DEVICE_PATH*)NewDevicePathNode)->Guid, &DevicePathGuid);
+  *DevicePath = NewDevicePathNode;
+
+  return EFI_SUCCESS;
+}
+
+STATIC EFI_STATUS
+SdSendCommand (
+  IN EFI_MMC_HOST_PROTOCOL    *This,
+  IN MMC_CMD                  MmcCmd,
+  IN UINT32                   Argument
+  )
+{
+  UINT32 Hsts;
+
+  //
+  // Fail fast, CMD5 (CMD_IO_SEND_OP_COND)
+  // is only valid for SDIO cards and thus
+  // expected to always fail.
+  //
+  if (MmcCmd == MMC_CMD5) {
+    DEBUG ((DEBUG_MMCHOST_SD, "SdHost: SdSendCommand(CMD%d, Argument: %08x) ignored\n",
+      MMC_GET_INDX (MmcCmd), Argument));
+    return EFI_UNSUPPORTED;
+  }
+
+  if (MmioRead32 (SDHOST_CMD) & SDHOST_CMD_NEW_FLAG) {
+    DEBUG ((DEBUG_MMCHOST_SD_ERROR,
+      "SdHost: SdSendCommand(): Failed to execute CMD%d, a CMD is already being executed.\n",
+      MMC_GET_INDX (MmcCmd)));
+    SdHostDumpStatus ();
+    return EFI_DEVICE_ERROR;
+  }
+
+  // Write command argument
+  MmioWrite32 (SDHOST_ARG, Argument);
+
+  UINT32 SdCmd = 0;
+  {
+    // Set response type
+    if (MmcCmd & MMC_CMD_WAIT_RESPONSE) {
+      if (MmcCmd & MMC_CMD_LONG_RESPONSE) {
+        SdCmd |= SDHOST_CMD_RESPONSE_CMD_LONG_RESP;
+      }
+    } else {
+      SdCmd |= SDHOST_CMD_RESPONSE_CMD_NO_RESP;
+    }
+
+    if (IsBusyCmd (MmcCmd)) {
+      SdCmd |= SDHOST_CMD_BUSY_CMD;
+    }
+
+    if (IsReadCmd (MmcCmd, Argument)) {
+      SdCmd |= SDHOST_CMD_READ_CMD;
+    }
+
+    if (IsWriteCmd (MmcCmd)) {
+      SdCmd |= SDHOST_CMD_WRITE_CMD;
+    }
+
+    SdCmd |= MMC_GET_INDX (MmcCmd);
+  }
+
+  if (IsReadCmd (MmcCmd, Argument) || IsWriteCmd (MmcCmd)) {
+    if (IsAppCmd () && MmcCmd == MMC_ACMD22) {
+      MmioWrite32 (SDHOST_HBCT, 0x4);
+    } else if (IsAppCmd () && MmcCmd == MMC_ACMD51) {
+      MmioWrite32 (SDHOST_HBCT, 0x8);
+    } else if (!IsAppCmd () && MmcCmd == MMC_CMD6) {
+      MmioWrite32 (SDHOST_HBCT, 0x40);
+    } else {
+      MmioWrite32 (SDHOST_HBCT, SDHOST_BLOCK_BYTE_LENGTH);
+    }
+  }
+
+  DEBUG ((DEBUG_MMCHOST_SD,
+    "SdHost: SdSendCommand(CMD%d, Argument: %08x): BUSY=%d, RESP=%d, WRITE=%d, READ=%d\n",
+    MMC_GET_INDX (MmcCmd), Argument, ((SdCmd & SDHOST_CMD_BUSY_CMD) ? 1 : 0),
+    ((SdCmd & (SDHOST_CMD_RESPONSE_CMD_LONG_RESP | SDHOST_CMD_RESPONSE_CMD_NO_RESP)) >> 9),
+    ((SdCmd & SDHOST_CMD_WRITE_CMD) ? 1 : 0), ((SdCmd & SDHOST_CMD_READ_CMD) ? 1 : 0)));
+
+  UINT32 PollCount = 0;
+  UINT32 RetryCount = 0;
+  BOOLEAN IsCmdExecuted = FALSE;
+  EFI_STATUS Status = EFI_SUCCESS;
+
+  // Keep retrying the command until it succeeds.
+  while ((RetryCount < CMD_MAX_RETRY_COUNT) && !IsCmdExecuted) {
+    Status = EFI_SUCCESS;
+
+    // Clear prev cmd status
+    MmioWrite32 (SDHOST_HSTS, SDHOST_HSTS_CLEAR);
+
+    if (IsReadCmd (MmcCmd, Argument) || IsWriteCmd (MmcCmd)) {
+      // Flush Fifo if this cmd will start a new transfer in case
+      // there is stale bytes in the Fifo
+      MmioOr32 (SDHOST_EDM, SDHOST_EDM_FIFO_CLEAR);
+    }
+
+    if (MmioRead32 (SDHOST_CMD) & SDHOST_CMD_NEW_FLAG) {
+      DEBUG ((DEBUG_MMCHOST_SD_ERROR,
+        "%a(%u): CMD%d is still being executed after %d trial(s)\n",
+        __FUNCTION__, __LINE__, MMC_GET_INDX (MmcCmd), RetryCount));
+    }
+
+    // Write command and set it to start execution
+    MmioWrite32 (SDHOST_CMD, SDHOST_CMD_NEW_FLAG | SdCmd);
+
+    // Poll for the command status until it finishes execution
+    while (PollCount < CMD_MAX_POLL_COUNT) {
+      UINT32 CmdReg = MmioRead32 (SDHOST_CMD);
+
+      // Read status of command response
+      if (CmdReg & SDHOST_CMD_FAIL_FLAG) {
+        Status = EFI_DEVICE_ERROR;
+        /*
+         * Must fall-through and wait for the command completion!
+         */
+      }
+
+      // Check if command is completed.
+      if (!(CmdReg & SDHOST_CMD_NEW_FLAG)) {
+        IsCmdExecuted = TRUE;
+        break;
+      }
+
+      ++PollCount;
+      gBS->Stall (CMD_STALL_AFTER_POLL_US);
+    }
+
+    if (!IsCmdExecuted) {
+      ++RetryCount;
+      gBS->Stall (CMD_STALL_AFTER_RETRY_US);
+    }
+  }
+
+  if (RetryCount == CMD_MAX_RETRY_COUNT) {
+    Status = EFI_TIMEOUT;
+  }
+
+  Hsts = MmioRead32 (SDHOST_HSTS);
+  if (EFI_ERROR (Status) ||
+    (Hsts & SDHOST_HSTS_ERROR) != 0) {
+    if (MmcCmd == MMC_CMD1 && (Hsts & SDHOST_HSTS_CRC7_ERROR) != 0) {
+      /*
+       * SdHost seems to have no way to specify
+       * R3 as a transfer type.
+       */
+      IsCmdExecuted = TRUE;
+      Status = EFI_SUCCESS;
+      MmioWrite32 (SDHOST_HSTS, SDHOST_HSTS_CLEAR);
+    } else if (MmcCmd == MMC_CMD7 && Argument == 0) {
+      /*
+       * Deselecting the SDCard with CMD7 and RCA=0x0
+       * always timeout on SDHost.
+       */
+      Status = EFI_SUCCESS;
+    } else {
+      DEBUG ((DEBUG_MMCHOST_SD_ERROR, "%a(%u): CMD%d execution failed after %d trial(s)\n",
+        __FUNCTION__, __LINE__, MMC_GET_INDX (MmcCmd), RetryCount));
+      SdHostDumpStatus ();
+    }
+
+    MmioWrite32 (SDHOST_HSTS, SDHOST_HSTS_CLEAR);
+  }
+
+  if (IsCmdExecuted && !EFI_ERROR (Status)) {
+    ASSERT (!(MmioRead32 (SDHOST_HSTS) & SDHOST_HSTS_ERROR));
+    mLastGoodCmd = MmcCmd;
+  }
+
+  return Status;
+}
+
+STATIC EFI_STATUS
+SdReceiveResponse (
+  IN EFI_MMC_HOST_PROTOCOL    *This,
+  IN MMC_RESPONSE_TYPE        Type,
+  IN UINT32*                  Buffer
+  )
+{
+  if (Buffer == NULL) {
+    DEBUG ((DEBUG_MMCHOST_SD_ERROR, "SdHost: SdReceiveResponse(): Input Buffer is NULL\n"));
+    return EFI_INVALID_PARAMETER;
+  }
+
+  if ((Type == MMC_RESPONSE_TYPE_R1) ||
+    (Type == MMC_RESPONSE_TYPE_R1b) ||
+    (Type == MMC_RESPONSE_TYPE_R3) ||
+    (Type == MMC_RESPONSE_TYPE_R6) ||
+    (Type == MMC_RESPONSE_TYPE_R7)) {
+    Buffer[0] = MmioRead32 (SDHOST_RSP0);
+    DEBUG ((DEBUG_MMCHOST_SD, "SdHost: SdReceiveResponse(Type: %x), Buffer[0]: %08x\n",
+      Type, Buffer[0]));
+
+  } else if (Type == MMC_RESPONSE_TYPE_R2) {
+    Buffer[0] = MmioRead32 (SDHOST_RSP0);
+    Buffer[1] = MmioRead32 (SDHOST_RSP1);
+    Buffer[2] = MmioRead32 (SDHOST_RSP2);
+    Buffer[3] = MmioRead32 (SDHOST_RSP3);
+
+    DEBUG ((DEBUG_MMCHOST_SD,
+      "SdHost: SdReceiveResponse(Type: %x), Buffer[0-3]: %08x, %08x, %08x, %08x\n",
+      Type, Buffer[0], Buffer[1], Buffer[2], Buffer[3]));
+  }
+
+  return EFI_SUCCESS;
+}
+
+STATIC EFI_STATUS
+SdReadBlockData (
+  IN EFI_MMC_HOST_PROTOCOL    *This,
+  IN EFI_LBA                  Lba,
+  IN UINTN                    Length,
+  IN UINT32*                  Buffer
+  )
+{
+  DEBUG ((DEBUG_MMCHOST_SD, "SdHost: SdReadBlockData(LBA: 0x%x, Length: 0x%x, Buffer: 0x%x)\n",
+    (UINT32)Lba, Length, Buffer));
+
+  ASSERT (Buffer != NULL);
+  ASSERT (Length % 4 == 0);
+
+  EFI_STATUS Status = EFI_SUCCESS;
+
+  mFwProtocol->SetLed (TRUE);
+  {
+    UINT32 NumWords = Length / 4;
+    UINT32 WordIdx;
+
+    for (WordIdx = 0; WordIdx < NumWords; ++WordIdx) {
+      UINT32 PollCount = 0;
+      while (PollCount < FIFO_MAX_POLL_COUNT) {
+        UINT32 Hsts = MmioRead32 (SDHOST_HSTS);
+        if ((Hsts & SDHOST_HSTS_DATA_FLAG) != 0) {
+          MmioWrite32 (SDHOST_HSTS, SDHOST_HSTS_DATA_FLAG);
+          Buffer[WordIdx] = MmioRead32 (SDHOST_DATA);
+          break;
+        }
+
+        ++PollCount;
+        gBS->Stall (CMD_STALL_AFTER_RETRY_US);
+      }
+
+      if (PollCount == FIFO_MAX_POLL_COUNT) {
+        DEBUG ((DEBUG_MMCHOST_SD_ERROR,
+            "SdHost: SdReadBlockData(): Block Word%d read poll timed-out\n", WordIdx));
+        SdHostDumpStatus ();
+        MmioWrite32 (SDHOST_HSTS, SDHOST_HSTS_CLEAR);
+        Status = EFI_TIMEOUT;
+        break;
+      }
+    }
+  }
+  mFwProtocol->SetLed (FALSE);
+
+  return Status;
+}
+
+STATIC EFI_STATUS
+SdWriteBlockData (
+  IN EFI_MMC_HOST_PROTOCOL    *This,
+  IN EFI_LBA                  Lba,
+  IN UINTN                    Length,
+  IN UINT32*                  Buffer
+  )
+{
+  DEBUG ((DEBUG_MMCHOST_SD,
+    "SdHost: SdWriteBlockData(LBA: 0x%x, Length: 0x%x, Buffer: 0x%x)\n",
+    (UINT32)Lba, Length, Buffer));
+
+  ASSERT (Buffer != NULL);
+  ASSERT (Length % SDHOST_BLOCK_BYTE_LENGTH == 0);
+
+  EFI_STATUS Status = EFI_SUCCESS;
+
+  mFwProtocol->SetLed (TRUE);
+  {
+    UINT32 NumWords = Length / 4;
+    UINT32 WordIdx;
+
+    for (WordIdx = 0; WordIdx < NumWords; ++WordIdx) {
+      UINT32 PollCount = 0;
+      while (PollCount < FIFO_MAX_POLL_COUNT) {
+        if (MmioRead32 (SDHOST_HSTS) & SDHOST_HSTS_DATA_FLAG) {
+          MmioWrite32 (SDHOST_HSTS, SDHOST_HSTS_DATA_FLAG);
+          MmioWrite32 (SDHOST_DATA, Buffer[WordIdx]);
+          break;
+        }
+
+        ++PollCount;
+        gBS->Stall (CMD_STALL_AFTER_RETRY_US);
+      }
+
+      if (PollCount == FIFO_MAX_POLL_COUNT) {
+        DEBUG ((DEBUG_MMCHOST_SD_ERROR,
+          "SdHost: SdWriteBlockData(): Block Word%d write poll timed-out\n", WordIdx));
+        SdHostDumpStatus ();
+        MmioWrite32 (SDHOST_HSTS, SDHOST_HSTS_CLEAR);
+        Status = EFI_TIMEOUT;
+        break;
+      }
+    }
+  }
+  mFwProtocol->SetLed (FALSE);
+
+  return Status;
+}
+
+STATIC EFI_STATUS
+SdSetIos (
+  IN EFI_MMC_HOST_PROTOCOL      *This,
+  IN  UINT32                    BusClockFreq,
+  IN  UINT32                    BusWidth,
+  IN  UINT32                    TimingMode
+  )
+{
+  if (BusWidth != 0) {
+    UINT32 Hcfg = MmioRead32 (SDHOST_HCFG);
+
+    DEBUG ((DEBUG_MMCHOST_SD_INFO, "Setting BusWidth %u\n", BusWidth));
+    if (BusWidth == 4) {
+      Hcfg |= SDHOST_HCFG_WIDE_EXT_BUS;
+    } else {
+      Hcfg &= ~SDHOST_HCFG_WIDE_EXT_BUS;
+    }
+
+    Hcfg |= SDHOST_HCFG_WIDE_INT_BUS | SDHOST_HCFG_SLOW_CARD;
+    MmioWrite32 (SDHOST_HCFG, Hcfg);
+  }
+
+  if (BusClockFreq != 0) {
+    DEBUG ((DEBUG_MMCHOST_SD_INFO, "Setting Freq %u Hz\n", BusClockFreq));
+    SdHostSetClockFrequency (BusClockFreq);
+  }
+
+  return EFI_SUCCESS;
+}
+
+STATIC EFI_STATUS
+SdNotifyState (
+  IN EFI_MMC_HOST_PROTOCOL    *This,
+  IN MMC_STATE                State
+  )
+{
+  DEBUG ((DEBUG_MMCHOST_SD, "SdHost: SdNotifyState(State: %d) ", State));
+
+  switch (State) {
+  case MmcHwInitializationState:
+    DEBUG ((DEBUG_MMCHOST_SD, "MmcHwInitializationState\n", State));
+
+    // Turn-off SD Card power
+    MmioWrite32 (SDHOST_VDD, 0);
+
+    // Reset command and arg
+    MmioWrite32 (SDHOST_CMD, 0);
+    MmioWrite32 (SDHOST_ARG, 0);
+    // Reset clock divider
+    MmioWrite32 (SDHOST_CDIV, 0);
+    // Default timeout
+    MmioWrite32 (SDHOST_TOUT, 0xffffffff);
+    // Clear status flags
+    MmioWrite32 (SDHOST_HSTS, SDHOST_HSTS_CLEAR);;
+    // Reset controller configs
+    MmioWrite32 (SDHOST_HCFG, 0);
+    MmioWrite32 (SDHOST_HBCT, 0);
+    MmioWrite32 (SDHOST_HBLC, 0);
+
+    gBS->Stall (STALL_TO_STABILIZE_US);
+
+    // Turn-on SD Card power
+    MmioWrite32 (SDHOST_VDD, 1);
+
+    gBS->Stall (STALL_TO_STABILIZE_US);
+
+    // Write controller configs
+    UINT32 Hcfg = 0;
+    Hcfg |= SDHOST_HCFG_WIDE_INT_BUS;
+    Hcfg |= SDHOST_HCFG_SLOW_CARD; // Use all bits of CDIV in DataMode
+    MmioWrite32 (SDHOST_HCFG, Hcfg);
+
+    // Set default clock frequency
+    EFI_STATUS Status = SdHostSetClockFrequency (IDENT_MODE_SD_CLOCK_FREQ_HZ);
+    if (EFI_ERROR (Status)) {
+      DEBUG ((DEBUG_MMCHOST_SD_ERROR,
+        "SdHost: SdNotifyState(): Fail to initialize SD clock to %dHz\n",
+        IDENT_MODE_SD_CLOCK_FREQ_HZ));
+      SdHostDumpStatus ();
+      return Status;
+    }
+    break;
+  case MmcIdleState:
+    DEBUG ((DEBUG_MMCHOST_SD, "MmcIdleState\n", State));
+    break;
+  case MmcReadyState:
+    DEBUG ((DEBUG_MMCHOST_SD, "MmcReadyState\n", State));
+    break;
+  case MmcIdentificationState:
+    DEBUG ((DEBUG_MMCHOST_SD, "MmcIdentificationState\n", State));
+    break;
+  case MmcStandByState:
+    DEBUG ((DEBUG_MMCHOST_SD, "MmcStandByState\n", State));
+    break;
+  case MmcTransferState:
+    DEBUG ((DEBUG_MMCHOST_SD, "MmcTransferState\n", State));
+    break;
+    break;
+  case MmcSendingDataState:
+    DEBUG ((DEBUG_MMCHOST_SD, "MmcSendingDataState\n", State));
+    break;
+  case MmcReceiveDataState:
+    DEBUG ((DEBUG_MMCHOST_SD, "MmcReceiveDataState\n", State));
+    break;
+  case MmcProgrammingState:
+    DEBUG ((DEBUG_MMCHOST_SD, "MmcProgrammingState\n", State));
+    break;
+  case MmcDisconnectState:
+  case MmcInvalidState:
+  default:
+    DEBUG ((DEBUG_MMCHOST_SD_ERROR, "SdHost: SdNotifyState(): Invalid State: %d\n", State));
+    ASSERT (0);
+  }
+
+  return EFI_SUCCESS;
+}
+
+BOOLEAN
+SdIsMultiBlock (
+  IN EFI_MMC_HOST_PROTOCOL *This
+  )
+{
+  return TRUE;
+}
+
+EFI_MMC_HOST_PROTOCOL gMmcHost =
+  {
+    MMC_HOST_PROTOCOL_REVISION,
+    SdIsCardPresent,
+    SdIsReadOnly,
+    SdBuildDevicePath,
+    SdNotifyState,
+    SdSendCommand,
+    SdReceiveResponse,
+    SdReadBlockData,
+    SdWriteBlockData,
+    SdSetIos,
+    SdIsMultiBlock
+  };
+
+EFI_STATUS
+SdHostInitialize (
+  IN EFI_HANDLE          ImageHandle,
+  IN EFI_SYSTEM_TABLE    *SystemTable
+  )
+{
+  EFI_STATUS Status;
+  EFI_HANDLE Handle = NULL;
+
+  if (PcdGet32 (PcdSdIsArasan)) {
+    DEBUG ((DEBUG_INFO, "SD is not routed to SdHost\n"));
+    return EFI_REQUEST_UNLOAD_IMAGE;
+  }
+
+  Status = gBS->LocateProtocol (&gRaspberryPiFirmwareProtocolGuid, NULL, (VOID**)&mFwProtocol);
+  ASSERT_EFI_ERROR (Status);
+  if (EFI_ERROR (Status)) {
+    return Status;
+  }
+
+  DEBUG ((DEBUG_MMCHOST_SD, "SdHost: Initialize\n"));
+  DEBUG ((DEBUG_MMCHOST_SD, "Config:\n"));
+  DEBUG ((DEBUG_MMCHOST_SD, " - FIFO_MAX_POLL_COUNT=%d\n", FIFO_MAX_POLL_COUNT));
+  DEBUG ((DEBUG_MMCHOST_SD, " - CMD_STALL_AFTER_POLL_US=%dus\n", CMD_STALL_AFTER_POLL_US));
+  DEBUG ((DEBUG_MMCHOST_SD, " - CMD_MIN_POLL_TOTAL_TIME_US=%dms\n", CMD_MIN_POLL_TOTAL_TIME_US / 1000));
+  DEBUG ((DEBUG_MMCHOST_SD, " - CMD_MAX_POLL_COUNT=%d\n", CMD_MAX_POLL_COUNT));
+  DEBUG ((DEBUG_MMCHOST_SD, " - CMD_MAX_RETRY_COUNT=%d\n", CMD_MAX_RETRY_COUNT));
+  DEBUG ((DEBUG_MMCHOST_SD, " - CMD_STALL_AFTER_RETRY_US=%dus\n", CMD_STALL_AFTER_RETRY_US));
+
+  Status = gBS->InstallMultipleProtocolInterfaces (
+    &Handle,
+    &gRaspberryPiMmcHostProtocolGuid,
+    &gMmcHost,
+    NULL
+  );
+  ASSERT_EFI_ERROR (Status);
+  return Status;
+}
diff --git a/Platform/RaspberryPi/RPi3/Drivers/SdHostDxe/SdHostDxe.inf b/Platform/RaspberryPi/RPi3/Drivers/SdHostDxe/SdHostDxe.inf
new file mode 100644
index 000000000000..49d25a84154a
--- /dev/null
+++ b/Platform/RaspberryPi/RPi3/Drivers/SdHostDxe/SdHostDxe.inf
@@ -0,0 +1,55 @@
+#/** @file
+#
+#  Copyright (c) 2017, Andrei Warkentin <andrey.warkentin@gmail.com>
+#  Copyright (c) Microsoft Corporation. All rights reserved.
+#
+#  This program and the accompanying materials
+#  are licensed and made available under the terms and conditions of the BSD License
+#  which accompanies this distribution.  The full text of the license may be found at
+#  http://opensource.org/licenses/bsd-license.php
+#
+#  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+#  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+#
+#**/
+
+[Defines]
+  INF_VERSION                    = 0x0001001A
+  BASE_NAME                      = SdHost
+  FILE_GUID                      = 58ABD787-F64D-4CA2-A034-B9AC2D5AD0CF
+  MODULE_TYPE                    = DXE_DRIVER
+  VERSION_STRING                 = 1.0
+
+  ENTRY_POINT                    = SdHostInitialize
+
+
+[Sources.common]
+  SdHostDxe.c
+
+[Packages]
+  ArmPkg/ArmPkg.dec
+  MdePkg/MdePkg.dec
+  EmbeddedPkg/EmbeddedPkg.dec
+  Silicon/Broadcom/Bcm283x/Bcm283x.dec
+  Platform/RaspberryPi/RPi3/RPi3.dec
+
+[LibraryClasses]
+  PcdLib
+  UefiLib
+  UefiDriverEntryPoint
+  MemoryAllocationLib
+  IoLib
+  DmaLib
+  CacheMaintenanceLib
+
+[Guids]
+
+[Protocols]
+  gRaspberryPiMmcHostProtocolGuid ## PRODUCES
+  gRaspberryPiFirmwareProtocolGuid ## CONSUMES
+
+[Pcd]
+  gRaspberryPiTokenSpaceGuid.PcdSdIsArasan
+
+[Depex]
+  gRaspberryPiFirmwareProtocolGuid AND gRaspberryPiConfigAppliedProtocolGuid
diff --git a/Silicon/Broadcom/Bcm283x/Include/IndustryStandard/Bcm2836SdHost.h b/Silicon/Broadcom/Bcm283x/Include/IndustryStandard/Bcm2836SdHost.h
new file mode 100644
index 000000000000..1841cc285751
--- /dev/null
+++ b/Silicon/Broadcom/Bcm283x/Include/IndustryStandard/Bcm2836SdHost.h
@@ -0,0 +1,92 @@
+/** @file
+ *
+ *  Copyright (c) 2017, Andrei Warkentin <andrey.warkentin@gmail.com>
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *
+ *  This program and the accompanying materials
+ *  are licensed and made available under the terms and conditions of the BSD License
+ *  which accompanies this distribution.  The full text of the license may be found at
+ *  http://opensource.org/licenses/bsd-license.php
+ *
+ *  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+ *  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+ *
+ **/
+
+#ifndef __BCM2836_SDHOST_H__
+#define __BCM2836_SDHOST_H__
+
+#define SDHOST_BASE_ADDRESS         (BCM2836_SOC_REGISTERS + 0x00202000)
+#define SDHOST_REG(X)               (SDHOST_BASE_ADDRESS + (X))
+#define SDHOST_CMD                  SDHOST_REG(0x0)
+#define SDHOST_ARG                  SDHOST_REG(0x4)
+#define SDHOST_TOUT                 SDHOST_REG(0x8)
+#define SDHOST_CDIV                 SDHOST_REG(0xC)
+#define SDHOST_RSP0                 SDHOST_REG(0x10) // [31:0]
+#define SDHOST_RSP1                 SDHOST_REG(0x14) // [63:32]
+#define SDHOST_RSP2                 SDHOST_REG(0x18) // [95:64]
+#define SDHOST_RSP3                 SDHOST_REG(0x1C) // [127:96]
+#define SDHOST_HSTS                 SDHOST_REG(0x20)
+#define SDHOST_VDD                  SDHOST_REG(0x30)
+#define SDHOST_EDM                  SDHOST_REG(0x34)
+#define SDHOST_HCFG                 SDHOST_REG(0x38)
+#define SDHOST_HBCT                 SDHOST_REG(0x3C)
+#define SDHOST_DATA                 SDHOST_REG(0x40)
+#define SDHOST_HBLC                 SDHOST_REG(0x50)
+
+//
+// CMD
+//
+#define SDHOST_CMD_READ_CMD                     BIT6
+#define SDHOST_CMD_WRITE_CMD                    BIT7
+#define SDHOST_CMD_RESPONSE_CMD_LONG_RESP       BIT9
+#define SDHOST_CMD_RESPONSE_CMD_NO_RESP         BIT10
+#define SDHOST_CMD_BUSY_CMD                     BIT11
+#define SDHOST_CMD_FAIL_FLAG                    BIT14
+#define SDHOST_CMD_NEW_FLAG                     BIT15
+
+//
+// VDD
+//
+#define SDHOST_VDD_POWER_ON         BIT0
+
+//
+// HSTS
+//
+#define SDHOST_HSTS_CLEAR           0x7F8
+#define SDHOST_HSTS_BLOCK_IRPT      BIT9
+#define SDHOST_HSTS_REW_TIME_OUT    BIT7
+#define SDHOST_HSTS_CMD_TIME_OUT    BIT6
+#define SDHOST_HSTS_CRC16_ERROR     BIT5
+#define SDHOST_HSTS_CRC7_ERROR      BIT4
+#define SDHOST_HSTS_FIFO_ERROR      BIT3
+#define SDHOST_HSTS_DATA_FLAG       BIT0
+
+#define SDHOST_HSTS_TIMOUT_ERROR    (SDHOST_HSTS_CMD_TIME_OUT | SDHOST_HSTS_REW_TIME_OUT)
+#define SDHOST_HSTS_TRANSFER_ERROR  (SDHOST_HSTS_FIFO_ERROR | SDHOST_HSTS_CRC7_ERROR | SDHOST_HSTS_CRC16_ERROR)
+#define SDHOST_HSTS_ERROR           (SDHOST_HSTS_TIMOUT_ERROR | SDHOST_HSTS_TRANSFER_ERROR)
+
+//
+// HCFG
+//
+#define SDHOST_HCFG_SLOW_CARD       BIT3
+#define SDHOST_HCFG_WIDE_EXT_BUS    BIT2
+#define SDHOST_HCFG_WIDE_INT_BUS    BIT1
+#define SDHOST_HCFG_DATA_IRPT_EN    BIT4
+#define SDHOST_HCFG_BLOCK_IRPT_EN   BIT8
+#define SDHOST_HCFG_BUSY_IRPT_EN    BIT10
+
+//
+// EDM
+//
+#define SDHOST_EDM_FIFO_CLEAR               BIT21
+#define SDHOST_EDM_WRITE_THRESHOLD_SHIFT    9
+#define SDHOST_EDM_READ_THRESHOLD_SHIFT     14
+#define SDHOST_EDM_THRESHOLD_MASK           0x1F
+#define SDHOST_EDM_READ_THRESHOLD(X)        ((X) << SDHOST_EDM_READ_THRESHOLD_SHIFT)
+#define SDHOST_EDM_WRITE_THRESHOLD(X)       ((X) << SDHOST_EDM_WRITE_THRESHOLD_SHIFT)
+
+#define CMD8_SD_ARG       (0x0UL << 12 | BIT8 | 0xCEUL << 0)
+#define CMD8_MMC_ARG      (0)
+
+#endif /*__BCM2836_SDHOST_H__ */
-- 
2.17.0.windows.1



^ permalink raw reply related	[flat|nested] 34+ messages in thread

* [PATCH v5 edk2-platforms 16/22] Platform/RaspberryPi/RPi3: Add platform boot manager and helper libs
  2019-02-05 16:25 [PATCH v5 edk2-platforms 00/22] Platform/RaspberryPi: Add Raspberry Pi 3 support Pete Batard
                   ` (14 preceding siblings ...)
  2019-02-05 16:25 ` [PATCH v5 edk2-platforms 15/22] Platform/RaspberryPi/RPi3: Add SD Host driver Pete Batard
@ 2019-02-05 16:25 ` Pete Batard
  2019-02-05 16:25 ` [PATCH v5 edk2-platforms 17/22] Platform/RaspberryPi/RPi3: Add USB host driver Pete Batard
                   ` (7 subsequent siblings)
  23 siblings, 0 replies; 34+ messages in thread
From: Pete Batard @ 2019-02-05 16:25 UTC (permalink / raw)
  To: edk2-devel

The libraries decide and set the boot order between UEFI Shell, SD media
and/or USB media and allow for user configuration and override. Stale
boot options (non present media) are automatically removed on boot.

Contributed-under: TianoCore Contribution Agreement 1.1
Signed-off-by: Pete Batard <pete@akeo.ie>
---
 Platform/RaspberryPi/RPi3/Library/PlatformBootManagerLib/PlatformBm.c               | 793 ++++++++++++++++++++
 Platform/RaspberryPi/RPi3/Library/PlatformBootManagerLib/PlatformBm.h               |  60 ++
 Platform/RaspberryPi/RPi3/Library/PlatformBootManagerLib/PlatformBootManagerLib.inf |  90 +++
 Platform/RaspberryPi/RPi3/Library/PlatformUiAppLib/PlatformUiAppLib.c               | 120 +++
 Platform/RaspberryPi/RPi3/Library/PlatformUiAppLib/PlatformUiAppLib.inf             |  34 +
 5 files changed, 1097 insertions(+)

diff --git a/Platform/RaspberryPi/RPi3/Library/PlatformBootManagerLib/PlatformBm.c b/Platform/RaspberryPi/RPi3/Library/PlatformBootManagerLib/PlatformBm.c
new file mode 100644
index 000000000000..9bbe0db64950
--- /dev/null
+++ b/Platform/RaspberryPi/RPi3/Library/PlatformBootManagerLib/PlatformBm.c
@@ -0,0 +1,793 @@
+/** @file
+ *
+ *  Copyright (c) 2018, Pete Batard <pete@akeo.ie>
+ *  Copyright (c) 2017-2018, Andrei Warkentin <andrey.warkentin@gmail.com>
+ *  Copyright (c) 2016, Linaro Ltd. All rights reserved.
+ *  Copyright (c) 2015-2016, Red Hat, Inc.
+ *  Copyright (c) 2014, ARM Ltd. All rights reserved.
+ *  Copyright (c) 2004-2016, Intel Corporation. All rights reserved.
+ *
+ *  This program and the accompanying materials
+ *  are licensed and made available under the terms and conditions of the BSD License
+ *  which accompanies this distribution.  The full text of the license may be found at
+ *  http://opensource.org/licenses/bsd-license.php
+ *
+ *  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+ *  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+ *
+ **/
+
+#include <Library/BootLogoLib.h>
+#include <Library/CapsuleLib.h>
+#include <Library/DevicePathLib.h>
+#include <Library/HobLib.h>
+#include <Library/PcdLib.h>
+#include <Library/UefiBootManagerLib.h>
+#include <Library/UefiLib.h>
+#include <Library/PrintLib.h>
+#include <Protocol/DevicePath.h>
+#include <Protocol/EsrtManagement.h>
+#include <Protocol/GraphicsOutput.h>
+#include <Protocol/LoadedImage.h>
+#include <Guid/EventGroup.h>
+#include <Guid/TtyTerm.h>
+#include <Protocol/BootLogo.h>
+
+#include "PlatformBm.h"
+
+#define BOOT_PROMPT L"ESC (setup), F1 (shell), ENTER (boot)"
+
+#define DP_NODE_LEN(Type) { (UINT8)sizeof (Type), (UINT8)(sizeof (Type) >> 8) }
+
+#pragma pack (1)
+typedef struct {
+  VENDOR_DEVICE_PATH         SerialDxe;
+  UART_DEVICE_PATH           Uart;
+  VENDOR_DEFINED_DEVICE_PATH TermType;
+  EFI_DEVICE_PATH_PROTOCOL   End;
+} PLATFORM_SERIAL_CONSOLE;
+#pragma pack ()
+
+typedef struct {
+  VENDOR_DEVICE_PATH         Custom;
+  USB_DEVICE_PATH            Hub;
+  USB_DEVICE_PATH            Dev;
+  EFI_DEVICE_PATH_PROTOCOL   EndDevicePath;
+} PLATFORM_USB_DEV;
+
+typedef struct {
+  VENDOR_DEVICE_PATH         Custom;
+  EFI_DEVICE_PATH_PROTOCOL   EndDevicePath;
+} PLATFORM_SD_DEV;
+
+#define ARASAN_MMC_DXE_FILE_GUID  \
+  { 0x100c2cfa, 0xb586, 0x4198, { 0x9b, 0x4c, 0x16, 0x83, 0xd1, 0x95, 0xb1, 0xda } }
+
+#define SDHOST_MMC_DXE_FILE_GUID  \
+  { 0x58abd787, 0xf64d, 0x4ca2, { 0xa0, 0x34, 0xb9, 0xac, 0x2d, 0x5a, 0xd0, 0xcf } }
+
+#define SERIAL_DXE_FILE_GUID      \
+  { 0xD3987D4B, 0x971A, 0x435F, { 0x8C, 0xAF, 0x49, 0x67, 0xEB, 0x62, 0x72, 0x41 } }
+
+STATIC PLATFORM_SD_DEV mArasan = {
+  //
+  // VENDOR_DEVICE_PATH ArasanMMCHostDxe
+  //
+  {
+    { HARDWARE_DEVICE_PATH, HW_VENDOR_DP, DP_NODE_LEN (VENDOR_DEVICE_PATH) },
+    ARASAN_MMC_DXE_FILE_GUID
+  },
+
+  //
+  // EFI_DEVICE_PATH_PROTOCOL End
+  //
+  {
+    END_DEVICE_PATH_TYPE, END_ENTIRE_DEVICE_PATH_SUBTYPE,
+    DP_NODE_LEN (EFI_DEVICE_PATH_PROTOCOL)
+  }
+};
+
+STATIC PLATFORM_SD_DEV mSDHost = {
+  //
+  // VENDOR_DEVICE_PATH SdHostDxe
+  //
+  {
+    { HARDWARE_DEVICE_PATH, HW_VENDOR_DP, DP_NODE_LEN (VENDOR_DEVICE_PATH) },
+    SDHOST_MMC_DXE_FILE_GUID
+  },
+
+  //
+  // EFI_DEVICE_PATH_PROTOCOL End
+  //
+  {
+    END_DEVICE_PATH_TYPE, END_ENTIRE_DEVICE_PATH_SUBTYPE,
+    DP_NODE_LEN (EFI_DEVICE_PATH_PROTOCOL)
+  }
+};
+
+STATIC PLATFORM_SERIAL_CONSOLE mSerialConsole = {
+  //
+  // VENDOR_DEVICE_PATH SerialDxe
+  //
+  {
+    { HARDWARE_DEVICE_PATH, HW_VENDOR_DP, DP_NODE_LEN (VENDOR_DEVICE_PATH) },
+    SERIAL_DXE_FILE_GUID
+  },
+
+  //
+  // UART_DEVICE_PATH Uart
+  //
+  {
+    { MESSAGING_DEVICE_PATH, MSG_UART_DP, DP_NODE_LEN (UART_DEVICE_PATH) },
+    0,                                      // Reserved
+    FixedPcdGet64 (PcdUartDefaultBaudRate), // BaudRate
+    FixedPcdGet8 (PcdUartDefaultDataBits),  // DataBits
+    FixedPcdGet8 (PcdUartDefaultParity),    // Parity
+    FixedPcdGet8 (PcdUartDefaultStopBits)   // StopBits
+  },
+
+  //
+  // VENDOR_DEFINED_DEVICE_PATH TermType
+  //
+  {
+    {
+      MESSAGING_DEVICE_PATH, MSG_VENDOR_DP,
+      DP_NODE_LEN (VENDOR_DEFINED_DEVICE_PATH)
+    }
+    //
+    // Guid to be filled in dynamically
+    //
+  },
+
+  //
+  // EFI_DEVICE_PATH_PROTOCOL End
+  //
+  {
+    END_DEVICE_PATH_TYPE, END_ENTIRE_DEVICE_PATH_SUBTYPE,
+    DP_NODE_LEN (EFI_DEVICE_PATH_PROTOCOL)
+  }
+};
+
+
+#pragma pack (1)
+typedef struct {
+  USB_CLASS_DEVICE_PATH    Keyboard;
+  EFI_DEVICE_PATH_PROTOCOL End;
+} PLATFORM_USB_KEYBOARD;
+#pragma pack ()
+
+STATIC PLATFORM_USB_KEYBOARD mUsbKeyboard = {
+  //
+  // USB_CLASS_DEVICE_PATH Keyboard
+  //
+  {
+    {
+      MESSAGING_DEVICE_PATH, MSG_USB_CLASS_DP,
+      DP_NODE_LEN (USB_CLASS_DEVICE_PATH)
+    },
+    0xFFFF, // VendorId: any
+    0xFFFF, // ProductId: any
+    3,      // DeviceClass: HID
+    1,      // DeviceSubClass: boot
+    1       // DeviceProtocol: keyboard
+  },
+
+  //
+  // EFI_DEVICE_PATH_PROTOCOL End
+  //
+  {
+    END_DEVICE_PATH_TYPE, END_ENTIRE_DEVICE_PATH_SUBTYPE,
+    DP_NODE_LEN (EFI_DEVICE_PATH_PROTOCOL)
+  }
+};
+
+STATIC EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL *mSerialConProtocol;
+
+/**
+  Check if the handle satisfies a particular condition.
+
+  @param[in] Handle      The handle to check.
+  @param[in] ReportText  A caller-allocated string passed in for reporting
+                         purposes. It must never be NULL.
+
+  @retval TRUE   The condition is satisfied.
+  @retval FALSE  Otherwise. This includes the case when the condition could not
+                 be fully evaluated due to an error.
+**/
+typedef
+BOOLEAN
+(EFIAPI *FILTER_FUNCTION) (
+  IN EFI_HANDLE   Handle,
+  IN CONST CHAR16 *ReportText
+  );
+
+
+/**
+  Process a handle.
+
+  @param[in] Handle      The handle to process.
+  @param[in] ReportText  A caller-allocated string passed in for reporting
+                         purposes. It must never be NULL.
+**/
+typedef
+VOID
+(EFIAPI *CALLBACK_FUNCTION)  (
+  IN EFI_HANDLE   Handle,
+  IN CONST CHAR16 *ReportText
+  );
+
+/**
+  Locate all handles that carry the specified protocol, filter them with a
+  callback function, and pass each handle that passes the filter to another
+  callback.
+
+  @param[in] ProtocolGuid  The protocol to look for.
+
+  @param[in] Filter        The filter function to pass each handle to. If this
+                           parameter is NULL, then all handles are processed.
+
+  @param[in] Process       The callback function to pass each handle to that
+                           clears the filter.
+**/
+STATIC
+VOID
+FilterAndProcess (
+  IN EFI_GUID          *ProtocolGuid,
+  IN FILTER_FUNCTION   Filter         OPTIONAL,
+  IN CALLBACK_FUNCTION Process
+  )
+{
+  EFI_STATUS Status;
+  EFI_HANDLE *Handles;
+  UINTN      NoHandles;
+  UINTN      Idx;
+
+  Status = gBS->LocateHandleBuffer (ByProtocol, ProtocolGuid,
+                  NULL /* SearchKey */, &NoHandles, &Handles);
+  if (EFI_ERROR (Status)) {
+    //
+    // This is not an error, just an informative condition.
+    //
+    DEBUG ((DEBUG_VERBOSE, "%a: %g: %r\n", __FUNCTION__, ProtocolGuid,
+      Status));
+    return;
+  }
+
+  ASSERT (NoHandles > 0);
+  for (Idx = 0; Idx < NoHandles; ++Idx) {
+    CHAR16        *DevicePathText;
+    STATIC CHAR16 Fallback[] = L"<device path unavailable>";
+
+    //
+    // The ConvertDevicePathToText() function handles NULL input transparently.
+    //
+    DevicePathText = ConvertDevicePathToText (
+                       DevicePathFromHandle (Handles[Idx]),
+                       FALSE, // DisplayOnly
+                       FALSE  // AllowShortcuts
+                     );
+    if (DevicePathText == NULL) {
+      DevicePathText = Fallback;
+    }
+
+    if (Filter == NULL || Filter (Handles[Idx], DevicePathText)) {
+      Process (Handles[Idx], DevicePathText);
+    }
+
+    if (DevicePathText != Fallback) {
+      FreePool (DevicePathText);
+    }
+  }
+  gBS->FreePool (Handles);
+}
+
+/**
+  This CALLBACK_FUNCTION retrieves the EFI_DEVICE_PATH_PROTOCOL from the
+  handle, and adds it to ConOut and ErrOut.
+**/
+STATIC
+VOID
+EFIAPI
+AddOutput (
+  IN EFI_HANDLE   Handle,
+  IN CONST CHAR16 *ReportText
+  )
+{
+  EFI_STATUS               Status;
+  EFI_DEVICE_PATH_PROTOCOL *DevicePath;
+
+  DevicePath = DevicePathFromHandle (Handle);
+  if (DevicePath == NULL) {
+    DEBUG ((DEBUG_ERROR, "%a: %s: handle %p: device path not found\n",
+      __FUNCTION__, ReportText, Handle));
+    return;
+  }
+
+  Status = EfiBootManagerUpdateConsoleVariable (ConOut, DevicePath, NULL);
+  if (EFI_ERROR (Status)) {
+    DEBUG ((DEBUG_ERROR, "%a: %s: adding to ConOut: %r\n", __FUNCTION__,
+      ReportText, Status));
+    return;
+  }
+
+  Status = EfiBootManagerUpdateConsoleVariable (ErrOut, DevicePath, NULL);
+  if (EFI_ERROR (Status)) {
+    DEBUG ((DEBUG_ERROR, "%a: %s: adding to ErrOut: %r\n", __FUNCTION__,
+      ReportText, Status));
+    return;
+  }
+
+  DEBUG ((DEBUG_VERBOSE, "%a: %s: added to ConOut and ErrOut\n", __FUNCTION__,
+    ReportText));
+}
+
+STATIC
+INTN
+PlatformRegisterBootOption (
+  EFI_DEVICE_PATH_PROTOCOL *DevicePath,
+  CHAR16                   *Description,
+  UINT32                   Attributes
+  )
+{
+  EFI_STATUS                        Status;
+  INTN                              OptionIndex;
+  EFI_BOOT_MANAGER_LOAD_OPTION      NewOption;
+  EFI_BOOT_MANAGER_LOAD_OPTION      *BootOptions;
+  UINTN                             BootOptionCount;
+
+  Status = EfiBootManagerInitializeLoadOption (
+             &NewOption,
+             LoadOptionNumberUnassigned,
+             LoadOptionTypeBoot,
+             Attributes,
+             Description,
+             DevicePath,
+             NULL,
+             0
+           );
+  ASSERT_EFI_ERROR (Status);
+
+  BootOptions = EfiBootManagerGetLoadOptions (&BootOptionCount, LoadOptionTypeBoot);
+
+  OptionIndex = EfiBootManagerFindLoadOption (&NewOption, BootOptions, BootOptionCount);
+
+  if (OptionIndex == -1) {
+    Status = EfiBootManagerAddLoadOptionVariable (&NewOption, MAX_UINTN);
+    ASSERT_EFI_ERROR (Status);
+    OptionIndex = BootOptionCount;
+  }
+
+  EfiBootManagerFreeLoadOption (&NewOption);
+  EfiBootManagerFreeLoadOptions (BootOptions, BootOptionCount);
+
+  return OptionIndex;
+}
+
+STATIC
+INTN
+PlatformRegisterFvBootOption (
+  CONST EFI_GUID                   *FileGuid,
+  CHAR16                           *Description,
+  UINT32                           Attributes
+  )
+{
+  EFI_STATUS                        Status;
+  MEDIA_FW_VOL_FILEPATH_DEVICE_PATH FileNode;
+  EFI_LOADED_IMAGE_PROTOCOL         *LoadedImage;
+  EFI_DEVICE_PATH_PROTOCOL          *DevicePath;
+  INTN OptionIndex;
+
+  Status = gBS->HandleProtocol (
+                  gImageHandle,
+                  &gEfiLoadedImageProtocolGuid,
+                  (VOID**)&LoadedImage
+                );
+  ASSERT_EFI_ERROR (Status);
+
+  EfiInitializeFwVolDevicepathNode (&FileNode, FileGuid);
+  DevicePath = DevicePathFromHandle (LoadedImage->DeviceHandle);
+  ASSERT (DevicePath != NULL);
+  DevicePath = AppendDevicePathNode (DevicePath, (EFI_DEVICE_PATH_PROTOCOL*)&FileNode);
+  ASSERT (DevicePath != NULL);
+
+  OptionIndex = PlatformRegisterBootOption (DevicePath, Description, Attributes);
+  FreePool (DevicePath);
+
+  return OptionIndex;
+}
+
+STATIC
+VOID
+RemoveStaleBootOptions (
+  VOID
+)
+{
+  EFI_BOOT_MANAGER_LOAD_OPTION *BootOptions;
+  UINTN                        BootOptionCount;
+  UINTN                        Index;
+  EFI_STATUS                   Status;
+
+  BootOptions = EfiBootManagerGetLoadOptions (&BootOptionCount,
+    LoadOptionTypeBoot);
+
+  for (Index = 0; Index < BootOptionCount; ++Index) {
+    EFI_DEVICE_PATH_PROTOCOL *DevicePath = BootOptions[Index].FilePath;
+
+    if (CompareMem (&mArasan, DevicePath, GetDevicePathSize (DevicePath)) == 0) {
+      if (PcdGet32 (PcdSdIsArasan)) {
+        continue;
+      }
+    } else if (CompareMem (&mSDHost, DevicePath, GetDevicePathSize (DevicePath)) == 0) {
+      if (!PcdGet32 (PcdSdIsArasan)) {
+        continue;
+      }
+    } else {
+      continue;
+    }
+
+    //
+    // Delete the boot options corresponding to stale SD controllers.
+    //
+    Status = EfiBootManagerDeleteLoadOptionVariable (
+      BootOptions[Index].OptionNumber, LoadOptionTypeBoot);
+    DEBUG_CODE (
+      CHAR16 *DevicePathString;
+
+      DevicePathString = ConvertDevicePathToText(BootOptions[Index].FilePath, FALSE, FALSE);
+      DEBUG ((
+        EFI_ERROR (Status) ? EFI_D_WARN : EFI_D_INFO,
+        "%a: removing stale Boot#%04x %s: %r\n",
+        __FUNCTION__,
+        (UINT32)BootOptions[Index].OptionNumber,
+        DevicePathString == NULL ? L"<unavailable>" : DevicePathString,
+        Status
+      ));
+      if (DevicePathString != NULL) {
+        FreePool (DevicePathString);
+      }
+    );
+  }
+
+  EfiBootManagerFreeLoadOptions (BootOptions, BootOptionCount);
+}
+
+STATIC
+VOID
+PlatformRegisterOptionsAndKeys (
+  VOID
+  )
+{
+  EFI_STATUS                   Status;
+  EFI_INPUT_KEY                Enter;
+  EFI_INPUT_KEY                F1;
+  EFI_INPUT_KEY                Esc;
+  EFI_BOOT_MANAGER_LOAD_OPTION BootOption;
+  INTN ShellOption;
+
+  RemoveStaleBootOptions ();
+
+  ShellOption = PlatformRegisterFvBootOption (&gUefiShellFileGuid, L"UEFI Shell", LOAD_OPTION_ACTIVE);
+  if (ShellOption != -1) {
+    //
+    // F1 boots Shell.
+    //
+    F1.ScanCode = SCAN_F1;
+    F1.UnicodeChar = CHAR_NULL;
+    Status = EfiBootManagerAddKeyOptionVariable (NULL, (UINT16)ShellOption, 0, &F1, NULL);
+    ASSERT (Status == EFI_SUCCESS || Status == EFI_ALREADY_STARTED);
+  }
+
+  //
+  // Register ENTER as CONTINUE key
+  //
+  Enter.ScanCode = SCAN_NULL;
+  Enter.UnicodeChar = CHAR_CARRIAGE_RETURN;
+  Status = EfiBootManagerRegisterContinueKeyOption (0, &Enter, NULL);
+  ASSERT_EFI_ERROR (Status);
+
+  //
+  // Map ESC to Boot Manager Menu
+  //
+  Esc.ScanCode = SCAN_ESC;
+  Esc.UnicodeChar = CHAR_NULL;
+  Status = EfiBootManagerGetBootManagerMenu (&BootOption);
+  ASSERT_EFI_ERROR (Status);
+  Status = EfiBootManagerAddKeyOptionVariable (NULL, (UINT16)BootOption.OptionNumber, 0, &Esc, NULL);
+  ASSERT (Status == EFI_SUCCESS || Status == EFI_ALREADY_STARTED);
+}
+
+STATIC VOID
+SerialConPrint (
+  IN CHAR16 *Text
+  )
+{
+  if (mSerialConProtocol != NULL) {
+    mSerialConProtocol->OutputString (mSerialConProtocol, Text);
+  }
+}
+
+STATIC
+VOID
+EFIAPI
+ExitBootServicesHandler (
+  IN EFI_EVENT  Event,
+  IN VOID       *Context
+  )
+{
+  EFI_STATUS Status;
+  //
+  // Long enough to occlude the string printed
+  // in PlatformBootManagerWaitCallback.
+  //
+  STATIC CHAR16 *OsBootStr = L"Exiting UEFI and booting EL2 OS kernel!\r\n";
+  EFI_GRAPHICS_OUTPUT_BLT_PIXEL_UNION Green;
+  EFI_GRAPHICS_OUTPUT_BLT_PIXEL_UNION Black;
+  EFI_GRAPHICS_OUTPUT_BLT_PIXEL_UNION Yellow;
+
+  if (!PcdGet32 (PcdDebugShowUEFIExit)) {
+    return;
+  }
+
+  Green.Raw = 0x00007F00;
+  Black.Raw = 0x00000000;
+  Yellow.Raw = 0x00FFFF00;
+
+  Status = BootLogoUpdateProgress (Yellow.Pixel,
+             Black.Pixel,
+             OsBootStr,
+             Green.Pixel,
+             100, 0);
+  if (Status == EFI_SUCCESS) {
+    SerialConPrint (OsBootStr);
+  } else {
+    Print (L"\n");
+    Print (OsBootStr);
+    Print (L"\n");
+  }
+}
+
+//
+// BDS Platform Functions
+//
+/**
+  Do the platform init, can be customized by OEM/IBV
+  Possible things that can be done in PlatformBootManagerBeforeConsole:
+  > Update console variable: 1. include hot-plug devices;
+  >                          2. Clear ConIn and add SOL for AMT
+  > Register new Driver#### or Boot####
+  > Register new Key####: e.g.: F12
+  > Signal ReadyToLock event
+  > Authentication action: 1. connect Auth devices;
+  >                        2. Identify auto logon user.
+**/
+VOID
+EFIAPI
+PlatformBootManagerBeforeConsole (
+  VOID
+  )
+{
+  EFI_STATUS Status;
+  EFI_EVENT ExitBSEvent;
+  ESRT_MANAGEMENT_PROTOCOL *EsrtManagement;
+
+  Status = gBS->CreateEventEx (
+                  EVT_NOTIFY_SIGNAL,
+                  TPL_NOTIFY,
+                  ExitBootServicesHandler,
+                  NULL,
+                  &gEfiEventExitBootServicesGuid,
+                  &ExitBSEvent
+                );
+  if (EFI_ERROR (Status)) {
+    DEBUG ((DEBUG_ERROR, "%a: failed to register ExitBootServices handler\n", __FUNCTION__));
+  }
+
+  if (GetBootModeHob () == BOOT_ON_FLASH_UPDATE) {
+    DEBUG ((DEBUG_INFO, "ProcessCapsules Before EndOfDxe ......\n"));
+    Status = ProcessCapsules ();
+    DEBUG ((DEBUG_INFO, "ProcessCapsules returned %r\n", Status));
+  } else {
+    Status = gBS->LocateProtocol (&gEsrtManagementProtocolGuid, NULL, (VOID**)&EsrtManagement);
+    if (!EFI_ERROR (Status)) {
+      EsrtManagement->SyncEsrtFmp ();
+    }
+  }
+
+  //
+  // Now add the device path of all handles with GOP on them to ConOut and
+  // ErrOut.
+  //
+  FilterAndProcess (&gEfiGraphicsOutputProtocolGuid, NULL, AddOutput);
+
+  //
+  // Add the hardcoded short-form USB keyboard device path to ConIn.
+  //
+  EfiBootManagerUpdateConsoleVariable (ConIn, (EFI_DEVICE_PATH_PROTOCOL*)&mUsbKeyboard, NULL);
+
+  //
+  // Add the hardcoded serial console device path to ConIn, ConOut, ErrOut.
+  //
+  ASSERT (FixedPcdGet8 (PcdDefaultTerminalType) == 4);
+  CopyGuid (&mSerialConsole.TermType.Guid, &gEfiTtyTermGuid);
+
+  EfiBootManagerUpdateConsoleVariable (ConIn, (EFI_DEVICE_PATH_PROTOCOL*)&mSerialConsole, NULL);
+  EfiBootManagerUpdateConsoleVariable (ConOut, (EFI_DEVICE_PATH_PROTOCOL*)&mSerialConsole, NULL);
+  EfiBootManagerUpdateConsoleVariable (ErrOut, (EFI_DEVICE_PATH_PROTOCOL*)&mSerialConsole, NULL);
+
+  //
+  // Signal EndOfDxe PI Event
+  //
+  EfiEventGroupSignal (&gEfiEndOfDxeEventGroupGuid);
+
+  //
+  // Dispatch deferred images after EndOfDxe event and ReadyToLock installation.
+  //
+  EfiBootManagerDispatchDeferredImages ();
+}
+
+/**
+  Do the platform specific action after the console is ready
+  Possible things that can be done in PlatformBootManagerAfterConsole:
+  > Console post action:
+    > Dynamically switch output mode from 100x31 to 80x25 for certain senarino
+    > Signal console ready platform customized event
+  > Run diagnostics like memory testing
+  > Connect certain devices
+  > Dispatch aditional option roms
+  > Special boot: e.g.: USB boot, enter UI
+**/
+VOID
+EFIAPI
+PlatformBootManagerAfterConsole (
+  VOID
+  )
+{
+  ESRT_MANAGEMENT_PROTOCOL      *EsrtManagement;
+  EFI_STATUS                    Status;
+  EFI_HANDLE SerialHandle;
+
+  Status = EfiBootManagerConnectDevicePath ((EFI_DEVICE_PATH_PROTOCOL*)&mSerialConsole, &SerialHandle);
+  if (Status == EFI_SUCCESS) {
+    gBS->HandleProtocol (SerialHandle, &gEfiSimpleTextOutProtocolGuid, (VOID**)&mSerialConProtocol);
+  }
+
+  //
+  // Show the splash screen.
+  //
+  Status = BootLogoEnableLogo ();
+  if (Status == EFI_SUCCESS) {
+    SerialConPrint (BOOT_PROMPT);
+  } else {
+    Print (BOOT_PROMPT);
+  }
+
+  //
+  // Connect the rest of the devices.
+  //
+  EfiBootManagerConnectAll ();
+
+  Status = gBS->LocateProtocol (&gEsrtManagementProtocolGuid, NULL, (VOID**)&EsrtManagement);
+  if (!EFI_ERROR (Status)) {
+    EsrtManagement->SyncEsrtFmp ();
+  }
+
+  if (GetBootModeHob () == BOOT_ON_FLASH_UPDATE) {
+    DEBUG ((DEBUG_INFO, "ProcessCapsules After EndOfDxe ......\n"));
+    Status = ProcessCapsules ();
+    DEBUG ((DEBUG_INFO, "ProcessCapsules returned %r\n", Status));
+  }
+
+  PlatformRegisterOptionsAndKeys ();
+}
+
+/**
+  This function is called each second during the boot manager waits the
+  timeout.
+
+  @param TimeoutRemain  The remaining timeout.
+**/
+VOID
+EFIAPI
+PlatformBootManagerWaitCallback (
+  IN UINT16  TimeoutRemain
+  )
+{
+  EFI_GRAPHICS_OUTPUT_BLT_PIXEL_UNION Black;
+  EFI_GRAPHICS_OUTPUT_BLT_PIXEL_UNION White;
+  UINT16                              Timeout;
+  EFI_STATUS                          Status;
+  EFI_BOOT_LOGO_PROTOCOL *BootLogo;
+
+  Timeout = PcdGet16 (PcdPlatformBootTimeOut);
+
+  Black.Raw = 0x00000000;
+  White.Raw = 0x00FFFFFF;
+
+  Status = BootLogoUpdateProgress (
+             White.Pixel,
+             Black.Pixel,
+             BOOT_PROMPT,
+             White.Pixel,
+             (Timeout - TimeoutRemain) * 100 / Timeout,
+             0
+           );
+  if (Status == EFI_SUCCESS) {
+    SerialConPrint (L".");
+  } else {
+    Print (L".");
+  }
+
+  if (TimeoutRemain == 0) {
+    BootLogo = NULL;
+
+    //
+    // Clear out the boot logo so that Windows displays its own logo
+    // instead of ours.
+    //
+    Status = gBS->LocateProtocol (&gEfiBootLogoProtocolGuid, NULL, (VOID**)&BootLogo);
+    if (!EFI_ERROR (Status) && (BootLogo != NULL)) {
+      Status = BootLogo->SetBootLogo (BootLogo, NULL, 0, 0, 0, 0);
+      ASSERT_EFI_ERROR (Status);
+    };
+
+    gST->ConOut->ClearScreen (gST->ConOut);
+  }
+}
+
+/**
+  The function is called when no boot option could be launched,
+  including platform recovery options and options pointing to applications
+  built into firmware volumes.
+  If this function returns, BDS attempts to enter an infinite loop.
+**/
+VOID
+EFIAPI
+PlatformBootManagerUnableToBoot (
+  VOID
+  )
+{
+  EFI_STATUS                   Status;
+  EFI_INPUT_KEY                Key;
+  EFI_BOOT_MANAGER_LOAD_OPTION BootManagerMenu;
+  UINTN                        Index;
+
+  //
+  // BootManagerMenu doesn't contain the correct information when return status
+  // is EFI_NOT_FOUND.
+  //
+  Status = EfiBootManagerGetBootManagerMenu (&BootManagerMenu);
+  if (EFI_ERROR (Status)) {
+    return;
+  }
+  //
+  // Normally BdsDxe does not print anything to the system console, but this is
+  // a last resort -- the end-user will likely not see any DEBUG messages
+  // logged in this situation.
+  //
+  // AsciiPrint() will NULL-check gST->ConOut internally. We check gST->ConIn
+  // here to see if it makes sense to request and wait for a keypress.
+  //
+  if (gST->ConIn != NULL) {
+    AsciiPrint (
+      "%a: No bootable option or device was found.\n"
+      "%a: Press any key to enter the Boot Manager Menu.\n",
+      gEfiCallerBaseName,
+      gEfiCallerBaseName);
+    Status = gBS->WaitForEvent (1, &gST->ConIn->WaitForKey, &Index);
+    ASSERT_EFI_ERROR (Status);
+    ASSERT (Index == 0);
+
+    //
+    // Drain any queued keys.
+    //
+    while (!EFI_ERROR (gST->ConIn->ReadKeyStroke (gST->ConIn, &Key))) {
+      //
+      // just throw away Key
+      //
+    }
+  }
+
+  for (;;) {
+    EfiBootManagerBoot (&BootManagerMenu);
+  }
+}
diff --git a/Platform/RaspberryPi/RPi3/Library/PlatformBootManagerLib/PlatformBm.h b/Platform/RaspberryPi/RPi3/Library/PlatformBootManagerLib/PlatformBm.h
new file mode 100644
index 000000000000..3717ba6174df
--- /dev/null
+++ b/Platform/RaspberryPi/RPi3/Library/PlatformBootManagerLib/PlatformBm.h
@@ -0,0 +1,60 @@
+/** @file
+ *
+ *  Copyright (c) 2017-2018, Andrei Warkentin <andrey.warkentin@gmail.com>
+ *  Copyright (c) 2016, Linaro Ltd. All rights reserved.
+ *  Copyright (c) 2015-2016, Red Hat, Inc.
+ *  Copyright (c) 2014, ARM Ltd. All rights reserved.
+ *  Copyright (c) 2004-2016, Intel Corporation. All rights reserved.
+ *
+ *  This program and the accompanying materials
+ *  are licensed and made available under the terms and conditions of the BSD License
+ *  which accompanies this distribution.  The full text of the license may be found at
+ *  http://opensource.org/licenses/bsd-license.php
+ *
+ *  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+ *  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+ *
+ **/
+
+#ifndef _PLATFORM_BM_H_
+#define _PLATFORM_BM_H_
+
+#include <Library/BaseLib.h>
+#include <Library/BaseMemoryLib.h>
+#include <Library/DebugLib.h>
+#include <Library/DevicePathLib.h>
+#include <Library/MemoryAllocationLib.h>
+#include <Library/UefiBootServicesTableLib.h>
+#include <Library/UefiLib.h>
+#include <Library/UefiRuntimeServicesTableLib.h>
+
+/**
+  Use SystemTable Conout to stop video based Simple Text Out consoles from
+  going to the video device. Put up LogoFile on every video device that is a
+  console.
+
+  @param[in]  LogoFile   File name of logo to display on the center of the
+                         screen.
+
+  @retval EFI_SUCCESS     ConsoleControl has been flipped to graphics and logo
+                          displayed.
+  @retval EFI_UNSUPPORTED Logo not found
+**/
+EFI_STATUS
+EnableQuietBoot (
+  IN  EFI_GUID  *LogoFile
+  );
+
+/**
+  Use SystemTable Conout to turn on video based Simple Text Out consoles. The
+  Simple Text Out screens will now be synced up with all non video output
+  devices
+
+  @retval EFI_SUCCESS     UGA devices are back in text mode and synced up.
+**/
+EFI_STATUS
+DisableQuietBoot (
+  VOID
+  );
+
+#endif // _PLATFORM_BM_H_
diff --git a/Platform/RaspberryPi/RPi3/Library/PlatformBootManagerLib/PlatformBootManagerLib.inf b/Platform/RaspberryPi/RPi3/Library/PlatformBootManagerLib/PlatformBootManagerLib.inf
new file mode 100644
index 000000000000..b30772d5a123
--- /dev/null
+++ b/Platform/RaspberryPi/RPi3/Library/PlatformBootManagerLib/PlatformBootManagerLib.inf
@@ -0,0 +1,90 @@
+#/** @file
+#
+#  Copyright (c) 2017-2018, Andrei Warkentin <andrey.warkentin@gmail.com>
+#  Copyright (c) 2016, Linaro Ltd. All rights reserved.
+#  Copyright (c) 2015-2016, Red Hat, Inc.
+#  Copyright (c) 2014, ARM Ltd. All rights reserved.
+#  Copyright (c) 2007-2014, Intel Corporation. All rights reserved.
+#
+#  This program and the accompanying materials are licensed and made available
+#  under the terms and conditions of the BSD License which accompanies this
+#  distribution. The full text of the license may be found at
+#  http://opensource.org/licenses/bsd-license.php
+#
+#  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+#  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR
+#  IMPLIED.
+#
+#**/
+
+[Defines]
+  INF_VERSION                    = 0x0001001A
+  BASE_NAME                      = PlatformBootManagerLib
+  FILE_GUID                      = 92FD2DE3-B9CB-4B35-8141-42AD34D73C9F
+  MODULE_TYPE                    = DXE_DRIVER
+  VERSION_STRING                 = 1.0
+  LIBRARY_CLASS                  = PlatformBootManagerLib|DXE_DRIVER
+
+#
+# The following information is for reference only and not required by the build tools.
+#
+#  VALID_ARCHITECTURES           = AARCH64
+#
+
+[Sources]
+  PlatformBm.c
+
+[Packages]
+  MdeModulePkg/MdeModulePkg.dec
+  MdePkg/MdePkg.dec
+  ShellPkg/ShellPkg.dec
+  Platform/RaspberryPi/RPi3/RPi3.dec
+
+[LibraryClasses]
+  BaseLib
+  BaseMemoryLib
+  BootLogoLib
+  CapsuleLib
+  DebugLib
+  DevicePathLib
+  DxeServicesLib
+  HobLib
+  MemoryAllocationLib
+  PcdLib
+  PrintLib
+  UefiBootManagerLib
+  UefiBootServicesTableLib
+  UefiLib
+
+[FeaturePcd]
+  gEfiMdePkgTokenSpaceGuid.PcdUgaConsumeSupport
+
+[FixedPcd]
+  gEfiMdePkgTokenSpaceGuid.PcdUartDefaultBaudRate
+  gEfiMdePkgTokenSpaceGuid.PcdUartDefaultDataBits
+  gEfiMdePkgTokenSpaceGuid.PcdUartDefaultParity
+  gEfiMdePkgTokenSpaceGuid.PcdUartDefaultStopBits
+  gEfiMdePkgTokenSpaceGuid.PcdDefaultTerminalType
+
+[Pcd]
+  gEfiMdePkgTokenSpaceGuid.PcdPlatformBootTimeOut
+  gRaspberryPiTokenSpaceGuid.PcdDebugShowUEFIExit
+  gRaspberryPiTokenSpaceGuid.PcdSdIsArasan
+
+[Guids]
+  gEfiFileInfoGuid
+  gEfiFileSystemInfoGuid
+  gEfiFileSystemVolumeLabelInfoIdGuid
+  gEfiEndOfDxeEventGroupGuid
+  gEfiTtyTermGuid
+  gUefiShellFileGuid
+  gEfiEventExitBootServicesGuid
+
+[Protocols]
+  gEfiDevicePathProtocolGuid
+  gEfiGraphicsOutputProtocolGuid
+  gEfiLoadedImageProtocolGuid
+  gEfiSimpleFileSystemProtocolGuid
+  gEsrtManagementProtocolGuid
+  gEfiUsb2HcProtocolGuid
+  gEfiBootLogoProtocolGuid
diff --git a/Platform/RaspberryPi/RPi3/Library/PlatformUiAppLib/PlatformUiAppLib.c b/Platform/RaspberryPi/RPi3/Library/PlatformUiAppLib/PlatformUiAppLib.c
new file mode 100644
index 000000000000..3f8521a35190
--- /dev/null
+++ b/Platform/RaspberryPi/RPi3/Library/PlatformUiAppLib/PlatformUiAppLib.c
@@ -0,0 +1,120 @@
+/** @file
+ *
+ *  Copyright (c) 2019, Andrey Warkentin <andrey.warkentin@gmail.com>
+ *
+ *  This program and the accompanying materials
+ *  are licensed and made available under the terms and conditions of the BSD License
+ *  which accompanies this distribution.  The full text of the license may be found at
+ *  http://opensource.org/licenses/bsd-license.php
+ *
+ *  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+ *  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+ *
+ **/
+
+#include <Library/PrintLib.h>
+#include <Library/DebugLib.h>
+#include <Library/BaseMemoryLib.h>
+#include <Library/MemoryAllocationLib.h>
+#include <Library/UefiBootServicesTableLib.h>
+#include <Library/UefiLib.h>
+#include <Library/DevicePathLib.h>
+#include <Library/UefiBootManagerLib.h>
+#include <Protocol/DevicePath.h>
+
+#define ARASAN_MMC_DXE_FILE_GUID  \
+  { 0x100c2cfa, 0xb586, 0x4198, { 0x9b, 0x4c, 0x16, 0x83, 0xd1, 0x95, 0xb1, 0xda } }
+
+#define SDHOST_MMC_DXE_FILE_GUID  \
+  { 0x58abd787, 0xf64d, 0x4ca2, { 0xa0, 0x34, 0xb9, 0xac, 0x2d, 0x5a, 0xd0, 0xcf } }
+
+#define DP_NODE_LEN(Type) { (UINT8)sizeof (Type), (UINT8)(sizeof (Type) >> 8) }
+
+typedef struct {
+  VENDOR_DEVICE_PATH       Custom;
+  EFI_DEVICE_PATH_PROTOCOL EndDevicePath;
+} PLATFORM_SD_DEV;
+
+STATIC PLATFORM_SD_DEV mArasan = {
+  //
+  // VENDOR_DEVICE_PATH ArasanMMCHostDxe
+  //
+  {
+    { HARDWARE_DEVICE_PATH, HW_VENDOR_DP, DP_NODE_LEN (VENDOR_DEVICE_PATH) },
+    ARASAN_MMC_DXE_FILE_GUID
+  },
+
+  //
+  // EFI_DEVICE_PATH_PROTOCOL End
+  //
+  {
+    END_DEVICE_PATH_TYPE, END_ENTIRE_DEVICE_PATH_SUBTYPE,
+    DP_NODE_LEN (EFI_DEVICE_PATH_PROTOCOL)
+  }
+};
+
+STATIC PLATFORM_SD_DEV mSDHost = {
+  //
+  // VENDOR_DEVICE_PATH SdHostDxe
+  //
+  {
+    { HARDWARE_DEVICE_PATH, HW_VENDOR_DP, DP_NODE_LEN (VENDOR_DEVICE_PATH) },
+    SDHOST_MMC_DXE_FILE_GUID
+  },
+
+  //
+  // EFI_DEVICE_PATH_PROTOCOL End
+  //
+  {
+    END_DEVICE_PATH_TYPE, END_ENTIRE_DEVICE_PATH_SUBTYPE,
+    DP_NODE_LEN (EFI_DEVICE_PATH_PROTOCOL)
+  }
+};
+
+STATIC
+CHAR16*
+EFIAPI
+BootDescriptionHandler (
+  IN EFI_HANDLE Handle,
+  IN CONST CHAR16 *DefaultDescription
+  )
+{
+  CHAR16 *Name;
+  EFI_DEVICE_PATH_PROTOCOL *DevicePath;
+
+  DevicePath = DevicePathFromHandle (Handle);
+  if (CompareMem (&mArasan, DevicePath, GetDevicePathSize (DevicePath)) == 0) {
+    Name = L"SD/MMC on Arasan SDHCI";
+  } else if (CompareMem (&mSDHost, DevicePath, GetDevicePathSize (DevicePath)) == 0) {
+    Name = L"SD/MMC on Broadcom SDHOST";
+  } else {
+    return NULL;
+  }
+
+  return AllocateCopyPool(StrSize (Name), Name);
+}
+
+EFI_STATUS
+EFIAPI
+PlatformUiAppLibConstructor (
+  IN EFI_HANDLE ImageHandle,
+  IN EFI_SYSTEM_TABLE *SystemTable
+  )
+{
+  EFI_STATUS Status;
+
+  Status = EfiBootManagerRegisterBootDescriptionHandler(BootDescriptionHandler);
+  ASSERT_EFI_ERROR (Status);
+
+  return EFI_SUCCESS;
+}
+
+EFI_STATUS
+EFIAPI
+PlatformUiAppLibDestructor (
+  IN EFI_HANDLE ImageHandle,
+  IN EFI_SYSTEM_TABLE *SystemTable
+  )
+{
+  return EFI_SUCCESS;
+}
diff --git a/Platform/RaspberryPi/RPi3/Library/PlatformUiAppLib/PlatformUiAppLib.inf b/Platform/RaspberryPi/RPi3/Library/PlatformUiAppLib/PlatformUiAppLib.inf
new file mode 100644
index 000000000000..cacf55f02a14
--- /dev/null
+++ b/Platform/RaspberryPi/RPi3/Library/PlatformUiAppLib/PlatformUiAppLib.inf
@@ -0,0 +1,34 @@
+[Defines]
+  INF_VERSION                    = 0x0001001A
+  BASE_NAME                      = PlatformUiAppLib
+  FILE_GUID                      = CCB2DCE1-5EC9-42CB-88C5-D349E134C9FC
+  MODULE_TYPE                    = DXE_DRIVER
+  VERSION_STRING                 = 1.0
+  LIBRARY_CLASS                  = NULL|DXE_DRIVER UEFI_APPLICATION
+  CONSTRUCTOR                    = PlatformUiAppLibConstructor
+  DESTRUCTOR                     = PlatformUiAppLibDestructor
+
+[Sources]
+  PlatformUiAppLib.c
+
+[Packages]
+  MdePkg/MdePkg.dec
+  MdeModulePkg/MdeModulePkg.dec
+  Platform/RaspberryPi/RPi3/RPi3.dec
+
+[LibraryClasses]
+  UefiLib
+  UefiBootServicesTableLib
+  BaseMemoryLib
+  DebugLib
+  PrintLib
+  UefiBootManagerLib
+  MemoryAllocationLib
+
+[Guids]
+
+[Protocols]
+
+[FeaturePcd]
+
+[Pcd]
-- 
2.17.0.windows.1



^ permalink raw reply related	[flat|nested] 34+ messages in thread

* [PATCH v5 edk2-platforms 17/22] Platform/RaspberryPi/RPi3: Add USB host driver
  2019-02-05 16:25 [PATCH v5 edk2-platforms 00/22] Platform/RaspberryPi: Add Raspberry Pi 3 support Pete Batard
                   ` (15 preceding siblings ...)
  2019-02-05 16:25 ` [PATCH v5 edk2-platforms 16/22] Platform/RaspberryPi/RPi3: Add platform boot manager and helper libs Pete Batard
@ 2019-02-05 16:25 ` Pete Batard
  2019-02-05 16:25 ` [PATCH v5 edk2-platforms 18/22] Platform/RaspberryPi/RPi3 *NON-OSI*: Add ATF binaries Pete Batard
                   ` (6 subsequent siblings)
  23 siblings, 0 replies; 34+ messages in thread
From: Pete Batard @ 2019-02-05 16:25 UTC (permalink / raw)
  To: edk2-devel

The Raspberry Pi 3 uses a dedicated Synopsys DesignWare USB Host driver
to interface with various USB peripherals, including the onboard NIC.
This driver, which is based on the Android OpenPlatformPkg implementation,
provides support for that.

Contributed-under: TianoCore Contribution Agreement 1.1
Signed-off-by: Pete Batard <pete@akeo.ie>
---
 Platform/RaspberryPi/RPi3/Drivers/DwUsbHostDxe/ComponentName.c  |  225 +++
 Platform/RaspberryPi/RPi3/Drivers/DwUsbHostDxe/DriverBinding.c  |  274 ++++
 Platform/RaspberryPi/RPi3/Drivers/DwUsbHostDxe/DwUsbHostDxe.c   | 1635 ++++++++++++++++++++
 Platform/RaspberryPi/RPi3/Drivers/DwUsbHostDxe/DwUsbHostDxe.h   |  162 ++
 Platform/RaspberryPi/RPi3/Drivers/DwUsbHostDxe/DwUsbHostDxe.inf |   59 +
 Platform/RaspberryPi/RPi3/Drivers/DwUsbHostDxe/DwcHw.h          |  788 ++++++++++
 Platform/RaspberryPi/RPi3/Include/Protocol/DwUsb.h              |   53 +
 7 files changed, 3196 insertions(+)

diff --git a/Platform/RaspberryPi/RPi3/Drivers/DwUsbHostDxe/ComponentName.c b/Platform/RaspberryPi/RPi3/Drivers/DwUsbHostDxe/ComponentName.c
new file mode 100644
index 000000000000..056debb7c5f4
--- /dev/null
+++ b/Platform/RaspberryPi/RPi3/Drivers/DwUsbHostDxe/ComponentName.c
@@ -0,0 +1,225 @@
+/** @file
+ *
+ *  Copyright (c) 2018, Andrey Warkentin <andrey.warkentin@gmail.com>
+ *
+ *  This program and the accompanying materials
+ *  are licensed and made available under the terms and conditions of the BSD License
+ *  which accompanies this distribution.  The full text of the license may be found at
+ *  http://opensource.org/licenses/bsd-license.php
+ *
+ *  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+ *  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+ *
+ **/
+
+#include "DwUsbHostDxe.h"
+
+STATIC
+EFI_STATUS
+EFIAPI
+ComponentNameGetDriverName (
+  IN  EFI_COMPONENT_NAME_PROTOCOL  *This,
+  IN  CHAR8                        *Language,
+  OUT CHAR16                       **DriverName
+  );
+
+STATIC
+EFI_STATUS
+EFIAPI
+ComponentNameGetControllerName (
+  IN  EFI_COMPONENT_NAME_PROTOCOL *This,
+  IN  EFI_HANDLE                  ControllerHandle,
+  IN  EFI_HANDLE                  ChildHandle,
+  IN  CHAR8                       *Language,
+  OUT CHAR16                      **ControllerName
+  );
+
+//
+// EFI Component Name Protocol
+//
+GLOBAL_REMOVE_IF_UNREFERENCED EFI_COMPONENT_NAME_PROTOCOL gComponentName = {
+  ComponentNameGetDriverName,
+  ComponentNameGetControllerName,
+  "eng"
+};
+
+//
+// EFI Component Name 2 Protocol
+//
+GLOBAL_REMOVE_IF_UNREFERENCED EFI_COMPONENT_NAME2_PROTOCOL gComponentName2 = {
+  (EFI_COMPONENT_NAME2_GET_DRIVER_NAME)ComponentNameGetDriverName,
+  (EFI_COMPONENT_NAME2_GET_CONTROLLER_NAME)ComponentNameGetControllerName,
+  "en"
+};
+
+
+STATIC EFI_UNICODE_STRING_TABLE mDriverName[] = {
+  {
+    "eng;en",
+    (CHAR16*)L"Raspberry Pi USB Host Driver"
+  },
+  {
+    NULL,
+    NULL
+  }
+};
+
+STATIC EFI_UNICODE_STRING_TABLE mDeviceName[] = {
+  {
+    "eng;en",
+    (CHAR16*)L"Raspberry Pi USB Host"
+  },
+  {
+    NULL,
+    NULL
+  }
+};
+
+/**
+  Retrieves a Unicode string that is the user readable name of the driver.
+
+  This function retrieves the user readable name of a driver in the form of a
+  Unicode string. If the driver specified by This has a user readable name in
+  the language specified by Language, then a pointer to the driver name is
+  returned in DriverName, and EFI_SUCCESS is returned. If the driver specified
+  by This does not support the language specified by Language,
+  then EFI_UNSUPPORTED is returned.
+
+  @param  This[in]              A pointer to the EFI_COMPONENT_NAME2_PROTOCOL or
+                                EFI_COMPONENT_NAME_PROTOCOL instance.
+
+  @param  Language[in]          A pointer to a Null-terminated ASCII string
+                                array indicating the language. This is the
+                                language of the driver name that the caller is
+                                requesting, and it must match one of the
+                                languages specified in SupportedLanguages. The
+                                number of languages supported by a driver is up
+                                to the driver writer. Language is specified
+                                in RFC 4646 or ISO 639-2 language code format.
+
+  @param  DriverName[out]       A pointer to the Unicode string to return.
+                                This Unicode string is the name of the
+                                driver specified by This in the language
+                                specified by Language.
+
+  @retval EFI_SUCCESS           The Unicode string for the Driver specified by
+                                This and the language specified by Language was
+                                returned in DriverName.
+
+  @retval EFI_INVALID_PARAMETER Language is NULL.
+
+  @retval EFI_INVALID_PARAMETER DriverName is NULL.
+
+  @retval EFI_UNSUPPORTED       The driver specified by This does not support
+                                the language specified by Language.
+
+**/
+STATIC
+EFI_STATUS
+EFIAPI
+ComponentNameGetDriverName (
+  IN  EFI_COMPONENT_NAME_PROTOCOL  *This,
+  IN  CHAR8                        *Language,
+  OUT CHAR16                       **DriverName
+  )
+{
+  return LookupUnicodeString2 (
+           Language,
+           This->SupportedLanguages,
+           mDriverName,
+           DriverName,
+           (BOOLEAN)(This == &gComponentName)
+         );
+}
+
+/**
+  Retrieves a Unicode string that is the user readable name of the controller
+  that is being managed by a driver.
+
+  This function retrieves the user readable name of the controller specified by
+  ControllerHandle and ChildHandle in the form of a Unicode string. If the
+  driver specified by This has a user readable name in the language specified by
+  Language, then a pointer to the controller name is returned in ControllerName,
+  and EFI_SUCCESS is returned.  If the driver specified by This is not currently
+  managing the controller specified by ControllerHandle and ChildHandle,
+  then EFI_UNSUPPORTED is returned.  If the driver specified by This does not
+  support the language specified by Language, then EFI_UNSUPPORTED is returned.
+
+  @param  This[in]              A pointer to the EFI_COMPONENT_NAME2_PROTOCOL or
+                                EFI_COMPONENT_NAME_PROTOCOL instance.
+
+  @param  ControllerHandle[in]  The handle of a controller that the driver
+                                specified by This is managing.  This handle
+                                specifies the controller whose name is to be
+                                returned.
+
+  @param  ChildHandle[in]       The handle of the child controller to retrieve
+                                the name of.  This is an optional parameter that
+                                may be NULL.  It will be NULL for device
+                                drivers.  It will also be NULL for a bus drivers
+                                that wish to retrieve the name of the bus
+                                controller.  It will not be NULL for a bus
+                                driver that wishes to retrieve the name of a
+                                child controller.
+
+  @param  Language[in]          A pointer to a Null-terminated ASCII string
+                                array indicating the language.  This is the
+                                language of the driver name that the caller is
+                                requesting, and it must match one of the
+                                languages specified in SupportedLanguages. The
+                                number of languages supported by a driver is up
+                                to the driver writer. Language is specified in
+                                RFC 4646 or ISO 639-2 language code format.
+
+  @param  ControllerName[out]   A pointer to the Unicode string to return.
+                                This Unicode string is the name of the
+                                controller specified by ControllerHandle and
+                                ChildHandle in the language specified by
+                                Language from the point of view of the driver
+                                specified by This.
+
+  @retval EFI_SUCCESS           The Unicode string for the user readable name in
+                                the language specified by Language for the
+                                driver specified by This was returned in
+                                DriverName.
+
+  @retval EFI_INVALID_PARAMETER ControllerHandle is NULL.
+
+  @retval EFI_INVALID_PARAMETER ChildHandle is not NULL and it is not a valid
+                                EFI_HANDLE.
+
+  @retval EFI_INVALID_PARAMETER Language is NULL.
+
+  @retval EFI_INVALID_PARAMETER ControllerName is NULL.
+
+  @retval EFI_UNSUPPORTED       The driver specified by This is not currently
+                                managing the controller specified by
+                                ControllerHandle and ChildHandle.
+
+  @retval EFI_UNSUPPORTED       The driver specified by This does not support
+                                the language specified by Language.
+
+**/
+STATIC
+EFI_STATUS
+EFIAPI
+ComponentNameGetControllerName (
+  IN  EFI_COMPONENT_NAME_PROTOCOL *This,
+  IN  EFI_HANDLE                  ControllerHandle,
+  IN  EFI_HANDLE                  ChildHandle,
+  IN  CHAR8                       *Language,
+  OUT CHAR16                      **ControllerName
+  )
+{
+  if (ChildHandle != NULL) {
+    return EFI_UNSUPPORTED;
+  }
+
+  return LookupUnicodeString2 (
+           Language,
+           This->SupportedLanguages,
+           mDeviceName,
+           ControllerName,
+           (BOOLEAN)(This == &gComponentName)
+         );
+}
diff --git a/Platform/RaspberryPi/RPi3/Drivers/DwUsbHostDxe/DriverBinding.c b/Platform/RaspberryPi/RPi3/Drivers/DwUsbHostDxe/DriverBinding.c
new file mode 100644
index 000000000000..05aa133fa023
--- /dev/null
+++ b/Platform/RaspberryPi/RPi3/Drivers/DwUsbHostDxe/DriverBinding.c
@@ -0,0 +1,274 @@
+/** @file
+ *
+ *  Copyright (c) 2018, Andrey Warkentin <andrey.warkentin@gmail.com>
+ *
+ *  This program and the accompanying materials
+ *  are licensed and made available under the terms and conditions of the BSD License
+ *  which accompanies this distribution.  The full text of the license may be found at
+ *  http://opensource.org/licenses/bsd-license.php
+ *
+ *  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+ *  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+ *
+ **/
+
+#include "DwUsbHostDxe.h"
+
+STATIC
+EFI_STATUS
+EFIAPI
+DriverSupported (
+  IN  EFI_DRIVER_BINDING_PROTOCOL *This,
+  IN  EFI_HANDLE                  Controller,
+  IN  EFI_DEVICE_PATH_PROTOCOL    *RemainingDevicePath
+  );
+
+STATIC
+EFI_STATUS
+EFIAPI
+DriverStart (
+  IN  EFI_DRIVER_BINDING_PROTOCOL *This,
+  IN  EFI_HANDLE                  Controller,
+  IN  EFI_DEVICE_PATH_PROTOCOL    *RemainingDevicePath
+  );
+
+STATIC
+EFI_STATUS
+EFIAPI
+DriverStop (
+  IN  EFI_DRIVER_BINDING_PROTOCOL *This,
+  IN  EFI_HANDLE                  Controller,
+  IN  UINTN                       NumberOfChildren,
+  IN  EFI_HANDLE                  *ChildHandleBuffer
+  );
+
+STATIC EFI_DRIVER_BINDING_PROTOCOL mDriverBinding = {
+  DriverSupported,
+  DriverStart,
+  DriverStop,
+  0xa,
+  NULL,
+  NULL
+};
+
+STATIC EFI_DW_DEVICE_PATH mDevicePath = {
+  {
+    {
+      HARDWARE_DEVICE_PATH,
+      HW_VENDOR_DP,
+      {
+        (UINT8)(sizeof (VENDOR_DEVICE_PATH)),
+        (UINT8)((sizeof (VENDOR_DEVICE_PATH)) >> 8),
+      }
+    },
+    EFI_CALLER_ID_GUID
+  },
+  {
+    END_DEVICE_PATH_TYPE,
+    END_ENTIRE_DEVICE_PATH_SUBTYPE,
+    {
+      sizeof (EFI_DEVICE_PATH_PROTOCOL),
+      0
+    }
+  }
+};
+
+STATIC EFI_HANDLE mDevice;
+STATIC RASPBERRY_PI_FIRMWARE_PROTOCOL *mFwProtocol;
+
+STATIC
+EFI_STATUS
+EFIAPI
+DriverSupported (
+  IN  EFI_DRIVER_BINDING_PROTOCOL *This,
+  IN  EFI_HANDLE                  Controller,
+  IN  EFI_DEVICE_PATH_PROTOCOL    *RemainingDevicePath
+  )
+{
+  VOID *Temp;
+  EFI_STATUS Status;
+
+  if (Controller != mDevice) {
+    return EFI_UNSUPPORTED;
+  }
+
+  Status = gBS->LocateProtocol (&gRaspberryPiFirmwareProtocolGuid, NULL,
+                  (VOID**)&mFwProtocol);
+  if (EFI_ERROR (Status)) {
+    return EFI_NOT_READY;
+  }
+
+  if (gBS->HandleProtocol (Controller, &gEfiUsb2HcProtocolGuid,
+             (VOID**)&Temp) == EFI_SUCCESS) {
+    return EFI_ALREADY_STARTED;
+  }
+
+  return EFI_SUCCESS;
+}
+
+STATIC
+EFI_STATUS
+EFIAPI
+DriverStart (
+  IN  EFI_DRIVER_BINDING_PROTOCOL *This,
+  IN  EFI_HANDLE                  Controller,
+  IN  EFI_DEVICE_PATH_PROTOCOL    *RemainingDevicePath
+  )
+{
+  VOID *Dummy;
+  EFI_STATUS Status;
+  DWUSB_OTGHC_DEV *DwHc = NULL;
+
+  Status = gBS->OpenProtocol (
+                  Controller,
+                  &gEfiCallerIdGuid,
+                  (VOID**)&Dummy,
+                  This->DriverBindingHandle,
+                  Controller,
+                  EFI_OPEN_PROTOCOL_BY_DRIVER
+                );
+  if (EFI_ERROR (Status)) {
+    return Status;
+  }
+
+  Status = mFwProtocol->SetPowerState (RPI_MBOX_POWER_STATE_USB_HCD, TRUE, TRUE);
+  if (EFI_ERROR (Status)) {
+    DEBUG ((DEBUG_ERROR, "Couldn't power on USB: %r\n", Status));
+    return Status;
+  }
+
+  Status = CreateDwUsbHc (&DwHc);
+  if (EFI_ERROR (Status)) {
+    goto Exit;
+  }
+
+  /*
+   * UsbBusDxe as of b4e96b82b4e2e47e95014b51787ba5b43abac784 expects
+   * the HCD to do this. There is no agent invoking DwHcReset anymore.
+   */
+  DwHcReset (&DwHc->DwUsbOtgHc, 0);
+  DwHcSetState (&DwHc->DwUsbOtgHc, EfiUsbHcStateOperational);
+
+  Status = gBS->InstallMultipleProtocolInterfaces (
+    &Controller,
+    &gEfiUsb2HcProtocolGuid, &DwHc->DwUsbOtgHc,
+    NULL
+  );
+
+Exit:
+  if (EFI_ERROR (Status)) {
+    DEBUG ((DEBUG_ERROR, "Could not start DwUsbHostDxe: %r\n", Status));
+
+    DestroyDwUsbHc (DwHc);
+
+    mFwProtocol->SetPowerState (RPI_MBOX_POWER_STATE_USB_HCD, FALSE, FALSE);
+
+    gBS->CloseProtocol (
+           Controller,
+           &gEfiCallerIdGuid,
+           This->DriverBindingHandle,
+           Controller
+         );
+  }
+  return Status;
+}
+
+STATIC
+EFI_STATUS
+EFIAPI
+DriverStop (
+  IN  EFI_DRIVER_BINDING_PROTOCOL *This,
+  IN  EFI_HANDLE                  Controller,
+  IN  UINTN                       NumberOfChildren,
+  IN  EFI_HANDLE                  *ChildHandleBuffer
+  )
+{
+  EFI_STATUS Status;
+  DWUSB_OTGHC_DEV *DwHc;
+  EFI_USB2_HC_PROTOCOL *HcProtocol;
+
+  Status = gBS->HandleProtocol (
+                  Controller,
+                  &gEfiUsb2HcProtocolGuid,
+                  (VOID**)&HcProtocol
+                );
+  if (EFI_ERROR (Status)) {
+    DEBUG ((DEBUG_ERROR, "DriverStop: HandleProtocol: %r\n", Status));
+    return Status;
+  }
+
+  DwHc = DWHC_FROM_THIS (HcProtocol);
+
+  Status = gBS->UninstallMultipleProtocolInterfaces (
+    Controller,
+    &gEfiUsb2HcProtocolGuid, &DwHc->DwUsbOtgHc,
+    NULL);
+  if (EFI_ERROR (Status)) {
+    DEBUG ((DEBUG_ERROR, "DriverStop: UninstallMultipleProtocolInterfaces: %r\n",
+      Status));
+    return Status;
+  }
+
+  DwHcQuiesce (DwHc);
+  DestroyDwUsbHc (DwHc);
+
+  gBS->CloseProtocol (
+         Controller,
+         &gEfiCallerIdGuid,
+         This->DriverBindingHandle,
+         Controller
+       );
+
+  return EFI_SUCCESS;
+}
+
+/**
+   UEFI Driver Entry Point API
+
+   @param  ImageHandle       EFI_HANDLE.
+   @param  SystemTable       EFI_SYSTEM_TABLE.
+
+   @return EFI_SUCCESS       Success.
+   EFI_DEVICE_ERROR  Fail.
+**/
+
+EFI_STATUS
+EFIAPI
+DwUsbHostEntryPoint (
+  IN  EFI_HANDLE ImageHandle,
+  IN  EFI_SYSTEM_TABLE *SystemTable
+  )
+{
+  EFI_STATUS Status;
+
+  Status = gBS->InstallMultipleProtocolInterfaces (
+    &mDevice,
+    &gEfiDevicePathProtocolGuid, &mDevicePath,
+    &gEfiCallerIdGuid, NULL,
+    NULL);
+  if (EFI_ERROR (Status)) {
+    DEBUG ((DEBUG_ERROR, "InstallMultipleProtocolInterfaces: %r\n", Status));
+    return Status;
+  }
+
+  Status = EfiLibInstallDriverBindingComponentName2 (
+             ImageHandle,
+             SystemTable,
+             &mDriverBinding,
+             ImageHandle,
+             &gComponentName,
+             &gComponentName2
+           );
+
+  if (EFI_ERROR (Status)) {
+    DEBUG ((DEBUG_ERROR, "EfiLibInstallDriverBindingComponentName2: %r\n", Status));
+    gBS->UninstallMultipleProtocolInterfaces (
+           mDevice,
+           &gEfiDevicePathProtocolGuid, &mDevicePath,
+           &gEfiCallerIdGuid, NULL,
+           NULL
+         );
+  }
+
+  return Status;
+}
diff --git a/Platform/RaspberryPi/RPi3/Drivers/DwUsbHostDxe/DwUsbHostDxe.c b/Platform/RaspberryPi/RPi3/Drivers/DwUsbHostDxe/DwUsbHostDxe.c
new file mode 100644
index 000000000000..8905a4d18fc2
--- /dev/null
+++ b/Platform/RaspberryPi/RPi3/Drivers/DwUsbHostDxe/DwUsbHostDxe.c
@@ -0,0 +1,1635 @@
+/** @file
+ *
+ *  Copyright (c) 2017-2018, Andrey Warkentin <andrey.warkentin@gmail.com>
+ *  Copyright (c) 2015-2016, Linaro Limited. All rights reserved.
+ *
+ *  This program and the accompanying materials
+ *  are licensed and made available under the terms and conditions of the BSD License
+ *  which accompanies this distribution.  The full text of the license may be found at
+ *  http://opensource.org/licenses/bsd-license.php
+ *
+ *  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+ *  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+ *
+ **/
+
+#include "DwUsbHostDxe.h"
+#include "DwcHw.h"
+
+/*
+ * Excessive (10s) timeout for reset.
+ */
+#define DW_HC_RESET_TIMEOUT_MS (10000)
+
+  /*
+   * TimerPeriodic to account for timeout processing
+   * within DwHcTransfer.
+   */
+#define TimerForTransfer TimerRelative
+
+/*
+ * https://www.quicklogic.com/assets/pdf/data-sheets/QL-Hi-Speed-USB-2.0-OTG-Controller-Data-Sheet.pdf
+ */
+
+typedef enum {
+  XFER_NOT_HALTED,
+  XFER_ERROR,
+  XFER_CSPLIT,
+  XFER_NAK,
+  XFER_STALL,
+  XFER_FRMOVRUN,
+  XFER_DONE
+} CHANNEL_HALT_REASON;
+
+typedef struct {
+  BOOLEAN Splitting;
+  BOOLEAN SplitStart;
+  UINT32 Tries;
+} SPLIT_CONTROL;
+
+EFI_STATUS
+DwHcInit (
+  IN DWUSB_OTGHC_DEV *DwHc,
+  IN EFI_EVENT       Timeout
+  );
+
+EFI_STATUS
+DwCoreInit (
+  IN DWUSB_OTGHC_DEV *DwHc,
+  IN EFI_EVENT        Timeout
+  );
+
+UINT32
+Wait4Bit (
+  IN  EFI_EVENT Timeout,
+  IN  UINT32    Reg,
+  IN  UINT32    Mask,
+  IN  BOOLEAN   Set
+  )
+{
+  UINT32 Value;
+
+  do {
+    Value = MmioRead32 (Reg);
+    if (!Set) {
+      Value = ~Value;
+    }
+
+    if ((Value & Mask) == Mask) {
+      return 0;
+    }
+  } while (EFI_ERROR (gBS->CheckEvent (Timeout)));
+
+  DEBUG ((DEBUG_ERROR, "Wait4Bit: %a timeout (reg:0x%x, value:0x%x, mask:0x%x)\n",
+    Set ? "set" : "clear", Reg, Set ? Value : ~Value, Mask));
+
+  return 1;
+}
+
+CHANNEL_HALT_REASON
+Wait4Chhltd (
+  IN  DWUSB_OTGHC_DEV *DwHc,
+  IN  EFI_EVENT       Timeout,
+  IN  UINT32          Channel,
+  IN  UINT32          *Sub,
+  IN  UINT32          *Toggle,
+  IN  BOOLEAN         IgnoreAck,
+  IN  SPLIT_CONTROL   *Split
+  )
+{
+  INT32   Ret;
+  UINT32  Hcint, Hctsiz;
+  UINT32  HcintCompHltAck = DWC2_HCINT_XFERCOMP;
+
+  MicroSecondDelay (100);
+  Ret = Wait4Bit (Timeout, DwHc->DwUsbBase + HCINT (Channel), DWC2_HCINT_CHHLTD, 1);
+  if (Ret) {
+    DEBUG ((DEBUG_ERROR, "Channel %u did not halt\n", Channel));
+    return XFER_NOT_HALTED;
+  }
+
+  MicroSecondDelay (100);
+  Hcint = MmioRead32 (DwHc->DwUsbBase + HCINT (Channel));
+
+  ASSERT ((Hcint & DWC2_HCINT_CHHLTD) != 0);
+  Hcint &= ~DWC2_HCINT_CHHLTD;
+
+  if (!IgnoreAck ||
+      (Split->Splitting && Split->SplitStart)) {
+    HcintCompHltAck |= DWC2_HCINT_ACK;
+  } else {
+    Hcint &= ~DWC2_HCINT_ACK;
+  }
+
+  if ((Hcint & DWC2_HCINT_XACTERR) != 0) {
+    return XFER_ERROR;
+  }
+
+  if ((Hcint & DWC2_HCINT_NYET) != 0) {
+    return XFER_CSPLIT;
+  }
+
+  if ((Hcint & DWC2_HCINT_NAK) != 0) {
+    return XFER_NAK;
+  }
+
+  if ((Hcint & DWC2_HCINT_STALL) != 0) {
+    return XFER_STALL;
+  }
+
+  if ((Hcint & DWC2_HCINT_FRMOVRUN) != 0) {
+    return XFER_FRMOVRUN;
+  }
+
+  if (Split->Splitting &&
+      Split->SplitStart &&
+      ((Hcint & DWC2_HCINT_ACK) != 0)) {
+    Split->SplitStart = FALSE;
+    Split->Tries = 0;
+    return XFER_CSPLIT;
+  }
+
+  if (Hcint != HcintCompHltAck) {
+    DEBUG ((DEBUG_ERROR, "Wait4Chhltd: Channel %u HCINT 0x%x %a%a\n",
+      Channel, Hcint,
+      IgnoreAck ? "IgnoreAck " : "",
+      Split->SplitStart ? "split start" :
+      (Split->Splitting ? "split complete" : "")));
+    return XFER_ERROR;
+  }
+
+  Hctsiz = MmioRead32 (DwHc->DwUsbBase + HCTSIZ (Channel));
+  *Sub = (Hctsiz & DWC2_HCTSIZ_XFERSIZE_MASK) >> DWC2_HCTSIZ_XFERSIZE_OFFSET;
+  *Toggle = (Hctsiz & DWC2_HCTSIZ_PID_MASK) >> DWC2_HCTSIZ_PID_OFFSET;
+
+  return XFER_DONE;
+}
+
+VOID
+DwOtgHcInit (
+  IN  DWUSB_OTGHC_DEV    *DwHc,
+  IN  UINT8              HcNum,
+  IN  EFI_USB2_HC_TRANSACTION_TRANSLATOR  *Translator,
+  IN  UINT8              DeviceSpeed,
+  IN  UINT8              DevAddr,
+  IN  UINT8              Endpoint,
+  IN  UINT8              EpDir,
+  IN  UINT8              EpType,
+  IN  UINT16             MaxPacket,
+  IN  SPLIT_CONTROL *SplitControl
+  )
+{
+  UINT32 Split = 0;
+  UINT32 Hcchar = (DevAddr << DWC2_HCCHAR_DEVADDR_OFFSET) |
+    (Endpoint << DWC2_HCCHAR_EPNUM_OFFSET) |
+    (EpDir << DWC2_HCCHAR_EPDIR_OFFSET) |
+    (EpType << DWC2_HCCHAR_EPTYPE_OFFSET) |
+    (MaxPacket << DWC2_HCCHAR_MPS_OFFSET) |
+    ((DeviceSpeed == EFI_USB_SPEED_LOW) ? DWC2_HCCHAR_LSPDDEV : 0);
+
+  MmioWrite32 (DwHc->DwUsbBase + HCINT (HcNum), 0x3FFF);
+
+  MmioWrite32 (DwHc->DwUsbBase + HCCHAR (HcNum), Hcchar);
+
+  if (SplitControl->Splitting) {
+    Split = DWC2_HCSPLT_SPLTENA |
+      ((Translator->TranslatorPortNumber) << DWC2_HCSPLT_PRTADDR_OFFSET) |
+      ((Translator->TranslatorHubAddress) << DWC2_HCSPLT_HUBADDR_OFFSET);
+
+    if (!SplitControl->SplitStart) {
+      Split |= DWC2_HCSPLT_COMPSPLT;
+    }
+  }
+
+  MmioWrite32 (DwHc->DwUsbBase + HCSPLT (HcNum), Split);
+}
+
+EFI_STATUS
+DwCoreReset (
+  IN  DWUSB_OTGHC_DEV *DwHc,
+  IN  EFI_EVENT Timeout
+  )
+{
+  UINT32  Status;
+
+  Status = Wait4Bit (Timeout, DwHc->DwUsbBase + GRSTCTL, DWC2_GRSTCTL_AHBIDLE, 1);
+  if (Status) {
+    DEBUG ((DEBUG_ERROR, "DwCoreReset: AHBIDLE Timeout!\n"));
+    return Status;
+  }
+
+  MmioWrite32 (DwHc->DwUsbBase + GRSTCTL, DWC2_GRSTCTL_CSFTRST);
+
+  Status = Wait4Bit (Timeout, DwHc->DwUsbBase + GRSTCTL, DWC2_GRSTCTL_CSFTRST, 0);
+  if (Status) {
+    DEBUG ((DEBUG_ERROR, "DwCoreReset: CSFTRST Timeout!\n"));
+    return Status;
+  }
+
+  MicroSecondDelay (100000);
+  return EFI_SUCCESS;
+}
+
+STATIC
+EFI_STATUS
+DwHcTransfer (
+  IN      DWUSB_OTGHC_DEV        *DwHc,
+  IN      EFI_EVENT              Timeout,
+  IN      UINT32                 Channel,
+  IN      EFI_USB2_HC_TRANSACTION_TRANSLATOR *Translator,
+  IN      UINT8                  DeviceSpeed,
+  IN      UINT8                  DeviceAddress,
+  IN      UINTN                  MaximumPacketLength,
+  IN  OUT UINT32                *Pid,
+  IN      UINT32                 TransferDirection,
+  IN  OUT VOID                  *Data,
+  IN  OUT UINTN                 *DataLength,
+  IN      UINT32                 EpAddress,
+  IN      UINT32                 EpType,
+  OUT     UINT32                 *TransferResult,
+  IN      BOOLEAN                IgnoreAck
+  )
+{
+  UINT32                          TxferLen;
+  UINT32                          Done = 0;
+  UINT32                          NumPackets;
+  UINT32                          Sub;
+  UINT32                          Ret = 0;
+  UINT32                          StopTransfer = 0;
+  EFI_STATUS                      Status = EFI_SUCCESS;
+  SPLIT_CONTROL                   Split = { 0 };
+
+  EFI_TPL Tpl = gBS->RaiseTPL (TPL_NOTIFY);
+
+  *TransferResult = EFI_USB_NOERROR;
+
+  do {
+  RestartXfer:
+    if (DeviceSpeed == EFI_USB_SPEED_LOW ||
+        DeviceSpeed == EFI_USB_SPEED_FULL) {
+      Split.Splitting = TRUE;
+      Split.SplitStart = TRUE;
+      Split.Tries = 0;
+    }
+
+    TxferLen = *DataLength - Done;
+
+    if (TxferLen > DWC2_MAX_TRANSFER_SIZE) {
+      TxferLen = DWC2_MAX_TRANSFER_SIZE - MaximumPacketLength + 1;
+    }
+
+    if (TxferLen > DWC2_DATA_BUF_SIZE) {
+      TxferLen = DWC2_DATA_BUF_SIZE - MaximumPacketLength + 1;
+    }
+
+    if (Split.Splitting || TxferLen == 0) {
+      NumPackets = 1;
+    } else {
+      NumPackets = (TxferLen + MaximumPacketLength - 1) / MaximumPacketLength;
+      if (NumPackets > DWC2_MAX_PACKET_COUNT) {
+        NumPackets = DWC2_MAX_PACKET_COUNT;
+        TxferLen = NumPackets * MaximumPacketLength;
+      }
+    }
+
+    if (TransferDirection) { // in
+      TxferLen = NumPackets * MaximumPacketLength;
+    } else {
+      CopyMem (DwHc->AlignedBuffer, Data + Done, TxferLen);
+      ArmDataSynchronizationBarrier ();
+    }
+
+  RestartChannel:
+    MmioWrite32 (DwHc->DwUsbBase + HCDMA (Channel),
+      (UINTN)DwHc->AlignedBufferBusAddress);
+
+    DwOtgHcInit (DwHc, Channel, Translator, DeviceSpeed,
+      DeviceAddress, EpAddress,
+      TransferDirection, EpType,
+      MaximumPacketLength, &Split);
+
+    MmioWrite32 (DwHc->DwUsbBase + HCTSIZ (Channel),
+      (TxferLen << DWC2_HCTSIZ_XFERSIZE_OFFSET) |
+      (NumPackets << DWC2_HCTSIZ_PKTCNT_OFFSET) |
+      (*Pid << DWC2_HCTSIZ_PID_OFFSET));
+
+    MmioAndThenOr32 (DwHc->DwUsbBase + HCCHAR (Channel),
+      ~(DWC2_HCCHAR_MULTICNT_MASK |
+        DWC2_HCCHAR_CHEN |
+        DWC2_HCCHAR_CHDIS),
+        ((1 << DWC2_HCCHAR_MULTICNT_OFFSET) |
+          DWC2_HCCHAR_CHEN));
+
+    Ret = Wait4Chhltd (DwHc, Timeout, Channel, &Sub, Pid, IgnoreAck, &Split);
+
+    if (Ret == XFER_NOT_HALTED) {
+      /*
+       * FIXME: do proper channel reset.
+       */
+      MmioWrite32 (DwHc->DwUsbBase + HCCHAR (Channel), DWC2_HCCHAR_CHDIS);
+
+      *TransferResult = EFI_USB_ERR_TIMEOUT;
+      Status = EFI_DEVICE_ERROR;
+      break;
+    } else if (Ret == XFER_STALL) {
+      *TransferResult = EFI_USB_ERR_STALL;
+      Status = EFI_DEVICE_ERROR;
+      break;
+    } else if (Ret == XFER_CSPLIT) {
+      ASSERT (Split.Splitting);
+
+      if (Split.Tries++ < 3) {
+        goto RestartChannel;
+      }
+
+      goto RestartXfer;
+    } else if (Ret == XFER_ERROR) {
+      *TransferResult =
+        EFI_USB_ERR_CRC |
+        EFI_USB_ERR_TIMEOUT |
+        EFI_USB_ERR_BITSTUFF |
+        EFI_USB_ERR_SYSTEM;
+      Status = EFI_DEVICE_ERROR;
+      break;
+    } else if (Ret == XFER_FRMOVRUN) {
+      goto RestartChannel;
+    } else if (Ret == XFER_NAK) {
+      if (Split.Splitting &&
+          (EpType == DWC2_HCCHAR_EPTYPE_CONTROL)) {
+        goto RestartXfer;
+      }
+
+      *TransferResult = EFI_USB_ERR_NAK;
+      Status = EFI_DEVICE_ERROR;
+      break;
+    }
+
+    if (TransferDirection) { // in
+      ArmDataSynchronizationBarrier ();
+      TxferLen -= Sub;
+      CopyMem (Data + Done, DwHc->AlignedBuffer, TxferLen);
+      if (Sub) {
+        StopTransfer = 1;
+      }
+    }
+
+    Done += TxferLen;
+  } while (Done < *DataLength && !StopTransfer);
+
+  MmioWrite32 (DwHc->DwUsbBase + HCINTMSK (Channel), 0);
+  MmioWrite32 (DwHc->DwUsbBase + HCINT (Channel), 0xFFFFFFFF);
+
+  *DataLength = Done;
+
+  gBS->RestoreTPL (Tpl);
+
+  ASSERT (!EFI_ERROR (Status) || *TransferResult != EFI_USB_NOERROR);
+
+  return Status;
+}
+
+STATIC
+DWUSB_DEFERRED_REQ *
+DwHcFindDeferredTransfer (
+  IN  DWUSB_OTGHC_DEV *DwHc,
+  IN  UINT8 DeviceAddress,
+  IN  UINT8 EndPointAddress
+  )
+{
+  LIST_ENTRY *Entry;
+
+  EFI_LIST_FOR_EACH (Entry, &DwHc->DeferredList) {
+    DWUSB_DEFERRED_REQ *Req = EFI_LIST_CONTAINER (Entry, DWUSB_DEFERRED_REQ, List);
+
+    if (Req->DeviceAddress == DeviceAddress &&
+        Req->EpAddress == (EndPointAddress & 0xF) &&
+        Req->TransferDirection == ((EndPointAddress >> 7) & 0x01)) {
+      return Req;
+    }
+  }
+
+  return NULL;
+}
+
+STATIC
+VOID
+DwHcDeferredTransfer (
+  IN  DWUSB_DEFERRED_REQ *Req
+  )
+{
+  EFI_STATUS Status;
+  EFI_EVENT TimeoutEvt = NULL;
+
+  Status = gBS->CreateEvent (EVT_TIMER, 0, NULL, NULL, &TimeoutEvt);
+  ASSERT_EFI_ERROR (Status);
+  if (EFI_ERROR (Status)) {
+    goto Exit;
+  }
+
+  Status = gBS->SetTimer (TimeoutEvt, TimerForTransfer,
+                  EFI_TIMER_PERIOD_MILLISECONDS (Req->TimeOut));
+  ASSERT_EFI_ERROR (Status);
+  if (EFI_ERROR (Status)) {
+    goto Exit;
+  }
+
+  Req->TransferResult = EFI_USB_NOERROR;
+  Status = DwHcTransfer (Req->DwHc, TimeoutEvt,
+             Req->Channel, Req->Translator,
+             Req->DeviceSpeed, Req->DeviceAddress,
+             Req->MaximumPacketLength, &Req->Pid,
+             Req->TransferDirection, Req->Data, &Req->DataLength,
+             Req->EpAddress, Req->EpType, &Req->TransferResult,
+             Req->IgnoreAck);
+
+  if (Req->EpType == DWC2_HCCHAR_EPTYPE_INTR &&
+      Status == EFI_DEVICE_ERROR &&
+      Req->TransferResult == EFI_USB_ERR_NAK) {
+    /*
+     * Swallow the NAK, the upper layer expects us to resubmit automatically.
+     */
+    goto Exit;
+  }
+
+  Req->CallbackFunction (Req->Data, Req->DataLength,
+         Req->CallbackContext,
+         Req->TransferResult);
+Exit:
+  if (TimeoutEvt != NULL) {
+    gBS->CloseEvent (TimeoutEvt);
+  }
+}
+
+/**
+   EFI_USB2_HC_PROTOCOL APIs
+**/
+
+EFI_STATUS
+EFIAPI
+DwHcGetCapability (
+  IN  EFI_USB2_HC_PROTOCOL *This,
+  OUT UINT8                *MaxSpeed,
+  OUT UINT8                *PortNumber,
+  OUT UINT8                *Is64BitCapable
+  )
+{
+  if ((MaxSpeed == NULL) || (PortNumber == NULL) || (Is64BitCapable == NULL)) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  *MaxSpeed = EFI_USB_SPEED_HIGH;
+  *PortNumber = 1;
+  *Is64BitCapable = 1;
+
+  return EFI_SUCCESS;
+}
+
+EFI_STATUS
+EFIAPI
+DwHcReset (
+  IN EFI_USB2_HC_PROTOCOL *This,
+  IN UINT16               Attributes
+  )
+{
+  EFI_STATUS Status;
+  EFI_EVENT TimeoutEvt = NULL;
+
+  DWUSB_OTGHC_DEV *DwHc;
+  DwHc = DWHC_FROM_THIS (This);
+
+  Status = gBS->CreateEvent (EVT_TIMER, 0, NULL, NULL, &TimeoutEvt);
+  ASSERT_EFI_ERROR (Status);
+  if (EFI_ERROR (Status)) {
+    goto Exit;
+  }
+
+  Status = gBS->SetTimer (TimeoutEvt, TimerRelative,
+                  EFI_TIMER_PERIOD_MILLISECONDS (DW_HC_RESET_TIMEOUT_MS));
+  ASSERT_EFI_ERROR (Status);
+  if (EFI_ERROR (Status)) {
+    goto Exit;
+  }
+
+  Status = DwCoreInit (DwHc, TimeoutEvt);
+  if (Status != EFI_SUCCESS) {
+    DEBUG ((DEBUG_ERROR, "DwCoreInit failed\n"));
+    goto Exit;
+  }
+
+  Status = DwHcInit (DwHc, TimeoutEvt);
+  if (Status != EFI_SUCCESS) {
+    DEBUG ((DEBUG_ERROR, "DwHcInit failed\n"));
+    goto Exit;
+  }
+
+  MmioAndThenOr32 (DwHc->DwUsbBase + HPRT0,
+    ~(DWC2_HPRT0_PRTENA | DWC2_HPRT0_PRTCONNDET |
+      DWC2_HPRT0_PRTENCHNG | DWC2_HPRT0_PRTOVRCURRCHNG),
+    DWC2_HPRT0_PRTRST);
+
+  MicroSecondDelay (50000);
+
+  MmioAnd32 (DwHc->DwUsbBase + HPRT0, ~(DWC2_HPRT0_PRTENA | DWC2_HPRT0_PRTCONNDET |
+    DWC2_HPRT0_PRTENCHNG | DWC2_HPRT0_PRTOVRCURRCHNG |
+    DWC2_HPRT0_PRTRST));
+
+Exit:
+  if (TimeoutEvt != NULL) {
+    gBS->CloseEvent (TimeoutEvt);
+  }
+
+  return Status;
+}
+
+EFI_STATUS
+EFIAPI
+DwHcGetState (
+  IN  EFI_USB2_HC_PROTOCOL *This,
+  OUT EFI_USB_HC_STATE     *State
+  )
+{
+  DWUSB_OTGHC_DEV *DwHc;
+
+  DwHc = DWHC_FROM_THIS (This);
+
+  *State = DwHc->DwHcState;
+
+  return EFI_SUCCESS;
+}
+
+EFI_STATUS
+EFIAPI
+DwHcSetState (
+  IN  EFI_USB2_HC_PROTOCOL *This,
+  IN  EFI_USB_HC_STATE     State
+  )
+{
+  DWUSB_OTGHC_DEV *DwHc;
+
+  DwHc = DWHC_FROM_THIS (This);
+
+  DwHc->DwHcState = State;
+
+  return EFI_SUCCESS;
+}
+
+EFI_STATUS
+EFIAPI
+DwHcGetRootHubPortStatus (
+  IN  EFI_USB2_HC_PROTOCOL *This,
+  IN  UINT8                PortNumber,
+  OUT EFI_USB_PORT_STATUS  *PortStatus
+  )
+{
+  DWUSB_OTGHC_DEV *DwHc;
+  UINT32          Hprt0;
+
+  if (PortNumber > DWC2_HC_PORT) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  if (PortStatus == NULL) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  DwHc = DWHC_FROM_THIS (This);
+
+  PortStatus->PortStatus = 0;
+  PortStatus->PortChangeStatus = 0;
+  Hprt0 = MmioRead32 (DwHc->DwUsbBase + HPRT0);
+
+  if (Hprt0 & DWC2_HPRT0_PRTCONNSTS) {
+    PortStatus->PortStatus |= USB_PORT_STAT_CONNECTION;
+  }
+
+  if (Hprt0 & DWC2_HPRT0_PRTENA) {
+    PortStatus->PortStatus |= USB_PORT_STAT_ENABLE;
+  }
+
+  if (Hprt0 & DWC2_HPRT0_PRTSUSP) {
+    PortStatus->PortStatus |= USB_PORT_STAT_SUSPEND;
+  }
+
+  if (Hprt0 & DWC2_HPRT0_PRTOVRCURRACT) {
+    PortStatus->PortStatus |= USB_PORT_STAT_OVERCURRENT;
+  }
+
+  if (Hprt0 & DWC2_HPRT0_PRTRST) {
+    PortStatus->PortStatus |= USB_PORT_STAT_RESET;
+  }
+
+  if (Hprt0 & DWC2_HPRT0_PRTPWR) {
+    PortStatus->PortStatus |= USB_PORT_STAT_POWER;
+  }
+
+  PortStatus->PortStatus |= USB_PORT_STAT_HIGH_SPEED;
+
+  if (Hprt0 & DWC2_HPRT0_PRTENCHNG) {
+    //              PortStatus->PortChangeStatus |= USB_PORT_STAT_C_ENABLE;
+  }
+
+  if (Hprt0 & DWC2_HPRT0_PRTCONNDET) {
+    PortStatus->PortChangeStatus |= USB_PORT_STAT_C_CONNECTION;
+  }
+
+  if (Hprt0 & DWC2_HPRT0_PRTOVRCURRCHNG) {
+    PortStatus->PortChangeStatus |= USB_PORT_STAT_C_OVERCURRENT;
+  }
+
+  return EFI_SUCCESS;
+}
+
+EFI_STATUS
+EFIAPI
+DwHcSetRootHubPortFeature (
+  IN  EFI_USB2_HC_PROTOCOL *This,
+  IN  UINT8                PortNumber,
+  IN  EFI_USB_PORT_FEATURE PortFeature
+  )
+{
+  DWUSB_OTGHC_DEV         *DwHc;
+  UINT32                  Hprt0;
+  EFI_STATUS              Status = EFI_SUCCESS;
+
+  if (PortNumber > DWC2_HC_PORT) {
+    Status = EFI_INVALID_PARAMETER;
+    goto Exit;
+  }
+
+  DwHc = DWHC_FROM_THIS (This);
+
+  switch (PortFeature) {
+  case EfiUsbPortEnable:
+    break;
+  case EfiUsbPortSuspend:
+    Hprt0 = MmioRead32 (DwHc->DwUsbBase + HPRT0);
+    Hprt0 &= ~(DWC2_HPRT0_PRTENA | DWC2_HPRT0_PRTCONNDET |
+               DWC2_HPRT0_PRTENCHNG | DWC2_HPRT0_PRTOVRCURRCHNG);
+    Hprt0 |= DWC2_HPRT0_PRTSUSP;
+    MmioWrite32 (DwHc->DwUsbBase + HPRT0, Hprt0);
+    break;
+  case EfiUsbPortReset:
+    MmioAndThenOr32 (DwHc->DwUsbBase + HPRT0,
+      ~(DWC2_HPRT0_PRTENA | DWC2_HPRT0_PRTCONNDET |
+        DWC2_HPRT0_PRTENCHNG | DWC2_HPRT0_PRTOVRCURRCHNG),
+      DWC2_HPRT0_PRTRST);
+    MicroSecondDelay (50000);
+    MmioAnd32 (DwHc->DwUsbBase + HPRT0, ~DWC2_HPRT0_PRTRST);
+    break;
+  case EfiUsbPortPower:
+    Hprt0 = MmioRead32 (DwHc->DwUsbBase + HPRT0);
+    Hprt0 &= ~(DWC2_HPRT0_PRTENA | DWC2_HPRT0_PRTCONNDET |
+               DWC2_HPRT0_PRTENCHNG | DWC2_HPRT0_PRTOVRCURRCHNG);
+    Hprt0 |= DWC2_HPRT0_PRTPWR;
+    MmioWrite32 (DwHc->DwUsbBase + HPRT0, Hprt0);
+    break;
+  case EfiUsbPortOwner:
+    break;
+  default:
+    Status = EFI_INVALID_PARAMETER;
+    break;
+  }
+
+Exit:
+  return Status;
+}
+
+EFI_STATUS
+EFIAPI
+DwHcClearRootHubPortFeature (
+  IN  EFI_USB2_HC_PROTOCOL *This,
+  IN  UINT8                PortNumber,
+  IN  EFI_USB_PORT_FEATURE PortFeature
+  )
+{
+  DWUSB_OTGHC_DEV         *DwHc;
+  UINT32                  Hprt0;
+  EFI_STATUS              Status = EFI_SUCCESS;
+
+  if (PortNumber > DWC2_HC_PORT) {
+    Status = EFI_INVALID_PARAMETER;
+    goto Exit;
+  }
+
+  DwHc = DWHC_FROM_THIS (This);
+
+  switch (PortFeature) {
+  case EfiUsbPortEnable:
+    Hprt0 = MmioRead32 (DwHc->DwUsbBase + HPRT0);
+    Hprt0 &= ~(DWC2_HPRT0_PRTENA | DWC2_HPRT0_PRTCONNDET |
+               DWC2_HPRT0_PRTENCHNG | DWC2_HPRT0_PRTOVRCURRCHNG);
+    Hprt0 |= DWC2_HPRT0_PRTENA;
+    MmioWrite32 (DwHc->DwUsbBase + HPRT0, Hprt0);
+    break;
+  case EfiUsbPortReset:
+    MmioAndThenOr32 (DwHc->DwUsbBase + HPRT0,
+      ~(DWC2_HPRT0_PRTENA | DWC2_HPRT0_PRTCONNDET |
+        DWC2_HPRT0_PRTENCHNG | DWC2_HPRT0_PRTOVRCURRCHNG),
+      DWC2_HPRT0_PRTRST);
+    MicroSecondDelay (50000);
+    MmioAnd32 (DwHc->DwUsbBase + HPRT0, ~DWC2_HPRT0_PRTRST);
+    break;
+  case EfiUsbPortSuspend:
+    MmioWrite32 (DwHc->DwUsbBase + PCGCCTL, 0);
+    MicroSecondDelay (40000);
+    Hprt0 = MmioRead32 (DwHc->DwUsbBase + HPRT0);
+    Hprt0 &= ~(DWC2_HPRT0_PRTENA | DWC2_HPRT0_PRTCONNDET |
+               DWC2_HPRT0_PRTENCHNG | DWC2_HPRT0_PRTOVRCURRCHNG);
+    Hprt0 |= DWC2_HPRT0_PRTRES;
+    MmioWrite32 (DwHc->DwUsbBase + HPRT0, Hprt0);
+    Hprt0 &= ~DWC2_HPRT0_PRTSUSP;
+    MicroSecondDelay (150000);
+    Hprt0 &= ~DWC2_HPRT0_PRTRES;
+    MmioWrite32 (DwHc->DwUsbBase + HPRT0, Hprt0);
+    break;
+  case EfiUsbPortPower:
+    Hprt0 = MmioRead32 (DwHc->DwUsbBase + HPRT0);
+    Hprt0 &= ~(DWC2_HPRT0_PRTENA | DWC2_HPRT0_PRTCONNDET |
+               DWC2_HPRT0_PRTENCHNG | DWC2_HPRT0_PRTOVRCURRCHNG);
+    Hprt0 &= ~DWC2_HPRT0_PRTPWR;
+    MmioWrite32 (DwHc->DwUsbBase + HPRT0, Hprt0);
+    break;
+  case EfiUsbPortOwner:
+    break;
+  case EfiUsbPortConnectChange:
+    Hprt0 = MmioRead32 (DwHc->DwUsbBase + HPRT0);
+    Hprt0 &= ~DWC2_HPRT0_PRTCONNDET;
+    MmioWrite32 (DwHc->DwUsbBase + HPRT0, Hprt0);
+    break;
+  case EfiUsbPortResetChange:
+    break;
+  case EfiUsbPortEnableChange:
+    Hprt0 = MmioRead32 (DwHc->DwUsbBase + HPRT0);
+    Hprt0 &= ~DWC2_HPRT0_PRTENCHNG;
+    MmioWrite32 (DwHc->DwUsbBase + HPRT0, Hprt0);
+    break;
+  case EfiUsbPortSuspendChange:
+    break;
+  case EfiUsbPortOverCurrentChange:
+    Hprt0 = MmioRead32 (DwHc->DwUsbBase + HPRT0);
+    Hprt0 &= ~DWC2_HPRT0_PRTOVRCURRCHNG;
+    MmioWrite32 (DwHc->DwUsbBase + HPRT0, Hprt0);
+    break;
+  default:
+    Status = EFI_INVALID_PARAMETER;
+    break;
+  }
+
+Exit:
+  return Status;
+}
+
+EFI_STATUS
+EFIAPI
+DwHcControlTransfer (
+  IN  EFI_USB2_HC_PROTOCOL               *This,
+  IN  UINT8                              DeviceAddress,
+  IN  UINT8                              DeviceSpeed,
+  IN  UINTN                              MaximumPacketLength,
+  IN  EFI_USB_DEVICE_REQUEST             *Request,
+  IN  EFI_USB_DATA_DIRECTION             TransferDirection,
+  IN  OUT VOID                           *Data,
+  IN  OUT UINTN                          *DataLength,
+  IN  UINTN                              TimeOut,
+  IN  EFI_USB2_HC_TRANSACTION_TRANSLATOR *Translator,
+  OUT UINT32                             *TransferResult
+  )
+{
+  DWUSB_OTGHC_DEV         *DwHc;
+  EFI_STATUS              Status;
+  UINT32                  Pid;
+  UINTN                   Length;
+  EFI_USB_DATA_DIRECTION  StatusDirection;
+  UINT32                  Direction;
+  EFI_EVENT TimeoutEvt = NULL;
+
+  if ((Request == NULL) || (TransferResult == NULL)) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  if ((TransferDirection != EfiUsbDataIn) &&
+      (TransferDirection != EfiUsbDataOut) &&
+      (TransferDirection != EfiUsbNoData)) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  if ((TransferDirection == EfiUsbNoData) &&
+      ((Data != NULL) || (*DataLength != 0))) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  if ((TransferDirection != EfiUsbNoData) &&
+      ((Data == NULL) || (*DataLength == 0))) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  if ((MaximumPacketLength != 8) && (MaximumPacketLength != 16) &&
+      (MaximumPacketLength != 32) && (MaximumPacketLength != 64)) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  if ((DeviceSpeed == EFI_USB_SPEED_LOW) && (MaximumPacketLength != 8)) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  DwHc = DWHC_FROM_THIS (This);
+
+  Status = gBS->CreateEvent (EVT_TIMER, 0, NULL, NULL, &TimeoutEvt);
+  ASSERT_EFI_ERROR (Status);
+  if (EFI_ERROR (Status)) {
+    goto Exit;
+  }
+
+  Status = gBS->SetTimer (TimeoutEvt, TimerForTransfer,
+                  EFI_TIMER_PERIOD_MILLISECONDS (TimeOut));
+  ASSERT_EFI_ERROR (Status);
+  if (EFI_ERROR (Status)) {
+    goto Exit;
+  }
+
+  Pid = DWC2_HC_PID_SETUP;
+  Length = 8;
+  Status = DwHcTransfer (DwHc, TimeoutEvt,
+             DWC2_HC_CHANNEL, Translator, DeviceSpeed,
+             DeviceAddress, MaximumPacketLength, &Pid, 0,
+             Request, &Length, 0, DWC2_HCCHAR_EPTYPE_CONTROL,
+             TransferResult, 1);
+
+  if (EFI_ERROR (Status)) {
+    DEBUG ((DEBUG_ERROR, "Setup Stage Error for device 0x%x: 0x%x\n",
+      DeviceAddress, *TransferResult));
+    goto Exit;
+  }
+
+  if (Data) {
+    Pid = DWC2_HC_PID_DATA1;
+
+    if (TransferDirection == EfiUsbDataIn) {
+      Direction = 1;
+    } else {
+      Direction = 0;
+    }
+
+    Status = DwHcTransfer (DwHc, TimeoutEvt,
+               DWC2_HC_CHANNEL, Translator, DeviceSpeed,
+               DeviceAddress, MaximumPacketLength, &Pid,
+               Direction, Data, DataLength, 0,
+               DWC2_HCCHAR_EPTYPE_CONTROL,
+               TransferResult, 0);
+
+    if (EFI_ERROR (Status)) {
+      DEBUG ((DEBUG_ERROR, "Data Stage Error for device 0x%x: 0x%x\n",
+        DeviceAddress, *TransferResult));
+      goto Exit;
+    }
+  }
+
+  if ((TransferDirection == EfiUsbDataOut) ||
+      (TransferDirection == EfiUsbNoData)) {
+    StatusDirection = 1;
+  } else {
+    StatusDirection = 0;
+  }
+
+  Pid = DWC2_HC_PID_DATA1;
+  Length = 0;
+  Status = DwHcTransfer (DwHc, TimeoutEvt,
+             DWC2_HC_CHANNEL, Translator, DeviceSpeed,
+             DeviceAddress, MaximumPacketLength, &Pid,
+             StatusDirection, DwHc->StatusBuffer, &Length, 0,
+             DWC2_HCCHAR_EPTYPE_CONTROL, TransferResult, 1);
+
+  if (EFI_ERROR (Status)) {
+    DEBUG ((DEBUG_ERROR, "Status Stage Error for 0x%x: 0x%x\n",
+      DeviceAddress, *TransferResult));
+    goto Exit;
+  }
+
+Exit:
+  if (TimeoutEvt != NULL) {
+    gBS->CloseEvent (TimeoutEvt);
+  }
+
+  if (EFI_ERROR (Status)) {
+    DEBUG ((DEBUG_ERROR, "RequestType 0x%x\n", Request->RequestType));
+    DEBUG ((DEBUG_ERROR, "Request 0x%x\n", Request->Request));
+    DEBUG ((DEBUG_ERROR, "Value 0x%x\n", Request->Value));
+    DEBUG ((DEBUG_ERROR, "Index 0x%x\n", Request->Index));
+    DEBUG ((DEBUG_ERROR, "Length 0x%x\n", Request->Length));
+  }
+  return Status;
+}
+
+EFI_STATUS
+EFIAPI
+DwHcBulkTransfer (
+  IN  EFI_USB2_HC_PROTOCOL               *This,
+  IN  UINT8                              DeviceAddress,
+  IN  UINT8                              EndPointAddress,
+  IN  UINT8                              DeviceSpeed,
+  IN  UINTN                              MaximumPacketLength,
+  IN  UINT8                              DataBuffersNumber,
+  IN  OUT VOID                           *Data[EFI_USB_MAX_BULK_BUFFER_NUM],
+  IN  OUT UINTN                          *DataLength,
+  IN  OUT UINT8                          *DataToggle,
+  IN  UINTN                              TimeOut,
+  IN  EFI_USB2_HC_TRANSACTION_TRANSLATOR *Translator,
+  OUT UINT32                             *TransferResult
+  )
+{
+  DWUSB_OTGHC_DEV         *DwHc;
+  EFI_STATUS              Status;
+  UINT8                   TransferDirection;
+  UINT8                   EpAddress;
+  UINT32                  Pid;
+  EFI_EVENT TimeoutEvt = NULL;
+
+  if ((Data == NULL) || (Data[0] == NULL) ||
+      (DataLength == NULL) || (*DataLength == 0) ||
+      (TransferResult == NULL)) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  if ((*DataToggle != 0) && (*DataToggle != 1)) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  if ((DeviceSpeed == EFI_USB_SPEED_LOW) ||
+      (DeviceSpeed == EFI_USB_SPEED_SUPER)) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  if (((DeviceSpeed == EFI_USB_SPEED_FULL) && (MaximumPacketLength > 64)) ||
+      ((DeviceSpeed == EFI_USB_SPEED_HIGH) && (MaximumPacketLength > 512)))
+    return EFI_INVALID_PARAMETER;
+
+  DwHc = DWHC_FROM_THIS (This);
+
+  Status = gBS->CreateEvent (EVT_TIMER, 0, NULL, NULL, &TimeoutEvt);
+  ASSERT_EFI_ERROR (Status);
+  if (EFI_ERROR (Status)) {
+    goto Exit;
+  }
+
+  Status = gBS->SetTimer (TimeoutEvt, TimerForTransfer,
+                  EFI_TIMER_PERIOD_MILLISECONDS (TimeOut));
+  ASSERT_EFI_ERROR (Status);
+  if (EFI_ERROR (Status)) {
+    goto Exit;
+  }
+
+  Status = EFI_DEVICE_ERROR;
+  TransferDirection = (EndPointAddress >> 7) & 0x01;
+  EpAddress = EndPointAddress & 0x0F;
+  Pid = (*DataToggle << 1);
+
+  Status = DwHcTransfer (DwHc, TimeoutEvt,
+             DWC2_HC_CHANNEL_BULK, Translator, DeviceSpeed,
+             DeviceAddress, MaximumPacketLength, &Pid,
+             TransferDirection, Data[0], DataLength, EpAddress,
+             DWC2_HCCHAR_EPTYPE_BULK, TransferResult, 1);
+
+  *DataToggle = (Pid >> 1);
+
+Exit:
+  if (TimeoutEvt != NULL) {
+    gBS->CloseEvent (TimeoutEvt);
+  }
+
+  return Status;
+}
+
+EFI_STATUS
+EFIAPI
+DwHcAsyncInterruptTransfer (
+  IN  EFI_USB2_HC_PROTOCOL               *This,
+  IN  UINT8                              DeviceAddress,
+  IN  UINT8                              EndPointAddress,
+  IN  UINT8                              DeviceSpeed,
+  IN  UINTN                              MaximumPacketLength,
+  IN  BOOLEAN                            IsNewTransfer,
+  IN  OUT UINT8                          *DataToggle,
+  IN  UINTN                              PollingInterval,
+  IN  UINTN                              DataLength,
+  IN  EFI_USB2_HC_TRANSACTION_TRANSLATOR *Translator,
+  IN  EFI_ASYNC_USB_TRANSFER_CALLBACK    CallbackFunction,
+  IN  VOID                               *Context OPTIONAL
+  )
+{
+  DWUSB_OTGHC_DEV                 *DwHc;
+  EFI_STATUS                      Status;
+  EFI_TPL                         PreviousTpl;
+  VOID                            *Data = NULL;
+  DWUSB_DEFERRED_REQ              *FoundReq = NULL;
+  DWUSB_DEFERRED_REQ              *NewReq = NULL;
+
+  if (!(EndPointAddress & USB_ENDPOINT_DIR_IN)) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  DwHc = DWHC_FROM_THIS (This);
+
+  PreviousTpl = gBS->RaiseTPL (TPL_NOTIFY);
+  FoundReq = DwHcFindDeferredTransfer (DwHc, DeviceAddress, EndPointAddress);
+
+  if (IsNewTransfer) {
+    if (FoundReq != NULL) {
+      Status = EFI_INVALID_PARAMETER;
+      goto Done;
+    }
+
+    if (DataLength == 0) {
+      Status = EFI_INVALID_PARAMETER;
+      goto Done;
+    }
+
+    if ((*DataToggle != 1) && (*DataToggle != 0)) {
+      Status = EFI_INVALID_PARAMETER;
+      goto Done;
+    }
+
+    if ((PollingInterval > 255) || (PollingInterval < 1)) {
+      Status = EFI_INVALID_PARAMETER;
+      goto Done;
+    }
+
+    if (CallbackFunction == NULL) {
+      Status = EFI_INVALID_PARAMETER;
+      goto Done;
+    }
+  }
+
+  if (!IsNewTransfer) {
+    if (FoundReq == NULL) {
+      DEBUG ((DEBUG_ERROR, "%u:%u> transfer not found\n", DeviceAddress, EndPointAddress & 0xF));
+      Status = EFI_INVALID_PARAMETER;
+      goto Done;
+    }
+
+    *DataToggle = FoundReq->Pid >> 1;
+    FreePool (FoundReq->Data);
+
+    RemoveEntryList (&FoundReq->List);
+    FreePool (FoundReq);
+
+    Status = EFI_SUCCESS;
+    goto Done;
+  }
+
+  NewReq = AllocateZeroPool (sizeof *NewReq);
+  if (NewReq == NULL) {
+    DEBUG ((DEBUG_ERROR, "DwHcAsyncInterruptTransfer: failed to allocate req"));
+    Status = EFI_OUT_OF_RESOURCES;
+    goto Done;
+  }
+
+  Data = AllocateZeroPool (DataLength);
+  if (Data == NULL) {
+    DEBUG ((DEBUG_ERROR, "DwHcAsyncInterruptTransfer: failed to allocate buffer\n"));
+    Status = EFI_OUT_OF_RESOURCES;
+    goto Done;
+  }
+
+  InitializeListHead (&NewReq->List);
+
+  NewReq->FrameInterval = PollingInterval;
+  NewReq->TargetFrame = DwHc->CurrentFrame +
+    NewReq->FrameInterval;
+
+  NewReq->DwHc = DwHc;
+  NewReq->Channel = DWC2_HC_CHANNEL_ASYNC;
+  NewReq->Translator = Translator;
+  NewReq->DeviceSpeed = DeviceSpeed;
+  NewReq->DeviceAddress = DeviceAddress;
+  NewReq->MaximumPacketLength = MaximumPacketLength;
+  NewReq->TransferDirection = (EndPointAddress >> 7) & 0x01;
+  NewReq->Data = Data;
+  NewReq->DataLength = DataLength;
+  NewReq->Pid = *DataToggle << 1;
+  NewReq->EpAddress = EndPointAddress & 0x0F;
+  NewReq->EpType = DWC2_HCCHAR_EPTYPE_INTR;
+  NewReq->IgnoreAck = FALSE;
+  NewReq->CallbackFunction = CallbackFunction;
+  NewReq->CallbackContext = Context;
+  NewReq->TimeOut = 1000; /* 1000 ms */
+
+  InsertTailList (&DwHc->DeferredList, &NewReq->List);
+  Status = EFI_SUCCESS;
+
+Done:
+  gBS->RestoreTPL (PreviousTpl);
+
+  if (Status != EFI_SUCCESS) {
+    if (Data != NULL) {
+      FreePool (Data);
+    }
+
+    if (NewReq != NULL) {
+      FreePool (NewReq);
+    }
+  }
+
+  return Status;
+}
+
+EFI_STATUS
+EFIAPI
+DwHcSyncInterruptTransfer (
+  IN  EFI_USB2_HC_PROTOCOL               *This,
+  IN  UINT8                              DeviceAddress,
+  IN  UINT8                              EndPointAddress,
+  IN  UINT8                              DeviceSpeed,
+  IN  UINTN                              MaximumPacketLength,
+  IN  OUT VOID                           *Data,
+  IN  OUT UINTN                          *DataLength,
+  IN  OUT UINT8                          *DataToggle,
+  IN  UINTN                              TimeOut,
+  IN  EFI_USB2_HC_TRANSACTION_TRANSLATOR *Translator,
+  OUT UINT32                             *TransferResult
+  )
+{
+  DWUSB_OTGHC_DEV *DwHc;
+  EFI_STATUS Status;
+  EFI_EVENT TimeoutEvt;
+  UINT8 TransferDirection;
+  UINT8 EpAddress;
+  UINT32 Pid;
+
+  DwHc = DWHC_FROM_THIS (This);
+
+  if (Data == NULL ||
+      DataLength == NULL ||
+      DataToggle == NULL ||
+      TransferResult == NULL) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  if (*DataLength == 0) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  if ((*DataToggle != 0) && (*DataToggle != 1)) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  Status = gBS->CreateEvent (EVT_TIMER, 0, NULL, NULL, &TimeoutEvt);
+  if (EFI_ERROR (Status)) {
+    return Status;
+  }
+
+  Status = gBS->SetTimer (TimeoutEvt, TimerForTransfer,
+                  EFI_TIMER_PERIOD_MILLISECONDS (TimeOut));
+  if (EFI_ERROR (Status)) {
+    goto Exit;
+  }
+
+  TransferDirection = (EndPointAddress >> 7) & 0x01;
+  EpAddress = EndPointAddress & 0x0F;
+  Pid = (*DataToggle << 1);
+  Status = DwHcTransfer (DwHc, TimeoutEvt,
+             DWC2_HC_CHANNEL_SYNC, Translator,
+             DeviceSpeed, DeviceAddress,
+             MaximumPacketLength,
+             &Pid, TransferDirection, Data,
+             DataLength, EpAddress,
+             DWC2_HCCHAR_EPTYPE_INTR,
+             TransferResult, 0);
+  *DataToggle = (Pid >> 1);
+
+Exit:
+  if (TimeoutEvt != NULL) {
+    gBS->CloseEvent (TimeoutEvt);
+  }
+  return Status;
+}
+
+EFI_STATUS
+EFIAPI
+DwHcIsochronousTransfer (
+  IN  EFI_USB2_HC_PROTOCOL               *This,
+  IN  UINT8                              DeviceAddress,
+  IN  UINT8                              EndPointAddress,
+  IN  UINT8                              DeviceSpeed,
+  IN  UINTN                              MaximumPacketLength,
+  IN  UINT8                              DataBuffersNumber,
+  IN  OUT VOID                           *Data[EFI_USB_MAX_ISO_BUFFER_NUM],
+  IN  UINTN                              DataLength,
+  IN  EFI_USB2_HC_TRANSACTION_TRANSLATOR *Translator,
+  OUT UINT32                             *TransferResult
+  )
+{
+  DEBUG ((DEBUG_ERROR, "Iso\n"));
+  return EFI_UNSUPPORTED;
+}
+
+EFI_STATUS
+EFIAPI
+DwHcAsyncIsochronousTransfer (
+  IN  EFI_USB2_HC_PROTOCOL               *This,
+  IN  UINT8                              DeviceAddress,
+  IN  UINT8                              EndPointAddress,
+  IN  UINT8                              DeviceSpeed,
+  IN  UINTN                              MaximumPacketLength,
+  IN  UINT8                              DataBuffersNumber,
+  IN  OUT VOID                           *Data[EFI_USB_MAX_ISO_BUFFER_NUM],
+  IN  UINTN                              DataLength,
+  IN  EFI_USB2_HC_TRANSACTION_TRANSLATOR *Translator,
+  IN  EFI_ASYNC_USB_TRANSFER_CALLBACK    IsochronousCallBack,
+  IN  VOID                               *Context
+  )
+{
+  DEBUG ((DEBUG_ERROR, "AsyncIso\n"));
+  return EFI_UNSUPPORTED;
+}
+
+/**
+   Supported Functions
+**/
+
+VOID
+InitFslspClkSel (
+  IN  DWUSB_OTGHC_DEV *DwHc
+  )
+{
+  UINT32  PhyClk;
+
+  PhyClk = DWC2_HCFG_FSLSPCLKSEL_30_60_MHZ;
+
+  MmioAndThenOr32 (DwHc->DwUsbBase + HCFG,
+    ~DWC2_HCFG_FSLSPCLKSEL_MASK,
+    PhyClk << DWC2_HCFG_FSLSPCLKSEL_OFFSET);
+}
+
+VOID
+DwFlushTxFifo (
+  IN  DWUSB_OTGHC_DEV *DwHc,
+  IN EFI_EVENT Timeout,
+  IN INT32 Num
+  )
+{
+  UINT32 Status;
+
+  MmioWrite32 (DwHc->DwUsbBase + GRSTCTL, DWC2_GRSTCTL_TXFFLSH |
+    (Num << DWC2_GRSTCTL_TXFNUM_OFFSET));
+
+  Status = Wait4Bit (Timeout, DwHc->DwUsbBase + GRSTCTL, DWC2_GRSTCTL_TXFFLSH, 0);
+  if (Status)
+    DEBUG ((DEBUG_ERROR, "DwFlushTxFifo: Timeout!\n"));
+
+  MicroSecondDelay (1);
+}
+
+VOID
+DwFlushRxFifo (
+  IN  DWUSB_OTGHC_DEV *DwHc,
+  IN  EFI_EVENT Timeout
+  )
+{
+  UINT32 Status;
+
+  MmioWrite32 (DwHc->DwUsbBase + GRSTCTL, DWC2_GRSTCTL_RXFFLSH);
+
+  Status = Wait4Bit (Timeout, DwHc->DwUsbBase + GRSTCTL, DWC2_GRSTCTL_RXFFLSH, 0);
+  if (Status)
+    DEBUG ((DEBUG_ERROR, "DwFlushRxFifo: Timeout!\n"));
+
+  MicroSecondDelay (1);
+}
+
+EFI_STATUS
+DwHcInit (
+  IN  DWUSB_OTGHC_DEV *DwHc,
+  IN  EFI_EVENT Timeout
+  )
+{
+  UINT32 NpTxFifoSz = 0;
+  UINT32 pTxFifoSz = 0;
+  UINT32 Hprt0 = 0;
+  INT32  i, Status, NumChannels;
+
+  MmioWrite32 (DwHc->DwUsbBase + PCGCCTL, 0);
+
+  InitFslspClkSel (DwHc);
+
+  MmioWrite32 (DwHc->DwUsbBase + GRXFSIZ, DWC2_HOST_RX_FIFO_SIZE);
+
+  NpTxFifoSz |= DWC2_HOST_NPERIO_TX_FIFO_SIZE << DWC2_FIFOSIZE_DEPTH_OFFSET;
+  NpTxFifoSz |= DWC2_HOST_RX_FIFO_SIZE << DWC2_FIFOSIZE_STARTADDR_OFFSET;
+  MmioWrite32 (DwHc->DwUsbBase + GNPTXFSIZ, NpTxFifoSz);
+
+  pTxFifoSz |= DWC2_HOST_PERIO_TX_FIFO_SIZE << DWC2_FIFOSIZE_DEPTH_OFFSET;
+  pTxFifoSz |= (DWC2_HOST_RX_FIFO_SIZE + DWC2_HOST_NPERIO_TX_FIFO_SIZE) <<
+    DWC2_FIFOSIZE_STARTADDR_OFFSET;
+  MmioWrite32 (DwHc->DwUsbBase + HPTXFSIZ, pTxFifoSz);
+
+  MmioAnd32 (DwHc->DwUsbBase + GOTGCTL, ~(DWC2_GOTGCTL_HSTSETHNPEN));
+
+  DwFlushTxFifo (DwHc, Timeout, 0x10);
+  DwFlushRxFifo (DwHc, Timeout);
+
+  NumChannels = MmioRead32 (DwHc->DwUsbBase + GHWCFG2);
+  NumChannels &= DWC2_HWCFG2_NUM_HOST_CHAN_MASK;
+  NumChannels >>= DWC2_HWCFG2_NUM_HOST_CHAN_OFFSET;
+  NumChannels += 1;
+  DEBUG ((DEBUG_INFO, "Host has %u channels\n", NumChannels));
+
+  for (i = 0; i < NumChannels; i++)
+    MmioAndThenOr32 (DwHc->DwUsbBase + HCCHAR (i),
+      ~(DWC2_HCCHAR_CHEN | DWC2_HCCHAR_EPDIR),
+      DWC2_HCCHAR_CHDIS);
+
+  for (i = 0; i < NumChannels; i++) {
+    MmioAndThenOr32 (DwHc->DwUsbBase + HCCHAR (i),
+      ~DWC2_HCCHAR_EPDIR,
+      (DWC2_HCCHAR_CHEN | DWC2_HCCHAR_CHDIS));
+    Status = Wait4Bit (Timeout, DwHc->DwUsbBase + HCCHAR (i), DWC2_HCCHAR_CHEN, 0);
+    if (Status) {
+      DEBUG ((DEBUG_ERROR, "DwHcInit: Timeout!\n"));
+      return Status;
+    }
+  }
+
+  if (MmioRead32 (DwHc->DwUsbBase + GINTSTS) & DWC2_GINTSTS_CURMODE_HOST) {
+    Hprt0 = MmioRead32 (DwHc->DwUsbBase + HPRT0);
+    Hprt0 &= ~(DWC2_HPRT0_PRTENA | DWC2_HPRT0_PRTCONNDET);
+    Hprt0 &= ~(DWC2_HPRT0_PRTENCHNG | DWC2_HPRT0_PRTOVRCURRCHNG);
+
+    if (!(Hprt0 & DWC2_HPRT0_PRTPWR)) {
+      Hprt0 |= DWC2_HPRT0_PRTPWR;
+      MmioWrite32 (DwHc->DwUsbBase + HPRT0, Hprt0);
+    }
+  }
+
+  return EFI_SUCCESS;
+}
+
+EFI_STATUS
+DwCoreInit (
+  IN  DWUSB_OTGHC_DEV *DwHc,
+  IN  EFI_EVENT Timeout
+  )
+{
+  UINT32 AhbCfg = 0;
+  UINT32 UsbCfg = 0;
+  EFI_STATUS Status;
+
+  UsbCfg = MmioRead32 (DwHc->DwUsbBase + GUSBCFG);
+
+  UsbCfg |= DWC2_GUSBCFG_ULPI_EXT_VBUS_DRV;
+  UsbCfg &= ~DWC2_GUSBCFG_TERM_SEL_DL_PULSE;
+
+  MmioWrite32 (DwHc->DwUsbBase + GUSBCFG, UsbCfg);
+
+  Status = DwCoreReset (DwHc, Timeout);
+  if (Status != EFI_SUCCESS) {
+    DEBUG ((DEBUG_ERROR, "DwCoreReset failed\n"));
+    return Status;
+  }
+
+  UsbCfg &= ~(DWC2_GUSBCFG_ULPI_UTMI_SEL | DWC2_GUSBCFG_PHYIF);
+  UsbCfg |= CONFIG_DWC2_PHY_TYPE << DWC2_GUSBCFG_ULPI_UTMI_SEL_OFFSET;
+  UsbCfg &= ~DWC2_GUSBCFG_DDRSEL;
+
+  MmioWrite32 (DwHc->DwUsbBase + GUSBCFG, UsbCfg);
+
+  Status = DwCoreReset (DwHc, Timeout);
+  if (Status != EFI_SUCCESS) {
+    DEBUG ((DEBUG_ERROR, "DwCoreReset 2 failed\n"));
+    return Status;
+  }
+
+  UsbCfg = MmioRead32 (DwHc->DwUsbBase + GUSBCFG);
+
+  UsbCfg &= ~(DWC2_GUSBCFG_ULPI_FSLS | DWC2_GUSBCFG_ULPI_CLK_SUS_M);
+  MmioWrite32 (DwHc->DwUsbBase + GUSBCFG, UsbCfg);
+
+  AhbCfg &= ~DWC2_GAHBCFG_AXI_BURST4_MASK;
+  AhbCfg |= DWC2_GAHBCFG_DMAENABLE | DWC2_GAHBCFG_WAIT_AXI_WRITES;
+
+  MmioWrite32 (DwHc->DwUsbBase + GAHBCFG, AhbCfg);
+  MmioAnd32 (DwHc->DwUsbBase + GUSBCFG, ~(DWC2_GUSBCFG_HNPCAP | DWC2_GUSBCFG_SRPCAP));
+
+  return EFI_SUCCESS;
+}
+
+VOID
+DestroyDwUsbHc (
+  IN  DWUSB_OTGHC_DEV *DwHc
+  )
+{
+  UINT32 Pages;
+  EFI_TPL PreviousTpl;
+
+  if (DwHc == NULL) {
+    return;
+  }
+
+  if (DwHc->PeriodicEvent != NULL) {
+    PreviousTpl = gBS->RaiseTPL (TPL_NOTIFY);
+    gBS->CloseEvent (DwHc->PeriodicEvent);
+    gBS->RestoreTPL (PreviousTpl);
+  }
+
+  if (DwHc->ExitBootServiceEvent != NULL) {
+    gBS->CloseEvent (DwHc->ExitBootServiceEvent);
+  }
+
+  Pages = EFI_SIZE_TO_PAGES (DWC2_DATA_BUF_SIZE);
+  DmaUnmap (DwHc->AlignedBufferMapping);
+  DmaFreeBuffer (Pages, DwHc->AlignedBuffer);
+
+  Pages = EFI_SIZE_TO_PAGES (DWC2_STATUS_BUF_SIZE);
+  FreePages (DwHc->StatusBuffer, Pages);
+
+  gBS->FreePool (DwHc);
+}
+
+STATIC
+VOID
+EFIAPI
+DwUsbHcExitBootService (
+  IN  EFI_EVENT Event,
+  IN  VOID *Context
+  )
+{
+  DWUSB_OTGHC_DEV *DwHc;
+
+  DwHc = (DWUSB_OTGHC_DEV*)Context;
+  DwHcQuiesce (DwHc);
+}
+
+STATIC
+UINT32
+FramesPassed (
+  IN  DWUSB_OTGHC_DEV *DwHc
+  )
+{
+  UINT32 MicroFrameStart = DwHc->LastMicroFrame;
+  UINT32 MicroFrameEnd =
+    MmioRead32 (DwHc->DwUsbBase + HFNUM) &
+    DWC2_HFNUM_FRNUM_MASK;
+  UINT32 MicroFramesPassed;
+
+  DwHc->LastMicroFrame = (UINT16)MicroFrameEnd;
+
+  if (MicroFrameEnd < MicroFrameStart) {
+    /*
+     * Being delayed by 0x8000 microframes is 262 seconds.
+     * Unlikely. Also, we can't really do better unless we
+     * start polling time (which is tedious in EFI...).
+     */
+    MicroFrameEnd += DWC2_HFNUM_FRNUM_MASK + 1;
+  }
+
+  MicroFramesPassed = MicroFrameEnd - MicroFrameStart;
+
+  /*
+   * Round up. We're supposedly getting called every
+   * 8 microframes anyway. This means we'll end up
+   * going a bit faster, which is okay.
+   */
+  return ALIGN_VALUE (MicroFramesPassed, 8) / 8;
+}
+
+STATIC
+VOID
+DwHcPeriodicHandler (
+  IN EFI_EVENT Event,
+  IN VOID      *Context
+  )
+{
+  UINT32 Frame;
+  LIST_ENTRY *Entry;
+  LIST_ENTRY *NextEntry;
+  DWUSB_OTGHC_DEV *DwHc = Context;
+
+  DwHc->CurrentFrame += FramesPassed (DwHc);
+  Frame = DwHc->CurrentFrame;
+
+  EFI_LIST_FOR_EACH_SAFE (Entry, NextEntry,
+    &DwHc->DeferredList) {
+    DWUSB_DEFERRED_REQ *Req = EFI_LIST_CONTAINER (Entry, DWUSB_DEFERRED_REQ, List);
+
+    if (Frame >= Req->TargetFrame) {
+      Req->TargetFrame = Frame + Req->FrameInterval;
+      DwHcDeferredTransfer (Req);
+    }
+  }
+}
+
+EFI_STATUS
+CreateDwUsbHc (
+  OUT DWUSB_OTGHC_DEV **OutDwHc
+  )
+{
+  DWUSB_OTGHC_DEV *DwHc;
+  UINT32          Pages;
+  UINTN           BufferSize;
+  EFI_STATUS      Status;
+
+  DwHc = AllocateZeroPool (sizeof (DWUSB_OTGHC_DEV));
+  if (DwHc == NULL) {
+    return EFI_OUT_OF_RESOURCES;
+  }
+
+  DwHc->Signature                                 = DWUSB_OTGHC_DEV_SIGNATURE;
+  DwHc->DwUsbOtgHc.GetCapability                  = DwHcGetCapability;
+  DwHc->DwUsbOtgHc.Reset                          = DwHcReset;
+  DwHc->DwUsbOtgHc.GetState                       = DwHcGetState;
+  DwHc->DwUsbOtgHc.SetState                       = DwHcSetState;
+  DwHc->DwUsbOtgHc.ControlTransfer                = DwHcControlTransfer;
+  DwHc->DwUsbOtgHc.BulkTransfer                   = DwHcBulkTransfer;
+  DwHc->DwUsbOtgHc.AsyncInterruptTransfer         = DwHcAsyncInterruptTransfer;
+  DwHc->DwUsbOtgHc.SyncInterruptTransfer          = DwHcSyncInterruptTransfer;
+  DwHc->DwUsbOtgHc.IsochronousTransfer            = DwHcIsochronousTransfer;
+  DwHc->DwUsbOtgHc.AsyncIsochronousTransfer       = DwHcAsyncIsochronousTransfer;
+  DwHc->DwUsbOtgHc.GetRootHubPortStatus           = DwHcGetRootHubPortStatus;
+  DwHc->DwUsbOtgHc.SetRootHubPortFeature          = DwHcSetRootHubPortFeature;
+  DwHc->DwUsbOtgHc.ClearRootHubPortFeature        = DwHcClearRootHubPortFeature;
+  DwHc->DwUsbOtgHc.MajorRevision                  = 0x02;
+  DwHc->DwUsbOtgHc.MinorRevision                  = 0x00;
+  DwHc->DwUsbBase                                 = DW2_USB_BASE_ADDRESS;
+
+  Pages = EFI_SIZE_TO_PAGES (DWC2_STATUS_BUF_SIZE);
+  DwHc->StatusBuffer = AllocatePages (Pages);
+  if (DwHc->StatusBuffer == NULL) {
+    DEBUG ((DEBUG_ERROR, "CreateDwUsbHc: No pages available for StatusBuffer\n"));
+    return EFI_OUT_OF_RESOURCES;
+  }
+
+  Pages = EFI_SIZE_TO_PAGES (DWC2_DATA_BUF_SIZE);
+  Status = DmaAllocateBuffer (EfiBootServicesData, Pages, (VOID**)&DwHc->AlignedBuffer);
+  if (EFI_ERROR (Status)) {
+    DEBUG ((DEBUG_ERROR, "CreateDwUsbHc: DmaAllocateBuffer: %r\n", Status));
+    return Status;
+  }
+
+  BufferSize = EFI_PAGES_TO_SIZE (Pages);
+  Status = DmaMap (MapOperationBusMasterCommonBuffer, DwHc->AlignedBuffer, &BufferSize,
+             &DwHc->AlignedBufferBusAddress, &DwHc->AlignedBufferMapping);
+  if (EFI_ERROR (Status)) {
+    DEBUG ((DEBUG_ERROR, "CreateDwUsbHc: DmaMap: %r\n", Status));
+    return Status;
+  }
+
+  InitializeListHead (&DwHc->DeferredList);
+
+  Status = gBS->CreateEventEx (
+                  EVT_NOTIFY_SIGNAL,
+                  TPL_NOTIFY,
+                  DwUsbHcExitBootService,
+                  DwHc,
+                  &gEfiEventExitBootServicesGuid,
+                  &DwHc->ExitBootServiceEvent
+                );
+
+  if (EFI_ERROR (Status)) {
+    DEBUG ((DEBUG_ERROR, "CreateDwUsbHc: DwUsbHcExitBootService: %r\n", Status));
+    return Status;
+  }
+
+  Status = gBS->CreateEvent (
+                  EVT_TIMER | EVT_NOTIFY_SIGNAL,
+                  TPL_NOTIFY,
+                  DwHcPeriodicHandler,
+                  DwHc, &DwHc->PeriodicEvent
+                );
+  if (Status != EFI_SUCCESS) {
+    DEBUG ((DEBUG_ERROR, "CreateDwUsbHc: DwHcPeriodicHandler: %r\n", Status));
+    return Status;
+  }
+
+  Status = gBS->SetTimer (DwHc->PeriodicEvent, TimerPeriodic,
+                  EFI_TIMER_PERIOD_MILLISECONDS (1));
+  if (Status != EFI_SUCCESS) {
+    DEBUG ((DEBUG_ERROR, "CreateDwUsbHc: PeriodicEvent: %r\n", Status));
+    return Status;
+  }
+
+  *OutDwHc = DwHc;
+  return EFI_SUCCESS;
+}
+
+VOID
+DwHcQuiesce (
+  IN  DWUSB_OTGHC_DEV *DwHc
+  )
+{
+  if (DwHc->PeriodicEvent != NULL) {
+    EFI_TPL PreviousTpl;
+    PreviousTpl = gBS->RaiseTPL (TPL_NOTIFY);
+    gBS->CloseEvent (DwHc->PeriodicEvent);
+    DwHc->PeriodicEvent = NULL;
+    gBS->RestoreTPL (PreviousTpl);
+  }
+
+  MmioAndThenOr32 (DwHc->DwUsbBase + HPRT0,
+    ~(DWC2_HPRT0_PRTENA | DWC2_HPRT0_PRTCONNDET |
+      DWC2_HPRT0_PRTENCHNG | DWC2_HPRT0_PRTOVRCURRCHNG),
+    DWC2_HPRT0_PRTRST);
+
+  MicroSecondDelay (50000);
+
+  MmioWrite32 (DwHc->DwUsbBase + GRSTCTL, DWC2_GRSTCTL_CSFTRST);
+  MicroSecondDelay (100000);
+}
diff --git a/Platform/RaspberryPi/RPi3/Drivers/DwUsbHostDxe/DwUsbHostDxe.h b/Platform/RaspberryPi/RPi3/Drivers/DwUsbHostDxe/DwUsbHostDxe.h
new file mode 100644
index 000000000000..673d8d3406e4
--- /dev/null
+++ b/Platform/RaspberryPi/RPi3/Drivers/DwUsbHostDxe/DwUsbHostDxe.h
@@ -0,0 +1,162 @@
+/** @file
+ *
+ *  Copyright (c) 2017-2018, Andrey Warkentin <andrey.warkentin@gmail.com>
+ *  Copyright (c) 2015-2016, Linaro Limited. All rights reserved.
+ *
+ *  This program and the accompanying materials
+ *  are licensed and made available under the terms and conditions of the BSD License
+ *  which accompanies this distribution.  The full text of the license may be found at
+ *  http://opensource.org/licenses/bsd-license.php
+ *
+ *  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+ *  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+ *
+ **/
+
+#ifndef __DWUSBHOSTDXE_H__
+#define __DWUSBHOSTDXE_H__
+
+#include <Uefi.h>
+
+#include <IndustryStandard/Bcm2836.h>
+#include <IndustryStandard/RpiMbox.h>
+#include <Protocol/Usb2HostController.h>
+#include <Protocol/RpiFirmware.h>
+
+#include <Guid/EventGroup.h>
+
+#include <Library/DebugLib.h>
+#include <Library/BaseMemoryLib.h>
+#include <Library/UefiDriverEntryPoint.h>
+#include <Library/UefiBootServicesTableLib.h>
+#include <Library/UefiLib.h>
+#include <Library/BaseLib.h>
+#include <Library/MemoryAllocationLib.h>
+#include <Library/PcdLib.h>
+#include <Library/ReportStatusCodeLib.h>
+#include <Library/DevicePathLib.h>
+#include <Library/PcdLib.h>
+#include <Library/IoLib.h>
+#include <Library/TimerLib.h>
+#include <Library/DmaLib.h>
+#include <Library/ArmLib.h>
+
+#define MAX_DEVICE                      16
+#define MAX_ENDPOINT                    16
+
+#define DWUSB_OTGHC_DEV_SIGNATURE       SIGNATURE_32 ('d', 'w', 'h', 'c')
+#define DWHC_FROM_THIS(a)               CR(a, DWUSB_OTGHC_DEV, DwUsbOtgHc, DWUSB_OTGHC_DEV_SIGNATURE)
+
+//
+// Iterate through the double linked list. NOT delete safe
+//
+#define EFI_LIST_FOR_EACH(Entry, ListHead)    \
+  for(Entry = (ListHead)->ForwardLink; Entry != (ListHead); Entry = Entry->ForwardLink)
+
+//
+// Iterate through the double linked list. This is delete-safe.
+// Do not touch NextEntry
+//
+#define EFI_LIST_FOR_EACH_SAFE(Entry, NextEntry, ListHead)            \
+  for(Entry = (ListHead)->ForwardLink, NextEntry = Entry->ForwardLink;\
+      Entry != (ListHead); Entry = NextEntry, NextEntry = Entry->ForwardLink)
+
+#define EFI_LIST_CONTAINER(Entry, Type, Field) BASE_CR(Entry, Type, Field)
+
+//
+// The RequestType in EFI_USB_DEVICE_REQUEST is composed of
+// three fields: One bit direction, 2 bit type, and 5 bit
+// target.
+//
+#define USB_REQUEST_TYPE(Dir, Type, Target)                             \
+  ((UINT8)((((Dir) == EfiUsbDataIn ? 0x01 : 0) << 7) | (Type) | (Target)))
+
+typedef struct {
+  VENDOR_DEVICE_PATH            Custom;
+  EFI_DEVICE_PATH_PROTOCOL      EndDevicePath;
+} EFI_DW_DEVICE_PATH;
+
+typedef struct _DWUSB_DEFERRED_REQ {
+  IN OUT LIST_ENTRY                         List;
+  IN     struct _DWUSB_OTGHC_DEV            *DwHc;
+  IN     UINT32                             Channel;
+  IN     UINT32                             FrameInterval;
+  IN     UINT32                             TargetFrame;
+  IN     EFI_USB2_HC_TRANSACTION_TRANSLATOR *Translator;
+  IN     UINT8                              DeviceSpeed;
+  IN     UINT8                              DeviceAddress;
+  IN     UINTN                              MaximumPacketLength;
+  IN     UINT32                             TransferDirection;
+  IN OUT VOID                               *Data;
+  IN OUT UINTN                              DataLength;
+  IN OUT UINT32                             Pid;
+  IN     UINT32                             EpAddress;
+  IN     UINT32                             EpType;
+  OUT    UINT32                             TransferResult;
+  IN     BOOLEAN                            IgnoreAck;
+  IN     EFI_ASYNC_USB_TRANSFER_CALLBACK    CallbackFunction;
+  IN     VOID                               *CallbackContext;
+  IN     UINTN                              TimeOut;
+} DWUSB_DEFERRED_REQ;
+
+typedef struct _DWUSB_OTGHC_DEV {
+  UINTN                           Signature;
+
+  EFI_USB2_HC_PROTOCOL            DwUsbOtgHc;
+
+  EFI_USB_HC_STATE                DwHcState;
+
+  EFI_EVENT                       ExitBootServiceEvent;
+
+  EFI_EVENT                       PeriodicEvent;
+
+  EFI_PHYSICAL_ADDRESS            DwUsbBase;
+  UINT8                           *StatusBuffer;
+
+  UINT8                           *AlignedBuffer;
+  VOID *                          AlignedBufferMapping;
+  UINTN                           AlignedBufferBusAddress;
+  LIST_ENTRY                      DeferredList;
+  /*
+   * 1ms frames.
+   */
+  UINTN                           CurrentFrame;
+  /*
+   * 125us frames;
+   */
+  UINT16                          LastMicroFrame;
+} DWUSB_OTGHC_DEV;
+
+extern EFI_COMPONENT_NAME_PROTOCOL gComponentName;
+extern EFI_COMPONENT_NAME2_PROTOCOL gComponentName2;
+
+EFI_STATUS
+CreateDwUsbHc (
+  OUT DWUSB_OTGHC_DEV **OutDwHc
+  );
+
+VOID
+DestroyDwUsbHc (
+  IN  DWUSB_OTGHC_DEV *Dev
+  );
+
+EFI_STATUS
+EFIAPI
+DwHcReset (
+  IN  EFI_USB2_HC_PROTOCOL *This,
+  IN  UINT16               Attributes
+  );
+
+EFI_STATUS
+EFIAPI
+DwHcSetState (
+  IN  EFI_USB2_HC_PROTOCOL *This,
+  IN  EFI_USB_HC_STATE     State
+  );
+
+VOID
+DwHcQuiesce (
+  IN  DWUSB_OTGHC_DEV *DwHc
+  );
+
+#endif /* __DWUSBHOSTDXE_H__ */
diff --git a/Platform/RaspberryPi/RPi3/Drivers/DwUsbHostDxe/DwUsbHostDxe.inf b/Platform/RaspberryPi/RPi3/Drivers/DwUsbHostDxe/DwUsbHostDxe.inf
new file mode 100644
index 000000000000..5ae730ccaa4e
--- /dev/null
+++ b/Platform/RaspberryPi/RPi3/Drivers/DwUsbHostDxe/DwUsbHostDxe.inf
@@ -0,0 +1,59 @@
+#/** @file
+#
+#  Copyright (c) 2017-2018, Andrei Warkentin <andrey.warkentin@gmail.com>
+#  Copyright (c) 2015-2016, Linaro Limited. All rights reserved.
+#
+#  This program and the accompanying materials
+#  are licensed and made available under the terms and conditions of the BSD License
+#  which accompanies this distribution.  The full text of the license may be found at
+#  http://opensource.org/licenses/bsd-license.php
+#
+#  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+#  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+#
+#**/
+
+[Defines]
+  INF_VERSION                    = 0x0001001A
+  BASE_NAME                      = DwUsbHostDxe
+  FILE_GUID                      = 4bf1704c-03f4-46d5-bca6-82fa580badfd
+  MODULE_TYPE                    = UEFI_DRIVER
+  VERSION_STRING                 = 1.0
+  ENTRY_POINT                    = DwUsbHostEntryPoint
+
+[Sources.common]
+  DwUsbHostDxe.c
+  DriverBinding.c
+  ComponentName.c
+
+[Packages]
+  ArmPkg/ArmPkg.dec
+  MdePkg/MdePkg.dec
+  EmbeddedPkg/EmbeddedPkg.dec
+  MdeModulePkg/MdeModulePkg.dec
+  Silicon/Broadcom/Bcm283x/Bcm283x.dec
+  Platform/RaspberryPi/RPi3/RPi3.dec
+
+[LibraryClasses]
+  MemoryAllocationLib
+  BaseLib
+  UefiLib
+  UefiBootServicesTableLib
+  UefiDriverEntryPoint
+  BaseMemoryLib
+  DebugLib
+  ReportStatusCodeLib
+  TimerLib
+  DmaLib
+  IoLib
+
+[Guids]
+  gEfiEventExitBootServicesGuid
+
+[Protocols]
+  gEfiDriverBindingProtocolGuid
+  gEfiUsb2HcProtocolGuid
+  gRaspberryPiFirmwareProtocolGuid
+
+[Depex]
+  gRaspberryPiFirmwareProtocolGuid
diff --git a/Platform/RaspberryPi/RPi3/Drivers/DwUsbHostDxe/DwcHw.h b/Platform/RaspberryPi/RPi3/Drivers/DwUsbHostDxe/DwcHw.h
new file mode 100644
index 000000000000..d92bb2d3fd3b
--- /dev/null
+++ b/Platform/RaspberryPi/RPi3/Drivers/DwUsbHostDxe/DwcHw.h
@@ -0,0 +1,788 @@
+/** @file
+ *
+ *  Copyright (c) 2017, Andrey Warkentin <andrey.warkentin@gmail.com>
+ *  Copyright (c) 2015-2016, Linaro Limited. All rights reserved.
+ *
+ *  This program and the accompanying materials
+ *  are licensed and made available under the terms and conditions of the BSD License
+ *  which accompanies this distribution.  The full text of the license may be found at
+ *  http://opensource.org/licenses/bsd-license.php
+ *
+ *  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+ *  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+ *
+ **/
+
+#ifndef __DWCHW_H__
+#define __DWCHW_H__
+
+#define DW2_USB_BASE_ADDRESS            0x3f980000
+
+#define HSOTG_REG(x)    (x)
+
+#define HCCHAR(_ch)                     HSOTG_REG(0x0500 + 0x20 * (_ch))
+#define HCSPLT(_ch)                     HSOTG_REG(0x0504 + 0x20 * (_ch))
+#define HCINT(_ch)                      HSOTG_REG(0x0508 + 0x20 * (_ch))
+#define HCINTMSK(_ch)                   HSOTG_REG(0x050c + 0x20 * (_ch))
+#define HCTSIZ(_ch)                     HSOTG_REG(0x0510 + 0x20 * (_ch))
+#define HCDMA(_ch)                      HSOTG_REG(0x0514 + 0x20 * (_ch))
+#define HCDMAB(_ch)                     HSOTG_REG(0x051c + 0x20 * (_ch))
+
+#define HCFG                            HSOTG_REG(0x0400)
+#define HFIR                            HSOTG_REG(0x0404)
+#define HFNUM                           HSOTG_REG(0x0408)
+#define HPTXSTS                         HSOTG_REG(0x0410)
+#define HAINT                           HSOTG_REG(0x0414)
+#define HAINTMSK                        HSOTG_REG(0x0418)
+#define HFLBADDR                        HSOTG_REG(0x041c)
+
+#define GOTGCTL                         HSOTG_REG(0x000)  // OTG control and status
+#define GOTGINT                         HSOTG_REG(0x004)  // OTG interrupt
+#define GAHBCFG                         HSOTG_REG(0x008)  // AHB config
+#define GUSBCFG                         HSOTG_REG(0x00C)  // Core USB config
+#define GRSTCTL                         HSOTG_REG(0x010)  // Core Reset
+#define GINTSTS                         HSOTG_REG(0x014)  // Core Interrupt
+#define GINTMSK                         HSOTG_REG(0x018)  // Core Interrupt Mask
+#define GRXSTSR                         HSOTG_REG(0x01C)  // Receive Status Queue Read
+#define GRXSTSP                         HSOTG_REG(0x020)  // Receive Status Queue Read and POP
+#define GRXFSIZ                         HSOTG_REG(0x024)  // Receive FIFO Size
+#define GNPTXFSIZ                       HSOTG_REG(0x028)  // Non-periodic TX FIFO Size
+#define GNPTXSTS                        HSOTG_REG(0x02C)  // Non-periodic TX FIFO/Queue Status
+#define GI2CCTL                         HSOTG_REG(0x0030) // I2C access
+#define GPVNDCTL                        HSOTG_REG(0x0034) // PHY vendor control
+#define GGPIO                           HSOTG_REG(0x0038) // GPIO
+#define GUID                            HSOTG_REG(0x003c) // User ID
+#define GSNPSID                         HSOTG_REG(0x0040) // Synopsis ID
+#define GHWCFG1                         HSOTG_REG(0x0044) // User HW Config1
+#define GHWCFG2                         HSOTG_REG(0x0048) // User HW Config2
+#define GHWCFG3                         HSOTG_REG(0x004c) // User HW Config3
+#define GHWCFG4                         HSOTG_REG(0x0050) // User HW Config4
+#define GLPMCFG                         HSOTG_REG(0x0054) // Core LPM config
+#define HPTXFSIZ                        HSOTG_REG(0x100)  // Host periodic TX FIFO Size
+#define DPTXFSIZN(_a)                   HSOTG_REG(0x104 + (((_a) - 1) * 4))
+#define HPRT0                           HSOTG_REG(0x0440)
+#define PCGCCTL                         HSOTG_REG(0xE00)
+
+#define DWC2_GOTGCTL_SESREQSCS                          (1 << 0)
+#define DWC2_GOTGCTL_SESREQSCS_OFFSET                   0
+#define DWC2_GOTGCTL_SESREQ                             (1 << 1)
+#define DWC2_GOTGCTL_SESREQ_OFFSET                      1
+#define DWC2_GOTGCTL_HSTNEGSCS                          (1 << 8)
+#define DWC2_GOTGCTL_HSTNEGSCS_OFFSET                   8
+#define DWC2_GOTGCTL_HNPREQ                             (1 << 9)
+#define DWC2_GOTGCTL_HNPREQ_OFFSET                      9
+#define DWC2_GOTGCTL_HSTSETHNPEN                        (1 << 10)
+#define DWC2_GOTGCTL_HSTSETHNPEN_OFFSET                 10
+#define DWC2_GOTGCTL_DEVHNPEN                           (1 << 11)
+#define DWC2_GOTGCTL_DEVHNPEN_OFFSET                    11
+#define DWC2_GOTGCTL_CONIDSTS                           (1 << 16)
+#define DWC2_GOTGCTL_CONIDSTS_OFFSET                    16
+#define DWC2_GOTGCTL_DBNCTIME                           (1 << 17)
+#define DWC2_GOTGCTL_DBNCTIME_OFFSET                    17
+#define DWC2_GOTGCTL_ASESVLD                            (1 << 18)
+#define DWC2_GOTGCTL_ASESVLD_OFFSET                     18
+#define DWC2_GOTGCTL_BSESVLD                            (1 << 19)
+#define DWC2_GOTGCTL_BSESVLD_OFFSET                     19
+#define DWC2_GOTGCTL_OTGVER                             (1 << 20)
+#define DWC2_GOTGCTL_OTGVER_OFFSET                      20
+#define DWC2_GOTGINT_SESENDDET                          (1 << 2)
+#define DWC2_GOTGINT_SESENDDET_OFFSET                   2
+#define DWC2_GOTGINT_SESREQSUCSTSCHNG                   (1 << 8)
+#define DWC2_GOTGINT_SESREQSUCSTSCHNG_OFFSET            8
+#define DWC2_GOTGINT_HSTNEGSUCSTSCHNG                   (1 << 9)
+#define DWC2_GOTGINT_HSTNEGSUCSTSCHNG_OFFSET            9
+#define DWC2_GOTGINT_RESERVER10_16_MASK                 (0x7F << 10)
+#define DWC2_GOTGINT_RESERVER10_16_OFFSET               10
+#define DWC2_GOTGINT_HSTNEGDET                          (1 << 17)
+#define DWC2_GOTGINT_HSTNEGDET_OFFSET                   17
+#define DWC2_GOTGINT_ADEVTOUTCHNG                       (1 << 18)
+#define DWC2_GOTGINT_ADEVTOUTCHNG_OFFSET                18
+#define DWC2_GOTGINT_DEBDONE                            (1 << 19)
+#define DWC2_GOTGINT_DEBDONE_OFFSET                     19
+#define DWC2_GAHBCFG_GLBLINTRMSK                        (1 << 0)
+#define DWC2_GAHBCFG_GLBLINTRMSK_OFFSET                 0
+#define DWC2_GAHBCFG_AXI_BURST4_MASK                    (3 << 1)
+#define DWC2_GAHBCFG_WAIT_AXI_WRITES                   (1 << 4)
+#define DWC2_GAHBCFG_DMAENABLE                          (1 << 5)
+#define DWC2_GAHBCFG_DMAENABLE_OFFSET                   5
+#define DWC2_GAHBCFG_NPTXFEMPLVL_TXFEMPLVL              (1 << 7)
+#define DWC2_GAHBCFG_NPTXFEMPLVL_TXFEMPLVL_OFFSET       7
+#define DWC2_GAHBCFG_PTXFEMPLVL                         (1 << 8)
+#define DWC2_GAHBCFG_PTXFEMPLVL_OFFSET                  8
+#define DWC2_GUSBCFG_TOUTCAL_MASK                       (0x7 << 0)
+#define DWC2_GUSBCFG_TOUTCAL_OFFSET                     0
+#define DWC2_GUSBCFG_PHYIF                              (1 << 3)
+#define DWC2_GUSBCFG_PHYIF_OFFSET                       3
+#define DWC2_GUSBCFG_ULPI_UTMI_SEL                      (1 << 4)
+#define DWC2_GUSBCFG_ULPI_UTMI_SEL_OFFSET               4
+#define DWC2_GUSBCFG_FSINTF                             (1 << 5)
+#define DWC2_GUSBCFG_FSINTF_OFFSET                      5
+#define DWC2_GUSBCFG_PHYSEL                             (1 << 6)
+#define DWC2_GUSBCFG_PHYSEL_OFFSET                      6
+#define DWC2_GUSBCFG_DDRSEL                             (1 << 7)
+#define DWC2_GUSBCFG_DDRSEL_OFFSET                      7
+#define DWC2_GUSBCFG_SRPCAP                             (1 << 8)
+#define DWC2_GUSBCFG_SRPCAP_OFFSET                      8
+#define DWC2_GUSBCFG_HNPCAP                             (1 << 9)
+#define DWC2_GUSBCFG_HNPCAP_OFFSET                      9
+#define DWC2_GUSBCFG_USBTRDTIM_MASK                     (0xF << 10)
+#define DWC2_GUSBCFG_USBTRDTIM_OFFSET                   10
+#define DWC2_GUSBCFG_NPTXFRWNDEN                        (1 << 14)
+#define DWC2_GUSBCFG_NPTXFRWNDEN_OFFSET                 14
+#define DWC2_GUSBCFG_PHYLPWRCLKSEL                      (1 << 15)
+#define DWC2_GUSBCFG_PHYLPWRCLKSEL_OFFSET               15
+#define DWC2_GUSBCFG_OTGUTMIFSSEL                       (1 << 16)
+#define DWC2_GUSBCFG_OTGUTMIFSSEL_OFFSET                16
+#define DWC2_GUSBCFG_ULPI_FSLS                          (1 << 17)
+#define DWC2_GUSBCFG_ULPI_FSLS_OFFSET                   17
+#define DWC2_GUSBCFG_ULPI_AUTO_RES                      (1 << 18)
+#define DWC2_GUSBCFG_ULPI_AUTO_RES_OFFSET               18
+#define DWC2_GUSBCFG_ULPI_CLK_SUS_M                     (1 << 19)
+#define DWC2_GUSBCFG_ULPI_CLK_SUS_M_OFFSET              19
+#define DWC2_GUSBCFG_ULPI_EXT_VBUS_DRV                  (1 << 20)
+#define DWC2_GUSBCFG_ULPI_EXT_VBUS_DRV_OFFSET           20
+#define DWC2_GUSBCFG_ULPI_INT_VBUS_INDICATOR            (1 << 21)
+#define DWC2_GUSBCFG_ULPI_INT_VBUS_INDICATOR_OFFSET     21
+#define DWC2_GUSBCFG_TERM_SEL_DL_PULSE                  (1 << 22)
+#define DWC2_GUSBCFG_TERM_SEL_DL_PULSE_OFFSET           22
+#define DWC2_GUSBCFG_IC_USB_CAP                         (1 << 26)
+#define DWC2_GUSBCFG_IC_USB_CAP_OFFSET                  26
+#define DWC2_GUSBCFG_IC_TRAFFIC_PULL_REMOVE             (1 << 27)
+#define DWC2_GUSBCFG_IC_TRAFFIC_PULL_REMOVE_OFFSET      27
+#define DWC2_GUSBCFG_TX_END_DELAY                       (1 << 28)
+#define DWC2_GUSBCFG_TX_END_DELAY_OFFSET                28
+#define DWC2_GUSBCFG_FORCEHOSTMODE                      (1 << 29)
+#define DWC2_GUSBCFG_FORCEHOSTMODE_OFFSET               29
+#define DWC2_GUSBCFG_FORCEDEVMODE                       (1 << 30)
+#define DWC2_GUSBCFG_FORCEDEVMODE_OFFSET                30
+#define DWC2_GLPMCTL_LPM_CAP_EN                         (1 << 0)
+#define DWC2_GLPMCTL_LPM_CAP_EN_OFFSET                  0
+#define DWC2_GLPMCTL_APPL_RESP                          (1 << 1)
+#define DWC2_GLPMCTL_APPL_RESP_OFFSET                   1
+#define DWC2_GLPMCTL_HIRD_MASK                          (0xF << 2)
+#define DWC2_GLPMCTL_HIRD_OFFSET                        2
+#define DWC2_GLPMCTL_REM_WKUP_EN                        (1 << 6)
+#define DWC2_GLPMCTL_REM_WKUP_EN_OFFSET                 6
+#define DWC2_GLPMCTL_EN_UTMI_SLEEP                      (1 << 7)
+#define DWC2_GLPMCTL_EN_UTMI_SLEEP_OFFSET               7
+#define DWC2_GLPMCTL_HIRD_THRES_MASK                    (0x1F << 8)
+#define DWC2_GLPMCTL_HIRD_THRES_OFFSET                  8
+#define DWC2_GLPMCTL_LPM_RESP_MASK                      (0x3 << 13)
+#define DWC2_GLPMCTL_LPM_RESP_OFFSET                    13
+#define DWC2_GLPMCTL_PRT_SLEEP_STS                      (1 << 15)
+#define DWC2_GLPMCTL_PRT_SLEEP_STS_OFFSET               15
+#define DWC2_GLPMCTL_SLEEP_STATE_RESUMEOK               (1 << 16)
+#define DWC2_GLPMCTL_SLEEP_STATE_RESUMEOK_OFFSET        16
+#define DWC2_GLPMCTL_LPM_CHAN_INDEX_MASK                (0xF << 17)
+#define DWC2_GLPMCTL_LPM_CHAN_INDEX_OFFSET              17
+#define DWC2_GLPMCTL_RETRY_COUNT_MASK                   (0x7 << 21)
+#define DWC2_GLPMCTL_RETRY_COUNT_OFFSET                 21
+#define DWC2_GLPMCTL_SEND_LPM                           (1 << 24)
+#define DWC2_GLPMCTL_SEND_LPM_OFFSET                    24
+#define DWC2_GLPMCTL_RETRY_COUNT_STS_MASK               (0x7 << 25)
+#define DWC2_GLPMCTL_RETRY_COUNT_STS_OFFSET             25
+#define DWC2_GLPMCTL_HSIC_CONNECT                       (1 << 30)
+#define DWC2_GLPMCTL_HSIC_CONNECT_OFFSET                30
+#define DWC2_GLPMCTL_INV_SEL_HSIC                       (1 << 31)
+#define DWC2_GLPMCTL_INV_SEL_HSIC_OFFSET                31
+#define DWC2_GRSTCTL_CSFTRST                            (1 << 0)
+#define DWC2_GRSTCTL_CSFTRST_OFFSET                     0
+#define DWC2_GRSTCTL_HSFTRST                            (1 << 1)
+#define DWC2_GRSTCTL_HSFTRST_OFFSET                     1
+#define DWC2_GRSTCTL_HSTFRM                             (1 << 2)
+#define DWC2_GRSTCTL_HSTFRM_OFFSET                      2
+#define DWC2_GRSTCTL_INTKNQFLSH                         (1 << 3)
+#define DWC2_GRSTCTL_INTKNQFLSH_OFFSET                  3
+#define DWC2_GRSTCTL_RXFFLSH                            (1 << 4)
+#define DWC2_GRSTCTL_RXFFLSH_OFFSET                     4
+#define DWC2_GRSTCTL_TXFFLSH                            (1 << 5)
+#define DWC2_GRSTCTL_TXFFLSH_OFFSET                     5
+#define DWC2_GRSTCTL_TXFNUM_MASK                        (0x1F << 6)
+#define DWC2_GRSTCTL_TXFNUM_OFFSET                      6
+#define DWC2_GRSTCTL_DMAREQ                             (1 << 30)
+#define DWC2_GRSTCTL_DMAREQ_OFFSET                      30
+#define DWC2_GRSTCTL_AHBIDLE                            (1 << 31)
+#define DWC2_GRSTCTL_AHBIDLE_OFFSET                     31
+#define DWC2_GINTMSK_MODEMISMATCH                       (1 << 1)
+#define DWC2_GINTMSK_MODEMISMATCH_OFFSET                1
+#define DWC2_GINTMSK_OTGINTR                            (1 << 2)
+#define DWC2_GINTMSK_OTGINTR_OFFSET                     2
+#define DWC2_GINTMSK_SOFINTR                            (1 << 3)
+#define DWC2_GINTMSK_SOFINTR_OFFSET                     3
+#define DWC2_GINTMSK_RXSTSQLVL                          (1 << 4)
+#define DWC2_GINTMSK_RXSTSQLVL_OFFSET                   4
+#define DWC2_GINTMSK_NPTXFEMPTY                         (1 << 5)
+#define DWC2_GINTMSK_NPTXFEMPTY_OFFSET                  5
+#define DWC2_GINTMSK_GINNAKEFF                          (1 << 6)
+#define DWC2_GINTMSK_GINNAKEFF_OFFSET                   6
+#define DWC2_GINTMSK_GOUTNAKEFF                         (1 << 7)
+#define DWC2_GINTMSK_GOUTNAKEFF_OFFSET                  7
+#define DWC2_GINTMSK_I2CINTR                            (1 << 9)
+#define DWC2_GINTMSK_I2CINTR_OFFSET                     9
+#define DWC2_GINTMSK_ERLYSUSPEND                        (1 << 10)
+#define DWC2_GINTMSK_ERLYSUSPEND_OFFSET                 10
+#define DWC2_GINTMSK_USBSUSPEND                         (1 << 11)
+#define DWC2_GINTMSK_USBSUSPEND_OFFSET                  11
+#define DWC2_GINTMSK_USBRESET                           (1 << 12)
+#define DWC2_GINTMSK_USBRESET_OFFSET                    12
+#define DWC2_GINTMSK_ENUMDONE                           (1 << 13)
+#define DWC2_GINTMSK_ENUMDONE_OFFSET                    13
+#define DWC2_GINTMSK_ISOOUTDROP                         (1 << 14)
+#define DWC2_GINTMSK_ISOOUTDROP_OFFSET                  14
+#define DWC2_GINTMSK_EOPFRAME                           (1 << 15)
+#define DWC2_GINTMSK_EOPFRAME_OFFSET                    15
+#define DWC2_GINTMSK_EPMISMATCH                         (1 << 17)
+#define DWC2_GINTMSK_EPMISMATCH_OFFSET                  17
+#define DWC2_GINTMSK_INEPINTR                           (1 << 18)
+#define DWC2_GINTMSK_INEPINTR_OFFSET                    18
+#define DWC2_GINTMSK_OUTEPINTR                          (1 << 19)
+#define DWC2_GINTMSK_OUTEPINTR_OFFSET                   19
+#define DWC2_GINTMSK_INCOMPLISOIN                       (1 << 20)
+#define DWC2_GINTMSK_INCOMPLISOIN_OFFSET                20
+#define DWC2_GINTMSK_INCOMPLISOOUT                      (1 << 21)
+#define DWC2_GINTMSK_INCOMPLISOOUT_OFFSET               21
+#define DWC2_GINTMSK_PORTINTR                           (1 << 24)
+#define DWC2_GINTMSK_PORTINTR_OFFSET                    24
+#define DWC2_GINTMSK_HCINTR                             (1 << 25)
+#define DWC2_GINTMSK_HCINTR_OFFSET                      25
+#define DWC2_GINTMSK_PTXFEMPTY                          (1 << 26)
+#define DWC2_GINTMSK_PTXFEMPTY_OFFSET                   26
+#define DWC2_GINTMSK_LPMTRANRCVD                        (1 << 27)
+#define DWC2_GINTMSK_LPMTRANRCVD_OFFSET                 27
+#define DWC2_GINTMSK_CONIDSTSCHNG                       (1 << 28)
+#define DWC2_GINTMSK_CONIDSTSCHNG_OFFSET                28
+#define DWC2_GINTMSK_DISCONNECT                         (1 << 29)
+#define DWC2_GINTMSK_DISCONNECT_OFFSET                  29
+#define DWC2_GINTMSK_SESSREQINTR                        (1 << 30)
+#define DWC2_GINTMSK_SESSREQINTR_OFFSET                 30
+#define DWC2_GINTMSK_WKUPINTR                           (1 << 31)
+#define DWC2_GINTMSK_WKUPINTR_OFFSET                    31
+#define DWC2_GINTSTS_CURMODE_DEVICE                     (0 << 0)
+#define DWC2_GINTSTS_CURMODE_HOST                       (1 << 0)
+#define DWC2_GINTSTS_CURMODE                            (1 << 0)
+#define DWC2_GINTSTS_CURMODE_OFFSET                     0
+#define DWC2_GINTSTS_MODEMISMATCH                       (1 << 1)
+#define DWC2_GINTSTS_MODEMISMATCH_OFFSET                1
+#define DWC2_GINTSTS_OTGINTR                            (1 << 2)
+#define DWC2_GINTSTS_OTGINTR_OFFSET                     2
+#define DWC2_GINTSTS_SOFINTR                            (1 << 3)
+#define DWC2_GINTSTS_SOFINTR_OFFSET                     3
+#define DWC2_GINTSTS_RXSTSQLVL                          (1 << 4)
+#define DWC2_GINTSTS_RXSTSQLVL_OFFSET                   4
+#define DWC2_GINTSTS_NPTXFEMPTY                         (1 << 5)
+#define DWC2_GINTSTS_NPTXFEMPTY_OFFSET                  5
+#define DWC2_GINTSTS_GINNAKEFF                          (1 << 6)
+#define DWC2_GINTSTS_GINNAKEFF_OFFSET                   6
+#define DWC2_GINTSTS_GOUTNAKEFF                         (1 << 7)
+#define DWC2_GINTSTS_GOUTNAKEFF_OFFSET                  7
+#define DWC2_GINTSTS_I2CINTR                            (1 << 9)
+#define DWC2_GINTSTS_I2CINTR_OFFSET                     9
+#define DWC2_GINTSTS_ERLYSUSPEND                        (1 << 10)
+#define DWC2_GINTSTS_ERLYSUSPEND_OFFSET                 10
+#define DWC2_GINTSTS_USBSUSPEND                         (1 << 11)
+#define DWC2_GINTSTS_USBSUSPEND_OFFSET                  11
+#define DWC2_GINTSTS_USBRESET                           (1 << 12)
+#define DWC2_GINTSTS_USBRESET_OFFSET                    12
+#define DWC2_GINTSTS_ENUMDONE                           (1 << 13)
+#define DWC2_GINTSTS_ENUMDONE_OFFSET                    13
+#define DWC2_GINTSTS_ISOOUTDROP                         (1 << 14)
+#define DWC2_GINTSTS_ISOOUTDROP_OFFSET                  14
+#define DWC2_GINTSTS_EOPFRAME                           (1 << 15)
+#define DWC2_GINTSTS_EOPFRAME_OFFSET                    15
+#define DWC2_GINTSTS_INTOKENRX                          (1 << 16)
+#define DWC2_GINTSTS_INTOKENRX_OFFSET                   16
+#define DWC2_GINTSTS_EPMISMATCH                         (1 << 17)
+#define DWC2_GINTSTS_EPMISMATCH_OFFSET                  17
+#define DWC2_GINTSTS_INEPINT                            (1 << 18)
+#define DWC2_GINTSTS_INEPINT_OFFSET                     18
+#define DWC2_GINTSTS_OUTEPINTR                          (1 << 19)
+#define DWC2_GINTSTS_OUTEPINTR_OFFSET                   19
+#define DWC2_GINTSTS_INCOMPLISOIN                       (1 << 20)
+#define DWC2_GINTSTS_INCOMPLISOIN_OFFSET                20
+#define DWC2_GINTSTS_INCOMPLISOOUT                      (1 << 21)
+#define DWC2_GINTSTS_INCOMPLISOOUT_OFFSET               21
+#define DWC2_GINTSTS_PORTINTR                           (1 << 24)
+#define DWC2_GINTSTS_PORTINTR_OFFSET                    24
+#define DWC2_GINTSTS_HCINTR                             (1 << 25)
+#define DWC2_GINTSTS_HCINTR_OFFSET                      25
+#define DWC2_GINTSTS_PTXFEMPTY                          (1 << 26)
+#define DWC2_GINTSTS_PTXFEMPTY_OFFSET                   26
+#define DWC2_GINTSTS_LPMTRANRCVD                        (1 << 27)
+#define DWC2_GINTSTS_LPMTRANRCVD_OFFSET                 27
+#define DWC2_GINTSTS_CONIDSTSCHNG                       (1 << 28)
+#define DWC2_GINTSTS_CONIDSTSCHNG_OFFSET                28
+#define DWC2_GINTSTS_DISCONNECT                         (1 << 29)
+#define DWC2_GINTSTS_DISCONNECT_OFFSET                  29
+#define DWC2_GINTSTS_SESSREQINTR                        (1 << 30)
+#define DWC2_GINTSTS_SESSREQINTR_OFFSET                 30
+#define DWC2_GINTSTS_WKUPINTR                           (1 << 31)
+#define DWC2_GINTSTS_WKUPINTR_OFFSET                    31
+#define DWC2_GRXSTS_EPNUM_MASK                          (0xF << 0)
+#define DWC2_GRXSTS_EPNUM_OFFSET                        0
+#define DWC2_GRXSTS_BCNT_MASK                           (0x7FF << 4)
+#define DWC2_GRXSTS_BCNT_OFFSET                         4
+#define DWC2_GRXSTS_DPID_MASK                           (0x3 << 15)
+#define DWC2_GRXSTS_DPID_OFFSET                         15
+#define DWC2_GRXSTS_PKTSTS_MASK                         (0xF << 17)
+#define DWC2_GRXSTS_PKTSTS_OFFSET                       17
+#define DWC2_GRXSTS_FN_MASK                             (0xF << 21)
+#define DWC2_GRXSTS_FN_OFFSET                           21
+#define DWC2_FIFOSIZE_STARTADDR_MASK                    (0xFFFF << 0)
+#define DWC2_FIFOSIZE_STARTADDR_OFFSET                  0
+#define DWC2_FIFOSIZE_DEPTH_MASK                        (0xFFFF << 16)
+#define DWC2_FIFOSIZE_DEPTH_OFFSET                      16
+#define DWC2_GNPTXSTS_NPTXFSPCAVAIL_MASK                (0xFFFF << 0)
+#define DWC2_GNPTXSTS_NPTXFSPCAVAIL_OFFSET              0
+#define DWC2_GNPTXSTS_NPTXQSPCAVAIL_MASK                (0xFF << 16)
+#define DWC2_GNPTXSTS_NPTXQSPCAVAIL_OFFSET              16
+#define DWC2_GNPTXSTS_NPTXQTOP_TERMINATE                (1 << 24)
+#define DWC2_GNPTXSTS_NPTXQTOP_TERMINATE_OFFSET         24
+#define DWC2_GNPTXSTS_NPTXQTOP_TOKEN_MASK               (0x3 << 25)
+#define DWC2_GNPTXSTS_NPTXQTOP_TOKEN_OFFSET             25
+#define DWC2_GNPTXSTS_NPTXQTOP_CHNEP_MASK               (0xF << 27)
+#define DWC2_GNPTXSTS_NPTXQTOP_CHNEP_OFFSET             27
+#define DWC2_DTXFSTS_TXFSPCAVAIL_MASK                   (0xFFFF << 0)
+#define DWC2_DTXFSTS_TXFSPCAVAIL_OFFSET                 0
+#define DWC2_GI2CCTL_RWDATA_MASK                        (0xFF << 0)
+#define DWC2_GI2CCTL_RWDATA_OFFSET                      0
+#define DWC2_GI2CCTL_REGADDR_MASK                       (0xFF << 8)
+#define DWC2_GI2CCTL_REGADDR_OFFSET                     8
+#define DWC2_GI2CCTL_ADDR_MASK                          (0x7F << 16)
+#define DWC2_GI2CCTL_ADDR_OFFSET                        16
+#define DWC2_GI2CCTL_I2CEN                              (1 << 23)
+#define DWC2_GI2CCTL_I2CEN_OFFSET                       23
+#define DWC2_GI2CCTL_ACK                                (1 << 24)
+#define DWC2_GI2CCTL_ACK_OFFSET                         24
+#define DWC2_GI2CCTL_I2CSUSPCTL                         (1 << 25)
+#define DWC2_GI2CCTL_I2CSUSPCTL_OFFSET                  25
+#define DWC2_GI2CCTL_I2CDEVADDR_MASK                    (0x3 << 26)
+#define DWC2_GI2CCTL_I2CDEVADDR_OFFSET                  26
+#define DWC2_GI2CCTL_RW                                 (1 << 30)
+#define DWC2_GI2CCTL_RW_OFFSET                          30
+#define DWC2_GI2CCTL_BSYDNE                             (1 << 31)
+#define DWC2_GI2CCTL_BSYDNE_OFFSET                      31
+#define DWC2_HWCFG1_EP_DIR0_MASK                        (0x3 << 0)
+#define DWC2_HWCFG1_EP_DIR0_OFFSET                      0
+#define DWC2_HWCFG1_EP_DIR1_MASK                        (0x3 << 2)
+#define DWC2_HWCFG1_EP_DIR1_OFFSET                      2
+#define DWC2_HWCFG1_EP_DIR2_MASK                        (0x3 << 4)
+#define DWC2_HWCFG1_EP_DIR2_OFFSET                      4
+#define DWC2_HWCFG1_EP_DIR3_MASK                        (0x3 << 6)
+#define DWC2_HWCFG1_EP_DIR3_OFFSET                      6
+#define DWC2_HWCFG1_EP_DIR4_MASK                        (0x3 << 8)
+#define DWC2_HWCFG1_EP_DIR4_OFFSET                      8
+#define DWC2_HWCFG1_EP_DIR5_MASK                        (0x3 << 10)
+#define DWC2_HWCFG1_EP_DIR5_OFFSET                      10
+#define DWC2_HWCFG1_EP_DIR6_MASK                        (0x3 << 12)
+#define DWC2_HWCFG1_EP_DIR6_OFFSET                      12
+#define DWC2_HWCFG1_EP_DIR7_MASK                        (0x3 << 14)
+#define DWC2_HWCFG1_EP_DIR7_OFFSET                      14
+#define DWC2_HWCFG1_EP_DIR8_MASK                        (0x3 << 16)
+#define DWC2_HWCFG1_EP_DIR8_OFFSET                      16
+#define DWC2_HWCFG1_EP_DIR9_MASK                        (0x3 << 18)
+#define DWC2_HWCFG1_EP_DIR9_OFFSET                      18
+#define DWC2_HWCFG1_EP_DIR10_MASK                       (0x3 << 20)
+#define DWC2_HWCFG1_EP_DIR10_OFFSET                     20
+#define DWC2_HWCFG1_EP_DIR11_MASK                       (0x3 << 22)
+#define DWC2_HWCFG1_EP_DIR11_OFFSET                     22
+#define DWC2_HWCFG1_EP_DIR12_MASK                       (0x3 << 24)
+#define DWC2_HWCFG1_EP_DIR12_OFFSET                     24
+#define DWC2_HWCFG1_EP_DIR13_MASK                       (0x3 << 26)
+#define DWC2_HWCFG1_EP_DIR13_OFFSET                     26
+#define DWC2_HWCFG1_EP_DIR14_MASK                       (0x3 << 28)
+#define DWC2_HWCFG1_EP_DIR14_OFFSET                     28
+#define DWC2_HWCFG1_EP_DIR15_MASK                       (0x3 << 30)
+#define DWC2_HWCFG1_EP_DIR15_OFFSET                     30
+#define DWC2_HWCFG2_OP_MODE_MASK                        (0x7 << 0)
+#define DWC2_HWCFG2_OP_MODE_OFFSET                      0
+#define DWC2_HWCFG2_ARCHITECTURE_SLAVE_ONLY             (0x0 << 3)
+#define DWC2_HWCFG2_ARCHITECTURE_EXT_DMA                (0x1 << 3)
+#define DWC2_HWCFG2_ARCHITECTURE_INT_DMA                (0x2 << 3)
+#define DWC2_HWCFG2_ARCHITECTURE_MASK                   (0x3 << 3)
+#define DWC2_HWCFG2_ARCHITECTURE_OFFSET                 3
+#define DWC2_HWCFG2_POINT2POINT                         (1 << 5)
+#define DWC2_HWCFG2_POINT2POINT_OFFSET                  5
+#define DWC2_HWCFG2_HS_PHY_TYPE_MASK                    (0x3 << 6)
+#define DWC2_HWCFG2_HS_PHY_TYPE_OFFSET                  6
+#define DWC2_HWCFG2_FS_PHY_TYPE_MASK                    (0x3 << 8)
+#define DWC2_HWCFG2_FS_PHY_TYPE_OFFSET                  8
+#define DWC2_HWCFG2_NUM_DEV_EP_MASK                     (0xF << 10)
+#define DWC2_HWCFG2_NUM_DEV_EP_OFFSET                   10
+#define DWC2_HWCFG2_NUM_HOST_CHAN_MASK                  (0xF << 14)
+#define DWC2_HWCFG2_NUM_HOST_CHAN_OFFSET                14
+#define DWC2_HWCFG2_PERIO_EP_SUPPORTED                  (1 << 18)
+#define DWC2_HWCFG2_PERIO_EP_SUPPORTED_OFFSET           18
+#define DWC2_HWCFG2_DYNAMIC_FIFO                        (1 << 19)
+#define DWC2_HWCFG2_DYNAMIC_FIFO_OFFSET                 19
+#define DWC2_HWCFG2_MULTI_PROC_INT                      (1 << 20)
+#define DWC2_HWCFG2_MULTI_PROC_INT_OFFSET               20
+#define DWC2_HWCFG2_NONPERIO_TX_Q_DEPTH_MASK            (0x3 << 22)
+#define DWC2_HWCFG2_NONPERIO_TX_Q_DEPTH_OFFSET          22
+#define DWC2_HWCFG2_HOST_PERIO_TX_Q_DEPTH_MASK          (0x3 << 24)
+#define DWC2_HWCFG2_HOST_PERIO_TX_Q_DEPTH_OFFSET        24
+#define DWC2_HWCFG2_DEV_TOKEN_Q_DEPTH_MASK              (0x1F << 26)
+#define DWC2_HWCFG2_DEV_TOKEN_Q_DEPTH_OFFSET            26
+#define DWC2_HWCFG3_XFER_SIZE_CNTR_WIDTH_MASK           (0xF << 0)
+#define DWC2_HWCFG3_XFER_SIZE_CNTR_WIDTH_OFFSET         0
+#define DWC2_HWCFG3_PACKET_SIZE_CNTR_WIDTH_MASK         (0x7 << 4)
+#define DWC2_HWCFG3_PACKET_SIZE_CNTR_WIDTH_OFFSET       4
+#define DWC2_HWCFG3_OTG_FUNC                            (1 << 7)
+#define DWC2_HWCFG3_OTG_FUNC_OFFSET                     7
+#define DWC2_HWCFG3_I2C                                 (1 << 8)
+#define DWC2_HWCFG3_I2C_OFFSET                          8
+#define DWC2_HWCFG3_VENDOR_CTRL_IF                      (1 << 9)
+#define DWC2_HWCFG3_VENDOR_CTRL_IF_OFFSET               9
+#define DWC2_HWCFG3_OPTIONAL_FEATURES                   (1 << 10)
+#define DWC2_HWCFG3_OPTIONAL_FEATURES_OFFSET            10
+#define DWC2_HWCFG3_SYNCH_RESET_TYPE                    (1 << 11)
+#define DWC2_HWCFG3_SYNCH_RESET_TYPE_OFFSET             11
+#define DWC2_HWCFG3_OTG_ENABLE_IC_USB                   (1 << 12)
+#define DWC2_HWCFG3_OTG_ENABLE_IC_USB_OFFSET            12
+#define DWC2_HWCFG3_OTG_ENABLE_HSIC                     (1 << 13)
+#define DWC2_HWCFG3_OTG_ENABLE_HSIC_OFFSET              13
+#define DWC2_HWCFG3_OTG_LPM_EN                          (1 << 15)
+#define DWC2_HWCFG3_OTG_LPM_EN_OFFSET                   15
+#define DWC2_HWCFG3_DFIFO_DEPTH_MASK                    (0xFFFF << 16)
+#define DWC2_HWCFG3_DFIFO_DEPTH_OFFSET                  16
+#define DWC2_HWCFG4_NUM_DEV_PERIO_IN_EP_MASK            (0xF << 0)
+#define DWC2_HWCFG4_NUM_DEV_PERIO_IN_EP_OFFSET          0
+#define DWC2_HWCFG4_POWER_OPTIMIZ                       (1 << 4)
+#define DWC2_HWCFG4_POWER_OPTIMIZ_OFFSET                4
+#define DWC2_HWCFG4_MIN_AHB_FREQ_MASK                   (0x1FF << 5)
+#define DWC2_HWCFG4_MIN_AHB_FREQ_OFFSET                 5
+#define DWC2_HWCFG4_UTMI_PHY_DATA_WIDTH_MASK            (0x3 << 14)
+#define DWC2_HWCFG4_UTMI_PHY_DATA_WIDTH_OFFSET          14
+#define DWC2_HWCFG4_NUM_DEV_MODE_CTRL_EP_MASK           (0xF << 16)
+#define DWC2_HWCFG4_NUM_DEV_MODE_CTRL_EP_OFFSET         16
+#define DWC2_HWCFG4_IDDIG_FILT_EN                       (1 << 20)
+#define DWC2_HWCFG4_IDDIG_FILT_EN_OFFSET                20
+#define DWC2_HWCFG4_VBUS_VALID_FILT_EN                  (1 << 21)
+#define DWC2_HWCFG4_VBUS_VALID_FILT_EN_OFFSET           21
+#define DWC2_HWCFG4_A_VALID_FILT_EN                     (1 << 22)
+#define DWC2_HWCFG4_A_VALID_FILT_EN_OFFSET              22
+#define DWC2_HWCFG4_B_VALID_FILT_EN                     (1 << 23)
+#define DWC2_HWCFG4_B_VALID_FILT_EN_OFFSET              23
+#define DWC2_HWCFG4_SESSION_END_FILT_EN                 (1 << 24)
+#define DWC2_HWCFG4_SESSION_END_FILT_EN_OFFSET          24
+#define DWC2_HWCFG4_DED_FIFO_EN                         (1 << 25)
+#define DWC2_HWCFG4_DED_FIFO_EN_OFFSET                  25
+#define DWC2_HWCFG4_NUM_IN_EPS_MASK                     (0xF << 26)
+#define DWC2_HWCFG4_NUM_IN_EPS_OFFSET                   26
+#define DWC2_HWCFG4_DESC_DMA                            (1 << 30)
+#define DWC2_HWCFG4_DESC_DMA_OFFSET                     30
+#define DWC2_HWCFG4_DESC_DMA_DYN                        (1 << 31)
+#define DWC2_HWCFG4_DESC_DMA_DYN_OFFSET                 31
+#define DWC2_HCFG_FSLSPCLKSEL_30_60_MHZ                 0
+#define DWC2_HCFG_FSLSPCLKSEL_48_MHZ                    1
+#define DWC2_HCFG_FSLSPCLKSEL_6_MHZ                     2
+#define DWC2_HCFG_FSLSPCLKSEL_MASK                      (0x3 << 0)
+#define DWC2_HCFG_FSLSPCLKSEL_OFFSET                    0
+#define DWC2_HCFG_FSLSSUPP                              (1 << 2)
+#define DWC2_HCFG_FSLSSUPP_OFFSET                       2
+#define DWC2_HCFG_DESCDMA                               (1 << 23)
+#define DWC2_HCFG_DESCDMA_OFFSET                        23
+#define DWC2_HCFG_FRLISTEN_MASK                         (0x3 << 24)
+#define DWC2_HCFG_FRLISTEN_OFFSET                       24
+#define DWC2_HCFG_PERSCHEDENA                           (1 << 26)
+#define DWC2_HCFG_PERSCHEDENA_OFFSET                    26
+#define DWC2_HCFG_PERSCHEDSTAT                          (1 << 27)
+#define DWC2_HCFG_PERSCHEDSTAT_OFFSET                   27
+#define DWC2_HFIR_FRINT_MASK                            (0xFFFF << 0)
+#define DWC2_HFIR_FRINT_OFFSET                          0
+#define DWC2_HFNUM_FRNUM_MASK                           (0x3FFF << 0)
+#define DWC2_HFNUM_FRNUM_OFFSET                         0
+#define DWC2_HFNUM_FRREM_MASK                           (0xFFFF << 16)
+#define DWC2_HFNUM_FRREM_OFFSET                         16
+#define DWC2_HPTXSTS_PTXFSPCAVAIL_MASK                  (0xFFFF << 0)
+#define DWC2_HPTXSTS_PTXFSPCAVAIL_OFFSET                0
+#define DWC2_HPTXSTS_PTXQSPCAVAIL_MASK                  (0xFF << 16)
+#define DWC2_HPTXSTS_PTXQSPCAVAIL_OFFSET                16
+#define DWC2_HPTXSTS_PTXQTOP_TERMINATE                  (1 << 24)
+#define DWC2_HPTXSTS_PTXQTOP_TERMINATE_OFFSET           24
+#define DWC2_HPTXSTS_PTXQTOP_TOKEN_MASK                 (0x3 << 25)
+#define DWC2_HPTXSTS_PTXQTOP_TOKEN_OFFSET               25
+#define DWC2_HPTXSTS_PTXQTOP_CHNUM_MASK                 (0xF << 27)
+#define DWC2_HPTXSTS_PTXQTOP_CHNUM_OFFSET               27
+#define DWC2_HPTXSTS_PTXQTOP_ODD                        (1 << 31)
+#define DWC2_HPTXSTS_PTXQTOP_ODD_OFFSET                 31
+#define DWC2_HPRT0_PRTCONNSTS                           (1 << 0)
+#define DWC2_HPRT0_PRTCONNSTS_OFFSET                    0
+#define DWC2_HPRT0_PRTCONNDET                           (1 << 1)
+#define DWC2_HPRT0_PRTCONNDET_OFFSET                    1
+#define DWC2_HPRT0_PRTENA                               (1 << 2)
+#define DWC2_HPRT0_PRTENA_OFFSET                        2
+#define DWC2_HPRT0_PRTENCHNG                            (1 << 3)
+#define DWC2_HPRT0_PRTENCHNG_OFFSET                     3
+#define DWC2_HPRT0_PRTOVRCURRACT                        (1 << 4)
+#define DWC2_HPRT0_PRTOVRCURRACT_OFFSET                 4
+#define DWC2_HPRT0_PRTOVRCURRCHNG                       (1 << 5)
+#define DWC2_HPRT0_PRTOVRCURRCHNG_OFFSET                5
+#define DWC2_HPRT0_PRTRES                               (1 << 6)
+#define DWC2_HPRT0_PRTRES_OFFSET                        6
+#define DWC2_HPRT0_PRTSUSP                              (1 << 7)
+#define DWC2_HPRT0_PRTSUSP_OFFSET                       7
+#define DWC2_HPRT0_PRTRST                               (1 << 8)
+#define DWC2_HPRT0_PRTRST_OFFSET                        8
+#define DWC2_HPRT0_PRTLNSTS_MASK                        (0x3 << 10)
+#define DWC2_HPRT0_PRTLNSTS_OFFSET                      10
+#define DWC2_HPRT0_PRTPWR                               (1 << 12)
+#define DWC2_HPRT0_PRTPWR_OFFSET                        12
+#define DWC2_HPRT0_PRTTSTCTL_MASK                       (0xF << 13)
+#define DWC2_HPRT0_PRTTSTCTL_OFFSET                     13
+#define DWC2_HPRT0_PRTSPD_MASK                          (0x3 << 17)
+#define DWC2_HPRT0_PRTSPD_OFFSET                        17
+#define DWC2_HAINT_CH0                                  (1 << 0)
+#define DWC2_HAINT_CH0_OFFSET                           0
+#define DWC2_HAINT_CH1                                  (1 << 1)
+#define DWC2_HAINT_CH1_OFFSET                           1
+#define DWC2_HAINT_CH2                                  (1 << 2)
+#define DWC2_HAINT_CH2_OFFSET                           2
+#define DWC2_HAINT_CH3                                  (1 << 3)
+#define DWC2_HAINT_CH3_OFFSET                           3
+#define DWC2_HAINT_CH4                                  (1 << 4)
+#define DWC2_HAINT_CH4_OFFSET                           4
+#define DWC2_HAINT_CH5                                  (1 << 5)
+#define DWC2_HAINT_CH5_OFFSET                           5
+#define DWC2_HAINT_CH6                                  (1 << 6)
+#define DWC2_HAINT_CH6_OFFSET                           6
+#define DWC2_HAINT_CH7                                  (1 << 7)
+#define DWC2_HAINT_CH7_OFFSET                           7
+#define DWC2_HAINT_CH8                                  (1 << 8)
+#define DWC2_HAINT_CH8_OFFSET                           8
+#define DWC2_HAINT_CH9                                  (1 << 9)
+#define DWC2_HAINT_CH9_OFFSET                           9
+#define DWC2_HAINT_CH10                                 (1 << 10)
+#define DWC2_HAINT_CH10_OFFSET                          10
+#define DWC2_HAINT_CH11                                 (1 << 11)
+#define DWC2_HAINT_CH11_OFFSET                          11
+#define DWC2_HAINT_CH12                                 (1 << 12)
+#define DWC2_HAINT_CH12_OFFSET                          12
+#define DWC2_HAINT_CH13                                 (1 << 13)
+#define DWC2_HAINT_CH13_OFFSET                          13
+#define DWC2_HAINT_CH14                                 (1 << 14)
+#define DWC2_HAINT_CH14_OFFSET                          14
+#define DWC2_HAINT_CH15                                 (1 << 15)
+#define DWC2_HAINT_CH15_OFFSET                          15
+#define DWC2_HAINT_CHINT_MASK                           0xffff
+#define DWC2_HAINT_CHINT_OFFSET                         0
+#define DWC2_HAINTMSK_CH0                               (1 << 0)
+#define DWC2_HAINTMSK_CH0_OFFSET                        0
+#define DWC2_HAINTMSK_CH1                               (1 << 1)
+#define DWC2_HAINTMSK_CH1_OFFSET                        1
+#define DWC2_HAINTMSK_CH2                               (1 << 2)
+#define DWC2_HAINTMSK_CH2_OFFSET                        2
+#define DWC2_HAINTMSK_CH3                               (1 << 3)
+#define DWC2_HAINTMSK_CH3_OFFSET                        3
+#define DWC2_HAINTMSK_CH4                               (1 << 4)
+#define DWC2_HAINTMSK_CH4_OFFSET                        4
+#define DWC2_HAINTMSK_CH5                               (1 << 5)
+#define DWC2_HAINTMSK_CH5_OFFSET                        5
+#define DWC2_HAINTMSK_CH6                               (1 << 6)
+#define DWC2_HAINTMSK_CH6_OFFSET                        6
+#define DWC2_HAINTMSK_CH7                               (1 << 7)
+#define DWC2_HAINTMSK_CH7_OFFSET                        7
+#define DWC2_HAINTMSK_CH8                               (1 << 8)
+#define DWC2_HAINTMSK_CH8_OFFSET                        8
+#define DWC2_HAINTMSK_CH9                               (1 << 9)
+#define DWC2_HAINTMSK_CH9_OFFSET                        9
+#define DWC2_HAINTMSK_CH10                              (1 << 10)
+#define DWC2_HAINTMSK_CH10_OFFSET                       10
+#define DWC2_HAINTMSK_CH11                              (1 << 11)
+#define DWC2_HAINTMSK_CH11_OFFSET                       11
+#define DWC2_HAINTMSK_CH12                              (1 << 12)
+#define DWC2_HAINTMSK_CH12_OFFSET                       12
+#define DWC2_HAINTMSK_CH13                              (1 << 13)
+#define DWC2_HAINTMSK_CH13_OFFSET                       13
+#define DWC2_HAINTMSK_CH14                              (1 << 14)
+#define DWC2_HAINTMSK_CH14_OFFSET                       14
+#define DWC2_HAINTMSK_CH15                              (1 << 15)
+#define DWC2_HAINTMSK_CH15_OFFSET                       15
+#define DWC2_HAINTMSK_CHINT_MASK                        0xffff
+#define DWC2_HAINTMSK_CHINT_OFFSET                      0
+#define DWC2_HCCHAR_MPS_MASK                            (0x7FF << 0)
+#define DWC2_HCCHAR_MPS_OFFSET                          0
+#define DWC2_HCCHAR_EPNUM_MASK                          (0xF << 11)
+#define DWC2_HCCHAR_EPNUM_OFFSET                        11
+#define DWC2_HCCHAR_EPDIR                               (1 << 15)
+#define DWC2_HCCHAR_EPDIR_OFFSET                        15
+#define DWC2_HCCHAR_LSPDDEV                             (1 << 17)
+#define DWC2_HCCHAR_LSPDDEV_OFFSET                      17
+#define DWC2_HCCHAR_EPTYPE_CONTROL                      0
+#define DWC2_HCCHAR_EPTYPE_ISOC                         1
+#define DWC2_HCCHAR_EPTYPE_BULK                         2
+#define DWC2_HCCHAR_EPTYPE_INTR                         3
+#define DWC2_HCCHAR_EPTYPE_MASK                         (0x3 << 18)
+#define DWC2_HCCHAR_EPTYPE_OFFSET                       18
+#define DWC2_HCCHAR_MULTICNT_MASK                       (0x3 << 20)
+#define DWC2_HCCHAR_MULTICNT_OFFSET                     20
+#define DWC2_HCCHAR_DEVADDR_MASK                        (0x7F << 22)
+#define DWC2_HCCHAR_DEVADDR_OFFSET                      22
+#define DWC2_HCCHAR_ODDFRM                              (1 << 29)
+#define DWC2_HCCHAR_ODDFRM_OFFSET                       29
+#define DWC2_HCCHAR_CHDIS                               (1 << 30)
+#define DWC2_HCCHAR_CHDIS_OFFSET                        30
+#define DWC2_HCCHAR_CHEN                                (1 << 31)
+#define DWC2_HCCHAR_CHEN_OFFSET                         31
+#define DWC2_HCSPLT_PRTADDR_MASK                        (0x7F << 0)
+#define DWC2_HCSPLT_PRTADDR_OFFSET                      0
+#define DWC2_HCSPLT_HUBADDR_MASK                        (0x7F << 7)
+#define DWC2_HCSPLT_HUBADDR_OFFSET                      7
+#define DWC2_HCSPLT_XACTPOS_MASK                        (0x3 << 14)
+#define DWC2_HCSPLT_XACTPOS_OFFSET                      14
+#define DWC2_HCSPLT_COMPSPLT                            (1 << 16)
+#define DWC2_HCSPLT_COMPSPLT_OFFSET                     16
+#define DWC2_HCSPLT_SPLTENA                             (1 << 31)
+#define DWC2_HCSPLT_SPLTENA_OFFSET                      31
+#define DWC2_HCINT_XFERCOMP                             (1 << 0) // Transfer complete
+#define DWC2_HCINT_XFERCOMP_OFFSET                      0
+#define DWC2_HCINT_CHHLTD                               (1 << 1) // Channel halted
+#define DWC2_HCINT_CHHLTD_OFFSET                        1
+#define DWC2_HCINT_AHBERR                               (1 << 2) // AHB error
+#define DWC2_HCINT_AHBERR_OFFSET                        2
+#define DWC2_HCINT_STALL                                (1 << 3) // Stall response received
+#define DWC2_HCINT_STALL_OFFSET                         3
+#define DWC2_HCINT_NAK                                  (1 << 4) // NAK response
+#define DWC2_HCINT_NAK_OFFSET                           4
+#define DWC2_HCINT_ACK                                  (1 << 5) // ACK response
+#define DWC2_HCINT_ACK_OFFSET                           5
+#define DWC2_HCINT_NYET                                 (1 << 6) // NYET
+#define DWC2_HCINT_NYET_OFFSET                          6
+#define DWC2_HCINT_XACTERR                              (1 << 7) // Transaction Error
+#define DWC2_HCINT_XACTERR_OFFSET                       7
+#define DWC2_HCINT_BBLERR                               (1 << 8) // Babble Error
+#define DWC2_HCINT_BBLERR_OFFSET                        8
+#define DWC2_HCINT_FRMOVRUN                             (1 << 9) // Frame overrun
+#define DWC2_HCINT_FRMOVRUN_OFFSET                      9
+#define DWC2_HCINT_DATATGLERR                           (1 << 10) // Data Toggle
+#define DWC2_HCINT_DATATGLERR_OFFSET                    10
+#define DWC2_HCINT_BNA                                  (1 << 11) // Buffer Not Available
+#define DWC2_HCINT_BNA_OFFSET                           11
+#define DWC2_HCINT_XCS_XACT                             (1 << 12) // Excessive Transaction
+#define DWC2_HCINT_XCS_XACT_OFFSET                      12
+#define DWC2_HCINT_FRM_LIST_ROLL                        (1 << 13) // Frame List Rollover
+#define DWC2_HCINT_FRM_LIST_ROLL_OFFSET                 13
+#define DWC2_HCINTMSK_XFERCOMPL                         (1 << 0)
+#define DWC2_HCINTMSK_XFERCOMPL_OFFSET                  0
+#define DWC2_HCINTMSK_CHHLTD                            (1 << 1)
+#define DWC2_HCINTMSK_CHHLTD_OFFSET                     1
+#define DWC2_HCINTMSK_AHBERR                            (1 << 2)
+#define DWC2_HCINTMSK_AHBERR_OFFSET                     2
+#define DWC2_HCINTMSK_STALL                             (1 << 3)
+#define DWC2_HCINTMSK_STALL_OFFSET                      3
+#define DWC2_HCINTMSK_NAK                               (1 << 4)
+#define DWC2_HCINTMSK_NAK_OFFSET                        4
+#define DWC2_HCINTMSK_ACK                               (1 << 5)
+#define DWC2_HCINTMSK_ACK_OFFSET                        5
+#define DWC2_HCINTMSK_NYET                              (1 << 6)
+#define DWC2_HCINTMSK_NYET_OFFSET                       6
+#define DWC2_HCINTMSK_XACTERR                           (1 << 7)
+#define DWC2_HCINTMSK_XACTERR_OFFSET                    7
+#define DWC2_HCINTMSK_BBLERR                            (1 << 8)
+#define DWC2_HCINTMSK_BBLERR_OFFSET                     8
+#define DWC2_HCINTMSK_FRMOVRUN                          (1 << 9)
+#define DWC2_HCINTMSK_FRMOVRUN_OFFSET                   9
+#define DWC2_HCINTMSK_DATATGLERR                        (1 << 10)
+#define DWC2_HCINTMSK_DATATGLERR_OFFSET                 10
+#define DWC2_HCINTMSK_BNA                               (1 << 11)
+#define DWC2_HCINTMSK_BNA_OFFSET                        11
+#define DWC2_HCINTMSK_XCS_XACT                          (1 << 12)
+#define DWC2_HCINTMSK_XCS_XACT_OFFSET                   12
+#define DWC2_HCINTMSK_FRM_LIST_ROLL                     (1 << 13)
+#define DWC2_HCINTMSK_FRM_LIST_ROLL_OFFSET              13
+#define DWC2_HCTSIZ_XFERSIZE_MASK                       0x7ffff
+#define DWC2_HCTSIZ_XFERSIZE_OFFSET                     0
+#define DWC2_HCTSIZ_SCHINFO_MASK                        0xff
+#define DWC2_HCTSIZ_SCHINFO_OFFSET                      0
+#define DWC2_HCTSIZ_NTD_MASK                            (0xff << 8)
+#define DWC2_HCTSIZ_NTD_OFFSET                          8
+#define DWC2_HCTSIZ_PKTCNT_MASK                         (0x3ff << 19)
+#define DWC2_HCTSIZ_PKTCNT_OFFSET                       19
+#define DWC2_HCTSIZ_PID_MASK                            (0x3 << 29)
+#define DWC2_HCTSIZ_PID_OFFSET                          29
+#define DWC2_HCTSIZ_DOPNG                               (1 << 31)
+#define DWC2_HCTSIZ_DOPNG_OFFSET                        31
+#define DWC2_HCDMA_CTD_MASK                             (0xFF << 3)
+#define DWC2_HCDMA_CTD_OFFSET                           3
+#define DWC2_HCDMA_DMA_ADDR_MASK                        (0x1FFFFF << 11)
+#define DWC2_HCDMA_DMA_ADDR_OFFSET                      11
+#define DWC2_PCGCCTL_STOPPCLK                           (1 << 0)
+#define DWC2_PCGCCTL_STOPPCLK_OFFSET                    0
+#define DWC2_PCGCCTL_GATEHCLK                           (1 << 1)
+#define DWC2_PCGCCTL_GATEHCLK_OFFSET                    1
+#define DWC2_PCGCCTL_PWRCLMP                            (1 << 2)
+#define DWC2_PCGCCTL_PWRCLMP_OFFSET                     2
+#define DWC2_PCGCCTL_RSTPDWNMODULE                      (1 << 3)
+#define DWC2_PCGCCTL_RSTPDWNMODULE_OFFSET               3
+#define DWC2_PCGCCTL_PHYSUSPENDED                       (1 << 4)
+#define DWC2_PCGCCTL_PHYSUSPENDED_OFFSET                4
+#define DWC2_PCGCCTL_ENBL_SLEEP_GATING                  (1 << 5)
+#define DWC2_PCGCCTL_ENBL_SLEEP_GATING_OFFSET           5
+#define DWC2_PCGCCTL_PHY_IN_SLEEP                       (1 << 6)
+#define DWC2_PCGCCTL_PHY_IN_SLEEP_OFFSET                6
+#define DWC2_PCGCCTL_DEEP_SLEEP                         (1 << 7)
+#define DWC2_PCGCCTL_DEEP_SLEEP_OFFSET                  7
+#define DWC2_SNPSID_DEVID_VER_2xx                       (0x4f542 << 12)
+#define DWC2_SNPSID_DEVID_VER_3xx                       (0x4f543 << 12)
+#define DWC2_SNPSID_DEVID_MASK                          (0xfffff << 12)
+#define DWC2_SNPSID_DEVID_OFFSET                        12
+
+/* Host controller specific */
+#define DWC2_HC_PID_DATA0               0
+#define DWC2_HC_PID_DATA2               1
+#define DWC2_HC_PID_DATA1               2
+#define DWC2_HC_PID_MDATA               3
+#define DWC2_HC_PID_SETUP               3
+
+/* roothub.a masks */
+#define RH_A_NDP        (0xff << 0)     /* number of downstream ports */
+#define RH_A_PSM        (1 << 8)        /* power switching mode */
+#define RH_A_NPS        (1 << 9)        /* no power switching */
+#define RH_A_DT         (1 << 10)       /* device type (mbz) */
+#define RH_A_OCPM       (1 << 11)       /* over current protection mode */
+#define RH_A_NOCP       (1 << 12)       /* no over current protection */
+#define RH_A_POTPGT     (0xff << 24)    /* power on to power good time */
+
+/* roothub.b masks */
+#define RH_B_DR         0x0000ffff      /* device removable flags */
+#define RH_B_PPCM       0xffff0000      /* port power control mask */
+
+#define DWC2_PHY_TYPE_FS                0
+#define DWC2_PHY_TYPE_UTMI              1
+#define DWC2_PHY_TYPE_ULPI              2
+#define CONFIG_DWC2_PHY_TYPE            DWC2_PHY_TYPE_UTMI      /* PHY type */
+#define CONFIG_DWC2_UTMI_WIDTH          8       /* UTMI bus width (8/16) */
+
+#define DWC2_DMA_BURST_SIZE              32      /* DMA burst len */
+#define DWC2_MAX_CHANNELS                16      /* Max # of EPs */
+#define DWC2_HOST_RX_FIFO_SIZE           (516 + DWC2_MAX_CHANNELS)
+#define DWC2_HOST_NPERIO_TX_FIFO_SIZE    0x100   /* nPeriodic TX FIFO */
+#define DWC2_HOST_PERIO_TX_FIFO_SIZE     0x200   /* Periodic TX FIFO */
+#define DWC2_MAX_TRANSFER_SIZE           65535
+#define DWC2_MAX_PACKET_COUNT            511
+
+#define DWC2_HC_CHANNEL                 0
+#define DWC2_HC_CHANNEL_ASYNC           1
+#define DWC2_HC_CHANNEL_SYNC            2
+#define DWC2_HC_CHANNEL_BULK            3
+#define DWC2_HC_PORT                    0
+
+#define DWC2_STATUS_BUF_SIZE            64
+#define DWC2_DATA_BUF_SIZE              (64 * 1024)
+
+
+#define USB_PORT_FEAT_CONNECTION     0
+#define USB_PORT_FEAT_ENABLE         1
+#define USB_PORT_FEAT_SUSPEND        2
+#define USB_PORT_FEAT_OVER_CURRENT   3
+#define USB_PORT_FEAT_RESET          4
+#define USB_PORT_FEAT_POWER          8
+#define USB_PORT_FEAT_LOWSPEED       9
+#define USB_PORT_FEAT_HIGHSPEED      10
+#define USB_PORT_FEAT_C_CONNECTION   16
+#define USB_PORT_FEAT_C_ENABLE       17
+#define USB_PORT_FEAT_C_SUSPEND      18
+#define USB_PORT_FEAT_C_OVER_CURRENT 19
+#define USB_PORT_FEAT_C_RESET        20
+#define USB_PORT_FEAT_TEST           21
+
+#endif  /* __DWCHW_H__ */
diff --git a/Platform/RaspberryPi/RPi3/Include/Protocol/DwUsb.h b/Platform/RaspberryPi/RPi3/Include/Protocol/DwUsb.h
new file mode 100644
index 000000000000..ac57960e048a
--- /dev/null
+++ b/Platform/RaspberryPi/RPi3/Include/Protocol/DwUsb.h
@@ -0,0 +1,53 @@
+/** @file
+ *
+ *  Copyright (c) 2015-2016, Linaro. All rights reserved.
+ *  Copyright (c) 2015-2016, Hisilicon Limited. All rights reserved.
+ *
+ *  This program and the accompanying materials
+ *  are licensed and made available under the terms and conditions of the BSD License
+ *  which accompanies this distribution.  The full text of the license may be found at
+ *  http://opensource.org/licenses/bsd-license.php
+ *
+ *  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+ *  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+ *
+ **/
+
+#ifndef __DW_USB_PROTOCOL_H__
+#define __DW_USB_PROTOCOL_H__
+
+//
+// Protocol GUID
+//
+#define DW_USB_PROTOCOL_GUID { 0x109fa264, 0x7811, 0x4862, { 0xa9, 0x73, 0x4a, 0xb2, 0xef, 0x2e, 0xe2, 0xff }}
+
+//
+// Protocol interface structure
+//
+typedef struct _DW_USB_PROTOCOL  DW_USB_PROTOCOL;
+
+#define USB_HOST_MODE    0
+#define USB_DEVICE_MODE  1
+#define USB_CABLE_NOT_ATTACHED  2
+
+typedef
+EFI_STATUS
+(EFIAPI *DW_USB_GET_SERIAL_NO) (
+  OUT CHAR16                           *SerialNo,
+  OUT UINT8                            *Length
+  );
+
+typedef
+EFI_STATUS
+(EFIAPI *DW_USB_PHY_INIT) (
+  IN UINT8                             Mode
+  );
+
+struct _DW_USB_PROTOCOL {
+  DW_USB_GET_SERIAL_NO                 Get;
+  DW_USB_PHY_INIT                      PhyInit;
+};
+
+extern EFI_GUID gDwUsbProtocolGuid;
+
+#endif /* __DW_USB_PROTOCOL_H__ */
-- 
2.17.0.windows.1



^ permalink raw reply related	[flat|nested] 34+ messages in thread

* [PATCH v5 edk2-platforms 18/22] Platform/RaspberryPi/RPi3 *NON-OSI*: Add ATF binaries
  2019-02-05 16:25 [PATCH v5 edk2-platforms 00/22] Platform/RaspberryPi: Add Raspberry Pi 3 support Pete Batard
                   ` (16 preceding siblings ...)
  2019-02-05 16:25 ` [PATCH v5 edk2-platforms 17/22] Platform/RaspberryPi/RPi3: Add USB host driver Pete Batard
@ 2019-02-05 16:25 ` Pete Batard
  2019-02-06 22:39   ` Kinney, Michael D
  2019-02-05 16:25 ` [PATCH v5 edk2-platforms 19/22] Platform/RaspberryPi/RPi3 *NON-OSI*: Add Device Tree binaries Pete Batard
                   ` (5 subsequent siblings)
  23 siblings, 1 reply; 34+ messages in thread
From: Pete Batard @ 2019-02-05 16:25 UTC (permalink / raw)
  To: edk2-devel

These ATF binaries were built from the ATF source (commit c3859557)
with the custom RPi3 platform options detailed in the readme, and with
no modification to the official source whatsoever.

Contributed-under: TianoCore Contribution Agreement 1.1
Signed-off-by: Pete Batard <pete@akeo.ie>
---
 Platform/RaspberryPi/RPi3/TrustedFirmware/License.txt |  26 ++++++++++++
 Platform/RaspberryPi/RPi3/TrustedFirmware/Readme.md   |  42 ++++++++++++++++++++
 Platform/RaspberryPi/RPi3/TrustedFirmware/bl1.bin     | Bin 0 -> 18801 bytes
 Platform/RaspberryPi/RPi3/TrustedFirmware/fip.bin     | Bin 0 -> 41714 bytes
 4 files changed, 68 insertions(+)

diff --git a/Platform/RaspberryPi/RPi3/TrustedFirmware/License.txt b/Platform/RaspberryPi/RPi3/TrustedFirmware/License.txt
new file mode 100644
index 000000000000..b98dc643227e
--- /dev/null
+++ b/Platform/RaspberryPi/RPi3/TrustedFirmware/License.txt
@@ -0,0 +1,26 @@
+Copyright (c) 2013-2018, ARM Limited and Contributors. All rights reserved.
+
+Redistribution and use in source and binary forms, with or without modification,
+are permitted provided that the following conditions are met:
+
+* Redistributions of source code must retain the above copyright notice, this
+  list of conditions and the following disclaimer.
+
+* Redistributions in binary form must reproduce the above copyright notice, this
+  list of conditions and the following disclaimer in the documentation and/or
+  other materials provided with the distribution.
+
+* Neither the name of ARM nor the names of its contributors may be used to
+  endorse or promote products derived from this software without specific prior
+  written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR
+ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
+ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
diff --git a/Platform/RaspberryPi/RPi3/TrustedFirmware/Readme.md b/Platform/RaspberryPi/RPi3/TrustedFirmware/Readme.md
new file mode 100644
index 000000000000..74bcec7d1f12
--- /dev/null
+++ b/Platform/RaspberryPi/RPi3/TrustedFirmware/Readme.md
@@ -0,0 +1,42 @@
+ARM Trusted Firmware for Raspberry Pi 3
+=======================================
+
+The `bl1` and `fip` ATF binaries, found in this directory, were built from
+the [official ATF source](https://github.com/ARM-software/arm-trusted-firmware)
+(commit c3859557) using Linaro's GCC 5.5 compiler with:
+
+```
+export CROSS_COMPILE=/usr/src/gcc-linaro-5.5.0-2017.10-x86_64_aarch64-linux-gnu/bin/aarch64-linux-gnu-
+make PLAT=rpi3 PRELOADED_BL33_BASE=0x30000 RPI3_PRELOADED_DTB_BASE=0x10000 SUPPORT_VFP=1 RPI3_USE_UEFI_MAP=1 fip all
+```
+
+This results in the following memory mapping:
+
+```
+    0x00000000 +-----------------+
+               |       ROM       | BL1
+    0x00010000 +-----------------+
+               |       DTB       | (Loaded by the VideoCore)
+    0x00020000 +-----------------+
+               |       FIP       |
+    0x00030000 +-----------------+
+               |                 |
+               |  UEFI PAYLOAD   |
+               |                 |
+    0x00200000 +-----------------+
+               |   Secure SRAM   | BL2, BL31
+    0x00300000 +-----------------+
+               |   Secure DRAM   | BL32 (Secure payload)
+    0x00400000 +-----------------+
+               |                 |
+               |                 |
+               | Non-secure DRAM | BL33
+               |                 |
+               |                 |
+    0x01000000 +-----------------+
+               |                 |
+               |       ...       |
+               |                 |
+    0x3F000000 +-----------------+
+               |       I/O       |
+```
diff --git a/Platform/RaspberryPi/RPi3/TrustedFirmware/bl1.bin b/Platform/RaspberryPi/RPi3/TrustedFirmware/bl1.bin
new file mode 100644
index 0000000000000000000000000000000000000000..e25138828d0a4ddb24772abb1a60eefc334666b5
GIT binary patch
literal 18801
zcmeHud2|%#mG7;pmedFVtpy|tJ-S*z4DF582<)+{TLO%YF^IMyw%@2*ivhC;Enpe2
zRTA<tmgA=aC3r9swODMrCx7^1@T3zb2%DK?Lf#29G?V1z4J{zXv79_;z^G+F?{}-Z
zge>Dp&Ya2NoOkF$@l}1x-M+hhw@Q@U820D96C>N0$f-gpvNVO-6r%k^_LFjhV53f>
zzYYB^p(#wZhayBm(40?m)v%ZRF-jkU{?@RJdpUDVq_0@Qvl>>=KM8BSMAN6D9c2X^
zv}!gTC9-IZXdTh<nuF*_F~<Dabe@Q`4z%dg`yWETSD&vxw>l_aE5oz<u%x-Mt_I@=
z6^f(*?g@d~PT~5aNNv#+%2G)!>6A)Ol0}J=O^M4yanPmrUEBE6z%_}qi$f`XQKFzu
zlVZ_?G$rnX41{DgYzORyWMj?6p-TMP#*g+gylWdj3`8X%sIOlv1lmB)R$NV@Mf2q+
zY4d>}JWrcSYDNxGR%4SA-?^DI?>kETG0>;<^-cF@D)C*r!0X4PiJ}^Q9sQugsR%T^
zW2zF8L8m(ZKusahN`})&<nhl?LUy9+i<w(<d3`h1M5RpU#l^0`wT*}SX*21%1imhU
zPUcNemAKC1ZY6&CX)*AHBnEe$A?>mx1t%~~5>0PQR^krEJ6wr3iAo6aZSmWc_!Ag6
z`56X&xUWmf4DJH$r=?NBrxUaj_-e#D|7a!d7m4LPR23=2^S_NbBGxi5Ce4?hcK6f$
z3TXVu>I#)XZeBsnU^%~vzTYcJS`*qLzY-q@C2Lj%?d)EP7gLhfKy+cZh2moYa~$X{
zx3%XUwhAHXdf#-#Z|vK6?76XLKQ{Io`^9@z>$YethdSW8QZ5C&;8{(g13fpB7t2Z#
zv}wTee+aU&&~*P;CC>ZC@)`!-q9RS70s5}E1#NvkX*|Abte|y4K4Ov@&cGb(htrS!
z?UHhWQSQh3M%HhErgcf#{e7FzN8o|+H4LXX!y1D17Ravw@_ZjU`DI^Uc2vsJ_nzf=
zrMw8T{AXPU*sfUT3wKkT?+aC<bwGw9De+Pgy0M=g=$J0&Ya0&+1VIh6-ju<Pc#Vv`
zxVG`oUb4_488RjCX~^+rc9W#N2)U@RbJ%UGLl!h2_J5$wD2esZiB|H98rptaG+{Rb
z?`Abg<Nbfx>k5sBtYoZHy#nk(iF>b7Kn7plG-GWM_MT}fv`}>i_+g$!>kYVAtMjMZ
zKkRxSPMv3q!LuE3blU*#eDKfoFz*JxKk3(-OVEQ%;4th*3YIr1fsrJ(5J@e0*s~Mh
zd0nc3pKa36?~nW8oE_jZ2E+0tU<o9&L?uhm`e)&NbstQ*jvlxV@UesUfo;hxCu;)y
zb8)?|=Zqvc?PTfhg!~*9(h6;K!PVE-uN%59sIE}y(y=|nx}e_B1%~Bnc7=Gq3awQA
zngJu7<>zV^LM%V#S;F3RL3YfS7qNwP(4B`1epbOV&*!-U`W><occEV%(9iz15;#~t
zHv{J~&~p)X+?PhxycbtSQ~c)^@_Yhc#^cMuUlRBm@<L_LSt-f+2f*6{-VTB{A9%B1
zY&>*>{SoGslw<yPvF^amWNq8$n~tBeQ2Kr`yX9x#wXS|#&+nm!93u$yvEMu`Wd$YZ
z0sI*FDLnam*tH7XfB(4|J*)!~;KDY8d;0peMS=ec{NW9KF#I&jq?|9S5-$RMEEh#I
z^i`J+#@x_ZQ%2^P1^vx@A)XauojPD0$28`L<)q6J^Bg(AorrNhU9JYbO#6$Vk8PA`
zG-I1?2mTbz(EWqD?jJ-v(_;wwMQRF*7Jp2<MDeJ-Zl4U>xnU~@1Li!YAs@Crw^@mE
zJEv8N!xy*iIXqtPFMdslV^5CpSP{AOIqo-<I9)>j-O4@(<co3b0C4Mm2z>pGL|JCs
z_Scg326Vj>zPQ7#guJ=UC5TLVy!49XQEbg6O5#}+;Onf*7m-!0mNBN=N<p%=2(THy
z`+O4T8m*3;WR2sS-uGaVW;O5q7Gu0M33`<nH~XR%Z5QzCFpnl{4+19pY5m!gq7~qI
zD(E!j%eu_A$MRtv=G@_OCdDsv4kEhZGkH&-Pcn3lpE*W%Nh5=WiGDBijN|Fcx^87U
zFCz~a9RI%&eyS_(7ziKFCj2`G!C(E2@DqL~LA#o7)iz%5+r}}~dpbq?E$-E1S6ufq
zWYzslANsu4kyBufTd{&~mmve>Q$5%FvW<L-oTf}NB{e(^`_Wc5M9bWi`L^M2g&^Cx
zDrUA^fensqRsvDTMTY(PA(O`EYI`n=g#1N`A3|%|8{6KE+~_9(LH?@jw>DWdQ~o5Y
zCCK+eYQ7j!pl>qyYZ_h>Cwf!Shv$Y|3VDZ9h;3(06152rzgE&E_-n-MZDBF`ZcHI1
z<UlNH)MG2+oSLDHfG#L~SMH~*ZDGP3pZMRVh?&NGfhc6cFxPgNYtu3{2&rup>r&s9
z8Dulo!>&Ve8fDmJs#eXpdo#6Up0{e#7UT!IFW2?2AWM4-F#Z5qXW(MGng6G8uYzxp
z-YXF-N~n;;mHn`Om!<2yU{gX(;2CpZQ{u`_6W9Ea+GfBcFvofh?m~X#BzP{-We$D3
zw$X@rr=ioFC%dpG;1$=7@S!As%#CLUiAMzZ4gopP=p?r5p9FN8ZKE_(4`4T~wJ(j*
z_vcyQWcnR!r#Ksw4Se>K_P2Om3_F89ZA-&FVtO^(5%$Bw`PoQ?G^}@8aj)lL$TPdx
z&H#^gkJ2*03)>mb8I_m=o~P;K%d@pP=;M6rIlawvehFL*hv)ReIh(CLi19Cwo9XL*
zkfU)d(C>S4wCRbpld<-O-G02cQRn|A@%#sOXq=lf-)1f~R-i2Ajo{P#z->nibm%@!
z4cmYVdKw;%wsZUU!`>x<SSNBN{|9e|qd(Xg>qKtk{q~z-<$d&X&eQuwSbq0lOvHTb
z-xlzKSdbiK-%sg$)?2@i&vyLGd4NMr)8wVz9wRo~$cxxM1xrE1kym^ix!8q6rmkGQ
zL+b&r^Pq3rERYN2g&^9NiT$ceRzkYZ16%^!Mv*cuL03fNBp(qS5a+02j^*W@X<B}o
z__kQ@=s5v?33%*j^)WBwc!Bj3UcX)~;q!<$gKcw^^G)DjnIS&vd-gP1$fd*&+ty_{
zAUFFJ*0b)JI>$7yKj3&j9kwBW4#c309iX3O(&cZ=Xv)z2eJasNXOXS=xIm+(;4D%t
zlbYKIzAQ9yN+G=zQ*CN4)#qhwhJPwfb02R<j>P&<4Et@LK-DhrK$J7ZVR0RIytV8&
z&y%PzEakov<9Sj_V|Z7NKjt7Q=-Ub3W-EyJ-a(Fuc|w{R_Qeo4U~i`-(dlhMj$cNa
znykdjn$qDLp)=r9w8G!P9_wzRW5|nPx0LaB@bxS|Q^!7p{&IfIGHJpXby_rz!T+Sk
zU!#8$`VYD&g7c`x=kFUiz*qFxS%Z1-snu+Ud<GQ+<$m(BKS;@-<i--zA8KSGC)x5M
zIpEpcU-%S{JmHb!r23ANWhwM9FA{Bd1vQ1dh!;9eU3t(?)E}aG5rGPD<wZKscAzB(
z`gS}JaXk3waR<-GC7;H6*!C|#54R?-ztnBj$Uk+xhn{fj&8GJt8$AzVd+UO|nYjnY
z?H<74^Y#8~ecLk0I1eA@IQXp_`M(+SL1*IZ^rNrp8SDl&;M|FGVh7?p;+gY%*uMt>
zhkcidGdah4K6`fDsl*=wF7EHdS(DF%9Yun+F45;lzOeHy?7e`TaFh~SEU6i#MBSf4
z$Mmykxp5Y4f{j#}YXGAb_l(1V_I-|{&~4VC4<u@19h?N)p)dQU>oV)Nn}5;IG=?Ae
zpr5CXmgGPg<mOhD(5|g1fjw_q1Mfc0eqWi%F~lm7hwTb6!I=lREI(CLW~#93q-1Jq
zOD63q_QStf)DD)SZXj6#{>_5szYBgTS<Uc2jlPuPfImgVH5-={=-7<93f5WRV_4s>
zZTy8!TZ1e``T)z6y?q>22Otak&tZ4TY6-PA=Cbcl1e{fHk@ZlnK&U&(c^dIKr{45)
zKMjb=TP69(1#};QTpGE~d$sN{+8Nl4;D4i}BebiAtgnaVv+u^-@DpChF%9igkfCme
ziQ16^dT>s+p$~PLvERI`pC^PMVn~qd5Is1<6oH;AQc~~>DFrqx1TIMy)Nzu7?8iiD
z<PjrIjSLn6-jnD%EoPxF3v$g07FpDiMd<rT%tT)%$FraWc=OQ*eLhc}c^a?j&yV!F
z!Qs76Ko(4cA2wB(=81Jc-wQ2I##B7J^!ugoxoWrzGAvAcCZ^!NQNQ=bqABg$Sr_<H
z+yxPWuVb6>VVvNzI5$BpE%E$dM2|OIOSHO=^BSHjq(#GIjfQ1Xbyy}GL&pvVnsF9*
zg*tz0u^Q)_f3bD`7P1UBQ}Uxx$jnF98G`?nl4cT|&6||1|BL+-;4+QPD$iT7k8^kW
zaP4uy_FmXR7W4_hXuBF#t^OGMuc(azrx7C!oW>scUlpJ>d&3>&r0vW`EVUzsvTu+@
zZP!%96UfrcFIj%(81faw6~k9DExJ6g4!YrCSukDsfT1iU#0%sIxG%$gig;#P__;!d
z@zX#h`c2(q`!{i5f1MVblSG{HBpLN9rb`{K?H}ah!UN7ttWRu%9Ou5vbmdV^CulMB
z$A}s1w+@SxW!RHh^ZaR`0l9`7Ie{4~YoP<>$?e;xA_me@&Ldxp)n;V|%S17FF}r;`
z^Sn4OGuQ$6W#Wc?g|s2I*tT^$?|&_xr&+0n$C?y1T#Gd?fgS|aEY!<N;4hwIS-pV1
zT9Jb7sZ{MvuHVOf<bvNv-&g7Tp>9)O)+PnM<QNXy%7fha9Jvnm7hh=!0A}}e8rjmz
zdY(+jSQcz^aVg2^e}Lj_d%HJMXdd)E5A_B@PW0iXywN+_DV^lsZAWe9^?c;5&y4%s
z_S3+Tg*o>_2Gbg{Mz?*R(og1}*xm`a{u!u!rck=S0sd;E5^9%drI<{f@~ui>Yr~7j
zm(Zw|%a~U|mX=bIx}n?0QdZXXsPYrNQ43}4LhSQNsNao1+$8A;a^)7*7tZy37~?p}
z_ml$P&aq&IUfX&dvG~F`sdPgWbG*n4XxxeIs!03U{u*dxx1tvJBA@g`QE!}xKIXwU
zS_z$z?r=t>+~BK_HLA@${s)x!4$yyE$`0BoyZh64pGN_WW3XoKeM(3H>@L(u&TXpO
znnEf6=(-Q*BH)Z#lzqH@PXohDflnI^|C1ZEC~C>OQz^a;@LBiXoyzgQDICR|r_k3R
zj_mec?enm&VjGRZCvxmL_eR~8Kf;F(^i}bd#epwtXT#6`T=(<iQ9qfTPWvYy2Ir$D
zV!ua;Ifj#GEcU(OZY6eT7<mq&ZA5E<9haikWwH3f#kS&J3uxfBBaLJG4WB$pNNQo-
zIEg*lkJ_GH7}br~bd1lRWv!mxy+g?(0)D$Fc0bJbz<mn$pQe&$Xb$o}=&uO6Rt_2W
zc17dg_Ee<Ofpg$#6<Lp*MgL)m_WvPA3H$>4-$2RTk0jBtru;{G|M+Tq?spJ7+QroF
zGI>rf&MKaNr6ETOg|u$ei9H8FyO-wlHlkmFd>SaVyP1Zxs9WarvJQQ6XM3()KrL^}
zyxy}j+H+5lW#zv@@6I9LKFx9j4dq*uz-I7Nj`{5(bni8#mu;$cCuwoaF~=Df&(X(i
zo?c&K4)UJtBJfa3L%S;qjJ0mS=X&%Nwma;vn~d1w1<Zd({llnjXX<tEFrNMSEHCPw
z2bdq^!>4|WWl7yDphNq=Me%g-MjWdYyVil4SQ?%k7UR6>gUzx35ODr9=k)7G;;jF_
zuMN<d0q1|iuivO&aQ?yXN4yzIyc4xCBVJ|&Sr*ShFMC;LdQM^bz#HcT*5fS5fzJvY
zcV{9F_-1iFjdud)Up#I{jolCa%5ovA<#G?nhK$OcI8$Iw0|_fvV;{?ao7cD}2`%P4
zyG6OsfjXrFF^|uZZJ<X@g^fdR$^nmkbp>#-y;PPcArb34ku$RFnFcTBFb$j0*Z8J_
zbG6h$*h|#$y8YMsJk7a!-hZAxw`)zJ68|5_{ooVY?!_g;XY!fCTO!QVa~GZekN2|7
zS$=$7kj4a4z%TgQFPxtlar9JganOtVg!6YqWU=(53-s*7e4Yp2)28yg80OLPeL~Eb
z<HMZ4zv&#$SLS>db1nkT>wtqp5&TI;Fp9n5_R~cBf6>Z-Pqbm54EX#m(+fI2!#c#1
zHsqv7-Gq00uy?WwZ!1FS$v<F>b9g?#$awbaX9(z3p0b7V>bJ-_N(=MK{q&%+g?(!@
zyFHitE@K@*z9Qb4a4nSJpLtIOoS#dPcOu`77vdbudr0s#{4AqR%lmA~(99Q+KZcP%
z#*kx%kz>ZbhnO!QmvkVPJdAsD-f#FG{!2j32DF3(E9v$1?*ry3iMl(GTaUr{^pvE;
zx?o4wTa-AT%P^*KtY;lP_a$m`uRtG^F%bcm%z0WGYU0qtsn~n_tHUGh4@fvCWd*0;
z`IYY%2b#ZE6li+W9Z+9!1)@^>NdnJKjNOIH3)%i&vIjo_j$giJ;A<C1vndZnCgaKg
zJx33x2f`}F=ZebvVc_48*iX)hSU1>@UWXpLp(6@p#PTU#AlSw~F4$OJBIGY!Zx2h+
zgQy!xsqK`c*S8ui?jFR(R6bX5O<z^%7_a5Cp#03j<8qqvK0oIJhJ=glQEA<*=aygT
zla0P16O_OZB`4y<H9~O(M%Z#9lW?Vva|afo9YVR0)VqrUsjj@p(2|@;+O*<8nw%54
z2iNciX9tGw#JXKM5nJ(`z(VwCN3mwY+`zn}qa)AZ8dmUdU|1dIdKvz_z=%bFk1KuL
zBZ0|0w=*Y_x>Sj$?id{zI%$63uA;oid|bl{9t#XZy9U<?WkF!Xq`b(ag?SO?4ez)E
zr$-2Zv)N+c6T1}n^iE6Qv-^?)pU+4R{HZV{aDJ{e5PN(`;L?)Rz!#-M13k;q0=-qk
z0#~0O9>{PNL}Cp_t{Y8J0LKM5Zonx5oMOP44LEZEXD;A83^?-u=Mlhp6maGP&SQbA
z4N5%El@q!8{DJ_}^C#@-^^FSrVLN;T>H??_Txg+qY_k$S|FcDb4Ahcr(7VaFU_;qw
zV1sIwQUE>LUxc;S(C4MnliZ(#y2TzF9aG2s^L9#u{Y{_?MewJzgEZ<SZ3gBi_4OU#
z`JZ6^-FS`y&h7_<g`eU6EY3^KSdaW++kLpM<M}1%UI)&{W9flN`TT{)o1hnN`D4!O
zT8iKwiN?MzzcdtnL~LPw*#*67hc98?{_MI9|H*ahtvAIdf~HBJm)kQ;Z<=!aWzf3|
z^cEs#9Giq35j2C&&p7w8;4H&uqzVh|Zzr*P0_rXHG$jU^c#_hTef%!vWyBAA78TfG
zLx;ed9WlNM<MvIBd-?uj^c9l>d8DNq{@WwhF;B>U@XWF({(KYs;MdpKflp;PI&4vg
z%`#*B-s^bZ2K-DL>LWUBP3SY`TJ*Wtuk2EVF6;t~v9?2dC0pZOw?fA_rvM%M$3jOW
zz;?r@Hi8a)KOhU^dlbj(=JzQ5dj&twxeU+at07SfxQz4Ix@>CgSg*wW>$xsL@XKoW
za^hVta<-8BnVbwa&X9PItov79b8+#(z@-st24cRG*B`+8k;tokxOa3G&D@!)*U+Dn
z;YV>FKMk4@JDq$^SE%qL^2Ev39A!h+du_P~5N|JlHuzZQ#l?sAnz*kw0LKyokBQ?l
zbagNe0*(&k42N_a#`}-K@M8)1mzEsbd%eMUkB#p;_B$k+CgO6h%3GXo{V3O!M;Y!-
z*2QkLQkoJfr#q%dX^1U|FQNsPP0c7LF_rtukr!|aUs@tzY%FRD5@e+J+bG0&1Irpd
zTW`<7Ci#8r9LT9N3po<oC-~v|@^$3>z|rdPXKILJybrAoISb$3B<}sVw^6(Udm~sV
zzJ>XLox=xIcR@$;@y@|*8J$t83e_BAcY>CD&^)+bMjzAU$TDOuV4aWXe!@GH1g#l*
zi*eQ$9(Mq4VFIqn3#vr=ILAk>IpCa)cRS;ePv9K0b4-L|m|Gqbk&q8cXgP**4q`!#
zV-I*p68y1dN(#Q*^Wv61QewMp&D$+D<J&66Z^4{W*cI!Kw7jB#ZDl;p27Atz7Bo=O
zN*O$QDe2J!&ANQC4_G7VIp(<K<pq}IV++c$j%|kLC6jREENDFi+ho6a3H=iM+IU=D
z(pbn}z;_F<A^4C&BHey>F83CcEtd<7Z%Zutdw^>jf6VWc``=f-a|YiG;cR_LlAKTG
z(PF&ccS_d7+r6sgZPeH<EC(+5=X4Rii=GkEJC~0yIDoSv*J#)WAtyb6T)#RKda{b?
zLe0~Pxp=SlsGUZx{0?~K8h&ju&fLf`I0whsYf*bLP42{e|Hls<qt0n9<ZqbSgZzQ_
z%`1)^YMueiZ(y!%4E5I~InQUBxi-KxfvGs7J>XIFvwsfJ(VQxW#`S@0jC~urq@pGn
z&BeQwHmU}0&5=u<Q5Zvxr;ph?g=!V&J}dmLy;Z38BKP_^XtQ_Xe0~Rccn#105%{w2
z#yHP=PpEFp(Z8`s=W)c!Z2JkoNhi;1y!MwuHQ}uGV_p*#s{J^V+CLSlyG9xCT!7bw
zHOMQgQOoljg05_(o*BME<GmJgsVr|krN95tRQPME#yQf%V;6A-f8hL!TQ<P&48t6K
z&3*sD8jRgoqlVb${fK%#=#_GhK&ck_akkwKxu3xvp+4Z`+9{v$Ij>{bUf}!!zK`iy
zpP=Uy_M7S9F@`-lK@W5w%rz|RwWdg!Ed+h{q88i)_`L5sBw^@9;Heq_yEg%QLjrcG
z^mW)3;FV!F!{3<jy<(0I-w*h^QJ+}>9J^6B;qxrxIhjg}OrH2V6}*=$xhUm275J?k
z5)EAd8V1Xr`C<6Xt1m$hZ0T#fdI!kf3;BNInuP3GK3D_U3r>?JrpIv$XfW|JExgxP
zai(N>aGma?c*khgWfk@Un_nctAC!)x>Upr?Y}DANL$*AQ+$<Zq*TyxaiMWqSc~0Fw
z;0$ltEq}juqqg%iy|&Z;zQy={#Yupl2mGwx-kt4FneT86zeu-#w<T~}0=Fe_TLOQv
z1k~_9UG3ZULtKCHlK;YqGGg>L;C|~C;a7nFdEl<UMfknIzXZ6K-Xi=e@XrA5f?I^&
z5B%A{opX!ucLM(v)FgXw{THhBUkoY={Qm~rzrIEI`R{bDZ>0E`l7}My-tg4%Q>Ao4
zSk&iP*~{Ne{Plk_YRTKc`&+k&e|-B9ejd2%ZxMbk@Gk-GrMC#b3j8yGyWke#_XB@6
zaOd12{GGsmr5E;(>#wivU&jyy{(l4RU*979U#IAH&ut0ZmcVTZ+?K#?3EY;z|L+o5
zKjq#@6KX0~Rr+cxC(h!hd#21NxMx}U)Pm_Vr}LjP8$b8D6|3sxS@PujXHC6-*7Qkt
z%L}U3%Tp%d-{b;Jc>~4VoBg7R&d&#pf12n&ffs)Re^(O^1&RJ&<0C-+{ZP@H{{L3t
zgIWHyCR+UMr~dmi(XPTrg!~(qXs;&vjb5VH63=yJ|JwVEA;p}LXcPStCeL->EibNG
z^TOTo6OT@$5?}4wvdWs87vzO2<f-ywRTY)1WH%YpX0I-*tgX9SE?T}~jqjW0-bE9h
zShI3X)$?m6QsRbEYu2uqI!jJG%4Jo)nhLq5a{Y?h6;*5GN%i9=71XCvmNBcivaYhc
zuCij5JieCyJ#CEt_tYC;d}XUD<+>`lLZ3Pa9?JLlDf<8T&)gtG@TKw3hd!47&|`aw
zKmLctpB1LQxp(9L{MF9F$6mg6?#FvX`8Pw?e)P8Usd}ZoGWE%(+NRf%j&}Xs;@@S?
z{mxwrQy<;%P=PJqkf+scz&|l0fhW<QljyHA`%N+iw~6_!#l}GY{6zo5gW)9l)xq-z
z!@d3d*O5R%{srH#FB1m!pFH}fcdvdHd30OT-%pE8`{3-{6V}!9ufH|t?e9)pc;qKf
znX0_Htg3#Nytr}=n?v<FSeIP4Vs&NJy1IUCH>Q+SmRGJ=Ux`_@Ypd4OLi=wzZAnel
znq_kNa^IRYm8)j;TUNsU3{X$3sjOeCTbS&tr~ts)Z<tsF<Cp*D=0KKJ)(tW{`B~qJ
zRh1R;1jAe>!k*n#Rdp*skEdo`Eeu+ov!Z78^S+u&9-2Ry?HgRq!LoHVmGX);@>*_I
z`<7M8tEzkzGPtN%#p|n{mEH5F$P>m_0II$Kz+nFREFO6_0r=iQ@TwrsKMT;H#iSMB
z4D#-ov*d|cveWqCUS3#JRSsdvi|c$f;3hF*@^WMS)XAV?_Wa3m?YgyVt7__MWtXd_
zeEI#;?x|X{>V<pdg?dnuYgvMbJ{9t_t9;AkBG1y&c?*i>KT$lp)a5EEdU)!T(vsP8
z7xM<B((ICw$4h3(vP=se_slDrjaypcDp@dZ!Q5Fg&08?%aUPWE$=N0D#}{MRG=g8v
zG46hoXwM|tKPK8MiI&J*l4$XTBLDFHg85StH+T)K|IAk4r?1Zwjah^IFMrsa_$lVi
zU(%+oUhP|33VkiDsa%GjQChydvV7%)i3zQ{S4PaLs*%Uzd-T)=RdsUZnyPinmdmRv
zS63mHL07OG#=}czrOHpbW<g6=)ywii<Bo4@S8S-{?hUy2)z#JTJ)+V=*MfOP=#Uo{
zAy1f8PxwbP>F5X-)4dme>~*uBE|dWSf{3p%_@~@uwETZ3zJS9Y#ptpd*neZjfBKF;
pGUp%uPONWW+j(aqe(9t5Z<6tBrVGl%uRfd8%+}<~gxlZ${{V7n<9`4E

literal 0
HcmV?d00001

diff --git a/Platform/RaspberryPi/RPi3/TrustedFirmware/fip.bin b/Platform/RaspberryPi/RPi3/TrustedFirmware/fip.bin
new file mode 100644
index 0000000000000000000000000000000000000000..eff727ca78dc07cbfe56f1b6717e93b91702c16a
GIT binary patch
literal 41714
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
F{9hQUX+r=2

literal 0
HcmV?d00001

-- 
2.17.0.windows.1



^ permalink raw reply related	[flat|nested] 34+ messages in thread

* [PATCH v5 edk2-platforms 19/22] Platform/RaspberryPi/RPi3 *NON-OSI*: Add Device Tree binaries
  2019-02-05 16:25 [PATCH v5 edk2-platforms 00/22] Platform/RaspberryPi: Add Raspberry Pi 3 support Pete Batard
                   ` (17 preceding siblings ...)
  2019-02-05 16:25 ` [PATCH v5 edk2-platforms 18/22] Platform/RaspberryPi/RPi3 *NON-OSI*: Add ATF binaries Pete Batard
@ 2019-02-05 16:25 ` Pete Batard
  2019-02-05 16:25 ` [PATCH v5 edk2-platforms 20/22] Platform/RaspberryPi/RPi3 *NON-OSI*: Add logo driver Pete Batard
                   ` (4 subsequent siblings)
  23 siblings, 0 replies; 34+ messages in thread
From: Pete Batard @ 2019-02-05 16:25 UTC (permalink / raw)
  To: edk2-devel

>From https://github.com/raspberrypi/firmware/tree/master/boot
The .dtb's were decompiled to .dts, and then edited to fix USB
keyboard support as well as CPU enabling through PSCI.

Contributed-under: TianoCore Contribution Agreement 1.1
Signed-off-by: Pete Batard <pete@akeo.ie>
---
 Platform/RaspberryPi/RPi3/DeviceTree/License.txt              |  340 ++++++
 Platform/RaspberryPi/RPi3/DeviceTree/bcm2710-rpi-3-b-plus.dtb |  Bin 0 -> 25617 bytes
 Platform/RaspberryPi/RPi3/DeviceTree/bcm2710-rpi-3-b-plus.dts | 1263 ++++++++++++++++++++
 Platform/RaspberryPi/RPi3/DeviceTree/bcm2710-rpi-3-b.dtb      |  Bin 0 -> 25354 bytes
 Platform/RaspberryPi/RPi3/DeviceTree/bcm2710-rpi-3-b.dts      | 1259 +++++++++++++++++++
 5 files changed, 2862 insertions(+)

diff --git a/Platform/RaspberryPi/RPi3/DeviceTree/License.txt b/Platform/RaspberryPi/RPi3/DeviceTree/License.txt
new file mode 100644
index 000000000000..1603937dad82
--- /dev/null
+++ b/Platform/RaspberryPi/RPi3/DeviceTree/License.txt
@@ -0,0 +1,340 @@
+                    GNU GENERAL PUBLIC LICENSE
+                       Version 2, June 1991
+
+ Copyright (C) 1989, 1991 Free Software Foundation, Inc.
+                       51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
+ Everyone is permitted to copy and distribute verbatim copies
+ of this license document, but changing it is not allowed.
+
+                            Preamble
+
+  The licenses for most software are designed to take away your
+freedom to share and change it.  By contrast, the GNU General Public
+License is intended to guarantee your freedom to share and change free
+software--to make sure the software is free for all its users.  This
+General Public License applies to most of the Free Software
+Foundation's software and to any other program whose authors commit to
+using it.  (Some other Free Software Foundation software is covered by
+the GNU Library General Public License instead.)  You can apply it to
+your programs, too.
+
+  When we speak of free software, we are referring to freedom, not
+price.  Our General Public Licenses are designed to make sure that you
+have the freedom to distribute copies of free software (and charge for
+this service if you wish), that you receive source code or can get it
+if you want it, that you can change the software or use pieces of it
+in new free programs; and that you know you can do these things.
+
+  To protect your rights, we need to make restrictions that forbid
+anyone to deny you these rights or to ask you to surrender the rights.
+These restrictions translate to certain responsibilities for you if you
+distribute copies of the software, or if you modify it.
+
+  For example, if you distribute copies of such a program, whether
+gratis or for a fee, you must give the recipients all the rights that
+you have.  You must make sure that they, too, receive or can get the
+source code.  And you must show them these terms so they know their
+rights.
+
+  We protect your rights with two steps: (1) copyright the software, and
+(2) offer you this license which gives you legal permission to copy,
+distribute and/or modify the software.
+
+  Also, for each author's protection and ours, we want to make certain
+that everyone understands that there is no warranty for this free
+software.  If the software is modified by someone else and passed on, we
+want its recipients to know that what they have is not the original, so
+that any problems introduced by others will not reflect on the original
+authors' reputations.
+
+  Finally, any free program is threatened constantly by software
+patents.  We wish to avoid the danger that redistributors of a free
+program will individually obtain patent licenses, in effect making the
+program proprietary.  To prevent this, we have made it clear that any
+patent must be licensed for everyone's free use or not licensed at all.
+
+  The precise terms and conditions for copying, distribution and
+modification follow.
+
+                    GNU GENERAL PUBLIC LICENSE
+   TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
+
+  0. This License applies to any program or other work which contains
+a notice placed by the copyright holder saying it may be distributed
+under the terms of this General Public License.  The "Program", below,
+refers to any such program or work, and a "work based on the Program"
+means either the Program or any derivative work under copyright law:
+that is to say, a work containing the Program or a portion of it,
+either verbatim or with modifications and/or translated into another
+language.  (Hereinafter, translation is included without limitation in
+the term "modification".)  Each licensee is addressed as "you".
+
+Activities other than copying, distribution and modification are not
+covered by this License; they are outside its scope.  The act of
+running the Program is not restricted, and the output from the Program
+is covered only if its contents constitute a work based on the
+Program (independent of having been made by running the Program).
+Whether that is true depends on what the Program does.
+
+  1. You may copy and distribute verbatim copies of the Program's
+source code as you receive it, in any medium, provided that you
+conspicuously and appropriately publish on each copy an appropriate
+copyright notice and disclaimer of warranty; keep intact all the
+notices that refer to this License and to the absence of any warranty;
+and give any other recipients of the Program a copy of this License
+along with the Program.
+
+You may charge a fee for the physical act of transferring a copy, and
+you may at your option offer warranty protection in exchange for a fee.
+
+  2. You may modify your copy or copies of the Program or any portion
+of it, thus forming a work based on the Program, and copy and
+distribute such modifications or work under the terms of Section 1
+above, provided that you also meet all of these conditions:
+
+    a) You must cause the modified files to carry prominent notices
+    stating that you changed the files and the date of any change.
+
+    b) You must cause any work that you distribute or publish, that in
+    whole or in part contains or is derived from the Program or any
+    part thereof, to be licensed as a whole at no charge to all third
+    parties under the terms of this License.
+
+    c) If the modified program normally reads commands interactively
+    when run, you must cause it, when started running for such
+    interactive use in the most ordinary way, to print or display an
+    announcement including an appropriate copyright notice and a
+    notice that there is no warranty (or else, saying that you provide
+    a warranty) and that users may redistribute the program under
+    these conditions, and telling the user how to view a copy of this
+    License.  (Exception: if the Program itself is interactive but
+    does not normally print such an announcement, your work based on
+    the Program is not required to print an announcement.)
+
+These requirements apply to the modified work as a whole.  If
+identifiable sections of that work are not derived from the Program,
+and can be reasonably considered independent and separate works in
+themselves, then this License, and its terms, do not apply to those
+sections when you distribute them as separate works.  But when you
+distribute the same sections as part of a whole which is a work based
+on the Program, the distribution of the whole must be on the terms of
+this License, whose permissions for other licensees extend to the
+entire whole, and thus to each and every part regardless of who wrote it.
+
+Thus, it is not the intent of this section to claim rights or contest
+your rights to work written entirely by you; rather, the intent is to
+exercise the right to control the distribution of derivative or
+collective works based on the Program.
+
+In addition, mere aggregation of another work not based on the Program
+with the Program (or with a work based on the Program) on a volume of
+a storage or distribution medium does not bring the other work under
+the scope of this License.
+
+  3. You may copy and distribute the Program (or a work based on it,
+under Section 2) in object code or executable form under the terms of
+Sections 1 and 2 above provided that you also do one of the following:
+
+    a) Accompany it with the complete corresponding machine-readable
+    source code, which must be distributed under the terms of Sections
+    1 and 2 above on a medium customarily used for software interchange; or,
+
+    b) Accompany it with a written offer, valid for at least three
+    years, to give any third party, for a charge no more than your
+    cost of physically performing source distribution, a complete
+    machine-readable copy of the corresponding source code, to be
+    distributed under the terms of Sections 1 and 2 above on a medium
+    customarily used for software interchange; or,
+
+    c) Accompany it with the information you received as to the offer
+    to distribute corresponding source code.  (This alternative is
+    allowed only for noncommercial distribution and only if you
+    received the program in object code or executable form with such
+    an offer, in accord with Subsection b above.)
+
+The source code for a work means the preferred form of the work for
+making modifications to it.  For an executable work, complete source
+code means all the source code for all modules it contains, plus any
+associated interface definition files, plus the scripts used to
+control compilation and installation of the executable.  However, as a
+special exception, the source code distributed need not include
+anything that is normally distributed (in either source or binary
+form) with the major components (compiler, kernel, and so on) of the
+operating system on which the executable runs, unless that component
+itself accompanies the executable.
+
+If distribution of executable or object code is made by offering
+access to copy from a designated place, then offering equivalent
+access to copy the source code from the same place counts as
+distribution of the source code, even though third parties are not
+compelled to copy the source along with the object code.
+
+  4. You may not copy, modify, sublicense, or distribute the Program
+except as expressly provided under this License.  Any attempt
+otherwise to copy, modify, sublicense or distribute the Program is
+void, and will automatically terminate your rights under this License.
+However, parties who have received copies, or rights, from you under
+this License will not have their licenses terminated so long as such
+parties remain in full compliance.
+
+  5. You are not required to accept this License, since you have not
+signed it.  However, nothing else grants you permission to modify or
+distribute the Program or its derivative works.  These actions are
+prohibited by law if you do not accept this License.  Therefore, by
+modifying or distributing the Program (or any work based on the
+Program), you indicate your acceptance of this License to do so, and
+all its terms and conditions for copying, distributing or modifying
+the Program or works based on it.
+
+  6. Each time you redistribute the Program (or any work based on the
+Program), the recipient automatically receives a license from the
+original licensor to copy, distribute or modify the Program subject to
+these terms and conditions.  You may not impose any further
+restrictions on the recipients' exercise of the rights granted herein.
+You are not responsible for enforcing compliance by third parties to
+this License.
+
+  7. If, as a consequence of a court judgment or allegation of patent
+infringement or for any other reason (not limited to patent issues),
+conditions are imposed on you (whether by court order, agreement or
+otherwise) that contradict the conditions of this License, they do not
+excuse you from the conditions of this License.  If you cannot
+distribute so as to satisfy simultaneously your obligations under this
+License and any other pertinent obligations, then as a consequence you
+may not distribute the Program at all.  For example, if a patent
+license would not permit royalty-free redistribution of the Program by
+all those who receive copies directly or indirectly through you, then
+the only way you could satisfy both it and this License would be to
+refrain entirely from distribution of the Program.
+
+If any portion of this section is held invalid or unenforceable under
+any particular circumstance, the balance of the section is intended to
+apply and the section as a whole is intended to apply in other
+circumstances.
+
+It is not the purpose of this section to induce you to infringe any
+patents or other property right claims or to contest validity of any
+such claims; this section has the sole purpose of protecting the
+integrity of the free software distribution system, which is
+implemented by public license practices.  Many people have made
+generous contributions to the wide range of software distributed
+through that system in reliance on consistent application of that
+system; it is up to the author/donor to decide if he or she is willing
+to distribute software through any other system and a licensee cannot
+impose that choice.
+
+This section is intended to make thoroughly clear what is believed to
+be a consequence of the rest of this License.
+
+  8. If the distribution and/or use of the Program is restricted in
+certain countries either by patents or by copyrighted interfaces, the
+original copyright holder who places the Program under this License
+may add an explicit geographical distribution limitation excluding
+those countries, so that distribution is permitted only in or among
+countries not thus excluded.  In such case, this License incorporates
+the limitation as if written in the body of this License.
+
+  9. The Free Software Foundation may publish revised and/or new versions
+of the General Public License from time to time.  Such new versions will
+be similar in spirit to the present version, but may differ in detail to
+address new problems or concerns.
+
+Each version is given a distinguishing version number.  If the Program
+specifies a version number of this License which applies to it and "any
+later version", you have the option of following the terms and conditions
+either of that version or of any later version published by the Free
+Software Foundation.  If the Program does not specify a version number of
+this License, you may choose any version ever published by the Free Software
+Foundation.
+
+  10. If you wish to incorporate parts of the Program into other free
+programs whose distribution conditions are different, write to the author
+to ask for permission.  For software which is copyrighted by the Free
+Software Foundation, write to the Free Software Foundation; we sometimes
+make exceptions for this.  Our decision will be guided by the two goals
+of preserving the free status of all derivatives of our free software and
+of promoting the sharing and reuse of software generally.
+
+                            NO WARRANTY
+
+  11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY
+FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW.  EXCEPT WHEN
+OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES
+PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED
+OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.  THE ENTIRE RISK AS
+TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU.  SHOULD THE
+PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING,
+REPAIR OR CORRECTION.
+
+  12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
+WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR
+REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES,
+INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING
+OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED
+TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY
+YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER
+PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE
+POSSIBILITY OF SUCH DAMAGES.
+
+                     END OF TERMS AND CONDITIONS
+
+            How to Apply These Terms to Your New Programs
+
+  If you develop a new program, and you want it to be of the greatest
+possible use to the public, the best way to achieve this is to make it
+free software which everyone can redistribute and change under these terms.
+
+  To do so, attach the following notices to the program.  It is safest
+to attach them to the start of each source file to most effectively
+convey the exclusion of warranty; and each file should have at least
+the "copyright" line and a pointer to where the full notice is found.
+
+    <one line to give the program's name and a brief idea of what it does.>
+    Copyright (C) <year>  <name of author>
+
+    This program is free software; you can redistribute it and/or modify
+    it under the terms of the GNU General Public License as published by
+    the Free Software Foundation; either version 2 of the License, or
+    (at your option) any later version.
+
+    This program is distributed in the hope that it will be useful,
+    but WITHOUT ANY WARRANTY; without even the implied warranty of
+    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+    GNU General Public License for more details.
+
+    You should have received a copy of the GNU General Public License
+    along with this program; if not, write to the Free Software
+    Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
+
+
+Also add information on how to contact you by electronic and paper mail.
+
+If the program is interactive, make it output a short notice like this
+when it starts in an interactive mode:
+
+    Gnomovision version 69, Copyright (C) year name of author
+    Gnomovision comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
+    This is free software, and you are welcome to redistribute it
+    under certain conditions; type `show c' for details.
+
+The hypothetical commands `show w' and `show c' should show the appropriate
+parts of the General Public License.  Of course, the commands you use may
+be called something other than `show w' and `show c'; they could even be
+mouse-clicks or menu items--whatever suits your program.
+
+You should also get your employer (if you work as a programmer) or your
+school, if any, to sign a "copyright disclaimer" for the program, if
+necessary.  Here is a sample; alter the names:
+
+  Yoyodyne, Inc., hereby disclaims all copyright interest in the program
+  `Gnomovision' (which makes passes at compilers) written by James Hacker.
+
+  <signature of Ty Coon>, 1 April 1989
+  Ty Coon, President of Vice
+
+This General Public License does not permit incorporating your program into
+proprietary programs.  If your program is a subroutine library, you may
+consider it more useful to permit linking proprietary applications with the
+library.  If this is what you want to do, use the GNU Library General
+Public License instead of this License.
diff --git a/Platform/RaspberryPi/RPi3/DeviceTree/bcm2710-rpi-3-b-plus.dtb b/Platform/RaspberryPi/RPi3/DeviceTree/bcm2710-rpi-3-b-plus.dtb
new file mode 100644
index 0000000000000000000000000000000000000000..d1b37bd1375de4fe4b5f26fe611e40a5a09d9327
GIT binary patch
literal 25617
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
G;Qs)(;p;~L

literal 0
HcmV?d00001

diff --git a/Platform/RaspberryPi/RPi3/DeviceTree/bcm2710-rpi-3-b-plus.dts b/Platform/RaspberryPi/RPi3/DeviceTree/bcm2710-rpi-3-b-plus.dts
new file mode 100644
index 000000000000..e22c5d055f47
--- /dev/null
+++ b/Platform/RaspberryPi/RPi3/DeviceTree/bcm2710-rpi-3-b-plus.dts
@@ -0,0 +1,1263 @@
+/dts-v1/;
+
+/*
+ * Raspberry Pi 3 Model B+ DTS (Device Tree Source), for UEFI firmware.
+ *
+ * This source is the mostly identical to the decompiled version of the
+ * official DTB (Device Tree Binary), as found at:
+ *   https://github.com/raspberrypi/firmware/tree/master/boot
+ *
+ * Only the following changes were applied:
+ * - Two fixes for USB keyboard support under the usb@7e980000 section:
+ *   compatible = "brcm,bcm2708-usb"; -> compatible = "brcm,bcm2835-usb";
+ *   interrupts = <0x2 0x0 0x1 0x9>;  -> interrupts = <0x1 0x9>;
+ * - A 'psci' section was added, as it is provided by the ATF
+ * - The 'enable-method' for CPUs was swicthed to "psci" instead of "spin-table"
+ */
+
+/memreserve/  0x0000000000000000 0x0000000000001000;
+/ {
+  compatible = "raspberrypi,3-model-b-plus", "brcm,bcm2837";
+  model = "Raspberry Pi 3 Model B+";
+  interrupt-parent = <0x1>;
+  #address-cells = <0x1>;
+  #size-cells = <0x1>;
+
+  aliases {
+    serial0 = "/soc/serial@7e215040";
+    serial1 = "/soc/serial@7e201000";
+    audio = "/soc/audio";
+    aux = "/soc/aux@0x7e215000";
+    sound = "/soc/sound";
+    soc = "/soc";
+    dma = "/soc/dma@7e007000";
+    intc = "/soc/interrupt-controller@7e00b200";
+    watchdog = "/soc/watchdog@7e100000";
+    random = "/soc/rng@7e104000";
+    mailbox = "/soc/mailbox@7e00b880";
+    gpio = "/soc/gpio@7e200000";
+    uart0 = "/soc/serial@7e201000";
+    sdhost = "/soc/mmc@7e202000";
+    mmc0 = "/soc/mmc@7e202000";
+    i2s = "/soc/i2s@7e203000";
+    spi0 = "/soc/spi@7e204000";
+    i2c0 = "/soc/i2c@7e205000";
+    uart1 = "/soc/serial@7e215040";
+    spi1 = "/soc/spi@7e215080";
+    spi2 = "/soc/spi@7e2150c0";
+    mmc = "/soc/mmc@7e300000";
+    mmc1 = "/soc/mmc@7e300000";
+    i2c1 = "/soc/i2c@7e804000";
+    i2c2 = "/soc/i2c@7e805000";
+    usb = "/soc/usb@7e980000";
+    leds = "/leds";
+    fb = "/soc/fb";
+    vchiq = "/soc/vchiq";
+    thermal = "/soc/thermal@7e212000";
+    axiperf = "/soc/axiperf";
+    ethernet0 = "/soc/usb@7e980000/usb1@1/usb1_1@1/usbether@1";
+  };
+
+  chosen {
+    bootargs = "8250.nr_uarts=1";
+  };
+
+  thermal-zones {
+
+    cpu-thermal {
+      polling-delay-passive = <0x0>;
+      polling-delay = <0x3e8>;
+      thermal-sensors = <0x2>;
+      coefficients = <0xfffffde6 0x64960>;
+      phandle = <0x31>;
+
+      cooling-maps {
+      };
+    };
+  };
+
+  soc {
+    compatible = "simple-bus";
+    #address-cells = <0x1>;
+    #size-cells = <0x1>;
+    ranges = <0x7e000000 0x3f000000 0x1000000 0x40000000 0x40000000 0x1000>;
+    dma-ranges = <0xc0000000 0x0 0x3f000000>;
+    phandle = <0x32>;
+
+    dma@7e007000 {
+      compatible = "brcm,bcm2835-dma";
+      reg = <0x7e007000 0xf00>;
+      interrupts = <0x1 0x10 0x1 0x11 0x1 0x12 0x1 0x13 0x1 0x14 0x1 0x15 0x1 0x16 0x1 0x17 0x1 0x18 0x1 0x19 0x1 0x1a 0x1 0x1b 0x1 0x1b 0x1 0x1b 0x1 0x1b 0x1 0x1c>;
+      interrupt-names = "dma0", "dma1", "dma2", "dma3", "dma4", "dma5", "dma6", "dma7", "dma8", "dma9", "dma10", "dma11", "dma12", "dma13", "dma14", "dma-shared-all";
+      #dma-cells = <0x1>;
+      brcm,dma-channel-mask = <0x7f34>;
+      phandle = <0xb>;
+    };
+
+    interrupt-controller@7e00b200 {
+      compatible = "brcm,bcm2836-armctrl-ic";
+      reg = <0x7e00b200 0x200>;
+      interrupt-controller;
+      #interrupt-cells = <0x2>;
+      interrupt-parent = <0x3>;
+      interrupts = <0x8>;
+      phandle = <0x1>;
+    };
+
+    watchdog@7e100000 {
+      compatible = "brcm,bcm2835-pm-wdt";
+      reg = <0x7e100000 0x28>;
+      phandle = <0x24>;
+    };
+
+    cprman@7e101000 {
+      compatible = "brcm,bcm2835-cprman";
+      #clock-cells = <0x1>;
+      reg = <0x7e101000 0x2000>;
+      clocks = <0x4 0x5 0x0 0x5 0x1 0x5 0x2 0x6 0x0 0x6 0x1 0x6 0x2>;
+      firmware = <0x7>;
+      phandle = <0x8>;
+    };
+
+    rng@7e104000 {
+      compatible = "brcm,bcm2835-rng";
+      reg = <0x7e104000 0x10>;
+      interrupts = <0x2 0x1d>;
+      phandle = <0x25>;
+    };
+
+    mailbox@7e00b880 {
+      compatible = "brcm,bcm2835-mbox";
+      reg = <0x7e00b880 0x40>;
+      interrupts = <0x0 0x1>;
+      #mbox-cells = <0x0>;
+      phandle = <0x1a>;
+    };
+
+    gpio@7e200000 {
+      compatible = "brcm,bcm2835-gpio";
+      reg = <0x7e200000 0xb4>;
+      interrupts = <0x2 0x11 0x2 0x12>;
+      gpio-controller;
+      #gpio-cells = <0x2>;
+      interrupt-controller;
+      #interrupt-cells = <0x2>;
+      phandle = <0x10>;
+
+      dpi_gpio0 {
+        brcm,pins = <0x0 0x1 0x2 0x3 0x4 0x5 0x6 0x7 0x8 0x9 0xa 0xb 0xc 0xd 0xe 0xf 0x10 0x11 0x12 0x13 0x14 0x15 0x16 0x17 0x18 0x19 0x1a 0x1b>;
+        brcm,function = <0x6>;
+        phandle = <0x33>;
+      };
+
+      emmc_gpio22 {
+        brcm,pins = <0x16 0x17 0x18 0x19 0x1a 0x1b>;
+        brcm,function = <0x7>;
+        phandle = <0x34>;
+      };
+
+      emmc_gpio34 {
+        brcm,pins = <0x22 0x23 0x24 0x25 0x26 0x27>;
+        brcm,function = <0x7>;
+        brcm,pull = <0x0 0x2 0x2 0x2 0x2 0x2>;
+        phandle = <0x35>;
+      };
+
+      emmc_gpio48 {
+        brcm,pins = <0x30 0x31 0x32 0x33 0x34 0x35>;
+        brcm,function = <0x7>;
+        phandle = <0x36>;
+      };
+
+      gpclk0_gpio4 {
+        brcm,pins = <0x4>;
+        brcm,function = <0x4>;
+        phandle = <0x37>;
+      };
+
+      gpclk1_gpio5 {
+        brcm,pins = <0x5>;
+        brcm,function = <0x4>;
+        phandle = <0x38>;
+      };
+
+      gpclk1_gpio42 {
+        brcm,pins = <0x2a>;
+        brcm,function = <0x4>;
+        phandle = <0x39>;
+      };
+
+      gpclk1_gpio44 {
+        brcm,pins = <0x2c>;
+        brcm,function = <0x4>;
+        phandle = <0x3a>;
+      };
+
+      gpclk2_gpio6 {
+        brcm,pins = <0x6>;
+        brcm,function = <0x4>;
+        phandle = <0x3b>;
+      };
+
+      gpclk2_gpio43 {
+        brcm,pins = <0x2b>;
+        brcm,function = <0x4>;
+        phandle = <0x3c>;
+      };
+
+      i2c0_gpio0 {
+        brcm,pins = <0x0 0x1>;
+        brcm,function = <0x4>;
+        phandle = <0x3d>;
+      };
+
+      i2c0_gpio28 {
+        brcm,pins = <0x1c 0x1d>;
+        brcm,function = <0x4>;
+        phandle = <0x3e>;
+      };
+
+      i2c0_gpio44 {
+        brcm,pins = <0x2c 0x2d>;
+        brcm,function = <0x5>;
+        phandle = <0x3f>;
+      };
+
+      i2c1_gpio2 {
+        brcm,pins = <0x2 0x3>;
+        brcm,function = <0x4>;
+        phandle = <0x40>;
+      };
+
+      i2c1_gpio44 {
+        brcm,pins = <0x2c 0x2d>;
+        brcm,function = <0x6>;
+        phandle = <0x41>;
+      };
+
+      i2c_slave_gpio18 {
+        brcm,pins = <0x12 0x13 0x14 0x15>;
+        brcm,function = <0x7>;
+        phandle = <0x42>;
+      };
+
+      jtag_gpio4 {
+        brcm,pins = <0x4 0x5 0x6 0xc 0xd>;
+        brcm,function = <0x2>;
+        phandle = <0x43>;
+      };
+
+      jtag_gpio22 {
+        brcm,pins = <0x16 0x17 0x18 0x19 0x1a 0x1b>;
+        brcm,function = <0x3>;
+        phandle = <0x44>;
+      };
+
+      pcm_gpio18 {
+        brcm,pins = <0x12 0x13 0x14 0x15>;
+        brcm,function = <0x4>;
+        phandle = <0x45>;
+      };
+
+      pcm_gpio28 {
+        brcm,pins = <0x1c 0x1d 0x1e 0x1f>;
+        brcm,function = <0x6>;
+        phandle = <0x46>;
+      };
+
+      pwm0_gpio12 {
+        brcm,pins = <0xc>;
+        brcm,function = <0x4>;
+        phandle = <0x47>;
+      };
+
+      pwm0_gpio18 {
+        brcm,pins = <0x12>;
+        brcm,function = <0x2>;
+        phandle = <0x48>;
+      };
+
+      pwm0_gpio40 {
+        brcm,pins = <0x28>;
+        brcm,function = <0x4>;
+        phandle = <0x49>;
+      };
+
+      pwm1_gpio13 {
+        brcm,pins = <0xd>;
+        brcm,function = <0x4>;
+        phandle = <0x4a>;
+      };
+
+      pwm1_gpio19 {
+        brcm,pins = <0x13>;
+        brcm,function = <0x2>;
+        phandle = <0x4b>;
+      };
+
+      pwm1_gpio41 {
+        brcm,pins = <0x29>;
+        brcm,function = <0x4>;
+        phandle = <0x4c>;
+      };
+
+      pwm1_gpio45 {
+        brcm,pins = <0x2d>;
+        brcm,function = <0x4>;
+        phandle = <0x4d>;
+      };
+
+      sdhost_gpio48 {
+        brcm,pins = <0x30 0x31 0x32 0x33 0x34 0x35>;
+        brcm,function = <0x4>;
+        phandle = <0xc>;
+      };
+
+      spi0_gpio7 {
+        brcm,pins = <0x7 0x8 0x9 0xa 0xb>;
+        brcm,function = <0x4>;
+        phandle = <0x4e>;
+      };
+
+      spi0_gpio35 {
+        brcm,pins = <0x23 0x24 0x25 0x26 0x27>;
+        brcm,function = <0x4>;
+        phandle = <0x4f>;
+      };
+
+      spi1_gpio16 {
+        brcm,pins = <0x10 0x11 0x12 0x13 0x14 0x15>;
+        brcm,function = <0x3>;
+        phandle = <0x50>;
+      };
+
+      spi2_gpio40 {
+        brcm,pins = <0x28 0x29 0x2a 0x2b 0x2c 0x2d>;
+        brcm,function = <0x3>;
+        phandle = <0x51>;
+      };
+
+      uart0_gpio14 {
+        brcm,pins = <0xe 0xf>;
+        brcm,function = <0x4>;
+        phandle = <0x52>;
+      };
+
+      uart0_ctsrts_gpio16 {
+        brcm,pins = <0x10 0x11>;
+        brcm,function = <0x7>;
+        phandle = <0x53>;
+      };
+
+      uart0_ctsrts_gpio30 {
+        brcm,pins = <0x1e 0x1f>;
+        brcm,function = <0x7>;
+        phandle = <0x54>;
+      };
+
+      uart0_gpio32 {
+        brcm,pins = <0x20 0x21>;
+        brcm,function = <0x7>;
+        phandle = <0x55>;
+      };
+
+      uart0_gpio36 {
+        brcm,pins = <0x24 0x25>;
+        brcm,function = <0x6>;
+        phandle = <0x56>;
+      };
+
+      uart0_ctsrts_gpio38 {
+        brcm,pins = <0x26 0x27>;
+        brcm,function = <0x6>;
+        phandle = <0x57>;
+      };
+
+      uart1_gpio14 {
+        brcm,pins = <0xe 0xf>;
+        brcm,function = <0x2>;
+        phandle = <0x58>;
+      };
+
+      uart1_ctsrts_gpio16 {
+        brcm,pins = <0x10 0x11>;
+        brcm,function = <0x2>;
+        phandle = <0x59>;
+      };
+
+      uart1_gpio32 {
+        brcm,pins = <0x20 0x21>;
+        brcm,function = <0x2>;
+        phandle = <0x5a>;
+      };
+
+      uart1_ctsrts_gpio30 {
+        brcm,pins = <0x1e 0x1f>;
+        brcm,function = <0x2>;
+        phandle = <0x5b>;
+      };
+
+      uart1_gpio40 {
+        brcm,pins = <0x28 0x29>;
+        brcm,function = <0x2>;
+        phandle = <0x5c>;
+      };
+
+      uart1_ctsrts_gpio42 {
+        brcm,pins = <0x2a 0x2b>;
+        brcm,function = <0x2>;
+        phandle = <0x5d>;
+      };
+
+      dpi_18bit_gpio0 {
+        brcm,pins = <0x0 0x1 0x2 0x3 0x4 0x5 0x6 0x7 0x8 0x9 0xa 0xb 0xc 0xd 0xe 0xf 0x10 0x11 0x12 0x13 0x14 0x15>;
+        brcm,function = <0x6>;
+        phandle = <0x5e>;
+      };
+
+      spi0_pins {
+        brcm,pins = <0x9 0xa 0xb>;
+        brcm,function = <0x4>;
+        phandle = <0xe>;
+      };
+
+      spi0_cs_pins {
+        brcm,pins = <0x8 0x7>;
+        brcm,function = <0x1>;
+        phandle = <0xf>;
+      };
+
+      i2c0 {
+        brcm,pins = <0x0 0x1>;
+        brcm,function = <0x4>;
+        phandle = <0x11>;
+      };
+
+      i2c1 {
+        brcm,pins = <0x2 0x3>;
+        brcm,function = <0x4>;
+        phandle = <0x15>;
+      };
+
+      i2s {
+        brcm,pins = <0x12 0x13 0x14 0x15>;
+        brcm,function = <0x4>;
+        phandle = <0xd>;
+      };
+
+      sdio_pins {
+        brcm,pins = <0x22 0x23 0x24 0x25 0x26 0x27>;
+        brcm,function = <0x7>;
+        brcm,pull = <0x0 0x2 0x2 0x2 0x2 0x2>;
+        phandle = <0x19>;
+      };
+
+      bt_pins {
+        brcm,pins = <0x2b>;
+        brcm,function = <0x4>;
+        brcm,pull = <0x0>;
+        phandle = <0xa>;
+      };
+
+      uart0_pins {
+        brcm,pins = <0x20 0x21>;
+        brcm,function = <0x7>;
+        brcm,pull = <0x0 0x2>;
+        phandle = <0x9>;
+      };
+
+      uart1_pins {
+        brcm,pins;
+        brcm,function;
+        brcm,pull;
+        phandle = <0x13>;
+      };
+
+      audio_pins {
+        brcm,pins = <0x28 0x29>;
+        brcm,function = <0x4>;
+        phandle = <0x1b>;
+      };
+    };
+
+    serial@7e201000 {
+      compatible = "brcm,bcm2835-pl011", "arm,pl011", "arm,primecell";
+      reg = <0x7e201000 0x1000>;
+      interrupts = <0x2 0x19>;
+      clocks = <0x8 0x13 0x8 0x14>;
+      clock-names = "uartclk", "apb_pclk";
+      arm,primecell-periphid = <0x241011>;
+      cts-event-workaround;
+      pinctrl-names = "default";
+      pinctrl-0 = <0x9 0xa>;
+      status = "okay";
+      phandle = <0x1d>;
+    };
+
+    mmc@7e202000 {
+      compatible = "brcm,bcm2835-sdhost";
+      reg = <0x7e202000 0x100>;
+      interrupts = <0x2 0x18>;
+      clocks = <0x8 0x14>;
+      dmas = <0xb 0xd>;
+      dma-names = "rx-tx";
+      status = "okay";
+      pinctrl-names = "default";
+      pinctrl-0 = <0xc>;
+      bus-width = <0x4>;
+      brcm,overclock-50 = <0x0>;
+      brcm,pio-limit = <0x1>;
+      phandle = <0x26>;
+    };
+
+    i2s@7e203000 {
+      compatible = "brcm,bcm2835-i2s";
+      reg = <0x7e203000 0x24>;
+      clocks = <0x8 0x1f>;
+      dmas = <0xb 0x2 0xb 0x3>;
+      dma-names = "tx", "rx";
+      status = "disabled";
+      #sound-dai-cells = <0x0>;
+      pinctrl-names = "default";
+      pinctrl-0 = <0xd>;
+      phandle = <0x1f>;
+    };
+
+    spi@7e204000 {
+      compatible = "brcm,bcm2835-spi";
+      reg = <0x7e204000 0x1000>;
+      interrupts = <0x2 0x16>;
+      clocks = <0x8 0x14>;
+      #address-cells = <0x1>;
+      #size-cells = <0x0>;
+      status = "disabled";
+      dmas = <0xb 0x6 0xb 0x7>;
+      dma-names = "tx", "rx";
+      pinctrl-names = "default";
+      pinctrl-0 = <0xe 0xf>;
+      cs-gpios = <0x10 0x8 0x1 0x10 0x7 0x1>;
+      phandle = <0x20>;
+
+      spidev@0 {
+        compatible = "spidev";
+        reg = <0x0>;
+        #address-cells = <0x1>;
+        #size-cells = <0x0>;
+        spi-max-frequency = <0x7735940>;
+        phandle = <0x5f>;
+      };
+
+      spidev@1 {
+        compatible = "spidev";
+        reg = <0x1>;
+        #address-cells = <0x1>;
+        #size-cells = <0x0>;
+        spi-max-frequency = <0x7735940>;
+        phandle = <0x60>;
+      };
+    };
+
+    i2c@7e205000 {
+      compatible = "brcm,bcm2835-i2c";
+      reg = <0x7e205000 0x1000>;
+      interrupts = <0x2 0x15>;
+      clocks = <0x8 0x14>;
+      #address-cells = <0x1>;
+      #size-cells = <0x0>;
+      status = "disabled";
+      pinctrl-names = "default";
+      pinctrl-0 = <0x11>;
+      clock-frequency = <0x186a0>;
+      phandle = <0x21>;
+    };
+
+    pixelvalve@7e206000 {
+      compatible = "brcm,bcm2835-pixelvalve0";
+      reg = <0x7e206000 0x100>;
+      interrupts = <0x2 0xd>;
+      status = "disabled";
+      phandle = <0x61>;
+    };
+
+    pixelvalve@7e207000 {
+      compatible = "brcm,bcm2835-pixelvalve1";
+      reg = <0x7e207000 0x100>;
+      interrupts = <0x2 0xe>;
+      status = "disabled";
+      phandle = <0x62>;
+    };
+
+    dpi@7e208000 {
+      compatible = "brcm,bcm2835-dpi";
+      reg = <0x7e208000 0x8c>;
+      clocks = <0x8 0x14 0x8 0x2c>;
+      clock-names = "core", "pixel";
+      #address-cells = <0x1>;
+      #size-cells = <0x0>;
+      status = "disabled";
+      phandle = <0x63>;
+    };
+
+    dsi@7e209000 {
+      compatible = "brcm,bcm2835-dsi0";
+      reg = <0x7e209000 0x78>;
+      interrupts = <0x2 0x4>;
+      #address-cells = <0x1>;
+      #size-cells = <0x0>;
+      #clock-cells = <0x1>;
+      clocks = <0x8 0x20 0x8 0x2f 0x8 0x31>;
+      clock-names = "phy", "escape", "pixel";
+      clock-output-names = "dsi0_byte", "dsi0_ddr2", "dsi0_ddr";
+      phandle = <0x5>;
+    };
+
+    thermal@7e212000 {
+      compatible = "brcm,bcm2837-thermal";
+      reg = <0x7e212000 0x8>;
+      clocks = <0x8 0x1b>;
+      #thermal-sensor-cells = <0x0>;
+      status = "okay";
+      phandle = <0x2>;
+    };
+
+    aux@0x7e215000 {
+      compatible = "brcm,bcm2835-aux";
+      #clock-cells = <0x1>;
+      reg = <0x7e215000 0x8>;
+      clocks = <0x8 0x14>;
+      interrupts = <0x1 0x1d>;
+      interrupt-controller;
+      #interrupt-cells = <0x1>;
+      phandle = <0x12>;
+    };
+
+    serial@7e215040 {
+      compatible = "brcm,bcm2835-aux-uart";
+      reg = <0x7e215040 0x40>;
+      interrupts = <0x0>;
+      clocks = <0x12 0x0>;
+      status = "okay";
+      interrupt-parent = <0x12>;
+      pinctrl-names = "default";
+      pinctrl-0 = <0x13>;
+      phandle = <0x1e>;
+    };
+
+    spi@7e215080 {
+      compatible = "brcm,bcm2835-aux-spi";
+      reg = <0x7e215080 0x40>;
+      interrupts = <0x1>;
+      clocks = <0x12 0x1>;
+      #address-cells = <0x1>;
+      #size-cells = <0x0>;
+      status = "disabled";
+      interrupt-parent = <0x12>;
+      phandle = <0x64>;
+    };
+
+    spi@7e2150c0 {
+      compatible = "brcm,bcm2835-aux-spi";
+      reg = <0x7e2150c0 0x40>;
+      interrupts = <0x2>;
+      clocks = <0x12 0x2>;
+      #address-cells = <0x1>;
+      #size-cells = <0x0>;
+      status = "disabled";
+      interrupt-parent = <0x12>;
+      phandle = <0x65>;
+    };
+
+    pwm@7e20c000 {
+      compatible = "brcm,bcm2835-pwm";
+      reg = <0x7e20c000 0x28>;
+      clocks = <0x8 0x1e>;
+      assigned-clocks = <0x8 0x1e>;
+      assigned-clock-rates = <0x989680>;
+      #pwm-cells = <0x2>;
+      status = "disabled";
+      phandle = <0x66>;
+    };
+
+    hvs@7e400000 {
+      compatible = "brcm,bcm2835-hvs";
+      reg = <0x7e400000 0x6000>;
+      interrupts = <0x2 0x1>;
+      status = "disabled";
+      phandle = <0x67>;
+    };
+
+    dsi@7e700000 {
+      compatible = "brcm,bcm2835-dsi1";
+      reg = <0x7e700000 0x8c>;
+      interrupts = <0x2 0xc>;
+      #address-cells = <0x1>;
+      #size-cells = <0x0>;
+      #clock-cells = <0x1>;
+      clocks = <0x8 0x23 0x8 0x30 0x8 0x32>;
+      clock-names = "phy", "escape", "pixel";
+      clock-output-names = "dsi1_byte", "dsi1_ddr2", "dsi1_ddr";
+      status = "disabled";
+      phandle = <0x6>;
+    };
+
+    csi0@7e800000 {
+      compatible = "brcm,bcm2835-unicam";
+      reg = <0x7e800000 0x800 0x7e802000 0x4>;
+      interrupts = <0x2 0x6>;
+      clocks = <0x8 0x2d>;
+      clock-names = "lp";
+      #address-cells = <0x1>;
+      #size-cells = <0x0>;
+      #clock-cells = <0x1>;
+      status = "disabled";
+      power-domains = <0x14 0xc>;
+      phandle = <0x68>;
+    };
+
+    csi1@7e801000 {
+      compatible = "brcm,bcm2835-unicam";
+      reg = <0x7e801000 0x800 0x7e802004 0x4>;
+      interrupts = <0x2 0x7>;
+      clocks = <0x8 0x2e>;
+      clock-names = "lp";
+      #address-cells = <0x1>;
+      #size-cells = <0x0>;
+      #clock-cells = <0x1>;
+      status = "disabled";
+      power-domains = <0x14 0xd>;
+      phandle = <0x69>;
+
+      port {
+
+        endpoint {
+          data-lanes = <0x1 0x2>;
+        };
+      };
+    };
+
+    i2c@7e804000 {
+      compatible = "brcm,bcm2835-i2c";
+      reg = <0x7e804000 0x1000>;
+      interrupts = <0x2 0x15>;
+      clocks = <0x8 0x14>;
+      #address-cells = <0x1>;
+      #size-cells = <0x0>;
+      status = "disabled";
+      pinctrl-names = "default";
+      pinctrl-0 = <0x15>;
+      clock-frequency = <0x186a0>;
+      phandle = <0x22>;
+    };
+
+    i2c@7e805000 {
+      compatible = "brcm,bcm2835-i2c";
+      reg = <0x7e805000 0x1000>;
+      interrupts = <0x2 0x15>;
+      clocks = <0x8 0x14>;
+      #address-cells = <0x1>;
+      #size-cells = <0x0>;
+      status = "disabled";
+      clock-frequency = <0x186a0>;
+      phandle = <0x16>;
+    };
+
+    vec@7e806000 {
+      compatible = "brcm,bcm2835-vec";
+      reg = <0x7e806000 0x1000>;
+      clocks = <0x8 0x18>;
+      interrupts = <0x2 0x1b>;
+      status = "disabled";
+      phandle = <0x6a>;
+    };
+
+    pixelvalve@7e807000 {
+      compatible = "brcm,bcm2835-pixelvalve2";
+      reg = <0x7e807000 0x100>;
+      interrupts = <0x2 0xa>;
+      status = "disabled";
+      phandle = <0x6b>;
+    };
+
+    hdmi@7e902000 {
+      compatible = "brcm,bcm2835-hdmi";
+      reg = <0x7e902000 0x600 0x7e808000 0x100>;
+      interrupts = <0x2 0x8 0x2 0x9>;
+      ddc = <0x16>;
+      clocks = <0x8 0x10 0x8 0x19>;
+      clock-names = "pixel", "hdmi";
+      dmas = <0xb 0x11>;
+      dma-names = "audio-rx";
+      status = "disabled";
+      power-domains = <0x14 0x5>;
+      hpd-gpios = <0x10 0x1c 0x1>;
+      phandle = <0x6c>;
+    };
+
+    usb@7e980000 {
+      compatible = "brcm,bcm2835-usb";
+      reg = <0x7e980000 0x10000 0x7e006000 0x1000>;
+      interrupts = <0x1 0x9>;
+      #address-cells = <0x1>;
+      #size-cells = <0x0>;
+      clocks = <0x17>;
+      clock-names = "otg";
+      phys = <0x18>;
+      phy-names = "usb2-phy";
+      power-domains = <0x14 0x6>;
+      phandle = <0x6d>;
+
+      usb1@1 {
+        compatible = "usb424,2514";
+        reg = <0x1>;
+        #address-cells = <0x1>;
+        #size-cells = <0x0>;
+
+        usb1_1@1 {
+          compatible = "usb424,2514";
+          reg = <0x1>;
+          #address-cells = <0x1>;
+          #size-cells = <0x0>;
+
+          usbether@1 {
+            compatible = "usb424,7800";
+            reg = <0x1>;
+            microchip,eee-enabled;
+            microchip,tx-lpi-timer = <0x258>;
+            microchip,led-modes = <0x1 0x6>;
+            phandle = <0x2d>;
+          };
+        };
+      };
+    };
+
+    v3d@7ec00000 {
+      compatible = "brcm,vc4-v3d";
+      reg = <0x7ec00000 0x1000>;
+      interrupts = <0x1 0xa>;
+      power-domains = <0x14 0xa>;
+      status = "disabled";
+      phandle = <0x6e>;
+    };
+
+    gpu {
+      compatible = "brcm,bcm2835-vc4";
+      status = "disabled";
+      phandle = <0x6f>;
+    };
+
+    local_intc@40000000 {
+      compatible = "brcm,bcm2836-l1-intc";
+      reg = <0x40000000 0x100>;
+      interrupt-controller;
+      #interrupt-cells = <0x1>;
+      interrupt-parent = <0x3>;
+      phandle = <0x3>;
+    };
+
+    mmc@7e300000 {
+      compatible = "brcm,bcm2835-mmc", "brcm,bcm2835-sdhci";
+      reg = <0x7e300000 0x100>;
+      interrupts = <0x2 0x1e>;
+      clocks = <0x8 0x1c>;
+      dmas = <0xb 0xb>;
+      dma-names = "rx-tx";
+      brcm,overclock-50 = <0x0>;
+      status = "okay";
+      pinctrl-names = "default";
+      pinctrl-0 = <0x19>;
+      non-removable;
+      bus-width = <0x4>;
+      phandle = <0x27>;
+    };
+
+    firmwarekms@7e600000 {
+      compatible = "raspberrypi,rpi-firmware-kms";
+      reg = <0x7e600000 0x100>;
+      interrupts = <0x2 0x10>;
+      brcm,firmware = <0x7>;
+      status = "disabled";
+      phandle = <0x70>;
+    };
+
+    smi@7e600000 {
+      compatible = "brcm,bcm2835-smi";
+      reg = <0x7e600000 0x100>;
+      interrupts = <0x2 0x10>;
+      clocks = <0x8 0x2a>;
+      assigned-clocks = <0x8 0x2a>;
+      assigned-clock-rates = <0x7735940>;
+      dmas = <0xb 0x4>;
+      dma-names = "rx-tx";
+      status = "disabled";
+      phandle = <0x71>;
+    };
+
+    axiperf {
+      compatible = "brcm,bcm2835-axiperf";
+      reg = <0x7e009800 0x100 0x7ee08000 0x100>;
+      firmware = <0x7>;
+      status = "disabled";
+      phandle = <0x28>;
+    };
+
+    gpiomem {
+      compatible = "brcm,bcm2835-gpiomem";
+      reg = <0x7e200000 0x1000>;
+    };
+
+    firmware {
+      compatible = "raspberrypi,bcm2835-firmware";
+      mboxes = <0x1a>;
+      phandle = <0x7>;
+    };
+
+    power {
+      compatible = "raspberrypi,bcm2835-power";
+      firmware = <0x7>;
+      #power-domain-cells = <0x1>;
+      phandle = <0x14>;
+    };
+
+    fb {
+      compatible = "brcm,bcm2708-fb";
+      firmware = <0x7>;
+      status = "okay";
+      phandle = <0x72>;
+    };
+
+    vchiq {
+      compatible = "brcm,bcm2835-vchiq";
+      reg = <0x7e00b840 0xf>;
+      interrupts = <0x0 0x2>;
+      cache-line-size = <0x20>;
+      firmware = <0x7>;
+      phandle = <0x1c>;
+    };
+
+    vcsm {
+      compatible = "raspberrypi,bcm2835-vcsm";
+      firmware = <0x7>;
+      status = "okay";
+      phandle = <0x73>;
+    };
+
+    audio {
+      compatible = "brcm,bcm2835-audio";
+      brcm,pwm-channels = <0x8>;
+      status = "disabled";
+      pinctrl-names = "default";
+      pinctrl-0 = <0x1b>;
+      phandle = <0x23>;
+    };
+
+    sound {
+      status = "disabled";
+      phandle = <0x74>;
+    };
+
+    arm-pmu {
+      compatible = "arm,cortex-a7-pmu";
+      interrupt-parent = <0x3>;
+      interrupts = <0x9>;
+    };
+
+    expgpio {
+      compatible = "brcm,bcm2835-expgpio";
+      gpio-controller;
+      #gpio-cells = <0x2>;
+      firmware = <0x7>;
+      status = "okay";
+      phandle = <0x30>;
+    };
+  };
+
+  clocks {
+    compatible = "simple-bus";
+    #address-cells = <0x1>;
+    #size-cells = <0x0>;
+
+    clock@3 {
+      compatible = "fixed-clock";
+      reg = <0x3>;
+      #clock-cells = <0x0>;
+      clock-output-names = "osc";
+      clock-frequency = <0x124f800>;
+      phandle = <0x4>;
+    };
+
+    clock@4 {
+      compatible = "fixed-clock";
+      reg = <0x4>;
+      #clock-cells = <0x0>;
+      clock-output-names = "otg";
+      clock-frequency = <0x1c9c3800>;
+      phandle = <0x17>;
+    };
+  };
+
+  phy {
+    compatible = "usb-nop-xceiv";
+    #phy-cells = <0x0>;
+    phandle = <0x18>;
+  };
+
+  timer {
+    compatible = "arm,armv7-timer";
+    interrupt-parent = <0x3>;
+    interrupts = <0x0 0x1 0x3 0x2>;
+    always-on;
+  };
+
+  psci {
+    compatible = "arm,psci-1.0";
+    method = "smc";
+  };
+
+  cpus {
+    #address-cells = <0x1>;
+    #size-cells = <0x0>;
+    enable-method = "brcm,bcm2836-smp";
+    phandle = <0x75>;
+
+    cpu@0 {
+      device_type = "cpu";
+      compatible = "arm,cortex-a53";
+      reg = <0x0>;
+      enable-method = "psci";
+      cpu-release-addr = <0x0 0xd8>;
+      phandle = <0x29>;
+    };
+
+    cpu@1 {
+      device_type = "cpu";
+      compatible = "arm,cortex-a53";
+      reg = <0x1>;
+      enable-method = "psci";
+      cpu-release-addr = <0x0 0xe0>;
+      phandle = <0x2a>;
+    };
+
+    cpu@2 {
+      device_type = "cpu";
+      compatible = "arm,cortex-a53";
+      reg = <0x2>;
+      enable-method = "psci";
+      cpu-release-addr = <0x0 0xe8>;
+      phandle = <0x2b>;
+    };
+
+    cpu@3 {
+      device_type = "cpu";
+      compatible = "arm,cortex-a53";
+      reg = <0x3>;
+      enable-method = "psci";
+      cpu-release-addr = <0x0 0xf0>;
+      phandle = <0x2c>;
+    };
+  };
+
+  fixedregulator_5v0 {
+    compatible = "regulator-fixed";
+    regulator-name = "5v0";
+    regulator-min-microvolt = <0x4c4b40>;
+    regulator-max-microvolt = <0x4c4b40>;
+    regulator-always-on;
+    phandle = <0x76>;
+  };
+
+  fixedregulator_3v3 {
+    compatible = "regulator-fixed";
+    regulator-name = "3v3";
+    regulator-min-microvolt = <0x325aa0>;
+    regulator-max-microvolt = <0x325aa0>;
+    regulator-always-on;
+    phandle = <0x77>;
+  };
+
+  __overrides__ {
+    cam0-pwdn-ctrl;
+    cam0-pwdn;
+    cam0-led-ctrl;
+    cam0-led;
+    cache_line_size = [00 00 00 1c 63 61 63 68 65 2d 6c 69 6e 65 2d 73 69 7a 65 3a 30 00];
+    uart0 = [00 00 00 1d 73 74 61 74 75 73 00];
+    uart1 = [00 00 00 1e 73 74 61 74 75 73 00];
+    i2s = [00 00 00 1f 73 74 61 74 75 73 00];
+    spi = "", "", "", " status";
+    i2c0 = "", "", "", "!status";
+    i2c1 = "", "", "", "\"status";
+    i2c2_iknowwhatimdoing = [00 00 00 16 73 74 61 74 75 73 00];
+    i2c0_baudrate = "", "", "", "!clock-frequency:0";
+    i2c1_baudrate = "", "", "", "\"clock-frequency:0";
+    i2c2_baudrate = [00 00 00 16 63 6c 6f 63 6b 2d 66 72 65 71 75 65 6e 63 79 3a 30 00];
+    audio = "", "", "", "#status";
+    watchdog = "", "", "", "$status";
+    random = "", "", "", "%status";
+    sd_overclock = "", "", "", "&brcm,overclock-50:0";
+    sd_force_pio = "", "", "", "&brcm,force-pio?";
+    sd_pio_limit = "", "", "", "&brcm,pio-limit:0";
+    sd_debug = "", "", "", "&brcm,debug";
+    sdio_overclock = "", "", "", "'brcm,overclock-50:0";
+    axiperf = "", "", "", "(status";
+    arm_freq = "", "", "", ")clock-frequency:0", "", "", "", "*clock-frequency:0", "", "", "", "+clock-frequency:0", "", "", "", ",clock-frequency:0";
+    eee = "", "", "", "-microchip,eee-enabled?";
+    tx_lpi_timer = "", "", "", "-microchip,tx-lpi-timer:0";
+    eth_led0 = "", "", "", "-microchip,led-modes:0";
+    eth_led1 = "", "", "", "-microchip,led-modes:4";
+    act_led_gpio = "", "", "", ".gpios:4";
+    act_led_activelow = "", "", "", ".gpios:8";
+    act_led_trigger = "", "", "", ".linux,default-trigger";
+    pwr_led_gpio = "", "", "", "/gpios:4";
+    pwr_led_activelow = "", "", "", "/gpios:8";
+    pwr_led_trigger = "", "", "", "/linux,default-trigger";
+  };
+
+  memory {
+    device_type = "memory";
+    reg = <0x0 0x0>;
+  };
+
+  leds {
+    compatible = "gpio-leds";
+    phandle = <0x78>;
+
+    act {
+      label = "led0";
+      linux,default-trigger = "mmc0";
+      gpios = <0x10 0x1d 0x0>;
+      phandle = <0x2e>;
+    };
+
+    pwr {
+      label = "led1";
+      linux,default-trigger = "default-on";
+      gpios = <0x30 0x2 0x1>;
+      phandle = <0x2f>;
+    };
+  };
+
+  __symbols__ {
+    cpu_thermal = "/thermal-zones/cpu-thermal";
+    soc = "/soc";
+    dma = "/soc/dma@7e007000";
+    intc = "/soc/interrupt-controller@7e00b200";
+    watchdog = "/soc/watchdog@7e100000";
+    clocks = "/soc/cprman@7e101000";
+    random = "/soc/rng@7e104000";
+    mailbox = "/soc/mailbox@7e00b880";
+    gpio = "/soc/gpio@7e200000";
+    dpi_gpio0 = "/soc/gpio@7e200000/dpi_gpio0";
+    emmc_gpio22 = "/soc/gpio@7e200000/emmc_gpio22";
+    emmc_gpio34 = "/soc/gpio@7e200000/emmc_gpio34";
+    emmc_gpio48 = "/soc/gpio@7e200000/emmc_gpio48";
+    gpclk0_gpio4 = "/soc/gpio@7e200000/gpclk0_gpio4";
+    gpclk1_gpio5 = "/soc/gpio@7e200000/gpclk1_gpio5";
+    gpclk1_gpio42 = "/soc/gpio@7e200000/gpclk1_gpio42";
+    gpclk1_gpio44 = "/soc/gpio@7e200000/gpclk1_gpio44";
+    gpclk2_gpio6 = "/soc/gpio@7e200000/gpclk2_gpio6";
+    gpclk2_gpio43 = "/soc/gpio@7e200000/gpclk2_gpio43";
+    i2c0_gpio0 = "/soc/gpio@7e200000/i2c0_gpio0";
+    i2c0_gpio28 = "/soc/gpio@7e200000/i2c0_gpio28";
+    i2c0_gpio44 = "/soc/gpio@7e200000/i2c0_gpio44";
+    i2c1_gpio2 = "/soc/gpio@7e200000/i2c1_gpio2";
+    i2c1_gpio44 = "/soc/gpio@7e200000/i2c1_gpio44";
+    i2c_slave_gpio18 = "/soc/gpio@7e200000/i2c_slave_gpio18";
+    jtag_gpio4 = "/soc/gpio@7e200000/jtag_gpio4";
+    jtag_gpio22 = "/soc/gpio@7e200000/jtag_gpio22";
+    pcm_gpio18 = "/soc/gpio@7e200000/pcm_gpio18";
+    pcm_gpio28 = "/soc/gpio@7e200000/pcm_gpio28";
+    pwm0_gpio12 = "/soc/gpio@7e200000/pwm0_gpio12";
+    pwm0_gpio18 = "/soc/gpio@7e200000/pwm0_gpio18";
+    pwm0_gpio40 = "/soc/gpio@7e200000/pwm0_gpio40";
+    pwm1_gpio13 = "/soc/gpio@7e200000/pwm1_gpio13";
+    pwm1_gpio19 = "/soc/gpio@7e200000/pwm1_gpio19";
+    pwm1_gpio41 = "/soc/gpio@7e200000/pwm1_gpio41";
+    pwm1_gpio45 = "/soc/gpio@7e200000/pwm1_gpio45";
+    sdhost_pins = "/soc/gpio@7e200000/sdhost_gpio48";
+    sdhost_gpio48 = "/soc/gpio@7e200000/sdhost_gpio48";
+    spi0_gpio7 = "/soc/gpio@7e200000/spi0_gpio7";
+    spi0_gpio35 = "/soc/gpio@7e200000/spi0_gpio35";
+    spi1_gpio16 = "/soc/gpio@7e200000/spi1_gpio16";
+    spi2_gpio40 = "/soc/gpio@7e200000/spi2_gpio40";
+    uart0_gpio14 = "/soc/gpio@7e200000/uart0_gpio14";
+    uart0_ctsrts_gpio16 = "/soc/gpio@7e200000/uart0_ctsrts_gpio16";
+    uart0_ctsrts_gpio30 = "/soc/gpio@7e200000/uart0_ctsrts_gpio30";
+    uart0_gpio32 = "/soc/gpio@7e200000/uart0_gpio32";
+    uart0_gpio36 = "/soc/gpio@7e200000/uart0_gpio36";
+    uart0_ctsrts_gpio38 = "/soc/gpio@7e200000/uart0_ctsrts_gpio38";
+    uart1_gpio14 = "/soc/gpio@7e200000/uart1_gpio14";
+    uart1_ctsrts_gpio16 = "/soc/gpio@7e200000/uart1_ctsrts_gpio16";
+    uart1_gpio32 = "/soc/gpio@7e200000/uart1_gpio32";
+    uart1_ctsrts_gpio30 = "/soc/gpio@7e200000/uart1_ctsrts_gpio30";
+    uart1_gpio40 = "/soc/gpio@7e200000/uart1_gpio40";
+    uart1_ctsrts_gpio42 = "/soc/gpio@7e200000/uart1_ctsrts_gpio42";
+    dpi_18bit_gpio0 = "/soc/gpio@7e200000/dpi_18bit_gpio0";
+    spi0_pins = "/soc/gpio@7e200000/spi0_pins";
+    spi0_cs_pins = "/soc/gpio@7e200000/spi0_cs_pins";
+    i2c0_pins = "/soc/gpio@7e200000/i2c0";
+    i2c1_pins = "/soc/gpio@7e200000/i2c1";
+    i2s_pins = "/soc/gpio@7e200000/i2s";
+    sdio_pins = "/soc/gpio@7e200000/sdio_pins";
+    bt_pins = "/soc/gpio@7e200000/bt_pins";
+    uart0_pins = "/soc/gpio@7e200000/uart0_pins";
+    uart1_pins = "/soc/gpio@7e200000/uart1_pins";
+    audio_pins = "/soc/gpio@7e200000/audio_pins";
+    uart0 = "/soc/serial@7e201000";
+    sdhost = "/soc/mmc@7e202000";
+    i2s = "/soc/i2s@7e203000";
+    spi0 = "/soc/spi@7e204000";
+    spi = "/soc/spi@7e204000";
+    spidev0 = "/soc/spi@7e204000/spidev@0";
+    spidev1 = "/soc/spi@7e204000/spidev@1";
+    i2c0 = "/soc/i2c@7e205000";
+    pixelvalve0 = "/soc/pixelvalve@7e206000";
+    pixelvalve1 = "/soc/pixelvalve@7e207000";
+    dpi = "/soc/dpi@7e208000";
+    dsi0 = "/soc/dsi@7e209000";
+    thermal = "/soc/thermal@7e212000";
+    aux = "/soc/aux@0x7e215000";
+    uart1 = "/soc/serial@7e215040";
+    spi1 = "/soc/spi@7e215080";
+    spi2 = "/soc/spi@7e2150c0";
+    pwm = "/soc/pwm@7e20c000";
+    hvs = "/soc/hvs@7e400000";
+    dsi1 = "/soc/dsi@7e700000";
+    csi0 = "/soc/csi0@7e800000";
+    csi1 = "/soc/csi1@7e801000";
+    i2c1 = "/soc/i2c@7e804000";
+    i2c2 = "/soc/i2c@7e805000";
+    vec = "/soc/vec@7e806000";
+    pixelvalve2 = "/soc/pixelvalve@7e807000";
+    hdmi = "/soc/hdmi@7e902000";
+    usb = "/soc/usb@7e980000";
+    ethernet = "/soc/usb@7e980000/usb1@1/usb1_1@1/usbether@1";
+    v3d = "/soc/v3d@7ec00000";
+    vc4 = "/soc/gpu";
+    local_intc = "/soc/local_intc@40000000";
+    mmc = "/soc/mmc@7e300000";
+    firmwarekms = "/soc/firmwarekms@7e600000";
+    smi = "/soc/smi@7e600000";
+    axiperf = "/soc/axiperf";
+    firmware = "/soc/firmware";
+    power = "/soc/power";
+    fb = "/soc/fb";
+    vchiq = "/soc/vchiq";
+    vcsm = "/soc/vcsm";
+    audio = "/soc/audio";
+    sound = "/soc/sound";
+    expgpio = "/soc/expgpio";
+    clk_osc = "/clocks/clock@3";
+    clk_usb = "/clocks/clock@4";
+    usbphy = "/phy";
+    cpus = "/cpus";
+    cpu0 = "/cpus/cpu@0";
+    cpu1 = "/cpus/cpu@1";
+    cpu2 = "/cpus/cpu@2";
+    cpu3 = "/cpus/cpu@3";
+    vdd_5v0_reg = "/fixedregulator_5v0";
+    vdd_3v3_reg = "/fixedregulator_3v3";
+    leds = "/leds";
+    act_led = "/leds/act";
+    pwr_led = "/leds/pwr";
+  };
+};
diff --git a/Platform/RaspberryPi/RPi3/DeviceTree/bcm2710-rpi-3-b.dtb b/Platform/RaspberryPi/RPi3/DeviceTree/bcm2710-rpi-3-b.dtb
new file mode 100644
index 0000000000000000000000000000000000000000..14c78a9eead443adefd229f81ad0ace70c8e0ec7
GIT binary patch
literal 25354
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

literal 0
HcmV?d00001

diff --git a/Platform/RaspberryPi/RPi3/DeviceTree/bcm2710-rpi-3-b.dts b/Platform/RaspberryPi/RPi3/DeviceTree/bcm2710-rpi-3-b.dts
new file mode 100644
index 000000000000..887eb09692b6
--- /dev/null
+++ b/Platform/RaspberryPi/RPi3/DeviceTree/bcm2710-rpi-3-b.dts
@@ -0,0 +1,1259 @@
+/dts-v1/;
+
+/*
+ * Raspberry Pi 3 Model B DTS (Device Tree Source), for UEFI firmware.
+ *
+ * This source is the mostly identical to the decompiled version of the
+ * official DTB (Device Tree Binary), as found at:
+ *   https://github.com/raspberrypi/firmware/tree/master/boot
+ *
+ * Only the following changes were applied:
+ * - Two fixes for USB keyboard support under the usb@7e980000 section:
+ *   compatible = "brcm,bcm2708-usb"; -> compatible = "brcm,bcm2835-usb";
+ *   interrupts = <0x2 0x0 0x1 0x9>;  -> interrupts = <0x1 0x9>;
+ * - A 'psci' section was added, as it is provided by the ATF
+ * - The 'enable-method' for CPUs was swicthed to "psci" instead of "spin-table"
+ */
+
+/memreserve/  0x0000000000000000 0x0000000000001000;
+/ {
+  compatible = "raspberrypi,3-model-b", "brcm,bcm2837";
+  model = "Raspberry Pi 3 Model B";
+  interrupt-parent = <0x1>;
+  #address-cells = <0x1>;
+  #size-cells = <0x1>;
+
+  aliases {
+    serial0 = "/soc/serial@7e215040";
+    serial1 = "/soc/serial@7e201000";
+    audio = "/soc/audio";
+    aux = "/soc/aux@0x7e215000";
+    sound = "/soc/sound";
+    soc = "/soc";
+    dma = "/soc/dma@7e007000";
+    intc = "/soc/interrupt-controller@7e00b200";
+    watchdog = "/soc/watchdog@7e100000";
+    random = "/soc/rng@7e104000";
+    mailbox = "/soc/mailbox@7e00b880";
+    gpio = "/soc/gpio@7e200000";
+    uart0 = "/soc/serial@7e201000";
+    sdhost = "/soc/mmc@7e202000";
+    mmc0 = "/soc/mmc@7e202000";
+    i2s = "/soc/i2s@7e203000";
+    spi0 = "/soc/spi@7e204000";
+    i2c0 = "/soc/i2c@7e205000";
+    uart1 = "/soc/serial@7e215040";
+    spi1 = "/soc/spi@7e215080";
+    spi2 = "/soc/spi@7e2150c0";
+    mmc = "/soc/mmc@7e300000";
+    mmc1 = "/soc/mmc@7e300000";
+    i2c1 = "/soc/i2c@7e804000";
+    i2c2 = "/soc/i2c@7e805000";
+    usb = "/soc/usb@7e980000";
+    leds = "/leds";
+    fb = "/soc/fb";
+    vchiq = "/soc/vchiq";
+    thermal = "/soc/thermal@7e212000";
+    axiperf = "/soc/axiperf";
+    ethernet0 = "/soc/usb@7e980000/usb1@1/usbether@1";
+  };
+
+  chosen {
+    bootargs = "8250.nr_uarts=1";
+  };
+
+  thermal-zones {
+
+    cpu-thermal {
+      polling-delay-passive = <0x0>;
+      polling-delay = <0x3e8>;
+      thermal-sensors = <0x2>;
+      coefficients = <0xfffffde6 0x64960>;
+      phandle = <0x31>;
+
+      cooling-maps {
+      };
+    };
+  };
+
+  soc {
+    compatible = "simple-bus";
+    #address-cells = <0x1>;
+    #size-cells = <0x1>;
+    ranges = <0x7e000000 0x3f000000 0x1000000 0x40000000 0x40000000 0x1000>;
+    dma-ranges = <0xc0000000 0x0 0x3f000000>;
+    phandle = <0x32>;
+
+    dma@7e007000 {
+      compatible = "brcm,bcm2835-dma";
+      reg = <0x7e007000 0xf00>;
+      interrupts = <0x1 0x10 0x1 0x11 0x1 0x12 0x1 0x13 0x1 0x14 0x1 0x15 0x1 0x16 0x1 0x17 0x1 0x18 0x1 0x19 0x1 0x1a 0x1 0x1b 0x1 0x1b 0x1 0x1b 0x1 0x1b 0x1 0x1c>;
+      interrupt-names = "dma0", "dma1", "dma2", "dma3", "dma4", "dma5", "dma6", "dma7", "dma8", "dma9", "dma10", "dma11", "dma12", "dma13", "dma14", "dma-shared-all";
+      #dma-cells = <0x1>;
+      brcm,dma-channel-mask = <0x7f34>;
+      phandle = <0xb>;
+    };
+
+    interrupt-controller@7e00b200 {
+      compatible = "brcm,bcm2836-armctrl-ic";
+      reg = <0x7e00b200 0x200>;
+      interrupt-controller;
+      #interrupt-cells = <0x2>;
+      interrupt-parent = <0x3>;
+      interrupts = <0x8>;
+      phandle = <0x1>;
+    };
+
+    watchdog@7e100000 {
+      compatible = "brcm,bcm2835-pm-wdt";
+      reg = <0x7e100000 0x28>;
+      phandle = <0x25>;
+    };
+
+    cprman@7e101000 {
+      compatible = "brcm,bcm2835-cprman";
+      #clock-cells = <0x1>;
+      reg = <0x7e101000 0x2000>;
+      clocks = <0x4 0x5 0x0 0x5 0x1 0x5 0x2 0x6 0x0 0x6 0x1 0x6 0x2>;
+      firmware = <0x7>;
+      phandle = <0x8>;
+    };
+
+    rng@7e104000 {
+      compatible = "brcm,bcm2835-rng";
+      reg = <0x7e104000 0x10>;
+      interrupts = <0x2 0x1d>;
+      phandle = <0x26>;
+    };
+
+    mailbox@7e00b880 {
+      compatible = "brcm,bcm2835-mbox";
+      reg = <0x7e00b880 0x40>;
+      interrupts = <0x0 0x1>;
+      #mbox-cells = <0x0>;
+      phandle = <0x1b>;
+    };
+
+    gpio@7e200000 {
+      compatible = "brcm,bcm2835-gpio";
+      reg = <0x7e200000 0xb4>;
+      interrupts = <0x2 0x11 0x2 0x12>;
+      gpio-controller;
+      #gpio-cells = <0x2>;
+      interrupt-controller;
+      #interrupt-cells = <0x2>;
+      phandle = <0x10>;
+
+      dpi_gpio0 {
+        brcm,pins = <0x0 0x1 0x2 0x3 0x4 0x5 0x6 0x7 0x8 0x9 0xa 0xb 0xc 0xd 0xe 0xf 0x10 0x11 0x12 0x13 0x14 0x15 0x16 0x17 0x18 0x19 0x1a 0x1b>;
+        brcm,function = <0x6>;
+        phandle = <0x33>;
+      };
+
+      emmc_gpio22 {
+        brcm,pins = <0x16 0x17 0x18 0x19 0x1a 0x1b>;
+        brcm,function = <0x7>;
+        phandle = <0x34>;
+      };
+
+      emmc_gpio34 {
+        brcm,pins = <0x22 0x23 0x24 0x25 0x26 0x27>;
+        brcm,function = <0x7>;
+        brcm,pull = <0x0 0x2 0x2 0x2 0x2 0x2>;
+        phandle = <0x35>;
+      };
+
+      emmc_gpio48 {
+        brcm,pins = <0x30 0x31 0x32 0x33 0x34 0x35>;
+        brcm,function = <0x7>;
+        phandle = <0x36>;
+      };
+
+      gpclk0_gpio4 {
+        brcm,pins = <0x4>;
+        brcm,function = <0x4>;
+        phandle = <0x37>;
+      };
+
+      gpclk1_gpio5 {
+        brcm,pins = <0x5>;
+        brcm,function = <0x4>;
+        phandle = <0x38>;
+      };
+
+      gpclk1_gpio42 {
+        brcm,pins = <0x2a>;
+        brcm,function = <0x4>;
+        phandle = <0x39>;
+      };
+
+      gpclk1_gpio44 {
+        brcm,pins = <0x2c>;
+        brcm,function = <0x4>;
+        phandle = <0x3a>;
+      };
+
+      gpclk2_gpio6 {
+        brcm,pins = <0x6>;
+        brcm,function = <0x4>;
+        phandle = <0x3b>;
+      };
+
+      gpclk2_gpio43 {
+        brcm,pins = <0x2b>;
+        brcm,function = <0x4>;
+        phandle = <0x3c>;
+      };
+
+      i2c0_gpio0 {
+        brcm,pins = <0x0 0x1>;
+        brcm,function = <0x4>;
+        phandle = <0x3d>;
+      };
+
+      i2c0_gpio28 {
+        brcm,pins = <0x1c 0x1d>;
+        brcm,function = <0x4>;
+        phandle = <0x3e>;
+      };
+
+      i2c0_gpio44 {
+        brcm,pins = <0x2c 0x2d>;
+        brcm,function = <0x5>;
+        phandle = <0x3f>;
+      };
+
+      i2c1_gpio2 {
+        brcm,pins = <0x2 0x3>;
+        brcm,function = <0x4>;
+        phandle = <0x40>;
+      };
+
+      i2c1_gpio44 {
+        brcm,pins = <0x2c 0x2d>;
+        brcm,function = <0x6>;
+        phandle = <0x41>;
+      };
+
+      i2c_slave_gpio18 {
+        brcm,pins = <0x12 0x13 0x14 0x15>;
+        brcm,function = <0x7>;
+        phandle = <0x42>;
+      };
+
+      jtag_gpio4 {
+        brcm,pins = <0x4 0x5 0x6 0xc 0xd>;
+        brcm,function = <0x2>;
+        phandle = <0x43>;
+      };
+
+      jtag_gpio22 {
+        brcm,pins = <0x16 0x17 0x18 0x19 0x1a 0x1b>;
+        brcm,function = <0x3>;
+        phandle = <0x44>;
+      };
+
+      pcm_gpio18 {
+        brcm,pins = <0x12 0x13 0x14 0x15>;
+        brcm,function = <0x4>;
+        phandle = <0x45>;
+      };
+
+      pcm_gpio28 {
+        brcm,pins = <0x1c 0x1d 0x1e 0x1f>;
+        brcm,function = <0x6>;
+        phandle = <0x46>;
+      };
+
+      pwm0_gpio12 {
+        brcm,pins = <0xc>;
+        brcm,function = <0x4>;
+        phandle = <0x47>;
+      };
+
+      pwm0_gpio18 {
+        brcm,pins = <0x12>;
+        brcm,function = <0x2>;
+        phandle = <0x48>;
+      };
+
+      pwm0_gpio40 {
+        brcm,pins = <0x28>;
+        brcm,function = <0x4>;
+        phandle = <0x49>;
+      };
+
+      pwm1_gpio13 {
+        brcm,pins = <0xd>;
+        brcm,function = <0x4>;
+        phandle = <0x4a>;
+      };
+
+      pwm1_gpio19 {
+        brcm,pins = <0x13>;
+        brcm,function = <0x2>;
+        phandle = <0x4b>;
+      };
+
+      pwm1_gpio41 {
+        brcm,pins = <0x29>;
+        brcm,function = <0x4>;
+        phandle = <0x4c>;
+      };
+
+      pwm1_gpio45 {
+        brcm,pins = <0x2d>;
+        brcm,function = <0x4>;
+        phandle = <0x4d>;
+      };
+
+      sdhost_gpio48 {
+        brcm,pins = <0x30 0x31 0x32 0x33 0x34 0x35>;
+        brcm,function = <0x4>;
+        phandle = <0xc>;
+      };
+
+      spi0_gpio7 {
+        brcm,pins = <0x7 0x8 0x9 0xa 0xb>;
+        brcm,function = <0x4>;
+        phandle = <0x4e>;
+      };
+
+      spi0_gpio35 {
+        brcm,pins = <0x23 0x24 0x25 0x26 0x27>;
+        brcm,function = <0x4>;
+        phandle = <0x4f>;
+      };
+
+      spi1_gpio16 {
+        brcm,pins = <0x10 0x11 0x12 0x13 0x14 0x15>;
+        brcm,function = <0x3>;
+        phandle = <0x50>;
+      };
+
+      spi2_gpio40 {
+        brcm,pins = <0x28 0x29 0x2a 0x2b 0x2c 0x2d>;
+        brcm,function = <0x3>;
+        phandle = <0x51>;
+      };
+
+      uart0_gpio14 {
+        brcm,pins = <0xe 0xf>;
+        brcm,function = <0x4>;
+        phandle = <0x52>;
+      };
+
+      uart0_ctsrts_gpio16 {
+        brcm,pins = <0x10 0x11>;
+        brcm,function = <0x7>;
+        phandle = <0x53>;
+      };
+
+      uart0_ctsrts_gpio30 {
+        brcm,pins = <0x1e 0x1f>;
+        brcm,function = <0x7>;
+        phandle = <0x54>;
+      };
+
+      uart0_gpio32 {
+        brcm,pins = <0x20 0x21>;
+        brcm,function = <0x7>;
+        phandle = <0x55>;
+      };
+
+      uart0_gpio36 {
+        brcm,pins = <0x24 0x25>;
+        brcm,function = <0x6>;
+        phandle = <0x56>;
+      };
+
+      uart0_ctsrts_gpio38 {
+        brcm,pins = <0x26 0x27>;
+        brcm,function = <0x6>;
+        phandle = <0x57>;
+      };
+
+      uart1_gpio14 {
+        brcm,pins = <0xe 0xf>;
+        brcm,function = <0x2>;
+        phandle = <0x58>;
+      };
+
+      uart1_ctsrts_gpio16 {
+        brcm,pins = <0x10 0x11>;
+        brcm,function = <0x2>;
+        phandle = <0x59>;
+      };
+
+      uart1_gpio32 {
+        brcm,pins = <0x20 0x21>;
+        brcm,function = <0x2>;
+        phandle = <0x5a>;
+      };
+
+      uart1_ctsrts_gpio30 {
+        brcm,pins = <0x1e 0x1f>;
+        brcm,function = <0x2>;
+        phandle = <0x5b>;
+      };
+
+      uart1_gpio40 {
+        brcm,pins = <0x28 0x29>;
+        brcm,function = <0x2>;
+        phandle = <0x5c>;
+      };
+
+      uart1_ctsrts_gpio42 {
+        brcm,pins = <0x2a 0x2b>;
+        brcm,function = <0x2>;
+        phandle = <0x5d>;
+      };
+
+      dpi_18bit_gpio0 {
+        brcm,pins = <0x0 0x1 0x2 0x3 0x4 0x5 0x6 0x7 0x8 0x9 0xa 0xb 0xc 0xd 0xe 0xf 0x10 0x11 0x12 0x13 0x14 0x15>;
+        brcm,function = <0x6>;
+        phandle = <0x5e>;
+      };
+
+      spi0_pins {
+        brcm,pins = <0x9 0xa 0xb>;
+        brcm,function = <0x4>;
+        phandle = <0xe>;
+      };
+
+      spi0_cs_pins {
+        brcm,pins = <0x8 0x7>;
+        brcm,function = <0x1>;
+        phandle = <0xf>;
+      };
+
+      i2c0 {
+        brcm,pins = <0x0 0x1>;
+        brcm,function = <0x4>;
+        phandle = <0x11>;
+      };
+
+      i2c1 {
+        brcm,pins = <0x2 0x3>;
+        brcm,function = <0x4>;
+        phandle = <0x15>;
+      };
+
+      i2s {
+        brcm,pins = <0x12 0x13 0x14 0x15>;
+        brcm,function = <0x4>;
+        phandle = <0xd>;
+      };
+
+      sdio_pins {
+        brcm,pins = <0x22 0x23 0x24 0x25 0x26 0x27>;
+        brcm,function = <0x7>;
+        brcm,pull = <0x0 0x2 0x2 0x2 0x2 0x2>;
+        phandle = <0x1a>;
+      };
+
+      bt_pins {
+        brcm,pins = <0x2b>;
+        brcm,function = <0x4>;
+        brcm,pull = <0x0>;
+        phandle = <0xa>;
+      };
+
+      uart0_pins {
+        brcm,pins = <0x20 0x21>;
+        brcm,function = <0x7>;
+        brcm,pull = <0x0 0x2>;
+        phandle = <0x9>;
+      };
+
+      uart1_pins {
+        brcm,pins;
+        brcm,function;
+        brcm,pull;
+        phandle = <0x13>;
+      };
+
+      audio_pins {
+        brcm,pins = <0x28 0x29>;
+        brcm,function = <0x4>;
+        phandle = <0x1c>;
+      };
+    };
+
+    serial@7e201000 {
+      compatible = "brcm,bcm2835-pl011", "arm,pl011", "arm,primecell";
+      reg = <0x7e201000 0x1000>;
+      interrupts = <0x2 0x19>;
+      clocks = <0x8 0x13 0x8 0x14>;
+      clock-names = "uartclk", "apb_pclk";
+      arm,primecell-periphid = <0x241011>;
+      cts-event-workaround;
+      pinctrl-names = "default";
+      pinctrl-0 = <0x9 0xa>;
+      status = "okay";
+      phandle = <0x1e>;
+    };
+
+    mmc@7e202000 {
+      compatible = "brcm,bcm2835-sdhost";
+      reg = <0x7e202000 0x100>;
+      interrupts = <0x2 0x18>;
+      clocks = <0x8 0x14>;
+      dmas = <0xb 0xd>;
+      dma-names = "rx-tx";
+      status = "okay";
+      pinctrl-names = "default";
+      pinctrl-0 = <0xc>;
+      bus-width = <0x4>;
+      brcm,overclock-50 = <0x0>;
+      brcm,pio-limit = <0x1>;
+      phandle = <0x27>;
+    };
+
+    i2s@7e203000 {
+      compatible = "brcm,bcm2835-i2s";
+      reg = <0x7e203000 0x24>;
+      clocks = <0x8 0x1f>;
+      dmas = <0xb 0x2 0xb 0x3>;
+      dma-names = "tx", "rx";
+      status = "disabled";
+      #sound-dai-cells = <0x0>;
+      pinctrl-names = "default";
+      pinctrl-0 = <0xd>;
+      phandle = <0x20>;
+    };
+
+    spi@7e204000 {
+      compatible = "brcm,bcm2835-spi";
+      reg = <0x7e204000 0x1000>;
+      interrupts = <0x2 0x16>;
+      clocks = <0x8 0x14>;
+      #address-cells = <0x1>;
+      #size-cells = <0x0>;
+      status = "disabled";
+      dmas = <0xb 0x6 0xb 0x7>;
+      dma-names = "tx", "rx";
+      pinctrl-names = "default";
+      pinctrl-0 = <0xe 0xf>;
+      cs-gpios = <0x10 0x8 0x1 0x10 0x7 0x1>;
+      phandle = <0x21>;
+
+      spidev@0 {
+        compatible = "spidev";
+        reg = <0x0>;
+        #address-cells = <0x1>;
+        #size-cells = <0x0>;
+        spi-max-frequency = <0x7735940>;
+        phandle = <0x5f>;
+      };
+
+      spidev@1 {
+        compatible = "spidev";
+        reg = <0x1>;
+        #address-cells = <0x1>;
+        #size-cells = <0x0>;
+        spi-max-frequency = <0x7735940>;
+        phandle = <0x60>;
+      };
+    };
+
+    i2c@7e205000 {
+      compatible = "brcm,bcm2835-i2c";
+      reg = <0x7e205000 0x1000>;
+      interrupts = <0x2 0x15>;
+      clocks = <0x8 0x14>;
+      #address-cells = <0x1>;
+      #size-cells = <0x0>;
+      status = "disabled";
+      pinctrl-names = "default";
+      pinctrl-0 = <0x11>;
+      clock-frequency = <0x186a0>;
+      phandle = <0x22>;
+    };
+
+    pixelvalve@7e206000 {
+      compatible = "brcm,bcm2835-pixelvalve0";
+      reg = <0x7e206000 0x100>;
+      interrupts = <0x2 0xd>;
+      status = "disabled";
+      phandle = <0x61>;
+    };
+
+    pixelvalve@7e207000 {
+      compatible = "brcm,bcm2835-pixelvalve1";
+      reg = <0x7e207000 0x100>;
+      interrupts = <0x2 0xe>;
+      status = "disabled";
+      phandle = <0x62>;
+    };
+
+    dpi@7e208000 {
+      compatible = "brcm,bcm2835-dpi";
+      reg = <0x7e208000 0x8c>;
+      clocks = <0x8 0x14 0x8 0x2c>;
+      clock-names = "core", "pixel";
+      #address-cells = <0x1>;
+      #size-cells = <0x0>;
+      status = "disabled";
+      phandle = <0x63>;
+    };
+
+    dsi@7e209000 {
+      compatible = "brcm,bcm2835-dsi0";
+      reg = <0x7e209000 0x78>;
+      interrupts = <0x2 0x4>;
+      #address-cells = <0x1>;
+      #size-cells = <0x0>;
+      #clock-cells = <0x1>;
+      clocks = <0x8 0x20 0x8 0x2f 0x8 0x31>;
+      clock-names = "phy", "escape", "pixel";
+      clock-output-names = "dsi0_byte", "dsi0_ddr2", "dsi0_ddr";
+      phandle = <0x5>;
+    };
+
+    thermal@7e212000 {
+      compatible = "brcm,bcm2837-thermal";
+      reg = <0x7e212000 0x8>;
+      clocks = <0x8 0x1b>;
+      #thermal-sensor-cells = <0x0>;
+      status = "okay";
+      phandle = <0x2>;
+    };
+
+    aux@0x7e215000 {
+      compatible = "brcm,bcm2835-aux";
+      #clock-cells = <0x1>;
+      reg = <0x7e215000 0x8>;
+      clocks = <0x8 0x14>;
+      interrupts = <0x1 0x1d>;
+      interrupt-controller;
+      #interrupt-cells = <0x1>;
+      phandle = <0x12>;
+    };
+
+    serial@7e215040 {
+      compatible = "brcm,bcm2835-aux-uart";
+      reg = <0x7e215040 0x40>;
+      interrupts = <0x0>;
+      clocks = <0x12 0x0>;
+      status = "okay";
+      interrupt-parent = <0x12>;
+      pinctrl-names = "default";
+      pinctrl-0 = <0x13>;
+      phandle = <0x1f>;
+    };
+
+    spi@7e215080 {
+      compatible = "brcm,bcm2835-aux-spi";
+      reg = <0x7e215080 0x40>;
+      interrupts = <0x1>;
+      clocks = <0x12 0x1>;
+      #address-cells = <0x1>;
+      #size-cells = <0x0>;
+      status = "disabled";
+      interrupt-parent = <0x12>;
+      phandle = <0x64>;
+    };
+
+    spi@7e2150c0 {
+      compatible = "brcm,bcm2835-aux-spi";
+      reg = <0x7e2150c0 0x40>;
+      interrupts = <0x2>;
+      clocks = <0x12 0x2>;
+      #address-cells = <0x1>;
+      #size-cells = <0x0>;
+      status = "disabled";
+      interrupt-parent = <0x12>;
+      phandle = <0x65>;
+    };
+
+    pwm@7e20c000 {
+      compatible = "brcm,bcm2835-pwm";
+      reg = <0x7e20c000 0x28>;
+      clocks = <0x8 0x1e>;
+      assigned-clocks = <0x8 0x1e>;
+      assigned-clock-rates = <0x989680>;
+      #pwm-cells = <0x2>;
+      status = "disabled";
+      phandle = <0x66>;
+    };
+
+    hvs@7e400000 {
+      compatible = "brcm,bcm2835-hvs";
+      reg = <0x7e400000 0x6000>;
+      interrupts = <0x2 0x1>;
+      status = "disabled";
+      phandle = <0x67>;
+    };
+
+    dsi@7e700000 {
+      compatible = "brcm,bcm2835-dsi1";
+      reg = <0x7e700000 0x8c>;
+      interrupts = <0x2 0xc>;
+      #address-cells = <0x1>;
+      #size-cells = <0x0>;
+      #clock-cells = <0x1>;
+      clocks = <0x8 0x23 0x8 0x30 0x8 0x32>;
+      clock-names = "phy", "escape", "pixel";
+      clock-output-names = "dsi1_byte", "dsi1_ddr2", "dsi1_ddr";
+      status = "disabled";
+      phandle = <0x6>;
+    };
+
+    csi0@7e800000 {
+      compatible = "brcm,bcm2835-unicam";
+      reg = <0x7e800000 0x800 0x7e802000 0x4>;
+      interrupts = <0x2 0x6>;
+      clocks = <0x8 0x2d>;
+      clock-names = "lp";
+      #address-cells = <0x1>;
+      #size-cells = <0x0>;
+      #clock-cells = <0x1>;
+      status = "disabled";
+      power-domains = <0x14 0xc>;
+      phandle = <0x68>;
+    };
+
+    csi1@7e801000 {
+      compatible = "brcm,bcm2835-unicam";
+      reg = <0x7e801000 0x800 0x7e802004 0x4>;
+      interrupts = <0x2 0x7>;
+      clocks = <0x8 0x2e>;
+      clock-names = "lp";
+      #address-cells = <0x1>;
+      #size-cells = <0x0>;
+      #clock-cells = <0x1>;
+      status = "disabled";
+      power-domains = <0x14 0xd>;
+      phandle = <0x69>;
+
+      port {
+
+        endpoint {
+          data-lanes = <0x1 0x2>;
+        };
+      };
+    };
+
+    i2c@7e804000 {
+      compatible = "brcm,bcm2835-i2c";
+      reg = <0x7e804000 0x1000>;
+      interrupts = <0x2 0x15>;
+      clocks = <0x8 0x14>;
+      #address-cells = <0x1>;
+      #size-cells = <0x0>;
+      status = "disabled";
+      pinctrl-names = "default";
+      pinctrl-0 = <0x15>;
+      clock-frequency = <0x186a0>;
+      phandle = <0x23>;
+    };
+
+    i2c@7e805000 {
+      compatible = "brcm,bcm2835-i2c";
+      reg = <0x7e805000 0x1000>;
+      interrupts = <0x2 0x15>;
+      clocks = <0x8 0x14>;
+      #address-cells = <0x1>;
+      #size-cells = <0x0>;
+      status = "disabled";
+      clock-frequency = <0x186a0>;
+      phandle = <0x16>;
+    };
+
+    vec@7e806000 {
+      compatible = "brcm,bcm2835-vec";
+      reg = <0x7e806000 0x1000>;
+      clocks = <0x8 0x18>;
+      interrupts = <0x2 0x1b>;
+      status = "disabled";
+      phandle = <0x6a>;
+    };
+
+    pixelvalve@7e807000 {
+      compatible = "brcm,bcm2835-pixelvalve2";
+      reg = <0x7e807000 0x100>;
+      interrupts = <0x2 0xa>;
+      status = "disabled";
+      phandle = <0x6b>;
+    };
+
+    hdmi@7e902000 {
+      compatible = "brcm,bcm2835-hdmi";
+      reg = <0x7e902000 0x600 0x7e808000 0x100>;
+      interrupts = <0x2 0x8 0x2 0x9>;
+      ddc = <0x16>;
+      clocks = <0x8 0x10 0x8 0x19>;
+      clock-names = "pixel", "hdmi";
+      dmas = <0xb 0x11>;
+      dma-names = "audio-rx";
+      status = "disabled";
+      power-domains = <0x14 0x5>;
+      hpd-gpios = <0x17 0x4 0x1>;
+      phandle = <0x6c>;
+    };
+
+    usb@7e980000 {
+      compatible = "brcm,bcm2835-usb";
+      reg = <0x7e980000 0x10000 0x7e006000 0x1000>;
+      interrupts = <0x1 0x9>;
+      #address-cells = <0x1>;
+      #size-cells = <0x0>;
+      clocks = <0x18>;
+      clock-names = "otg";
+      phys = <0x19>;
+      phy-names = "usb2-phy";
+      power-domains = <0x14 0x6>;
+      phandle = <0x6d>;
+
+      usb1@1 {
+        compatible = "usb424,9514";
+        reg = <0x1>;
+        #address-cells = <0x1>;
+        #size-cells = <0x0>;
+
+        usbether@1 {
+          compatible = "usb424,ec00";
+          reg = <0x1>;
+          phandle = <0x6e>;
+        };
+      };
+    };
+
+    v3d@7ec00000 {
+      compatible = "brcm,vc4-v3d";
+      reg = <0x7ec00000 0x1000>;
+      interrupts = <0x1 0xa>;
+      power-domains = <0x14 0xa>;
+      status = "disabled";
+      phandle = <0x6f>;
+    };
+
+    gpu {
+      compatible = "brcm,bcm2835-vc4";
+      status = "disabled";
+      phandle = <0x70>;
+    };
+
+    local_intc@40000000 {
+      compatible = "brcm,bcm2836-l1-intc";
+      reg = <0x40000000 0x100>;
+      interrupt-controller;
+      #interrupt-cells = <0x1>;
+      interrupt-parent = <0x3>;
+      phandle = <0x3>;
+    };
+
+    mmc@7e300000 {
+      compatible = "brcm,bcm2835-mmc", "brcm,bcm2835-sdhci";
+      reg = <0x7e300000 0x100>;
+      interrupts = <0x2 0x1e>;
+      clocks = <0x8 0x1c>;
+      dmas = <0xb 0xb>;
+      dma-names = "rx-tx";
+      brcm,overclock-50 = <0x0>;
+      status = "okay";
+      pinctrl-names = "default";
+      pinctrl-0 = <0x1a>;
+      non-removable;
+      bus-width = <0x4>;
+      phandle = <0x28>;
+    };
+
+    firmwarekms@7e600000 {
+      compatible = "raspberrypi,rpi-firmware-kms";
+      reg = <0x7e600000 0x100>;
+      interrupts = <0x2 0x10>;
+      brcm,firmware = <0x7>;
+      status = "disabled";
+      phandle = <0x71>;
+    };
+
+    smi@7e600000 {
+      compatible = "brcm,bcm2835-smi";
+      reg = <0x7e600000 0x100>;
+      interrupts = <0x2 0x10>;
+      clocks = <0x8 0x2a>;
+      assigned-clocks = <0x8 0x2a>;
+      assigned-clock-rates = <0x7735940>;
+      dmas = <0xb 0x4>;
+      dma-names = "rx-tx";
+      status = "disabled";
+      phandle = <0x72>;
+    };
+
+    axiperf {
+      compatible = "brcm,bcm2835-axiperf";
+      reg = <0x7e009800 0x100 0x7ee08000 0x100>;
+      firmware = <0x7>;
+      status = "disabled";
+      phandle = <0x29>;
+    };
+
+    gpiomem {
+      compatible = "brcm,bcm2835-gpiomem";
+      reg = <0x7e200000 0x1000>;
+    };
+
+    firmware {
+      compatible = "raspberrypi,bcm2835-firmware";
+      mboxes = <0x1b>;
+      phandle = <0x7>;
+    };
+
+    power {
+      compatible = "raspberrypi,bcm2835-power";
+      firmware = <0x7>;
+      #power-domain-cells = <0x1>;
+      phandle = <0x14>;
+    };
+
+    fb {
+      compatible = "brcm,bcm2708-fb";
+      firmware = <0x7>;
+      status = "okay";
+      phandle = <0x73>;
+    };
+
+    vchiq {
+      compatible = "brcm,bcm2835-vchiq";
+      reg = <0x7e00b840 0xf>;
+      interrupts = <0x0 0x2>;
+      cache-line-size = <0x20>;
+      firmware = <0x7>;
+      phandle = <0x1d>;
+    };
+
+    vcsm {
+      compatible = "raspberrypi,bcm2835-vcsm";
+      firmware = <0x7>;
+      status = "okay";
+      phandle = <0x74>;
+    };
+
+    audio {
+      compatible = "brcm,bcm2835-audio";
+      brcm,pwm-channels = <0x8>;
+      status = "disabled";
+      pinctrl-names = "default";
+      pinctrl-0 = <0x1c>;
+      phandle = <0x24>;
+    };
+
+    sound {
+      status = "disabled";
+      phandle = <0x75>;
+    };
+
+    arm-pmu {
+      compatible = "arm,cortex-a7-pmu";
+      interrupt-parent = <0x3>;
+      interrupts = <0x9>;
+    };
+
+    virtgpio {
+      compatible = "brcm,bcm2835-virtgpio";
+      gpio-controller;
+      #gpio-cells = <0x2>;
+      firmware = <0x7>;
+      status = "okay";
+      phandle = <0x30>;
+    };
+
+    expgpio {
+      compatible = "brcm,bcm2835-expgpio";
+      gpio-controller;
+      #gpio-cells = <0x2>;
+      firmware = <0x7>;
+      status = "okay";
+      phandle = <0x17>;
+    };
+  };
+
+  clocks {
+    compatible = "simple-bus";
+    #address-cells = <0x1>;
+    #size-cells = <0x0>;
+
+    clock@3 {
+      compatible = "fixed-clock";
+      reg = <0x3>;
+      #clock-cells = <0x0>;
+      clock-output-names = "osc";
+      clock-frequency = <0x124f800>;
+      phandle = <0x4>;
+    };
+
+    clock@4 {
+      compatible = "fixed-clock";
+      reg = <0x4>;
+      #clock-cells = <0x0>;
+      clock-output-names = "otg";
+      clock-frequency = <0x1c9c3800>;
+      phandle = <0x18>;
+    };
+  };
+
+  phy {
+    compatible = "usb-nop-xceiv";
+    #phy-cells = <0x0>;
+    phandle = <0x19>;
+  };
+
+  timer {
+    compatible = "arm,armv7-timer";
+    interrupt-parent = <0x3>;
+    interrupts = <0x0 0x1 0x3 0x2>;
+    always-on;
+  };
+
+  psci {
+    compatible = "arm,psci-1.0";
+    method = "smc";
+  };
+
+  cpus {
+    #address-cells = <0x1>;
+    #size-cells = <0x0>;
+    enable-method = "brcm,bcm2836-smp";
+    phandle = <0x76>;
+
+    cpu@0 {
+      device_type = "cpu";
+      compatible = "arm,cortex-a53";
+      reg = <0x0>;
+      enable-method = "psci";
+      cpu-release-addr = <0x0 0xd8>;
+      phandle = <0x2a>;
+    };
+
+    cpu@1 {
+      device_type = "cpu";
+      compatible = "arm,cortex-a53";
+      reg = <0x1>;
+      enable-method = "psci";
+      cpu-release-addr = <0x0 0xe0>;
+      phandle = <0x2b>;
+    };
+
+    cpu@2 {
+      device_type = "cpu";
+      compatible = "arm,cortex-a53";
+      reg = <0x2>;
+      enable-method = "psci";
+      cpu-release-addr = <0x0 0xe8>;
+      phandle = <0x2c>;
+    };
+
+    cpu@3 {
+      device_type = "cpu";
+      compatible = "arm,cortex-a53";
+      reg = <0x3>;
+      enable-method = "psci";
+      cpu-release-addr = <0x0 0xf0>;
+      phandle = <0x2d>;
+    };
+  };
+
+  fixedregulator_5v0 {
+    compatible = "regulator-fixed";
+    regulator-name = "5v0";
+    regulator-min-microvolt = <0x4c4b40>;
+    regulator-max-microvolt = <0x4c4b40>;
+    regulator-always-on;
+    phandle = <0x77>;
+  };
+
+  fixedregulator_3v3 {
+    compatible = "regulator-fixed";
+    regulator-name = "3v3";
+    regulator-min-microvolt = <0x325aa0>;
+    regulator-max-microvolt = <0x325aa0>;
+    regulator-always-on;
+    phandle = <0x78>;
+  };
+
+  __overrides__ {
+    cam0-pwdn-ctrl;
+    cam0-pwdn;
+    cam0-led-ctrl;
+    cam0-led;
+    cache_line_size = [00 00 00 1d 63 61 63 68 65 2d 6c 69 6e 65 2d 73 69 7a 65 3a 30 00];
+    uart0 = [00 00 00 1e 73 74 61 74 75 73 00];
+    uart1 = [00 00 00 1f 73 74 61 74 75 73 00];
+    i2s = "", "", "", " status";
+    spi = "", "", "", "!status";
+    i2c0 = "", "", "", "\"status";
+    i2c1 = "", "", "", "#status";
+    i2c2_iknowwhatimdoing = [00 00 00 16 73 74 61 74 75 73 00];
+    i2c0_baudrate = "", "", "", "\"clock-frequency:0";
+    i2c1_baudrate = "", "", "", "#clock-frequency:0";
+    i2c2_baudrate = [00 00 00 16 63 6c 6f 63 6b 2d 66 72 65 71 75 65 6e 63 79 3a 30 00];
+    audio = "", "", "", "$status";
+    watchdog = "", "", "", "%status";
+    random = "", "", "", "&status";
+    sd_overclock = "", "", "", "'brcm,overclock-50:0";
+    sd_force_pio = "", "", "", "'brcm,force-pio?";
+    sd_pio_limit = "", "", "", "'brcm,pio-limit:0";
+    sd_debug = "", "", "", "'brcm,debug";
+    sdio_overclock = "", "", "", "(brcm,overclock-50:0";
+    axiperf = "", "", "", ")status";
+    arm_freq = "", "", "", "*clock-frequency:0", "", "", "", "+clock-frequency:0", "", "", "", ",clock-frequency:0", "", "", "", "-clock-frequency:0";
+    act_led_gpio = "", "", "", ".gpios:4";
+    act_led_activelow = "", "", "", ".gpios:8";
+    act_led_trigger = "", "", "", ".linux,default-trigger";
+    pwr_led_gpio = "", "", "", "/gpios:4";
+    pwr_led_activelow = "", "", "", "/gpios:8";
+    pwr_led_trigger = "", "", "", "/linux,default-trigger";
+  };
+
+  memory {
+    device_type = "memory";
+    reg = <0x0 0x0>;
+  };
+
+  leds {
+    compatible = "gpio-leds";
+    phandle = <0x79>;
+
+    act {
+      label = "led0";
+      linux,default-trigger = "mmc0";
+      gpios = <0x30 0x0 0x0>;
+      phandle = <0x2e>;
+    };
+
+    pwr {
+      label = "led1";
+      linux,default-trigger = "input";
+      gpios = <0x17 0x7 0x0>;
+      phandle = <0x2f>;
+    };
+  };
+
+  __symbols__ {
+    cpu_thermal = "/thermal-zones/cpu-thermal";
+    soc = "/soc";
+    dma = "/soc/dma@7e007000";
+    intc = "/soc/interrupt-controller@7e00b200";
+    watchdog = "/soc/watchdog@7e100000";
+    clocks = "/soc/cprman@7e101000";
+    random = "/soc/rng@7e104000";
+    mailbox = "/soc/mailbox@7e00b880";
+    gpio = "/soc/gpio@7e200000";
+    dpi_gpio0 = "/soc/gpio@7e200000/dpi_gpio0";
+    emmc_gpio22 = "/soc/gpio@7e200000/emmc_gpio22";
+    emmc_gpio34 = "/soc/gpio@7e200000/emmc_gpio34";
+    emmc_gpio48 = "/soc/gpio@7e200000/emmc_gpio48";
+    gpclk0_gpio4 = "/soc/gpio@7e200000/gpclk0_gpio4";
+    gpclk1_gpio5 = "/soc/gpio@7e200000/gpclk1_gpio5";
+    gpclk1_gpio42 = "/soc/gpio@7e200000/gpclk1_gpio42";
+    gpclk1_gpio44 = "/soc/gpio@7e200000/gpclk1_gpio44";
+    gpclk2_gpio6 = "/soc/gpio@7e200000/gpclk2_gpio6";
+    gpclk2_gpio43 = "/soc/gpio@7e200000/gpclk2_gpio43";
+    i2c0_gpio0 = "/soc/gpio@7e200000/i2c0_gpio0";
+    i2c0_gpio28 = "/soc/gpio@7e200000/i2c0_gpio28";
+    i2c0_gpio44 = "/soc/gpio@7e200000/i2c0_gpio44";
+    i2c1_gpio2 = "/soc/gpio@7e200000/i2c1_gpio2";
+    i2c1_gpio44 = "/soc/gpio@7e200000/i2c1_gpio44";
+    i2c_slave_gpio18 = "/soc/gpio@7e200000/i2c_slave_gpio18";
+    jtag_gpio4 = "/soc/gpio@7e200000/jtag_gpio4";
+    jtag_gpio22 = "/soc/gpio@7e200000/jtag_gpio22";
+    pcm_gpio18 = "/soc/gpio@7e200000/pcm_gpio18";
+    pcm_gpio28 = "/soc/gpio@7e200000/pcm_gpio28";
+    pwm0_gpio12 = "/soc/gpio@7e200000/pwm0_gpio12";
+    pwm0_gpio18 = "/soc/gpio@7e200000/pwm0_gpio18";
+    pwm0_gpio40 = "/soc/gpio@7e200000/pwm0_gpio40";
+    pwm1_gpio13 = "/soc/gpio@7e200000/pwm1_gpio13";
+    pwm1_gpio19 = "/soc/gpio@7e200000/pwm1_gpio19";
+    pwm1_gpio41 = "/soc/gpio@7e200000/pwm1_gpio41";
+    pwm1_gpio45 = "/soc/gpio@7e200000/pwm1_gpio45";
+    sdhost_pins = "/soc/gpio@7e200000/sdhost_gpio48";
+    sdhost_gpio48 = "/soc/gpio@7e200000/sdhost_gpio48";
+    spi0_gpio7 = "/soc/gpio@7e200000/spi0_gpio7";
+    spi0_gpio35 = "/soc/gpio@7e200000/spi0_gpio35";
+    spi1_gpio16 = "/soc/gpio@7e200000/spi1_gpio16";
+    spi2_gpio40 = "/soc/gpio@7e200000/spi2_gpio40";
+    uart0_gpio14 = "/soc/gpio@7e200000/uart0_gpio14";
+    uart0_ctsrts_gpio16 = "/soc/gpio@7e200000/uart0_ctsrts_gpio16";
+    uart0_ctsrts_gpio30 = "/soc/gpio@7e200000/uart0_ctsrts_gpio30";
+    uart0_gpio32 = "/soc/gpio@7e200000/uart0_gpio32";
+    uart0_gpio36 = "/soc/gpio@7e200000/uart0_gpio36";
+    uart0_ctsrts_gpio38 = "/soc/gpio@7e200000/uart0_ctsrts_gpio38";
+    uart1_gpio14 = "/soc/gpio@7e200000/uart1_gpio14";
+    uart1_ctsrts_gpio16 = "/soc/gpio@7e200000/uart1_ctsrts_gpio16";
+    uart1_gpio32 = "/soc/gpio@7e200000/uart1_gpio32";
+    uart1_ctsrts_gpio30 = "/soc/gpio@7e200000/uart1_ctsrts_gpio30";
+    uart1_gpio40 = "/soc/gpio@7e200000/uart1_gpio40";
+    uart1_ctsrts_gpio42 = "/soc/gpio@7e200000/uart1_ctsrts_gpio42";
+    dpi_18bit_gpio0 = "/soc/gpio@7e200000/dpi_18bit_gpio0";
+    spi0_pins = "/soc/gpio@7e200000/spi0_pins";
+    spi0_cs_pins = "/soc/gpio@7e200000/spi0_cs_pins";
+    i2c0_pins = "/soc/gpio@7e200000/i2c0";
+    i2c1_pins = "/soc/gpio@7e200000/i2c1";
+    i2s_pins = "/soc/gpio@7e200000/i2s";
+    sdio_pins = "/soc/gpio@7e200000/sdio_pins";
+    bt_pins = "/soc/gpio@7e200000/bt_pins";
+    uart0_pins = "/soc/gpio@7e200000/uart0_pins";
+    uart1_pins = "/soc/gpio@7e200000/uart1_pins";
+    audio_pins = "/soc/gpio@7e200000/audio_pins";
+    uart0 = "/soc/serial@7e201000";
+    sdhost = "/soc/mmc@7e202000";
+    i2s = "/soc/i2s@7e203000";
+    spi0 = "/soc/spi@7e204000";
+    spi = "/soc/spi@7e204000";
+    spidev0 = "/soc/spi@7e204000/spidev@0";
+    spidev1 = "/soc/spi@7e204000/spidev@1";
+    i2c0 = "/soc/i2c@7e205000";
+    pixelvalve0 = "/soc/pixelvalve@7e206000";
+    pixelvalve1 = "/soc/pixelvalve@7e207000";
+    dpi = "/soc/dpi@7e208000";
+    dsi0 = "/soc/dsi@7e209000";
+    thermal = "/soc/thermal@7e212000";
+    aux = "/soc/aux@0x7e215000";
+    uart1 = "/soc/serial@7e215040";
+    spi1 = "/soc/spi@7e215080";
+    spi2 = "/soc/spi@7e2150c0";
+    pwm = "/soc/pwm@7e20c000";
+    hvs = "/soc/hvs@7e400000";
+    dsi1 = "/soc/dsi@7e700000";
+    csi0 = "/soc/csi0@7e800000";
+    csi1 = "/soc/csi1@7e801000";
+    i2c1 = "/soc/i2c@7e804000";
+    i2c2 = "/soc/i2c@7e805000";
+    vec = "/soc/vec@7e806000";
+    pixelvalve2 = "/soc/pixelvalve@7e807000";
+    hdmi = "/soc/hdmi@7e902000";
+    usb = "/soc/usb@7e980000";
+    ethernet = "/soc/usb@7e980000/usb1@1/usbether@1";
+    v3d = "/soc/v3d@7ec00000";
+    vc4 = "/soc/gpu";
+    local_intc = "/soc/local_intc@40000000";
+    mmc = "/soc/mmc@7e300000";
+    firmwarekms = "/soc/firmwarekms@7e600000";
+    smi = "/soc/smi@7e600000";
+    axiperf = "/soc/axiperf";
+    firmware = "/soc/firmware";
+    power = "/soc/power";
+    fb = "/soc/fb";
+    vchiq = "/soc/vchiq";
+    vcsm = "/soc/vcsm";
+    audio = "/soc/audio";
+    sound = "/soc/sound";
+    virtgpio = "/soc/virtgpio";
+    expgpio = "/soc/expgpio";
+    clk_osc = "/clocks/clock@3";
+    clk_usb = "/clocks/clock@4";
+    usbphy = "/phy";
+    cpus = "/cpus";
+    cpu0 = "/cpus/cpu@0";
+    cpu1 = "/cpus/cpu@1";
+    cpu2 = "/cpus/cpu@2";
+    cpu3 = "/cpus/cpu@3";
+    vdd_5v0_reg = "/fixedregulator_5v0";
+    vdd_3v3_reg = "/fixedregulator_3v3";
+    leds = "/leds";
+    act_led = "/leds/act";
+    pwr_led = "/leds/pwr";
+  };
+};
-- 
2.17.0.windows.1



^ permalink raw reply related	[flat|nested] 34+ messages in thread

* [PATCH v5 edk2-platforms 20/22] Platform/RaspberryPi/RPi3 *NON-OSI*: Add logo driver
  2019-02-05 16:25 [PATCH v5 edk2-platforms 00/22] Platform/RaspberryPi: Add Raspberry Pi 3 support Pete Batard
                   ` (18 preceding siblings ...)
  2019-02-05 16:25 ` [PATCH v5 edk2-platforms 19/22] Platform/RaspberryPi/RPi3 *NON-OSI*: Add Device Tree binaries Pete Batard
@ 2019-02-05 16:25 ` Pete Batard
  2019-02-05 16:25 ` [PATCH v5 edk2-platforms 21/22] Platform/RaspberryPi/RPi3: Add platform Pete Batard
                   ` (3 subsequent siblings)
  23 siblings, 0 replies; 34+ messages in thread
From: Pete Batard @ 2019-02-05 16:25 UTC (permalink / raw)
  To: edk2-devel

Displays a custom logo during early boot.
This custom logo was graciously provided by the Raspberry Pi foundation.

Contributed-under: TianoCore Contribution Agreement 1.1
Signed-off-by: Pete Batard <pete@akeo.ie>
---
 Platform/RaspberryPi/RPi3/Drivers/LogoDxe/License.txt      |  10 ++
 Platform/RaspberryPi/RPi3/Drivers/LogoDxe/Logo.bmp         | Bin 0 -> 185398 bytes
 Platform/RaspberryPi/RPi3/Drivers/LogoDxe/Logo.c           | 159 ++++++++++++++++++++
 Platform/RaspberryPi/RPi3/Drivers/LogoDxe/Logo.eps         | Bin 0 -> 250982 bytes
 Platform/RaspberryPi/RPi3/Drivers/LogoDxe/Logo.idf         |  18 +++
 Platform/RaspberryPi/RPi3/Drivers/LogoDxe/Logo.inf         |  34 +++++
 Platform/RaspberryPi/RPi3/Drivers/LogoDxe/Logo.uni         |  20 +++
 Platform/RaspberryPi/RPi3/Drivers/LogoDxe/LogoDxe.inf      |  63 ++++++++
 Platform/RaspberryPi/RPi3/Drivers/LogoDxe/LogoDxe.uni      |  19 +++
 Platform/RaspberryPi/RPi3/Drivers/LogoDxe/LogoDxeExtra.uni |  19 +++
 Platform/RaspberryPi/RPi3/Drivers/LogoDxe/LogoExtra.uni    |  19 +++
 11 files changed, 361 insertions(+)

diff --git a/Platform/RaspberryPi/RPi3/Drivers/LogoDxe/License.txt b/Platform/RaspberryPi/RPi3/Drivers/LogoDxe/License.txt
new file mode 100644
index 000000000000..9370146336be
--- /dev/null
+++ b/Platform/RaspberryPi/RPi3/Drivers/LogoDxe/License.txt
@@ -0,0 +1,10 @@
+The source code in this directory is licensed under the standard EDK2 terms.
+
+On the other hand, the Raspberry Pi logo binary (.bmp, .eps) is subject to the
+licensing terms and conditions put forward by the Raspberry Pi Foundation at:
+- https://www.raspberrypi.org/trademark-rules/
+- https://static.raspberrypi.org/files/Raspberry_Pi_Visual_Guidelines_2018.pdf
+
+While the logo was obtained and is being used with kind permission from the
+Raspberry Pi Foundation, it needs to be noted that this project is not
+officially endorsed by the Foundation.
diff --git a/Platform/RaspberryPi/RPi3/Drivers/LogoDxe/Logo.bmp b/Platform/RaspberryPi/RPi3/Drivers/LogoDxe/Logo.bmp
new file mode 100644
index 0000000000000000000000000000000000000000..674356fe0b1b12c60ef485d27cb4a659eafe3485
GIT binary patch
literal 185398
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
Ll>0Db8uR}EsF|n^

literal 0
HcmV?d00001

diff --git a/Platform/RaspberryPi/RPi3/Drivers/LogoDxe/Logo.c b/Platform/RaspberryPi/RPi3/Drivers/LogoDxe/Logo.c
new file mode 100644
index 000000000000..bb287b339b3b
--- /dev/null
+++ b/Platform/RaspberryPi/RPi3/Drivers/LogoDxe/Logo.c
@@ -0,0 +1,159 @@
+/** @file
+  Logo DXE Driver, install Edkii Platform Logo protocol.
+
+Copyright (c) 2016 - 2017, Intel Corporation. All rights reserved.<BR>
+This program and the accompanying materials
+are licensed and made available under the terms and conditions of the BSD License
+which accompanies this distribution.  The full text of the license may be found at
+http://opensource.org/licenses/bsd-license.php
+
+THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+
+**/
+#include <Uefi.h>
+#include <Protocol/HiiDatabase.h>
+#include <Protocol/GraphicsOutput.h>
+#include <Protocol/HiiImageEx.h>
+#include <Protocol/PlatformLogo.h>
+#include <Protocol/HiiPackageList.h>
+#include <Library/UefiBootServicesTableLib.h>
+#include <Library/DebugLib.h>
+
+typedef struct {
+  EFI_IMAGE_ID                          ImageId;
+  EDKII_PLATFORM_LOGO_DISPLAY_ATTRIBUTE Attribute;
+  INTN                                  OffsetX;
+  INTN                                  OffsetY;
+} LOGO_ENTRY;
+
+EFI_HII_IMAGE_EX_PROTOCOL *mHiiImageEx;
+EFI_HII_HANDLE            mHiiHandle;
+LOGO_ENTRY                mLogos[] = {
+  {
+    IMAGE_TOKEN (IMG_LOGO),
+    EdkiiPlatformLogoDisplayAttributeCenter,
+    0,
+    0
+  }
+};
+
+/**
+  Load a platform logo image and return its data and attributes.
+
+  @param This              The pointer to this protocol instance.
+  @param Instance          The visible image instance is found.
+  @param Image             Points to the image.
+  @param Attribute         The display attributes of the image returned.
+  @param OffsetX           The X offset of the image regarding the Attribute.
+  @param OffsetY           The Y offset of the image regarding the Attribute.
+
+  @retval EFI_SUCCESS      The image was fetched successfully.
+  @retval EFI_NOT_FOUND    The specified image could not be found.
+**/
+EFI_STATUS
+EFIAPI
+GetImage (
+  IN     EDKII_PLATFORM_LOGO_PROTOCOL          *This,
+  IN OUT UINT32                                *Instance,
+     OUT EFI_IMAGE_INPUT                       *Image,
+     OUT EDKII_PLATFORM_LOGO_DISPLAY_ATTRIBUTE *Attribute,
+     OUT INTN                                  *OffsetX,
+     OUT INTN                                  *OffsetY
+  )
+{
+  UINT32 Current;
+  if (Instance == NULL || Image == NULL ||
+      Attribute == NULL || OffsetX == NULL || OffsetY == NULL) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  Current = *Instance;
+  if (Current >= ARRAY_SIZE (mLogos)) {
+    return EFI_NOT_FOUND;
+  }
+
+  (*Instance)++;
+  *Attribute = mLogos[Current].Attribute;
+  *OffsetX = mLogos[Current].OffsetX;
+  *OffsetY = mLogos[Current].OffsetY;
+  return mHiiImageEx->GetImageEx (mHiiImageEx, mHiiHandle, mLogos[Current].ImageId, Image);
+}
+
+EDKII_PLATFORM_LOGO_PROTOCOL mPlatformLogo = {
+  GetImage
+};
+
+/**
+  Entrypoint of this module.
+
+  This function is the entrypoint of this module. It installs the Edkii
+  Platform Logo protocol.
+
+  @param  ImageHandle       The firmware allocated handle for the EFI image.
+  @param  SystemTable       A pointer to the EFI System Table.
+
+  @retval EFI_SUCCESS       The entry point is executed successfully.
+
+**/
+EFI_STATUS
+EFIAPI
+InitializeLogo (
+  IN EFI_HANDLE               ImageHandle,
+  IN EFI_SYSTEM_TABLE         *SystemTable
+  )
+{
+  EFI_STATUS                  Status;
+  EFI_HII_PACKAGE_LIST_HEADER *PackageList;
+  EFI_HII_DATABASE_PROTOCOL   *HiiDatabase;
+  EFI_HANDLE                  Handle;
+
+  Status = gBS->LocateProtocol (
+                  &gEfiHiiDatabaseProtocolGuid,
+                  NULL,
+                  (VOID**) &HiiDatabase
+                );
+  ASSERT_EFI_ERROR (Status);
+
+  Status = gBS->LocateProtocol (
+                  &gEfiHiiImageExProtocolGuid,
+                  NULL,
+                  (VOID**) &mHiiImageEx
+                );
+  ASSERT_EFI_ERROR (Status);
+
+  //
+  // Retrieve HII package list from ImageHandle
+  //
+  Status = gBS->OpenProtocol (
+                  ImageHandle,
+                  &gEfiHiiPackageListProtocolGuid,
+                  (VOID**)&PackageList,
+                  ImageHandle,
+                  NULL,
+                  EFI_OPEN_PROTOCOL_GET_PROTOCOL
+                );
+  if (EFI_ERROR (Status)) {
+    DEBUG ((DEBUG_ERROR, "HII Image Package with logo not found in PE/COFF resource section\n"));
+    return Status;
+  }
+
+  //
+  // Publish HII package list to HII Database.
+  //
+  Status = HiiDatabase->NewPackageList (
+                          HiiDatabase,
+                          PackageList,
+                          NULL,
+                          &mHiiHandle
+                        );
+  if (!EFI_ERROR (Status)) {
+    Handle = NULL;
+    Status = gBS->InstallMultipleProtocolInterfaces (
+                    &Handle,
+                    &gEdkiiPlatformLogoProtocolGuid, &mPlatformLogo,
+                    NULL
+                  );
+  }
+  return Status;
+}
diff --git a/Platform/RaspberryPi/RPi3/Drivers/LogoDxe/Logo.eps b/Platform/RaspberryPi/RPi3/Drivers/LogoDxe/Logo.eps
new file mode 100644
index 0000000000000000000000000000000000000000..f40df6b0149a9b45e2b86a42e074a11c7bce6796
GIT binary patch
literal 250982
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
PPKas%y!4z5ke~kpwvJ^n

literal 0
HcmV?d00001

diff --git a/Platform/RaspberryPi/RPi3/Drivers/LogoDxe/Logo.idf b/Platform/RaspberryPi/RPi3/Drivers/LogoDxe/Logo.idf
new file mode 100644
index 000000000000..f4c39b78c436
--- /dev/null
+++ b/Platform/RaspberryPi/RPi3/Drivers/LogoDxe/Logo.idf
@@ -0,0 +1,18 @@
+// /** @file
+// Platform Logo image definition file.
+//
+// Console Platfrom DXE Driver that specifies whether device can be used as console
+// input/output device or error output device and update global variables accordingly.
+//
+// Copyright (c) 2016, Intel Corporation. All rights reserved.<BR>
+//
+// This program and the accompanying materials
+// are licensed and made available under the terms and conditions of the BSD License
+// which accompanies this distribution. The full text of the license may be found at
+// http://opensource.org/licenses/bsd-license.php
+// THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+// WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+//
+// **/
+
+#image IMG_LOGO Logo.bmp
diff --git a/Platform/RaspberryPi/RPi3/Drivers/LogoDxe/Logo.inf b/Platform/RaspberryPi/RPi3/Drivers/LogoDxe/Logo.inf
new file mode 100644
index 000000000000..8bb82f3223b3
--- /dev/null
+++ b/Platform/RaspberryPi/RPi3/Drivers/LogoDxe/Logo.inf
@@ -0,0 +1,34 @@
+## @file
+#  The default logo bitmap picture shown on setup screen, which is corresponding to gEfiDefaultBmpLogoGuid.
+#
+#  Copyright (c) 2006 - 2014, Intel Corporation. All rights reserved.<BR>
+#
+#  This program and the accompanying materials
+#  are licensed and made available under the terms and conditions of the BSD License
+#  which accompanies this distribution. The full text of the license may be found at
+#  http://opensource.org/licenses/bsd-license.php
+#  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+#  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+#
+#
+##
+
+[Defines]
+  INF_VERSION                    = 0x0001001A
+  BASE_NAME                      = Logo
+  MODULE_UNI_FILE                = Logo.uni
+  FILE_GUID                      = 7BB28B99-61BB-11D5-9A5D-0090273FC14D
+  MODULE_TYPE                    = USER_DEFINED
+  VERSION_STRING                 = 1.0
+
+#
+# The following information is for reference only and not required by the build tools.
+#
+#  VALID_ARCHITECTURES           = IA32 X64 IPF EBC ARM AARCH64
+#
+
+[Binaries]
+  BIN|Logo.bmp|*
+
+[UserExtensions.TianoCore."ExtraFiles"]
+  LogoExtra.uni
diff --git a/Platform/RaspberryPi/RPi3/Drivers/LogoDxe/Logo.uni b/Platform/RaspberryPi/RPi3/Drivers/LogoDxe/Logo.uni
new file mode 100644
index 000000000000..d21b336446bf
--- /dev/null
+++ b/Platform/RaspberryPi/RPi3/Drivers/LogoDxe/Logo.uni
@@ -0,0 +1,20 @@
+// /** @file
+// The default logo bitmap picture shown on setup screen, which is corresponding to gEfiDefaultBmpLogoGuid.
+//
+// This module provides the default logo bitmap picture shown on setup screen, which corresponds to gEfiDefaultBmpLogoGuid.
+//
+// Copyright (c) 2006 - 2014, Intel Corporation. All rights reserved.<BR>
+//
+// This program and the accompanying materials
+// are licensed and made available under the terms and conditions of the BSD License
+// which accompanies this distribution. The full text of the license may be found at
+// http://opensource.org/licenses/bsd-license.php
+// THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+// WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+//
+// **/
+
+
+#string STR_MODULE_ABSTRACT             #language en-US "Provides the default logo bitmap picture shown on setup screen, which corresponds to gEfiDefaultBmpLogoGuid"
+
+#string STR_MODULE_DESCRIPTION          #language en-US "This module provides the default logo bitmap picture shown on setup screen, which corresponds to gEfiDefaultBmpLogoGuid."
diff --git a/Platform/RaspberryPi/RPi3/Drivers/LogoDxe/LogoDxe.inf b/Platform/RaspberryPi/RPi3/Drivers/LogoDxe/LogoDxe.inf
new file mode 100644
index 000000000000..ca4cadec5ca8
--- /dev/null
+++ b/Platform/RaspberryPi/RPi3/Drivers/LogoDxe/LogoDxe.inf
@@ -0,0 +1,63 @@
+#/** @file
+#
+#  The default logo bitmap picture shown on setup screen.
+#
+#  Copyright (c) 2016-2017, Intel Corporation. All rights reserved.
+#
+#  This program and the accompanying materials are licensed and made available
+#  under the terms and conditions of the BSD License which accompanies this
+#  distribution. The full text of the license may be found at
+#  http://opensource.org/licenses/bsd-license.php
+#
+#  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+#  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR
+#  IMPLIED.
+#
+#**/
+
+[Defines]
+  INF_VERSION                    = 0x0001001A
+  BASE_NAME                      = LogoDxe
+  MODULE_UNI_FILE                = LogoDxe.uni
+  FILE_GUID                      = F74D20EE-37E7-48FC-97F7-9B1047749C69
+  MODULE_TYPE                    = DXE_DRIVER
+  VERSION_STRING                 = 1.0
+
+  ENTRY_POINT                    = InitializeLogo
+#
+#  This flag specifies whether HII resource section is generated into PE image.
+#
+  UEFI_HII_RESOURCE_SECTION      = TRUE
+
+#
+# The following information is for reference only and not required by the build tools.
+#
+#  VALID_ARCHITECTURES           = AARCH64
+#
+
+[Sources]
+  Logo.bmp
+  Logo.c
+  Logo.idf
+
+[Packages]
+  MdeModulePkg/MdeModulePkg.dec
+  MdePkg/MdePkg.dec
+
+[LibraryClasses]
+  UefiBootServicesTableLib
+  UefiDriverEntryPoint
+  DebugLib
+
+[Protocols]
+  gEfiHiiDatabaseProtocolGuid        ## CONSUMES
+  gEfiHiiImageExProtocolGuid         ## CONSUMES
+  gEfiHiiPackageListProtocolGuid     ## PRODUCES CONSUMES
+  gEdkiiPlatformLogoProtocolGuid     ## PRODUCES
+
+[Depex]
+  gEfiHiiDatabaseProtocolGuid AND
+  gEfiHiiImageExProtocolGuid
+
+[UserExtensions.TianoCore."ExtraFiles"]
+  LogoDxeExtra.uni
diff --git a/Platform/RaspberryPi/RPi3/Drivers/LogoDxe/LogoDxe.uni b/Platform/RaspberryPi/RPi3/Drivers/LogoDxe/LogoDxe.uni
new file mode 100644
index 000000000000..fe1637534332
--- /dev/null
+++ b/Platform/RaspberryPi/RPi3/Drivers/LogoDxe/LogoDxe.uni
@@ -0,0 +1,19 @@
+/** @file
+ *
+ *  The default logo bitmap picture shown on setup screen.
+ *
+ *  Copyright (c) 2016, Intel Corporation. All rights reserved.
+ *
+ *  This program and the accompanying materials
+ *  are licensed and made available under the terms and conditions of the BSD License
+ *  which accompanies this distribution.  The full text of the license may be found at
+ *  http://opensource.org/licenses/bsd-license.php
+ *
+ *  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+ *  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+ *
+ **/
+
+#string STR_MODULE_ABSTRACT             #language en-US "Provides the default logo bitmap picture shown on setup screen."
+
+#string STR_MODULE_DESCRIPTION          #language en-US "This module provides the default logo bitmap picture shown on setup screen, through EDKII Platform Logo protocol."
diff --git a/Platform/RaspberryPi/RPi3/Drivers/LogoDxe/LogoDxeExtra.uni b/Platform/RaspberryPi/RPi3/Drivers/LogoDxe/LogoDxeExtra.uni
new file mode 100644
index 000000000000..d8815b2dac56
--- /dev/null
+++ b/Platform/RaspberryPi/RPi3/Drivers/LogoDxe/LogoDxeExtra.uni
@@ -0,0 +1,19 @@
+/** @file
+ *
+ *  Logo Localized Strings and Content
+ *
+ *  Copyright (c) 2016, Intel Corporation. All rights reserved.
+ *
+ *  This program and the accompanying materials
+ *  are licensed and made available under the terms and conditions of the BSD License
+ *  which accompanies this distribution.  The full text of the license may be found at
+ *  http://opensource.org/licenses/bsd-license.php
+ *
+ *  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+ *  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+ *
+ **/
+
+#string STR_PROPERTIES_MODULE_NAME
+#language en-US
+"Logo Image File"
diff --git a/Platform/RaspberryPi/RPi3/Drivers/LogoDxe/LogoExtra.uni b/Platform/RaspberryPi/RPi3/Drivers/LogoDxe/LogoExtra.uni
new file mode 100644
index 000000000000..4f177586266a
--- /dev/null
+++ b/Platform/RaspberryPi/RPi3/Drivers/LogoDxe/LogoExtra.uni
@@ -0,0 +1,19 @@
+/** @file
+ *
+ *  Logo Localized Strings and Content
+ *
+ *  Copyright (c) 2013-2014, Intel Corporation. All rights reserved.
+ *
+ *  This program and the accompanying materials
+ *  are licensed and made available under the terms and conditions of the BSD License
+ *  which accompanies this distribution.  The full text of the license may be found at
+ *  http://opensource.org/licenses/bsd-license.php
+ *
+ *  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+ *  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+ *
+ **/
+
+#string STR_PROPERTIES_MODULE_NAME
+#language en-US
+"Logo Image File"
-- 
2.17.0.windows.1



^ permalink raw reply related	[flat|nested] 34+ messages in thread

* [PATCH v5 edk2-platforms 21/22] Platform/RaspberryPi/RPi3: Add platform
  2019-02-05 16:25 [PATCH v5 edk2-platforms 00/22] Platform/RaspberryPi: Add Raspberry Pi 3 support Pete Batard
                   ` (19 preceding siblings ...)
  2019-02-05 16:25 ` [PATCH v5 edk2-platforms 20/22] Platform/RaspberryPi/RPi3 *NON-OSI*: Add logo driver Pete Batard
@ 2019-02-05 16:25 ` Pete Batard
  2019-02-05 16:25 ` [PATCH v5 edk2-platforms 22/22] Platform/RaspberryPi/RPi3: Add platform readme's Pete Batard
                   ` (2 subsequent siblings)
  23 siblings, 0 replies; 34+ messages in thread
From: Pete Batard @ 2019-02-05 16:25 UTC (permalink / raw)
  To: edk2-devel

Adds the .dec/.dsc/.fdf needed to build the platform firmware.

Contributed-under: TianoCore Contribution Agreement 1.1
Signed-off-by: Pete Batard <pete@akeo.ie>
---
 Platform/RaspberryPi/RPi3/RPi3.dec |  58 ++
 Platform/RaspberryPi/RPi3/RPi3.dsc | 629 ++++++++++++++++++++
 Platform/RaspberryPi/RPi3/RPi3.fdf | 449 ++++++++++++++
 3 files changed, 1136 insertions(+)

diff --git a/Platform/RaspberryPi/RPi3/RPi3.dec b/Platform/RaspberryPi/RPi3/RPi3.dec
new file mode 100644
index 000000000000..2ca7e746a647
--- /dev/null
+++ b/Platform/RaspberryPi/RPi3/RPi3.dec
@@ -0,0 +1,58 @@
+## @file
+#
+#  Copyright (c) 2016, Linaro, Ltd. All rights reserved.
+#  Copyright (c) 2017-2018, Andrei Warkentin <andrey.warkentin@gmail.com>
+#
+#  This program and the accompanying materials are licensed and made available
+#  under the terms and conditions of the BSD License which accompanies this
+#  distribution. The full text of the license may be found at
+#  http://opensource.org/licenses/bsd-license.php
+#
+#  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+#  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR
+#  IMPLIED.
+#
+##
+
+[Defines]
+  DEC_SPECIFICATION              = 0x0001001A
+  PACKAGE_NAME                   = RPi3Pkg
+  PACKAGE_GUID                   = DFA0CA8B-F3AC-4607-96AC-46FA04B84DCC
+  PACKAGE_VERSION                = 1.0
+
+[Includes]
+  Include
+
+[Protocols]
+  gRaspberryPiFirmwareProtocolGuid = { 0x0ACA9535, 0x7AD0, 0x4286, { 0xB0, 0x2E, 0x87, 0xFA, 0x7E, 0x2A, 0x57, 0x11 } }
+  gRaspberryPiConfigAppliedProtocolGuid = { 0x0ACA4444, 0x7AD0, 0x4286, { 0xB0, 0x2E, 0x87, 0xFA, 0x7E, 0x2A, 0x57, 0x11 } }
+  gRaspberryPiMmcHostProtocolGuid = { 0x3e591c00, 0x9e4a, 0x11df, {0x92, 0x44, 0x00, 0x02, 0xA5, 0xF5, 0xF5, 0x1B } }
+  gExtendedTextOutputProtocolGuid = { 0x387477ff, 0xffc7, 0xffd2, {0x8e, 0x39, 0x0, 0xff, 0xc9, 0x69, 0x72, 0x3b } }
+
+[Guids]
+  gRaspberryPiTokenSpaceGuid = {0xCD7CC258, 0x31DB, 0x11E6, {0x9F, 0xD3, 0x63, 0xB0, 0xB8, 0xEE, 0xD6, 0xB5}}
+  gRaspberryPiFdtFileGuid = {0xDF5DA223, 0x1D27, 0x47C3, { 0x8D, 0x1B, 0x9A, 0x41, 0xB5, 0x5A, 0x18, 0xBC}}
+  gRaspberryPiEventResetGuid = {0xCD7CC258, 0x31DB, 0x11E6, {0x9F, 0xD3, 0x63, 0xB4, 0xB4, 0xE4, 0xD4, 0xB4}}
+  gConfigDxeFormSetGuid = {0xCD7CC258, 0x31DB, 0x22E6, {0x9F, 0x22, 0x63, 0xB0, 0xB8, 0xEE, 0xD6, 0xB5}}
+
+[PcdsFixedAtBuild.common]
+  gRaspberryPiTokenSpaceGuid.PcdFdtBaseAddress|0x10000|UINT32|0x00000001
+  gRaspberryPiTokenSpaceGuid.PcdFirmwareBlockSize|0x0|UINT32|0x00000002
+  gRaspberryPiTokenSpaceGuid.PcdNvStorageEventLogBase|0x0|UINT32|0x00000003
+  gRaspberryPiTokenSpaceGuid.PcdNvStorageEventLogSize|0x0|UINT32|0x00000004
+  gRaspberryPiTokenSpaceGuid.PcdNvStorageVariableBase|0x0|UINT32|0x00000005
+  gRaspberryPiTokenSpaceGuid.PcdNvStorageFtwSpareBase|0x0|UINT32|0x00000006
+  gRaspberryPiTokenSpaceGuid.PcdNvStorageFtwWorkingBase|0x0|UINT32|0x00000007
+
+[PcdsFixedAtBuild, PcdsPatchableInModule, PcdsDynamic, PcdsDynamicEx]
+  gRaspberryPiTokenSpaceGuid.PcdCpuClock|0|UINT32|0x0000000d
+  gRaspberryPiTokenSpaceGuid.PcdSdIsArasan|0|UINT32|0x0000000e
+  gRaspberryPiTokenSpaceGuid.PcdMmcForce1Bit|0|UINT32|0x0000000f
+  gRaspberryPiTokenSpaceGuid.PcdMmcForceDefaultSpeed|0|UINT32|0x00000010
+  gRaspberryPiTokenSpaceGuid.PcdMmcSdDefaultSpeedMHz|0|UINT32|0x00000011
+  gRaspberryPiTokenSpaceGuid.PcdMmcSdHighSpeedMHz|0|UINT32|0x00000012
+  gRaspberryPiTokenSpaceGuid.PcdMmcDisableMulti|0|UINT32|0x00000013
+  gRaspberryPiTokenSpaceGuid.PcdDebugEnableJTAG|0|UINT32|0x00000014
+  gRaspberryPiTokenSpaceGuid.PcdDebugShowUEFIExit|0|UINT32|0x00000015
+  gRaspberryPiTokenSpaceGuid.PcdDisplayEnableVModes|0|UINT32|0x00000017
+  gRaspberryPiTokenSpaceGuid.PcdDisplayEnableSShot|0|UINT32|0x00000018
diff --git a/Platform/RaspberryPi/RPi3/RPi3.dsc b/Platform/RaspberryPi/RPi3/RPi3.dsc
new file mode 100644
index 000000000000..86f9d2e5e925
--- /dev/null
+++ b/Platform/RaspberryPi/RPi3/RPi3.dsc
@@ -0,0 +1,629 @@
+# @file
+#
+#  Copyright (c) 2011-2015, ARM Limited. All rights reserved.
+#  Copyright (c) 2014, Linaro Limited. All rights reserved.
+#  Copyright (c) 2015 - 2016, Intel Corporation. All rights reserved.
+#  Copyright (c) 2017 - 2018, Andrei Warkentin <andrey.warkentin@gmail.com>
+#
+#  This program and the accompanying materials are licensed and made available
+#  under the terms and conditions of the BSD License which accompanies this
+#  distribution. The full text of the license may be found at
+#  http://opensource.org/licenses/bsd-license.php
+#
+#  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+#  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR
+#  IMPLIED.
+#
+##
+
+################################################################################
+#
+# Defines Section - statements that will be processed to create a Makefile.
+#
+################################################################################
+[Defines]
+  PLATFORM_NAME                  = RPi3
+  PLATFORM_GUID                  = 5d30c4fc-93cf-40c9-8486-3badc0410816
+  PLATFORM_VERSION               = 1.0
+  DSC_SPECIFICATION              = 0x0001001A
+  OUTPUT_DIRECTORY               = Build/$(PLATFORM_NAME)
+  SUPPORTED_ARCHITECTURES        = AARCH64
+  BUILD_TARGETS                  = DEBUG|RELEASE|NOOPT
+  SKUID_IDENTIFIER               = DEFAULT
+  FLASH_DEFINITION               = Platform/RaspberryPi/$(PLATFORM_NAME)/$(PLATFORM_NAME).fdf
+
+  #
+  # Defines for default states.  These can be changed on the command line.
+  # -D FLAG=VALUE
+  #
+  DEFINE SECURE_BOOT_ENABLE      = FALSE
+  DEFINE DEBUG_PRINT_ERROR_LEVEL = 0x8000004F
+
+################################################################################
+#
+# Library Class section - list of all Library Classes needed by this Platform.
+#
+################################################################################
+[LibraryClasses.common]
+!if $(TARGET) == RELEASE
+  DebugLib|MdePkg/Library/BaseDebugLibNull/BaseDebugLibNull.inf
+!else
+  DebugLib|MdePkg/Library/BaseDebugLibSerialPort/BaseDebugLibSerialPort.inf
+!endif
+  DebugPrintErrorLevelLib|MdePkg/Library/BaseDebugPrintErrorLevelLib/BaseDebugPrintErrorLevelLib.inf
+
+  BaseLib|MdePkg/Library/BaseLib/BaseLib.inf
+  SafeIntLib|MdePkg/Library/BaseSafeIntLib/BaseSafeIntLib.inf
+  BmpSupportLib|MdeModulePkg/Library/BaseBmpSupportLib/BaseBmpSupportLib.inf
+  SynchronizationLib|MdePkg/Library/BaseSynchronizationLib/BaseSynchronizationLib.inf
+  PerformanceLib|MdePkg/Library/BasePerformanceLibNull/BasePerformanceLibNull.inf
+  PrintLib|MdePkg/Library/BasePrintLib/BasePrintLib.inf
+  PeCoffGetEntryPointLib|MdePkg/Library/BasePeCoffGetEntryPointLib/BasePeCoffGetEntryPointLib.inf
+  PeCoffLib|MdePkg/Library/BasePeCoffLib/BasePeCoffLib.inf
+  IoLib|MdePkg/Library/BaseIoLibIntrinsic/BaseIoLibIntrinsic.inf
+  UefiDecompressLib|MdePkg/Library/BaseUefiDecompressLib/BaseUefiDecompressLib.inf
+  CpuLib|MdePkg/Library/BaseCpuLib/BaseCpuLib.inf
+
+  UefiLib|MdePkg/Library/UefiLib/UefiLib.inf
+  HobLib|MdePkg/Library/DxeHobLib/DxeHobLib.inf
+  UefiRuntimeServicesTableLib|MdePkg/Library/UefiRuntimeServicesTableLib/UefiRuntimeServicesTableLib.inf
+  DevicePathLib|MdePkg/Library/UefiDevicePathLib/UefiDevicePathLib.inf
+  UefiBootServicesTableLib|MdePkg/Library/UefiBootServicesTableLib/UefiBootServicesTableLib.inf
+  DxeServicesTableLib|MdePkg/Library/DxeServicesTableLib/DxeServicesTableLib.inf
+  DxeServicesLib|MdePkg/Library/DxeServicesLib/DxeServicesLib.inf
+  UefiDriverEntryPoint|MdePkg/Library/UefiDriverEntryPoint/UefiDriverEntryPoint.inf
+  UefiApplicationEntryPoint|MdePkg/Library/UefiApplicationEntryPoint/UefiApplicationEntryPoint.inf
+  HiiLib|MdeModulePkg/Library/UefiHiiLib/UefiHiiLib.inf
+  UefiHiiServicesLib|MdeModulePkg/Library/UefiHiiServicesLib/UefiHiiServicesLib.inf
+  SortLib|MdeModulePkg/Library/UefiSortLib/UefiSortLib.inf
+
+  UefiRuntimeLib|MdePkg/Library/UefiRuntimeLib/UefiRuntimeLib.inf
+  OrderedCollectionLib|MdePkg/Library/BaseOrderedCollectionRedBlackTreeLib/BaseOrderedCollectionRedBlackTreeLib.inf
+
+  #
+  # Ramdisk Requirements
+  #
+  FileExplorerLib|MdeModulePkg/Library/FileExplorerLib/FileExplorerLib.inf
+
+  # Allow dynamic PCDs
+  #
+  PcdLib|MdePkg/Library/DxePcdLib/DxePcdLib.inf
+
+  # use the accelerated BaseMemoryLibOptDxe by default, overrides for SEC/PEI below
+  BaseMemoryLib|MdePkg/Library/BaseMemoryLibOptDxe/BaseMemoryLibOptDxe.inf
+
+  # Networking Requirements
+  NetLib|MdeModulePkg/Library/DxeNetLib/DxeNetLib.inf
+  DpcLib|MdeModulePkg/Library/DxeDpcLib/DxeDpcLib.inf
+  UdpIoLib|MdeModulePkg/Library/DxeUdpIoLib/DxeUdpIoLib.inf
+  IpIoLib|MdeModulePkg/Library/DxeIpIoLib/DxeIpIoLib.inf
+
+  #
+  # It is not possible to prevent the ARM compiler from inserting calls to intrinsic functions.
+  # This library provides the instrinsic functions such a compiler may generate calls to.
+  #
+  NULL|ArmPkg/Library/CompilerIntrinsicsLib/CompilerIntrinsicsLib.inf
+
+  # Add support for GCC stack protector
+  NULL|MdePkg/Library/BaseStackCheckLib/BaseStackCheckLib.inf
+
+  # ARM Architectural Libraries
+  CacheMaintenanceLib|ArmPkg/Library/ArmCacheMaintenanceLib/ArmCacheMaintenanceLib.inf
+  DefaultExceptionHandlerLib|ArmPkg/Library/DefaultExceptionHandlerLib/DefaultExceptionHandlerLib.inf
+  CpuExceptionHandlerLib|ArmPkg/Library/ArmExceptionLib/ArmExceptionLib.inf
+  ArmDisassemblerLib|ArmPkg/Library/ArmDisassemblerLib/ArmDisassemblerLib.inf
+  DmaLib|EmbeddedPkg/Library/NonCoherentDmaLib/NonCoherentDmaLib.inf
+  TimeBaseLib|EmbeddedPkg/Library/TimeBaseLib/TimeBaseLib.inf
+  ArmPlatformStackLib|ArmPlatformPkg/Library/ArmPlatformStackLib/ArmPlatformStackLib.inf
+  ArmSmcLib|ArmPkg/Library/ArmSmcLib/ArmSmcLib.inf
+  ArmHvcLib|ArmPkg/Library/ArmHvcLib/ArmHvcLib.inf
+  ArmGenericTimerCounterLib|ArmPkg/Library/ArmGenericTimerPhyCounterLib/ArmGenericTimerPhyCounterLib.inf
+
+  PciCf8Lib|MdePkg/Library/BasePciCf8Lib/BasePciCf8Lib.inf
+  PciLib|MdePkg/Library/BasePciLibCf8/BasePciLibCf8.inf
+  PlatformHookLib|MdeModulePkg/Library/BasePlatformHookLibNull/BasePlatformHookLibNull.inf
+  SerialPortLib|MdeModulePkg/Library/BaseSerialPortLib16550/BaseSerialPortLib16550.inf
+
+  #
+  # Uncomment (and comment out the next line) For RealView Debugger. The Standard IO window
+  # in the debugger will show load and unload commands for symbols. You can cut and paste this
+  # into the command window to load symbols. We should be able to use a script to do this, but
+  # the version of RVD I have does not support scripts accessing system memory.
+  #
+  #PeCoffExtraActionLib|ArmPkg/Library/RvdPeCoffExtraActionLib/RvdPeCoffExtraActionLib.inf
+  PeCoffExtraActionLib|ArmPkg/Library/DebugPeCoffExtraActionLib/DebugPeCoffExtraActionLib.inf
+  #PeCoffExtraActionLib|MdePkg/Library/BasePeCoffExtraActionLibNull/BasePeCoffExtraActionLibNull.inf
+
+  DebugAgentLib|MdeModulePkg/Library/DebugAgentLibNull/DebugAgentLibNull.inf
+  DebugAgentTimerLib|EmbeddedPkg/Library/DebugAgentTimerLibNull/DebugAgentTimerLibNull.inf
+
+  # Flattened Device Tree (FDT) access library
+  FdtLib|EmbeddedPkg/Library/FdtLib/FdtLib.inf
+
+  # USB Libraries
+  UefiUsbLib|MdePkg/Library/UefiUsbLib/UefiUsbLib.inf
+
+  #
+  # Secure Boot dependencies
+  #
+!if $(SECURE_BOOT_ENABLE) == TRUE
+  IntrinsicLib|CryptoPkg/Library/IntrinsicLib/IntrinsicLib.inf
+  OpensslLib|CryptoPkg/Library/OpensslLib/OpensslLib.inf
+  TpmMeasurementLib|SecurityPkg/Library/DxeTpmMeasurementLib/DxeTpmMeasurementLib.inf
+  AuthVariableLib|SecurityPkg/Library/AuthVariableLib/AuthVariableLib.inf
+  BaseCryptLib|CryptoPkg/Library/BaseCryptLib/BaseCryptLib.inf
+
+  # re-use the UserPhysicalPresent() dummy implementation from the ovmf tree
+  PlatformSecureLib|OvmfPkg/Library/PlatformSecureLib/PlatformSecureLib.inf
+!else
+  TpmMeasurementLib|MdeModulePkg/Library/TpmMeasurementLibNull/TpmMeasurementLibNull.inf
+  AuthVariableLib|MdeModulePkg/Library/AuthVariableLibNull/AuthVariableLibNull.inf
+!endif
+  VarCheckLib|MdeModulePkg/Library/VarCheckLib/VarCheckLib.inf
+  GpioLib|Silicon/Broadcom/Bcm283x/Library/GpioLib/GpioLib.inf
+
+[LibraryClasses.common.SEC]
+  PcdLib|MdePkg/Library/BasePcdLibNull/BasePcdLibNull.inf
+  BaseMemoryLib|MdePkg/Library/BaseMemoryLib/BaseMemoryLib.inf
+  MemoryInitPeiLib|Platform/RaspberryPi/$(PLATFORM_NAME)/Library/MemoryInitPeiLib/MemoryInitPeiLib.inf
+  PlatformPeiLib|ArmPlatformPkg/PlatformPei/PlatformPeiLib.inf
+  ExtractGuidedSectionLib|EmbeddedPkg/Library/PrePiExtractGuidedSectionLib/PrePiExtractGuidedSectionLib.inf
+  LzmaDecompressLib|MdeModulePkg/Library/LzmaCustomDecompressLib/LzmaCustomDecompressLib.inf
+  PrePiLib|EmbeddedPkg/Library/PrePiLib/PrePiLib.inf
+  HobLib|EmbeddedPkg/Library/PrePiHobLib/PrePiHobLib.inf
+  PrePiHobListPointerLib|ArmPlatformPkg/Library/PrePiHobListPointerLib/PrePiHobListPointerLib.inf
+  MemoryAllocationLib|EmbeddedPkg/Library/PrePiMemoryAllocationLib/PrePiMemoryAllocationLib.inf
+
+[LibraryClasses.common.DXE_CORE]
+  HobLib|MdePkg/Library/DxeCoreHobLib/DxeCoreHobLib.inf
+  MemoryAllocationLib|MdeModulePkg/Library/DxeCoreMemoryAllocationLib/DxeCoreMemoryAllocationLib.inf
+  DxeCoreEntryPoint|MdePkg/Library/DxeCoreEntryPoint/DxeCoreEntryPoint.inf
+  ReportStatusCodeLib|IntelFrameworkModulePkg/Library/DxeReportStatusCodeLibFramework/DxeReportStatusCodeLib.inf
+  ExtractGuidedSectionLib|MdePkg/Library/DxeExtractGuidedSectionLib/DxeExtractGuidedSectionLib.inf
+  UefiDecompressLib|MdePkg/Library/BaseUefiDecompressLib/BaseUefiDecompressLib.inf
+  PerformanceLib|MdeModulePkg/Library/DxeCorePerformanceLib/DxeCorePerformanceLib.inf
+
+[LibraryClasses.common.DXE_DRIVER]
+  ReportStatusCodeLib|IntelFrameworkModulePkg/Library/DxeReportStatusCodeLibFramework/DxeReportStatusCodeLib.inf
+  SecurityManagementLib|MdeModulePkg/Library/DxeSecurityManagementLib/DxeSecurityManagementLib.inf
+  PerformanceLib|MdeModulePkg/Library/DxePerformanceLib/DxePerformanceLib.inf
+  MemoryAllocationLib|MdePkg/Library/UefiMemoryAllocationLib/UefiMemoryAllocationLib.inf
+
+[LibraryClasses.common.UEFI_APPLICATION]
+  UefiDecompressLib|IntelFrameworkModulePkg/Library/BaseUefiTianoCustomDecompressLib/BaseUefiTianoCustomDecompressLib.inf
+  PerformanceLib|MdeModulePkg/Library/DxePerformanceLib/DxePerformanceLib.inf
+  MemoryAllocationLib|MdePkg/Library/UefiMemoryAllocationLib/UefiMemoryAllocationLib.inf
+  HiiLib|MdeModulePkg/Library/UefiHiiLib/UefiHiiLib.inf
+  ShellLib|ShellPkg/Library/UefiShellLib/UefiShellLib.inf
+  FileHandleLib|MdePkg/Library/UefiFileHandleLib/UefiFileHandleLib.inf
+  ReportStatusCodeLib|MdeModulePkg/Library/DxeReportStatusCodeLib/DxeReportStatusCodeLib.inf
+
+[LibraryClasses.common.UEFI_DRIVER]
+  ReportStatusCodeLib|IntelFrameworkModulePkg/Library/DxeReportStatusCodeLibFramework/DxeReportStatusCodeLib.inf
+  UefiDecompressLib|IntelFrameworkModulePkg/Library/BaseUefiTianoCustomDecompressLib/BaseUefiTianoCustomDecompressLib.inf
+  ExtractGuidedSectionLib|MdePkg/Library/DxeExtractGuidedSectionLib/DxeExtractGuidedSectionLib.inf
+  PerformanceLib|MdeModulePkg/Library/DxePerformanceLib/DxePerformanceLib.inf
+  MemoryAllocationLib|MdePkg/Library/UefiMemoryAllocationLib/UefiMemoryAllocationLib.inf
+
+[LibraryClasses.common.DXE_RUNTIME_DRIVER]
+  MemoryAllocationLib|MdePkg/Library/UefiMemoryAllocationLib/UefiMemoryAllocationLib.inf
+  ReportStatusCodeLib|IntelFrameworkModulePkg/Library/DxeReportStatusCodeLibFramework/DxeReportStatusCodeLib.inf
+  CapsuleLib|MdeModulePkg/Library/DxeCapsuleLibNull/DxeCapsuleLibNull.inf
+  EfiResetSystemLib|Platform/RaspberryPi/$(PLATFORM_NAME)/Library/ResetLib/ResetLib.inf
+  ArmSmcLib|ArmPkg/Library/ArmSmcLib/ArmSmcLib.inf
+
+!if $(SECURE_BOOT_ENABLE) == TRUE
+  BaseCryptLib|CryptoPkg/Library/BaseCryptLib/RuntimeCryptLib.inf
+!endif
+
+###################################################################################################
+# BuildOptions Section - Define the module specific tool chain flags that should be used as
+#                        the default flags for a module. These flags are appended to any
+#                        standard flags that are defined by the build process.
+###################################################################################################
+
+[BuildOptions]
+  GCC:*_*_AARCH64_DLINK_FLAGS = -Wl,--fix-cortex-a53-843419
+  GCC:RELEASE_*_*_CC_FLAGS    = -DMDEPKG_NDEBUG -DNDEBUG
+
+[BuildOptions.common.EDKII.DXE_RUNTIME_DRIVER]
+  GCC:*_*_AARCH64_DLINK_FLAGS = -z common-page-size=0x10000
+
+################################################################################
+#
+# Pcd Section - list of all EDK II PCD Entries defined by this Platform
+#
+################################################################################
+
+[PcdsFeatureFlag.common]
+  # Use the Vector Table location in CpuDxe. We will not copy the Vector Table at PcdCpuVectorBaseAddress
+  gArmTokenSpaceGuid.PcdRelocateVectorTable|FALSE
+
+  gEmbeddedTokenSpaceGuid.PcdPrePiProduceMemoryTypeInformationHob|TRUE
+  gEfiMdeModulePkgTokenSpaceGuid.PcdTurnOffUsbLegacySupport|TRUE
+
+  ## If TRUE, Graphics Output Protocol will be installed on virtual handle created by ConsplitterDxe.
+  #  It could be set FALSE to save size.
+  gEfiMdeModulePkgTokenSpaceGuid.PcdConOutGopSupport|TRUE
+  gEfiMdeModulePkgTokenSpaceGuid.PcdConOutUgaSupport|FALSE
+
+[PcdsFixedAtBuild.common]
+  gEfiMdePkgTokenSpaceGuid.PcdMaximumUnicodeStringLength|1000000
+  gEfiMdePkgTokenSpaceGuid.PcdMaximumAsciiStringLength|1000000
+  gEfiMdePkgTokenSpaceGuid.PcdMaximumLinkedListLength|1000000
+  gEfiMdePkgTokenSpaceGuid.PcdSpinLockTimeout|10000000
+  gEfiMdePkgTokenSpaceGuid.PcdDebugClearMemoryValue|0xAF
+  gEfiMdePkgTokenSpaceGuid.PcdPerformanceLibraryPropertyMask|1
+  gEfiMdePkgTokenSpaceGuid.PcdPostCodePropertyMask|0
+  gEfiMdePkgTokenSpaceGuid.PcdUefiLibMaxPrintBufferSize|320
+
+  # DEBUG_ASSERT_ENABLED       0x01
+  # DEBUG_PRINT_ENABLED        0x02
+  # DEBUG_CODE_ENABLED         0x04
+  # CLEAR_MEMORY_ENABLED       0x08
+  # ASSERT_BREAKPOINT_ENABLED  0x10
+  # ASSERT_DEADLOOP_ENABLED    0x20
+!if $(TARGET) == RELEASE
+  gEfiMdePkgTokenSpaceGuid.PcdDebugPropertyMask|0x21
+!else
+  gEfiMdePkgTokenSpaceGuid.PcdDebugPropertyMask|0x2f
+!endif
+
+  #  DEBUG_INIT      0x00000001  // Initialization
+  #  DEBUG_WARN      0x00000002  // Warnings
+  #  DEBUG_LOAD      0x00000004  // Load events
+  #  DEBUG_FS        0x00000008  // EFI File system
+  #  DEBUG_POOL      0x00000010  // Alloc & Free (pool)
+  #  DEBUG_PAGE      0x00000020  // Alloc & Free (page)
+  #  DEBUG_INFO      0x00000040  // Informational debug messages
+  #  DEBUG_DISPATCH  0x00000080  // PEI/DXE/SMM Dispatchers
+  #  DEBUG_VARIABLE  0x00000100  // Variable
+  #  DEBUG_BM        0x00000400  // Boot Manager
+  #  DEBUG_BLKIO     0x00001000  // BlkIo Driver
+  #  DEBUG_NET       0x00004000  // SNP Driver
+  #  DEBUG_UNDI      0x00010000  // UNDI Driver
+  #  DEBUG_LOADFILE  0x00020000  // LoadFile
+  #  DEBUG_EVENT     0x00080000  // Event messages
+  #  DEBUG_GCD       0x00100000  // Global Coherency Database changes
+  #  DEBUG_CACHE     0x00200000  // Memory range cachability changes
+  #  DEBUG_VERBOSE   0x00400000  // Detailed debug messages that may
+  #                              // significantly impact boot performance
+  #  DEBUG_ERROR     0x80000000  // Error
+  gEfiMdePkgTokenSpaceGuid.PcdDebugPrintErrorLevel|$(DEBUG_PRINT_ERROR_LEVEL)
+
+  gEfiMdePkgTokenSpaceGuid.PcdReportStatusCodePropertyMask|0x07
+
+  #
+  # Optional feature to help prevent EFI memory map fragments
+  # Turned on and off via: PcdPrePiProduceMemoryTypeInformationHob
+  # Values are in EFI Pages (4K). DXE Core will make sure that
+  # at least this much of each type of memory can be allocated
+  # from a single memory range. This way you only end up with
+  # maximum of two fragments for each type in the memory map
+  # (the memory used, and the free memory that was prereserved
+  # but not used).
+  #
+  gEmbeddedTokenSpaceGuid.PcdMemoryTypeEfiACPIReclaimMemory|0
+  gEmbeddedTokenSpaceGuid.PcdMemoryTypeEfiACPIMemoryNVS|0
+  gEmbeddedTokenSpaceGuid.PcdMemoryTypeEfiReservedMemoryType|0
+!if $(SECURE_BOOT_ENABLE) == TRUE
+  gEmbeddedTokenSpaceGuid.PcdMemoryTypeEfiRuntimeServicesData|600
+  gEmbeddedTokenSpaceGuid.PcdMemoryTypeEfiRuntimeServicesCode|400
+  gEmbeddedTokenSpaceGuid.PcdMemoryTypeEfiBootServicesCode|1500
+!else
+  gEmbeddedTokenSpaceGuid.PcdMemoryTypeEfiRuntimeServicesData|300
+  gEmbeddedTokenSpaceGuid.PcdMemoryTypeEfiRuntimeServicesCode|150
+  gEmbeddedTokenSpaceGuid.PcdMemoryTypeEfiBootServicesCode|1000
+!endif
+  gEmbeddedTokenSpaceGuid.PcdMemoryTypeEfiBootServicesData|12000
+  gEmbeddedTokenSpaceGuid.PcdMemoryTypeEfiLoaderCode|20
+  gEmbeddedTokenSpaceGuid.PcdMemoryTypeEfiLoaderData|0
+
+  gEmbeddedTokenSpaceGuid.PcdDmaDeviceOffset|0xc0000000
+
+  gEfiMdeModulePkgTokenSpaceGuid.PcdFirmwareVersionString|L"edk2-1.0"
+
+!if $(SECURE_BOOT_ENABLE) == TRUE
+  # override the default values from SecurityPkg to ensure images from all sources are verified in secure boot
+  gEfiSecurityPkgTokenSpaceGuid.PcdOptionRomImageVerificationPolicy|0x04
+  gEfiSecurityPkgTokenSpaceGuid.PcdFixedMediaImageVerificationPolicy|0x04
+  gEfiSecurityPkgTokenSpaceGuid.PcdRemovableMediaImageVerificationPolicy|0x04
+!endif
+
+  gEmbeddedTokenSpaceGuid.PcdInterruptBaseAddress|0x40000000
+  gArmTokenSpaceGuid.PcdArmArchTimerSecIntrNum|0x0
+  gArmTokenSpaceGuid.PcdArmArchTimerIntrNum|0x1
+  gArmTokenSpaceGuid.PcdArmArchTimerVirtIntrNum|0x2
+  gArmTokenSpaceGuid.PcdArmArchTimerHypIntrNum|0x3
+
+[LibraryClasses.common]
+  ArmLib|ArmPkg/Library/ArmLib/ArmBaseLib.inf
+  ArmMmuLib|ArmPkg/Library/ArmMmuLib/ArmMmuBaseLib.inf
+  ArmPlatformLib|Platform/RaspberryPi/$(PLATFORM_NAME)/Library/PlatformLib/PlatformLib.inf
+  TimerLib|ArmPkg/Library/ArmArchTimerLib/ArmArchTimerLib.inf
+  CapsuleLib|MdeModulePkg/Library/DxeCapsuleLibNull/DxeCapsuleLibNull.inf
+  UefiBootManagerLib|MdeModulePkg/Library/UefiBootManagerLib/UefiBootManagerLib.inf
+  BootLogoLib|MdeModulePkg/Library/BootLogoLib/BootLogoLib.inf
+  PlatformBootManagerLib|Platform/RaspberryPi/$(PLATFORM_NAME)/Library/PlatformBootManagerLib/PlatformBootManagerLib.inf
+  CustomizedDisplayLib|MdeModulePkg/Library/CustomizedDisplayLib/CustomizedDisplayLib.inf
+  FileExplorerLib|MdeModulePkg/Library/FileExplorerLib/FileExplorerLib.inf
+
+[LibraryClasses.common.UEFI_DRIVER]
+  UefiScsiLib|MdePkg/Library/UefiScsiLib/UefiScsiLib.inf
+
+################################################################################
+#
+# Pcd Section - list of all EDK II PCD Entries defined by this Platform
+#
+################################################################################
+
+[PcdsFeatureFlag.common]
+  gEfiMdeModulePkgTokenSpaceGuid.PcdConOutGopSupport|TRUE
+  gEfiMdeModulePkgTokenSpaceGuid.PcdConOutUgaSupport|FALSE
+  gEfiMdeModulePkgTokenSpaceGuid.PcdInstallAcpiSdtProtocol|TRUE
+
+[PcdsFixedAtBuild.common]
+  gArmPlatformTokenSpaceGuid.PcdCoreCount|4
+  gArmTokenSpaceGuid.PcdVFPEnabled|1
+
+  gArmPlatformTokenSpaceGuid.PcdCPUCorePrimaryStackSize|0x4000
+  gEfiMdeModulePkgTokenSpaceGuid.PcdMaxVariableSize|0x2000
+  gEfiMdeModulePkgTokenSpaceGuid.PcdMaxAuthVariableSize|0x2800
+
+  # Size of the region used by UEFI in permanent memory (Reserved 64MB)
+  gArmPlatformTokenSpaceGuid.PcdSystemMemoryUefiRegionSize|0x04000000
+  #
+  # This matches PcdFvBaseAddress, since everything less is ATF, and
+  # will be reserved away.
+  #
+  gArmTokenSpaceGuid.PcdSystemMemoryBase|0x00400000
+  gArmTokenSpaceGuid.PcdSystemMemorySize|0x3FC00000
+
+  ## NS16550 compatible UART
+  gEfiMdeModulePkgTokenSpaceGuid.PcdSerialRegisterBase|0x3f215040
+  gEfiMdeModulePkgTokenSpaceGuid.PcdSerialUseMmio|TRUE
+  gEfiMdeModulePkgTokenSpaceGuid.PcdSerialRegisterStride|4
+  gEfiMdeModulePkgTokenSpaceGuid.PcdSerialClockRate|500000000
+  gEfiMdeModulePkgTokenSpaceGuid.PcdSerialFifoControl|0x27
+  gEfiMdeModulePkgTokenSpaceGuid.PcdSerialExtendedTxFifoSize|8
+  gEfiMdePkgTokenSpaceGuid.PcdUartDefaultBaudRate|115200
+
+  ## Default Terminal Type
+  ## 0-PCANSI, 1-VT100, 2-VT00+, 3-UTF8, 4-TTYTERM
+  gEfiMdePkgTokenSpaceGuid.PcdDefaultTerminalType|4
+
+  gEfiMdeModulePkgTokenSpaceGuid.PcdResetOnMemoryTypeInformationChange|FALSE
+  gEfiMdeModulePkgTokenSpaceGuid.PcdBootManagerMenuFile|{ 0x21, 0xaa, 0x2c, 0x46, 0x14, 0x76, 0x03, 0x45, 0x83, 0x6e, 0x8a, 0xb6, 0xf4, 0x66, 0x23, 0x31 }
+  gEfiIntelFrameworkModulePkgTokenSpaceGuid.PcdShellFile|{ 0x83, 0xA5, 0x04, 0x7C, 0x3E, 0x9E, 0x1C, 0x4F, 0xAD, 0x65, 0xE0, 0x52, 0x68, 0xD0, 0xB4, 0xD1 }
+
+  gEfiMdeModulePkgTokenSpaceGuid.PcdFirmwareVendor|L"Raspberry Pi 3 64-bit UEFI"
+  gEfiMdeModulePkgTokenSpaceGuid.PcdSetNxForStack|TRUE
+
+[PcdsDynamicHii.common.DEFAULT]
+
+  #
+  # Clock overrides.
+  #
+
+  gRaspberryPiTokenSpaceGuid.PcdCpuClock|L"CpuClock"|gConfigDxeFormSetGuid|0x0|0
+
+  #
+  # SD-related.
+  #
+
+  gRaspberryPiTokenSpaceGuid.PcdSdIsArasan|L"SdIsArasan"|gConfigDxeFormSetGuid|0x0|0
+  gRaspberryPiTokenSpaceGuid.PcdMmcForce1Bit|L"MmcForce1Bit"|gConfigDxeFormSetGuid|0x0|0
+  gRaspberryPiTokenSpaceGuid.PcdMmcForceDefaultSpeed|L"MmcForceDefaultSpeed"|gConfigDxeFormSetGuid|0x0|0
+  gRaspberryPiTokenSpaceGuid.PcdMmcSdDefaultSpeedMHz|L"MmcSdDefaultSpeedMHz"|gConfigDxeFormSetGuid|0x0|25
+  gRaspberryPiTokenSpaceGuid.PcdMmcSdHighSpeedMHz|L"MmcSdHighSpeedMHz"|gConfigDxeFormSetGuid|0x0|50
+  gRaspberryPiTokenSpaceGuid.PcdMmcDisableMulti|L"MmcDisableMulti"|gConfigDxeFormSetGuid|0x0|0
+
+  #
+  # Debug-related.
+  #
+
+  gRaspberryPiTokenSpaceGuid.PcdDebugEnableJTAG|L"DebugEnableJTAG"|gConfigDxeFormSetGuid|0x0|0
+  gRaspberryPiTokenSpaceGuid.PcdDebugShowUEFIExit|L"DebugShowUEFIExit"|gConfigDxeFormSetGuid|0x0|0
+
+  #
+  # Display-related.
+  #
+  gRaspberryPiTokenSpaceGuid.PcdDisplayEnableVModes|L"DisplayEnableVModes"|gConfigDxeFormSetGuid|0x0|0
+  gRaspberryPiTokenSpaceGuid.PcdDisplayEnableSShot|L"DisplayEnableSShot"|gConfigDxeFormSetGuid|0x0|1
+
+  #
+  # Common UEFI ones.
+  #
+
+  gEfiMdePkgTokenSpaceGuid.PcdPlatformBootTimeOut|L"Timeout"|gEfiGlobalVariableGuid|0x0|5
+  #
+  # This is silly, but by pointing SetupConXXX and ConXXX PCDs to
+  # the same variables, I can use the graphical configuration to
+  # change the mode used by ConSplitter.
+  #
+  gEfiMdeModulePkgTokenSpaceGuid.PcdSetupConOutColumn|L"Columns"|gRaspberryPiTokenSpaceGuid|0x0|80
+  gEfiMdeModulePkgTokenSpaceGuid.PcdConOutColumn|L"Columns"|gRaspberryPiTokenSpaceGuid|0x0|80
+  gEfiMdeModulePkgTokenSpaceGuid.PcdSetupConOutRow|L"Rows"|gRaspberryPiTokenSpaceGuid|0x0|25
+  gEfiMdeModulePkgTokenSpaceGuid.PcdConOutRow|L"Rows"|gRaspberryPiTokenSpaceGuid|0x0|25
+
+[PcdsDynamicDefault.common]
+  #
+  # Set video resolution for boot options and for text setup.
+  #
+  gEfiMdeModulePkgTokenSpaceGuid.PcdVideoHorizontalResolution|0
+  gEfiMdeModulePkgTokenSpaceGuid.PcdVideoVerticalResolution|0
+  gEfiMdeModulePkgTokenSpaceGuid.PcdSetupVideoHorizontalResolution|640
+  gEfiMdeModulePkgTokenSpaceGuid.PcdSetupVideoVerticalResolution|480
+  gEfiMdeModulePkgTokenSpaceGuid.PcdFlashNvStorageVariableBase64|0
+  gEfiMdeModulePkgTokenSpaceGuid.PcdFlashNvStorageFtwWorkingBase|0
+  gEfiMdeModulePkgTokenSpaceGuid.PcdFlashNvStorageFtwSpareBase|0
+
+################################################################################
+#
+# Components Section - list of all EDK II Modules needed by this Platform
+#
+################################################################################
+[Components.common]
+  #
+  # PEI Phase modules
+  #
+  ArmPlatformPkg/PrePi/PeiUniCore.inf
+
+  #
+  # DXE
+  #
+  MdeModulePkg/Core/Dxe/DxeMain.inf {
+    <LibraryClasses>
+      NULL|MdeModulePkg/Library/DxeCrc32GuidedSectionExtractLib/DxeCrc32GuidedSectionExtractLib.inf
+  }
+  MdeModulePkg/Universal/PCD/Dxe/Pcd.inf {
+    <LibraryClasses>
+      PcdLib|MdePkg/Library/BasePcdLibNull/BasePcdLibNull.inf
+  }
+
+  #
+  # Architectural Protocols
+  #
+  ArmPkg/Drivers/CpuDxe/CpuDxe.inf
+  MdeModulePkg/Core/RuntimeDxe/RuntimeDxe.inf
+  Platform/RaspberryPi/$(PLATFORM_NAME)/Drivers/VarBlockServiceDxe/VarBlockServiceDxe.inf
+  MdeModulePkg/Universal/FaultTolerantWriteDxe/FaultTolerantWriteDxe.inf
+  MdeModulePkg/Universal/Variable/RuntimeDxe/VariableRuntimeDxe.inf {
+    <LibraryClasses>
+      NULL|MdeModulePkg/Library/VarCheckUefiLib/VarCheckUefiLib.inf
+      DebugLib|MdePkg/Library/BaseDebugLibNull/BaseDebugLibNull.inf
+  }
+!if $(SECURE_BOOT_ENABLE) == TRUE
+  MdeModulePkg/Universal/SecurityStubDxe/SecurityStubDxe.inf {
+    <LibraryClasses>
+      NULL|SecurityPkg/Library/DxeImageVerificationLib/DxeImageVerificationLib.inf
+  }
+  SecurityPkg/VariableAuthenticated/SecureBootConfigDxe/SecureBootConfigDxe.inf
+!else
+  MdeModulePkg/Universal/SecurityStubDxe/SecurityStubDxe.inf
+!endif
+  MdeModulePkg/Universal/CapsuleRuntimeDxe/CapsuleRuntimeDxe.inf
+  MdeModulePkg/Universal/MonotonicCounterRuntimeDxe/MonotonicCounterRuntimeDxe.inf
+  EmbeddedPkg/ResetRuntimeDxe/ResetRuntimeDxe.inf
+  EmbeddedPkg/RealTimeClockRuntimeDxe/RealTimeClockRuntimeDxe.inf {
+    <LibraryClasses>
+      RealTimeClockLib|EmbeddedPkg/Library/VirtualRealTimeClockLib/VirtualRealTimeClockLib.inf
+  }
+  EmbeddedPkg/MetronomeDxe/MetronomeDxe.inf
+
+  MdeModulePkg/Universal/Console/ConPlatformDxe/ConPlatformDxe.inf
+  MdeModulePkg/Universal/Console/ConSplitterDxe/ConSplitterDxe.inf
+  Platform/RaspberryPi/$(PLATFORM_NAME)/Drivers/GraphicsConsoleDxe/GraphicsConsoleDxe.inf
+  MdeModulePkg/Universal/Console/TerminalDxe/TerminalDxe.inf
+  MdeModulePkg/Universal/SerialDxe/SerialDxe.inf
+  Platform/RaspberryPi/$(PLATFORM_NAME)/Drivers/DisplayDxe/DisplayDxe.inf
+
+  MdeModulePkg/Universal/HiiDatabaseDxe/HiiDatabaseDxe.inf
+
+  UefiCpuPkg/CpuIo2Dxe/CpuIo2Dxe.inf
+  Silicon/Broadcom/Bcm283x/Drivers/InterruptDxe/InterruptDxe.inf
+  Platform/RaspberryPi/$(PLATFORM_NAME)/Drivers/RpiFirmwareDxe/RpiFirmwareDxe.inf
+  Platform/RaspberryPi/$(PLATFORM_NAME)/Drivers/FdtDxe/FdtDxe.inf
+  Platform/RaspberryPi/$(PLATFORM_NAME)/Drivers/ConfigDxe/ConfigDxe.inf
+  ArmPkg/Drivers/TimerDxe/TimerDxe.inf
+  MdeModulePkg/Universal/WatchdogTimerDxe/WatchdogTimer.inf
+  MdeModulePkg/Universal/EbcDxe/EbcDxe.inf
+
+  #
+  # FAT filesystem + GPT/MBR partitioning
+  #
+  MdeModulePkg/Universal/Disk/DiskIoDxe/DiskIoDxe.inf
+  MdeModulePkg/Universal/Disk/PartitionDxe/PartitionDxe.inf
+  MdeModulePkg/Universal/Disk/UnicodeCollation/EnglishDxe/EnglishDxe.inf
+  FatPkg/EnhancedFatDxe/Fat.inf
+
+  #
+  # ACPI Support
+  #
+  MdeModulePkg/Universal/Acpi/AcpiTableDxe/AcpiTableDxe.inf
+  MdeModulePkg/Universal/Acpi/AcpiPlatformDxe/AcpiPlatformDxe.inf
+  MdeModulePkg/Universal/Acpi/BootGraphicsResourceTableDxe/BootGraphicsResourceTableDxe.inf
+  Platform/RaspberryPi/$(PLATFORM_NAME)/AcpiTables/AcpiTables.inf
+
+  #
+  # SMBIOS Support
+  #
+  Platform/RaspberryPi/$(PLATFORM_NAME)/Drivers/PlatformSmbiosDxe/PlatformSmbiosDxe.inf
+  MdeModulePkg/Universal/SmbiosDxe/SmbiosDxe.inf
+
+  #
+  # Bds
+  #
+  MdeModulePkg/Universal/DevicePathDxe/DevicePathDxe.inf
+  MdeModulePkg/Universal/DisplayEngineDxe/DisplayEngineDxe.inf
+  MdeModulePkg/Universal/SetupBrowserDxe/SetupBrowserDxe.inf
+  MdeModulePkg/Universal/DriverHealthManagerDxe/DriverHealthManagerDxe.inf
+  MdeModulePkg/Universal/BdsDxe/BdsDxe.inf
+  Platform/RaspberryPi/$(PLATFORM_NAME)/Drivers/LogoDxe/LogoDxe.inf
+  MdeModulePkg/Application/UiApp/UiApp.inf {
+    <LibraryClasses>
+      NULL|MdeModulePkg/Library/DeviceManagerUiLib/DeviceManagerUiLib.inf
+      NULL|MdeModulePkg/Library/BootManagerUiLib/BootManagerUiLib.inf
+      NULL|Platform/RaspberryPi/$(PLATFORM_NAME)/Library/PlatformUiAppLib/PlatformUiAppLib.inf
+      NULL|MdeModulePkg/Library/BootMaintenanceManagerUiLib/BootMaintenanceManagerUiLib.inf
+  }
+
+  #
+  # SCSI Bus and Disk Driver
+  #
+  MdeModulePkg/Bus/Scsi/ScsiBusDxe/ScsiBusDxe.inf
+  MdeModulePkg/Bus/Scsi/ScsiDiskDxe/ScsiDiskDxe.inf
+
+  #
+  # USB Support
+  #
+  Platform/RaspberryPi/$(PLATFORM_NAME)/Drivers/DwUsbHostDxe/DwUsbHostDxe.inf
+  MdeModulePkg/Bus/Usb/UsbBusDxe/UsbBusDxe.inf
+  MdeModulePkg/Bus/Usb/UsbKbDxe/UsbKbDxe.inf
+  MdeModulePkg/Bus/Usb/UsbMassStorageDxe/UsbMassStorageDxe.inf
+  OptionRomPkg/Bus/Usb/UsbNetworking/Ax88772b/Ax88772b.inf
+
+  #
+  # SD/MMC support
+  #
+  Platform/RaspberryPi/$(PLATFORM_NAME)/Drivers/SdHostDxe/SdHostDxe.inf
+  Platform/RaspberryPi/$(PLATFORM_NAME)/Drivers/ArasanMmcHostDxe/ArasanMmcHostDxe.inf
+  Platform/RaspberryPi/$(PLATFORM_NAME)/Drivers/MmcDxe/MmcDxe.inf
+
+  #
+  # Networking stack
+  #
+  MdeModulePkg/Universal/Network/DpcDxe/DpcDxe.inf
+  MdeModulePkg/Universal/Network/ArpDxe/ArpDxe.inf
+  MdeModulePkg/Universal/Network/Dhcp4Dxe/Dhcp4Dxe.inf
+  MdeModulePkg/Universal/Network/Ip4Dxe/Ip4Dxe.inf
+  MdeModulePkg/Universal/Network/MnpDxe/MnpDxe.inf
+  MdeModulePkg/Universal/Network/VlanConfigDxe/VlanConfigDxe.inf
+  MdeModulePkg/Universal/Network/Mtftp4Dxe/Mtftp4Dxe.inf
+  MdeModulePkg/Universal/Network/Udp4Dxe/Udp4Dxe.inf
+  NetworkPkg/UefiPxeBcDxe/UefiPxeBcDxe.inf
+  NetworkPkg/TcpDxe/TcpDxe.inf
+
+  #
+  # UEFI application (Shell Embedded Boot Loader)
+  #
+  ShellPkg/Application/Shell/Shell.inf {
+    <LibraryClasses>
+      ShellCommandLib|ShellPkg/Library/UefiShellCommandLib/UefiShellCommandLib.inf
+      NULL|ShellPkg/Library/UefiShellLevel2CommandsLib/UefiShellLevel2CommandsLib.inf
+      NULL|ShellPkg/Library/UefiShellLevel1CommandsLib/UefiShellLevel1CommandsLib.inf
+      NULL|ShellPkg/Library/UefiShellLevel3CommandsLib/UefiShellLevel3CommandsLib.inf
+      NULL|ShellPkg/Library/UefiShellDriver1CommandsLib/UefiShellDriver1CommandsLib.inf
+      NULL|ShellPkg/Library/UefiShellDebug1CommandsLib/UefiShellDebug1CommandsLib.inf
+      NULL|ShellPkg/Library/UefiShellInstall1CommandsLib/UefiShellInstall1CommandsLib.inf
+      NULL|ShellPkg/Library/UefiShellNetwork1CommandsLib/UefiShellNetwork1CommandsLib.inf
+      HandleParsingLib|ShellPkg/Library/UefiHandleParsingLib/UefiHandleParsingLib.inf
+      PrintLib|MdePkg/Library/BasePrintLib/BasePrintLib.inf
+      BcfgCommandLib|ShellPkg/Library/UefiShellBcfgCommandLib/UefiShellBcfgCommandLib.inf
+
+    <PcdsFixedAtBuild>
+      gEfiMdePkgTokenSpaceGuid.PcdDebugPropertyMask|0xFF
+      gEfiShellPkgTokenSpaceGuid.PcdShellLibAutoInitialize|FALSE
+      gEfiMdePkgTokenSpaceGuid.PcdUefiLibMaxPrintBufferSize|8000
+      gEfiShellPkgTokenSpaceGuid.PcdShellFileOperationSize|0x200000
+  }
diff --git a/Platform/RaspberryPi/RPi3/RPi3.fdf b/Platform/RaspberryPi/RPi3/RPi3.fdf
new file mode 100644
index 000000000000..7dcbdfbd31a6
--- /dev/null
+++ b/Platform/RaspberryPi/RPi3/RPi3.fdf
@@ -0,0 +1,449 @@
+## @file
+#
+#  Copyright (c) 2011-2015, ARM Limited. All rights reserved.
+#  Copyright (c) 2014, Linaro Limited. All rights reserved.
+#  Copyright (c) 2015 - 2016, Intel Corporation. All rights reserved.
+#  Copyright (c) 2017 - 2018, Andrei Warkentin <andrey.warkentin@gmail.com>
+#
+#  This program and the accompanying materials are licensed and made available
+#  under the terms and conditions of the BSD License which accompanies this
+#  distribution. The full text of the license may be found at
+#  http://opensource.org/licenses/bsd-license.php
+#
+#  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+#  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR
+#  IMPLIED.
+#
+##
+
+################################################################################
+#
+# FD Section
+# The [FD] Section is made up of the definition statements and a
+# description of what goes into  the Flash Device Image.  Each FD section
+# defines one flash "device" image.  A flash device image may be one of
+# the following: Removable media bootable image (like a boot floppy
+# image,) an Option ROM image (that would be "flashed" into an add-in
+# card,) a System "Flash"  image (that would be burned into a system's
+# flash) or an Update ("Capsule") image that will be used to update and
+# existing system flash.
+#
+################################################################################
+
+[FD.RPI_EFI]
+BaseAddress   = 0x00000000|gArmTokenSpaceGuid.PcdFdBaseAddress
+Size          = 0x00200000|gArmTokenSpaceGuid.PcdFdSize
+ErasePolarity = 1
+
+BlockSize     = 0x00001000|gRaspberryPiTokenSpaceGuid.PcdFirmwareBlockSize
+NumBlocks     = 0x200
+
+################################################################################
+#
+# Following are lists of FD Region layout which correspond to the locations of different
+# images within the flash device.
+#
+# Regions must be defined in ascending order and may not overlap.
+#
+# A Layout Region start with a eight digit hex offset (leading "0x" required) followed by
+# the pipe "|" character, followed by the size of the region, also in hex with the leading
+# "0x" characters. Like:
+# Offset|Size
+# PcdOffsetCName|PcdSizeCName
+# RegionType <FV, DATA, or FILE>
+#
+################################################################################
+
+#
+# ATF primary boot image
+#
+0x00000000|0x00010000
+FILE = Platform/RaspberryPi/$(PLATFORM_NAME)/TrustedFirmware/bl1.bin
+
+#
+# DTB.
+#
+0x00010000|0x00010000
+DATA = { 0x00 }
+
+#
+# ATF secondary boot image in FIP format (BL2 + BL31)
+#
+0x00020000|0x00010000
+FILE = Platform/RaspberryPi/$(PLATFORM_NAME)/TrustedFirmware/fip.bin
+
+#
+# UEFI image
+#
+0x00030000|0x001b0000
+gArmTokenSpaceGuid.PcdFvBaseAddress|gArmTokenSpaceGuid.PcdFvSize
+FV = FVMAIN_COMPACT
+
+#
+# Variables (0x20000 overall).
+#
+# 0x001e0000 - 0x001edfff EFI_FIRMWARE_VOLUME_HEADER
+# 0x001ee000 - 0x001eefff Event log
+# 0x001ef000 - 0x001effff EFI_FAULT_TOLERANT_WORKING_BLOCK_HEADER-
+# 0x001f0000 - 0x001fffff Data
+#
+
+# NV_VARIABLE_STORE
+0x001e0000|0x0000e000
+gRaspberryPiTokenSpaceGuid.PcdNvStorageVariableBase|gEfiMdeModulePkgTokenSpaceGuid.PcdFlashNvStorageVariableSize
+
+DATA = {
+  ## This is the EFI_FIRMWARE_VOLUME_HEADER
+  # ZeroVector []
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
+  # FileSystemGuid: gEfiSystemNvDataFvGuid         =
+  #   { 0xFFF12B8D, 0x7696, 0x4C8B,
+  #     { 0xA9, 0x85, 0x27, 0x47, 0x07, 0x5B, 0x4F, 0x50 }}
+  0x8D, 0x2B, 0xF1, 0xFF, 0x96, 0x76, 0x8B, 0x4C,
+  0xA9, 0x85, 0x27, 0x47, 0x07, 0x5B, 0x4F, 0x50,
+  # FvLength: 0x20000
+  0x00, 0x00, 0x02, 0x00, 0x00, 0x00, 0x00, 0x00,
+  # Signature "_FVH"       # Attributes
+  0x5f, 0x46, 0x56, 0x48, 0xff, 0xfe, 0x04, 0x00,
+  # HeaderLength
+  0x48, 0x00,
+  # CheckSum
+  0x19, 0xF9,
+  # ExtHeaderOffset #Reserved #Revision
+  0x00, 0x00, 0x00, 0x02,
+  # Blockmap[0]: 0x20 Blocks * 0x1000 Bytes / Block
+  0x20, 0x00, 0x00, 0x00, 0x00, 0x10, 0x00, 0x00,
+  # Blockmap[1]: End
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
+  ## This is the VARIABLE_STORE_HEADER
+  # It is compatible with SECURE_BOOT_ENABLE == FALSE as well.
+  # Signature: gEfiAuthenticatedVariableGuid =
+  #   { 0xaaf32c78, 0x947b, 0x439a,
+  #     { 0xa1, 0x80, 0x2e, 0x14, 0x4e, 0xc3, 0x77, 0x92 }}
+  0x78, 0x2c, 0xf3, 0xaa, 0x7b, 0x94, 0x9a, 0x43,
+  0xa1, 0x80, 0x2e, 0x14, 0x4e, 0xc3, 0x77, 0x92,
+  # Size: 0xe000 (gEfiMdeModulePkgTokenSpaceGuid.PcdFlashNvStorageVariableSize) -
+  #         0x48 (size of EFI_FIRMWARE_VOLUME_HEADER) = 0xdfb8
+  # This can speed up the Variable Dispatch a bit.
+  0xB8, 0xDF, 0x00, 0x00,
+  # FORMATTED: 0x5A #HEALTHY: 0xFE #Reserved: UINT16 #Reserved1: UINT32
+  0x5A, 0xFE, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00
+}
+
+# NV_EVENT_LOG
+0x001ee000|0x00001000
+gRaspberryPiTokenSpaceGuid.PcdNvStorageEventLogBase|gRaspberryPiTokenSpaceGuid.PcdNvStorageEventLogSize
+
+# NV_FTW_WORKING header
+0x001ef000|0x00001000
+gRaspberryPiTokenSpaceGuid.PcdNvStorageFtwWorkingBase|gEfiMdeModulePkgTokenSpaceGuid.PcdFlashNvStorageFtwWorkingSize
+
+DATA = {
+  # EFI_FAULT_TOLERANT_WORKING_BLOCK_HEADER->Signature = gEdkiiWorkingBlockSignatureGuid         =
+  #  { 0x9e58292b, 0x7c68, 0x497d, { 0xa0, 0xce, 0x65,  0x0, 0xfd, 0x9f, 0x1b, 0x95 }}
+  0x2b, 0x29, 0x58, 0x9e, 0x68, 0x7c, 0x7d, 0x49,
+  0xa0, 0xce, 0x65,  0x0, 0xfd, 0x9f, 0x1b, 0x95,
+  # Crc:UINT32            #WorkingBlockValid:1, WorkingBlockInvalid:1, Reserved
+  0x2c, 0xaf, 0x2c, 0x64, 0xFE, 0xFF, 0xFF, 0xFF,
+  # WriteQueueSize: UINT64
+  0xE0, 0x0F, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00
+}
+
+# NV_FTW_WORKING data
+0x001f0000|0x00010000
+gRaspberryPiTokenSpaceGuid.PcdNvStorageFtwSpareBase|gEfiMdeModulePkgTokenSpaceGuid.PcdFlashNvStorageFtwSpareSize
+
+################################################################################
+#
+# FV Section
+#
+# [FV] section is used to define what components or modules are placed within a flash
+# device file.  This section also defines order the components and modules are positioned
+# within the image.  The [FV] section consists of define statements, set statements and
+# module statements.
+#
+################################################################################
+
+[FV.FvMain]
+FvNameGuid         = 9a15aa37-d555-4a4e-b541-86391ff68164
+BlockSize          = 0x40
+NumBlocks          = 0         # This FV gets compressed so make it just big enough
+FvAlignment        = 16        # FV alignment and FV attributes setting.
+ERASE_POLARITY     = 1
+MEMORY_MAPPED      = TRUE
+STICKY_WRITE       = TRUE
+LOCK_CAP           = TRUE
+LOCK_STATUS        = TRUE
+WRITE_DISABLED_CAP = TRUE
+WRITE_ENABLED_CAP  = TRUE
+WRITE_STATUS       = TRUE
+WRITE_LOCK_CAP     = TRUE
+WRITE_LOCK_STATUS  = TRUE
+READ_DISABLED_CAP  = TRUE
+READ_ENABLED_CAP   = TRUE
+READ_STATUS        = TRUE
+READ_LOCK_CAP      = TRUE
+READ_LOCK_STATUS   = TRUE
+
+  INF MdeModulePkg/Core/Dxe/DxeMain.inf
+  INF MdeModulePkg/Universal/PCD/Dxe/Pcd.inf
+
+  #
+  # PI DXE Drivers producing Architectural Protocols (EFI Services)
+  #
+  INF ArmPkg/Drivers/CpuDxe/CpuDxe.inf
+  INF MdeModulePkg/Core/RuntimeDxe/RuntimeDxe.inf
+  INF MdeModulePkg/Universal/SecurityStubDxe/SecurityStubDxe.inf
+  INF MdeModulePkg/Universal/CapsuleRuntimeDxe/CapsuleRuntimeDxe.inf
+  INF Platform/RaspberryPi/$(PLATFORM_NAME)/Drivers/VarBlockServiceDxe/VarBlockServiceDxe.inf
+  INF MdeModulePkg/Universal/FaultTolerantWriteDxe/FaultTolerantWriteDxe.inf
+  INF MdeModulePkg/Universal/Variable/RuntimeDxe/VariableRuntimeDxe.inf
+!if $(SECURE_BOOT_ENABLE) == TRUE
+  INF SecurityPkg/VariableAuthenticated/SecureBootConfigDxe/SecureBootConfigDxe.inf
+!endif
+  INF MdeModulePkg/Universal/MonotonicCounterRuntimeDxe/MonotonicCounterRuntimeDxe.inf
+  INF EmbeddedPkg/ResetRuntimeDxe/ResetRuntimeDxe.inf
+  INF EmbeddedPkg/RealTimeClockRuntimeDxe/RealTimeClockRuntimeDxe.inf
+  INF EmbeddedPkg/MetronomeDxe/MetronomeDxe.inf
+  INF MdeModulePkg/Universal/HiiDatabaseDxe/HiiDatabaseDxe.inf
+
+  #
+  # Multiple Console IO support
+  #
+  INF MdeModulePkg/Universal/Console/ConPlatformDxe/ConPlatformDxe.inf
+  INF MdeModulePkg/Universal/Console/ConSplitterDxe/ConSplitterDxe.inf
+  INF Platform/RaspberryPi/$(PLATFORM_NAME)/Drivers/GraphicsConsoleDxe/GraphicsConsoleDxe.inf
+  INF MdeModulePkg/Universal/Console/TerminalDxe/TerminalDxe.inf
+  INF MdeModulePkg/Universal/SerialDxe/SerialDxe.inf
+  INF Platform/RaspberryPi/$(PLATFORM_NAME)/Drivers/DisplayDxe/DisplayDxe.inf
+
+  INF UefiCpuPkg/CpuIo2Dxe/CpuIo2Dxe.inf
+  INF Silicon/Broadcom/Bcm283x/Drivers/InterruptDxe/InterruptDxe.inf
+  INF Platform/RaspberryPi/$(PLATFORM_NAME)/Drivers/RpiFirmwareDxe/RpiFirmwareDxe.inf
+  INF Platform/RaspberryPi/$(PLATFORM_NAME)/Drivers/FdtDxe/FdtDxe.inf
+  INF Platform/RaspberryPi/$(PLATFORM_NAME)/Drivers/ConfigDxe/ConfigDxe.inf
+  INF ArmPkg/Drivers/TimerDxe/TimerDxe.inf
+  INF MdeModulePkg/Universal/WatchdogTimerDxe/WatchdogTimer.inf
+  INF MdeModulePkg/Universal/EbcDxe/EbcDxe.inf
+
+  #
+  # FAT filesystem + GPT/MBR partitioning
+  #
+  INF MdeModulePkg/Universal/Disk/DiskIoDxe/DiskIoDxe.inf
+  INF MdeModulePkg/Universal/Disk/PartitionDxe/PartitionDxe.inf
+  INF FatPkg/EnhancedFatDxe/Fat.inf
+  INF MdeModulePkg/Universal/Disk/UnicodeCollation/EnglishDxe/EnglishDxe.inf
+
+  #
+  # UEFI application (Shell Embedded Boot Loader)
+  #
+  INF ShellPkg/Application/Shell/Shell.inf
+
+  #
+  # ACPI Support
+  #
+  INF MdeModulePkg/Universal/Acpi/AcpiTableDxe/AcpiTableDxe.inf
+  INF MdeModulePkg/Universal/Acpi/AcpiPlatformDxe/AcpiPlatformDxe.inf
+  INF MdeModulePkg/Universal/Acpi/BootGraphicsResourceTableDxe/BootGraphicsResourceTableDxe.inf
+  INF RuleOverride = ACPITABLE Platform/RaspberryPi/$(PLATFORM_NAME)/AcpiTables/AcpiTables.inf
+
+  #
+  # SMBIOS Support
+  #
+  INF Platform/RaspberryPi/$(PLATFORM_NAME)/Drivers/PlatformSmbiosDxe/PlatformSmbiosDxe.inf
+  INF MdeModulePkg/Universal/SmbiosDxe/SmbiosDxe.inf
+
+  #
+  # Bds
+  #
+  INF MdeModulePkg/Universal/DevicePathDxe/DevicePathDxe.inf
+  INF MdeModulePkg/Universal/DisplayEngineDxe/DisplayEngineDxe.inf
+  INF MdeModulePkg/Universal/SetupBrowserDxe/SetupBrowserDxe.inf
+  INF MdeModulePkg/Universal/DriverHealthManagerDxe/DriverHealthManagerDxe.inf
+  INF MdeModulePkg/Universal/BdsDxe/BdsDxe.inf
+  INF MdeModulePkg/Application/UiApp/UiApp.inf
+
+  #
+  # Networking stack
+  #
+  INF MdeModulePkg/Universal/Network/DpcDxe/DpcDxe.inf
+  INF MdeModulePkg/Universal/Network/ArpDxe/ArpDxe.inf
+  INF MdeModulePkg/Universal/Network/Dhcp4Dxe/Dhcp4Dxe.inf
+  INF MdeModulePkg/Universal/Network/Ip4Dxe/Ip4Dxe.inf
+  INF MdeModulePkg/Universal/Network/MnpDxe/MnpDxe.inf
+  INF MdeModulePkg/Universal/Network/VlanConfigDxe/VlanConfigDxe.inf
+  INF MdeModulePkg/Universal/Network/Mtftp4Dxe/Mtftp4Dxe.inf
+  INF MdeModulePkg/Universal/Network/Udp4Dxe/Udp4Dxe.inf
+  INF NetworkPkg/UefiPxeBcDxe/UefiPxeBcDxe.inf
+  INF NetworkPkg/TcpDxe/TcpDxe.inf
+
+  #
+  # SCSI Bus and Disk Driver
+  #
+  INF MdeModulePkg/Bus/Scsi/ScsiBusDxe/ScsiBusDxe.inf
+  INF MdeModulePkg/Bus/Scsi/ScsiDiskDxe/ScsiDiskDxe.inf
+
+  #
+  # USB Support
+  #
+  INF Platform/RaspberryPi/$(PLATFORM_NAME)/Drivers/DwUsbHostDxe/DwUsbHostDxe.inf
+  INF MdeModulePkg/Bus/Usb/UsbBusDxe/UsbBusDxe.inf
+  INF MdeModulePkg/Bus/Usb/UsbKbDxe/UsbKbDxe.inf
+  INF MdeModulePkg/Bus/Usb/UsbMassStorageDxe/UsbMassStorageDxe.inf
+  INF OptionRomPkg/Bus/Usb/UsbNetworking/Ax88772b/Ax88772b.inf
+
+  #
+  # SD/MMC support
+  #
+  INF Platform/RaspberryPi/$(PLATFORM_NAME)/Drivers/SdHostDxe/SdHostDxe.inf
+  INF Platform/RaspberryPi/$(PLATFORM_NAME)/Drivers/ArasanMmcHostDxe/ArasanMmcHostDxe.inf
+  INF Platform/RaspberryPi/$(PLATFORM_NAME)/Drivers/MmcDxe/MmcDxe.inf
+
+  #
+  # Pi logo (splash screen)
+  #
+  INF Platform/RaspberryPi/$(PLATFORM_NAME)/Drivers/LogoDxe/LogoDxe.inf
+
+  #
+  # FDT (GUID matches mRaspberryPiFfsFileGuid in RaspberryPiPlatformDxe)
+  #
+  FILE FREEFORM = DF5DA223-1D27-47C3-8D1B-9A41B55A18BC {
+    SECTION RAW = Platform/RaspberryPi/$(PLATFORM_NAME)/DeviceTree/bcm2710-rpi-3-b.dtb
+  }
+
+[FV.FVMAIN_COMPACT]
+FvAlignment        = 16
+ERASE_POLARITY     = 1
+MEMORY_MAPPED      = TRUE
+STICKY_WRITE       = TRUE
+LOCK_CAP           = TRUE
+LOCK_STATUS        = TRUE
+WRITE_DISABLED_CAP = TRUE
+WRITE_ENABLED_CAP  = TRUE
+WRITE_STATUS       = TRUE
+WRITE_LOCK_CAP     = TRUE
+WRITE_LOCK_STATUS  = TRUE
+READ_DISABLED_CAP  = TRUE
+READ_ENABLED_CAP   = TRUE
+READ_STATUS        = TRUE
+READ_LOCK_CAP      = TRUE
+READ_LOCK_STATUS   = TRUE
+
+  INF ArmPlatformPkg/PrePi/PeiUniCore.inf
+  FILE FV_IMAGE = 9E21FD93-9C72-4c15-8C4B-E77F1DB2D792 {
+    SECTION GUIDED EE4E5898-3914-4259-9D6E-DC7BD79403CF PROCESSING_REQUIRED = TRUE {
+      SECTION FV_IMAGE = FVMAIN
+    }
+  }
+
+################################################################################
+#
+# Rules are use with the [FV] section's module INF type to define
+# how an FFS file is created for a given INF file. The following Rule are the default
+# rules for the different module type. User can add the customized rules to define the
+# content of the FFS file.
+#
+################################################################################
+
+
+############################################################################
+# Example of a DXE_DRIVER FFS file with a Checksum encapsulation section   #
+############################################################################
+#
+#[Rule.Common.DXE_DRIVER]
+#  FILE DRIVER = $(NAMED_GUID) {
+#    DXE_DEPEX    DXE_DEPEX               Optional $(INF_OUTPUT)/$(MODULE_NAME).depex
+#    COMPRESS PI_STD {
+#      GUIDED {
+#        PE32     PE32                    $(INF_OUTPUT)/$(MODULE_NAME).efi
+#        UI       STRING="$(MODULE_NAME)" Optional
+#        VERSION  STRING="$(INF_VERSION)" Optional BUILD_NUM=$(BUILD_NUMBER)
+#      }
+#    }
+#  }
+#
+############################################################################
+
+[Rule.Common.SEC]
+  FILE SEC = $(NAMED_GUID) RELOCS_STRIPPED FIXED {
+    TE  TE Align = Auto                 $(INF_OUTPUT)/$(MODULE_NAME).efi
+  }
+
+[Rule.Common.PEI_CORE]
+  FILE PEI_CORE = $(NAMED_GUID) FIXED {
+    TE     TE Align = Auto              $(INF_OUTPUT)/$(MODULE_NAME).efi
+    UI     STRING ="$(MODULE_NAME)" Optional
+  }
+
+[Rule.Common.PEIM]
+  FILE PEIM = $(NAMED_GUID) FIXED {
+     PEI_DEPEX PEI_DEPEX Optional       $(INF_OUTPUT)/$(MODULE_NAME).depex
+     TE       TE Align = Auto           $(INF_OUTPUT)/$(MODULE_NAME).efi
+     UI       STRING="$(MODULE_NAME)" Optional
+  }
+
+[Rule.Common.PEIM.TIANOCOMPRESSED]
+  FILE PEIM = $(NAMED_GUID) DEBUG_MYTOOLS_IA32 {
+    PEI_DEPEX PEI_DEPEX Optional        $(INF_OUTPUT)/$(MODULE_NAME).depex
+    GUIDED A31280AD-481E-41B6-95E8-127F4C984779 PROCESSING_REQUIRED = TRUE {
+      PE32      PE32                    $(INF_OUTPUT)/$(MODULE_NAME).efi
+      UI        STRING="$(MODULE_NAME)" Optional
+    }
+  }
+
+[Rule.Common.DXE_CORE]
+  FILE DXE_CORE = $(NAMED_GUID) {
+    PE32     PE32                       $(INF_OUTPUT)/$(MODULE_NAME).efi
+    UI       STRING="$(MODULE_NAME)" Optional
+  }
+
+[Rule.Common.UEFI_DRIVER]
+  FILE DRIVER = $(NAMED_GUID) {
+    DXE_DEPEX    DXE_DEPEX              Optional $(INF_OUTPUT)/$(MODULE_NAME).depex
+    PE32         PE32                   $(INF_OUTPUT)/$(MODULE_NAME).efi
+    UI           STRING="$(MODULE_NAME)" Optional
+  }
+
+[Rule.Common.DXE_DRIVER]
+  FILE DRIVER = $(NAMED_GUID) {
+    DXE_DEPEX    DXE_DEPEX              Optional $(INF_OUTPUT)/$(MODULE_NAME).depex
+    PE32         PE32                   $(INF_OUTPUT)/$(MODULE_NAME).efi
+    UI           STRING="$(MODULE_NAME)" Optional
+    RAW          ACPI  Optional               |.acpi
+    RAW          ASL   Optional               |.aml
+  }
+
+[Rule.Common.DXE_RUNTIME_DRIVER]
+  FILE DRIVER = $(NAMED_GUID) {
+    DXE_DEPEX    DXE_DEPEX              Optional $(INF_OUTPUT)/$(MODULE_NAME).depex
+    PE32         PE32                   $(INF_OUTPUT)/$(MODULE_NAME).efi
+    UI           STRING="$(MODULE_NAME)" Optional
+  }
+
+[Rule.Common.UEFI_APPLICATION]
+  FILE APPLICATION = $(NAMED_GUID) {
+    UI     STRING ="$(MODULE_NAME)"     Optional
+    PE32   PE32                         $(INF_OUTPUT)/$(MODULE_NAME).efi
+  }
+
+[Rule.Common.UEFI_DRIVER.BINARY]
+  FILE DRIVER = $(NAMED_GUID) {
+    DXE_DEPEX DXE_DEPEX Optional      |.depex
+    PE32      PE32                    |.efi
+    UI        STRING="$(MODULE_NAME)" Optional
+    VERSION   STRING="$(INF_VERSION)" Optional BUILD_NUM=$(BUILD_NUMBER)
+  }
+
+[Rule.Common.UEFI_APPLICATION.BINARY]
+  FILE APPLICATION = $(NAMED_GUID) {
+    PE32      PE32                    |.efi
+    UI        STRING="$(MODULE_NAME)" Optional
+    VERSION   STRING="$(INF_VERSION)" Optional BUILD_NUM=$(BUILD_NUMBER)
+  }
+
+[Rule.Common.USER_DEFINED.ACPITABLE]
+  FILE FREEFORM = $(NAMED_GUID) {
+    RAW ACPI               |.acpi
+    RAW ASL                |.aml
+  }
-- 
2.17.0.windows.1



^ permalink raw reply related	[flat|nested] 34+ messages in thread

* [PATCH v5 edk2-platforms 22/22] Platform/RaspberryPi/RPi3: Add platform readme's
  2019-02-05 16:25 [PATCH v5 edk2-platforms 00/22] Platform/RaspberryPi: Add Raspberry Pi 3 support Pete Batard
                   ` (20 preceding siblings ...)
  2019-02-05 16:25 ` [PATCH v5 edk2-platforms 21/22] Platform/RaspberryPi/RPi3: Add platform Pete Batard
@ 2019-02-05 16:25 ` Pete Batard
  2019-02-14 18:42   ` Leif Lindholm
  2019-02-13  3:41 ` [PATCH v5 edk2-platforms 00/22] Platform/RaspberryPi: Add Raspberry Pi 3 support Jeremy Linton
  2019-02-14 18:45 ` Leif Lindholm
  23 siblings, 1 reply; 34+ messages in thread
From: Pete Batard @ 2019-02-05 16:25 UTC (permalink / raw)
  To: edk2-devel

Documentation is split between general plaform data and OS testing
and installation details.

Contributed-under: TianoCore Contribution Agreement 1.1
Signed-off-by: Pete Batard <pete@akeo.ie>
---
 Platform/RaspberryPi/RPi3/Readme.md  | 167 ++++++++++++++++++++
 Platform/RaspberryPi/RPi3/Systems.md |  65 ++++++++
 Readme.md                            |   3 +
 3 files changed, 235 insertions(+)

diff --git a/Platform/RaspberryPi/RPi3/Readme.md b/Platform/RaspberryPi/RPi3/Readme.md
new file mode 100644
index 000000000000..7434233df0fb
--- /dev/null
+++ b/Platform/RaspberryPi/RPi3/Readme.md
@@ -0,0 +1,167 @@
+Raspberry Pi Platform
+=====================
+
+# Summary
+
+This is a port of 64-bit Tiano Core UEFI firmware for the Raspberry Pi 3/3B+ platforms,
+based on [Ard Bisheuvel's 64-bit](http://www.workofard.com/2017/02/uefi-on-the-pi/)
+and [Microsoft's 32-bit](https://github.com/ms-iot/RPi-UEFI/tree/ms-iot/Pi3BoardPkg)
+implementations, as maintained by [Andrei Warkentin](https://github.com/andreiw/RaspberryPiPkg).
+
+This is meant as a generally useful 64-bit ATF + UEFI implementation for the Raspberry
+Pi 3/3B+ which should be good enough for most kind of UEFI development, as well as for
+running consummer Operating Systems in such as Linux or Windows.
+
+Raspberry Pi is a trademark of the [Raspberry Pi Foundation](http://www.raspberrypi.org).
+
+# Status
+
+This firmware, that has been validated to compile against the current
+[edk2](https://github.com/tianocore/edk2)/[edk2-platforms](https://github.com/tianocore/edk2-platforms),
+should be able to boot Linux (SUSE, Ubuntu), NetBSD, FreeBSD as well as Windows 10 ARM64
+(full GUI version).
+
+It also provides support for ATF ([Arm Trusted Platform](https://github.com/ARM-software/arm-trusted-firmware)).
+
+HDMI and the mini-UART serial port can be used for output devices, with mirrored output.
+USB keyboards and the mini-UART serial port can be used as input.
+
+On a freshly built firmware, the default is to boot the UEFI shell.
+To change the default boot order (for instance to boot uSD media by default) you
+will need to edit the preferences in _Boot Maintenance Manager_.
+
+For additional information about the tested systems and how to set them up,
+please see [Systems.md](./Systems.md).
+
+# Building
+
+Build instructions from the top level edk2-platforms Readme.md apply.
+
+# Booting the firmware
+
+1. Format a uSD card as FAT32
+2. Copy the generated `RPI_EFI.fd` firmware onto the partition
+3. Download and copy the following files from https://github.com/raspberrypi/firmware/tree/master/boot
+  - `bootcode.bin`
+  - `fixup.dat`
+  - `start.elf`
+4. Create a `config.txt` with the following content:
+  ```
+  arm_control=0x200
+  enable_uart=1
+  armstub=RPI_EFI.fd
+  disable_commandline_tags=1
+  ```
+5. Insert the uSD card and power up the Pi.
+
+Note that if you have a model 3+ or a model 3 where you enabled USB boot through OTP
+(see [here](https://www.raspberrypi.org/documentation/hardware/raspberrypi/bootmodes/msd.md))
+you may also be able to boot from a FAT32 USB driver rather than uSD.
+
+# Notes
+
+## ARM Trusted Firmware (ATF)
+
+The ATF binaries being used were compiled from the latest ATF source.
+No aleration to the official source have been applied.
+
+For more details on the ATF compilation, see the [Readme](./TrustedFirmware/Readme.md)
+in the `TrustedFirmware/` directory.
+
+## Custom Device Tree
+
+The default Device Tree included in the firmware is the one for a Raspberry Pi 3 Model B (not B+).
+If you want to use a different Device Tree, to boot a Pi 3 Model B+ for instance (for which a
+DTB is also provided under `DeviceTree/`), you should copy the relevant `.dtb` into the root of
+the SD or USB, and then edit your `config.txt` so that it looks like:
+
+```
+(...)
+disable_commandline_tags=2
+device_tree_address=0x10000
+device_tree_end=0x20000
+device_tree=bcm2710-rpi-3-b-plus.dtb
+```
+
+Note: the address range **must** be `[0x10000:0x20000]`.
+`dtoverlay` and `dtparam` parameters are also supported **when** providing a Device Tree`.
+
+## Custom `bootargs`
+
+This firmware will honor the command line passed by the GPU via `cmdline.txt`.
+
+Note, that the ultimate contents of `/chosen/bootargs` are a combination of several pieces:
+- Original `/chosen/bootargs` if using the internal DTB. Seems to be completely discarded by GPU when booting with a custom device tree.
+- GPU-passed hardware configuration. This one is always present.
+- Additional boot options passed via `cmdline.txt`.
+
+# Limitations
+
+## HDMI
+
+The UEFI HDMI video support relies on the VC (that's the GPU)
+firmware to correctly detect and configure the attached screen.
+Some screens are slow, and this detection may not occur fast
+enough. Finally, you may wish to be able to boot your Pi
+headless, yet be able to attach a display to it later for
+debugging.
+
+To accommodate these issues, the following extra lines
+are recommended for your `config.txt`:
+- `hdmi_force_hotplug=1` to allow plugging in video after system is booted.
+- `hdmi_group=1` and `hdmi_mode=4` to force a specific mode, both to accommodate
+   late-plugged screens or buggy/slow screens. See [official documentation](https://www.raspberrypi.org/documentation/configuration/config-txt/video.md)
+   to make sense of these parameters (example above sets up 720p 60Hz).
+
+## NVRAM
+
+The Raspberry Pi has no NVRAM.
+
+NVRAM is emulated, with the non-volatile store backed by the UEFI image itself. This means
+that any changes made in UEFI proper are persisted, but changes made from a High Level
+Operating System (HLOS) aren't.
+
+## RTC
+
+The Rasberry Pi has no RTC.
+
+An `RtcEpochSeconds` NVRAM variable is used to store the boot time.
+This should allow you to set whatever date/time you want using the Shell date and
+time commands. While in UEFI or HLOS, the time will tick forward.
+`RtcEpochSeconds` is not updated on reboots.
+
+## uSD
+
+UEFI supports both the Arasan SDHCI and the Broadcom SDHost controllers to access the uSD slot.
+You can use either. The other controller gets routed to the SDIO card. The choice made will
+impact ACPI OSes booted (e.g. Windows 10). Arasan, being an SDIO controller, is usually used
+with the WiFi adapter where available. SDHost cannot be used with SDIO. In UEFI setup screen:
+- go to `Device Manager`
+- go to `Raspberry Pi Configuration`
+- go to `Chipset`
+- configure `Boot uSD Routing`
+
+Known issues:
+- Arasan HS/4bit support is missing.
+- No 8 bit mode support for (e)MMC (irrelevant for the Pi 3).
+- Hacky (e)MMC support (no HS).
+- No card removal/replacement detection, tons of timeouts and slow down during boot without an uSD card present.
+
+## USB
+
+- USB1 BBB mass storage devices untested (USB2 and USB3 devices are fine).
+- USB1 CBI mass storage devices don't work (e.g. HP FD-05PUB floppy).
+
+## ACPI
+
+Both Arasan and SDHost SD controllers are exposed.
+
+Note that the ACPI tables were derived or copied from the MS-IoT one. This means that they
+are not truly ACPI compliant, especially when it comes to their descriptors, and therefore
+not suitable for Linux environments. If you want to use a Linux HLOS, you are encouraged to
+install a kernel that relies on Device Tree rather than ACPI.
+
+## Missing Functionality
+
+- Network booting via onboard NIC.
+- Ability to switch UART use to PL011.
diff --git a/Platform/RaspberryPi/RPi3/Systems.md b/Platform/RaspberryPi/RPi3/Systems.md
new file mode 100644
index 000000000000..f6410eb25f0d
--- /dev/null
+++ b/Platform/RaspberryPi/RPi3/Systems.md
@@ -0,0 +1,65 @@
+# Tested Operating Systems
+
+## Ubuntu
+
+[Ubuntu 18.04 LTS](http://releases.ubuntu.com/18.04/) has been tested and confirmed to work,
+on a Raspberry 3 Model B, including the installation process. Note however that network
+installation and networking may not work on the Model B+, due to the `lan78xx` Linux driver
+still requiring some support.
+
+Below are the steps you can follow to install Ubuntu LTS onto SD/USB:
+* Download the latest Ubuntu LTS ARM64 [`mini.iso`](http://ports.ubuntu.com/ubuntu-ports/dists/bionic/main/installer-arm64/current/images/netboot/mini.iso).
+* Partition the media as MBR and create a ~200 MB FAT32 partition on it with MBR type `0x0c`.
+  Note: Do not be tempted to use GPT partition scheme or `0xef` (EFI System Partition) for the
+  type, as none of these are supported by the Raspberry Pi's internal boot rom.
+* Extract the full content of the ISO onto the partition you created.
+* Also extract the GRUB EFI bootloader `bootaa64.efi` from `/boot/grub/efi.img` to `/boot/grub/`.
+  Note: Do not be tempted to copy this file to another directory (such as `/efi/boot/`) as GRUB looks for its
+  modules and configuration data in the same directory as the EFI loader and also, the installation
+  process will create a `bootaa64.efi` into `/efi/boot/`.
+* If needed, copy the UEFI firmware files (`RPI_EFI.fd`, `bootcode.bin`, `fixup.dat` and `start.elf`)
+  onto the FAT partition.
+* Boot the pi and let it go into the UEFI shell.
+* Navigate to `fs0:` then `/boot/grub/` and launch the GRUB efi loader.
+* Follow the Ubuntu installation process.
+
+Note: Because Ubuntu operates in quiet mode by default (no boot messages), you may think the system is frozen
+on first reboot after installation. However, if you wait long enough you **will** get to a login prompt.
+
+Once Linux is running, if desired, you can disable quiet boot, as well as force the display
+of the GRUB selector, by editing `/etc/default/grub` and changing:
+* `GRUB_TIMEOUT_STYLE=hidden` &rarr; `GRUB_TIMEOUT_STYLE=menu`
+* `GRUB_CMDLINE_LINUX_DEFAULT="splash quiet"` &rarr; `GRUB_CMDLINE_LINUX_DEFAULT=""`
+
+Then, to have your changes applied run `update-grub` and reboot.
+
+## Other Linux distributions
+
+* Debian ARM64 does not currently work, most likely due to missing required module support
+  in its kernel. However its installation process works, so it may be possible to get it
+  running with a custom kernel.
+
+* OpenSUSE Leap 42.3 has been reported to work on Raspberry 3 Model B.
+
+* Other ARM64 Linux releases, that support UEFI boot and have the required hardware support
+  for Pi hardware are expected to run, though their installation process might require some
+  cajoling.
+
+## Windows
+
+Windows 10 1809 for ARM64 (build 17763) has been tested and confirmed to work (after replacing
+`C:\Windows\System32\Drivers\WppRecorder.sys` with an older version, since the one from 1809
+appears to be buggy across all archs, and results in a similar BSOD when trying to run Windows
+To Go on x64 with native drivers for instance).
+
+Windows 10 1803 for ARM64 and earlier do not work due to the presence of a hardware ASSERT check
+in the Windows kernel, that was removed in later versions.
+
+You probably want to look at https://www.worproject.ml/ as well as the
+[Windows thread in the original RaspberryPiPkg](https://github.com/andreiw/RaspberryPiPkg/issues/12)
+for installation details.
+
+## Other platforms
+
+Details you may need to run other platforms, including FreeBSD, is provided in the
+[Readme from the original RaspberryPiPkg](https://github.com/andreiw/RaspberryPiPkg).
diff --git a/Readme.md b/Readme.md
index 384b1d3c5e2b..95c0c145224b 100644
--- a/Readme.md
+++ b/Readme.md
@@ -217,6 +217,9 @@ they will be documented with the platform.
 ## Marvell
 * [Armada 70x0](Platform/Marvell/Armada)
 
+## Raspberry Pi
+* [Pi 3](Platform/RaspberryPi/RPi3)
+
 ## Socionext
 * [SynQuacer](Platform/Socionext/DeveloperBox)
 
-- 
2.17.0.windows.1



^ permalink raw reply related	[flat|nested] 34+ messages in thread

* Re: [PATCH v5 edk2-platforms 18/22] Platform/RaspberryPi/RPi3 *NON-OSI*: Add ATF binaries
  2019-02-05 16:25 ` [PATCH v5 edk2-platforms 18/22] Platform/RaspberryPi/RPi3 *NON-OSI*: Add ATF binaries Pete Batard
@ 2019-02-06 22:39   ` Kinney, Michael D
  2019-02-07  0:52     ` Pete Batard
  0 siblings, 1 reply; 34+ messages in thread
From: Kinney, Michael D @ 2019-02-06 22:39 UTC (permalink / raw)
  To: Pete Batard, edk2-devel@lists.01.org, Kinney, Michael D,
	leif.lindholm@linaro.org

Hi Pete,

We have the edk2-non-osi repository for binaries.  Do some of 
the patches in this series really belong there?

https://github.com/tianocore/edk2-non-osi

Thanks,

Mike

> -----Original Message-----
> From: edk2-devel [mailto:edk2-devel-
> bounces@lists.01.org] On Behalf Of Pete Batard
> Sent: Tuesday, February 5, 2019 8:26 AM
> To: edk2-devel@lists.01.org
> Subject: [edk2] [PATCH v5 edk2-platforms 18/22]
> Platform/RaspberryPi/RPi3 *NON-OSI*: Add ATF binaries
> 
> These ATF binaries were built from the ATF source
> (commit c3859557)
> with the custom RPi3 platform options detailed in the
> readme, and with
> no modification to the official source whatsoever.
> 
> Contributed-under: TianoCore Contribution Agreement 1.1
> Signed-off-by: Pete Batard <pete@akeo.ie>
> ---
>  Platform/RaspberryPi/RPi3/TrustedFirmware/License.txt
> |  26 ++++++++++++
>  Platform/RaspberryPi/RPi3/TrustedFirmware/Readme.md
> |  42 ++++++++++++++++++++
>  Platform/RaspberryPi/RPi3/TrustedFirmware/bl1.bin
> | Bin 0 -> 18801 bytes
>  Platform/RaspberryPi/RPi3/TrustedFirmware/fip.bin
> | Bin 0 -> 41714 bytes
>  4 files changed, 68 insertions(+)
> 
> diff --git
> a/Platform/RaspberryPi/RPi3/TrustedFirmware/License.txt
> b/Platform/RaspberryPi/RPi3/TrustedFirmware/License.txt
> new file mode 100644
> index 000000000000..b98dc643227e
> --- /dev/null
> +++
> b/Platform/RaspberryPi/RPi3/TrustedFirmware/License.txt
> @@ -0,0 +1,26 @@
> +Copyright (c) 2013-2018, ARM Limited and Contributors.
> All rights reserved.
> +
> +Redistribution and use in source and binary forms,
> with or without modification,
> +are permitted provided that the following conditions
> are met:
> +
> +* Redistributions of source code must retain the above
> copyright notice, this
> +  list of conditions and the following disclaimer.
> +
> +* Redistributions in binary form must reproduce the
> above copyright notice, this
> +  list of conditions and the following disclaimer in
> the documentation and/or
> +  other materials provided with the distribution.
> +
> +* Neither the name of ARM nor the names of its
> contributors may be used to
> +  endorse or promote products derived from this
> software without specific prior
> +  written permission.
> +
> +THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND
> CONTRIBUTORS "AS IS" AND
> +ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
> LIMITED TO, THE IMPLIED
> +WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
> PARTICULAR PURPOSE ARE
> +DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR
> CONTRIBUTORS BE LIABLE FOR
> +ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY,
> OR CONSEQUENTIAL DAMAGES
> +(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
> SUBSTITUTE GOODS OR SERVICES;
> +LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
> INTERRUPTION) HOWEVER CAUSED AND ON
> +ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
> LIABILITY, OR TORT
> +(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
> OUT OF THE USE OF THIS
> +SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH
> DAMAGE.
> diff --git
> a/Platform/RaspberryPi/RPi3/TrustedFirmware/Readme.md
> b/Platform/RaspberryPi/RPi3/TrustedFirmware/Readme.md
> new file mode 100644
> index 000000000000..74bcec7d1f12
> --- /dev/null
> +++
> b/Platform/RaspberryPi/RPi3/TrustedFirmware/Readme.md
> @@ -0,0 +1,42 @@
> +ARM Trusted Firmware for Raspberry Pi 3
> +=======================================
> +
> +The `bl1` and `fip` ATF binaries, found in this
> directory, were built from
> +the [official ATF source](https://github.com/ARM-
> software/arm-trusted-firmware)
> +(commit c3859557) using Linaro's GCC 5.5 compiler
> with:
> +
> +```
> +export CROSS_COMPILE=/usr/src/gcc-linaro-5.5.0-
> 2017.10-x86_64_aarch64-linux-gnu/bin/aarch64-linux-gnu-
> +make PLAT=rpi3 PRELOADED_BL33_BASE=0x30000
> RPI3_PRELOADED_DTB_BASE=0x10000 SUPPORT_VFP=1
> RPI3_USE_UEFI_MAP=1 fip all
> +```
> +
> +This results in the following memory mapping:
> +
> +```
> +    0x00000000 +-----------------+
> +               |       ROM       | BL1
> +    0x00010000 +-----------------+
> +               |       DTB       | (Loaded by the
> VideoCore)
> +    0x00020000 +-----------------+
> +               |       FIP       |
> +    0x00030000 +-----------------+
> +               |                 |
> +               |  UEFI PAYLOAD   |
> +               |                 |
> +    0x00200000 +-----------------+
> +               |   Secure SRAM   | BL2, BL31
> +    0x00300000 +-----------------+
> +               |   Secure DRAM   | BL32 (Secure
> payload)
> +    0x00400000 +-----------------+
> +               |                 |
> +               |                 |
> +               | Non-secure DRAM | BL33
> +               |                 |
> +               |                 |
> +    0x01000000 +-----------------+
> +               |                 |
> +               |       ...       |
> +               |                 |
> +    0x3F000000 +-----------------+
> +               |       I/O       |
> +```
> diff --git
> a/Platform/RaspberryPi/RPi3/TrustedFirmware/bl1.bin
> b/Platform/RaspberryPi/RPi3/TrustedFirmware/bl1.bin
> new file mode 100644
> index
> 0000000000000000000000000000000000000000..e25138828d0a4
> ddb24772abb1a60eefc334666b5
> GIT binary patch
> literal 18801
> zcmeHud2|%#mG7;pmedFVtpy|tJ-
> S*z4DF582<)+{TLO%YF^IMyw%@2*ivhC;Enpe2
> zRTA<tmgA=aC3r9swODMrCx7^1@T3zb2%DK?Lf#29G?V1z4J{zXv79_
> ;z^G+F?{}-Z
> zge>Dp&Ya2NoOkF$@l}1x-M+hhw@Q@U820D96C>N0$f-gpvNVO-
> 6r%k^_LFjhV53f>
> zzYYB^p(#wZhayBm(40?m)v%ZRF-
> jkU{?@RJdpUDVq_0@Qvl>>=KM8BSMAN6D9c2X^
> zv}!gTC9-
> IZXdTh<nuF*_F~<Dabe@Q`4z%dg`yWETSD&vxw>l_aE5oz<u%x-
> Mt_I@=
> z6^f(*?g@d~PT~5aNNv#+%2G)!>6A)Ol0}J=O^M4yanPmrUEBE6z%_}
> qi$f`XQKFzu
> zlVZ_?G$rnX41{DgYzORyWMj?6p-
> TMP#*g+gylWdj3`8X%sIOlv1lmB)R$NV@Mf2q+
> zY4d>}JWrcSYDNxGR%4SA-?^DI?>kETG0>;<^-
> cF@D)C*r!0X4PiJ}^Q9sQugsR%T^
> zW2zF8L8m(ZKusahN`})&<nhl?LUy9+i<w(<d3`h1M5RpU#l^0`wT*}
> SX*21%1imhU
> zPUcNemAKC1ZY6&CX)*AHBnEe$A?>mx1t%~~5>0PQR^krEJ6wr3iAo6
> aZSmWc_!Ag6
> z`56X&xUWmf4DJH$r=?NBrxUaj_-
> e#D|7a!d7m4LPR23=2^S_NbBGxi5Ce4?hcK6f$
> z3TXVu>I#)XZeBsnU^%~vzTYcJS`*qLzY-
> q@C2Lj%?d)EP7gLhfKy+cZh2moYa~$X{
> zx3%XUwhAHXdf#-
> #Z|vK6?76XLKQ{Io`^9@z>$YethdSW8QZ5C&;8{(g13fpB7t2Z#
> zv}wTee+aU&&~*P;CC>ZC@)`!-
> q9RS70s5}E1#NvkX*|Abte|y4K4Ov@&cGb(htrS!
> z?UHhWQSQh3M%HhErgcf#{e7FzN8o|+H4LXX!y1D17Ravw@_ZjU`DI^
> Uc2vsJ_nzf=
> zrMw8T{AXPU*sfUT3wKkT?+aC<bwGw9De+Pgy0M=g=$J0&Ya0&+1VIh
> 6-ju<Pc#Vv`
> zxVG`oUb4_488RjCX~^+rc9W#N2)U@RbJ%UGLl!h2_J5$wD2esZiB|H
> 98rptaG+{Rb
> z?`Abg<Nbfx>k5sBtYoZHy#nk(iF>b7Kn7plG-
> GWM_MT}fv`}>i_+g$!>kYVAtMjMZ
> zKkRxSPMv3q!LuE3blU*#eDKfoFz*JxKk3(-
> OVEQ%;4th*3YIr1fsrJ(5J@e0*s~Mh
> zd0nc3pKa36?~nW8oE_jZ2E+0tU<o9&L?uhm`e)&NbstQ*jvlxV@Ues
> Ufo;hxCu;)y
> zb8)?|=Zqvc?PTfhg!~*9(h6;K!PVE-
> uN%59sIE}y(y=|nx}e_B1%~Bnc7=Gq3awQA
> zngJu7<>zV^LM%V#S;F3RL3YfS7qNwP(4B`1epbOV&*!-
> U`W><occEV%(9iz15;#~t
> zHv{J~&~p)X+?PhxycbtSQ~c)^@_Yhc#^cMuUlRBm@<L_LSt-
> f+2f*6{-VTB{A9%B1
> zY&>*>{SoGslw<yPvF^amWNq8$n~tBeQ2Kr`yX9x#wXS|#&+nm!93u$
> yvEMu`Wd$YZ
> z0sI*FDLnam*tH7XfB(4|J*)!~;KDY8d;0peMS=ec{NW9KF#I&jq?|9
> S5-$RMEEh#I
> z^i`J+#@x_ZQ%2^P1^vx@A)XauojPD0$28`L<)q6J^Bg(AorrNhU9JY
> bO#6$Vk8PA`
> zG-I1?2mTbz(EWqD?jJ-v(_;wwMQRF*7Jp2<MDeJ-
> Zl4U>xnU~@1Li!YAs@Crw^@mE
> zJEv8N!xy*iIXqtPFMdslV^5CpSP{AOIqo-<I9)>j-
> O4@(<co3b0C4Mm2z>pGL|JCs
> z_Scg326Vj>zPQ7#guJ=UC5TLVy!49XQEbg6O5#}+;Onf*7m-
> !0mNBN=N<p%=2(THy
> z`+O4T8m*3;WR2sS-
> uGaVW;O5q7Gu0M33`<nH~XR%Z5QzCFpnl{4+19pY5m!gq7~qI
> zD(E!j%eu_A$MRtv=G@_OCdDsv4kEhZGkH&-
> Pcn3lpE*W%Nh5=WiGDBijN|Fcx^87U
> zFCz~a9RI%&eyS_(7ziKFCj2`G!C(E2@DqL~LA#o7)iz%5+r}}~dpbq
> ?E$-E1S6ufq
> zWYzslANsu4kyBufTd{&~mmve>Q$5%FvW<L-
> oTf}NB{e(^`_Wc5M9bWi`L^M2g&^Cx
> zDrUA^fensqRsvDTMTY(PA(O`EYI`n=g#1N`A3|%|8{6KE+~_9(LH?@
> jw>DWdQ~o5Y
> zCCK+eYQ7j!pl>qyYZ_h>Cwf!Shv$Y|3VDZ9h;3(06152rzgE&E_-n-
> MZDBF`ZcHI1
> z<UlNH)MG2+oSLDHfG#L~SMH~*ZDGP3pZMRVh?&NGfhc6cFxPgNYtu3
> {2&rup>r&s9
> z8Dulo!>&Ve8fDmJs#eXpdo#6Up0{e#7UT!IFW2?2AWM4-
> F#Z5qXW(MGng6G8uYzxp
> z-YXF-
> N~n;;mHn`Om!<2yU{gX(;2CpZQ{u`_6W9Ea+GfBcFvofh?m~X#BzP{-
> We$D3
> zw$X@rr=ioFC%dpG;1$=7@S!As%#CLUiAMzZ4gopP=p?r5p9FN8ZKE_
> (4`4T~wJ(j*
> z_vcyQWcnR!r#Ksw4Se>K_P2Om3_F89ZA-
> &FVtO^(5%$Bw`PoQ?G^}@8aj)lL$TPdx
> z&H#^gkJ2*03)>mb8I_m=o~P;K%d@pP=;M6rIlawvehFL*hv)ReIh(C
> Li19Cwo9XL*
> zkfU)d(C>S4wCRbpld<-O-G02cQRn|A@%#sOXq=lf-)1f~R-
> i2Ajo{P#z->nibm%@!
> z4cmYVdKw;%wsZUU!`>x<SSNBN{|9e|qd(Xg>qKtk{q~z-
> <$d&X&eQuwSbq0lOvHTb
> z-xlzKSdbiK-
> %sg$)?2@i&vyLGd4NMr)8wVz9wRo~$cxxM1xrE1kym^ix!8q6rmkGQ
> zL+b&r^Pq3rERYN2g&^9NiT$ceRzkYZ16%^!Mv*cuL03fNBp(qS5a+0
> 2j^*W@X<B}o
> z__kQ@=s5v?33%*j^)WBwc!Bj3UcX)~;q!<$gKcw^^G)DjnIS&vd-
> gP1$fd*&+ty_{
> zAUFFJ*0b)JI>$7yKj3&j9kwBW4#c309iX3O(&cZ=Xv)z2eJasNXOXS
> =xIm+(;4D%t
> zlbYKIzAQ9yN+G=zQ*CN4)#qhwhJPwfb02R<j>P&<4Et@LK-
> DhrK$J7ZVR0RIytV8&
> z&y%PzEakov<9Sj_V|Z7NKjt7Q=-Ub3W-EyJ-
> a(Fuc|w{R_Qeo4U~i`-(dlhMj$cNa
> znykdjn$qDLp)=r9w8G!P9_wzRW5|nPx0LaB@bxS|Q^!7p{&IfIGHJp
> Xby_rz!T+Sk
> zU!#8$`VYD&g7c`x=kFUiz*qFxS%Z1-snu+Ud<GQ+<$m(BKS;@-<i--
> zA8KSGC)x5M
> zIpEpcU-
> %S{JmHb!r23ANWhwM9FA{Bd1vQ1dh!;9eU3t(?)E}aG5rGPD<wZKscA
> zB(
> z`gS}JaXk3waR<-GC7;H6*!C|#54R?-
> ztnBj$Uk+xhn{fj&8GJt8$AzVd+UO|nYjnY
> z?H<74^Y#8~ecLk0I1eA@IQXp_`M(+SL1*IZ^rNrp8SDl&;M|FGVh7?
> p;+gY%*uMt>
> zhkcidGdah4K6`fDsl*=wF7EHdS(DF%9Yun+F45;lzOeHy?7e`TaFh~
> SEU6i#MBSf4
> z$Mmykxp5Y4f{j#}YXGAb_l(1V_I-
> |{&~4VC4<u@19h?N)p)dQU>oV)Nn}5;IG=?Ae
> zpr5CXmgGPg<mOhD(5|g1fjw_q1Mfc0eqWi%F~lm7hwTb6!I=lREI(C
> LW~#93q-1Jq
> zOD63q_QStf)DD)SZXj6#{>_5szYBgTS<Uc2jlPuPfImgVH5-={=-
> 7<93f5WRV_4s>
> zZTy8!TZ1e``T)z6y?q>22Otak&tZ4TY6-
> PA=Cbcl1e{fHk@ZlnK&U&(c^dIKr{45)
> zKMjb=TP69(1#};QTpGE~d$sN{+8Nl4;D4i}BebiAtgnaVv+u^-
> @DpChF%9igkfCme
> ziQ16^dT>s+p$~PLvERI`pC^PMVn~qd5Is1<6oH;AQc~~>DFrqx1TIM
> y)Nzu7?8iiD
> z<PjrIjSLn6-
> jnD%EoPxF3v$g07FpDiMd<rT%tT)%$FraWc=OQ*eLhc}c^a?j&yV!F
> z!Qs76Ko(4cA2wB(=81Jc-
> wQ2I##B7J^!ugoxoWrzGAvAcCZ^!NQNQ=bqABg$Sr_<H
> z+yxPWuVb6>VVvNzI5$BpE%E$dM2|OIOSHO=^BSHjq(#GIjfQ1Xbyy}
> GL&pvVnsF9*
> zg*tz0u^Q)_f3bD`7P1UBQ}Uxx$jnF98G`?nl4cT|&6||1|BL+-
> ;4+QPD$iT7k8^kW
> zaP4uy_FmXR7W4_hXuBF#t^OGMuc(azrx7C!oW>scUlpJ>d&3>&r0vW
> `EVUzsvTu+@
> zZP!%96UfrcFIj%(81faw6~k9DExJ6g4!YrCSukDsfT1iU#0%sIxG%$
> gig;#P__;!d
> z@zX#h`c2(q`!{i5f1MVblSG{HBpLN9rb`{K?H}ah!UN7ttWRu%9Ou5
> vbmdV^CulMB
> z$A}s1w+@SxW!RHh^ZaR`0l9`7Ie{4~YoP<>$?e;xA_me@&Ldxp)n;V
> |%S17FF}r;`
> z^Sn4OGuQ$6W#Wc?g|s2I*tT^$?|&_xr&+0n$C?y1T#Gd?fgS|aEY!<
> N;4hwIS-pV1
> zT9Jb7sZ{MvuHVOf<bvNv-
> &g7Tp>9)O)+PnM<QNXy%7fha9Jvnm7hh=!0A}}e8rjmz
> zdY(+jSQcz^aVg2^e}Lj_d%HJMXdd)E5A_B@PW0iXywN+_DV^lsZAWe
> 9^?c;5&y4%s
> z_S3+Tg*o>_2Gbg{Mz?*R(og1}*xm`a{u!u!rck=S0sd;E5^9%drI<{
> f@~ui>Yr~7j
> zm(Zw|%a~U|mX=bIx}n?0QdZXXsPYrNQ43}4LhSQNsNao1+$8A;a^)7
> *7tZy37~?p}
> z_ml$P&aq&IUfX&dvG~F`sdPgWbG*n4XxxeIs!03U{u*dxx1tvJBA@g
> `QE!}xKIXwU
> zS_z$z?r=t>+~BK_HLA@${s)x!4$yyE$`0BoyZh64pGN_WW3XoKeM(3
> H>@L(u&TXpO
> znnEf6=(-
> Q*BH)Z#lzqH@PXohDflnI^|C1ZEC~C>OQz^a;@LBiXoyzgQDICR|r_k
> 3R
> zj_mec?enm&VjGRZCvxmL_eR~8Kf;F(^i}bd#epwtXT#6`T=(<iQ9qf
> TPWvYy2Ir$D
> zV!ua;Ifj#GEcU(OZY6eT7<mq&ZA5E<9haikWwH3f#kS&J3uxfBBaLJ
> G4WB$pNNQo-
> zIEg*lkJ_GH7}br~bd1lRWv!mxy+g?(0)D$Fc0bJbz<mn$pQe&$Xb$o
> }=&uO6Rt_2W
> zc17dg_Ee<Ofpg$#6<Lp*MgL)m_WvPA3H$>4-
> $2RTk0jBtru;{G|M+Tq?spJ7+QroF
> zGI>rf&MKaNr6ETOg|u$ei9H8FyO-
> wlHlkmFd>SaVyP1Zxs9WarvJQQ6XM3()KrL^}
> zyxy}j+H+5lW#zv@@6I9LKFx9j4dq*uz-
> I7Nj`{5(bni8#mu;$cCuwoaF~=Df&(X(i
> zo?c&K4)UJtBJfa3L%S;qjJ0mS=X&%Nwma;vn~d1w1<Zd({llnjXX<t
> EFrNMSEHCPw
> z2bdq^!>4|WWl7yDphNq=Me%g-
> MjWdYyVil4SQ?%k7UR6>gUzx35ODr9=k)7G;;jF_
> zuMN<d0q1|iuivO&aQ?yXN4yzIyc4xCBVJ|&Sr*ShFMC;LdQM^bz#Hc
> T*5fS5fzJvY
> zcV{9F_-
> 1iFjdud)Up#I{jolCa%5ovA<#G?nhK$OcI8$Iw0|_fvV;{?ao7cD}2`
> %P4
> zyG6OsfjXrFF^|uZZJ<X@g^fdR$^nmkbp>#-
> y;PPcArb34ku$RFnFcTBFb$j0*Z8J_
> zbG6h$*h|#$y8YMsJk7a!-
> hZAxw`)zJ68|5_{ooVY?!_g;XY!fCTO!QVa~GZekN2|7
> zS$=$7kj4a4z%TgQFPxtlar9JganOtVg!6YqWU=(53-
> s*7e4Yp2)28yg80OLPeL~Eb
> z<HMZ4zv&#$SLS>db1nkT>wtqp5&TI;Fp9n5_R~cBf6>Z-
> Pqbm54EX#m(+fI2!#c#1
> zHsqv7-Gq00uy?WwZ!1FS$v<F>b9g?#$awbaX9(z3p0b7V>bJ-
> _N(=MK{q&%+g?(!@
> zyFHitE@K@*z9Qb4a4nSJpLtIOoS#dPcOu`77vdbudr0s#{4AqR%lmA
> ~(99Q+KZcP%
> z#*kx%kz>ZbhnO!QmvkVPJdAsD-
> f#FG{!2j32DF3(E9v$1?*ry3iMl(GTaUr{^pvE;
> zx?o4wTa-
> AT%P^*KtY;lP_a$m`uRtG^F%bcm%z0WGYU0qtsn~n_tHUGh4@fvCWd*
> 0;
> z`IYY%2b#ZE6li+W9Z+9!1)@^>NdnJKjNOIH3)%i&vIjo_j$giJ;A<C
> 1vndZnCgaKg
> zJx33x2f`}F=ZebvVc_48*iX)hSU1>@UWXpLp(6@p#PTU#AlSw~F4$O
> JBIGY!Zx2h+
> zgQy!xsqK`c*S8ui?jFR(R6bX5O<z^%7_a5Cp#03j<8qqvK0oIJhJ=g
> lQEA<*=aygT
> zla0P16O_OZB`4y<H9~O(M%Z#9lW?Vva|afo9YVR0)VqrUsjj@p(2|@
> ;+O*<8nw%54
> z2iNciX9tGw#JXKM5nJ(`z(VwCN3mwY+`zn}qa)AZ8dmUdU|1dIdKvz
> _z=%bFk1KuL
> zBZ0|0w=*Y_x>Sj$?id{zI%$63uA;oid|bl{9t#XZy9U<?WkF!Xq`b(
> ag?SO?4ez)E
> zr$-2Zv)N+c6T1}n^iE6Qv-^?)pU+4R{HZV{aDJ{e5PN(`;L?)Rz!#-
> M13k;q0=-qk
> z0#~0O9>{PNL}Cp_t{Y8J0LKM5Zonx5oMOP44LEZEXD;A83^?-
> u=Mlhp6maGP&SQbA
> z4N5%El@q!8{DJ_}^C#@-
> ^^FSrVLN;T>H??_Txg+qY_k$S|FcDb4Ahcr(7VaFU_;qw
> zV1sIwQUE>LUxc;S(C4MnliZ(#y2TzF9aG2s^L9#u{Y{_?MewJzgEZ<
> SZ3gBi_4OU#
> z`JZ6^-
> FS`y&h7_<g`eU6EY3^KSdaW++kLpM<M}1%UI)&{W9flN`TT{)o1hnN`
> D4!O
> zT8iKwiN?MzzcdtnL~LPw*#*67hc98?{_MI9|H*ahtvAIdf~HBJm)kQ
> ;Z<=!aWzf3|
> z^cEs#9Giq35j2C&&p7w8;4H&uqzVh|Zzr*P0_rXHG$jU^c#_hTef%!
> vWyBAA78TfG
> zLx;ed9WlNM<MvIBd-
> ?uj^c9l>d8DNq{@WwhF;B>U@XWF({(KYs;MdpKflp;PI&4vg
> z%`#*B-s^bZ2K-
> DL>LWUBP3SY`TJ*Wtuk2EVF6;t~v9?2dC0pZOw?fA_rvM%M$3jOW
> zz;?r@Hi8a)KOhU^dlbj(=JzQ5dj&twxeU+at07SfxQz4Ix@>CgSg*w
> W>$xsL@XKoW
> za^hVta<-8BnVbwa&X9PItov79b8+#(z@-
> st24cRG*B`+8k;tokxOa3G&D@!)*U+Dn
> z;YV>FKMk4@JDq$^SE%qL^2Ev39A!h+du_P~5N|JlHuzZQ#l?sAnz*k
> w0LKyokBQ?l
> zbagNe0*(&k42N_a#`}-
> K@M8)1mzEsbd%eMUkB#p;_B$k+CgO6h%3GXo{V3O!M;Y!-
> z*2QkLQkoJfr#q%dX^1U|FQNsPP0c7LF_rtukr!|aUs@tzY%FRD5@e+
> J+bG0&1Irpd
> zTW`<7Ci#8r9LT9N3po<oC-
> ~v|@^$3>z|rdPXKILJybrAoISb$3B<}sVw^6(Udm~sV
> zzJ>XLox=xIcR@$;@y@|*8J$t83e_BAcY>CD&^)+bMjzAU$TDOuV4aW
> Xe!@GH1g#l*
> zi*eQ$9(Mq4VFIqn3#vr=ILAk>IpCa)cRS;ePv9K0b4-
> L|m|Gqbk&q8cXgP**4q`!#
> zV-
> I*p68y1dN(#Q*^Wv61QewMp&D$+D<J&66Z^4{W*cI!Kw7jB#ZDl;p27
> Atz7Bo=O
> zN*O$QDe2J!&ANQC4_G7VIp(<K<pq}IV++c$j%|kLC6jREENDFi+ho6
> a3H=iM+IU=D
> z(pbn}z;_F<A^4C&BHey>F83CcEtd<7Z%Zutdw^>jf6VWc``=f-
> a|YiG;cR_LlAKTG
> z(PF&ccS_d7+r6sgZPeH<EC(+5=X4Rii=GkEJC~0yIDoSv*J#)WAtyb
> 6T)#RKda{b?
> zLe0~Pxp=SlsGUZx{0?~K8h&ju&fLf`I0whsYf*bLP42{e|Hls<qt0n
> 9<ZqbSgZzQ_
> z%`1)^YMueiZ(y!%4E5I~InQUBxi-
> KxfvGs7J>XIFvwsfJ(VQxW#`S@0jC~urq@pGn
> z&BeQwHmU}0&5=u<Q5Zvxr;ph?g=!V&J}dmLy;Z38BKP_^XtQ_Xe0~R
> ccn#105%{w2
> z#yHP=PpEFp(Z8`s=W)c!Z2JkoNhi;1y!MwuHQ}uGV_p*#s{J^V+CLS
> lyG9xCT!7bw
> zHOMQgQOoljg05_(o*BME<GmJgsVr|krN95tRQPME#yQf%V;6A-
> f8hL!TQ<P&48t6K
> z&3*sD8jRgoqlVb${fK%#=#_GhK&ck_akkwKxu3xvp+4Z`+9{v$Ij>{
> bUf}!!zK`iy
> zpP=Uy_M7S9F@`-
> lK@W5w%rz|RwWdg!Ed+h{q88i)_`L5sBw^@9;Heq_yEg%QLjrcG
> z^mW)3;FV!F!{3<jy<(0I-
> w*h^QJ+}>9J^6B;qxrxIhjg}OrH2V6}*=$xhUm275J?k
> z5)EAd8V1Xr`C<6Xt1m$hZ0T#fdI!kf3;BNInuP3GK3D_U3r>?JrpIv
> $XfW|JExgxP
> zai(N>aGma?c*khgWfk@Un_nctAC!)x>Upr?Y}DANL$*AQ+$<Zq*Tyx
> aiMWqSc~0Fw
> z;0$ltEq}juqqg%iy|&Z;zQy={#Yupl2mGwx-kt4FneT86zeu-
> #w<T~}0=Fe_TLOQv
> z1k~_9UG3ZULtKCHlK;YqGGg>L;C|~C;a7nFdEl<UMfknIzXZ6K-
> Xi=e@XrA5f?I^&
> z5B%A{opX!ucLM(v)FgXw{THhBUkoY={Qm~rzrIEI`R{bDZ>0E`l7}M
> y-tg4%Q>Ao4
> zSk&iP*~{Ne{Plk_YRTKc`&+k&e|-B9ejd2%ZxMbk@Gk-
> GrMC#b3j8yGyWke#_XB@6
> zaOd12{GGsmr5E;(>#wivU&jyy{(l4RU*979U#IAH&ut0ZmcVTZ+?K#
> ?3EY;z|L+o5
> zKjq#@6KX0~Rr+cxC(h!hd#21NxMx}U)Pm_Vr}LjP8$b8D6|3sxS@Pu
> jXHC6-*7Qkt
> z%L}U3%Tp%d-{b;Jc>~4VoBg7R&d&#pf12n&ffs)Re^(O^1&RJ&<0C-
> +{ZP@H{{L3t
> zgIWHyCR+UMr~dmi(XPTrg!~(qXs;&vjb5VH63=yJ|JwVEA;p}LXcPS
> tCeL->EibNG
> z^TOTo6OT@$5?}4wvdWs87vzO2<f-ywRTY)1WH%YpX0I-
> *tgX9SE?T}~jqjW0-bE9h
> zShI3X)$?m6QsRbEYu2uqI!jJG%4Jo)nhLq5a{Y?h6;*5GN%i9=71XC
> vmNBcivaYhc
> zuCij5JieCyJ#CEt_tYC;d}XUD<+>`lLZ3Pa9?JLlDf<8T&)gtG@TKw
> 3hd!47&|`aw
> zKmLctpB1LQxp(9L{MF9F$6mg6?#FvX`8Pw?e)P8Usd}ZoGWE%(+NRf
> %j&}Xs;@@S?
> z{mxwrQy<;%P=PJqkf+scz&|l0fhW<QljyHA`%N+iw~6_!#l}GY{6zo
> 5gW)9l)xq-z
> z!@d3d*O5R%{srH#FB1m!pFH}fcdvdHd30OT-%pE8`{3-
> {6V}!9ufH|t?e9)pc;qKf
> znX0_Htg3#Nytr}=n?v<FSeIP4Vs&NJy1IUCH>Q+SmRGJ=Ux`_@Ypd4
> OLi=wzZAnel
> znq_kNa^IRYm8)j;TUNsU3{X$3sjOeCTbS&tr~ts)Z<tsF<Cp*D=0KK
> J)(tW{`B~qJ
> zRh1R;1jAe>!k*n#Rdp*skEdo`Eeu+ov!Z78^S+u&9-
> 2Ry?HgRq!LoHVmGX);@>*_I
> z`<7M8tEzkzGPtN%#p|n{mEH5F$P>m_0II$Kz+nFREFO6_0r=iQ@Twr
> sKMT;H#iSMB
> z4D#-
> ov*d|cveWqCUS3#JRSsdvi|c$f;3hF*@^WMS)XAV?_Wa3m?YgyVt7__
> MWtXd_
> zeEI#;?x|X{>V<pdg?dnuYgvMbJ{9t_t9;AkBG1y&c?*i>KT$lp)a5E
> EdU)!T(vsP8
> z7xM<B((ICw$4h3(vP=se_slDrjaypcDp@dZ!Q5Fg&08?%aUPWE$=N0
> D#}{MRG=g8v
> zG46hoXwM|tKPK8MiI&J*l4$XTBLDFHg85StH+T)K|IAk4r?1Zwjah^
> IFMrsa_$lVi
> zU(%+oUhP|33VkiDsa%GjQChydvV7%)i3zQ{S4PaLs*%Uzd-
> T)=RdsUZnyPinmdmRv
> zS63mHL07OG#=}czrOHpbW<g6=)ywii<Bo4@S8S-
> {?hUy2)z#JTJ)+V=*MfOP=#Uo{
> zAy1f8PxwbP>F5X-
> )4dme>~*uBE|dWSf{3p%_@~@uwETZ3zJS9Y#ptpd*neZjfBKF;
> pGUp%uPONWW+j(aqe(9t5Z<6tBrVGl%uRfd8%+}<~gxlZ${{V7n<9`4
> E
> 
> literal 0
> HcmV?d00001
> 
> diff --git
> a/Platform/RaspberryPi/RPi3/TrustedFirmware/fip.bin
> b/Platform/RaspberryPi/RPi3/TrustedFirmware/fip.bin
> new file mode 100644
> index
> 0000000000000000000000000000000000000000..eff727ca78dc0
> 7cbfe56f1b6717e93b91702c16a
> GIT binary patch
> literal 41714
> zcmeI54SZGAmFV|5_vV8nK)!$&QgUv<7H>a9J`=R&B;ix3ViGO2eUlr
> KC=lc$0g8a;
> z2C!0Nr(8^j4t6Ftpp|>;`#r`&$8_3qK|5`Sb_Nr}Ogo+N0=Blrb|8r
> 6qLBAr=iHNo
> zpw@O?f6SXnejN5W`|Q2e+H0@9*4q2*y{@Ke!yE6Jo~h!0Rk7DoKUHw
> +r=Fhk!e2H2
> zpg3hmJpWvYQ^HQ?znuKQqRU^M_vBY@SbXfe_o@d=?feIQSC$+4)U$V
> Jj{W?GONB4E
> zwD6lQJ^Yr-74{cv=_-=b{YtT`yKj!GyF}aCsnQF(mD0j0-
> Ol%2*3wHJPE7YGb*v##
> zwVF!pR4O?DsXINs?11ENCf}#j0k8zBNy)SF*ONbnE9%M)pLC50pK^^
> 2pLUH4e@<7e
> zE4bd|3i1BZ=EI>&E)_6<sjVsLP~-gNo-
> M&A<yn2lj1^jCj_fxr+#>>-?(dwIsItMc
> za}w_*ok+ceasEzC`8$i1>x`+X$^y3v%u7#r^6&kX&%dHnJ+xIuU79!
> IsycBJ9=zGt
> zH%=*kraU_|oayV^9Z|irbfE#b9^fl?!IQdD*_7?PwE4(>DKE4o2(9G
> (!lkCmb0TGh
> zM$H@%*rxpDN0lB(0*=cZQB=lrv0HUabgLql?k|V7821mpV5k5zm)H8
> Mp7*#_#$lz^
> zm+@|nQXL`aos{#;liPtaCt1Z#x!hrSUlY{>&6oQs6?g{IE;OXXX?iT
> trYTkE2mUEn
> zDt(}bOQ}0?lG#z?{!nI<PpxeS2VzBE>Vc9;S}Z}@2_03Ms<&`Zw}kf
> vYD8ck_pc#8
> zBS_O|*F<HvtBQ6(v(+xr2X%O&wmkb}wWeBp%YDyJ2Db54)nU+9m7rp
> VpLB$Zf%o8o
> zG@dt_9r<o`Qv_OC;QtK?f`3H)DOYm%$fdr@D7YQI`@t=3R&LsrZpLV
> {)jpdK-?QZC
> ze5#6_N7kh;R1kSdGh@}@(h~ih#}ia*Q=(nxe5x6{wE3vjpO-
> d&CxmQ-MGntbXrW5#
> zR&Z_IIwDZLH6?Hpvg%W6`ZVMv2Oc#~Es5>jrUJh5lGvv-
> #zkM>j9``-+qX{z+Fwus
> z9T|O$eCY5Zi!<7%nH>hS`xhN*C`J|qPBZNd&Z6x~tv#RhM6T4|PMxS
> L%X_|}By?%>
> zi~Y1YbjcV#51rCBZAytHZ)$N#?80aDkc{iSr&ZtrV|%jD<We(Q6J>m
> Wca$01s+%3~
> zyd{`##_s05)1HyENAga(vcmhIUB>BW<FqT<)l9wMcrzB%=_{pD{krO
> q@}HrMPF-n>
> zL-U2tmiE&<4;qi2ozt-
> tzWFqJoXsci7r~SObnGl!R1$M5b#}X73%pvX#pd`@0!>Pt
> zdrHOzFegEGO?q4Ii)Y;(uFHKh%te~j*VohMc7Ok!-
> QV<=^i|{D5dq=DI&i&J;|lp`
> zvp+!{>U}qU39npQU^;mIO~EU-nh~66#-!hbUn6N-
> R97>`LEl@YT3|zg3ds9?6Scre
> z_@gKIJ2NRme|UrR?@3oqI4b$n&qH7NG&TJsy3WZPN1mb$g0E?miV3U
> {)TjN~P4M%Z
> z$mHATBXp(J_rk}wYRcf{_bnMHp?xCr#f!C=+!s%=Qx81Ul^Ls2+8O$
> @5*h2)XPSn-
> za;ZQTGB0%u`a;H$a;v)xc&cdUdykuxz(erGuha|;9(W8bP)+|29y4a
> VzT&+KGR6mu
> zMF%!|Z0ELUN<jMmk>^W0u7_6!_59E4j0ZF3dq;%~+T}wJNFDTt)wk$
> MOE*cIb#$Kt
> zkGfX-
> tntsd9*k3TxaPLoj6Si)2DrQ2@E+KX4!N}XyZv(W26B)E4txB#!ZlmX
> &={q+
> zDCKJTTln@eZC;-
> e*B6XQTfSe2kIV0dULB+}hQg|j!_t)25=D3K`@Qh4)L#x?#}DoY
> z<-
> V#PWGt2XQpJvR&e>Sqdm0;;uiR%M$OASdP@JyLmGt%X%Z4QjZ_MeaS~
> 9U$i7dP^
> zAPWMkq<2n-
> ^jC4RT8nQYFfxRHCB5zrkr!#Ri@p<kBJJ|2{1YOBrFmTFS(9feFJ(3I
> zJ%%YVd(aq^FZ#9)93r1(;JhDtMDO;cskPD<Z;e;6AG%fLFVSW4ei`j
> cpnW4Atm}Q%
> zmEip~@Sdh^hiO|iZFBSPdSpXqJW;N^hVpk)@6f5#!0y+#biGC!4(j7
> ten4B-ZJgBm
> z3*=C2gn~ZNo2T$mT*v`>jP?|tz@~fs$o@B1%<2^xZ~<5Rn5VH%QSiT
> oJ`^22Sl<ax
> zYUD~bW6*q1_+sj|yjuL>T`4l_@W^@RCV#tJ*fYk<LI0q7mo|SdB<&G
> CS-hm2CkNbd
> z8&_@d)uvZye+c?yj0%kdwr#LnX<>Ae<;Q9GaZ7c^m(pTB?1a=a7&lV
> SM|*AEa5!Yb
> zM=2{bz~8g;w@V#$cHT}qo%>ZgowLJE%UVswtLP<lw)Ao6g|AD%Y3Ux
> ?@~Wn?rCkC~
> z`rOi?m!O;eXv<V<6~0^BShZFo4J!Q6Tg+X)2`aW47{JV~C-
> qHLmj1Hsq;11jUFsXR
> zhwD3BB408d92{cLFJ!6M1#tNHmc%NBPxP^Y9LTfSP4Q9hjpx(;8Dis
> tR)1%CFJPO8
> z+T{0yA1;aAG8jJ34*b#~@OQi?`~m(5?f!z1fxo!iw_EI-
> ?^Igg0{8x}mxwIwEL9_|
> zv7ZYp-
> (Sb`%#rZ6#O4A0nT2h!eH`U=c#`GvcV^Q^tp$mJtSwnj+B#4R%h>blS
> uJld
> zF2-
> y(@r%ZU4aP(eo;0s$?7g5Xd<rvmgwz=WG9Cu}mG6NUo54K5!iB76@!V
> KCIv_Io
> z2>MJ?t4vS@nt2|@^$gc&E|G&DyHu<ABT4jOA{S$zQ^vT9OZ-
> be*XJms5`&#4a}`@w
> z2lRS2awh$~1)hk0#|9h}8OLsP_*ME$csgSN@1|4Ehkx@$@FE*t+KAm
> &UIo2s+2}wj
> z@>WefgL*zKd6tx=T~^uX;Ifm_19y@Sue^<<Qf@x*uY$QhJs|Ur#uPL
> 5ucUWV#?nL3
> zsL&hYtClErC<}YINa`bZ*4VWC!58*R8N03D9yETmu=Jha+KYeEjw}l
> ue*xXwZ1`S3
> zzM#mn_&n_&L9US>k^cxjj`$+&Wm@2$<9R{G#NLmZv85WiXsp>$;qqr
> zDRt&o;;)Ji
> zRAc)<TQgP1OHLi~ySWz}+ep7DvXTj}q2Y)4&Z0l3!WZ>+-wgV`-
> ^aPM`S0Vl^jrPy
> zX>Umk6^LB>OFH&FkraCR$>h*8cd8iruc%n*^~o+(DLj+89KN&oU}3*
> *7WwH97dEyv
> zQ3c+Cx4~_C;BXbbs>>Y;Zqow6kE&QS(VrRoEO|+DLct`RYc7{7)V>X
> 0o_adIf<4av
> z!J@0lU~UX7;kiOq2B-
> Ox)Y=d{$^W5RTaxH6S38??ML(GuwvtOFAIY_3+{_Fpv9lX}
> zy>{PyFQl7aEiX{P24{R!(B8(SBLk;pTm&C4Z|~UGppqZ!G+uqC=aa~
> }4}K<*%Dh>|
> zj^l@Upy`w@`t&;%|7<xBd!{kpQ(^Igd&P!A&s(kp=Ke`xTj#o&M<j;
> n*H+y%=9uU{
> z8RuodyO+FEdNz64<YkA;-
> 2QTGY3orvi@YrIvcfLlEhbMXbzDU=15&477g&Dli~BzV
> zFC3m358AvFnu3ho;<U=1cJzC(`<@;@&n4FVk{%!TC*f&v+UI&q?whT
> 9Ur#itZIAFy
> zF0&MykXG7-
> kGHm(_p)Y@2(Enm75n*?Zs`Y=ervZ%F71*!QdUcgcB<rPr=k27EC-I=
> zCx=7Z@h85ZB0qB{+xGVF(<4874SKh$#M`6ruv#V0(t=+o-
> >x+8_ATZUKVfVg2CmS!
> z-7n>qKWELKzq6)GOFw|Va+9ZpqiyJ`<Y153zi7G&ox-
> 2BaoT+rd{je>_II||sKDNF
> z%nkCz-
> $efyiGh97R7VuvI=WT(=e)bmvZMCeiO^!Tk$OJp5nc#g1;8+us1BKD7
> ~C(V
> ze|4UP7J06X+hTkt%g2cO6}JB4J^k%<qnmVm4wqs1+h+k4I0!y#9LML
> -KeA+Sz-Gz#
> zd;=N$iqMs(8Y0kQ%M-F|>9V8ykAvH}xB2nCP!s-
> NsoL<IW1||8fttj&J=4<Xbg3m~
> zN3nXSr!hM#yj0i2=f}0}kv3Q4Wrf>;zf|A!T(R2JQ<46}9_jx^o~I|
> P26?yD^mjH=
> z=V9nc;T`k0a&*ZG;njoWHR|{tDQc}RapQB6r%L>tKJu=l?|EyCz1^4
> )dYiV%Sj&TN
> z;@_-
> ?53zc82$*MPs4*=UMa~n|OET7E494)sf;X#}jK!xmtB!@pdmjF;QvO}
> v*^)Q@
> zYi;=0#?SXKS9q*I>Bl}d>F0Z73};hjCOnwlls&%nuT{p0f|vJ1fE%2
> pVn&k62sWY1
> zHk%!7E>*85s>+%t%+M1}4|RQ7jcvI=xmx9JsbW10*?uXhzOmPD+<h_
> XR+;;BRaxy~
> zJ~>*g^(fad4|5)omwfnN&AS|UB=;%_oi8?Gmeu!<p>NMka#d}LQpSg
> EQj=cZ<JZ+e
> z8GlV`%o)=^=OSwll~LxuH;^Z7s2*>2oOWI3jk<EfkHTwKKYD{Vo3XD
> !|0(9k`D)ym
> zU&Z<=O=z4zo%uJK9VW0(;<LZDW!)1=D(M>~H>wW$qcZ9?pOgAeHwnx
> nbliCKQEu36
> z`pci0reeE+FS7T{G;FEb+8L#c_;gMBm@~e2SW7~8$rz2|+lWni?eTT
> Hev5t|th-|M
> zb3$)7&SmcXL(2wSkIkK%p$<;Q=PAHP&;PjD;~AwYC(`dtA2WN7j8v6
> }Nt;RCjN>Zi
> zUT$}=b58o4i*9I;v^`B#4%X3QwS*RtjT7|ILFStI+SoJLt(V02TDr6
> H;{H@ssRO@F
> z*Uv1FdvL$P{jX9~WonMu;YNOS=&Bzv>B-
> vWKkKbcQHNfmO)FLMu~*4|(WMUlI>!wC
> z1O4Bm63^V0pkCTqaNEV-
> KH8T1C2UEXo^ocXG4EnBef1+X;#jekcBVO*c0jvN&AZr4
> zz6pPtRLYs{YD9~F*Sw1&L%;k;TW-
> F_+;Z2#i?7aV%Y8+;>wkpYy@nrmO85v3HM`8v
> zHriA}`8FNd+hJamG1a(N1!9zO-
> U}`%W4%wWyjUGC(@U8$+EArZ&(s#$bxVOS>mzT;
> zxTAkdm2HcB!0cu|V6U}gS?e-
> C;yG9#{8DEY0`pr1=+qAjFV&gl$k4$Lt5^nYQ)0W+
> z*g!jTv^1VQZhxle$!f-&=nswgq*JC}KH`4v%gix`=7|n-^q8Z+#5a-
> kI$tJ!8*??=
> zerAV-7b}p<i^8+GKD6r&_^=|!+3-
> R9Sh2%J*n#TVW(PW>({uKru6)*fg0ydGF1%W1
> z^eV&VQH|H^fcDNN)`}mXAD4n#>Xc5=TAXtEZu49_^JWh=PyEqV=<(x
> |8purz@I+VF
> zf=k9rUAfsIK6eDaPIxag_$VVZh_BcD=Vr*DzZHFX7#;^%v)!I6bi&_
> f#|E}C$K1jE
> z?w_H5HkX0UwEWs~tw`Y8?SEmv@Z90yZ(I|?=;_u1Ykrf={DyB6$=Z{
> qR(0anyhBEI
> zql*Ft&oW2Uq`&gaT`F(mE+fZm5jc+jgg@1ZKh=ZJ)rrs5^AjnHZ{@+
> adYgNvTsrpX
> zG_d{IW}%P1dJ7zv;EhjJosj&5WPj(=>FOo_r0?%hY38o{$?6>Q{7Us
> T*0UojAm0uW
> z`uYw@`Cn2#%5xMr?pM{~-
> *Epb{?>Ntqi=Sf=DN)Da`58^9h|6c?ygz1xNEEQlktMs
> zftE7(sno>BjE7UZ75Z8Fdmnw)#`hX&-
> |wxr>5r_pA^BbLp)Xkq(ORZJv!thm<}|bG
> z5oq2A&BfT6i3!*h=!Vwch`x5?|A=2z%lxZN>1QUhrjws$_Q03Qgf#Q
> Hr+N1XGMAsN
> z3iDOMnIp6>AHA@Z_xW3z_sjhY<jqkYY>)fQUh<7~(k^r+&%%#6uW#A
> )Zguj(=NC8@
> zY~6w_d=vaWzMr_kFSNaQxzD0)D|vQVw^f!tv;6+1_#EH@>x*OXuiD>
> a{`98IN3g-P
> z{X+bk5c;^I^m93xrTB-
> eS#}66sdK*KaOjQE{!GTRSLz?4{upc~_0M`D^NaSTh+m_x
> zU@fAO``9UDMtm#r$xT&!0vm8sa*nwv`#@{%A;!`<=(5*|kL-
> 7FUv2`&r)@kAjtj`u
> zP#g*z?dXFe77lw}KNNmX9R3@hKC=IEll{GmZwUuIeCN`+N>}Dp6eJ(
> bEy+`vrCX9K
> zN=aR5d{a`_O?9OybdTy_9@U|z`!j2lo+5cQjCo02lFD~5<_|7-
> WaX#xZHRo~mx`ya
> zF@9w2ZytP#WTXFNEYY4QW9Bk89UMD7(dhvVU)s9&&EPvv{65Nkx{9^
> aH=0|;c1e2}
> zlZ@B3Cy|GOZ2HMPKC{ZNtrZ=(7h2FW9YgaC@`NT&w#{>mdeutJRLZp
> Sp*7Q@nfGGX
> z<h=*D#c{Y!TbL1A@ADr`?w0ukaL+P?&}sN6dvm(Q&X*cF-
> 7a*!i?r=#m-S87&AjGm
> z+K`|Hd$y~D@FTqs?dnrz&r|8!_qgNVX9d5TGF6NPkssHx+Cq`(>#_S
> !pRFovQVI12
> zZS<*x+XwTPexQ!avLBO{)fBpyO)RXTp4eC^m#DO3uR`l9j3Lo+Z;<a
> o2VKu~(lrtO
> zYb~^|Q!&<ym9oa!-
> etbRrOS*$`#Xj^EO0Ju{ySN}>|clbI%^Z+H^1R>dGE<n6|5zD
> zUCA%*@%i0PGM_%T3|#2a3|;i{=d_H-vg-
> >E;Rnk6OLPVH<`8y#Z5DE}Qs`oxBbl<S
> zSKXek#?*g_w(`xz+n9(yjUOQP6~F4PwnY2;V(^7qUs93jEh^Yl)Qf$
> Qe)H*LQpE<@
> zYq|FKmP?yE`qv}Gh6~N&_lv(j4gc%rO4IV|@sp3|+?W#(-
> +vtMK7%azS&N9~s_FTy
> zYAv_}o?KNqmUkMLyvvVhYyJ3i$>_)Yo!VL-
> >lr_!E%_0A@9R{h)RFSvrd|0@@m|Uu
> z(AGBR*lY3f{&&!w|1xkgROJq-`(tgb!Vmj9sT0-
> K2JtuZf2FNGIo5_(0=$#dDQ3R3
> zi1J5}l_&VlU0p0|MOj|)-
> +cut<C{mPp;y&fe8ft5cOL)x=Ccp&+JxR2Ng1oojqg*3
> zcLR0&9isETt$M$8(Up4)p}H%G-?|6BpQexS{k^hIBL4fPIBXv{-
> ;C44H#du(SLkn{
> zN8SnS@o{>Pflis9($@jgmDQq<cOPp&TY)eA{xz4DdLBHh2f@A=hrKB
> dyUKMn>{{9?
> zu(zXc9QZyx$ATXO{!`4ou-
> mOqF((pVRq&ihQFl3Ql5ZmHQ7Av}%JrJ)t*^OM>K)K9
> zl=spefiJwTj?=?fx~i?dLA>|D-
> }kH&=e_WUI`CfeIy4DAo@+pZgI{QozJ3RPQTQQq
> z@DuuV<3*PJj0wj4T{`-
> pYLZ&JkTE=t^|TrAR^ES%6xnN)`Qi=SM_qYdOFy80opCGQ
> zN(bg`KZvg>4*u@JnlAA3z%TOc+uL@pvxa8tMK%04%z<GJ40GVWF$es
> eKYpigw_Mkv
> zkp?#PS#ZmBE%2M*e;nL$T?_m^@UH~7T-O4>AN-
> 5JE!VZc9|Zr$z%AFcz#jpB8o1@U
> z7Wkv!fBo&g-
> Ev(E{EGcxKL)p4*8;x*{%650*R{aUciGOz!7bOd!0!Y9N^r|{E%5un
> zzX;rNT?_m{@P7>4a$O7j5%8yhTdr$?KMMZWFEakQt_A)LQ$I0fazow
> 9y6VQd8)nPX
> z$EVIJ{P_Jf(+X!4&6qLEp{aEJ@|Ek1*~U#XXHT0sd-
> {xz8F#GSU`(CDzncmvv}Vpn
> zouXHyFP7T*$A`TCaXkO|vMcLF<N0~<{O`=Q-
> #@?R%5sb6+0X0Z>9g_l$MJOWeEWTJ
> zJdMWl9pYBTpO-
> lK=^wLSIe5%CzM=VkhYn_&)*ma4{0%+7@#p(D|II(`E&kLamtOn3
> zr*-3}scVit>AiQO*;bcw&(_ARI}(nc{9?t=v*v&4ql;5+-
> *ju?;umbVg=_6}(d~9>
> z#`71%^IyNs!Ed3x>OZG^q|q+tly~ws4uRw39~e^pD!{`Te-
> aKj{9pDS{jy|8{)ywi
> zd*+?rbl<*v>t9aqnf|R;hn@$@E?qQrwsC!9ib}EW=2b6WxxS&!SiZ_
> wBgq5R_tzOK
> zS69~>%c@t^u3WzAeq-|W%WoK5ysp+*x7sda7av-{fw#JG-
> TMHXTV8%=`E0{5)E#$L
> zE-ahNt@?CH`5g=Im_OT43-
> 6eBr@S=OJ#))T@2udp#ov3^*>YPOPglj$jq!AAJXOjr
> z-=C)2-NU-C^Jm6ySU$7<oK%yitIIj#*-
> 5QpN<Q|+|4ciLC(219R(7uSzxAIvaQpl3
> zQXY7qdQDYzZEaOU-
> Tli~ud1q9R##I$`3B=YI<Btv6GmM_!|Dd(dcNhS+_8F{QMYRK
> z`ump|57a%dy5T|TC#oBE)!8Y=JtecJY`lKuM#ETa-
> ^p#`@=bM;y@~tkb?X}Beq#y;
> zMDAEvMuxGt481;OqvGH2-!KP;IWWwDVGay)V3-5L92n-
> ne|HYBf6MyQ^c=-LNB%xx
> z{cr!rjxIKav!8)KJO3w61-
> rl>{XhF{|5JZXeWBa&*arg?x<^<U|Bncc1LxdF-(Wm{
> z=zTw}@pS~*a4LTeTqoTTpZE9AQ;ys7BD;^6^&GwO*@iOkzdd^yfa|=
> `tc@#dJ{<`7
> zpcC+6g0;EGH<ClaR=@`iNmv0N?EJ;#tNCnxXQQObn83T89GD397+Dj
> nAQ6g1Y?FM$
> z+B|C=-
> rDJ5BPQ1|bCh+k@Hm?lB|yY+Po&Vwf0TTmwdu(U5OLPyv&%P=f7n#rH
> -b|(
> zxDE~yaWfzMtGI6Bz)K{ir&nLnrwESg1ji+Jdi#omba@`bb9AK24i*l
> y?S}Vg+jSqX
> zZ9-
> EDWewW88~95(y!``klyZp2WFrk}fKB=>6WJ)*q*T3cia(bPd}m~XK{c
> BfWJ7@*
> zOz^X5#kBaO2N2C{>)z)IXl(dmhI&q=+lN{PA4rx>zp~-
> Cl6tMW9(Z|#YHj2Y)!jTF
> zTIvc+V?&&e%^msa_5tZ?HVg{y^i+Rm&S?AK8Jifb!_)S=G1j{b-
> ZgR{{wy0PEIQV3
> zu#AIdkJG+y&{k_B1)J_KZFUYf9}YFkCOi68HZvOp_DGs!9RfIzIK@s
> A3hmTA*-l;4
> z?Nt95n}hwgzZ6Lbc6LC&bMSLfiX2q>ZU}km-w@`fkJ(%}L-
> JnWKA+7Q$gTH(v*}4T
> zc}YM83A7-aUZl)lQ6|a;_8_zdq2I}8qjRfl-
> j<DDZF*LH37a`}J;(;YpvZ6M9NtSC
> zo%R*bp3<mBzxX?Amo0t%MK<=d(U&#p$TWSZZedd+@Q?v(lOMRI>uIb
> JY;ji<u%T2A
> zm`Oj&W?b1ID)(|ZfkbA)S9vGFRs0-
> ESEruokqt1K`HhCH9K6(d*4SWZvYAj@mz$|L
> zWTkj#DCITDcQ&0m@MHtA1{{rgk{1ly<)v>5fI%Jj!(k!HId#UsE4Ag
> JE~OSQ4(-j5
> z4oz*)%vkO}6tBZ4V8noNKpDF9w`>}>Hf3_pm{wM>k&|uab0_nIJ*SX
> U^u}Y{cb?3T
> z^i;9o_aySJ-
> ?E@fV?$^a{aBD(wrK%*9jR>Qi}SIsj7`nSk$Xw|gO>;_X@{a6va!4U
> z-
> `dLCwQo1DiMYO*jcO(vE7_E49dPonIsXP^!(<blY^2Vg!vPlZPCn6`n
> @WF`6%a(=
> z^3&9H)obJ*kugZX6AmX>8-
> I>K$H}bbTsb@_aw&Z_lqTyrE%LJg8V5GzJDUMzLzC!L
> z3AXW1z@`n}2nQ#(ap;lFieA|a-rPB@#aQ6$eVzM=E}QsW-
> d}KUm<F5W&Dbxw4_f)U
> z*V)MA$fxvSKVQ<#j(?_X6danN(5+gFPTv^rl3q?H?)I^n7oC(LGReV
> ~_iUHIJnirr
> znARrxuc@^k2G+0P=`VoqV-
> vIR`g)a+%7*NEHi3HO{b~Ba$0lEC*Bs^Mox7gHXx@pE
> z&*4~Um+-)6*t|w&QjvjrIWWSe-F}+-
> 4}QlFu=}YeaNy4jABRo5c+NM~S~kjhrC&!t
> zm+!-7$4}z$<-
> mY!W|L>B7eyEJAp;Tm*&v_I;=6rg*?f#FR8wF2dGJOr;Q{Tm<&F0I
> zE#;++LFkr4ZGPx}Dq^(wkQ3e2JFAp~e!s+q$^j|KYg5{ph%xu#MChv
> F-Tg{G_NYo~
> zIjoY-?0^?Rc(E5aPt(VJY-
> l&B^FwIk5aF?ia<y!w{I|po!Ba>6uGIf74x6i34V$bl
> z(3i5=T4b&hn9|;$99U<=c%we%_Qq9t6>^};r>oRQg!UBG;U8soY>np
> $Z~ddt3GiUx
> z0K22#?Zbz12+6WJY;b*(cFF-
> H@P_}wh9QS_!~ctW(a9WQ>8R&k<ZvSNiwtHTpH6U#
> ztnlacY&Hgu3roKQ>5~(qB0oFCwPD5dUJjzY$3gLdaV0b;WRgRJR{QS
> )4u?%RG?o=^
> z<X#~kazC4UHUQVJfY<m7)_Z9idc52NEd`|2y2jxuTi1se6Y$#JC^*Q
> z8KUQc?zj#b
> zIJl_X94^h9BZo`RiSDq<McsjClT_=GG;B|*_yy`XhsxnAn>X1|DE+g
> K_hN@<VP_=Y
> z#(#9beMs|rArJVt`VYiU<GGQ8_tK`XSaq|IG0Fs0Ai(oX;Qkc-
> %~!crQ}i!E7Dx{&
> zRea)Qc<|TI;>dMJlFBZjOaXL?jF`z<i|ZC_0%-
> }CLe4$tKp!>&o$VE!CkI5?#99e&
> zI_25YE!ZWsMSD_Ud4Ods^YzNRlH<2_8%yl_E61<q{ZR_Cyri+$p+(B
> ~m$76^_sT)g
> z!<5TjGOgF)i(PIYfRD|OOlx!a4ES)UAS-
> Z)1IKcB^6<mz91($HU*s_2J<xVy>lFAl
> zHVkhLymd!nKu^cE(Z`1_&+WR7{yz(E4(ml{MzA5eFn@Dbwkzu!Q4XH
> ?6U`#6zOk?v
> zy>v1O`Q2HvNe-kio{Gd@`ym^#<q(t~zk+cTQ<^$-
> 9ePA5EBL|mX8f=yGJXU7lTN<W
> z(}72Rky5!8rP(Ue!&PeAVz1~w8T%#Z3DM6Sl&JXW3QwVIPA+0IYf-
> +cIKjOfwlZjo
> zdOb0a3G9zR|2*W(u?g1ZRu0%Z!GKOBX;V4eQg6x_D3*JzUO~I24wTD
> %HM+^5U-5f-
> z?1OFxI%)HnGRiA_SH`XN{A*~7_I<e%)IIW^v9k*q<FKKB*HP@h_&<v
> K2={XE!tS%f
> zA@xq1by)aD<Zvtp?(?zr9MH}k&}ZKZ<xd{pAU54TP@EX92JSN)uBUA
> FuaHqA+E%Xo
> z2O9DTG$!p($tpwc(Pfot(7O_zO@b;(J0jj4osmELPEUk`9+5+jbgGS
> qdm<bF@ujtO
> zs!RKOA{_ScrS9qsX6)^eL!QEeSCk4l?Ep6I7&tsH?XlZ5poc_O?L+h
> `Jd-i5&GUB>
> z-
> 6r!M`a@;h+PxJWcrw_WNq@12c`SXrrDtm*<<!`z;N!smn5k9j;T|L1p
> PRKY5BoFL
> zdmVfNw^!<xagcc%`muxq>=Ix{Xe+_5Eaq?u<Bsu|GZlH_AW2D==d1T
> yWnHSd)0O-6
> z9x3ZeYVO>Z6YSy8Zn%9ffjBrM(*AW7+W<^0&EMJH!(qp*5-
> d*l`jOY>rSt*1aPQWP
> zkR0&WImG4!F-
> l7t6o|#L$JjaA>`^K+5t{L>`vVPNCkY^O#fIvzqO789FS=@Q*=Glr
> zwe5@dKPaOj?tlk9(1kBO4WVl+$R+@nI?!609T4Bm%G2X{ylc|4&n!h
> Ys=r|NDodV=
> zPsrgC$=?gFhUQ<XTkM1J5}@L6iRwn~0y3`~ETfiu#_9V3<p>P7R^tG
> h=4bw*nKM<8
> z13D@xQzbT+2XnsOK%aY6dR})nI);yc1j;My&QIIeBhL{TbCYlDQvT{
> L<zDif%E;@E
> zHhqD)a$dI&+SSRtZfS!rn#W;9Ik1@5-
> A>w0syyU<?dERJEw^`hq&$~#DzEzu?1&un
> ziZI3`y<nwTUThjRc)-Sd-
> {SXxJr`RoKEzLx?LZ|a^ogwuo>oP{*Hn?f`Y7{iQ*@4d
> zek_8XvxA0Ydu7grFt<`RFp4tBzFkhuk7*oGl6(Vwm_++!9?LxIpwl;
> U*dubOZ@O)l
> zv%OQO`vi8|#C|BBtQGh>$J77v>;aFKqdMfU)8O|v%6p+p@DWf7y>Za
> N`DNyk((VCY
> z=Ee9%|ADqMfDW|kvn)IECU#l;896lE$)>;7PNSuDsvIH_zal%l9-
> C1ahdGYap|K~P
> zmnnJ7GlB$D6nps<%A42}hi^e>)09o4*dyVK(04a&b5VB;?UQF#r}|<
> 4YaI65^o_ul
> zLrVrSF6G`N&#7}>-
> p6_NkJRbs2|RajiGKtQ1fP>Yb6MVz$OTF%TkcO&-{G-5zcL8k
> zw=Ej7!yh7*z&#Qy#<4X{pozggX%_a&!7sW|c>EQ3taGpp-
> !gnCGppqgd^KtRb-;X#
> zKqaDUE`d{0;e}NnS%cn#8bNNPUmdx@-
> tRobxSvUSg7mOH)*9dKL&m*~7wOx^-)-rN
> zG7pV14>go}%)eq<uK~{o+VH~uWNS<e1j&*4ntkw$;HUT$1VHu5p)HJ
> Dcr<j1--Nt~
> zKk2PS{?(Df?is+05<oB>xWaoLU+iz)YP!gdL-
> TBCzSor<z_zybQva}?`>wQ$jA!LB
> z-<Pql#vThxhVq5+C47mxa=ao-
> 4$mEa30_;qt_%Ma`bx_E4!lmeF*2sorBCc~1S+)J
> za|dN+u*PyX{q`2RH>eMcEvM}B@Suq`0jCc0y4H3A{RltmXtz~|ARs~
> V968@bzEge%
> z<sJSzhj9ji``C8Fq0<gPqlGo#Irv+^Uuo$#bZm5dcLlWi66ePl8wZ&
> e#G)2ovcvc+
> z$dvL{^Ug!Q#V2@LLffa&7mc?4*x5?TIz-3&*$R;v33m3-<-
> T!8+YaM9=_}f?EBJ2*
> zO3^>1tZPXyJIYyWKqcgR$oEVUy!lu7xuQ28!gmwh+e8pEKVur)_4H?
> @tV!92BD1`g
> zC}WL#{7qBVnW(2TW*zx;g0=|_B`Pss^4?U5MFs&@jbyGgRTObu>0=8
> {<U4H1mftKg
> zlq$Mc@NC)AWz#&1K2t5wa@=F!|1rlGeEGyuONP!;%E@|W*%Y&=<~E~
> HiLXi-Iou|G
> z@ebP16wjA6hQW5W3_5GntUxWWw*%XE+-
> Q+CHAVe8;1silaGLt&#);1hJ$~q@!3UN1
> z0{@D(*lPmbk3zfju|vBjUA1^9KaHRw9$+j5S1Gt;9i(`QDzeKZ28ua
> +Dm=(X?^>x}
> z6-
> g>{6Vau@+h)z*xhYxvo`D0N*l&EI`25$>4a(9DpP_9<uEc;G{7i%<89
> (jlA6e&+
> z_P)(LdA3V$@uYJ>-
> &g79^VrrtJ*R#f{=f^&iT!Ur+$A*c%SsF_b(=+{^+ur|+Vh}Y
> zTh{)(jNz?G_*@I7x5!~Pk4tO0j}4*{G-
> qGdypWH6uNEIDMP>Bq1PA8cgbsyl99>ae
> zn6sd;MZf*#!dIAAxR9gfRI}sX;p-
> 6&)k)j6I1iLx*4+J_hoFBpV~wb4mV5+t)#C6|
> z?1l7;;BkRR`s;<;stdu_;-N2H@Y?COp<~?+m|`Ei!!IZj-
> !@9WV;_r5;1)9%YUWvS
> zFMV#rQz?5yeAjq6%1j?x#tEEa+j47tl=jcEf(K3qj&|JBBK^0XJ~^b
> Tzy{J21u8I&
> zwzTQv>L=5d#)r3b!QYH70^9j!n?=D<s^vr2DFU%|5a{7ugLyc3_qsF
> -m-r3hSIK(H
> zI&idtOV*z)yx^;PJpcJyu)!6`DP#VwAobLOX)TK2&cRI8q6!I82HsD
> Aw;!jqCgJ!o
> zw$J*E^gnYdc$BFQ44zjF%$K1hY|FuXD|o2{_7=OQvGy)=<ruPgl6mY
> n<}4B*t5@H+
> zYn=GB>9=&tfm5-|qB~Vz-
> *m+~*+lZB|8;f$t}4DwY(Q43bybvI`<brlM0C#Bwmn*^
> zzucEdAfBZvu%0y?@*mWgPl)||aFmLT(-
> zM>bSY_8zDu3+Y{YglCsfD{ddoWk_>yn3
> z1|HG<1Tq+3q0RP}AJR3inw0HD4q0DP%qIry_|SRpV4tJ_`8`~r9u(a
> ta_;C<WU11?
> z4yb5Spcp<^LR%waSIT7NF?VBpHWBElajdLMW_g#>U+w#pW#_(uO?6;
> Np7?y&CvP<{
> z2`af;^z^4JyPM_hA{AHyV*@a3ooKJEl`uX%_&UwlEDtu0=YwJ|Xq#n
> 6ME)ZLFu%0<
> zZ~G6KOMi-NS@Tc&P6BzFto5CupTz$VA6VA&B8(N=SI-
> KU#%U5cvBsk%OFxSH!~+5K
> z4iX5jU%%lGiyXI&%H1dd9tAc&{BD&X>uUt2DP7z(9z4=^@h^`!{7fG
> aID<dWJiRp^
> ze#(3{0(~Nb8a7dA;5$U@DBq`ou9Bis_-&$lJmiU-319PhmU%-
> K^$2vw0dVV^pEo#B
> z3w(vPNZ*TWN>C^XvMl*!&=S1dH@#oqSOIwK;Cz=h+X1<pHB8~%c-
> rEFM-|W`YX&ke
> z6+A)ua|*De?LP1ax2ZrHWhH%u)DI3>)3m=exx7+-
> 4Kzvr+I?#WgQA_~PruVQu9<nw
> z;Q8>kWAKb1<^sRk;+a1)8T^{)S!_=;<LT$z3%qymb3|STubBz|L@xS
> eJib0IbgUE}
> zpclm!pLDg|>)AMAs<cf4-
> |QVH!945$jq<Go_~GBt9>#K}l6F!C`LpD)0DoQhVbUMs
> z?+Sj=Wdq+FY(FhnqXKt=)A2=|c1r$2@`aA}(bBK}T~fx_X$RDE%Gv#
> )vF@kB$Dl>#
> z)oN$eCQrZZnlE&C^;>NJ&*tyZ{f@8YJPSXBPLVNJ`W@(o1C|{@_9~m
> z*_r0J$IGL7
> zu%U*vn1Xdnx{#mDD!z*fABywV@V$*-
> A6xP(bo6mC>ro=hCB_lH)w)(hv)b+z_|&oN
> zk@L+gDOJss0LK#CnDwx7z7=>&jYzK0kZ951M?WU6h>lQ|r}*}B+LeF
> ~aEHqh&dzfC
> z|4;co<xXu{%vvJBv?ig4w)>I;+ZNOm;xD9c+cB}lhaOlB4`*0%u6s|
> y|LX_ci{B%<
> zcxd{U)R{aeU+PJj0`e~56Q|&RACkV2XTEEFl3+$onLP63UQ)OJ`Amz
> (MQZJS)(qWz
> zm){<_n#QyAn*_y@prA6RoCEA+(j}xaMg_+v?B+I}MK6AcR54E!JumO
> 3TY&|S?C;?j
> zIq5W5i<ENk8=0}cyE#0+2fZR~5x-
> yF5v&Xt1NuwkNc2~Q`1hrW0kLxuY(wU6MWo`N
> z{TBQudi!>NmNJ`NvjV@Qjs%^%h#h{7^!t%nEjiF3{VhQ}@?A-
> 1f~+S$wQOUd=(!zy
> z_c^R5*YmBv@>>&B=4oVxaeTmouNIlGrRxUj82CYZC#Z@M(^b*Jye(Z
> GO=~GA6#tX;
> zAcEOw_(vYv_@jr-C!Wqv4DHVvb;H-
> 6NeUUi#s6zj9n~(?g73xhihoyiz0oUcgE7`b
> zk#S4bL{Ajpy9&I$U#1*^ax_B~iO>2IbVjI*^(fXO_kLNvJ&g5wKBYZ
> *J-)*JtUGSl
> z*J5@&oj))1^<p!22tSAKFa)M>r{*N70CRy1nd9?qY}{M=b*bCXB{70
> 1$TySc$y-l5
> z58=N^&=Hx(h>qG@ql>>-
> o{SC*K52FkgrnZa_|fnQzq!KmyreR(Y3Eyu%y(q&T)=u@
> zDfYeqx=#`WtcbSBoc$DY^;68%nPWT_pOftL;J-
> <KuGb3#1q3g9k@Xqmr2G=8pLI*w
> z3-Vd|Q~VT-
> _J4`?o0Ru#l{xOHj%wzx1<aS1Vq5o;r;`W%*ioKE&ut~u8Ly@4LsPAH
> z%oSNnJXnA|E+7?svQ*{U@0ia?`BJr`e5umCR(WGEj2ye%q``UP>^yY
> X0In=MZ%&+!
> z1%uy>wBMP7^U|z5&mz`o!LLD+M~#{)?Gqg+vMOt}&V1VTu^roI`-
> ;D%e}pfxj^_u4
> zV$F=_g9;r#276<@!#*q8BYDo4du3=n-
> aGY@2G^s_cD;c$@@#af_$p%S#P9quus}H7
> z!X;}wtS63U93Vftx@7%N=z|6gew?(|3mHqrCp6v@h-
> )UnJ+g&92mfpFzLq*-C&UMG
> z!6Wg-
> d{PfRBkN8B>wwNT%>f$4FBJLm$yx{f5&WjTZs}9KGvVtl(NoqtXcD+W
> 5A*R^
> zL4r?;?~U)e$F@T@Yz@DLV3x=5jnC}Et~h)w1&6g(K);&65cnqWb!ij
> &#?f_>7jX@m
> zx5w@K8hljumZmNlYdTl;ib)&cOZjQ}_RCnR*;KQ!=9ZE!Y*xL;*p@5
> y&BMBZN9JRc
> zD=5sb&<xGHlzRD;QP{>>;4NKIyRlApx0K$ZD)#mz@f};MK<=m48oIY
> w5wwx9T*Z3N
> zQ_6gBJMal0RgZsJ$=p1nN%j^oeh+`rWzC(3`T<Vx`4VV9e5<Qlba&G
> xW25XXX#?h9
> zzeXkSJ@s*)^*uE@t}WN*fi1fPU$W-
> 8A_soxDK4P?ELS(rozlM!?}XQ^<y6Rez3ios
> zxiLOm<w<1DlW|LTv~PE3wC`|_!CIhluY1mr_46#|1ai;5H3yFMZTAD
> vg5OkG!n`S3
> z)iwZ^ptQ2@?cHb-
> x_&*VE$?1`<9pVZz&8TpU*a$#;5TL7rtCVhhv+0aP|KXqeTp`h
> zN}FG?X=BVhCf^ve%)I_~+B_bxpZx)~nGgTIfZ93u5@K)tx*bsa1$2R
> |OUSy<9}`gf
> zC}Y_kN4DM~$kzu8njJ~GB4{?_r~I&6{DOgR^`d{o=NB8JWPc$)`fwB
> ;+Vcw5-6d~&
> zTHw3nbz+OoA+J*ZU4w6z-
> tex$w|lAQV?J@zw$tLj_kR=fK+|7YG}+%D#7B|66X*&2
> z$KM}(`#yL*H25|?$5p|%KS$os;M<=j&uU*ZEg*G-
> $BwO#HGF7B|Fo6+Cj}dvF=v(c
> zjkfk6Y=kF1=y%43&>Ljj4F~2H9c}mLy9MSp#Fm-
> rT?2DF@7^siw?}LdI!@-*&7=ju
> zFqgywb929xzF;4-
> 9hjSEzCl>BUMGEoZg2u~J2=EH4i3z13SGX!s{(UBboH1C%b0n;
> zz}%*5I54-
> uCJhJX9uCYs9GLr$56ry<dpkHVxA?ljf)5y&`_<9EKQK3C`t4pkF!#~
> n
> zz}z1!F!#=MD=_y4=58&lzYx*2)xg%soXYn;fw{GG_HGb}R!g_fi-
> >Pw^b~cg-UoLX
> zJ=a<L-
> DMsi`R54Y%X)8XQ0BI0i>SADmq$JHoObrQZbN5ZA^yg1@KdB5Yf7ztD
> F-Z%
> zTK1d<EGbh>nUn8Yrt*q1|3;bfz+r)>m5oy2s4LSBz)kuqd>wiI4^oR
> (wdpyBRv$Qe
> zsP_-
> @4qPw8hs%^bhQBNMFUIr#k^Bt!BxU|7UIt%t+#eczd;vd{;RGMwz`YZ
> EoIb!`
> z+s{5m*~7=W59>t2!wZ6Ivx-
> e9zqR|{o9^v;Wt%$Z!+&_?33X0mo?zvx1v7hTx6r0h
> z?yo1RbeZ2?-
> fW%s*e&(X@?JUb3skzyPvz3Me(@+jZ~*WB4P3f;YxhL1Q(w*qxtW6`
> z0Podt>Fh<%XFW{?_@T0{U$mGp*-
> Ld;$$r)e;ql1OVfI*^Y`H6>nG?DTxK3v+4!M{w
> zxyv~>^eB7ML{3;EeRZ53`enW=^sA4!L%+E(A@usJ#L(}GlR{_bCx?3
> O96=E4l+c@1
> zsiEHc(?S<lj|{!@`B9<FlEUtuCKdYyG_bB0NN25g^p>iw^xV<m-
> *vds|7rP}!vD|;
> zXSG~X>AzV%zGC&l6}>;+VbhpSTW;dYq%Fr^%m{V*RcyX)ezQ&En~zp
> };w9P-Uv@Ev
> zjUD4&cxFGhosc#K>3<1E{{_+lYp$;c-Y*!vl-
> *2O7yLGlPv|xYP%q!eWM6GFw6g!U
> zMfz1_bvxz8QBHT8vCGUWO6dbr<)4uE1@smB5zdtQ{d=tax5=#iasI=
> Trt{sny4RrG
> zJie(!$Y*>V61=SCwnoyl-
> pj5OYp>><H&y!6Zz*ufk7gBiyDqnNx}t}BN|h_6jlJm+
> z<fz$Q*2`YP6wWWz%h@G=M7<>VHOd>GTij)&ncsBiVZ8yGv@_<;ZPpL
> y2#x)DMt@%U
> zVb%a-
> Z9#jdYR3_NKvdtN?Pw<zIQj3i?T}RF^b#2T@8Q9IF6MGFXM(rdG5R79
> pe?>c
> z^QDtD#<4K>=PQovcjhWmSJoZ&P;YP@_|U4*Pf9)foQmrwr;g~PCTQ{
> ?<0B@Up%G?I
> zx0h?QSrQseFzqQ^8Iwvwcae@zx!oxrD+{HR<aMW(=X9q{pA$+ma=Jg
> xHR_hRp-}|w
> z9=$K8JAKZ)&|>le$Eh=UerVzG@!c!9Miwpzja)}rpTJ)j8hsb=xiTi
> *7P?8wMsm7S
> zmYA`WuZ{0cow6wO(XzbmMO-
> 5bKNT8Dx{7PGc}HmUl)UaKi}Ng98cpJdgGOti|IGLi
> zzDJWx;FJKTlyO+bIGn>coXa?z$2gqNI9$LuT*x@Qjd6H8<8Tq<@Kd3
> 8n#@>UNly1W
> zpT8p{a0oz+UXiu4HuOAuD;X>2T2!oO8#?C)cZD(;`|0R`o478ZCkOw
> qLWFM$m&p5|
> zKdf+&@(F`}SRur7l(Dk?=W5N+A69slck;su&oGwTS?B%#;fEDoAh`Z
> Nx>Wi<j!`X9
> z*NE_B>~LwqZ7tfQqkGs_vWvYG=lC8`nSxx(T9BrSx>@_)RmxelNmI(
> Y9!Zbf`$gmX
> zx#^zo=PuMnct5;yWJQMOXs%_4wfqyejZgvkA(v&W>E#1M@&%6c;}49
> ZxgXV%ytnhC
> z53i|=dd{v?-
> k_zQDJA6`(768h4`2OWejuU${idtmpW^)u&{~F`Sdpw=Vys)w+v3k+
> zKmRBHpu}Gwqsi<&OXBMPaf#XJ^VuqfU6${w{XZ_j^I0RR6-
> l4ztmA#4ADRGG{|`+>
> zOa3%JGyx8Ll!HQ_XAllq18x8B@<S7mnFBvGVa^)(p@|6hgMMh@%gFP
> 8jUSpAHSj|d
> ztO;of-
> (l~B_zz7?i2u;UgzkYKnz;3SerRIA&lg)?rT+9k8sXsa<DY2pAEuD?X
> OaE?
> z5kDxAl{x%_5`2UE68&F2{DTtK{t}I|t;0VkAwT+O|8R)x=P&s$@PiT
> s_?z;*c=!h;
> z)bQUh2ZlNDUx)+eF3Q>WYxnokHOBup*BJj}*XV}^oE~3$joW|MHO7C
> _HO8NEjr+fE
> zj;s5MZwGg(bJ4QC%2%q?xd^GO-
> ~BrFr_&J*{+A@+J!|kDuIQr~p;LT6V2_b?9-IAi
> zfzP~!50xfoLsaFx|3O*S6WEg*jy9Rk>8#tA@XbN?^qgk>Kd2X<c=ZG
> JtAqb<eh>bl
> zLHK8X0Q@ih0r=bhg#2~J`Fo{K`}@BgN&ioa_dluh|MEW}eGY!~!29<
> 9Pv0Eq|DXNt
> z_xFG8AHaW+fAqln;_n!Q|Jxq`|C~PnzvoZL-
> }mZwC;yN9!H2@3Klq^3jW)=|PQb``
> zdN!Uq`9AxZwLrF^YN|l-g_6Hom!01mPi<gV|G(xv-XD+WzZg&R-
> lN>r5I<N>B8zzP
> z_qwv_OqsjrCZlovnl-B%)-
> @U>B@H#pW={Y3>QyTr{DiUC`uPl_v2LBQl;6pyHSSwk
> zeZNswxuk009c7E|o-
> ?<qq@=uT!L+GW<#Xp(7@stz5cIBe(X^Z5k^1LaG2WN2TE1?1
> z^~&X&Bq)Ew`c><eKTrqEh7HSW>g<UA3s-
> I6eeG2*YwH?o8kVnFCxPPEq^RnK2db)}
> zuc~oFjcQz1Yo#f7ud3U)rmkik;r*-cyHAik$gcw2x7ui2SG}%I-
> J+|65ve0@${sVe
> zxOj9%adGj7a)@U^I1}BSI5v5#{H3JvU&h$cDGnj)svGX7(Q8(JzOKP
> oS+}8XrEwob
> zG_G%4Q@5(tSiPpMp?V!r?Nihr_iF&4|9rX4|K@nw5>LMpPut=t?X!N
> -facBJxUQ~Y
> zRrN}vWGS6Rbo`pS<r~Ofy^1jR5*@#KoiTUOG!G&5jk=9Bb!&t~id8q
> RUiHcA*Bgxw
> zuBvTV{XpF(rSwWd<=cP8m8mTr9DVEmGvjx~LsCoLuP$e0Q}oKz;<*j
> LjKldrNlL?-
> z<<n*x3s=$hhV^S`_UiT0*Zf2PZT$po{jc^*19rPl-
> (~l&)5w2GwV&N?`~BJY`^q#s
> ze`7qIa(r}&)Hyr#%K8qR$<yq7GoCv6U;VJ1U;7a|ofJ=<_rvKh2ZlK
> ?%z<GJ40B+Z
> z1H&8`=D;uq{yT9%V?(HT)@*RK{+u5ia8iHR_KW-
> HD+lans@Z?f4taL+<EibnzsnB~
> F{9hQUX+r=2
> 
> literal 0
> HcmV?d00001
> 
> --
> 2.17.0.windows.1
> 
> _______________________________________________
> edk2-devel mailing list
> edk2-devel@lists.01.org
> https://lists.01.org/mailman/listinfo/edk2-devel


^ permalink raw reply	[flat|nested] 34+ messages in thread

* Re: [PATCH v5 edk2-platforms 18/22] Platform/RaspberryPi/RPi3 *NON-OSI*: Add ATF binaries
  2019-02-06 22:39   ` Kinney, Michael D
@ 2019-02-07  0:52     ` Pete Batard
  2019-02-07  2:35       ` Kinney, Michael D
  0 siblings, 1 reply; 34+ messages in thread
From: Pete Batard @ 2019-02-07  0:52 UTC (permalink / raw)
  To: Kinney, Michael D, edk2-devel@lists.01.org,
	leif.lindholm@linaro.org

Hi Michael,

On 2019.02.06 22:39, Kinney, Michael D wrote:
> Hi Pete,
> 
> We have the edk2-non-osi repository for binaries.

Not exactly sure what your point is since this patch is tagged *NON-OSI* 
in its subject line which means it is intended to go into edk2-non-osi, 
and we already went over what, in this patch series, we thought belonged 
or did not belong to non-osi. These ATF binaries were determined to 
belong to non-osi (with the intent to remove them altogether, 
eventually, once we have the next dot release of ATF).

Or is the issue that I am submitting non-osi patches as part of series 
that is prefixed [edk2-platform]?

> Do some of
> the patches in this series really belong there?

The current consensus from previous patchsets submission is that the 3 
patches that are tagged as *NON-OSI* in this series are meant to be 
applied to edk2-non-osi whereas the other 19 are meant to be applied to 
edk2-platforms.

I have to say, if the issue is that you'd like to see an [edk2-non-osi] 
prefix for these patches, rather than a *NON-OSI* suffix appended, then 
doing so is a bit of a pain when you are re-submitting a large patchset 
series. So I do hope that simply submitting everything as edk2-platforms 
and tagging the non-osi ones in the subject line is okay.

Regards,

/Pete

> https://github.com/tianocore/edk2-non-osi
> 
> Thanks,
> 
> Mike
> 
>> -----Original Message-----
>> From: edk2-devel [mailto:edk2-devel-
>> bounces@lists.01.org] On Behalf Of Pete Batard
>> Sent: Tuesday, February 5, 2019 8:26 AM
>> To: edk2-devel@lists.01.org
>> Subject: [edk2] [PATCH v5 edk2-platforms 18/22]
>> Platform/RaspberryPi/RPi3 *NON-OSI*: Add ATF binaries
>>
>> These ATF binaries were built from the ATF source
>> (commit c3859557)
>> with the custom RPi3 platform options detailed in the
>> readme, and with
>> no modification to the official source whatsoever.
>>
>> Contributed-under: TianoCore Contribution Agreement 1.1
>> Signed-off-by: Pete Batard <pete@akeo.ie>
>> ---
>>   Platform/RaspberryPi/RPi3/TrustedFirmware/License.txt
>> |  26 ++++++++++++
>>   Platform/RaspberryPi/RPi3/TrustedFirmware/Readme.md
>> |  42 ++++++++++++++++++++
>>   Platform/RaspberryPi/RPi3/TrustedFirmware/bl1.bin
>> | Bin 0 -> 18801 bytes
>>   Platform/RaspberryPi/RPi3/TrustedFirmware/fip.bin
>> | Bin 0 -> 41714 bytes
>>   4 files changed, 68 insertions(+)
>>
>> diff --git
>> a/Platform/RaspberryPi/RPi3/TrustedFirmware/License.txt
>> b/Platform/RaspberryPi/RPi3/TrustedFirmware/License.txt
>> new file mode 100644
>> index 000000000000..b98dc643227e
>> --- /dev/null
>> +++
>> b/Platform/RaspberryPi/RPi3/TrustedFirmware/License.txt
>> @@ -0,0 +1,26 @@
>> +Copyright (c) 2013-2018, ARM Limited and Contributors.
>> All rights reserved.
>> +
>> +Redistribution and use in source and binary forms,
>> with or without modification,
>> +are permitted provided that the following conditions
>> are met:
>> +
>> +* Redistributions of source code must retain the above
>> copyright notice, this
>> +  list of conditions and the following disclaimer.
>> +
>> +* Redistributions in binary form must reproduce the
>> above copyright notice, this
>> +  list of conditions and the following disclaimer in
>> the documentation and/or
>> +  other materials provided with the distribution.
>> +
>> +* Neither the name of ARM nor the names of its
>> contributors may be used to
>> +  endorse or promote products derived from this
>> software without specific prior
>> +  written permission.
>> +
>> +THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND
>> CONTRIBUTORS "AS IS" AND
>> +ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
>> LIMITED TO, THE IMPLIED
>> +WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
>> PARTICULAR PURPOSE ARE
>> +DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR
>> CONTRIBUTORS BE LIABLE FOR
>> +ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY,
>> OR CONSEQUENTIAL DAMAGES
>> +(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
>> SUBSTITUTE GOODS OR SERVICES;
>> +LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
>> INTERRUPTION) HOWEVER CAUSED AND ON
>> +ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
>> LIABILITY, OR TORT
>> +(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
>> OUT OF THE USE OF THIS
>> +SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH
>> DAMAGE.
>> diff --git
>> a/Platform/RaspberryPi/RPi3/TrustedFirmware/Readme.md
>> b/Platform/RaspberryPi/RPi3/TrustedFirmware/Readme.md
>> new file mode 100644
>> index 000000000000..74bcec7d1f12
>> --- /dev/null
>> +++
>> b/Platform/RaspberryPi/RPi3/TrustedFirmware/Readme.md
>> @@ -0,0 +1,42 @@
>> +ARM Trusted Firmware for Raspberry Pi 3
>> +=======================================
>> +
>> +The `bl1` and `fip` ATF binaries, found in this
>> directory, were built from
>> +the [official ATF source](https://github.com/ARM-
>> software/arm-trusted-firmware)
>> +(commit c3859557) using Linaro's GCC 5.5 compiler
>> with:
>> +
>> +```
>> +export CROSS_COMPILE=/usr/src/gcc-linaro-5.5.0-
>> 2017.10-x86_64_aarch64-linux-gnu/bin/aarch64-linux-gnu-
>> +make PLAT=rpi3 PRELOADED_BL33_BASE=0x30000
>> RPI3_PRELOADED_DTB_BASE=0x10000 SUPPORT_VFP=1
>> RPI3_USE_UEFI_MAP=1 fip all
>> +```
>> +
>> +This results in the following memory mapping:
>> +
>> +```
>> +    0x00000000 +-----------------+
>> +               |       ROM       | BL1
>> +    0x00010000 +-----------------+
>> +               |       DTB       | (Loaded by the
>> VideoCore)
>> +    0x00020000 +-----------------+
>> +               |       FIP       |
>> +    0x00030000 +-----------------+
>> +               |                 |
>> +               |  UEFI PAYLOAD   |
>> +               |                 |
>> +    0x00200000 +-----------------+
>> +               |   Secure SRAM   | BL2, BL31
>> +    0x00300000 +-----------------+
>> +               |   Secure DRAM   | BL32 (Secure
>> payload)
>> +    0x00400000 +-----------------+
>> +               |                 |
>> +               |                 |
>> +               | Non-secure DRAM | BL33
>> +               |                 |
>> +               |                 |
>> +    0x01000000 +-----------------+
>> +               |                 |
>> +               |       ...       |
>> +               |                 |
>> +    0x3F000000 +-----------------+
>> +               |       I/O       |
>> +```
>> diff --git
>> a/Platform/RaspberryPi/RPi3/TrustedFirmware/bl1.bin
>> b/Platform/RaspberryPi/RPi3/TrustedFirmware/bl1.bin
>> new file mode 100644
>> index
>> 0000000000000000000000000000000000000000..e25138828d0a4
>> ddb24772abb1a60eefc334666b5
>> GIT binary patch
>> literal 18801
>> zcmeHud2|%#mG7;pmedFVtpy|tJ-
>> S*z4DF582<)+{TLO%YF^IMyw%@2*ivhC;Enpe2
>> zRTA<tmgA=aC3r9swODMrCx7^1@T3zb2%DK?Lf#29G?V1z4J{zXv79_
>> ;z^G+F?{}-Z
>> zge>Dp&Ya2NoOkF$@l}1x-M+hhw@Q@U820D96C>N0$f-gpvNVO-
>> 6r%k^_LFjhV53f>
>> zzYYB^p(#wZhayBm(40?m)v%ZRF-
>> jkU{?@RJdpUDVq_0@Qvl>>=KM8BSMAN6D9c2X^
>> zv}!gTC9-
>> IZXdTh<nuF*_F~<Dabe@Q`4z%dg`yWETSD&vxw>l_aE5oz<u%x-
>> Mt_I@=
>> z6^f(*?g@d~PT~5aNNv#+%2G)!>6A)Ol0}J=O^M4yanPmrUEBE6z%_}
>> qi$f`XQKFzu
>> zlVZ_?G$rnX41{DgYzORyWMj?6p-
>> TMP#*g+gylWdj3`8X%sIOlv1lmB)R$NV@Mf2q+
>> zY4d>}JWrcSYDNxGR%4SA-?^DI?>kETG0>;<^-
>> cF@D)C*r!0X4PiJ}^Q9sQugsR%T^
>> zW2zF8L8m(ZKusahN`})&<nhl?LUy9+i<w(<d3`h1M5RpU#l^0`wT*}
>> SX*21%1imhU
>> zPUcNemAKC1ZY6&CX)*AHBnEe$A?>mx1t%~~5>0PQR^krEJ6wr3iAo6
>> aZSmWc_!Ag6
>> z`56X&xUWmf4DJH$r=?NBrxUaj_-
>> e#D|7a!d7m4LPR23=2^S_NbBGxi5Ce4?hcK6f$
>> z3TXVu>I#)XZeBsnU^%~vzTYcJS`*qLzY-
>> q@C2Lj%?d)EP7gLhfKy+cZh2moYa~$X{
>> zx3%XUwhAHXdf#-
>> #Z|vK6?76XLKQ{Io`^9@z>$YethdSW8QZ5C&;8{(g13fpB7t2Z#
>> zv}wTee+aU&&~*P;CC>ZC@)`!-
>> q9RS70s5}E1#NvkX*|Abte|y4K4Ov@&cGb(htrS!
>> z?UHhWQSQh3M%HhErgcf#{e7FzN8o|+H4LXX!y1D17Ravw@_ZjU`DI^
>> Uc2vsJ_nzf=
>> zrMw8T{AXPU*sfUT3wKkT?+aC<bwGw9De+Pgy0M=g=$J0&Ya0&+1VIh
>> 6-ju<Pc#Vv`
>> zxVG`oUb4_488RjCX~^+rc9W#N2)U@RbJ%UGLl!h2_J5$wD2esZiB|H
>> 98rptaG+{Rb
>> z?`Abg<Nbfx>k5sBtYoZHy#nk(iF>b7Kn7plG-
>> GWM_MT}fv`}>i_+g$!>kYVAtMjMZ
>> zKkRxSPMv3q!LuE3blU*#eDKfoFz*JxKk3(-
>> OVEQ%;4th*3YIr1fsrJ(5J@e0*s~Mh
>> zd0nc3pKa36?~nW8oE_jZ2E+0tU<o9&L?uhm`e)&NbstQ*jvlxV@Ues
>> Ufo;hxCu;)y
>> zb8)?|=Zqvc?PTfhg!~*9(h6;K!PVE-
>> uN%59sIE}y(y=|nx}e_B1%~Bnc7=Gq3awQA
>> zngJu7<>zV^LM%V#S;F3RL3YfS7qNwP(4B`1epbOV&*!-
>> U`W><occEV%(9iz15;#~t
>> zHv{J~&~p)X+?PhxycbtSQ~c)^@_Yhc#^cMuUlRBm@<L_LSt-
>> f+2f*6{-VTB{A9%B1
>> zY&>*>{SoGslw<yPvF^amWNq8$n~tBeQ2Kr`yX9x#wXS|#&+nm!93u$
>> yvEMu`Wd$YZ
>> z0sI*FDLnam*tH7XfB(4|J*)!~;KDY8d;0peMS=ec{NW9KF#I&jq?|9
>> S5-$RMEEh#I
>> z^i`J+#@x_ZQ%2^P1^vx@A)XauojPD0$28`L<)q6J^Bg(AorrNhU9JY
>> bO#6$Vk8PA`
>> zG-I1?2mTbz(EWqD?jJ-v(_;wwMQRF*7Jp2<MDeJ-
>> Zl4U>xnU~@1Li!YAs@Crw^@mE
>> zJEv8N!xy*iIXqtPFMdslV^5CpSP{AOIqo-<I9)>j-
>> O4@(<co3b0C4Mm2z>pGL|JCs
>> z_Scg326Vj>zPQ7#guJ=UC5TLVy!49XQEbg6O5#}+;Onf*7m-
>> !0mNBN=N<p%=2(THy
>> z`+O4T8m*3;WR2sS-
>> uGaVW;O5q7Gu0M33`<nH~XR%Z5QzCFpnl{4+19pY5m!gq7~qI
>> zD(E!j%eu_A$MRtv=G@_OCdDsv4kEhZGkH&-
>> Pcn3lpE*W%Nh5=WiGDBijN|Fcx^87U
>> zFCz~a9RI%&eyS_(7ziKFCj2`G!C(E2@DqL~LA#o7)iz%5+r}}~dpbq
>> ?E$-E1S6ufq
>> zWYzslANsu4kyBufTd{&~mmve>Q$5%FvW<L-
>> oTf}NB{e(^`_Wc5M9bWi`L^M2g&^Cx
>> zDrUA^fensqRsvDTMTY(PA(O`EYI`n=g#1N`A3|%|8{6KE+~_9(LH?@
>> jw>DWdQ~o5Y
>> zCCK+eYQ7j!pl>qyYZ_h>Cwf!Shv$Y|3VDZ9h;3(06152rzgE&E_-n-
>> MZDBF`ZcHI1
>> z<UlNH)MG2+oSLDHfG#L~SMH~*ZDGP3pZMRVh?&NGfhc6cFxPgNYtu3
>> {2&rup>r&s9
>> z8Dulo!>&Ve8fDmJs#eXpdo#6Up0{e#7UT!IFW2?2AWM4-
>> F#Z5qXW(MGng6G8uYzxp
>> z-YXF-
>> N~n;;mHn`Om!<2yU{gX(;2CpZQ{u`_6W9Ea+GfBcFvofh?m~X#BzP{-
>> We$D3
>> zw$X@rr=ioFC%dpG;1$=7@S!As%#CLUiAMzZ4gopP=p?r5p9FN8ZKE_
>> (4`4T~wJ(j*
>> z_vcyQWcnR!r#Ksw4Se>K_P2Om3_F89ZA-
>> &FVtO^(5%$Bw`PoQ?G^}@8aj)lL$TPdx
>> z&H#^gkJ2*03)>mb8I_m=o~P;K%d@pP=;M6rIlawvehFL*hv)ReIh(C
>> Li19Cwo9XL*
>> zkfU)d(C>S4wCRbpld<-O-G02cQRn|A@%#sOXq=lf-)1f~R-
>> i2Ajo{P#z->nibm%@!
>> z4cmYVdKw;%wsZUU!`>x<SSNBN{|9e|qd(Xg>qKtk{q~z-
>> <$d&X&eQuwSbq0lOvHTb
>> z-xlzKSdbiK-
>> %sg$)?2@i&vyLGd4NMr)8wVz9wRo~$cxxM1xrE1kym^ix!8q6rmkGQ
>> zL+b&r^Pq3rERYN2g&^9NiT$ceRzkYZ16%^!Mv*cuL03fNBp(qS5a+0
>> 2j^*W@X<B}o
>> z__kQ@=s5v?33%*j^)WBwc!Bj3UcX)~;q!<$gKcw^^G)DjnIS&vd-
>> gP1$fd*&+ty_{
>> zAUFFJ*0b)JI>$7yKj3&j9kwBW4#c309iX3O(&cZ=Xv)z2eJasNXOXS
>> =xIm+(;4D%t
>> zlbYKIzAQ9yN+G=zQ*CN4)#qhwhJPwfb02R<j>P&<4Et@LK-
>> DhrK$J7ZVR0RIytV8&
>> z&y%PzEakov<9Sj_V|Z7NKjt7Q=-Ub3W-EyJ-
>> a(Fuc|w{R_Qeo4U~i`-(dlhMj$cNa
>> znykdjn$qDLp)=r9w8G!P9_wzRW5|nPx0LaB@bxS|Q^!7p{&IfIGHJp
>> Xby_rz!T+Sk
>> zU!#8$`VYD&g7c`x=kFUiz*qFxS%Z1-snu+Ud<GQ+<$m(BKS;@-<i--
>> zA8KSGC)x5M
>> zIpEpcU-
>> %S{JmHb!r23ANWhwM9FA{Bd1vQ1dh!;9eU3t(?)E}aG5rGPD<wZKscA
>> zB(
>> z`gS}JaXk3waR<-GC7;H6*!C|#54R?-
>> ztnBj$Uk+xhn{fj&8GJt8$AzVd+UO|nYjnY
>> z?H<74^Y#8~ecLk0I1eA@IQXp_`M(+SL1*IZ^rNrp8SDl&;M|FGVh7?
>> p;+gY%*uMt>
>> zhkcidGdah4K6`fDsl*=wF7EHdS(DF%9Yun+F45;lzOeHy?7e`TaFh~
>> SEU6i#MBSf4
>> z$Mmykxp5Y4f{j#}YXGAb_l(1V_I-
>> |{&~4VC4<u@19h?N)p)dQU>oV)Nn}5;IG=?Ae
>> zpr5CXmgGPg<mOhD(5|g1fjw_q1Mfc0eqWi%F~lm7hwTb6!I=lREI(C
>> LW~#93q-1Jq
>> zOD63q_QStf)DD)SZXj6#{>_5szYBgTS<Uc2jlPuPfImgVH5-={=-
>> 7<93f5WRV_4s>
>> zZTy8!TZ1e``T)z6y?q>22Otak&tZ4TY6-
>> PA=Cbcl1e{fHk@ZlnK&U&(c^dIKr{45)
>> zKMjb=TP69(1#};QTpGE~d$sN{+8Nl4;D4i}BebiAtgnaVv+u^-
>> @DpChF%9igkfCme
>> ziQ16^dT>s+p$~PLvERI`pC^PMVn~qd5Is1<6oH;AQc~~>DFrqx1TIM
>> y)Nzu7?8iiD
>> z<PjrIjSLn6-
>> jnD%EoPxF3v$g07FpDiMd<rT%tT)%$FraWc=OQ*eLhc}c^a?j&yV!F
>> z!Qs76Ko(4cA2wB(=81Jc-
>> wQ2I##B7J^!ugoxoWrzGAvAcCZ^!NQNQ=bqABg$Sr_<H
>> z+yxPWuVb6>VVvNzI5$BpE%E$dM2|OIOSHO=^BSHjq(#GIjfQ1Xbyy}
>> GL&pvVnsF9*
>> zg*tz0u^Q)_f3bD`7P1UBQ}Uxx$jnF98G`?nl4cT|&6||1|BL+-
>> ;4+QPD$iT7k8^kW
>> zaP4uy_FmXR7W4_hXuBF#t^OGMuc(azrx7C!oW>scUlpJ>d&3>&r0vW
>> `EVUzsvTu+@
>> zZP!%96UfrcFIj%(81faw6~k9DExJ6g4!YrCSukDsfT1iU#0%sIxG%$
>> gig;#P__;!d
>> z@zX#h`c2(q`!{i5f1MVblSG{HBpLN9rb`{K?H}ah!UN7ttWRu%9Ou5
>> vbmdV^CulMB
>> z$A}s1w+@SxW!RHh^ZaR`0l9`7Ie{4~YoP<>$?e;xA_me@&Ldxp)n;V
>> |%S17FF}r;`
>> z^Sn4OGuQ$6W#Wc?g|s2I*tT^$?|&_xr&+0n$C?y1T#Gd?fgS|aEY!<
>> N;4hwIS-pV1
>> zT9Jb7sZ{MvuHVOf<bvNv-
>> &g7Tp>9)O)+PnM<QNXy%7fha9Jvnm7hh=!0A}}e8rjmz
>> zdY(+jSQcz^aVg2^e}Lj_d%HJMXdd)E5A_B@PW0iXywN+_DV^lsZAWe
>> 9^?c;5&y4%s
>> z_S3+Tg*o>_2Gbg{Mz?*R(og1}*xm`a{u!u!rck=S0sd;E5^9%drI<{
>> f@~ui>Yr~7j
>> zm(Zw|%a~U|mX=bIx}n?0QdZXXsPYrNQ43}4LhSQNsNao1+$8A;a^)7
>> *7tZy37~?p}
>> z_ml$P&aq&IUfX&dvG~F`sdPgWbG*n4XxxeIs!03U{u*dxx1tvJBA@g
>> `QE!}xKIXwU
>> zS_z$z?r=t>+~BK_HLA@${s)x!4$yyE$`0BoyZh64pGN_WW3XoKeM(3
>> H>@L(u&TXpO
>> znnEf6=(-
>> Q*BH)Z#lzqH@PXohDflnI^|C1ZEC~C>OQz^a;@LBiXoyzgQDICR|r_k
>> 3R
>> zj_mec?enm&VjGRZCvxmL_eR~8Kf;F(^i}bd#epwtXT#6`T=(<iQ9qf
>> TPWvYy2Ir$D
>> zV!ua;Ifj#GEcU(OZY6eT7<mq&ZA5E<9haikWwH3f#kS&J3uxfBBaLJ
>> G4WB$pNNQo-
>> zIEg*lkJ_GH7}br~bd1lRWv!mxy+g?(0)D$Fc0bJbz<mn$pQe&$Xb$o
>> }=&uO6Rt_2W
>> zc17dg_Ee<Ofpg$#6<Lp*MgL)m_WvPA3H$>4-
>> $2RTk0jBtru;{G|M+Tq?spJ7+QroF
>> zGI>rf&MKaNr6ETOg|u$ei9H8FyO-
>> wlHlkmFd>SaVyP1Zxs9WarvJQQ6XM3()KrL^}
>> zyxy}j+H+5lW#zv@@6I9LKFx9j4dq*uz-
>> I7Nj`{5(bni8#mu;$cCuwoaF~=Df&(X(i
>> zo?c&K4)UJtBJfa3L%S;qjJ0mS=X&%Nwma;vn~d1w1<Zd({llnjXX<t
>> EFrNMSEHCPw
>> z2bdq^!>4|WWl7yDphNq=Me%g-
>> MjWdYyVil4SQ?%k7UR6>gUzx35ODr9=k)7G;;jF_
>> zuMN<d0q1|iuivO&aQ?yXN4yzIyc4xCBVJ|&Sr*ShFMC;LdQM^bz#Hc
>> T*5fS5fzJvY
>> zcV{9F_-
>> 1iFjdud)Up#I{jolCa%5ovA<#G?nhK$OcI8$Iw0|_fvV;{?ao7cD}2`
>> %P4
>> zyG6OsfjXrFF^|uZZJ<X@g^fdR$^nmkbp>#-
>> y;PPcArb34ku$RFnFcTBFb$j0*Z8J_
>> zbG6h$*h|#$y8YMsJk7a!-
>> hZAxw`)zJ68|5_{ooVY?!_g;XY!fCTO!QVa~GZekN2|7
>> zS$=$7kj4a4z%TgQFPxtlar9JganOtVg!6YqWU=(53-
>> s*7e4Yp2)28yg80OLPeL~Eb
>> z<HMZ4zv&#$SLS>db1nkT>wtqp5&TI;Fp9n5_R~cBf6>Z-
>> Pqbm54EX#m(+fI2!#c#1
>> zHsqv7-Gq00uy?WwZ!1FS$v<F>b9g?#$awbaX9(z3p0b7V>bJ-
>> _N(=MK{q&%+g?(!@
>> zyFHitE@K@*z9Qb4a4nSJpLtIOoS#dPcOu`77vdbudr0s#{4AqR%lmA
>> ~(99Q+KZcP%
>> z#*kx%kz>ZbhnO!QmvkVPJdAsD-
>> f#FG{!2j32DF3(E9v$1?*ry3iMl(GTaUr{^pvE;
>> zx?o4wTa-
>> AT%P^*KtY;lP_a$m`uRtG^F%bcm%z0WGYU0qtsn~n_tHUGh4@fvCWd*
>> 0;
>> z`IYY%2b#ZE6li+W9Z+9!1)@^>NdnJKjNOIH3)%i&vIjo_j$giJ;A<C
>> 1vndZnCgaKg
>> zJx33x2f`}F=ZebvVc_48*iX)hSU1>@UWXpLp(6@p#PTU#AlSw~F4$O
>> JBIGY!Zx2h+
>> zgQy!xsqK`c*S8ui?jFR(R6bX5O<z^%7_a5Cp#03j<8qqvK0oIJhJ=g
>> lQEA<*=aygT
>> zla0P16O_OZB`4y<H9~O(M%Z#9lW?Vva|afo9YVR0)VqrUsjj@p(2|@
>> ;+O*<8nw%54
>> z2iNciX9tGw#JXKM5nJ(`z(VwCN3mwY+`zn}qa)AZ8dmUdU|1dIdKvz
>> _z=%bFk1KuL
>> zBZ0|0w=*Y_x>Sj$?id{zI%$63uA;oid|bl{9t#XZy9U<?WkF!Xq`b(
>> ag?SO?4ez)E
>> zr$-2Zv)N+c6T1}n^iE6Qv-^?)pU+4R{HZV{aDJ{e5PN(`;L?)Rz!#-
>> M13k;q0=-qk
>> z0#~0O9>{PNL}Cp_t{Y8J0LKM5Zonx5oMOP44LEZEXD;A83^?-
>> u=Mlhp6maGP&SQbA
>> z4N5%El@q!8{DJ_}^C#@-
>> ^^FSrVLN;T>H??_Txg+qY_k$S|FcDb4Ahcr(7VaFU_;qw
>> zV1sIwQUE>LUxc;S(C4MnliZ(#y2TzF9aG2s^L9#u{Y{_?MewJzgEZ<
>> SZ3gBi_4OU#
>> z`JZ6^-
>> FS`y&h7_<g`eU6EY3^KSdaW++kLpM<M}1%UI)&{W9flN`TT{)o1hnN`
>> D4!O
>> zT8iKwiN?MzzcdtnL~LPw*#*67hc98?{_MI9|H*ahtvAIdf~HBJm)kQ
>> ;Z<=!aWzf3|
>> z^cEs#9Giq35j2C&&p7w8;4H&uqzVh|Zzr*P0_rXHG$jU^c#_hTef%!
>> vWyBAA78TfG
>> zLx;ed9WlNM<MvIBd-
>> ?uj^c9l>d8DNq{@WwhF;B>U@XWF({(KYs;MdpKflp;PI&4vg
>> z%`#*B-s^bZ2K-
>> DL>LWUBP3SY`TJ*Wtuk2EVF6;t~v9?2dC0pZOw?fA_rvM%M$3jOW
>> zz;?r@Hi8a)KOhU^dlbj(=JzQ5dj&twxeU+at07SfxQz4Ix@>CgSg*w
>> W>$xsL@XKoW
>> za^hVta<-8BnVbwa&X9PItov79b8+#(z@-
>> st24cRG*B`+8k;tokxOa3G&D@!)*U+Dn
>> z;YV>FKMk4@JDq$^SE%qL^2Ev39A!h+du_P~5N|JlHuzZQ#l?sAnz*k
>> w0LKyokBQ?l
>> zbagNe0*(&k42N_a#`}-
>> K@M8)1mzEsbd%eMUkB#p;_B$k+CgO6h%3GXo{V3O!M;Y!-
>> z*2QkLQkoJfr#q%dX^1U|FQNsPP0c7LF_rtukr!|aUs@tzY%FRD5@e+
>> J+bG0&1Irpd
>> zTW`<7Ci#8r9LT9N3po<oC-
>> ~v|@^$3>z|rdPXKILJybrAoISb$3B<}sVw^6(Udm~sV
>> zzJ>XLox=xIcR@$;@y@|*8J$t83e_BAcY>CD&^)+bMjzAU$TDOuV4aW
>> Xe!@GH1g#l*
>> zi*eQ$9(Mq4VFIqn3#vr=ILAk>IpCa)cRS;ePv9K0b4-
>> L|m|Gqbk&q8cXgP**4q`!#
>> zV-
>> I*p68y1dN(#Q*^Wv61QewMp&D$+D<J&66Z^4{W*cI!Kw7jB#ZDl;p27
>> Atz7Bo=O
>> zN*O$QDe2J!&ANQC4_G7VIp(<K<pq}IV++c$j%|kLC6jREENDFi+ho6
>> a3H=iM+IU=D
>> z(pbn}z;_F<A^4C&BHey>F83CcEtd<7Z%Zutdw^>jf6VWc``=f-
>> a|YiG;cR_LlAKTG
>> z(PF&ccS_d7+r6sgZPeH<EC(+5=X4Rii=GkEJC~0yIDoSv*J#)WAtyb
>> 6T)#RKda{b?
>> zLe0~Pxp=SlsGUZx{0?~K8h&ju&fLf`I0whsYf*bLP42{e|Hls<qt0n
>> 9<ZqbSgZzQ_
>> z%`1)^YMueiZ(y!%4E5I~InQUBxi-
>> KxfvGs7J>XIFvwsfJ(VQxW#`S@0jC~urq@pGn
>> z&BeQwHmU}0&5=u<Q5Zvxr;ph?g=!V&J}dmLy;Z38BKP_^XtQ_Xe0~R
>> ccn#105%{w2
>> z#yHP=PpEFp(Z8`s=W)c!Z2JkoNhi;1y!MwuHQ}uGV_p*#s{J^V+CLS
>> lyG9xCT!7bw
>> zHOMQgQOoljg05_(o*BME<GmJgsVr|krN95tRQPME#yQf%V;6A-
>> f8hL!TQ<P&48t6K
>> z&3*sD8jRgoqlVb${fK%#=#_GhK&ck_akkwKxu3xvp+4Z`+9{v$Ij>{
>> bUf}!!zK`iy
>> zpP=Uy_M7S9F@`-
>> lK@W5w%rz|RwWdg!Ed+h{q88i)_`L5sBw^@9;Heq_yEg%QLjrcG
>> z^mW)3;FV!F!{3<jy<(0I-
>> w*h^QJ+}>9J^6B;qxrxIhjg}OrH2V6}*=$xhUm275J?k
>> z5)EAd8V1Xr`C<6Xt1m$hZ0T#fdI!kf3;BNInuP3GK3D_U3r>?JrpIv
>> $XfW|JExgxP
>> zai(N>aGma?c*khgWfk@Un_nctAC!)x>Upr?Y}DANL$*AQ+$<Zq*Tyx
>> aiMWqSc~0Fw
>> z;0$ltEq}juqqg%iy|&Z;zQy={#Yupl2mGwx-kt4FneT86zeu-
>> #w<T~}0=Fe_TLOQv
>> z1k~_9UG3ZULtKCHlK;YqGGg>L;C|~C;a7nFdEl<UMfknIzXZ6K-
>> Xi=e@XrA5f?I^&
>> z5B%A{opX!ucLM(v)FgXw{THhBUkoY={Qm~rzrIEI`R{bDZ>0E`l7}M
>> y-tg4%Q>Ao4
>> zSk&iP*~{Ne{Plk_YRTKc`&+k&e|-B9ejd2%ZxMbk@Gk-
>> GrMC#b3j8yGyWke#_XB@6
>> zaOd12{GGsmr5E;(>#wivU&jyy{(l4RU*979U#IAH&ut0ZmcVTZ+?K#
>> ?3EY;z|L+o5
>> zKjq#@6KX0~Rr+cxC(h!hd#21NxMx}U)Pm_Vr}LjP8$b8D6|3sxS@Pu
>> jXHC6-*7Qkt
>> z%L}U3%Tp%d-{b;Jc>~4VoBg7R&d&#pf12n&ffs)Re^(O^1&RJ&<0C-
>> +{ZP@H{{L3t
>> zgIWHyCR+UMr~dmi(XPTrg!~(qXs;&vjb5VH63=yJ|JwVEA;p}LXcPS
>> tCeL->EibNG
>> z^TOTo6OT@$5?}4wvdWs87vzO2<f-ywRTY)1WH%YpX0I-
>> *tgX9SE?T}~jqjW0-bE9h
>> zShI3X)$?m6QsRbEYu2uqI!jJG%4Jo)nhLq5a{Y?h6;*5GN%i9=71XC
>> vmNBcivaYhc
>> zuCij5JieCyJ#CEt_tYC;d}XUD<+>`lLZ3Pa9?JLlDf<8T&)gtG@TKw
>> 3hd!47&|`aw
>> zKmLctpB1LQxp(9L{MF9F$6mg6?#FvX`8Pw?e)P8Usd}ZoGWE%(+NRf
>> %j&}Xs;@@S?
>> z{mxwrQy<;%P=PJqkf+scz&|l0fhW<QljyHA`%N+iw~6_!#l}GY{6zo
>> 5gW)9l)xq-z
>> z!@d3d*O5R%{srH#FB1m!pFH}fcdvdHd30OT-%pE8`{3-
>> {6V}!9ufH|t?e9)pc;qKf
>> znX0_Htg3#Nytr}=n?v<FSeIP4Vs&NJy1IUCH>Q+SmRGJ=Ux`_@Ypd4
>> OLi=wzZAnel
>> znq_kNa^IRYm8)j;TUNsU3{X$3sjOeCTbS&tr~ts)Z<tsF<Cp*D=0KK
>> J)(tW{`B~qJ
>> zRh1R;1jAe>!k*n#Rdp*skEdo`Eeu+ov!Z78^S+u&9-
>> 2Ry?HgRq!LoHVmGX);@>*_I
>> z`<7M8tEzkzGPtN%#p|n{mEH5F$P>m_0II$Kz+nFREFO6_0r=iQ@Twr
>> sKMT;H#iSMB
>> z4D#-
>> ov*d|cveWqCUS3#JRSsdvi|c$f;3hF*@^WMS)XAV?_Wa3m?YgyVt7__
>> MWtXd_
>> zeEI#;?x|X{>V<pdg?dnuYgvMbJ{9t_t9;AkBG1y&c?*i>KT$lp)a5E
>> EdU)!T(vsP8
>> z7xM<B((ICw$4h3(vP=se_slDrjaypcDp@dZ!Q5Fg&08?%aUPWE$=N0
>> D#}{MRG=g8v
>> zG46hoXwM|tKPK8MiI&J*l4$XTBLDFHg85StH+T)K|IAk4r?1Zwjah^
>> IFMrsa_$lVi
>> zU(%+oUhP|33VkiDsa%GjQChydvV7%)i3zQ{S4PaLs*%Uzd-
>> T)=RdsUZnyPinmdmRv
>> zS63mHL07OG#=}czrOHpbW<g6=)ywii<Bo4@S8S-
>> {?hUy2)z#JTJ)+V=*MfOP=#Uo{
>> zAy1f8PxwbP>F5X-
>> )4dme>~*uBE|dWSf{3p%_@~@uwETZ3zJS9Y#ptpd*neZjfBKF;
>> pGUp%uPONWW+j(aqe(9t5Z<6tBrVGl%uRfd8%+}<~gxlZ${{V7n<9`4
>> E
>>
>> literal 0
>> HcmV?d00001
>>
>> diff --git
>> a/Platform/RaspberryPi/RPi3/TrustedFirmware/fip.bin
>> b/Platform/RaspberryPi/RPi3/TrustedFirmware/fip.bin
>> new file mode 100644
>> index
>> 0000000000000000000000000000000000000000..eff727ca78dc0
>> 7cbfe56f1b6717e93b91702c16a
>> GIT binary patch
>> literal 41714
>> zcmeI54SZGAmFV|5_vV8nK)!$&QgUv<7H>a9J`=R&B;ix3ViGO2eUlr
>> KC=lc$0g8a;
>> z2C!0Nr(8^j4t6Ftpp|>;`#r`&$8_3qK|5`Sb_Nr}Ogo+N0=Blrb|8r
>> 6qLBAr=iHNo
>> zpw@O?f6SXnejN5W`|Q2e+H0@9*4q2*y{@Ke!yE6Jo~h!0Rk7DoKUHw
>> +r=Fhk!e2H2
>> zpg3hmJpWvYQ^HQ?znuKQqRU^M_vBY@SbXfe_o@d=?feIQSC$+4)U$V
>> Jj{W?GONB4E
>> zwD6lQJ^Yr-74{cv=_-=b{YtT`yKj!GyF}aCsnQF(mD0j0-
>> Ol%2*3wHJPE7YGb*v##
>> zwVF!pR4O?DsXINs?11ENCf}#j0k8zBNy)SF*ONbnE9%M)pLC50pK^^
>> 2pLUH4e@<7e
>> zE4bd|3i1BZ=EI>&E)_6<sjVsLP~-gNo-
>> M&A<yn2lj1^jCj_fxr+#>>-?(dwIsItMc
>> za}w_*ok+ceasEzC`8$i1>x`+X$^y3v%u7#r^6&kX&%dHnJ+xIuU79!
>> IsycBJ9=zGt
>> zH%=*kraU_|oayV^9Z|irbfE#b9^fl?!IQdD*_7?PwE4(>DKE4o2(9G
>> (!lkCmb0TGh
>> zM$H@%*rxpDN0lB(0*=cZQB=lrv0HUabgLql?k|V7821mpV5k5zm)H8
>> Mp7*#_#$lz^
>> zm+@|nQXL`aos{#;liPtaCt1Z#x!hrSUlY{>&6oQs6?g{IE;OXXX?iT
>> trYTkE2mUEn
>> zDt(}bOQ}0?lG#z?{!nI<PpxeS2VzBE>Vc9;S}Z}@2_03Ms<&`Zw}kf
>> vYD8ck_pc#8
>> zBS_O|*F<HvtBQ6(v(+xr2X%O&wmkb}wWeBp%YDyJ2Db54)nU+9m7rp
>> VpLB$Zf%o8o
>> zG@dt_9r<o`Qv_OC;QtK?f`3H)DOYm%$fdr@D7YQI`@t=3R&LsrZpLV
>> {)jpdK-?QZC
>> ze5#6_N7kh;R1kSdGh@}@(h~ih#}ia*Q=(nxe5x6{wE3vjpO-
>> d&CxmQ-MGntbXrW5#
>> zR&Z_IIwDZLH6?Hpvg%W6`ZVMv2Oc#~Es5>jrUJh5lGvv-
>> #zkM>j9``-+qX{z+Fwus
>> z9T|O$eCY5Zi!<7%nH>hS`xhN*C`J|qPBZNd&Z6x~tv#RhM6T4|PMxS
>> L%X_|}By?%>
>> zi~Y1YbjcV#51rCBZAytHZ)$N#?80aDkc{iSr&ZtrV|%jD<We(Q6J>m
>> Wca$01s+%3~
>> zyd{`##_s05)1HyENAga(vcmhIUB>BW<FqT<)l9wMcrzB%=_{pD{krO
>> q@}HrMPF-n>
>> zL-U2tmiE&<4;qi2ozt-
>> tzWFqJoXsci7r~SObnGl!R1$M5b#}X73%pvX#pd`@0!>Pt
>> zdrHOzFegEGO?q4Ii)Y;(uFHKh%te~j*VohMc7Ok!-
>> QV<=^i|{D5dq=DI&i&J;|lp`
>> zvp+!{>U}qU39npQU^;mIO~EU-nh~66#-!hbUn6N-
>> R97>`LEl@YT3|zg3ds9?6Scre
>> z_@gKIJ2NRme|UrR?@3oqI4b$n&qH7NG&TJsy3WZPN1mb$g0E?miV3U
>> {)TjN~P4M%Z
>> z$mHATBXp(J_rk}wYRcf{_bnMHp?xCr#f!C=+!s%=Qx81Ul^Ls2+8O$
>> @5*h2)XPSn-
>> za;ZQTGB0%u`a;H$a;v)xc&cdUdykuxz(erGuha|;9(W8bP)+|29y4a
>> VzT&+KGR6mu
>> zMF%!|Z0ELUN<jMmk>^W0u7_6!_59E4j0ZF3dq;%~+T}wJNFDTt)wk$
>> MOE*cIb#$Kt
>> zkGfX-
>> tntsd9*k3TxaPLoj6Si)2DrQ2@E+KX4!N}XyZv(W26B)E4txB#!ZlmX
>> &={q+
>> zDCKJTTln@eZC;-
>> e*B6XQTfSe2kIV0dULB+}hQg|j!_t)25=D3K`@Qh4)L#x?#}DoY
>> z<-
>> V#PWGt2XQpJvR&e>Sqdm0;;uiR%M$OASdP@JyLmGt%X%Z4QjZ_MeaS~
>> 9U$i7dP^
>> zAPWMkq<2n-
>> ^jC4RT8nQYFfxRHCB5zrkr!#Ri@p<kBJJ|2{1YOBrFmTFS(9feFJ(3I
>> zJ%%YVd(aq^FZ#9)93r1(;JhDtMDO;cskPD<Z;e;6AG%fLFVSW4ei`j
>> cpnW4Atm}Q%
>> zmEip~@Sdh^hiO|iZFBSPdSpXqJW;N^hVpk)@6f5#!0y+#biGC!4(j7
>> ten4B-ZJgBm
>> z3*=C2gn~ZNo2T$mT*v`>jP?|tz@~fs$o@B1%<2^xZ~<5Rn5VH%QSiT
>> oJ`^22Sl<ax
>> zYUD~bW6*q1_+sj|yjuL>T`4l_@W^@RCV#tJ*fYk<LI0q7mo|SdB<&G
>> CS-hm2CkNbd
>> z8&_@d)uvZye+c?yj0%kdwr#LnX<>Ae<;Q9GaZ7c^m(pTB?1a=a7&lV
>> SM|*AEa5!Yb
>> zM=2{bz~8g;w@V#$cHT}qo%>ZgowLJE%UVswtLP<lw)Ao6g|AD%Y3Ux
>> ?@~Wn?rCkC~
>> z`rOi?m!O;eXv<V<6~0^BShZFo4J!Q6Tg+X)2`aW47{JV~C-
>> qHLmj1Hsq;11jUFsXR
>> zhwD3BB408d92{cLFJ!6M1#tNHmc%NBPxP^Y9LTfSP4Q9hjpx(;8Dis
>> tR)1%CFJPO8
>> z+T{0yA1;aAG8jJ34*b#~@OQi?`~m(5?f!z1fxo!iw_EI-
>> ?^Igg0{8x}mxwIwEL9_|
>> zv7ZYp-
>> (Sb`%#rZ6#O4A0nT2h!eH`U=c#`GvcV^Q^tp$mJtSwnj+B#4R%h>blS
>> uJld
>> zF2-
>> y(@r%ZU4aP(eo;0s$?7g5Xd<rvmgwz=WG9Cu}mG6NUo54K5!iB76@!V
>> KCIv_Io
>> z2>MJ?t4vS@nt2|@^$gc&E|G&DyHu<ABT4jOA{S$zQ^vT9OZ-
>> be*XJms5`&#4a}`@w
>> z2lRS2awh$~1)hk0#|9h}8OLsP_*ME$csgSN@1|4Ehkx@$@FE*t+KAm
>> &UIo2s+2}wj
>> z@>WefgL*zKd6tx=T~^uX;Ifm_19y@Sue^<<Qf@x*uY$QhJs|Ur#uPL
>> 5ucUWV#?nL3
>> zsL&hYtClErC<}YINa`bZ*4VWC!58*R8N03D9yETmu=Jha+KYeEjw}l
>> ue*xXwZ1`S3
>> zzM#mn_&n_&L9US>k^cxjj`$+&Wm@2$<9R{G#NLmZv85WiXsp>$;qqr
>> zDRt&o;;)Ji
>> zRAc)<TQgP1OHLi~ySWz}+ep7DvXTj}q2Y)4&Z0l3!WZ>+-wgV`-
>> ^aPM`S0Vl^jrPy
>> zX>Umk6^LB>OFH&FkraCR$>h*8cd8iruc%n*^~o+(DLj+89KN&oU}3*
>> *7WwH97dEyv
>> zQ3c+Cx4~_C;BXbbs>>Y;Zqow6kE&QS(VrRoEO|+DLct`RYc7{7)V>X
>> 0o_adIf<4av
>> z!J@0lU~UX7;kiOq2B-
>> Ox)Y=d{$^W5RTaxH6S38??ML(GuwvtOFAIY_3+{_Fpv9lX}
>> zy>{PyFQl7aEiX{P24{R!(B8(SBLk;pTm&C4Z|~UGppqZ!G+uqC=aa~
>> }4}K<*%Dh>|
>> zj^l@Upy`w@`t&;%|7<xBd!{kpQ(^Igd&P!A&s(kp=Ke`xTj#o&M<j;
>> n*H+y%=9uU{
>> z8RuodyO+FEdNz64<YkA;-
>> 2QTGY3orvi@YrIvcfLlEhbMXbzDU=15&477g&Dli~BzV
>> zFC3m358AvFnu3ho;<U=1cJzC(`<@;@&n4FVk{%!TC*f&v+UI&q?whT
>> 9Ur#itZIAFy
>> zF0&MykXG7-
>> kGHm(_p)Y@2(Enm75n*?Zs`Y=ervZ%F71*!QdUcgcB<rPr=k27EC-I=
>> zCx=7Z@h85ZB0qB{+xGVF(<4874SKh$#M`6ruv#V0(t=+o-
>>> x+8_ATZUKVfVg2CmS!
>> z-7n>qKWELKzq6)GOFw|Va+9ZpqiyJ`<Y153zi7G&ox-
>> 2BaoT+rd{je>_II||sKDNF
>> z%nkCz-
>> $efyiGh97R7VuvI=WT(=e)bmvZMCeiO^!Tk$OJp5nc#g1;8+us1BKD7
>> ~C(V
>> ze|4UP7J06X+hTkt%g2cO6}JB4J^k%<qnmVm4wqs1+h+k4I0!y#9LML
>> -KeA+Sz-Gz#
>> zd;=N$iqMs(8Y0kQ%M-F|>9V8ykAvH}xB2nCP!s-
>> NsoL<IW1||8fttj&J=4<Xbg3m~
>> zN3nXSr!hM#yj0i2=f}0}kv3Q4Wrf>;zf|A!T(R2JQ<46}9_jx^o~I|
>> P26?yD^mjH=
>> z=V9nc;T`k0a&*ZG;njoWHR|{tDQc}RapQB6r%L>tKJu=l?|EyCz1^4
>> )dYiV%Sj&TN
>> z;@_-
>> ?53zc82$*MPs4*=UMa~n|OET7E494)sf;X#}jK!xmtB!@pdmjF;QvO}
>> v*^)Q@
>> zYi;=0#?SXKS9q*I>Bl}d>F0Z73};hjCOnwlls&%nuT{p0f|vJ1fE%2
>> pVn&k62sWY1
>> zHk%!7E>*85s>+%t%+M1}4|RQ7jcvI=xmx9JsbW10*?uXhzOmPD+<h_
>> XR+;;BRaxy~
>> zJ~>*g^(fad4|5)omwfnN&AS|UB=;%_oi8?Gmeu!<p>NMka#d}LQpSg
>> EQj=cZ<JZ+e
>> z8GlV`%o)=^=OSwll~LxuH;^Z7s2*>2oOWI3jk<EfkHTwKKYD{Vo3XD
>> !|0(9k`D)ym
>> zU&Z<=O=z4zo%uJK9VW0(;<LZDW!)1=D(M>~H>wW$qcZ9?pOgAeHwnx
>> nbliCKQEu36
>> z`pci0reeE+FS7T{G;FEb+8L#c_;gMBm@~e2SW7~8$rz2|+lWni?eTT
>> Hev5t|th-|M
>> zb3$)7&SmcXL(2wSkIkK%p$<;Q=PAHP&;PjD;~AwYC(`dtA2WN7j8v6
>> }Nt;RCjN>Zi
>> zUT$}=b58o4i*9I;v^`B#4%X3QwS*RtjT7|ILFStI+SoJLt(V02TDr6
>> H;{H@ssRO@F
>> z*Uv1FdvL$P{jX9~WonMu;YNOS=&Bzv>B-
>> vWKkKbcQHNfmO)FLMu~*4|(WMUlI>!wC
>> z1O4Bm63^V0pkCTqaNEV-
>> KH8T1C2UEXo^ocXG4EnBef1+X;#jekcBVO*c0jvN&AZr4
>> zz6pPtRLYs{YD9~F*Sw1&L%;k;TW-
>> F_+;Z2#i?7aV%Y8+;>wkpYy@nrmO85v3HM`8v
>> zHriA}`8FNd+hJamG1a(N1!9zO-
>> U}`%W4%wWyjUGC(@U8$+EArZ&(s#$bxVOS>mzT;
>> zxTAkdm2HcB!0cu|V6U}gS?e-
>> C;yG9#{8DEY0`pr1=+qAjFV&gl$k4$Lt5^nYQ)0W+
>> z*g!jTv^1VQZhxle$!f-&=nswgq*JC}KH`4v%gix`=7|n-^q8Z+#5a-
>> kI$tJ!8*??=
>> zerAV-7b}p<i^8+GKD6r&_^=|!+3-
>> R9Sh2%J*n#TVW(PW>({uKru6)*fg0ydGF1%W1
>> z^eV&VQH|H^fcDNN)`}mXAD4n#>Xc5=TAXtEZu49_^JWh=PyEqV=<(x
>> |8purz@I+VF
>> zf=k9rUAfsIK6eDaPIxag_$VVZh_BcD=Vr*DzZHFX7#;^%v)!I6bi&_
>> f#|E}C$K1jE
>> z?w_H5HkX0UwEWs~tw`Y8?SEmv@Z90yZ(I|?=;_u1Ykrf={DyB6$=Z{
>> qR(0anyhBEI
>> zql*Ft&oW2Uq`&gaT`F(mE+fZm5jc+jgg@1ZKh=ZJ)rrs5^AjnHZ{@+
>> adYgNvTsrpX
>> zG_d{IW}%P1dJ7zv;EhjJosj&5WPj(=>FOo_r0?%hY38o{$?6>Q{7Us
>> T*0UojAm0uW
>> z`uYw@`Cn2#%5xMr?pM{~-
>> *Epb{?>Ntqi=Sf=DN)Da`58^9h|6c?ygz1xNEEQlktMs
>> zftE7(sno>BjE7UZ75Z8Fdmnw)#`hX&-
>> |wxr>5r_pA^BbLp)Xkq(ORZJv!thm<}|bG
>> z5oq2A&BfT6i3!*h=!Vwch`x5?|A=2z%lxZN>1QUhrjws$_Q03Qgf#Q
>> Hr+N1XGMAsN
>> z3iDOMnIp6>AHA@Z_xW3z_sjhY<jqkYY>)fQUh<7~(k^r+&%%#6uW#A
>> )Zguj(=NC8@
>> zY~6w_d=vaWzMr_kFSNaQxzD0)D|vQVw^f!tv;6+1_#EH@>x*OXuiD>
>> a{`98IN3g-P
>> z{X+bk5c;^I^m93xrTB-
>> eS#}66sdK*KaOjQE{!GTRSLz?4{upc~_0M`D^NaSTh+m_x
>> zU@fAO``9UDMtm#r$xT&!0vm8sa*nwv`#@{%A;!`<=(5*|kL-
>> 7FUv2`&r)@kAjtj`u
>> zP#g*z?dXFe77lw}KNNmX9R3@hKC=IEll{GmZwUuIeCN`+N>}Dp6eJ(
>> bEy+`vrCX9K
>> zN=aR5d{a`_O?9OybdTy_9@U|z`!j2lo+5cQjCo02lFD~5<_|7-
>> WaX#xZHRo~mx`ya
>> zF@9w2ZytP#WTXFNEYY4QW9Bk89UMD7(dhvVU)s9&&EPvv{65Nkx{9^
>> aH=0|;c1e2}
>> zlZ@B3Cy|GOZ2HMPKC{ZNtrZ=(7h2FW9YgaC@`NT&w#{>mdeutJRLZp
>> Sp*7Q@nfGGX
>> z<h=*D#c{Y!TbL1A@ADr`?w0ukaL+P?&}sN6dvm(Q&X*cF-
>> 7a*!i?r=#m-S87&AjGm
>> z+K`|Hd$y~D@FTqs?dnrz&r|8!_qgNVX9d5TGF6NPkssHx+Cq`(>#_S
>> !pRFovQVI12
>> zZS<*x+XwTPexQ!avLBO{)fBpyO)RXTp4eC^m#DO3uR`l9j3Lo+Z;<a
>> o2VKu~(lrtO
>> zYb~^|Q!&<ym9oa!-
>> etbRrOS*$`#Xj^EO0Ju{ySN}>|clbI%^Z+H^1R>dGE<n6|5zD
>> zUCA%*@%i0PGM_%T3|#2a3|;i{=d_H-vg-
>>> E;Rnk6OLPVH<`8y#Z5DE}Qs`oxBbl<S
>> zSKXek#?*g_w(`xz+n9(yjUOQP6~F4PwnY2;V(^7qUs93jEh^Yl)Qf$
>> Qe)H*LQpE<@
>> zYq|FKmP?yE`qv}Gh6~N&_lv(j4gc%rO4IV|@sp3|+?W#(-
>> +vtMK7%azS&N9~s_FTy
>> zYAv_}o?KNqmUkMLyvvVhYyJ3i$>_)Yo!VL-
>>> lr_!E%_0A@9R{h)RFSvrd|0@@m|Uu
>> z(AGBR*lY3f{&&!w|1xkgROJq-`(tgb!Vmj9sT0-
>> K2JtuZf2FNGIo5_(0=$#dDQ3R3
>> zi1J5}l_&VlU0p0|MOj|)-
>> +cut<C{mPp;y&fe8ft5cOL)x=Ccp&+JxR2Ng1oojqg*3
>> zcLR0&9isETt$M$8(Up4)p}H%G-?|6BpQexS{k^hIBL4fPIBXv{-
>> ;C44H#du(SLkn{
>> zN8SnS@o{>Pflis9($@jgmDQq<cOPp&TY)eA{xz4DdLBHh2f@A=hrKB
>> dyUKMn>{{9?
>> zu(zXc9QZyx$ATXO{!`4ou-
>> mOqF((pVRq&ihQFl3Ql5ZmHQ7Av}%JrJ)t*^OM>K)K9
>> zl=spefiJwTj?=?fx~i?dLA>|D-
>> }kH&=e_WUI`CfeIy4DAo@+pZgI{QozJ3RPQTQQq
>> z@DuuV<3*PJj0wj4T{`-
>> pYLZ&JkTE=t^|TrAR^ES%6xnN)`Qi=SM_qYdOFy80opCGQ
>> zN(bg`KZvg>4*u@JnlAA3z%TOc+uL@pvxa8tMK%04%z<GJ40GVWF$es
>> eKYpigw_Mkv
>> zkp?#PS#ZmBE%2M*e;nL$T?_m^@UH~7T-O4>AN-
>> 5JE!VZc9|Zr$z%AFcz#jpB8o1@U
>> z7Wkv!fBo&g-
>> Ev(E{EGcxKL)p4*8;x*{%650*R{aUciGOz!7bOd!0!Y9N^r|{E%5un
>> zzX;rNT?_m{@P7>4a$O7j5%8yhTdr$?KMMZWFEakQt_A)LQ$I0fazow
>> 9y6VQd8)nPX
>> z$EVIJ{P_Jf(+X!4&6qLEp{aEJ@|Ek1*~U#XXHT0sd-
>> {xz8F#GSU`(CDzncmvv}Vpn
>> zouXHyFP7T*$A`TCaXkO|vMcLF<N0~<{O`=Q-
>> #@?R%5sb6+0X0Z>9g_l$MJOWeEWTJ
>> zJdMWl9pYBTpO-
>> lK=^wLSIe5%CzM=VkhYn_&)*ma4{0%+7@#p(D|II(`E&kLamtOn3
>> zr*-3}scVit>AiQO*;bcw&(_ARI}(nc{9?t=v*v&4ql;5+-
>> *ju?;umbVg=_6}(d~9>
>> z#`71%^IyNs!Ed3x>OZG^q|q+tly~ws4uRw39~e^pD!{`Te-
>> aKj{9pDS{jy|8{)ywi
>> zd*+?rbl<*v>t9aqnf|R;hn@$@E?qQrwsC!9ib}EW=2b6WxxS&!SiZ_
>> wBgq5R_tzOK
>> zS69~>%c@t^u3WzAeq-|W%WoK5ysp+*x7sda7av-{fw#JG-
>> TMHXTV8%=`E0{5)E#$L
>> zE-ahNt@?CH`5g=Im_OT43-
>> 6eBr@S=OJ#))T@2udp#ov3^*>YPOPglj$jq!AAJXOjr
>> z-=C)2-NU-C^Jm6ySU$7<oK%yitIIj#*-
>> 5QpN<Q|+|4ciLC(219R(7uSzxAIvaQpl3
>> zQXY7qdQDYzZEaOU-
>> Tli~ud1q9R##I$`3B=YI<Btv6GmM_!|Dd(dcNhS+_8F{QMYRK
>> z`ump|57a%dy5T|TC#oBE)!8Y=JtecJY`lKuM#ETa-
>> ^p#`@=bM;y@~tkb?X}Beq#y;
>> zMDAEvMuxGt481;OqvGH2-!KP;IWWwDVGay)V3-5L92n-
>> ne|HYBf6MyQ^c=-LNB%xx
>> z{cr!rjxIKav!8)KJO3w61-
>> rl>{XhF{|5JZXeWBa&*arg?x<^<U|Bncc1LxdF-(Wm{
>> z=zTw}@pS~*a4LTeTqoTTpZE9AQ;ys7BD;^6^&GwO*@iOkzdd^yfa|=
>> `tc@#dJ{<`7
>> zpcC+6g0;EGH<ClaR=@`iNmv0N?EJ;#tNCnxXQQObn83T89GD397+Dj
>> nAQ6g1Y?FM$
>> z+B|C=-
>> rDJ5BPQ1|bCh+k@Hm?lB|yY+Po&Vwf0TTmwdu(U5OLPyv&%P=f7n#rH
>> -b|(
>> zxDE~yaWfzMtGI6Bz)K{ir&nLnrwESg1ji+Jdi#omba@`bb9AK24i*l
>> y?S}Vg+jSqX
>> zZ9-
>> EDWewW88~95(y!``klyZp2WFrk}fKB=>6WJ)*q*T3cia(bPd}m~XK{c
>> BfWJ7@*
>> zOz^X5#kBaO2N2C{>)z)IXl(dmhI&q=+lN{PA4rx>zp~-
>> Cl6tMW9(Z|#YHj2Y)!jTF
>> zTIvc+V?&&e%^msa_5tZ?HVg{y^i+Rm&S?AK8Jifb!_)S=G1j{b-
>> ZgR{{wy0PEIQV3
>> zu#AIdkJG+y&{k_B1)J_KZFUYf9}YFkCOi68HZvOp_DGs!9RfIzIK@s
>> A3hmTA*-l;4
>> z?Nt95n}hwgzZ6Lbc6LC&bMSLfiX2q>ZU}km-w@`fkJ(%}L-
>> JnWKA+7Q$gTH(v*}4T
>> zc}YM83A7-aUZl)lQ6|a;_8_zdq2I}8qjRfl-
>> j<DDZF*LH37a`}J;(;YpvZ6M9NtSC
>> zo%R*bp3<mBzxX?Amo0t%MK<=d(U&#p$TWSZZedd+@Q?v(lOMRI>uIb
>> JY;ji<u%T2A
>> zm`Oj&W?b1ID)(|ZfkbA)S9vGFRs0-
>> ESEruokqt1K`HhCH9K6(d*4SWZvYAj@mz$|L
>> zWTkj#DCITDcQ&0m@MHtA1{{rgk{1ly<)v>5fI%Jj!(k!HId#UsE4Ag
>> JE~OSQ4(-j5
>> z4oz*)%vkO}6tBZ4V8noNKpDF9w`>}>Hf3_pm{wM>k&|uab0_nIJ*SX
>> U^u}Y{cb?3T
>> z^i;9o_aySJ-
>> ?E@fV?$^a{aBD(wrK%*9jR>Qi}SIsj7`nSk$Xw|gO>;_X@{a6va!4U
>> z-
>> `dLCwQo1DiMYO*jcO(vE7_E49dPonIsXP^!(<blY^2Vg!vPlZPCn6`n
>> @WF`6%a(=
>> z^3&9H)obJ*kugZX6AmX>8-
>> I>K$H}bbTsb@_aw&Z_lqTyrE%LJg8V5GzJDUMzLzC!L
>> z3AXW1z@`n}2nQ#(ap;lFieA|a-rPB@#aQ6$eVzM=E}QsW-
>> d}KUm<F5W&Dbxw4_f)U
>> z*V)MA$fxvSKVQ<#j(?_X6danN(5+gFPTv^rl3q?H?)I^n7oC(LGReV
>> ~_iUHIJnirr
>> znARrxuc@^k2G+0P=`VoqV-
>> vIR`g)a+%7*NEHi3HO{b~Ba$0lEC*Bs^Mox7gHXx@pE
>> z&*4~Um+-)6*t|w&QjvjrIWWSe-F}+-
>> 4}QlFu=}YeaNy4jABRo5c+NM~S~kjhrC&!t
>> zm+!-7$4}z$<-
>> mY!W|L>B7eyEJAp;Tm*&v_I;=6rg*?f#FR8wF2dGJOr;Q{Tm<&F0I
>> zE#;++LFkr4ZGPx}Dq^(wkQ3e2JFAp~e!s+q$^j|KYg5{ph%xu#MChv
>> F-Tg{G_NYo~
>> zIjoY-?0^?Rc(E5aPt(VJY-
>> l&B^FwIk5aF?ia<y!w{I|po!Ba>6uGIf74x6i34V$bl
>> z(3i5=T4b&hn9|;$99U<=c%we%_Qq9t6>^};r>oRQg!UBG;U8soY>np
>> $Z~ddt3GiUx
>> z0K22#?Zbz12+6WJY;b*(cFF-
>> H@P_}wh9QS_!~ctW(a9WQ>8R&k<ZvSNiwtHTpH6U#
>> ztnlacY&Hgu3roKQ>5~(qB0oFCwPD5dUJjzY$3gLdaV0b;WRgRJR{QS
>> )4u?%RG?o=^
>> z<X#~kazC4UHUQVJfY<m7)_Z9idc52NEd`|2y2jxuTi1se6Y$#JC^*Q
>> z8KUQc?zj#b
>> zIJl_X94^h9BZo`RiSDq<McsjClT_=GG;B|*_yy`XhsxnAn>X1|DE+g
>> K_hN@<VP_=Y
>> z#(#9beMs|rArJVt`VYiU<GGQ8_tK`XSaq|IG0Fs0Ai(oX;Qkc-
>> %~!crQ}i!E7Dx{&
>> zRea)Qc<|TI;>dMJlFBZjOaXL?jF`z<i|ZC_0%-
>> }CLe4$tKp!>&o$VE!CkI5?#99e&
>> zI_25YE!ZWsMSD_Ud4Ods^YzNRlH<2_8%yl_E61<q{ZR_Cyri+$p+(B
>> ~m$76^_sT)g
>> z!<5TjGOgF)i(PIYfRD|OOlx!a4ES)UAS-
>> Z)1IKcB^6<mz91($HU*s_2J<xVy>lFAl
>> zHVkhLymd!nKu^cE(Z`1_&+WR7{yz(E4(ml{MzA5eFn@Dbwkzu!Q4XH
>> ?6U`#6zOk?v
>> zy>v1O`Q2HvNe-kio{Gd@`ym^#<q(t~zk+cTQ<^$-
>> 9ePA5EBL|mX8f=yGJXU7lTN<W
>> z(}72Rky5!8rP(Ue!&PeAVz1~w8T%#Z3DM6Sl&JXW3QwVIPA+0IYf-
>> +cIKjOfwlZjo
>> zdOb0a3G9zR|2*W(u?g1ZRu0%Z!GKOBX;V4eQg6x_D3*JzUO~I24wTD
>> %HM+^5U-5f-
>> z?1OFxI%)HnGRiA_SH`XN{A*~7_I<e%)IIW^v9k*q<FKKB*HP@h_&<v
>> K2={XE!tS%f
>> zA@xq1by)aD<Zvtp?(?zr9MH}k&}ZKZ<xd{pAU54TP@EX92JSN)uBUA
>> FuaHqA+E%Xo
>> z2O9DTG$!p($tpwc(Pfot(7O_zO@b;(J0jj4osmELPEUk`9+5+jbgGS
>> qdm<bF@ujtO
>> zs!RKOA{_ScrS9qsX6)^eL!QEeSCk4l?Ep6I7&tsH?XlZ5poc_O?L+h
>> `Jd-i5&GUB>
>> z-
>> 6r!M`a@;h+PxJWcrw_WNq@12c`SXrrDtm*<<!`z;N!smn5k9j;T|L1p
>> PRKY5BoFL
>> zdmVfNw^!<xagcc%`muxq>=Ix{Xe+_5Eaq?u<Bsu|GZlH_AW2D==d1T
>> yWnHSd)0O-6
>> z9x3ZeYVO>Z6YSy8Zn%9ffjBrM(*AW7+W<^0&EMJH!(qp*5-
>> d*l`jOY>rSt*1aPQWP
>> zkR0&WImG4!F-
>> l7t6o|#L$JjaA>`^K+5t{L>`vVPNCkY^O#fIvzqO789FS=@Q*=Glr
>> zwe5@dKPaOj?tlk9(1kBO4WVl+$R+@nI?!609T4Bm%G2X{ylc|4&n!h
>> Ys=r|NDodV=
>> zPsrgC$=?gFhUQ<XTkM1J5}@L6iRwn~0y3`~ETfiu#_9V3<p>P7R^tG
>> h=4bw*nKM<8
>> z13D@xQzbT+2XnsOK%aY6dR})nI);yc1j;My&QIIeBhL{TbCYlDQvT{
>> L<zDif%E;@E
>> zHhqD)a$dI&+SSRtZfS!rn#W;9Ik1@5-
>> A>w0syyU<?dERJEw^`hq&$~#DzEzu?1&un
>> ziZI3`y<nwTUThjRc)-Sd-
>> {SXxJr`RoKEzLx?LZ|a^ogwuo>oP{*Hn?f`Y7{iQ*@4d
>> zek_8XvxA0Ydu7grFt<`RFp4tBzFkhuk7*oGl6(Vwm_++!9?LxIpwl;
>> U*dubOZ@O)l
>> zv%OQO`vi8|#C|BBtQGh>$J77v>;aFKqdMfU)8O|v%6p+p@DWf7y>Za
>> N`DNyk((VCY
>> z=Ee9%|ADqMfDW|kvn)IECU#l;896lE$)>;7PNSuDsvIH_zal%l9-
>> C1ahdGYap|K~P
>> zmnnJ7GlB$D6nps<%A42}hi^e>)09o4*dyVK(04a&b5VB;?UQF#r}|<
>> 4YaI65^o_ul
>> zLrVrSF6G`N&#7}>-
>> p6_NkJRbs2|RajiGKtQ1fP>Yb6MVz$OTF%TkcO&-{G-5zcL8k
>> zw=Ej7!yh7*z&#Qy#<4X{pozggX%_a&!7sW|c>EQ3taGpp-
>> !gnCGppqgd^KtRb-;X#
>> zKqaDUE`d{0;e}NnS%cn#8bNNPUmdx@-
>> tRobxSvUSg7mOH)*9dKL&m*~7wOx^-)-rN
>> zG7pV14>go}%)eq<uK~{o+VH~uWNS<e1j&*4ntkw$;HUT$1VHu5p)HJ
>> Dcr<j1--Nt~
>> zKk2PS{?(Df?is+05<oB>xWaoLU+iz)YP!gdL-
>> TBCzSor<z_zybQva}?`>wQ$jA!LB
>> z-<Pql#vThxhVq5+C47mxa=ao-
>> 4$mEa30_;qt_%Ma`bx_E4!lmeF*2sorBCc~1S+)J
>> za|dN+u*PyX{q`2RH>eMcEvM}B@Suq`0jCc0y4H3A{RltmXtz~|ARs~
>> V968@bzEge%
>> z<sJSzhj9ji``C8Fq0<gPqlGo#Irv+^Uuo$#bZm5dcLlWi66ePl8wZ&
>> e#G)2ovcvc+
>> z$dvL{^Ug!Q#V2@LLffa&7mc?4*x5?TIz-3&*$R;v33m3-<-
>> T!8+YaM9=_}f?EBJ2*
>> zO3^>1tZPXyJIYyWKqcgR$oEVUy!lu7xuQ28!gmwh+e8pEKVur)_4H?
>> @tV!92BD1`g
>> zC}WL#{7qBVnW(2TW*zx;g0=|_B`Pss^4?U5MFs&@jbyGgRTObu>0=8
>> {<U4H1mftKg
>> zlq$Mc@NC)AWz#&1K2t5wa@=F!|1rlGeEGyuONP!;%E@|W*%Y&=<~E~
>> HiLXi-Iou|G
>> z@ebP16wjA6hQW5W3_5GntUxWWw*%XE+-
>> Q+CHAVe8;1silaGLt&#);1hJ$~q@!3UN1
>> z0{@D(*lPmbk3zfju|vBjUA1^9KaHRw9$+j5S1Gt;9i(`QDzeKZ28ua
>> +Dm=(X?^>x}
>> z6-
>> g>{6Vau@+h)z*xhYxvo`D0N*l&EI`25$>4a(9DpP_9<uEc;G{7i%<89
>> (jlA6e&+
>> z_P)(LdA3V$@uYJ>-
>> &g79^VrrtJ*R#f{=f^&iT!Ur+$A*c%SsF_b(=+{^+ur|+Vh}Y
>> zTh{)(jNz?G_*@I7x5!~Pk4tO0j}4*{G-
>> qGdypWH6uNEIDMP>Bq1PA8cgbsyl99>ae
>> zn6sd;MZf*#!dIAAxR9gfRI}sX;p-
>> 6&)k)j6I1iLx*4+J_hoFBpV~wb4mV5+t)#C6|
>> z?1l7;;BkRR`s;<;stdu_;-N2H@Y?COp<~?+m|`Ei!!IZj-
>> !@9WV;_r5;1)9%YUWvS
>> zFMV#rQz?5yeAjq6%1j?x#tEEa+j47tl=jcEf(K3qj&|JBBK^0XJ~^b
>> Tzy{J21u8I&
>> zwzTQv>L=5d#)r3b!QYH70^9j!n?=D<s^vr2DFU%|5a{7ugLyc3_qsF
>> -m-r3hSIK(H
>> zI&idtOV*z)yx^;PJpcJyu)!6`DP#VwAobLOX)TK2&cRI8q6!I82HsD
>> Aw;!jqCgJ!o
>> zw$J*E^gnYdc$BFQ44zjF%$K1hY|FuXD|o2{_7=OQvGy)=<ruPgl6mY
>> n<}4B*t5@H+
>> zYn=GB>9=&tfm5-|qB~Vz-
>> *m+~*+lZB|8;f$t}4DwY(Q43bybvI`<brlM0C#Bwmn*^
>> zzucEdAfBZvu%0y?@*mWgPl)||aFmLT(-
>> zM>bSY_8zDu3+Y{YglCsfD{ddoWk_>yn3
>> z1|HG<1Tq+3q0RP}AJR3inw0HD4q0DP%qIry_|SRpV4tJ_`8`~r9u(a
>> ta_;C<WU11?
>> z4yb5Spcp<^LR%waSIT7NF?VBpHWBElajdLMW_g#>U+w#pW#_(uO?6;
>> Np7?y&CvP<{
>> z2`af;^z^4JyPM_hA{AHyV*@a3ooKJEl`uX%_&UwlEDtu0=YwJ|Xq#n
>> 6ME)ZLFu%0<
>> zZ~G6KOMi-NS@Tc&P6BzFto5CupTz$VA6VA&B8(N=SI-
>> KU#%U5cvBsk%OFxSH!~+5K
>> z4iX5jU%%lGiyXI&%H1dd9tAc&{BD&X>uUt2DP7z(9z4=^@h^`!{7fG
>> aID<dWJiRp^
>> ze#(3{0(~Nb8a7dA;5$U@DBq`ou9Bis_-&$lJmiU-319PhmU%-
>> K^$2vw0dVV^pEo#B
>> z3w(vPNZ*TWN>C^XvMl*!&=S1dH@#oqSOIwK;Cz=h+X1<pHB8~%c-
>> rEFM-|W`YX&ke
>> z6+A)ua|*De?LP1ax2ZrHWhH%u)DI3>)3m=exx7+-
>> 4Kzvr+I?#WgQA_~PruVQu9<nw
>> z;Q8>kWAKb1<^sRk;+a1)8T^{)S!_=;<LT$z3%qymb3|STubBz|L@xS
>> eJib0IbgUE}
>> zpclm!pLDg|>)AMAs<cf4-
>> |QVH!945$jq<Go_~GBt9>#K}l6F!C`LpD)0DoQhVbUMs
>> z?+Sj=Wdq+FY(FhnqXKt=)A2=|c1r$2@`aA}(bBK}T~fx_X$RDE%Gv#
>> )vF@kB$Dl>#
>> z)oN$eCQrZZnlE&C^;>NJ&*tyZ{f@8YJPSXBPLVNJ`W@(o1C|{@_9~m
>> z*_r0J$IGL7
>> zu%U*vn1Xdnx{#mDD!z*fABywV@V$*-
>> A6xP(bo6mC>ro=hCB_lH)w)(hv)b+z_|&oN
>> zk@L+gDOJss0LK#CnDwx7z7=>&jYzK0kZ951M?WU6h>lQ|r}*}B+LeF
>> ~aEHqh&dzfC
>> z|4;co<xXu{%vvJBv?ig4w)>I;+ZNOm;xD9c+cB}lhaOlB4`*0%u6s|
>> y|LX_ci{B%<
>> zcxd{U)R{aeU+PJj0`e~56Q|&RACkV2XTEEFl3+$onLP63UQ)OJ`Amz
>> (MQZJS)(qWz
>> zm){<_n#QyAn*_y@prA6RoCEA+(j}xaMg_+v?B+I}MK6AcR54E!JumO
>> 3TY&|S?C;?j
>> zIq5W5i<ENk8=0}cyE#0+2fZR~5x-
>> yF5v&Xt1NuwkNc2~Q`1hrW0kLxuY(wU6MWo`N
>> z{TBQudi!>NmNJ`NvjV@Qjs%^%h#h{7^!t%nEjiF3{VhQ}@?A-
>> 1f~+S$wQOUd=(!zy
>> z_c^R5*YmBv@>>&B=4oVxaeTmouNIlGrRxUj82CYZC#Z@M(^b*Jye(Z
>> GO=~GA6#tX;
>> zAcEOw_(vYv_@jr-C!Wqv4DHVvb;H-
>> 6NeUUi#s6zj9n~(?g73xhihoyiz0oUcgE7`b
>> zk#S4bL{Ajpy9&I$U#1*^ax_B~iO>2IbVjI*^(fXO_kLNvJ&g5wKBYZ
>> *J-)*JtUGSl
>> z*J5@&oj))1^<p!22tSAKFa)M>r{*N70CRy1nd9?qY}{M=b*bCXB{70
>> 1$TySc$y-l5
>> z58=N^&=Hx(h>qG@ql>>-
>> o{SC*K52FkgrnZa_|fnQzq!KmyreR(Y3Eyu%y(q&T)=u@
>> zDfYeqx=#`WtcbSBoc$DY^;68%nPWT_pOftL;J-
>> <KuGb3#1q3g9k@Xqmr2G=8pLI*w
>> z3-Vd|Q~VT-
>> _J4`?o0Ru#l{xOHj%wzx1<aS1Vq5o;r;`W%*ioKE&ut~u8Ly@4LsPAH
>> z%oSNnJXnA|E+7?svQ*{U@0ia?`BJr`e5umCR(WGEj2ye%q``UP>^yY
>> X0In=MZ%&+!
>> z1%uy>wBMP7^U|z5&mz`o!LLD+M~#{)?Gqg+vMOt}&V1VTu^roI`-
>> ;D%e}pfxj^_u4
>> zV$F=_g9;r#276<@!#*q8BYDo4du3=n-
>> aGY@2G^s_cD;c$@@#af_$p%S#P9quus}H7
>> z!X;}wtS63U93Vftx@7%N=z|6gew?(|3mHqrCp6v@h-
>> )UnJ+g&92mfpFzLq*-C&UMG
>> z!6Wg-
>> d{PfRBkN8B>wwNT%>f$4FBJLm$yx{f5&WjTZs}9KGvVtl(NoqtXcD+W
>> 5A*R^
>> zL4r?;?~U)e$F@T@Yz@DLV3x=5jnC}Et~h)w1&6g(K);&65cnqWb!ij
>> &#?f_>7jX@m
>> zx5w@K8hljumZmNlYdTl;ib)&cOZjQ}_RCnR*;KQ!=9ZE!Y*xL;*p@5
>> y&BMBZN9JRc
>> zD=5sb&<xGHlzRD;QP{>>;4NKIyRlApx0K$ZD)#mz@f};MK<=m48oIY
>> w5wwx9T*Z3N
>> zQ_6gBJMal0RgZsJ$=p1nN%j^oeh+`rWzC(3`T<Vx`4VV9e5<Qlba&G
>> xW25XXX#?h9
>> zzeXkSJ@s*)^*uE@t}WN*fi1fPU$W-
>> 8A_soxDK4P?ELS(rozlM!?}XQ^<y6Rez3ios
>> zxiLOm<w<1DlW|LTv~PE3wC`|_!CIhluY1mr_46#|1ai;5H3yFMZTAD
>> vg5OkG!n`S3
>> z)iwZ^ptQ2@?cHb-
>> x_&*VE$?1`<9pVZz&8TpU*a$#;5TL7rtCVhhv+0aP|KXqeTp`h
>> zN}FG?X=BVhCf^ve%)I_~+B_bxpZx)~nGgTIfZ93u5@K)tx*bsa1$2R
>> |OUSy<9}`gf
>> zC}Y_kN4DM~$kzu8njJ~GB4{?_r~I&6{DOgR^`d{o=NB8JWPc$)`fwB
>> ;+Vcw5-6d~&
>> zTHw3nbz+OoA+J*ZU4w6z-
>> tex$w|lAQV?J@zw$tLj_kR=fK+|7YG}+%D#7B|66X*&2
>> z$KM}(`#yL*H25|?$5p|%KS$os;M<=j&uU*ZEg*G-
>> $BwO#HGF7B|Fo6+Cj}dvF=v(c
>> zjkfk6Y=kF1=y%43&>Ljj4F~2H9c}mLy9MSp#Fm-
>> rT?2DF@7^siw?}LdI!@-*&7=ju
>> zFqgywb929xzF;4-
>> 9hjSEzCl>BUMGEoZg2u~J2=EH4i3z13SGX!s{(UBboH1C%b0n;
>> zz}%*5I54-
>> uCJhJX9uCYs9GLr$56ry<dpkHVxA?ljf)5y&`_<9EKQK3C`t4pkF!#~
>> n
>> zz}z1!F!#=MD=_y4=58&lzYx*2)xg%soXYn;fw{GG_HGb}R!g_fi-
>>> Pw^b~cg-UoLX
>> zJ=a<L-
>> DMsi`R54Y%X)8XQ0BI0i>SADmq$JHoObrQZbN5ZA^yg1@KdB5Yf7ztD
>> F-Z%
>> zTK1d<EGbh>nUn8Yrt*q1|3;bfz+r)>m5oy2s4LSBz)kuqd>wiI4^oR
>> (wdpyBRv$Qe
>> zsP_-
>> @4qPw8hs%^bhQBNMFUIr#k^Bt!BxU|7UIt%t+#eczd;vd{;RGMwz`YZ
>> EoIb!`
>> z+s{5m*~7=W59>t2!wZ6Ivx-
>> e9zqR|{o9^v;Wt%$Z!+&_?33X0mo?zvx1v7hTx6r0h
>> z?yo1RbeZ2?-
>> fW%s*e&(X@?JUb3skzyPvz3Me(@+jZ~*WB4P3f;YxhL1Q(w*qxtW6`
>> z0Podt>Fh<%XFW{?_@T0{U$mGp*-
>> Ld;$$r)e;ql1OVfI*^Y`H6>nG?DTxK3v+4!M{w
>> zxyv~>^eB7ML{3;EeRZ53`enW=^sA4!L%+E(A@usJ#L(}GlR{_bCx?3
>> O96=E4l+c@1
>> zsiEHc(?S<lj|{!@`B9<FlEUtuCKdYyG_bB0NN25g^p>iw^xV<m-
>> *vds|7rP}!vD|;
>> zXSG~X>AzV%zGC&l6}>;+VbhpSTW;dYq%Fr^%m{V*RcyX)ezQ&En~zp
>> };w9P-Uv@Ev
>> zjUD4&cxFGhosc#K>3<1E{{_+lYp$;c-Y*!vl-
>> *2O7yLGlPv|xYP%q!eWM6GFw6g!U
>> zMfz1_bvxz8QBHT8vCGUWO6dbr<)4uE1@smB5zdtQ{d=tax5=#iasI=
>> Trt{sny4RrG
>> zJie(!$Y*>V61=SCwnoyl-
>> pj5OYp>><H&y!6Zz*ufk7gBiyDqnNx}t}BN|h_6jlJm+
>> z<fz$Q*2`YP6wWWz%h@G=M7<>VHOd>GTij)&ncsBiVZ8yGv@_<;ZPpL
>> y2#x)DMt@%U
>> zVb%a-
>> Z9#jdYR3_NKvdtN?Pw<zIQj3i?T}RF^b#2T@8Q9IF6MGFXM(rdG5R79
>> pe?>c
>> z^QDtD#<4K>=PQovcjhWmSJoZ&P;YP@_|U4*Pf9)foQmrwr;g~PCTQ{
>> ?<0B@Up%G?I
>> zx0h?QSrQseFzqQ^8Iwvwcae@zx!oxrD+{HR<aMW(=X9q{pA$+ma=Jg
>> xHR_hRp-}|w
>> z9=$K8JAKZ)&|>le$Eh=UerVzG@!c!9Miwpzja)}rpTJ)j8hsb=xiTi
>> *7P?8wMsm7S
>> zmYA`WuZ{0cow6wO(XzbmMO-
>> 5bKNT8Dx{7PGc}HmUl)UaKi}Ng98cpJdgGOti|IGLi
>> zzDJWx;FJKTlyO+bIGn>coXa?z$2gqNI9$LuT*x@Qjd6H8<8Tq<@Kd3
>> 8n#@>UNly1W
>> zpT8p{a0oz+UXiu4HuOAuD;X>2T2!oO8#?C)cZD(;`|0R`o478ZCkOw
>> qLWFM$m&p5|
>> zKdf+&@(F`}SRur7l(Dk?=W5N+A69slck;su&oGwTS?B%#;fEDoAh`Z
>> Nx>Wi<j!`X9
>> z*NE_B>~LwqZ7tfQqkGs_vWvYG=lC8`nSxx(T9BrSx>@_)RmxelNmI(
>> Y9!Zbf`$gmX
>> zx#^zo=PuMnct5;yWJQMOXs%_4wfqyejZgvkA(v&W>E#1M@&%6c;}49
>> ZxgXV%ytnhC
>> z53i|=dd{v?-
>> k_zQDJA6`(768h4`2OWejuU${idtmpW^)u&{~F`Sdpw=Vys)w+v3k+
>> zKmRBHpu}Gwqsi<&OXBMPaf#XJ^VuqfU6${w{XZ_j^I0RR6-
>> l4ztmA#4ADRGG{|`+>
>> zOa3%JGyx8Ll!HQ_XAllq18x8B@<S7mnFBvGVa^)(p@|6hgMMh@%gFP
>> 8jUSpAHSj|d
>> ztO;of-
>> (l~B_zz7?i2u;UgzkYKnz;3SerRIA&lg)?rT+9k8sXsa<DY2pAEuD?X
>> OaE?
>> z5kDxAl{x%_5`2UE68&F2{DTtK{t}I|t;0VkAwT+O|8R)x=P&s$@PiT
>> s_?z;*c=!h;
>> z)bQUh2ZlNDUx)+eF3Q>WYxnokHOBup*BJj}*XV}^oE~3$joW|MHO7C
>> _HO8NEjr+fE
>> zj;s5MZwGg(bJ4QC%2%q?xd^GO-
>> ~BrFr_&J*{+A@+J!|kDuIQr~p;LT6V2_b?9-IAi
>> zfzP~!50xfoLsaFx|3O*S6WEg*jy9Rk>8#tA@XbN?^qgk>Kd2X<c=ZG
>> JtAqb<eh>bl
>> zLHK8X0Q@ih0r=bhg#2~J`Fo{K`}@BgN&ioa_dluh|MEW}eGY!~!29<
>> 9Pv0Eq|DXNt
>> z_xFG8AHaW+fAqln;_n!Q|Jxq`|C~PnzvoZL-
>> }mZwC;yN9!H2@3Klq^3jW)=|PQb``
>> zdN!Uq`9AxZwLrF^YN|l-g_6Hom!01mPi<gV|G(xv-XD+WzZg&R-
>> lN>r5I<N>B8zzP
>> z_qwv_OqsjrCZlovnl-B%)-
>> @U>B@H#pW={Y3>QyTr{DiUC`uPl_v2LBQl;6pyHSSwk
>> zeZNswxuk009c7E|o-
>> ?<qq@=uT!L+GW<#Xp(7@stz5cIBe(X^Z5k^1LaG2WN2TE1?1
>> z^~&X&Bq)Ew`c><eKTrqEh7HSW>g<UA3s-
>> I6eeG2*YwH?o8kVnFCxPPEq^RnK2db)}
>> zuc~oFjcQz1Yo#f7ud3U)rmkik;r*-cyHAik$gcw2x7ui2SG}%I-
>> J+|65ve0@${sVe
>> zxOj9%adGj7a)@U^I1}BSI5v5#{H3JvU&h$cDGnj)svGX7(Q8(JzOKP
>> oS+}8XrEwob
>> zG_G%4Q@5(tSiPpMp?V!r?Nihr_iF&4|9rX4|K@nw5>LMpPut=t?X!N
>> -facBJxUQ~Y
>> zRrN}vWGS6Rbo`pS<r~Ofy^1jR5*@#KoiTUOG!G&5jk=9Bb!&t~id8q
>> RUiHcA*Bgxw
>> zuBvTV{XpF(rSwWd<=cP8m8mTr9DVEmGvjx~LsCoLuP$e0Q}oKz;<*j
>> LjKldrNlL?-
>> z<<n*x3s=$hhV^S`_UiT0*Zf2PZT$po{jc^*19rPl-
>> (~l&)5w2GwV&N?`~BJY`^q#s
>> ze`7qIa(r}&)Hyr#%K8qR$<yq7GoCv6U;VJ1U;7a|ofJ=<_rvKh2ZlK
>> ?%z<GJ40B+Z
>> z1H&8`=D;uq{yT9%V?(HT)@*RK{+u5ia8iHR_KW-
>> HD+lans@Z?f4taL+<EibnzsnB~
>> F{9hQUX+r=2
>>
>> literal 0
>> HcmV?d00001
>>
>> --
>> 2.17.0.windows.1
>>
>> _______________________________________________
>> edk2-devel mailing list
>> edk2-devel@lists.01.org
>> https://lists.01.org/mailman/listinfo/edk2-devel



^ permalink raw reply	[flat|nested] 34+ messages in thread

* Re: [PATCH v5 edk2-platforms 18/22] Platform/RaspberryPi/RPi3 *NON-OSI*: Add ATF binaries
  2019-02-07  0:52     ` Pete Batard
@ 2019-02-07  2:35       ` Kinney, Michael D
  2019-02-07 11:26         ` Pete Batard
  0 siblings, 1 reply; 34+ messages in thread
From: Kinney, Michael D @ 2019-02-07  2:35 UTC (permalink / raw)
  To: Pete Batard, edk2-devel@lists.01.org, leif.lindholm@linaro.org,
	Kinney, Michael D

Hi Pete,

When I saw it as a single patch series, I did assume all the
patches were for the edk2-platforms repo.  And it looked like
non-OSI binaries were going into the edk2-platforms repo.

Patch #0 did not make this clear either that multiple repos
were targeted.

I have not seen a patch series with content for multiple repos.
 
It would be clearer if there were 2 different series.  One for
edk2-platforms repo and one for the edk2-non-osi repo.

Thanks,

Mike

> -----Original Message-----
> From: Pete Batard [mailto:pete@akeo.ie]
> Sent: Wednesday, February 6, 2019 4:53 PM
> To: Kinney, Michael D <michael.d.kinney@intel.com>;
> edk2-devel@lists.01.org; leif.lindholm@linaro.org
> Subject: Re: [edk2] [PATCH v5 edk2-platforms 18/22]
> Platform/RaspberryPi/RPi3 *NON-OSI*: Add ATF binaries
> 
> Hi Michael,
> 
> On 2019.02.06 22:39, Kinney, Michael D wrote:
> > Hi Pete,
> >
> > We have the edk2-non-osi repository for binaries.
> 
> Not exactly sure what your point is since this patch is
> tagged *NON-OSI*
> in its subject line which means it is intended to go
> into edk2-non-osi,
> and we already went over what, in this patch series, we
> thought belonged
> or did not belong to non-osi. These ATF binaries were
> determined to
> belong to non-osi (with the intent to remove them
> altogether,
> eventually, once we have the next dot release of ATF).
> 
> Or is the issue that I am submitting non-osi patches as
> part of series
> that is prefixed [edk2-platform]?
> 
> > Do some of
> > the patches in this series really belong there?
> 
> The current consensus from previous patchsets
> submission is that the 3
> patches that are tagged as *NON-OSI* in this series are
> meant to be
> applied to edk2-non-osi whereas the other 19 are meant
> to be applied to
> edk2-platforms.
> 
> I have to say, if the issue is that you'd like to see
> an [edk2-non-osi]
> prefix for these patches, rather than a *NON-OSI*
> suffix appended, then
> doing so is a bit of a pain when you are re-submitting
> a large patchset
> series. So I do hope that simply submitting everything
> as edk2-platforms
> and tagging the non-osi ones in the subject line is
> okay.
> 
> Regards,
> 
> /Pete
> 
> > https://github.com/tianocore/edk2-non-osi
> >
> > Thanks,
> >
> > Mike
> >
> >> -----Original Message-----
> >> From: edk2-devel [mailto:edk2-devel-
> >> bounces@lists.01.org] On Behalf Of Pete Batard
> >> Sent: Tuesday, February 5, 2019 8:26 AM
> >> To: edk2-devel@lists.01.org
> >> Subject: [edk2] [PATCH v5 edk2-platforms 18/22]
> >> Platform/RaspberryPi/RPi3 *NON-OSI*: Add ATF
> binaries
> >>
> >> These ATF binaries were built from the ATF source
> >> (commit c3859557)
> >> with the custom RPi3 platform options detailed in
> the
> >> readme, and with
> >> no modification to the official source whatsoever.
> >>
> >> Contributed-under: TianoCore Contribution Agreement
> 1.1
> >> Signed-off-by: Pete Batard <pete@akeo.ie>
> >> ---
> >>
> Platform/RaspberryPi/RPi3/TrustedFirmware/License.txt
> >> |  26 ++++++++++++
> >>
> Platform/RaspberryPi/RPi3/TrustedFirmware/Readme.md
> >> |  42 ++++++++++++++++++++
> >>   Platform/RaspberryPi/RPi3/TrustedFirmware/bl1.bin
> >> | Bin 0 -> 18801 bytes
> >>   Platform/RaspberryPi/RPi3/TrustedFirmware/fip.bin
> >> | Bin 0 -> 41714 bytes
> >>   4 files changed, 68 insertions(+)
> >>
> >> diff --git
> >>
> a/Platform/RaspberryPi/RPi3/TrustedFirmware/License.txt
> >>
> b/Platform/RaspberryPi/RPi3/TrustedFirmware/License.txt
> >> new file mode 100644
> >> index 000000000000..b98dc643227e
> >> --- /dev/null
> >> +++
> >>
> b/Platform/RaspberryPi/RPi3/TrustedFirmware/License.txt
> >> @@ -0,0 +1,26 @@
> >> +Copyright (c) 2013-2018, ARM Limited and
> Contributors.
> >> All rights reserved.
> >> +
> >> +Redistribution and use in source and binary forms,
> >> with or without modification,
> >> +are permitted provided that the following
> conditions
> >> are met:
> >> +
> >> +* Redistributions of source code must retain the
> above
> >> copyright notice, this
> >> +  list of conditions and the following disclaimer.
> >> +
> >> +* Redistributions in binary form must reproduce the
> >> above copyright notice, this
> >> +  list of conditions and the following disclaimer
> in
> >> the documentation and/or
> >> +  other materials provided with the distribution.
> >> +
> >> +* Neither the name of ARM nor the names of its
> >> contributors may be used to
> >> +  endorse or promote products derived from this
> >> software without specific prior
> >> +  written permission.
> >> +
> >> +THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS
> AND
> >> CONTRIBUTORS "AS IS" AND
> >> +ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT
> NOT
> >> LIMITED TO, THE IMPLIED
> >> +WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
> >> PARTICULAR PURPOSE ARE
> >> +DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER
> OR
> >> CONTRIBUTORS BE LIABLE FOR
> >> +ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
> EXEMPLARY,
> >> OR CONSEQUENTIAL DAMAGES
> >> +(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
> >> SUBSTITUTE GOODS OR SERVICES;
> >> +LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
> >> INTERRUPTION) HOWEVER CAUSED AND ON
> >> +ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
> STRICT
> >> LIABILITY, OR TORT
> >> +(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY
> WAY
> >> OUT OF THE USE OF THIS
> >> +SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
> SUCH
> >> DAMAGE.
> >> diff --git
> >>
> a/Platform/RaspberryPi/RPi3/TrustedFirmware/Readme.md
> >>
> b/Platform/RaspberryPi/RPi3/TrustedFirmware/Readme.md
> >> new file mode 100644
> >> index 000000000000..74bcec7d1f12
> >> --- /dev/null
> >> +++
> >>
> b/Platform/RaspberryPi/RPi3/TrustedFirmware/Readme.md
> >> @@ -0,0 +1,42 @@
> >> +ARM Trusted Firmware for Raspberry Pi 3
> >> +=======================================
> >> +
> >> +The `bl1` and `fip` ATF binaries, found in this
> >> directory, were built from
> >> +the [official ATF source](https://github.com/ARM-
> >> software/arm-trusted-firmware)
> >> +(commit c3859557) using Linaro's GCC 5.5 compiler
> >> with:
> >> +
> >> +```
> >> +export CROSS_COMPILE=/usr/src/gcc-linaro-5.5.0-
> >> 2017.10-x86_64_aarch64-linux-gnu/bin/aarch64-linux-
> gnu-
> >> +make PLAT=rpi3 PRELOADED_BL33_BASE=0x30000
> >> RPI3_PRELOADED_DTB_BASE=0x10000 SUPPORT_VFP=1
> >> RPI3_USE_UEFI_MAP=1 fip all
> >> +```
> >> +
> >> +This results in the following memory mapping:
> >> +
> >> +```
> >> +    0x00000000 +-----------------+
> >> +               |       ROM       | BL1
> >> +    0x00010000 +-----------------+
> >> +               |       DTB       | (Loaded by the
> >> VideoCore)
> >> +    0x00020000 +-----------------+
> >> +               |       FIP       |
> >> +    0x00030000 +-----------------+
> >> +               |                 |
> >> +               |  UEFI PAYLOAD   |
> >> +               |                 |
> >> +    0x00200000 +-----------------+
> >> +               |   Secure SRAM   | BL2, BL31
> >> +    0x00300000 +-----------------+
> >> +               |   Secure DRAM   | BL32 (Secure
> >> payload)
> >> +    0x00400000 +-----------------+
> >> +               |                 |
> >> +               |                 |
> >> +               | Non-secure DRAM | BL33
> >> +               |                 |
> >> +               |                 |
> >> +    0x01000000 +-----------------+
> >> +               |                 |
> >> +               |       ...       |
> >> +               |                 |
> >> +    0x3F000000 +-----------------+
> >> +               |       I/O       |
> >> +```
> >> diff --git
> >> a/Platform/RaspberryPi/RPi3/TrustedFirmware/bl1.bin
> >> b/Platform/RaspberryPi/RPi3/TrustedFirmware/bl1.bin
> >> new file mode 100644
> >> index
> >>
> 0000000000000000000000000000000000000000..e25138828d0a4
> >> ddb24772abb1a60eefc334666b5
> >> GIT binary patch
> >> literal 18801
> >> zcmeHud2|%#mG7;pmedFVtpy|tJ-
> >> S*z4DF582<)+{TLO%YF^IMyw%@2*ivhC;Enpe2
> >>
> zRTA<tmgA=aC3r9swODMrCx7^1@T3zb2%DK?Lf#29G?V1z4J{zXv79_
> >> ;z^G+F?{}-Z
> >> zge>Dp&Ya2NoOkF$@l}1x-M+hhw@Q@U820D96C>N0$f-gpvNVO-
> >> 6r%k^_LFjhV53f>
> >> zzYYB^p(#wZhayBm(40?m)v%ZRF-
> >> jkU{?@RJdpUDVq_0@Qvl>>=KM8BSMAN6D9c2X^
> >> zv}!gTC9-
> >> IZXdTh<nuF*_F~<Dabe@Q`4z%dg`yWETSD&vxw>l_aE5oz<u%x-
> >> Mt_I@=
> >>
> z6^f(*?g@d~PT~5aNNv#+%2G)!>6A)Ol0}J=O^M4yanPmrUEBE6z%_}
> >> qi$f`XQKFzu
> >> zlVZ_?G$rnX41{DgYzORyWMj?6p-
> >> TMP#*g+gylWdj3`8X%sIOlv1lmB)R$NV@Mf2q+
> >> zY4d>}JWrcSYDNxGR%4SA-?^DI?>kETG0>;<^-
> >> cF@D)C*r!0X4PiJ}^Q9sQugsR%T^
> >>
> zW2zF8L8m(ZKusahN`})&<nhl?LUy9+i<w(<d3`h1M5RpU#l^0`wT*}
> >> SX*21%1imhU
> >>
> zPUcNemAKC1ZY6&CX)*AHBnEe$A?>mx1t%~~5>0PQR^krEJ6wr3iAo6
> >> aZSmWc_!Ag6
> >> z`56X&xUWmf4DJH$r=?NBrxUaj_-
> >> e#D|7a!d7m4LPR23=2^S_NbBGxi5Ce4?hcK6f$
> >> z3TXVu>I#)XZeBsnU^%~vzTYcJS`*qLzY-
> >> q@C2Lj%?d)EP7gLhfKy+cZh2moYa~$X{
> >> zx3%XUwhAHXdf#-
> >> #Z|vK6?76XLKQ{Io`^9@z>$YethdSW8QZ5C&;8{(g13fpB7t2Z#
> >> zv}wTee+aU&&~*P;CC>ZC@)`!-
> >> q9RS70s5}E1#NvkX*|Abte|y4K4Ov@&cGb(htrS!
> >>
> z?UHhWQSQh3M%HhErgcf#{e7FzN8o|+H4LXX!y1D17Ravw@_ZjU`DI^
> >> Uc2vsJ_nzf=
> >>
> zrMw8T{AXPU*sfUT3wKkT?+aC<bwGw9De+Pgy0M=g=$J0&Ya0&+1VIh
> >> 6-ju<Pc#Vv`
> >>
> zxVG`oUb4_488RjCX~^+rc9W#N2)U@RbJ%UGLl!h2_J5$wD2esZiB|H
> >> 98rptaG+{Rb
> >> z?`Abg<Nbfx>k5sBtYoZHy#nk(iF>b7Kn7plG-
> >> GWM_MT}fv`}>i_+g$!>kYVAtMjMZ
> >> zKkRxSPMv3q!LuE3blU*#eDKfoFz*JxKk3(-
> >> OVEQ%;4th*3YIr1fsrJ(5J@e0*s~Mh
> >>
> zd0nc3pKa36?~nW8oE_jZ2E+0tU<o9&L?uhm`e)&NbstQ*jvlxV@Ues
> >> Ufo;hxCu;)y
> >> zb8)?|=Zqvc?PTfhg!~*9(h6;K!PVE-
> >> uN%59sIE}y(y=|nx}e_B1%~Bnc7=Gq3awQA
> >> zngJu7<>zV^LM%V#S;F3RL3YfS7qNwP(4B`1epbOV&*!-
> >> U`W><occEV%(9iz15;#~t
> >> zHv{J~&~p)X+?PhxycbtSQ~c)^@_Yhc#^cMuUlRBm@<L_LSt-
> >> f+2f*6{-VTB{A9%B1
> >>
> zY&>*>{SoGslw<yPvF^amWNq8$n~tBeQ2Kr`yX9x#wXS|#&+nm!93u$
> >> yvEMu`Wd$YZ
> >>
> z0sI*FDLnam*tH7XfB(4|J*)!~;KDY8d;0peMS=ec{NW9KF#I&jq?|9
> >> S5-$RMEEh#I
> >>
> z^i`J+#@x_ZQ%2^P1^vx@A)XauojPD0$28`L<)q6J^Bg(AorrNhU9JY
> >> bO#6$Vk8PA`
> >> zG-I1?2mTbz(EWqD?jJ-v(_;wwMQRF*7Jp2<MDeJ-
> >> Zl4U>xnU~@1Li!YAs@Crw^@mE
> >> zJEv8N!xy*iIXqtPFMdslV^5CpSP{AOIqo-<I9)>j-
> >> O4@(<co3b0C4Mm2z>pGL|JCs
> >> z_Scg326Vj>zPQ7#guJ=UC5TLVy!49XQEbg6O5#}+;Onf*7m-
> >> !0mNBN=N<p%=2(THy
> >> z`+O4T8m*3;WR2sS-
> >> uGaVW;O5q7Gu0M33`<nH~XR%Z5QzCFpnl{4+19pY5m!gq7~qI
> >> zD(E!j%eu_A$MRtv=G@_OCdDsv4kEhZGkH&-
> >> Pcn3lpE*W%Nh5=WiGDBijN|Fcx^87U
> >>
> zFCz~a9RI%&eyS_(7ziKFCj2`G!C(E2@DqL~LA#o7)iz%5+r}}~dpbq
> >> ?E$-E1S6ufq
> >> zWYzslANsu4kyBufTd{&~mmve>Q$5%FvW<L-
> >> oTf}NB{e(^`_Wc5M9bWi`L^M2g&^Cx
> >>
> zDrUA^fensqRsvDTMTY(PA(O`EYI`n=g#1N`A3|%|8{6KE+~_9(LH?@
> >> jw>DWdQ~o5Y
> >>
> zCCK+eYQ7j!pl>qyYZ_h>Cwf!Shv$Y|3VDZ9h;3(06152rzgE&E_-n-
> >> MZDBF`ZcHI1
> >>
> z<UlNH)MG2+oSLDHfG#L~SMH~*ZDGP3pZMRVh?&NGfhc6cFxPgNYtu3
> >> {2&rup>r&s9
> >> z8Dulo!>&Ve8fDmJs#eXpdo#6Up0{e#7UT!IFW2?2AWM4-
> >> F#Z5qXW(MGng6G8uYzxp
> >> z-YXF-
> >>
> N~n;;mHn`Om!<2yU{gX(;2CpZQ{u`_6W9Ea+GfBcFvofh?m~X#BzP{-
> >> We$D3
> >>
> zw$X@rr=ioFC%dpG;1$=7@S!As%#CLUiAMzZ4gopP=p?r5p9FN8ZKE_
> >> (4`4T~wJ(j*
> >> z_vcyQWcnR!r#Ksw4Se>K_P2Om3_F89ZA-
> >> &FVtO^(5%$Bw`PoQ?G^}@8aj)lL$TPdx
> >>
> z&H#^gkJ2*03)>mb8I_m=o~P;K%d@pP=;M6rIlawvehFL*hv)ReIh(C
> >> Li19Cwo9XL*
> >> zkfU)d(C>S4wCRbpld<-O-G02cQRn|A@%#sOXq=lf-)1f~R-
> >> i2Ajo{P#z->nibm%@!
> >> z4cmYVdKw;%wsZUU!`>x<SSNBN{|9e|qd(Xg>qKtk{q~z-
> >> <$d&X&eQuwSbq0lOvHTb
> >> z-xlzKSdbiK-
> >>
> %sg$)?2@i&vyLGd4NMr)8wVz9wRo~$cxxM1xrE1kym^ix!8q6rmkGQ
> >>
> zL+b&r^Pq3rERYN2g&^9NiT$ceRzkYZ16%^!Mv*cuL03fNBp(qS5a+0
> >> 2j^*W@X<B}o
> >>
> z__kQ@=s5v?33%*j^)WBwc!Bj3UcX)~;q!<$gKcw^^G)DjnIS&vd-
> >> gP1$fd*&+ty_{
> >>
> zAUFFJ*0b)JI>$7yKj3&j9kwBW4#c309iX3O(&cZ=Xv)z2eJasNXOXS
> >> =xIm+(;4D%t
> >> zlbYKIzAQ9yN+G=zQ*CN4)#qhwhJPwfb02R<j>P&<4Et@LK-
> >> DhrK$J7ZVR0RIytV8&
> >> z&y%PzEakov<9Sj_V|Z7NKjt7Q=-Ub3W-EyJ-
> >> a(Fuc|w{R_Qeo4U~i`-(dlhMj$cNa
> >>
> znykdjn$qDLp)=r9w8G!P9_wzRW5|nPx0LaB@bxS|Q^!7p{&IfIGHJp
> >> Xby_rz!T+Sk
> >> zU!#8$`VYD&g7c`x=kFUiz*qFxS%Z1-snu+Ud<GQ+<$m(BKS;@-
> <i--
> >> zA8KSGC)x5M
> >> zIpEpcU-
> >>
> %S{JmHb!r23ANWhwM9FA{Bd1vQ1dh!;9eU3t(?)E}aG5rGPD<wZKscA
> >> zB(
> >> z`gS}JaXk3waR<-GC7;H6*!C|#54R?-
> >> ztnBj$Uk+xhn{fj&8GJt8$AzVd+UO|nYjnY
> >>
> z?H<74^Y#8~ecLk0I1eA@IQXp_`M(+SL1*IZ^rNrp8SDl&;M|FGVh7?
> >> p;+gY%*uMt>
> >>
> zhkcidGdah4K6`fDsl*=wF7EHdS(DF%9Yun+F45;lzOeHy?7e`TaFh~
> >> SEU6i#MBSf4
> >> z$Mmykxp5Y4f{j#}YXGAb_l(1V_I-
> >> |{&~4VC4<u@19h?N)p)dQU>oV)Nn}5;IG=?Ae
> >>
> zpr5CXmgGPg<mOhD(5|g1fjw_q1Mfc0eqWi%F~lm7hwTb6!I=lREI(C
> >> LW~#93q-1Jq
> >> zOD63q_QStf)DD)SZXj6#{>_5szYBgTS<Uc2jlPuPfImgVH5-
> ={=-
> >> 7<93f5WRV_4s>
> >> zZTy8!TZ1e``T)z6y?q>22Otak&tZ4TY6-
> >> PA=Cbcl1e{fHk@ZlnK&U&(c^dIKr{45)
> >> zKMjb=TP69(1#};QTpGE~d$sN{+8Nl4;D4i}BebiAtgnaVv+u^-
> >> @DpChF%9igkfCme
> >>
> ziQ16^dT>s+p$~PLvERI`pC^PMVn~qd5Is1<6oH;AQc~~>DFrqx1TIM
> >> y)Nzu7?8iiD
> >> z<PjrIjSLn6-
> >>
> jnD%EoPxF3v$g07FpDiMd<rT%tT)%$FraWc=OQ*eLhc}c^a?j&yV!F
> >> z!Qs76Ko(4cA2wB(=81Jc-
> >> wQ2I##B7J^!ugoxoWrzGAvAcCZ^!NQNQ=bqABg$Sr_<H
> >>
> z+yxPWuVb6>VVvNzI5$BpE%E$dM2|OIOSHO=^BSHjq(#GIjfQ1Xbyy}
> >> GL&pvVnsF9*
> >> zg*tz0u^Q)_f3bD`7P1UBQ}Uxx$jnF98G`?nl4cT|&6||1|BL+-
> >> ;4+QPD$iT7k8^kW
> >>
> zaP4uy_FmXR7W4_hXuBF#t^OGMuc(azrx7C!oW>scUlpJ>d&3>&r0vW
> >> `EVUzsvTu+@
> >>
> zZP!%96UfrcFIj%(81faw6~k9DExJ6g4!YrCSukDsfT1iU#0%sIxG%$
> >> gig;#P__;!d
> >>
> z@zX#h`c2(q`!{i5f1MVblSG{HBpLN9rb`{K?H}ah!UN7ttWRu%9Ou5
> >> vbmdV^CulMB
> >>
> z$A}s1w+@SxW!RHh^ZaR`0l9`7Ie{4~YoP<>$?e;xA_me@&Ldxp)n;V
> >> |%S17FF}r;`
> >>
> z^Sn4OGuQ$6W#Wc?g|s2I*tT^$?|&_xr&+0n$C?y1T#Gd?fgS|aEY!<
> >> N;4hwIS-pV1
> >> zT9Jb7sZ{MvuHVOf<bvNv-
> >> &g7Tp>9)O)+PnM<QNXy%7fha9Jvnm7hh=!0A}}e8rjmz
> >>
> zdY(+jSQcz^aVg2^e}Lj_d%HJMXdd)E5A_B@PW0iXywN+_DV^lsZAWe
> >> 9^?c;5&y4%s
> >>
> z_S3+Tg*o>_2Gbg{Mz?*R(og1}*xm`a{u!u!rck=S0sd;E5^9%drI<{
> >> f@~ui>Yr~7j
> >>
> zm(Zw|%a~U|mX=bIx}n?0QdZXXsPYrNQ43}4LhSQNsNao1+$8A;a^)7
> >> *7tZy37~?p}
> >>
> z_ml$P&aq&IUfX&dvG~F`sdPgWbG*n4XxxeIs!03U{u*dxx1tvJBA@g
> >> `QE!}xKIXwU
> >>
> zS_z$z?r=t>+~BK_HLA@${s)x!4$yyE$`0BoyZh64pGN_WW3XoKeM(3
> >> H>@L(u&TXpO
> >> znnEf6=(-
> >>
> Q*BH)Z#lzqH@PXohDflnI^|C1ZEC~C>OQz^a;@LBiXoyzgQDICR|r_k
> >> 3R
> >>
> zj_mec?enm&VjGRZCvxmL_eR~8Kf;F(^i}bd#epwtXT#6`T=(<iQ9qf
> >> TPWvYy2Ir$D
> >>
> zV!ua;Ifj#GEcU(OZY6eT7<mq&ZA5E<9haikWwH3f#kS&J3uxfBBaLJ
> >> G4WB$pNNQo-
> >>
> zIEg*lkJ_GH7}br~bd1lRWv!mxy+g?(0)D$Fc0bJbz<mn$pQe&$Xb$o
> >> }=&uO6Rt_2W
> >> zc17dg_Ee<Ofpg$#6<Lp*MgL)m_WvPA3H$>4-
> >> $2RTk0jBtru;{G|M+Tq?spJ7+QroF
> >> zGI>rf&MKaNr6ETOg|u$ei9H8FyO-
> >> wlHlkmFd>SaVyP1Zxs9WarvJQQ6XM3()KrL^}
> >> zyxy}j+H+5lW#zv@@6I9LKFx9j4dq*uz-
> >> I7Nj`{5(bni8#mu;$cCuwoaF~=Df&(X(i
> >>
> zo?c&K4)UJtBJfa3L%S;qjJ0mS=X&%Nwma;vn~d1w1<Zd({llnjXX<t
> >> EFrNMSEHCPw
> >> z2bdq^!>4|WWl7yDphNq=Me%g-
> >> MjWdYyVil4SQ?%k7UR6>gUzx35ODr9=k)7G;;jF_
> >>
> zuMN<d0q1|iuivO&aQ?yXN4yzIyc4xCBVJ|&Sr*ShFMC;LdQM^bz#Hc
> >> T*5fS5fzJvY
> >> zcV{9F_-
> >>
> 1iFjdud)Up#I{jolCa%5ovA<#G?nhK$OcI8$Iw0|_fvV;{?ao7cD}2`
> >> %P4
> >> zyG6OsfjXrFF^|uZZJ<X@g^fdR$^nmkbp>#-
> >> y;PPcArb34ku$RFnFcTBFb$j0*Z8J_
> >> zbG6h$*h|#$y8YMsJk7a!-
> >> hZAxw`)zJ68|5_{ooVY?!_g;XY!fCTO!QVa~GZekN2|7
> >> zS$=$7kj4a4z%TgQFPxtlar9JganOtVg!6YqWU=(53-
> >> s*7e4Yp2)28yg80OLPeL~Eb
> >> z<HMZ4zv&#$SLS>db1nkT>wtqp5&TI;Fp9n5_R~cBf6>Z-
> >> Pqbm54EX#m(+fI2!#c#1
> >> zHsqv7-Gq00uy?WwZ!1FS$v<F>b9g?#$awbaX9(z3p0b7V>bJ-
> >> _N(=MK{q&%+g?(!@
> >>
> zyFHitE@K@*z9Qb4a4nSJpLtIOoS#dPcOu`77vdbudr0s#{4AqR%lmA
> >> ~(99Q+KZcP%
> >> z#*kx%kz>ZbhnO!QmvkVPJdAsD-
> >> f#FG{!2j32DF3(E9v$1?*ry3iMl(GTaUr{^pvE;
> >> zx?o4wTa-
> >>
> AT%P^*KtY;lP_a$m`uRtG^F%bcm%z0WGYU0qtsn~n_tHUGh4@fvCWd*
> >> 0;
> >>
> z`IYY%2b#ZE6li+W9Z+9!1)@^>NdnJKjNOIH3)%i&vIjo_j$giJ;A<C
> >> 1vndZnCgaKg
> >>
> zJx33x2f`}F=ZebvVc_48*iX)hSU1>@UWXpLp(6@p#PTU#AlSw~F4$O
> >> JBIGY!Zx2h+
> >>
> zgQy!xsqK`c*S8ui?jFR(R6bX5O<z^%7_a5Cp#03j<8qqvK0oIJhJ=g
> >> lQEA<*=aygT
> >>
> zla0P16O_OZB`4y<H9~O(M%Z#9lW?Vva|afo9YVR0)VqrUsjj@p(2|@
> >> ;+O*<8nw%54
> >>
> z2iNciX9tGw#JXKM5nJ(`z(VwCN3mwY+`zn}qa)AZ8dmUdU|1dIdKvz
> >> _z=%bFk1KuL
> >>
> zBZ0|0w=*Y_x>Sj$?id{zI%$63uA;oid|bl{9t#XZy9U<?WkF!Xq`b(
> >> ag?SO?4ez)E
> >> zr$-2Zv)N+c6T1}n^iE6Qv-
> ^?)pU+4R{HZV{aDJ{e5PN(`;L?)Rz!#-
> >> M13k;q0=-qk
> >> z0#~0O9>{PNL}Cp_t{Y8J0LKM5Zonx5oMOP44LEZEXD;A83^?-
> >> u=Mlhp6maGP&SQbA
> >> z4N5%El@q!8{DJ_}^C#@-
> >> ^^FSrVLN;T>H??_Txg+qY_k$S|FcDb4Ahcr(7VaFU_;qw
> >>
> zV1sIwQUE>LUxc;S(C4MnliZ(#y2TzF9aG2s^L9#u{Y{_?MewJzgEZ<
> >> SZ3gBi_4OU#
> >> z`JZ6^-
> >>
> FS`y&h7_<g`eU6EY3^KSdaW++kLpM<M}1%UI)&{W9flN`TT{)o1hnN`
> >> D4!O
> >>
> zT8iKwiN?MzzcdtnL~LPw*#*67hc98?{_MI9|H*ahtvAIdf~HBJm)kQ
> >> ;Z<=!aWzf3|
> >>
> z^cEs#9Giq35j2C&&p7w8;4H&uqzVh|Zzr*P0_rXHG$jU^c#_hTef%!
> >> vWyBAA78TfG
> >> zLx;ed9WlNM<MvIBd-
> >> ?uj^c9l>d8DNq{@WwhF;B>U@XWF({(KYs;MdpKflp;PI&4vg
> >> z%`#*B-s^bZ2K-
> >> DL>LWUBP3SY`TJ*Wtuk2EVF6;t~v9?2dC0pZOw?fA_rvM%M$3jOW
> >>
> zz;?r@Hi8a)KOhU^dlbj(=JzQ5dj&twxeU+at07SfxQz4Ix@>CgSg*w
> >> W>$xsL@XKoW
> >> za^hVta<-8BnVbwa&X9PItov79b8+#(z@-
> >> st24cRG*B`+8k;tokxOa3G&D@!)*U+Dn
> >>
> z;YV>FKMk4@JDq$^SE%qL^2Ev39A!h+du_P~5N|JlHuzZQ#l?sAnz*k
> >> w0LKyokBQ?l
> >> zbagNe0*(&k42N_a#`}-
> >> K@M8)1mzEsbd%eMUkB#p;_B$k+CgO6h%3GXo{V3O!M;Y!-
> >>
> z*2QkLQkoJfr#q%dX^1U|FQNsPP0c7LF_rtukr!|aUs@tzY%FRD5@e+
> >> J+bG0&1Irpd
> >> zTW`<7Ci#8r9LT9N3po<oC-
> >> ~v|@^$3>z|rdPXKILJybrAoISb$3B<}sVw^6(Udm~sV
> >>
> zzJ>XLox=xIcR@$;@y@|*8J$t83e_BAcY>CD&^)+bMjzAU$TDOuV4aW
> >> Xe!@GH1g#l*
> >> zi*eQ$9(Mq4VFIqn3#vr=ILAk>IpCa)cRS;ePv9K0b4-
> >> L|m|Gqbk&q8cXgP**4q`!#
> >> zV-
> >>
> I*p68y1dN(#Q*^Wv61QewMp&D$+D<J&66Z^4{W*cI!Kw7jB#ZDl;p27
> >> Atz7Bo=O
> >>
> zN*O$QDe2J!&ANQC4_G7VIp(<K<pq}IV++c$j%|kLC6jREENDFi+ho6
> >> a3H=iM+IU=D
> >> z(pbn}z;_F<A^4C&BHey>F83CcEtd<7Z%Zutdw^>jf6VWc``=f-
> >> a|YiG;cR_LlAKTG
> >>
> z(PF&ccS_d7+r6sgZPeH<EC(+5=X4Rii=GkEJC~0yIDoSv*J#)WAtyb
> >> 6T)#RKda{b?
> >>
> zLe0~Pxp=SlsGUZx{0?~K8h&ju&fLf`I0whsYf*bLP42{e|Hls<qt0n
> >> 9<ZqbSgZzQ_
> >> z%`1)^YMueiZ(y!%4E5I~InQUBxi-
> >> KxfvGs7J>XIFvwsfJ(VQxW#`S@0jC~urq@pGn
> >>
> z&BeQwHmU}0&5=u<Q5Zvxr;ph?g=!V&J}dmLy;Z38BKP_^XtQ_Xe0~R
> >> ccn#105%{w2
> >>
> z#yHP=PpEFp(Z8`s=W)c!Z2JkoNhi;1y!MwuHQ}uGV_p*#s{J^V+CLS
> >> lyG9xCT!7bw
> >> zHOMQgQOoljg05_(o*BME<GmJgsVr|krN95tRQPME#yQf%V;6A-
> >> f8hL!TQ<P&48t6K
> >>
> z&3*sD8jRgoqlVb${fK%#=#_GhK&ck_akkwKxu3xvp+4Z`+9{v$Ij>{
> >> bUf}!!zK`iy
> >> zpP=Uy_M7S9F@`-
> >> lK@W5w%rz|RwWdg!Ed+h{q88i)_`L5sBw^@9;Heq_yEg%QLjrcG
> >> z^mW)3;FV!F!{3<jy<(0I-
> >> w*h^QJ+}>9J^6B;qxrxIhjg}OrH2V6}*=$xhUm275J?k
> >>
> z5)EAd8V1Xr`C<6Xt1m$hZ0T#fdI!kf3;BNInuP3GK3D_U3r>?JrpIv
> >> $XfW|JExgxP
> >>
> zai(N>aGma?c*khgWfk@Un_nctAC!)x>Upr?Y}DANL$*AQ+$<Zq*Tyx
> >> aiMWqSc~0Fw
> >> z;0$ltEq}juqqg%iy|&Z;zQy={#Yupl2mGwx-kt4FneT86zeu-
> >> #w<T~}0=Fe_TLOQv
> >> z1k~_9UG3ZULtKCHlK;YqGGg>L;C|~C;a7nFdEl<UMfknIzXZ6K-
> >> Xi=e@XrA5f?I^&
> >>
> z5B%A{opX!ucLM(v)FgXw{THhBUkoY={Qm~rzrIEI`R{bDZ>0E`l7}M
> >> y-tg4%Q>Ao4
> >> zSk&iP*~{Ne{Plk_YRTKc`&+k&e|-B9ejd2%ZxMbk@Gk-
> >> GrMC#b3j8yGyWke#_XB@6
> >>
> zaOd12{GGsmr5E;(>#wivU&jyy{(l4RU*979U#IAH&ut0ZmcVTZ+?K#
> >> ?3EY;z|L+o5
> >>
> zKjq#@6KX0~Rr+cxC(h!hd#21NxMx}U)Pm_Vr}LjP8$b8D6|3sxS@Pu
> >> jXHC6-*7Qkt
> >> z%L}U3%Tp%d-
> {b;Jc>~4VoBg7R&d&#pf12n&ffs)Re^(O^1&RJ&<0C-
> >> +{ZP@H{{L3t
> >>
> zgIWHyCR+UMr~dmi(XPTrg!~(qXs;&vjb5VH63=yJ|JwVEA;p}LXcPS
> >> tCeL->EibNG
> >> z^TOTo6OT@$5?}4wvdWs87vzO2<f-ywRTY)1WH%YpX0I-
> >> *tgX9SE?T}~jqjW0-bE9h
> >>
> zShI3X)$?m6QsRbEYu2uqI!jJG%4Jo)nhLq5a{Y?h6;*5GN%i9=71XC
> >> vmNBcivaYhc
> >>
> zuCij5JieCyJ#CEt_tYC;d}XUD<+>`lLZ3Pa9?JLlDf<8T&)gtG@TKw
> >> 3hd!47&|`aw
> >>
> zKmLctpB1LQxp(9L{MF9F$6mg6?#FvX`8Pw?e)P8Usd}ZoGWE%(+NRf
> >> %j&}Xs;@@S?
> >>
> z{mxwrQy<;%P=PJqkf+scz&|l0fhW<QljyHA`%N+iw~6_!#l}GY{6zo
> >> 5gW)9l)xq-z
> >> z!@d3d*O5R%{srH#FB1m!pFH}fcdvdHd30OT-%pE8`{3-
> >> {6V}!9ufH|t?e9)pc;qKf
> >>
> znX0_Htg3#Nytr}=n?v<FSeIP4Vs&NJy1IUCH>Q+SmRGJ=Ux`_@Ypd4
> >> OLi=wzZAnel
> >>
> znq_kNa^IRYm8)j;TUNsU3{X$3sjOeCTbS&tr~ts)Z<tsF<Cp*D=0KK
> >> J)(tW{`B~qJ
> >> zRh1R;1jAe>!k*n#Rdp*skEdo`Eeu+ov!Z78^S+u&9-
> >> 2Ry?HgRq!LoHVmGX);@>*_I
> >>
> z`<7M8tEzkzGPtN%#p|n{mEH5F$P>m_0II$Kz+nFREFO6_0r=iQ@Twr
> >> sKMT;H#iSMB
> >> z4D#-
> >>
> ov*d|cveWqCUS3#JRSsdvi|c$f;3hF*@^WMS)XAV?_Wa3m?YgyVt7__
> >> MWtXd_
> >>
> zeEI#;?x|X{>V<pdg?dnuYgvMbJ{9t_t9;AkBG1y&c?*i>KT$lp)a5E
> >> EdU)!T(vsP8
> >>
> z7xM<B((ICw$4h3(vP=se_slDrjaypcDp@dZ!Q5Fg&08?%aUPWE$=N0
> >> D#}{MRG=g8v
> >>
> zG46hoXwM|tKPK8MiI&J*l4$XTBLDFHg85StH+T)K|IAk4r?1Zwjah^
> >> IFMrsa_$lVi
> >> zU(%+oUhP|33VkiDsa%GjQChydvV7%)i3zQ{S4PaLs*%Uzd-
> >> T)=RdsUZnyPinmdmRv
> >> zS63mHL07OG#=}czrOHpbW<g6=)ywii<Bo4@S8S-
> >> {?hUy2)z#JTJ)+V=*MfOP=#Uo{
> >> zAy1f8PxwbP>F5X-
> >> )4dme>~*uBE|dWSf{3p%_@~@uwETZ3zJS9Y#ptpd*neZjfBKF;
> >>
> pGUp%uPONWW+j(aqe(9t5Z<6tBrVGl%uRfd8%+}<~gxlZ${{V7n<9`4
> >> E
> >>
> >> literal 0
> >> HcmV?d00001
> >>
> >> diff --git
> >> a/Platform/RaspberryPi/RPi3/TrustedFirmware/fip.bin
> >> b/Platform/RaspberryPi/RPi3/TrustedFirmware/fip.bin
> >> new file mode 100644
> >> index
> >>
> 0000000000000000000000000000000000000000..eff727ca78dc0
> >> 7cbfe56f1b6717e93b91702c16a
> >> GIT binary patch
> >> literal 41714
> >>
> zcmeI54SZGAmFV|5_vV8nK)!$&QgUv<7H>a9J`=R&B;ix3ViGO2eUlr
> >> KC=lc$0g8a;
> >>
> z2C!0Nr(8^j4t6Ftpp|>;`#r`&$8_3qK|5`Sb_Nr}Ogo+N0=Blrb|8r
> >> 6qLBAr=iHNo
> >>
> zpw@O?f6SXnejN5W`|Q2e+H0@9*4q2*y{@Ke!yE6Jo~h!0Rk7DoKUHw
> >> +r=Fhk!e2H2
> >>
> zpg3hmJpWvYQ^HQ?znuKQqRU^M_vBY@SbXfe_o@d=?feIQSC$+4)U$V
> >> Jj{W?GONB4E
> >> zwD6lQJ^Yr-74{cv=_-=b{YtT`yKj!GyF}aCsnQF(mD0j0-
> >> Ol%2*3wHJPE7YGb*v##
> >>
> zwVF!pR4O?DsXINs?11ENCf}#j0k8zBNy)SF*ONbnE9%M)pLC50pK^^
> >> 2pLUH4e@<7e
> >> zE4bd|3i1BZ=EI>&E)_6<sjVsLP~-gNo-
> >> M&A<yn2lj1^jCj_fxr+#>>-?(dwIsItMc
> >>
> za}w_*ok+ceasEzC`8$i1>x`+X$^y3v%u7#r^6&kX&%dHnJ+xIuU79!
> >> IsycBJ9=zGt
> >>
> zH%=*kraU_|oayV^9Z|irbfE#b9^fl?!IQdD*_7?PwE4(>DKE4o2(9G
> >> (!lkCmb0TGh
> >>
> zM$H@%*rxpDN0lB(0*=cZQB=lrv0HUabgLql?k|V7821mpV5k5zm)H8
> >> Mp7*#_#$lz^
> >>
> zm+@|nQXL`aos{#;liPtaCt1Z#x!hrSUlY{>&6oQs6?g{IE;OXXX?iT
> >> trYTkE2mUEn
> >>
> zDt(}bOQ}0?lG#z?{!nI<PpxeS2VzBE>Vc9;S}Z}@2_03Ms<&`Zw}kf
> >> vYD8ck_pc#8
> >>
> zBS_O|*F<HvtBQ6(v(+xr2X%O&wmkb}wWeBp%YDyJ2Db54)nU+9m7rp
> >> VpLB$Zf%o8o
> >>
> zG@dt_9r<o`Qv_OC;QtK?f`3H)DOYm%$fdr@D7YQI`@t=3R&LsrZpLV
> >> {)jpdK-?QZC
> >> ze5#6_N7kh;R1kSdGh@}@(h~ih#}ia*Q=(nxe5x6{wE3vjpO-
> >> d&CxmQ-MGntbXrW5#
> >> zR&Z_IIwDZLH6?Hpvg%W6`ZVMv2Oc#~Es5>jrUJh5lGvv-
> >> #zkM>j9``-+qX{z+Fwus
> >>
> z9T|O$eCY5Zi!<7%nH>hS`xhN*C`J|qPBZNd&Z6x~tv#RhM6T4|PMxS
> >> L%X_|}By?%>
> >>
> zi~Y1YbjcV#51rCBZAytHZ)$N#?80aDkc{iSr&ZtrV|%jD<We(Q6J>m
> >> Wca$01s+%3~
> >>
> zyd{`##_s05)1HyENAga(vcmhIUB>BW<FqT<)l9wMcrzB%=_{pD{krO
> >> q@}HrMPF-n>
> >> zL-U2tmiE&<4;qi2ozt-
> >> tzWFqJoXsci7r~SObnGl!R1$M5b#}X73%pvX#pd`@0!>Pt
> >> zdrHOzFegEGO?q4Ii)Y;(uFHKh%te~j*VohMc7Ok!-
> >> QV<=^i|{D5dq=DI&i&J;|lp`
> >> zvp+!{>U}qU39npQU^;mIO~EU-nh~66#-!hbUn6N-
> >> R97>`LEl@YT3|zg3ds9?6Scre
> >>
> z_@gKIJ2NRme|UrR?@3oqI4b$n&qH7NG&TJsy3WZPN1mb$g0E?miV3U
> >> {)TjN~P4M%Z
> >>
> z$mHATBXp(J_rk}wYRcf{_bnMHp?xCr#f!C=+!s%=Qx81Ul^Ls2+8O$
> >> @5*h2)XPSn-
> >>
> za;ZQTGB0%u`a;H$a;v)xc&cdUdykuxz(erGuha|;9(W8bP)+|29y4a
> >> VzT&+KGR6mu
> >>
> zMF%!|Z0ELUN<jMmk>^W0u7_6!_59E4j0ZF3dq;%~+T}wJNFDTt)wk$
> >> MOE*cIb#$Kt
> >> zkGfX-
> >>
> tntsd9*k3TxaPLoj6Si)2DrQ2@E+KX4!N}XyZv(W26B)E4txB#!ZlmX
> >> &={q+
> >> zDCKJTTln@eZC;-
> >> e*B6XQTfSe2kIV0dULB+}hQg|j!_t)25=D3K`@Qh4)L#x?#}DoY
> >> z<-
> >>
> V#PWGt2XQpJvR&e>Sqdm0;;uiR%M$OASdP@JyLmGt%X%Z4QjZ_MeaS~
> >> 9U$i7dP^
> >> zAPWMkq<2n-
> >>
> ^jC4RT8nQYFfxRHCB5zrkr!#Ri@p<kBJJ|2{1YOBrFmTFS(9feFJ(3I
> >>
> zJ%%YVd(aq^FZ#9)93r1(;JhDtMDO;cskPD<Z;e;6AG%fLFVSW4ei`j
> >> cpnW4Atm}Q%
> >>
> zmEip~@Sdh^hiO|iZFBSPdSpXqJW;N^hVpk)@6f5#!0y+#biGC!4(j7
> >> ten4B-ZJgBm
> >>
> z3*=C2gn~ZNo2T$mT*v`>jP?|tz@~fs$o@B1%<2^xZ~<5Rn5VH%QSiT
> >> oJ`^22Sl<ax
> >>
> zYUD~bW6*q1_+sj|yjuL>T`4l_@W^@RCV#tJ*fYk<LI0q7mo|SdB<&G
> >> CS-hm2CkNbd
> >>
> z8&_@d)uvZye+c?yj0%kdwr#LnX<>Ae<;Q9GaZ7c^m(pTB?1a=a7&lV
> >> SM|*AEa5!Yb
> >>
> zM=2{bz~8g;w@V#$cHT}qo%>ZgowLJE%UVswtLP<lw)Ao6g|AD%Y3Ux
> >> ?@~Wn?rCkC~
> >> z`rOi?m!O;eXv<V<6~0^BShZFo4J!Q6Tg+X)2`aW47{JV~C-
> >> qHLmj1Hsq;11jUFsXR
> >>
> zhwD3BB408d92{cLFJ!6M1#tNHmc%NBPxP^Y9LTfSP4Q9hjpx(;8Dis
> >> tR)1%CFJPO8
> >> z+T{0yA1;aAG8jJ34*b#~@OQi?`~m(5?f!z1fxo!iw_EI-
> >> ?^Igg0{8x}mxwIwEL9_|
> >> zv7ZYp-
> >>
> (Sb`%#rZ6#O4A0nT2h!eH`U=c#`GvcV^Q^tp$mJtSwnj+B#4R%h>blS
> >> uJld
> >> zF2-
> >>
> y(@r%ZU4aP(eo;0s$?7g5Xd<rvmgwz=WG9Cu}mG6NUo54K5!iB76@!V
> >> KCIv_Io
> >> z2>MJ?t4vS@nt2|@^$gc&E|G&DyHu<ABT4jOA{S$zQ^vT9OZ-
> >> be*XJms5`&#4a}`@w
> >>
> z2lRS2awh$~1)hk0#|9h}8OLsP_*ME$csgSN@1|4Ehkx@$@FE*t+KAm
> >> &UIo2s+2}wj
> >>
> z@>WefgL*zKd6tx=T~^uX;Ifm_19y@Sue^<<Qf@x*uY$QhJs|Ur#uPL
> >> 5ucUWV#?nL3
> >>
> zsL&hYtClErC<}YINa`bZ*4VWC!58*R8N03D9yETmu=Jha+KYeEjw}l
> >> ue*xXwZ1`S3
> >>
> zzM#mn_&n_&L9US>k^cxjj`$+&Wm@2$<9R{G#NLmZv85WiXsp>$;qqr
> >> zDRt&o;;)Ji
> >> zRAc)<TQgP1OHLi~ySWz}+ep7DvXTj}q2Y)4&Z0l3!WZ>+-wgV`-
> >> ^aPM`S0Vl^jrPy
> >>
> zX>Umk6^LB>OFH&FkraCR$>h*8cd8iruc%n*^~o+(DLj+89KN&oU}3*
> >> *7WwH97dEyv
> >>
> zQ3c+Cx4~_C;BXbbs>>Y;Zqow6kE&QS(VrRoEO|+DLct`RYc7{7)V>X
> >> 0o_adIf<4av
> >> z!J@0lU~UX7;kiOq2B-
> >> Ox)Y=d{$^W5RTaxH6S38??ML(GuwvtOFAIY_3+{_Fpv9lX}
> >>
> zy>{PyFQl7aEiX{P24{R!(B8(SBLk;pTm&C4Z|~UGppqZ!G+uqC=aa~
> >> }4}K<*%Dh>|
> >>
> zj^l@Upy`w@`t&;%|7<xBd!{kpQ(^Igd&P!A&s(kp=Ke`xTj#o&M<j;
> >> n*H+y%=9uU{
> >> z8RuodyO+FEdNz64<YkA;-
> >> 2QTGY3orvi@YrIvcfLlEhbMXbzDU=15&477g&Dli~BzV
> >>
> zFC3m358AvFnu3ho;<U=1cJzC(`<@;@&n4FVk{%!TC*f&v+UI&q?whT
> >> 9Ur#itZIAFy
> >> zF0&MykXG7-
> >>
> kGHm(_p)Y@2(Enm75n*?Zs`Y=ervZ%F71*!QdUcgcB<rPr=k27EC-I=
> >> zCx=7Z@h85ZB0qB{+xGVF(<4874SKh$#M`6ruv#V0(t=+o-
> >>> x+8_ATZUKVfVg2CmS!
> >> z-7n>qKWELKzq6)GOFw|Va+9ZpqiyJ`<Y153zi7G&ox-
> >> 2BaoT+rd{je>_II||sKDNF
> >> z%nkCz-
> >>
> $efyiGh97R7VuvI=WT(=e)bmvZMCeiO^!Tk$OJp5nc#g1;8+us1BKD7
> >> ~C(V
> >>
> ze|4UP7J06X+hTkt%g2cO6}JB4J^k%<qnmVm4wqs1+h+k4I0!y#9LML
> >> -KeA+Sz-Gz#
> >> zd;=N$iqMs(8Y0kQ%M-F|>9V8ykAvH}xB2nCP!s-
> >> NsoL<IW1||8fttj&J=4<Xbg3m~
> >>
> zN3nXSr!hM#yj0i2=f}0}kv3Q4Wrf>;zf|A!T(R2JQ<46}9_jx^o~I|
> >> P26?yD^mjH=
> >>
> z=V9nc;T`k0a&*ZG;njoWHR|{tDQc}RapQB6r%L>tKJu=l?|EyCz1^4
> >> )dYiV%Sj&TN
> >> z;@_-
> >>
> ?53zc82$*MPs4*=UMa~n|OET7E494)sf;X#}jK!xmtB!@pdmjF;QvO}
> >> v*^)Q@
> >>
> zYi;=0#?SXKS9q*I>Bl}d>F0Z73};hjCOnwlls&%nuT{p0f|vJ1fE%2
> >> pVn&k62sWY1
> >>
> zHk%!7E>*85s>+%t%+M1}4|RQ7jcvI=xmx9JsbW10*?uXhzOmPD+<h_
> >> XR+;;BRaxy~
> >>
> zJ~>*g^(fad4|5)omwfnN&AS|UB=;%_oi8?Gmeu!<p>NMka#d}LQpSg
> >> EQj=cZ<JZ+e
> >>
> z8GlV`%o)=^=OSwll~LxuH;^Z7s2*>2oOWI3jk<EfkHTwKKYD{Vo3XD
> >> !|0(9k`D)ym
> >>
> zU&Z<=O=z4zo%uJK9VW0(;<LZDW!)1=D(M>~H>wW$qcZ9?pOgAeHwnx
> >> nbliCKQEu36
> >>
> z`pci0reeE+FS7T{G;FEb+8L#c_;gMBm@~e2SW7~8$rz2|+lWni?eTT
> >> Hev5t|th-|M
> >>
> zb3$)7&SmcXL(2wSkIkK%p$<;Q=PAHP&;PjD;~AwYC(`dtA2WN7j8v6
> >> }Nt;RCjN>Zi
> >>
> zUT$}=b58o4i*9I;v^`B#4%X3QwS*RtjT7|ILFStI+SoJLt(V02TDr6
> >> H;{H@ssRO@F
> >> z*Uv1FdvL$P{jX9~WonMu;YNOS=&Bzv>B-
> >> vWKkKbcQHNfmO)FLMu~*4|(WMUlI>!wC
> >> z1O4Bm63^V0pkCTqaNEV-
> >> KH8T1C2UEXo^ocXG4EnBef1+X;#jekcBVO*c0jvN&AZr4
> >> zz6pPtRLYs{YD9~F*Sw1&L%;k;TW-
> >> F_+;Z2#i?7aV%Y8+;>wkpYy@nrmO85v3HM`8v
> >> zHriA}`8FNd+hJamG1a(N1!9zO-
> >> U}`%W4%wWyjUGC(@U8$+EArZ&(s#$bxVOS>mzT;
> >> zxTAkdm2HcB!0cu|V6U}gS?e-
> >> C;yG9#{8DEY0`pr1=+qAjFV&gl$k4$Lt5^nYQ)0W+
> >> z*g!jTv^1VQZhxle$!f-&=nswgq*JC}KH`4v%gix`=7|n-
> ^q8Z+#5a-
> >> kI$tJ!8*??=
> >> zerAV-7b}p<i^8+GKD6r&_^=|!+3-
> >> R9Sh2%J*n#TVW(PW>({uKru6)*fg0ydGF1%W1
> >>
> z^eV&VQH|H^fcDNN)`}mXAD4n#>Xc5=TAXtEZu49_^JWh=PyEqV=<(x
> >> |8purz@I+VF
> >>
> zf=k9rUAfsIK6eDaPIxag_$VVZh_BcD=Vr*DzZHFX7#;^%v)!I6bi&_
> >> f#|E}C$K1jE
> >>
> z?w_H5HkX0UwEWs~tw`Y8?SEmv@Z90yZ(I|?=;_u1Ykrf={DyB6$=Z{
> >> qR(0anyhBEI
> >>
> zql*Ft&oW2Uq`&gaT`F(mE+fZm5jc+jgg@1ZKh=ZJ)rrs5^AjnHZ{@+
> >> adYgNvTsrpX
> >>
> zG_d{IW}%P1dJ7zv;EhjJosj&5WPj(=>FOo_r0?%hY38o{$?6>Q{7Us
> >> T*0UojAm0uW
> >> z`uYw@`Cn2#%5xMr?pM{~-
> >> *Epb{?>Ntqi=Sf=DN)Da`58^9h|6c?ygz1xNEEQlktMs
> >> zftE7(sno>BjE7UZ75Z8Fdmnw)#`hX&-
> >> |wxr>5r_pA^BbLp)Xkq(ORZJv!thm<}|bG
> >>
> z5oq2A&BfT6i3!*h=!Vwch`x5?|A=2z%lxZN>1QUhrjws$_Q03Qgf#Q
> >> Hr+N1XGMAsN
> >>
> z3iDOMnIp6>AHA@Z_xW3z_sjhY<jqkYY>)fQUh<7~(k^r+&%%#6uW#A
> >> )Zguj(=NC8@
> >>
> zY~6w_d=vaWzMr_kFSNaQxzD0)D|vQVw^f!tv;6+1_#EH@>x*OXuiD>
> >> a{`98IN3g-P
> >> z{X+bk5c;^I^m93xrTB-
> >> eS#}66sdK*KaOjQE{!GTRSLz?4{upc~_0M`D^NaSTh+m_x
> >> zU@fAO``9UDMtm#r$xT&!0vm8sa*nwv`#@{%A;!`<=(5*|kL-
> >> 7FUv2`&r)@kAjtj`u
> >>
> zP#g*z?dXFe77lw}KNNmX9R3@hKC=IEll{GmZwUuIeCN`+N>}Dp6eJ(
> >> bEy+`vrCX9K
> >> zN=aR5d{a`_O?9OybdTy_9@U|z`!j2lo+5cQjCo02lFD~5<_|7-
> >> WaX#xZHRo~mx`ya
> >>
> zF@9w2ZytP#WTXFNEYY4QW9Bk89UMD7(dhvVU)s9&&EPvv{65Nkx{9^
> >> aH=0|;c1e2}
> >>
> zlZ@B3Cy|GOZ2HMPKC{ZNtrZ=(7h2FW9YgaC@`NT&w#{>mdeutJRLZp
> >> Sp*7Q@nfGGX
> >> z<h=*D#c{Y!TbL1A@ADr`?w0ukaL+P?&}sN6dvm(Q&X*cF-
> >> 7a*!i?r=#m-S87&AjGm
> >>
> z+K`|Hd$y~D@FTqs?dnrz&r|8!_qgNVX9d5TGF6NPkssHx+Cq`(>#_S
> >> !pRFovQVI12
> >>
> zZS<*x+XwTPexQ!avLBO{)fBpyO)RXTp4eC^m#DO3uR`l9j3Lo+Z;<a
> >> o2VKu~(lrtO
> >> zYb~^|Q!&<ym9oa!-
> >> etbRrOS*$`#Xj^EO0Ju{ySN}>|clbI%^Z+H^1R>dGE<n6|5zD
> >> zUCA%*@%i0PGM_%T3|#2a3|;i{=d_H-vg-
> >>> E;Rnk6OLPVH<`8y#Z5DE}Qs`oxBbl<S
> >>
> zSKXek#?*g_w(`xz+n9(yjUOQP6~F4PwnY2;V(^7qUs93jEh^Yl)Qf$
> >> Qe)H*LQpE<@
> >> zYq|FKmP?yE`qv}Gh6~N&_lv(j4gc%rO4IV|@sp3|+?W#(-
> >> +vtMK7%azS&N9~s_FTy
> >> zYAv_}o?KNqmUkMLyvvVhYyJ3i$>_)Yo!VL-
> >>> lr_!E%_0A@9R{h)RFSvrd|0@@m|Uu
> >> z(AGBR*lY3f{&&!w|1xkgROJq-`(tgb!Vmj9sT0-
> >> K2JtuZf2FNGIo5_(0=$#dDQ3R3
> >> zi1J5}l_&VlU0p0|MOj|)-
> >> +cut<C{mPp;y&fe8ft5cOL)x=Ccp&+JxR2Ng1oojqg*3
> >> zcLR0&9isETt$M$8(Up4)p}H%G-?|6BpQexS{k^hIBL4fPIBXv{-
> >> ;C44H#du(SLkn{
> >>
> zN8SnS@o{>Pflis9($@jgmDQq<cOPp&TY)eA{xz4DdLBHh2f@A=hrKB
> >> dyUKMn>{{9?
> >> zu(zXc9QZyx$ATXO{!`4ou-
> >> mOqF((pVRq&ihQFl3Ql5ZmHQ7Av}%JrJ)t*^OM>K)K9
> >> zl=spefiJwTj?=?fx~i?dLA>|D-
> >> }kH&=e_WUI`CfeIy4DAo@+pZgI{QozJ3RPQTQQq
> >> z@DuuV<3*PJj0wj4T{`-
> >> pYLZ&JkTE=t^|TrAR^ES%6xnN)`Qi=SM_qYdOFy80opCGQ
> >>
> zN(bg`KZvg>4*u@JnlAA3z%TOc+uL@pvxa8tMK%04%z<GJ40GVWF$es
> >> eKYpigw_Mkv
> >> zkp?#PS#ZmBE%2M*e;nL$T?_m^@UH~7T-O4>AN-
> >> 5JE!VZc9|Zr$z%AFcz#jpB8o1@U
> >> z7Wkv!fBo&g-
> >>
> Ev(E{EGcxKL)p4*8;x*{%650*R{aUciGOz!7bOd!0!Y9N^r|{E%5un
> >>
> zzX;rNT?_m{@P7>4a$O7j5%8yhTdr$?KMMZWFEakQt_A)LQ$I0fazow
> >> 9y6VQd8)nPX
> >> z$EVIJ{P_Jf(+X!4&6qLEp{aEJ@|Ek1*~U#XXHT0sd-
> >> {xz8F#GSU`(CDzncmvv}Vpn
> >> zouXHyFP7T*$A`TCaXkO|vMcLF<N0~<{O`=Q-
> >> #@?R%5sb6+0X0Z>9g_l$MJOWeEWTJ
> >> zJdMWl9pYBTpO-
> >> lK=^wLSIe5%CzM=VkhYn_&)*ma4{0%+7@#p(D|II(`E&kLamtOn3
> >> zr*-3}scVit>AiQO*;bcw&(_ARI}(nc{9?t=v*v&4ql;5+-
> >> *ju?;umbVg=_6}(d~9>
> >> z#`71%^IyNs!Ed3x>OZG^q|q+tly~ws4uRw39~e^pD!{`Te-
> >> aKj{9pDS{jy|8{)ywi
> >>
> zd*+?rbl<*v>t9aqnf|R;hn@$@E?qQrwsC!9ib}EW=2b6WxxS&!SiZ_
> >> wBgq5R_tzOK
> >> zS69~>%c@t^u3WzAeq-|W%WoK5ysp+*x7sda7av-{fw#JG-
> >> TMHXTV8%=`E0{5)E#$L
> >> zE-ahNt@?CH`5g=Im_OT43-
> >> 6eBr@S=OJ#))T@2udp#ov3^*>YPOPglj$jq!AAJXOjr
> >> z-=C)2-NU-C^Jm6ySU$7<oK%yitIIj#*-
> >> 5QpN<Q|+|4ciLC(219R(7uSzxAIvaQpl3
> >> zQXY7qdQDYzZEaOU-
> >> Tli~ud1q9R##I$`3B=YI<Btv6GmM_!|Dd(dcNhS+_8F{QMYRK
> >> z`ump|57a%dy5T|TC#oBE)!8Y=JtecJY`lKuM#ETa-
> >> ^p#`@=bM;y@~tkb?X}Beq#y;
> >> zMDAEvMuxGt481;OqvGH2-!KP;IWWwDVGay)V3-5L92n-
> >> ne|HYBf6MyQ^c=-LNB%xx
> >> z{cr!rjxIKav!8)KJO3w61-
> >> rl>{XhF{|5JZXeWBa&*arg?x<^<U|Bncc1LxdF-(Wm{
> >>
> z=zTw}@pS~*a4LTeTqoTTpZE9AQ;ys7BD;^6^&GwO*@iOkzdd^yfa|=
> >> `tc@#dJ{<`7
> >>
> zpcC+6g0;EGH<ClaR=@`iNmv0N?EJ;#tNCnxXQQObn83T89GD397+Dj
> >> nAQ6g1Y?FM$
> >> z+B|C=-
> >>
> rDJ5BPQ1|bCh+k@Hm?lB|yY+Po&Vwf0TTmwdu(U5OLPyv&%P=f7n#rH
> >> -b|(
> >>
> zxDE~yaWfzMtGI6Bz)K{ir&nLnrwESg1ji+Jdi#omba@`bb9AK24i*l
> >> y?S}Vg+jSqX
> >> zZ9-
> >>
> EDWewW88~95(y!``klyZp2WFrk}fKB=>6WJ)*q*T3cia(bPd}m~XK{c
> >> BfWJ7@*
> >> zOz^X5#kBaO2N2C{>)z)IXl(dmhI&q=+lN{PA4rx>zp~-
> >> Cl6tMW9(Z|#YHj2Y)!jTF
> >> zTIvc+V?&&e%^msa_5tZ?HVg{y^i+Rm&S?AK8Jifb!_)S=G1j{b-
> >> ZgR{{wy0PEIQV3
> >>
> zu#AIdkJG+y&{k_B1)J_KZFUYf9}YFkCOi68HZvOp_DGs!9RfIzIK@s
> >> A3hmTA*-l;4
> >> z?Nt95n}hwgzZ6Lbc6LC&bMSLfiX2q>ZU}km-w@`fkJ(%}L-
> >> JnWKA+7Q$gTH(v*}4T
> >> zc}YM83A7-aUZl)lQ6|a;_8_zdq2I}8qjRfl-
> >> j<DDZF*LH37a`}J;(;YpvZ6M9NtSC
> >>
> zo%R*bp3<mBzxX?Amo0t%MK<=d(U&#p$TWSZZedd+@Q?v(lOMRI>uIb
> >> JY;ji<u%T2A
> >> zm`Oj&W?b1ID)(|ZfkbA)S9vGFRs0-
> >> ESEruokqt1K`HhCH9K6(d*4SWZvYAj@mz$|L
> >>
> zWTkj#DCITDcQ&0m@MHtA1{{rgk{1ly<)v>5fI%Jj!(k!HId#UsE4Ag
> >> JE~OSQ4(-j5
> >>
> z4oz*)%vkO}6tBZ4V8noNKpDF9w`>}>Hf3_pm{wM>k&|uab0_nIJ*SX
> >> U^u}Y{cb?3T
> >> z^i;9o_aySJ-
> >>
> ?E@fV?$^a{aBD(wrK%*9jR>Qi}SIsj7`nSk$Xw|gO>;_X@{a6va!4U
> >> z-
> >>
> `dLCwQo1DiMYO*jcO(vE7_E49dPonIsXP^!(<blY^2Vg!vPlZPCn6`n
> >> @WF`6%a(=
> >> z^3&9H)obJ*kugZX6AmX>8-
> >> I>K$H}bbTsb@_aw&Z_lqTyrE%LJg8V5GzJDUMzLzC!L
> >> z3AXW1z@`n}2nQ#(ap;lFieA|a-rPB@#aQ6$eVzM=E}QsW-
> >> d}KUm<F5W&Dbxw4_f)U
> >>
> z*V)MA$fxvSKVQ<#j(?_X6danN(5+gFPTv^rl3q?H?)I^n7oC(LGReV
> >> ~_iUHIJnirr
> >> znARrxuc@^k2G+0P=`VoqV-
> >> vIR`g)a+%7*NEHi3HO{b~Ba$0lEC*Bs^Mox7gHXx@pE
> >> z&*4~Um+-)6*t|w&QjvjrIWWSe-F}+-
> >> 4}QlFu=}YeaNy4jABRo5c+NM~S~kjhrC&!t
> >> zm+!-7$4}z$<-
> >>
> mY!W|L>B7eyEJAp;Tm*&v_I;=6rg*?f#FR8wF2dGJOr;Q{Tm<&F0I
> >>
> zE#;++LFkr4ZGPx}Dq^(wkQ3e2JFAp~e!s+q$^j|KYg5{ph%xu#MChv
> >> F-Tg{G_NYo~
> >> zIjoY-?0^?Rc(E5aPt(VJY-
> >> l&B^FwIk5aF?ia<y!w{I|po!Ba>6uGIf74x6i34V$bl
> >>
> z(3i5=T4b&hn9|;$99U<=c%we%_Qq9t6>^};r>oRQg!UBG;U8soY>np
> >> $Z~ddt3GiUx
> >> z0K22#?Zbz12+6WJY;b*(cFF-
> >> H@P_}wh9QS_!~ctW(a9WQ>8R&k<ZvSNiwtHTpH6U#
> >>
> ztnlacY&Hgu3roKQ>5~(qB0oFCwPD5dUJjzY$3gLdaV0b;WRgRJR{QS
> >> )4u?%RG?o=^
> >>
> z<X#~kazC4UHUQVJfY<m7)_Z9idc52NEd`|2y2jxuTi1se6Y$#JC^*Q
> >> z8KUQc?zj#b
> >>
> zIJl_X94^h9BZo`RiSDq<McsjClT_=GG;B|*_yy`XhsxnAn>X1|DE+g
> >> K_hN@<VP_=Y
> >> z#(#9beMs|rArJVt`VYiU<GGQ8_tK`XSaq|IG0Fs0Ai(oX;Qkc-
> >> %~!crQ}i!E7Dx{&
> >> zRea)Qc<|TI;>dMJlFBZjOaXL?jF`z<i|ZC_0%-
> >> }CLe4$tKp!>&o$VE!CkI5?#99e&
> >>
> zI_25YE!ZWsMSD_Ud4Ods^YzNRlH<2_8%yl_E61<q{ZR_Cyri+$p+(B
> >> ~m$76^_sT)g
> >> z!<5TjGOgF)i(PIYfRD|OOlx!a4ES)UAS-
> >> Z)1IKcB^6<mz91($HU*s_2J<xVy>lFAl
> >>
> zHVkhLymd!nKu^cE(Z`1_&+WR7{yz(E4(ml{MzA5eFn@Dbwkzu!Q4XH
> >> ?6U`#6zOk?v
> >> zy>v1O`Q2HvNe-kio{Gd@`ym^#<q(t~zk+cTQ<^$-
> >> 9ePA5EBL|mX8f=yGJXU7lTN<W
> >>
> z(}72Rky5!8rP(Ue!&PeAVz1~w8T%#Z3DM6Sl&JXW3QwVIPA+0IYf-
> >> +cIKjOfwlZjo
> >>
> zdOb0a3G9zR|2*W(u?g1ZRu0%Z!GKOBX;V4eQg6x_D3*JzUO~I24wTD
> >> %HM+^5U-5f-
> >>
> z?1OFxI%)HnGRiA_SH`XN{A*~7_I<e%)IIW^v9k*q<FKKB*HP@h_&<v
> >> K2={XE!tS%f
> >>
> zA@xq1by)aD<Zvtp?(?zr9MH}k&}ZKZ<xd{pAU54TP@EX92JSN)uBUA
> >> FuaHqA+E%Xo
> >>
> z2O9DTG$!p($tpwc(Pfot(7O_zO@b;(J0jj4osmELPEUk`9+5+jbgGS
> >> qdm<bF@ujtO
> >>
> zs!RKOA{_ScrS9qsX6)^eL!QEeSCk4l?Ep6I7&tsH?XlZ5poc_O?L+h
> >> `Jd-i5&GUB>
> >> z-
> >>
> 6r!M`a@;h+PxJWcrw_WNq@12c`SXrrDtm*<<!`z;N!smn5k9j;T|L1p
> >> PRKY5BoFL
> >>
> zdmVfNw^!<xagcc%`muxq>=Ix{Xe+_5Eaq?u<Bsu|GZlH_AW2D==d1T
> >> yWnHSd)0O-6
> >> z9x3ZeYVO>Z6YSy8Zn%9ffjBrM(*AW7+W<^0&EMJH!(qp*5-
> >> d*l`jOY>rSt*1aPQWP
> >> zkR0&WImG4!F-
> >>
> l7t6o|#L$JjaA>`^K+5t{L>`vVPNCkY^O#fIvzqO789FS=@Q*=Glr
> >>
> zwe5@dKPaOj?tlk9(1kBO4WVl+$R+@nI?!609T4Bm%G2X{ylc|4&n!h
> >> Ys=r|NDodV=
> >>
> zPsrgC$=?gFhUQ<XTkM1J5}@L6iRwn~0y3`~ETfiu#_9V3<p>P7R^tG
> >> h=4bw*nKM<8
> >>
> z13D@xQzbT+2XnsOK%aY6dR})nI);yc1j;My&QIIeBhL{TbCYlDQvT{
> >> L<zDif%E;@E
> >> zHhqD)a$dI&+SSRtZfS!rn#W;9Ik1@5-
> >> A>w0syyU<?dERJEw^`hq&$~#DzEzu?1&un
> >> ziZI3`y<nwTUThjRc)-Sd-
> >> {SXxJr`RoKEzLx?LZ|a^ogwuo>oP{*Hn?f`Y7{iQ*@4d
> >>
> zek_8XvxA0Ydu7grFt<`RFp4tBzFkhuk7*oGl6(Vwm_++!9?LxIpwl;
> >> U*dubOZ@O)l
> >>
> zv%OQO`vi8|#C|BBtQGh>$J77v>;aFKqdMfU)8O|v%6p+p@DWf7y>Za
> >> N`DNyk((VCY
> >>
> z=Ee9%|ADqMfDW|kvn)IECU#l;896lE$)>;7PNSuDsvIH_zal%l9-
> >> C1ahdGYap|K~P
> >>
> zmnnJ7GlB$D6nps<%A42}hi^e>)09o4*dyVK(04a&b5VB;?UQF#r}|<
> >> 4YaI65^o_ul
> >> zLrVrSF6G`N&#7}>-
> >> p6_NkJRbs2|RajiGKtQ1fP>Yb6MVz$OTF%TkcO&-{G-5zcL8k
> >> zw=Ej7!yh7*z&#Qy#<4X{pozggX%_a&!7sW|c>EQ3taGpp-
> >> !gnCGppqgd^KtRb-;X#
> >> zKqaDUE`d{0;e}NnS%cn#8bNNPUmdx@-
> >> tRobxSvUSg7mOH)*9dKL&m*~7wOx^-)-rN
> >>
> zG7pV14>go}%)eq<uK~{o+VH~uWNS<e1j&*4ntkw$;HUT$1VHu5p)HJ
> >> Dcr<j1--Nt~
> >> zKk2PS{?(Df?is+05<oB>xWaoLU+iz)YP!gdL-
> >> TBCzSor<z_zybQva}?`>wQ$jA!LB
> >> z-<Pql#vThxhVq5+C47mxa=ao-
> >> 4$mEa30_;qt_%Ma`bx_E4!lmeF*2sorBCc~1S+)J
> >>
> za|dN+u*PyX{q`2RH>eMcEvM}B@Suq`0jCc0y4H3A{RltmXtz~|ARs~
> >> V968@bzEge%
> >>
> z<sJSzhj9ji``C8Fq0<gPqlGo#Irv+^Uuo$#bZm5dcLlWi66ePl8wZ&
> >> e#G)2ovcvc+
> >> z$dvL{^Ug!Q#V2@LLffa&7mc?4*x5?TIz-3&*$R;v33m3-<-
> >> T!8+YaM9=_}f?EBJ2*
> >>
> zO3^>1tZPXyJIYyWKqcgR$oEVUy!lu7xuQ28!gmwh+e8pEKVur)_4H?
> >> @tV!92BD1`g
> >>
> zC}WL#{7qBVnW(2TW*zx;g0=|_B`Pss^4?U5MFs&@jbyGgRTObu>0=8
> >> {<U4H1mftKg
> >>
> zlq$Mc@NC)AWz#&1K2t5wa@=F!|1rlGeEGyuONP!;%E@|W*%Y&=<~E~
> >> HiLXi-Iou|G
> >> z@ebP16wjA6hQW5W3_5GntUxWWw*%XE+-
> >> Q+CHAVe8;1silaGLt&#);1hJ$~q@!3UN1
> >>
> z0{@D(*lPmbk3zfju|vBjUA1^9KaHRw9$+j5S1Gt;9i(`QDzeKZ28ua
> >> +Dm=(X?^>x}
> >> z6-
> >>
> g>{6Vau@+h)z*xhYxvo`D0N*l&EI`25$>4a(9DpP_9<uEc;G{7i%<89
> >> (jlA6e&+
> >> z_P)(LdA3V$@uYJ>-
> >> &g79^VrrtJ*R#f{=f^&iT!Ur+$A*c%SsF_b(=+{^+ur|+Vh}Y
> >> zTh{)(jNz?G_*@I7x5!~Pk4tO0j}4*{G-
> >> qGdypWH6uNEIDMP>Bq1PA8cgbsyl99>ae
> >> zn6sd;MZf*#!dIAAxR9gfRI}sX;p-
> >> 6&)k)j6I1iLx*4+J_hoFBpV~wb4mV5+t)#C6|
> >> z?1l7;;BkRR`s;<;stdu_;-N2H@Y?COp<~?+m|`Ei!!IZj-
> >> !@9WV;_r5;1)9%YUWvS
> >>
> zFMV#rQz?5yeAjq6%1j?x#tEEa+j47tl=jcEf(K3qj&|JBBK^0XJ~^b
> >> Tzy{J21u8I&
> >>
> zwzTQv>L=5d#)r3b!QYH70^9j!n?=D<s^vr2DFU%|5a{7ugLyc3_qsF
> >> -m-r3hSIK(H
> >>
> zI&idtOV*z)yx^;PJpcJyu)!6`DP#VwAobLOX)TK2&cRI8q6!I82HsD
> >> Aw;!jqCgJ!o
> >>
> zw$J*E^gnYdc$BFQ44zjF%$K1hY|FuXD|o2{_7=OQvGy)=<ruPgl6mY
> >> n<}4B*t5@H+
> >> zYn=GB>9=&tfm5-|qB~Vz-
> >> *m+~*+lZB|8;f$t}4DwY(Q43bybvI`<brlM0C#Bwmn*^
> >> zzucEdAfBZvu%0y?@*mWgPl)||aFmLT(-
> >> zM>bSY_8zDu3+Y{YglCsfD{ddoWk_>yn3
> >>
> z1|HG<1Tq+3q0RP}AJR3inw0HD4q0DP%qIry_|SRpV4tJ_`8`~r9u(a
> >> ta_;C<WU11?
> >>
> z4yb5Spcp<^LR%waSIT7NF?VBpHWBElajdLMW_g#>U+w#pW#_(uO?6;
> >> Np7?y&CvP<{
> >>
> z2`af;^z^4JyPM_hA{AHyV*@a3ooKJEl`uX%_&UwlEDtu0=YwJ|Xq#n
> >> 6ME)ZLFu%0<
> >> zZ~G6KOMi-NS@Tc&P6BzFto5CupTz$VA6VA&B8(N=SI-
> >> KU#%U5cvBsk%OFxSH!~+5K
> >>
> z4iX5jU%%lGiyXI&%H1dd9tAc&{BD&X>uUt2DP7z(9z4=^@h^`!{7fG
> >> aID<dWJiRp^
> >> ze#(3{0(~Nb8a7dA;5$U@DBq`ou9Bis_-&$lJmiU-319PhmU%-
> >> K^$2vw0dVV^pEo#B
> >>
> z3w(vPNZ*TWN>C^XvMl*!&=S1dH@#oqSOIwK;Cz=h+X1<pHB8~%c-
> >> rEFM-|W`YX&ke
> >> z6+A)ua|*De?LP1ax2ZrHWhH%u)DI3>)3m=exx7+-
> >> 4Kzvr+I?#WgQA_~PruVQu9<nw
> >>
> z;Q8>kWAKb1<^sRk;+a1)8T^{)S!_=;<LT$z3%qymb3|STubBz|L@xS
> >> eJib0IbgUE}
> >> zpclm!pLDg|>)AMAs<cf4-
> >> |QVH!945$jq<Go_~GBt9>#K}l6F!C`LpD)0DoQhVbUMs
> >>
> z?+Sj=Wdq+FY(FhnqXKt=)A2=|c1r$2@`aA}(bBK}T~fx_X$RDE%Gv#
> >> )vF@kB$Dl>#
> >>
> z)oN$eCQrZZnlE&C^;>NJ&*tyZ{f@8YJPSXBPLVNJ`W@(o1C|{@_9~m
> >> z*_r0J$IGL7
> >> zu%U*vn1Xdnx{#mDD!z*fABywV@V$*-
> >> A6xP(bo6mC>ro=hCB_lH)w)(hv)b+z_|&oN
> >>
> zk@L+gDOJss0LK#CnDwx7z7=>&jYzK0kZ951M?WU6h>lQ|r}*}B+LeF
> >> ~aEHqh&dzfC
> >>
> z|4;co<xXu{%vvJBv?ig4w)>I;+ZNOm;xD9c+cB}lhaOlB4`*0%u6s|
> >> y|LX_ci{B%<
> >>
> zcxd{U)R{aeU+PJj0`e~56Q|&RACkV2XTEEFl3+$onLP63UQ)OJ`Amz
> >> (MQZJS)(qWz
> >>
> zm){<_n#QyAn*_y@prA6RoCEA+(j}xaMg_+v?B+I}MK6AcR54E!JumO
> >> 3TY&|S?C;?j
> >> zIq5W5i<ENk8=0}cyE#0+2fZR~5x-
> >> yF5v&Xt1NuwkNc2~Q`1hrW0kLxuY(wU6MWo`N
> >> z{TBQudi!>NmNJ`NvjV@Qjs%^%h#h{7^!t%nEjiF3{VhQ}@?A-
> >> 1f~+S$wQOUd=(!zy
> >>
> z_c^R5*YmBv@>>&B=4oVxaeTmouNIlGrRxUj82CYZC#Z@M(^b*Jye(Z
> >> GO=~GA6#tX;
> >> zAcEOw_(vYv_@jr-C!Wqv4DHVvb;H-
> >> 6NeUUi#s6zj9n~(?g73xhihoyiz0oUcgE7`b
> >>
> zk#S4bL{Ajpy9&I$U#1*^ax_B~iO>2IbVjI*^(fXO_kLNvJ&g5wKBYZ
> >> *J-)*JtUGSl
> >>
> z*J5@&oj))1^<p!22tSAKFa)M>r{*N70CRy1nd9?qY}{M=b*bCXB{70
> >> 1$TySc$y-l5
> >> z58=N^&=Hx(h>qG@ql>>-
> >> o{SC*K52FkgrnZa_|fnQzq!KmyreR(Y3Eyu%y(q&T)=u@
> >> zDfYeqx=#`WtcbSBoc$DY^;68%nPWT_pOftL;J-
> >> <KuGb3#1q3g9k@Xqmr2G=8pLI*w
> >> z3-Vd|Q~VT-
> >>
> _J4`?o0Ru#l{xOHj%wzx1<aS1Vq5o;r;`W%*ioKE&ut~u8Ly@4LsPAH
> >>
> z%oSNnJXnA|E+7?svQ*{U@0ia?`BJr`e5umCR(WGEj2ye%q``UP>^yY
> >> X0In=MZ%&+!
> >>
> z1%uy>wBMP7^U|z5&mz`o!LLD+M~#{)?Gqg+vMOt}&V1VTu^roI`-
> >> ;D%e}pfxj^_u4
> >> zV$F=_g9;r#276<@!#*q8BYDo4du3=n-
> >> aGY@2G^s_cD;c$@@#af_$p%S#P9quus}H7
> >> z!X;}wtS63U93Vftx@7%N=z|6gew?(|3mHqrCp6v@h-
> >> )UnJ+g&92mfpFzLq*-C&UMG
> >> z!6Wg-
> >>
> d{PfRBkN8B>wwNT%>f$4FBJLm$yx{f5&WjTZs}9KGvVtl(NoqtXcD+W
> >> 5A*R^
> >>
> zL4r?;?~U)e$F@T@Yz@DLV3x=5jnC}Et~h)w1&6g(K);&65cnqWb!ij
> >> &#?f_>7jX@m
> >>
> zx5w@K8hljumZmNlYdTl;ib)&cOZjQ}_RCnR*;KQ!=9ZE!Y*xL;*p@5
> >> y&BMBZN9JRc
> >>
> zD=5sb&<xGHlzRD;QP{>>;4NKIyRlApx0K$ZD)#mz@f};MK<=m48oIY
> >> w5wwx9T*Z3N
> >>
> zQ_6gBJMal0RgZsJ$=p1nN%j^oeh+`rWzC(3`T<Vx`4VV9e5<Qlba&G
> >> xW25XXX#?h9
> >> zzeXkSJ@s*)^*uE@t}WN*fi1fPU$W-
> >> 8A_soxDK4P?ELS(rozlM!?}XQ^<y6Rez3ios
> >>
> zxiLOm<w<1DlW|LTv~PE3wC`|_!CIhluY1mr_46#|1ai;5H3yFMZTAD
> >> vg5OkG!n`S3
> >> z)iwZ^ptQ2@?cHb-
> >> x_&*VE$?1`<9pVZz&8TpU*a$#;5TL7rtCVhhv+0aP|KXqeTp`h
> >>
> zN}FG?X=BVhCf^ve%)I_~+B_bxpZx)~nGgTIfZ93u5@K)tx*bsa1$2R
> >> |OUSy<9}`gf
> >>
> zC}Y_kN4DM~$kzu8njJ~GB4{?_r~I&6{DOgR^`d{o=NB8JWPc$)`fwB
> >> ;+Vcw5-6d~&
> >> zTHw3nbz+OoA+J*ZU4w6z-
> >> tex$w|lAQV?J@zw$tLj_kR=fK+|7YG}+%D#7B|66X*&2
> >> z$KM}(`#yL*H25|?$5p|%KS$os;M<=j&uU*ZEg*G-
> >> $BwO#HGF7B|Fo6+Cj}dvF=v(c
> >> zjkfk6Y=kF1=y%43&>Ljj4F~2H9c}mLy9MSp#Fm-
> >> rT?2DF@7^siw?}LdI!@-*&7=ju
> >> zFqgywb929xzF;4-
> >> 9hjSEzCl>BUMGEoZg2u~J2=EH4i3z13SGX!s{(UBboH1C%b0n;
> >> zz}%*5I54-
> >>
> uCJhJX9uCYs9GLr$56ry<dpkHVxA?ljf)5y&`_<9EKQK3C`t4pkF!#~
> >> n
> >>
> zz}z1!F!#=MD=_y4=58&lzYx*2)xg%soXYn;fw{GG_HGb}R!g_fi-
> >>> Pw^b~cg-UoLX
> >> zJ=a<L-
> >>
> DMsi`R54Y%X)8XQ0BI0i>SADmq$JHoObrQZbN5ZA^yg1@KdB5Yf7ztD
> >> F-Z%
> >>
> zTK1d<EGbh>nUn8Yrt*q1|3;bfz+r)>m5oy2s4LSBz)kuqd>wiI4^oR
> >> (wdpyBRv$Qe
> >> zsP_-
> >>
> @4qPw8hs%^bhQBNMFUIr#k^Bt!BxU|7UIt%t+#eczd;vd{;RGMwz`YZ
> >> EoIb!`
> >> z+s{5m*~7=W59>t2!wZ6Ivx-
> >> e9zqR|{o9^v;Wt%$Z!+&_?33X0mo?zvx1v7hTx6r0h
> >> z?yo1RbeZ2?-
> >>
> fW%s*e&(X@?JUb3skzyPvz3Me(@+jZ~*WB4P3f;YxhL1Q(w*qxtW6`
> >> z0Podt>Fh<%XFW{?_@T0{U$mGp*-
> >> Ld;$$r)e;ql1OVfI*^Y`H6>nG?DTxK3v+4!M{w
> >>
> zxyv~>^eB7ML{3;EeRZ53`enW=^sA4!L%+E(A@usJ#L(}GlR{_bCx?3
> >> O96=E4l+c@1
> >> zsiEHc(?S<lj|{!@`B9<FlEUtuCKdYyG_bB0NN25g^p>iw^xV<m-
> >> *vds|7rP}!vD|;
> >>
> zXSG~X>AzV%zGC&l6}>;+VbhpSTW;dYq%Fr^%m{V*RcyX)ezQ&En~zp
> >> };w9P-Uv@Ev
> >> zjUD4&cxFGhosc#K>3<1E{{_+lYp$;c-Y*!vl-
> >> *2O7yLGlPv|xYP%q!eWM6GFw6g!U
> >>
> zMfz1_bvxz8QBHT8vCGUWO6dbr<)4uE1@smB5zdtQ{d=tax5=#iasI=
> >> Trt{sny4RrG
> >> zJie(!$Y*>V61=SCwnoyl-
> >> pj5OYp>><H&y!6Zz*ufk7gBiyDqnNx}t}BN|h_6jlJm+
> >>
> z<fz$Q*2`YP6wWWz%h@G=M7<>VHOd>GTij)&ncsBiVZ8yGv@_<;ZPpL
> >> y2#x)DMt@%U
> >> zVb%a-
> >>
> Z9#jdYR3_NKvdtN?Pw<zIQj3i?T}RF^b#2T@8Q9IF6MGFXM(rdG5R79
> >> pe?>c
> >>
> z^QDtD#<4K>=PQovcjhWmSJoZ&P;YP@_|U4*Pf9)foQmrwr;g~PCTQ{
> >> ?<0B@Up%G?I
> >>
> zx0h?QSrQseFzqQ^8Iwvwcae@zx!oxrD+{HR<aMW(=X9q{pA$+ma=Jg
> >> xHR_hRp-}|w
> >>
> z9=$K8JAKZ)&|>le$Eh=UerVzG@!c!9Miwpzja)}rpTJ)j8hsb=xiTi
> >> *7P?8wMsm7S
> >> zmYA`WuZ{0cow6wO(XzbmMO-
> >> 5bKNT8Dx{7PGc}HmUl)UaKi}Ng98cpJdgGOti|IGLi
> >>
> zzDJWx;FJKTlyO+bIGn>coXa?z$2gqNI9$LuT*x@Qjd6H8<8Tq<@Kd3
> >> 8n#@>UNly1W
> >>
> zpT8p{a0oz+UXiu4HuOAuD;X>2T2!oO8#?C)cZD(;`|0R`o478ZCkOw
> >> qLWFM$m&p5|
> >>
> zKdf+&@(F`}SRur7l(Dk?=W5N+A69slck;su&oGwTS?B%#;fEDoAh`Z
> >> Nx>Wi<j!`X9
> >>
> z*NE_B>~LwqZ7tfQqkGs_vWvYG=lC8`nSxx(T9BrSx>@_)RmxelNmI(
> >> Y9!Zbf`$gmX
> >>
> zx#^zo=PuMnct5;yWJQMOXs%_4wfqyejZgvkA(v&W>E#1M@&%6c;}49
> >> ZxgXV%ytnhC
> >> z53i|=dd{v?-
> >>
> k_zQDJA6`(768h4`2OWejuU${idtmpW^)u&{~F`Sdpw=Vys)w+v3k+
> >> zKmRBHpu}Gwqsi<&OXBMPaf#XJ^VuqfU6${w{XZ_j^I0RR6-
> >> l4ztmA#4ADRGG{|`+>
> >>
> zOa3%JGyx8Ll!HQ_XAllq18x8B@<S7mnFBvGVa^)(p@|6hgMMh@%gFP
> >> 8jUSpAHSj|d
> >> ztO;of-
> >>
> (l~B_zz7?i2u;UgzkYKnz;3SerRIA&lg)?rT+9k8sXsa<DY2pAEuD?X
> >> OaE?
> >>
> z5kDxAl{x%_5`2UE68&F2{DTtK{t}I|t;0VkAwT+O|8R)x=P&s$@PiT
> >> s_?z;*c=!h;
> >>
> z)bQUh2ZlNDUx)+eF3Q>WYxnokHOBup*BJj}*XV}^oE~3$joW|MHO7C
> >> _HO8NEjr+fE
> >> zj;s5MZwGg(bJ4QC%2%q?xd^GO-
> >> ~BrFr_&J*{+A@+J!|kDuIQr~p;LT6V2_b?9-IAi
> >>
> zfzP~!50xfoLsaFx|3O*S6WEg*jy9Rk>8#tA@XbN?^qgk>Kd2X<c=ZG
> >> JtAqb<eh>bl
> >>
> zLHK8X0Q@ih0r=bhg#2~J`Fo{K`}@BgN&ioa_dluh|MEW}eGY!~!29<
> >> 9Pv0Eq|DXNt
> >> z_xFG8AHaW+fAqln;_n!Q|Jxq`|C~PnzvoZL-
> >> }mZwC;yN9!H2@3Klq^3jW)=|PQb``
> >> zdN!Uq`9AxZwLrF^YN|l-g_6Hom!01mPi<gV|G(xv-XD+WzZg&R-
> >> lN>r5I<N>B8zzP
> >> z_qwv_OqsjrCZlovnl-B%)-
> >> @U>B@H#pW={Y3>QyTr{DiUC`uPl_v2LBQl;6pyHSSwk
> >> zeZNswxuk009c7E|o-
> >> ?<qq@=uT!L+GW<#Xp(7@stz5cIBe(X^Z5k^1LaG2WN2TE1?1
> >> z^~&X&Bq)Ew`c><eKTrqEh7HSW>g<UA3s-
> >> I6eeG2*YwH?o8kVnFCxPPEq^RnK2db)}
> >> zuc~oFjcQz1Yo#f7ud3U)rmkik;r*-cyHAik$gcw2x7ui2SG}%I-
> >> J+|65ve0@${sVe
> >>
> zxOj9%adGj7a)@U^I1}BSI5v5#{H3JvU&h$cDGnj)svGX7(Q8(JzOKP
> >> oS+}8XrEwob
> >>
> zG_G%4Q@5(tSiPpMp?V!r?Nihr_iF&4|9rX4|K@nw5>LMpPut=t?X!N
> >> -facBJxUQ~Y
> >>
> zRrN}vWGS6Rbo`pS<r~Ofy^1jR5*@#KoiTUOG!G&5jk=9Bb!&t~id8q
> >> RUiHcA*Bgxw
> >>
> zuBvTV{XpF(rSwWd<=cP8m8mTr9DVEmGvjx~LsCoLuP$e0Q}oKz;<*j
> >> LjKldrNlL?-
> >> z<<n*x3s=$hhV^S`_UiT0*Zf2PZT$po{jc^*19rPl-
> >> (~l&)5w2GwV&N?`~BJY`^q#s
> >>
> ze`7qIa(r}&)Hyr#%K8qR$<yq7GoCv6U;VJ1U;7a|ofJ=<_rvKh2ZlK
> >> ?%z<GJ40B+Z
> >> z1H&8`=D;uq{yT9%V?(HT)@*RK{+u5ia8iHR_KW-
> >> HD+lans@Z?f4taL+<EibnzsnB~
> >> F{9hQUX+r=2
> >>
> >> literal 0
> >> HcmV?d00001
> >>
> >> --
> >> 2.17.0.windows.1
> >>
> >> _______________________________________________
> >> edk2-devel mailing list
> >> edk2-devel@lists.01.org
> >> https://lists.01.org/mailman/listinfo/edk2-devel


^ permalink raw reply	[flat|nested] 34+ messages in thread

* Re: [PATCH v5 edk2-platforms 18/22] Platform/RaspberryPi/RPi3 *NON-OSI*: Add ATF binaries
  2019-02-07  2:35       ` Kinney, Michael D
@ 2019-02-07 11:26         ` Pete Batard
  2019-02-07 14:25           ` Ard Biesheuvel
  0 siblings, 1 reply; 34+ messages in thread
From: Pete Batard @ 2019-02-07 11:26 UTC (permalink / raw)
  To: Kinney, Michael D, edk2-devel@lists.01.org,
	leif.lindholm@linaro.org

On 2019.02.07 02:35, Kinney, Michael D wrote:
> Hi Pete,
> 
> When I saw it as a single patch series, I did assume all the
> patches were for the edk2-platforms repo.  And it looked like
> non-OSI binaries were going into the edk2-platforms repo.
> 
> Patch #0 did not make this clear either that multiple repos
> were targeted.
> 
> I have not seen a patch series with content for multiple repos.

Well, new ways of doing things have to be introduced sometimes and, to 
make things a lot more convenient for people who submit work (and 
others), I would pressure the edk2 mailing list to accept this kind of 
multiple edk2-platforms + edk2-non-osi patchset submission *for new 
platforms*, where content that is aimed at non-osi is simply tagged 
*NON-OSI* rather than split into 2 separate patchsets. As a global 
timesaver (since it also makes review of a newly introduced platform 
easier IMO, by not risking people to miss the separately submitted 
non-osi content), it does make a lot of sense to me to do it this way, 
rather than enforce a rigid approach.

It also makes life simpler for people who simply want to test (rather 
than review), as they can just apply the full patchset onto their local 
edk2-platforms repo in one breadth, rather than have to hunt and apply 
from 2 different sets. To me, the advantages of doing things in this 
fashion largely outweigh any potential drawback.

> It would be clearer if there were 2 different series.  One for
> edk2-platforms repo and one for the edk2-non-osi repo.

I'm not planning to resubmit a new patchset just to split between osi 
and non-osi at this stage.

If I hear a lot of backlash, and there is need for a v6, I may split it, 
but I really think this approach of submitting brand new content to 
non-osi, by simply tagging it *NON-OSI* on the subject line, should be 
deemed as an acceptable way to introduce the non-osi content for a new 
platforms.

Regards,

/Pete

> 
> Thanks,
> 
> Mike
> 
>> -----Original Message-----
>> From: Pete Batard [mailto:pete@akeo.ie]
>> Sent: Wednesday, February 6, 2019 4:53 PM
>> To: Kinney, Michael D <michael.d.kinney@intel.com>;
>> edk2-devel@lists.01.org; leif.lindholm@linaro.org
>> Subject: Re: [edk2] [PATCH v5 edk2-platforms 18/22]
>> Platform/RaspberryPi/RPi3 *NON-OSI*: Add ATF binaries
>>
>> Hi Michael,
>>
>> On 2019.02.06 22:39, Kinney, Michael D wrote:
>>> Hi Pete,
>>>
>>> We have the edk2-non-osi repository for binaries.
>>
>> Not exactly sure what your point is since this patch is
>> tagged *NON-OSI*
>> in its subject line which means it is intended to go
>> into edk2-non-osi,
>> and we already went over what, in this patch series, we
>> thought belonged
>> or did not belong to non-osi. These ATF binaries were
>> determined to
>> belong to non-osi (with the intent to remove them
>> altogether,
>> eventually, once we have the next dot release of ATF).
>>
>> Or is the issue that I am submitting non-osi patches as
>> part of series
>> that is prefixed [edk2-platform]?
>>
>>> Do some of
>>> the patches in this series really belong there?
>>
>> The current consensus from previous patchsets
>> submission is that the 3
>> patches that are tagged as *NON-OSI* in this series are
>> meant to be
>> applied to edk2-non-osi whereas the other 19 are meant
>> to be applied to
>> edk2-platforms.
>>
>> I have to say, if the issue is that you'd like to see
>> an [edk2-non-osi]
>> prefix for these patches, rather than a *NON-OSI*
>> suffix appended, then
>> doing so is a bit of a pain when you are re-submitting
>> a large patchset
>> series. So I do hope that simply submitting everything
>> as edk2-platforms
>> and tagging the non-osi ones in the subject line is
>> okay.
>>
>> Regards,
>>
>> /Pete
>>
>>> https://github.com/tianocore/edk2-non-osi
>>>
>>> Thanks,
>>>
>>> Mike
>>>
>>>> -----Original Message-----
>>>> From: edk2-devel [mailto:edk2-devel-
>>>> bounces@lists.01.org] On Behalf Of Pete Batard
>>>> Sent: Tuesday, February 5, 2019 8:26 AM
>>>> To: edk2-devel@lists.01.org
>>>> Subject: [edk2] [PATCH v5 edk2-platforms 18/22]
>>>> Platform/RaspberryPi/RPi3 *NON-OSI*: Add ATF
>> binaries
>>>>
>>>> These ATF binaries were built from the ATF source
>>>> (commit c3859557)
>>>> with the custom RPi3 platform options detailed in
>> the
>>>> readme, and with
>>>> no modification to the official source whatsoever.
>>>>
>>>> Contributed-under: TianoCore Contribution Agreement
>> 1.1
>>>> Signed-off-by: Pete Batard <pete@akeo.ie>
>>>> ---
>>>>
>> Platform/RaspberryPi/RPi3/TrustedFirmware/License.txt
>>>> |  26 ++++++++++++
>>>>
>> Platform/RaspberryPi/RPi3/TrustedFirmware/Readme.md
>>>> |  42 ++++++++++++++++++++
>>>>    Platform/RaspberryPi/RPi3/TrustedFirmware/bl1.bin
>>>> | Bin 0 -> 18801 bytes
>>>>    Platform/RaspberryPi/RPi3/TrustedFirmware/fip.bin
>>>> | Bin 0 -> 41714 bytes
>>>>    4 files changed, 68 insertions(+)
>>>>
>>>> diff --git
>>>>
>> a/Platform/RaspberryPi/RPi3/TrustedFirmware/License.txt
>>>>
>> b/Platform/RaspberryPi/RPi3/TrustedFirmware/License.txt
>>>> new file mode 100644
>>>> index 000000000000..b98dc643227e
>>>> --- /dev/null
>>>> +++
>>>>
>> b/Platform/RaspberryPi/RPi3/TrustedFirmware/License.txt
>>>> @@ -0,0 +1,26 @@
>>>> +Copyright (c) 2013-2018, ARM Limited and
>> Contributors.
>>>> All rights reserved.
>>>> +
>>>> +Redistribution and use in source and binary forms,
>>>> with or without modification,
>>>> +are permitted provided that the following
>> conditions
>>>> are met:
>>>> +
>>>> +* Redistributions of source code must retain the
>> above
>>>> copyright notice, this
>>>> +  list of conditions and the following disclaimer.
>>>> +
>>>> +* Redistributions in binary form must reproduce the
>>>> above copyright notice, this
>>>> +  list of conditions and the following disclaimer
>> in
>>>> the documentation and/or
>>>> +  other materials provided with the distribution.
>>>> +
>>>> +* Neither the name of ARM nor the names of its
>>>> contributors may be used to
>>>> +  endorse or promote products derived from this
>>>> software without specific prior
>>>> +  written permission.
>>>> +
>>>> +THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS
>> AND
>>>> CONTRIBUTORS "AS IS" AND
>>>> +ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT
>> NOT
>>>> LIMITED TO, THE IMPLIED
>>>> +WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
>>>> PARTICULAR PURPOSE ARE
>>>> +DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER
>> OR
>>>> CONTRIBUTORS BE LIABLE FOR
>>>> +ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
>> EXEMPLARY,
>>>> OR CONSEQUENTIAL DAMAGES
>>>> +(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
>>>> SUBSTITUTE GOODS OR SERVICES;
>>>> +LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
>>>> INTERRUPTION) HOWEVER CAUSED AND ON
>>>> +ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
>> STRICT
>>>> LIABILITY, OR TORT
>>>> +(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY
>> WAY
>>>> OUT OF THE USE OF THIS
>>>> +SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
>> SUCH
>>>> DAMAGE.
>>>> diff --git
>>>>
>> a/Platform/RaspberryPi/RPi3/TrustedFirmware/Readme.md
>>>>
>> b/Platform/RaspberryPi/RPi3/TrustedFirmware/Readme.md
>>>> new file mode 100644
>>>> index 000000000000..74bcec7d1f12
>>>> --- /dev/null
>>>> +++
>>>>
>> b/Platform/RaspberryPi/RPi3/TrustedFirmware/Readme.md
>>>> @@ -0,0 +1,42 @@
>>>> +ARM Trusted Firmware for Raspberry Pi 3
>>>> +=======================================
>>>> +
>>>> +The `bl1` and `fip` ATF binaries, found in this
>>>> directory, were built from
>>>> +the [official ATF source](https://github.com/ARM-
>>>> software/arm-trusted-firmware)
>>>> +(commit c3859557) using Linaro's GCC 5.5 compiler
>>>> with:
>>>> +
>>>> +```
>>>> +export CROSS_COMPILE=/usr/src/gcc-linaro-5.5.0-
>>>> 2017.10-x86_64_aarch64-linux-gnu/bin/aarch64-linux-
>> gnu-
>>>> +make PLAT=rpi3 PRELOADED_BL33_BASE=0x30000
>>>> RPI3_PRELOADED_DTB_BASE=0x10000 SUPPORT_VFP=1
>>>> RPI3_USE_UEFI_MAP=1 fip all
>>>> +```
>>>> +
>>>> +This results in the following memory mapping:
>>>> +
>>>> +```
>>>> +    0x00000000 +-----------------+
>>>> +               |       ROM       | BL1
>>>> +    0x00010000 +-----------------+
>>>> +               |       DTB       | (Loaded by the
>>>> VideoCore)
>>>> +    0x00020000 +-----------------+
>>>> +               |       FIP       |
>>>> +    0x00030000 +-----------------+
>>>> +               |                 |
>>>> +               |  UEFI PAYLOAD   |
>>>> +               |                 |
>>>> +    0x00200000 +-----------------+
>>>> +               |   Secure SRAM   | BL2, BL31
>>>> +    0x00300000 +-----------------+
>>>> +               |   Secure DRAM   | BL32 (Secure
>>>> payload)
>>>> +    0x00400000 +-----------------+
>>>> +               |                 |
>>>> +               |                 |
>>>> +               | Non-secure DRAM | BL33
>>>> +               |                 |
>>>> +               |                 |
>>>> +    0x01000000 +-----------------+
>>>> +               |                 |
>>>> +               |       ...       |
>>>> +               |                 |
>>>> +    0x3F000000 +-----------------+
>>>> +               |       I/O       |
>>>> +```
>>>> diff --git
>>>> a/Platform/RaspberryPi/RPi3/TrustedFirmware/bl1.bin
>>>> b/Platform/RaspberryPi/RPi3/TrustedFirmware/bl1.bin
>>>> new file mode 100644
>>>> index
>>>>
>> 0000000000000000000000000000000000000000..e25138828d0a4
>>>> ddb24772abb1a60eefc334666b5
>>>> GIT binary patch
>>>> literal 18801
>>>> zcmeHud2|%#mG7;pmedFVtpy|tJ-
>>>> S*z4DF582<)+{TLO%YF^IMyw%@2*ivhC;Enpe2
>>>>
>> zRTA<tmgA=aC3r9swODMrCx7^1@T3zb2%DK?Lf#29G?V1z4J{zXv79_
>>>> ;z^G+F?{}-Z
>>>> zge>Dp&Ya2NoOkF$@l}1x-M+hhw@Q@U820D96C>N0$f-gpvNVO-
>>>> 6r%k^_LFjhV53f>
>>>> zzYYB^p(#wZhayBm(40?m)v%ZRF-
>>>> jkU{?@RJdpUDVq_0@Qvl>>=KM8BSMAN6D9c2X^
>>>> zv}!gTC9-
>>>> IZXdTh<nuF*_F~<Dabe@Q`4z%dg`yWETSD&vxw>l_aE5oz<u%x-
>>>> Mt_I@=
>>>>
>> z6^f(*?g@d~PT~5aNNv#+%2G)!>6A)Ol0}J=O^M4yanPmrUEBE6z%_}
>>>> qi$f`XQKFzu
>>>> zlVZ_?G$rnX41{DgYzORyWMj?6p-
>>>> TMP#*g+gylWdj3`8X%sIOlv1lmB)R$NV@Mf2q+
>>>> zY4d>}JWrcSYDNxGR%4SA-?^DI?>kETG0>;<^-
>>>> cF@D)C*r!0X4PiJ}^Q9sQugsR%T^
>>>>
>> zW2zF8L8m(ZKusahN`})&<nhl?LUy9+i<w(<d3`h1M5RpU#l^0`wT*}
>>>> SX*21%1imhU
>>>>
>> zPUcNemAKC1ZY6&CX)*AHBnEe$A?>mx1t%~~5>0PQR^krEJ6wr3iAo6
>>>> aZSmWc_!Ag6
>>>> z`56X&xUWmf4DJH$r=?NBrxUaj_-
>>>> e#D|7a!d7m4LPR23=2^S_NbBGxi5Ce4?hcK6f$
>>>> z3TXVu>I#)XZeBsnU^%~vzTYcJS`*qLzY-
>>>> q@C2Lj%?d)EP7gLhfKy+cZh2moYa~$X{
>>>> zx3%XUwhAHXdf#-
>>>> #Z|vK6?76XLKQ{Io`^9@z>$YethdSW8QZ5C&;8{(g13fpB7t2Z#
>>>> zv}wTee+aU&&~*P;CC>ZC@)`!-
>>>> q9RS70s5}E1#NvkX*|Abte|y4K4Ov@&cGb(htrS!
>>>>
>> z?UHhWQSQh3M%HhErgcf#{e7FzN8o|+H4LXX!y1D17Ravw@_ZjU`DI^
>>>> Uc2vsJ_nzf=
>>>>
>> zrMw8T{AXPU*sfUT3wKkT?+aC<bwGw9De+Pgy0M=g=$J0&Ya0&+1VIh
>>>> 6-ju<Pc#Vv`
>>>>
>> zxVG`oUb4_488RjCX~^+rc9W#N2)U@RbJ%UGLl!h2_J5$wD2esZiB|H
>>>> 98rptaG+{Rb
>>>> z?`Abg<Nbfx>k5sBtYoZHy#nk(iF>b7Kn7plG-
>>>> GWM_MT}fv`}>i_+g$!>kYVAtMjMZ
>>>> zKkRxSPMv3q!LuE3blU*#eDKfoFz*JxKk3(-
>>>> OVEQ%;4th*3YIr1fsrJ(5J@e0*s~Mh
>>>>
>> zd0nc3pKa36?~nW8oE_jZ2E+0tU<o9&L?uhm`e)&NbstQ*jvlxV@Ues
>>>> Ufo;hxCu;)y
>>>> zb8)?|=Zqvc?PTfhg!~*9(h6;K!PVE-
>>>> uN%59sIE}y(y=|nx}e_B1%~Bnc7=Gq3awQA
>>>> zngJu7<>zV^LM%V#S;F3RL3YfS7qNwP(4B`1epbOV&*!-
>>>> U`W><occEV%(9iz15;#~t
>>>> zHv{J~&~p)X+?PhxycbtSQ~c)^@_Yhc#^cMuUlRBm@<L_LSt-
>>>> f+2f*6{-VTB{A9%B1
>>>>
>> zY&>*>{SoGslw<yPvF^amWNq8$n~tBeQ2Kr`yX9x#wXS|#&+nm!93u$
>>>> yvEMu`Wd$YZ
>>>>
>> z0sI*FDLnam*tH7XfB(4|J*)!~;KDY8d;0peMS=ec{NW9KF#I&jq?|9
>>>> S5-$RMEEh#I
>>>>
>> z^i`J+#@x_ZQ%2^P1^vx@A)XauojPD0$28`L<)q6J^Bg(AorrNhU9JY
>>>> bO#6$Vk8PA`
>>>> zG-I1?2mTbz(EWqD?jJ-v(_;wwMQRF*7Jp2<MDeJ-
>>>> Zl4U>xnU~@1Li!YAs@Crw^@mE
>>>> zJEv8N!xy*iIXqtPFMdslV^5CpSP{AOIqo-<I9)>j-
>>>> O4@(<co3b0C4Mm2z>pGL|JCs
>>>> z_Scg326Vj>zPQ7#guJ=UC5TLVy!49XQEbg6O5#}+;Onf*7m-
>>>> !0mNBN=N<p%=2(THy
>>>> z`+O4T8m*3;WR2sS-
>>>> uGaVW;O5q7Gu0M33`<nH~XR%Z5QzCFpnl{4+19pY5m!gq7~qI
>>>> zD(E!j%eu_A$MRtv=G@_OCdDsv4kEhZGkH&-
>>>> Pcn3lpE*W%Nh5=WiGDBijN|Fcx^87U
>>>>
>> zFCz~a9RI%&eyS_(7ziKFCj2`G!C(E2@DqL~LA#o7)iz%5+r}}~dpbq
>>>> ?E$-E1S6ufq
>>>> zWYzslANsu4kyBufTd{&~mmve>Q$5%FvW<L-
>>>> oTf}NB{e(^`_Wc5M9bWi`L^M2g&^Cx
>>>>
>> zDrUA^fensqRsvDTMTY(PA(O`EYI`n=g#1N`A3|%|8{6KE+~_9(LH?@
>>>> jw>DWdQ~o5Y
>>>>
>> zCCK+eYQ7j!pl>qyYZ_h>Cwf!Shv$Y|3VDZ9h;3(06152rzgE&E_-n-
>>>> MZDBF`ZcHI1
>>>>
>> z<UlNH)MG2+oSLDHfG#L~SMH~*ZDGP3pZMRVh?&NGfhc6cFxPgNYtu3
>>>> {2&rup>r&s9
>>>> z8Dulo!>&Ve8fDmJs#eXpdo#6Up0{e#7UT!IFW2?2AWM4-
>>>> F#Z5qXW(MGng6G8uYzxp
>>>> z-YXF-
>>>>
>> N~n;;mHn`Om!<2yU{gX(;2CpZQ{u`_6W9Ea+GfBcFvofh?m~X#BzP{-
>>>> We$D3
>>>>
>> zw$X@rr=ioFC%dpG;1$=7@S!As%#CLUiAMzZ4gopP=p?r5p9FN8ZKE_
>>>> (4`4T~wJ(j*
>>>> z_vcyQWcnR!r#Ksw4Se>K_P2Om3_F89ZA-
>>>> &FVtO^(5%$Bw`PoQ?G^}@8aj)lL$TPdx
>>>>
>> z&H#^gkJ2*03)>mb8I_m=o~P;K%d@pP=;M6rIlawvehFL*hv)ReIh(C
>>>> Li19Cwo9XL*
>>>> zkfU)d(C>S4wCRbpld<-O-G02cQRn|A@%#sOXq=lf-)1f~R-
>>>> i2Ajo{P#z->nibm%@!
>>>> z4cmYVdKw;%wsZUU!`>x<SSNBN{|9e|qd(Xg>qKtk{q~z-
>>>> <$d&X&eQuwSbq0lOvHTb
>>>> z-xlzKSdbiK-
>>>>
>> %sg$)?2@i&vyLGd4NMr)8wVz9wRo~$cxxM1xrE1kym^ix!8q6rmkGQ
>>>>
>> zL+b&r^Pq3rERYN2g&^9NiT$ceRzkYZ16%^!Mv*cuL03fNBp(qS5a+0
>>>> 2j^*W@X<B}o
>>>>
>> z__kQ@=s5v?33%*j^)WBwc!Bj3UcX)~;q!<$gKcw^^G)DjnIS&vd-
>>>> gP1$fd*&+ty_{
>>>>
>> zAUFFJ*0b)JI>$7yKj3&j9kwBW4#c309iX3O(&cZ=Xv)z2eJasNXOXS
>>>> =xIm+(;4D%t
>>>> zlbYKIzAQ9yN+G=zQ*CN4)#qhwhJPwfb02R<j>P&<4Et@LK-
>>>> DhrK$J7ZVR0RIytV8&
>>>> z&y%PzEakov<9Sj_V|Z7NKjt7Q=-Ub3W-EyJ-
>>>> a(Fuc|w{R_Qeo4U~i`-(dlhMj$cNa
>>>>
>> znykdjn$qDLp)=r9w8G!P9_wzRW5|nPx0LaB@bxS|Q^!7p{&IfIGHJp
>>>> Xby_rz!T+Sk
>>>> zU!#8$`VYD&g7c`x=kFUiz*qFxS%Z1-snu+Ud<GQ+<$m(BKS;@-
>> <i--
>>>> zA8KSGC)x5M
>>>> zIpEpcU-
>>>>
>> %S{JmHb!r23ANWhwM9FA{Bd1vQ1dh!;9eU3t(?)E}aG5rGPD<wZKscA
>>>> zB(
>>>> z`gS}JaXk3waR<-GC7;H6*!C|#54R?-
>>>> ztnBj$Uk+xhn{fj&8GJt8$AzVd+UO|nYjnY
>>>>
>> z?H<74^Y#8~ecLk0I1eA@IQXp_`M(+SL1*IZ^rNrp8SDl&;M|FGVh7?
>>>> p;+gY%*uMt>
>>>>
>> zhkcidGdah4K6`fDsl*=wF7EHdS(DF%9Yun+F45;lzOeHy?7e`TaFh~
>>>> SEU6i#MBSf4
>>>> z$Mmykxp5Y4f{j#}YXGAb_l(1V_I-
>>>> |{&~4VC4<u@19h?N)p)dQU>oV)Nn}5;IG=?Ae
>>>>
>> zpr5CXmgGPg<mOhD(5|g1fjw_q1Mfc0eqWi%F~lm7hwTb6!I=lREI(C
>>>> LW~#93q-1Jq
>>>> zOD63q_QStf)DD)SZXj6#{>_5szYBgTS<Uc2jlPuPfImgVH5-
>> ={=-
>>>> 7<93f5WRV_4s>
>>>> zZTy8!TZ1e``T)z6y?q>22Otak&tZ4TY6-
>>>> PA=Cbcl1e{fHk@ZlnK&U&(c^dIKr{45)
>>>> zKMjb=TP69(1#};QTpGE~d$sN{+8Nl4;D4i}BebiAtgnaVv+u^-
>>>> @DpChF%9igkfCme
>>>>
>> ziQ16^dT>s+p$~PLvERI`pC^PMVn~qd5Is1<6oH;AQc~~>DFrqx1TIM
>>>> y)Nzu7?8iiD
>>>> z<PjrIjSLn6-
>>>>
>> jnD%EoPxF3v$g07FpDiMd<rT%tT)%$FraWc=OQ*eLhc}c^a?j&yV!F
>>>> z!Qs76Ko(4cA2wB(=81Jc-
>>>> wQ2I##B7J^!ugoxoWrzGAvAcCZ^!NQNQ=bqABg$Sr_<H
>>>>
>> z+yxPWuVb6>VVvNzI5$BpE%E$dM2|OIOSHO=^BSHjq(#GIjfQ1Xbyy}
>>>> GL&pvVnsF9*
>>>> zg*tz0u^Q)_f3bD`7P1UBQ}Uxx$jnF98G`?nl4cT|&6||1|BL+-
>>>> ;4+QPD$iT7k8^kW
>>>>
>> zaP4uy_FmXR7W4_hXuBF#t^OGMuc(azrx7C!oW>scUlpJ>d&3>&r0vW
>>>> `EVUzsvTu+@
>>>>
>> zZP!%96UfrcFIj%(81faw6~k9DExJ6g4!YrCSukDsfT1iU#0%sIxG%$
>>>> gig;#P__;!d
>>>>
>> z@zX#h`c2(q`!{i5f1MVblSG{HBpLN9rb`{K?H}ah!UN7ttWRu%9Ou5
>>>> vbmdV^CulMB
>>>>
>> z$A}s1w+@SxW!RHh^ZaR`0l9`7Ie{4~YoP<>$?e;xA_me@&Ldxp)n;V
>>>> |%S17FF}r;`
>>>>
>> z^Sn4OGuQ$6W#Wc?g|s2I*tT^$?|&_xr&+0n$C?y1T#Gd?fgS|aEY!<
>>>> N;4hwIS-pV1
>>>> zT9Jb7sZ{MvuHVOf<bvNv-
>>>> &g7Tp>9)O)+PnM<QNXy%7fha9Jvnm7hh=!0A}}e8rjmz
>>>>
>> zdY(+jSQcz^aVg2^e}Lj_d%HJMXdd)E5A_B@PW0iXywN+_DV^lsZAWe
>>>> 9^?c;5&y4%s
>>>>
>> z_S3+Tg*o>_2Gbg{Mz?*R(og1}*xm`a{u!u!rck=S0sd;E5^9%drI<{
>>>> f@~ui>Yr~7j
>>>>
>> zm(Zw|%a~U|mX=bIx}n?0QdZXXsPYrNQ43}4LhSQNsNao1+$8A;a^)7
>>>> *7tZy37~?p}
>>>>
>> z_ml$P&aq&IUfX&dvG~F`sdPgWbG*n4XxxeIs!03U{u*dxx1tvJBA@g
>>>> `QE!}xKIXwU
>>>>
>> zS_z$z?r=t>+~BK_HLA@${s)x!4$yyE$`0BoyZh64pGN_WW3XoKeM(3
>>>> H>@L(u&TXpO
>>>> znnEf6=(-
>>>>
>> Q*BH)Z#lzqH@PXohDflnI^|C1ZEC~C>OQz^a;@LBiXoyzgQDICR|r_k
>>>> 3R
>>>>
>> zj_mec?enm&VjGRZCvxmL_eR~8Kf;F(^i}bd#epwtXT#6`T=(<iQ9qf
>>>> TPWvYy2Ir$D
>>>>
>> zV!ua;Ifj#GEcU(OZY6eT7<mq&ZA5E<9haikWwH3f#kS&J3uxfBBaLJ
>>>> G4WB$pNNQo-
>>>>
>> zIEg*lkJ_GH7}br~bd1lRWv!mxy+g?(0)D$Fc0bJbz<mn$pQe&$Xb$o
>>>> }=&uO6Rt_2W
>>>> zc17dg_Ee<Ofpg$#6<Lp*MgL)m_WvPA3H$>4-
>>>> $2RTk0jBtru;{G|M+Tq?spJ7+QroF
>>>> zGI>rf&MKaNr6ETOg|u$ei9H8FyO-
>>>> wlHlkmFd>SaVyP1Zxs9WarvJQQ6XM3()KrL^}
>>>> zyxy}j+H+5lW#zv@@6I9LKFx9j4dq*uz-
>>>> I7Nj`{5(bni8#mu;$cCuwoaF~=Df&(X(i
>>>>
>> zo?c&K4)UJtBJfa3L%S;qjJ0mS=X&%Nwma;vn~d1w1<Zd({llnjXX<t
>>>> EFrNMSEHCPw
>>>> z2bdq^!>4|WWl7yDphNq=Me%g-
>>>> MjWdYyVil4SQ?%k7UR6>gUzx35ODr9=k)7G;;jF_
>>>>
>> zuMN<d0q1|iuivO&aQ?yXN4yzIyc4xCBVJ|&Sr*ShFMC;LdQM^bz#Hc
>>>> T*5fS5fzJvY
>>>> zcV{9F_-
>>>>
>> 1iFjdud)Up#I{jolCa%5ovA<#G?nhK$OcI8$Iw0|_fvV;{?ao7cD}2`
>>>> %P4
>>>> zyG6OsfjXrFF^|uZZJ<X@g^fdR$^nmkbp>#-
>>>> y;PPcArb34ku$RFnFcTBFb$j0*Z8J_
>>>> zbG6h$*h|#$y8YMsJk7a!-
>>>> hZAxw`)zJ68|5_{ooVY?!_g;XY!fCTO!QVa~GZekN2|7
>>>> zS$=$7kj4a4z%TgQFPxtlar9JganOtVg!6YqWU=(53-
>>>> s*7e4Yp2)28yg80OLPeL~Eb
>>>> z<HMZ4zv&#$SLS>db1nkT>wtqp5&TI;Fp9n5_R~cBf6>Z-
>>>> Pqbm54EX#m(+fI2!#c#1
>>>> zHsqv7-Gq00uy?WwZ!1FS$v<F>b9g?#$awbaX9(z3p0b7V>bJ-
>>>> _N(=MK{q&%+g?(!@
>>>>
>> zyFHitE@K@*z9Qb4a4nSJpLtIOoS#dPcOu`77vdbudr0s#{4AqR%lmA
>>>> ~(99Q+KZcP%
>>>> z#*kx%kz>ZbhnO!QmvkVPJdAsD-
>>>> f#FG{!2j32DF3(E9v$1?*ry3iMl(GTaUr{^pvE;
>>>> zx?o4wTa-
>>>>
>> AT%P^*KtY;lP_a$m`uRtG^F%bcm%z0WGYU0qtsn~n_tHUGh4@fvCWd*
>>>> 0;
>>>>
>> z`IYY%2b#ZE6li+W9Z+9!1)@^>NdnJKjNOIH3)%i&vIjo_j$giJ;A<C
>>>> 1vndZnCgaKg
>>>>
>> zJx33x2f`}F=ZebvVc_48*iX)hSU1>@UWXpLp(6@p#PTU#AlSw~F4$O
>>>> JBIGY!Zx2h+
>>>>
>> zgQy!xsqK`c*S8ui?jFR(R6bX5O<z^%7_a5Cp#03j<8qqvK0oIJhJ=g
>>>> lQEA<*=aygT
>>>>
>> zla0P16O_OZB`4y<H9~O(M%Z#9lW?Vva|afo9YVR0)VqrUsjj@p(2|@
>>>> ;+O*<8nw%54
>>>>
>> z2iNciX9tGw#JXKM5nJ(`z(VwCN3mwY+`zn}qa)AZ8dmUdU|1dIdKvz
>>>> _z=%bFk1KuL
>>>>
>> zBZ0|0w=*Y_x>Sj$?id{zI%$63uA;oid|bl{9t#XZy9U<?WkF!Xq`b(
>>>> ag?SO?4ez)E
>>>> zr$-2Zv)N+c6T1}n^iE6Qv-
>> ^?)pU+4R{HZV{aDJ{e5PN(`;L?)Rz!#-
>>>> M13k;q0=-qk
>>>> z0#~0O9>{PNL}Cp_t{Y8J0LKM5Zonx5oMOP44LEZEXD;A83^?-
>>>> u=Mlhp6maGP&SQbA
>>>> z4N5%El@q!8{DJ_}^C#@-
>>>> ^^FSrVLN;T>H??_Txg+qY_k$S|FcDb4Ahcr(7VaFU_;qw
>>>>
>> zV1sIwQUE>LUxc;S(C4MnliZ(#y2TzF9aG2s^L9#u{Y{_?MewJzgEZ<
>>>> SZ3gBi_4OU#
>>>> z`JZ6^-
>>>>
>> FS`y&h7_<g`eU6EY3^KSdaW++kLpM<M}1%UI)&{W9flN`TT{)o1hnN`
>>>> D4!O
>>>>
>> zT8iKwiN?MzzcdtnL~LPw*#*67hc98?{_MI9|H*ahtvAIdf~HBJm)kQ
>>>> ;Z<=!aWzf3|
>>>>
>> z^cEs#9Giq35j2C&&p7w8;4H&uqzVh|Zzr*P0_rXHG$jU^c#_hTef%!
>>>> vWyBAA78TfG
>>>> zLx;ed9WlNM<MvIBd-
>>>> ?uj^c9l>d8DNq{@WwhF;B>U@XWF({(KYs;MdpKflp;PI&4vg
>>>> z%`#*B-s^bZ2K-
>>>> DL>LWUBP3SY`TJ*Wtuk2EVF6;t~v9?2dC0pZOw?fA_rvM%M$3jOW
>>>>
>> zz;?r@Hi8a)KOhU^dlbj(=JzQ5dj&twxeU+at07SfxQz4Ix@>CgSg*w
>>>> W>$xsL@XKoW
>>>> za^hVta<-8BnVbwa&X9PItov79b8+#(z@-
>>>> st24cRG*B`+8k;tokxOa3G&D@!)*U+Dn
>>>>
>> z;YV>FKMk4@JDq$^SE%qL^2Ev39A!h+du_P~5N|JlHuzZQ#l?sAnz*k
>>>> w0LKyokBQ?l
>>>> zbagNe0*(&k42N_a#`}-
>>>> K@M8)1mzEsbd%eMUkB#p;_B$k+CgO6h%3GXo{V3O!M;Y!-
>>>>
>> z*2QkLQkoJfr#q%dX^1U|FQNsPP0c7LF_rtukr!|aUs@tzY%FRD5@e+
>>>> J+bG0&1Irpd
>>>> zTW`<7Ci#8r9LT9N3po<oC-
>>>> ~v|@^$3>z|rdPXKILJybrAoISb$3B<}sVw^6(Udm~sV
>>>>
>> zzJ>XLox=xIcR@$;@y@|*8J$t83e_BAcY>CD&^)+bMjzAU$TDOuV4aW
>>>> Xe!@GH1g#l*
>>>> zi*eQ$9(Mq4VFIqn3#vr=ILAk>IpCa)cRS;ePv9K0b4-
>>>> L|m|Gqbk&q8cXgP**4q`!#
>>>> zV-
>>>>
>> I*p68y1dN(#Q*^Wv61QewMp&D$+D<J&66Z^4{W*cI!Kw7jB#ZDl;p27
>>>> Atz7Bo=O
>>>>
>> zN*O$QDe2J!&ANQC4_G7VIp(<K<pq}IV++c$j%|kLC6jREENDFi+ho6
>>>> a3H=iM+IU=D
>>>> z(pbn}z;_F<A^4C&BHey>F83CcEtd<7Z%Zutdw^>jf6VWc``=f-
>>>> a|YiG;cR_LlAKTG
>>>>
>> z(PF&ccS_d7+r6sgZPeH<EC(+5=X4Rii=GkEJC~0yIDoSv*J#)WAtyb
>>>> 6T)#RKda{b?
>>>>
>> zLe0~Pxp=SlsGUZx{0?~K8h&ju&fLf`I0whsYf*bLP42{e|Hls<qt0n
>>>> 9<ZqbSgZzQ_
>>>> z%`1)^YMueiZ(y!%4E5I~InQUBxi-
>>>> KxfvGs7J>XIFvwsfJ(VQxW#`S@0jC~urq@pGn
>>>>
>> z&BeQwHmU}0&5=u<Q5Zvxr;ph?g=!V&J}dmLy;Z38BKP_^XtQ_Xe0~R
>>>> ccn#105%{w2
>>>>
>> z#yHP=PpEFp(Z8`s=W)c!Z2JkoNhi;1y!MwuHQ}uGV_p*#s{J^V+CLS
>>>> lyG9xCT!7bw
>>>> zHOMQgQOoljg05_(o*BME<GmJgsVr|krN95tRQPME#yQf%V;6A-
>>>> f8hL!TQ<P&48t6K
>>>>
>> z&3*sD8jRgoqlVb${fK%#=#_GhK&ck_akkwKxu3xvp+4Z`+9{v$Ij>{
>>>> bUf}!!zK`iy
>>>> zpP=Uy_M7S9F@`-
>>>> lK@W5w%rz|RwWdg!Ed+h{q88i)_`L5sBw^@9;Heq_yEg%QLjrcG
>>>> z^mW)3;FV!F!{3<jy<(0I-
>>>> w*h^QJ+}>9J^6B;qxrxIhjg}OrH2V6}*=$xhUm275J?k
>>>>
>> z5)EAd8V1Xr`C<6Xt1m$hZ0T#fdI!kf3;BNInuP3GK3D_U3r>?JrpIv
>>>> $XfW|JExgxP
>>>>
>> zai(N>aGma?c*khgWfk@Un_nctAC!)x>Upr?Y}DANL$*AQ+$<Zq*Tyx
>>>> aiMWqSc~0Fw
>>>> z;0$ltEq}juqqg%iy|&Z;zQy={#Yupl2mGwx-kt4FneT86zeu-
>>>> #w<T~}0=Fe_TLOQv
>>>> z1k~_9UG3ZULtKCHlK;YqGGg>L;C|~C;a7nFdEl<UMfknIzXZ6K-
>>>> Xi=e@XrA5f?I^&
>>>>
>> z5B%A{opX!ucLM(v)FgXw{THhBUkoY={Qm~rzrIEI`R{bDZ>0E`l7}M
>>>> y-tg4%Q>Ao4
>>>> zSk&iP*~{Ne{Plk_YRTKc`&+k&e|-B9ejd2%ZxMbk@Gk-
>>>> GrMC#b3j8yGyWke#_XB@6
>>>>
>> zaOd12{GGsmr5E;(>#wivU&jyy{(l4RU*979U#IAH&ut0ZmcVTZ+?K#
>>>> ?3EY;z|L+o5
>>>>
>> zKjq#@6KX0~Rr+cxC(h!hd#21NxMx}U)Pm_Vr}LjP8$b8D6|3sxS@Pu
>>>> jXHC6-*7Qkt
>>>> z%L}U3%Tp%d-
>> {b;Jc>~4VoBg7R&d&#pf12n&ffs)Re^(O^1&RJ&<0C-
>>>> +{ZP@H{{L3t
>>>>
>> zgIWHyCR+UMr~dmi(XPTrg!~(qXs;&vjb5VH63=yJ|JwVEA;p}LXcPS
>>>> tCeL->EibNG
>>>> z^TOTo6OT@$5?}4wvdWs87vzO2<f-ywRTY)1WH%YpX0I-
>>>> *tgX9SE?T}~jqjW0-bE9h
>>>>
>> zShI3X)$?m6QsRbEYu2uqI!jJG%4Jo)nhLq5a{Y?h6;*5GN%i9=71XC
>>>> vmNBcivaYhc
>>>>
>> zuCij5JieCyJ#CEt_tYC;d}XUD<+>`lLZ3Pa9?JLlDf<8T&)gtG@TKw
>>>> 3hd!47&|`aw
>>>>
>> zKmLctpB1LQxp(9L{MF9F$6mg6?#FvX`8Pw?e)P8Usd}ZoGWE%(+NRf
>>>> %j&}Xs;@@S?
>>>>
>> z{mxwrQy<;%P=PJqkf+scz&|l0fhW<QljyHA`%N+iw~6_!#l}GY{6zo
>>>> 5gW)9l)xq-z
>>>> z!@d3d*O5R%{srH#FB1m!pFH}fcdvdHd30OT-%pE8`{3-
>>>> {6V}!9ufH|t?e9)pc;qKf
>>>>
>> znX0_Htg3#Nytr}=n?v<FSeIP4Vs&NJy1IUCH>Q+SmRGJ=Ux`_@Ypd4
>>>> OLi=wzZAnel
>>>>
>> znq_kNa^IRYm8)j;TUNsU3{X$3sjOeCTbS&tr~ts)Z<tsF<Cp*D=0KK
>>>> J)(tW{`B~qJ
>>>> zRh1R;1jAe>!k*n#Rdp*skEdo`Eeu+ov!Z78^S+u&9-
>>>> 2Ry?HgRq!LoHVmGX);@>*_I
>>>>
>> z`<7M8tEzkzGPtN%#p|n{mEH5F$P>m_0II$Kz+nFREFO6_0r=iQ@Twr
>>>> sKMT;H#iSMB
>>>> z4D#-
>>>>
>> ov*d|cveWqCUS3#JRSsdvi|c$f;3hF*@^WMS)XAV?_Wa3m?YgyVt7__
>>>> MWtXd_
>>>>
>> zeEI#;?x|X{>V<pdg?dnuYgvMbJ{9t_t9;AkBG1y&c?*i>KT$lp)a5E
>>>> EdU)!T(vsP8
>>>>
>> z7xM<B((ICw$4h3(vP=se_slDrjaypcDp@dZ!Q5Fg&08?%aUPWE$=N0
>>>> D#}{MRG=g8v
>>>>
>> zG46hoXwM|tKPK8MiI&J*l4$XTBLDFHg85StH+T)K|IAk4r?1Zwjah^
>>>> IFMrsa_$lVi
>>>> zU(%+oUhP|33VkiDsa%GjQChydvV7%)i3zQ{S4PaLs*%Uzd-
>>>> T)=RdsUZnyPinmdmRv
>>>> zS63mHL07OG#=}czrOHpbW<g6=)ywii<Bo4@S8S-
>>>> {?hUy2)z#JTJ)+V=*MfOP=#Uo{
>>>> zAy1f8PxwbP>F5X-
>>>> )4dme>~*uBE|dWSf{3p%_@~@uwETZ3zJS9Y#ptpd*neZjfBKF;
>>>>
>> pGUp%uPONWW+j(aqe(9t5Z<6tBrVGl%uRfd8%+}<~gxlZ${{V7n<9`4
>>>> E
>>>>
>>>> literal 0
>>>> HcmV?d00001
>>>>
>>>> diff --git
>>>> a/Platform/RaspberryPi/RPi3/TrustedFirmware/fip.bin
>>>> b/Platform/RaspberryPi/RPi3/TrustedFirmware/fip.bin
>>>> new file mode 100644
>>>> index
>>>>
>> 0000000000000000000000000000000000000000..eff727ca78dc0
>>>> 7cbfe56f1b6717e93b91702c16a
>>>> GIT binary patch
>>>> literal 41714
>>>>
>> zcmeI54SZGAmFV|5_vV8nK)!$&QgUv<7H>a9J`=R&B;ix3ViGO2eUlr
>>>> KC=lc$0g8a;
>>>>
>> z2C!0Nr(8^j4t6Ftpp|>;`#r`&$8_3qK|5`Sb_Nr}Ogo+N0=Blrb|8r
>>>> 6qLBAr=iHNo
>>>>
>> zpw@O?f6SXnejN5W`|Q2e+H0@9*4q2*y{@Ke!yE6Jo~h!0Rk7DoKUHw
>>>> +r=Fhk!e2H2
>>>>
>> zpg3hmJpWvYQ^HQ?znuKQqRU^M_vBY@SbXfe_o@d=?feIQSC$+4)U$V
>>>> Jj{W?GONB4E
>>>> zwD6lQJ^Yr-74{cv=_-=b{YtT`yKj!GyF}aCsnQF(mD0j0-
>>>> Ol%2*3wHJPE7YGb*v##
>>>>
>> zwVF!pR4O?DsXINs?11ENCf}#j0k8zBNy)SF*ONbnE9%M)pLC50pK^^
>>>> 2pLUH4e@<7e
>>>> zE4bd|3i1BZ=EI>&E)_6<sjVsLP~-gNo-
>>>> M&A<yn2lj1^jCj_fxr+#>>-?(dwIsItMc
>>>>
>> za}w_*ok+ceasEzC`8$i1>x`+X$^y3v%u7#r^6&kX&%dHnJ+xIuU79!
>>>> IsycBJ9=zGt
>>>>
>> zH%=*kraU_|oayV^9Z|irbfE#b9^fl?!IQdD*_7?PwE4(>DKE4o2(9G
>>>> (!lkCmb0TGh
>>>>
>> zM$H@%*rxpDN0lB(0*=cZQB=lrv0HUabgLql?k|V7821mpV5k5zm)H8
>>>> Mp7*#_#$lz^
>>>>
>> zm+@|nQXL`aos{#;liPtaCt1Z#x!hrSUlY{>&6oQs6?g{IE;OXXX?iT
>>>> trYTkE2mUEn
>>>>
>> zDt(}bOQ}0?lG#z?{!nI<PpxeS2VzBE>Vc9;S}Z}@2_03Ms<&`Zw}kf
>>>> vYD8ck_pc#8
>>>>
>> zBS_O|*F<HvtBQ6(v(+xr2X%O&wmkb}wWeBp%YDyJ2Db54)nU+9m7rp
>>>> VpLB$Zf%o8o
>>>>
>> zG@dt_9r<o`Qv_OC;QtK?f`3H)DOYm%$fdr@D7YQI`@t=3R&LsrZpLV
>>>> {)jpdK-?QZC
>>>> ze5#6_N7kh;R1kSdGh@}@(h~ih#}ia*Q=(nxe5x6{wE3vjpO-
>>>> d&CxmQ-MGntbXrW5#
>>>> zR&Z_IIwDZLH6?Hpvg%W6`ZVMv2Oc#~Es5>jrUJh5lGvv-
>>>> #zkM>j9``-+qX{z+Fwus
>>>>
>> z9T|O$eCY5Zi!<7%nH>hS`xhN*C`J|qPBZNd&Z6x~tv#RhM6T4|PMxS
>>>> L%X_|}By?%>
>>>>
>> zi~Y1YbjcV#51rCBZAytHZ)$N#?80aDkc{iSr&ZtrV|%jD<We(Q6J>m
>>>> Wca$01s+%3~
>>>>
>> zyd{`##_s05)1HyENAga(vcmhIUB>BW<FqT<)l9wMcrzB%=_{pD{krO
>>>> q@}HrMPF-n>
>>>> zL-U2tmiE&<4;qi2ozt-
>>>> tzWFqJoXsci7r~SObnGl!R1$M5b#}X73%pvX#pd`@0!>Pt
>>>> zdrHOzFegEGO?q4Ii)Y;(uFHKh%te~j*VohMc7Ok!-
>>>> QV<=^i|{D5dq=DI&i&J;|lp`
>>>> zvp+!{>U}qU39npQU^;mIO~EU-nh~66#-!hbUn6N-
>>>> R97>`LEl@YT3|zg3ds9?6Scre
>>>>
>> z_@gKIJ2NRme|UrR?@3oqI4b$n&qH7NG&TJsy3WZPN1mb$g0E?miV3U
>>>> {)TjN~P4M%Z
>>>>
>> z$mHATBXp(J_rk}wYRcf{_bnMHp?xCr#f!C=+!s%=Qx81Ul^Ls2+8O$
>>>> @5*h2)XPSn-
>>>>
>> za;ZQTGB0%u`a;H$a;v)xc&cdUdykuxz(erGuha|;9(W8bP)+|29y4a
>>>> VzT&+KGR6mu
>>>>
>> zMF%!|Z0ELUN<jMmk>^W0u7_6!_59E4j0ZF3dq;%~+T}wJNFDTt)wk$
>>>> MOE*cIb#$Kt
>>>> zkGfX-
>>>>
>> tntsd9*k3TxaPLoj6Si)2DrQ2@E+KX4!N}XyZv(W26B)E4txB#!ZlmX
>>>> &={q+
>>>> zDCKJTTln@eZC;-
>>>> e*B6XQTfSe2kIV0dULB+}hQg|j!_t)25=D3K`@Qh4)L#x?#}DoY
>>>> z<-
>>>>
>> V#PWGt2XQpJvR&e>Sqdm0;;uiR%M$OASdP@JyLmGt%X%Z4QjZ_MeaS~
>>>> 9U$i7dP^
>>>> zAPWMkq<2n-
>>>>
>> ^jC4RT8nQYFfxRHCB5zrkr!#Ri@p<kBJJ|2{1YOBrFmTFS(9feFJ(3I
>>>>
>> zJ%%YVd(aq^FZ#9)93r1(;JhDtMDO;cskPD<Z;e;6AG%fLFVSW4ei`j
>>>> cpnW4Atm}Q%
>>>>
>> zmEip~@Sdh^hiO|iZFBSPdSpXqJW;N^hVpk)@6f5#!0y+#biGC!4(j7
>>>> ten4B-ZJgBm
>>>>
>> z3*=C2gn~ZNo2T$mT*v`>jP?|tz@~fs$o@B1%<2^xZ~<5Rn5VH%QSiT
>>>> oJ`^22Sl<ax
>>>>
>> zYUD~bW6*q1_+sj|yjuL>T`4l_@W^@RCV#tJ*fYk<LI0q7mo|SdB<&G
>>>> CS-hm2CkNbd
>>>>
>> z8&_@d)uvZye+c?yj0%kdwr#LnX<>Ae<;Q9GaZ7c^m(pTB?1a=a7&lV
>>>> SM|*AEa5!Yb
>>>>
>> zM=2{bz~8g;w@V#$cHT}qo%>ZgowLJE%UVswtLP<lw)Ao6g|AD%Y3Ux
>>>> ?@~Wn?rCkC~
>>>> z`rOi?m!O;eXv<V<6~0^BShZFo4J!Q6Tg+X)2`aW47{JV~C-
>>>> qHLmj1Hsq;11jUFsXR
>>>>
>> zhwD3BB408d92{cLFJ!6M1#tNHmc%NBPxP^Y9LTfSP4Q9hjpx(;8Dis
>>>> tR)1%CFJPO8
>>>> z+T{0yA1;aAG8jJ34*b#~@OQi?`~m(5?f!z1fxo!iw_EI-
>>>> ?^Igg0{8x}mxwIwEL9_|
>>>> zv7ZYp-
>>>>
>> (Sb`%#rZ6#O4A0nT2h!eH`U=c#`GvcV^Q^tp$mJtSwnj+B#4R%h>blS
>>>> uJld
>>>> zF2-
>>>>
>> y(@r%ZU4aP(eo;0s$?7g5Xd<rvmgwz=WG9Cu}mG6NUo54K5!iB76@!V
>>>> KCIv_Io
>>>> z2>MJ?t4vS@nt2|@^$gc&E|G&DyHu<ABT4jOA{S$zQ^vT9OZ-
>>>> be*XJms5`&#4a}`@w
>>>>
>> z2lRS2awh$~1)hk0#|9h}8OLsP_*ME$csgSN@1|4Ehkx@$@FE*t+KAm
>>>> &UIo2s+2}wj
>>>>
>> z@>WefgL*zKd6tx=T~^uX;Ifm_19y@Sue^<<Qf@x*uY$QhJs|Ur#uPL
>>>> 5ucUWV#?nL3
>>>>
>> zsL&hYtClErC<}YINa`bZ*4VWC!58*R8N03D9yETmu=Jha+KYeEjw}l
>>>> ue*xXwZ1`S3
>>>>
>> zzM#mn_&n_&L9US>k^cxjj`$+&Wm@2$<9R{G#NLmZv85WiXsp>$;qqr
>>>> zDRt&o;;)Ji
>>>> zRAc)<TQgP1OHLi~ySWz}+ep7DvXTj}q2Y)4&Z0l3!WZ>+-wgV`-
>>>> ^aPM`S0Vl^jrPy
>>>>
>> zX>Umk6^LB>OFH&FkraCR$>h*8cd8iruc%n*^~o+(DLj+89KN&oU}3*
>>>> *7WwH97dEyv
>>>>
>> zQ3c+Cx4~_C;BXbbs>>Y;Zqow6kE&QS(VrRoEO|+DLct`RYc7{7)V>X
>>>> 0o_adIf<4av
>>>> z!J@0lU~UX7;kiOq2B-
>>>> Ox)Y=d{$^W5RTaxH6S38??ML(GuwvtOFAIY_3+{_Fpv9lX}
>>>>
>> zy>{PyFQl7aEiX{P24{R!(B8(SBLk;pTm&C4Z|~UGppqZ!G+uqC=aa~
>>>> }4}K<*%Dh>|
>>>>
>> zj^l@Upy`w@`t&;%|7<xBd!{kpQ(^Igd&P!A&s(kp=Ke`xTj#o&M<j;
>>>> n*H+y%=9uU{
>>>> z8RuodyO+FEdNz64<YkA;-
>>>> 2QTGY3orvi@YrIvcfLlEhbMXbzDU=15&477g&Dli~BzV
>>>>
>> zFC3m358AvFnu3ho;<U=1cJzC(`<@;@&n4FVk{%!TC*f&v+UI&q?whT
>>>> 9Ur#itZIAFy
>>>> zF0&MykXG7-
>>>>
>> kGHm(_p)Y@2(Enm75n*?Zs`Y=ervZ%F71*!QdUcgcB<rPr=k27EC-I=
>>>> zCx=7Z@h85ZB0qB{+xGVF(<4874SKh$#M`6ruv#V0(t=+o-
>>>>> x+8_ATZUKVfVg2CmS!
>>>> z-7n>qKWELKzq6)GOFw|Va+9ZpqiyJ`<Y153zi7G&ox-
>>>> 2BaoT+rd{je>_II||sKDNF
>>>> z%nkCz-
>>>>
>> $efyiGh97R7VuvI=WT(=e)bmvZMCeiO^!Tk$OJp5nc#g1;8+us1BKD7
>>>> ~C(V
>>>>
>> ze|4UP7J06X+hTkt%g2cO6}JB4J^k%<qnmVm4wqs1+h+k4I0!y#9LML
>>>> -KeA+Sz-Gz#
>>>> zd;=N$iqMs(8Y0kQ%M-F|>9V8ykAvH}xB2nCP!s-
>>>> NsoL<IW1||8fttj&J=4<Xbg3m~
>>>>
>> zN3nXSr!hM#yj0i2=f}0}kv3Q4Wrf>;zf|A!T(R2JQ<46}9_jx^o~I|
>>>> P26?yD^mjH=
>>>>
>> z=V9nc;T`k0a&*ZG;njoWHR|{tDQc}RapQB6r%L>tKJu=l?|EyCz1^4
>>>> )dYiV%Sj&TN
>>>> z;@_-
>>>>
>> ?53zc82$*MPs4*=UMa~n|OET7E494)sf;X#}jK!xmtB!@pdmjF;QvO}
>>>> v*^)Q@
>>>>
>> zYi;=0#?SXKS9q*I>Bl}d>F0Z73};hjCOnwlls&%nuT{p0f|vJ1fE%2
>>>> pVn&k62sWY1
>>>>
>> zHk%!7E>*85s>+%t%+M1}4|RQ7jcvI=xmx9JsbW10*?uXhzOmPD+<h_
>>>> XR+;;BRaxy~
>>>>
>> zJ~>*g^(fad4|5)omwfnN&AS|UB=;%_oi8?Gmeu!<p>NMka#d}LQpSg
>>>> EQj=cZ<JZ+e
>>>>
>> z8GlV`%o)=^=OSwll~LxuH;^Z7s2*>2oOWI3jk<EfkHTwKKYD{Vo3XD
>>>> !|0(9k`D)ym
>>>>
>> zU&Z<=O=z4zo%uJK9VW0(;<LZDW!)1=D(M>~H>wW$qcZ9?pOgAeHwnx
>>>> nbliCKQEu36
>>>>
>> z`pci0reeE+FS7T{G;FEb+8L#c_;gMBm@~e2SW7~8$rz2|+lWni?eTT
>>>> Hev5t|th-|M
>>>>
>> zb3$)7&SmcXL(2wSkIkK%p$<;Q=PAHP&;PjD;~AwYC(`dtA2WN7j8v6
>>>> }Nt;RCjN>Zi
>>>>
>> zUT$}=b58o4i*9I;v^`B#4%X3QwS*RtjT7|ILFStI+SoJLt(V02TDr6
>>>> H;{H@ssRO@F
>>>> z*Uv1FdvL$P{jX9~WonMu;YNOS=&Bzv>B-
>>>> vWKkKbcQHNfmO)FLMu~*4|(WMUlI>!wC
>>>> z1O4Bm63^V0pkCTqaNEV-
>>>> KH8T1C2UEXo^ocXG4EnBef1+X;#jekcBVO*c0jvN&AZr4
>>>> zz6pPtRLYs{YD9~F*Sw1&L%;k;TW-
>>>> F_+;Z2#i?7aV%Y8+;>wkpYy@nrmO85v3HM`8v
>>>> zHriA}`8FNd+hJamG1a(N1!9zO-
>>>> U}`%W4%wWyjUGC(@U8$+EArZ&(s#$bxVOS>mzT;
>>>> zxTAkdm2HcB!0cu|V6U}gS?e-
>>>> C;yG9#{8DEY0`pr1=+qAjFV&gl$k4$Lt5^nYQ)0W+
>>>> z*g!jTv^1VQZhxle$!f-&=nswgq*JC}KH`4v%gix`=7|n-
>> ^q8Z+#5a-
>>>> kI$tJ!8*??=
>>>> zerAV-7b}p<i^8+GKD6r&_^=|!+3-
>>>> R9Sh2%J*n#TVW(PW>({uKru6)*fg0ydGF1%W1
>>>>
>> z^eV&VQH|H^fcDNN)`}mXAD4n#>Xc5=TAXtEZu49_^JWh=PyEqV=<(x
>>>> |8purz@I+VF
>>>>
>> zf=k9rUAfsIK6eDaPIxag_$VVZh_BcD=Vr*DzZHFX7#;^%v)!I6bi&_
>>>> f#|E}C$K1jE
>>>>
>> z?w_H5HkX0UwEWs~tw`Y8?SEmv@Z90yZ(I|?=;_u1Ykrf={DyB6$=Z{
>>>> qR(0anyhBEI
>>>>
>> zql*Ft&oW2Uq`&gaT`F(mE+fZm5jc+jgg@1ZKh=ZJ)rrs5^AjnHZ{@+
>>>> adYgNvTsrpX
>>>>
>> zG_d{IW}%P1dJ7zv;EhjJosj&5WPj(=>FOo_r0?%hY38o{$?6>Q{7Us
>>>> T*0UojAm0uW
>>>> z`uYw@`Cn2#%5xMr?pM{~-
>>>> *Epb{?>Ntqi=Sf=DN)Da`58^9h|6c?ygz1xNEEQlktMs
>>>> zftE7(sno>BjE7UZ75Z8Fdmnw)#`hX&-
>>>> |wxr>5r_pA^BbLp)Xkq(ORZJv!thm<}|bG
>>>>
>> z5oq2A&BfT6i3!*h=!Vwch`x5?|A=2z%lxZN>1QUhrjws$_Q03Qgf#Q
>>>> Hr+N1XGMAsN
>>>>
>> z3iDOMnIp6>AHA@Z_xW3z_sjhY<jqkYY>)fQUh<7~(k^r+&%%#6uW#A
>>>> )Zguj(=NC8@
>>>>
>> zY~6w_d=vaWzMr_kFSNaQxzD0)D|vQVw^f!tv;6+1_#EH@>x*OXuiD>
>>>> a{`98IN3g-P
>>>> z{X+bk5c;^I^m93xrTB-
>>>> eS#}66sdK*KaOjQE{!GTRSLz?4{upc~_0M`D^NaSTh+m_x
>>>> zU@fAO``9UDMtm#r$xT&!0vm8sa*nwv`#@{%A;!`<=(5*|kL-
>>>> 7FUv2`&r)@kAjtj`u
>>>>
>> zP#g*z?dXFe77lw}KNNmX9R3@hKC=IEll{GmZwUuIeCN`+N>}Dp6eJ(
>>>> bEy+`vrCX9K
>>>> zN=aR5d{a`_O?9OybdTy_9@U|z`!j2lo+5cQjCo02lFD~5<_|7-
>>>> WaX#xZHRo~mx`ya
>>>>
>> zF@9w2ZytP#WTXFNEYY4QW9Bk89UMD7(dhvVU)s9&&EPvv{65Nkx{9^
>>>> aH=0|;c1e2}
>>>>
>> zlZ@B3Cy|GOZ2HMPKC{ZNtrZ=(7h2FW9YgaC@`NT&w#{>mdeutJRLZp
>>>> Sp*7Q@nfGGX
>>>> z<h=*D#c{Y!TbL1A@ADr`?w0ukaL+P?&}sN6dvm(Q&X*cF-
>>>> 7a*!i?r=#m-S87&AjGm
>>>>
>> z+K`|Hd$y~D@FTqs?dnrz&r|8!_qgNVX9d5TGF6NPkssHx+Cq`(>#_S
>>>> !pRFovQVI12
>>>>
>> zZS<*x+XwTPexQ!avLBO{)fBpyO)RXTp4eC^m#DO3uR`l9j3Lo+Z;<a
>>>> o2VKu~(lrtO
>>>> zYb~^|Q!&<ym9oa!-
>>>> etbRrOS*$`#Xj^EO0Ju{ySN}>|clbI%^Z+H^1R>dGE<n6|5zD
>>>> zUCA%*@%i0PGM_%T3|#2a3|;i{=d_H-vg-
>>>>> E;Rnk6OLPVH<`8y#Z5DE}Qs`oxBbl<S
>>>>
>> zSKXek#?*g_w(`xz+n9(yjUOQP6~F4PwnY2;V(^7qUs93jEh^Yl)Qf$
>>>> Qe)H*LQpE<@
>>>> zYq|FKmP?yE`qv}Gh6~N&_lv(j4gc%rO4IV|@sp3|+?W#(-
>>>> +vtMK7%azS&N9~s_FTy
>>>> zYAv_}o?KNqmUkMLyvvVhYyJ3i$>_)Yo!VL-
>>>>> lr_!E%_0A@9R{h)RFSvrd|0@@m|Uu
>>>> z(AGBR*lY3f{&&!w|1xkgROJq-`(tgb!Vmj9sT0-
>>>> K2JtuZf2FNGIo5_(0=$#dDQ3R3
>>>> zi1J5}l_&VlU0p0|MOj|)-
>>>> +cut<C{mPp;y&fe8ft5cOL)x=Ccp&+JxR2Ng1oojqg*3
>>>> zcLR0&9isETt$M$8(Up4)p}H%G-?|6BpQexS{k^hIBL4fPIBXv{-
>>>> ;C44H#du(SLkn{
>>>>
>> zN8SnS@o{>Pflis9($@jgmDQq<cOPp&TY)eA{xz4DdLBHh2f@A=hrKB
>>>> dyUKMn>{{9?
>>>> zu(zXc9QZyx$ATXO{!`4ou-
>>>> mOqF((pVRq&ihQFl3Ql5ZmHQ7Av}%JrJ)t*^OM>K)K9
>>>> zl=spefiJwTj?=?fx~i?dLA>|D-
>>>> }kH&=e_WUI`CfeIy4DAo@+pZgI{QozJ3RPQTQQq
>>>> z@DuuV<3*PJj0wj4T{`-
>>>> pYLZ&JkTE=t^|TrAR^ES%6xnN)`Qi=SM_qYdOFy80opCGQ
>>>>
>> zN(bg`KZvg>4*u@JnlAA3z%TOc+uL@pvxa8tMK%04%z<GJ40GVWF$es
>>>> eKYpigw_Mkv
>>>> zkp?#PS#ZmBE%2M*e;nL$T?_m^@UH~7T-O4>AN-
>>>> 5JE!VZc9|Zr$z%AFcz#jpB8o1@U
>>>> z7Wkv!fBo&g-
>>>>
>> Ev(E{EGcxKL)p4*8;x*{%650*R{aUciGOz!7bOd!0!Y9N^r|{E%5un
>>>>
>> zzX;rNT?_m{@P7>4a$O7j5%8yhTdr$?KMMZWFEakQt_A)LQ$I0fazow
>>>> 9y6VQd8)nPX
>>>> z$EVIJ{P_Jf(+X!4&6qLEp{aEJ@|Ek1*~U#XXHT0sd-
>>>> {xz8F#GSU`(CDzncmvv}Vpn
>>>> zouXHyFP7T*$A`TCaXkO|vMcLF<N0~<{O`=Q-
>>>> #@?R%5sb6+0X0Z>9g_l$MJOWeEWTJ
>>>> zJdMWl9pYBTpO-
>>>> lK=^wLSIe5%CzM=VkhYn_&)*ma4{0%+7@#p(D|II(`E&kLamtOn3
>>>> zr*-3}scVit>AiQO*;bcw&(_ARI}(nc{9?t=v*v&4ql;5+-
>>>> *ju?;umbVg=_6}(d~9>
>>>> z#`71%^IyNs!Ed3x>OZG^q|q+tly~ws4uRw39~e^pD!{`Te-
>>>> aKj{9pDS{jy|8{)ywi
>>>>
>> zd*+?rbl<*v>t9aqnf|R;hn@$@E?qQrwsC!9ib}EW=2b6WxxS&!SiZ_
>>>> wBgq5R_tzOK
>>>> zS69~>%c@t^u3WzAeq-|W%WoK5ysp+*x7sda7av-{fw#JG-
>>>> TMHXTV8%=`E0{5)E#$L
>>>> zE-ahNt@?CH`5g=Im_OT43-
>>>> 6eBr@S=OJ#))T@2udp#ov3^*>YPOPglj$jq!AAJXOjr
>>>> z-=C)2-NU-C^Jm6ySU$7<oK%yitIIj#*-
>>>> 5QpN<Q|+|4ciLC(219R(7uSzxAIvaQpl3
>>>> zQXY7qdQDYzZEaOU-
>>>> Tli~ud1q9R##I$`3B=YI<Btv6GmM_!|Dd(dcNhS+_8F{QMYRK
>>>> z`ump|57a%dy5T|TC#oBE)!8Y=JtecJY`lKuM#ETa-
>>>> ^p#`@=bM;y@~tkb?X}Beq#y;
>>>> zMDAEvMuxGt481;OqvGH2-!KP;IWWwDVGay)V3-5L92n-
>>>> ne|HYBf6MyQ^c=-LNB%xx
>>>> z{cr!rjxIKav!8)KJO3w61-
>>>> rl>{XhF{|5JZXeWBa&*arg?x<^<U|Bncc1LxdF-(Wm{
>>>>
>> z=zTw}@pS~*a4LTeTqoTTpZE9AQ;ys7BD;^6^&GwO*@iOkzdd^yfa|=
>>>> `tc@#dJ{<`7
>>>>
>> zpcC+6g0;EGH<ClaR=@`iNmv0N?EJ;#tNCnxXQQObn83T89GD397+Dj
>>>> nAQ6g1Y?FM$
>>>> z+B|C=-
>>>>
>> rDJ5BPQ1|bCh+k@Hm?lB|yY+Po&Vwf0TTmwdu(U5OLPyv&%P=f7n#rH
>>>> -b|(
>>>>
>> zxDE~yaWfzMtGI6Bz)K{ir&nLnrwESg1ji+Jdi#omba@`bb9AK24i*l
>>>> y?S}Vg+jSqX
>>>> zZ9-
>>>>
>> EDWewW88~95(y!``klyZp2WFrk}fKB=>6WJ)*q*T3cia(bPd}m~XK{c
>>>> BfWJ7@*
>>>> zOz^X5#kBaO2N2C{>)z)IXl(dmhI&q=+lN{PA4rx>zp~-
>>>> Cl6tMW9(Z|#YHj2Y)!jTF
>>>> zTIvc+V?&&e%^msa_5tZ?HVg{y^i+Rm&S?AK8Jifb!_)S=G1j{b-
>>>> ZgR{{wy0PEIQV3
>>>>
>> zu#AIdkJG+y&{k_B1)J_KZFUYf9}YFkCOi68HZvOp_DGs!9RfIzIK@s
>>>> A3hmTA*-l;4
>>>> z?Nt95n}hwgzZ6Lbc6LC&bMSLfiX2q>ZU}km-w@`fkJ(%}L-
>>>> JnWKA+7Q$gTH(v*}4T
>>>> zc}YM83A7-aUZl)lQ6|a;_8_zdq2I}8qjRfl-
>>>> j<DDZF*LH37a`}J;(;YpvZ6M9NtSC
>>>>
>> zo%R*bp3<mBzxX?Amo0t%MK<=d(U&#p$TWSZZedd+@Q?v(lOMRI>uIb
>>>> JY;ji<u%T2A
>>>> zm`Oj&W?b1ID)(|ZfkbA)S9vGFRs0-
>>>> ESEruokqt1K`HhCH9K6(d*4SWZvYAj@mz$|L
>>>>
>> zWTkj#DCITDcQ&0m@MHtA1{{rgk{1ly<)v>5fI%Jj!(k!HId#UsE4Ag
>>>> JE~OSQ4(-j5
>>>>
>> z4oz*)%vkO}6tBZ4V8noNKpDF9w`>}>Hf3_pm{wM>k&|uab0_nIJ*SX
>>>> U^u}Y{cb?3T
>>>> z^i;9o_aySJ-
>>>>
>> ?E@fV?$^a{aBD(wrK%*9jR>Qi}SIsj7`nSk$Xw|gO>;_X@{a6va!4U
>>>> z-
>>>>
>> `dLCwQo1DiMYO*jcO(vE7_E49dPonIsXP^!(<blY^2Vg!vPlZPCn6`n
>>>> @WF`6%a(=
>>>> z^3&9H)obJ*kugZX6AmX>8-
>>>> I>K$H}bbTsb@_aw&Z_lqTyrE%LJg8V5GzJDUMzLzC!L
>>>> z3AXW1z@`n}2nQ#(ap;lFieA|a-rPB@#aQ6$eVzM=E}QsW-
>>>> d}KUm<F5W&Dbxw4_f)U
>>>>
>> z*V)MA$fxvSKVQ<#j(?_X6danN(5+gFPTv^rl3q?H?)I^n7oC(LGReV
>>>> ~_iUHIJnirr
>>>> znARrxuc@^k2G+0P=`VoqV-
>>>> vIR`g)a+%7*NEHi3HO{b~Ba$0lEC*Bs^Mox7gHXx@pE
>>>> z&*4~Um+-)6*t|w&QjvjrIWWSe-F}+-
>>>> 4}QlFu=}YeaNy4jABRo5c+NM~S~kjhrC&!t
>>>> zm+!-7$4}z$<-
>>>>
>> mY!W|L>B7eyEJAp;Tm*&v_I;=6rg*?f#FR8wF2dGJOr;Q{Tm<&F0I
>>>>
>> zE#;++LFkr4ZGPx}Dq^(wkQ3e2JFAp~e!s+q$^j|KYg5{ph%xu#MChv
>>>> F-Tg{G_NYo~
>>>> zIjoY-?0^?Rc(E5aPt(VJY-
>>>> l&B^FwIk5aF?ia<y!w{I|po!Ba>6uGIf74x6i34V$bl
>>>>
>> z(3i5=T4b&hn9|;$99U<=c%we%_Qq9t6>^};r>oRQg!UBG;U8soY>np
>>>> $Z~ddt3GiUx
>>>> z0K22#?Zbz12+6WJY;b*(cFF-
>>>> H@P_}wh9QS_!~ctW(a9WQ>8R&k<ZvSNiwtHTpH6U#
>>>>
>> ztnlacY&Hgu3roKQ>5~(qB0oFCwPD5dUJjzY$3gLdaV0b;WRgRJR{QS
>>>> )4u?%RG?o=^
>>>>
>> z<X#~kazC4UHUQVJfY<m7)_Z9idc52NEd`|2y2jxuTi1se6Y$#JC^*Q
>>>> z8KUQc?zj#b
>>>>
>> zIJl_X94^h9BZo`RiSDq<McsjClT_=GG;B|*_yy`XhsxnAn>X1|DE+g
>>>> K_hN@<VP_=Y
>>>> z#(#9beMs|rArJVt`VYiU<GGQ8_tK`XSaq|IG0Fs0Ai(oX;Qkc-
>>>> %~!crQ}i!E7Dx{&
>>>> zRea)Qc<|TI;>dMJlFBZjOaXL?jF`z<i|ZC_0%-
>>>> }CLe4$tKp!>&o$VE!CkI5?#99e&
>>>>
>> zI_25YE!ZWsMSD_Ud4Ods^YzNRlH<2_8%yl_E61<q{ZR_Cyri+$p+(B
>>>> ~m$76^_sT)g
>>>> z!<5TjGOgF)i(PIYfRD|OOlx!a4ES)UAS-
>>>> Z)1IKcB^6<mz91($HU*s_2J<xVy>lFAl
>>>>
>> zHVkhLymd!nKu^cE(Z`1_&+WR7{yz(E4(ml{MzA5eFn@Dbwkzu!Q4XH
>>>> ?6U`#6zOk?v
>>>> zy>v1O`Q2HvNe-kio{Gd@`ym^#<q(t~zk+cTQ<^$-
>>>> 9ePA5EBL|mX8f=yGJXU7lTN<W
>>>>
>> z(}72Rky5!8rP(Ue!&PeAVz1~w8T%#Z3DM6Sl&JXW3QwVIPA+0IYf-
>>>> +cIKjOfwlZjo
>>>>
>> zdOb0a3G9zR|2*W(u?g1ZRu0%Z!GKOBX;V4eQg6x_D3*JzUO~I24wTD
>>>> %HM+^5U-5f-
>>>>
>> z?1OFxI%)HnGRiA_SH`XN{A*~7_I<e%)IIW^v9k*q<FKKB*HP@h_&<v
>>>> K2={XE!tS%f
>>>>
>> zA@xq1by)aD<Zvtp?(?zr9MH}k&}ZKZ<xd{pAU54TP@EX92JSN)uBUA
>>>> FuaHqA+E%Xo
>>>>
>> z2O9DTG$!p($tpwc(Pfot(7O_zO@b;(J0jj4osmELPEUk`9+5+jbgGS
>>>> qdm<bF@ujtO
>>>>
>> zs!RKOA{_ScrS9qsX6)^eL!QEeSCk4l?Ep6I7&tsH?XlZ5poc_O?L+h
>>>> `Jd-i5&GUB>
>>>> z-
>>>>
>> 6r!M`a@;h+PxJWcrw_WNq@12c`SXrrDtm*<<!`z;N!smn5k9j;T|L1p
>>>> PRKY5BoFL
>>>>
>> zdmVfNw^!<xagcc%`muxq>=Ix{Xe+_5Eaq?u<Bsu|GZlH_AW2D==d1T
>>>> yWnHSd)0O-6
>>>> z9x3ZeYVO>Z6YSy8Zn%9ffjBrM(*AW7+W<^0&EMJH!(qp*5-
>>>> d*l`jOY>rSt*1aPQWP
>>>> zkR0&WImG4!F-
>>>>
>> l7t6o|#L$JjaA>`^K+5t{L>`vVPNCkY^O#fIvzqO789FS=@Q*=Glr
>>>>
>> zwe5@dKPaOj?tlk9(1kBO4WVl+$R+@nI?!609T4Bm%G2X{ylc|4&n!h
>>>> Ys=r|NDodV=
>>>>
>> zPsrgC$=?gFhUQ<XTkM1J5}@L6iRwn~0y3`~ETfiu#_9V3<p>P7R^tG
>>>> h=4bw*nKM<8
>>>>
>> z13D@xQzbT+2XnsOK%aY6dR})nI);yc1j;My&QIIeBhL{TbCYlDQvT{
>>>> L<zDif%E;@E
>>>> zHhqD)a$dI&+SSRtZfS!rn#W;9Ik1@5-
>>>> A>w0syyU<?dERJEw^`hq&$~#DzEzu?1&un
>>>> ziZI3`y<nwTUThjRc)-Sd-
>>>> {SXxJr`RoKEzLx?LZ|a^ogwuo>oP{*Hn?f`Y7{iQ*@4d
>>>>
>> zek_8XvxA0Ydu7grFt<`RFp4tBzFkhuk7*oGl6(Vwm_++!9?LxIpwl;
>>>> U*dubOZ@O)l
>>>>
>> zv%OQO`vi8|#C|BBtQGh>$J77v>;aFKqdMfU)8O|v%6p+p@DWf7y>Za
>>>> N`DNyk((VCY
>>>>
>> z=Ee9%|ADqMfDW|kvn)IECU#l;896lE$)>;7PNSuDsvIH_zal%l9-
>>>> C1ahdGYap|K~P
>>>>
>> zmnnJ7GlB$D6nps<%A42}hi^e>)09o4*dyVK(04a&b5VB;?UQF#r}|<
>>>> 4YaI65^o_ul
>>>> zLrVrSF6G`N&#7}>-
>>>> p6_NkJRbs2|RajiGKtQ1fP>Yb6MVz$OTF%TkcO&-{G-5zcL8k
>>>> zw=Ej7!yh7*z&#Qy#<4X{pozggX%_a&!7sW|c>EQ3taGpp-
>>>> !gnCGppqgd^KtRb-;X#
>>>> zKqaDUE`d{0;e}NnS%cn#8bNNPUmdx@-
>>>> tRobxSvUSg7mOH)*9dKL&m*~7wOx^-)-rN
>>>>
>> zG7pV14>go}%)eq<uK~{o+VH~uWNS<e1j&*4ntkw$;HUT$1VHu5p)HJ
>>>> Dcr<j1--Nt~
>>>> zKk2PS{?(Df?is+05<oB>xWaoLU+iz)YP!gdL-
>>>> TBCzSor<z_zybQva}?`>wQ$jA!LB
>>>> z-<Pql#vThxhVq5+C47mxa=ao-
>>>> 4$mEa30_;qt_%Ma`bx_E4!lmeF*2sorBCc~1S+)J
>>>>
>> za|dN+u*PyX{q`2RH>eMcEvM}B@Suq`0jCc0y4H3A{RltmXtz~|ARs~
>>>> V968@bzEge%
>>>>
>> z<sJSzhj9ji``C8Fq0<gPqlGo#Irv+^Uuo$#bZm5dcLlWi66ePl8wZ&
>>>> e#G)2ovcvc+
>>>> z$dvL{^Ug!Q#V2@LLffa&7mc?4*x5?TIz-3&*$R;v33m3-<-
>>>> T!8+YaM9=_}f?EBJ2*
>>>>
>> zO3^>1tZPXyJIYyWKqcgR$oEVUy!lu7xuQ28!gmwh+e8pEKVur)_4H?
>>>> @tV!92BD1`g
>>>>
>> zC}WL#{7qBVnW(2TW*zx;g0=|_B`Pss^4?U5MFs&@jbyGgRTObu>0=8
>>>> {<U4H1mftKg
>>>>
>> zlq$Mc@NC)AWz#&1K2t5wa@=F!|1rlGeEGyuONP!;%E@|W*%Y&=<~E~
>>>> HiLXi-Iou|G
>>>> z@ebP16wjA6hQW5W3_5GntUxWWw*%XE+-
>>>> Q+CHAVe8;1silaGLt&#);1hJ$~q@!3UN1
>>>>
>> z0{@D(*lPmbk3zfju|vBjUA1^9KaHRw9$+j5S1Gt;9i(`QDzeKZ28ua
>>>> +Dm=(X?^>x}
>>>> z6-
>>>>
>> g>{6Vau@+h)z*xhYxvo`D0N*l&EI`25$>4a(9DpP_9<uEc;G{7i%<89
>>>> (jlA6e&+
>>>> z_P)(LdA3V$@uYJ>-
>>>> &g79^VrrtJ*R#f{=f^&iT!Ur+$A*c%SsF_b(=+{^+ur|+Vh}Y
>>>> zTh{)(jNz?G_*@I7x5!~Pk4tO0j}4*{G-
>>>> qGdypWH6uNEIDMP>Bq1PA8cgbsyl99>ae
>>>> zn6sd;MZf*#!dIAAxR9gfRI}sX;p-
>>>> 6&)k)j6I1iLx*4+J_hoFBpV~wb4mV5+t)#C6|
>>>> z?1l7;;BkRR`s;<;stdu_;-N2H@Y?COp<~?+m|`Ei!!IZj-
>>>> !@9WV;_r5;1)9%YUWvS
>>>>
>> zFMV#rQz?5yeAjq6%1j?x#tEEa+j47tl=jcEf(K3qj&|JBBK^0XJ~^b
>>>> Tzy{J21u8I&
>>>>
>> zwzTQv>L=5d#)r3b!QYH70^9j!n?=D<s^vr2DFU%|5a{7ugLyc3_qsF
>>>> -m-r3hSIK(H
>>>>
>> zI&idtOV*z)yx^;PJpcJyu)!6`DP#VwAobLOX)TK2&cRI8q6!I82HsD
>>>> Aw;!jqCgJ!o
>>>>
>> zw$J*E^gnYdc$BFQ44zjF%$K1hY|FuXD|o2{_7=OQvGy)=<ruPgl6mY
>>>> n<}4B*t5@H+
>>>> zYn=GB>9=&tfm5-|qB~Vz-
>>>> *m+~*+lZB|8;f$t}4DwY(Q43bybvI`<brlM0C#Bwmn*^
>>>> zzucEdAfBZvu%0y?@*mWgPl)||aFmLT(-
>>>> zM>bSY_8zDu3+Y{YglCsfD{ddoWk_>yn3
>>>>
>> z1|HG<1Tq+3q0RP}AJR3inw0HD4q0DP%qIry_|SRpV4tJ_`8`~r9u(a
>>>> ta_;C<WU11?
>>>>
>> z4yb5Spcp<^LR%waSIT7NF?VBpHWBElajdLMW_g#>U+w#pW#_(uO?6;
>>>> Np7?y&CvP<{
>>>>
>> z2`af;^z^4JyPM_hA{AHyV*@a3ooKJEl`uX%_&UwlEDtu0=YwJ|Xq#n
>>>> 6ME)ZLFu%0<
>>>> zZ~G6KOMi-NS@Tc&P6BzFto5CupTz$VA6VA&B8(N=SI-
>>>> KU#%U5cvBsk%OFxSH!~+5K
>>>>
>> z4iX5jU%%lGiyXI&%H1dd9tAc&{BD&X>uUt2DP7z(9z4=^@h^`!{7fG
>>>> aID<dWJiRp^
>>>> ze#(3{0(~Nb8a7dA;5$U@DBq`ou9Bis_-&$lJmiU-319PhmU%-
>>>> K^$2vw0dVV^pEo#B
>>>>
>> z3w(vPNZ*TWN>C^XvMl*!&=S1dH@#oqSOIwK;Cz=h+X1<pHB8~%c-
>>>> rEFM-|W`YX&ke
>>>> z6+A)ua|*De?LP1ax2ZrHWhH%u)DI3>)3m=exx7+-
>>>> 4Kzvr+I?#WgQA_~PruVQu9<nw
>>>>
>> z;Q8>kWAKb1<^sRk;+a1)8T^{)S!_=;<LT$z3%qymb3|STubBz|L@xS
>>>> eJib0IbgUE}
>>>> zpclm!pLDg|>)AMAs<cf4-
>>>> |QVH!945$jq<Go_~GBt9>#K}l6F!C`LpD)0DoQhVbUMs
>>>>
>> z?+Sj=Wdq+FY(FhnqXKt=)A2=|c1r$2@`aA}(bBK}T~fx_X$RDE%Gv#
>>>> )vF@kB$Dl>#
>>>>
>> z)oN$eCQrZZnlE&C^;>NJ&*tyZ{f@8YJPSXBPLVNJ`W@(o1C|{@_9~m
>>>> z*_r0J$IGL7
>>>> zu%U*vn1Xdnx{#mDD!z*fABywV@V$*-
>>>> A6xP(bo6mC>ro=hCB_lH)w)(hv)b+z_|&oN
>>>>
>> zk@L+gDOJss0LK#CnDwx7z7=>&jYzK0kZ951M?WU6h>lQ|r}*}B+LeF
>>>> ~aEHqh&dzfC
>>>>
>> z|4;co<xXu{%vvJBv?ig4w)>I;+ZNOm;xD9c+cB}lhaOlB4`*0%u6s|
>>>> y|LX_ci{B%<
>>>>
>> zcxd{U)R{aeU+PJj0`e~56Q|&RACkV2XTEEFl3+$onLP63UQ)OJ`Amz
>>>> (MQZJS)(qWz
>>>>
>> zm){<_n#QyAn*_y@prA6RoCEA+(j}xaMg_+v?B+I}MK6AcR54E!JumO
>>>> 3TY&|S?C;?j
>>>> zIq5W5i<ENk8=0}cyE#0+2fZR~5x-
>>>> yF5v&Xt1NuwkNc2~Q`1hrW0kLxuY(wU6MWo`N
>>>> z{TBQudi!>NmNJ`NvjV@Qjs%^%h#h{7^!t%nEjiF3{VhQ}@?A-
>>>> 1f~+S$wQOUd=(!zy
>>>>
>> z_c^R5*YmBv@>>&B=4oVxaeTmouNIlGrRxUj82CYZC#Z@M(^b*Jye(Z
>>>> GO=~GA6#tX;
>>>> zAcEOw_(vYv_@jr-C!Wqv4DHVvb;H-
>>>> 6NeUUi#s6zj9n~(?g73xhihoyiz0oUcgE7`b
>>>>
>> zk#S4bL{Ajpy9&I$U#1*^ax_B~iO>2IbVjI*^(fXO_kLNvJ&g5wKBYZ
>>>> *J-)*JtUGSl
>>>>
>> z*J5@&oj))1^<p!22tSAKFa)M>r{*N70CRy1nd9?qY}{M=b*bCXB{70
>>>> 1$TySc$y-l5
>>>> z58=N^&=Hx(h>qG@ql>>-
>>>> o{SC*K52FkgrnZa_|fnQzq!KmyreR(Y3Eyu%y(q&T)=u@
>>>> zDfYeqx=#`WtcbSBoc$DY^;68%nPWT_pOftL;J-
>>>> <KuGb3#1q3g9k@Xqmr2G=8pLI*w
>>>> z3-Vd|Q~VT-
>>>>
>> _J4`?o0Ru#l{xOHj%wzx1<aS1Vq5o;r;`W%*ioKE&ut~u8Ly@4LsPAH
>>>>
>> z%oSNnJXnA|E+7?svQ*{U@0ia?`BJr`e5umCR(WGEj2ye%q``UP>^yY
>>>> X0In=MZ%&+!
>>>>
>> z1%uy>wBMP7^U|z5&mz`o!LLD+M~#{)?Gqg+vMOt}&V1VTu^roI`-
>>>> ;D%e}pfxj^_u4
>>>> zV$F=_g9;r#276<@!#*q8BYDo4du3=n-
>>>> aGY@2G^s_cD;c$@@#af_$p%S#P9quus}H7
>>>> z!X;}wtS63U93Vftx@7%N=z|6gew?(|3mHqrCp6v@h-
>>>> )UnJ+g&92mfpFzLq*-C&UMG
>>>> z!6Wg-
>>>>
>> d{PfRBkN8B>wwNT%>f$4FBJLm$yx{f5&WjTZs}9KGvVtl(NoqtXcD+W
>>>> 5A*R^
>>>>
>> zL4r?;?~U)e$F@T@Yz@DLV3x=5jnC}Et~h)w1&6g(K);&65cnqWb!ij
>>>> &#?f_>7jX@m
>>>>
>> zx5w@K8hljumZmNlYdTl;ib)&cOZjQ}_RCnR*;KQ!=9ZE!Y*xL;*p@5
>>>> y&BMBZN9JRc
>>>>
>> zD=5sb&<xGHlzRD;QP{>>;4NKIyRlApx0K$ZD)#mz@f};MK<=m48oIY
>>>> w5wwx9T*Z3N
>>>>
>> zQ_6gBJMal0RgZsJ$=p1nN%j^oeh+`rWzC(3`T<Vx`4VV9e5<Qlba&G
>>>> xW25XXX#?h9
>>>> zzeXkSJ@s*)^*uE@t}WN*fi1fPU$W-
>>>> 8A_soxDK4P?ELS(rozlM!?}XQ^<y6Rez3ios
>>>>
>> zxiLOm<w<1DlW|LTv~PE3wC`|_!CIhluY1mr_46#|1ai;5H3yFMZTAD
>>>> vg5OkG!n`S3
>>>> z)iwZ^ptQ2@?cHb-
>>>> x_&*VE$?1`<9pVZz&8TpU*a$#;5TL7rtCVhhv+0aP|KXqeTp`h
>>>>
>> zN}FG?X=BVhCf^ve%)I_~+B_bxpZx)~nGgTIfZ93u5@K)tx*bsa1$2R
>>>> |OUSy<9}`gf
>>>>
>> zC}Y_kN4DM~$kzu8njJ~GB4{?_r~I&6{DOgR^`d{o=NB8JWPc$)`fwB
>>>> ;+Vcw5-6d~&
>>>> zTHw3nbz+OoA+J*ZU4w6z-
>>>> tex$w|lAQV?J@zw$tLj_kR=fK+|7YG}+%D#7B|66X*&2
>>>> z$KM}(`#yL*H25|?$5p|%KS$os;M<=j&uU*ZEg*G-
>>>> $BwO#HGF7B|Fo6+Cj}dvF=v(c
>>>> zjkfk6Y=kF1=y%43&>Ljj4F~2H9c}mLy9MSp#Fm-
>>>> rT?2DF@7^siw?}LdI!@-*&7=ju
>>>> zFqgywb929xzF;4-
>>>> 9hjSEzCl>BUMGEoZg2u~J2=EH4i3z13SGX!s{(UBboH1C%b0n;
>>>> zz}%*5I54-
>>>>
>> uCJhJX9uCYs9GLr$56ry<dpkHVxA?ljf)5y&`_<9EKQK3C`t4pkF!#~
>>>> n
>>>>
>> zz}z1!F!#=MD=_y4=58&lzYx*2)xg%soXYn;fw{GG_HGb}R!g_fi-
>>>>> Pw^b~cg-UoLX
>>>> zJ=a<L-
>>>>
>> DMsi`R54Y%X)8XQ0BI0i>SADmq$JHoObrQZbN5ZA^yg1@KdB5Yf7ztD
>>>> F-Z%
>>>>
>> zTK1d<EGbh>nUn8Yrt*q1|3;bfz+r)>m5oy2s4LSBz)kuqd>wiI4^oR
>>>> (wdpyBRv$Qe
>>>> zsP_-
>>>>
>> @4qPw8hs%^bhQBNMFUIr#k^Bt!BxU|7UIt%t+#eczd;vd{;RGMwz`YZ
>>>> EoIb!`
>>>> z+s{5m*~7=W59>t2!wZ6Ivx-
>>>> e9zqR|{o9^v;Wt%$Z!+&_?33X0mo?zvx1v7hTx6r0h
>>>> z?yo1RbeZ2?-
>>>>
>> fW%s*e&(X@?JUb3skzyPvz3Me(@+jZ~*WB4P3f;YxhL1Q(w*qxtW6`
>>>> z0Podt>Fh<%XFW{?_@T0{U$mGp*-
>>>> Ld;$$r)e;ql1OVfI*^Y`H6>nG?DTxK3v+4!M{w
>>>>
>> zxyv~>^eB7ML{3;EeRZ53`enW=^sA4!L%+E(A@usJ#L(}GlR{_bCx?3
>>>> O96=E4l+c@1
>>>> zsiEHc(?S<lj|{!@`B9<FlEUtuCKdYyG_bB0NN25g^p>iw^xV<m-
>>>> *vds|7rP}!vD|;
>>>>
>> zXSG~X>AzV%zGC&l6}>;+VbhpSTW;dYq%Fr^%m{V*RcyX)ezQ&En~zp
>>>> };w9P-Uv@Ev
>>>> zjUD4&cxFGhosc#K>3<1E{{_+lYp$;c-Y*!vl-
>>>> *2O7yLGlPv|xYP%q!eWM6GFw6g!U
>>>>
>> zMfz1_bvxz8QBHT8vCGUWO6dbr<)4uE1@smB5zdtQ{d=tax5=#iasI=
>>>> Trt{sny4RrG
>>>> zJie(!$Y*>V61=SCwnoyl-
>>>> pj5OYp>><H&y!6Zz*ufk7gBiyDqnNx}t}BN|h_6jlJm+
>>>>
>> z<fz$Q*2`YP6wWWz%h@G=M7<>VHOd>GTij)&ncsBiVZ8yGv@_<;ZPpL
>>>> y2#x)DMt@%U
>>>> zVb%a-
>>>>
>> Z9#jdYR3_NKvdtN?Pw<zIQj3i?T}RF^b#2T@8Q9IF6MGFXM(rdG5R79
>>>> pe?>c
>>>>
>> z^QDtD#<4K>=PQovcjhWmSJoZ&P;YP@_|U4*Pf9)foQmrwr;g~PCTQ{
>>>> ?<0B@Up%G?I
>>>>
>> zx0h?QSrQseFzqQ^8Iwvwcae@zx!oxrD+{HR<aMW(=X9q{pA$+ma=Jg
>>>> xHR_hRp-}|w
>>>>
>> z9=$K8JAKZ)&|>le$Eh=UerVzG@!c!9Miwpzja)}rpTJ)j8hsb=xiTi
>>>> *7P?8wMsm7S
>>>> zmYA`WuZ{0cow6wO(XzbmMO-
>>>> 5bKNT8Dx{7PGc}HmUl)UaKi}Ng98cpJdgGOti|IGLi
>>>>
>> zzDJWx;FJKTlyO+bIGn>coXa?z$2gqNI9$LuT*x@Qjd6H8<8Tq<@Kd3
>>>> 8n#@>UNly1W
>>>>
>> zpT8p{a0oz+UXiu4HuOAuD;X>2T2!oO8#?C)cZD(;`|0R`o478ZCkOw
>>>> qLWFM$m&p5|
>>>>
>> zKdf+&@(F`}SRur7l(Dk?=W5N+A69slck;su&oGwTS?B%#;fEDoAh`Z
>>>> Nx>Wi<j!`X9
>>>>
>> z*NE_B>~LwqZ7tfQqkGs_vWvYG=lC8`nSxx(T9BrSx>@_)RmxelNmI(
>>>> Y9!Zbf`$gmX
>>>>
>> zx#^zo=PuMnct5;yWJQMOXs%_4wfqyejZgvkA(v&W>E#1M@&%6c;}49
>>>> ZxgXV%ytnhC
>>>> z53i|=dd{v?-
>>>>
>> k_zQDJA6`(768h4`2OWejuU${idtmpW^)u&{~F`Sdpw=Vys)w+v3k+
>>>> zKmRBHpu}Gwqsi<&OXBMPaf#XJ^VuqfU6${w{XZ_j^I0RR6-
>>>> l4ztmA#4ADRGG{|`+>
>>>>
>> zOa3%JGyx8Ll!HQ_XAllq18x8B@<S7mnFBvGVa^)(p@|6hgMMh@%gFP
>>>> 8jUSpAHSj|d
>>>> ztO;of-
>>>>
>> (l~B_zz7?i2u;UgzkYKnz;3SerRIA&lg)?rT+9k8sXsa<DY2pAEuD?X
>>>> OaE?
>>>>
>> z5kDxAl{x%_5`2UE68&F2{DTtK{t}I|t;0VkAwT+O|8R)x=P&s$@PiT
>>>> s_?z;*c=!h;
>>>>
>> z)bQUh2ZlNDUx)+eF3Q>WYxnokHOBup*BJj}*XV}^oE~3$joW|MHO7C
>>>> _HO8NEjr+fE
>>>> zj;s5MZwGg(bJ4QC%2%q?xd^GO-
>>>> ~BrFr_&J*{+A@+J!|kDuIQr~p;LT6V2_b?9-IAi
>>>>
>> zfzP~!50xfoLsaFx|3O*S6WEg*jy9Rk>8#tA@XbN?^qgk>Kd2X<c=ZG
>>>> JtAqb<eh>bl
>>>>
>> zLHK8X0Q@ih0r=bhg#2~J`Fo{K`}@BgN&ioa_dluh|MEW}eGY!~!29<
>>>> 9Pv0Eq|DXNt
>>>> z_xFG8AHaW+fAqln;_n!Q|Jxq`|C~PnzvoZL-
>>>> }mZwC;yN9!H2@3Klq^3jW)=|PQb``
>>>> zdN!Uq`9AxZwLrF^YN|l-g_6Hom!01mPi<gV|G(xv-XD+WzZg&R-
>>>> lN>r5I<N>B8zzP
>>>> z_qwv_OqsjrCZlovnl-B%)-
>>>> @U>B@H#pW={Y3>QyTr{DiUC`uPl_v2LBQl;6pyHSSwk
>>>> zeZNswxuk009c7E|o-
>>>> ?<qq@=uT!L+GW<#Xp(7@stz5cIBe(X^Z5k^1LaG2WN2TE1?1
>>>> z^~&X&Bq)Ew`c><eKTrqEh7HSW>g<UA3s-
>>>> I6eeG2*YwH?o8kVnFCxPPEq^RnK2db)}
>>>> zuc~oFjcQz1Yo#f7ud3U)rmkik;r*-cyHAik$gcw2x7ui2SG}%I-
>>>> J+|65ve0@${sVe
>>>>
>> zxOj9%adGj7a)@U^I1}BSI5v5#{H3JvU&h$cDGnj)svGX7(Q8(JzOKP
>>>> oS+}8XrEwob
>>>>
>> zG_G%4Q@5(tSiPpMp?V!r?Nihr_iF&4|9rX4|K@nw5>LMpPut=t?X!N
>>>> -facBJxUQ~Y
>>>>
>> zRrN}vWGS6Rbo`pS<r~Ofy^1jR5*@#KoiTUOG!G&5jk=9Bb!&t~id8q
>>>> RUiHcA*Bgxw
>>>>
>> zuBvTV{XpF(rSwWd<=cP8m8mTr9DVEmGvjx~LsCoLuP$e0Q}oKz;<*j
>>>> LjKldrNlL?-
>>>> z<<n*x3s=$hhV^S`_UiT0*Zf2PZT$po{jc^*19rPl-
>>>> (~l&)5w2GwV&N?`~BJY`^q#s
>>>>
>> ze`7qIa(r}&)Hyr#%K8qR$<yq7GoCv6U;VJ1U;7a|ofJ=<_rvKh2ZlK
>>>> ?%z<GJ40B+Z
>>>> z1H&8`=D;uq{yT9%V?(HT)@*RK{+u5ia8iHR_KW-
>>>> HD+lans@Z?f4taL+<EibnzsnB~
>>>> F{9hQUX+r=2
>>>>
>>>> literal 0
>>>> HcmV?d00001
>>>>
>>>> --
>>>> 2.17.0.windows.1
>>>>
>>>> _______________________________________________
>>>> edk2-devel mailing list
>>>> edk2-devel@lists.01.org
>>>> https://lists.01.org/mailman/listinfo/edk2-devel
> 



^ permalink raw reply	[flat|nested] 34+ messages in thread

* Re: [PATCH v5 edk2-platforms 18/22] Platform/RaspberryPi/RPi3 *NON-OSI*: Add ATF binaries
  2019-02-07 11:26         ` Pete Batard
@ 2019-02-07 14:25           ` Ard Biesheuvel
  0 siblings, 0 replies; 34+ messages in thread
From: Ard Biesheuvel @ 2019-02-07 14:25 UTC (permalink / raw)
  To: Pete Batard
  Cc: Kinney, Michael D, edk2-devel@lists.01.org,
	leif.lindholm@linaro.org

On Thu, 7 Feb 2019 at 12:35, Pete Batard <pete@akeo.ie> wrote:
>
> On 2019.02.07 02:35, Kinney, Michael D wrote:
> > Hi Pete,
> >
> > When I saw it as a single patch series, I did assume all the
> > patches were for the edk2-platforms repo.  And it looked like
> > non-OSI binaries were going into the edk2-platforms repo.
> >
> > Patch #0 did not make this clear either that multiple repos
> > were targeted.
> >
> > I have not seen a patch series with content for multiple repos.
>
> Well, new ways of doing things have to be introduced sometimes and, to
> make things a lot more convenient for people who submit work (and
> others), I would pressure the edk2 mailing list to accept this kind of
> multiple edk2-platforms + edk2-non-osi patchset submission *for new
> platforms*, where content that is aimed at non-osi is simply tagged
> *NON-OSI* rather than split into 2 separate patchsets. As a global
> timesaver (since it also makes review of a newly introduced platform
> easier IMO, by not risking people to miss the separately submitted
> non-osi content), it does make a lot of sense to me to do it this way,
> rather than enforce a rigid approach.
>
> It also makes life simpler for people who simply want to test (rather
> than review), as they can just apply the full patchset onto their local
> edk2-platforms repo in one breadth, rather than have to hunt and apply
> from 2 different sets. To me, the advantages of doing things in this
> fashion largely outweigh any potential drawback.
>
> > It would be clearer if there were 2 different series.  One for
> > edk2-platforms repo and one for the edk2-non-osi repo.
>
> I'm not planning to resubmit a new patchset just to split between osi
> and non-osi at this stage.
>
> If I hear a lot of backlash, and there is need for a v6, I may split it,
> but I really think this approach of submitting brand new content to
> non-osi, by simply tagging it *NON-OSI* on the subject line, should be
> deemed as an acceptable way to introduce the non-osi content for a new
> platforms.
>

The subject is

[PATCH v5 edk2-platforms 18/22] Platform/RaspberryPi/RPi3 *NON-OSI*:
Add ATF binaries

so it does seem like you are proposing non-osi content to go into
edk2-platforms. Patches
for edk2-non-osi are usually described as

[PATCH vN edk2-non-osi #/#] ...

Your current arrangement also results in a need for me to go and edit
the commit log by hand when I apply the patch, since the part in [] is
stripped by git am, but the rest remains.

Since all changes go to the same list, I don't think it is necessary
to mandate that patches that target different repositories are split
into different series, and I take your point about being to apply
patches, and having the ability to easily figure it which parts belong
together.

So in case there turns out to be a need for a v6, please update the
subjects, but otherwise, we can work with what has been posted to the
list.

Thanks,
Ard.


^ permalink raw reply	[flat|nested] 34+ messages in thread

* Re: [PATCH v5 edk2-platforms 00/22] Platform/RaspberryPi: Add Raspberry Pi 3 support
  2019-02-05 16:25 [PATCH v5 edk2-platforms 00/22] Platform/RaspberryPi: Add Raspberry Pi 3 support Pete Batard
                   ` (21 preceding siblings ...)
  2019-02-05 16:25 ` [PATCH v5 edk2-platforms 22/22] Platform/RaspberryPi/RPi3: Add platform readme's Pete Batard
@ 2019-02-13  3:41 ` Jeremy Linton
  2019-02-15 10:27   ` Ard Biesheuvel
  2019-02-14 18:45 ` Leif Lindholm
  23 siblings, 1 reply; 34+ messages in thread
From: Jeremy Linton @ 2019-02-13  3:41 UTC (permalink / raw)
  To: Pete Batard, edk2-devel

the
Hi,

On 2/5/19 10:25 AM, Pete Batard wrote:
> Changes for v5:
> 
> * Raspberry/Pi3 -> RaspberryPi/RPi3
> * Remove VirtualRealTimeClockLib as well as BUILD_EPOCH macro (use the upcoming
>    EmbeddedPkg Virtual RTC from EDK2 instead)
> * Use $(PLATFORM_NAME) where possible in .dsc and .fdf
> * Update Readme to remove build instructions, describe ACPI limitations, fix
>    ATF Readme link and split OS installation & test notes into a separate file.
> * Add -Wl,--fix-cortex-a53-843419 to LINK_FLAGS
> 
> IMPORTANT: Due to the removal of VirtualRealTimeClockLib this series requires
> https://lists.01.org/pipermail/edk2-devel/2019-February/036301.html to have
> been applied to your edk2 repository.

I would just like to congratulate everyone working on this port. It is 
crazy awesome! I just applied these patches, followed the readme 
instructions for the SD card. Then grabbed a USB DVD drive, and a USB 
SSD, plugged in a keyboard/mouse/monitor/network and booted the fedora 
29 1.2 install ISO. The graphical installer ran as expected, system 
installed as expected, and other than the nextboot not being reset (had 
to update it via the BDS, as is documented) it "just worked".

There are a few rough edges here/there but the idea that we have another 
ARM machine that almost behaves like one expects a modern computing 
device to behave, is wonderful. The only real gocha continues to be the 
rpi's well known shortcomings, including the fact that it took nearly 6 
hours to install.


so,

Tested-by: Jeremy Linton <jeremy.linton@arm.com>




> 
> Regards,
> 
> /Pete
> 
> 
> Pete Batard (22):
>    Silicon/Broadcom/Bcm283x: Add interrupt driver
>    Silicon/Broadcom/Bcm283x: Add GpioLib
>    Platform/RaspberryPi/RPi3: Add ACPI tables
>    Platform/RaspberryPi/RPi3: Add reset and memory init libraries
>    Platform/RaspberryPi/RPi3: Add platform library
>    Platform/RaspberryPi/RPi3: Add firmware driver
>    Platform/RaspberryPi/RPi3: Add platform config driver
>    Platform/RaspberryPi/RPi3: Add SMBIOS driver
>    Platform/RaspberryPi/RPi3: Add display driver
>    Platform/RaspberryPi/RPi3: Add console driver
>    Platform/RaspberryPi/RPi3: Add NV storage driver
>    Platform/RaspberryPi/RPi3: Add Device Tree driver
>    Platform/RaspberryPi/RPi3: Add base MMC driver
>    Platform/RaspberryPi/RPi3: Add Arasan MMC driver
>    Platform/RaspberryPi/RPi3: Add SD Host driver
>    Platform/RaspberryPi/RPi3: Add platform boot manager and helper libs
>    Platform/RaspberryPi/RPi3: Add USB host driver
>    Platform/RaspberryPi/RPi3 *NON-OSI*: Add ATF binaries
>    Platform/RaspberryPi/RPi3 *NON-OSI*: Add Device Tree binaries
>    Platform/RaspberryPi/RPi3 *NON-OSI*: Add logo driver
>    Platform/RaspberryPi/RPi3: Add platform
>    Platform/RaspberryPi/RPi3: Add platform readme's
> 
>   .../RaspberryPi/RPi3/AcpiTables/AcpiTables.h  |   82 +
>   .../RPi3/AcpiTables/AcpiTables.inf            |   46 +
>   .../RaspberryPi/RPi3/AcpiTables/Csrt.aslc     |  332 +++
>   .../RaspberryPi/RPi3/AcpiTables/Dbg2.aslc     |   34 +
>   Platform/RaspberryPi/RPi3/AcpiTables/Dsdt.asl |  511 +++++
>   .../RaspberryPi/RPi3/AcpiTables/Fadt.aslc     |   52 +
>   .../RaspberryPi/RPi3/AcpiTables/Gtdt.aslc     |   33 +
>   .../RaspberryPi/RPi3/AcpiTables/Madt.aslc     |   62 +
>   Platform/RaspberryPi/RPi3/AcpiTables/Pep.asl  |   95 +
>   Platform/RaspberryPi/RPi3/AcpiTables/Pep.c    |   84 +
>   Platform/RaspberryPi/RPi3/AcpiTables/Pep.h    |  126 ++
>   Platform/RaspberryPi/RPi3/AcpiTables/Rhpx.asl |  201 ++
>   Platform/RaspberryPi/RPi3/AcpiTables/Sdhc.asl |  105 +
>   Platform/RaspberryPi/RPi3/AcpiTables/Spcr.asl |   53 +
>   Platform/RaspberryPi/RPi3/AcpiTables/Uart.asl |  158 ++
>   .../RaspberryPi/RPi3/DeviceTree/License.txt   |  340 +++
>   .../RPi3/DeviceTree/bcm2710-rpi-3-b-plus.dtb  |  Bin 0 -> 25617 bytes
>   .../RPi3/DeviceTree/bcm2710-rpi-3-b-plus.dts  | 1263 ++++++++++++
>   .../RPi3/DeviceTree/bcm2710-rpi-3-b.dtb       |  Bin 0 -> 25354 bytes
>   .../RPi3/DeviceTree/bcm2710-rpi-3-b.dts       | 1259 +++++++++++
>   .../ArasanMmcHostDxe/ArasanMmcHostDxe.c       |  723 +++++++
>   .../ArasanMmcHostDxe/ArasanMmcHostDxe.h       |   50 +
>   .../ArasanMmcHostDxe/ArasanMmcHostDxe.inf     |   52 +
>   .../RPi3/Drivers/ConfigDxe/ConfigDxe.c        |  351 ++++
>   .../RPi3/Drivers/ConfigDxe/ConfigDxe.inf      |   78 +
>   .../Drivers/ConfigDxe/ConfigDxeFormSetGuid.h  |   23 +
>   .../RPi3/Drivers/ConfigDxe/ConfigDxeHii.uni   |  100 +
>   .../RPi3/Drivers/ConfigDxe/ConfigDxeHii.vfr   |  306 +++
>   .../RPi3/Drivers/DisplayDxe/ComponentName.c   |  222 ++
>   .../RPi3/Drivers/DisplayDxe/DisplayDxe.c      |  606 ++++++
>   .../RPi3/Drivers/DisplayDxe/DisplayDxe.h      |   42 +
>   .../RPi3/Drivers/DisplayDxe/DisplayDxe.inf    |   71 +
>   .../RPi3/Drivers/DisplayDxe/Screenshot.c      |  375 ++++
>   .../RPi3/Drivers/DwUsbHostDxe/ComponentName.c |  225 ++
>   .../RPi3/Drivers/DwUsbHostDxe/DriverBinding.c |  274 +++
>   .../RPi3/Drivers/DwUsbHostDxe/DwUsbHostDxe.c  | 1635 +++++++++++++++
>   .../RPi3/Drivers/DwUsbHostDxe/DwUsbHostDxe.h  |  162 ++
>   .../Drivers/DwUsbHostDxe/DwUsbHostDxe.inf     |   59 +
>   .../RPi3/Drivers/DwUsbHostDxe/DwcHw.h         |  788 +++++++
>   .../RaspberryPi/RPi3/Drivers/FdtDxe/FdtDxe.c  |  364 ++++
>   .../RPi3/Drivers/FdtDxe/FdtDxe.inf            |   53 +
>   .../GraphicsConsoleDxe/ComponentName.c        |  183 ++
>   .../GraphicsConsoleDxe/GraphicsConsole.c      | 1837 +++++++++++++++++
>   .../GraphicsConsoleDxe/GraphicsConsole.h      |  591 ++++++
>   .../GraphicsConsoleDxe/GraphicsConsoleDxe.inf |   75 +
>   .../GraphicsConsoleDxe/GraphicsConsoleDxe.uni |   18 +
>   .../GraphicsConsoleDxeExtra.uni               |   18 +
>   .../RPi3/Drivers/GraphicsConsoleDxe/NewFont.c |  287 +++
>   .../RPi3/Drivers/LogoDxe/License.txt          |   10 +
>   .../RaspberryPi/RPi3/Drivers/LogoDxe/Logo.bmp |  Bin 0 -> 185398 bytes
>   .../RaspberryPi/RPi3/Drivers/LogoDxe/Logo.c   |  159 ++
>   .../RaspberryPi/RPi3/Drivers/LogoDxe/Logo.eps |  Bin 0 -> 250982 bytes
>   .../RaspberryPi/RPi3/Drivers/LogoDxe/Logo.idf |   18 +
>   .../RaspberryPi/RPi3/Drivers/LogoDxe/Logo.inf |   34 +
>   .../RaspberryPi/RPi3/Drivers/LogoDxe/Logo.uni |   20 +
>   .../RPi3/Drivers/LogoDxe/LogoDxe.inf          |   63 +
>   .../RPi3/Drivers/LogoDxe/LogoDxe.uni          |   19 +
>   .../RPi3/Drivers/LogoDxe/LogoDxeExtra.uni     |   19 +
>   .../RPi3/Drivers/LogoDxe/LogoExtra.uni        |   19 +
>   .../RPi3/Drivers/MmcDxe/ComponentName.c       |  163 ++
>   .../RPi3/Drivers/MmcDxe/Diagnostics.c         |  263 +++
>   .../RaspberryPi/RPi3/Drivers/MmcDxe/Mmc.c     |  460 +++++
>   .../RaspberryPi/RPi3/Drivers/MmcDxe/Mmc.h     |  533 +++++
>   .../RPi3/Drivers/MmcDxe/MmcBlockIo.c          |  469 +++++
>   .../RPi3/Drivers/MmcDxe/MmcDebug.c            |  170 ++
>   .../RPi3/Drivers/MmcDxe/MmcDxe.inf            |   58 +
>   .../RPi3/Drivers/MmcDxe/MmcIdentification.c   |  980 +++++++++
>   .../PlatformSmbiosDxe/PlatformSmbiosDxe.c     |  903 ++++++++
>   .../PlatformSmbiosDxe/PlatformSmbiosDxe.inf   |   56 +
>   .../Drivers/RpiFirmwareDxe/RpiFirmwareDxe.c   | 1084 ++++++++++
>   .../Drivers/RpiFirmwareDxe/RpiFirmwareDxe.inf |   50 +
>   .../RPi3/Drivers/SdHostDxe/SdHostDxe.c        |  787 +++++++
>   .../RPi3/Drivers/SdHostDxe/SdHostDxe.inf      |   55 +
>   .../RPi3/Drivers/VarBlockServiceDxe/FileIo.c  |  196 ++
>   .../RPi3/Drivers/VarBlockServiceDxe/FvbInfo.c |  115 ++
>   .../VarBlockServiceDxe/VarBlockService.c      |  971 +++++++++
>   .../VarBlockServiceDxe/VarBlockService.h      |  217 ++
>   .../VarBlockServiceDxe/VarBlockServiceDxe.c   |  331 +++
>   .../VarBlockServiceDxe/VarBlockServiceDxe.inf |   93 +
>   .../RPi3/Include/IndustryStandard/RpiMbox.h   |  108 +
>   .../RaspberryPi/RPi3/Include/Protocol/DwUsb.h |   53 +
>   .../RPi3/Include/Protocol/ExtendedTextOut.h   |   36 +
>   .../RPi3/Include/Protocol/RpiFirmware.h       |  131 ++
>   .../RPi3/Include/Protocol/RpiMmcHost.h        |  206 ++
>   .../MemoryInitPeiLib/MemoryInitPeiLib.c       |  162 ++
>   .../MemoryInitPeiLib/MemoryInitPeiLib.inf     |   51 +
>   .../PlatformBootManagerLib/PlatformBm.c       |  793 +++++++
>   .../PlatformBootManagerLib/PlatformBm.h       |   60 +
>   .../PlatformBootManagerLib.inf                |   90 +
>   .../PlatformLib/AArch64/RaspberryPiHelper.S   |  107 +
>   .../RPi3/Library/PlatformLib/PlatformLib.inf  |   65 +
>   .../RPi3/Library/PlatformLib/RaspberryPi.c    |   99 +
>   .../RPi3/Library/PlatformLib/RaspberryPiMem.c |  160 ++
>   .../PlatformUiAppLib/PlatformUiAppLib.c       |  120 ++
>   .../PlatformUiAppLib/PlatformUiAppLib.inf     |   34 +
>   .../RPi3/Library/ResetLib/ResetLib.c          |  104 +
>   .../RPi3/Library/ResetLib/ResetLib.inf        |   46 +
>   Platform/RaspberryPi/RPi3/RPi3.dec            |   58 +
>   Platform/RaspberryPi/RPi3/RPi3.dsc            |  629 ++++++
>   Platform/RaspberryPi/RPi3/RPi3.fdf            |  449 ++++
>   Platform/RaspberryPi/RPi3/Readme.md           |  167 ++
>   Platform/RaspberryPi/RPi3/Systems.md          |   65 +
>   .../RPi3/TrustedFirmware/License.txt          |   26 +
>   .../RPi3/TrustedFirmware/Readme.md            |   42 +
>   .../RaspberryPi/RPi3/TrustedFirmware/bl1.bin  |  Bin 0 -> 18801 bytes
>   .../RaspberryPi/RPi3/TrustedFirmware/fip.bin  |  Bin 0 -> 41714 bytes
>   Readme.md                                     |    3 +
>   Silicon/Broadcom/Bcm283x/Bcm283x.dec          |   23 +
>   .../Drivers/InterruptDxe/InterruptDxe.c       |  367 ++++
>   .../Drivers/InterruptDxe/InterruptDxe.inf     |   48 +
>   .../Include/IndustryStandard/Bcm2836.h        |   72 +
>   .../Include/IndustryStandard/Bcm2836Gpio.h    |   49 +
>   .../Include/IndustryStandard/Bcm2836SdHost.h  |   92 +
>   .../Include/IndustryStandard/Bcm2836Sdio.h    |  199 ++
>   .../Bcm283x/Include/Library/GpioLib.h         |   33 +
>   .../Bcm283x/Library/GpioLib/GpioLib.c         |   89 +
>   .../Bcm283x/Library/GpioLib/GpioLib.inf       |   39 +
>   117 files changed, 27594 insertions(+)
>   create mode 100644 Platform/RaspberryPi/RPi3/AcpiTables/AcpiTables.h
>   create mode 100644 Platform/RaspberryPi/RPi3/AcpiTables/AcpiTables.inf
>   create mode 100644 Platform/RaspberryPi/RPi3/AcpiTables/Csrt.aslc
>   create mode 100644 Platform/RaspberryPi/RPi3/AcpiTables/Dbg2.aslc
>   create mode 100644 Platform/RaspberryPi/RPi3/AcpiTables/Dsdt.asl
>   create mode 100644 Platform/RaspberryPi/RPi3/AcpiTables/Fadt.aslc
>   create mode 100644 Platform/RaspberryPi/RPi3/AcpiTables/Gtdt.aslc
>   create mode 100644 Platform/RaspberryPi/RPi3/AcpiTables/Madt.aslc
>   create mode 100644 Platform/RaspberryPi/RPi3/AcpiTables/Pep.asl
>   create mode 100644 Platform/RaspberryPi/RPi3/AcpiTables/Pep.c
>   create mode 100644 Platform/RaspberryPi/RPi3/AcpiTables/Pep.h
>   create mode 100644 Platform/RaspberryPi/RPi3/AcpiTables/Rhpx.asl
>   create mode 100644 Platform/RaspberryPi/RPi3/AcpiTables/Sdhc.asl
>   create mode 100644 Platform/RaspberryPi/RPi3/AcpiTables/Spcr.asl
>   create mode 100644 Platform/RaspberryPi/RPi3/AcpiTables/Uart.asl
>   create mode 100644 Platform/RaspberryPi/RPi3/DeviceTree/License.txt
>   create mode 100644 Platform/RaspberryPi/RPi3/DeviceTree/bcm2710-rpi-3-b-plus.dtb
>   create mode 100644 Platform/RaspberryPi/RPi3/DeviceTree/bcm2710-rpi-3-b-plus.dts
>   create mode 100644 Platform/RaspberryPi/RPi3/DeviceTree/bcm2710-rpi-3-b.dtb
>   create mode 100644 Platform/RaspberryPi/RPi3/DeviceTree/bcm2710-rpi-3-b.dts
>   create mode 100644 Platform/RaspberryPi/RPi3/Drivers/ArasanMmcHostDxe/ArasanMmcHostDxe.c
>   create mode 100644 Platform/RaspberryPi/RPi3/Drivers/ArasanMmcHostDxe/ArasanMmcHostDxe.h
>   create mode 100644 Platform/RaspberryPi/RPi3/Drivers/ArasanMmcHostDxe/ArasanMmcHostDxe.inf
>   create mode 100644 Platform/RaspberryPi/RPi3/Drivers/ConfigDxe/ConfigDxe.c
>   create mode 100644 Platform/RaspberryPi/RPi3/Drivers/ConfigDxe/ConfigDxe.inf
>   create mode 100644 Platform/RaspberryPi/RPi3/Drivers/ConfigDxe/ConfigDxeFormSetGuid.h
>   create mode 100644 Platform/RaspberryPi/RPi3/Drivers/ConfigDxe/ConfigDxeHii.uni
>   create mode 100644 Platform/RaspberryPi/RPi3/Drivers/ConfigDxe/ConfigDxeHii.vfr
>   create mode 100644 Platform/RaspberryPi/RPi3/Drivers/DisplayDxe/ComponentName.c
>   create mode 100644 Platform/RaspberryPi/RPi3/Drivers/DisplayDxe/DisplayDxe.c
>   create mode 100644 Platform/RaspberryPi/RPi3/Drivers/DisplayDxe/DisplayDxe.h
>   create mode 100644 Platform/RaspberryPi/RPi3/Drivers/DisplayDxe/DisplayDxe.inf
>   create mode 100644 Platform/RaspberryPi/RPi3/Drivers/DisplayDxe/Screenshot.c
>   create mode 100644 Platform/RaspberryPi/RPi3/Drivers/DwUsbHostDxe/ComponentName.c
>   create mode 100644 Platform/RaspberryPi/RPi3/Drivers/DwUsbHostDxe/DriverBinding.c
>   create mode 100644 Platform/RaspberryPi/RPi3/Drivers/DwUsbHostDxe/DwUsbHostDxe.c
>   create mode 100644 Platform/RaspberryPi/RPi3/Drivers/DwUsbHostDxe/DwUsbHostDxe.h
>   create mode 100644 Platform/RaspberryPi/RPi3/Drivers/DwUsbHostDxe/DwUsbHostDxe.inf
>   create mode 100644 Platform/RaspberryPi/RPi3/Drivers/DwUsbHostDxe/DwcHw.h
>   create mode 100644 Platform/RaspberryPi/RPi3/Drivers/FdtDxe/FdtDxe.c
>   create mode 100644 Platform/RaspberryPi/RPi3/Drivers/FdtDxe/FdtDxe.inf
>   create mode 100644 Platform/RaspberryPi/RPi3/Drivers/GraphicsConsoleDxe/ComponentName.c
>   create mode 100644 Platform/RaspberryPi/RPi3/Drivers/GraphicsConsoleDxe/GraphicsConsole.c
>   create mode 100644 Platform/RaspberryPi/RPi3/Drivers/GraphicsConsoleDxe/GraphicsConsole.h
>   create mode 100644 Platform/RaspberryPi/RPi3/Drivers/GraphicsConsoleDxe/GraphicsConsoleDxe.inf
>   create mode 100644 Platform/RaspberryPi/RPi3/Drivers/GraphicsConsoleDxe/GraphicsConsoleDxe.uni
>   create mode 100644 Platform/RaspberryPi/RPi3/Drivers/GraphicsConsoleDxe/GraphicsConsoleDxeExtra.uni
>   create mode 100644 Platform/RaspberryPi/RPi3/Drivers/GraphicsConsoleDxe/NewFont.c
>   create mode 100644 Platform/RaspberryPi/RPi3/Drivers/LogoDxe/License.txt
>   create mode 100644 Platform/RaspberryPi/RPi3/Drivers/LogoDxe/Logo.bmp
>   create mode 100644 Platform/RaspberryPi/RPi3/Drivers/LogoDxe/Logo.c
>   create mode 100644 Platform/RaspberryPi/RPi3/Drivers/LogoDxe/Logo.eps
>   create mode 100644 Platform/RaspberryPi/RPi3/Drivers/LogoDxe/Logo.idf
>   create mode 100644 Platform/RaspberryPi/RPi3/Drivers/LogoDxe/Logo.inf
>   create mode 100644 Platform/RaspberryPi/RPi3/Drivers/LogoDxe/Logo.uni
>   create mode 100644 Platform/RaspberryPi/RPi3/Drivers/LogoDxe/LogoDxe.inf
>   create mode 100644 Platform/RaspberryPi/RPi3/Drivers/LogoDxe/LogoDxe.uni
>   create mode 100644 Platform/RaspberryPi/RPi3/Drivers/LogoDxe/LogoDxeExtra.uni
>   create mode 100644 Platform/RaspberryPi/RPi3/Drivers/LogoDxe/LogoExtra.uni
>   create mode 100644 Platform/RaspberryPi/RPi3/Drivers/MmcDxe/ComponentName.c
>   create mode 100644 Platform/RaspberryPi/RPi3/Drivers/MmcDxe/Diagnostics.c
>   create mode 100644 Platform/RaspberryPi/RPi3/Drivers/MmcDxe/Mmc.c
>   create mode 100644 Platform/RaspberryPi/RPi3/Drivers/MmcDxe/Mmc.h
>   create mode 100644 Platform/RaspberryPi/RPi3/Drivers/MmcDxe/MmcBlockIo.c
>   create mode 100644 Platform/RaspberryPi/RPi3/Drivers/MmcDxe/MmcDebug.c
>   create mode 100644 Platform/RaspberryPi/RPi3/Drivers/MmcDxe/MmcDxe.inf
>   create mode 100644 Platform/RaspberryPi/RPi3/Drivers/MmcDxe/MmcIdentification.c
>   create mode 100644 Platform/RaspberryPi/RPi3/Drivers/PlatformSmbiosDxe/PlatformSmbiosDxe.c
>   create mode 100644 Platform/RaspberryPi/RPi3/Drivers/PlatformSmbiosDxe/PlatformSmbiosDxe.inf
>   create mode 100644 Platform/RaspberryPi/RPi3/Drivers/RpiFirmwareDxe/RpiFirmwareDxe.c
>   create mode 100644 Platform/RaspberryPi/RPi3/Drivers/RpiFirmwareDxe/RpiFirmwareDxe.inf
>   create mode 100644 Platform/RaspberryPi/RPi3/Drivers/SdHostDxe/SdHostDxe.c
>   create mode 100644 Platform/RaspberryPi/RPi3/Drivers/SdHostDxe/SdHostDxe.inf
>   create mode 100644 Platform/RaspberryPi/RPi3/Drivers/VarBlockServiceDxe/FileIo.c
>   create mode 100644 Platform/RaspberryPi/RPi3/Drivers/VarBlockServiceDxe/FvbInfo.c
>   create mode 100644 Platform/RaspberryPi/RPi3/Drivers/VarBlockServiceDxe/VarBlockService.c
>   create mode 100644 Platform/RaspberryPi/RPi3/Drivers/VarBlockServiceDxe/VarBlockService.h
>   create mode 100644 Platform/RaspberryPi/RPi3/Drivers/VarBlockServiceDxe/VarBlockServiceDxe.c
>   create mode 100644 Platform/RaspberryPi/RPi3/Drivers/VarBlockServiceDxe/VarBlockServiceDxe.inf
>   create mode 100644 Platform/RaspberryPi/RPi3/Include/IndustryStandard/RpiMbox.h
>   create mode 100644 Platform/RaspberryPi/RPi3/Include/Protocol/DwUsb.h
>   create mode 100644 Platform/RaspberryPi/RPi3/Include/Protocol/ExtendedTextOut.h
>   create mode 100644 Platform/RaspberryPi/RPi3/Include/Protocol/RpiFirmware.h
>   create mode 100644 Platform/RaspberryPi/RPi3/Include/Protocol/RpiMmcHost.h
>   create mode 100644 Platform/RaspberryPi/RPi3/Library/MemoryInitPeiLib/MemoryInitPeiLib.c
>   create mode 100644 Platform/RaspberryPi/RPi3/Library/MemoryInitPeiLib/MemoryInitPeiLib.inf
>   create mode 100644 Platform/RaspberryPi/RPi3/Library/PlatformBootManagerLib/PlatformBm.c
>   create mode 100644 Platform/RaspberryPi/RPi3/Library/PlatformBootManagerLib/PlatformBm.h
>   create mode 100644 Platform/RaspberryPi/RPi3/Library/PlatformBootManagerLib/PlatformBootManagerLib.inf
>   create mode 100644 Platform/RaspberryPi/RPi3/Library/PlatformLib/AArch64/RaspberryPiHelper.S
>   create mode 100644 Platform/RaspberryPi/RPi3/Library/PlatformLib/PlatformLib.inf
>   create mode 100644 Platform/RaspberryPi/RPi3/Library/PlatformLib/RaspberryPi.c
>   create mode 100644 Platform/RaspberryPi/RPi3/Library/PlatformLib/RaspberryPiMem.c
>   create mode 100644 Platform/RaspberryPi/RPi3/Library/PlatformUiAppLib/PlatformUiAppLib.c
>   create mode 100644 Platform/RaspberryPi/RPi3/Library/PlatformUiAppLib/PlatformUiAppLib.inf
>   create mode 100644 Platform/RaspberryPi/RPi3/Library/ResetLib/ResetLib.c
>   create mode 100644 Platform/RaspberryPi/RPi3/Library/ResetLib/ResetLib.inf
>   create mode 100644 Platform/RaspberryPi/RPi3/RPi3.dec
>   create mode 100644 Platform/RaspberryPi/RPi3/RPi3.dsc
>   create mode 100644 Platform/RaspberryPi/RPi3/RPi3.fdf
>   create mode 100644 Platform/RaspberryPi/RPi3/Readme.md
>   create mode 100644 Platform/RaspberryPi/RPi3/Systems.md
>   create mode 100644 Platform/RaspberryPi/RPi3/TrustedFirmware/License.txt
>   create mode 100644 Platform/RaspberryPi/RPi3/TrustedFirmware/Readme.md
>   create mode 100644 Platform/RaspberryPi/RPi3/TrustedFirmware/bl1.bin
>   create mode 100644 Platform/RaspberryPi/RPi3/TrustedFirmware/fip.bin
>   create mode 100644 Silicon/Broadcom/Bcm283x/Bcm283x.dec
>   create mode 100644 Silicon/Broadcom/Bcm283x/Drivers/InterruptDxe/InterruptDxe.c
>   create mode 100644 Silicon/Broadcom/Bcm283x/Drivers/InterruptDxe/InterruptDxe.inf
>   create mode 100644 Silicon/Broadcom/Bcm283x/Include/IndustryStandard/Bcm2836.h
>   create mode 100644 Silicon/Broadcom/Bcm283x/Include/IndustryStandard/Bcm2836Gpio.h
>   create mode 100644 Silicon/Broadcom/Bcm283x/Include/IndustryStandard/Bcm2836SdHost.h
>   create mode 100644 Silicon/Broadcom/Bcm283x/Include/IndustryStandard/Bcm2836Sdio.h
>   create mode 100644 Silicon/Broadcom/Bcm283x/Include/Library/GpioLib.h
>   create mode 100644 Silicon/Broadcom/Bcm283x/Library/GpioLib/GpioLib.c
>   create mode 100644 Silicon/Broadcom/Bcm283x/Library/GpioLib/GpioLib.inf
> 



^ permalink raw reply	[flat|nested] 34+ messages in thread

* Re: [PATCH v5 edk2-platforms 22/22] Platform/RaspberryPi/RPi3: Add platform readme's
  2019-02-05 16:25 ` [PATCH v5 edk2-platforms 22/22] Platform/RaspberryPi/RPi3: Add platform readme's Pete Batard
@ 2019-02-14 18:42   ` Leif Lindholm
  0 siblings, 0 replies; 34+ messages in thread
From: Leif Lindholm @ 2019-02-14 18:42 UTC (permalink / raw)
  To: Pete Batard; +Cc: edk2-devel, ard.biesheuvel

On Tue, Feb 05, 2019 at 04:25:37PM +0000, Pete Batard wrote:
> Documentation is split between general plaform data and OS testing
> and installation details.
> 
> Contributed-under: TianoCore Contribution Agreement 1.1
> Signed-off-by: Pete Batard <pete@akeo.ie>

Reviewed-by: Leif Lindholm <leif.lindholm@linaro.org>

> ---
>  Platform/RaspberryPi/RPi3/Readme.md  | 167 ++++++++++++++++++++
>  Platform/RaspberryPi/RPi3/Systems.md |  65 ++++++++
>  Readme.md                            |   3 +
>  3 files changed, 235 insertions(+)
> 
> diff --git a/Platform/RaspberryPi/RPi3/Readme.md b/Platform/RaspberryPi/RPi3/Readme.md
> new file mode 100644
> index 000000000000..7434233df0fb
> --- /dev/null
> +++ b/Platform/RaspberryPi/RPi3/Readme.md
> @@ -0,0 +1,167 @@
> +Raspberry Pi Platform
> +=====================
> +
> +# Summary
> +
> +This is a port of 64-bit Tiano Core UEFI firmware for the Raspberry Pi 3/3B+ platforms,
> +based on [Ard Bisheuvel's 64-bit](http://www.workofard.com/2017/02/uefi-on-the-pi/)
> +and [Microsoft's 32-bit](https://github.com/ms-iot/RPi-UEFI/tree/ms-iot/Pi3BoardPkg)
> +implementations, as maintained by [Andrei Warkentin](https://github.com/andreiw/RaspberryPiPkg).
> +
> +This is meant as a generally useful 64-bit ATF + UEFI implementation for the Raspberry
> +Pi 3/3B+ which should be good enough for most kind of UEFI development, as well as for
> +running consummer Operating Systems in such as Linux or Windows.
> +
> +Raspberry Pi is a trademark of the [Raspberry Pi Foundation](http://www.raspberrypi.org).
> +
> +# Status
> +
> +This firmware, that has been validated to compile against the current
> +[edk2](https://github.com/tianocore/edk2)/[edk2-platforms](https://github.com/tianocore/edk2-platforms),
> +should be able to boot Linux (SUSE, Ubuntu), NetBSD, FreeBSD as well as Windows 10 ARM64
> +(full GUI version).
> +
> +It also provides support for ATF ([Arm Trusted Platform](https://github.com/ARM-software/arm-trusted-firmware)).
> +
> +HDMI and the mini-UART serial port can be used for output devices, with mirrored output.
> +USB keyboards and the mini-UART serial port can be used as input.
> +
> +On a freshly built firmware, the default is to boot the UEFI shell.
> +To change the default boot order (for instance to boot uSD media by default) you
> +will need to edit the preferences in _Boot Maintenance Manager_.
> +
> +For additional information about the tested systems and how to set them up,
> +please see [Systems.md](./Systems.md).
> +
> +# Building
> +
> +Build instructions from the top level edk2-platforms Readme.md apply.
> +
> +# Booting the firmware
> +
> +1. Format a uSD card as FAT32
> +2. Copy the generated `RPI_EFI.fd` firmware onto the partition
> +3. Download and copy the following files from https://github.com/raspberrypi/firmware/tree/master/boot
> +  - `bootcode.bin`
> +  - `fixup.dat`
> +  - `start.elf`
> +4. Create a `config.txt` with the following content:
> +  ```
> +  arm_control=0x200
> +  enable_uart=1
> +  armstub=RPI_EFI.fd
> +  disable_commandline_tags=1
> +  ```
> +5. Insert the uSD card and power up the Pi.
> +
> +Note that if you have a model 3+ or a model 3 where you enabled USB boot through OTP
> +(see [here](https://www.raspberrypi.org/documentation/hardware/raspberrypi/bootmodes/msd.md))
> +you may also be able to boot from a FAT32 USB driver rather than uSD.
> +
> +# Notes
> +
> +## ARM Trusted Firmware (ATF)
> +
> +The ATF binaries being used were compiled from the latest ATF source.
> +No aleration to the official source have been applied.
> +
> +For more details on the ATF compilation, see the [Readme](./TrustedFirmware/Readme.md)
> +in the `TrustedFirmware/` directory.
> +
> +## Custom Device Tree
> +
> +The default Device Tree included in the firmware is the one for a Raspberry Pi 3 Model B (not B+).
> +If you want to use a different Device Tree, to boot a Pi 3 Model B+ for instance (for which a
> +DTB is also provided under `DeviceTree/`), you should copy the relevant `.dtb` into the root of
> +the SD or USB, and then edit your `config.txt` so that it looks like:
> +
> +```
> +(...)
> +disable_commandline_tags=2
> +device_tree_address=0x10000
> +device_tree_end=0x20000
> +device_tree=bcm2710-rpi-3-b-plus.dtb
> +```
> +
> +Note: the address range **must** be `[0x10000:0x20000]`.
> +`dtoverlay` and `dtparam` parameters are also supported **when** providing a Device Tree`.
> +
> +## Custom `bootargs`
> +
> +This firmware will honor the command line passed by the GPU via `cmdline.txt`.
> +
> +Note, that the ultimate contents of `/chosen/bootargs` are a combination of several pieces:
> +- Original `/chosen/bootargs` if using the internal DTB. Seems to be completely discarded by GPU when booting with a custom device tree.
> +- GPU-passed hardware configuration. This one is always present.
> +- Additional boot options passed via `cmdline.txt`.
> +
> +# Limitations
> +
> +## HDMI
> +
> +The UEFI HDMI video support relies on the VC (that's the GPU)
> +firmware to correctly detect and configure the attached screen.
> +Some screens are slow, and this detection may not occur fast
> +enough. Finally, you may wish to be able to boot your Pi
> +headless, yet be able to attach a display to it later for
> +debugging.
> +
> +To accommodate these issues, the following extra lines
> +are recommended for your `config.txt`:
> +- `hdmi_force_hotplug=1` to allow plugging in video after system is booted.
> +- `hdmi_group=1` and `hdmi_mode=4` to force a specific mode, both to accommodate
> +   late-plugged screens or buggy/slow screens. See [official documentation](https://www.raspberrypi.org/documentation/configuration/config-txt/video.md)
> +   to make sense of these parameters (example above sets up 720p 60Hz).
> +
> +## NVRAM
> +
> +The Raspberry Pi has no NVRAM.
> +
> +NVRAM is emulated, with the non-volatile store backed by the UEFI image itself. This means
> +that any changes made in UEFI proper are persisted, but changes made from a High Level
> +Operating System (HLOS) aren't.
> +
> +## RTC
> +
> +The Rasberry Pi has no RTC.
> +
> +An `RtcEpochSeconds` NVRAM variable is used to store the boot time.
> +This should allow you to set whatever date/time you want using the Shell date and
> +time commands. While in UEFI or HLOS, the time will tick forward.
> +`RtcEpochSeconds` is not updated on reboots.
> +
> +## uSD
> +
> +UEFI supports both the Arasan SDHCI and the Broadcom SDHost controllers to access the uSD slot.
> +You can use either. The other controller gets routed to the SDIO card. The choice made will
> +impact ACPI OSes booted (e.g. Windows 10). Arasan, being an SDIO controller, is usually used
> +with the WiFi adapter where available. SDHost cannot be used with SDIO. In UEFI setup screen:
> +- go to `Device Manager`
> +- go to `Raspberry Pi Configuration`
> +- go to `Chipset`
> +- configure `Boot uSD Routing`
> +
> +Known issues:
> +- Arasan HS/4bit support is missing.
> +- No 8 bit mode support for (e)MMC (irrelevant for the Pi 3).
> +- Hacky (e)MMC support (no HS).
> +- No card removal/replacement detection, tons of timeouts and slow down during boot without an uSD card present.
> +
> +## USB
> +
> +- USB1 BBB mass storage devices untested (USB2 and USB3 devices are fine).
> +- USB1 CBI mass storage devices don't work (e.g. HP FD-05PUB floppy).
> +
> +## ACPI
> +
> +Both Arasan and SDHost SD controllers are exposed.
> +
> +Note that the ACPI tables were derived or copied from the MS-IoT one. This means that they
> +are not truly ACPI compliant, especially when it comes to their descriptors, and therefore
> +not suitable for Linux environments. If you want to use a Linux HLOS, you are encouraged to
> +install a kernel that relies on Device Tree rather than ACPI.
> +
> +## Missing Functionality
> +
> +- Network booting via onboard NIC.
> +- Ability to switch UART use to PL011.
> diff --git a/Platform/RaspberryPi/RPi3/Systems.md b/Platform/RaspberryPi/RPi3/Systems.md
> new file mode 100644
> index 000000000000..f6410eb25f0d
> --- /dev/null
> +++ b/Platform/RaspberryPi/RPi3/Systems.md
> @@ -0,0 +1,65 @@
> +# Tested Operating Systems
> +
> +## Ubuntu
> +
> +[Ubuntu 18.04 LTS](http://releases.ubuntu.com/18.04/) has been tested and confirmed to work,
> +on a Raspberry 3 Model B, including the installation process. Note however that network
> +installation and networking may not work on the Model B+, due to the `lan78xx` Linux driver
> +still requiring some support.
> +
> +Below are the steps you can follow to install Ubuntu LTS onto SD/USB:
> +* Download the latest Ubuntu LTS ARM64 [`mini.iso`](http://ports.ubuntu.com/ubuntu-ports/dists/bionic/main/installer-arm64/current/images/netboot/mini.iso).
> +* Partition the media as MBR and create a ~200 MB FAT32 partition on it with MBR type `0x0c`.
> +  Note: Do not be tempted to use GPT partition scheme or `0xef` (EFI System Partition) for the
> +  type, as none of these are supported by the Raspberry Pi's internal boot rom.
> +* Extract the full content of the ISO onto the partition you created.
> +* Also extract the GRUB EFI bootloader `bootaa64.efi` from `/boot/grub/efi.img` to `/boot/grub/`.
> +  Note: Do not be tempted to copy this file to another directory (such as `/efi/boot/`) as GRUB looks for its
> +  modules and configuration data in the same directory as the EFI loader and also, the installation
> +  process will create a `bootaa64.efi` into `/efi/boot/`.
> +* If needed, copy the UEFI firmware files (`RPI_EFI.fd`, `bootcode.bin`, `fixup.dat` and `start.elf`)
> +  onto the FAT partition.
> +* Boot the pi and let it go into the UEFI shell.
> +* Navigate to `fs0:` then `/boot/grub/` and launch the GRUB efi loader.
> +* Follow the Ubuntu installation process.
> +
> +Note: Because Ubuntu operates in quiet mode by default (no boot messages), you may think the system is frozen
> +on first reboot after installation. However, if you wait long enough you **will** get to a login prompt.
> +
> +Once Linux is running, if desired, you can disable quiet boot, as well as force the display
> +of the GRUB selector, by editing `/etc/default/grub` and changing:
> +* `GRUB_TIMEOUT_STYLE=hidden` &rarr; `GRUB_TIMEOUT_STYLE=menu`
> +* `GRUB_CMDLINE_LINUX_DEFAULT="splash quiet"` &rarr; `GRUB_CMDLINE_LINUX_DEFAULT=""`
> +
> +Then, to have your changes applied run `update-grub` and reboot.
> +
> +## Other Linux distributions
> +
> +* Debian ARM64 does not currently work, most likely due to missing required module support
> +  in its kernel. However its installation process works, so it may be possible to get it
> +  running with a custom kernel.
> +
> +* OpenSUSE Leap 42.3 has been reported to work on Raspberry 3 Model B.
> +
> +* Other ARM64 Linux releases, that support UEFI boot and have the required hardware support
> +  for Pi hardware are expected to run, though their installation process might require some
> +  cajoling.
> +
> +## Windows
> +
> +Windows 10 1809 for ARM64 (build 17763) has been tested and confirmed to work (after replacing
> +`C:\Windows\System32\Drivers\WppRecorder.sys` with an older version, since the one from 1809
> +appears to be buggy across all archs, and results in a similar BSOD when trying to run Windows
> +To Go on x64 with native drivers for instance).
> +
> +Windows 10 1803 for ARM64 and earlier do not work due to the presence of a hardware ASSERT check
> +in the Windows kernel, that was removed in later versions.
> +
> +You probably want to look at https://www.worproject.ml/ as well as the
> +[Windows thread in the original RaspberryPiPkg](https://github.com/andreiw/RaspberryPiPkg/issues/12)
> +for installation details.
> +
> +## Other platforms
> +
> +Details you may need to run other platforms, including FreeBSD, is provided in the
> +[Readme from the original RaspberryPiPkg](https://github.com/andreiw/RaspberryPiPkg).
> diff --git a/Readme.md b/Readme.md
> index 384b1d3c5e2b..95c0c145224b 100644
> --- a/Readme.md
> +++ b/Readme.md
> @@ -217,6 +217,9 @@ they will be documented with the platform.
>  ## Marvell
>  * [Armada 70x0](Platform/Marvell/Armada)
>  
> +## Raspberry Pi
> +* [Pi 3](Platform/RaspberryPi/RPi3)
> +
>  ## Socionext
>  * [SynQuacer](Platform/Socionext/DeveloperBox)
>  
> -- 
> 2.17.0.windows.1
> 


^ permalink raw reply	[flat|nested] 34+ messages in thread

* Re: [PATCH v5 edk2-platforms 00/22] Platform/RaspberryPi: Add Raspberry Pi 3 support
  2019-02-05 16:25 [PATCH v5 edk2-platforms 00/22] Platform/RaspberryPi: Add Raspberry Pi 3 support Pete Batard
                   ` (22 preceding siblings ...)
  2019-02-13  3:41 ` [PATCH v5 edk2-platforms 00/22] Platform/RaspberryPi: Add Raspberry Pi 3 support Jeremy Linton
@ 2019-02-14 18:45 ` Leif Lindholm
  23 siblings, 0 replies; 34+ messages in thread
From: Leif Lindholm @ 2019-02-14 18:45 UTC (permalink / raw)
  To: Pete Batard; +Cc: edk2-devel, ard.biesheuvel

On Tue, Feb 05, 2019 at 04:25:15PM +0000, Pete Batard wrote:
> Changes for v5:
> 
> * Raspberry/Pi3 -> RaspberryPi/RPi3
> * Remove VirtualRealTimeClockLib as well as BUILD_EPOCH macro (use the upcoming
>   EmbeddedPkg Virtual RTC from EDK2 instead)
> * Use $(PLATFORM_NAME) where possible in .dsc and .fdf
> * Update Readme to remove build instructions, describe ACPI limitations, fix
>   ATF Readme link and split OS installation & test notes into a separate file.
> * Add -Wl,--fix-cortex-a53-843419 to LINK_FLAGS
> 
> IMPORTANT: Due to the removal of VirtualRealTimeClockLib this series requires
> https://lists.01.org/pipermail/edk2-devel/2019-February/036301.html to have
> been applied to your edk2 repository.

All of the comments I raised on previous versions of this set have
been addressed. The VirtualRtc driver has been moved separately and I
have provided feedback on that for the new edk2 version.
Other than that, I gave an R-b for the added documentation, but I
cannot claim to have properly looked at the rest of the platform
support.

I'll just mention here formally that I see no reason for Ard not to
push this support once he is happy with it (and the Rtc driver is in
edk2).

Regards,

Leif


> Regards,
> 
> /Pete
> 
> 
> Pete Batard (22):
>   Silicon/Broadcom/Bcm283x: Add interrupt driver
>   Silicon/Broadcom/Bcm283x: Add GpioLib
>   Platform/RaspberryPi/RPi3: Add ACPI tables
>   Platform/RaspberryPi/RPi3: Add reset and memory init libraries
>   Platform/RaspberryPi/RPi3: Add platform library
>   Platform/RaspberryPi/RPi3: Add firmware driver
>   Platform/RaspberryPi/RPi3: Add platform config driver
>   Platform/RaspberryPi/RPi3: Add SMBIOS driver
>   Platform/RaspberryPi/RPi3: Add display driver
>   Platform/RaspberryPi/RPi3: Add console driver
>   Platform/RaspberryPi/RPi3: Add NV storage driver
>   Platform/RaspberryPi/RPi3: Add Device Tree driver
>   Platform/RaspberryPi/RPi3: Add base MMC driver
>   Platform/RaspberryPi/RPi3: Add Arasan MMC driver
>   Platform/RaspberryPi/RPi3: Add SD Host driver
>   Platform/RaspberryPi/RPi3: Add platform boot manager and helper libs
>   Platform/RaspberryPi/RPi3: Add USB host driver
>   Platform/RaspberryPi/RPi3 *NON-OSI*: Add ATF binaries
>   Platform/RaspberryPi/RPi3 *NON-OSI*: Add Device Tree binaries
>   Platform/RaspberryPi/RPi3 *NON-OSI*: Add logo driver
>   Platform/RaspberryPi/RPi3: Add platform
>   Platform/RaspberryPi/RPi3: Add platform readme's
> 
>  .../RaspberryPi/RPi3/AcpiTables/AcpiTables.h  |   82 +
>  .../RPi3/AcpiTables/AcpiTables.inf            |   46 +
>  .../RaspberryPi/RPi3/AcpiTables/Csrt.aslc     |  332 +++
>  .../RaspberryPi/RPi3/AcpiTables/Dbg2.aslc     |   34 +
>  Platform/RaspberryPi/RPi3/AcpiTables/Dsdt.asl |  511 +++++
>  .../RaspberryPi/RPi3/AcpiTables/Fadt.aslc     |   52 +
>  .../RaspberryPi/RPi3/AcpiTables/Gtdt.aslc     |   33 +
>  .../RaspberryPi/RPi3/AcpiTables/Madt.aslc     |   62 +
>  Platform/RaspberryPi/RPi3/AcpiTables/Pep.asl  |   95 +
>  Platform/RaspberryPi/RPi3/AcpiTables/Pep.c    |   84 +
>  Platform/RaspberryPi/RPi3/AcpiTables/Pep.h    |  126 ++
>  Platform/RaspberryPi/RPi3/AcpiTables/Rhpx.asl |  201 ++
>  Platform/RaspberryPi/RPi3/AcpiTables/Sdhc.asl |  105 +
>  Platform/RaspberryPi/RPi3/AcpiTables/Spcr.asl |   53 +
>  Platform/RaspberryPi/RPi3/AcpiTables/Uart.asl |  158 ++
>  .../RaspberryPi/RPi3/DeviceTree/License.txt   |  340 +++
>  .../RPi3/DeviceTree/bcm2710-rpi-3-b-plus.dtb  |  Bin 0 -> 25617 bytes
>  .../RPi3/DeviceTree/bcm2710-rpi-3-b-plus.dts  | 1263 ++++++++++++
>  .../RPi3/DeviceTree/bcm2710-rpi-3-b.dtb       |  Bin 0 -> 25354 bytes
>  .../RPi3/DeviceTree/bcm2710-rpi-3-b.dts       | 1259 +++++++++++
>  .../ArasanMmcHostDxe/ArasanMmcHostDxe.c       |  723 +++++++
>  .../ArasanMmcHostDxe/ArasanMmcHostDxe.h       |   50 +
>  .../ArasanMmcHostDxe/ArasanMmcHostDxe.inf     |   52 +
>  .../RPi3/Drivers/ConfigDxe/ConfigDxe.c        |  351 ++++
>  .../RPi3/Drivers/ConfigDxe/ConfigDxe.inf      |   78 +
>  .../Drivers/ConfigDxe/ConfigDxeFormSetGuid.h  |   23 +
>  .../RPi3/Drivers/ConfigDxe/ConfigDxeHii.uni   |  100 +
>  .../RPi3/Drivers/ConfigDxe/ConfigDxeHii.vfr   |  306 +++
>  .../RPi3/Drivers/DisplayDxe/ComponentName.c   |  222 ++
>  .../RPi3/Drivers/DisplayDxe/DisplayDxe.c      |  606 ++++++
>  .../RPi3/Drivers/DisplayDxe/DisplayDxe.h      |   42 +
>  .../RPi3/Drivers/DisplayDxe/DisplayDxe.inf    |   71 +
>  .../RPi3/Drivers/DisplayDxe/Screenshot.c      |  375 ++++
>  .../RPi3/Drivers/DwUsbHostDxe/ComponentName.c |  225 ++
>  .../RPi3/Drivers/DwUsbHostDxe/DriverBinding.c |  274 +++
>  .../RPi3/Drivers/DwUsbHostDxe/DwUsbHostDxe.c  | 1635 +++++++++++++++
>  .../RPi3/Drivers/DwUsbHostDxe/DwUsbHostDxe.h  |  162 ++
>  .../Drivers/DwUsbHostDxe/DwUsbHostDxe.inf     |   59 +
>  .../RPi3/Drivers/DwUsbHostDxe/DwcHw.h         |  788 +++++++
>  .../RaspberryPi/RPi3/Drivers/FdtDxe/FdtDxe.c  |  364 ++++
>  .../RPi3/Drivers/FdtDxe/FdtDxe.inf            |   53 +
>  .../GraphicsConsoleDxe/ComponentName.c        |  183 ++
>  .../GraphicsConsoleDxe/GraphicsConsole.c      | 1837 +++++++++++++++++
>  .../GraphicsConsoleDxe/GraphicsConsole.h      |  591 ++++++
>  .../GraphicsConsoleDxe/GraphicsConsoleDxe.inf |   75 +
>  .../GraphicsConsoleDxe/GraphicsConsoleDxe.uni |   18 +
>  .../GraphicsConsoleDxeExtra.uni               |   18 +
>  .../RPi3/Drivers/GraphicsConsoleDxe/NewFont.c |  287 +++
>  .../RPi3/Drivers/LogoDxe/License.txt          |   10 +
>  .../RaspberryPi/RPi3/Drivers/LogoDxe/Logo.bmp |  Bin 0 -> 185398 bytes
>  .../RaspberryPi/RPi3/Drivers/LogoDxe/Logo.c   |  159 ++
>  .../RaspberryPi/RPi3/Drivers/LogoDxe/Logo.eps |  Bin 0 -> 250982 bytes
>  .../RaspberryPi/RPi3/Drivers/LogoDxe/Logo.idf |   18 +
>  .../RaspberryPi/RPi3/Drivers/LogoDxe/Logo.inf |   34 +
>  .../RaspberryPi/RPi3/Drivers/LogoDxe/Logo.uni |   20 +
>  .../RPi3/Drivers/LogoDxe/LogoDxe.inf          |   63 +
>  .../RPi3/Drivers/LogoDxe/LogoDxe.uni          |   19 +
>  .../RPi3/Drivers/LogoDxe/LogoDxeExtra.uni     |   19 +
>  .../RPi3/Drivers/LogoDxe/LogoExtra.uni        |   19 +
>  .../RPi3/Drivers/MmcDxe/ComponentName.c       |  163 ++
>  .../RPi3/Drivers/MmcDxe/Diagnostics.c         |  263 +++
>  .../RaspberryPi/RPi3/Drivers/MmcDxe/Mmc.c     |  460 +++++
>  .../RaspberryPi/RPi3/Drivers/MmcDxe/Mmc.h     |  533 +++++
>  .../RPi3/Drivers/MmcDxe/MmcBlockIo.c          |  469 +++++
>  .../RPi3/Drivers/MmcDxe/MmcDebug.c            |  170 ++
>  .../RPi3/Drivers/MmcDxe/MmcDxe.inf            |   58 +
>  .../RPi3/Drivers/MmcDxe/MmcIdentification.c   |  980 +++++++++
>  .../PlatformSmbiosDxe/PlatformSmbiosDxe.c     |  903 ++++++++
>  .../PlatformSmbiosDxe/PlatformSmbiosDxe.inf   |   56 +
>  .../Drivers/RpiFirmwareDxe/RpiFirmwareDxe.c   | 1084 ++++++++++
>  .../Drivers/RpiFirmwareDxe/RpiFirmwareDxe.inf |   50 +
>  .../RPi3/Drivers/SdHostDxe/SdHostDxe.c        |  787 +++++++
>  .../RPi3/Drivers/SdHostDxe/SdHostDxe.inf      |   55 +
>  .../RPi3/Drivers/VarBlockServiceDxe/FileIo.c  |  196 ++
>  .../RPi3/Drivers/VarBlockServiceDxe/FvbInfo.c |  115 ++
>  .../VarBlockServiceDxe/VarBlockService.c      |  971 +++++++++
>  .../VarBlockServiceDxe/VarBlockService.h      |  217 ++
>  .../VarBlockServiceDxe/VarBlockServiceDxe.c   |  331 +++
>  .../VarBlockServiceDxe/VarBlockServiceDxe.inf |   93 +
>  .../RPi3/Include/IndustryStandard/RpiMbox.h   |  108 +
>  .../RaspberryPi/RPi3/Include/Protocol/DwUsb.h |   53 +
>  .../RPi3/Include/Protocol/ExtendedTextOut.h   |   36 +
>  .../RPi3/Include/Protocol/RpiFirmware.h       |  131 ++
>  .../RPi3/Include/Protocol/RpiMmcHost.h        |  206 ++
>  .../MemoryInitPeiLib/MemoryInitPeiLib.c       |  162 ++
>  .../MemoryInitPeiLib/MemoryInitPeiLib.inf     |   51 +
>  .../PlatformBootManagerLib/PlatformBm.c       |  793 +++++++
>  .../PlatformBootManagerLib/PlatformBm.h       |   60 +
>  .../PlatformBootManagerLib.inf                |   90 +
>  .../PlatformLib/AArch64/RaspberryPiHelper.S   |  107 +
>  .../RPi3/Library/PlatformLib/PlatformLib.inf  |   65 +
>  .../RPi3/Library/PlatformLib/RaspberryPi.c    |   99 +
>  .../RPi3/Library/PlatformLib/RaspberryPiMem.c |  160 ++
>  .../PlatformUiAppLib/PlatformUiAppLib.c       |  120 ++
>  .../PlatformUiAppLib/PlatformUiAppLib.inf     |   34 +
>  .../RPi3/Library/ResetLib/ResetLib.c          |  104 +
>  .../RPi3/Library/ResetLib/ResetLib.inf        |   46 +
>  Platform/RaspberryPi/RPi3/RPi3.dec            |   58 +
>  Platform/RaspberryPi/RPi3/RPi3.dsc            |  629 ++++++
>  Platform/RaspberryPi/RPi3/RPi3.fdf            |  449 ++++
>  Platform/RaspberryPi/RPi3/Readme.md           |  167 ++
>  Platform/RaspberryPi/RPi3/Systems.md          |   65 +
>  .../RPi3/TrustedFirmware/License.txt          |   26 +
>  .../RPi3/TrustedFirmware/Readme.md            |   42 +
>  .../RaspberryPi/RPi3/TrustedFirmware/bl1.bin  |  Bin 0 -> 18801 bytes
>  .../RaspberryPi/RPi3/TrustedFirmware/fip.bin  |  Bin 0 -> 41714 bytes
>  Readme.md                                     |    3 +
>  Silicon/Broadcom/Bcm283x/Bcm283x.dec          |   23 +
>  .../Drivers/InterruptDxe/InterruptDxe.c       |  367 ++++
>  .../Drivers/InterruptDxe/InterruptDxe.inf     |   48 +
>  .../Include/IndustryStandard/Bcm2836.h        |   72 +
>  .../Include/IndustryStandard/Bcm2836Gpio.h    |   49 +
>  .../Include/IndustryStandard/Bcm2836SdHost.h  |   92 +
>  .../Include/IndustryStandard/Bcm2836Sdio.h    |  199 ++
>  .../Bcm283x/Include/Library/GpioLib.h         |   33 +
>  .../Bcm283x/Library/GpioLib/GpioLib.c         |   89 +
>  .../Bcm283x/Library/GpioLib/GpioLib.inf       |   39 +
>  117 files changed, 27594 insertions(+)
>  create mode 100644 Platform/RaspberryPi/RPi3/AcpiTables/AcpiTables.h
>  create mode 100644 Platform/RaspberryPi/RPi3/AcpiTables/AcpiTables.inf
>  create mode 100644 Platform/RaspberryPi/RPi3/AcpiTables/Csrt.aslc
>  create mode 100644 Platform/RaspberryPi/RPi3/AcpiTables/Dbg2.aslc
>  create mode 100644 Platform/RaspberryPi/RPi3/AcpiTables/Dsdt.asl
>  create mode 100644 Platform/RaspberryPi/RPi3/AcpiTables/Fadt.aslc
>  create mode 100644 Platform/RaspberryPi/RPi3/AcpiTables/Gtdt.aslc
>  create mode 100644 Platform/RaspberryPi/RPi3/AcpiTables/Madt.aslc
>  create mode 100644 Platform/RaspberryPi/RPi3/AcpiTables/Pep.asl
>  create mode 100644 Platform/RaspberryPi/RPi3/AcpiTables/Pep.c
>  create mode 100644 Platform/RaspberryPi/RPi3/AcpiTables/Pep.h
>  create mode 100644 Platform/RaspberryPi/RPi3/AcpiTables/Rhpx.asl
>  create mode 100644 Platform/RaspberryPi/RPi3/AcpiTables/Sdhc.asl
>  create mode 100644 Platform/RaspberryPi/RPi3/AcpiTables/Spcr.asl
>  create mode 100644 Platform/RaspberryPi/RPi3/AcpiTables/Uart.asl
>  create mode 100644 Platform/RaspberryPi/RPi3/DeviceTree/License.txt
>  create mode 100644 Platform/RaspberryPi/RPi3/DeviceTree/bcm2710-rpi-3-b-plus.dtb
>  create mode 100644 Platform/RaspberryPi/RPi3/DeviceTree/bcm2710-rpi-3-b-plus.dts
>  create mode 100644 Platform/RaspberryPi/RPi3/DeviceTree/bcm2710-rpi-3-b.dtb
>  create mode 100644 Platform/RaspberryPi/RPi3/DeviceTree/bcm2710-rpi-3-b.dts
>  create mode 100644 Platform/RaspberryPi/RPi3/Drivers/ArasanMmcHostDxe/ArasanMmcHostDxe.c
>  create mode 100644 Platform/RaspberryPi/RPi3/Drivers/ArasanMmcHostDxe/ArasanMmcHostDxe.h
>  create mode 100644 Platform/RaspberryPi/RPi3/Drivers/ArasanMmcHostDxe/ArasanMmcHostDxe.inf
>  create mode 100644 Platform/RaspberryPi/RPi3/Drivers/ConfigDxe/ConfigDxe.c
>  create mode 100644 Platform/RaspberryPi/RPi3/Drivers/ConfigDxe/ConfigDxe.inf
>  create mode 100644 Platform/RaspberryPi/RPi3/Drivers/ConfigDxe/ConfigDxeFormSetGuid.h
>  create mode 100644 Platform/RaspberryPi/RPi3/Drivers/ConfigDxe/ConfigDxeHii.uni
>  create mode 100644 Platform/RaspberryPi/RPi3/Drivers/ConfigDxe/ConfigDxeHii.vfr
>  create mode 100644 Platform/RaspberryPi/RPi3/Drivers/DisplayDxe/ComponentName.c
>  create mode 100644 Platform/RaspberryPi/RPi3/Drivers/DisplayDxe/DisplayDxe.c
>  create mode 100644 Platform/RaspberryPi/RPi3/Drivers/DisplayDxe/DisplayDxe.h
>  create mode 100644 Platform/RaspberryPi/RPi3/Drivers/DisplayDxe/DisplayDxe.inf
>  create mode 100644 Platform/RaspberryPi/RPi3/Drivers/DisplayDxe/Screenshot.c
>  create mode 100644 Platform/RaspberryPi/RPi3/Drivers/DwUsbHostDxe/ComponentName.c
>  create mode 100644 Platform/RaspberryPi/RPi3/Drivers/DwUsbHostDxe/DriverBinding.c
>  create mode 100644 Platform/RaspberryPi/RPi3/Drivers/DwUsbHostDxe/DwUsbHostDxe.c
>  create mode 100644 Platform/RaspberryPi/RPi3/Drivers/DwUsbHostDxe/DwUsbHostDxe.h
>  create mode 100644 Platform/RaspberryPi/RPi3/Drivers/DwUsbHostDxe/DwUsbHostDxe.inf
>  create mode 100644 Platform/RaspberryPi/RPi3/Drivers/DwUsbHostDxe/DwcHw.h
>  create mode 100644 Platform/RaspberryPi/RPi3/Drivers/FdtDxe/FdtDxe.c
>  create mode 100644 Platform/RaspberryPi/RPi3/Drivers/FdtDxe/FdtDxe.inf
>  create mode 100644 Platform/RaspberryPi/RPi3/Drivers/GraphicsConsoleDxe/ComponentName.c
>  create mode 100644 Platform/RaspberryPi/RPi3/Drivers/GraphicsConsoleDxe/GraphicsConsole.c
>  create mode 100644 Platform/RaspberryPi/RPi3/Drivers/GraphicsConsoleDxe/GraphicsConsole.h
>  create mode 100644 Platform/RaspberryPi/RPi3/Drivers/GraphicsConsoleDxe/GraphicsConsoleDxe.inf
>  create mode 100644 Platform/RaspberryPi/RPi3/Drivers/GraphicsConsoleDxe/GraphicsConsoleDxe.uni
>  create mode 100644 Platform/RaspberryPi/RPi3/Drivers/GraphicsConsoleDxe/GraphicsConsoleDxeExtra.uni
>  create mode 100644 Platform/RaspberryPi/RPi3/Drivers/GraphicsConsoleDxe/NewFont.c
>  create mode 100644 Platform/RaspberryPi/RPi3/Drivers/LogoDxe/License.txt
>  create mode 100644 Platform/RaspberryPi/RPi3/Drivers/LogoDxe/Logo.bmp
>  create mode 100644 Platform/RaspberryPi/RPi3/Drivers/LogoDxe/Logo.c
>  create mode 100644 Platform/RaspberryPi/RPi3/Drivers/LogoDxe/Logo.eps
>  create mode 100644 Platform/RaspberryPi/RPi3/Drivers/LogoDxe/Logo.idf
>  create mode 100644 Platform/RaspberryPi/RPi3/Drivers/LogoDxe/Logo.inf
>  create mode 100644 Platform/RaspberryPi/RPi3/Drivers/LogoDxe/Logo.uni
>  create mode 100644 Platform/RaspberryPi/RPi3/Drivers/LogoDxe/LogoDxe.inf
>  create mode 100644 Platform/RaspberryPi/RPi3/Drivers/LogoDxe/LogoDxe.uni
>  create mode 100644 Platform/RaspberryPi/RPi3/Drivers/LogoDxe/LogoDxeExtra.uni
>  create mode 100644 Platform/RaspberryPi/RPi3/Drivers/LogoDxe/LogoExtra.uni
>  create mode 100644 Platform/RaspberryPi/RPi3/Drivers/MmcDxe/ComponentName.c
>  create mode 100644 Platform/RaspberryPi/RPi3/Drivers/MmcDxe/Diagnostics.c
>  create mode 100644 Platform/RaspberryPi/RPi3/Drivers/MmcDxe/Mmc.c
>  create mode 100644 Platform/RaspberryPi/RPi3/Drivers/MmcDxe/Mmc.h
>  create mode 100644 Platform/RaspberryPi/RPi3/Drivers/MmcDxe/MmcBlockIo.c
>  create mode 100644 Platform/RaspberryPi/RPi3/Drivers/MmcDxe/MmcDebug.c
>  create mode 100644 Platform/RaspberryPi/RPi3/Drivers/MmcDxe/MmcDxe.inf
>  create mode 100644 Platform/RaspberryPi/RPi3/Drivers/MmcDxe/MmcIdentification.c
>  create mode 100644 Platform/RaspberryPi/RPi3/Drivers/PlatformSmbiosDxe/PlatformSmbiosDxe.c
>  create mode 100644 Platform/RaspberryPi/RPi3/Drivers/PlatformSmbiosDxe/PlatformSmbiosDxe.inf
>  create mode 100644 Platform/RaspberryPi/RPi3/Drivers/RpiFirmwareDxe/RpiFirmwareDxe.c
>  create mode 100644 Platform/RaspberryPi/RPi3/Drivers/RpiFirmwareDxe/RpiFirmwareDxe.inf
>  create mode 100644 Platform/RaspberryPi/RPi3/Drivers/SdHostDxe/SdHostDxe.c
>  create mode 100644 Platform/RaspberryPi/RPi3/Drivers/SdHostDxe/SdHostDxe.inf
>  create mode 100644 Platform/RaspberryPi/RPi3/Drivers/VarBlockServiceDxe/FileIo.c
>  create mode 100644 Platform/RaspberryPi/RPi3/Drivers/VarBlockServiceDxe/FvbInfo.c
>  create mode 100644 Platform/RaspberryPi/RPi3/Drivers/VarBlockServiceDxe/VarBlockService.c
>  create mode 100644 Platform/RaspberryPi/RPi3/Drivers/VarBlockServiceDxe/VarBlockService.h
>  create mode 100644 Platform/RaspberryPi/RPi3/Drivers/VarBlockServiceDxe/VarBlockServiceDxe.c
>  create mode 100644 Platform/RaspberryPi/RPi3/Drivers/VarBlockServiceDxe/VarBlockServiceDxe.inf
>  create mode 100644 Platform/RaspberryPi/RPi3/Include/IndustryStandard/RpiMbox.h
>  create mode 100644 Platform/RaspberryPi/RPi3/Include/Protocol/DwUsb.h
>  create mode 100644 Platform/RaspberryPi/RPi3/Include/Protocol/ExtendedTextOut.h
>  create mode 100644 Platform/RaspberryPi/RPi3/Include/Protocol/RpiFirmware.h
>  create mode 100644 Platform/RaspberryPi/RPi3/Include/Protocol/RpiMmcHost.h
>  create mode 100644 Platform/RaspberryPi/RPi3/Library/MemoryInitPeiLib/MemoryInitPeiLib.c
>  create mode 100644 Platform/RaspberryPi/RPi3/Library/MemoryInitPeiLib/MemoryInitPeiLib.inf
>  create mode 100644 Platform/RaspberryPi/RPi3/Library/PlatformBootManagerLib/PlatformBm.c
>  create mode 100644 Platform/RaspberryPi/RPi3/Library/PlatformBootManagerLib/PlatformBm.h
>  create mode 100644 Platform/RaspberryPi/RPi3/Library/PlatformBootManagerLib/PlatformBootManagerLib.inf
>  create mode 100644 Platform/RaspberryPi/RPi3/Library/PlatformLib/AArch64/RaspberryPiHelper.S
>  create mode 100644 Platform/RaspberryPi/RPi3/Library/PlatformLib/PlatformLib.inf
>  create mode 100644 Platform/RaspberryPi/RPi3/Library/PlatformLib/RaspberryPi.c
>  create mode 100644 Platform/RaspberryPi/RPi3/Library/PlatformLib/RaspberryPiMem.c
>  create mode 100644 Platform/RaspberryPi/RPi3/Library/PlatformUiAppLib/PlatformUiAppLib.c
>  create mode 100644 Platform/RaspberryPi/RPi3/Library/PlatformUiAppLib/PlatformUiAppLib.inf
>  create mode 100644 Platform/RaspberryPi/RPi3/Library/ResetLib/ResetLib.c
>  create mode 100644 Platform/RaspberryPi/RPi3/Library/ResetLib/ResetLib.inf
>  create mode 100644 Platform/RaspberryPi/RPi3/RPi3.dec
>  create mode 100644 Platform/RaspberryPi/RPi3/RPi3.dsc
>  create mode 100644 Platform/RaspberryPi/RPi3/RPi3.fdf
>  create mode 100644 Platform/RaspberryPi/RPi3/Readme.md
>  create mode 100644 Platform/RaspberryPi/RPi3/Systems.md
>  create mode 100644 Platform/RaspberryPi/RPi3/TrustedFirmware/License.txt
>  create mode 100644 Platform/RaspberryPi/RPi3/TrustedFirmware/Readme.md
>  create mode 100644 Platform/RaspberryPi/RPi3/TrustedFirmware/bl1.bin
>  create mode 100644 Platform/RaspberryPi/RPi3/TrustedFirmware/fip.bin
>  create mode 100644 Silicon/Broadcom/Bcm283x/Bcm283x.dec
>  create mode 100644 Silicon/Broadcom/Bcm283x/Drivers/InterruptDxe/InterruptDxe.c
>  create mode 100644 Silicon/Broadcom/Bcm283x/Drivers/InterruptDxe/InterruptDxe.inf
>  create mode 100644 Silicon/Broadcom/Bcm283x/Include/IndustryStandard/Bcm2836.h
>  create mode 100644 Silicon/Broadcom/Bcm283x/Include/IndustryStandard/Bcm2836Gpio.h
>  create mode 100644 Silicon/Broadcom/Bcm283x/Include/IndustryStandard/Bcm2836SdHost.h
>  create mode 100644 Silicon/Broadcom/Bcm283x/Include/IndustryStandard/Bcm2836Sdio.h
>  create mode 100644 Silicon/Broadcom/Bcm283x/Include/Library/GpioLib.h
>  create mode 100644 Silicon/Broadcom/Bcm283x/Library/GpioLib/GpioLib.c
>  create mode 100644 Silicon/Broadcom/Bcm283x/Library/GpioLib/GpioLib.inf
> 
> -- 
> 2.17.0.windows.1
> 


^ permalink raw reply	[flat|nested] 34+ messages in thread

* Re: [PATCH v5 edk2-platforms 00/22] Platform/RaspberryPi: Add Raspberry Pi 3 support
  2019-02-13  3:41 ` [PATCH v5 edk2-platforms 00/22] Platform/RaspberryPi: Add Raspberry Pi 3 support Jeremy Linton
@ 2019-02-15 10:27   ` Ard Biesheuvel
  2019-02-15 11:05     ` Ard Biesheuvel
  0 siblings, 1 reply; 34+ messages in thread
From: Ard Biesheuvel @ 2019-02-15 10:27 UTC (permalink / raw)
  To: Jeremy Linton; +Cc: Pete Batard, edk2-devel@lists.01.org

On Wed, 13 Feb 2019 at 04:50, Jeremy Linton <jeremy.linton@arm.com> wrote:
>
> the
> Hi,
>
> On 2/5/19 10:25 AM, Pete Batard wrote:
> > Changes for v5:
> >
> > * Raspberry/Pi3 -> RaspberryPi/RPi3
> > * Remove VirtualRealTimeClockLib as well as BUILD_EPOCH macro (use the upcoming
> >    EmbeddedPkg Virtual RTC from EDK2 instead)
> > * Use $(PLATFORM_NAME) where possible in .dsc and .fdf
> > * Update Readme to remove build instructions, describe ACPI limitations, fix
> >    ATF Readme link and split OS installation & test notes into a separate file.
> > * Add -Wl,--fix-cortex-a53-843419 to LINK_FLAGS
> >
> > IMPORTANT: Due to the removal of VirtualRealTimeClockLib this series requires
> > https://lists.01.org/pipermail/edk2-devel/2019-February/036301.html to have
> > been applied to your edk2 repository.
>
> I would just like to congratulate everyone working on this port. It is
> crazy awesome! I just applied these patches, followed the readme
> instructions for the SD card. Then grabbed a USB DVD drive, and a USB
> SSD, plugged in a keyboard/mouse/monitor/network and booted the fedora
> 29 1.2 install ISO. The graphical installer ran as expected, system
> installed as expected, and other than the nextboot not being reset (had
> to update it via the BDS, as is documented) it "just worked".
>
> There are a few rough edges here/there but the idea that we have another
> ARM machine that almost behaves like one expects a modern computing
> device to behave, is wonderful. The only real gocha continues to be the
> rpi's well known shortcomings, including the fact that it took nearly 6
> hours to install.
>
>
> so,
>
> Tested-by: Jeremy Linton <jeremy.linton@arm.com>
>

Thanks Jeremy.

I fully agree, and I am quite happy to have an example to point to the
next time someone wants to contribute some 96boards UEFI port that
looks like u-boot and only runs on the serial port


^ permalink raw reply	[flat|nested] 34+ messages in thread

* Re: [PATCH v5 edk2-platforms 00/22] Platform/RaspberryPi: Add Raspberry Pi 3 support
  2019-02-15 10:27   ` Ard Biesheuvel
@ 2019-02-15 11:05     ` Ard Biesheuvel
  2019-02-15 14:56       ` Pete Batard
  0 siblings, 1 reply; 34+ messages in thread
From: Ard Biesheuvel @ 2019-02-15 11:05 UTC (permalink / raw)
  To: Jeremy Linton; +Cc: Pete Batard, edk2-devel@lists.01.org

On Fri, 15 Feb 2019 at 11:27, Ard Biesheuvel <ard.biesheuvel@linaro.org> wrote:
>
> On Wed, 13 Feb 2019 at 04:50, Jeremy Linton <jeremy.linton@arm.com> wrote:
> >
> > the
> > Hi,
> >
> > On 2/5/19 10:25 AM, Pete Batard wrote:
> > > Changes for v5:
> > >
> > > * Raspberry/Pi3 -> RaspberryPi/RPi3
> > > * Remove VirtualRealTimeClockLib as well as BUILD_EPOCH macro (use the upcoming
> > >    EmbeddedPkg Virtual RTC from EDK2 instead)
> > > * Use $(PLATFORM_NAME) where possible in .dsc and .fdf
> > > * Update Readme to remove build instructions, describe ACPI limitations, fix
> > >    ATF Readme link and split OS installation & test notes into a separate file.
> > > * Add -Wl,--fix-cortex-a53-843419 to LINK_FLAGS
> > >
> > > IMPORTANT: Due to the removal of VirtualRealTimeClockLib this series requires
> > > https://lists.01.org/pipermail/edk2-devel/2019-February/036301.html to have
> > > been applied to your edk2 repository.
> >
> > I would just like to congratulate everyone working on this port. It is
> > crazy awesome! I just applied these patches, followed the readme
> > instructions for the SD card. Then grabbed a USB DVD drive, and a USB
> > SSD, plugged in a keyboard/mouse/monitor/network and booted the fedora
> > 29 1.2 install ISO. The graphical installer ran as expected, system
> > installed as expected, and other than the nextboot not being reset (had
> > to update it via the BDS, as is documented) it "just worked".
> >
> > There are a few rough edges here/there but the idea that we have another
> > ARM machine that almost behaves like one expects a modern computing
> > device to behave, is wonderful. The only real gocha continues to be the
> > rpi's well known shortcomings, including the fact that it took nearly 6
> > hours to install.
> >
> >
> > so,
> >
> > Tested-by: Jeremy Linton <jeremy.linton@arm.com>
> >
>
> Thanks Jeremy.
>
> I fully agree, and I am quite happy to have an example to point to the
> next time someone wants to contribute some 96boards UEFI port that
> looks like u-boot and only runs on the serial port

For the series

Reviewed-by: Ard Biesheuvel <ard.biesheuvel@linaro.org>

edk2-non-osi pieces pushed as

863a3237a74c Platform/RaspberryPi/RPi3: Add ATF binaries
9c52bc5c0f14 Platform/RaspberryPi/RPi3: Add Device Tree binaries
635f97e09aaa Platform/RaspberryPi/RPi3: Add logo driver

edk2-platforms pieces pushed as 06454982de98..94d6843f1a90

Thanks again, Pete, and everyone else for the excellent work.

/me goes and updates his blog


^ permalink raw reply	[flat|nested] 34+ messages in thread

* Re: [PATCH v5 edk2-platforms 00/22] Platform/RaspberryPi: Add Raspberry Pi 3 support
  2019-02-15 11:05     ` Ard Biesheuvel
@ 2019-02-15 14:56       ` Pete Batard
  0 siblings, 0 replies; 34+ messages in thread
From: Pete Batard @ 2019-02-15 14:56 UTC (permalink / raw)
  To: Ard Biesheuvel, Jeremy Linton; +Cc: edk2-devel@lists.01.org

Awesome!

Thanks a lot to all the people on this list who helped with the review 
process, provided advice, or tested this series.

Regards,

/Pete

On 2019-02-15 12:05, Ard Biesheuvel wrote:
> On Fri, 15 Feb 2019 at 11:27, Ard Biesheuvel <ard.biesheuvel@linaro.org> wrote:
>>
>> On Wed, 13 Feb 2019 at 04:50, Jeremy Linton <jeremy.linton@arm.com> wrote:
>>>
>>> the
>>> Hi,
>>>
>>> On 2/5/19 10:25 AM, Pete Batard wrote:
>>>> Changes for v5:
>>>>
>>>> * Raspberry/Pi3 -> RaspberryPi/RPi3
>>>> * Remove VirtualRealTimeClockLib as well as BUILD_EPOCH macro (use the upcoming
>>>>     EmbeddedPkg Virtual RTC from EDK2 instead)
>>>> * Use $(PLATFORM_NAME) where possible in .dsc and .fdf
>>>> * Update Readme to remove build instructions, describe ACPI limitations, fix
>>>>     ATF Readme link and split OS installation & test notes into a separate file.
>>>> * Add -Wl,--fix-cortex-a53-843419 to LINK_FLAGS
>>>>
>>>> IMPORTANT: Due to the removal of VirtualRealTimeClockLib this series requires
>>>> https://lists.01.org/pipermail/edk2-devel/2019-February/036301.html to have
>>>> been applied to your edk2 repository.
>>>
>>> I would just like to congratulate everyone working on this port. It is
>>> crazy awesome! I just applied these patches, followed the readme
>>> instructions for the SD card. Then grabbed a USB DVD drive, and a USB
>>> SSD, plugged in a keyboard/mouse/monitor/network and booted the fedora
>>> 29 1.2 install ISO. The graphical installer ran as expected, system
>>> installed as expected, and other than the nextboot not being reset (had
>>> to update it via the BDS, as is documented) it "just worked".
>>>
>>> There are a few rough edges here/there but the idea that we have another
>>> ARM machine that almost behaves like one expects a modern computing
>>> device to behave, is wonderful. The only real gocha continues to be the
>>> rpi's well known shortcomings, including the fact that it took nearly 6
>>> hours to install.
>>>
>>>
>>> so,
>>>
>>> Tested-by: Jeremy Linton <jeremy.linton@arm.com>
>>>
>>
>> Thanks Jeremy.
>>
>> I fully agree, and I am quite happy to have an example to point to the
>> next time someone wants to contribute some 96boards UEFI port that
>> looks like u-boot and only runs on the serial port
> 
> For the series
> 
> Reviewed-by: Ard Biesheuvel <ard.biesheuvel@linaro.org>
> 
> edk2-non-osi pieces pushed as
> 
> 863a3237a74c Platform/RaspberryPi/RPi3: Add ATF binaries
> 9c52bc5c0f14 Platform/RaspberryPi/RPi3: Add Device Tree binaries
> 635f97e09aaa Platform/RaspberryPi/RPi3: Add logo driver
> 
> edk2-platforms pieces pushed as 06454982de98..94d6843f1a90
> 
> Thanks again, Pete, and everyone else for the excellent work.
> 
> /me goes and updates his blog
> 



^ permalink raw reply	[flat|nested] 34+ messages in thread

end of thread, other threads:[~2019-02-15 14:56 UTC | newest]

Thread overview: 34+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2019-02-05 16:25 [PATCH v5 edk2-platforms 00/22] Platform/RaspberryPi: Add Raspberry Pi 3 support Pete Batard
2019-02-05 16:25 ` [PATCH v5 edk2-platforms 01/22] Silicon/Broadcom/Bcm283x: Add interrupt driver Pete Batard
2019-02-05 16:25 ` [PATCH v5 edk2-platforms 02/22] Silicon/Broadcom/Bcm283x: Add GpioLib Pete Batard
2019-02-05 16:25 ` [PATCH v5 edk2-platforms 03/22] Platform/RaspberryPi/RPi3: Add ACPI tables Pete Batard
2019-02-05 16:25 ` [PATCH v5 edk2-platforms 04/22] Platform/RaspberryPi/RPi3: Add reset and memory init libraries Pete Batard
2019-02-05 16:25 ` [PATCH v5 edk2-platforms 05/22] Platform/RaspberryPi/RPi3: Add platform library Pete Batard
2019-02-05 16:25 ` [PATCH v5 edk2-platforms 06/22] Platform/RaspberryPi/RPi3: Add firmware driver Pete Batard
2019-02-05 16:25 ` [PATCH v5 edk2-platforms 07/22] Platform/RaspberryPi/RPi3: Add platform config driver Pete Batard
2019-02-05 16:25 ` [PATCH v5 edk2-platforms 08/22] Platform/RaspberryPi/RPi3: Add SMBIOS driver Pete Batard
2019-02-05 16:25 ` [PATCH v5 edk2-platforms 09/22] Platform/RaspberryPi/RPi3: Add display driver Pete Batard
2019-02-05 16:25 ` [PATCH v5 edk2-platforms 10/22] Platform/RaspberryPi/RPi3: Add console driver Pete Batard
2019-02-05 16:25 ` [PATCH v5 edk2-platforms 11/22] Platform/RaspberryPi/RPi3: Add NV storage driver Pete Batard
2019-02-05 16:25 ` [PATCH v5 edk2-platforms 12/22] Platform/RaspberryPi/RPi3: Add Device Tree driver Pete Batard
2019-02-05 16:25 ` [PATCH v5 edk2-platforms 13/22] Platform/RaspberryPi/RPi3: Add base MMC driver Pete Batard
2019-02-05 16:25 ` [PATCH v5 edk2-platforms 14/22] Platform/RaspberryPi/RPi3: Add Arasan " Pete Batard
2019-02-05 16:25 ` [PATCH v5 edk2-platforms 15/22] Platform/RaspberryPi/RPi3: Add SD Host driver Pete Batard
2019-02-05 16:25 ` [PATCH v5 edk2-platforms 16/22] Platform/RaspberryPi/RPi3: Add platform boot manager and helper libs Pete Batard
2019-02-05 16:25 ` [PATCH v5 edk2-platforms 17/22] Platform/RaspberryPi/RPi3: Add USB host driver Pete Batard
2019-02-05 16:25 ` [PATCH v5 edk2-platforms 18/22] Platform/RaspberryPi/RPi3 *NON-OSI*: Add ATF binaries Pete Batard
2019-02-06 22:39   ` Kinney, Michael D
2019-02-07  0:52     ` Pete Batard
2019-02-07  2:35       ` Kinney, Michael D
2019-02-07 11:26         ` Pete Batard
2019-02-07 14:25           ` Ard Biesheuvel
2019-02-05 16:25 ` [PATCH v5 edk2-platforms 19/22] Platform/RaspberryPi/RPi3 *NON-OSI*: Add Device Tree binaries Pete Batard
2019-02-05 16:25 ` [PATCH v5 edk2-platforms 20/22] Platform/RaspberryPi/RPi3 *NON-OSI*: Add logo driver Pete Batard
2019-02-05 16:25 ` [PATCH v5 edk2-platforms 21/22] Platform/RaspberryPi/RPi3: Add platform Pete Batard
2019-02-05 16:25 ` [PATCH v5 edk2-platforms 22/22] Platform/RaspberryPi/RPi3: Add platform readme's Pete Batard
2019-02-14 18:42   ` Leif Lindholm
2019-02-13  3:41 ` [PATCH v5 edk2-platforms 00/22] Platform/RaspberryPi: Add Raspberry Pi 3 support Jeremy Linton
2019-02-15 10:27   ` Ard Biesheuvel
2019-02-15 11:05     ` Ard Biesheuvel
2019-02-15 14:56       ` Pete Batard
2019-02-14 18:45 ` Leif Lindholm

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox