public inbox for devel@edk2.groups.io
 help / color / mirror / Atom feed
* Re: [edk2-devel] [edk2-non-osi] [PATCH V1 1/3] Silicon/Intel: Add WhitleySiliconBinPkg CooperLake Microcode
       [not found] <168D94F70681FC1A.19934@groups.io>
@ 2021-07-01  6:15 ` Nate DeSimone
  0 siblings, 0 replies; only message in thread
From: Nate DeSimone @ 2021-07-01  6:15 UTC (permalink / raw)
  To: devel@edk2.groups.io, Desimone, Nathaniel L
  Cc: Chiu, Chasel, Kinney, Michael D, Oram, Isaac W, Abbas, Mohamed,
	Liming Gao, Dong, Eric, Michael Kubacki

The series has been pushed as 5a1d56c~..cf26a05a

Thanks,
Nate

-----Original Message-----
From: devel@edk2.groups.io <devel@edk2.groups.io> On Behalf Of Nate DeSimone
Sent: Wednesday, June 30, 2021 10:54 PM
To: devel@edk2.groups.io
Cc: Chiu, Chasel <chasel.chiu@intel.com>; Kinney, Michael D <michael.d.kinney@intel.com>; Oram, Isaac W <isaac.w.oram@intel.com>; Abbas, Mohamed <mohamed.abbas@intel.com>; Liming Gao <gaoliming@byosoft.com.cn>; Dong, Eric <eric.dong@intel.com>; Michael Kubacki <Michael.Kubacki@microsoft.com>
Subject: [edk2-devel] [edk2-non-osi] [PATCH V1 1/3] Silicon/Intel: Add WhitleySiliconBinPkg CooperLake Microcode

Add WhitleySiliconBinPkg and microcode for 3rd Generation Intel(R) Xeon(R) Scalable processors formerly known as Cooper Lake.

Signed-off-by: Nate DeSimone <nathaniel.l.desimone@intel.com>
Cc: Chasel Chiu <chasel.chiu@intel.com>
Cc: Michael D Kinney <michael.d.kinney@intel.com>
Cc: Isaac Oram <isaac.w.oram@intel.com>
Cc: Mohamed Abbas <mohamed.abbas@intel.com>
Cc: Liming Gao <gaoliming@byosoft.com.cn>
Cc: Eric Dong <eric.dong@intel.com>
Cc: Michael Kubacki <Michael.Kubacki@microsoft.com>
---
 .../CpxMicrocode/IntelMicrocodeLicense.txt    |  37 ++++++++++++++++++
 .../CpxMicrocode/MicrocodeUpdates.inf         |  25 ++++++++++++
 .../CpxMicrocode/mBF5065B_07002302.mcb        | Bin 0 -> 27648 bytes
 .../Intel/WhitleySiliconBinPkg/License.txt    |  30 ++++++++++++++
 4 files changed, 92 insertions(+)
 create mode 100644 Silicon/Intel/WhitleySiliconBinPkg/CpxMicrocode/IntelMicrocodeLicense.txt
 create mode 100644 Silicon/Intel/WhitleySiliconBinPkg/CpxMicrocode/MicrocodeUpdates.inf
 create mode 100644 Silicon/Intel/WhitleySiliconBinPkg/CpxMicrocode/mBF5065B_07002302.mcb
 create mode 100644 Silicon/Intel/WhitleySiliconBinPkg/License.txt

diff --git a/Silicon/Intel/WhitleySiliconBinPkg/CpxMicrocode/IntelMicrocodeLicense.txt b/Silicon/Intel/WhitleySiliconBinPkg/CpxMicrocode/IntelMicrocodeLicense.txt
new file mode 100644
index 0000000..de55fd5
--- /dev/null
+++ b/Silicon/Intel/WhitleySiliconBinPkg/CpxMicrocode/IntelMicrocodeLice
+++ nse.txt
@@ -0,0 +1,37 @@
+Copyright (c) 2021 Intel Corporation.
+All rights reserved.
+
+Redistribution.
+
+Redistribution and use in binary form, without modification, are 
+permitted, provided that the following conditions are met:
+
+1.  Redistributions must reproduce the above copyright notice and the
+    following disclaimer in the documentation and/or other materials provided
+    with the distribution.
+
+2.  Neither the name of Intel Corporation nor the names of its suppliers may
+    be used to endorse or promote products derived from this software without
+    specific prior written permission.
+
+3.  No reverse engineering, decompilation, or disassembly of this software
+    is permitted.
+
+
+"Binary form" includes any format that is commonly used for electronic 
+conveyance that is a reversible, bit-exact translation of binary 
+representation to ASCII or ISO text, for example "uuencode".
+
+DISCLAIMER.
+
+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 OWNER 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/Silicon/Intel/WhitleySiliconBinPkg/CpxMicrocode/MicrocodeUpdates.inf b/Silicon/Intel/WhitleySiliconBinPkg/CpxMicrocode/MicrocodeUpdates.inf
new file mode 100644
index 0000000..26164de
--- /dev/null
+++ b/Silicon/Intel/WhitleySiliconBinPkg/CpxMicrocode/MicrocodeUpdates.i
+++ nf
@@ -0,0 +1,25 @@
+### @file
+# Microcode update.
+#
+# Copyright (c) 2021, 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                    = 0x00010017
+  BASE_NAME                      = MicrocodeUpdates
+  FILE_GUID                      = 0104DB99-B8E7-4783-BC35-DB89001C7C51
+  VERSION_STRING                 = 1.0
+  MODULE_TYPE                    = USER_DEFINED
+
+[Sources]
+  mBF5065B_07002302.mcb
+
diff --git a/Silicon/Intel/WhitleySiliconBinPkg/CpxMicrocode/mBF5065B_07002302.mcb b/Silicon/Intel/WhitleySiliconBinPkg/CpxMicrocode/mBF5065B_07002302.mcb
new file mode 100644
index 0000000000000000000000000000000000000000..96deb26c6eebb066accb06e99853132f37da4cc8
GIT binary patch
literal 27648
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
R!X#0kb61TX<0@4!`hwymp|k)1

literal 0
HcmV?d00001

diff --git a/Silicon/Intel/WhitleySiliconBinPkg/License.txt b/Silicon/Intel/WhitleySiliconBinPkg/License.txt
new file mode 100644
index 0000000..0b0f639
--- /dev/null
+++ b/Silicon/Intel/WhitleySiliconBinPkg/License.txt
@@ -0,0 +1,30 @@
+Copyright (c) 2021, Intel Corporation. All rights reserved.
+
+Redistribution and use in source and binary forms, with or without 
+modification, are permitted provided that the following conditions are 
+met:
+
+* Redistributions of source code must retain the above copyright
+  notice, this list of conditions and the following disclaimer.
+* Redistributions in binary form must reproduce the above copyright
+  notice, this list of conditions and the following disclaimer in
+  the documentation and/or other materials provided with the
+  distribution.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS 
+IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED 
+TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A 
+PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT 
+HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, 
+SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT 
+LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, 
+DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY 
+THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE 
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+Some files are subject to a license documented in the 
+IntelMicrocodeLicense.txt file. These files are in the same directory 
+as IntelMicrocodeLicense.txt, and they do not have a license specified 
+within the file.
--
2.27.0.windows.1







^ permalink raw reply related	[flat|nested] only message in thread

only message in thread, other threads:[~2021-07-01  6:15 UTC | newest]

Thread overview: (only message) (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
     [not found] <168D94F70681FC1A.19934@groups.io>
2021-07-01  6:15 ` [edk2-devel] [edk2-non-osi] [PATCH V1 1/3] Silicon/Intel: Add WhitleySiliconBinPkg CooperLake Microcode Nate DeSimone

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