Skip to content

Kersten #28

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
kersten1 wants to merge 18 commits into from
Closed

Kersten #28

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
18 commits
Select commit Hold shift + click to select a range
343a6dc
First pass
danielmrichter Aug 31, 2025
499ded0
added spacing in the sections
danielmrichter Sep 1, 2025
1d587e6
gave some style to headers and created a navbar
danielmrichter Sep 1, 2025
f727d05
merge conflicts
danielmrichter Sep 1, 2025
b3d5fd3
changed behaviour to make cards always be the same size
danielmrichter Sep 1, 2025
fb03bdc
added a versioning component to work with custom cards
danielmrichter Sep 2, 2025
3bf90f7
fixed padding issue
danielmrichter Sep 2, 2025
345d672
fixed typing errors
danielmrichter Sep 2, 2025
8f9d686
reordered buttons in footer
danielmrichter Sep 2, 2025
573d0e6
removed background gradients
danielmrichter Sep 2, 2025
4c993fb
updated toc styling
danielmrichter Sep 2, 2025
4e9d9ba
updated pdf button to only serve one link
danielmrichter Sep 2, 2025
510e53f
updated comments
danielmrichter Sep 2, 2025
761d870
created a new component for creating tables, and an example component…
danielmrichter Sep 2, 2025
69a7cf0
another example added using mdx instead of tsx
danielmrichter Sep 3, 2025
26d7bf2
instantiated new more details pages by created new more details butto…
danielmrichter Sep 3, 2025
3956a6a
fixed some links and linked in other example
danielmrichter Sep 3, 2025
5340298
Added the ratified specs
kersten1 Sep 3, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
355 changes: 239 additions & 116 deletions docs/spec/intro.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,143 +6,266 @@ hide_table_of_contents: true
---
import siteConfig from '@site/docusaurus.config';

The RISC-V Library contains a comprehensive list of all of the ratified RISC-V technical publications.

## Instruction Set (ISA) Specifications

These are the current ratified versions of the ISA specifications. Previously published versions and the original ratification specifications for included extensions can be found on the [RISC-V Technical Specifications Archive page](https://lf-riscv.atlassian.net/wiki/spaces/HOME/pages/16154899/RISC-V+Technical+Specifications+Archive).

<Columns className='padding--lg margin-bottom-xl' >
<Column className="text--center col--3">
<Card shadow='tl'>
<CardHeader>
<h3>Volume I</h3>
</CardHeader>
<CardBody>
Unprivileged Architecture
</CardBody>
<CardFooter>
<a href={`${siteConfig.baseUrl}docs/reference/isa/unpriv/intro.html`}>
<button className='button button--secondary button--block'>Version: May 2024</button>
</a>
</CardFooter>
</Card>
</Column>

<Column className="text--center col--3">
<Card shadow='tl'>
<CardHeader>
<h3>Volume II</h3>
</CardHeader>
<CardBody>
Privileged Architecture
</CardBody>
<CardFooter>
<a href={`${siteConfig.baseUrl}docs/reference/isa/priv/priv-intro.html`}>
<button className='button button--secondary button--block'>Version: May 2024</button>
</a>
</CardFooter>
</Card>
</Column>
</Columns>
<div className='page-header'>
# Overview
<p style={{marginBottom: '0px'}}>The RISC-V Library contains a comprehensive list of all of the ratified RISC-V technical publications.</p>
</div>

:::note
Extensions that are ratified, but not yet included in the full specifications, can be found on the [RISC-V Ratified Extensions](https://lf-riscv.atlassian.net/wiki/spaces/HOME/pages/16154732/Ratified+Extensions) page.
:::
<div className='rv-navbar'>
<a href='#isa-spec'>ISA Spec</a>
<a href='#profiles'>Profiles</a>
<a href='#processor-infra'>Processor Infrastructure</a>
<a href='#debug'>Debug, Trace, & RAS</a>
<a href='#platsoft'>Platform Software</a>
<a href='#appsoft'>Application Software</a>
</div>

<div id='isa-spec'>
## RISC-V Instruction Set (ISA) Specifications
These are the current ratified versions of the ISA specifications. Previously published versions and the original ratification specifications can be found at More details for each volume.

<RvCardGrid>
<RvCard details='/details/isa-priv' pdfLink='www.google.com' title='Volume I - Unprivileged Architecture' buttonLabel='View Spec' buttonHref={`${siteConfig.baseUrl}isa`}>
<RvCardVersioning>
<p>Version: 20250508</p>
<p>Published: May 2025</p>
</RvCardVersioning>
<p>Version: 20250508</p>
<p>Published: May 2025</p>
</RvCard>
<RvCard details='/details/isa-unpriv' title='Volume II: Privileged Architecture' buttonLabel='Version: May 2024' buttonHref={`${siteConfig.baseUrl}isa`}>
<p>Version: 20250508</p>
<p>Published: May 2025</p>
</RvCard>
<RvCard details='/details/isa-ratified' title='Ratified Extensions' buttonLabel='Extensions' buttonHref={`${siteConfig.baseUrl}isa`}>
<p>Find extensions that are ratified, but not included in the current, ratified specifications.</p>
</RvCard>
</RvCardGrid>
</div>

---
<div id='profiles'>
## Profiles

These are the current, published versions of the Profiles specifications.

<Columns className='padding--lg margin-bottom-xl'>
<Column className="text--center col--3">
<Card shadow='tl'>
<CardHeader>
<h3>RVA23 Profile</h3>
</CardHeader>
<CardBody>
Focused on Servers and application class processors.
</CardBody>
<CardFooter>
<a href={`${siteConfig.baseUrl}docs/spec/profiles/rva23`}>
<button className='button button--secondary button--block'>Version: October 2024</button>
</a>
</CardFooter>
</Card>
</Column>

<Column className="text--center col--3">
<Card shadow='tl'>
<CardHeader>
<h3>RVB23 Profile</h3>
</CardHeader>
<CardBody>
Focused on Edge embedded Devices.
</CardBody>
<CardFooter>
<a href={`${siteConfig.baseUrl}docs/spec/profiles/rvb23`}>
<button className='button button--secondary button--block'>Version: October 2024</button>
</a>
</CardFooter>
</Card>
</Column>

<Column className="text--center col--3">
<Card shadow='tl'>
<CardHeader>
<h3>RISC-V Profiles</h3>
</CardHeader>
<CardBody>
The older profiles. Archived for historical purposes
</CardBody>
<CardFooter>
<a href={`${siteConfig.baseUrl}docs/spec/profiles/riscv-profiles`}>
<button className='button button--secondary button--block'>Version: March 2023</button>
</a>
</CardFooter>
</Card>
</Column>
<Column className="text--center col--3">
<Card shadow='tl'>
<CardHeader>
<h3>RVA23 Profile</h3>
</CardHeader>
<CardBody>
Focused on Servers and application class processors.
</CardBody>
<CardFooter>
<a href={`${siteConfig.baseUrl}docs/spec/profiles/rva23`}>
<button className='button button--secondary button--block'>Version: October 2024</button>
</a>
</CardFooter>
</Card>
</Column>

<Column className="text--center col--3">
<Card shadow='tl'>
<CardHeader>
<h3>RVB23 Profile</h3>
</CardHeader>
<CardBody>
Focused on Edge embedded Devices.
</CardBody>
<CardFooter>
<a href={`${siteConfig.baseUrl}docs/spec/profiles/rvb23`}>
<button className='button button--secondary button--block'>Version: October 2024</button>
</a>
</CardFooter>
</Card>
</Column>

<Column className="text--center col--3">
<Card shadow='tl'>
<CardHeader>
<h3>RISC-V Profiles</h3>
</CardHeader>
<CardBody>
The older profiles. Archived for historical purposes
</CardBody>
<CardFooter>
<a href={`${siteConfig.baseUrl}docs/spec/profiles/riscv-profiles`}>
<button className='button button--secondary button--block'>Version: March 2023</button>
</a>
</CardFooter>
</Card>
</Column>
</Columns>
</div>

---
<div id='processor-infra'>
## Processor Infrastructure
- [RISC-V Advanced Interrupt Architecture](./non-isa/advanced-interrupt)
- [RISC-V IO Mapping Table Specification](./non-isa/io-mapping)
- [RISC-V IOMMU Architecture Specification ](./non-isa/iommu-architecture)
- [RISC-V Platform-Level Interrupt Controller Specification](./non-isa/platform-interrupt)
- [RISC-V Server SOC Specification](./non-isa/server-soc)

<RvCardGrid>
<RvCard title='RISC-V Advanced Interrupt Architecture' buttonLabel='View Spec' buttonHref='./non-isa/advanced-interrupt'>
<p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Vestibulum imperdiet.</p>
</RvCard>
<RvCard title='RISC-V IO Mapping Table Specification' buttonLabel='View Spec' buttonHref='./non-isa/io-mapping'>
<p>Lorem ipsum dolor sit amet, consectetur elit.</p>
</RvCard>
<RvCard title='RISC-V IOMMU Architecture Specification' buttonLabel='View Spec' buttonHref='./non-isa/iommu-architecture'>
<p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Vestibulum.</p>
</RvCard>
<RvCard title='RISC-V Platform-Level Interrupt Controller Specification' buttonLabel='View Spec' buttonHref='./non-isa/platform-interrupt'>
<p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Vestibulum imperdiet.</p>
</RvCard>
<RvCard title='RISC-V Server SOC Specification' buttonLabel='View Spec' buttonHref='./non-isa/server-soc'>
<p>Lorem ipsum dolor sit amet, consectetur adipiscing elit.</p>
</RvCard>
</RvCardGrid>
</div>

---
<div id='debug'>
## Debug, Trace, & RAS
- [The RISC-V Debug Specification](./non-isa/debug)
- [Efficient Trace for RISC-V](./non-isa/efficient-trace)
- [RISC-V N-Trace (Nexus-based Trace)](./non-isa/n-trace)
- [RISC-V Capacity and Bandwidth QoS Register Interface](./non-isa/qos)
- [RISC-V RERI Architecture Specification](./non-isa/reri)
- [RISC-V Trace Connectors](./non-isa/trace-conectors)
- [RISC-V Trace Control Interface](./non-isa/trace-control-interface)
- [Unformatted Trace & Diagnostic Data Packet Encapsulation for RISC-V](./non-isa/unformatted-trace)

<Columns className='padding--lg margin-bottom-xl'>
<Column className="text--center col--3">
<Card shadow='tl'>
<CardHeader><h3>The RISC-V Debug Specification</h3></CardHeader>
<CardBody>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque tincidunt.</CardBody>
<CardFooter>
<a href='./non-isa/debug'>
<button className='button button--secondary button--block'>View Spec</button>
</a>
</CardFooter>
</Card>
</Column>

<Column className="text--center col--3">
<Card shadow='tl'>
<CardHeader><h3>Efficient Trace for RISC-V</h3></CardHeader>
<CardBody>Lorem ipsum dolor sit amet, consectetur adipiscing elit.</CardBody>
<CardFooter>
<a href='./non-isa/efficient-trace'>
<button className='button button--secondary button--block'>View Spec</button>
</a>
</CardFooter>
</Card>
</Column>

<Column className="text--center col--3">
<Card shadow='tl'>
<CardHeader><h3>RISC-V N-Trace (Nexus-based Trace)</h3></CardHeader>
<CardBody>Lorem ipsum dolor sit amet, consectetur adipiscing.</CardBody>
<CardFooter>
<a href='./non-isa/n-trace'>
<button className='button button--secondary button--block'>View Spec</button>
</a>
</CardFooter>
</Card>
</Column>

<Column className="text--center col--3">
<Card shadow='tl'>
<CardHeader><h3>RISC-V Capacity and Bandwidth QoS Register Interface</h3></CardHeader>
<CardBody>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque tincidunt lorem nec.</CardBody>
<CardFooter>
<a href='./non-isa/qos'>
<button className='button button--secondary button--block'>View Spec</button>
</a>
</CardFooter>
</Card>
</Column>

<Column className="text--center col--3">
<Card shadow='tl'>
<CardHeader><h3>RISC-V RERI Architecture Specification</h3></CardHeader>
<CardBody>Lorem ipsum dolor sit amet, consectetur.</CardBody>
<CardFooter>
<a href='./non-isa/reri'>
<button className='button button--secondary button--block'>View Spec</button>
</a>
</CardFooter>
</Card>
</Column>

<Column className="text--center col--3">
<Card shadow='tl'>
<CardHeader><h3>RISC-V Trace Connectors</h3></CardHeader>
<CardBody>Lorem ipsum dolor sit amet, consectetur adipiscing elit.</CardBody>
<CardFooter>
<a href='./non-isa/trace-conectors'>
<button className='button button--secondary button--block'>View Spec</button>
</a>
</CardFooter>
</Card>
</Column>

<Column className="text--center col--3">
<Card shadow='tl'>
<CardHeader><h3>RISC-V Trace Control Interface</h3></CardHeader>
<CardBody>Lorem ipsum dolor sit amet, consectetur adipiscing elit.</CardBody>
<CardFooter>
<a href='./non-isa/trace-control-interface'>
<button className='button button--secondary button--block'>View Spec</button>
</a>
</CardFooter>
</Card>
</Column>

<Column className="text--center col--3">
<Card shadow='tl'>
<CardHeader><h3>Unformatted Trace & Diagnostic Data Packet Encapsulation for RISC-V</h3></CardHeader>
<CardBody>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque.</CardBody>
<CardFooter>
<a href='./non-isa/unformatted-trace'>
<button className='button button--secondary button--block'>View Spec</button>
</a>
</CardFooter>
</Card>
</Column>
</Columns>
</div>

---
<div id='platsoft'>
## Platform Software
- [RISC-V Functional Fixed Hardware Specification](./non-isa/functional-fixed)
- [RISC-V Semihosting](./non-isa/semihosting)
- [RISC-V Supervisor Binary Interface Specification](./non-isa/sbi)
- [RISC-V UEFI Protocol Specification](./non-isa/uefi)

## Application Software
- [RISC-V ABIs Specification](./non-isa/abi)
<RvCardGrid>
<RvCard title='RISC-V Functional Fixed Hardware Specification' buttonLabel='View Spec' buttonHref='./non-isa/functional-fixed'>
<p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque imperdiet.</p>
</RvCard>
<RvCard title='RISC-V Semihosting' buttonLabel='View Spec' buttonHref='./non-isa/semihosting'>
<p>Lorem ipsum dolor sit amet, consectetur adipiscing elit.</p>
</RvCard>
<RvCard title='RISC-V Supervisor Binary Interface Specification' buttonLabel='View Spec' buttonHref='./non-isa/sbi'>
<p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Vestibulum imperdiet.</p>
</RvCard>
<RvCard title='RISC-V UEFI Protocol Specification' buttonLabel='View Spec' buttonHref='./non-isa/uefi'>
<p>Lorem ipsum dolor sit amet, consectetur adipiscing elit.</p>
</RvCard>
</RvCardGrid>
</div>

## Guides
- [Authoring and Editing RISC-V Specifications](https://github.com/riscv/docs-dev-guide/releases/tag/v0.2.0-example)
---
<div id='appsoft'>
## Application Software

## Glossary
- Terms
- Acronyms
- Alphabetical listing of Extensions
- CSRs
<Columns className='padding--lg margin-bottom-xl'>
<Column className="text--center col--3">
<Card shadow='tl'>
<CardHeader><h3>RISC-V ABIs Specification</h3></CardHeader>
<CardBody>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque tincidunt.</CardBody>
<CardFooter>
<a href='./non-isa/abi'>
<button className='button button--secondary button--block'>View Spec</button>
</a>
</CardFooter>
</Card>
</Column>
</Columns>
</div>

---
:::note
If you do not see a specification in this library, visit the [RISC-V GitHub `riscv-non-isa`](https://github.com/riscv-non-isa) organization to see a complete list of all specifications that have been developed or are presently under development.
:::

3 changes: 1 addition & 2 deletions docs/spec/non-isa/io-mapping-table.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -7,5 +7,4 @@ pdf: /pdf/rimt-spec.pdf

Provides information about the RISC-V IOMMU and the relationship between the IO topology and the IOMMU in ACPI based RISC-V platforms. The RIMT identifies which components are behind IOMMU and how they are connected together.

<PDF download= {frontMatter.pdf} title= {frontMatter.title} >
</PDF>
<PDF download= {frontMatter.pdf} title= {frontMatter.title} />
2 changes: 1 addition & 1 deletion docs/spec/non-isa/iommu-architecture.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -7,5 +7,5 @@ pdf: /pdf/riscv-iommu.pdf

Describes an Input-Output Memory Management Unit (IOMMU) that connects direct-memory-access-capable Input/Output (I/O) devices to system memory.

<PDF download= {frontMatter.pdf} title= {frontMatter.title} >
<PDF download={frontMatter.pdf} title={frontMatter.title}>
</PDF>
Loading
Loading