From: Luke Kenneth Casson Leighton Date: Wed, 18 Sep 2019 04:57:13 +0000 (+0100) Subject: whitespace X-Git-Tag: convert-csv-opcode-to-binary~4039 X-Git-Url: https://git.libre-soc.org/?a=commitdiff_plain;h=e21d962a548642585d99a5187fb2672e49f162a2;p=libreriscv.git whitespace --- diff --git a/resources.mdwn b/resources.mdwn index 0da9105b0..b20c3f40d 100644 --- a/resources.mdwn +++ b/resources.mdwn @@ -1,70 +1,113 @@ # Resources and Specifications -This page aims to collect all the resources and specifications we need in one place for quick access. We will try our best to keep links here up-to-date. Feel free to add more links here. +This page aims to collect all the resources and specifications we need +in one place for quick access. We will try our best to keep links here +up-to-date. Feel free to add more links here. # RISC-V Instruction Set Architecture -The Libre RISC-V Project is building a hybrid CPU/GPU SoC. As the name of the project implies, we will be following the RISC-V ISA due to it being open-source and also because of the huge software and hardware ecosystem building around it. There are other open-source ISAs but none of them have the same momentum and energy behind it as RISC-V. +The Libre RISC-V Project is building a hybrid CPU/GPU SoC. As the name +of the project implies, we will be following the RISC-V ISA due to it +being open-source and also because of the huge software and hardware +ecosystem building around it. There are other open-source ISAs but none +of them have the same momentum and energy behind it as RISC-V. -To fully take advantage of the RISC-V ecosystem, it is important to be compliant with the RISC-V standards. Doing so will allow us to to reuse most software as-is and avoid major forks. +To fully take advantage of the RISC-V ecosystem, it is important to be +compliant with the RISC-V standards. Doing so will allow us to to reuse +most software as-is and avoid major forks. -* Official compiled PDFs of RISC-V ISA Manual: -* Working draft of the proposed RISC-V Bitmanipulation extension: -* RISC-V "V" Vector Extension: +* Official compiled PDFs of RISC-V ISA Manual: + +* Working draft of the proposed RISC-V Bitmanipulation extension: + +* RISC-V "V" Vector Extension: + + +Note: As far as I know, we aren't using the RISC-V V Extension directly +at the moment. However, there are many wiki pages that make a reference +to the V extension so it would be good to include it here as a reference +for comparative/informative purposes with regard to Simple-V. -Note: As far as I know, we aren't using the RISC-V V Extension directly at the moment. However, there are many wiki pages that make a reference to the V extension so it would be good to include it here as a reference for comparative/informative purposes with regard to Simple-V. # IEEE Standard for Floating-Point Arithmetic (IEEE 754) -Almost all modern computers follow the IEEE Floating-Point Standard. Of course, we will follow it as well for interoperability. +Almost all modern computers follow the IEEE Floating-Point Standard. Of +course, we will follow it as well for interoperability. * IEEE 754-2019: -Note: Even though this is such an important standard used by everyone, it is unfortunately not freely available and requires a payment to access. However, each of the Libre RISC-V members already have access to the document. +Note: Even though this is such an important standard used by everyone, +it is unfortunately not freely available and requires a payment to +access. However, each of the Libre RISC-V members already have access +to the document. # Khronos Standards -The Khronos Group creates open standards for authoring and acceleration of graphics, media, and computation. It is a requirement for our hybrid CPU/GPU to be compliant with these standards, especially Vulkan and OpenCL being the most important. SPIR-V is also important for the Kazan driver. +The Khronos Group creates open standards for authoring and acceleration +of graphics, media, and computation. It is a requirement for our hybrid +CPU/GPU to be compliant with these standards *as well* as with IEEE754, +in order to be commercially-competitive in both areas: especially Vulkan +and OpenCL being the most important. SPIR-V is also important for the +Kazan driver. + +Thus the [[zfpacc_proposal]] has been created which permits runtime dynamic +switching between different accuracy levels, in userspace applications. **SPIR-V Main Page ** -* SPIR-V 1.5 Specification Revision 1: -* SPIR-V OpenCL Extended Instruction Set: -* SPIR-V GLSL Extended Instruction Set: +* SPIR-V 1.5 Specification Revision 1: + +* SPIR-V OpenCL Extended Instruction Set: + +* SPIR-V GLSL Extended Instruction Set: + **Vulkan Main Page ** -* Vulkan 1.1.122: +* Vulkan 1.1.122: + **OpenCL Main Page ** -* OpenCL 2.2 API Specification: -* OpenCL 2.2 Extension Specification: -* OpenCL 2.2 SPIR-V Environment Specification: +* OpenCL 2.2 API Specification: + +* OpenCL 2.2 Extension Specification: + +* OpenCL 2.2 SPIR-V Environment Specification: + -Note: We are implementing hardware accelerated Vulkan (and possibly OpenCL) while relying on other software projects to translate APIs to Vulkan. E.g. Zink allows for OpenGL-->Vulkan in software. +Note: We are implementing hardware accelerated Vulkan (and possibly +OpenCL) while relying on other software projects to translate APIs to +Vulkan. E.g. Zink allows for OpenGL-to-Vulkan in software. # Graphics and Compute API Stack -I found this informative post that mentions Kazan and a whole bunch of other stuff. It looks like *many* APIs can be emulated on top of Vulkan, although performance is not evaluated. +I found this informative post that mentions Kazan and a whole bunch of +other stuff. It looks like *many* APIs can be emulated on top of Vulkan, +although performance is not evaluated. # Free Silicon Conference -The conference brought together experts and enthusiasts who want to build a complete Free and Open Source CAD ecosystem for designing analog and digital integrated circuits. -The conference covered the full spectrum of the design process, from system architecture, to layout and verification. +The conference brought together experts and enthusiasts who want to build +a complete Free and Open Source CAD ecosystem for designing analog and +digital integrated circuits. The conference covered the full spectrum of +the design process, from system architecture, to layout and verification. * -* LIP6's Coriolis - a set of backend design tools: +* LIP6's Coriolis - a set of backend design tools: + -Note: The rest of LIP6's website is in French, but there is a UK flag in the corner that gives the English version. +Note: The rest of LIP6's website is in French, but there is a UK flag +in the corner that gives the English version. * KLayout - Layout viewer and editor: # The OpenROAD Project -OpenROAD seeks to develop and foster an autonomous, 24-hour, open-source layout generation flow (RTL-to-GDS). +OpenROAD seeks to develop and foster an autonomous, 24-hour, open-source +layout generation flow (RTL-to-GDS). * @@ -72,13 +115,16 @@ OpenROAD seeks to develop and foster an autonomous, 24-hour, open-source layout ## RISC-V Tests -RISC-V Foundation is in the process of creating an official conformance test. It's still in development as far as I can tell. +RISC-V Foundation is in the process of creating an official conformance +test. It's still in development as far as I can tell. * //TODO LINK TO RISC-V CONFORMANCE TEST ## IEEE 754 Tests -IEEE 754 has no official tests for floating-point but there are several well-known third party tools to check such as John Hauser's SoftFloat and TestFloat. +IEEE 754 has no official tests for floating-point but there are several +well-known third party tools to check such as John Hauser's SoftFloat +and TestFloat. * @@ -86,9 +132,11 @@ Jacob is also making a Rust library to check IEEE 754 operations. * -A cool paper I came across in my research is "IeeeCC754++ : An Advanced Set of Tools to Check IEEE 754-2008 Conformity" by Dr. Matthias Hüsken. +A cool paper I came across in my research is "IeeeCC754++ : An Advanced +Set of Tools to Check IEEE 754-2008 Conformity" by Dr. Matthias Hüsken. -* Direct link to PDF: +* Direct link to PDF: + ## Khronos Tests @@ -100,4 +148,7 @@ Vulkan Conformance Tests * -MAJOR NOTE: We are **not** allowed to say we are compliant with any of the Khronos standards until we actually make an official submission and do the paperwork. +MAJOR NOTE: We are **not** allowed to say we are compliant with any of +the Khronos standards until we actually make an official submission, +do the paperwork, and pay the relevant fees. +