openpower-coreboot-docs

Documentation related to POWER9 coreboot porting effort.

Introduction

3mdeb Embedded Systems Consulting is porting POWER9 architecture with Raptor Comupting Systems' Talos II and Talos II lite as reference platforms. The project has been initiated and is sponsored by Insurgo Technologies Libres/Open Technologies. The development process is open and anyone can join. See How to help and contribute section.

If you are interested in released coreboot images, check out the releases.

To start working on the project, see the project introduction.

Repository overview

• devnotes - various developer notes created during the porting
  • isteps_analysis.md - file containing a table of content for analysis of isteps/IPL flow
• logs - a place to put important dumps and logs, which can be linked in the documents
• images - directory containins images linked in the documents

Public documentation

Various related documentation of OpenPOWER architecture, registers and programming guides:

• OpenPOWER 64bit ELF ABI
• OpenPOWER 64bit ELF ABI errata
• POWER9 IPL flow
• OpenFSI specification
• POWER9 processor programming model
• POWER9 Registers vol1
• POWER9 Registers vol2
• POWER9 Registers vol3
• POWER ISA v3.0B
• POWER9 processor errata
• Power9 PCIe Controller
• PHB4 Specification (PCIe related)

Other useful information extracted form documents aboive may be found in ppc.md.

Also information about the porting process are included in porting.md.

How to help and contribute

If you have Talos II or Talos II Lite simply joins forces with us. Everything is developed in open on 3mdeb's GitHub:

• coreboot, use talos_2_support branch as base, create own branch and set up a PR
• pnor, use coreboot branch as a base, create own branch and set up a PR
• talos-op-build, use coreboot branch as a base, create own branch and set up a PR
• op-docker, dockerized environment to build full PNOR images for Talos II op-build, refer to its README to get details how to use it. Use own branches for talos-op-build to test your changes. Refer to Implementing op-build support for coreboot to get details how to modify op-build to your needs.

If you need another repo, let us know.

Do not have hardware? No problem, we can arrange remote access to our development machine. Just contact us to get details.

Do not have time to develop? No problem. If you are knowledgeable about OpenPOWER and POWER9 architecture, feel free to use your knowledge to support us (e.g. through PR reviews).