retained_mem_driver_api Struct Reference

@driver_ops{Retained Memory} More...

#include <retained_mem.h>

Data Fields
retained_mem_size_api	size
	@driver_ops_mandatory Returns the size of the retained memory area.
retained_mem_read_api	read
	@driver_ops_mandatory Reads data from the Retained memory area.
retained_mem_write_api	write
	@driver_ops_mandatory Writes data to the Retained memory area - underlying data does not need to be cleared prior to writing.
retained_mem_clear_api	clear
	@driver_ops_mandatory Clears data in the retained memory area by setting it to 0x00.

Detailed Description

@driver_ops{Retained Memory}

API which can be used by a device to store data in a retained memory area. Retained memory is memory that is retained while the device is powered but is lost when power to the device is lost (note that low power modes in some devices may clear the data also). This may be in a non-initialised RAM region, or in specific registers, but is not reset when a different application begins execution or the device is rebooted (without power loss). It must support byte-level reading and writing without a need to erase data before writing.

Note that drivers must implement all functions, none of the functions are optional.

Field Documentation

clear

retained_mem_clear_api retained_mem_driver_api::clear

@driver_ops_mandatory Clears data in the retained memory area by setting it to 0x00.

read

retained_mem_read_api retained_mem_driver_api::read

@driver_ops_mandatory Reads data from the Retained memory area.

size

retained_mem_size_api retained_mem_driver_api::size

@driver_ops_mandatory Returns the size of the retained memory area.

write

retained_mem_write_api retained_mem_driver_api::write

@driver_ops_mandatory Writes data to the Retained memory area - underlying data does not need to be cleared prior to writing.

---

The documentation for this struct was generated from the following file:

• include/zephyr/drivers/retained_mem.h