blob: f1f57abbf7db44d070541665501c44d8736a5a88 [file] [log] [blame]
.. _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