From: Pete Batard <pete@akeo.ie>
To: edk2-devel@lists.01.org
Subject: [PATCH v1 edk2-platfoms 2/2] Platform/Broadcom: Add Raspberry Pi 3 support (non OSI)
Date: Fri, 7 Dec 2018 12:05:11 +0000 [thread overview]
Message-ID: <20181207120511.8724-3-pete@akeo.ie> (raw)
In-Reply-To: <20181207120511.8724-1-pete@akeo.ie>
This commit contains the edk2-non-osi components that introduce
support for the Raspberry Pi 3 as a platform, based on the original
work by Ard Biesheuvel and Andrei Warkentin.
Usage of the Raspberry Pi logo for this work was obtained with kind
permission from the Raspberry Pi Foundation.
Contributed-under: TianoCore Contribution Agreement 1.1
Signed-off-by: Pete Batard <pete@akeo.ie>
---
Platform/Broadcom/Bcm283x/Binary/License.txt | 26 +
Platform/Broadcom/Bcm283x/Binary/README.md | 41 +
Platform/Broadcom/Bcm283x/Binary/bl1.bin | Bin 0 -> 18801 bytes
Platform/Broadcom/Bcm283x/Binary/fip.bin | Bin 0 -> 41714 bytes
Platform/Broadcom/Bcm283x/DeviceTree/License.txt | 340 ++++
Platform/Broadcom/Bcm283x/DeviceTree/bcm2710-rpi-3-b-plus.dtb | Bin 0 -> 25617 bytes
Platform/Broadcom/Bcm283x/DeviceTree/bcm2710-rpi-3-b-plus.dts | 1263 +++++++++++++++
Platform/Broadcom/Bcm283x/DeviceTree/bcm2710-rpi-3-b.dtb | Bin 0 -> 25354 bytes
Platform/Broadcom/Bcm283x/DeviceTree/bcm2710-rpi-3-b.dts | 1259 +++++++++++++++
Platform/Broadcom/Bcm283x/Drivers/DwUsbHostDxe/ComponentName.c | 219 +++
Platform/Broadcom/Bcm283x/Drivers/DwUsbHostDxe/DriverBinding.c | 269 ++++
Platform/Broadcom/Bcm283x/Drivers/DwUsbHostDxe/DwUsbHostDxe.c | 1644 ++++++++++++++++++++
Platform/Broadcom/Bcm283x/Drivers/DwUsbHostDxe/DwUsbHostDxe.h | 159 ++
Platform/Broadcom/Bcm283x/Drivers/DwUsbHostDxe/DwUsbHostDxe.inf | 52 +
Platform/Broadcom/Bcm283x/Drivers/DwUsbHostDxe/DwcHw.h | 782 ++++++++++
Platform/Broadcom/Bcm283x/Drivers/DwUsbHostDxe/License.txt | 340 ++++
Platform/Broadcom/Bcm283x/Drivers/Logo/License.txt | 10 +
Platform/Broadcom/Bcm283x/Drivers/Logo/Logo.bmp | Bin 0 -> 185398 bytes
Platform/Broadcom/Bcm283x/Drivers/Logo/Logo.c | 159 ++
Platform/Broadcom/Bcm283x/Drivers/Logo/Logo.eps | Bin 0 -> 250982 bytes
Platform/Broadcom/Bcm283x/Drivers/Logo/Logo.idf | 18 +
Platform/Broadcom/Bcm283x/Drivers/Logo/Logo.inf | 34 +
Platform/Broadcom/Bcm283x/Drivers/Logo/Logo.uni | 20 +
Platform/Broadcom/Bcm283x/Drivers/Logo/LogoDxe.inf | 63 +
Platform/Broadcom/Bcm283x/Drivers/Logo/LogoDxe.uni | 19 +
| 19 +
| 19 +
27 files changed, 6755 insertions(+)
diff --git a/Platform/Broadcom/Bcm283x/Binary/License.txt b/Platform/Broadcom/Bcm283x/Binary/License.txt
new file mode 100644
index 000000000000..b98dc643227e
--- /dev/null
+++ b/Platform/Broadcom/Bcm283x/Binary/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/Broadcom/Bcm283x/Binary/README.md b/Platform/Broadcom/Bcm283x/Binary/README.md
new file mode 100644
index 000000000000..9811a1286093
--- /dev/null
+++ b/Platform/Broadcom/Bcm283x/Binary/README.md
@@ -0,0 +1,41 @@
+ARM Trusted Firmware for Raspberry Pi 3
+=======================================
+
+The `bl1` and `fip` ATF binaries, found in this directory, were built from
+the [latest ATF](https://github.com/ARM-software/arm-trusted-firmware)
+(commit c3859557) using Linaro's GCC 5.5 compiler with:
+
+```
+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/Broadcom/Bcm283x/Binary/bl1.bin b/Platform/Broadcom/Bcm283x/Binary/bl1.bin
new file mode 100644
index 0000000000000000000000000000000000000000..e25138828d0a4ddb24772abb1a60eefc334666b5
GIT binary patch
literal 18801
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
literal 0
HcmV?d00001
diff --git a/Platform/Broadcom/Bcm283x/Binary/fip.bin b/Platform/Broadcom/Bcm283x/Binary/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
diff --git a/Platform/Broadcom/Bcm283x/DeviceTree/License.txt b/Platform/Broadcom/Bcm283x/DeviceTree/License.txt
new file mode 100644
index 000000000000..1603937dad82
--- /dev/null
+++ b/Platform/Broadcom/Bcm283x/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/Broadcom/Bcm283x/DeviceTree/bcm2710-rpi-3-b-plus.dtb b/Platform/Broadcom/Bcm283x/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/Broadcom/Bcm283x/DeviceTree/bcm2710-rpi-3-b-plus.dts b/Platform/Broadcom/Bcm283x/DeviceTree/bcm2710-rpi-3-b-plus.dts
new file mode 100644
index 000000000000..e22c5d055f47
--- /dev/null
+++ b/Platform/Broadcom/Bcm283x/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/Broadcom/Bcm283x/DeviceTree/bcm2710-rpi-3-b.dtb b/Platform/Broadcom/Bcm283x/DeviceTree/bcm2710-rpi-3-b.dtb
new file mode 100644
index 0000000000000000000000000000000000000000..14c78a9eead443adefd229f81ad0ace70c8e0ec7
GIT binary patch
literal 25354
zcmd5^eT-#ERll!$KDxod0Tx&gc6+90nE~c*zxTR(rU&`Bu6!;mj35Fd@aFY<Z@TZ!
z`{Lc#Uz^wtuEIYqf-wk06!`-}j3FV2L`@w3Fi`|Tkf?tk!MG|Kh>{S38eM<CQ+4Xr
z{dn)qE(@`edvDdLQ>V^3b?Q{zx>fhfC;s=_LC|_a5CpFZg13(GJcsMaxK83iSo{Fs
z=S^JiHcOM{S+U7^JeL_CHIw0HXEZt(#^+bV-k{y-hMU3WsMR~a+3M9dRxe5k;y(k|
z6W^ftOPAxN)usDbVCf!*a|AK+#d=tV>C?G%&892OZrn^d36g^QG(2Ctk_=iaNoN!{
zyV1o?y|!Lms}cc$^oaBF98R@Xt@=1m1kQbe)7)vt1EfsZ+wgp&h3`kzeM8<9C2f{_
zv!OlM>9>(G<&NU{cESZ>U{683DY)%k6O2}?7abF%wT!DH`Eh>?_3jMEVQbJIj|Sat
zXCwtS>y~TcQ@8gE{$6w3+HMcFfJ3=F9M+i#&Zuv)*ECyn^K|4tAo;y!+}#}Pn`$;T
zta4b-Q*r&0;A{=!0T9515@9~|`yR<p+aRxB^6`+Vr`Hk^Bmy7;X)ymcX5@cJ^5c3U
z<yQ;kKVo<o#*&|vlk`7k%bWVwGvz76CrtT?c0?M#@7DoC^Yz61Pv`PmIT`;@@_V8K
zN|4vVAJ53YDfw}oGHk%i^X30Mlb@B5{C!^Xcalw%zqFC9{}}SWw9@UgrFWTjSpe*>
zrOdTWM5V20^M50--PU&ePJ*2+eNEuw?aruYJ7cz;PXPB}!D;Tt!_MfMls4thApR}M
z^Z8prq88Qo=#XwiR}jqMs<gHTNvF@G)PEAs?`_oAt9SQDjh*IboV+;2wJe1X4En}<
zu>5c*v~Z<C-}49)2((M2E3l3EZ+huv#92S{p`Xg?Bai&gKL^KNebvHPCPG|%R%<Zm
z#{I3Z*Bn~4N?Dc{8LW#SE$TH$;@+^^2{(5PHsR#yG%nvi3T?oce><{Xb%@AIEmDLh
zFYD@w^JBny{Y`=ph=*WlS0cpgxGF`rBsfn-p6}h)Lm(1{KpND+mBV0&=#MMx24L?%
zf;_Wb_#_=ZX@`8$ukcA9%P0FFpY%z5(!cQu`Q-Ub`+Syt{=|&uvyo5!8Ymuv<!XRi
zjkh{)tGuo8w$9rH-Y)XC!P_O?YNm*ksY#)ll&VRwFxhU7I_<F8?V^@cp9hGOZ`JQF
z2f;6{dFcpowzahXY*#OIr~|(ZE`-fduQeWZ!??vPuN^*(BuNVlkIIK_oObys#F=S%
zlQv=8rlrl;=QSN6PFaN4@?l1B*@ixU>*25$?zP7Rla{d&T7sE}`1J1rOz5|U@EU!1
zrkWc*h*zX-5J^kv+(cY;ZtG%YOSl9F`mcNuarPyS%?y0944<r@{*QrA!uj-cRrxB?
z$8l+$5#rR9@Ln8V1+Un5fQT{-q+@xFm?pytW8Wd&=U5oqE<*gdxTL=F;abYGe`VXE
zhk>2Ils@|F=WZY!c`(+=pn7DTe{VoSS9xH+6CR4wfeG~!(GXJkt{g52;4`=r2HC~-
zNS8X}lX5T*q4KY|F-{)-6Hn%A-W2<;M8Kn7EA3(2ARARA5Lk8yGHMHyS!tpUu?e<6
z+na5?h>LS+_FMSUfaBPcaM9tBK6xg;^l7wL`ZD@4`Y`rg`Y!q{>dwkB$Fi)$riIs4
zq{&C6gE@jQT(2W3IG`i^-U{8kox=WebXN(=&^?XxGOjbY?!rY|JB!QbSLu=$+9m_}
z&0oGu>oz}?X>Eh$h@&#GS!%c_EOkKUSgx#YwZjX@7hP=)Tixqb(Uu71m1Fy|J$*V}
zx)LGpBCeE9P3W+01}#TAyfn?W%hRDyc{*#-dTBY*c>WAJm&)i^!L)wT;k%or%lLU=
zhE84NqRtq!9O-yAC^ngw>nDMe%4O)Rv5^pbIxq0jW&FGd`9cTNSJPUiGm-}SSf(#3
z-7-2aF3_nvdr~?a`#s-TD%VR2bk<y-P&(9ch|A~4vx7>6JWi)nE@M5W(S5m?&$Le`
zuji;h=hpb~+E4iTDUVJg={9#e()2Y^lH~zDOZ5E|q<x>|^QV0sd<xxrl<xiG=9bsn
zSmriMk20xEsh{*|sveZ)PZwxDHh;%DY(13-@s}yxVXNm$Pn=tkopSi}UY@6COipl=
zp4!|Uz`ZjqU+U*y;ppx4OkcqK(knw9Qh%0*Qu}=+^2P3kj)v<8;NP{cPb07YR~2ZO
zr4ubfKF-bH<JBGwWB-^Xdu2$2<E7Fp>(lolUuCg0=muRG(x9FCH1e{%2KiYUYaCKs
z8Pa&3moDSuwaCxWkfA{9C5^m4$lJ<&N+W6G1$AtCitT))bGvODdcRp?UY<5>LikID
zv9TMDUPeakgY38PUzs_J@?R$N>wuf3x$0zAn#;gBgX=C_W%GhOpRf05+V+&8$Cn@d
zrgYxq^UAnQS0cnO<5FJjNJKRXj_Q^6%68^B%Q5LZu6>HZ9Ggf7<&Y=@M=0C3_$
zpVFUn&S!Zl?U!%J(rS$pEJYY6<aD6)R0lr2yx)D}M0%@EcBNP5d-C*tHcOAQ;#D(Z
zWo2Cg-YHzuczaU`Eq{)oe5vjDwDRND&t++OdRujVP3e`{V4mKaeR|diZ?#Qn3zpYP
zg!o&sv^?Hwx74P2dT-6rdsJ<Zr*$Pu%j50V>?2R_=d<+4TV_37+u$7V^8PeW>up(D
z9&cu5OdTsd?XSL#<mtU#>G6H8wy_x-_v-oq+9@-S^vb(=Ntu77U*#C3{agFxwE0oq
z-uV8^`YPg^hjBka0)g^?zVNk(_!DsPJ<^vm??1^$N~@JLQgTvGb%v+ECL#XFe}9jV
zPoFQeIPXTB!Ph&}UYSy#_GI8F4H;B(G?+)4(`0&DN<%b5T<F=&Q#ih3ypeb3X>{05
zMmP9U<0*z^bPPC+_%bf_J7xYt{UXcU>bor8;ic})v8!2m<=kM(JCLix;#VTz(-wrD
z8FySO6Gz*43GqpOm^eP~K5g2Xqg`|CN*ghY{1P8Q+Faw_ds8JsCfh~m$fvO^9p&*H
zaPqz&Z_}I~laA0T`BcREslV*n)v#Nw)dH+`p7&y-xYucQymeRbfi>tQc3WN|7h&2b
zx&A`>$dq+J<cVB-(&m^48=pJNcED;v&>U_yxU2v;1M?xz+-h*<B>Mu>2y^%1#yIHA
zHQJqP&7JO;84Bwmu6>>`=zMN(aJ_jzBm}}hw-VvWv0HRwJ`dHa>8BIHBcEB_m<cAq
zwm#}$2}yQm2U8uu&K>NFi2JgW|3kp&m)O5Z5B_cL!O?y=-bVs~urmJ3WT&nuJN+ul
zG5wHvy7X@%&7k?8MBMX3l?dsxxI`z#&wf&lZIRUp5D7ydUGPSoRGB{G!Bl>IPlH`J
z`B@+J!1BCA4^YC$(*xRcZm%6D%}snS0}camDd*=T<?1ik1#zgG6KR=Bg!mFJ(>DsA
zFokweRtz*K!@#<&tP!H6ec<UHp31Mb51vZDF##;JC&}yUjpHHprhc_dZ)LVZ81<oJ
zFJ*zP&iy5x6a@KV7mSm3-bPLl2352>yHOQ!2GSsIVBm}i402XDUt%E6EV<cMUpbz<
zHA?X-j5ly;Te036(hRfe^?0AE?@9GuMIEeH>NcN&>(%r#uhd_(6Ck1t1NpOdav4#o
z)WOtGaGX}W$IDL2+MP18-N`TOWBTEs^6rnO=}Lt7X<Q=jFy8NUcbnbaj(p+2V84E|
zEd6`d52VPxO<38l0-H_Y<W$*DSlA?c2am#26L@7j>5h(BJo)xwc^ZObDNpPdq&JJF
zP2~x5V^I*l?*qob@<qD<qU5G}fUmqk(68cR85oEgFX=15t6O(QU!ObM8jL!D=o&eu
z40JTrwr9!FLV3|`J27%x%F4kxdA6;AXayzDR-f-98eO)+w2jFhVYB!|e&r_cw9mpP
zIbAFPPF<|nC)<-Wq2sx;!|j8hleC&cUo$2jbE~=UlHJDU!MGDhtlb{r+cIH@fd+%+
zuM#27d79{>d|QR!vd{WDx#(|fKo;p4y_{M?RCrgI_Hpmq)V%mk;1Q>6%%^T5<dHAo
zt+|um9wlXqHU~tMVIb|ijxCRunNR)ZdDQWWcx+F$jm}q@{ID%Ux}UQ7T2F*DZAbV`
z=bvu781Xnp`g&Xs!EeY(Av02bt{k4a93jn1>60G@pJ%aE3!9)v>6gT_<tEM-I1ksl
zBE&g&F|wHc?rldByu3{qS<2=Nr!L<Btq7OWSKa1i(Y^rvKGr^-kyq`g4SG3QGViL7
zMwXkP72)z_A?>^@3VXa|>7Xu=1?%$Shg(_yRqPW$L>UI<5q|h4)8{;x_R~93*gS2Y
z{X}7qWj+i(_<<W1hv|C|S6OHI-fI@Ovc1b~cHCe#V+;Wz$}pt7M@(MjO<}Yr(TRo4
z;$utk;TORNht&)p(yzQ7r`VH}#B{<4TIZF+p`>*zQ=dUTy!Vo+b`1SZ90Qg?hq~v`
z!)F~A>%P@7pytMa8a=;^0TKfZ2GW|PC(gM=uPuxpP?T)xBSQ!*Pk)*9XFL74)f97M
z{z=Gp<?sfv7J|bYON_8TFwfT)>rt56VQ681&z<cWT@#1pPvi1^g>4$4k=N-Y8BzcI
zeV{`by!NU@NN?j(xoaYKx}ldm+@jnN-^fj#%jD)bNP5(T%6+$m0scdm`-H8FI*SmG
zaaD!`9gc!Zr{5k9u!#(C2FvR_*KnzS>d3z;=AFUcIx1y~KB?@T;YI{<)S1@f)>nSi
z?+jWW^iulHunZo>K2+Yv^p14n@{dy9NwRQGBC_mu%(h>B@v-etY&#$#kHOjl`}kEP
zGi|5#jCrlYQ$MY9!AX5n?eTt;72eX<E$NN7`W{4|$>8xhM3ScKV9FEMN{Kg%r|ZBG
zp0?XP4jz}hg*28gjvYiq1_JY;B<SmXONbtWPrQMr<A-_54}5~u1Ae3&bTZHJQ`cFD
zt2#!UK1AMAS%<tknb#&)IpM%@>riZ0!YJ>9vi2J45|o3NtwDi?^P7BkAPxA>dA8Lv
zaDh+XH&-I0ySPMW{?=>27+Ah&V?dN#lW%nPK|r9Y!{90+6j{oGA2(O`bTxB~pzhQ*
z!SmeN!I;wmp-ElS=jpmG=*}O2rFzJhFB8bOuL~W+P*!B_A-{q$*j+9Kh|h5*0Bo(k
zcK*^j_W2?Z&N5s#q9NGyME*(B+o~@3KHU!HgCL`H@^po_KJwWfdR2B;+c0I$Bs24%
z6C@<_pxxG52qdNv$RqWB<?tqxrEQ`8$=8v>Xme$@rMeq{sMyQaaEBGJzM_qQCuSlr
ze-_OlaD--e&}w!Y7}Q#knSiGH%D)F(2)nhAn5+cB$sI}3^;@K-y&DSeEXzw}WL)?u
z9@h}OGsw@*t$>&XV1d3B6V35;C{6G9(!RlZ?(p!`Z}6LmE$jRO*H{UIJr~yJ!TX%Q
zu3q-ei8?2~V?N8$=Ho#dC(VZt$5ZOXvl1bG4wvZXT0H9QVJrOg9^V-_I%RB>?<kow
zW20dlYMBs)n2%uPgw0-MvQ$SjWa5E``S;_g^RrpD^-kaluZau^1s;pG3q+J*cr<*m
zJ+<wgpO$s+X$m9%p|`HgHaP@7+g9~l*1ogk9HG3(=^d{j|M`A{wSdC;8|W6g4~!E(
z{KgFwb8P^gGW*|W@$o$6gS!WMogR{+$08pdg2kZ@@&3yqZ0@X$5r9CM3U*}<AFeyw
z5=?_jeg6*9I<KKT5z@3D(bsUW*P-$dNSpm2W3x&-hnLq2>-ji}QgNiC_1uQI=_{Lv
znLH8By~AFtZiML>t32JZeyp_Fe}r~=982ovdQsLLr3mEB=sEaYggEyID2($P2GX=L
z%>NPMOKCb|3(5!E!}5_xgIj!AoA=L*sxEh18N5d$Gsk|ZD?P3`LFN=eW%)eHLUzHQ
zWXJ4}`R}>lPrg^EPgc3lC@+aS0y>qpmgB%_WEk~uT!u+0C-YN&@W$HuxU(NNFKVu9
zkHUDxHiIly|M6(dZbgC!l)JdDxtl>E4#LE97UcP>Ku~`>%^s`36S+G3LuG^Xi+$fi
zK>p*&1LwKqLHKB4LUG-UGOU9>_R*ZPBYH(>M5~OGhRo-#;d@j&lpKXqPgg7s@tD5J
zOaz;r`|coV`RRu%XTI;HD-jYX=kXrNG>YYC)ys0Wo|1Yq^XIvTpZ!}KKzH~N;<w{+
zdb3k$(&INM&WpqTU>NSVI`J+6uI&8ROfo}@{a*Ax#%>MIw~F7RedF52hYHQLd}nMM
zxbp5m^6FDblem2R3vN=!FfkJ?0&$(dWj2if9@g%rO)}Uz=D(9*s)itCaSqg2hs&Qh
zw`Y0G73RP1{PxD`g)r$2Nesc#uSAGbMLc7wAEj;Hkz;@%OK|CTg-`A4>tbS#4sD5n
zWzpy6zn_y6e(H$$3*`Tu#iPwdh;y!?^63Za$I651eijekK%KS@;o${74|OCE9xD&p
z?z4FKW?F~va2{!=2czD{%maDnHH(M;$ng+b9)u6^8>7zFPPaK8j2i2^#yUy&B(A_^
zVI~6)LlE=Ou1A(FvZm|7YhM$2`S*Hh7THYmD#Y8vRmQ{WZfbWkd9cVS5A`b_1zk<w
z8>DG~3q0&A4~@oP7ymiH#*L)W01$yR5RS0#X#7{a_^)~KkJvcIwj-Q#J*U-dZFfQ(
zx9)^V{6Oc0My*1JKL0(q?nuVXv3Itb@K4~nvjqMjz?X{fBcBEQR1qG04Diz>@SA`y
z7vV=Zr+Ru0PFcQ8Ix?z+*G8Rp?sWRC178;6e4R9B;Czepr{GZb`*5Af@j&?fxb7-}
z(@#D(2gjIk<i7wvD?X7;YARi?8m`%nnExI<?r^RRMy*bW8OlomlJ>#e;3#k`4dkF1
zd+}Js799A>qo*8ByR*5o#p03&9*)xAotwe~<$4&`^K$&Z1!XS*{`^v1y`U6&z7%Ta
z0{K>>{1~^7-h=1eoDd~1^vCm~uTS9{h>ASV0)CTlSo6;QdAqYP9FO9yEq^Q}UB26{
zl+fk-q=jebzK`%Jbj3g5ooz5W0H)ywZFl5Y4u-Ku<~o9eo0Lm`A0cu)ftlnjOf#qt
z9iv!7rP&%2jd1wYqaOvT?Ya*3aV)L)Fvvak1>h?TQNdNZ{6-`E4EJQ_;nS`W8G$go
zV;}u^+#l`;2L`6JIftapGWa~NAWhmrztKnzaJ;%}Js9!uj(PM?Rx&@FSjqirLgo5@
z@sAkvy~-EmzZ)e7@U85eWBjoHBZK$HqkkcM&|t8VWd1X=k~_LBy1Ns&Un#-O9h-Kz
zU!R6+jzT-!f18GDjxG!C5_tGt32y#4GHn95$L1&DnzJeEKoh#~amP+h$JJxS4*!lB
z_~LLZee!aC625m#n0%9$OVe@nD6sHy2k>86f{)K|{*hn7MH?P_!!%s)j3sg3F%8!o
zm32JaUyf@u?af0;cV`-|NB0bH-&KxVIA%-TQ5U~nf}cA+>vUoMUzD|dhii_-I{7|X
zLN|BR)!}|-3a(YL<Ka)saNY4zqd3Y&z5UfxTp4m4-M^iNYfl#`-G3~{wI{gJc`AAM
z_o=uX)lHuw?tf3iHAh92-{Z%p;!0N)T=b9QPc6YMIr{1F?|c;au%Y8&8GiQor{jBL
z8m>9k>2P0Gj%)RN!PnjK%jLNK5lo@G1b*LEf}1~9$+kWV+;}3ccT~(Au@m|%^9#39
z#vFZfJiUKn8TL1G{E<A7|KFaDD~eJ6e{UkL$G<tg=y)mXW7LmTyqg<R)-Oz;Uu$^u
zJ^hgXZ%izcm6i0rJrUQVpVj3;Wnvl9PtT8o{=$<c;(GM$Xhxkbqs-}&G9}0TM4y;5
zEYwTzvCFZVo>VeE0J>Rt(Ii~&h#mR39k{P9!R0uHY^j?#Z!E`=DJJP)4!I!z0hEb&
zI;YW7D#W1-*GlLl+2d_eC+3z5!xCKYIGW(WZ!GMW;F*5tj+r^!2Pfcq$HpA)drNS0
zN5cdc^UBBNzkomBfB%krR``WQi2Aet%%eUHeLsH%iS#rH+lY9-TcD$O=8b}QoF`BF
z&)_pb$Bf;X4Kwv>Zch*K{y^%>;pxU2)MM*g_%p#PZu-}J^G`stk+NP*H`6m8YYD-u
zfA-x59AoFjP2QxzcK#9kJ8|LjMjwSuwJPVAB)_<ERrAgJLUBVW^PdWRn>k8xBc<jW
zJt050;n30#e!zb-F8qV=U)<zH`m~3CGV=R}U^cv8h>AT>j_(*f6gEF8pGJ>Z%twF7
z{{s?p+y(Pa<L8(EgVEAkc*O8s*r39Ee3M$#_nsZ38LT{uW{x#svxmiFf138sOstbE
zK1J%+4F$zb2$s)9^Nv*90Kj~HFPQXSN__jMd^J-CkP%o8Yf6h|yh=X|6OOf!TmEk*
z)<_o586CP0qLy~)KWVv+^=83OKR6N}d@h=~V)5G^<XgNTWs2Y2P9pCmE3%-Km`D1Z
zi+Qie=DGO^)@l}Cx02m&h4qxhH*vLt3xx>e3+pM1R|LkJ`5L0|MhbUhCh^-TTwXd9
zKThHDB0xC&(_(+6d{JHVAIRr>YuMnq@ZVFm$-CuWs4I4L%E&_adkx&KETwBfi>*O#
z*c`_=5*o-)k%RQ-jzesZ!6x11CN_F^k|gBe<pit3Sf;jdb0DP}m?us=%YTS@TE?_8
ze-w&eQj%sX&_6L^i$cFW=mqv~fU?pS$QU2kv%#`%#@PmEM1f3SWUk3{jkkKhT}!xX
z%#~Z6U-|-Bu)~f7vuQy8ld9WBWP@A3Gp+`kgTc5t+Dd{U{!`3fo#OA#&4X~*Op<sP
zC!l<2psQl|Z)-9bB|&S@xppmX#ZV3iY(p9-4?=C>C#{e+v{8H!NtKzT(Xij_0dtwC
zMy0a;D@hRR<Hyv!W^&ytkp56PSWcVAHiuc%H3`!n0(C3FGJm3IE8#rX`!#d0Yyi@x
z!hlS$BzA45-x|k*zS)Q|+`*Z3Q;XqT&b8}l_7FeBjfdNDJHX^P?Ce4*;oe|$y*ZMN
z1t2Pa{4^ys1&cACG$6FmnaRf=WW&9<J>E7o`^)l{7hPnB8Ipe3ZpK!=RuWPoF&Zdv
zKV8wb%)9RrHa*xGV+mDTBiqQ9Ce2~1uiwj)Ae%-*kJ*qo31jiapN25*CV!;SZjPH_
zx5<C^w%e^>d)T%d!u`;24s6~1K|dT}>3Ww3vyGgt1=)a72e<lI$|`X7%aK(Oc`;T*
z&QOQ3jAnPQd60x?(;j-kpdEDjtSz)DOdR7@r!hXj@jov6jyl~Aepw!}>wBN}*h*fq
z7x%+n+!_sb2l#_P`UQ~MFN3E{;50`y9PYLIA*~~DNfSda_TWeXjIU%3ekE(r{m=)n
z=hqwY_5NUQZyO%0*T#_o^f)fsZNd?;al|`hQuQ>IwB=KtST;OQLq71}{cFGk9;gmq
zbC@unZRFL)nIu1eH)v7;d~E|f%FmKq0zf#D?qJVB^fL%taEh*p6kQ>T-feDnx<UDu
z542Q6eO$WW>@O#~IF^fD9LvF(<z7jc7x{IQV-k49^|G+2C@EcR^%7W36}7Yf8GkLx
zz&f1+qcq}%Zas|}aCRlqEg!B0E{c^zZ>3P9r~rM>{faJ)dvLtk18$coR=xP8G>&yN
zhqJbBM<Mejo?R2;cqF1-l%YwYSfJvtBylWiaCDM5DmE{!)Cx9bn}oN50OSG;s}^Y?
ztnhe=GVBdOuyva%@{25_U=S?141%rCAXttw2(W?tGKMHY1`CPlB7`)xfTf{r%>D!@
zT^7)nej}M+85Sk#y^@1Cyb?wVd7_2fI|N$P#qpbKxB|Q%NizpL*e8eT_(l})wI|@Y
zk`%ul$k7Fz2?X4I&K=+BjNXl&+~ms*wPunm`~KV<RVSqQ*-C>uqxj_f0~hC(GMB^+
iEDU#Qyw!PI4R+gYZk=dwZooKZbP~5d1ZF7CA^1PO>8mpU
literal 0
HcmV?d00001
diff --git a/Platform/Broadcom/Bcm283x/DeviceTree/bcm2710-rpi-3-b.dts b/Platform/Broadcom/Bcm283x/DeviceTree/bcm2710-rpi-3-b.dts
new file mode 100644
index 000000000000..887eb09692b6
--- /dev/null
+++ b/Platform/Broadcom/Bcm283x/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";
+ };
+};
diff --git a/Platform/Broadcom/Bcm283x/Drivers/DwUsbHostDxe/ComponentName.c b/Platform/Broadcom/Bcm283x/Drivers/DwUsbHostDxe/ComponentName.c
new file mode 100644
index 000000000000..6e2709b13c9b
--- /dev/null
+++ b/Platform/Broadcom/Bcm283x/Drivers/DwUsbHostDxe/ComponentName.c
@@ -0,0 +1,219 @@
+/** @file
+ *
+ * Copyright (c) 2018, Andrey Warkentin <andrey.warkentin@gmail.com>
+ *
+ * SPDX-License-Identifier: GPL-2.0+
+ *
+ **/
+
+#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/Broadcom/Bcm283x/Drivers/DwUsbHostDxe/DriverBinding.c b/Platform/Broadcom/Bcm283x/Drivers/DwUsbHostDxe/DriverBinding.c
new file mode 100644
index 000000000000..7878251fcfc3
--- /dev/null
+++ b/Platform/Broadcom/Bcm283x/Drivers/DwUsbHostDxe/DriverBinding.c
@@ -0,0 +1,269 @@
+/** @file
+ *
+ * Copyright (c) 2018, Andrey Warkentin <andrey.warkentin@gmail.com>
+ *
+ * SPDX-License-Identifier: GPL-2.0+
+ *
+ **/
+
+#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_FW_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 out;
+ }
+
+ /*
+ * 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
+ );
+
+out:
+ if (EFI_ERROR (Status)) {
+ DEBUG((DEBUG_ERROR, "Could not start DwUsbHostDxe: %r\n", Status));
+
+ DestroyDwUsbHc(DwHc);
+
+ mFwProtocol->SetPowerState(RPI_FW_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/Broadcom/Bcm283x/Drivers/DwUsbHostDxe/DwUsbHostDxe.c b/Platform/Broadcom/Bcm283x/Drivers/DwUsbHostDxe/DwUsbHostDxe.c
new file mode 100644
index 000000000000..93ac65c85070
--- /dev/null
+++ b/Platform/Broadcom/Bcm283x/Drivers/DwUsbHostDxe/DwUsbHostDxe.c
@@ -0,0 +1,1644 @@
+/** @file
+ *
+ * Copyright (c) 2017-2018, Andrey Warkentin <andrey.warkentin@gmail.com>
+ * Copyright (c) 2015-2016, Linaro Limited. All rights reserved.
+ * Copyright (c) 2014 Marek Vasut <marex@denx.de>
+ * Copyright (c) 2012 Oleksandr Tymoshenko <gonzo@freebsd.org>
+ *
+ * SPDX-License-Identifier: GPL-2.0+
+ *
+ **/
+
+#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 {
+ restart_xfer:
+ 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();
+ }
+
+restart_channel:
+ 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 restart_channel;
+ }
+
+ goto restart_xfer;
+ } 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 restart_channel;
+ } else if (Ret == XFER_NAK) {
+ if (Split.Splitting &&
+ (EpType == DWC2_HCCHAR_EPTYPE_CONTROL)) {
+ goto restart_xfer;
+ }
+
+ *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 out;
+ }
+
+ Status = gBS->SetTimer (TimeoutEvt, TimerForTransfer,
+ EFI_TIMER_PERIOD_MILLISECONDS(Req->TimeOut));
+ ASSERT_EFI_ERROR (Status);
+ if (EFI_ERROR (Status)) {
+ goto out;
+ }
+
+ 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 out;
+ }
+
+ Req->CallbackFunction (Req->Data, Req->DataLength,
+ Req->CallbackContext,
+ Req->TransferResult);
+ out:
+ 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 out;
+ }
+
+ Status = gBS->SetTimer (TimeoutEvt, TimerRelative,
+ EFI_TIMER_PERIOD_MILLISECONDS(DW_HC_RESET_TIMEOUT_MS));
+ ASSERT_EFI_ERROR (Status);
+ if (EFI_ERROR (Status)) {
+ goto out;
+ }
+
+ Status = DwCoreInit(DwHc, TimeoutEvt);
+ if (Status != EFI_SUCCESS) {
+ DEBUG((DEBUG_ERROR, "DwCoreInit failed\n"));
+ goto out;
+ }
+
+ Status = DwHcInit(DwHc, TimeoutEvt);
+ if (Status != EFI_SUCCESS) {
+ DEBUG((DEBUG_ERROR, "DwHcInit failed\n"));
+ goto out;
+ }
+
+ 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));
+
+ out:
+ 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 End;
+ }
+
+ 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;
+ }
+
+ End:
+ 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 End;
+ }
+
+ 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;
+ }
+
+ End:
+ 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 out;
+ }
+
+ Status = gBS->SetTimer (TimeoutEvt, TimerForTransfer,
+ EFI_TIMER_PERIOD_MILLISECONDS(TimeOut));
+ ASSERT_EFI_ERROR (Status);
+ if (EFI_ERROR (Status)) {
+ goto out;
+ }
+
+ 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 out;
+ }
+
+ 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 out;
+ }
+ }
+
+ 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 out;
+ }
+
+out:
+ 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 out;
+ }
+
+ Status = gBS->SetTimer (TimeoutEvt, TimerForTransfer,
+ EFI_TIMER_PERIOD_MILLISECONDS(TimeOut));
+ ASSERT_EFI_ERROR (Status);
+ if (EFI_ERROR (Status)) {
+ goto out;
+ }
+
+ 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);
+
+ out:
+ 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 out;
+ }
+
+ 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);
+
+ out:
+ 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 = BCM2836_USB_DW2_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/Broadcom/Bcm283x/Drivers/DwUsbHostDxe/DwUsbHostDxe.h b/Platform/Broadcom/Bcm283x/Drivers/DwUsbHostDxe/DwUsbHostDxe.h
new file mode 100644
index 000000000000..7916961e30fd
--- /dev/null
+++ b/Platform/Broadcom/Bcm283x/Drivers/DwUsbHostDxe/DwUsbHostDxe.h
@@ -0,0 +1,159 @@
+/** @file
+ *
+ * Copyright (c) 2017-2018, Andrey Warkentin <andrey.warkentin@gmail.com>
+ * Copyright (c) 2015-2016, Linaro Limited. All rights reserved.
+ * Copyright (c) 2014 Marek Vasut <marex@denx.de>
+ * Copyright (c) 2012 Oleksandr Tymoshenko <gonzo@freebsd.org>
+ *
+ * SPDX-License-Identifier: GPL-2.0+
+ *
+ **/
+
+#ifndef _DWUSBHOSTDXE_H_
+#define _DWUSBHOSTDXE_H_
+
+#include <Uefi.h>
+
+#include <Protocol/RaspberryPiFirmware.h>
+#include <Protocol/Usb2HostController.h>
+#include <IndustryStandard/RpiFirmware.h>
+#include <IndustryStandard/Bcm2836.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>
+#include <Utils.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/Broadcom/Bcm283x/Drivers/DwUsbHostDxe/DwUsbHostDxe.inf b/Platform/Broadcom/Bcm283x/Drivers/DwUsbHostDxe/DwUsbHostDxe.inf
new file mode 100644
index 000000000000..fd42875529b8
--- /dev/null
+++ b/Platform/Broadcom/Bcm283x/Drivers/DwUsbHostDxe/DwUsbHostDxe.inf
@@ -0,0 +1,52 @@
+#/** @file
+#
+# Copyright (c) 2017-2018, Andrei Warkentin <andrey.warkentin@gmail.com>
+# Copyright (c) 2015-2016, Linaro Limited. All rights reserved.
+#
+# SPDX-License-Identifier: GPL-2.0+
+#
+#**/
+
+[Defines]
+ INF_VERSION = 0x00010005
+ 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
+ Platform/Broadcom/Bcm283x/RaspberryPiPkg.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/Broadcom/Bcm283x/Drivers/DwUsbHostDxe/DwcHw.h b/Platform/Broadcom/Bcm283x/Drivers/DwUsbHostDxe/DwcHw.h
new file mode 100644
index 000000000000..e64010f220ba
--- /dev/null
+++ b/Platform/Broadcom/Bcm283x/Drivers/DwUsbHostDxe/DwcHw.h
@@ -0,0 +1,782 @@
+/** @file
+ *
+ * Copyright (c) 2017, Andrey Warkentin <andrey.warkentin@gmail.com>
+ * Copyright (c) 2015-2016, Linaro Limited. All rights reserved.
+ * Copyright (c) 2014 Marek Vasut <marex@denx.de>
+ * Copyright (c) 2012 Oleksandr Tymoshenko <gonzo@freebsd.org>
+ *
+ * SPDX-License-Identifier: GPL-2.0+
+ *
+ **/
+
+#ifndef __DWCHW_H__
+#define __DWCHW_H__
+
+#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/Broadcom/Bcm283x/Drivers/DwUsbHostDxe/License.txt b/Platform/Broadcom/Bcm283x/Drivers/DwUsbHostDxe/License.txt
new file mode 100644
index 000000000000..1603937dad82
--- /dev/null
+++ b/Platform/Broadcom/Bcm283x/Drivers/DwUsbHostDxe/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/Broadcom/Bcm283x/Drivers/Logo/License.txt b/Platform/Broadcom/Bcm283x/Drivers/Logo/License.txt
new file mode 100644
index 000000000000..9370146336be
--- /dev/null
+++ b/Platform/Broadcom/Bcm283x/Drivers/Logo/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/Broadcom/Bcm283x/Drivers/Logo/Logo.bmp b/Platform/Broadcom/Bcm283x/Drivers/Logo/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/Broadcom/Bcm283x/Drivers/Logo/Logo.c b/Platform/Broadcom/Bcm283x/Drivers/Logo/Logo.c
new file mode 100644
index 000000000000..1789ad9d90bc
--- /dev/null
+++ b/Platform/Broadcom/Bcm283x/Drivers/Logo/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/Broadcom/Bcm283x/Drivers/Logo/Logo.eps b/Platform/Broadcom/Bcm283x/Drivers/Logo/Logo.eps
new file mode 100644
index 0000000000000000000000000000000000000000..f40df6b0149a9b45e2b86a42e074a11c7bce6796
GIT binary patch
literal 250982
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�ZNv=QC}>w&ZKKDs8g$w43lON>k^
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
PPKas%y!4z5ke~kpwvJ^n
literal 0
HcmV?d00001
diff --git a/Platform/Broadcom/Bcm283x/Drivers/Logo/Logo.idf b/Platform/Broadcom/Bcm283x/Drivers/Logo/Logo.idf
new file mode 100644
index 000000000000..f4c39b78c436
--- /dev/null
+++ b/Platform/Broadcom/Bcm283x/Drivers/Logo/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/Broadcom/Bcm283x/Drivers/Logo/Logo.inf b/Platform/Broadcom/Bcm283x/Drivers/Logo/Logo.inf
new file mode 100644
index 000000000000..e2e61c82c5ca
--- /dev/null
+++ b/Platform/Broadcom/Bcm283x/Drivers/Logo/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 = 0x00010005
+ 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/Broadcom/Bcm283x/Drivers/Logo/Logo.uni b/Platform/Broadcom/Bcm283x/Drivers/Logo/Logo.uni
new file mode 100644
index 000000000000..d21b336446bf
--- /dev/null
+++ b/Platform/Broadcom/Bcm283x/Drivers/Logo/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/Broadcom/Bcm283x/Drivers/Logo/LogoDxe.inf b/Platform/Broadcom/Bcm283x/Drivers/Logo/LogoDxe.inf
new file mode 100644
index 000000000000..b5957343cc04
--- /dev/null
+++ b/Platform/Broadcom/Bcm283x/Drivers/Logo/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 = 0x00010005
+ 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/Broadcom/Bcm283x/Drivers/Logo/LogoDxe.uni b/Platform/Broadcom/Bcm283x/Drivers/Logo/LogoDxe.uni
new file mode 100644
index 000000000000..fe1637534332
--- /dev/null
+++ b/Platform/Broadcom/Bcm283x/Drivers/Logo/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."
--git a/Platform/Broadcom/Bcm283x/Drivers/Logo/LogoDxeExtra.uni b/Platform/Broadcom/Bcm283x/Drivers/Logo/LogoDxeExtra.uni
new file mode 100644
index 000000000000..d8815b2dac56
--- /dev/null
+++ b/Platform/Broadcom/Bcm283x/Drivers/Logo/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"
--git a/Platform/Broadcom/Bcm283x/Drivers/Logo/LogoExtra.uni b/Platform/Broadcom/Bcm283x/Drivers/Logo/LogoExtra.uni
new file mode 100644
index 000000000000..4f177586266a
--- /dev/null
+++ b/Platform/Broadcom/Bcm283x/Drivers/Logo/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
next prev parent reply other threads:[~2018-12-07 12:06 UTC|newest]
Thread overview: 6+ messages / expand[flat|nested] mbox.gz Atom feed top
2018-12-07 12:05 [PATCH v1 edk2-platfoms 0/2] Platform/Broadcom: Add Raspberry Pi 3 support Pete Batard
2018-12-07 12:05 ` [PATCH v1 edk2-platfoms 1/2] " Pete Batard
2018-12-07 12:05 ` Pete Batard [this message]
2018-12-07 14:08 ` [PATCH v1 edk2-platfoms 0/2] " Ard Biesheuvel
2018-12-07 14:33 ` Pete Batard
2018-12-07 14:39 ` Ard Biesheuvel
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-list from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20181207120511.8724-3-pete@akeo.ie \
--to=devel@edk2.groups.io \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox