Add ability to set halt state on DS1307

adafruit · Oct 13, 2023 · 78fc148 · 78fc148
1 parent 33fb040
commit 78fc148
Show file tree

Hide file tree

Showing 2 changed files with 18 additions and 0 deletions.
diff --git a/src/RTC_DS1307.cpp b/src/RTC_DS1307.cpp
@@ -3,6 +3,7 @@
 #define DS1307_ADDRESS 0x68 ///< I2C address for DS1307
 #define DS1307_CONTROL 0x07 ///< Control register
 #define DS1307_NVRAM 0x08 ///< Start of RAM registers - 56 bytes, 0x08 to 0x3f
+#define DS1307_HALT 0x80
 
 /**************************************************************************/
 /*!
@@ -28,6 +29,22 @@ bool RTC_DS1307::begin(TwoWire *wireInstance) {
 /**************************************************************************/
 uint8_t RTC_DS1307::isrunning(void) { return !(read_register(0) >> 7); }
 
+/**************************************************************************/
+/*!
+ @brief Set DS1307 halt state
+ @param halt set halt to specified value
+*/
+/**************************************************************************/
+void RTC_DS1307::halt(bool halt) {
+ uint8_t reg = read_register(0);
+ if (halt) {
+ reg |= DS1307_HALT;
+ } else {
+ reg &= ~DS1307_HALT;
+ }
+ write_register(0, reg);
+}
+
 /**************************************************************************/
 /*!
  @brief Set the date and time in the DS1307

diff --git a/src/RTClib.h b/src/RTClib.h
@@ -353,6 +353,7 @@ class RTC_DS1307 : RTC_I2C {
  bool begin(TwoWire *wireInstance = &Wire);
  void adjust(const DateTime &dt);
  uint8_t isrunning(void);
+ void halt(bool halt);
  DateTime now();
  Ds1307SqwPinMode readSqwPinMode();
  void writeSqwPinMode(Ds1307SqwPinMode mode);