435 lines
26 KiB
C
435 lines
26 KiB
C
/*
|
|
* Copyright (c) 2013-2020 ARM Limited. All rights reserved.
|
|
*
|
|
* SPDX-License-Identifier: Apache-2.0
|
|
*
|
|
* Licensed under the Apache License, Version 2.0 (the License); you may
|
|
* not use this file except in compliance with the License.
|
|
* You may obtain a copy of the License at
|
|
*
|
|
* www.apache.org/licenses/LICENSE-2.0
|
|
*
|
|
* Unless required by applicable law or agreed to in writing, software
|
|
* distributed under the License is distributed on an AS IS BASIS, WITHOUT
|
|
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
* See the License for the specific language governing permissions and
|
|
* limitations under the License.
|
|
*
|
|
* $Date: 24. January 2020
|
|
* $Revision: V1.2
|
|
*
|
|
* Project: Storage Driver definitions
|
|
*/
|
|
|
|
/* History:
|
|
* Version 1.2
|
|
* Removed volatile from ARM_STORAGE_STATUS
|
|
* Version 1.1
|
|
* ARM_STORAGE_STATUS made volatile
|
|
* Version 1.00
|
|
* Initial release
|
|
*/
|
|
|
|
#ifndef DRIVER_STORAGE_H_
|
|
#define DRIVER_STORAGE_H_
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
#include "Driver_Common.h"
|
|
|
|
#define ARM_STORAGE_API_VERSION ARM_DRIVER_VERSION_MAJOR_MINOR(1,2) /* API version */
|
|
|
|
|
|
#define _ARM_Driver_Storage_(n) Driver_Storage##n
|
|
#define ARM_Driver_Storage_(n) _ARM_Driver_Storage_(n)
|
|
|
|
#define ARM_STORAGE_INVALID_OFFSET (0xFFFFFFFFFFFFFFFFULL) ///< Invalid address (relative to a storage controller's
|
|
/// address space). A storage block may never start at this address.
|
|
|
|
#define ARM_STORAGE_INVALID_ADDRESS (0xFFFFFFFFUL) ///< Invalid address within the processor's memory address space.
|
|
/// Refer to memory-mapped storage, i.e. \ref ARM_DRIVER_STORAGE::ResolveAddress().
|
|
|
|
/****** Storage specific error codes *****/
|
|
#define ARM_STORAGE_ERROR_NOT_ERASABLE (ARM_DRIVER_ERROR_SPECIFIC - 1) ///< Part (or all) of the range provided to Erase() isn't erasable.
|
|
#define ARM_STORAGE_ERROR_NOT_PROGRAMMABLE (ARM_DRIVER_ERROR_SPECIFIC - 2) ///< Part (or all) of the range provided to ProgramData() isn't programmable.
|
|
#define ARM_STORAGE_ERROR_PROTECTED (ARM_DRIVER_ERROR_SPECIFIC - 3) ///< Part (or all) of the range to Erase() or ProgramData() is protected.
|
|
|
|
/**
|
|
* \brief Attributes of the storage range within a storage block.
|
|
*/
|
|
typedef struct _ARM_STORAGE_BLOCK_ATTRIBUTES {
|
|
uint32_t erasable : 1; ///< Erasing blocks is permitted with a minimum granularity of 'erase_unit'.
|
|
/// @note if 'erasable' is 0 (i.e. the 'erase' operation isn't available) then
|
|
/// 'erase_unit' (see below) is immaterial and should be 0.
|
|
uint32_t programmable : 1; ///< Writing to ranges is permitted with a minimum granularity of 'program_unit'.
|
|
/// Writes are typically achieved through the ProgramData operation (following an erase);
|
|
/// if storage isn't erasable (see 'erasable' above) but is memory-mapped
|
|
/// (i.e. 'memory_mapped'), it can be written directly using memory-store operations.
|
|
uint32_t executable : 1; ///< This storage block can hold program data; the processor can fetch and execute code
|
|
/// sourced from it. Often this is accompanied with the device being 'memory_mapped' (see \ref ARM_STORAGE_INFO).
|
|
uint32_t protectable : 1; ///< The entire block can be protected from program and erase operations. Once protection
|
|
/// is enabled for a block, its 'erasable' and 'programmable' bits are turned off.
|
|
uint32_t reserved : 28;
|
|
uint32_t erase_unit; ///< Minimum erase size in bytes.
|
|
/// The offset of the start of the erase-range should also be aligned with this value.
|
|
/// Applicable if the 'erasable' attribute is set for the block.
|
|
/// @note if 'erasable' (see above) is 0 (i.e. the 'erase' operation isn't available) then
|
|
/// 'erase_unit' is immaterial and should be 0.
|
|
uint32_t protection_unit; ///< Minimum protectable size in bytes. Applicable if the 'protectable'
|
|
/// attribute is set for the block. This should be a divisor of the block's size. A
|
|
/// block can be considered to be made up of consecutive, individually-protectable fragments.
|
|
} ARM_STORAGE_BLOCK_ATTRIBUTES;
|
|
|
|
/**
|
|
* \brief A storage block is a range of memory with uniform attributes.
|
|
*/
|
|
typedef struct _ARM_STORAGE_BLOCK {
|
|
uint64_t addr; ///< This is the start address of the storage block. It is
|
|
/// expressed as an offset from the start of the storage map
|
|
/// maintained by the owning storage controller.
|
|
uint64_t size; ///< This is the size of the storage block, in units of bytes.
|
|
/// Together with addr, it describes a range [addr, addr+size).
|
|
ARM_STORAGE_BLOCK_ATTRIBUTES attributes; ///< Attributes for this block.
|
|
} ARM_STORAGE_BLOCK;
|
|
|
|
/**
|
|
* The check for a valid ARM_STORAGE_BLOCK.
|
|
*/
|
|
#define ARM_STORAGE_VALID_BLOCK(BLK) (((BLK)->addr != ARM_STORAGE_INVALID_OFFSET) && ((BLK)->size != 0))
|
|
|
|
/**
|
|
* \brief Values for encoding storage memory-types with respect to programmability.
|
|
*
|
|
* Please ensure that the maximum of the following memory types doesn't exceed 16; we
|
|
* encode this in a 4-bit field within ARM_STORAGE_INFO::programmability.
|
|
*/
|
|
#define ARM_STORAGE_PROGRAMMABILITY_RAM (0U)
|
|
#define ARM_STORAGE_PROGRAMMABILITY_ROM (1U) ///< Read-only memory.
|
|
#define ARM_STORAGE_PROGRAMMABILITY_WORM (2U) ///< write-once-read-only-memory (WORM).
|
|
#define ARM_STORAGE_PROGRAMMABILITY_ERASABLE (3U) ///< re-programmable based on erase. Supports multiple writes.
|
|
|
|
/**
|
|
* Values for encoding data-retention levels for storage blocks.
|
|
*
|
|
* Please ensure that the maximum of the following retention types doesn't exceed 16; we
|
|
* encode this in a 4-bit field within ARM_STORAGE_INFO::retention_level.
|
|
*/
|
|
#define ARM_RETENTION_WHILE_DEVICE_ACTIVE (0U) ///< Data is retained only during device activity.
|
|
#define ARM_RETENTION_ACROSS_SLEEP (1U) ///< Data is retained across processor sleep.
|
|
#define ARM_RETENTION_ACROSS_DEEP_SLEEP (2U) ///< Data is retained across processor deep-sleep.
|
|
#define ARM_RETENTION_BATTERY_BACKED (3U) ///< Data is battery-backed. Device can be powered off.
|
|
#define ARM_RETENTION_NVM (4U) ///< Data is retained in non-volatile memory.
|
|
|
|
/**
|
|
* Device Data Security Protection Features. Applicable mostly to EXTERNAL_NVM.
|
|
*/
|
|
typedef struct _ARM_STORAGE_SECURITY_FEATURES {
|
|
uint32_t acls : 1; ///< Protection against internal software attacks using ACLs.
|
|
uint32_t rollback_protection : 1; ///< Roll-back protection. Set to true if the creator of the storage
|
|
/// can ensure that an external attacker can't force an
|
|
/// older firmware to run or to revert back to a previous state.
|
|
uint32_t tamper_proof : 1; ///< Tamper-proof memory (will be deleted on tamper-attempts using board level or chip level sensors).
|
|
uint32_t internal_flash : 1; ///< Internal flash.
|
|
uint32_t reserved1 : 12;
|
|
|
|
/**
|
|
* Encode support for hardening against various classes of attacks.
|
|
*/
|
|
uint32_t software_attacks : 1; ///< device software (malware running on the device).
|
|
uint32_t board_level_attacks : 1; ///< board level attacks (debug probes, copy protection fuses.)
|
|
uint32_t chip_level_attacks : 1; ///< chip level attacks (tamper-protection).
|
|
uint32_t side_channel_attacks : 1; ///< side channel attacks.
|
|
uint32_t reserved2 : 12;
|
|
} ARM_STORAGE_SECURITY_FEATURES;
|
|
|
|
#define ARM_STORAGE_PROGRAM_CYCLES_INFINITE (0UL) /**< Infinite or unknown endurance for reprogramming. */
|
|
|
|
/**
|
|
* Device level metadata regarding the Storage implementation.
|
|
*/
|
|
typedef struct _ARM_STORAGE_INFO {
|
|
uint64_t total_storage; ///< Total available storage, in bytes.
|
|
uint32_t program_unit; ///< Minimum programming size in bytes.
|
|
/// The offset of the start of the program-range should also be aligned with this value.
|
|
/// Applicable only if the 'programmable' attribute is set for a block.
|
|
/// @note setting program_unit to 0 has the effect of disabling the size and alignment
|
|
/// restrictions (setting it to 1 also has the same effect).
|
|
uint32_t optimal_program_unit; ///< Optimal programming page-size in bytes. Some storage controllers
|
|
/// have internal buffers into which to receive data. Writing in chunks of
|
|
/// 'optimal_program_unit' would achieve maximum programming speed.
|
|
/// Applicable only if the 'programmable' attribute is set for the underlying block(s).
|
|
uint32_t program_cycles; ///< A measure of endurance for reprogramming.
|
|
/// Use ARM_STORAGE_PROGRAM_CYCLES_INFINITE for infinite or unknown endurance.
|
|
uint32_t erased_value : 1; ///< Contents of erased memory (usually 1 to indicate erased bytes with state 0xFF).
|
|
uint32_t memory_mapped : 1; ///< This storage device has a mapping onto the processor's memory address space.
|
|
/// @note For a memory-mapped block which isn't erasable but is programmable (i.e. if
|
|
/// 'erasable' is set to 0, but 'programmable' is 1), writes should be possible directly to
|
|
/// the memory-mapped storage without going through the ProgramData operation.
|
|
uint32_t programmability : 4; ///< A value to indicate storage programmability.
|
|
uint32_t retention_level : 4;
|
|
uint32_t reserved : 22;
|
|
ARM_STORAGE_SECURITY_FEATURES security; ///< \ref ARM_STORAGE_SECURITY_FEATURES
|
|
} ARM_STORAGE_INFO;
|
|
|
|
/**
|
|
\brief Operating status of the storage controller.
|
|
*/
|
|
typedef struct _ARM_STORAGE_STATUS {
|
|
uint32_t busy : 1; ///< Controller busy flag
|
|
uint32_t error : 1; ///< Read/Program/Erase error flag (cleared on start of next operation)
|
|
uint32_t reserved : 30;
|
|
} ARM_STORAGE_STATUS;
|
|
|
|
/**
|
|
* \brief Storage Driver API Capabilities.
|
|
*/
|
|
typedef struct _ARM_STORAGE_CAPABILITIES {
|
|
uint32_t asynchronous_ops : 1; ///< Used to indicate if APIs like initialize,
|
|
/// read, erase, program, etc. can operate in asynchronous mode.
|
|
/// Setting this bit to 1 means that the driver is capable
|
|
/// of launching asynchronous operations; command completion is
|
|
/// signaled by the invocation of a completion callback. If
|
|
/// set to 1, drivers may still complete asynchronous
|
|
/// operations synchronously as necessary (in which case they
|
|
/// return a positive error code to indicate synchronous completion).
|
|
uint32_t erase_all : 1; ///< Supports EraseAll operation.
|
|
uint32_t reserved : 30; ///< Reserved (must be zero)
|
|
} ARM_STORAGE_CAPABILITIES;
|
|
|
|
/**
|
|
* Command opcodes for Storage.
|
|
*/
|
|
typedef enum _ARM_STORAGE_OPERATION {
|
|
ARM_STORAGE_OPERATION_GET_VERSION,
|
|
ARM_STORAGE_OPERATION_GET_CAPABILITIES,
|
|
ARM_STORAGE_OPERATION_INITIALIZE,
|
|
ARM_STORAGE_OPERATION_UNINITIALIZE,
|
|
ARM_STORAGE_OPERATION_POWER_CONTROL,
|
|
ARM_STORAGE_OPERATION_READ_DATA,
|
|
ARM_STORAGE_OPERATION_PROGRAM_DATA,
|
|
ARM_STORAGE_OPERATION_ERASE,
|
|
ARM_STORAGE_OPERATION_ERASE_ALL,
|
|
ARM_STORAGE_OPERATION_GET_STATUS,
|
|
ARM_STORAGE_OPERATION_GET_INFO,
|
|
ARM_STORAGE_OPERATION_RESOLVE_ADDRESS,
|
|
ARM_STORAGE_OPERATION_GET_NEXT_BLOCK,
|
|
ARM_STORAGE_OPERATION_GET_BLOCK
|
|
} ARM_STORAGE_OPERATION;
|
|
|
|
// Function documentation
|
|
/**
|
|
\fn ARM_DRIVER_VERSION ARM_Storage_GetVersion (void)
|
|
\brief Get driver version.
|
|
\return \ref ARM_DRIVER_VERSION
|
|
*/
|
|
/**
|
|
\fn ARM_STORAGE_CAPABILITIES ARM_Storage_GetCapabilities (void)
|
|
\brief Get driver capabilities.
|
|
\return \ref ARM_STORAGE_CAPABILITIES
|
|
*/
|
|
/**
|
|
\fn int32_t ARM_Storage_Initialize (ARM_Storage_Callback_t callback)
|
|
\brief Initialize the Storage interface.
|
|
\param [in] callback Pointer to \ref ARM_Storage_Callback_t.
|
|
Caller-defined callback to be invoked upon command completion
|
|
for asynchronous APIs (including the completion of
|
|
initialization). Use a NULL pointer when no callback
|
|
signals are required.
|
|
\return If asynchronous activity is launched, invocation
|
|
ARM_DRIVER_OK, and the caller can expect to receive a callback in the
|
|
future with a status value of ARM_DRIVER_OK or an error-code. In the
|
|
case of synchronous execution, control returns after completion with a
|
|
value of 1. Return values less than ARM_DRIVER_OK (0) signify errors.
|
|
*/
|
|
/**
|
|
\fn int32_t ARM_Storage_Uninitialize (void)
|
|
\brief De-initialize the Storage Interface.
|
|
\return If asynchronous activity is launched, an invocation returns
|
|
ARM_DRIVER_OK, and the caller can expect to receive a callback in the
|
|
future with a status value of ARM_DRIVER_OK or an error-code. In the
|
|
case of synchronous execution, control returns after completion with a
|
|
value of 1. Return values less than ARM_DRIVER_OK (0) signify errors.
|
|
*/
|
|
/**
|
|
\fn int32_t ARM_Storage_PowerControl (ARM_POWER_STATE state)
|
|
\brief Control the Storage interface power.
|
|
\param[in] state Power state
|
|
\return If asynchronous activity is launched, an invocation returns
|
|
ARM_DRIVER_OK, and the caller can expect to receive a callback in the
|
|
future with a status value of ARM_DRIVER_OK or an error-code. In the
|
|
case of synchronous execution, control returns after completion with a
|
|
value of 1. Return values less than ARM_DRIVER_OK (0) signify errors.
|
|
*/
|
|
/**
|
|
\fn int32_t ARM_Storage_ReadData (uint64_t addr, void *data, uint32_t size)
|
|
\brief Read data from Storage.
|
|
\param[in] addr Data address.
|
|
\param[out] data Pointer to a buffer storing the data read from Storage.
|
|
\param[in] size Number of bytes to read. The data buffer
|
|
should be at least as large as this size.
|
|
\return If asynchronous activity is launched, an invocation returns
|
|
ARM_DRIVER_OK, and the caller can expect to receive a callback in the
|
|
future with the number of successfully transferred bytes passed in as
|
|
the 'status' parameter. In the case of synchronous execution, control
|
|
returns after completion with a positive transfer-count. Return values
|
|
less than ARM_DRIVER_OK (0) signify errors.
|
|
*/
|
|
/**
|
|
\fn int32_t ARM_Storage_ProgramData (uint64_t addr, const void *data, uint32_t size)
|
|
\brief Program data to Storage.
|
|
\param [in] addr This is the start address of the range to be written into. It
|
|
needs to be aligned to the device's \em program_unit
|
|
specified in \ref ARM_STORAGE_INFO.
|
|
\param [in] data The source of the write operation. The buffer is owned by the
|
|
caller and should remain accessible for the lifetime of this
|
|
command.
|
|
\param [in] size The number of bytes requested to be written. The buffer
|
|
should be at least as large as this size. \note 'size' should
|
|
be a multiple of the device's 'program_unit' (see \ref
|
|
ARM_STORAGE_INFO).
|
|
\return If asynchronous activity is launched, an invocation returns
|
|
ARM_DRIVER_OK, and the caller can expect to receive a callback in the
|
|
future with the number of successfully transferred bytes passed in as
|
|
the 'status' parameter. In the case of synchronous execution, control
|
|
returns after completion with a positive transfer-count. Return values
|
|
less than ARM_DRIVER_OK (0) signify errors.
|
|
*/
|
|
/**
|
|
\fn int32_t ARM_Storage_Erase (uint64_t addr, uint32_t size)
|
|
\brief Erase Storage range.
|
|
\param [in] addr This is the start-address of the range to be erased. It must
|
|
start at an 'erase_unit' boundary of the underlying block.
|
|
\param [in] size Size (in bytes) of the range to be erased. 'addr + size'
|
|
must be aligned with the 'erase_unit' of the underlying
|
|
block.
|
|
\return If the range to be erased doesn't align with the erase_units of the
|
|
respective start and end blocks, ARM_DRIVER_ERROR_PARAMETER is
|
|
returned. If any part of the range is protected,
|
|
ARM_STORAGE_ERROR_PROTECTED is returned. If any part of the range
|
|
is not erasable, ARM_STORAGE_ERROR_NOT_ERASABLE is returned. All
|
|
such sanity-check failures result in the error code being
|
|
returned synchronously and the storage bytes within the range
|
|
remain unaffected. Otherwise the function executes in the
|
|
following ways: If asynchronous activity is launched, an
|
|
invocation returns ARM_DRIVER_OK, and the caller can expect to
|
|
receive a callback in the future with the number of successfully
|
|
erased bytes passed in as the 'status' parameter. In the case of
|
|
synchronous execution, control returns after completion with a
|
|
positive erase-count. Return values less than ARM_DRIVER_OK (0)
|
|
signify errors.
|
|
*/
|
|
/**
|
|
\fn int32_t ARM_Storage_EraseAll (void)
|
|
\brief Erase complete Storage.
|
|
\return If any part of the storage range is protected,
|
|
ARM_STORAGE_ERROR_PROTECTED is returned. If any part of the
|
|
storage range is not erasable, ARM_STORAGE_ERROR_NOT_ERASABLE is
|
|
returned. All such sanity-check failures result in the error code
|
|
being returned synchronously and the storage bytes within the
|
|
range remain unaffected. Otherwise the function executes in the
|
|
following ways: If asynchronous activity is launched, an
|
|
invocation returns ARM_DRIVER_OK, and the caller can expect to
|
|
receive a callback in the future with ARM_DRIVER_OK passed in as
|
|
the 'status' parameter. In the case of synchronous execution,
|
|
control returns after completion with a value of 1. Return values
|
|
less than ARM_DRIVER_OK (0) signify errors.
|
|
*/
|
|
/**
|
|
\fn ARM_STORAGE_STATUS ARM_Storage_GetStatus (void)
|
|
\brief Get Storage status.
|
|
\return Storage status \ref ARM_STORAGE_STATUS
|
|
*/
|
|
/**
|
|
\fn int32_t ARM_Storage_GetInfo (ARM_STORAGE_INFO *info)
|
|
\brief Get Storage information.
|
|
\param[out] info A caller-supplied buffer capable of being filled in with an \ref ARM_STORAGE_INFO.
|
|
\return ARM_DRIVER_OK if a ARM_STORAGE_INFO structure containing top level
|
|
metadata about the storage controller is filled into the supplied
|
|
buffer, else an appropriate error value.
|
|
*/
|
|
/**
|
|
\fn uint32_t ARM_Storage_ResolveAddress(uint64_t addr)
|
|
\brief Resolve an address relative to the storage controller into a memory address.
|
|
\param[in] addr The address for which we want a resolution to the processor's physical address space. It is an offset from the
|
|
start of the storage map maintained by the owning storage
|
|
controller.
|
|
\return The resolved address in the processor's address space, else ARM_STORAGE_INVALID_ADDRESS.
|
|
*/
|
|
/**
|
|
\fn int32_t ARM_Storage_GetNextBlock(const ARM_STORAGE_BLOCK* prev_block, ARM_STORAGE_BLOCK *next_block);
|
|
\brief Advance to the successor of the current block (iterator).
|
|
\param[in] prev_block An existing block (iterator) within the same storage
|
|
controller. The memory buffer holding this block is owned
|
|
by the caller. This pointer may be NULL; if so, the
|
|
invocation fills in the first block into the out parameter:
|
|
'next_block'.
|
|
\param[out] next_block A caller-owned buffer large enough to be filled in with
|
|
the following ARM_STORAGE_BLOCK. It is legal to provide the
|
|
same buffer using 'next_block' as was passed in with 'prev_block'. It
|
|
is also legal to pass a NULL into this parameter if the
|
|
caller isn't interested in populating a buffer with the next
|
|
block, i.e. if the caller only wishes to establish the
|
|
presence of a next block.
|
|
\return ARM_DRIVER_OK if a valid next block is found (or first block, if
|
|
prev_block is passed as NULL); upon successful operation, the contents
|
|
of the next (or first) block are filled into the buffer pointed to by
|
|
the parameter 'next_block' and ARM_STORAGE_VALID_BLOCK(next_block) is
|
|
guaranteed to be true. Upon reaching the end of the sequence of blocks
|
|
(iterators), or in case the driver is unable to fetch information about
|
|
the next (or first) block, an error (negative) value is returned and an
|
|
invalid StorageBlock is populated into the supplied buffer. If
|
|
prev_block is NULL, the first block is returned.
|
|
*/
|
|
/**
|
|
\fn int32_t ARM_Storage_GetBlock(uint64_t addr, ARM_STORAGE_BLOCK *block);
|
|
\brief Find the storage block (iterator) encompassing a given storage address.
|
|
\param[in] addr Storage address in bytes.
|
|
\param[out] block A caller-owned buffer large enough to be filled in with the
|
|
ARM_STORAGE_BLOCK encapsulating the given address. This value
|
|
can also be passed in as NULL if the caller isn't interested
|
|
in populating a buffer with the block, if the caller only
|
|
wishes to establish the presence of a containing storage
|
|
block.
|
|
\return ARM_DRIVER_OK if a containing storage-block is found. In this case,
|
|
if block is non-NULL, the buffer pointed to by it is populated with
|
|
the contents of the storage block, i.e. if block is valid and a block is
|
|
found, ARM_STORAGE_VALID_BLOCK(block) would return true following this
|
|
call. If there is no storage block containing the given offset, or in
|
|
case the driver is unable to resolve an address to a storage-block, an
|
|
error (negative) value is returned and an invalid StorageBlock is
|
|
populated into the supplied buffer.
|
|
*/
|
|
|
|
/**
|
|
* Provides the typedef for the callback function \ref ARM_Storage_Callback_t.
|
|
*/
|
|
typedef void (*ARM_Storage_Callback_t)(int32_t status, ARM_STORAGE_OPERATION operation);
|
|
|
|
/**
|
|
* The set of operations constituting the Storage driver.
|
|
*/
|
|
typedef struct _ARM_DRIVER_STORAGE {
|
|
ARM_DRIVER_VERSION (*GetVersion) (void); ///< Pointer to \ref ARM_Storage_GetVersion : Get driver version.
|
|
ARM_STORAGE_CAPABILITIES (*GetCapabilities)(void); ///< Pointer to \ref ARM_Storage_GetCapabilities : Get driver capabilities.
|
|
int32_t (*Initialize) (ARM_Storage_Callback_t callback); ///< Pointer to \ref ARM_Storage_Initialize : Initialize the Storage Interface.
|
|
int32_t (*Uninitialize) (void); ///< Pointer to \ref ARM_Storage_Uninitialize : De-initialize the Storage Interface.
|
|
int32_t (*PowerControl) (ARM_POWER_STATE state); ///< Pointer to \ref ARM_Storage_PowerControl : Control the Storage interface power.
|
|
int32_t (*ReadData) (uint64_t addr, void *data, uint32_t size); ///< Pointer to \ref ARM_Storage_ReadData : Read data from Storage.
|
|
int32_t (*ProgramData) (uint64_t addr, const void *data, uint32_t size); ///< Pointer to \ref ARM_Storage_ProgramData : Program data to Storage.
|
|
int32_t (*Erase) (uint64_t addr, uint32_t size); ///< Pointer to \ref ARM_Storage_Erase : Erase Storage range.
|
|
int32_t (*EraseAll) (void); ///< Pointer to \ref ARM_Storage_EraseAll : Erase complete Storage.
|
|
ARM_STORAGE_STATUS (*GetStatus) (void); ///< Pointer to \ref ARM_Storage_GetStatus : Get Storage status.
|
|
int32_t (*GetInfo) (ARM_STORAGE_INFO *info); ///< Pointer to \ref ARM_Storage_GetInfo : Get Storage information.
|
|
uint32_t (*ResolveAddress) (uint64_t addr); ///< Pointer to \ref ARM_Storage_ResolveAddress : Resolve a storage address.
|
|
int32_t (*GetNextBlock) (const ARM_STORAGE_BLOCK* prev, ARM_STORAGE_BLOCK *next); ///< Pointer to \ref ARM_Storage_GetNextBlock : fetch successor for current block.
|
|
int32_t (*GetBlock) (uint64_t addr, ARM_STORAGE_BLOCK *block); ///< Pointer to \ref ARM_Storage_GetBlock :
|
|
} const ARM_DRIVER_STORAGE;
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
#endif /* DRIVER_STORAGE_H_ */
|