blob: ccb5648214f6996bc95d314edd0ce0b6f4b176aa [file] [log] [blame] [view]
lowRISC Contributors802543a2019-08-31 12:12:56 +01001# Introduction to OpenTitan
2
Scott Johnson8573fa22019-11-01 14:49:56 -07003[OpenTitan](https://opentitan.org) is an open source silicon Root of Trust (RoT) project.
4OpenTitan will make the silicon RoT design and implementation more transparent, trustworthy, and secure for enterprises, platform providers, and chip manufacturers.
5OpenTitan is administered by lowRISC CIC as a collaborative [project]({{< relref "doc/project" >}}) to produce high quality, open IP for instantiation as a full-featured product.
lowRISC Contributors802543a2019-08-31 12:12:56 +01006This repository exists to enable collaboration across partners participating in the OpenTitan project.
7
8To get started using or contributing to the OpenTitan codebase, see the
Garret Kelly9eebde02019-10-22 15:36:49 -04009[list of user guides]({{< relref "doc/ug" >}}).
lowRISC Contributors802543a2019-08-31 12:12:56 +010010For details on coding styles or how to use our project-specific tooling, see the
Garret Kelly9eebde02019-10-22 15:36:49 -040011[reference manuals]({{< relref "doc/rm" >}}).
12[This page]({{< relref "hw" >}})
lowRISC Contributors802543a2019-08-31 12:12:56 +010013contains technical documentation on the SoC, the Ibex processor core, and the individual IP blocks.
Scott Johnson8573fa22019-11-01 14:49:56 -070014For questions about how the project is organized, see the [project]({{< relref "doc/project" >}}) landing spot for more information.
lowRISC Contributors802543a2019-08-31 12:12:56 +010015
lowRISC Contributors802543a2019-08-31 12:12:56 +010016## Repository Structure
17
18The underlying
19[repo](http://www.github.com/lowrisc/opentitan)
20is set up as a monolithic repository to contain RTL, helper scripts, technical documentation, and other software necessary to produce our hardware designs.
21
Alex Bradburyed7cc902019-11-05 11:29:48 +000022Unless otherwise noted, everything in the repository is covered by the Apache License, Version 2.0. See the [LICENSE](https://github.com/lowRISC/opentitan/blob/master/LICENSE) file and [repository README](https://github.com/lowRISC/opentitan/blob/master/README.md) for more information on licensing and see the user guides below for more information on development methodology.
lowRISC Contributors802543a2019-08-31 12:12:56 +010023
24## Documentation Sections
25
Tobias Wölfel834975a2020-02-26 12:43:46 +010026* [General]({{< relref "doc" >}})
27 * Project
28 * User Guides
29 * Reference Manuals
30 * Security
Srikrishna Iyerd1f896e2020-03-05 13:52:40 -080031* [Hardware Dashboard]({{< relref "hw" >}})
32 * Design specifications
33 * Verification plans
34 * Results of tool-flows
35 * Comportable IPs
36 * Processor cores
37 * Top level designs
Tobias Wölfel03d1cf32020-02-26 12:47:07 +010038* [Software]({{< relref "sw" >}})
39 * READMEs of OpenTitan software
Garret Kelly9eebde02019-10-22 15:36:49 -040040* [Tools]({{< relref "util" >}})
Scott Johnson8573fa22019-11-01 14:49:56 -070041 * READMEs of OpenTitan tools