.. _bbram_api:

Battery Backed RAM (BBRAM)
##########################

The BBRAM APIs allow interfacing with the unique properties of this memory region. The following
common types of BBRAM properties are easily accessed via this API:

- IBBR (invalid) state - check that the BBRAM is not corrupt.
- VSBY (voltage standby) state - check if the BBRAM is using standby voltage.
- VCC (active power) state - check if the BBRAM is on normal power.
- Size - get the size (in bytes) of the BBRAM region.

Along with these, the API provides a means for reading and writing to the memory region via
:c:func:`bbram_read` and :c:func:`bbram_write` respectively. Both functions are expected to only
succeed if the BBRAM is in a valid state and the operation is bounded to the memory region.

API Reference
*************

.. doxygengroup:: bbram_interface