24xx256 series(24AA256, 24LC256, 24FC256) is a 32,768words × 8 bits EEPROM(Electrically Erasable and Programmable Read-Only Memory) chip manufactured by Microchip Technology. This posting will provide the OSS-ECAL(Open Source Software for Electronic Components Abstraction Layer) for 24xx256 series.
MCU interface : I2C
CAUTION:Please be sure to refer to the latest version of the Datasheet prior to actual design.
24xx256 series
General description
The Microchip Technology Inc. 24xx256 is a 32K x 8 (256-Kbit) Serial Electrically Erasable PROM (EEPROM), capable of operation across a broad voltage range (1.7V to 5.5V) It has been developed for advanced, low-power applications such as personal communications or data acquisition. This device also has a page write capability of up to 64 bytes of data.
This device is capable of both random and sequential reads up to the 256K boundary Functional address lines allow up to eight devices on the same bus, for up to 2 Mbit address space.
Part Number | Vcc Range | Maximum Clock Frequency | Temperature Ranges | Available Packages |
---|---|---|---|---|
24AA256 | 1.7~5.5V | 400kHz(1) | I, E | CS, MF, MS, P, SN, SM, MNY, ST |
24LC256 | 2.5~5.5V | 400kHz | I, E | MF, MS, P, SN, SM, MNY, ST |
24FC256 | 1.7~5.5V | 1Mhz(2) | I, E | MF, MS, P, OT, SN, SM, MNY, ST |
Note
1: 100 kHz for Vcc < 2.5V
2: 400kHz for Vcc < 2.5V
Feature
- Single Supply with Operation Down to 1.7V for 24AA256 and 24FC256 Devices, 2.5V for 24LC256 Devices
- Low-Power CMOS Technology
Write current 3mA, maximum
Standby current 1μA maximum (I-temp.) - Two-Wire Serial Interface,I2C Compaitble
- Cascadable up to Eight Device
- Schmit Trigger Inputs for Noise Suppression
- Output Slope Control to Eilminate Ground Bounce
- 100 kHz, 400 kHz and 1MHz Compaitbility
- Page Write Time 5ms, maximum
- Self-Timed Erase/Write Cycle
- 64-Byte Page Write Buffer
- Hardware Write-Protect
- ESD Protection >4000V
- More than One Million Erase/Write Cycles
- Data Retention >200 years
- Factory Programming Available
- RoHS Compliant
- Temperature Ranges
Industrial (I): -40°C to +85°C
Extended (E): -40°C to +125°C - Automotive AEC-O100 Qualified
OSS-ECAL specification
API Function
This product provides the following command API functions.
etSTS o24xx256_BYTE_WRITE( etCMP cmp, uint16 mem_adr, uint8 val )
Return value
Parameter IN
etSTS
etCMP cmp
uint16 mem_adr
uint8 val
OSS-ECAL status code
OSS-ECAL Components number codes
Memory address
Write data
Feature :
Command API function to write the value of val to the address specified by mem_adr.
Process :
1. Writes the value of val to the address specified in mem_adr.
2. Wait until measurement time i24xx256_WRITE_TIME[ms] has elapsed (return value eSTS_EXE while waiting).
Return value :
eSTS_FIN
eSTS_EXE
eSTS_ERR_PARAMETER
eSTS_ERR_HAL_I2C
eSTS_ERR_OTHERS_RUN
eSTS_ERR_I2C_OBJECT
NOTE :
i24xx256_WRITE_TIME[ms] Progress measurement is calculated from the Thread cycle that calls this API function, so please set the Thread cycle to THREAD_OSS_ECAL_PERIOD[ms].
etSTS o24xx256_PAGE_WRITE( etCMP cmp, uint16 mem_adr, uint16 len, uint8* buf )
Return value
Parameter IN
etSTS
etCMP cmp
uint16 mem_adr
uint16 len
uint8* buf
OSS-ECAL status code
OSS-ECAL Components number codes
Memory address
Number of bytes to write (Max 64)
Data buffer to write
Feature :
Command API function that writes values from buf[0] to buf[len-1] in order from the address specified in mem_adr.
Process :
1. Write values from buf[0] to buf[len-1] in order from the address specified in mem_adr.
2. Wait until measurement time i24xx256_WRITE_TIME[ms] has elapsed (return value eSTS_EXE while waiting).
Return value :
eSTS_FIN
eSTS_EXE
eSTS_ERR_PARAMETER
eSTS_ERR_HAL_I2C
eSTS_ERR_OTHERS_RUN
eSTS_ERR_I2C_OBJECT
NOTE :
If mem_adr + len > 0bXXXXXX1111, the addresses A4 to A8 are fixed and A0 to A3 are rolled over to 0bXXXXXX0000.
i24xx256_WRITE_TIME[ms] Progress measurement is calculated from the Thread cycle that calls this API function, so please set the Thread cycle to THREAD_OSS_ECAL_PERIOD[ms].
etSTS o24xx256_CURRENT_READ( etCMP cmp, uint8* rlt )
Return value
Parameter IN
Parameter OUT
etSTS
etCMP cmp
uint8* rlt
OSS-ECAL status code
OSS-ECAL Components number codes
Read data
Feature :
Command API function to read 1Byte value from the last Read or Write address +1 and save it to rlt.
Process :
1. Read 1Byte value from the last read or write address + 1 and save it to rlt.
Return value :
eSTS_FIN
eSTS_ERR_HAL_I2C
eSTS_ERR_OTHERS_RUN
eSTS_ERR_I2C_OBJECT
NOTE :
If mem_adr + len >0x7fff, the addresses is rolled over to 0x0000.
etSTS o24xx256_RANDOM_READ( etCMP cmp, uint16 mem_adr, uint8* rlt )
Return value
Parameter IN
Parameter OUT
etSTS
etCMP cmp
uint16 mem_adr
uint8* rlt
OSS-ECAL status code
OSS-ECAL Components number codes
Memory address
Read data
Feature :
Command API function that reads 1 Byte worth of value from the address specified in mem_adr and saves it to rlt.
Process :
1. Read 1Byte worth of value from the address specified in mem_adr and save it to rlt.
Return value :
eSTS_FIN
eSTS_ERR_PARAMETER
eSTS_ERR_HAL_I2C
eSTS_ERR_OTHERS_RUN
eSTS_ERR_I2C_OBJECT
NOTE :
etSTS o24xx256_SEQ_READ( etCMP cmp, uint16 mem_adr, uint16 len, uint8* buf )
Return value
Parameter IN
Parameter OUT
etSTS
etCMP cmp
uint16 mem_adr
uint16 len
uint8* buf
OSS-ECAL status code
OSS-ECAL Components number codes
Memory address
Number of bytes to read
Data buffer to read
Feature :
Command API function that reads sequentially from the address specified in mem_adr and saves from buf[0] to buf[len-1].
Process :
1. Read in order from the address specified in mem_adr and save from buf[0] to buf[len-1].
Return value :
eSTS_FIN
eSTS_ERR_PARAMETER
eSTS_ERR_HAL_I2C
eSTS_ERR_OTHERS_RUN
eSTS_ERR_I2C_OBJECT
NOTE :
If mem_adr + len > 0x7fff, the addresses is rolled over to 0x0000.
etSTS oAT24C08C_WP_EN( etCMP cmp )
Return value
Parameter IN
etSTS
etCMP cmp
OSS-ECAL status code
OSS-ECAL Components number codes
Feature :
Command API function to write protect enable (write disable).
Process :
1. Write protect output as “Hi”.
Return value :
eSTS_FIN
eSTS_ERR_GPIO_OBJECT
NOTE :
etSTS oAT24C08C_WP_DIS( etCMP cmp )
Return value
Parameter IN
etSTS
etCMP cmp
OSS-ECAL status code
OSS-ECAL Components number codes
Feature :
Command API function to write protect disable (write enable).
Process :
1. Write protect output as “Low”.
Return value :
eSTS_FIN
eSTS_ERR_GPIO_OBJECT
NOTE :
Files
Folder* | File | summary |
---|---|---|
24xx256_HALNAME/sample | sample.c (.cpp) | Sample Application Program |
| sample.h | Sample Application Header |
24xx256_HALNAME | o24xx256.c (.cpp) | OSS-ECAL Program for 24xx256 |
| o24xx256C.h | OSS-ECAL Header for 24xx256 |
| oss_ecal.h | OSS-ECAL Common Header (Ver 01.01.02 or later) |
| user_setting.c (.cpp) | Const and Table of User setting |
| user_setting.h | Header of User setting |
oHAL_i2c_stm32f4.c | HAL Program for STM32Cube FW_F4 | |
oHAL_i2c_stm32f4.h | HAL Header for STM32Cube FW_F4 | |
| readme.md | Readme |
| OSS-ECAL Terms of Use.txt | OSS-ECAL Terms of Use |
* For HALNAME, please refer to HAL Support.
HAL Support List
MCU/Board manufacturer | HAL | MCU* | Development environment* | HALNAME |
---|---|---|---|---|
Arduino | Arduino 1.8.6 | ATmega2560 ATmega328P | Mega 2560 Rev3 Arduino Pro Mini 3.3V | ARDUINO |
ARM | Mbed 6.17.0 | STM32F401RETx | STM32 Nucleo-64 boards | MBED |
Infineon | ModusToolbox HAL Cat1 2.4.3 | CYBLE-416045-02 | CY8CPROTO-063-BLE PSoC 6 BLE Prototyping Kit | ModusToolbox |
NXP | MCUXpresso SDK iMXRT1051B_1052B ksdk2_0 | CYBLE-416045-02 | IMXRT1050-EVKB | iMXRT1051B1052B |
STM | STM32Cube FW_F4 V1.27.1 | STM32F401RETx | STM32 Nucleo-64 boards | STM32F4 |
* MCU and development environment at the time of development. Even if the same HAL is used, different MCUs and development environments may not work together.
OSS-ECAL Download
Please login before downloading. To register as a new user, please click here.
HAL | Download OSS-ECAL Ver |
---|---|
Arduino 1.8.6 | |
Mbed 6.17.0 | |
ModusToolbox HAL Cat1 2.4.3 | |
MCUXpresso SDK iMXRT1051B_1052B ksdk2_0 | |
STM32Cube FW_F4 V1.27.1 |
“ABC.zip was blocked because this type of file can harm your device.” in Microsoft Edge.
If you are unable to download the File, please contact us and let us know the model number and HAL type. We will send you the file as an email attachment.
Built-in How to
Please refer to the following to incorporate API functions into your user program.
Pin A2 should be set with the following code in user_setting.h.
// Device address Code bit2:A2 bit1:A1 bit0:A0
#define M24xx256_1 0b00000000
For Infineon ModusToolbox HAL, set the I2C Timeout setting with the following code in user_setting.h. For details, see cyhal_i2c_master_write(), cyhal_i2c_master_read() Parameters timeout.
#define I2C_TIMEOUT 10U // Timeout[ms]
For STM32Cube FW_F4 HAL, I2C Timeout time is 25ms.
Note :
For the following command API functions, the Timeout time varies depending on the Read/Write data length len.
etSTS o24xx256_PAGE_WRITE( etCMP cmp, uint16 mem_adr, uint16 len, uint8* buf )
etSTS o24xx256_SEQ_READ( etCMP cmp, uint16 mem_adr, uint16 len, uint8* buf )
How to incorporate OSS-ECAL into user programs
How to incorporate multiple OSS-ECALs in a user program (same MCU function)
How to incorporate multiple OSS-ECALs in a user program (different MCU function)
How to incorporate multiple identical electronic components into a user program
How to reduce the impact on user programs by replacing electronic components