esp32 操作DS1307时钟芯片

电气参数摘要

• 有VCC供电，IIC活动状态是1.5mA，待机状态200μA，电池电流5nA(MAX=50nA）
• 无VCC供电的时候，电池电流，300nA（时钟运行），10nA（时钟停止）
• 供电电压是4.5-5.5V，不支持3.3V
• IIC频率最大400kHZ。
• 因为ESP32不支持5V电压，但是DS1307必须用5V供电，因此在IIC上拉电阻的位置，必须上拉到3.3V。否则直接给ESP32的IO灌5V可能会烧掉。可以使用ESP32内部的IO上拉，然后去掉外部的上拉就行。

IIC的通信

• 访问是通过实施启动条件，并提供设备识别代码，后跟寄存器地址而获得的。可以按顺序访问后续寄存器，直到执行停止条件为止。
• 芯片iic地址是0x68
• 配置寄存器，先发送设备地址，发送寄存器地址（比如0），然后发送寄存器的值。可以一次性发送多个字节，芯片会自动偏移寄存器地址。
• 读取寄存器，先发送寄存器地址，然后读取。支持连续读取多个寄存器。

寄存器

• RTC寄存器位于地址00h至07h的位置。
• RAM寄存器位于地址08h至3Fh的位置。

在多字节访问期间，当地址指针达到3Fh，即RAM空间的末尾时，它会环绕到位置00h，即时钟空间的开头。

• 在初次上电的时候（指初次装上纽扣电池），CH位是置1的，表示振荡器停止，计时功能处于停止状态。这时候纽扣电池的耗电量位10nA。
• 所以在初次使用的时候，需要对CH位清零，一般这个清零操作会在设置当前时间到DS1307时同时完成。
• 当CH位置0后，断开主电，RTC也会继续运行，这时候纽扣电池的耗电量典型值为300nA（无方波输出时）。

计算

1. 芯片将“年月日时分秒周”存放到地址00-06这7个寄存器里面。每个寄存器相应bit对应的含义，看寄存器列表。
2. 读取秒的寄存器是00h。先要读取出10倍数的秒（也就是十位数），对应BIT4~bit6.
   然后读取个位数的秒数，BIT0~BIT3.
   
   比如读取到寄存器值为0x59，则对应二进制为00101 1001b。则bit4~bit6=5 ,BIT0~BIT3= 9最终为5*10+9=59秒。
   这个寄存器的CH位是时钟启停控制bit。
   3.比如读小时，小时在芯片里面有12小时表示法和24小时表示法。具体看BIT6。
   当bit6=1，则剩余的bit按照12小时制展开。
   当bit6=0，则剩余的bit按照24小时制展开。
   

DS1307上的RAM

这个RAM是留给用户使用的存储空间，RTC不会用到这部分RAM

DS1307上的RAM（随机存储器）用于存储临时数据，用户自定义的设置以及其他需要在断电时保持的信息。以下是DS1307上RAM的主要用途：

存储用户数据： 用户可以将自定义数据存储在DS1307的RAM中。这可以包括配置参数、计数器值、标志位等。因为这部分RAM是带电池支持的，所以即使在主电源断电时，这些数据也会被保持。

保存配置信息： DS1307的RAM可以用于存储与实时时钟（RTC）和其他功能相关的配置信息。这些配置信息可能包括时钟格式（12小时或24小时制）、日期格式、方波输出频率等。

临时存储： RAM还可用于存储临时性的运行时数据。例如，当进行时钟校准或其他运行时操作时，可能需要在RAM中存储一些中间数据。

断电备份： 由于RAM是带电池支持的，所以它提供了断电备份的功能。即使主电源断电，RAM中的数据仍然会被保存，确保在电源重新连接时可以恢复先前的状态。

总的来说，DS1307上的RAM为用户提供了一块持久存储区域，允许在断电时保留关键的信息。这在需要在系统重新上电时恢复先前状态或保留特定配置和数据时非常有用。

操作时序

设置时钟，比如设置时钟为2024-01-26 10:37:10 周五
发送的字节依次为：设备地址0x68，寄存器地址00，接下来7个字节是要设置进00h-06h这7个寄存器的值。

读取时钟
1.先发送一个数据00，将读取指针只想寄存器0.这个操作在数据手册有说。
2.然后连续读取出数据

## 赋上次芯片的driver代码

#include <stdio.h>
#include "esp_log.h"
#include "ds1307_driver.h"
#include "driver/i2c.h"
#include <string.h>

static const char *TAG = "ds1307-driver";

#define I2C_MASTER_SCL_IO CONFIG_I2C_MASTER_SCL /*!< GPIO number used for I2C master clock */
#define I2C_MASTER_SDA_IO CONFIG_I2C_MASTER_SDA /*!< GPIO number used for I2C master data  */
#define I2C_MASTER_NUM 0                        /*!< I2C master i2c port number, the number of i2c peripheral interfaces available will depend on the chip */
#define I2C_MASTER_FREQ_HZ 100000               /*!< I2C master clock frequency */
#define I2C_MASTER_TX_BUF_DISABLE 0             /*!< I2C master doesn't need buffer */
#define I2C_MASTER_RX_BUF_DISABLE 0             /*!< I2C master doesn't need buffer */
#define I2C_MASTER_TIMEOUT_MS 1000

#define DS1307_I2C_ADDR 0x68 /*!< Slave address of the MPU9250 sensor */

RTC_time_typedef time;

esp_err_t ds1307_init(void)
{
   
    int ret;

    // 初始化iic
    int i2c_master_port = I2C_MASTER_NUM;

    i2c_config_t conf = {
   
        .mode = I2C_MODE_MASTER,
        .sda_io_num = I2C_MASTER_SDA_IO,
        .scl_io_num = I2C_MASTER_SCL_IO,
        .sda_pullup_en = GPIO_PULLUP_ENABLE,
        .scl_pullup_en = GPIO_PU