AT24C08C is a 1,024words × 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 AT24C08C.
MCU interface : I2C
CAUTION:Please be sure to refer to the latest version of the Datasheet prior to actual design.
AT24C08C
General description
The AT24C08C provides 8,192 bits of Serial Electrically Erasable and Programmable Read-Only Memory (EEPROM) organized as 1,024 words of 8 bits each. The device’s cascading feature allows up to two devices (AT24C08C) to share a common Two-Wire bus. These devices are optimized for use in many industrial and commercial applications where low‑power and low‑voltage operations are essential. The devices are available in space-saving 8-lead SOIC, 8-lead TSSOP, 8-pad UDFN, 8-lead PDIP, 5-lead SOT23 and 8-ball VFBGA packages. All packages operate from 1.7V to 5.5V.
Feature
- Low-Voltage Operation : VCC = 1.7V to 5.5V
- Internally Organized as 1,024 x 8 (8K)
- Industrial Temperature Range : -40°C to +85°C
- I2C-Compatible (Two-Wire) Serial Interface : 100 kHz Standard mode, 1.7V to 5.5V, 400 kHz Fast mode, 1.7V to 5.5V, 1 MHz Fast Mode Plus (FM+), 2.5V to 5.5V
- Schmitt Triggers, Filtered Inputs for Noise Suppression
- Bidirectional Data Transfer Protocol
- Write-Protect Pin for Full Array Hardware Data Protection
- Ultra Low Active Current (3 mA maximum) and Standby Current (6 μA maximum)
- 16-byte Page Write Mode : Partial page writes allowed
- Random and Sequential Read Modes
- Self-Timed Write Cycle Within 5 ms Maximum
- ESD Protection > 4,000V
- High Reliability : 1,000,000 write cycles, Data retention 100 years
- Green Package Options (Lead-Free/Halide-Free/RoHS Compliant)
- Die Sale Options: Wafer Form and Tape and Reel Available
OSS-ECAL specification
API Function
etSTS oAT24C08C_BYTE_WRITE( etCMP cmp, uint16 mem_adr, uint8 val )
The oAT24C08C_BYTE_WRITE function is an API function that writes the value of val to the specified address mem_adr for AT24C08C. This function returns the return value eSTS_EXE until the time to complete the write (iAT24C08C_WRITE_TIME [ms]) has elapsed.
NOTE :
The iAT24C08C_WRITE_TIME [ms] elapsed measurement is calculated from the Thread period that calls this function, so set the Thread period to THREAD_OSS_ECAL_PERIOD [ms].
Please use the oAT24C08C_WP_DIS function to release write-protection before using this function.
| Return value | etSTS | OSS-ECAL status code | |
| eSTS_FIN | Completed successfully | ||
| eSTS_EXE | During execution | ||
| eSTS_ERR_PARAMETER | Parameter error(Memory address) | ||
| eSTS_ERR_I2C_OBJECT | I2C object selection error | ||
| eSTS_ERR_OTHERS_RUN | Other components are executing the process | ||
| eSTS_ERR_HAL_OTHERS_RUN | Other application is running HAL | ||
| eSTS_ERR_HAL_I2C | HAL I2C error | ||
| Parameter IN | etCMP cmp | OSS-ECAL components code | |
| uint16 mem_adr | Memory address | 0x0000 to 0x03FF | |
| uint8 val | Data to write |
Function Correspondence Table by HAL
| Arduino | Arduino | X |
| ARM | Mbed | X |
| Debian Project | Debian(Linux) v2022.04 | X |
| Infineon | ModusToolbox | X |
| NXP | MCUXpresso MXRT1051B_1052B | X |
| STM | STM32Cube FW_F4 | X |
etSTS oAT24C08C_PAGE_WRITE( etCMP cmp, uint16 mem_adr, uint16 len, uint8* buf )
The oAT24C08C_PAGE_WRITE function is an API function that writes the values buf[0] through buf[len-1] for the AT24C08C in order from the specified address mem_adr. This function returns the return value eSTS_EXE until the time to complete the write (iAT24C08C_WRITE_TIME [ms]) has elapsed.
NOTE :
If mem_adr + len > 0bXXXXXX1111, the addresses A4 to A8 are fixed and A0 to A3 are rolled over to 0bXXXXXX0000.
The iAT24C08C_WRITE_TIME [ms] elapsed measurement is calculated from the Thread period that calls this function, so set the Thread period to THREAD_OSS_ECAL_PERIOD [ms].
Please use the oAT24C08C_WP_DIS function to release write-protection before using this function.
| Return value | etSTS | OSS-ECAL status code | |
| eSTS_FIN | Completed successfully | ||
| eSTS_EXE | During execution | ||
| eSTS_ERR_PARAMETER | Parameter error(Memory address) | ||
| eSTS_ERR_I2C_OBJECT | I2C object selection error | ||
| eSTS_ERR_OTHERS_RUN | Other components are executing the process | ||
| eSTS_ERR_HAL_OTHERS_RUN | Other application is running HAL | ||
| eSTS_ERR_HAL_I2C | HAL I2C error | ||
| Parameter IN | etCMP cmp | OSS-ECAL components code | |
| uint16 mem_adr | Memory address | 0x0000 to 0x03FF | |
| uint16 len | Number of bytes to write (Max 16) | ||
| uint8* buf | Data buffer to write |
Function Correspondence Table by HAL
| Arduino | Arduino | X |
| ARM | Mbed | X |
| Debian Project | Debian(Linux) v2022.04 | X |
| Infineon | ModusToolbox | X |
| NXP | MCUXpresso MXRT1051B_1052B | X |
| STM | STM32Cube FW_F4 | X |
etSTS oAT24C08C_CURRENT_READ( etCMP cmp, uint8* rlt )
The oAT24C08C_CURRENT_READ function is an API function that reads the value of 1 byte from the last Read or Write address + 1 for the AT24C08C and stores it in rlt.
NOTE :
If mem_adr + len > 0b1111111111, the addresses is rolled over to 0b0000000000.
| Return value | etSTS | OSS-ECAL status code | |
| eSTS_FIN | Completed successfully | ||
| eSTS_ERR_I2C_OBJECT | I2C object selection error | ||
| eSTS_ERR_OTHERS_RUN | Other components are executing the process | ||
| eSTS_ERR_HAL_OTHERS_RUN | Other application is running HAL | ||
| eSTS_ERR_HAL_I2C | HAL I2C error | ||
| Parameter IN | etCMP cmp | OSS-ECAL components code | |
| Parameter OUT | uint8* rlt | Data to read |
Function Correspondence Table by HAL
| Arduino | Arduino | X |
| ARM | Mbed | X |
| Debian Project | Debian(Linux) v2022.04 | X |
| Infineon | ModusToolbox | X |
| NXP | MCUXpresso MXRT1051B_1052B | X |
| STM | STM32Cube FW_F4 | X |
etSTS oAT24C08C_RANDOM_READ( etCMP cmp, uint16 mem_adr, uint8* rlt )
The oAT24C08C_RANDOM_READ function is an API function that reads a 1-byte value from a specified address mem_adr for the AT24C08C and stores it in rlt.
NOTE :
| Return value | etSTS | OSS-ECAL status code | |
| eSTS_FIN | Completed successfully | ||
| eSTS_ERR_PARAMETER | Parameter error(Memory address) | ||
| eSTS_ERR_I2C_OBJECT | I2C object selection error | ||
| eSTS_ERR_OTHERS_RUN | Other components are executing the process | ||
| eSTS_ERR_HAL_OTHERS_RUN | Other application is running HAL | ||
| eSTS_ERR_HAL_I2C | HAL I2C error | ||
| Parameter IN | etCMP cmp | OSS-ECAL components code | |
| uint16 mem_adr | Memory address | 0x0000 to 0x03FF | |
| Parameter OUT | uint8* rlt | Data to read |
Function Correspondence Table by HAL
| Arduino | Arduino | X |
| ARM | Mbed | X |
| Debian Project | Debian(Linux) v2022.04 | X |
| Infineon | ModusToolbox | X |
| NXP | MCUXpresso MXRT1051B_1052B | X |
| STM | STM32Cube FW_F4 | X |
etSTS oAT24C08C_SEQ_READ( etCMP cmp, uint16 mem_adr, uint16 len, uint8* buf )
The oAT24C08C_SEQ_READ function is an API function that reads data for len from the specified address mem_adr for the AT24C08C in sequence and stores the data from buf[0] to buf[len-1].
NOTE :
If mem_adr + len > 0b1111111111, the addresses is rolled over to 0b0000000000.
| Return value | etSTS | OSS-ECAL status code | |
| eSTS_FIN | Completed successfully | ||
| eSTS_ERR_PARAMETER | Parameter error(Memory address) | ||
| eSTS_ERR_I2C_OBJECT | I2C object selection error | ||
| eSTS_ERR_OTHERS_RUN | Error during execution of other components | ||
| eSTS_ERR_HAL_OTHERS_RUN | HAL running in another application | ||
| eSTS_ERR_HAL_I2C | HAL I2C error | ||
| Parameter IN | etCMP cmp | OSS-ECAL components code | |
| uint16 mem_adr | Memory address | 0x0000 to 0x03FF | |
| uint16 len | Number of bytes to read | ||
| Parameter OUT | uint8* buf | Data to read |
Function Correspondence Table by HAL
| Arduino | Arduino | X |
| ARM | Mbed | X |
| Debian Project | Debian(Linux) v2022.04 | X |
| Infineon | ModusToolbox | X |
| NXP | MCUXpresso MXRT1051B_1052B | X |
| STM | STM32Cube FW_F4 | X |
etSTS oAT24C08C_WP_EN( etCMP cmp )
The oAT24C08C_WP_EN function is an API function that outputs Write protect enable (write disable) = “Hi” for the AT24C08C.
NOTE :
| Return value | etSTS | OSS-ECAL status code | |
| eSTS_FIN | Completed successfully | ||
| eSTS_ERR_GPIO_OBJECT | GPIO object selection error | ||
| Parameter IN | etCMP cmp | OSS-ECAL components code |
Function Correspondence Table by HAL
| Arduino | Arduino | X |
| ARM | Mbed | X |
| Debian Project | Debian(Linux) v2022.04 | X |
| Infineon | ModusToolbox | X |
| NXP | MCUXpresso MXRT1051B_1052B | X |
| STM | STM32Cube FW_F4 | X |
etSTS oAT24C08C_WP_DIS( etCMP cmp )
The oAT24C08C_WP_DIS function is an API function that outputs Write protect disable (write enable) = “Low” for the AT24C08C.
NOTE :
| Return value | etSTS | OSS-ECAL status code | |
| eSTS_FIN | Completed successfully | ||
| eSTS_ERR_GPIO_OBJECT | GPIO object selection error | ||
| Parameter IN | etCMP cmp | OSS-ECAL components code |
Function Correspondence Table by HAL
| Arduino | Arduino | X |
| ARM | Mbed | X |
| Debian Project | Debian(Linux) v2022.04 | X |
| Infineon | ModusToolbox | X |
| NXP | MCUXpresso MXRT1051B_1052B | X |
| STM | STM32Cube FW_F4 | X |
Files
| Folder* | File | summary |
|---|---|---|
| AT24C08C_HALNAME_VERSION/sample | sample.c (.cpp) | Sample Application Program |
| sample.h | Sample Application Header | |
| AT24C08C_HALNAME_VERSION | oAT24C08C.c (.cpp) | OSS-ECAL Program for AT24C08C |
| oAT24C08C.h | OSS-ECAL Header for AT24C08C | |
| AT24C08C_ARDUINO.ino | Sample application programs for Arduino | |
| oss_ecal.h | OSS-ECAL Common Header (Ver 01.00.00 or later, AUTOSAR is Ver 01.01.07 or later) | |
| oTypes.h | Typedef header file for AUTOSAR | |
| 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 | STM32F401RE | 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 | MIMXRT1052DVL6A | IMXRT1050-EVKB | iMXRT1051B1052B |
| STM | STM32Cube FW_F4 V1.27.1 | STM32F401RE | STM32 Nucleo-64 boards | STM32F4 |
| Debian Project | Debian(Linux) v2022.04 | TI AM335x | BeagleBone Black – Rev C | Linux |
* 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.
This OSS-ECAL is a sample version and can be downloaded without user registration, but please accept the OSS-ECAL Terms of Use before downloading.
| 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 | |
| Debian(Linux) v2022.04 |
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
#define AT24C08C_1 0b00000000For 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 oAT24C08C_PAGE_WRITE( etCMP cmp, uint16 mem_adr, uint16 len, uint8* buf )
etSTS oAT24C08C_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