Difference between revisions of "RTC Cape"

From eLinux.org
Jump to: navigation, search
(update production photo)
(update design files & getting started guide)
Line 27: Line 27:
  
  
<!--
 
 
==Getting Started==
 
==Getting Started==
The instructions below are performed on Angstrom release 2013.09.04 (Linux beaglebone 3.8.13 #1 SMP Wed Sep 4 09:09:32 CEST 2013 armv7l GNU/Linux).
+
The instructions below are performed on Debian release 2014-05-14 (Linux beaglebone 3.8.13-bone50 #1 SMP Tue May 13 13:24:52 UTC 2014 armv7l GNU/Linux).
 
* Connect your BeagleBone Black to the internet, log in as root, download the device tree files and extract them to /lib/firmware of your BBB:
 
* Connect your BeagleBone Black to the internet, log in as root, download the device tree files and extract them to /lib/firmware of your BBB:
 
<code>
 
<code>
cd /lib/firmware
+
    cd /lib/firmware
 
+
    wget https://github.com/CircuitCo/RTC-Cape/raw/docs/BBB-RTC-01-00A1.tar.gz
wget http://elinux.org/images/e/e3/BBB-RTC-01-00A1.tar.gz
+
    tar xvzf BBB-RTC-01-00A1.tar.gz
 
 
tar xzvf BBB-RTC-01-00A1.tar.gz
 
 
</code>
 
</code>
  
Line 42: Line 39:
 
* Load the device tree overlay for your RTC Cape:
 
* Load the device tree overlay for your RTC Cape:
 
<code>
 
<code>
echo BBB-RTC-01:00A1 > /sys/devices/bone_capemgr*/slots
+
    echo BBB-RTC-01:00A1 > /sys/devices/bone_capemgr*/slots
 
</code>
 
</code>
  
  
* Check to ensure the overlay is loaded. In the messages below, the MCP79410 is registered as rtc1:
+
* Check to ensure the overlay is loaded. In the messages below, the DS1338 is registered as rtc1:
<code>dmesg | tail
+
<code>
<blockquote>
+
    dmesg | tail
: [ 2016.295415] bone-capemgr bone_capemgr.8: slot #10: 'Override Board Name,00A1,Override Manuf,BBB-RTC-01'
+
        [ 5721.844355] bone-capemgr bone_capemgr.9: slot #7: 'Override Board Name,00A1,Override Manuf,BBB-RTC-01'
: [ 2016.295721] bone-capemgr bone_capemgr.8: slot #10: Requesting part number/version based 'BBB-RTC-01-00A1.dtbo
+
        [ 5721.844607] bone-capemgr bone_capemgr.9: slot #7: Requesting part number/version based 'BBB-RTC-01-00A1.dtbo
: [ 2016.295777] bone-capemgr bone_capemgr.8: slot #10: Requesting firmware 'BBB-RTC-01-00A1.dtbo' for board-name 'Override Board Name', version '00A1'
+
        [ 5721.844656] bone-capemgr bone_capemgr.9: slot #7: Requesting firmware 'BBB-RTC-01-00A1.dtbo' for board-name 'Override Board Name', version '00A1'
: [ 2016.296256] bone-capemgr bone_capemgr.8: slot #10: dtbo 'BBB-RTC-01-00A1.dtbo' loaded; converting to live tree
+
        [ 5721.847380] bone-capemgr bone_capemgr.9: slot #7: dtbo 'BBB-RTC-01-00A1.dtbo' loaded; converting to live tree
: [ 2016.299751] bone-capemgr bone_capemgr.8: slot #10: #3 overlays
+
        [ 5721.848460] bone-capemgr bone_capemgr.9: slot #7: #3 overlays
: [ 2016.311744] omap_i2c 4802a000.i2c: bus 2 rev0.11 at 100 kHz
+
        [ 5721.860065] omap_i2c 4802a000.i2c: bus 2 rev0.11 at 100 kHz
: '''[ 2016.352020] rtc-ds1307 2-006f: rtc core: registered mcp7941x as rtc1'''
+
        [ 5721.902076] rtc-ds1307 2-0068: rtc core: registered ds1338 as rtc1
: [ 2016.352091] rtc-ds1307 2-006f: 64 bytes nvram
+
        [ 5721.902147] rtc-ds1307 2-0068: 56 bytes nvram
: [ 2016.352225] omap_i2c 4802a000.i2c: unable to select pin group
+
        [ 5721.902274] omap_i2c 4802a000.i2c: unable to select pin group
: [ 2016.352428] bone-capemgr bone_capemgr.8: slot #10: Applied #3 overlays.
+
        [ 5721.902468] bone-capemgr bone_capemgr.9: slot #7: Applied #3 overlays.
</blockquote>
 
 
</code>
 
</code>
  
Line 65: Line 61:
 
* Read the time from the RTC chip. It should look like something below since the time has not been set:
 
* Read the time from the RTC chip. It should look like something below since the time has not been set:
 
<code>
 
<code>
hwclock -r -f /dev/rtc1
+
    hwclock -r -f /dev/rtc1
<blockquote>
+
    Sat 01 Jan 2000 12:06:17 AM UTC -1.004531 seconds
: Mon Jan 1 00:00:02 2001 0.000000 seconds
 
</blockquote>
 
 
</code>
 
</code>
  
Line 74: Line 68:
 
* Update the system time of the BeagleBone Black (internet connection required) and write that to the RTC chip using hwclock command:
 
* Update the system time of the BeagleBone Black (internet connection required) and write that to the RTC chip using hwclock command:
 
<code>
 
<code>
ntpdate -b -s -u pool.ntp.org
+
    ntpdate -b -s -u pool.ntp.org
 
+
    hwclock -w -f /dev/rtc1
hwclock -w -f /dev/rtc1
 
 
</code>
 
</code>
  
Line 82: Line 75:
 
* Read the time again. This time it should have been updated.
 
* Read the time again. This time it should have been updated.
 
<code>
 
<code>
hwclock -r -f /dev/rtc1
+
    hwclock -r -f /dev/rtc1
<blockquote>
+
    Fri 16 May 2014 10:57:12 PM UTC -0.755959 seconds
: Fri Dec 13 22:51:56 2013 0.000000 seconds
 
</blockquote>
 
 
</code>
 
</code>
-->
+
 
  
  
Line 155: Line 146:
 
==Documentations==
 
==Documentations==
 
====RTC Cape Revision A1====
 
====RTC Cape Revision A1====
Design files will be posted when the boards are shipped.
+
* [https://github.com/CircuitCo/RTC-Cape/blob/rev_a1/RTC_Cape_A1_BOM.xlsx?raw=true Bill of Materials]
 +
* [https://github.com/CircuitCo/RTC-Cape/blob/rev_a1/RTC_Cape_A1_Gerbers.zip?raw=true Manufacturing Files]
 +
* [https://github.com/CircuitCo/RTC-Cape/blob/rev_a1/RTC_Cape_A1_Schematic.pdf?raw=true Schematic (PDF)]
 +
* [https://github.com/CircuitCo/RTC-Cape/blob/rev_a1/RTC_Cape_A1.sch Schematic (EAGLE)] (Right click and save as...)
 +
* [https://github.com/CircuitCo/RTC-Cape/blob/rev_a1/RTC_Cape_A1.brd PCB (EAGLE)] (Right click and save as...)
 +
To download all files at once please click [https://github.com/CircuitCo/RTC-Cape/archive/rev_a1.zip here]
 +
 
 +
 
 +
To go back to the cape list, please click [http://elinux.org/Beagleboard:BeagleBone_Capes here]

Revision as of 11:04, 4 June 2014

Descriptions

RTC Cape

The RTC Cape provides time tracking capability for the BeagleBone Black even when the power is lost. This cape features the DS1338 I2C-based real-time clock/calendar and a holder for a coin battery type CR2032. Setup, reading, and setting up time is easy with the provided device tree overlay.









Revision Changes

Revision A1

Initial release of RTC Cape.



Software Support & Compatibility

  • All revisions are compatible with BeagleBone and BeagleBone Black using 3.8 kernel.
  • Latest software for BeagleBone Black can be downloaded here.



Getting Started

The instructions below are performed on Debian release 2014-05-14 (Linux beaglebone 3.8.13-bone50 #1 SMP Tue May 13 13:24:52 UTC 2014 armv7l GNU/Linux).

  • Connect your BeagleBone Black to the internet, log in as root, download the device tree files and extract them to /lib/firmware of your BBB:

   cd /lib/firmware
   wget https://github.com/CircuitCo/RTC-Cape/raw/docs/BBB-RTC-01-00A1.tar.gz
   tar xvzf BBB-RTC-01-00A1.tar.gz


  • Load the device tree overlay for your RTC Cape:

   echo BBB-RTC-01:00A1 > /sys/devices/bone_capemgr*/slots


  • Check to ensure the overlay is loaded. In the messages below, the DS1338 is registered as rtc1:

   dmesg | tail
       [ 5721.844355] bone-capemgr bone_capemgr.9: slot #7: 'Override Board Name,00A1,Override Manuf,BBB-RTC-01'
       [ 5721.844607] bone-capemgr bone_capemgr.9: slot #7: Requesting part number/version based 'BBB-RTC-01-00A1.dtbo
       [ 5721.844656] bone-capemgr bone_capemgr.9: slot #7: Requesting firmware 'BBB-RTC-01-00A1.dtbo' for board-name 'Override Board Name', version '00A1'
       [ 5721.847380] bone-capemgr bone_capemgr.9: slot #7: dtbo 'BBB-RTC-01-00A1.dtbo' loaded; converting to live tree
       [ 5721.848460] bone-capemgr bone_capemgr.9: slot #7: #3 overlays
       [ 5721.860065] omap_i2c 4802a000.i2c: bus 2 rev0.11 at 100 kHz
       [ 5721.902076] rtc-ds1307 2-0068: rtc core: registered ds1338 as rtc1
       [ 5721.902147] rtc-ds1307 2-0068: 56 bytes nvram
       [ 5721.902274] omap_i2c 4802a000.i2c: unable to select pin group
       [ 5721.902468] bone-capemgr bone_capemgr.9: slot #7: Applied #3 overlays.


  • Read the time from the RTC chip. It should look like something below since the time has not been set:

   hwclock -r -f /dev/rtc1
   Sat 01 Jan 2000 12:06:17 AM UTC  -1.004531 seconds


  • Update the system time of the BeagleBone Black (internet connection required) and write that to the RTC chip using hwclock command:

   ntpdate -b -s -u pool.ntp.org
   hwclock -w -f /dev/rtc1


  • Read the time again. This time it should have been updated.

   hwclock -r -f /dev/rtc1
   Fri 16 May 2014 10:57:12 PM UTC  -0.755959 seconds



Helpful Links



Specifications

Followings are some specifications of the RTC Cape:

Mechanical Specifications

Size 2.15" x 2.825"
Layers 2
PCB Thickness .062"
RoHS Compliant Yes



Signal Usage

RTC Cape
Power VDD_3V3EXP
I2C I2C1_SCL
I2C1_SDA
Squarewave Output Pin GPIO1_29



Distributors

Please visit Where To Buy for a list of distributors who carry BeagleBoardToys' capes.



Product Images



Documentations

RTC Cape Revision A1

To download all files at once please click here


To go back to the cape list, please click here