![\"\"](\"http:\/\/msalamon.pl\/wp-content\/uploads\/2019\/09\/ds3231_clasic_crystal_accuracy.png\")
<\/a><\/figure>\n<\/div>\n\n\nAt an ambient temperature of about 0\u00b0C, the accuracy drops below -20 ppm. According to the calculator<\/a>, an error at this level results in a delay of 1.73 seconds\/day, i.e. 10.51 minutes\/year. Who wants to set the clock every month? It\u2019s less of a problem when the RTC has consistently similar conditions, such as in an apartment. Then you can save the day with software calibration. What if it\u2019s in an outdoor device? Let\u2019s say it\u2019s installed in winter in an info booth with a huge, heat-generating display. On a sunny winter day, when the booth is open, the temperature in the electronics compartment might hit 40\u00baC at the extreme, giving an error of about -10 ppm. As evening approaches, the system cools down slowly moving left along the characteristic. Nice, because the error decreases for a while. Unfortunately at night, when the device is asleep, the temperature drops to -5\u00baC and the oscillator accuracy is -30 ppm. Are we able to perfectly compensate such errors in software? Probably we can, but who would want to\u2026<\/p>\n\n\n\n Especially knowing that for little money you can get an RTC that compensates for such errors automatically. One of the precise chips on the market is the DS3231<\/a>.<\/p>\n\n\n\n <\/p>\n\n\n\n Mr. Mateusz, how accurate is \u201caccurate\u201d? According to the documentation<\/a> it is:<\/p>\n\n\n\n Entering 2 ppm into the calculator mentioned above shows that the DS3231<\/a> will be late by\u2026 a minute per year. Per day that\u2019s 0.17 seconds. Is that acceptable? Much more than 10 minutes per year! This is a very good result.<\/p>\n\n\n\n How is it so accurate? The Maxim chip has an integrated quartz oscillator together with the crystal. The oscillator also has temperature compensation. This allows the manufacturer to control all the most important components that determine accuracy. Thanks to compensation, they squeeze the absolute maximum out of them, resulting in those \u00b12 ppm. <\/p>\n\n\n\n In Poland, detailed tests of DS3231<\/a> compensation were carried out by Mirek Karda\u015b. Allow me not to roast a chip connected to an oscilloscope \ud83d\ude42<\/p>\n\n\n\n Besides accuracy, you may be interested in a few other things. The most important is probably how the chip connects to the microcontroller. The communication interface is I\u00b2C, so it\u2019s easy. In addition to the SDA and SCL pins, our RTC has a few other outputs.<\/p>\n\n\n\n As is typical with clock systems, we want the option to connect a battery to keep time. Here there is a dedicated pin, and inside the package there is a power-fail detection circuit and automatic switchover to battery power.<\/p>\n\n\n\n DS3231<\/a> has two clock outputs. One is 32.768 kHz straight from the built-in temperature-compensated oscillator and is called 32kHz<\/em><\/strong>. This source is perfect for clocking other circuits in low-power mode.<\/p>\n\n\n\n There is one more clock output. It is on a pin with a dual function called INT\/SQW<\/strong>. Here we can get one of four programmable frequencies: 1 Hz, 1024 Hz, 4096 Hz, or 8192 Hz. This is a suitably divided oscillator frequency.<\/p>\n\n\n\n The second function of the INT\/SQW<\/strong> pin, as the first part of the name suggests, is interrupts. According to the documentation, an interrupt is asserted when an alarm is active and its time arrives. Does anyone use alarms?<\/p>\n\n\n\n Importantly \u2013 both clock outputs are Open Drain<\/em>. You need to provide pull-up resistors, which fortunately are already placed on the PCB in ready-made modules.<\/p>\n\n\n\n How are time and date stored? Of course, there are registers for hours, minutes, and seconds. As for the calendar, it is fairly extensive. In addition to year, month, and day, there is day of the week, century, and leap year support.<\/p>\n\n\n\n Today I\u2019ll use a Nucleo<\/a> board with an STM32F410RB that I received from Kamami<\/strong>, for which I am very grateful! \ud83d\ude42<\/p>\n\n\n\n Connecting the module to the Nucleo<\/a> is, as usual, trivially simple. You only need to connect the I\u00b2C pins and the INT\/SQW pin for the RTC interrupt.<\/p>\n\n\n For the software I of course used STM32CubeIDE version 1.0.2. The HAL F4 libraries are version 1.24.1. Let\u2019s go!<\/p>\n\n\n\n I could show you the classic approach, i.e., crude, blocking reads from the RTC every so often in the main loop. A better solution would of course be to read in the RTC interrupt, which occurs every second. However, such a crude, blocking read in an interrupt is also not optimal\u2026<\/p>\n\n\n\n Remember that STM32 has something called DMA, of which I am a huge fan. You don\u2019t have to wait idly while I\u00b2C communication is taking place. DMA can handle data collection, and the CPU can later convert BCD to DEC. I\u2019ll show you a comparison at the end.<\/p>\n\n\n\n First, you need to configure the I\u00b2C interface. I chose I2C1.<\/em> Choose the interface speed. I recommend 400 kHz<\/strong>, especially since the DS3231<\/a> supports Fast Mode<\/em>. If your microcontroller cannot operate with that clock, the classic 100 kHz is fine. Use whichever pins you prefer. I set PB9<\/strong> and PB8<\/strong> because they are routed to the Arduino<\/em> connector. That way I can connect a logic analyzer to the Morpho<\/em> pins.<\/p>\n\n\n The next thing you need to set is DMA<\/strong> for our I2C1<\/em> interface. You can conveniently do this from the I\u00b2C configuration panel. Enable DMA for both receive and transmit. <\/p>\n\n\n To preview data from the RTC, also configure UART2<\/strong> in the classic way, which is routed to the ST-Link USB. I leave the standard values, i.e., 115200 8n1.<\/p>\n\n\n You will also need a pin to handle the interrupt from the DS3231<\/a> chip. You can set any GPIO to the GPIO_EXTI<\/strong> function. I chose the PA9<\/strong> pin. Name it DS3231_INT<\/strong> and set it to trigger on the falling edge. In practice it doesn\u2019t matter which edge you choose \ud83d\ude42 The important thing is to use one of the two so you don\u2019t read the same time twice unnecessarily. Also remember to enable the interrupt for the proper EXTI in CubeMX!<\/strong><\/p>\n\n\n\n You can leave the clock at the default 84 MHz if you generated the project \u201cfrom the board\u201d rather than by selecting the MCU. If you have it set differently, enter 84 for HCLK so our projects are consistent. After configuring the project like this, you can save it and generate the code. Also remember to select separate file generation for each peripheral.<\/p>\n\n\n\n I prepared a simple library for the DS3231<\/a>. It\u2019s not a masterpiece that supports every function of the chip. I skipped alarms and reading the chip\u2019s temperature (since there is temperature compensation, there is also the ability to measure temperature). I think the most important and useful part is reading the time and date anyway. <\/p>\n\n\n\n You\u2019ll be interested in one or two defines. These are #define DS3231_USE_DMA<\/strong> and #define DS3231_ADDRESS (0x68<<1)<\/strong>. The first, if uncommented, selects the function to read from the RTC via DMA. If it is commented out, it will work with the classic, blocking ones.<\/p>\n\n\n\n The second define is the chip address. The module without jumpers has address 0x68<\/strong>. If you have or placed jumpers, you will need to change this line according to your address.<\/p>\n\n\n\n Let\u2019s move on to the functions that interest you. The first is of course initialization<\/strong>.<\/p>\n\n\n\n You pass in the handler of the selected I\u00b2C interface. Inside the initialization I set a 1 Hz waveform on the SQW output and disable the 32 kHz output.<\/p>\n\n\n\n The next important function is setting the clock<\/strong>.<\/p>\n\n\n\n As an argument you pass a pointer to a previously prepared RTCDateTime<\/em> structure, which is defined in the DS3231<\/a> library.<\/p>\n\n\n\n The last important element is receiving data from the RTC<\/strong> and converting it into the RTCDateTime<\/em> structure. Depending on which type of handling you choose, for blocking\/interrupt-based you will have:<\/p>\n\n\n\n This function will fetch the data via I\u00b2C and store it in the variable pointed to by *DateTime.<\/em><\/p>\n\n\n\n And the most important ones from the DMA perspective. Functions that receive data and place it into the structure.<\/p>\n\n\n\n Why two? I\u2019ll explain.<\/p>\n\n\n\n I used the DS3231_ReceiveDateTimeDMA<\/strong> function in the EXTI interrupt generated by the RTC thanks to the 1 Hz signal on the SQW output. Its task is to start receiving from the DS3231<\/a> via DMA all the data related to time and date. Fortunately, RTC manufacturers place this data one after another.<\/p>\n\n\n\n When the reception is complete, a DMA reception complete interrupt is triggered. That\u2019s where I placed the DS3231_CalculateDateTime<\/strong> function to unpack the received data into time and date values. <\/p>\n\n\n\n That\u2019s all the philosophy \ud83d\ude42 How to use these functions in interrupts? You need to override the default _weak<\/em> functions provided by the HAL libraries. I did this in the main file, and it looks like this:<\/p>\n\n\n\n And that\u2019s it! Simple, right?<\/p>\n\n\n\n If this isn\u2019t your first time reading me, you know I like to check code execution times, especially CPU time. This time I won\u2019t let it slide either!<\/p>\n\n\n\n First, I\u2019ll show you what blocking data reception from the DS3231<\/a> looks like. First 100 kHz.<\/p>\n\n\n and 400 kHz<\/p>\n\n\n Hmm\u2026 920 \u00b5s and 237 \u00b5s. Given that this code runs exactly every second, it\u2019s easy to calculate that the read at 100 kHz takes 0.92% of CPU time, and for 400 kHz only 0.23%. Come on, Salamon, what more do you want from it?<\/p>\n\n\n\n <\/a>Notice that the CPU is idly waiting for the data to be received over I\u00b2C. This means there is still a small room for improvement thanks to DMA. The effect of my DMA code looks like this:<\/p>\n\n\n 100 kHz400 kHzNow there are two shorter segments during which the CPU is needed. The first is dispatching the DMA reception, the second is converting BCD to DEC and assigning to the struct variable. To calculate the CPU time, you need to sum them, which is simple. Thus, for 100 kHz the total is 301 \u00b5s, and for 400 kHz only 85 \u00b5s. Converted to % of CPU time, that\u2019s 0.3% and 0.08%, respectively.<\/p>\n\n\n\n In both cases we have about a 3x gain. Not bad, right? An operation like reading the time should be as little burden on the system as possible. After all, it has more serious things to do.<\/p>\n\n\n\n I hope that if you weren\u2019t already, you\u2019re now convinced of the high accuracy of the RTC clock that is the DS3231<\/a>. Although I feel that a comparison with other chips in terms of timekeeping accuracy would still be useful. I already have an idea \ud83d\ude42<\/p>\n\n\n\n Admit it too, I\u2019ve given you another reason to use DMA. Even in such \u2013 seemingly \u2013 trivial situations it\u2019s worth doing.<\/p>\n\n\n\n And what do you think about such an RTC?<\/strong> Is it worth buying one? Surprisingly, modules are sometimes cheaper than other, less accurate chips that need several additional components around them. Check out the RTC modules in my store<\/a>. By buying from me, you support the development of the blog and you get a cool sticker, e.g., for your laptop<\/strong> \ud83d\ude09<\/p>\n\n\n\n You\u2019ll find the full project along with the library on my GitHub as usual: link<\/a><\/p>\n\n\n\n If you noticed any error, disagree with something, would like to add something important, or simply want to discuss the topic, leave a comment. Remember that the discussion should be polite and in accordance with the rules of the Polish language.<\/span><\/p>\n\n\nDS3231 \u2013 an extremely accurate RTC<\/h1>\n\n\n
<\/a><\/figure>\n<\/div>\n\n\n\n
The most important things from the specification<\/h2>\n\n\n\n
Schematics and software<\/a><\/h2>\n\n\n\n
<\/a><\/figure>\n<\/div>\n\n\nConfiguring and handling DMA for the RTC<\/h3>\n\n\n\n
<\/a><\/figure>\n<\/div>\n\n\n<\/a><\/figure>\n<\/div>\n\n\n<\/a><\/figure>\n<\/div>\n\n\nCode<\/h3>\n\n\n\n
void DS3231_Init(I2C_HandleTypeDef *hi2c);<\/pre>\n\n\n\n
void DS3231_SetDateTime(RTCDateTime *DateTime);<\/pre>\n\n\n\n
typedef struct\n{\n\tuint16_t Year;\n\tuint8_t Month;\n\tuint8_t Day;\n\tuint8_t Hour;\n\tuint8_t Minute;\n\tuint8_t Second;\n\tuint8_t DayOfWeek;\n}RTCDateTime;\n<\/pre>\n\n\n\nvoid DS3231_GetDateTime(RTCDateTime *DateTime);<\/pre>\n\n\n\n
void DS3231_ReceiveDateTimeDMA(void);\nvoid DS3231_CalculateDateTime(RTCDateTime *DateTime);<\/pre>\n\n\n\n
DMA reception<\/h3>\n\n\n\n
\/* USER CODE BEGIN 4 *\/\nvoid HAL_GPIO_EXTI_Callback(uint16_t GPIO_Pin)\n{\n if(GPIO_Pin == DS3231_INT_Pin)\n {\n DS3231_ReceiveDateTimeDMA();\n }\n}\n\nvoid HAL_I2C_MemRxCpltCallback(I2C_HandleTypeDef *hi2c)\n{\n DS3231_CalculateDateTime(&r);\n}\n\/* USER CODE END 4 *\/<\/pre>\n\n\n\nResults, performance<\/h2>\n\n\n\n
<\/a><\/figure>\n<\/div>\n\n\n<\/a><\/figure>\n<\/div>\n\n\n<\/a><\/figure>\n<\/div>\n\n<\/a><\/figure>\n<\/div>\n\n\n<\/a><\/figure><\/h1>\n\n\n\nSummary<\/h2>\n\n\n\n