Virtual block device consists of two mirrored block devices. More...

#include <modm/driver/storage/block_device_mirror.hpp>

Inheritance diagram for modm::BdMirror< BlockDeviceA, BlockDeviceB >:

Public Typedefs
using	bd_address_t = uint32_t

using	bd_size_t = uint32_t

Public Member Functions
modm::ResumableResult< bool >	initialize ()
	Initializes the storage hardware.

modm::ResumableResult< bool >	deinitialize ()
	Deinitializes the storage hardware.

modm::ResumableResult< bool >	read (uint8_t *buffer, bd_address_t address, bd_size_t size)

modm::ResumableResult< bool >	program (const uint8_t *buffer, bd_address_t address, bd_size_t size)

modm::ResumableResult< bool >	erase (bd_address_t address, bd_size_t size)

modm::ResumableResult< bool >	write (const uint8_t *buffer, bd_address_t address, bd_size_t size)

BlockDeviceA &	getBlockDeviceA ()

BlockDeviceB &	getBlockDeviceB ()

modm::ResumableResult< bool >	deinitialize ()
	Deinitializes the storage hardware.

modm::ResumableResult< bool >	erase (bd_address_t address, bd_size_t size)

modm::ResumableResult< bool >	initialize ()
	Initializes the storage hardware.

modm::ResumableResult< bool >	program (const uint8_t *buffer, bd_address_t address, bd_size_t size)

modm::ResumableResult< bool >	read (uint8_t *buffer, bd_address_t address, bd_size_t size)

modm::ResumableResult< bool >	write (const uint8_t *buffer, bd_address_t address, bd_size_t size)

Static Public Attributes
static constexpr bd_size_t	BlockSizeRead = BlockDeviceA::BlockSizeRead

static constexpr bd_size_t	BlockSizeWrite = std::max(BlockDeviceA::BlockSizeWrite, BlockDeviceB::BlockSizeWrite)

static constexpr bd_size_t	BlockSizeErase = std::max(BlockDeviceA::BlockSizeErase, BlockDeviceB::BlockSizeErase)

static constexpr bd_size_t	DeviceSize = std::min(BlockDeviceA::DeviceSize, BlockDeviceB::DeviceSize)

static constexpr bd_size_t	BlockSizeErase = 1

static constexpr bd_size_t	BlockSizeRead = 1

static constexpr bd_size_t	BlockSizeWrite = 1

Protected Member Functions
modm::ResumableResult< ReturnType > resumable	function (...)

int8_t	getResumableDepth () const

bool	isResumableRunning () const

void	stopResumable ()
	Force all resumable functions to stop running at the current nesting level.

Detailed Description

template<typename BlockDeviceA, typename BlockDeviceB>
class modm::BdMirror< BlockDeviceA, BlockDeviceB >

Virtual block device consists of two mirrored block devices.

Write operations (erase(), program() and write()) are forwarded to both block devices. Read operations (read()) are only performed on BlockDeviceA.

Template Parameters

BlockDeviceA	First block device of the mirrored block devices
BlockDeviceB	Second block device

Author: Raphael Lehmann

Member Function Documentation

template<typename BlockDeviceA , typename BlockDeviceB >

modm::ResumableResult<bool> modm::BdMirror< BlockDeviceA, BlockDeviceB >::erase	(	bd_address_t	address,
		bd_size_t	size
	)

Erase blocks

The state of an erased block is undefined until it has been programmed

Parameters

address	Address of block to begin erasing
size	Size to erase in bytes (multiple of read block size)

Returns: True on success

modm::ResumableResult<bool> modm::BlockDevice::erase	(	bd_address_t	address,
		bd_size_t	size
	)

inherited

Erase blocks

The state of an erased block is undefined until it has been programmed

Parameters

address	Address of block to begin erasing
size	Size to erase in bytes (multiple of read block size)

Returns: True on success

modm::ResumableResult< ReturnType > resumable modm::NestedResumable< 1 >::function ( ... )

inherited

Run the resumable function.

You need to implement this method in you subclass yourself.

Returns: >NestingError if still running, <=NestingError if it has finished.

template<typename BlockDeviceA , typename BlockDeviceB >

BlockDeviceA& modm::BdMirror< BlockDeviceA, BlockDeviceB >::getBlockDeviceA ( )

inline

Direct access to the BlockDeviceA

Returns: BlockDeviceA

template<typename BlockDeviceA , typename BlockDeviceB >

BlockDeviceB& modm::BdMirror< BlockDeviceA, BlockDeviceB >::getBlockDeviceB ( )

inline

Direct access to the BlockDeviceB

Returns: BlockDeviceB

int8_t modm::NestedResumable< 1 >::getResumableDepth ( ) const

inheritedinline

Returns: the nesting depth in the current resumable function, or -1 if called outside any resumable function

bool modm::NestedResumable< 1 >::isResumableRunning ( ) const

inheritedinline

Returns: true if a resumable function is running at the current nesting level, else false

template<typename BlockDeviceA , typename BlockDeviceB >

modm::ResumableResult<bool> modm::BdMirror< BlockDeviceA, BlockDeviceB >::program	(	const uint8_t *	buffer,
		bd_address_t	address,
		bd_size_t	size
	)

Program blocks with data

Any block has to be erased prior to being programmed

Parameters

buffer	Buffer of data to write to blocks
address	Address of first block to begin writing to
size	Size to write in bytes (multiple of read block size)

Returns: True on success

modm::ResumableResult<bool> modm::BlockDevice::program	(	const uint8_t *	buffer,
		bd_address_t	address,
		bd_size_t	size
	)

inherited

Program blocks with data

Any block has to be erased prior to being programmed

Parameters

buffer	Buffer of data to write to blocks
address	Address of first block to begin writing to
size	Size to write in bytes (multiple of read block size)

Returns: True on success

template<typename BlockDeviceA , typename BlockDeviceB >

modm::ResumableResult<bool> modm::BdMirror< BlockDeviceA, BlockDeviceB >::read	(	uint8_t *	buffer,
		bd_address_t	address,
		bd_size_t	size
	)

Read data from one or more blocks

Parameters

buffer	Buffer to read data into
address	Address to begin reading from
size	Size to read in bytes (multiple of read block size)

Returns: True on success

modm::ResumableResult<bool> modm::BlockDevice::read	(	uint8_t *	buffer,
		bd_address_t	address,
		bd_size_t	size
	)

inherited

Read data from one or more blocks

Parameters

buffer	Buffer to read data into
address	Address to begin reading from
size	Size to read in bytes (multiple of read block size)

Returns: True on success

template<typename BlockDeviceA , typename BlockDeviceB >

modm::ResumableResult<bool> modm::BdMirror< BlockDeviceA, BlockDeviceB >::write	(	const uint8_t *	buffer,
		bd_address_t	address,
		bd_size_t	size
	)

Writes data to one or more blocks after erasing them

The blocks are erased prior to being programmed

Parameters

buffer	Buffer of data to write to blocks
address	Address of first block to begin writing to
size	Size to write in bytes (multiple of read block size)

Returns: True on success

modm::ResumableResult<bool> modm::BlockDevice::write	(	const uint8_t *	buffer,
		bd_address_t	address,
		bd_size_t	size
	)

inherited

Writes data to one or more blocks after erasing them

The blocks are erased proir to being programmed

Parameters

buffer	Buffer of data to write to blocks
address	Address of first block to begin writing to
size	Size to write in bytes (multiple of read block size)

Returns: True on success

Member Data Documentation

constexpr bd_size_t modm::BlockDevice::BlockSizeRead = 1

inheritedstaticconstexpr

Minimum block sizes for block device operations

Most persistent storage devices require program(), erase() and sometimes read() operations to be executed on fixed sized blocks.

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

block_device_mirror.hpp

Public Typedefs

Public Member Functions

Static Public Attributes

Protected Member Functions

Detailed Description

template<typename BlockDeviceA, typename BlockDeviceB> class modm::BdMirror< BlockDeviceA, BlockDeviceB >

Member Function Documentation

Member Data Documentation

template<typename BlockDeviceA, typename BlockDeviceB>
class modm::BdMirror< BlockDeviceA, BlockDeviceB >