[otbn] Operational states and commands

Specify the operational states OTBN can be in.

- Consolidate all user (host-software) initiated actions into the CMD
  register. To keep things simple, I resorted to allowing only a single
  command being executed at any time, and in consequence encoding the
  command as number, not as bitfield. This also means that performing a
  secure wipe of IMEM and DMEM now requires two host-initiated actions.
  (Nobody ever asked explicitly for them being a single operation.)

  The CMD register is 8 bit wide to make multi-bit encodings and
  extensions of the commands easier going forward.

- Expand the STATUS register to show what's currently going on within
  OTBN: mirror all CMDs in the status register.

  The STATUS register is 8 bit wide to make it easier to extend going
  forward. We already plan to have a LOCKED status.

Update all users of the registers:

- Update all software to make use of the new CMD and STATUS registers.

- Update otbnsim to make use of the new registers. Refactor the err_bits
  module to hold other constants as well.

- Update DV to make use of the new registers.

Fixes #7434

Signed-off-by: Philipp Wagner <phw@lowrisc.org>
25 files changed
tree: 2a961748bc614b864091b62d8dfcf123c710e8b0
  1. .github/
  2. ci/
  3. doc/
  4. hw/
  5. site/
  6. sw/
  7. test/
  8. util/
  9. .bazelversion
  10. .clang-format
  11. .dockerignore
  12. .flake8
  13. .gitignore
  14. .style.yapf
  15. .svlint.toml
  16. .svls.toml
  17. _index.md
  18. apt-requirements.txt
  19. azure-pipelines.yml
  20. BUILD
  21. check_tool_requirements.core
  22. CLA
  23. COMMITTERS
  24. CONTRIBUTING.md
  25. LICENSE
  26. meson.build
  27. meson_init.sh
  28. meson_options.txt
  29. python-requirements.txt
  30. README.md
  31. tool_requirements.py
  32. toolchain.txt
  33. topgen-generator.core
  34. topgen-reg-only.core
  35. topgen.core
  36. WORKSPACE
  37. yum-requirements.txt
README.md

OpenTitan

OpenTitan logo

About the project

OpenTitan is an open source silicon Root of Trust (RoT) project. OpenTitan will make the silicon RoT design and implementation more transparent, trustworthy, and secure for enterprises, platform providers, and chip manufacturers. OpenTitan is administered by lowRISC CIC as a collaborative project to produce high quality, open IP for instantiation as a full-featured product. See the OpenTitan site and OpenTitan docs for more information about the project.

About this repository

This repository contains hardware, software and utilities written as part of the OpenTitan project. It is structured as monolithic repository, or “monorepo”, where all components live in one repository. It exists to enable collaboration across partners participating in the OpenTitan project.

Documentation

The project contains comprehensive documentation of all IPs and tools. You can access it online at docs.opentitan.org.

How to contribute

Have a look at CONTRIBUTING and our documentation on project organization and processes for guidelines on how to contribute code to this repository.

Licensing

Unless otherwise noted, everything in this repository is covered by the Apache License, Version 2.0 (see LICENSE for full text).