riscvarchive/riscv-platform-specs riscvarchive/riscv-platform-specs

  • This repository has been archived on 01/Nov/2023
  • Stars
    star
    111
  • Rank 314,510 (Top 7 %)
  • Language Makefile
  • License
    Creative Commons ...
  • Created about 7 years ago
  • Updated about 1 year ago
Twitter logo Share LinkedIn logo Share Facebook logo Share
riscvarchive/riscv-platform-specs
github

riscvarchive

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

RISC-V Profiles and Platform Specification

RISC-V Platform Specification

The files in this project are used to create the RISC-V Platform Specification. This specification defines the set of firmware and hardware required of a RISC-V platform so that it may install and run various operating systems.

The content of the specification is created and controlled by the RISC-V Platform Horizontal Subcommittee (RISC-V Platform HSC). Information about the subcommittee can be found at https://lists.riscv.org/g/tech-unixplatformspec. Please note that membership in RISC-V International is required to post to the mailing list, but it is publicly readable. Membership in RISC-V International is free for individual community members.

All discussion of this specification occurs on the task group mailing list. Please use github issues for bug reports.

Licensing

The files in this repository are licensed under the Creative Commons Attribution 4.0 International License (CC-BY 4.0). The full license text is available at https://creativecommons.org/licenses/by/4.0/.

Repository Content

  • Makefile => 'make' in this directory will produce the HTML, markdown, and PDF versions of the current spec
  • README.md => this file
  • riscv-platform-spec.adoc => the spec in asciidoc format; there are several subsidiary asciidoc files that get included by this file.
  • docs-resources => Git Submodule with the RISC-V documentation theme, fonts, etc. for building the document

Repository Branches

  • All development occurs on main; no content on main is to be considered TSC-approved content.
  • TSC-approved content will be clearly marked as such.

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

More Repositories

1

riscv-cores-list

RISC-V Cores, SoC platforms and SoCs
830
star
2

riscv-linux

RISC-V Linux Port
C
606
star
3

riscv-software-list

The RISC-V software tools list, as seen on riscv.org
459
star
4

riscv-qemu

QEMU with RISC-V (RV64G, RV32G) Emulation Support
C
386
star
5

riscv-gcc

361
star
6

riscv-wiki

250
star
7

educational-materials

Educational materials for RISC-V
224
star
8

risc-v-getting-started-guide

The official RISC-V getting started guide
CSS
199
star
9

riscv-go

Go
155
star
10

riscv-code-size-reduction

Python
150
star
11

riscv-binutils-gdb

RISC-V backports for binutils-gdb. Development is done upstream at the FSF.
C
148
star
12

riscv-newlib

RISC-V port of newlib
C
96
star
13

riscv-musl

musl libc for RISC-V
C
81
star
14

ISA_Formal_Spec_Public_Review

Locus site for Public Review of Several RISC-V ISA Formal Specs
73
star
15

riscv-glibc

RISC-V port of GNU's libc
70
star
16

riscv-fesvr

RISC-V Frontend Server
C
62
star
17

riscv-poky

Port of the Yocto Project to the RISC-V ISA
62
star
18

riscv-tee

Makefile
37
star
19

riscv-clang

27
star
20

riscv-eabi-spec

Proposal for new Embedded ABI (EABI) for use in embedded RISC-V systems.
26
star
21

riscv-lld

RISC-V port of LLVM Linker
C++
25
star
22

riscv-edk2

Port of EDK2 implementation of UEFI to RISC-V. See documentation at:
C
22
star
23

riscv-gentoo

A port of Gentoo to RISC-V
20
star
24

riscv-zicond

The ISA specification for the ZiCondOps extension.
Makefile
19
star
25

riscv-old-gcc

gcc+newlib and gcc+glibc toolchains
18
star
26

riscv-edk2-platforms

Port of EDK2 implementation of UEFI to RISC-V. See documentation at:
C
18
star
27

riscv-4th-workshop-tutorials

4th RISC-V Workshop Tutorials
C
14
star
28

riscv-zfinx

13
star
29

riscv-strace

RISC-V strace port
C
13
star
30

riscv-dejagnu

DejaGnu RISC-V port
TeX
12
star
31

documents

riscv.github.io
HTML
11
star
32

riscv-gentoo-infra

Infrastructure for building Gentoo for RISC-V
Shell
10
star
33

riscv-buildroot

RISC-V Buildroot
9
star
34

riscv-alt-fp

RISC-V Alternate FP Format
9
star
35

riscv-zacas

riscv-zacas created from docs-spec-template template
Makefile
9
star
36

debug-taskgroup

Overview page for the RISC-V debug task group
9
star
37

riscv-weekly

RISC-V Weekly Community Update
8
star
38

riscv-libffi

RISC-V libffi port
8
star
39

riscv-buildbot-infra

The RISC-V buildbot infastructure
Python
8
star
40

riscv-watchdog

Makefile
8
star
41

riscv-crossdev

A RISC-V Port of Gentoo's Crossdev
Shell
8
star
42

riscv-svadu

The Svadu extension adds support and CSR control for hardware updating of PTE A/D bits.
Makefile
7
star
43

riscv-zawrs

The repo will be used to hold the draft Zawrs (fast-track) extension and to make releases for reviews.
Makefile
6
star
44

groups

RISC-V Technical Working Groups - charter, meeting minutes, planning documents
6
star
45

genz-on-riscv

5
star
46

riscv-sail-archive

Coq
5
star
47

riscv-time-compare

TeX
4
star
48

blockchain

Blockchain SIG Community
3
star
49

riscv-linux-infra

Scripts to help manager the RISC-V Linux codebase
3
star
50

riscv-state-enable

TeX
3
star
51

riscv-smcntrpmf

Cycle & Instret Privilege Mode Filtering Architecture Extension
Makefile
3
star
52

riscv-indirect-csr-access

Smcsrind/Sscsrind is an ISA extension that extends the indirect CSR access mechanism originally defined as part of the Smaia/Ssaia extensions, in order to make it available for use by other extensions without creating an unnecessary dependence on Smaia/Ssaia.
Makefile
3
star
53

riscv-unix-class-platform-spec

RISC-V UNIX-class Platform Specification
2
star
54

riscv-count-overflow

TeX
2
star
55

mem-model

Private repo for the Memory Model Task Group
TeX
1
star
56

unified-discovery

TeX
1
star
57

automotive

Group administration repository for SIG: Automotive
1
star
58

riscv-CMOs-discuss

Makefile
1
star
59

riscv-ras-terms-defs

The RAS Terms & Definitions specification define the terms and definitions for physical mechanisms starting from common ones from research and development to adapting the terms as needed.
TeX
1
star