tree: 2603a44fca7a9a1118e23b7e02eed495bc466d77 [path history] [tgz]
  1. freestanding/
  2. bitfield.c
  3. bitfield.h
  4. csr.h
  5. csr_registers.h
  6. hardened.h
  7. macros.h
  8. memory.c
  9. memory.h
  10. meson.build
  11. mmio.c
  12. mmio.h
  13. README.md
  14. stdasm.h
sw/device/lib/base/README.md

libbase, the OpenTitan Standard Library

This subtree provides headers and libraries known collectively as libbase, which serve as OpenTitan's ersatz libc.

Differences from a libc

libbase is not a libc, even though it implements a number of libc symbols, and should not be used as such. libbase is, rather, a place for base libraries which may need to make use of more compiler/platform intrinsics than average, in order to present a safe, stable, and uesful interface that other parts of OpenTitan can rely on.

In general, a library exposing general utilities for working close to the hardware should live in this subtree: for example, a library providing memcpy and related symbols. A library for talking to a particular peripheral, like a UART port, is a non-example.