M24LR64E Class Reference

C++ API for the M24LR64E based Grove NFC Tag. More...

Detailed Description

• ID: m24lr64e
• Name: Grove NFC Tag
• Category: other
• Manufacturer: seeed
• Link: http://www.seeedstudio.com/wiki/Grove_-_NFC_Tag
• Connection: i2c

The Grove NFC tag is, in essence, an 8KB EEPROM that can be written to or read from using I2C and NFC equipped devices.

The USER mode (default) allows read and write access to all 8KB of space, provided the sector security status (SSS) allows it. The ROOT mode allows modification of the SSS data and other information, provided the proper password is submitted. The default password for a new tag is 0x00000000. See the data sheet for much more detailed information.

The Seeed Studio wiki page for this device includes a link to an Android application that can be used to also read and write the device via NFC, as well as set the NFC passwords, which cannot be done via I2C.

  // Instantiate an M24LR64E on I2C bus 0

  upm::M24LR64E *nfcTag = new upm::M24LR64E(M24LR64E_I2C_BUS);

  // This example accesses the device in the 'user' (default) mode,
  // reads the last byte of data in the EEPROM, inverts it, writes
  // it back, and then re-reads it.

  // Read the last byte of the EEPROM area

  int addr = M24LR64E::EEPROM_I2C_LENGTH - 1;
  printf("Address: %d\n", addr);
  uint8_t byte = nfcTag->readByte(addr);
  printf("Read byte: %02x\n", byte);

  // Now change it to it's opposite and write it
  byte = ~byte;
  nfcTag->writeByte(addr, byte);
  printf("Wrote inverted byte: %02x\n", byte);

  // Now read it back.
  byte = nfcTag->readByte(addr);
  printf("Read byte: %02x\n", byte);

Public Types
enum	M24LR64E_ADDR_T {   I2C_PASSWORD_ADDR = 2304, RF_PASSWORD_1_ADDR = 2308, RF_PASSWORD_2_ADDR = 2312, RF_PASSWORD_3_ADDR = 2316,   DSFID_ADDR = 2320, AFI_ADDR = 2321, RESV_ADDR = 2322, CONFIG_ADDR = 2323,   UID_ADDR = 2324, MEM_SIZE_ADDR = 2332, IC_REF_ADDR = 2335, PROG_COMP_ENERGY_HARVEST_ADDR = 2339 }
enum	AccessMode { USER_MODE = 0x0, ROOT_MODE = 0x1 }
enum	SectorAccessRight { Access_1110 = 0, Access_1111 = 1, Access_1100 = 2, Access_0111 = 3 }
enum	SectorSelectPassWd { noPasswd = 0, passwd_1 = 1, passwd_2 = 2, passwd_3 = 3 }

Public Member Functions
	M24LR64E (int bus, AccessMode mode=USER_MODE)
	~M24LR64E ()
bool	submitPasswd (uint32_t passwd)
bool	writePasswd (uint32_t passwd)
void	sectorProtectConfig (unsigned int sectorNumber, bool protectEnable, SectorAccessRight accessRight, SectorSelectPassWd passwd)
void	clearSectorProtect (void)
void	sectorWriteLockBit (unsigned int sectorNumber, bool sockEnable)
uint8_t	getDSFID ()
uint8_t	getAFI ()
void	getUID (uint8_t *buf)
uint32_t	getMemorySize ()
void	clearMemory ()
void	writeByte (unsigned int address, uint8_t data)
void	writeBytes (unsigned int address, uint8_t *buf, unsigned int len)
uint8_t	readByte (unsigned int address)
void	readBytes (unsigned int address, uint8_t *buf, unsigned int len)

Static Public Attributes
static const int	EEPROM_I2C_LENGTH = 8192
static const int	PASSWORD_LENGTH = 4
static const int	SECTOR_SECURITY_STATUS_BASE_ADDR = 0x800
static const uint8_t	LOCK_PROTECT_BIT = 0x01
static const uint8_t	WRITE_READ_PROTECT_BIT = 0x02
static const uint8_t	PASSWORD_CTRL_BIT = 0x04
static const int	UID_LENGTH = 8
static const unsigned int	I2C_WRITE_TIME = 5

Protected Member Functions
void	EEPROM_Write_Byte (unsigned int address, uint8_t data)
void	EEPROM_Write_Bytes (unsigned int address, uint8_t *data, unsigned int len)
uint8_t	EEPROM_Read_Byte (unsigned int address)
unsigned int	EEPROM_Read_Bytes (unsigned int address, uint8_t *buf, unsigned int len)

Protected Attributes
mraa::I2c	m_i2c

Constructor & Destructor Documentation

M24LR64E	(	int	bus,
		AccessMode	mode = USER_MODE
	)

m24lr64e constructor

Parameters

bus	i2c bus to use
mode	the access mode (user or root) to use

~M24LR64E

(

)

M24LR64E Destructor

Member Function Documentation

bool submitPasswd

(

uint32_t

passwd

)

submit an i2c access password

Parameters

passwd

the 4-byte access password

bool writePasswd

(

uint32_t

passwd

)

write a new i2c password

Parameters

passwd

the 4-byte access password

void sectorProtectConfig	(	unsigned int	sectorNumber,
		bool	protectEnable,
		SectorAccessRight	accessRight,
		SectorSelectPassWd	passwd
	)

Set the protection bit for a sector. Must be in ROOT mode

Parameters

sectorNumber	the sector whose protection you are modifying
protectEnable	true if you are enabling protection
accessRight	the access rights to set
passwd	the password number to enable, if any

void clearSectorProtect

(

void

)

Clear the sector protection bits. Must be in ROOT mode.

void sectorWriteLockBit	(	unsigned int	sectorNumber,
		bool	sockEnable
	)

Set or clear the Sector Security Status Lock bit for a sector. Must be in ROOT mode.

Parameters

sectorNumber	the sector who's SSS you want to modify
sockEnable	true r false to set or clear the bit

Here is the call graph for this function:

uint8_t getDSFID

(

)

return the Data Storage Familiy Identifier Must be in ROOT mode.

Returns

the DSFID

uint8_t getAFI

(

)

return the Application Family Identifier Must be in ROOT mode.

Returns

the AFI

void getUID

(

uint8_t *

buf

)

return the Unique ID. Must be in ROOT mode.

Parameters

buf	buffer to hold returned UID. Must be UID_LENGTH bytes.

uint32_t getMemorySize

(

)

return the memory size Must be in ROOT mode.

Returns

the amount of memory present

void clearMemory

(

)

set all memory to 0, if permissions allow

Here is the call graph for this function:

void writeByte	(	unsigned int	address,
		uint8_t	data
	)

write a byte to EEPROM

Parameters

address	address to write to
data	data to write

Here is the caller graph for this function:

void writeBytes	(	unsigned int	address,
		uint8_t *	buf,
		unsigned int	len
	)

write bytes to EEPROM

Parameters

address	address to write to
data	data to write
data	length of data buffer

uint8_t readByte

(

unsigned int

address

)

read a byte from EEPROM

Parameters

address

address to read from

Returns

data value read

void readBytes	(	unsigned int	address,
		uint8_t *	buf,
		unsigned int	len
	)

read multiple bytes from EEPROM

Parameters

address	address to read from
buffer	buffer to store data
len	number of bytes to read

---

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

• /var/lib/jenkins/workspace/upm-doc-stable/src/m24lr64e/m24lr64e.h
• /var/lib/jenkins/workspace/upm-doc-stable/src/m24lr64e/m24lr64e.cxx