/**************************************************************************//**
* \brief EEPROM 24C128/24C256 library.
* \author Copyright (C) 2012 Julien Le Sech - www.idreammicro.com
* \version 1.0
* \date 20121102
*
* This file is part of the iDreamMicro library.
*
* This library is free software: you can redistribute it and/or modify it under
* the terms of the GNU Lesser General Public License as published by the Free
* Software Foundation, either version 3 of the License, or (at your option) any
* later version.
*
* This library is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
* FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more
* details.
*
* You should have received a copy of the GNU Lesser General Public License
* along with this program. If not, see http://www.gnu.org/licenses/
******************************************************************************/
/**************************************************************************//**
* \file eeprom_24c128_24c256.c
******************************************************************************/
/******************************************************************************
* Header file inclusions.
******************************************************************************/
#include "../eeprom_24c128_24c256.h"
#include <twi/twi.h>
#include <util/delay.h>
#include <assert.h>
#include <stdint.h>
#include <stdlib.h>
/******************************************************************************
* Private macro definitions.
******************************************************************************/
/**************************************************************************//**
* \def EEPROM_24C128_24C256__ADDRESS
* \brief EEPROM 24C128/24C256 address. Given by datasheet.
******************************************************************************/
#define EEPROM_24C128_24C256__ADDRESS 0xA0
/**************************************************************************//**
* \def EEPROM_24C128_24C256__PAGE_SIZE
* \brief Size of a page in EEPROM memory.
* This size is given by EEPROM memory datasheet.
******************************************************************************/
#define EEPROM_24C128_24C256__PAGE_SIZE 64
/******************************************************************************
* Private function prototypes.
******************************************************************************/
/**************************************************************************//**
* \fn static void eeprom_24c128_24c256__write_page(
* uint16_t address,
* uint8_t length,
* uint8_t* p_data)
*
* \brief Write a page in memory.
*
* \param address Start address of data to write.
* \param length Number of bytes to write.
* \param[in] p_data Bytes to write.
******************************************************************************/
static
void
eeprom_24c128_24c256__write_page
(
uint16_t address
,
uint8_t length
,
uint8_t* p_data
);
/******************************************************************************
* Private variable declarations.
******************************************************************************/
static uint8_t device_address
= 0;
/******************************************************************************
* Public function definitions.
******************************************************************************/
/**************************************************************************//**
* \fn void eeprom_24c128_24c256__initialize(uint8_t hardware_address)
*
* \brief Initialize EEPROM 24C128/24C256.
*
* \param hardware_address Hardware address. Pins A0 to A2.
******************************************************************************/
void
eeprom_24c128_24c256__initialize
(
uint8_t hardware_address
){
// Compute device address.
device_address
= EEPROM_24C128_24C256__ADDRESS
| ((hardware_address
& 0x07) << 1);
// We don't initialize TWI here: we may have several devices on the bus.
// Initialize TWI.
//twi__initialize(EEPROM_24C128_24C256__CLOCK_RATE);
}
/**************************************************************************//**
* \fn void eeprom_24c128_24c256__write_byte(uint16_t address, uint8_t data)
*
* \brief Write a byte into memory.
*
* \param address Address in memory.
* \param data Byte to write.
******************************************************************************/
void
eeprom_24c128_24c256__write_byte
(
uint16_t address
,
uint8_t data
){
twi__start
();
twi__send_slaw
(device_address
);
twi__send_data
(address
>> 8);
twi__send_data
(address
& 0xFF);
twi__send_data
(data
);
twi__stop
();
}
/**************************************************************************//**
* \fn void eeprom_24c128_24c256__write_bytes(
* uint16_t address,
* uint16_t length,
* uint8_t* p_data)
*
* \brief Write bytes into memory.
*
* \param address Start address.
* \param length Number of bytes to write.
* \param[in] p_data Bytes to write.
******************************************************************************/
void
eeprom_24c128_24c256__write_bytes
(
uint16_t address
,
uint16_t length
,
uint8_t* p_data
){
// Check the preconditions.
assert(NULL
!= p_data
);
// Write first page if not aligned.
uint8_t not_aligned_length
= 0;
uint8_t page_offset
= address
% EEPROM_24C128_24C256__PAGE_SIZE
;
if (page_offset
> 0)
{
not_aligned_length
= EEPROM_24C128_24C256__PAGE_SIZE
- page_offset
;
eeprom_24c128_24c256__write_page
(address
, not_aligned_length
, p_data
);
length
-= not_aligned_length
;
}
if (length
> 0)
{
address
+= not_aligned_length
;
p_data
+= not_aligned_length
;
// Write complete and aligned pages.
uint16_t page_count
= length
/ EEPROM_24C128_24C256__PAGE_SIZE
;
for (uint16_t i
= 0; i
< page_count
; i
++)
{
eeprom_24c128_24c256__write_page
(address
, EEPROM_24C128_24C256__PAGE_SIZE
, p_data
);
address
+= EEPROM_24C128_24C256__PAGE_SIZE
;
p_data
+= EEPROM_24C128_24C256__PAGE_SIZE
;
length
-= EEPROM_24C128_24C256__PAGE_SIZE
;
}
if (length
> 0)
{
// Write remaining uncomplete page.
eeprom_24c128_24c256__write_page
(address
, EEPROM_24C128_24C256__PAGE_SIZE
, p_data
);
}
}
}
/**************************************************************************//**
* \fn uint8_t eeprom_24c128_24c256__read_byte(uint16_t address)
*
* \brief Read a byte in memory.
*
* \param address Address to read.
*
* \return Read byte.
******************************************************************************/
uint8_t
eeprom_24c128_24c256__read_byte
(
uint16_t address
){
uint8_t data
= 0;
twi__start
();
twi__send_slaw
(device_address
);
twi__send_data
(address
>> 8);
twi__send_data
(address
& 0xFF);
twi__repeat_start
();
twi__send_slar
(device_address
);
twi__receive_data_nack
(&data
);
twi__stop
();
return data
;
}
/**************************************************************************//**
* \fn void eeprom_24c128_24c256__read_bytes(
* uint16_t address,
* uint16_t length,
* uint8_t* p_data)
*
* \brief Read bytes in memory.
*
* \param address Start address of data to read.
* \param length Number of bytes to read.
* \param[in] p_data Buffer to fill with read bytes.
******************************************************************************/
void
eeprom_24c128_24c256__read_bytes
(
uint16_t address
,
uint16_t length
,
uint8_t* p_data
){
// Check the preconditions.
assert(NULL
!= p_data
);
twi__start
();
twi__send_slaw
(device_address
);
twi__send_data
(address
>> 8);
twi__send_data
(address
& 0xFF);
twi__repeat_start
();
twi__send_slar
(device_address
);
for (uint16_t i
= 0; i
< length
- 1; i
++)
{
twi__receive_data_ack
(p_data
+ i
);
}
twi__receive_data_nack
(p_data
+ length
- 1);
twi__stop
();
}
/******************************************************************************
* Private function definitions.
******************************************************************************/
/**************************************************************************//**
* \fn static void eeprom_24c128_24c256__write_page(
* uint16_t address,
* uint8_t length,
* uint8_t* p_data)
*
* \brief Write a page in memory.
*
* \param address Start address of data to write.
* \param length Number of bytes to write.
* \param[in] p_data Bytes to write.
******************************************************************************/
static
void
eeprom_24c128_24c256__write_page
(
uint16_t address
,
uint8_t length
,
uint8_t* p_data
){
// Check the preconditions.
assert(NULL
!= p_data
);
twi__start
();
twi__send_slaw
(device_address
);
twi__send_data
(address
>> 8);
twi__send_data
(address
& 0xFF);
for (uint8_t i
= 0; i
< length
; i
++)
{
twi__send_data
(p_data
[i
]);
}
twi__stop
();
// Write cycle time (tWR). See EEPROM memory datasheet for more details.
_delay_ms
(10);
}