@mchp-mcc/scf-pic8-i2c-v1 NPM

I2C Driver

Overview

The Inter-Integrated Circuit (I2C) bus is a multi-host serial data communication bus. Devices communicate in a host/ client environment where the host devices initiate the communication. A client device is controlled through addressing.

Generated Files

This driver generates the following files :

I2C Host Mode:

./mcc_generated_files/i2c_host/src/i2c1.c => A driver file containing Register Initialization and API function implementations
./mcc_generated_files/i2c_host/i2c1.h => A driver file containing the API function prototypes
./mcc_generated_files/i2c_host/i2c_host_interface.h => A driver file containing the Common API function prototypes structure
./mcc_generated_files/i2c_host/i2c_host_type.h => A driver file containing the type definition for i2c host
./mcc_generated_files/i2c_host/i2c_host_event_types.h => A driver file containing the structure definition for i2c host

I2C Client Mode:

./mcc_generated_files/i2c_client/src/i2c1.c => A driver file containing Register Initialization and API function implementations
./mcc_generated_files/i2c_client/i2c1.h => A driver file containing the API function prototypes
./mcc_generated_files/i2c_client/i2c_client_interface.h => A driver file containing the Common API function prototypes structure
./mcc_generated_files/i2c_client/i2c_client_type.h => A driver file containing the type definition for i2c client

Changelog

All notable changes to this project will be documented in this file.

6.1.4 - 2024-12-19

Bug Fixes

M8PD-12362 :- Corrected I2CXPIR register clearing to only clear stop interrupt bit on stop interrupt reception
M8PD-11437 :- Fixed the I2C client to clear the ACKDT bit in I2CxCON1 after receiving a NACK from the host, which previously resulted in disabled clock stretching for subsequent requests
M8PD-10837 :- Revised the error handler to include missing checks on error flags, which previously led to incorrect error event generation
M8PD-5167 :- Removed the device specific warning and link to the Errata DS80000870F

6.1.3 - 2024-09-27

Bug Fixes

M8PD-10703 :- Unit test stage on CICD pipeline and locally passed when the coverage for the module files was lesser than the threshold
M8PD-9373 :- Included stddef.h header in the interface files of the I2C/TWI Host and client for successful compilation
M8PD-8902 :- Fixed I2C drivers to avoid incorrect occurrence of TX_READY state prior to the ACK reception for the address match
M8PD-8843 :- Fixed I2C drivers to enable clock stretching for ack, address or data reception
M8PD-7588 :- Fixed PIC18 I2C drivers to check the host read event only once after the address match
M8PD-6141 :- PIC18 I2C Client Address match event not clock stretching
M8PD-5191 :- Fixed the I2C address mask for PIC18F devices to be set to default POR of "7F" to avoid I2C slave malfunctioning with multiple devices