Unit DS1307 - Revision history

Ultibo at 02:35, 19 November 2025

2025-11-19T02:35:35Z

Ultibo at 04:26, 10 June 2025

2025-06-10T04:26:06Z

Ultibo at 04:11, 24 April 2018

2018-04-24T04:11:46Z

Ultibo at 01:35, 20 April 2017

2017-04-20T01:35:38Z

Ultibo at 04:02, 13 April 2017

2017-04-13T04:02:51Z

Ultibo at 04:04, 24 March 2017

2017-03-24T04:04:05Z

Ultibo at 02:18, 18 January 2017

2017-01-18T02:18:31Z

Ultibo at 02:42, 30 December 2016

2016-12-30T02:42:40Z

Ultibo at 05:44, 19 December 2016

2016-12-19T05:44:56Z

Ultibo at 03:38, 9 December 2016

2016-12-09T03:38:03Z

Show changes

@@ Line 405: / Line 405: @@
 <div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 0px; padding-bottom: 15px;">
 <pre style="border: 0; padding-bottom:0px;">procedure DS1307Init;</pre>
-<div style="font-size: 14px; padding-left: 12px;">'''Description:''' To be documented</div>
+<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Initialize the DS1307 unit and parameters</div>
 <div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
 ! Note
-| None documented
+| Called only during system startup
 |-
 |}

@@ Line 411: / Line 411: @@
 ! Note
 | None documented
 |-
 |}

@@ Line 409: / Line 409: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 424: / Line 424: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
-| Not intended to be called directly by applications, use RTCDeviceStart instead
+| Not intended to be called directly by applications, use RTCDeviceStart instead.
 |-
 |}
@@ Line 436: / Line 436: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
-| Not intended to be called directly by applications, use RTCDeviceStop instead
+| Not intended to be called directly by applications, use RTCDeviceStop instead.
 |-
 |}
@@ Line 448: / Line 448: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
-| Not intended to be called directly by applications, use RTCDeviceGetTime instead
+| Not intended to be called directly by applications, use RTCDeviceGetTime instead.
 |-
 |}
@@ Line 460: / Line 460: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
-| Not intended to be called directly by applications, use RTCDeviceSetTime instead
+| Not intended to be called directly by applications, use RTCDeviceSetTime instead.
 |-
 |}
@@ Line 475: / Line 475: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 487: / Line 487: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 499: / Line 499: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 511: / Line 511: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 523: / Line 523: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 535: / Line 535: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 547: / Line 547: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 559: / Line 559: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-
@@ Line 571: / Line 571: @@
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
-! '''Note'''
+! Note
 | None documented
 |-

@@ Line 420: / Line 420: @@
 <div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 0px; padding-bottom: 15px;">
 <pre style="border: 0; padding-bottom:0px;">function DS1307RTCStart(RTC:PRTCDevice):LongWord;</pre>
-<div style="font-size: 14px; padding-left: 12px;">'''Description:''' To be documented</div>
+<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Implementation of RTCDeviceStart API for DS1307 RTC</div>
 <div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
 ! '''Note'''
-| None documented
+| Not intended to be called directly by applications, use RTCDeviceStart instead
 |-
 |}
@@ Line 432: / Line 432: @@
 <div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 0px; padding-bottom: 15px;">
 <pre style="border: 0; padding-bottom:0px;">function DS1307RTCStop(RTC:PRTCDevice):LongWord;</pre>
-<div style="font-size: 14px; padding-left: 12px;">'''Description:''' To be documented</div>
+<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Implementation of RTCDeviceStop API for DS1307 RTC</div>
 <div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
 ! '''Note'''
-| None documented
+| Not intended to be called directly by applications, use RTCDeviceStop instead
 |-
 |}
@@ Line 444: / Line 444: @@
 <div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 0px; padding-bottom: 15px;">
 <pre style="border: 0; padding-bottom:0px;">function DS1307RTCGetTime(RTC:PRTCDevice):Int64;</pre>
-<div style="font-size: 14px; padding-left: 12px;">'''Description:''' To be documented</div>
+<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Implementation of RTCDeviceGetTime API for DS1307 RTC</div>
 <div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
 ! '''Note'''
-| None documented
+| Not intended to be called directly by applications, use RTCDeviceGetTime instead
 |-
 |}
@@ Line 456: / Line 456: @@
 <div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 0px; padding-bottom: 15px;">
 <pre style="border: 0; padding-bottom:0px;">function DS1307RTCSetTime(RTC:PRTCDevice; const Time:Int64):Int64;</pre>
-<div style="font-size: 14px; padding-left: 12px;">'''Description:''' To be documented</div>
+<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Implementation of RTCDeviceSetTime API for DS1307 RTC</div>
 <div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
 {| class="wikitable" style="font-size: 14px; background: white;"
 |-
 ! '''Note'''
-| None documented
+| Not intended to be called directly by applications, use RTCDeviceSetTime instead
 |-
 |}

@@ Line 139: / Line 139: @@
 |-
 | <code>DS1307_REG_SECONDS_CH = $80;</code>
-| Clock Halt bit (1 to Disable / 0 to Enable the clock)
+| Clock Halt bit (1 to Disable/0 to Enable the clock)
 |-
 | <code>DS1340_REG_SECONDS_nEOSC = $80;</code>
@@ Line 145: / Line 145: @@
 |-
 | <code>MCP794XX_REG_SECONDS_ST = $80;</code>
-| Clock Stop Bit (1 to Enable / 0 to Disable the clock)
+| Clock Stop Bit (1 to Enable/0 to Disable the clock)
 |-
 |}
@@ Line 156: / Line 156: @@
 |-
 | <code>DS1307_REG_HOUR_12HR = $40;</code>
-| 12/24 hour bit (1 = 12 hour mode / 0 = 24 hour mode)
+| 12/24 hour bit (1 = 12 hour mode/0 = 24 hour mode)
 |-
 | <code>DS1307_REG_HOUR_PM = $20;</code>
-| AM/PM bit (1 = PM / 0 = AM) (Only in 12 hour mode)
+| AM/PM bit (1 = PM/0 = AM) (Only in 12 hour mode)
 |-
 | <code>DS1340_REG_HOUR_CENTURY_EN = $80;</code>
@@ Line 176: / Line 176: @@
 |-
 | <code>MCP794XX_REG_WEEKDAY_VBATEN = $08;</code>
-| Battery Backup Enabled (1 to Enable / 0 to Disable)
+| Battery Backup Enabled (1 to Enable/0 to Disable)
 |-
 |}

@@ Line 35: / Line 35: @@
 <br />
 <div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 20px; padding-bottom: 15px;">
-<div style="font-size: 14px; padding-left: 12px;">'''DS1307 chip constants''' <code> DS1307_CHIP_* </code></div>
+<div style="font-size: 14px; padding-left: 12px;">'''DS1307 chip''' <code> DS1307_CHIP_* </code></div>
 <div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
 {| class="wikitable" style="font-size: 14px; background: white;"
@@ Line 73: / Line 73: @@
 <br />
 <div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 20px; padding-bottom: 15px;">
-<div style="font-size: 14px; padding-left: 12px;">'''DS1307 RTC register constants''' <code> DS1307_REG_* </code></div>
+<div style="font-size: 14px; padding-left: 12px;">'''DS1307 RTC register''' <code> DS1307_REG_* </code></div>
 <div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
 {| class="wikitable" style="font-size: 14px; background: white;"
@@ Line 102: / Line 102: @@
 <br />
 <div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 20px; padding-bottom: 15px;">
-<div style="font-size: 14px; padding-left: 12px;">'''DS1307 control and status register constants''' <code> DS1307_REG_* </code></div>
+<div style="font-size: 14px; padding-left: 12px;">'''DS1307 control and status register''' <code> DS1307_REG_* </code></div>
 <div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
 {| class="wikitable" style="font-size: 14px; background: white;"
@@ Line 134: / Line 134: @@
 <br />
 <div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 20px; padding-bottom: 15px;">
-<div style="font-size: 14px; padding-left: 12px;">'''DS1307 seconds register constants''' <code> DS1307_REG_SECONDS_* </code></div>
+<div style="font-size: 14px; padding-left: 12px;">'''DS1307 seconds register''' <code> DS1307_REG_SECONDS_* </code></div>
 <div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
 {| class="wikitable" style="font-size: 14px; background: white;"
@@ Line 151: / Line 151: @@
 <br />
 <div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 20px; padding-bottom: 15px;">
-<div style="font-size: 14px; padding-left: 12px;">'''DS1307 hour register constants''' <code> DS1307_REG_HOUR_* </code></div>
+<div style="font-size: 14px; padding-left: 12px;">'''DS1307 hour register''' <code> DS1307_REG_HOUR_* </code></div>
 <div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
 {| class="wikitable" style="font-size: 14px; background: white;"
@@ Line 171: / Line 171: @@
 <br />
 <div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 20px; padding-bottom: 15px;">
-<div style="font-size: 14px; padding-left: 12px;">'''MCP794XX weekday register constants''' <code> MCP794XX_REG_WEEKDAY_* </code></div>
+<div style="font-size: 14px; padding-left: 12px;">'''MCP794XX weekday register''' <code> MCP794XX_REG_WEEKDAY_* </code></div>
 <div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
 {| class="wikitable" style="font-size: 14px; background: white;"
@@ Line 182: / Line 182: @@
 <br />
 <div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 20px; padding-bottom: 15px;">
-<div style="font-size: 14px; padding-left: 12px;">'''DS1337 month register constants''' <code> DS1337_REG_MONTH_* </code></div>
+<div style="font-size: 14px; padding-left: 12px;">'''DS1337 month register''' <code> DS1337_REG_MONTH_* </code></div>
 <div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
 {| class="wikitable" style="font-size: 14px; background: white;"
@@ Line 193: / Line 193: @@
 <br />
 <div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 20px; padding-bottom: 15px;">
-<div style="font-size: 14px; padding-left: 12px;">'''DS1307 control register constants''' <code> DS1307_REG_CONTROL_* </code></div>
+<div style="font-size: 14px; padding-left: 12px;">'''DS1307 control register''' <code> DS1307_REG_CONTROL_* </code></div>
 <div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
 {| class="wikitable" style="font-size: 14px; background: white;"
@@ Line 216: / Line 216: @@
 <br />
 <div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 20px; padding-bottom: 15px;">
-<div style="font-size: 14px; padding-left: 12px;">'''DS1337 control register constants''' <code> DS1337_REG_CONTROL_* </code></div>
+<div style="font-size: 14px; padding-left: 12px;">'''DS1337 control register''' <code> DS1337_REG_CONTROL_* </code></div>
 <div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
 {| class="wikitable" style="font-size: 14px; background: white;"
@@ Line 248: / Line 248: @@
 <br />
 <div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 20px; padding-bottom: 15px;">
-<div style="font-size: 14px; padding-left: 12px;">'''DS1340 control register constants''' <code> DS1340_REG_CONTROL_* </code></div>
+<div style="font-size: 14px; padding-left: 12px;">'''DS1340 control register''' <code> DS1340_REG_CONTROL_* </code></div>
 <div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
 {| class="wikitable" style="font-size: 14px; background: white;"
@@ Line 268: / Line 268: @@
 <br />
 <div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 20px; padding-bottom: 15px;">
-<div style="font-size: 14px; padding-left: 12px;">'''DS1340 flag register constants''' <code> DS1340_REG_FLAG_* </code></div>
+<div style="font-size: 14px; padding-left: 12px;">'''DS1340 flag register''' <code> DS1340_REG_FLAG_* </code></div>
 <div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
 {| class="wikitable" style="font-size: 14px; background: white;"
@@ Line 279: / Line 279: @@
 <br />
 <div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 20px; padding-bottom: 15px;">
-<div style="font-size: 14px; padding-left: 12px;">'''DS1337 status register constants''' <code> DS1337_REG_STATUS_* </code></div>
+<div style="font-size: 14px; padding-left: 12px;">'''DS1337 status register''' <code> DS1337_REG_STATUS_* </code></div>
 <div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
 {| class="wikitable" style="font-size: 14px; background: white;"
@@ Line 296: / Line 296: @@
 <br />
 <div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 20px; padding-bottom: 15px;">
-<div style="font-size: 14px; padding-left: 12px;">'''RX8025 control1 register constants''' <code> RX8025_REG_CONTROL1_* </code></div>
+<div style="font-size: 14px; padding-left: 12px;">'''RX8025 control1 register''' <code> RX8025_REG_CONTROL1_* </code></div>
 <div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
 {| class="wikitable" style="font-size: 14px; background: white;"
@@ Line 307: / Line 307: @@
 <br />
 <div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 20px; padding-bottom: 15px;">
-<div style="font-size: 14px; padding-left: 12px;">'''RX8025 control2 register constants''' <code> RX8025_REG_CONTROL2_* </code></div>
+<div style="font-size: 14px; padding-left: 12px;">'''RX8025 control2 register''' <code> RX8025_REG_CONTROL2_* </code></div>
 <div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
 {| class="wikitable" style="font-size: 14px; background: white;"

@@ Line 327: / Line 327: @@
 ----
-''To be documented''
 === Public variables ===

@@ Line 332: / Line 332: @@
 ----
-''To be documented''
+''None defined''
 === Function declarations ===

@@ Line 4: / Line 4: @@
 === Description ===
 ----
 The Maxim DS1307 is an I2C interface, battery backed real time clock chip with full BCD clock and calendar and 56 bytes of software accessible NVRAM. The chip supports 12 or 24 hour format and is widely used in low cost RTC devices available from a range of suppliers.