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 > > modm::NestedResumable< 10+1 >

Public Member Functions

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

int8_t getResumableDepth () const
 
bool isResumableRunning () const
 
bool isTransactionRunning ()
 
modm::ResumableResult< bool > runTransaction ()
 Starts our own transaction and waits until finished.
 
bool startRead (uint8_t *buffer, std::size_t size)
 Configures the transaction with a read operation and starts it.
 
bool startTransaction ()
 Starts the transaction with our own transaction object.
 
bool startTransaction (modm::I2cTransaction *transaction)
 Starts the transaction with a separate transaction object.
 
bool startWrite (const uint8_t *buffer, std::size_t size)
 Configures the transaction with a write operation and starts it.
 
bool startWriteRead (const uint8_t *writeBuffer, std::size_t writeSize, uint8_t *readBuffer, std::size_t readSize)
 Configures the transaction with a write/read operation and starts it.
 
void stopResumable ()
 
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.
modm::ResumableResult<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 >
modm::ResumableResult<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 >
modm::ResumableResult<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>
modm::ResumableResult<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>
modm::ResumableResult<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: