|  | .. _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 |