{"id":52344,"date":"2026-11-01T10:50:59","date_gmt":"2026-11-01T10:50:59","guid":{"rendered":"http:\/\/siratek.net\/index.php\/tutorials\/rtc-ds3231\/"},"modified":"2026-11-01T10:50:59","modified_gmt":"2026-11-01T10:50:59","slug":"rtc-ds3231","status":"publish","type":"siratek_tutorial","link":"https:\/\/siratek.net\/index.php\/tutorials\/rtc-ds3231\/","title":{"rendered":"Keeping Time with a DS3231"},"content":{"rendered":"

<\/p>\n

What it does<\/h2>\n

A real time clock: a chip that knows the date and time and keeps counting through power cuts, on a coin cell, for years.<\/p>\n

An Arduino cannot do this on its own. millis()<\/code> counts milliseconds since the sketch started and resets to zero on every power-up, and the crystal driving it is accurate to perhaps a few hundred parts per million, which is minutes of drift per week.<\/p>\n

The DS3231 solves both. It has its own battery, and it contains a temperature-compensated<\/strong> crystal oscillator, which is what makes it unusual at this price: most cheap clock chips drift badly as the room warms and cools, and this one corrects for it. Expect a couple of minutes a year rather than a couple of minutes a month.<\/p>\n

Before you begin<\/h2>\n

Required parts and tools<\/h3>\n
    \n
  • An Arduino Uno or compatible board.<\/li>\n
  • One DS3231 module. This is Siratek product 2522.<\/li>\n
  • A coin cell for the module, if one is not fitted.<\/li>\n
  • Four jumper wires, which may need to be male-to-female<\/strong>: see below.<\/li>\n<\/ul>\n

    Two shapes of module<\/h3>\n

    DS3231 boards come in two common forms, and the Siratek part is the smaller one.<\/p>\n

      \n
    • The small black board<\/strong>, which is what the product photographs show: a DS3231 chip, a coin cell on the underside and a female header block<\/strong>. It is designed to plug onto a Raspberry Pi\u2019s GPIO header, which is why the connector is female.<\/li>\n
    • The larger red board<\/strong>, often marked ZS-042, with a six-pin male header and room for an AT24C32 memory chip.<\/li>\n<\/ul>\n

      Both are the same chip, both speak I2C, and both work identically with the code below. What differs is the connector: the small board needs male-to-female<\/strong> jumpers, with the male end in the module.<\/p>\n

      Read the pin labels printed on your own board. On the small module they are marked beside the header and are easy to miss.<\/p>\n

      The battery, and a genuine hazard<\/h3>\n

      This is the part to read properly.<\/p>\n

      Some DS3231 boards, the larger red ones especially, include a charging circuit<\/strong> intended for a rechargeable LIR2032<\/strong> cell. The circuit trickle-charges whatever is fitted whenever the module has power.<\/p>\n

      Fit a non-rechargeable CR2032<\/strong> into a board with that circuit and it will be charged anyway. Non-rechargeable lithium cells are not designed to accept a charge: they can swell, leak, vent, or in the worst case rupture.<\/p>\n

      So:<\/p>\n

        \n
      • Find out which cell your board expects. LIR2032<\/code> is rechargeable, CR2032<\/code> is not.<\/li>\n
      • If the board has a charging circuit and you only have a CR2032, the usual fix is to remove the series resistor in the charging path, often marked R5<\/code> or similar, or to lift the diode. That disables charging and the cell runs down normally over several years.<\/li>\n
      • If you are not sure, use the cell the board is marked for, and do not leave an unfamiliar combination powered unattended.<\/li>\n<\/ul>\n

        A CR2032 in a non-charging holder is entirely safe and lasts years. The problem only arises with the combination.<\/p>\n

        It is an I2C device<\/h3>\n

        Four wires, and A4<\/code> and A5<\/code> again. The DS3231\u2019s address is 0x68<\/strong>, which it does not share with any display in this library, so it will happily sit on the same bus as an LCD or OLED.<\/p>\n

        If a bus scan finds a device at 0x57<\/strong> as well, that is the AT24C32 memory chip on the larger boards. Harmless, and occasionally useful.<\/p>\n

        Setting the time, and the trap in it<\/h3>\n

        The time has to be put into the chip once. Every library offers a way to set it from the compile-time of your sketch, which is convenient and contains a trap:<\/p>\n

        If that line stays in your sketch, the clock is reset to the compile time every time the board restarts.<\/strong> The project works perfectly on the bench, then loses an hour overnight because it was power-cycled, and the clock quietly jumps back to whenever you last compiled.<\/p>\n

        The sketch below sets the time only if the chip reports that it has lost power, which is the behaviour you actually want and costs one if<\/code>.<\/p>\n

        Pin reference<\/h2>\n\n\n\n\n\n\n\n\n\n\n
        Module pin<\/th>\nConnect to<\/th>\nPurpose<\/th>\nNotes<\/th>\n<\/tr>\n<\/thead>\n
        GND<\/code><\/td>\nUno GND<\/code><\/td>\nGround<\/td>\n<\/td>\n<\/tr>\n
        VCC<\/code><\/td>\nUno 5V<\/code><\/td>\nPower<\/td>\n2.3 to 5.5 V<\/td>\n<\/tr>\n
        SDA<\/code><\/td>\nUno A4<\/code><\/td>\nI2C data<\/td>\n<\/td>\n<\/tr>\n
        SCL<\/code><\/td>\nUno A5<\/code><\/td>\nI2C clock<\/td>\n<\/td>\n<\/tr>\n
        SQW<\/code><\/td>\nNot used here<\/td>\nSquare wave or alarm output<\/td>\nFor waking a sleeping board<\/td>\n<\/tr>\n
        32K<\/code><\/td>\nNot used here<\/td>\n32 kHz reference<\/td>\n<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
        \"A
        Four wires on the I2C bus, at address 0x68. The cell keeps it running when the Arduino is off.<\/figcaption><\/figure>\n

        Wiring steps<\/h2>\n
          \n
        1. Unplug the USB cable.<\/li>\n
        2. Check the cell is fitted, the right way up, and of the type the board expects.<\/li>\n
        3. GND<\/code> to GND<\/code>, VCC<\/code> to 5V<\/code>.<\/li>\n
        4. SDA<\/code> to A4<\/code>, SCL<\/code> to A5<\/code>.<\/li>\n
        5. Plug the USB cable back in.<\/li>\n
        6. Run the bus scanner from I2C, Two Wires and Many Devices<\/em> and confirm something answers at 0x68.<\/li>\n<\/ol>\n

          Software and libraries<\/h2>\n

          Install RTClib<\/strong> by Adafruit through Library Manager. It covers the DS3231 and several other clock chips with the same interface.<\/p>\n

          Minimal working example<\/h2>\n
          \/\/ Siratek: reading the time, and setting it only when it has been lost.\n\n#include <Wire.h>\n#include <RTClib.h>\n\nRTC_DS3231 rtc;\n\nvoid setup() {\n  Serial.begin(9600);\n  while (!Serial) {\n    ;\n  }\n\n  if (!rtc.begin()) {\n    Serial.println(\"Siratek: no DS3231 found. Check SDA, SCL and power.\");\n    while (1) {\n      delay(100);\n    }\n  }\n\n  if (rtc.lostPower()) {\n    \/\/ Only runs when the chip has actually lost its timekeeping,\n    \/\/ so a normal restart does not reset the clock.\n    Serial.println(\"Siratek: clock had lost power, setting from compile time.\");\n    rtc.adjust(DateTime(F(__DATE__), F(__TIME__)));\n  }\n\n  Serial.println(\"Siratek: clock ready.\");\n}\n\nvoid loop() {\n  DateTime now = rtc.now();\n\n  if (now.hour() < 10) {\n    Serial.print('0');\n  }\n  Serial.print(now.hour());\n  Serial.print(':');\n  if (now.minute() < 10) {\n    Serial.print('0');\n  }\n  Serial.print(now.minute());\n  Serial.print(':');\n  if (now.second() < 10) {\n    Serial.print('0');\n  }\n  Serial.print(now.second());\n\n  Serial.print(\"   \");\n  Serial.print(now.day());\n  Serial.print('\/');\n  Serial.print(now.month());\n  Serial.print('\/');\n  Serial.print(now.year());\n\n  Serial.print(\"   \");\n  Serial.print(rtc.getTemperature(), 1);\n  Serial.println(\" C\");\n\n  delay(1000);\n}<\/code><\/pre>\n
          Three things worth noticing.<\/p>\n
          lostPower()<\/code> is what makes the clock stay set.<\/strong> It asks the chip whether its own timekeeping has been interrupted, which is true on the very first run and false ever after while the cell holds up.<\/p>\n
          __DATE__<\/code> and __TIME__<\/code> are the moment the sketch was compiled<\/strong>, not the moment it was uploaded. Compiling, going for lunch and then uploading sets the clock an hour slow. Verify and upload together, and expect the clock to be a few seconds behind.<\/p>\n
          getTemperature()<\/code> is free.<\/strong> The chip measures its own temperature in order to compensate the crystal, and it will tell you the figure. It is accurate to about three degrees and is reading the chip, not the room, but it is a genuine extra sensor at no cost.<\/p>\n
          Setting the time without recompiling<\/h3>\n
          Relying on compile time means the only way to correct the clock is to recompile. Taking the time from the serial monitor is better for anything that will be used.<\/p>\n
          \/\/ Siratek: set the clock by typing, for example, 2026-10-29 14:05:00\n\nvoid checkForTimeSetting() {\n  if (Serial.available() < 19) {\n    return;\n  }\n\n  char buf[20];\n  Serial.readBytes(buf, 19);\n  buf[19] = '\\0';\n\n  int year, month, day, hour, minute, second;\n  if (sscanf(buf, \"%d-%d-%d %d:%d:%d\",\n             &year, &month, &day, &hour, &minute, &second) == 6) {\n    rtc.adjust(DateTime(year, month, day, hour, minute, second));\n    Serial.print(\"Siratek: clock set to \");\n    Serial.println(buf);\n  } else {\n    Serial.println(\"Siratek: expected YYYY-MM-DD HH:MM:SS\");\n  }\n\n  while (Serial.available()) {\n    Serial.read();            \/\/ discard the newline and anything else\n  }\n}<\/code><\/pre>\n
          Call that from loop()<\/code>. Now the clock can be corrected in the field by anyone with a serial monitor, with no toolchain and no source code.<\/p>\n
          Expected result<\/h2>\n
          The time printing once a second, advancing correctly, and a plausible temperature a few degrees above room temperature because the chip warms itself slightly.<\/p>\n
          The real test is the one that takes a day: unplug everything, leave it overnight, plug it back in and check the time is still right. That is what you bought the chip for, and nothing else proves it.<\/p>\n
          Troubleshooting<\/h2>\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
          Symptom<\/th>\nLikely cause<\/th>\nCheck or fix<\/th>\n<\/tr>\n<\/thead>\n
          begin()<\/code> fails<\/td>\nWiring, or no power<\/td>\nScan the bus; expect 0x68<\/td>\n<\/tr>\n
          Scanner finds nothing<\/td>\nSDA<\/code> and SCL<\/code> swapped<\/td>\nSDA<\/code> is A4<\/code>, SCL<\/code> is A5<\/code><\/td>\n<\/tr>\n
          Time resets on every power-up<\/td>\nadjust()<\/code> called unconditionally<\/td>\nGuard it with lostPower()<\/code><\/td>\n<\/tr>\n
          Time resets despite that<\/td>\nCell flat, missing or upside down<\/td>\nCheck the holder<\/td>\n<\/tr>\n
          Clock a few seconds slow<\/td>\nCompile time, not upload time<\/td>\nExpected; recompile and upload together<\/td>\n<\/tr>\n
          Clock minutes out after months<\/td>\nNormal DS3231 drift<\/td>\nA couple of minutes a year is in spec<\/td>\n<\/tr>\n
          Cell swollen or leaking<\/td>\nCR2032 in a charging board<\/td>\nRemove it carefully; disable the charging circuit<\/td>\n<\/tr>\n
          A second device at 0x57<\/td>\nAT24C32 memory on the larger board<\/td>\nHarmless<\/td>\n<\/tr>\n
          Jumpers will not fit<\/td>\nFemale header on the small module<\/td>\nUse male-to-female leads<\/td>\n<\/tr>\n
          Temperature reads high<\/td>\nIt is the chip\u2019s own temperature<\/td>\nNormal, and only accurate to a few degrees<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
          Next steps<\/h2>\n
            \n
          • Easier first:<\/strong> I2C, Two Wires and Many Devices<\/em>, for the bus and the scanner.<\/li>\n
          • Related products:<\/strong> a 16\u00d72 LCD to show the time, and an SD card module to timestamp a log.<\/li>\n
          • Next project:<\/strong> a data logger that records a sensor reading with the real time against it, which is where this chip earns its place.<\/li>\n<\/ul>\n
            Sources and attribution<\/h2>\n
            All text, wiring guidance and code in this tutorial are original Siratek work.<\/p>\n
              \n
            • DS3231 datasheet for the I2C address, the temperature-compensated oscillator, the accuracy figures and the onboard temperature sensor.<\/li>\n
            • RTClib documentation for the calls used.<\/li>\n
            • The small-format module with a female header and an underside coin cell was read from the Siratek product photographs for item 2522.<\/li>\n<\/ul>\n
              Whether a particular board includes a cell-charging circuit varies, so this tutorial tells the reader how to find out rather than assuming either way; the hazard described is a property of charging a non-rechargeable lithium cell. No third-party tutorial text, diagrams, photographs or code has been reproduced here.<\/p>\n
              <\/p>\n<\/body>","protected":false},"excerpt":{"rendered":"
              A real time clock: a chip that knows the date and time and keeps counting through power cuts, on a coin cell, for years.<\/p>\n","protected":false},"featured_media":0,"template":"","siratek_tutorial_level":[],"class_list":["post-52344","siratek_tutorial","type-siratek_tutorial","status-publish","hentry"],"yoast_head":"\nKeeping Time with a DS3231 - siratek<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"http:\/\/siratek.net\/index.php\/tutorials\/rtc-ds3231\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Keeping Time with a DS3231 - siratek\" \/>\n<meta property=\"og:description\" content=\"A real time clock: a chip that knows the date and time and keeps counting through power cuts, on a coin cell, for years.\" \/>\n<meta property=\"og:url\" content=\"http:\/\/siratek.net\/index.php\/tutorials\/rtc-ds3231\/\" \/>\n<meta property=\"og:site_name\" content=\"siratek\" \/>\n<meta property=\"og:image\" content=\"http:\/\/siratek.net\/wp-content\/uploads\/2026\/11\/rtc-ds3231-wiring.svg\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"8 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"http:\\\/\\\/siratek.net\\\/index.php\\\/tutorials\\\/rtc-ds3231\\\/\",\"url\":\"http:\\\/\\\/siratek.net\\\/index.php\\\/tutorials\\\/rtc-ds3231\\\/\",\"name\":\"Keeping Time with a DS3231 - siratek\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/siratek.net\\\/#website\"},\"primaryImageOfPage\":{\"@id\":\"http:\\\/\\\/siratek.net\\\/index.php\\\/tutorials\\\/rtc-ds3231\\\/#primaryimage\"},\"image\":{\"@id\":\"http:\\\/\\\/siratek.net\\\/index.php\\\/tutorials\\\/rtc-ds3231\\\/#primaryimage\"},\"thumbnailUrl\":\"http:\\\/\\\/siratek.net\\\/wp-content\\\/uploads\\\/2026\\\/11\\\/rtc-ds3231-wiring.svg\",\"datePublished\":\"2026-11-01T10:50:59+00:00\",\"breadcrumb\":{\"@id\":\"http:\\\/\\\/siratek.net\\\/index.php\\\/tutorials\\\/rtc-ds3231\\\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"http:\\\/\\\/siratek.net\\\/index.php\\\/tutorials\\\/rtc-ds3231\\\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"http:\\\/\\\/siratek.net\\\/index.php\\\/tutorials\\\/rtc-ds3231\\\/#primaryimage\",\"url\":\"https:\\\/\\\/siratek.net\\\/wp-content\\\/uploads\\\/2026\\\/11\\\/rtc-ds3231-wiring.svg\",\"contentUrl\":\"https:\\\/\\\/siratek.net\\\/wp-content\\\/uploads\\\/2026\\\/11\\\/rtc-ds3231-wiring.svg\"},{\"@type\":\"BreadcrumbList\",\"@id\":\"http:\\\/\\\/siratek.net\\\/index.php\\\/tutorials\\\/rtc-ds3231\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\\\/\\\/siratek.net\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Tutorials\",\"item\":\"https:\\\/\\\/siratek.net\\\/index.php\\\/tutorials\\\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Keeping Time with a DS3231\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/siratek.net\\\/#website\",\"url\":\"https:\\\/\\\/siratek.net\\\/\",\"name\":\"siratek\",\"description\":\"Your Best Electronic Retail Shop\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/siratek.net\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"Keeping Time with a DS3231 - siratek","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"http:\/\/siratek.net\/index.php\/tutorials\/rtc-ds3231\/","og_locale":"en_US","og_type":"article","og_title":"Keeping Time with a DS3231 - siratek","og_description":"A real time clock: a chip that knows the date and time and keeps counting through power cuts, on a coin cell, for years.","og_url":"http:\/\/siratek.net\/index.php\/tutorials\/rtc-ds3231\/","og_site_name":"siratek","og_image":[{"url":"http:\/\/siratek.net\/wp-content\/uploads\/2026\/11\/rtc-ds3231-wiring.svg","type":"","width":"","height":""}],"twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"8 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"http:\/\/siratek.net\/index.php\/tutorials\/rtc-ds3231\/","url":"http:\/\/siratek.net\/index.php\/tutorials\/rtc-ds3231\/","name":"Keeping Time with a DS3231 - siratek","isPartOf":{"@id":"https:\/\/siratek.net\/#website"},"primaryImageOfPage":{"@id":"http:\/\/siratek.net\/index.php\/tutorials\/rtc-ds3231\/#primaryimage"},"image":{"@id":"http:\/\/siratek.net\/index.php\/tutorials\/rtc-ds3231\/#primaryimage"},"thumbnailUrl":"http:\/\/siratek.net\/wp-content\/uploads\/2026\/11\/rtc-ds3231-wiring.svg","datePublished":"2026-11-01T10:50:59+00:00","breadcrumb":{"@id":"http:\/\/siratek.net\/index.php\/tutorials\/rtc-ds3231\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["http:\/\/siratek.net\/index.php\/tutorials\/rtc-ds3231\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"http:\/\/siratek.net\/index.php\/tutorials\/rtc-ds3231\/#primaryimage","url":"https:\/\/siratek.net\/wp-content\/uploads\/2026\/11\/rtc-ds3231-wiring.svg","contentUrl":"https:\/\/siratek.net\/wp-content\/uploads\/2026\/11\/rtc-ds3231-wiring.svg"},{"@type":"BreadcrumbList","@id":"http:\/\/siratek.net\/index.php\/tutorials\/rtc-ds3231\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/siratek.net\/"},{"@type":"ListItem","position":2,"name":"Tutorials","item":"https:\/\/siratek.net\/index.php\/tutorials\/"},{"@type":"ListItem","position":3,"name":"Keeping Time with a DS3231"}]},{"@type":"WebSite","@id":"https:\/\/siratek.net\/#website","url":"https:\/\/siratek.net\/","name":"siratek","description":"Your Best Electronic Retail Shop","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/siratek.net\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"}]}},"jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/siratek.net\/index.php\/wp-json\/wp\/v2\/siratek_tutorial\/52344","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/siratek.net\/index.php\/wp-json\/wp\/v2\/siratek_tutorial"}],"about":[{"href":"https:\/\/siratek.net\/index.php\/wp-json\/wp\/v2\/types\/siratek_tutorial"}],"version-history":[{"count":0,"href":"https:\/\/siratek.net\/index.php\/wp-json\/wp\/v2\/siratek_tutorial\/52344\/revisions"}],"wp:attachment":[{"href":"https:\/\/siratek.net\/index.php\/wp-json\/wp\/v2\/media?parent=52344"}],"wp:term":[{"taxonomy":"siratek_tutorial_level","embeddable":true,"href":"https:\/\/siratek.net\/index.php\/wp-json\/wp\/v2\/siratek_tutorial_level?post=52344"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}