TG RISC-V Nexus Trace

Status of each PDF

2024/05/23 status:

PDFs 1.0.0_rc34: Using theme from ISA Manual ADOC and columns adjusted (font is smaller).

Inside of ./pdfs directory:

• N-Trace PDF: Version 1.0.0_rc34. Ready for Freeze (accepted by ARC via email).
• Controls PDF: Version 1.0.0_rc34. Almost ready for Freeze (see TODO below).
• Connectors PDF: Version 1.0.0_rc34. Ready for Freeze (accepted by ARC via email).

TODO (before official freeze)

• TODO: Issue of 'minimal reset' (in Control PDF) is discussed with ARC and TG.
• TODO: Fix annoying page breaks (manual insert of 'page-break').
• TODO: Make release with all PDFs 'Frozen', same date/version and pass back to ARC for official OK-stamp.
• TODO: Make Public Review announcement (all PDFs Frozen).

TODO (after ratification approval)

• TODO: Change status to Ratified.
• TODO: Change date.
• TODO: Remove _rc and make version 1.0.0.
• TODO: Make official release.
• TODO: Place all 3 PDFs into 'public' place (and update/add links).

Repository Overview

Working repository of the RISC-V Nexus Trace TG report. Nexus Trace TG Home page is here.

• Main N-Trace specification is defined here: RISC-V-N-Trace.adoc and PDF version is here: PDF.

• Trace Control Interface is defined here: RISC-V-Trace-Control-Interface.adoc and PDF version is here: PDF.

• Trace connectors are defined here: RISC-V-Trace-Connectors.adoc and PDF version is here: PDF.

Clicking on ADOC file in the github repo viewer will render a usable version as markdown.

For a better rendering to PDF, use Actions in main menu above.

Reference C code for Nexus Trace dumper/encoder/decoder is here - documentation as README.md file is provided.

This work is licensed under a Creative Commons Attribution 4.0 International License. See the LICENSE file for details.

Initial Work (Preserved)

For initial document v0.01 (as PDF from MS Word), click here. Same file in ADOC format is here: TG-RISC-V-Nexus-Trace.adoc.

Additional Resources

• The Nexus IEEE-ISTO-5001 Standard (2012-v3.0.1) PDF file.

Documentation generator

PDF version of specification should be generated using Actions menu. See below for more details.

Dependencies

The PDF built in this project uses AsciiDoctor (Ruby). For more information on 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