# Ds1302

**Repository Path**: for2cyfeng/Ds1302

## Basic Information

- **Project Name**: Ds1302
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: AGPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-30
- **Last Updated**: 2026-06-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Ds1302

A C/C++ library to use DS1302 RTC chip. 

Tested with (but easily portable to your favourite MCU):

- [X] Arduino
- [X] ESP32 
- [X] ESP8266 

[![PlatformIO CI - main](https://github.com/Treboada/Ds1302/actions/workflows/platformio.yml/badge.svg?branch=master)](https://github.com/Treboada/Ds1302/actions/workflows/platformio.yml?query=branch%3Amaster)

Features:

- Simple to use and manage.
- Platformio compatible.
- Control of start/stop of the oscillator.
- Secure against edge time race conditions (see [#4][ISU02]).

## Examples

- [GetDateTime][EXA01]
- [SetDateTime][EXA02]

## License

This library is AGPL-3.0 licensed. See the [LICENSE][LIC01] file.

## Support

Bugs, feature requests, contributions are welcome: [Ds1302 issue tracker][ISU01].

[EXA01]: https://gitee.com/for2cyfeng/Ds1302/blob/master/examples/get-date-time/src/main.cpp
[EXA02]: https://gitee.com/for2cyfeng/Ds1302/tree/master/examples/set-date-time/src/main.cpp
[ISU01]: https://gitee.com/for2cyfeng/Ds1302/issues
[ISU02]: https://gitee.com/for2cyfeng/Ds1302/issues/4
[LIC01]: LICENSE

## Changelog

### 1.1.1

- Pipeline to compile and test the examples with Github actions

### 1.1.0

- Start and halt oscillator without setting current timestamp (thanks
  [@photomultiplier](https://github.com/Treboada/Ds1302/pull/9))

### 1.0.5

- Bugfix: wrong mask when reading the year register (thanks
  [@photomultiplier](https://github.com/Treboada/Ds1302/pull/8))

### 1.0.4

- Library added to the Arduino Library Manager (thanks
  [@jackjansen](https://github.com/Treboada/Ds1302/issues/2))

### 1.0.3

- Bugfix: error on consecutive reads (thanks Reinhard Kopka).

### 1.0.2

- Bugfix: unable to set date 31, dow 7 and month 12.
- Platformio environment for ESP8266.

### 1.0.1

- First version.