Shadowgraph
TrendingAbout
Sign in

riscv-non-isa/riscv-uefi

Makefile

34

40 commits

updated Jul 21, 2026

riscv.atlassian.net/browse/RVG-49

See the code

README

RISC-V Platforms need special UEFI Protocols. The discussion of such requirements occurs on the RISC-V Unix Platform Mailing list. It is publicly readable but posting requires being a member of the RISC-V Foundation. Any new UEFI Protocol needs to be discussed and approved there before being merged. Once approved in RISC-V community, it can be added/referenced to the UEFI spec maintained by UEFI forum.

License

This work is licensed under a Creative Commons Attribution 4.0 International License (CC-BY-4.0). See the LICENSE file for details.

Contributors

Contributors to this specification are contained in the contributors.adoc file.

Dependencies

This project is built using AsciiDoctor (Ruby). The repository has been setup to build the PDF on checkin using GitHub actions. Workflow ependencies are located in the dependencies directory.

For more information on the AsciiDoctor, specification guidelines, or building locally, see the RISC-V Documentation Developer Guide.

Cloning the project

This project uses GitHub Submodules to include the RISC-V docs-resources project to achieve a common look and feel.

When cloning this repository for the first time, you must either use git clone --recurse-submodules or execute git submodule init and git submodule update after the clone to populate the docs-resources directory. Failure to clone the submodule, will result in the PDF build fail with an error message like the following:

$ make
asciidoctor-pdf \
-a toc \
-a compress \
-a pdf-style=docs-resources/themes/riscv-pdf.yml \
-a pdf-fontsdir=docs-resources/fonts \
--failure-level=ERROR \
-o profiles.pdf profiles.adoc
asciidoctor: ERROR: could not locate or load the built-in pdf theme `docs-resources/themes/riscv-pdf.yml'; reverting to default theme
No such file or directory - notoserif-regular-subset.ttf not found in docs-resources/fonts
  Use --trace for backtrace
make: *** [Makefile:7: profiles.pdf] Error 1

Building the document

The final specification form of PDF can be generated using the make command.

Similar repos

riscv-non-isa/riscv-asm-manual

RISC-V Assembly Programmer's Manual

1,646

same org

riscv-non-isa/riscv-toolchain-conventions

Documenting the expected behaviour and supported command-line switches for GNU and LLVM based…

152

same org

riscv-non-isa/riscv-semihosting

32

same org

riscv-non-isa/riscv-c-api-doc

Documentation of the RISC-V C API

89

same org

riscv-non-isa/riscv-sbi-doc

Documentation for the RISC-V Supervisor Binary Interface

482

same org

riscv-non-isa/riscv-elf-psabi-doc

A RISC-V ELF psABI Document

855

same org

riscv/riscv-profiles

RISC-V Architecture Profiles

192

riscv/riscv-semihosting-spec

32

Languages

Makefile

100.0%

riscv-non-isa/riscv-uefi

Makefile

34

40 commits

updated Jul 21, 2026

riscv.atlassian.net/browse/RVG-49

See the code

README

RISC-V Platforms need special UEFI Protocols. The discussion of such requirements occurs on the RISC-V Unix Platform Mailing list. It is publicly readable but posting requires being a member of the RISC-V Foundation. Any new UEFI Protocol needs to be discussed and approved there before being merged. Once approved in RISC-V community, it can be added/referenced to the UEFI spec maintained by UEFI forum.

License

This work is licensed under a Creative Commons Attribution 4.0 International License (CC-BY-4.0). See the LICENSE file for details.

Contributors

Contributors to this specification are contained in the contributors.adoc file.

Dependencies

This project is built using AsciiDoctor (Ruby). The repository has been setup to build the PDF on checkin using GitHub actions. Workflow ependencies are located in the dependencies directory.

For more information on the AsciiDoctor, specification guidelines, or building locally, see the RISC-V Documentation Developer Guide.

Cloning the project

This project uses GitHub Submodules to include the RISC-V docs-resources project to achieve a common look and feel.

When cloning this repository for the first time, you must either use git clone --recurse-submodules or execute git submodule init and git submodule update after the clone to populate the docs-resources directory. Failure to clone the submodule, will result in the PDF build fail with an error message like the following:

$ make
asciidoctor-pdf \
-a toc \
-a compress \
-a pdf-style=docs-resources/themes/riscv-pdf.yml \
-a pdf-fontsdir=docs-resources/fonts \
--failure-level=ERROR \
-o profiles.pdf profiles.adoc
asciidoctor: ERROR: could not locate or load the built-in pdf theme `docs-resources/themes/riscv-pdf.yml'; reverting to default theme
No such file or directory - notoserif-regular-subset.ttf not found in docs-resources/fonts
  Use --trace for backtrace
make: *** [Makefile:7: profiles.pdf] Error 1

Building the document

The final specification form of PDF can be generated using the make command.

Similar repos

riscv-non-isa/riscv-asm-manual

RISC-V Assembly Programmer's Manual

1,646

same org

riscv-non-isa/riscv-toolchain-conventions

Documenting the expected behaviour and supported command-line switches for GNU and LLVM based…

152

same org

riscv-non-isa/riscv-semihosting

32

same org

riscv-non-isa/riscv-c-api-doc

Documentation of the RISC-V C API

89

same org

riscv-non-isa/riscv-sbi-doc

Documentation for the RISC-V Supervisor Binary Interface

482

same org

riscv-non-isa/riscv-elf-psabi-doc

A RISC-V ELF psABI Document

855

same org

riscv/riscv-profiles

RISC-V Architecture Profiles

192

riscv/riscv-semihosting-spec

32

Languages

Makefile

100.0%