modm API documentation
modm::I2cEeprom< I2cMaster, AddressBytes > Class Template Reference

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

Inheritance diagram for modm::I2cEeprom< I2cMaster, AddressBytes >:
modm::I2cDevice< I2cMaster, 1, i2c_eeprom::detail::DataTransmissionAdapter< AddressBytes > >

Public Member Functions

 I2cEeprom (uint8_t address=0x50)
 
bool writeByte (uint32_t address, uint8_t data)
 
bool write (uint32_t address, const uint8_t *data, std::size_t length)
 
template<typename T >
bool write (uint32_t address, const T &data)
 
bool readByte (uint32_t address, uint8_t &data)
 Read byte.
 
bool read (uint32_t address, uint8_t *data, std::size_t length)
 Read block.
 
template<typename T >
bool read (uint16_t address, T &data)
 
void attachConfigurationHandler (I2c::ConfigurationHandler handler)
 
bool ping ()
 
bool read (uint8_t *buffer, std::size_t size)
 Starts a write transaction and waits until finished.
 
void setAddress (uint8_t address)
 
bool write (const uint8_t *buffer, std::size_t size)
 Starts a write transaction and waits until finished.
 
bool writeRead (const uint8_t *writeBuffer, std::size_t writeSize, uint8_t *readBuffer, std::size_t readSize)
 Starts a write-read transaction and waits until finished.
 

Protected Member Functions

bool isTransactionRunning ()
 
bool runTransaction ()
 Starts our own transaction and waits until finished.
 
bool startTransaction ()
 Starts the transaction with our own transaction object.
 
bool startTransaction (modm::I2cTransaction *transaction)
 Starts the transaction with a separate transaction object.
 
bool wasTransactionSuccessful ()
 

Protected Attributes

i2c_eeprom::detail::DataTransmissionAdapter< AddressBytes > transaction
 

Detailed Description

template<typename I2cMaster, size_t AddressBytes = 2>
class modm::I2cEeprom< I2cMaster, AddressBytes >

I2C Eeprom

Compatible with the 24C256 (ST) and 24FC1025 (Microchip) family and other I2C eeprom with an 16-bit address pointer. Base address for most 24xxyyyy eeproms is 0x50.

Author
Fabian Greif
Niklas Hauser

Member Function Documentation

void modm::I2cDevice< I2cMaster, 10 , i2c_eeprom::detail::DataTransmissionAdapter< AddressBytes > >::attachConfigurationHandler ( I2c::ConfigurationHandler  handler)
inheritedinline

Attaches a configuration handler, which is called before a transaction, whenever the configuration has to be changed.

bool modm::I2cDevice< I2cMaster, 10 , i2c_eeprom::detail::DataTransmissionAdapter< AddressBytes > >::isTransactionRunning ( )
inheritedinlineprotected
Returns
true when transaction is busy.
bool modm::I2cDevice< I2cMaster, 10 , i2c_eeprom::detail::DataTransmissionAdapter< AddressBytes > >::ping ( )
inheritedinline
Return Values
truedevice responds to address
falseno device with address found
template<typename I2cMaster , size_t AddressBytes = 2>
template<typename T >
bool modm::I2cEeprom< I2cMaster, AddressBytes >::read ( uint16_t  address,
T &  data 
)
inline

Convenience function

Shortcut for:

return read(address, static_cast<uint8_t *>(&data), sizeof(T));
void modm::I2cDevice< I2cMaster, 10 , i2c_eeprom::detail::DataTransmissionAdapter< AddressBytes > >::setAddress ( uint8_t  address)
inheritedinline

Sets a new address of the slave device.

Parameters
addressthe slave address not yet shifted left (address < 128).
bool modm::I2cDevice< I2cMaster, 10 , i2c_eeprom::detail::DataTransmissionAdapter< AddressBytes > >::wasTransactionSuccessful ( )
inheritedinlineprotected
Returns
true when transaction did not return an error.
template<typename I2cMaster , size_t AddressBytes = 2>
template<typename T >
bool modm::I2cEeprom< I2cMaster, AddressBytes >::write ( uint32_t  address,
const T &  data 
)
inline

Convenience function

Shortcut for:

return write(address, static_cast<const uint8_t *>(&data), sizeof(T));
template<typename I2cMaster , size_t AddressBytes = 2>
bool modm::I2cEeprom< I2cMaster, AddressBytes >::write ( uint32_t  address,
const uint8_t *  data,
std::size_t  length 
)

Write block

Parameters
addressAddress
dataData block
lengthNumber of bytes to be written
Returns
true if the data could be written, false otherwise
template<typename I2cMaster , size_t AddressBytes = 2>
bool modm::I2cEeprom< I2cMaster, AddressBytes >::writeByte ( uint32_t  address,
uint8_t  data 
)
inline

Write byte

Parameters
addressAddress
dataData byte
Returns
true if the data could be written, false otherwise

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