GitHub - xxxajk/RTClib: A fork of Jeelab's fantastic RTC library

xxxajk / RTClib Public

forked from adafruit/RTClib

Notifications You must be signed in to change notification settings
Fork 3
Star 3

A fork of Jeelab's fantastic RTC library

3 stars 703 forks Branches Tags Activity

Notifications

Name		Name	Last commit message	Last commit date
Latest commit History 51 Commits
examples		examples
ARM_ATOMIC.h		ARM_ATOMIC.h
ATOMIC.h		ATOMIC.h
PIC32_ATOMIC.h		PIC32_ATOMIC.h
README		README
RTClib.cpp		RTClib.cpp
RTClib.h		RTClib.h
asc_store.c		asc_store.c
asctime.c		asctime.c
asctime_r.c		asctime_r.c
ctime.c		ctime.c
ctime_r.c		ctime_r.c
daylight_seconds.c		daylight_seconds.c
difftime.c		difftime.c
dst_pointer.c		dst_pointer.c
ephemera_common.h		ephemera_common.h
equation_of_time.c		equation_of_time.c
fatfs_time.c		fatfs_time.c
geo_location.c		geo_location.c
gm_sidereal.c		gm_sidereal.c
gmtime.c		gmtime.c
gmtime_r.c		gmtime_r.c
isLeap.c		isLeap.c
iso_week_date.c		iso_week_date.c
iso_week_date_r.c		iso_week_date_r.c
isotime.c		isotime.c
isotime_r.c		isotime_r.c
keywords.txt		keywords.txt
lm_sidereal.c		lm_sidereal.c
localtime.c		localtime.c
localtime_r.c		localtime_r.c
mk_gmtime.c		mk_gmtime.c
mktime.c		mktime.c
month_length.c		month_length.c
moon_phase.c		moon_phase.c
print_lz.c		print_lz.c
set_dst.c		set_dst.c
set_position.c		set_position.c
set_system_time.cpp		set_system_time.cpp
set_zone.c		set_zone.c
solar_declination.c		solar_declination.c
solar_noon.c		solar_noon.c
strftime.c		strftime.c
sun_rise.c		sun_rise.c
sun_set.c		sun_set.c
system_time.c		system_time.c
time.cpp		time.cpp
time.h		time.h
tm_store.c		tm_store.c
utc_offset.c		utc_offset.c
week_of_month.c		week_of_month.c
week_of_year.c		week_of_year.c

Repository files navigation

Original code from JeeLabs http://news.jeelabs.org/code/

forked by Adafruit

and then forked by me... rlameiro :D

Now forked, enhanced, and mutilated by me xxxajk.


What's new:

* Preliminary Teensy 3.0 RTC support. Please test!

* AVR:
  All the standard libc time functions are available.
  Epoch is 1/1/1900.
  time_t is an int64_t and does not have the January 19, 2038 overflow problem.
  I2C is protected by xmem's multitasking lock if you use multitasking.
  If you are missing the DS1307 chip, the library automatically reverts to
  using the software millis RTC which is only good for ~49 days.

* You no longer have to 'start' RTC with begin.

* You do not have to declare that you use any particular RTC.

* There are 3 simplified functions for using the entire RTC library.
        Set the time
                RTCset(const DateTime& dt);
        Get the current time
                DateTime RTCnow();
        Find out if RTC is hardware.
                boolean RTChardware(void);

* DS1307 specifics:
  Read and write to DS1307 scratch memory is available, as is the
  SqwPinMode setting.

TO-DO:
       Make a unified access method to RTC specific features, such as:
         * Access to RTC memory
         * Access to RTC PIN features

Notes for DS1307 users in the far future:
  In the year 2100 you will have to get a new DS1307 and adjust the software,
  because the DS1307 is only good to the year 2099. :-)

Notes for Teensy 3.0 users on and after January 19, 2038:
  time_t in the libc is only 32 bits.
  The date restarts at December 13, 1901 due to an overflow.
  Please complain to GNU and the developers of libc about it.
  For details about this problem, please see:
    http://en.wikipedia.org/wiki/Year_2038_problem