Installation

This guide covers how to integrate the PCAL95555 driver into your project.

Prerequisites

Before installing the driver, ensure you have:

• C++17 Compiler: GCC 7+, Clang 5+, or MSVC 2017+
• I2C Interface: Your platform's I2C driver (ESP-IDF, STM32 HAL, Arduino Wire, etc.)
• Compatible chip: PCA9555 or PCAL9555A (the driver auto-detects which variant is connected)

Integration

This driver is a header-only template library designed to be integrated directly into your project. There's no separate build step required.

Option 1: Copy Files

Copy the following files into your project:

inc/
  ├── pcal95555.hpp
  └── pcal95555_kconfig.hpp
src/
  └── pcal95555.ipp

Note: The driver uses a header-only template design where pcal95555.ipp is included by pcal95555.hpp. Kconfig compile-time configuration macros live in pcal95555_kconfig.hpp (also included automatically). You typically only need to include the main header file in your project.

Option 2: Git Submodule

cd your-project
git submodule add https://github.com/N3b3x/hf-pcal95555-driver.git drivers/pcal95555

Then add to your include path:

target_include_directories(your_target PRIVATE drivers/pcal95555/inc)

Including the Header

Simply include the header in your code:

#include "pcal95555.hpp"

The implementation is included automatically via the header file.

Next Steps

• Follow the Quick Start guide to create your first application
• Review Hardware Setup for wiring instructions
• Check Platform Integration to implement the I2C interface