HF-PCAL95555 0.1.0-dev
Loading...
Searching...
No Matches
Troubleshooting

This guide helps you diagnose and resolve common issues when using the PCAL95555 driver.

Common Error Messages

Error: Device Not Detected

Symptoms:

  • ResetToDefault() or other operations fail
  • No response from device

Causes:

  • Wrong I2C address
  • Hardware connections incorrect
  • Pull-up resistors missing

Solutions:

  1. Check I2C address:
    • Default is 0x20 (all A0-A2 pins to GND)
    • Use I2C scanner to verify device address
    • Update address pin levels in constructor if different:
      // For address 0x21: A0=HIGH, A1=LOW, A2=LOW
      PCAL95555 driver(bus, true, false, false);
    • Use GetAddress() to verify current address:
      uint8_t addr = driver.GetAddress();
      printf("Current address: 0x%02X\n", addr);
  2. Verify hardware connections:
    • Check SDA/SCL connections
    • Verify 4.7kΩ pull-up resistors on SCL and SDA
    • Ensure power connections (VDD and GND)
  3. Test I2C bus:
    • Verify I2C bus is properly initialized
    • Check I2C bus speed (try 100 kHz if 400 kHz fails)

Error: I2C Communication Failures

Symptoms:

  • Operations fail intermittently
  • Timeout errors

Solutions:

  1. Increase retries:
    gpio.SetRetries(3); // Default is 0
  2. Check bus speed: Reduce I2C speed if using long wires
  3. Verify signal integrity: Check for noise on I2C lines

Incorrect Pin States

Symptoms:

  • Pins don't respond to writes
  • Reads return wrong values

Checklist:

  • [ ] Verify pin direction is set correctly
  • [ ] Check pin is configured as output before writing
  • [ ] Verify pull resistors are configured if needed
  • [ ] Check for external loads affecting pin state

Runtime Errors

Initialization Fails

Checklist:

  • [ ] I2C interface is properly implemented
  • [ ] I2C bus is initialized
  • [ ] Hardware connections are correct
  • [ ] I2C address matches hardware configuration

Pin Operations Fail

Checklist:

  • [ ] Pin number is valid (0-15)
  • [ ] Pin direction is set correctly
  • [ ] I2C communication is working
  • [ ] Error flags are checked

Error: Invalid Address (InvalidAddress)

Symptoms:

  • Constructor or ChangeAddress() sets Error::InvalidAddress (flag 0x0020)
  • Methods fail after providing an out-of-range address

Cause: The I2C address provided is outside the valid range 0x20-0x27. The PCA9555/PCAL9555A only responds to addresses in this range (determined by the A0-A2 hardware pins).

Solutions:

  1. Check address parameter: Ensure the address is between 0x20 and 0x27:
    // Valid: address in 0x20-0x27 range
    PCAL95555 driver(bus, 0x20);
    // Invalid: will set Error::InvalidAddress
    PCAL95555 driver(bus, 0x50);
  2. Use pin-level constructor: The pin-level constructor always computes a valid address:
    PCAL95555 driver(bus, false, false, false); // Always valid (0x20)
  3. Check error flags: After construction, verify no errors:
    if (driver.GetErrorFlags() & static_cast<uint16_t>(Error::InvalidAddress)) {
    printf("Invalid I2C address!\n");
    }

Error: ChipVariant Shows "Unknown"

Symptoms:

  • GetChipVariant() returns ChipVariant::Unknown
  • HasAgileIO() returns false

Cause: The 3-step chip detection probe could not confirm the chip type. This usually means the bus was unhealthy during initialization.

Solutions:

  1. Check I2C pull-up resistors (4.7kΩ on SDA and SCL)
  2. Verify power supply is stable
  3. Ensure no other I2C master is on the bus
  4. Force the variant in the constructor to skip detection:
    PCAL95555 driver(bus, 0x20, pcal95555::ChipVariant::PCA9555);

FAQ

Q: Why do my pin writes not work?

A: Common causes:

  1. Pin not configured as output: Call SetPinDirection(pin, GPIODir::Output) first
  2. Wrong pin number: Valid pins are 0-15
  3. I2C communication failure: Check I2C bus and connections

Q: How do I use interrupts?

A: There are two ways to handle interrupts:

Method 1: Per-pin callbacks (recommended)

// Configure pin as input
gpio.SetPinDirection(pin, GPIODir::Input);
gpio.SetPullEnable(pin, true);
gpio.EnableInputLatch(pin, true);
// Enable interrupt (easy-to-use method)
gpio.ConfigureInterrupt(pin, InterruptState::Enabled);
// Register per-pin callback
gpio.RegisterPinInterrupt(pin, InterruptEdge::Rising, [](uint16_t p, bool state) {
printf("Pin %d interrupt!\n", p);
});
// Register interrupt handler with I2C interface (for hardware INT pin)
gpio.RegisterInterruptHandler();
// Handle interrupt (called automatically if INT pin configured, or call manually)
gpio.HandleInterrupt();

Method 2: Global callback

gpio.SetInterruptCallback([](uint16_t status) {
printf("Interrupt on pins: 0x%04X\n", status);
});

Q: Can I use multiple devices?

A: Yes! Configure different I2C addresses via A0-A2 pins, then create separate driver instances. You can even mix PCA9555 and PCAL9555A on the same bus:

// First device: PCA9555 at 0x20
pcal95555::PCAL95555<MyI2c> gpio1(&i2c, false, false, false);
// Second device: PCAL9555A at 0x21
pcal95555::PCAL95555<MyI2c> gpio2(&i2c, true, false, false);
// Each auto-detects its own chip variant

You can also change the address dynamically if your I2C interface supports GPIO control:

if (gpio1.ChangeAddress(true, false, false)) {
printf("Address changed to 0x%02X\n", gpio1.GetAddress()); // Now 0x21
}

Q: How do I know which chip I have (PCA9555 vs PCAL9555A)?

A: The driver auto-detects during initialization:

gpio.EnsureInitialized();
if (gpio.HasAgileIO()) {
printf("PCAL9555A (extended features available)\n");
} else {
printf("PCA9555 (standard GPIO only)\n");
}

You can also check the chip marking. PCA9555 has part number "PCA9555"; PCAL9555A has "PCAL9555A".

Q: What's the difference between pull-up and pull-down?

A:

  • Pull-up: Resistor connects pin to VDD (default high when floating)
  • Pull-down: Resistor connects pin to GND (default low when floating)

Choose based on your circuit requirements.

Q: What drive strength levels are available?

A: The driver supports four drive strength levels:

  • Level0: 25% drive strength (¼)
  • Level1: 50% drive strength (½)
  • Level2: 75% drive strength (¾)
  • Level3: 100% drive strength (full)

Example:

gpio.SetDriveStrength(pin, DriveStrength::Level1); // 50% strength

Q: How do I check for errors?

A: Use error flags to check for errors:

uint16_t errors = gpio.GetErrorFlags();
if (errors & static_cast<uint16_t>(Error::I2CReadFail)) {
// I2C read failed (also set by ReadPins() on failure)
}
if (errors & static_cast<uint16_t>(Error::I2CWriteFail)) {
// I2C write failed
}
if (errors & static_cast<uint16_t>(Error::InvalidPin)) {
// Invalid pin number (>= 16)
}
if (errors & static_cast<uint16_t>(Error::UnsupportedFeature)) {
// PCAL9555A feature called on PCA9555
}
if (errors & static_cast<uint16_t>(Error::InvalidAddress)) {
// I2C address outside valid 0x20-0x27 range
}
gpio.ClearErrorFlags(); // Clear all errors
// Or clear selectively: gpio.ClearErrorFlags(0x0001); // Clear only InvalidPin

‍Note: ReadPins() now properly reports Error::I2CReadFail when the underlying I2C read fails, instead of silently returning empty results.

Navigation ⬅️ Examples | Back to Index

Generated by doxygen 1.10.0