“RTC DS1307 DS3231库”的版本间的差异

RTC_DS1307_DS3231库 -- arduino实时时钟库（已支持ESP8266）

GITHUB 工程地址：RTC by Makuna

本地下载地址：RTC DS3231

支持设备

DS1307

Full support including squarewave output pin and memory access -- 全部功能支持，包括方波输出和内存访问

DS3231

Full support including squarewave output pin and alarms. -- 全部功能支持，包括方波输出和闹钟

示例

- DS1307_Memory: This demonstrates how to write and read data from the extended memory of the device. This memory is retained even after the device has lost power./演示如何读写数据从设备的扩展内存。即使设备掉电内存依然保存

- DS1307_Simple: This demonstrates how to set and get the date and time from the device./演示了如何在设备上设置和获取日期和时间

- DS3231_Alarms: This demonstrates how to set the alarms and check when the alarms are triggered. This includes using the squarewave output to trigger an interrupt./演示如何设置闹钟和检查何时触发闹钟。这包含使用方波输出触发一个中断

- DS3231_Simple: This demonstrates how to set and get the date and time from the device./演示如何在设备上设置和获取日期和时间。

- DS3231_StoreIt: This demonstrates how to turn off the Rtc clock so that the onboard battery will last longer./演示如何关闭RTC时钟以保证板载电池能持续更长时间

DS1307

DS1307 函数。

- Begin() -- 初始化

参数：无

返回：无

-GetIsRunning() -- 判断RTC芯片是否正常工作

参数：无

返回：bool

-SetIsRunning() -- 设置RTC芯片正常工作

参数：bool

返回：无

-SetDateTime() -- 设置RTC芯片日期时间

参数：RtcDateTime （宏：__DATE__,__TIME__,__FILE__,__LINE__）

返回：无

-GetDateTime() -- 获取RTC芯片日期时间

参数：RtcDateTime （宏：__DATE__,__TIME__,__FILE__,__LINE__）

返回：无

-SetMemory() -- 写入RTC内存

参数：memoryAddress 地址, value 值

返回：无

-GetMemory() -- 读取RTC内存

参数：memoryAddress 地址

返回：value 值

-SetSquareWavePin() -- 设置方波输出

参数：方波频率

enum DS1307SquareWaveOut
{
    DS1307SquareWaveOut_1Hz  =  0b00010000,
    DS1307SquareWaveOut_4kHz =  0b00010001,
    DS1307SquareWaveOut_8kHz =  0b00010010,
    DS1307SquareWaveOut_32kHz = 0b00010011,
    DS1307SquareWaveOut_High =  0b10000000,
    DS1307SquareWaveOut_Low =   0b00000000,
};

返回：无

DS3231

DS3231 函数

- Begin() -- 初始化

参数：无

返回：无

-IsDateTimeValid() -- 检查日期时间是否有效

参数：无

返回：bool

- GetIsRunning()

- SetIsRunning()

-SetDateTime() -- 设置日期时间

参数：const RtcDateTime& dt

返回：无

-GetDateTime() -- 获取日期时间

参数：无

返回：RtcDateTime

-GetTemperature() -- 获取温度

参数：无

返回：RtcTemperature

-Enable32kHzPin() -- 使能32KHZ引脚

参数：bool enable

返回：无

-SetSquareWavePin() -- 设置方波输出引脚

参数：DS3231SquareWavePinMode pinMode

    enum DS3231SquareWavePinMode{
        DS3231SquareWavePin_ModeNone,
        DS3231SquareWavePin_ModeBatteryBackup,
        DS3231SquareWavePin_ModeClock,
        DS3231SquareWavePin_ModeAlarmOne,
        DS3231SquareWavePin_ModeAlarmTwo,
        DS3231SquareWavePin_ModeAlarmBoth
    }

返回：无

-SetSquareWavePinClockFrequency() -- 设置方波输出引脚时钟频率

参数：DS3231SquareWaveClock freq

返回：无

-SetAlarmOne() -- 设置闹钟1

参数：const DS3231AlarmOne& alarm

返回：无

-SetAlarmTwo() -- 设置闹钟2

参数：const DS3231AlarmTwo& alarm

返回：无

-GetAlarmOne() -- 获取闹钟1

参数：无

返回：DS3231AlarmOne

-GetAlarmTwo() -- 获取闹钟2

参数：无

返回：DS3231AlarmTwo

-LatchAlarmsTriggeredFlags() -- 警报后必须调用，否则将不会再次触发

参数：无

返回：DS3231AlarmFlag

-ForceTemperatureCompensationUpdate() -- 手动温度补偿更新

参数：bool block

返回：无

-GetAgingOffset() -- 获取老化补偿

参数：无

返回：int8_t

-SetAgingOffset() -- 设置老化补偿

参数：int8_t

返回：无