AT24C32.h

Go to the documentation of this file.

/*
 * AT24C32.h
 *
 * STM32 HAL driver for the Atmel/Microchip AT24C32 32 Kbit (4096 byte) I2C EEPROM,
 * as found on the common ZS-042 DS3231 breakout module.
 *
 * Written from the AT24C32D datasheet (DS20006047A): device address, 16-bit word
 * address, 32-byte page write, acknowledge polling and sequential read. It is an
 * independent implementation, not a port of anyone else's library.
 *
 *  Created on: Oct 7, 2026
 *      Author: johng
 */
 
#ifndef STM32_AT24C32_AT24C32_H_
#define STM32_AT24C32_AT24C32_H_
 
#include "main.h"
#include <stdint.h>
 
#ifdef __cplusplus
extern "C" {
#endif
 
#define AT24C32_SIZE_BYTES          4096U
 
#define AT24C32_PAGE_SIZE           32U
 
#define AT24C32_MAX_ADDRESS_PINS    7U
 
#define AT24C32_DEFAULT_MAX_ATTEMPTS 3U
 
#define AT24C32_I2C_TIMEOUT_MS      100U
 
#define AT24C32_WRITE_TIMEOUT_MS    20U
 
typedef enum {
    AT24C32_OK = 0,           
    AT24C32_ERR_PARAM,        
    AT24C32_ERR_NOT_FOUND,    
    AT24C32_ERR_BUS           
} AT24C32_Status_t;
 
typedef struct {
    I2C_HandleTypeDef *hi2c;        
    uint16_t           deviceAddress; 
    uint8_t            maxAttempts;   
    HAL_StatusTypeDef  lastStatus;    
} AT24C32_t;
 
AT24C32_Status_t at24c32Init(AT24C32_t *dev, I2C_HandleTypeDef *hi2c, uint8_t addressPins, uint8_t maxAttempts);
AT24C32_Status_t at24c32Read(AT24C32_t *dev, uint16_t memAddress, uint8_t *data, uint16_t length);
AT24C32_Status_t at24c32Write(AT24C32_t *dev, uint16_t memAddress, const uint8_t *data, uint16_t length);
 
#ifdef __cplusplus
}
#endif
 
#endif /* STM32_AT24C32_AT24C32_H_ */