Rel v4.17.0.1

_posts/2022-06-23-PC-Engines-Firmware-v4.17.0.1.md

@@ -0,0 +1,135 @@
+---
+layout: post
+title:  "PC Engines apu coreboot Open Source Firmware v4.17.0.1"
+date:   2022-05-27
+categories: Firmware
+---
+
+# PC Engines apu coreboot Open Source Firmware v4.17.0.1
+
+## Key changes
+
+Mainline:
+
+### Added
+
+- Support for APU7 (APU3 variant with 2.5GbE i225 NICs)
+
+### Changed
+
+- **Rebased** with official coreboot repository **commit** 5eda52a
+- **Updated sortbootorder** to **v4.6.24** adding support for APU7
+
+## Statistics
+
+![Files Changed](https://cloud.3mdeb.com/index.php/s/NFcsWDEGYde6anA/preview)
+
+The chart shows the total files changed from release tag against the rebase
+point of given release specified in CHANGELOG (CHANGELOG.md, gitlab-ci.yml
+and regression.sh excluded from statistics). Check the statistics with:
+
+```
+git diff --stat 5eda52a ':(exclude).gitlab-ci.yml' ':(exclude)CHANGELOG.md' ':(exclude).gitlab-ci/regression.sh'
+```
+
+`116 files changed, 4237 insertions(+), 217 deletions(-)`
+
+![Process of mainlining](https://cloud.3mdeb.com/index.php/s/6yR5a3sTC8Xot5W/preview)
+
+The chart represents the total line added and deleted on the PC Engines
+coreboot fork against the rebase point for a given release.
+
+## Testing
+
+* [PC Engines hardware configuration matrix](https://cloud.3mdeb.com/index.php/s/GYecq2SHidoFZ8A/preview) -
+  hardware configurations available for testing in 3mdeb laboratory.
+
+* [PC Engines release validation results](https://docs.google.com/spreadsheets/d/1_uRhVo9eYeZONnelymonYp444zYHT_Q_qmJEJ8_XqJc/edit#gid=0) -
+  please note there are separate sheets for each board-release.
+
+![Mainline test results](https://cloud.3mdeb.com/index.php/s/qSxoPobkE46JFib/preview)
+
+* Mainline:
+  * PASSED: **754** (+62)
+  * FAILED: **12** (+0)
+  * PASSED [%]: **98.43** (+0.13%)
+
+Fails are related to
+[wakeonlan](https://github.com/pcengines/apu2-documentation/issues/282),
+[USB](https://github.com/pcengines/apu2-documentation/issues/277) and
+[Xen](https://github.com/pcengines/apu2-documentation/issues/109).
+
+## Binaries
+
+### Mainline
+
+* [apu1 v4.17.0.1.zip](https://3mdeb.com/open-source-firmware/pcengines/apu1/apu1_v4.17.0.1.zip)
+
+  [apu1 v4.17.0.1.rom](https://3mdeb.com/open-source-firmware/pcengines/apu1/apu1_v4.17.0.1.rom)
+
+  [SHA256 file](https://3mdeb.com/open-source-firmware/pcengines/apu1/apu1_v4.17.0.1.SHA256)
+
+  [SHA256 sig](https://3mdeb.com/open-source-firmware/pcengines/apu1/apu1_v4.17.0.1.SHA256.sig)
+
+* [apu2 v4.17.0.1.zip](https://3mdeb.com/open-source-firmware/pcengines/apu2/apu2_v4.17.0.1.zip)
+
+  [apu2 v4.17.0.1.rom](https://3mdeb.com/open-source-firmware/pcengines/apu2/apu2_v4.17.0.1.rom)
+
+  [SHA256 file](https://3mdeb.com/open-source-firmware/pcengines/apu2/apu2_v4.17.0.1.SHA256)
+
+  [SHA256 sig](https://3mdeb.com/open-source-firmware/pcengines/apu2/apu2_v4.17.0.1.SHA256.sig)
+
+* [apu3 v4.17.0.1.zip](https://3mdeb.com/open-source-firmware/pcengines/apu3/apu3_v4.17.0.1.zip)
+
+  [apu3 v4.17.0.1.rom](https://3mdeb.com/open-source-firmware/pcengines/apu3/apu3_v4.17.0.1.rom)
+
+  [SHA256 file](https://3mdeb.com/open-source-firmware/pcengines/apu3/apu3_v4.17.0.1.SHA256)
+
+  [SHA256 sig](https://3mdeb.com/open-source-firmware/pcengines/apu3/apu3_v4.17.0.1.SHA256.sig)
+
+* [apu4 v4.17.0.1.zip](https://3mdeb.com/open-source-firmware/pcengines/apu4/apu4_v4.17.0.1.zip)
+
+  [apu4 v4.17.0.1.rom](https://3mdeb.com/open-source-firmware/pcengines/apu4/apu4_v4.17.0.1.rom)
+
+  [SHA256 file](https://3mdeb.com/open-source-firmware/pcengines/apu4/apu4_v4.17.0.1.SHA256)
+
+  [SHA256 sig](https://3mdeb.com/open-source-firmware/pcengines/apu4/apu4_v4.17.0.1.SHA256.sig)
+
+* [apu5 v4.17.0.1.zip](https://3mdeb.com/open-source-firmware/pcengines/apu5/apu5_v4.17.0.1.zip)
+
+  [apu5 v4.17.0.1.rom](https://3mdeb.com/open-source-firmware/pcengines/apu5/apu5_v4.17.0.1.rom)
+
+  [SHA256 file](https://3mdeb.com/open-source-firmware/pcengines/apu5/apu5_v4.17.0.1.SHA256)
+
+  [SHA256 sig](https://3mdeb.com/open-source-firmware/pcengines/apu5/apu5_v4.17.0.1.SHA256.sig)
+
+* [apu6 v4.17.0.1.zip](https://3mdeb.com/open-source-firmware/pcengines/apu6/apu6_v4.17.0.1.zip)
+
+  [apu6 v4.17.0.1.rom](https://3mdeb.com/open-source-firmware/pcengines/apu6/apu6_v4.17.0.1.rom)
+
+  [SHA256 file](https://3mdeb.com/open-source-firmware/pcengines/apu6/apu6_v4.17.0.1.SHA256)
+
+  [SHA256 sig](https://3mdeb.com/open-source-firmware/pcengines/apu6/apu6_v4.17.0.1.SHA256.sig)
+
+* [apu7 v4.17.0.1.zip](https://3mdeb.com/open-source-firmware/pcengines/apu7/apu7_v4.17.0.1.zip)
+
+  [apu7 v4.17.0.1.rom](https://3mdeb.com/open-source-firmware/pcengines/apu7/apu7_v4.17.0.1.rom)
+
+  [SHA256 file](https://3mdeb.com/open-source-firmware/pcengines/apu7/apu7_v4.17.0.1.SHA256)
+
+  [SHA256 sig](https://3mdeb.com/open-source-firmware/pcengines/apu7/apu7_v4.17.0.1.SHA256.sig)
+
+See how to verify the signatures on [asciinema](https://asciinema.org/a/504899)
+
+**IMPORTANT**
+
+To update the firmware and keep the runtime configuration unchanged please
+use the following command:
+
+```
+flashrom -p internal -w apuX_v4.17.0.1.rom --fmap -i COREBOOT
+```
+
+The persistent runtime configuration works only when migrating from versions
+v4.14.0.1 and later. The feature is not yet supported on apu1. Flashrom version
+needs to be v1.1 or newer.

gen-index.py

@@ -125,7 +125,7 @@ def replace_line(keyword, replacement):
 replace_line("<p>Release date:", input)
 
 # platforms names
-platforms = ['apu1', 'apu2', 'apu3', 'apu4', 'apu5', 'apu6']
+platforms = ['apu1', 'apu2', 'apu3', 'apu4', 'apu5', 'apu6', 'apu7']
 # update binaries and zip links
 for name in platforms:
     input = "                    <li><a class=\"sha-button\" href=\""+ftp_url+name+"/"+name+"_"+version+".rom\">"+name+" "+version+"</a><a href=\""+ftp_url+name+"/"+name+"_"+version+".SHA256\" class=\"sha-button\">SHA256</a><a href=\""+ftp_url+name+"/"+name+"_"+version+".SHA256.sig\" class=\"sha-button\">SHA256.sig</a></li>\n"

index.html

@@ -185,7 +185,7 @@ <h2>
             <div class="main-list">
               <h2>
                 The recommended firmware version is latest mainline
-                <span class="green-text">v4.16.0.x.</span> Reasons:
+                <span class="green-text">v4.17.0.x.</span> Reasons:
               </h2>
               <ul>
                 <li
@@ -211,6 +211,7 @@ <h2>
                 <div class="main-list">
                     <h3 class="green-text">Mainline releases</h3>
                     <ul class="list">
+                        <li><a href="#mr-60">v4.17.0.1</a></li>
                         <li><a href="#mr-59">v4.16.0.4</a></li>
                         <li><a href="#mr-58">v4.16.0.3</a></li>
                         <li><a href="#mr-57">v4.16.0.2</a></li>
@@ -397,12 +398,86 @@ <h1>Documentation</h1>
   </div>
 
 
-        <!-- mainline releases v4.16.0.4 -->
+        <!-- mainline releases v4.17.0.1 -->
         <div class="wrapper">
         <!--<div class="break"></div>insert this code when a new update comes out to separate a new version from the current.-->
-        <div class="smaller-margin" id="mr-59">
+        <div class="smaller-margin" id="mr-60">
               <h2 class="text-middle">Mainline releases</h2>
               <!-- h2 tag needs to be moved to the newest version -->
+            <h4><a target="_blank" href="https://github.com/pcengines/coreboot/compare/v4.16.0.4...v4.17.0.1">v4.17.0.1</a></h4>
+          </div>
+
+          <div class="dimmed-text">
+            <p>Release date: 2022-06-23</p>
+          </div>
+
+          <ul>
+              <li>Changed:</li>
+              <ol>
+                <li>Rebased with official coreboot repository commit 5eda52a</li>
+                <li>updated sortbootorder to v4.6.24</li>
+              </ol>
+              <li>Added:</li>
+              <ol>
+                <li>Support for APU7 (APU3 variant with 2.5GbE i225 NICs)</li>
+              </ol>
+              <li>Known issues:</li>
+              <ol>
+                  <li><a href="https://github.com/pcengines/apu2-documentation/issues/308">APU7 iPXE network boot with i225 NICs does not work</a></li>
+                  <li><a href="https://github.com/pcengines/coreboot/issues/329">apuled driver doesn't work in FreeBSD.</a> Check the <a target="_blank" href="https://github.com/pcengines/apu2-documentation/blob/master/docs/gpios.md">GPIOs</a> document for workaround.</li>
+                  <li><a href="https://github.com/pcengines/apu2-documentation/issues/115">some PCIe cards are not detected on certain OSes and/or in certain mPCIe slots.</a> Check the <a target="_blank" href="https://github.com/pcengines/apu2-documentation/blob/master/docs/mpcie_modules.md">mPCIe modules</a> document for solution/workaround.</li>
+                  <li><a href="https://github.com/pcengines/seabios/issues/30">booting with 2 USB 3.x sticks plugged in apu4 sometimes results in detecting only 1 stick</a></li>
+                  <li><a href="https://github.com/pcengines/seabios/issues/29">certain USB 3.x sticks happen to not appear in boot menu</a></li>
+                  <li><a href="https://github.com/pcengines/apu2-documentation/issues/109">booting Xen is unstable</a></li>
+              </ol>
+          </ul>
+
+          <div class="source-code-links-binaries">
+              <div class="binaries-column">
+                  <div class="smaller-margin">
+                      <p>Binaries:</p>
+                  </div>
+                  <ul>
+                    <li><a class="sha-button" href="https://3mdeb.com/open-source-firmware/pcengines/apu1/apu1_v4.17.0.1.rom">apu1 v4.17.0.1</a><a href="https://3mdeb.com/open-source-firmware/pcengines/apu1/apu1_v4.17.0.1.SHA256" class="sha-button">SHA256</a><a href="https://3mdeb.com/open-source-firmware/pcengines/apu1/apu1_v4.17.0.1.SHA256.sig" class="sha-button">SHA256.sig</a></li>
+                    <li><a class="sha-button" href="https://3mdeb.com/open-source-firmware/pcengines/apu2/apu2_v4.17.0.1.rom">apu2 v4.17.0.1</a><a href="https://3mdeb.com/open-source-firmware/pcengines/apu2/apu2_v4.17.0.1.SHA256" class="sha-button">SHA256</a><a href="https://3mdeb.com/open-source-firmware/pcengines/apu2/apu2_v4.17.0.1.SHA256.sig" class="sha-button">SHA256.sig</a></li>
+                    <li><a class="sha-button" href="https://3mdeb.com/open-source-firmware/pcengines/apu3/apu3_v4.17.0.1.rom">apu3 v4.17.0.1</a><a href="https://3mdeb.com/open-source-firmware/pcengines/apu3/apu3_v4.17.0.1.SHA256" class="sha-button">SHA256</a><a href="https://3mdeb.com/open-source-firmware/pcengines/apu3/apu3_v4.17.0.1.SHA256.sig" class="sha-button">SHA256.sig</a></li>
+                    <li><a class="sha-button" href="https://3mdeb.com/open-source-firmware/pcengines/apu4/apu4_v4.17.0.1.rom">apu4 v4.17.0.1</a><a href="https://3mdeb.com/open-source-firmware/pcengines/apu4/apu4_v4.17.0.1.SHA256" class="sha-button">SHA256</a><a href="https://3mdeb.com/open-source-firmware/pcengines/apu4/apu4_v4.17.0.1.SHA256.sig" class="sha-button">SHA256.sig</a></li>
+                    <li><a class="sha-button" href="https://3mdeb.com/open-source-firmware/pcengines/apu5/apu5_v4.17.0.1.rom">apu5 v4.17.0.1</a><a href="https://3mdeb.com/open-source-firmware/pcengines/apu5/apu5_v4.17.0.1.SHA256" class="sha-button">SHA256</a><a href="https://3mdeb.com/open-source-firmware/pcengines/apu5/apu5_v4.17.0.1.SHA256.sig" class="sha-button">SHA256.sig</a></li>
+                    <li><a class="sha-button" href="https://3mdeb.com/open-source-firmware/pcengines/apu6/apu6_v4.17.0.1.rom">apu6 v4.17.0.1</a><a href="https://3mdeb.com/open-source-firmware/pcengines/apu6/apu6_v4.17.0.1.SHA256" class="sha-button">SHA256</a><a href="https://3mdeb.com/open-source-firmware/pcengines/apu6/apu6_v4.17.0.1.SHA256.sig" class="sha-button">SHA256.sig</a></li>
+                    <li><a class="sha-button" href="https://3mdeb.com/open-source-firmware/pcengines/apu7/apu7_v4.17.0.1.rom">apu7 v4.17.0.1</a><a href="https://3mdeb.com/open-source-firmware/pcengines/apu7/apu7_v4.17.0.1.SHA256" class="sha-button">SHA256</a><a href="https://3mdeb.com/open-source-firmware/pcengines/apu7/apu7_v4.17.0.1.SHA256.sig" class="sha-button">SHA256.sig</a></li>
+                  </ul>
+                  <div class="smaller-margin">
+                      <p>Zip packages:</p>
+                  </div>
+                  <ul>
+                    <li><a class="sha-button" href="https://3mdeb.com/open-source-firmware/pcengines/apu1/apu1_v4.17.0.1.zip">apu1 v4.17.0.1.zip</a></li>
+                    <li><a class="sha-button" href="https://3mdeb.com/open-source-firmware/pcengines/apu2/apu2_v4.17.0.1.zip">apu2 v4.17.0.1.zip</a></li>
+                    <li><a class="sha-button" href="https://3mdeb.com/open-source-firmware/pcengines/apu3/apu3_v4.17.0.1.zip">apu3 v4.17.0.1.zip</a></li>
+                    <li><a class="sha-button" href="https://3mdeb.com/open-source-firmware/pcengines/apu4/apu4_v4.17.0.1.zip">apu4 v4.17.0.1.zip</a></li>
+                    <li><a class="sha-button" href="https://3mdeb.com/open-source-firmware/pcengines/apu5/apu5_v4.17.0.1.zip">apu5 v4.17.0.1.zip</a></li>
+                    <li><a class="sha-button" href="https://3mdeb.com/open-source-firmware/pcengines/apu6/apu6_v4.17.0.1.zip">apu6 v4.17.0.1.zip</a></li>
+                    <li><a class="sha-button" href="https://3mdeb.com/open-source-firmware/pcengines/apu7/apu7_v4.17.0.1.zip">apu7 v4.17.0.1.zip</a></li>
+                  </ul>
+                  <p>See an example how to verify the signatures on <a href="https://asciinema.org/a/504899">asciinema</a></p>
+              </div>
+              <div class="source-code-column">
+                  <div class="smaller-margin">
+                      <p>Source code:</p>
+                  </div>
+                  <ul>
+                    <li><a target="_blank" href="https://github.com/pcengines/coreboot/compare/v4.16.0.4...v4.17.0.1">coreboot v4.17.0.1</a></li>
+                    <li><a target="_blank" href="https://github.com/pcengines/seabios/compare/rel-1.14.0.1...'rel-1.16.0.1'">SeaBIOS 'rel-1.16.0.1'</a></li>
+                    <li><a target="_blank" href="https://github.com/pcengines/sortbootorder/compare/v4.6.22...'v4.6.24'">sortbootorder 'v4.6.24'</a></li>
+                      <li><a target="_blank" href="https://github.com/ipxe/ipxe/commits/ebf2eaf5">ipxe 2019.03 stable</a></li>
+                      <li><a target="_blank" href="https://review.coreboot.org/cgit/memtest86plus.git/commit/?id=0b756257276729c1a12bc1d95e7a1f044894bda2">memtest86+ revision 0b756257</a></li>
+                  </ul>
+              </div>
+      </div>
+        <div class="break"></div>
+
+
+        <!-- mainline releases v4.16.0.4 -->
+        <div class="smaller-margin" id="mr-59">
             <h4><a target="_blank" href="https://github.com/pcengines/coreboot/compare/v4.16.0.3...v4.16.0.4">v4.16.0.4</a></h4>
           </div>