RaspberryPi:RTC - Revision history

CRNKEE002: /* Test the Software */

2020-02-06T10:38:18Z

Test the Software

CRNKEE002: /* Test the Hardware */

2020-02-06T10:32:09Z

Test the Hardware

CRNKEE002: /* Test the Hardware */

2020-02-06T10:31:56Z

Test the Hardware

CRNKEE002: Created page with "Category:RaspberryPi = RTC on the Pi = The Raspberry Pi can make use of a kernel driver to handle an RTC (Real time clock). This page was written for use with the MCP7940..."

2020-02-06T09:25:43Z

Created page with "Category:RaspberryPi = RTC on the Pi = The Raspberry Pi can make use of a kernel driver to handle an RTC (Real time clock). This page was written for use with the MCP7940..."

New page

[[Category:RaspberryPi]]
= RTC on the Pi =

The Raspberry Pi can make use of a kernel driver to handle an RTC (Real time clock). This page was written for use with the MCP7940 IC. Adaptations may be required for different RTC ICs.

The Pi doesn’t come with an RTC, and instead uses a daemon service called <code>fake-hwclock</code> to handle the time. But, seeing that we have an RTC, we can use that instead. And by supplying an external current (from, say a CR2032, a common coin cell battery for RTCs), we can hold the time even while the Raspberry Pi is off and doesn’t have internet access.

'''Note:''' This guide was tested on a fresh install of Raspbian Stretch, but should work fine on Buster, too.

= Build the Circuit =

<ol>
<li>Build the RTC circuit and connect it to your Pi</li>
<li>SSH in to your Pi</li>
<li>Run the following. We’re using the MCP7940, which means we expect a result at address <code>0x6f</code>
<pre>$ gpio i2cdetect</pre></li></ol>

= Configure the Pi =

<ol>
<li>Run the following:
<pre>$ touch rtc.sh
$ chmod +x rtc.sh</pre></li>
<li>Using your favourite text editor, place the following script into <code>rtc.sh</code> 
Take note when a red arrow appears below, you need to ensure that the text after the arrow is on the same line as the line above it (i.e. a red arrow just shows a line is split, the text should be on one line)
<pre>#!/bin/bash
# UniPi driver setup
# https://forum.unipi.technology/topic/171/mcp7491x-jessie/3
# Modified for the MCP7940x

if [ "$EUID" -ne 0 ]
then echo "This script must be run as root"
exit
fi

echo Backup files
cp /boot/config.txt /boot/config.txt.bak
echo Enabling I2C bus...

if ! grep -q '^dtparam=i2c_arm=on' /boot/config.txt
then echo 'dtparam=i2c_arm=on' >> /boot/config.txt
fi

if ! grep -q '^dtparam=i2c_baudrate=400000' /boot/config.txt
then echo 'dtparam=i2c_baudrate=400000' >> /boot/config.txt
fi
echo Enabling the RTC chip...
if ! grep -q '^dtoverlay=i2c-rtc,mcp7940x' /boot/config.txt
then echo 'dtoverlay=i2c-rtc,mcp7940x' >> /boot/config.txt
fi

echo Getting i2c development tools
apt-get install -y i2c-tools
if ! grep -q '^i2c-dev' /etc/modules
then echo 'i2c-dev' >> /etc/modules
fi

echo Removing fake-hwclock...
apt-get purge -y fake-hwclock
update-rc.d -f fake-hwclock remove
apt-get autoremove -y

sed -i '/^if \[ -e \/run\/systemd\/system/,/^fi/s/^/#/' /lib/udev/hwclock-set

echo ' '
echo 'UniPi installed.'
echo ' '
echo '!!! REBOOT IS REQUIRED !!!'
echo ' '

read -p "Is it OK to reboot now? [y/N] " -n 1 -r
echo ' '
if [[ $REPLY =~ ^[Yy]$ ]]
then
reboot
else
echo 'Reboot to finish configuring drivers'
fi
echo ' '
</pre></li>
<li>Run the script as sudo, as follows:
<pre>$ sudo ./rtc.sh</pre></li>
<li>The script will prompt you to reboot. Do so.</li></ol>

= Test the Hardware =

<ol>
<li>Once rebooted, SSH in to your Pi</li>
<li>Run the following. We’re using the MCP7940, which means we expect a result at address <code>0x6f</code>
<pre> $ gpio i2cdetect</pre></li>
<li>instead of the address “6f”, you should see “UU”
[[File:Figures/UU.PNG|frame|none|alt=|caption gpio i2cdetect showing the device at 0x6f is in use]]
</li></ol>

= Test the Software =

And now for the fun stuff:

<ol>
<li>Check if we can see the hwclock. Depending on whether or not you’re connected to the internet, you should see an arbitrary time
<pre>$ sudo hwclock -r</pre></li>
<li>Assuming you have internet connectivity, your Pi should fetch the time through NTP</li>
<li>Check the various times the Pi has access to:
<pre>$ timedatectl</pre>
Depending on whether or not you’ve connected to the internet, your results can look quite varied:
.5 [[File:Figures/RTCnoInternet.PNG|fig:]]
.5 [fig:rtcwint] [[File:Figures/RTCInternetNotSet.PNG|fig:]]</li>
<li>Connect your Pi to the internet and reboot so you can get the NTP time as shown in Figure [fig:rtcwint].</li>
<li>Set the System time to the RTC:
<pre>$ sudo hwclock -w
$ timedatectl</pre>
[[File:Figures/RTCset.PNG|frame|none|alt=|caption Once you’ve connected to the internet and set the RTC]]
</li></ol>

@@ Line 104: / Line 104: @@
 <li><p>Check the various times the Pi has access to:</p>
 <pre>$ timedatectl</pre>
-<p>Depending on whether or not you’ve connected to the internet, your results can look quite varied:</p>
+<p>Depending on whether or not you’ve connected to the internet, your results can look quite varied:</p></li>
-<p><span>.5</span> [[File:Figures/RTCnoInternet.PNG|fig:]]</p>
-<p><span>.5</span> [fig:rtcwint] [[File:Figures/RTCInternetNotSet.PNG|fig:]]</p></li>
+[[File:RTCnoInternet.png|thumb|none|RTC with time set and no internet connection]]
 <li><p>Connect your Pi to the internet and reboot so you can get the NTP time as shown in Figure [fig:rtcwint].</p></li>
 <li><p>Set the System time to the RTC:</p>
 <pre>$ sudo hwclock -w
 $ timedatectl</pre>
-[[File:Figures/RTCset.PNG|frame|none|alt=|caption Once you’ve connected to the internet and set the RTC<span data-label="fig:pinout"></span>]]
+[[File:RTCset.png|thumb|none|alt=|Once you’ve connected to the internet and set the RTC]]
 </li></ol>

@@ Line 91: / Line 91: @@
 <li><p>instead of the address “6f”, you should see “UU”</p>
-[[File:UU.PNG|thumb|none|alt=|gpio i2cdetect showing the device at 0x6f is in use]]
+[[File:UU.png|thumb|none|alt=|gpio i2cdetect showing the device at 0x6f is in use]]
 </li></ol>

@@ Line 90: / Line 90: @@
 <pre> $ gpio i2cdetect</pre></li>
 <li><p>instead of the address “6f”, you should see “UU”</p>
-[[File:Figures/UU.PNG|frame|none|alt=|caption gpio i2cdetect showing the device at 0x6f is in use<span data-label="fig:pinout"></span>]]
 </li></ol>