Skip to content

kgpe-d16: add AGESA 15h coreboot fork support#2092

Open
tlaurion wants to merge 1 commit intomasterfrom
kgpe-d16-15h-coreboot
Open

kgpe-d16: add AGESA 15h coreboot fork support#2092
tlaurion wants to merge 1 commit intomasterfrom
kgpe-d16-15h-coreboot

Conversation

@tlaurion
Copy link
Copy Markdown
Collaborator

@tlaurion tlaurion commented Apr 22, 2026

Summary

  • Add coreboot-15h module pointing to AGESA-based 15h fork for kgpe-d16 board support
  • Move kgpe-d16 boards from unmaintained to maintained
  • Add TPM1 and TPM2 board variants with proper coreboot configs
  • Update CircleCI config to build kgpe-d16 boards
  • Add comprehensive board documentation referencing 15h.org wiki

Changes

New Module

  • Add coreboot-15h git-fork module pinned to specific commit
  • BUILD_LANGUAGES=c added to avoid Ada compiler errors with GCC toolchain
  • Supports up to 512GB DDR3 ECC RAM

Board Variants (8 total)

  • kgpe-d16_server-tpm1, kgpe-d16_server-tpm2
  • kgpe-d16_workstation-tpm1, kgpe-d16_workstation-tpm2
  • kgpe-d16_server-whiptail-tpm1, kgpe-d16_server-whiptail-tpm2
  • kgpe-d16_workstation-usb_keyboard-tpm1, kgpe-d16_workstation-usb_keyboard-tpm2

TPM Configuration

  • TPM1: CONFIG_TPM1=y, CONFIG_TPM_INIT=y, CONFIG_USER_TPM1=y
  • TPM2: CONFIG_TPM2=y, CONFIG_TPM2_MODE=spt, CONFIG_TPM2_PPI=y, CONFIG_OPENSSL=y

Initial Flash (REQUIRED)

  • Stock 2 MiB flash (W25Q16V) is NOT big enough for Heads - must be replaced with 16 MiB chip
  • Initial flash MUST be done externally (3.3V CH341A SPI programmer)
  • Chip location: bottom right corner of board (labeled BIOS)
  • CMOS clear after flashing: move CLRTC1 to 2-3, wait 20s, restore
  • After initial external flash, internal upgrades work like any other Heads board

Board Documentation

  • Board revisions: 1.02G, 1.03G, 1.04, 1.05 (revisions 1.04/1.05 recommended)
  • Hardware specs, TPM chips, VGA_SW1 jumper, fan control, flashing, BMC
  • 15h.org wiki references

Workstation GPU Support

  • Tested: Nvidia GPUs (NvForcePost=1)
  • Linux config: nouveau, radeon, amdgpu

CircleCI

  • Added all 8 kgpe-d16 TPM1 and TPM2 build jobs

Known Issues

  • TPM support still in progress (untested)

Supersedes #1931

Copilot AI review requested due to automatic review settings April 22, 2026 18:07
Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR adds support for building the KGPE-D16 boards against the AGESA-based coreboot “15h” fork, updates board metadata/docs to reflect the new status, and wires the KGPE-D16 builds into CircleCI.

Changes:

  • Add a new coreboot-15h git-fork module pinned to a specific commit.
  • Switch KGPE-D16 board configs to use CONFIG_COREBOOT_VERSION=15h and simplify the per-board coreboot .config fragments.
  • Add KGPE-D16 jobs to the CircleCI workflow and update the boards/testers documentation.

Reviewed changes

Copilot reviewed 11 out of 11 changed files in this pull request and generated 7 comments.

Show a summary per file
File Description
modules/coreboot Introduces the new coreboot-15h fork module and pins its commit.
doc/BOARDS_AND_TESTERS.md Updates KGPE-D16 entry to reflect usage of the 15h fork.
config/coreboot-kgpe-d16_workstation.config Replaces the previous full coreboot config with a minimal fragment for the KGPE-D16 workstation variant.
config/coreboot-kgpe-d16_workstation-usb_keyboard.config Same as above for workstation USB keyboard variant.
config/coreboot-kgpe-d16_server.config Same as above for server variant.
config/coreboot-kgpe-d16_server-whiptail.config Same as above for server-whiptail variant.
boards/kgpe-d16_workstation/kgpe-d16_workstation.config Switches board to CONFIG_COREBOOT_VERSION=15h and adds board notes.
boards/kgpe-d16_workstation-usb_keyboard/kgpe-d16_workstation-usb_keyboard.config Switches board to CONFIG_COREBOOT_VERSION=15h and adds board notes.
boards/kgpe-d16_server/kgpe-d16_server.config Switches board to CONFIG_COREBOOT_VERSION=15h.
boards/kgpe-d16_server-whiptail/kgpe-d16_server-whiptail.config Switches board to CONFIG_COREBOOT_VERSION=15h.
.circleci/config.yml Adds KGPE-D16 builds to CI (but currently with target naming/caching issues).
Comments suppressed due to low confidence (4)

boards/kgpe-d16_workstation-usb_keyboard/kgpe-d16_workstation-usb_keyboard.config:15

  • Typo in board notes: "work around" should be "workaround".
    boards/kgpe-d16_workstation/kgpe-d16_workstation.config:18
  • Typo in board notes: "work around" should be the single word "workaround".
    boards/kgpe-d16_workstation/kgpe-d16_workstation.config:18
  • Typo in board notes: "trubble" should be "trouble".
    boards/kgpe-d16_workstation-usb_keyboard/kgpe-d16_workstation-usb_keyboard.config:15
  • Typo in board notes: "trubble" should be "trouble".

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread .circleci/config.yml Outdated
Comment thread config/coreboot-kgpe-d16_server-tpm1.config_defconfig
Comment thread config/coreboot-kgpe-d16_server-whiptail-tpm1.config_defconfig
Comment thread .circleci/config.yml Outdated
Comment thread modules/coreboot
Comment thread config/coreboot-kgpe-d16_workstation-tpm1.config_defconfig
@tlaurion tlaurion mentioned this pull request Apr 22, 2026
@tlaurion tlaurion force-pushed the kgpe-d16-15h-coreboot branch 2 times, most recently from 83aeb1d to cbfa0b1 Compare April 22, 2026 18:55
@tlaurion tlaurion requested a review from Copilot April 22, 2026 18:55
@tlaurion tlaurion force-pushed the kgpe-d16-15h-coreboot branch 2 times, most recently from 558bb90 to effed43 Compare April 22, 2026 19:00
Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 30 out of 30 changed files in this pull request and generated 5 comments.

Comments suppressed due to low confidence (4)

boards/kgpe-d16_workstation-tpm1/kgpe-d16_workstation-tpm1.config:27

  • CONFIG_COREBOOT_VERSION was switched to the new 15h fork, but this board still points CONFIG_COREBOOT_CONFIG at config/coreboot-kgpe-d16_workstation.config, which does not exist (only -tpm1/-tpm2 coreboot configs are present). This will break builds; update the path to the correct kgpe-d16_workstation-tpm1 coreboot config file.
    boards/kgpe-d16_server-whiptail-tpm1/kgpe-d16_server-whiptail-tpm1.config:25
  • This board now uses CONFIG_COREBOOT_VERSION=15h, but CONFIG_COREBOOT_CONFIG still points to config/coreboot-kgpe-d16_server-whiptail.config, which is not present (only *-server-whiptail-tpm1/tpm2 configs exist). Update CONFIG_COREBOOT_CONFIG to the correct kgpe-d16_server-whiptail-tpm1 coreboot config so the board builds successfully.
    boards/kgpe-d16_workstation-usb_keyboard-tpm1/kgpe-d16_workstation-usb_keyboard-tpm1.config:24
  • This board still references config/coreboot-kgpe-d16_workstation-usb_keyboard.config, but the repo only contains the new -usb_keyboard-tpm1/-usb_keyboard-tpm2 coreboot config filenames. This mismatch will cause make BOARD=kgpe-d16_workstation-usb_keyboard-tpm1 to fail; update CONFIG_COREBOOT_CONFIG to the correct *-tpm1 file.
    boards/kgpe-d16_server-tpm1/kgpe-d16_server-tpm1.config:23
  • This board now uses CONFIG_COREBOOT_VERSION=15h, but CONFIG_COREBOOT_CONFIG points to config/coreboot-kgpe-d16_server.config, which is not present in the repo (only coreboot-kgpe-d16_server-tpm1/tpm2 configs exist). Update the path to the correct kgpe-d16_server-tpm1 coreboot config to avoid build failures.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread .circleci/config.yml Outdated
Comment thread .circleci/config.yml
Comment thread .circleci/config.yml
Comment thread modules/coreboot
Comment thread modules/coreboot Outdated
@tlaurion tlaurion force-pushed the kgpe-d16-15h-coreboot branch from effed43 to a563c07 Compare April 22, 2026 19:01
@tlaurion
Copy link
Copy Markdown
Collaborator Author

tlaurion commented Apr 22, 2026

as per BOARDS_AND_TESTERS.md, testing and review needed. specify which variant you tested, will move others to untested before merging

  • KGPE-D16 (Bulldozer: AMD Family 15h CPU) - dropped in coreboot 4.12, brought back in 15h fork: @arhabd @zifxify

Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 30 out of 30 changed files in this pull request and generated 8 comments.


💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread .circleci/config.yml Outdated
Comment thread .circleci/config.yml Outdated
Comment thread config/coreboot-kgpe-d16_server-whiptail-tpm1.config_defconfig
@tlaurion tlaurion force-pushed the kgpe-d16-15h-coreboot branch from 89c847c to 56ffddf Compare April 22, 2026 19:19
@tlaurion tlaurion requested a review from Copilot April 22, 2026 19:22
@tlaurion tlaurion force-pushed the kgpe-d16-15h-coreboot branch 4 times, most recently from 54f6018 to 95af626 Compare April 22, 2026 19:26
Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 30 out of 30 changed files in this pull request and generated 1 comment.


💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread modules/coreboot
@tlaurion tlaurion force-pushed the kgpe-d16-15h-coreboot branch 4 times, most recently from c9d53b9 to 8890032 Compare April 22, 2026 19:31
@tlaurion tlaurion requested a review from Copilot April 22, 2026 19:34
@tlaurion tlaurion force-pushed the kgpe-d16-15h-coreboot branch 3 times, most recently from 77fef73 to 58b0c58 Compare April 23, 2026 12:45
@tlaurion tlaurion requested a review from Copilot April 23, 2026 12:47
Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 34 out of 34 changed files in this pull request and generated 7 comments.

Comments suppressed due to low confidence (5)

boards/kgpe-d16_workstation/kgpe-d16_workstation.config:18

  • Typo: "work around" should be "workaround".
    boards/kgpe-d16_workstation/kgpe-d16_workstation.config:18
  • Typo: "trubble" should be "trouble".
    boards/kgpe-d16_workstation-usb_keyboard/kgpe-d16_workstation-usb_keyboard.config:15
  • Typo: "work around" should be "workaround".
    boards/kgpe-d16_workstation-usb_keyboard/kgpe-d16_workstation-usb_keyboard.config:16
  • Typo: "trubble" should be "trouble".
    boards/kgpe-d16_workstation/kgpe-d16_workstation.config:17
  • Typo/consistency: "qubes" should be capitalized as "Qubes" (as used elsewhere in the sentence).

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread boards/kgpe-d16_server-tpm1/kgpe-d16_server-tpm1.config Outdated
Comment thread modules/coreboot
Comment thread modules/coreboot
Comment thread config/coreboot-kgpe-d16_workstation-tpm2.config_defconfig
Comment thread boards/kgpe-d16_workstation-tpm1/kgpe-d16_workstation-tpm1.config Outdated
Comment thread boards/kgpe-d16_server-whiptail-tpm1/kgpe-d16_server-whiptail-tpm1.config Outdated
@tlaurion tlaurion force-pushed the kgpe-d16-15h-coreboot branch 3 times, most recently from 9e3beb4 to ebf3a39 Compare April 23, 2026 12:56
@tlaurion tlaurion requested a review from Copilot April 23, 2026 12:59
@tlaurion tlaurion force-pushed the kgpe-d16-15h-coreboot branch from ebf3a39 to 86963db Compare April 23, 2026 13:01
Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 34 out of 34 changed files in this pull request and generated 3 comments.


💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread .circleci/config.yml Outdated
Comment thread .circleci/config.yml Outdated
Comment thread .circleci/config.yml Outdated
@tlaurion tlaurion force-pushed the kgpe-d16-15h-coreboot branch 8 times, most recently from 656aefb to c789796 Compare April 23, 2026 15:19
@tlaurion tlaurion requested a review from Copilot April 23, 2026 15:44
Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 34 out of 34 changed files in this pull request and generated 4 comments.

Comments suppressed due to low confidence (1)

boards/kgpe-d16_server-whiptail/kgpe-d16_server-whiptail.config:25

  • This whiptail board config uses the BMC serial console (ttyS1), but the referenced coreboot config (config/coreboot-kgpe-d16_server-whiptail-tpm1.config) currently sets CONFIG_LINUX_COMMAND_LINE to console=tty0. That mismatch can hide early output / break headless boot. Please update the coreboot config command line to use ttyS1 (consistent with the TPM2 whiptail variant).

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread config/coreboot-kgpe-d16_workstation-tpm2.config_defconfig
Comment thread config/coreboot-kgpe-d16_server-tpm2.config_defconfig
Comment thread config/coreboot-kgpe-d16_server-whiptail-tpm2.config_defconfig
@tlaurion tlaurion force-pushed the kgpe-d16-15h-coreboot branch from 5cd0412 to dda575e Compare April 23, 2026 16:12
- Add coreboot-15h module pointing to AGESA-based 15h fork
- Move kgpe-d16 boards from UNMAINTAINED to maintained
- Add TPM1 and TPM2 board variants with proper coreboot configs
- Add defconfig and oldconfig helper targets documentation
- Update CircleCI config to build kgpe-d16 boards
- Add board documentation referencing 15h.org wiki

Supersedes #1931

Signed-off-by: Thierry Laurion <insurgo@riseup.net>
@tlaurion tlaurion closed this Apr 23, 2026
@tlaurion tlaurion force-pushed the kgpe-d16-15h-coreboot branch from dda575e to 426750a Compare April 23, 2026 16:53
@tlaurion tlaurion reopened this Apr 23, 2026
Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 35 out of 35 changed files in this pull request and generated no new comments.


💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants