STM32CubeMX配置I2C读取DS3231

使用HAL库操作DS3231

因为DSP2这个项目需要计时间功能所以封装了一下这个芯片的程序

硬件设计

我将它接到了I2C1对应的IO口是（SCL > PB6 | SDA > PB7）

程序封装

CubeMX的I2C配置

之后就是代码的编写

BSP_DS3231.c

copy

/* USER CODE BEGIN Header */
/**
  ******************************************************************************
  * @file           : DS3231.c
  * @brief          : DS3231 program body
  * @author         : 「千樊」
  * @time           : 2021-09-26
  * @update         : 2023-03-28
  ******************************************************************************
  * @attention
  *
  *
  *
  ******************************************************************************
  */
/* USER CODE END Header */

/* Private includes ----------------------------------------------------------*/
/* USER CODE BEGIN Includes */

    #include "BSP_DS3231.h"
    #include "i2c.h"

/* USER CODE END Includes */


/* Private typedef -----------------------------------------------------------*/
/* USER CODE BEGIN PT */

    char* QF_WEEK_NAMES[] = {"SUNDAY","MONDAY", "TUESDAY" ,"WEDNESDAY" ,"THURSDAY" ,"FRIDAY" ,"SATURDAY",};  
    struct DS3231_time_t DS3231_Buff;
    
/* USER CODE END PT */
    

/* Function definition -------------------------------------------------------*/
/* USER CODE BEGIN FD */
/**
  * @Function name  BCD_DEC
  * @Introduce      BCD(8421)转DEC
  * @Parameter      BCD(8421)值    
  * @Return         DEC值
  */
    uint8_t BCD_DEC(uint8_t BCD_Data){
        uint8_t DEC_Data;
   
        DEC_Data= BCD_Data&0x0f;
        BCD_Data >>= 4;
        BCD_Data &= 0x0f;
        BCD_Data *= 10;
        DEC_Data += BCD_Data;    
        return DEC_Data;
    }
    
/**
  * @Function name  DEC_BCD
  * @Introduce      DEC转BCD(8421)
  * @Parameter      DEC值    
  * @Return         BCD(8421)值
  */
    uint8_t DEC_BCD(uint8_t DEC_Data){
        uint8_t BCD_DataA,BCD_DataB,BCD_Data;
        
        BCD_DataA=DEC_Data/10;
        BCD_DataB=DEC_Data%10;
        BCD_Data=BCD_DataB+(BCD_DataA<<4);
        return BCD_Data;
    }

/**
  * @Function name  I2C_DS3231_ReadData
  * @Introduce      DS3231通过I2C读取一个字节
  * @Parameter      ReadAddr I2C读取地址
  * @Return         NULL
  */
    uint8_t I2C_DS3231_ReadData(uint8_t ReadAddr){
        uint8_t DS3231_DataAddr[1];
        DS3231_DataAddr[0]= ReadAddr;

        HAL_I2C_Master_Transmit(&hi2c1,(DS3231_ADDRESS|I2C_WR),DS3231_DataAddr,sizeof(DS3231_DataAddr), 1000);
        HAL_I2C_Master_Receive(&hi2c1,(DS3231_ADDRESS|I2C_RD),DS3231_DataAddr,sizeof(DS3231_DataAddr), 1000);
        return DS3231_DataAddr[0];
    }

/**
  * @Function name  I2C_DS3231_WriteData
  * @Introduce      DS3231通过I2C写一个字节
  * @Parameter      WriteAddr I2C写入地址 Data I2C写入数据
  * @Return         NULL
  */
    void I2C_DS3231_WriteData(uint8_t WriteAddr,uint8_t Data){
        uint8_t DS3231_Data[2];
        DS3231_Data[0]    = WriteAddr;
        DS3231_Data[1]    = Data;
        HAL_I2C_Master_Transmit(&hi2c1,(DS3231_ADDRESS|I2C_WR),DS3231_Data,sizeof(DS3231_Data), 1000);
    }
    
/**
  * @Function name  DS3231_SetTime
  * @Introduce          DS3231通过I2C设置时间
  * @Parameter          Yea 年份范围在0~99
  *                     Mon    月份范围在0~12
  *                     Dat    日范围在1~31
  *                     Wee    周范围在1~7
  *                     Hou    小时范围在0~23
  *                     Min    分钟范围在0~59
  *                     Sec    秒范围在0~59
  * @Return             NULL
  */
    void QF_DS3231_SetTime(uint8_t Yea,uint8_t Mon,uint8_t Dat,uint8_t Hou,uint8_t Min,uint8_t Sec,uint8_t Wee){
        I2C_DS3231_WriteData(Year_Register        ,DEC_BCD(Yea));
        I2C_DS3231_WriteData(Month_Register        ,DEC_BCD(Mon));
        I2C_DS3231_WriteData(Day_Register            ,DEC_BCD(Dat));
        I2C_DS3231_WriteData(Week_Register        ,DEC_BCD(Wee));
        I2C_DS3231_WriteData(Hour_Register        ,DEC_BCD(Hou));
        I2C_DS3231_WriteData(Minutes_Register    ,DEC_BCD(Min));
        I2C_DS3231_WriteData(Seconds_Register    ,DEC_BCD(Sec));
    }

/**
  * @Function name  DS3231_ReadTime_ReturnPoint
  * @Introduce          将读到的时间数据通过指针返回 
  * @Return                 NULL
  */
    struct DS3231_time_t QF_DS3231_ReadTime_ReturnPoint(void){
　　　　DS3231_Buff.Year        = BCD_DEC(I2C_DS3231_ReadData(Year_Register));
　　　　DS3231_Buff.Month       = BCD_DEC(I2C_DS3231_ReadData(Month_Register));
　　　　DS3231_Buff.Date         = BCD_DEC(I2C_DS3231_ReadData(Day_Register));
　　　　DS3231_Buff.Hour        = BCD_DEC(I2C_DS3231_ReadData(Hour_Register));
　　　　DS3231_Buff.Minutes      = BCD_DEC(I2C_DS3231_ReadData(Minutes_Register));
　　　　DS3231_Buff.Seconds      = BCD_DEC(I2C_DS3231_ReadData(Seconds_Register));
　　　　DS3231_Buff.Week        = BCD_DEC(I2C_DS3231_ReadData(Week_Register));
　　　　return DS3231_Buff;
    }
    
/* USER CODE END FD */
/************************ (C) COPYRIGHT 「千樊」 *****END OF FILE****/

DS3231.h

copy

/* USER CODE BEGIN Header */
/**
  ******************************************************************************
  * @file           : DS3231.h
  * @brief          : Header for DS3231.c file.
  *                   This file provides code for the configuration
  *                   of the DS3231 instances
  * @author　　　　　 : 「千樊」
  * @time　　　　　　  :  2021-09-26
  ******************************************************************************
  * @attention
  *
  *
  ******************************************************************************
  */
/* USER CODE END Header */

/* Define to prevent recursive inclusion -------------------------------------*/
#ifndef __BSP_DS3231_H_
#define __BSP_DS3231_H_

/* Private includes ----------------------------------------------------------*/
/* USER CODE BEGIN Includes */

    #include "main.h"
    
/* USER CODE END Includes */
/* Private typedef -----------------------------------------------------------*/
/* USER CODE BEGIN PT */

    #define     I2C_WR                      　　0x00            //写指令
    #define     I2C_RD                      　　0x01            //读指令
    #define     DS3231_ADDRESS                 0xD0           //DS3231地址
    
    #define     Seconds_Register      　　　　　0x00         //秒钟寄存器
    #define     Minutes_Register              0x01         //分钟寄存器
    #define     Hour_Register                　0x02         //小时寄存器
    #define     Week_Register           　　　　0x03      　　//星期寄存器
    #define     Day_Register              　　0x04            //日期寄存器
    #define     Month_Register             　　0x05        //月份寄存器
    #define     Year_Register           　　　　0x06        //年份寄存器

    struct DS3231_time_t{
        uint8_t Seconds;
        uint8_t Minutes;
        uint8_t Hour;
        uint8_t Date;
        uint8_t Month;
        uint8_t Year;
        uint8_t Week;
    }; 

    extern char* QF_WEEK_NAMES[];

    
/* USER CODE END PT */
/* Exported functions prototypes ---------------------------------------------*/
/* USER CODE BEGIN EFP */

    void QF_DS3231_SetTime(uint8_t Yea,uint8_t Mon,uint8_t Dat,uint8_t Hou,uint8_t Min,uint8_t Sec,uint8_t Wee);
    struct DS3231_time_t QF_DS3231_ReadTime_ReturnPoint(void);

/* USER CODE END EFP */

#endif /* __BSP_DS3231_H_ */


/************************ (C) COPYRIGHT Lesterbor *****END OF FILE*************/