265 lines
11 KiB
C
265 lines
11 KiB
C
|
//*****************************************************************************
|
||
|
|
//
|
||
|
|
// eeprom.h - Prototypes for the EEPROM driver.
|
||
|
|
//
|
||
|
|
// Copyright (c) 2010-2011 Texas Instruments Incorporated. All rights reserved.
|
||
|
|
// Software License Agreement
|
||
|
|
//
|
||
|
|
// Texas Instruments (TI) is supplying this software for use solely and
|
||
|
|
// exclusively on TI's microcontroller products. The software is owned by
|
||
|
|
// TI and/or its suppliers, and is protected under applicable copyright
|
||
|
|
// laws. You may not combine this software with "viral" open-source
|
||
|
|
// software in order to form a larger program.
|
||
|
|
//
|
||
|
|
// THIS SOFTWARE IS PROVIDED "AS IS" AND WITH ALL FAULTS.
|
||
|
|
// NO WARRANTIES, WHETHER EXPRESS, IMPLIED OR STATUTORY, INCLUDING, BUT
|
||
|
|
// NOT LIMITED TO, IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
|
||
|
|
// A PARTICULAR PURPOSE APPLY TO THIS SOFTWARE. TI SHALL NOT, UNDER ANY
|
||
|
|
// CIRCUMSTANCES, BE LIABLE FOR SPECIAL, INCIDENTAL, OR CONSEQUENTIAL
|
||
|
|
// DAMAGES, FOR ANY REASON WHATSOEVER.
|
||
|
|
//
|
||
|
|
// This is part of revision 8264 of the Stellaris Peripheral Driver Library.
|
||
|
|
//
|
||
|
|
//*****************************************************************************
|
||
|
|
|
||
|
|
#ifndef __EEPROM_H__
|
||
|
|
#define __EEPROM_H__
|
||
|
|
|
||
|
|
//*****************************************************************************
|
||
|
|
//
|
||
|
|
// If building with a C++ compiler, make all of the definitions in this header
|
||
|
|
// have a C binding.
|
||
|
|
//
|
||
|
|
//*****************************************************************************
|
||
|
|
#ifdef __cplusplus
|
||
|
|
extern "C"
|
||
|
|
{
|
||
|
|
#endif
|
||
|
|
|
||
|
|
//*****************************************************************************
|
||
|
|
//
|
||
|
|
//! \addtogroup eeprom_api
|
||
|
|
//! @{
|
||
|
|
//
|
||
|
|
//*****************************************************************************
|
||
|
|
|
||
|
|
//*****************************************************************************
|
||
|
|
//
|
||
|
|
// Values returned by EEPROMInit.
|
||
|
|
//
|
||
|
|
//*****************************************************************************
|
||
|
|
|
||
|
|
//
|
||
|
|
//! This value may be returned from a call to EEPROMInit(). It indicates that
|
||
|
|
//! no previous write operations were interrupted by a reset event and that the
|
||
|
|
//! EEPROM peripheral is ready for use.
|
||
|
|
//
|
||
|
|
#define EEPROM_INIT_OK 0
|
||
|
|
|
||
|
|
//
|
||
|
|
//! This value may be returned from a call to EEPROMInit(). It indicates that
|
||
|
|
//! a previous data or protection write operation was interrupted by a reset
|
||
|
|
//! event. The EEPROM peripheral has recovered its state but the last write
|
||
|
|
//! operation may have been lost. The application must check the validity of
|
||
|
|
//! data it has written and retry any writes as required.
|
||
|
|
//
|
||
|
|
#define EEPROM_INIT_RETRY 1
|
||
|
|
|
||
|
|
//
|
||
|
|
//! This value may be returned from a call to EEPROMInit(). It indicates that a
|
||
|
|
//! previous data or protection write operation was interrupted by a reset
|
||
|
|
//! event and that the EEPROM peripheral was unable to clean up after the
|
||
|
|
//! problem. This situation may be resolved with another reset or may be fatal
|
||
|
|
//! depending upon the cause of the problem. For example, if the voltage to
|
||
|
|
//! the part is unstable, retrying once the voltage has stabilized may clear
|
||
|
|
//! the error.
|
||
|
|
//
|
||
|
|
#define EEPROM_INIT_ERROR 2
|
||
|
|
|
||
|
|
//*****************************************************************************
|
||
|
|
//
|
||
|
|
// Error indicators returned by various EEPROM API calls. These will be ORed
|
||
|
|
// together into the final return code.
|
||
|
|
//
|
||
|
|
//*****************************************************************************
|
||
|
|
|
||
|
|
//
|
||
|
|
//! This return code bit indicates that the EEPROM programming state machine
|
||
|
|
//! failed to write a value due to the voltage level dropping below that
|
||
|
|
//! required for EEPROM programming. The operation may be retried once the
|
||
|
|
//! voltage stabilizes.
|
||
|
|
//
|
||
|
|
#define EEPROM_RC_INVPL 0x00000100
|
||
|
|
|
||
|
|
//
|
||
|
|
//! This return code bit indicates that an attempt was made to read from
|
||
|
|
//! the EEPROM while a write operation was in progress.
|
||
|
|
//
|
||
|
|
#define EEPROM_RC_WRBUSY 0x00000020
|
||
|
|
|
||
|
|
//
|
||
|
|
//! This return code bit indicates that an attempt was made to write a
|
||
|
|
//! value but the destination permissions disallow write operations. This
|
||
|
|
//! may be due to the destination block being locked, access protection set
|
||
|
|
//! to prohibit writes or an attempt to write a password when one is already
|
||
|
|
//! written.
|
||
|
|
//
|
||
|
|
#define EEPROM_RC_NOPERM 0x00000010
|
||
|
|
|
||
|
|
//
|
||
|
|
//! This return code bit indicates that the EEPROM programming state machine
|
||
|
|
//! is currently copying to or from the internal copy buffer to make room for
|
||
|
|
//! a newly written value. It is provided as a status indicator and does not
|
||
|
|
//! indicate an error.
|
||
|
|
//
|
||
|
|
#define EEPROM_RC_WKCOPY 0x00000008
|
||
|
|
|
||
|
|
//
|
||
|
|
//! This return code bit indicates that the EEPROM programming state machine
|
||
|
|
//! is currently erasing the internal copy buffer. It is provided as a
|
||
|
|
//! status indicator and does not indicate an error.
|
||
|
|
//
|
||
|
|
#define EEPROM_RC_WKERASE 0x00000004
|
||
|
|
|
||
|
|
//
|
||
|
|
//! This return code bit indicates that the EEPROM programming state machine
|
||
|
|
//! is currently working. No new write operations should be attempted until
|
||
|
|
//! this bit is clear.
|
||
|
|
//
|
||
|
|
#define EEPROM_RC_WORKING 0x00000001
|
||
|
|
|
||
|
|
//*****************************************************************************
|
||
|
|
//
|
||
|
|
// Values that can be passed to EEPROMBlockProtectSet() in the ulProtect
|
||
|
|
// parameter, and returned by EEPROMBlockProtectGet().
|
||
|
|
//
|
||
|
|
//*****************************************************************************
|
||
|
|
|
||
|
|
//
|
||
|
|
//! This bit may be ORed with the protection option passed to
|
||
|
|
//! EEPROMBlockProtectSet() or returned from EEPROMBlockProtectGet(). It
|
||
|
|
//! restricts EEPROM access to threads running in supervisor mode and prevents
|
||
|
|
//! access to an EEPROM block when the CPU is in user mode.
|
||
|
|
//
|
||
|
|
#define EEPROM_PROT_SUPERVISOR_ONLY 0x00000008
|
||
|
|
|
||
|
|
//
|
||
|
|
//! This value may be passed to EEPROMBlockProtectSet() or returned from
|
||
|
|
//! EEPROMBlockProtectGet(). It indicates that the block should offer
|
||
|
|
//! read/write access when no password is set or when a password is set and
|
||
|
|
//! the block is unlocked, and read-only access when a password is set but
|
||
|
|
//! the block is locked.
|
||
|
|
//
|
||
|
|
#define EEPROM_PROT_RW_LRO_URW 0x00000000
|
||
|
|
|
||
|
|
//
|
||
|
|
//! This value may be passed to EEPROMBlockProtectSet() or returned from
|
||
|
|
//! EEPROMBlockProtectGet(). It indicates that the block should offer neither
|
||
|
|
//! read nor write access unless it is protected by a password and unlocked.
|
||
|
|
//
|
||
|
|
#define EEPROM_PROT_NA_LNA_URW 0x00000001
|
||
|
|
|
||
|
|
//
|
||
|
|
//! This value may be passed to EEPROMBlockProtectSet() or returned from
|
||
|
|
//! EEPROMBlockProtectGet(). It indicates that the block should offer
|
||
|
|
//! read-only access when no password is set or when a password is set and the
|
||
|
|
//! block is unlocked. When a password is set and the block is locked, neither
|
||
|
|
//! read nor write access is permitted.
|
||
|
|
//
|
||
|
|
#define EEPROM_PROT_RO_LNA_URO 0x00000002
|
||
|
|
|
||
|
|
//*****************************************************************************
|
||
|
|
//
|
||
|
|
//! This value may be passed to EEPROMIntEnable() and EEPROMIntDisable() and is
|
||
|
|
//! returned by EEPROMIntStatus() if an EEPROM interrupt is currently being
|
||
|
|
//! signaled.
|
||
|
|
//
|
||
|
|
//*****************************************************************************
|
||
|
|
#define EEPROM_INT_PROGRAM 0x00000004
|
||
|
|
|
||
|
|
//*****************************************************************************
|
||
|
|
//
|
||
|
|
//! Returns the EEPROM block number containing a given offset address.
|
||
|
|
//!
|
||
|
|
//! \param ulAddr is the linear, byte address of the EEPROM location whose
|
||
|
|
//! block number is to be returned. This is a zero-based offset from the start
|
||
|
|
//! of the EEPROM storage.
|
||
|
|
//!
|
||
|
|
//! This macro may be used to translate an EEPROM address offset into a
|
||
|
|
//! block number suitable for use in any of the driver's block protection
|
||
|
|
//! functions. The address provided is expressed as a byte offset from the
|
||
|
|
//! base of the EEPROM.
|
||
|
|
//!
|
||
|
|
//! \return Returns the zero-based block number which contains the passed
|
||
|
|
//! address.
|
||
|
|
//
|
||
|
|
//*****************************************************************************
|
||
|
|
#define EEPROMBlockFromAddr(ulAddr) ((ulAddr) >> 6)
|
||
|
|
|
||
|
|
//*****************************************************************************
|
||
|
|
//
|
||
|
|
//! Returns the offset address of the first word in an EEPROM block.
|
||
|
|
//!
|
||
|
|
//! \param ulBlock is the index of the EEPROM block whose first word address
|
||
|
|
//! is to be returned.
|
||
|
|
//!
|
||
|
|
//! This macro may be used to determine the address of the first word in a
|
||
|
|
//! given EEPROM block. The address returned is expressed as a byte offset
|
||
|
|
//! from the base of EEPROM storage.
|
||
|
|
//!
|
||
|
|
//! \return Returns the address of the first word in the given EEPROM block.
|
||
|
|
//
|
||
|
|
//*****************************************************************************
|
||
|
|
#define EEPROMAddrFromBlock(ulBlock) ((ulBlock) << 6)
|
||
|
|
|
||
|
|
//*****************************************************************************
|
||
|
|
//
|
||
|
|
// Prototypes for the APIs.
|
||
|
|
//
|
||
|
|
//*****************************************************************************
|
||
|
|
extern unsigned long EEPROMInit(void);
|
||
|
|
extern unsigned long EEPROMSizeGet(void);
|
||
|
|
extern unsigned long EEPROMBlockCountGet(void);
|
||
|
|
extern void EEPROMRead(unsigned long *pulData, unsigned long ulAddress,
|
||
|
|
unsigned long ulCount);
|
||
|
|
extern unsigned long EEPROMProgram(unsigned long *pulData,
|
||
|
|
unsigned long ulAddress,
|
||
|
|
unsigned long ulCount);
|
||
|
|
extern unsigned long EEPROMProgramNonBlocking(unsigned long ulData,
|
||
|
|
unsigned long ulAddress);
|
||
|
|
extern unsigned long EEPROMStatusGet(void);
|
||
|
|
extern unsigned long EEPROMMassErase(void);
|
||
|
|
extern unsigned long EEPROMBlockProtectGet(unsigned long ulBlock);
|
||
|
|
extern unsigned long EEPROMBlockProtectSet(unsigned long ulBlock,
|
||
|
|
unsigned long ulProtect);
|
||
|
|
extern unsigned long EEPROMBlockPasswordSet(unsigned long ulBlock,
|
||
|
|
unsigned long *pulPassword,
|
||
|
|
unsigned long ulCount);
|
||
|
|
extern unsigned long EEPROMBlockLock(unsigned long ulBlock);
|
||
|
|
extern unsigned long EEPROMBlockUnlock(unsigned long ulBlock,
|
||
|
|
unsigned long *pulPassword,
|
||
|
|
unsigned long ulCount);
|
||
|
|
extern void EEPROMBlockHide(unsigned long ulBlock);
|
||
|
|
extern void EEPROMIntEnable(unsigned long ulIntFlags);
|
||
|
|
extern void EEPROMIntDisable(unsigned long ulIntFlags);
|
||
|
|
extern unsigned long EEPROMIntStatus(tBoolean bMasked);
|
||
|
|
extern void EEPROMIntClear(unsigned long ulIntFlags);
|
||
|
|
|
||
|
|
//*****************************************************************************
|
||
|
|
//
|
||
|
|
// Close the Doxygen group.
|
||
|
|
//! @}
|
||
|
|
//
|
||
|
|
//*****************************************************************************
|
||
|
|
|
||
|
|
//*****************************************************************************
|
||
|
|
//
|
||
|
|
// Mark the end of the C bindings section for C++ compilers.
|
||
|
|
//
|
||
|
|
//*****************************************************************************
|
||
|
|
#ifdef __cplusplus
|
||
|
|
}
|
||
|
|
#endif
|
||
|
|
|
||
|
|
#endif // __EEPROM_H__
|