Subscribe to our newsletter

2024-03-18: Dasharo for PC Engines Announcement


Dear PC Engines Enthusiasts, We are thrilled to announce the releases of Dasharo for PC Engines aimed at preserving the value of the iconic hardware that has served our community so well over the years. Our new releases, Dasharo (coreboot+SeaBIOS) v24.02.01.01 and Dasharo (coreboot+UEFI) v0.9.0, represent our ongoing commitment to maintaining and enhancing the PC Engines platforms through open-source firmware.

Introducing Dasharo for PC Engines:

Dasharo (coreboot+SeaBIOS) v24.02.01.01: This release continues our tradition of providing regular firmware updates, integrating the latest coreboot 24.02.01 and SeaBIOS 1.16.0. It's designed for users who appreciate the legacy firmware approach, offering stability, security, and compatibility enhancements. The goal is to deliver validated stable releases quarterly, emphasizing backward compatibility. The planned release of this product is end of Q2’24.

Dasharo (coreboot+UEFI) v0.9.0: For those looking towards the future, this version introduces modern features like UEFI compatibility and Secure Boot, paving the way for next-generation firmware solutions, with the goal of at least one release per year.

How to get Dasharo for PC Engines?

Understanding the importance of long-term maintenance and support, we are introducing a pre-paid-based model. This approach ensures the continuous delivery of firmware updates and establishes a sustainable business model that supports the open-source firmware community. Our 1-Year Dasharo (coreboot+UEFI) Entry Subscription and 1-Year Dasharo (coreboot+SeaBIOS) Entry Subscription is essentially a pre-paid plan that is not automatically renewable. It guarantees you access to the latest updates and dedicated support, maximizing the value and lifespan of your PC Engines hardware. Our source code will always be open and available through Dasharo Github.

If you want to stay up to date, consider following these events:

Dasharo User Group: Join our community of enthusiasts and experts to stay informed about the latest developments, share insights, and contribute to the future of open-source firmware on PC Engines.

Dasharo Developers vPub This is an event series dedicated to discussing the challenges and opportunities of long-term maintenance through open-source firmware distribution. It's a platform for developers, contributors, and users to collaborate and innovate for the future of PC Engines.

Thank you for your continued support and enthusiasm. We can ensure a vibrant and secure future for PC Engines through open-source firmware.

Sincerely,
3mdeb Team

2023-02-03: Open-source firmware sponsorship announcement


Dear PC Engines hardware owners,

We regret to announce that PC Engines, a provider of small and low-power servers for network security, wireless networking, and embedded applications, has discontinued its sponsorship for open-source firmware. Although this is a significant change for the open-source firmware community, our commitment to supporting the hardware remains strong. At Dasharo, we aim to continue the legacy of PC Engines by distributing open-source firmware and putting the community's needs first. Our focus will be on releases and feature sets driven by community support. We are considering a subscription model to ensure stable and reliable firmware updates. Your input is important to us, and we would appreciate your feedback through our survey. Please help us understand how we can better serve the open-source firmware community and ensure its success in the future.

Full details.

Sincerely,
3mdeb Team

Release notes


Release notes describing changes, fixes and known issues in PC Engines apux releases.

Each binary (or archive in case of older images) is cryptographically signed by PC Engines Open Source Firmware Release Signing Key adequate to the official coreboot release (i.e. 4.9.0.x releases are signed by 4.9 Signing Key and 4.10.0.x by 4.10 Signing Key). Legacy releases starting from v4.0.28 are being signed with PC Engines Open Source Firmware Release 4.10 Signing Key. The keys are maintained and managed by 3mdeb company responsible for maintaining PC Engines firmware. Under each release binaries one may find an asciinema record showing example firmware signature verification using appropriate key. The public parts of the keys are available at 3mdeb-secpack repository. For the details of the change please refer to Canary #2.
Following new coreboot release 4.11, a new PC Engines Open Source Firmware Release 4.10 Signing Key has been enrolled. Since v4.11.0.1 and v4.0.30 firmware releases are signed by PC Engines Open Source Firmware Release 4.10 Signing Key. The public parts of the keys may be found on 3mdeb-secpack. The details of the change are also available on Canary #3.

The recommended firmware version is latest mainline v4.17.0.x. Reasons:

  • most of the new features are firstly introduced here in mainline
  • mainline version is more actively developed and maintained than legacy
  • mainline releases have extended validation comparing to legacy due to legacy limitations related to old toolchain and codebase
  • mainline releases are built with newest toolchains

OS status


Some operating system have problems running with different storage medias. These table shows currently tested systems on BIOS v4.10.0.x with corresponding medias:

OS SD card SATA disk mSATA disk USB stick
Voyage (1) OK OK OK(2)
Debian OK OK OK OK(2)
OPNSense OK OK OK OK(2)
pfSense OK OK(*) OK OK(2)

* - works well with BIOS v4.6.8 or later in mainline and all legacy releases; for v4.6.7 and older mainline versions issues with installation and system functionality (installation break, unwanted reboots), can be fixed by adding a hint hint.ahci.0.msi="0", for more information see this document

(2) - all apu boards have problems with USB 3.x stick detection in BIOS, system is working properly, but after reboot/warmboot/coldboot USB stick may not appear in BIOS boot menu (depends on the stick, well working sticks are mentioned in this document)

(1) - Voyage Linux is bootable on SD card and works well in read-only mode, remounting as read-write and writing changes to SD sometimes results in kernel panic which often leads to non-operable system

Read more...

Documentation


The list of most useful documents from documentation:

  • CPU Boost - document briefly describes what the Core Performance Boost is and how to verify it works in BIOS and operating system.
  • Fast Boot - document describing research for Fast Boot path for apu boards. The Fast Boot was intended to restore memory configuration from non-volatile storage and reduce the boot time of the platform. You will find the issues and limitations which did not allow to implement the feature.
  • ROCA TPM vulnerability - document describing ROCA TPM vulnerablity status and verification on TPM1a module form PC Engines.
  • APU mPCIe capabilities - list of all signals and interfaces present on mPCIe connectors for apu2/3/4 boards. The document also describes possible usage of the slots.
  • Cold reset - document describing reset types for the platform.
  • Firmware flashing - document describes how to flash new firmware for apu2 board on various operating systems. Also there is a description how to safely reboot the platform after a firmware update.
  • Microcode patching - a guide how to apply a microcode patch on the firmware level by building a custom firmware image.
  • mPCIe modules - list of supported and tested WiFi and LTE modules. The document also describes issues with certain modules and possible solutions/workarounds.
  • Old build system procedure (deprecated) - document describing build procedure for older PC Engines firmware releases. It is deprecated, do not use unless You want to build old binaries.
  • COM2 serial console - a practical guide how to build a firmware binary with native COM2 console support. If You want to use full RS232 COM1 port for other purposes, read the document how to change the main console port.
  • TPM menu - document describes the usage of TPM configuration menu in SeaBIOS.
  • TPM pin mapping - document showing the TPM1a module pinout. It may be useful for users that would like to connect the TPM1a module to boards other than apu2.
  • VBOOT HOWTO - document describing how to build a coreboot image with vboot support and measured boot mode
  • coreboot with Tianocore payload - document describes how to build a coreboot image with Tianocore payload
  • VBOOT HOWTO - document describing how to build a coreboot image with vboot support and measured boot mode
  • GPIO guide - quick guide how to manipulate GPIOs from Linux sysfs
  • Setup menu - briefly describes the runtime configuration options, setup menu and its usage
  • Runtime configuration - describes the runtime configuration options in detail and how to change the option from operating system without physical access to the machine

Mainline releases

v4.19.0.1

Release date: 2023-02-02

  • Changed:
  1. Rebased with official coreboot repository commit 2ccbcc5
  2. Removed configuration and mainboard files for apu1 due to the board being dropped from upstream coreboot
  • Known issues:
    1. APU7 iPXE network boot with i225 NICs does not work
    2. apuled driver doesn't work in FreeBSD. Check the  GPIOs document for workaround.
    3. some PCIe cards are not detected on certain OSes and/or in certain mPCIe slots. Check the  mPCIe modules document for solution/workaround.
    4. booting with 2 USB 3.x sticks plugged in apu4 sometimes results in detecting only 1 stick
    5. certain USB 3.x sticks happen to not appear in boot menu
    6. booting Xen is unstable

    Release date: 2022-08-24

    • Changed:
    1. Rebased with official coreboot repository commit e173f2b
  • Known issues:
    1. APU7 iPXE network boot with i225 NICs does not work
    2. apuled driver doesn't work in FreeBSD. Check the  GPIOs document for workaround.
    3. some PCIe cards are not detected on certain OSes and/or in certain mPCIe slots. Check the  mPCIe modules document for solution/workaround.
    4. booting with 2 USB 3.x sticks plugged in apu4 sometimes results in detecting only 1 stick
    5. certain USB 3.x sticks happen to not appear in boot menu
    6. booting Xen is unstable

    Release date: 2022-07-29

    • Changed:
    1. Rebased with official coreboot repository commit df721bd
  • Known issues:
    1. APU7 iPXE network boot with i225 NICs does not work
    2. apuled driver doesn't work in FreeBSD. Check the  GPIOs document for workaround.
    3. some PCIe cards are not detected on certain OSes and/or in certain mPCIe slots. Check the  mPCIe modules document for solution/workaround.
    4. booting with 2 USB 3.x sticks plugged in apu4 sometimes results in detecting only 1 stick
    5. certain USB 3.x sticks happen to not appear in boot menu
    6. booting Xen is unstable

    Release date: 2022-06-23

    • Changed:
    1. Rebased with official coreboot repository commit 5eda52a
    2. updated sortbootorder to v4.6.24
  • Added:
    1. Support for APU7 (APU3 variant with 2.5GbE i225 NICs)
  • Known issues:
    1. APU7 iPXE network boot with i225 NICs does not work
    2. apuled driver doesn't work in FreeBSD. Check the GPIOs document for workaround.
    3. some PCIe cards are not detected on certain OSes and/or in certain mPCIe slots. Check the mPCIe modules document for solution/workaround.
    4. booting with 2 USB 3.x sticks plugged in apu4 sometimes results in detecting only 1 stick
    5. certain USB 3.x sticks happen to not appear in boot menu
    6. booting Xen is unstable

    Release date: 2022-05-26

    • Changed:
    1. Rebased with official coreboot repository commit 9686ac2261
    2. updated sortbootorder to v4.6.23
    3. updated SeaBIOS to rel-1.16.0.1
  • Known issues:
    1. apuled driver doesn't work in FreeBSD. Check the GPIOs document for workaround.
    2. some PCIe cards are not detected on certain OSes and/or in certain mPCIe slots. Check the mPCIe modules document for solution/workaround.
    3. booting with 2 USB 3.x sticks plugged in apu4 sometimes results in detecting only 1 stick
    4. certain USB 3.x sticks happen to not appear in boot menu
    5. booting Xen is unstable

    Release date: `2022-04-21`

    • Changed:
    1. Rebased with official coreboot repository commit 2c4b426557
  • Known issues:
    1. apuled driver doesn't work in FreeBSD. Check the GPIOs document for workaround.
    2. some PCIe cards are not detected on certain OSes and/or in certain mPCIe slots. Check the mPCIe modules document for solution/workaround.
    3. booting with 2 USB 3.x sticks plugged in apu4 sometimes results in detecting only 1 stick
    4. certain USB 3.x sticks happen to not appear in boot menu
    5. booting Xen is unstable

    Release date: 2022-03-29

    • Changed:
    1. Rebased with official coreboot repository commit 66f99f7fa7
  • Known issues:
    1. apuled driver doesn't work in FreeBSD. Check the GPIOs document for workaround.
    2. some PCIe cards are not detected on certain OSes and/or in certain mPCIe slots. Check the mPCIe modules document for solution/workaround.
    3. booting with 2 USB 3.x sticks plugged in apu4 sometimes results in detecting only 1 stick
    4. certain USB 3.x sticks happen to not appear in boot menu
    5. booting Xen is unstable

    Release date: 2022-03-08

    • Changed:
    1. Rebased with official coreboot repository commit b4ba289fa5
    2. Disabled loglevel prefixes introduced in coreboot 4.16
    3. Disabled ANSI escape sequences introduced in coreboot 4.16
    4. Fixed AMD PSP CCP as entropy source
  • Known issues:
    1. apuled driver doesn't work in FreeBSD. Check the GPIOs document for workaround.
    2. some PCIe cards are not detected on certain OSes and/or in certain mPCIe slots. Check the mPCIe modules document for solution/workaround.
    3. booting with 2 USB 3.x sticks plugged in apu4 sometimes results in detecting only 1 stick
    4. certain USB 3.x sticks happen to not appear in boot menu
    5. booting Xen is unstable

    Release date: 2022-02-16

    • Changed:
    1. Rebased with official coreboot repository commit 36425312ee
    2. Added checking hardware matrix before regression tests
    3. Fixed the hard disk not visible in the Seabios Boot Menu
  • Known issues:
    1. apuled driver doesn't work in FreeBSD. Check the GPIOs document for workaround.
    2. some PCIe cards are not detected on certain OSes and/or in certain mPCIe slots. Check the mPCIe modules document for solution/workaround.
    3. booting with 2 USB 3.x sticks plugged in apu4 sometimes results in detecting only 1 stick
    4. certain USB 3.x sticks happen to not appear in boot menu
    5. booting Xen is unstable

    Release date: 2022-01-11

    • Changed:
    1. rebased with official coreboot repository commit 3990da0b
    2. disabled SMM
    3. enabled parallel AP initialization for apu2-6 for faster boot time
  • Known issues:
    1. apuled driver doesn't work in FreeBSD. Check the GPIOs document for workaround.
    2. some PCIe cards are not detected on certain OSes and/or in certain mPCIe slots. Check the mPCIe modules document for solution/workaround.
    3. booting with 2 USB 3.x sticks plugged in apu4 sometimes results in detecting only 1 stick
    4. certain USB 3.x sticks happen to not appear in boot menu
    5. booting Xen is unstable
    6. APU1: the hard disk is not visible in the Seabios Boot Menu after a coldboot

    Release date: 2021-12-03

    • Changed:
    1. rebased with official coreboot repository commit 6973a3e7
  • Known issues:
    1. apuled driver doesn't work in FreeBSD. Check the GPIOs document for workaround.
    2. some PCIe cards are not detected on certain OSes and/or in certain mPCIe slots. Check the mPCIe modules document for solution/workaround.
    3. booting with 2 USB 3.x sticks plugged in apu4 sometimes results in detecting only 1 stick
    4. certain USB 3.x sticks happen to not appear in boot menu
    5. booting Xen is unstable

    Release date: 2021-11-05

    • Changed:
    1. rebased with official coreboot repository commit d06c0917
    2. Re-added GPIO bindings to fix LED and button functionality
  • Known issues:
    1. apuled driver doesn't work in FreeBSD. Check the GPIOs document for workaround.
    2. some PCIe cards are not detected on certain OSes and/or in certain mPCIe slots. Check the mPCIe modules document for solution/workaround.
    3. booting with 2 USB 3.x sticks plugged in apu4 sometimes results in detecting only 1 stick
    4. certain USB 3.x sticks happen to not appear in boot menu
    5. booting Xen is unstable

    Release date: 2021-10-19

    • Changed:
    1. rebased with official coreboot repository commit d4c55353
    2. Updated CPU declarations in ACPI to comply with newer ACPI standard
    3. Removed GPIO bindings to fix conflict with OS drivers
  • Known issues:
    1. apuled driver doesn't work in FreeBSD. Check the GPIOs document for workaround.
    2. some PCIe cards are not detected on certain OSes and/or in certain mPCIe slots. Check the mPCIe modules document for solution/workaround.
    3. booting with 2 USB 3.x sticks plugged in apu4 sometimes results in detecting only 1 stick
    4. certain USB 3.x sticks happen to not appear in boot menu
    5. booting Xen is unstable

    Release date: 2021-09-17

    • Changed:
    1. rebased with official coreboot repository commit d9f5d90
    2. enabled EHCI controller by default on apu3-apu6 platforms
    3. updated sortbootorder to v4.6.22
  • Added:
    1. safeguard against setting watchdog timeout too low
  • Known issues:
    1. apuled driver doesn't work in FreeBSD. Check the GPIOs document for workaround.
    2. some PCIe cards are not detected on certain OSes and/or in certain mPCIe slots. Check the mPCIe modules document for solution/workaround.
    3. booting with 2 USB 3.x sticks plugged in apu4 sometimes results in detecting only 1 stick
    4. certain USB 3.x sticks happen to not appear in boot menu
    5. booting Xen is unstable

    Release date: 2021-08-06

    • Changed:
    1. rebased with official coreboot repository commit c049c80
  • Known issues:
    1. apuled driver doesn't work in FreeBSD. Check the GPIOs document for workaround.
    2. some PCIe cards are not detected on certain OSes and/or in certain mPCIe slots. Check the mPCIe modules document for solution/workaround.
    3. booting with 2 USB 3.x sticks plugged in apu4 sometimes results in detecting only 1 stick
    4. certain USB 3.x sticks happen to not appear in boot menu
    5. booting Xen is unstable

    Release date: 2021-06-29

    • Changed:
    1. rebased with official coreboot repository commit 1c43d92
  • Known issues:
    1. apuled driver doesn't work in FreeBSD. Check the GPIOs document for workaround.
    2. some PCIe cards are not detected on certain OSes and/or in certain mPCIe slots. Check the mPCIe modules document for solution/workaround.
    3. booting with 2 USB 3.x sticks plugged in apu4 sometimes results in detecting only 1 stick
    4. certain USB 3.x sticks happen to not appear in boot menu
    5. booting Xen is unstable

    Release date: 2021-05-31

    • Changed:
    1. rebased with official coreboot repository commit 6a936fc
    2. updated sortbootorder to v4.6.21
    3. updated SeaBIOS to rel-1.14.0.1
  • Fixed:
    1. inconsistent MTRRs warning in Linux
  • Added:
    1. persistent bootorder and runtime configuration in separate FMAP region for apu2-apu6 platforms
  • Known issues:
    1. apuled driver doesn't work in FreeBSD. Check the GPIOs document for workaround.
    2. some PCIe cards are not detected on certain OSes and/or in certain mPCIe slots. Check the mPCIe modules document for solution/workaround.
    3. booting with 2 USB 3.x sticks plugged in apu4 sometimes results in detecting only 1 stick
    4. certain USB 3.x sticks happen to not appear in boot menu
    5. booting Xen is unstable

    Release date: 2021-05-05

    • Changed:
    1. rebased with official coreboot repository commit a4c09c5
  • Known issues:
    1. apuled driver doesn't work in FreeBSD. Check the GPIOs document for workaround.
    2. some PCIe cards are not detected on certain OSes and/or in certain mPCIe slots. Check the mPCIe modules document for solution/workaround.
    3. booting with 2 USB 3.x sticks plugged in apu4 sometimes results in detecting only 1 stick
    4. certain USB 3.x sticks happen to not appear in boot menu
    5. booting Xen is unstable

    Release date: 2021-04-02

    • Changed:
    1. rebased with official coreboot repository commit e7a68ec
  • Known issues:
    1. apuled driver doesn't work in FreeBSD. Check the GPIOs document for workaround.
    2. some PCIe cards are not detected on certain OSes and/or in certain mPCIe slots. Check the mPCIe modules document for solution/workaround.
    3. booting with 2 USB 3.x sticks plugged in apu4 sometimes results in detecting only 1 stick
    4. certain USB 3.x sticks happen to not appear in boot menu
    5. booting Xen is unstable

    Release date: 2020-02-26

    • Changed:
    1. rebased with official coreboot repository commit c79fc47
  • Known issues:
    1. apuled driver doesn't work in FreeBSD. Check the GPIOs document for workaround.
    2. some PCIe cards are not detected on certain OSes and/or in certain mPCIe slots. Check the mPCIe modules document for solution/workaround.
    3. booting with 2 USB 3.x sticks plugged in apu4 sometimes results in detecting only 1 stick
    4. certain USB 3.x sticks happen to not appear in boot menu
    5. booting Xen is unstable

    Release date: 2021-01-27

    • Changed:
    1. rebased with official coreboot repository commit 5e6e5c1
  • Known issues:
    1. apuled driver doesn't work in FreeBSD. Check the GPIOs document for workaround.
    2. some PCIe cards are not detected on certain OSes and/or in certain mPCIe slots. Check the mPCIe modules document for solution/workaround.
    3. booting with 2 USB 3.x sticks plugged in apu4 sometimes results in detecting only 1 stick
    4. certain USB 3.x sticks happen to not appear in boot menu
    5. booting Xen is unstable

    Release date: 2020-12-28

    • Fixed/added:
    1. rebased with official coreboot repository commit 8edb48b
    2. Fixed serial number calculation on APU1
  • Known issues:
    1. apuled driver doesn't work in FreeBSD. Check the GPIOs document for workaround.
    2. some PCIe cards are not detected on certain OSes and/or in certain mPCIe slots. Check the mPCIe modules document for solution/workaround.
    3. booting with 2 USB 3.x sticks plugged in apu4 sometimes results in detecting only 1 stick
    4. certain USB 3.x sticks happen to not appear in boot menu
    5. booting Xen is unstable

    Release date: 2020-11-27

    • Fixed/added:
    1. rebased with official coreboot repository commit 9b7dc76
  • Known issues:
    1. apuled driver doesn't work in FreeBSD. Check the GPIOs document for workaround.
    2. some PCIe cards are not detected on certain OSes and/or in certain mPCIe slots. Check the mPCIe modules document for solution/workaround.
    3. booting with 2 USB 3.x sticks plugged in apu4 sometimes results in detecting only 1 stick
    4. certain USB 3.x sticks happen to not appear in boot menu
    5. booting Xen is unstable

    Release date: 2020-10-28

    • Fixed/added:
    1. rebased with official coreboot repository commit 43439f6
  • Known issues:
    1. apuled driver doesn't work in FreeBSD. Check the GPIOs document for workaround.
    2. some PCIe cards are not detected on certain OSes and/or in certain mPCIe slots. Check the mPCIe modules document for solution/workaround.
    3. booting with 2 USB 3.x sticks plugged in apu4 sometimes results in detecting only 1 stick
    4. certain USB 3.x sticks happen to not appear in boot menu
    5. booting Xen is unstable

    Release date: 2020-09-29

    • Fixed/added:
    1. rebased with official coreboot repository commit da3375e
    2. added apu6 platform support
  • Known issues:
    1. apuled driver doesn't work in FreeBSD. Check the GPIOs document for workaround.
    2. some PCIe cards are not detected on certain OSes and/or in certain mPCIe slots. Check the mPCIe modules document for solution/workaround.
    3. booting with 2 USB 3.x sticks plugged in apu4 sometimes results in detecting only 1 stick
    4. certain USB 3.x sticks happen to not appear in boot menu
    5. booting Xen is unstable

    Release date: 2020-08-27

    • Fixed/added:
    1. rebased with official coreboot repository commit 81a2f45
    2. fixed TPM2 visibility in OS for apu3d and apu4d
    3. fixed issues with IRQ vectors reported in Xen and Linux dmesg
    4. updated sortbootorder to v4.6.20
  • Known issues:
    1. apuled driver doesn't work in FreeBSD. Check the GPIOs document for workaround.
    2. some PCIe cards are not detected on certain OSes and/or in certain mPCIe slots. Check the mPCIe modules document for solution/workaround.
    3. booting with 2 USB 3.x sticks plugged in apu4 sometimes results in detecting only 1 stick
    4. certain USB 3.x sticks happen to not appear in boot menu
    5. booting Xen is unstable

    Release date: 2020-07-29

    Documentation


    The list of most useful documents from documentation:

    • CPU Boost - document briefly describes what the Core Performance Boost is and how to verify it works in BIOS and operating system.
    • Fast Boot - document describing research for Fast Boot path for apu boards. The Fast Boot was intended to restore memory configuration from non-volatile storage and reduce the boot time of the platform. You will find the issues and limitations which did not allow to implement the feature.
    • ROCA TPM vulnerability - document describing ROCA TPM vulnerablity status and verification on TPM1a module form PC Engines.
    • APU mPCIe capabilities - list of all signals and interfaces present on mPCIe connectors for apu2/3/4 boards. The document also describes possible usage of the slots.
    • Cold reset - document describing reset types for the platform.
    • Firmware flashing - document describes how to flash new firmware for apu2 board on various operating systems. Also there is a description how to safely reboot the platform after a firmware update.
    • Microcode patching - a guide how to apply a microcode patch on the firmware level by building a custom firmware image.
    • mPCIe modules - list of supported and tested WiFi and LTE modules. The document also describes issues with certain modules and possible solutions/workarounds.
    • Old build system procedure (deprecated) - document describing build procedure for older PC Engines firmware releases. It is deprecated, do not use unless You want to build old binaries.
    • COM2 serial console - a practical guide how to build a firmware binary with native COM2 console support. If You want to use full RS232 COM1 port for other purposes, read the document how to change the main console port.
    • TPM menu - document describes the usage of TPM configuration menu in SeaBIOS.
    • TPM pin mapping - document showing the TPM1a module pinout. It may be useful for users that would like to connect the TPM1a module to boards other than apu2.
    • VBOOT HOWTO - document describing how to build a coreboot image with vboot support and measured boot mode
    • coreboot with Tianocore payload - document describes how to build a coreboot image with Tianocore payload
    • VBOOT HOWTO - document describing how to build a coreboot image with vboot support and measured boot mode
    • GPIO guide - quick guide how to manipulate GPIOs from Linux sysfs
    • Setup menu - briefly describes the runtime configuration options, setup menu and its usage

    Mainline releases


    Release date: 2020-07-29

    • Fixed/added:
    1. rebased with official coreboot repository commit 8d5cedf
    2. fixed cbmem error on apu1 caused by wrong ACPI table
    3. fixed memory speed values in DMI table
    4. added option in runtime config to reverse PCI addressing order
    5. updated sortbootorder to v4.6.19
  • Known issues:
    1. apuled driver doesn't work in FreeBSD. Check the GPIOs document for workaround.
    2. some PCIe cards are not detected on certain OSes and/or in certain mPCIe slots. Check the mPCIe modules document for solution/workaround.
    3. booting with 2 USB 3.x sticks plugged in apu4 sometimes results in detecting only 1 stick
    4. certain USB 3.x sticks happen to not appear in boot menu
    5. booting Xen is unstable

    See an example how to verify the signatures on asciinema

    Release date: 2020-03-27

    • Fixed/added:
    1. rebased with official coreboot repository commit 90557f4
    2. fixed processors definitions and scope in ACPI
    3. added missing GNB IOAPIC initialization
    4. enabled PCI Express power management capabilities: ASPM L0s and L1, CommonClock, ClockPowerManagement
    5. added PCI Express endpoint reset logic using GPIOs for apu2
    6. added thermal zone definition in ACPI
    7. added SMBIOS memory tables for apu1
    8. added GNB IOAPIC to MP table
  • Known issues:
    1. Reduction in network performance after upgrading to v4.11.0.5
    2. agesa errors on apu1 when booting 4.11.0.5
    3. apu1 with v4.11.0.5: memtest hangs at start
    4. Random boot loader hangup on apu1d4 with v4.11.0.5
    5. PCIe modules not detected in mPCIe2 slot
    6. apuled driver doesn't work in FreeBSD. Check the GPIOs document for workaround.
    7. some PCIe cards are not detected on certain OSes and/or in certain mPCIe slots. Check the mPCIe modules document for solution/workaround.
    8. booting with 2 USB 3.x sticks plugged in apu4 sometimes results in detecting only 1 stick
    9. certain USB 3.x sticks happen to not appear in boot menu
    10. booting Xen is unstable

    See an example how to verify the signatures on asciinema

    Release date: `2019-05-10`

    • Fixed/added:
    1. rebased with official coreboot repository commit fe80bf2
    2. MP table creation: fixed SDHCI, xHCI interrupt entries
    3. removed redundant SVI2 information string in sign-of-life
    4. added MP table entries for PCIe bridges, endpoints and IOMMU
  • Known issues:
    1. some PCIe cards are not detected on certain OSes and/or in certain mPCIe slots.Check the mPCIe modules document for solution/workaround.
    2. booting with 2 USB 3.x sticks plugged in apu4 sometimes results in detecting only 1 stick
    3. certain USB 3.x sticks happen to not appear in boot menu
    4. booting Xen is unstable

    See an example how to verify the signatures on asciinema

    Release date: 2019-03-08

    • Fixed/added:
    1. rebased with official coreboot repository commit 7a732b4
    2. sortbootorder updated to v4.6.13 introducing CPU boost runtime configuration
    3. release firmware is now built with coreboot SDK 1.52
    4. configured pull-ups on WLAN_DISABLE# pins on the mPCIe connectors which could cause issues with certain modems when floating
    5. fixed microcode update option in menuconfig
    6. added information about ECC memory capability in SMBIOS tables on 4GB platforms
    7. added interrupt configuration entries for PCIe bridge devices 2.4 and 2.5
    8. reproducible builds limiation has been eliminated by setting fixed revisions for iPXE and Memtest86+.
  • Known issues:
    1. some PCIe cards are not detected on certain OSes and/or in certain mPCIe slots.Check the mPCIe modules document for solution/workaround.
    2. booting with 2 USB 3.x sticks plugged in apu4 sometimes results in detecting only 1 stick
    3. certain USB 3.x sticks happen to not appear in boot menu
    4. booting Xen is unstable

    See an example how to verify the signatures on asciinema

    Release date: 2019-01-04

    • Fixed/added:
    1. rebased with official coreboot repository commit cd26f08
    2. updated SeaBIOS to rel-1.12.0.1
    3. prepared apu1 platform for TPM usage
    4. enabled TPM2.0 module on apu1, apu2 and apu5 in default configuration
    5. disabled waiting for SVI2 command completion causing reboot hangs
    6. introduced reproducible builds by passing build ID to iPXE
    7. AGESA AmdInitLate error caused by AGESA bugs
  • Known issues:
    1. some PCIe cards are not detected on certain OSes and/or in certain mPCIe slots.Check the mPCIe modules document for solution/workaround.
    2. booting with 2 USB 3.x sticks plugged in apu4 sometimes results in detecting only 1 stick
    3. certain USB 3.x sticks happen to not appear in boot menu
    4. booting Xen is unstable

    See an example how to verify the signatures on asciinema

    Release date: 2018-12-10

    • Fixed/added:
    1. coreboot: added experimental option for adding microcode update
    2. coreboot: enabled PCIe ACS and AER capabilities
    3. coreboot: added COM2 redirection runtime configuration
    4. coreboot: fixed generating serial number from MAC address of first NIC
    5. coreboot: synced and rebased with coreboot official repo commit 26d706b
    6. sortbootorder: fixed BIOS WP feature for different Winbond chips
    7. sortbootorder: BIOS WP is now set after saving bootorder changes
    8. sortbootorder: set SRP bit on Macronix SPI (apu1) when enabling BIOS WP
  • Known issues:
    1. CPU frequency is stuck at low frequencies and does not react to stressin"
    2. some PCIe cards are not detected on certain OSes and/or in certain mPCIe slots.Check the mPCIe modules document for solution/workaround.
    3. booting with 2 USB 3.x sticks plugged in apu4 sometimes results in detecting only 1 stick
    4. certain USB 3.x sticks happen to not appear in boot menu
    5. booting Xen is unstable
    6. platforms happen to hang after reboot

    See an example how to verify the signatures on asciinema

    Release date: 2018-07-08

    • Fixed/added:
    1. synced and rebased with coreboot official repo commit afc74ca
  • Known issues:
    1. changing bootorder on apu1 does not work
    2. some PCIe cards are not detected on certain OSes and/or in certain mPCIe slots.Check the mPCIe modules document for solution/workaround.
    3. booting with 2 USB 3.x sticks plugged in apu4 sometimes results in detecting only 1 stick
    4. certain USB 3.x sticks happen to not appear in boot menu

    See an example how to verify the signatures on asciinema

    Release date: 2018-06-08

    • Fixed/added:
    1. Rebased coreboot repository to official coreboot 4.8.0
  • Known issues:
    1. changing bootorder on apu1 does not work
    2. some PCIe cards are not detected on certain OSes and/or in certain mPCIe slots.Check the mPCIe modules document for solution/workaround.
    3. booting with 2 USB 3.x sticks plugged in apu4 sometimes results in detecting only 1 stick
    4. certain USB 3.x sticks happen to not appear in boot menu

    See an example how to verify the signatures on asciinema

    Release date: 2018-06-08

    • Fixed/added:
    1. Updated SeaBIOS to 1.11.0.5
    2. Updated sortbootorder to v4.6.9
    3. S1 button support for apu5b
  • Known issues:
    1. changing bootorder on apu1 does not work
    2. some PCIe cards are not detected on certain OSes and/or in certain mPCIe slots.Check the mPCIe modules document for solution/workaround.
    3. booting with 2 USB 3.x sticks plugged in apu4 sometimes results in detecting only 1 stick
    4. certain USB 3.x sticks happen to not appear in boot menu

    See an example how to verify the signatures on asciinema

    Release date: 2018-05-11

    • Fixed/added:
    1. infrastructure to include microcode update
    2. support for new building system pce-fw-builder
    3. building is now possible with official coreboot-sdk container
    4. retrieving board serial number
  • Known issues:
    1. changing bootorder on apu1 does not work
    2. some PCIe cards are not detected on certain OSes and/or in certain mPCIe slots.Check the mPCIe modules document for solution/workaround.
    3. booting with 2 USB 3.x sticks plugged in apu4 sometimes results in detecting only 1 stick
    4. certain USB 3.x sticks happen to not appear in boot menu

    See an example how to verify the signatures on asciinema

    Release date: 2018-04-06

    • Fixed/added:
    1. support for apu1
    2. S1 button feature (serial console enable)
    3. switched SATA controller mode from IDE to AHCI mode
  • Known issues:
    1. changing bootorder on apu1 does not work
    2. some PCIe cards are not detected on certain OSes and/or in certain mPCIe slots.Check the mPCIe modules document for solution/workaround.
    3. booting with 2 USB 3.x sticks plugged in apu4 sometimes results in detecting only 1 stick
    4. certain USB 3.x sticks happen to not appear in boot menu

    See an example how to verify the signatures on asciinema

    Release date: 2018-03-01

    • Fixed/added:
    1. SD card low performance
    2. SMBIOS wrong entries
    3. xHCi is enabled (timeouts has been adjusted in SeaBIOS, as a result USB 3.x sticks detection rate increased)
  • Known issues:
    1. pfSense installation may fail on hard disks - workaround
    2. some PCIe cards are not detected on certain OSes and/or in certain mPCIe slots.Check the mPCIe modules document for solution/workaround.

    See an example how to verify the signatures on asciinema

    Release date: 2018-01-31

    • Fixed/added:
    1. SeaBIOS 1.11.0.3 - enabled UDMA for faster boot, fixed serial console disable bug
    2. screen is refreshed properly in Memtest86+
  • Known issues:
    1. pfSense installation may fail on hard disks
    2. pfSense can not be installed from USB due to xHCi disabled
    3. USB 3.x sticks are handled like USB 2.0 sticks, but are detected
    4. wrong names in SMBIOS causes some modules not being loaded on certain OSes
    5. SD card performance is lower than in legacy releases
    6. some PCIe cards are not detected on certain OSes and/or in certain mPCIe slots.Check the mPCIe modules document for solution/workaround.

    See an example how to verify the signatures on asciinema

    Release date: 2017-12-29

    • Fixed/added:
    1. SeaBIOS 1.11.0.2 - fixes bug with serial console output shift
    2. disabled xHCI, force EHCI controller on front ports
  • Known issues:
    1. pfSense installation may fail on hard disks
    2. pfSense can not be installed from USB due to xHCi disabled
    3. USB 3.x sticks are handled like USB 2.0 sticks, but are detected
    4. wrong names in SMBIOS causes some modules not being loaded on certain OSes
    5. refreshing screen dos not work properly in Memtest86+
    6. serial console disable option does not affect SeaBIOS
    7. SD card performance is lower than in legacy releases
    8. some PCIe cards are not detected on certain OSes and/or in certain mPCIe slots.Check the mPCIe modules document for solution/workaround.

    See an example how to verify the signatures on asciinema

    Release date: 2017-11-30

    • Fixed/added:
    1. apu4 support
    2. updated SeaBIOS 1.11.0.1 (removed sgabios)
    3. Memtest86+ is built from coreboot Memtest86+ repository
  • Known issues:
    1. pfSense installation may fail on hard disks - workaround
    2. USB 3.x sticks happen to not appear in boot menu
    3. wrong names in SMBIOS causes some modules not being loaded on certain OSes
    4. restoring default configuration in sortbootorder works only for bootorder
    5. refreshing screen dos not work properly in Memtest86+
    6. serial console disable option does not affect SeaBIOS
    7. SeaBIOS serial console output is sometimes wrongly shifted
    8. SD card performance is lower than in legacy releases
    9. some PCIe cards are not detected on certain OSes and/or in certain mPCIe slots.Check the mPCIe modules document for solution/workaround.

    See an example how to verify the signatures on asciinema

    Release date: 2017-10-30

    • Fixed/added:
    1. UARTc/c and mPCIe2 CLK enable/disable runtime configuration works now
  • Known issues:
    1. pfSense installation may fail on hard disks - workaround
    2. USB 3.x sticks happen to not appear in boot menu
    3. wrong names in SMBIOS causes some modules not being loaded on certain OSes
    4. restoring default configuration in sortbootorder works only for bootorder
    5. SD card performance is lower than in legacy releases
    6. some PCIe cards are not detected on certain OSes and/or in certain mPCIe slots.Check the mPCIe modules document for solution/workaround.

    See an example how to verify the signatures on asciinema

    Release date: 2017-09-29

    • Fixed/added:
    1. date format in sign-of-life string
    2. Memtest86+ does nto hang now
  • Known issues:
    1. pfSense installation may fail on hard disks - workaround
    2. USB 3.x sticks happen to not appear in boot menu
    3. wrong names in SMBIOS causes some modules not being loaded on certain OSes
    4. UARTc/c and mPCIe2 CLK enable/disable runtime configuration do not work
    5. restoring default configuration in sortbootorder works only for bootorder
    6. SD card performance is lower than in legacy releases
    7. some PCIe cards are not detected on certain OSes and/or in certain mPCIe slots.Check the mPCIe modules document for solution/workaround.

    See an example how to verify the signatures on asciinema

    Release date: 2017-08-30

    • Fixed/added:
    1. apu5 support
  • Known issues:
    1. pfSense installation may fail on hard disks - workaround
    2. USB 3.x sticks happen to not appear in boot menu
    3. wrong names in SMBIOS causes some modules not being loaded on certain OSes
    4. Memtest86+ hangs
    5. UARTc/c and mPCIe2 CLK enable/disable runtime configuration do not work
    6. restoring default configuration in sortbootorder works only for bootorder
    7. SD card performance is lower than in legacy releases
    8. some PCIe cards are not detected on certain OSes and/or in certain mPCIe slots.Check the mPCIe modules document for solution/workaround.

    See an example how to verify the signatures on asciinema

    Release date: 2020-02-25

    • Fixed/added:
    1. SD card boot order is fixed on apu5
    2. added ARM management controller interaction on apu5
  • Known issues:
    1. certain USB 3.x sticks happen to not appear in boot menu
    2. some PCIe cards are not detected on certain OSes and/or in certain mPCIe slots.Check the mPCIe modules document for solution/workaround.

    See an example how to verify the signatures on asciinema

    Release date: 2019-10-09

    • Fixed/added:
    1. fix SD 3.0 mode to be runtime configurable
    2. enable basic ACPI support for GPIOs
    3. soft reset SuperIO GPIOs to set default state
    4. enable IO Base Address mode for SuperIO GPIOs
  • Known issues:
    1. certain USB 3.x sticks happen to not appear in boot menu
    2. some PCIe cards are not detected on certain OSes and/or in certain mPCIe slots.Check the mPCIe modules document for solution/workaround.

    See an example how to verify the signatures on asciinema

    Release date: 2019-09-10

    • Fixed/added:
    1. watchdog is now available on APU3
  • Known issues:
    1. certain USB 3.x sticks happen to not appear in boot menu
    2. some PCIe cards are not detected on certain OSes and/or in certain mPCIe slots.Check the mPCIe modules document for solution/workaround.

    See an example how to verify the signatures on asciinema

    Release date: 2019-07-08

    • Fixed/added:
    1. disabled IPv6 in iPXE that often caused the dhcp/autoboot command to time out
    2. updated SeaBIOS to rel-1.12.1.3
    3. updated sortbootorder to v4.6.15
    4. updated iPXE revision to the 2019.3
  • Known issues:
    1. certain USB 3.x sticks happen to not appear in boot menu
    2. some PCIe cards are not detected on certain OSes and/or in certain mPCIe slots.Check the mPCIe modules document for solution/workaround.
    3. watchdog cannot be enabled on apu3

    See an example how to verify the signatures on asciinema

    Release date: 2019-06-07

    • Fixed/added:
    1. watchdog is now runtime configurable
    2. SD 3.0 mode is now runtime configurable
    3. updated SeaBIOS to rel-1.12.1.2
    4. updated sortbootorder to v4.6.14
    5. ECC presence is now reported in SMBIOS tables
    6. all USB devices have now a single boot order priority
  • Known issues:
    1. certain USB 3.x sticks happen to not appear in boot menu
    2. some PCIe cards are not detected on certain OSes and/or in certain mPCIe slots.Check the mPCIe modules document for solution/workaround.
    3. watchdog cannot be enabled on apu3

    See an example how to verify the signatures on asciinema

    Release date: 2019-01-04

    • Fixed/added:
    1. enabled ECC
    2. disabled EHCI0 controller on apu2 which caused problems with pfSense booting
    3. updated SeaBIOS to rel-1.12.0.1
    4. introduced reproducible builds by providing build ID to iPXE
  • Known issues:
    1. certain USB 3.x sticks happen to not appear in boot menu
    2. some PCIe cards are not detected on certain OSes and/or in certain mPCIe slots.Check the mPCIe modules document for solution/workaround.

    See an example how to verify the signatures on asciinema

    Release date: 2018-12-10

    • Fixed/added:
    1. coreboot: added experimental option for adding microcode update
    2. coreboot: added COM2 redirection runtime configuration
    3. coreboot: fixed generating serial number from MAC address of first NIC
    4. sortbootorder: fixed BIOS WP feature for different Winbond chips
    5. sortbootorder: BIOS WP is now set after saving bootorder changes
    6. sortbootorder: set SRP bit on Macronix SPI (apu1) when enabling BIOS WP
  • Known issues:
    1. certain USB 3.x sticks happen to not appear in boot menu
    2. some PCIe cards are not detected on certain OSes and/or in certain mPCIe slots.Check the mPCIe modules document for solution/workaround.
    3. Sometimes pfSense hangs during boot on boards with legacy firmware when no USB stick present. Plugging USB stick workarounds the issue. Problem is during investigation.

    See an example how to verify the signatures on asciinema

    Release date: 2018-11-08

    • Fixed/added:
    1. SeaBIOS: updated to rel-1.11.0.6
    2. coreboot: fixed release date format in DMI tables
    3. coreboot: added console output redirection to COM2 option
  • Known issues:
    1. certain USB 3.x sticks happen to not appear in boot menu
    2. some PCIe cards are not detected on certain OSes and/or in certain mPCIe slots.Check the mPCIe modules document for solution/workaround.
    3. Sometimes pfSense hangs during boot on boards with legacy firmware when no USB stick present. Plugging USB stick workarounds the issue. Problem is during investigation.

    See an example how to verify the signatures on asciinema

    Release date: 2018-09-28

    • Fixed/added:
    1. Updated sortbootorder to v4.6.11
  • Known issues:
    1. certain USB 3.x sticks happen to not appear in boot menu
    2. some PCIe cards are not detected on certain OSes and/or in certain mPCIe slots.Check the mPCIe modules document for solution/workaround.

    See an example how to verify the signatures on asciinema

    Legacy releases

    v4.0.33

    Release date: 2020-10-28

    • Fixed/added:
    1. Fixed option in runtime config to reverse PCI addressing order
  • Known issues:
    1. certain USB 3.x sticks happen to not appear in boot menu
    2. some PCIe cards are not detected on certain OSes and/or in certain mPCIe slots.Check the mPCIe modules document for solution/workaround.

    Release date: 2020-07-29

    • Fixed/added:
    1. added option in runtime config to reverse PCI addressing order
  • Known issues:
    1. certain USB 3.x sticks happen to not appear in boot menu
    2. some PCIe cards are not detected on certain OSes and/or in certain mPCIe slots.Check the mPCIe modules document for solution/workaround.

    Release date: 2020-06-27

    • Fixed/added:
    1. fixed watchdog not causing reset after cold boot
  • Known issues:
    1. certain USB 3.x sticks happen to not appear in boot menu
    2. some PCIe cards are not detected on certain OSes and/or in certain mPCIe slots.Check the mPCIe modules document for solution/workaround.

    Release date: 2020-02-25

    • Fixed/added:
    1. SD card boot order is fixed on apu5
    2. added ARM management controller interaction on apu5
  • Known issues:
    1. certain USB 3.x sticks happen to not appear in boot menu
    2. some PCIe cards are not detected on certain OSes and/or in certain mPCIe slots.Check the mPCIe modules document for solution/workaround.

    Release date: 2019-10-09

    • Fixed/added:
    1. fix SD 3.0 mode to be runtime configurable
    2. enable basic ACPI support for GPIOs
    3. soft reset SuperIO GPIOs to set default state
    4. enable IO Base Address mode for SuperIO GPIOs
  • Known issues:
    1. certain USB 3.x sticks happen to not appear in boot menu
    2. some PCIe cards are not detected on certain OSes and/or in certain mPCIe slots.Check the mPCIe modules document for solution/workaround.

    Release date: 2019-09-10

    • Fixed/added:
    1. watchdog is now available on APU3
  • Known issues:
    1. certain USB 3.x sticks happen to not appear in boot menu
    2. some PCIe cards are not detected on certain OSes and/or in certain mPCIe slots.Check the mPCIe modules document for solution/workaround.

    Release date: 2019-07-08

    • Fixed/added:
    1. disabled IPv6 in iPXE that often caused the dhcp/autoboot command to time out
    2. updated SeaBIOS to rel-1.12.1.3
    3. updated sortbootorder to v4.6.15
    4. updated iPXE revision to the 2019.3
  • Known issues:
    1. certain USB 3.x sticks happen to not appear in boot menu
    2. some PCIe cards are not detected on certain OSes and/or in certain mPCIe slots.Check the mPCIe modules document for solution/workaround.
    3. watchdog cannot be enabled on apu3

    Release date: 2019-06-07

    • Fixed/added:
    1. watchdog is now runtime configurable
    2. SD 3.0 mode is now runtime configurable
    3. updated SeaBIOS to rel-1.12.1.2
    4. updated sortbootorder to v4.6.14
    5. ECC presence is now reported in SMBIOS tables
    6. all USB devices have now a single boot order priority
  • Known issues:
    1. certain USB 3.x sticks happen to not appear in boot menu
    2. some PCIe cards are not detected on certain OSes and/or in certain mPCIe slots.Check the mPCIe modules document for solution/workaround.
    3. watchdog cannot be enabled on apu3