RTC DS1307 DS3231库

来自YFRobotwiki
跳转至: 导航搜索


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
返回:无



TIP: 宏:__DATE__,__TIME__,__FILE__,__LINE__



返回DS1307

返回DS3231

返回Arduino库菜单

返回首页

更多建议和问题欢迎反馈至 YFRobot论坛