4.15.2 I2C with Baud Rate Prescaler

• struct i2c_client_interface_t

  This structure contains the portable interfaces for I2C client.

• enum i2c_client_transfer_dir_t { I2C_CLIENT_TRANSFER_DIR_WRITE = 0, I2C_CLIENT_TRANSFER_DIR_READ = 1 }

  Enumeration to determine the direction of data transfer initiated by the host, as determined by the I2Cx_TransferDirGet function.

• enum i2c_client_ack_status_t { I2C_CLIENT_ACK_STATUS_RECEIVED_ACK = 0, I2C_CLIENT_ACK_STATUS_RECEIVED_NACK = 1 }

  Enumeration for acknowledgment and non-acknowledgment status.

• enum i2c_client_transfer_event_t { I2C_CLIENT_TRANSFER_EVENT_NONE = 0, I2C_CLIENT_TRANSFER_EVENT_ADDR_MATCH, I2C_CLIENT_TRANSFER_EVENT_RX_READY, I2C_CLIENT_TRANSFER_EVENT_TX_READY, I2C_CLIENT_TRANSFER_EVENT_STOP_BIT_RECEIVED, I2C_CLIENT_TRANSFER_EVENT_ERROR}

  Enumeration defining the various I2C event types.

• enum i2c_client_error_t { I2C_CLIENT_ERROR_NONE = 0, I2C_CLIENT_ERROR_BUS_COLLISION, I2C_CLIENT_ERROR_WRITE_COLLISION, I2C_CLIENT_ERROR_RECEIVE_OVERFLOW, I2C_CLIENT_ERROR_TRANSMIT_UNDERFLOW, I2C_CLIENT_ERROR_READ_UNDERFLOW }

  Enumeration that specifies the possible errors in the I2C client driver.

• void I2C1_ISR (void)

  Interrupt Service Routine (ISR) function for all I2C1 interrupts. Ensure I2C1 client is initialized using I2C1_Initialize() before invoking this function.

• void I2C1_ERROR_ISR (void)

  Interrupt Service Routine (ISR) for error interrupts. Ensure I2C1 client is initialized using I2C1_Initialize() before invoking this function.

• void I2C1_Initialize (void)

  Initializes the I2C1 client module according to the settings specified in the MPLAB® Code Configurator Melody UI.

• void I2C1_Deinitialize (void)

  Resets the registers to their default Power-on Reset (POR) values.

• void I2C1_WriteByte (uint8_t data)

  Sends data to a host on the bus. Ensure I2C1 client is initialized using I2C1_Initialize() before invoking this function.

• uint8_t I2C1_ReadByte (void)

  Reads data from a host on the bus. Ensure I2C1 client is initialized using I2C1_Initialize() before invoking this function.  

• uint16_t I2C1_ReadAddr (void)

  Retrieves the most recently matched address received from the host. Ensure I2C1 client is initialized using I2C1_Initialize() before invoking this function.

• i2c_client_error_t I2C1_ErrorGet (void)

  Retrieves the type of error that occurred during I2C communication. Ensure I2C1 client is initialized using I2C1_Initialize() before invoking this function.

• i2c_client_transfer_dir_t I2C1_TransferDirGet (void)

  Retrieves the data transfer direction. Ensure I2C1 client is initialized using I2C1_Initialize() before invoking this function.

• i2c_client_ack_status_t I2C1_LastByteAckStatusGet (void)

  Retrieves the acknowledgement status from host. Ensure I2C1 is initialized using I2C1_Initialize() before invoking this function.

• void I2C1_CallbackRegister (bool(*callback)(i2c_client_transfer_event_t clientEvent))

  Registers a callback function.

• void I2C1_Tasks (void)

  Task to be polled I2C client events. Ensure I2C1 client is initialized using I2C1_Initialize() before invoking this function.

void I2C1_CallbackRegister (bool(*)(i2c_client_transfer_event_t clientEvent) callback)

Registers a callback function.

void I2C1_Deinitialize (void )

Resets the registers to their default Power-on Reset (POR) values.

void I2C1_ERROR_ISR (void )

Interrupt Service Routine (ISR) for error interrupts. Ensure I2C1 client is initialized using I2C1_Initialize() before invoking this function.

i2c_client_error_t I2C1_ErrorGet (void )

Retrieves the type of error that occurred during I2C communication. Ensure I2C1 client is initialized using I2C1_Initialize() before invoking this function.

void I2C1_Initialize (void )

Initializes the I2C1 client module according to the settings specified in the MPLAB® Code Configurator Melody UI.

void I2C1_ISR (void )

Interrupt Service Routine (ISR) function for all I2C1 interrupts. Ensure I2C1 client is initialized using I2C1_Initialize() before invoking this function.

i2c_client_ack_status_t I2C1_LastByteAckStatusGet (void )

Retrieves the acknowledgement status from host. Ensure I2C1 is initialized using I2C1_Initialize() before invoking this function.

uint16_t I2C1_ReadAddr (void )

Retrieves the most recently matched address received from the host. Ensure I2C1 client is initialized using I2C1_Initialize() before invoking this function.

uint8_t I2C1_ReadByte (void )

Reads data from a host on the bus. Ensure I2C1 client is initialized using I2C1_Initialize() before invoking this function.  

void I2C1_Tasks (void )

Task to be polled I2C client events. Ensure I2C1 client is initialized using I2C1_Initialize() before invoking this function.

i2c_client_transfer_dir_t I2C1_TransferDirGet (void )

Retrieves the data transfer direction. Ensure I2C1 client is initialized using I2C1_Initialize() before invoking this function.

void I2C1_WriteByte (uint8_t data)

Sends data to a host on the bus. Ensure I2C1 client is initialized using I2C1_Initialize() before invoking this function.

enum i2c_client_ack_status_t

Enumeration for acknowledgment and non-acknowledgment status.

enum i2c_client_error_t

Enumeration that specifies the possible errors in the I2C client driver.

enum i2c_client_transfer_dir_t

Enumeration to determine the direction of data transfer initiated by the host, as determined by the I2Cx_TransferDirGet function.

enum i2c_client_transfer_event_t

Enumeration defining the various I2C event types.

• struct i2c_host_event_status_t

  Structure that defines the communication parameters for an I2C host.

• struct i2c_host_transfer_setup_t

  Structure for the I2C clock configuration.

• enum i2c_host_error_t { I2C_ERROR_NONE, I2C_ERROR_ADDR_NACK, I2C_ERROR_DATA_NACK, I2C_ERROR_BUS_COLLISION}

  Enumeration for the possible errors in the I2C host driver.

• void I2C1_Initialize (void)

  Initializes the I2C1 host module according to the settings specified in the MPLAB® Code Configurator Melody UI.

• void I2C1_Deinitialize (void)

  Resets the registers to their default Power-on Reset (POR) values.

• bool I2C1_Write (uint16_t address, uint8_t *data, size_t dataLength)

  Sends data to a client on the bus. Ensure I2C1 host is initialized using I2C1_Initialize() before invoking this function.

• bool I2C1_Read (uint16_t address, uint8_t *data, size_t dataLength)

  Reads data from an I2C client on the bus. Ensure I2C1 host is initialized using I2C1_Initialize() before invoking this function.

• bool I2C1_WriteRead (uint16_t address, uint8_t *writeData, size_t writeLength, uint8_t *readData, size_t readLength)

  Initiates a data transfer by writing data from the writeData function to the bus and subsequently reads data from the Client, storing the received data in the readData parameter. The function generates a Start condition on the bus and transmits the specified number of bytes (writeLength) from the writeData buffer. Following this, a Repeated Start condition is inserted, and the function proceeds to read the specified number of bytes (readLength) from the client, storing them in the readData buffer. A Stop condition is generated after the final byte is received.

• i2c_host_error_t I2C1_ErrorGet (void)

  Retrieves the error that occurred during I2C transmission and reception. Ensure I2C1 host is initialized using I2C1_Initialize() before invoking this function.  

• bool I2C1_IsBusy (void)

  Determines if the I2C bus is currently busy. Ensure I2C1 host is initialized using I2C1_Initialize() before invoking this function.  

• void I2C1_CallbackRegister (void(*callback)(void))

  Registers a callback function.

void I2C1_CallbackRegister (void(*)(void) callback)

Registers a callback function.

void I2C1_Deinitialize (void )

Resets the registers to their default Power-on Reset (POR) values.

i2c_host_error_t I2C1_ErrorGet (void )

Retrieves the error that occurred during I2C transmission and reception. Ensure I2C1 host is initialized using I2C1_Initialize() before invoking this function.  

void I2C1_Initialize (void )

Initializes the I2C1 host module according to the settings specified in the MPLAB® Code Configurator Melody UI.

bool I2C1_IsBusy (void )

Determines if the I2C bus is currently busy. Ensure I2C1 host is initialized using I2C1_Initialize() before invoking this function.  

bool I2C1_Read (uint16_t address, uint8_t * data, size_t dataLength)

Reads data from an I2C client on the bus. Ensure I2C1 host is initialized using I2C1_Initialize() before invoking this function.

This function attempts to read a specified number of bytes received from the I2C client with the given address into the data buffer. The I2C Host initiates a Start condition, reads the data, and then generates a Stop condition. If the Client NAKs the request or a bus error occurs, the transfer is terminated. The application can call the I2C1_ErrorGet() function to determine the cause of the error.

This function is non-blocking; it starts the bus activity and returns immediately. The transfer is completed in the peripheral interrupt. In Polling mode, the user must call I2C1_Tasks within the while loop. A new transfer request cannot be initiated while another transfer is in progress. Calling this function during an ongoing transfer will result in the function returning false.

bool I2C1_Write (uint16_t address, uint8_t * data, size_t dataLength)

Sends data to a client on the bus. Ensure I2C1 host is initialized using I2C1_Initialize() before invoking this function.

This function attempts to write a specified number of bytes from the data buffer to a I2C client, identified by the provided address.

The TWI host will generate a Start condition, transmit the data, and then generate a Stop condition. If the client device responds with a NAK or if a bus error occurs, the transfer will be terminated. The application can call the I2C1_ErrorGet() function to determine the cause of the error. This function is non-blocking, meaning it initiates the bus activity and returns immediately. The transfer is then completed within the peripheral interrupt. In Polling mode, the user must call I2C1_Tasks within the while loop. A new transfer request cannot be initiated while another transfer is in progress. If this function is called while another transfer is ongoing, it will return false.

bool I2C1_WriteRead (uint16_t address, uint8_t * writeData, size_t writeLength, uint8_t * readData, size_t readLength)

Initiates a data transfer by writing data from the writeData function to the bus and subsequently reads data from the Client, storing the received data in the readData parameter. The function generates a Start condition on the bus and transmits the specified number of bytes (writeLength) from the writeData buffer. Following this, a Repeated Start condition is inserted, and the function proceeds to read the specified number of bytes (readLength) from the client, storing them in the readData buffer. A Stop condition is generated after the final byte is received.

If the Client responds with a NAK or a bus error occurs, the transfer is terminated. The application can call the I2C1_ErrorGet() function to determine the cause of the error.

This function is non-blocking; it initiates the bus activity and returns immediately. The transfer is then completed via the peripheral interrupt. In Polling mode, the user must call I2C1_Tasks within the while loop. A new transfer request cannot be initiated while another transfer is in progress. Calling this function during an ongoing transfer will result in the function returning false.

• struct i2c_host_interface_t

  This structure contains the portable interfaces for I2C host.

• struct i2c_host_event_status_t

  Structure that defines the communication parameters for an I2C host.

• struct i2c_host_transfer_setup_t

  Structure for the I2C clock configuration.

• void I2C1_ISR (void)

  Interrupt Service Routine (ISR) function for all I2C1 interrupts. Ensure I2C1 host is initialized using I2C1_Initialize() before invoking this function.

• void I2C1_ERROR_ISR (void)

  Interrupt Service Routine (ISR) for error interrupts. Ensure I2C1 host is initialized using I2C1_Initialize() before invoking this function.

• void I2C1_RX_ISR (void)

  Interrupt Service Routine (ISR) for I2C1 receive interrupts.

• void I2C1_TX_ISR (void)

  Interrupt Service Routine (ISR) for I2C1 transmit interrupts.

• void I2C1_Initialize (void)

  Initializes the I2C1 host module according to the settings specified in the MPLAB® Code Configurator Melody UI.

• void I2C1_Deinitialize (void)

  Resets the registers to their default Power-on Reset (POR) values.

• bool I2C1_Write (uint16_t address, uint8_t *data, size_t dataLength)

  Sends data to a client on the bus. Ensure I2C1 host is initialized using I2C1_Initialize() before invoking this function.

• bool I2C1_Read (uint16_t address, uint8_t *data, size_t dataLength)

  Reads data from an I2C client on the bus. Ensure I2C1 host is initialized using I2C1_Initialize() before invoking this function.

• bool I2C1_WriteRead (uint16_t address, uint8_t *writeData, size_t writeLength, uint8_t *readData, size_t readLength)

  Initiates a data transfer by writing data from the writeData function to the bus and subsequently reads data from the Client, storing the received data in the readData parameter. The function generates a Start condition on the bus and transmits the specified number of bytes (writeLength) from the writeData buffer. Following this, a Repeated Start condition is inserted, and the function proceeds to read the specified number of bytes (readLength) from the client, storing them in the readData buffer. A Stop condition is generated after the final byte is received.

• i2c_host_error_t I2C1_ErrorGet (void)

  Retrieves the error that occurred during I2C transmission and reception. Ensure I2C1 host is initialized using I2C1_Initialize() before invoking this function.  

• bool I2C1_IsBusy (void)

  Determines if the I2C bus is currently busy. Ensure I2C1 host is initialized using I2C1_Initialize() before invoking this function.  

• void I2C1_CallbackRegister (void(*callback)(void))

  Registers a callback function.

• void I2C1_Tasks (void)

  Task to be polled for I2C host events. Ensure I2C1 host is initialized using I2C1_Initialize() before invoking this function.

void I2C1_CallbackRegister (void(*)(void) callback)

Registers a callback function.

void I2C1_Deinitialize (void )

Resets the registers to their default Power-on Reset (POR) values.

void I2C1_ERROR_ISR (void )

Interrupt Service Routine (ISR) for error interrupts. Ensure I2C1 host is initialized using I2C1_Initialize() before invoking this function.

i2c_host_error_t I2C1_ErrorGet (void )

Retrieves the error that occurred during I2C transmission and reception. Ensure I2C1 host is initialized using I2C1_Initialize() before invoking this function.  

void I2C1_Initialize (void )

Initializes the I2C1 host module according to the settings specified in the MPLAB® Code Configurator Melody UI.

bool I2C1_IsBusy (void )

Determines if the I2C bus is currently busy. Ensure I2C1 host is initialized using I2C1_Initialize() before invoking this function.  

void I2C1_ISR (void )

Interrupt Service Routine (ISR) function for all I2C1 interrupts. Ensure I2C1 host is initialized using I2C1_Initialize() before invoking this function.

bool I2C1_Read (uint16_t address, uint8_t * data, size_t dataLength)

Reads data from an I2C client on the bus. Ensure I2C1 host is initialized using I2C1_Initialize() before invoking this function.

This function attempts to read a specified number of bytes received from the I2C client with the given address into the data buffer. The I2C Host initiates a Start condition, reads the data, and then generates a Stop condition. If the Client NAKs the request or a bus error occurs, the transfer is terminated. The application can call the I2C1_ErrorGet() function to determine the cause of the error.

This function is non-blocking; it starts the bus activity and returns immediately. The transfer is completed in the peripheral interrupt. In Polling mode, the user must call I2C1_Tasks within the while loop. A new transfer request cannot be initiated while another transfer is in progress. Calling this function during an ongoing transfer will result in the function returning false.

void I2C1_RX_ISR (void )

Interrupt Service Routine (ISR) for I2C1 receive interrupts.

void I2C1_Tasks (void )

Task to be polled for I2C host events. Ensure I2C1 host is initialized using I2C1_Initialize() before invoking this function.

void I2C1_TX_ISR (void )

Interrupt Service Routine (ISR) for I2C1 transmit interrupts.

bool I2C1_Write (uint16_t address, uint8_t * data, size_t dataLength)

Sends data to a client on the bus. Ensure I2C1 host is initialized using I2C1_Initialize() before invoking this function.

This function attempts to write a specified number of bytes from the data buffer to a I2C client, identified by the provided address.

The TWI host will generate a Start condition, transmit the data, and then generate a Stop condition. If the client device responds with a NAK or if a bus error occurs, the transfer will be terminated. The application can call the I2C1_ErrorGet() function to determine the cause of the error. This function is non-blocking, meaning it initiates the bus activity and returns immediately. The transfer is then completed within the peripheral interrupt. In Polling mode, the user must call I2C1_Tasks within the while loop. A new transfer request cannot be initiated while another transfer is in progress. If this function is called while another transfer is ongoing, it will return false.

bool I2C1_WriteRead (uint16_t address, uint8_t * writeData, size_t writeLength, uint8_t * readData, size_t readLength)

Initiates a data transfer by writing data from the writeData function to the bus and subsequently reads data from the Client, storing the received data in the readData parameter. The function generates a Start condition on the bus and transmits the specified number of bytes (writeLength) from the writeData buffer. Following this, a Repeated Start condition is inserted, and the function proceeds to read the specified number of bytes (readLength) from the client, storing them in the readData buffer. A Stop condition is generated after the final byte is received.

If the Client responds with a NAK or a bus error occurs, the transfer is terminated. The application can call the I2C1_ErrorGet() function to determine the cause of the error.

This function is non-blocking; it initiates the bus activity and returns immediately. The transfer is then completed via the peripheral interrupt. In Polling mode, the user must call I2C1_Tasks within the while loop. A new transfer request cannot be initiated while another transfer is in progress. Calling this function during an ongoing transfer will result in the function returning false.

enum i2c_host_error_t

Enumeration for the possible errors in the I2C host driver.

• void(* Initialize )(void)

  Pointer to the function that initializes the I2C client.

• void(* Deinitialize )(void)

  Pointer to the function that deinitializes the I2C client.

• void(* WriteByte )(uint8_t data)

  Pointer to the function that sends data to a host on bus.

• uint8_t(* ReadByte )(void)

  Pointer to the function that reads data from a host on bus.

• i2c_client_error_t(* ErrorGet )(void)

  Pointer to the function that returns the last error that occurred on the I2C bus.

• i2c_client_transfer_dir_t(* TransferDirGet )(void)

  Pointer to the function that returns the direction of data transfer between client and a host on bus.

• i2c_client_ack_status_t(* LastByteAckStatusGet )(void)

  Pointer to the function that retrieves the acknowledgment status of the last byte transferred.

• void(* CallbackRegister )(bool(*handler)(i2c_client_transfer_event_t clientEvent))

  Pointer to the function that registers a callback handler for I2C client.

• void(* Tasks )(void)

  Pointer to the function that is polled for I2C client events.

void(* CallbackRegister

Pointer to the function that registers a callback handler for I2C client.

void(* Deinitialize

Pointer to the function that deinitializes the I2C client.

i2c_client_error_t(* ErrorGet

Pointer to the function that returns the last error that occurred on the I2C bus.

void(* Initialize

Pointer to the function that initializes the I2C client.

i2c_client_ack_status_t(* LastByteAckStatusGet

Pointer to the function that retrieves the acknowledgment status of the last byte transferred.

uint8_t(* ReadByte

Pointer to the function that reads data from a host on bus.

void(* Tasks

Pointer to the function that is polled for I2C client events.

i2c_client_transfer_dir_t(* TransferDirGet

Pointer to the function that returns the direction of data transfer between client and a host on bus.

void(* WriteByte

Pointer to the function that sends data to a host on bus.

• bool busy

• uint16_t address

• uint8_t * writePtr

• size_t writeLength

• uint8_t * readPtr

• size_t readLength

• bool switchToRead

• i2c_host_error_t errorState

uint16_t address

I2C client address

bool busy

A flag that signifies the host is currently busy

i2c_host_error_t errorState

An instance of i2c_host_error_t

size_t readLength

Number of bytes to be read from the client

uint8_t * readPtr

Pointer to the buffer for received data

bool switchToRead

Boolean flag to indicate switching to read mode

size_t writeLength

The number of bytes to be written or sent to the client

uint8_t * writePtr

Pointer to the buffer used for transmission

• void(* Initialize )(void)

  Pointer to the function that initializes the I2C host, setting up any necessary hardware or software resources.

• void(* Deinitialize )(void)

  Pointer to the function that deinitializes the I2C host, by resetting the I2C registers to Power On Default (POR) values.

• bool(* Write )(uint16_t address, uint8_t *data, size_t dataLength)

  Pointer to the write function of the I2C host.

• bool(* Read )(uint16_t address, uint8_t *data, size_t dataLength)

  Pointer to the read function of the I2C host.

• bool(* WriteRead )(uint16_t address, uint8_t *writeData, size_t writeLength, uint8_t *readData, size_t readLength)

  Pointer to the write and read function of the I2C host.

• bool(* TransferSetup )(struct i2c_transfer_setup *setup, uint32_t srcClkFreq)

  Pointer to the function that sets up the transfer parameters of the I2C host.

• i2c_host_error_t(* ErrorGet )(void)

  Pointer to the function that returns the last error that occurred on the I2C bus.

• bool(* IsBusy )(void)

  Pointer to the function that checks if the I2C bus is busy.

• void(* CallbackRegister )(void(*callback)(void))

  Pointer to the function that Registers a callback function for I2C events.

• void(* Tasks )(void)

  Pointer to the function that is polled for I2C host events.

void(* CallbackRegister

Pointer to the function that Registers a callback function for I2C events.

void(* Deinitialize

Pointer to the function that deinitializes the I2C host, by resetting the I2C registers to Power On Default (POR) values.

i2c_host_error_t(* ErrorGet

Pointer to the function that returns the last error that occurred on the I2C bus.

void(* Initialize

Pointer to the function that initializes the I2C host, setting up any necessary hardware or software resources.

bool(* IsBusy

Pointer to the function that checks if the I2C bus is busy.

bool(* Read

Pointer to the read function of the I2C host.

void(* Tasks

Pointer to the function that is polled for I2C host events.

bool(* TransferSetup

Pointer to the function that sets up the transfer parameters of the I2C host.

bool(* Write

Pointer to the write function of the I2C host.

bool(* WriteRead

Pointer to the write and read function of the I2C host.

• uint32_t clkSpeed

uint32_t clkSpeed

void I2C1_CallbackRegister (bool(*)(i2c_client_transfer_event_t clientEvent) callback)

Registers a callback function.

void I2C1_Deinitialize (void )

Resets the registers to their default Power-on Reset (POR) values.

i2c_client_error_t I2C1_ErrorGet (void )

Retrieves the type of error that occurred during I2C communication. Ensure I2C1 client is initialized using I2C1_Initialize() before invoking this function.

void I2C1_Initialize (void )

Initializes the I2C1 client module according to the settings specified in the MPLAB® Code Configurator Melody UI.

i2c_client_ack_status_t I2C1_LastByteAckStatusGet (void )

Retrieves the acknowledgement status from host. Ensure I2C1 is initialized using I2C1_Initialize() before invoking this function.

uint16_t I2C1_ReadAddr (void )

Retrieves the most recently matched address received from the host. Ensure I2C1 client is initialized using I2C1_Initialize() before invoking this function.

uint8_t I2C1_ReadByte (void )

Reads data from a host on the bus. Ensure I2C1 client is initialized using I2C1_Initialize() before invoking this function.  

i2c_client_transfer_dir_t I2C1_TransferDirGet (void )

Retrieves the data transfer direction. Ensure I2C1 client is initialized using I2C1_Initialize() before invoking this function.

void I2C1_WriteByte (uint8_t data)

Sends data to a host on the bus. Ensure I2C1 client is initialized using I2C1_Initialize() before invoking this function.

#define I2C2_Client_CallbackRegister I2C1_CallbackRegister

#define I2C2_Client_Deinitialize I2C1_Deinitialize

#define I2C2_Client_ErrorGet I2C1_ErrorGet

#define I2C2_Client_Initialize I2C1_Initialize

#define i2c2_client_interface I2C2_Client

@misradeviation {advisory,2.5} False positive - A few macros in this file are used as arguments but are not getting recognized by the tool. This rule ID has been disabled at the project level due to numerous instances across various files. Consequently, in the application project, this rule ID must be disabled in the MPLAB-X IDE by navigation to Tools -> Options -> Embedded -> MISRA Check.

#define I2C2_Client_LastByteAckStatusGet I2C1_LastByteAckStatusGet

#define I2C2_Client_ReadAddr I2C1_ReadAddr

#define I2C2_Client_ReadByte I2C1_ReadByte

#define I2C2_Client_Tasks I2C1_Tasks

#define I2C2_Client_TransferDirGet I2C1_TransferDirGet

#define I2C2_Client_WriteByte I2C1_WriteByte

const i2c_client_interface_t I2C2_Client

Represents an instance of the portable interface structure designed for I2C1 client.

@misradeviation {Advisory:,8.7} Some Melody-generated driver APIs are made available to users through external linkage. Users have the option to add these APIs in the application.This rule ID is disabled at project level due to its multiple occurrences in several files.Therefore, in the application project, this rule ID must be disabled in the MPLAB-X IDE from Tools -> Options -> Embedded -> MISRA Check.

#define I2C2_Host_CallbackRegister I2C1_CallbackRegister

#define I2C2_Host_Deinitialize I2C1_Deinitialize

#define I2C2_Host_ErrorGet I2C1_ErrorGet

#define i2c2_host_host_interface I2C2_Host

@misradeviation {advisory,2.5} False positive - A few macros in this file are used as arguments but are not getting recognized by the tool. This rule ID has been disabled at the project level due to numerous instances across various files. Consequently, in the application project, this rule ID must be disabled in the MPLAB-X IDE by navigating to Tools>Options>Embedded>MISRA Check.

#define I2C2_Host_Initialize I2C1_Initialize

#define I2C2_Host_IsBusy I2C1_IsBusy

#define I2C2_Host_Read I2C1_Read

#define I2C2_Host_Write I2C1_Write

#define I2C2_Host_WriteRead I2C1_WriteRead

const i2c_host_interface_t I2C2_Host

Represents an instance of the portable interface structure designed for I2C1 host.

#define I2C1_Client_CallbackRegister I2C1_CallbackRegister

#define I2C1_Client_Deinitialize I2C1_Deinitialize

#define I2C1_Client_ErrorGet I2C1_ErrorGet

#define I2C1_Client_Initialize I2C1_Initialize

#define i2c1_client_interface I2C1_Client

@misradeviation {advisory,2.5} False positive - A few macros in this file are used as arguments but are not getting recognized by the tool. This rule ID has been disabled at the project level due to numerous instances across various files. Consequently, in the application project, this rule ID must be disabled in the MPLAB-X IDE by navigation to Tools -> Options -> Embedded -> MISRA Check.

#define I2C1_Client_LastByteAckStatusGet I2C1_LastByteAckStatusGet

#define I2C1_Client_ReadAddr I2C1_ReadAddr

#define I2C1_Client_ReadByte I2C1_ReadByte

#define I2C1_Client_Tasks I2C1_Tasks

#define I2C1_Client_TransferDirGet I2C1_TransferDirGet

#define I2C1_Client_WriteByte I2C1_WriteByte

const i2c_client_interface_t I2C1_Client

Represents an instance of the portable interface structure designed for I2C1 client.

@misradeviation {Advisory:,8.7} Some Melody-generated driver APIs are made available to users through external linkage. Users have the option to add these APIs in the application.This rule ID is disabled at project level due to its multiple occurrences in several files.Therefore, in the application project, this rule ID must be disabled in the MPLAB-X IDE from Tools -> Options -> Embedded -> MISRA Check.

#define I2C1_Host_CallbackRegister I2C1_CallbackRegister

#define I2C1_Host_Deinitialize I2C1_Deinitialize

#define I2C1_Host_ErrorGet I2C1_ErrorGet

#define i2c1_host_host_interface I2C1_Host

@misradeviation {advisory,2.5} False positive - A few macros in this file are used as arguments but are not getting recognized by the tool. This rule ID has been disabled at the project level due to numerous instances across various files. Consequently, in the application project, this rule ID must be disabled in the MPLAB-X IDE by navigating to Tools>Options>Embedded>MISRA Check.

#define I2C1_Host_Initialize I2C1_Initialize

#define I2C1_Host_IsBusy I2C1_IsBusy

#define I2C1_Host_Read I2C1_Read

#define I2C1_Host_Tasks I2C1_Tasks

#define I2C1_Host_Write I2C1_Write

#define I2C1_Host_WriteRead I2C1_WriteRead

const i2c_host_interface_t I2C1_Host

Represents an instance of the portable interface structure designed for I2C1 host.

enum i2c_client_ack_status_t

enum i2c_client_error_t

enum i2c_client_transfer_dir_t

enum i2c_client_transfer_event_t

static void I2C1_ErrorEventHandler (void )[static]

static void I2C1_EventHandler (void )[static]

bool(* I2C1_InterruptHandler) (i2c_client_transfer_event_t clientEvent)[static]

volatile i2c_client_error_t i2c1ErrorState[static]

const i2c_client_interface_t I2C2_Client

Initial value:

= { 
    .Initialize = I2C1_Initialize,                                   
    .Deinitialize = I2C1_Deinitialize,
    .WriteByte = I2C1_WriteByte,
    .ReadByte = I2C1_ReadByte,
    .TransferDirGet = I2C1_TransferDirGet,
    .LastByteAckStatusGet = I2C1_LastByteAckStatusGet,
    .ErrorGet = I2C1_ErrorGet,
    .CallbackRegister = I2C1_CallbackRegister,
    .Tasks = NULL
}

Represents an instance of the portable interface structure designed for I2C1 client.

@misradeviation {Advisory:,8.7} Some Melody-generated driver APIs are made available to users through external linkage. Users have the option to add these APIs in the application.This rule ID is disabled at project level due to its multiple occurrences in several files.Therefore, in the application project, this rule ID must be disabled in the MPLAB-X IDE from Tools -> Options -> Embedded -> MISRA Check.

inline static void I2C1_BusReset (void )

static void I2C1_Close (void )[static]

inline static void I2C1_InterruptsDisable (void )

inline static void I2C1_InterruptsEnable (void )

static void I2C1_ReadStart (void )[static]

@misradeviation {Advisory:,8.7} Some Melody-generated driver APIs are made available to users through external linkage. Users have the option to add these APIs in the application.This rule ID is disabled at project level due to its multiple occurrences in several files.Therefore, in the application project, this rule ID must be disabled in the MPLAB-X IDE from Tools -> Options -> Embedded -> MISRA Check.

static void I2C1_WriteStart (void )[static]

void(* I2C1_Callback) (void)[static]

volatile i2c_host_event_status_t i2c1Status = {0}

const i2c_host_interface_t I2C2_Host

Initial value:

= {
    .Initialize = I2C1_Initialize,
    .Deinitialize = I2C1_Deinitialize,
    .Write = I2C1_Write,
    .Read = I2C1_Read,
    .WriteRead = I2C1_WriteRead,
    .TransferSetup = NULL,
    .ErrorGet = I2C1_ErrorGet,
    .IsBusy = I2C1_IsBusy,
    .CallbackRegister = I2C1_CallbackRegister,
    .Tasks = NULL
}

Represents an instance of the portable interface structure designed for I2C1 host.

static void I2C1_ErrorEventHandler (void )[static]

static void I2C1_EventHandler (void )[static]

const i2c_client_interface_t I2C1_Client

Initial value:

= { 
    .Initialize = I2C1_Initialize,                                   
    .Deinitialize = I2C1_Deinitialize,
    .WriteByte = I2C1_WriteByte,
    .ReadByte = I2C1_ReadByte,
    .TransferDirGet = I2C1_TransferDirGet,
    .LastByteAckStatusGet = I2C1_LastByteAckStatusGet,
    .ErrorGet = I2C1_ErrorGet,
    .CallbackRegister = I2C1_CallbackRegister,
    .Tasks = I2C1_Tasks
}

Represents an instance of the portable interface structure designed for I2C1 client.

@misradeviation {Advisory:,8.7} Some Melody-generated driver APIs are made available to users through external linkage. Users have the option to add these APIs in the application.This rule ID is disabled at project level due to its multiple occurrences in several files.Therefore, in the application project, this rule ID must be disabled in the MPLAB-X IDE from Tools -> Options -> Embedded -> MISRA Check.

bool(* I2C1_InterruptHandler) (i2c_client_transfer_event_t clientEvent)[static]

volatile i2c_client_error_t i2c1ErrorState[static]

inline static void I2C1_BusReset (void )

static void I2C1_Close (void )[static]

static void I2C1_ReadStart (void )[static]

@misradeviation {Advisory:,8.7} Some Melody-generated driver APIs are made available to users through external linkage. Users have the option to add these APIs in the application.This rule ID is disabled at project level due to its multiple occurrences in several files.Therefore, in the application project, this rule ID must be disabled in the MPLAB-X IDE from Tools -> Options -> Embedded -> MISRA Check.

static void I2C1_WriteStart (void )[static]

void(* I2C1_Callback) (void)[static]

const i2c_host_interface_t I2C1_Host

Initial value:

= {
    .Initialize = I2C1_Initialize,
    .Deinitialize = I2C1_Deinitialize,
    .Write = I2C1_Write,
    .Read = I2C1_Read,
    .WriteRead = I2C1_WriteRead,
    .TransferSetup = NULL,
    .ErrorGet = I2C1_ErrorGet,
    .IsBusy = I2C1_IsBusy,
    .CallbackRegister = I2C1_CallbackRegister,
    .Tasks = I2C1_Tasks
}

Represents an instance of the portable interface structure designed for I2C1 host.

volatile i2c_host_event_status_t i2c1Status = {0}

volatile i2c_host_event_status_t i2c1Status

volatile i2c_host_event_status_t i2c1Status

typedef struct i2c_transfer_setup i2c_host_transfer_setup_t

@misradeviation{Advisory:,2.4,Advisory:,2.3} These declarations are provided by the Melody-generated drivers for the user’s application. It is up to the user if these declarations will be implemented in their application.

typedef struct i2c_transfer_setup i2c_host_transfer_setup_t

@misradeviation{Advisory:,2.4,Advisory:,2.3} These declarations are provided by the Melody-generated drivers for the user’s application. It is up to the user if these declarations will be implemented in their application.

enum i2c_host_error_t