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

来自YFRobotwiki
跳转至: 导航搜索
 
(未显示1个用户的3个中间版本)
第9行: 第9行:
 
GITHUB 工程地址:[https://github.com/Makuna/Rtc  RTC by Makuna]
 
GITHUB 工程地址:[https://github.com/Makuna/Rtc  RTC by Makuna]
  
 本地下载地址:[http://www.yfrobot.com.cn/forum.php?mod=attachment&aid=MTY5MXxkM2I5Nzk5Y3wxNTU5MjcxNjg5fDF8MTE5NDY%3D RTC DS3231]
+
 本地下载地址:[http://www.yfrobot.com.cn/forum.php?mod=attachment&aid=MTY5MXxlNDFkYmYwMXwxNjA4NzA0MTkxfDJ8MTE5NDY%3D RTC DS3231]
               http://www.yfrobot.com.cn/forum.php?mod=attachment&aid=MTY5MXxlNDFkYmYwMXwxNjA4NzA0MTkxfDJ8MTE5NDY%3D
+
                
  
 
 支持设备
 
 支持设备
  
'''DS1307'''   
+
'''[[RTC 1307|DS1307]]'''   
  
 
Full support including squarewave output pin and memory access  --  全部功能支持,包括方波输出和内存访问   
 
Full support including squarewave output pin and memory access  --  全部功能支持,包括方波输出和内存访问   
  
'''DS3231'''   
+
'''[[RTC 3231|DS3231]]'''   
  
 
Full support including squarewave output pin and alarms.  --  全部功能支持,包括方波输出和闹钟   
 
Full support including squarewave output pin and alarms.  --  全部功能支持,包括方波输出和闹钟   
第52行: 第52行:
 
::返回:无
 
::返回:无
  
:-[[RtcDS1307.GetIsRunning()| GetIsRunning()]]
+
:-<font color="forestgreen">GetIsRunning()</font>  -- 判断RTC芯片是否正常工作
 +
::参数:无
 +
::返回:bool
  
:-[[RtcDS1307.SetIsRunning()| SetIsRunning()]]
+
:-<font color="forestgreen">SetIsRunning()</font>  -- 设置RTC芯片正常工作
 +
::参数:bool
 +
::返回:无
  
:-[[RtcDS1307.SetDateTime()| SetDateTime()]]
+
:-<font color="forestgreen">SetDateTime()</font>  -- 设置RTC芯片日期时间
 +
::参数:RtcDateTime ([[宏:__DATE__,__TIME__,__FILE__,__LINE__]]
 +
::返回:无
  
:-[[RtcDS1307.GetDateTime()| GetDateTime()]]
+
:-<font color="forestgreen">GetDateTime()</font>  -- 获取RTC芯片日期时间
 +
::参数:RtcDateTime ([[宏:__DATE__,__TIME__,__FILE__,__LINE__]]
 +
::返回:无
  
:-[[RtcDS1307.SetMemory()| SetMemory()]]
+
:-<font color="forestgreen">SetMemory()</font>  -- 写入RTC内存
 +
::参数:memoryAddress 地址, value 值
 +
::返回:无
  
:-[[RtcDS1307.GetMemory()| GetMemory()]]
+
:-<font color="forestgreen">GetMemory()</font>  -- 读取RTC内存
 +
::参数:memoryAddress 地址
 +
::返回:value 值
  
:-[[RtcDS1307.SetSquareWavePin()| SetSquareWavePin()]]
+
:-<font color="forestgreen">SetSquareWavePin()</font>  -- 设置方波输出
 +
::参数:方波频率
 +
<pre>
 +
enum DS1307SquareWaveOut
 +
{
 +
    DS1307SquareWaveOut_1Hz  =  0b00010000,
 +
    DS1307SquareWaveOut_4kHz =  0b00010001,
 +
    DS1307SquareWaveOut_8kHz =  0b00010010,
 +
    DS1307SquareWaveOut_32kHz = 0b00010011,
 +
    DS1307SquareWaveOut_High =  0b10000000,
 +
    DS1307SquareWaveOut_Low =  0b00000000,
 +
};
 +
</pre>
 +
::返回:无
  
 
|width="50%" valign="top" align="left"|
 
|width="50%" valign="top" align="left"|

2020年12月24日 (四) 08:37的最后版本


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论坛