{"id":5902,"date":"2024-01-31T19:53:28","date_gmt":"2024-01-31T14:23:28","guid":{"rendered":"https:\/\/electrocredible.com\/?p=5902"},"modified":"2024-03-23T18:17:26","modified_gmt":"2024-03-23T12:47:26","slug":"raspberry-pi-pico-rtc-ds1302-micropython","status":"publish","type":"post","link":"https:\/\/electrocredible.com\/raspberry-pi-pico-rtc-ds1302-micropython\/","title":{"rendered":"Raspberry Pi Pico RTC DS1302 Tutorial- MicroPython Code"},"content":{"rendered":"\n<p>This tutorial will guide you to interface the DS1302 RTC with Raspberry Pi Pico W using MicroPython code.<\/p>\n\n\n\n<p>A real-time clock or RTC is an integrated circuit that can keep time. It consumes very little power and can run for years on a coin battery. RTCs are an important part of everyday electronics and help to keep time even after a device is powered down. <\/p>\n\n\n\n<figure class=\"wp-block-image aligncenter size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"536\" src=\"https:\/\/electrocredible.com\/wp-content\/uploads\/2024\/01\/RASPBERRY-PI-PICO-RTC-GUIDE-1024x536.webp\" alt=\"\" class=\"wp-image-5997\" srcset=\"https:\/\/electrocredible.com\/wp-content\/uploads\/2024\/01\/RASPBERRY-PI-PICO-RTC-GUIDE-1024x536.webp 1024w, https:\/\/electrocredible.com\/wp-content\/uploads\/2024\/01\/RASPBERRY-PI-PICO-RTC-GUIDE-300x157.webp 300w, https:\/\/electrocredible.com\/wp-content\/uploads\/2024\/01\/RASPBERRY-PI-PICO-RTC-GUIDE-768x402.webp 768w, https:\/\/electrocredible.com\/wp-content\/uploads\/2024\/01\/RASPBERRY-PI-PICO-RTC-GUIDE.webp 1200w\" sizes=\"(max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<p>The RP2040 microcontroller that powers Raspberry Pi Pico features an inbuilt RTC. However, the development board does have the feature to power the RTC without powering the board.<\/p>\n\n\n\n<p>The inbuilt RTC resets on reboot and requires to be constantly powered to keep time. As Raspberry Pi Pico boards consume a few milliAmperes of current, it becomes impractical to use the inbuilt RTC in battery-powered projects. <\/p>\n\n\n\n<p><em>Related:<\/em> <a href=\"https:\/\/electrocredible.com\/power-raspberry-pi-pico-with-batteries\/\" target=\"_blank\" data-type=\"post\" data-id=\"4878\" rel=\"noreferrer noopener\">How to Power Raspberry Pi Pico with Batteries &#8211; Li-ion, 9V, 12V, AA, AAA Examples<\/a><\/p>\n\n\n\n<div id=\"ez-toc-container\" class=\"ez-toc-v2_0_65 counter-hierarchy ez-toc-counter ez-toc-custom ez-toc-container-direction\">\n<div class=\"ez-toc-title-container\">\n<p class=\"ez-toc-title \" >Table of Contents<\/p>\n<span class=\"ez-toc-title-toggle\"><a href=\"#\" class=\"ez-toc-pull-right ez-toc-btn ez-toc-btn-xs ez-toc-btn-default ez-toc-toggle\" aria-label=\"Toggle Table of Content\"><span class=\"ez-toc-js-icon-con\"><span class=\"\"><span class=\"eztoc-hide\" style=\"display:none;\">Toggle<\/span><span class=\"ez-toc-icon-toggle-span\"><svg style=\"fill: #000000;color:#000000\" xmlns=\"http:\/\/www.w3.org\/2000\/svg\" class=\"list-377408\" width=\"20px\" height=\"20px\" viewBox=\"0 0 24 24\" fill=\"none\"><path d=\"M6 6H4v2h2V6zm14 0H8v2h12V6zM4 11h2v2H4v-2zm16 0H8v2h12v-2zM4 16h2v2H4v-2zm16 0H8v2h12v-2z\" fill=\"currentColor\"><\/path><\/svg><svg style=\"fill: #000000;color:#000000\" class=\"arrow-unsorted-368013\" xmlns=\"http:\/\/www.w3.org\/2000\/svg\" width=\"10px\" height=\"10px\" viewBox=\"0 0 24 24\" version=\"1.2\" baseProfile=\"tiny\"><path d=\"M18.2 9.3l-6.2-6.3-6.2 6.3c-.2.2-.3.4-.3.7s.1.5.3.7c.2.2.4.3.7.3h11c.3 0 .5-.1.7-.3.2-.2.3-.5.3-.7s-.1-.5-.3-.7zM5.8 14.7l6.2 6.3 6.2-6.3c.2-.2.3-.5.3-.7s-.1-.5-.3-.7c-.2-.2-.4-.3-.7-.3h-11c-.3 0-.5.1-.7.3-.2.2-.3.5-.3.7s.1.5.3.7z\"\/><\/svg><\/span><\/span><\/span><\/a><\/span><\/div>\n<nav><ul class='ez-toc-list ez-toc-list-level-1 ' ><li class='ez-toc-page-1 ez-toc-heading-level-2'><a class=\"ez-toc-link ez-toc-heading-1\" href=\"https:\/\/electrocredible.com\/raspberry-pi-pico-rtc-ds1302-micropython\/#Prerequisites\" title=\"Prerequisites\">Prerequisites<\/a><ul class='ez-toc-list-level-3' ><li class='ez-toc-heading-level-3'><a class=\"ez-toc-link ez-toc-heading-2\" href=\"https:\/\/electrocredible.com\/raspberry-pi-pico-rtc-ds1302-micropython\/#Components_Required\" title=\"Components Required\">Components Required<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-3'><a class=\"ez-toc-link ez-toc-heading-3\" href=\"https:\/\/electrocredible.com\/raspberry-pi-pico-rtc-ds1302-micropython\/#Software_Setup\" title=\"Software Setup\">Software Setup<\/a><\/li><\/ul><\/li><li class='ez-toc-page-1 ez-toc-heading-level-2'><a class=\"ez-toc-link ez-toc-heading-4\" href=\"https:\/\/electrocredible.com\/raspberry-pi-pico-rtc-ds1302-micropython\/#The_DS1302_RTC\" title=\"The DS1302 RTC\">The DS1302 RTC<\/a><ul class='ez-toc-list-level-3' ><li class='ez-toc-heading-level-3'><a class=\"ez-toc-link ez-toc-heading-5\" href=\"https:\/\/electrocredible.com\/raspberry-pi-pico-rtc-ds1302-micropython\/#DS1302_Features\" title=\"DS1302 Features\">DS1302 Features<\/a><\/li><\/ul><\/li><li class='ez-toc-page-1 ez-toc-heading-level-2'><a class=\"ez-toc-link ez-toc-heading-6\" href=\"https:\/\/electrocredible.com\/raspberry-pi-pico-rtc-ds1302-micropython\/#Schematic_Raspberry_Pi_Pico_W_with_DS1302_RTC\" title=\"Schematic: Raspberry Pi Pico W with DS1302 RTC\">Schematic: Raspberry Pi Pico W with DS1302 RTC<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-2'><a class=\"ez-toc-link ez-toc-heading-7\" href=\"https:\/\/electrocredible.com\/raspberry-pi-pico-rtc-ds1302-micropython\/#DS1302_RTC_MicroPython_Library\" title=\"DS1302 RTC MicroPython Library \">DS1302 RTC MicroPython Library <\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-2'><a class=\"ez-toc-link ez-toc-heading-8\" href=\"https:\/\/electrocredible.com\/raspberry-pi-pico-rtc-ds1302-micropython\/#MicroPython_Code_to_Interface_DS1302_RTC_with_Raspberry_Pi_Pico\" title=\"MicroPython Code to Interface DS1302 RTC with Raspberry Pi Pico\">MicroPython Code to Interface DS1302 RTC with Raspberry Pi Pico<\/a><ul class='ez-toc-list-level-3' ><li class='ez-toc-heading-level-3'><a class=\"ez-toc-link ez-toc-heading-9\" href=\"https:\/\/electrocredible.com\/raspberry-pi-pico-rtc-ds1302-micropython\/#Set_RTC\" title=\"Set RTC\">Set RTC<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-3'><a class=\"ez-toc-link ez-toc-heading-10\" href=\"https:\/\/electrocredible.com\/raspberry-pi-pico-rtc-ds1302-micropython\/#Read_RTC\" title=\"Read RTC\">Read RTC<\/a><\/li><\/ul><\/li><li class='ez-toc-page-1 ez-toc-heading-level-2'><a class=\"ez-toc-link ez-toc-heading-11\" href=\"https:\/\/electrocredible.com\/raspberry-pi-pico-rtc-ds1302-micropython\/#MicroPython_Functions_for_DS1302_RTC\" title=\"MicroPython Functions for DS1302 RTC\">MicroPython Functions for DS1302 RTC<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-2'><a class=\"ez-toc-link ez-toc-heading-12\" href=\"https:\/\/electrocredible.com\/raspberry-pi-pico-rtc-ds1302-micropython\/#Demonstration\" title=\"Demonstration\">Demonstration<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-2'><a class=\"ez-toc-link ez-toc-heading-13\" href=\"https:\/\/electrocredible.com\/raspberry-pi-pico-rtc-ds1302-micropython\/#Conclusion\" title=\"Conclusion\">Conclusion<\/a><\/li><\/ul><\/nav><\/div>\n<h2 class=\"wp-block-heading\"><span class=\"ez-toc-section\" id=\"Prerequisites\"><\/span>Prerequisites<span class=\"ez-toc-section-end\"><\/span><\/h2>\n\n\n\n<h3 class=\"wp-block-heading\"><span class=\"ez-toc-section\" id=\"Components_Required\"><\/span>Components Required<span class=\"ez-toc-section-end\"><\/span><\/h3>\n\n\n\n<ol>\n<li>Raspberry Pi Pico or Pico W<\/li>\n\n\n\n<li>DS1302 RTC module<\/li>\n\n\n\n<li>Breadboard and connecting wires<\/li>\n<\/ol>\n\n\n\n<h3 class=\"wp-block-heading\"><span class=\"ez-toc-section\" id=\"Software_Setup\"><\/span>Software Setup<span class=\"ez-toc-section-end\"><\/span><\/h3>\n\n\n\n<p>Your Raspberry Pi Pico must be preloaded with a<a href=\"https:\/\/micropython.org\/download\/\" target=\"_blank\" rel=\"noreferrer noopener\"> MicroPython UF2<\/a> file to program it in MicroPython. You can read our<a href=\"https:\/\/electrocredible.com\/raspberry-pi-pico-tutorial-for-beginners\/\" target=\"_blank\" rel=\"noreferrer noopener\"> getting started guide for Raspberry Pi Pico<\/a> where we show all the steps required to start programming Raspberry Pi Pico &amp; Pico W.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\"><span class=\"ez-toc-section\" id=\"The_DS1302_RTC\"><\/span>The DS1302 RTC<span class=\"ez-toc-section-end\"><\/span><\/h2>\n\n\n\n<p>The DS1302 is a trickle charge timekeeping chip that counts minutes, hours, dates, months, days of the week, and year with lead leap-year compensation valid up to 2100. It is available in an 8-pin DIP package. <\/p>\n\n\n\n<p>The chip requires an external 32.768kHz quartz crystal oscillator and a coin battery(CR2032). It is commonly available as a breakout board module, as shown below.<\/p>\n\n\n\n<figure class=\"wp-block-image aligncenter size-full\"><img loading=\"lazy\" decoding=\"async\" width=\"700\" height=\"520\" src=\"https:\/\/electrocredible.com\/wp-content\/uploads\/2024\/01\/DS302-RTC-MODULE.webp\" alt=\"\" class=\"wp-image-5965\" srcset=\"https:\/\/electrocredible.com\/wp-content\/uploads\/2024\/01\/DS302-RTC-MODULE.webp 700w, https:\/\/electrocredible.com\/wp-content\/uploads\/2024\/01\/DS302-RTC-MODULE-300x223.webp 300w\" sizes=\"(max-width: 700px) 100vw, 700px\" \/><figcaption class=\"wp-element-caption\">DS1302 breakout board (MH-Real-Time Clock Modules-2)<\/figcaption><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\"><span class=\"ez-toc-section\" id=\"DS1302_Features\"><\/span>DS1302 Features<span class=\"ez-toc-section-end\"><\/span><\/h3>\n\n\n\n<figure class=\"wp-block-table is-style-stripes\"><table><tbody><tr><td class=\"has-text-align-center\" data-align=\"center\">Operating Voltage-<\/td><td>2V-5.5V<\/td><\/tr><tr><td class=\"has-text-align-center\" data-align=\"center\">Current consumption-<\/td><td>Less than 300nA at 2V<\/td><\/tr><tr><td class=\"has-text-align-center\" data-align=\"center\">Internal memory-<\/td><td>31 x 8 bytes static RAM(battery-backed)<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h2 class=\"wp-block-heading\"><span class=\"ez-toc-section\" id=\"Schematic_Raspberry_Pi_Pico_W_with_DS1302_RTC\"><\/span>Schematic: Raspberry Pi Pico W with DS1302 RTC<span class=\"ez-toc-section-end\"><\/span><\/h2>\n\n\n\n<figure class=\"wp-block-image aligncenter size-full\"><img loading=\"lazy\" decoding=\"async\" width=\"800\" height=\"542\" src=\"https:\/\/electrocredible.com\/wp-content\/uploads\/2024\/01\/schematic-raspberry-pi-pico-with-ds1302-RTC.webp\" alt=\"\" class=\"wp-image-5966\" srcset=\"https:\/\/electrocredible.com\/wp-content\/uploads\/2024\/01\/schematic-raspberry-pi-pico-with-ds1302-RTC.webp 800w, https:\/\/electrocredible.com\/wp-content\/uploads\/2024\/01\/schematic-raspberry-pi-pico-with-ds1302-RTC-300x203.webp 300w, https:\/\/electrocredible.com\/wp-content\/uploads\/2024\/01\/schematic-raspberry-pi-pico-with-ds1302-RTC-768x520.webp 768w\" sizes=\"(max-width: 800px) 100vw, 800px\" \/><figcaption class=\"wp-element-caption\">Schematic of DS1302 RTC module with Raspberry Pi Pico<\/figcaption><\/figure>\n\n\n\n<p>Connect Raspberry Pi Pico W to DS1302 as shown in the schematic above. You can use any of the ground pins in Pico. You can also use other GPIOs. Learn more about the GPIOs in our article &#8211; <a href=\"https:\/\/electrocredible.com\/raspberry-pi-pico-w-pinout-guide-diagrams\/\" data-type=\"post\" data-id=\"3493\">Raspberry Pi Pico &amp; Pico W Pinout Guide<\/a>.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\"><span class=\"ez-toc-section\" id=\"DS1302_RTC_MicroPython_Library\"><\/span>DS1302 RTC MicroPython Library <span class=\"ez-toc-section-end\"><\/span><\/h2>\n\n\n\n<p>To interface the DS1302 RTC, we shall use a MicroPython library or driver. The library is hosted in this <a href=\"https:\/\/github.com\/omarbenhamid\/micropython-ds1302-rtc\/tree\/master\" target=\"_blank\" rel=\"noreferrer noopener nofollow\">Github link<\/a>. <\/p>\n\n\n\n<p>Here is the procedure to save the library using Thonny IDE.<\/p>\n\n\n\n<p>1. Connect Raspberry Pi Pico to your computer using a USB cable. Open Thonny IDE and set the interpreter to use MicroPython on Raspberry Pi Pico.<\/p>\n\n\n\n<figure class=\"wp-block-image aligncenter size-full\"><img loading=\"lazy\" decoding=\"async\" width=\"835\" height=\"523\" src=\"https:\/\/electrocredible.com\/wp-content\/uploads\/2023\/12\/Thonny-IDE-select-interpreter-as-MicroPython-Raspberry-Pi-Pico.webp\" alt=\"Thonny IDE select interpreter as MicroPython Raspberry Pi Pico\" class=\"wp-image-5532\" srcset=\"https:\/\/electrocredible.com\/wp-content\/uploads\/2023\/12\/Thonny-IDE-select-interpreter-as-MicroPython-Raspberry-Pi-Pico.webp 835w, https:\/\/electrocredible.com\/wp-content\/uploads\/2023\/12\/Thonny-IDE-select-interpreter-as-MicroPython-Raspberry-Pi-Pico-300x188.webp 300w, https:\/\/electrocredible.com\/wp-content\/uploads\/2023\/12\/Thonny-IDE-select-interpreter-as-MicroPython-Raspberry-Pi-Pico-768x481.webp 768w\" sizes=\"(max-width: 835px) 100vw, 835px\" \/><\/figure>\n\n\n\n<p>2. Go to <strong>File<\/strong>&gt;<strong>New<\/strong> in Thonny IDE to create a new project.&nbsp;<\/p>\n\n\n\n<p>3. Paste the following code into the new project.<\/p>\n\n\n<pre class=\"wp-block-code\" aria-describedby=\"shcb-language-2\" data-shcb-language-name=\"Python\" data-shcb-language-slug=\"python\"><span><code class=\"hljs language-python\"><span class=\"hljs-keyword\">from<\/span> machine <span class=\"hljs-keyword\">import<\/span> Pin\n\nDS1302_REG_SECOND = (<span class=\"hljs-number\">0x80<\/span>)\nDS1302_REG_MINUTE = (<span class=\"hljs-number\">0x82<\/span>)\nDS1302_REG_HOUR   = (<span class=\"hljs-number\">0x84<\/span>)\nDS1302_REG_DAY    = (<span class=\"hljs-number\">0x86<\/span>)\nDS1302_REG_MONTH  = (<span class=\"hljs-number\">0x88<\/span>)\nDS1302_REG_WEEKDAY= (<span class=\"hljs-number\">0x8A<\/span>)\nDS1302_REG_YEAR   = (<span class=\"hljs-number\">0x8C<\/span>)\nDS1302_REG_WP     = (<span class=\"hljs-number\">0x8E<\/span>)\nDS1302_REG_CTRL   = (<span class=\"hljs-number\">0x90<\/span>)\nDS1302_REG_RAM    = (<span class=\"hljs-number\">0xC0<\/span>)\n\n<span class=\"hljs-class\"><span class=\"hljs-keyword\">class<\/span> <span class=\"hljs-title\">DS1302<\/span>:<\/span>\n    <span class=\"hljs-function\"><span class=\"hljs-keyword\">def<\/span> <span class=\"hljs-title\">__init__<\/span><span class=\"hljs-params\">(self, clk, dio, cs)<\/span>:<\/span>\n        self.clk = clk\n        self.dio = dio\n        self.cs = cs\n        self.clk.init(Pin.OUT)\n        self.cs.init(Pin.OUT)\n\n    <span class=\"hljs-function\"><span class=\"hljs-keyword\">def<\/span> <span class=\"hljs-title\">_dec2hex<\/span><span class=\"hljs-params\">(self, dat)<\/span>:<\/span>\n        <span class=\"hljs-keyword\">return<\/span> (dat\/\/<span class=\"hljs-number\">10<\/span>) * <span class=\"hljs-number\">16<\/span> + (dat % <span class=\"hljs-number\">10<\/span>)\n\n    <span class=\"hljs-function\"><span class=\"hljs-keyword\">def<\/span> <span class=\"hljs-title\">_hex2dec<\/span><span class=\"hljs-params\">(self, dat)<\/span>:<\/span>\n        <span class=\"hljs-keyword\">return<\/span> (dat\/\/<span class=\"hljs-number\">16<\/span>) * <span class=\"hljs-number\">10<\/span> + (dat % <span class=\"hljs-number\">16<\/span>)\n\n    <span class=\"hljs-function\"><span class=\"hljs-keyword\">def<\/span> <span class=\"hljs-title\">_write_byte<\/span><span class=\"hljs-params\">(self, dat)<\/span>:<\/span>\n        self.dio.init(Pin.OUT)\n        <span class=\"hljs-keyword\">for<\/span> i <span class=\"hljs-keyword\">in<\/span> range(<span class=\"hljs-number\">8<\/span>):\n            self.dio.value((dat &gt;&gt; i) &amp; <span class=\"hljs-number\">1<\/span>)\n            self.clk.value(<span class=\"hljs-number\">1<\/span>)\n            self.clk.value(<span class=\"hljs-number\">0<\/span>)\n\n    <span class=\"hljs-function\"><span class=\"hljs-keyword\">def<\/span> <span class=\"hljs-title\">_read_byte<\/span><span class=\"hljs-params\">(self)<\/span>:<\/span>\n        d = <span class=\"hljs-number\">0<\/span>\n        self.dio.init(Pin.IN)\n        <span class=\"hljs-keyword\">for<\/span> i <span class=\"hljs-keyword\">in<\/span> range(<span class=\"hljs-number\">8<\/span>):\n            d = d | (self.dio.value() &lt;&lt; i)\n            self.clk.value(<span class=\"hljs-number\">1<\/span>)\n            self.clk.value(<span class=\"hljs-number\">0<\/span>)\n        <span class=\"hljs-keyword\">return<\/span> d\n\n    <span class=\"hljs-function\"><span class=\"hljs-keyword\">def<\/span> <span class=\"hljs-title\">_get_reg<\/span><span class=\"hljs-params\">(self, reg)<\/span>:<\/span>\n        self.cs.value(<span class=\"hljs-number\">1<\/span>)\n        self._write_byte(reg)\n        t = self._read_byte()\n        self.cs.value(<span class=\"hljs-number\">0<\/span>)\n        <span class=\"hljs-keyword\">return<\/span> t\n\n    <span class=\"hljs-function\"><span class=\"hljs-keyword\">def<\/span> <span class=\"hljs-title\">_set_reg<\/span><span class=\"hljs-params\">(self, reg, dat)<\/span>:<\/span>\n        self.cs.value(<span class=\"hljs-number\">1<\/span>)\n        self._write_byte(reg)\n        self._write_byte(dat)\n        self.cs.value(<span class=\"hljs-number\">0<\/span>)\n\n    <span class=\"hljs-function\"><span class=\"hljs-keyword\">def<\/span> <span class=\"hljs-title\">_wr<\/span><span class=\"hljs-params\">(self, reg, dat)<\/span>:<\/span>\n        self._set_reg(DS1302_REG_WP, <span class=\"hljs-number\">0<\/span>)\n        self._set_reg(reg, dat)\n        self._set_reg(DS1302_REG_WP, <span class=\"hljs-number\">0x80<\/span>)\n\n    <span class=\"hljs-function\"><span class=\"hljs-keyword\">def<\/span> <span class=\"hljs-title\">start<\/span><span class=\"hljs-params\">(self)<\/span>:<\/span>\n        t = self._get_reg(DS1302_REG_SECOND + <span class=\"hljs-number\">1<\/span>)\n        self._wr(DS1302_REG_SECOND, t &amp; <span class=\"hljs-number\">0x7f<\/span>)\n\n    <span class=\"hljs-function\"><span class=\"hljs-keyword\">def<\/span> <span class=\"hljs-title\">stop<\/span><span class=\"hljs-params\">(self)<\/span>:<\/span>\n        t = self._get_reg(DS1302_REG_SECOND + <span class=\"hljs-number\">1<\/span>)\n        self._wr(DS1302_REG_SECOND, t | <span class=\"hljs-number\">0x80<\/span>)\n\n    <span class=\"hljs-function\"><span class=\"hljs-keyword\">def<\/span> <span class=\"hljs-title\">second<\/span><span class=\"hljs-params\">(self, second=None)<\/span>:<\/span>\n        <span class=\"hljs-keyword\">if<\/span> second == <span class=\"hljs-literal\">None<\/span>:\n            <span class=\"hljs-keyword\">return<\/span> self._hex2dec(self._get_reg(DS1302_REG_SECOND+<span class=\"hljs-number\">1<\/span>)) % <span class=\"hljs-number\">60<\/span>\n        <span class=\"hljs-keyword\">else<\/span>:\n            self._wr(DS1302_REG_SECOND, self._dec2hex(second % <span class=\"hljs-number\">60<\/span>))\n\n    <span class=\"hljs-function\"><span class=\"hljs-keyword\">def<\/span> <span class=\"hljs-title\">minute<\/span><span class=\"hljs-params\">(self, minute=None)<\/span>:<\/span>\n        <span class=\"hljs-keyword\">if<\/span> minute == <span class=\"hljs-literal\">None<\/span>:\n            <span class=\"hljs-keyword\">return<\/span> self._hex2dec(self._get_reg(DS1302_REG_MINUTE+<span class=\"hljs-number\">1<\/span>))\n        <span class=\"hljs-keyword\">else<\/span>:\n            self._wr(DS1302_REG_MINUTE, self._dec2hex(minute % <span class=\"hljs-number\">60<\/span>))\n\n    <span class=\"hljs-function\"><span class=\"hljs-keyword\">def<\/span> <span class=\"hljs-title\">hour<\/span><span class=\"hljs-params\">(self, hour=None)<\/span>:<\/span>\n        <span class=\"hljs-keyword\">if<\/span> hour == <span class=\"hljs-literal\">None<\/span>:\n            <span class=\"hljs-keyword\">return<\/span> self._hex2dec(self._get_reg(DS1302_REG_HOUR+<span class=\"hljs-number\">1<\/span>))\n        <span class=\"hljs-keyword\">else<\/span>:\n            self._wr(DS1302_REG_HOUR, self._dec2hex(hour % <span class=\"hljs-number\">24<\/span>))\n\n    <span class=\"hljs-function\"><span class=\"hljs-keyword\">def<\/span> <span class=\"hljs-title\">weekday<\/span><span class=\"hljs-params\">(self, weekday=None)<\/span>:<\/span>\n        <span class=\"hljs-keyword\">if<\/span> weekday == <span class=\"hljs-literal\">None<\/span>:\n            <span class=\"hljs-keyword\">return<\/span> self._hex2dec(self._get_reg(DS1302_REG_WEEKDAY+<span class=\"hljs-number\">1<\/span>))\n        <span class=\"hljs-keyword\">else<\/span>:\n            self._wr(DS1302_REG_WEEKDAY, self._dec2hex(weekday % <span class=\"hljs-number\">8<\/span>))\n\n    <span class=\"hljs-function\"><span class=\"hljs-keyword\">def<\/span> <span class=\"hljs-title\">day<\/span><span class=\"hljs-params\">(self, day=None)<\/span>:<\/span>\n        <span class=\"hljs-keyword\">if<\/span> day == <span class=\"hljs-literal\">None<\/span>:\n            <span class=\"hljs-keyword\">return<\/span> self._hex2dec(self._get_reg(DS1302_REG_DAY+<span class=\"hljs-number\">1<\/span>))\n        <span class=\"hljs-keyword\">else<\/span>:\n            self._wr(DS1302_REG_DAY, self._dec2hex(day % <span class=\"hljs-number\">32<\/span>))\n\n    <span class=\"hljs-function\"><span class=\"hljs-keyword\">def<\/span> <span class=\"hljs-title\">month<\/span><span class=\"hljs-params\">(self, month=None)<\/span>:<\/span>\n        <span class=\"hljs-keyword\">if<\/span> month == <span class=\"hljs-literal\">None<\/span>:\n            <span class=\"hljs-keyword\">return<\/span> self._hex2dec(self._get_reg(DS1302_REG_MONTH+<span class=\"hljs-number\">1<\/span>))\n        <span class=\"hljs-keyword\">else<\/span>:\n            self._wr(DS1302_REG_MONTH, self._dec2hex(month % <span class=\"hljs-number\">13<\/span>))\n\n    <span class=\"hljs-function\"><span class=\"hljs-keyword\">def<\/span> <span class=\"hljs-title\">year<\/span><span class=\"hljs-params\">(self, year=None)<\/span>:<\/span>\n        <span class=\"hljs-keyword\">if<\/span> year == <span class=\"hljs-literal\">None<\/span>:\n            <span class=\"hljs-keyword\">return<\/span> self._hex2dec(self._get_reg(DS1302_REG_YEAR+<span class=\"hljs-number\">1<\/span>)) + <span class=\"hljs-number\">2000<\/span>\n        <span class=\"hljs-keyword\">else<\/span>:\n            self._wr(DS1302_REG_YEAR, self._dec2hex(year % <span class=\"hljs-number\">100<\/span>))\n\n    <span class=\"hljs-function\"><span class=\"hljs-keyword\">def<\/span> <span class=\"hljs-title\">date_time<\/span><span class=\"hljs-params\">(self, dat=None)<\/span>:<\/span>\n        <span class=\"hljs-keyword\">if<\/span> dat == <span class=\"hljs-literal\">None<\/span>:\n            <span class=\"hljs-keyword\">return<\/span> &#91;self.year(), self.month(), self.day(), self.weekday(), self.hour(), self.minute(), self.second()]\n        <span class=\"hljs-keyword\">else<\/span>:\n            self.year(dat&#91;<span class=\"hljs-number\">0<\/span>])\n            self.month(dat&#91;<span class=\"hljs-number\">1<\/span>])\n            self.day(dat&#91;<span class=\"hljs-number\">2<\/span>])\n            self.weekday(dat&#91;<span class=\"hljs-number\">3<\/span>])\n            self.hour(dat&#91;<span class=\"hljs-number\">4<\/span>])\n            self.minute(dat&#91;<span class=\"hljs-number\">5<\/span>])\n            self.second(dat&#91;<span class=\"hljs-number\">6<\/span>])\n\n    <span class=\"hljs-function\"><span class=\"hljs-keyword\">def<\/span> <span class=\"hljs-title\">ram<\/span><span class=\"hljs-params\">(self, reg, dat=None)<\/span>:<\/span>\n        <span class=\"hljs-keyword\">if<\/span> dat == <span class=\"hljs-literal\">None<\/span>:\n            <span class=\"hljs-keyword\">return<\/span> self._get_reg(DS1302_REG_RAM + <span class=\"hljs-number\">1<\/span> + (reg % <span class=\"hljs-number\">31<\/span>)*<span class=\"hljs-number\">2<\/span>)\n        <span class=\"hljs-keyword\">else<\/span>:\n            self._wr(DS1302_REG_RAM + (reg % <span class=\"hljs-number\">31<\/span>)*<span class=\"hljs-number\">2<\/span>, dat)\n<\/code><\/span><small class=\"shcb-language\" id=\"shcb-language-2\"><span class=\"shcb-language__label\">Code language:<\/span> <span class=\"shcb-language__name\">Python<\/span> <span class=\"shcb-language__paren\">(<\/span><span class=\"shcb-language__slug\">python<\/span><span class=\"shcb-language__paren\">)<\/span><\/small><\/pre>\n\n\n<p>4. Click on <strong>File<\/strong>&gt;<strong>Save as<\/strong> and select the save location as Raspberry Pi Pico.<\/p>\n\n\n\n<figure class=\"wp-block-image aligncenter size-full\"><img loading=\"lazy\" decoding=\"async\" width=\"312\" height=\"268\" src=\"https:\/\/electrocredible.com\/wp-content\/uploads\/2022\/06\/save-to.webp\" alt=\"Thonny Save to\" class=\"wp-image-379\" srcset=\"https:\/\/electrocredible.com\/wp-content\/uploads\/2022\/06\/save-to.webp 312w, https:\/\/electrocredible.com\/wp-content\/uploads\/2022\/06\/save-to-300x258.webp 300w\" sizes=\"(max-width: 312px) 100vw, 312px\" \/><\/figure>\n\n\n\n<p>5. Set the filename as <strong>ds1302.py<\/strong>.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\"><span class=\"ez-toc-section\" id=\"MicroPython_Code_to_Interface_DS1302_RTC_with_Raspberry_Pi_Pico\"><\/span>MicroPython Code to Interface DS1302 RTC with Raspberry Pi Pico<span class=\"ez-toc-section-end\"><\/span><\/h2>\n\n\n\n<p>With the library for DS1302 installed, we can now upload MicroPython code to read\/write DS1302 using Raspberry Pi Pico W. <\/p>\n\n\n\n<p>Code for two operations shall be explained:<\/p>\n\n\n\n<ul>\n<li>Initially, set the year, month, day, hour, minute, and seconds in the static RAM of DS1302.<\/li>\n\n\n\n<li>Retrieve the data from the RTC that was saved in the step above.<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\"><span class=\"ez-toc-section\" id=\"Set_RTC\"><\/span>Set RTC<span class=\"ez-toc-section-end\"><\/span><\/h3>\n\n\n\n<p>The following MicroPython code will write data to RTC:<\/p>\n\n\n<pre class=\"wp-block-code\" aria-describedby=\"shcb-language-3\" data-shcb-language-name=\"Python\" data-shcb-language-slug=\"python\"><span><code class=\"hljs language-python\"><span class=\"hljs-comment\"># Import necessary modules<\/span>\n<span class=\"hljs-keyword\">from<\/span> machine <span class=\"hljs-keyword\">import<\/span> Pin\n<span class=\"hljs-keyword\">import<\/span> ds1302\n\n<span class=\"hljs-comment\"># Initialize DS1302 RTC with specified pins (clk, dio, cs)<\/span>\nds = ds1302.DS1302(Pin(<span class=\"hljs-number\">0<\/span>),Pin(<span class=\"hljs-number\">1<\/span>),Pin(<span class=\"hljs-number\">2<\/span>))\n\n<span class=\"hljs-comment\"># Set the date and time on the RTC<\/span>\nds.year(<span class=\"hljs-number\">2085<\/span>)  <span class=\"hljs-comment\"># Set the year to 2085<\/span>\nds.month(<span class=\"hljs-number\">1<\/span>)    <span class=\"hljs-comment\"># Set the month to January<\/span>\nds.day(<span class=\"hljs-number\">17<\/span>)     <span class=\"hljs-comment\"># Set the day to 17th<\/span>\nds.hour(<span class=\"hljs-number\">00<\/span>)    <span class=\"hljs-comment\"># Set the hour to midnight (00)<\/span>\nds.minute(<span class=\"hljs-number\">17<\/span>)  <span class=\"hljs-comment\"># Set the minute to 17<\/span>\nds.second(<span class=\"hljs-number\">30<\/span>)  <span class=\"hljs-comment\"># Set the second to 30<\/span>\n\n<span class=\"hljs-comment\"># Print the date and time<\/span>\nprint( <span class=\"hljs-string\">\"Date={}\/{}\/{}\"<\/span> .format(ds.month(), ds.day(),ds.year()) )\nprint( <span class=\"hljs-string\">\"Time={}:{}:{}\"<\/span> .format(ds.hour(), ds.minute(),ds.second()) )\n<\/code><\/span><small class=\"shcb-language\" id=\"shcb-language-3\"><span class=\"shcb-language__label\">Code language:<\/span> <span class=\"shcb-language__name\">Python<\/span> <span class=\"shcb-language__paren\">(<\/span><span class=\"shcb-language__slug\">python<\/span><span class=\"shcb-language__paren\">)<\/span><\/small><\/pre>\n\n\n<p>Change <code>ds.year(2085)<\/code> to the year you want to set. Follow similar logic for the next lines to set the month, day, etc.<\/p>\n\n\n\n<p>Save the code to Raspberry Pi Pico. Name the file as <strong>main.py<\/strong> or any other name with a &#8216;.py&#8217; filename extension.<\/p>\n\n\n\n<p>Run the code by clicking on the Run icon or press <strong>F5<\/strong>.<\/p>\n\n\n\n<figure class=\"wp-block-image aligncenter size-full\"><img loading=\"lazy\" decoding=\"async\" width=\"785\" height=\"285\" src=\"https:\/\/electrocredible.com\/wp-content\/uploads\/2022\/05\/run-button-Thonny-1.webp\" alt=\"run-button-Thonny-1\" class=\"wp-image-176\" srcset=\"https:\/\/electrocredible.com\/wp-content\/uploads\/2022\/05\/run-button-Thonny-1.webp 785w, https:\/\/electrocredible.com\/wp-content\/uploads\/2022\/05\/run-button-Thonny-1-300x109.webp 300w, https:\/\/electrocredible.com\/wp-content\/uploads\/2022\/05\/run-button-Thonny-1-768x279.webp 768w\" sizes=\"(max-width: 785px) 100vw, 785px\" \/><\/figure>\n\n\n\n<p>When the code runs, the shell of the IDE will print the date in <strong>MM-DD-YYYY<\/strong> format and the time in <strong>HH:MM:SS<\/strong>. It should match the date and time that you specified in the code.<\/p>\n\n\n\n<figure class=\"wp-block-image aligncenter size-full\"><img loading=\"lazy\" decoding=\"async\" width=\"800\" height=\"367\" src=\"https:\/\/electrocredible.com\/wp-content\/uploads\/2024\/01\/DS1302-RTC-Thonny-output.webp\" alt=\"\" class=\"wp-image-5967\" srcset=\"https:\/\/electrocredible.com\/wp-content\/uploads\/2024\/01\/DS1302-RTC-Thonny-output.webp 800w, https:\/\/electrocredible.com\/wp-content\/uploads\/2024\/01\/DS1302-RTC-Thonny-output-300x138.webp 300w, https:\/\/electrocredible.com\/wp-content\/uploads\/2024\/01\/DS1302-RTC-Thonny-output-768x352.webp 768w\" sizes=\"(max-width: 800px) 100vw, 800px\" \/><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\"><span class=\"ez-toc-section\" id=\"Read_RTC\"><\/span>Read RTC<span class=\"ez-toc-section-end\"><\/span><\/h3>\n\n\n\n<p>Read the DS1302 RTC using the following MicroPython code. The code is similar to the code used to set the RTC, with a few lines removed.<\/p>\n\n\n<pre class=\"wp-block-code\" aria-describedby=\"shcb-language-4\" data-shcb-language-name=\"Python\" data-shcb-language-slug=\"python\"><span><code class=\"hljs language-python\"><span class=\"hljs-keyword\">from<\/span> machine <span class=\"hljs-keyword\">import<\/span> Pin\n<span class=\"hljs-keyword\">import<\/span> ds1302\n\nds = ds1302.DS1302(Pin(<span class=\"hljs-number\">0<\/span>),Pin(<span class=\"hljs-number\">1<\/span>),Pin(<span class=\"hljs-number\">2<\/span>)) <span class=\"hljs-comment\">#(clk, dio, cs)<\/span>\n\nprint( <span class=\"hljs-string\">\"Date={}\/{}\/{}\"<\/span> .format(ds.month(), ds.day(),ds.year()) )\nprint( <span class=\"hljs-string\">\"Time={}:{}:{}\"<\/span> .format(ds.hour(), ds.minute(),ds.second()) )<\/code><\/span><small class=\"shcb-language\" id=\"shcb-language-4\"><span class=\"shcb-language__label\">Code language:<\/span> <span class=\"shcb-language__name\">Python<\/span> <span class=\"shcb-language__paren\">(<\/span><span class=\"shcb-language__slug\">python<\/span><span class=\"shcb-language__paren\">)<\/span><\/small><\/pre>\n\n\n<p>Save the code to Raspberry Pi Pico. Name the file as <strong>main.py<\/strong> or any other name with a &#8216;.py&#8217; filename extension.<\/p>\n\n\n\n<p>Run the code. You should see the output data in the shell of Thonny IDE similar to the screenshot shown in the earlier section.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\"><span class=\"ez-toc-section\" id=\"MicroPython_Functions_for_DS1302_RTC\"><\/span>MicroPython Functions for DS1302 RTC<span class=\"ez-toc-section-end\"><\/span><\/h2>\n\n\n\n<p>Here are some additional MicroPythons functions for the DS1302 RTC, assuming that the <code>ds<\/code> object has been created for the <code>DS1302<\/code> class.<\/p>\n\n\n\n<ul>\n<li><code>ds.start()<\/code>: start the RTC.<\/li>\n\n\n\n<li><code>ds.stop()<\/code>: stop or pause the RTC.<\/li>\n\n\n\n<li><code>ds.date_time()<\/code>: Gets or sets the date and time. If no parameters are given, it will return the current date and time, otherwise, it will set the DateTime.<br>DateTime format: [Year, month, day, weekday, hour, minute, second].<\/li>\n\n\n\n<li><code>ds.ram()<\/code>: Get \/ set ram data (31 bytes).<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\"><span class=\"ez-toc-section\" id=\"Demonstration\"><\/span>Demonstration<span class=\"ez-toc-section-end\"><\/span><\/h2>\n\n\n\n<figure class=\"wp-block-image aligncenter size-full\"><img loading=\"lazy\" decoding=\"async\" width=\"800\" height=\"517\" src=\"https:\/\/electrocredible.com\/wp-content\/uploads\/2024\/01\/Raspberry-Pi-Pico-W-with-DS1302-RTC-schematic.webp\" alt=\"\" class=\"wp-image-5968\" srcset=\"https:\/\/electrocredible.com\/wp-content\/uploads\/2024\/01\/Raspberry-Pi-Pico-W-with-DS1302-RTC-schematic.webp 800w, https:\/\/electrocredible.com\/wp-content\/uploads\/2024\/01\/Raspberry-Pi-Pico-W-with-DS1302-RTC-schematic-300x194.webp 300w, https:\/\/electrocredible.com\/wp-content\/uploads\/2024\/01\/Raspberry-Pi-Pico-W-with-DS1302-RTC-schematic-768x496.webp 768w\" sizes=\"(max-width: 800px) 100vw, 800px\" \/><figcaption class=\"wp-element-caption\">Raspberry Pi Pico W with DS1302 RTC on a breadboard<\/figcaption><\/figure>\n\n\n\n<p>The DS1302 RTC will store the data as long as it is powered. If you do not have battery power, the RTC will store data till it is powered externally using Raspberry Pi Pico&#8217;s 3.3V power output pin.<\/p>\n\n\n\n<p>When power is removed, the date resets to 1\/1\/2000 and the time resets to 00:00:00.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\"><span class=\"ez-toc-section\" id=\"Conclusion\"><\/span>Conclusion<span class=\"ez-toc-section-end\"><\/span><\/h2>\n\n\n\n<p>This Raspberry Pi Pico RTC interfacing guide used MicroPython code to set and read the DS1302 RTC. You can use the information here to make a clock using LCD, OLED, or 7-segment displays.<\/p>\n\n\n\n<p class=\"mynote-yellow\">\u24d8 DS2321 is a more accurate RTC alternative to DS1302. Read our article: <a href=\"https:\/\/electrocredible.com\/ds3231-raspberry-pi-pico-micropython-arduino\/\" data-type=\"post\" data-id=\"6600\" target=\"_blank\" rel=\"noreferrer noopener\">Interface DS3231 With Raspberry Pi Pico-MicroPython\/Arduino Code<\/a>.<\/p>\n\n\n\n<p>These guides will help you to make a digital clock by combining RTC with a display:<\/p>\n\n\n\n<ul>\n<li><a href=\"https:\/\/electrocredible.com\/raspberry-pi-pico-lcd-16x2-i2c-pcf8574-micropython\/\" target=\"_blank\" data-type=\"post\" data-id=\"672\" rel=\"noreferrer noopener\">Raspberry Pi Pico LCD (I2C) Interfacing Using MicroPython<\/a><\/li>\n\n\n\n<li><a href=\"https:\/\/electrocredible.com\/raspberry-pi-pico-tm1637-7-segment-display-4-digit\/\" target=\"_blank\" data-type=\"post\" data-id=\"3065\" rel=\"noreferrer noopener\">Raspberry Pi Pico W with TM1637 7-Segment Display<\/a><\/li>\n\n\n\n<li><a href=\"https:\/\/electrocredible.com\/raspberry-pi-pico-oled-display-interfacing-tutorial\/\" data-type=\"post\" data-id=\"358\" target=\"_blank\" rel=\"noreferrer noopener\">Raspberry Pi Pico With SSD1306 OLED Display<\/a><\/li>\n\n\n\n<li><a href=\"https:\/\/electrocredible.com\/7-segment-display-with-raspberry-pi-pico\/\" target=\"_blank\" data-type=\"post\" data-id=\"2887\" rel=\"noreferrer noopener\">Interface 7-Segment Display with Raspberry Pi Pico using MicroPython<\/a><\/li>\n<\/ul>\n","protected":false},"excerpt":{"rendered":"<p>This tutorial will guide you to interface the DS1302 RTC with Raspberry Pi Pico W using MicroPython code. A real-time clock or RTC is an integrated circuit that can keep time. It consumes very little power and can run for years on a coin battery. RTCs are an important part of everyday electronics and help [&hellip;]<\/p>\n","protected":false},"author":2,"featured_media":5997,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_uag_custom_page_level_css":"","footnotes":""},"categories":[11],"tags":[8],"uagb_featured_image_src":{"full":["https:\/\/electrocredible.com\/wp-content\/uploads\/2024\/01\/RASPBERRY-PI-PICO-RTC-GUIDE.webp",1200,628,false],"thumbnail":["https:\/\/electrocredible.com\/wp-content\/uploads\/2024\/01\/RASPBERRY-PI-PICO-RTC-GUIDE-150x150.webp",150,150,true],"medium":["https:\/\/electrocredible.com\/wp-content\/uploads\/2024\/01\/RASPBERRY-PI-PICO-RTC-GUIDE-300x157.webp",300,157,true],"medium_large":["https:\/\/electrocredible.com\/wp-content\/uploads\/2024\/01\/RASPBERRY-PI-PICO-RTC-GUIDE-768x402.webp",768,402,true],"large":["https:\/\/electrocredible.com\/wp-content\/uploads\/2024\/01\/RASPBERRY-PI-PICO-RTC-GUIDE-1024x536.webp",1024,536,true],"1536x1536":["https:\/\/electrocredible.com\/wp-content\/uploads\/2024\/01\/RASPBERRY-PI-PICO-RTC-GUIDE.webp",1200,628,false],"2048x2048":["https:\/\/electrocredible.com\/wp-content\/uploads\/2024\/01\/RASPBERRY-PI-PICO-RTC-GUIDE.webp",1200,628,false]},"uagb_author_info":{"display_name":"Abhilekh Das","author_link":"https:\/\/electrocredible.com\/author\/abhilekh-2\/"},"uagb_comment_info":1,"uagb_excerpt":"This tutorial will guide you to interface the DS1302 RTC with Raspberry Pi Pico W using MicroPython code. A real-time clock or RTC is an integrated circuit that can keep time. It consumes very little power and can run for years on a coin battery. RTCs are an important part of everyday electronics and help&hellip;","_links":{"self":[{"href":"https:\/\/electrocredible.com\/wp-json\/wp\/v2\/posts\/5902"}],"collection":[{"href":"https:\/\/electrocredible.com\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/electrocredible.com\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/electrocredible.com\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/electrocredible.com\/wp-json\/wp\/v2\/comments?post=5902"}],"version-history":[{"count":40,"href":"https:\/\/electrocredible.com\/wp-json\/wp\/v2\/posts\/5902\/revisions"}],"predecessor-version":[{"id":6682,"href":"https:\/\/electrocredible.com\/wp-json\/wp\/v2\/posts\/5902\/revisions\/6682"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/electrocredible.com\/wp-json\/wp\/v2\/media\/5997"}],"wp:attachment":[{"href":"https:\/\/electrocredible.com\/wp-json\/wp\/v2\/media?parent=5902"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/electrocredible.com\/wp-json\/wp\/v2\/categories?post=5902"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/electrocredible.com\/wp-json\/wp\/v2\/tags?post=5902"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}