feat(pcf85063): Add espp::Pcf85063 peripheral for PCF85063 RTC (#476)

* feat(pcf85063): Add `espp::Pcf85063` peripheral for PCF85063 RTC

* add image to readme

Author: finger563

.github/workflows/build.yml

@@ -142,6 +142,8 @@ jobs:
           target: esp32s3
         - path: 'components/nvs/example'
           target: esp32s3
+        - path: 'components/pcf85063/example'
+          target: esp32s3
         - path: 'components/pid/example'
           target: esp32
         - path: 'components/qmi8658/example'

.github/workflows/upload_components.yml

@@ -89,6 +89,7 @@ jobs:
             components/neopixel
             components/nvs
             components/pid
+            components/pcf85063
             components/qmi8658
             components/qtpy
             components/qwiicnes

components/bm8563/CMakeLists.txt

@@ -1,4 +1,4 @@
 idf_component_register(
   INCLUDE_DIRS "include"
-  REQUIRES "base_peripheral"
+  REQUIRES "base_peripheral" "utils"
   )

components/bm8563/example/main/bm8563_example.cpp

@@ -22,11 +22,8 @@ extern "C" void app_main(void) {
     });
     // now make the bm8563
     auto bm8563 = espp::Bm8563({
-        .write = std::bind(&espp::I2c::write, &i2c, std::placeholders::_1, std::placeholders::_2,
-                           std::placeholders::_3),
-        .write_then_read =
-            std::bind(&espp::I2c::write_read, &i2c, std::placeholders::_1, std::placeholders::_2,
-                      std::placeholders::_3, std::placeholders::_4, std::placeholders::_5),
+        .write = std::bind_front(&espp::I2c::write, &i2c),
+        .write_then_read = std::bind_front(&espp::I2c::write_read, &i2c),
     });
 
     std::error_code ec;

components/bm8563/idf_component.yml

@@ -17,3 +17,4 @@ dependencies:
   idf:
     version: '>=5.0'
   espp/base_peripheral: '>=1.0'
+  espp/utils: '>=1.0'

components/bm8563/include/bm8563.hpp

@@ -3,6 +3,7 @@
 #include <functional>
 
 #include "base_peripheral.hpp"
+#include "espp_chrono.hpp"
 
 namespace espp {
 /// @brief The BM8563 RTC driver.
@@ -75,8 +76,8 @@ class Bm8563 : public BasePeripheral<> {
 
   /// @brief The configuration structure.
   struct Config {
-    BasePeripheral::write_fn write;                     ///< The I2C write function.
-    BasePeripheral::write_then_read_fn write_then_read; ///< The I2C write then read function.
+    BasePeripheral<>::write_fn write;                     ///< The I2C write function.
+    BasePeripheral<>::write_then_read_fn write_then_read; ///< The I2C write then read function.
     espp::Logger::Verbosity log_level{
         espp::Logger::Verbosity::WARN}; ///< Log verbosity for the input driver.
   };
@@ -95,16 +96,6 @@ class Bm8563 : public BasePeripheral<> {
     }
   }
 
-  /// @brief Convert a BCD value to a byte.
-  /// @param value The BCD value.
-  /// @return The byte value.
-  static uint8_t bcd2byte(uint8_t value) { return (value >> 4) * 10 + (value & 0x0f); }
-
-  /// @brief Convert a byte value to BCD.
-  /// @param value The byte value.
-  /// @return The BCD value.
-  static uint8_t byte2bcd(uint8_t value) { return ((value / 10) << 4) + value % 10; }
-
   /// @brief Get the date and time.
   /// @param ec The error code.
   /// @return The date and time.
@@ -143,10 +134,10 @@ class Bm8563 : public BasePeripheral<> {
     }
     Date d;
     int base_year = (data[2] & CENTURY_BIT) ? 1900 : 2000;
-    d.year = base_year + bcd2byte(data[3] & 0xff);
-    d.month = bcd2byte(data[2] & 0x1f);
-    d.weekday = bcd2byte(data[1] & 0x07);
-    d.day = bcd2byte(data[0] & 0x3f);
+    d.year = base_year + bcd_to_decimal(data[3] & 0xff);
+    d.month = bcd_to_decimal(data[2] & 0x1f);
+    d.weekday = bcd_to_decimal(data[1] & 0x07);
+    d.day = bcd_to_decimal(data[0] & 0x3f);
     return d;
   }
 
@@ -155,9 +146,9 @@ class Bm8563 : public BasePeripheral<> {
   /// @param ec The error code.
   void set_date(const Date &d, std::error_code &ec) {
     logger_.info("setting date");
-    const uint8_t data[] = {byte2bcd(d.day), byte2bcd(d.weekday),
-                            (uint8_t)(byte2bcd(d.month) | ((d.year < 2000) ? 0x80 : 0x00)),
-                            byte2bcd(d.year % 100)};
+    const uint8_t data[] = {decimal_to_bcd(d.day), decimal_to_bcd(d.weekday),
+                            (uint8_t)(decimal_to_bcd(d.month) | ((d.year < 2000) ? 0x80 : 0x00)),
+                            decimal_to_bcd(d.year % 100)};
     write_many_to_register((uint8_t)Registers::DATE, data, 4, ec);
   }
 
@@ -172,9 +163,9 @@ class Bm8563 : public BasePeripheral<> {
       return {};
     }
     Time t;
-    t.hour = bcd2byte(data[2] & 0x3f);
-    t.minute = bcd2byte(data[1] & 0x7f);
-    t.second = bcd2byte(data[0] & 0x7f);
+    t.hour = bcd_to_decimal(data[2] & 0x3f);
+    t.minute = bcd_to_decimal(data[1] & 0x7f);
+    t.second = bcd_to_decimal(data[0] & 0x7f);
     return t;
   }
 
@@ -183,7 +174,8 @@ class Bm8563 : public BasePeripheral<> {
   /// @param ec The error code.
   void set_time(const Time &t, std::error_code &ec) {
     logger_.info("Setting time");
-    const uint8_t data[] = {byte2bcd(t.second), byte2bcd(t.minute), byte2bcd(t.hour)};
+    const uint8_t data[] = {decimal_to_bcd(t.second), decimal_to_bcd(t.minute),
+                            decimal_to_bcd(t.hour)};
     write_many_to_register((uint8_t)Registers::TIME, data, 3, ec);
   }
 

components/pcf85063/CMakeLists.txt

@@ -0,0 +1,4 @@
+idf_component_register(
+  INCLUDE_DIRS "include"
+  REQUIRES "base_peripheral" "utils"
+  ) 

components/pcf85063/README.md

@@ -0,0 +1,12 @@
+# PCF85063 Example
+
+[![Badge](https://components.espressif.com/components/espp/pcf85063/badge.svg)](https://components.espressif.com/components/espp/pcf85063)
+
+The `pcf85063` component provides a driver for the PCF85063 Real Time Clock (RTC).
+
+It supports configuring and reading the time, setting alarms, and using the timer functionality.
+
+## Example
+
+The [example](./example) shows how to use the `espp::Pcf85063` component to initialize and
+communicate with the PCF85063 RTC. 

components/pcf85063/example/CMakeLists.txt

@@ -0,0 +1,21 @@
+# The following lines of boilerplate have to be in your project's CMakeLists
+# in this exact order for cmake to work correctly
+cmake_minimum_required(VERSION 3.20)
+
+include($ENV{IDF_PATH}/tools/cmake/project.cmake)
+
+# add the component directories that we want to use
+set(EXTRA_COMPONENT_DIRS
+  "../../../components/"
+)
+
+set(
+  COMPONENTS
+  "main esptool_py i2c pcf85063"
+  CACHE STRING
+  "List of components to include"
+  )
+
+project(pcf85063_example)
+
+set(CMAKE_CXX_STANDARD 20) 

components/pcf85063/example/README.md

@@ -0,0 +1,30 @@
+# PCF85063 Example
+
+This example shows how to use the `espp::Pcf85063` component to initialize and
+communicate with the PCF85063 RTC.
+
+## How to use example
+
+### Hardware Required
+
+This example is designed to run on a custom board with a PCF85063 RTC.
+You will need to configure the I2C pins for your specific hardware.
+
+### Build and Flash
+
+Build the project and flash it to the board, then run monitor tool to view
+serial output:
+
+```
+idf.py -p PORT flash monitor
+```
+
+(Replace PORT with the name of the serial port to use.)
+
+(To exit the serial monitor, type ``Ctrl-]``.)
+
+See the Getting Started Guide for full steps to configure and use ESP-IDF to build projects. 
+
+## Example Output
+
+<img width="453" height="330" alt="CleanShot 2025-07-13 at 22 14 08" src="https://github.com/user-attachments/assets/3b51ac17-db40-4d2f-90d2-476c90e085ba" />