esp-idf-pcf8563

PCF8563 RTC Driver for esp-idf

Software requirements

ESP-IDF V5.0 or later.
ESP-IDF V4.4 release branch reached EOL in July 2024.
ESP-IDF V5.1 is required when using ESP32-C6.

Note for ESP-IDF V5.2.
A new i2c driver is now available in ESP-IDF V5.2.
Under ESP-IDF V5.2 or later, this project uses a new i2c driver.

Installation

git clone https://github.com/nopnop2002/esp-idf-pcf8563
cd esp-idf-pcf8563
idf.py menuconfig
idf.py flash

Wireing

PCF8563		ESP32	ESP32S2/S3/H2	ESP32Cn
SCL	--	GPIO22	GPIO02	GPIO06
SDA	--	GPIO21	GPIO01	GPIO05
GND	--	GND	GND	GND
VCC	--	3.3V	3.3V	3.3V

You can change GPIO using menuconfig.

Set Clock Mode

This mode set RTC initial value using NTP time Server.
you have to set these config value using menuconfig.

you have to set gpio & NTP Server using menuconfig.

Get Clock Mode

This mode take out the time from a RTC clock.
you have to change mode using menuconfig.

Get the time difference of NTP and RTC

This mode get time over NTP, and take out the time from a RTC clock.
Calculate time difference of NTP and RTC.
you have to change mode using menuconfig.

Time difference of 1 week later.

Time difference of 1 month later.

Comparison with other RTCs

This module has a large time lag.
I recommend the DS3231 RTC.
https://github.com/nopnop2002/esp-idf-ds3231

nopnop2002/esp-idf-pcf8563