2.3-InternetRadio/nutos/nut/dev/nvmem.c

/*
 * Copyright (C) 2006 by egnite Software GmbH. All rights reserved.
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions
 * are met:
 *
 * 1. Redistributions of source code must retain the above copyright
 *    notice, this list of conditions and the following disclaimer.
 * 2. Redistributions in binary form must reproduce the above copyright
 *    notice, this list of conditions and the following disclaimer in the
 *    documentation and/or other materials provided with the distribution.
 * 3. Neither the name of the copyright holders nor the names of
 *    contributors may be used to endorse or promote products derived
 *    from this software without specific prior written permission.
 *
 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
 * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
 * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
 * COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
 * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS
 * OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
 * AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF
 * THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 * SUCH DAMAGE.
 *
 * For additional information see http://www.ethernut.de/
 *
 */

/*!
 * \file dev/nvmem.c
 * \brief Non-volatile memory access.
 *
 * \verbatim
 *
 * $Log$
 * Revision 1.8  2009/01/19 10:39:33  haraldkipp
 * Support for AT45D SPI bus driver added.
 *
 * Revision 1.7  2009/01/17 11:26:46  haraldkipp
 * Getting rid of two remaining BSD types in favor of stdint.
 * Replaced 'u_int' by 'unsinged int' and 'uptr_t' by 'uintptr_t'.
 *
 * Revision 1.6  2006/09/29 12:41:55  haraldkipp
 * Added support for AT45 serial DataFlash memory chips. Currently limited
 * to AT91 builds.
 *
 * Revision 1.5  2006/07/27 07:15:34  haraldkipp
 * Final SAM7X support added.
 *
 * Revision 1.4  2006/07/05 07:52:31  haraldkipp
 * Added Daidai's version of using the AT91SAM7X
 * on-chip flash for storing configuration data.
 *
 * Revision 1.3  2006/05/25 09:09:57  haraldkipp
 * API documentation updated and corrected.
 *
 * Revision 1.2  2006/04/07 12:29:42  haraldkipp
 * AT49BV flash memory support added. A single sector may be used to
 * store system configurations in case there is no EEPROM available.
 *
 * Revision 1.1  2006/01/23 17:26:19  haraldkipp
 * Platform independant routines added, which provide generic access to
 * non-volatile memory.
 *
 *
 * \endverbatim
 */

#include <dev/nvmem.h>

#if defined(NUT_CONFIG_X12RTC)
#include <dev/x12rtc.h>
#elif defined(NUT_CONFIG_AT45D)
#include <dev/nvmem_at45d.h>
#elif defined(NUT_CONFIG_AT45DB)
#include <dev/at45db.h>
#elif defined(NUT_CONFIG_AT49BV)
#include <dev/at49bv.h>
#elif defined(NUT_CONFIG_AT91EFC)
#include <arch/arm/atmel/at91_efc.h>
#elif defined(NUT_CONFIG_STM32_IAP)
#include <arch/cm3/stm/stm32_flash.h>
#elif defined(NUT_CONFIG_STM32L1_EEPROM)
#include <arch/cm3/stm/stm32l1_eeprom.h>
#elif defined(NUT_CONFIG_LPC177x_8x_EEPROM)
#include <arch/cm3/nxp/lpc177x_8x_eeprom.h>
#elif defined(NUT_CONFIG_LPC17xx_IAP)
#include <arch/cm3/nxp/lpc17xx_iap.h>
#elif defined(NUT_CONFIG_AT24)
#include <dev/eeprom.h>
#endif

/*!
 * \addtogroup xgNutNvMem
 */
/*@{*/

/*!
 * \brief Read data from non-volatile memory.
 *
 * This routine provides platform independent access to non-volatile
 * configuration data.
 *
 * \param addr Location to read from.
 * \param buff Pointer to a buffer that receives the data.
 * \param siz  Number of bytes to read.
 *
 * \return 0 on success, -1 otherwise.
 */
int NutNvMemLoad(unsigned int addr, void *buff, size_t siz)
{
#if defined(NUT_CONFIG_X12RTC)
    return X12EepromRead(addr, buff, siz);
#elif defined(NUT_CONFIG_AT45D)
    return SpiAt45dConfigRead(addr, buff, siz);
#elif defined(NUT_CONFIG_AT45DB)
    return At45dbParamRead(addr, buff, siz);
#elif defined(NUT_CONFIG_AT49BV)
    return At49bvParamRead(addr, buff, siz);
#elif defined(__AVR__)
    return OnChipNvMemLoad(addr, buff, siz);
#elif defined(NUT_CONFIG_AT91EFC)
    return At91EfcParamRead(addr, buff, siz);
#elif defined(NUT_CONFIG_STM32_IAP)
    return Stm32FlashParamRead(addr, buff, siz);
#elif defined(NUT_CONFIG_STM32L1_EEPROM)
    return Stm32l1_EepromRead(addr, buff, siz);
#elif defined(NUT_CONFIG_LPC177x_8x_EEPROM)
    return Lpc177x_8x_EepromRead(addr, buff, siz);
#elif defined(NUT_CONFIG_LPC17xx_IAP)
    return Lpc17xxIapParamRead(addr, buff, siz);
#elif defined(NUT_CONFIG_AT24)
    EEInit();
    return EEReadData( addr, buff, siz);
#else
    return -1;
#endif
}

/*!
 * \brief Save data in non-volatile memory.
 *
 * This routine provides platform independent access to non-volatile
 * configuration data.
 *
 * \param addr Location to write to.
 * \param buff Pointer to a buffer that contains the data.
 * \param len  Number of bytes to write.
 *
 * \return 0 on success, -1 otherwise.
 */
int NutNvMemSave(unsigned int addr, const void *buff, size_t len)
{
#if defined(NUT_CONFIG_X12RTC)
    return X12EepromWrite(addr, buff, len);
#elif defined(NUT_CONFIG_AT45D)
    return SpiAt45dConfigWrite(addr, buff, len);
#elif defined(NUT_CONFIG_AT45DB)
    return At45dbParamWrite(addr, buff, len);
#elif defined(NUT_CONFIG_AT49BV)
    return At49bvParamWrite(addr, buff, len);
#elif defined(__AVR__)
    return OnChipNvMemSave(addr, buff, len);
#elif defined(NUT_CONFIG_AT91EFC)
    return At91EfcParamWrite(addr, buff, len);
#elif defined(NUT_CONFIG_STM32_IAP)
    return Stm32FlashParamWrite(addr, buff, len);
#elif defined(NUT_CONFIG_STM32L1_EEPROM)
    return Stm32l1_EepromWrite(addr, buff, len);
#elif defined(NUT_CONFIG_LPC177x_8x_EEPROM)
    return Lpc177x_8x_EepromWrite(addr, buff, len);
#elif defined(NUT_CONFIG_LPC17xx_IAP)
    return Lpc17xxIapParamWrite(addr, buff, len);
#elif defined(NUT_CONFIG_AT24)
    return EEWriteData( addr, buff, len);
#else
    return -1;
#endif
}

/*@}*/