Scott Johnson | 8573fa2 | 2019-11-01 14:49:56 -0700 | [diff] [blame] | 1 | --- |
| 2 | title: "Introduction to the OpenTitan Project" |
| 3 | --- |
| 4 | |
Alex Bradbury | 0c2e362 | 2019-11-04 23:58:53 +0000 | [diff] [blame] | 5 | OpenTitan is a collaborative hardware and software development program with contributors from many organizations. |
Scott Johnson | 8573fa2 | 2019-11-01 14:49:56 -0700 | [diff] [blame] | 6 | This area gives some more information about how the project itself is organized. |
| 7 | More information will be added over time. |
| 8 | |
| 9 | ## Quality standards for open hardware IP |
| 10 | |
Sam Elliott | 2061d8b | 2020-04-20 19:56:54 +0100 | [diff] [blame] | 11 | In order to gauge the quality of the different IP that is in our repository, we define a series of [Hardware Development Stages]({{< relref "development_stages" >}}) to track the designs. |
Srikrishna Iyer | d1f896e | 2020-03-05 13:52:40 -0800 | [diff] [blame] | 12 | The current status of different IP is reflected in the [Hardware Dashboard]({{< relref "hw" >}}). |
Scott Johnson | 8573fa2 | 2019-11-01 14:49:56 -0700 | [diff] [blame] | 13 | The final state for developed IP is *Signed Off*, indicating that design and verification is complete, and the IP should be bug free. |
| 14 | To make it to that stage, a [Hardware Signoff Checklist]({{< relref "checklist.md" >}}) is used to confirm completion. |
Sam Elliott | c032182 | 2020-06-05 15:29:38 +0100 | [diff] [blame] | 15 | [Here](https://github.com/lowRISC/opentitan/blob/master/util/uvmdvgen/checklist.md.tpl) is a template that can be used as a checklist item. |
Scott Johnson | 8573fa2 | 2019-11-01 14:49:56 -0700 | [diff] [blame] | 16 | |
Alex Bradbury | 0c2e362 | 2019-11-04 23:58:53 +0000 | [diff] [blame] | 17 | ## Governance |
| 18 | |
| 19 | OpenTitan is stewarded by lowRISC CIC, a not-for-profit company that uses collaborative engineering to develop and maintain open source silicon designs and tools for the long term. |
| 20 | As a lowRISC CIC Chartered Project, OpenTitan governance is handled via lowRISC's default Technical Charter. |
| 21 | |
| 22 | As described in full detail in the [OpenTitan Technical Charter](https://static.opentitan.org/technical-charter.pdf), our governance structure consists of: |
Scott Johnson | 4e35384 | 2020-01-17 17:14:35 -0800 | [diff] [blame] | 23 | * The Project Director, Dominic Rizzo, who is a representative of the lowRISC CIC's Board of Directors within the Steering Committee. |
Alex Bradbury | 0c2e362 | 2019-11-04 23:58:53 +0000 | [diff] [blame] | 24 | * The Steering Committee, responsible for project oversight and agreeing the technical roadmap. |
Alex Bradbury | bed7114 | 2020-06-03 21:07:07 +0100 | [diff] [blame] | 25 | * The [Technical Committee]({{< relref "technical_committee" >}}), responsible for technical decision making required to implement the technical roadmap. |
Alex Bradbury | 0c2e362 | 2019-11-04 23:58:53 +0000 | [diff] [blame] | 26 | |
Scott Johnson | 8573fa2 | 2019-11-01 14:49:56 -0700 | [diff] [blame] | 27 | ## Initiating new development |
| 28 | |
| 29 | The [OpenTitan RFC process]({{< relref "rfc_process" >}}) guides developers on how to initiate new development within the program. |
Alex Bradbury | b5f8e7f | 2019-11-04 23:01:28 +0000 | [diff] [blame] | 30 | |
| 31 | ## Committers |
| 32 | |
| 33 | Committers are individuals with repository write access. |
| 34 | Everyone is able and encouraged to contribute and to help with code review, but committers are responsible for the final approval and merge of contributions. |
| 35 | See the [Committers]({{< relref "committers.md" >}}) definition and role description for more information. |