diff options
Diffstat (limited to 'peripheral/libupm/src/m24lr64e/m24lr64e.h')
-rw-r--r-- | peripheral/libupm/src/m24lr64e/m24lr64e.h | 285 |
1 files changed, 0 insertions, 285 deletions
diff --git a/peripheral/libupm/src/m24lr64e/m24lr64e.h b/peripheral/libupm/src/m24lr64e/m24lr64e.h deleted file mode 100644 index ffdaf25..0000000 --- a/peripheral/libupm/src/m24lr64e/m24lr64e.h +++ /dev/null @@ -1,285 +0,0 @@ -/* - * Author: Jon Trulson <jtrulson@ics.com> - * Copyright (c) 2015 Intel Corporation. - * - * - * This code was adapted from the Seeed Studio code at: - * https://github.com/Seeed-Studio/NFC_Tag_M24LR6E - * - * Copyright (c) 2014 seeed technology inc. - * Website : www.seeed.cc - * Author : lawliet zou - * Create Time: March 2014 - * - * Permission is hereby granted, free of charge, to any person obtaining - * a copy of this software and associated documentation files (the - * "Software"), to deal in the Software without restriction, including - * without limitation the rights to use, copy, modify, merge, publish, - * distribute, sublicense, and/or sell copies of the Software, and to - * permit persons to whom the Software is furnished to do so, subject to - * the following conditions: - * - * The above copyright notice and this permission notice shall be - * included in all copies or substantial portions of the Software. - * - * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, - * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF - * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND - * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE - * LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION - * OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION - * WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. - */ -#pragma once - -#include <string> -#include <mraa/common.hpp> -#include <mraa/i2c.hpp> - -#define M24LR64E_I2C_BUS 0 -#define M24LR64E_DEFAULT_I2C_ADDR 0x53 -#define M24LR64E_DEFAULT_I2C_ADDR_E2 (M24LR64E_DEFAULT_I2C_ADDR | 0x04) - -namespace upm { - - /** - * @brief Grove NFC Tag - * @defgroup m24lr64e libupm-m24lr64e - * @ingroup seeed i2c other - */ - - /** - * @library m24lr64e - * @sensor m24lr64e - * @comname Grove NFC Tag - * @type other - * @man seeed - * @web http://www.seeedstudio.com/wiki/Grove_-_NFC_Tag - * @con i2c - * - * @brief C++ API for the M24LR64E-based Grove NFC Tag - * - * Grove NFC tag is an 8KB electrically erasable programmable read-only memory (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 datasheet - * for more details. - * - * 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 NFC passwords, which cannot be - * done via I2C. - * - * @image html m24lr64e.jpg - * @snippet m24lr64e.cxx Interesting - */ - class M24LR64E { - public: - - static const int EEPROM_I2C_LENGTH = 8192; - static const int PASSWORD_LENGTH = 4; - static const int SECTOR_SECURITY_STATUS_BASE_ADDR = 0x800; // 2048 - - 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; // bytes - - static const unsigned int I2C_WRITE_TIME = 5; // 5ms - - /** - * M24LR64E addresses, accessible only in the root mode - */ - typedef enum { - I2C_PASSWORD_ADDR = 2304, - RF_PASSWORD_1_ADDR = 2308, // RF pwds not available in - RF_PASSWORD_2_ADDR = 2312, // I2C access modes - RF_PASSWORD_3_ADDR = 2316, - DSFID_ADDR = 2320, // 1 byte - AFI_ADDR = 2321, // 1 byte - RESV_ADDR = 2322, // 1 bytes - CONFIG_ADDR = 2323, // 1 bytes - UID_ADDR = 2324, // 8 bytes - MEM_SIZE_ADDR = 2332, // 3 bytes - IC_REF_ADDR = 2335, // 1 byte - PROG_COMP_ENERGY_HARVEST_ADDR = 2339 // 1 byte - } M24LR64E_ADDR_T; - - enum AccessMode { - USER_MODE = 0x0, // offers simple read/write access right - ROOT_MODE = 0x1 // offers password change access right - }; - - enum SectorAccessRight { - // ********************************** - // * submit passWd * no submit * - //b2,b1 * Read * Write * Read * Write * - // 00 * 1 1 1 0 * - // 01 * 1 1 1 1 * - // 10 * 1 1 0 0 * - // 11 * 0 1 0 0 * - // ********************************** - Access_1110 = 0, - Access_1111 = 1, - Access_1100 = 2, - Access_0111 = 3, - }; - - enum SectorSelectPassWd { - //00 => no passwd protect - //01 => passWd 1 - //10 => passWd 2 - //11 => passwd 3 - noPasswd = 0, - passwd_1 = 1, - passwd_2 = 2, - passwd_3 = 3, - }; - - /** - * M24LR64E constructor - * - * @param bus I2C bus to use - * @param mode Access mode (user or root) to use - */ - M24LR64E(int bus, AccessMode mode = USER_MODE); - - /** - * M24LR64E destructor - */ - ~M24LR64E(); - - /** - * Submits an I2C access password - * - * @param passwd 4-byte access password - */ - bool submitPasswd(uint32_t passwd); - - /** - * Writes a new I2C password - * - * @param passwd 4-byte access password - */ - bool writePasswd(uint32_t passwd); - - /** - * Sets a protection bit for a sector. Must be in the root mode - * - * @param sectorNumber Sector whose protection you are modifying - * @param protectEnable True if you are enabling protection - * @param accessRight Access rights to set - * @param passwd Password number to enable, if any - */ - void sectorProtectConfig(unsigned int sectorNumber, - bool protectEnable, - SectorAccessRight accessRight, - SectorSelectPassWd passwd); - - /** - * Clears sector protection bits. Must be in the root mode. - */ - void clearSectorProtect(void); - - /** - * Sets or clears a sector security status lock bit for a sector. - * Must be in the root mode. - * - * @param sectorNumber Sector whose SSS you want to modify - * @param sockEnable True to set the bit, false to clear it - */ - void sectorWriteLockBit(unsigned int sectorNumber, - bool sockEnable); - - /** - * Returns a data storage family identifier (DSFID) - * Must be in the root mode. - * - * @return DSFID - */ - uint8_t getDSFID(); - - /** - * Returns an application family identifier (AFI) - * Must be in the root mode. - * - * @return AFI - */ - uint8_t getAFI(); - - /** - * Returns a unique ID. - * Must be in the root mode. - * Maintained to preserve compatibility with older code. - * - * @result buf Buffer to hold the UID. Must be UID_LENGTH bytes. - */ - uint8_t *getUID(); - - /** - * Returns the memory size - * Must be in the root mode. - * - * @return Amount of memory present - */ - uint32_t getMemorySize(); - - /** - * Sets all memory to 0, if permissions allow - */ - void clearMemory(); - - /** - * Writes a byte to the EEPROM - * - * @param address Address to write to - * @param data Data to write - */ - mraa::Result writeByte(unsigned int address, uint8_t data); - - /** - * Writes bytes to the EEPROM - * - * @param address Address to write to - * @param data Data to write - * @param data Length of the data buffer - */ - mraa::Result writeBytes(unsigned int address, uint8_t* buffer, int len); - - /** - * Reads a byte from the EEPROM - * - * @param address Address to read from - * @return data Value read - */ - uint8_t readByte(unsigned int address); - - /** - * Reads multiple bytes from the EEPROM - * - * @param address Address to read from - * @param buffer Buffer to store data - * @param len Number of bytes to read - */ - int readBytes(unsigned int address, uint8_t* buffer, int len); - - protected: - mraa::I2c m_i2c; - mraa::Result EEPROM_Write_Byte(unsigned int address, uint8_t data); - mraa::Result EEPROM_Write_Bytes(unsigned int address, uint8_t* data, - int len); - uint8_t EEPROM_Read_Byte(unsigned int address); - int EEPROM_Read_Bytes(unsigned int address, - uint8_t* buffer, int len); - - private: - uint8_t m_addr; - }; -} - - |