Classes
struct	I2C_XFER_T
	Master transfer data structure definitions. More...

struct	LPC_I2C_T
	I2C register block structure. More...

Macros
#define	I2C_BYTE_RECV 0x02

#define	I2C_BYTE_SENT 0x01

#define	I2C_CheckError(ErrorCode) (ErrorCode & 0x10000000)

#define	I2C_CON_AA (1UL << 2)

#define	I2C_CON_I2EN (1UL << 6)

#define	I2C_CON_SI (1UL << 3)

#define	I2C_CON_STA (1UL << 5)

#define	I2C_CON_STO (1UL << 4)

#define	I2C_ERR (0x10000000)

#define	I2C_I2ADR_BITMASK ((0xFF))

#define	I2C_I2ADR_GC ((1 << 0))

#define	I2C_I2CONCLR_AAC ((1 << 2))

#define	I2C_I2CONCLR_I2ENC ((1 << 6))

#define	I2C_I2CONCLR_SIC ((1 << 3))

#define	I2C_I2CONCLR_STAC ((1 << 5))

#define	I2C_I2CONCLR_STOC ((1 << 4))

#define	I2C_I2CONSET_AA ((0x04))

#define	I2C_I2CONSET_I2EN ((0x40))

#define	I2C_I2CONSET_SI ((0x08))

#define	I2C_I2CONSET_STA ((0x20))

#define	I2C_I2CONSET_STO ((0x10))

#define	I2C_I2DAT_BITMASK ((0xFF))

#define	I2C_I2DAT_IDLE_CHAR (0xFF)

#define	I2C_I2MASK_MASK(n) ((n & 0xFE))

#define	I2C_I2MMCTRL_BITMASK ((0x07))

#define	I2C_I2MMCTRL_ENA_SCL ((1 << 1))

#define	I2C_I2MMCTRL_MATCH_ALL ((1 << 2))

#define	I2C_I2MMCTRL_MM_ENA ((1 << 0))

#define	I2C_I2SCLH_BITMASK ((0xFFFF))

#define	I2C_I2SCLL_BITMASK ((0xFFFF))

#define	I2C_I2STAT_BUS_ERROR ((0x00))

#define	I2C_I2STAT_M_RX_ARB_LOST ((0x38))

#define	I2C_I2STAT_M_RX_DAT_ACK ((0x50))

#define	I2C_I2STAT_M_RX_DAT_NACK ((0x58))

#define	I2C_I2STAT_M_RX_RESTART ((0x10))

#define	I2C_I2STAT_M_RX_SLAR_ACK ((0x40))

#define	I2C_I2STAT_M_RX_SLAR_NACK ((0x48))

#define	I2C_I2STAT_M_RX_START ((0x08))

#define	I2C_I2STAT_M_TX_ARB_LOST ((0x38))

#define	I2C_I2STAT_M_TX_DAT_ACK ((0x28))

#define	I2C_I2STAT_M_TX_DAT_NACK ((0x30))

#define	I2C_I2STAT_M_TX_RESTART ((0x10))

#define	I2C_I2STAT_M_TX_SLAW_ACK ((0x18))

#define	I2C_I2STAT_M_TX_SLAW_NACK ((0x20))

#define	I2C_I2STAT_M_TX_START ((0x08))

#define	I2C_I2STAT_NO_INF ((0xF8))

#define	I2C_I2STAT_S_RX_ARB_LOST_M_GENCALL ((0x78))

#define	I2C_I2STAT_S_RX_ARB_LOST_M_SLA ((0x68))

#define	I2C_I2STAT_S_RX_GENCALL_ACK ((0x70))

#define	I2C_I2STAT_S_RX_PRE_GENCALL_DAT_ACK ((0x90))

#define	I2C_I2STAT_S_RX_PRE_GENCALL_DAT_NACK ((0x98))

#define	I2C_I2STAT_S_RX_PRE_SLA_DAT_ACK ((0x80))

#define	I2C_I2STAT_S_RX_PRE_SLA_DAT_NACK ((0x88))

#define	I2C_I2STAT_S_RX_SLAW_ACK ((0x60))

#define	I2C_I2STAT_S_RX_STA_STO_SLVREC_SLVTRX ((0xA0))

#define	I2C_I2STAT_S_TX_ARB_LOST_M_SLA ((0xB0))

#define	I2C_I2STAT_S_TX_DAT_ACK ((0xB8))

#define	I2C_I2STAT_S_TX_DAT_NACK ((0xC0))

#define	I2C_I2STAT_S_TX_LAST_DAT_ACK ((0xC8))

#define	I2C_I2STAT_S_TX_SLAR_ACK ((0xA8))

#define	I2C_LAST_BYTE_RECV 0x04

#define	I2C_MONITOR_CFG_MATCHALL I2C_I2MMCTRL_MATCH_ALL

#define	I2C_MONITOR_CFG_SCL_OUTPUT I2C_I2MMCTRL_ENA_SCL

#define	I2C_NAK_RECV (0x10000000 \| 0x01)

#define	I2C_OK 0x00

#define	I2C_RECV_END 0x10

#define	I2C_SEND_END 0x08

#define	I2C_SETUP_STATUS_ARBF (1 << 8)

#define	I2C_SETUP_STATUS_DONE (1 << 10)

#define	I2C_SETUP_STATUS_NOACKF (1 << 9)

#define	I2C_SLAVE_TIME_OUT 0x10000000UL

#define	I2C_STA_STO_RECV 0x20
	I2C state handle return values. More...

#define	I2C_STA_STO_RECV 0x20
	I2C state handle return values. More...

#define	I2C_STAT_CODE_BITMASK ((0xF8))

#define	I2C_STAT_CODE_ERROR ((0xFF))

#define	I2DATA_BUFFER_BITMASK ((0xFF))

#define	RET_SLAVE_BUSY 0

#define	RET_SLAVE_IDLE 2

#define	RET_SLAVE_RX 5

#define	RET_SLAVE_TX 6
	Return values for SLAVE handler. More...

Typedefs
typedef void(*	I2C_EVENTHANDLER_T) (I2C_ID_T, I2C_EVENT_T)
	Event handler function type. More...

typedef enum I2C_ID	I2C_ID_T
	I2C interface IDs. More...

Enumerations
enum	I2C_EVENT_T { I2C_EVENT_WAIT = 1, I2C_EVENT_DONE, I2C_EVENT_LOCK, I2C_EVENT_UNLOCK, I2C_EVENT_SLAVE_RX, I2C_EVENT_SLAVE_TX }
	I2C master events. More...

enum	I2C_ID { I2C0, I2C_NUM_INTERFACE }
	I2C interface IDs. More...

enum	I2C_SLAVE_ID { I2C_SLAVE_GENERAL, I2C_SLAVE_0, I2C_SLAVE_1, I2C_SLAVE_2, I2C_SLAVE_3, I2C_SLAVE_NUM_INTERFACE }
	I2C Slave Identifiers. More...

enum	I2C_STATUS_T { I2C_STATUS_DONE, I2C_STATUS_NAK, I2C_STATUS_ARBLOST, I2C_STATUS_BUSERR, I2C_STATUS_BUSY }
	I2C transfer status. More...

Functions
void	Chip_I2C_DeInit (I2C_ID_T id)
	De-initializes the I2C peripheral registers to their default reset values. More...

void	Chip_I2C_Disable (I2C_ID_T id)
	Disable I2C peripheral's operation. More...

void	Chip_I2C_EventHandler (I2C_ID_T id, I2C_EVENT_T event)
	Default event handler for interrupt base operation. More...

void	Chip_I2C_EventHandlerPolling (I2C_ID_T id, I2C_EVENT_T event)
	Default event handler for polling operation. More...

uint32_t	Chip_I2C_GetClockRate (I2C_ID_T id)
	Get current clock rate for LPC_I2C peripheral. More...

I2C_EVENTHANDLER_T	Chip_I2C_GetMasterEventHandler (I2C_ID_T id)
	Get pointer to current function handling the events. More...

void	Chip_I2C_Init (I2C_ID_T id)
	Initializes the LPC_I2C peripheral with specified parameter. More...

int	Chip_I2C_IsMasterActive (I2C_ID_T id)
	Checks if master xfer in progress. More...

int	Chip_I2C_IsStateChanged (I2C_ID_T id)
	I2C peripheral state change checking. More...

int	Chip_I2C_MasterCmdRead (I2C_ID_T id, uint8_t slaveAddr, uint8_t cmd, uint8_t *buff, int len)
	Transfer a command to slave and receive data from slave after a repeated start. More...

int	Chip_I2C_MasterRead (I2C_ID_T id, uint8_t slaveAddr, uint8_t *buff, int len)
	Set function that must handle I2C events. More...

int	Chip_I2C_MasterSend (I2C_ID_T id, uint8_t slaveAddr, const uint8_t *buff, uint8_t len)
	Transmit data to I2C slave using I2C Master mode. More...

void	Chip_I2C_MasterStateHandler (I2C_ID_T id)
	I2C Master transfer state change handler. More...

int	Chip_I2C_MasterTransfer (I2C_ID_T id, I2C_XFER_T *xfer)
	Transmit and Receive data in master mode. More...

void	Chip_I2C_SetClockRate (I2C_ID_T id, uint32_t clockrate)
	Set up clock rate for LPC_I2C peripheral. More...

int	Chip_I2C_SetMasterEventHandler (I2C_ID_T id, I2C_EVENTHANDLER_T event)
	Set function that must handle I2C events. More...

void	Chip_I2C_SlaveSetup (I2C_ID_T id, I2C_SLAVE_ID sid, I2C_XFER_T *xfer, I2C_EVENTHANDLER_T event, uint8_t addrMask)
	Setup a slave I2C device. More...

void	Chip_I2C_SlaveStateHandler (I2C_ID_T id)
	I2C Slave event handler. More...

Detailed Description

Macro Definition Documentation

◆ I2C_BYTE_RECV

#define I2C_BYTE_RECV 0x02

Definition at line 221 of file i2c_11xx.h.

◆ I2C_BYTE_SENT

#define I2C_BYTE_SENT 0x01

Definition at line 220 of file i2c_11xx.h.

◆ I2C_CheckError

#define I2C_CheckError ( ErrorCode ) (ErrorCode & 0x10000000)

Definition at line 230 of file i2c_11xx.h.

◆ I2C_CON_AA

#define I2C_CON_AA (1UL << 2)

Assert acknowledge bit

Definition at line 101 of file i2c_11xx.h.

◆ I2C_CON_I2EN

#define I2C_CON_I2EN (1UL << 6)

I2C interface bit

Definition at line 105 of file i2c_11xx.h.

◆ I2C_CON_SI

#define I2C_CON_SI (1UL << 3)

I2C interrupt bit

Definition at line 102 of file i2c_11xx.h.

◆ I2C_CON_STA

#define I2C_CON_STA (1UL << 5)

START flag bit

Definition at line 104 of file i2c_11xx.h.

◆ I2C_CON_STO

#define I2C_CON_STO (1UL << 4)

I2C STOP bit

Definition at line 103 of file i2c_11xx.h.

◆ I2C_ERR

#define I2C_ERR (0x10000000)

Definition at line 227 of file i2c_11xx.h.

◆ I2C_I2ADR_BITMASK

#define I2C_I2ADR_BITMASK ((0xFF))

I2C Slave Address registers bit mask

Definition at line 192 of file i2c_11xx.h.

◆ I2C_I2ADR_GC

#define I2C_I2ADR_GC ((1 << 0))

General Call enable bit

Definition at line 191 of file i2c_11xx.h.

◆ I2C_I2CONCLR_AAC

#define I2C_I2CONCLR_AAC ((1 << 2))

Assert acknowledge Clear bit

Definition at line 92 of file i2c_11xx.h.

◆ I2C_I2CONCLR_I2ENC

#define I2C_I2CONCLR_I2ENC ((1 << 6))

I2C interface Disable bit

Definition at line 96 of file i2c_11xx.h.

◆ I2C_I2CONCLR_SIC

#define I2C_I2CONCLR_SIC ((1 << 3))

I2C interrupt Clear bit

Definition at line 93 of file i2c_11xx.h.

◆ I2C_I2CONCLR_STAC

#define I2C_I2CONCLR_STAC ((1 << 5))

START flag Clear bit

Definition at line 95 of file i2c_11xx.h.

◆ I2C_I2CONCLR_STOC

#define I2C_I2CONCLR_STOC ((1 << 4))

I2C STOP Clear bit

Definition at line 94 of file i2c_11xx.h.

◆ I2C_I2CONSET_AA

#define I2C_I2CONSET_AA ((0x04))

Assert acknowledge flag

Definition at line 83 of file i2c_11xx.h.

◆ I2C_I2CONSET_I2EN

#define I2C_I2CONSET_I2EN ((0x40))

I2C interface enable

Definition at line 87 of file i2c_11xx.h.

◆ I2C_I2CONSET_SI

#define I2C_I2CONSET_SI ((0x08))

I2C interrupt flag

Definition at line 84 of file i2c_11xx.h.

◆ I2C_I2CONSET_STA

#define I2C_I2CONSET_STA ((0x20))

START flag

Definition at line 86 of file i2c_11xx.h.

◆ I2C_I2CONSET_STO

#define I2C_I2CONSET_STO ((0x10))

STOP flag

Definition at line 85 of file i2c_11xx.h.

◆ I2C_I2DAT_BITMASK

#define I2C_I2DAT_BITMASK ((0xFF))

Mask for I2DAT register

Definition at line 171 of file i2c_11xx.h.

◆ I2C_I2DAT_IDLE_CHAR

#define I2C_I2DAT_IDLE_CHAR (0xFF)

Idle data value will be send out in slave mode in case of the actual expecting data requested from the master is greater than its sending data length that can be supported

Definition at line 172 of file i2c_11xx.h.

◆ I2C_I2MASK_MASK

#define I2C_I2MASK_MASK ( n ) ((n & 0xFE))

I2C Mask Register mask field

Definition at line 197 of file i2c_11xx.h.

◆ I2C_I2MMCTRL_BITMASK

#define I2C_I2MMCTRL_BITMASK ((0x07))

Mask for I2MMCTRL register

Definition at line 181 of file i2c_11xx.h.

◆ I2C_I2MMCTRL_ENA_SCL

#define I2C_I2MMCTRL_ENA_SCL ((1 << 1))

SCL output enable

Definition at line 179 of file i2c_11xx.h.

◆ I2C_I2MMCTRL_MATCH_ALL

#define I2C_I2MMCTRL_MATCH_ALL ((1 << 2))

Select interrupt register match

Definition at line 180 of file i2c_11xx.h.

◆ I2C_I2MMCTRL_MM_ENA

#define I2C_I2MMCTRL_MM_ENA ((1 << 0))

Monitor mode enable

Definition at line 178 of file i2c_11xx.h.

◆ I2C_I2SCLH_BITMASK

#define I2C_I2SCLH_BITMASK ((0xFFFF))

I2C SCL HIGH duty cycle Register bit mask

Definition at line 202 of file i2c_11xx.h.

◆ I2C_I2SCLL_BITMASK

#define I2C_I2SCLL_BITMASK ((0xFFFF))

I2C SCL LOW duty cycle Register bit mask

Definition at line 207 of file i2c_11xx.h.

◆ I2C_I2STAT_BUS_ERROR

#define I2C_I2STAT_BUS_ERROR ((0x00))

Bus Error

Definition at line 117 of file i2c_11xx.h.

◆ I2C_I2STAT_M_RX_ARB_LOST

#define I2C_I2STAT_M_RX_ARB_LOST ((0x38))

Arbitration lost

Definition at line 135 of file i2c_11xx.h.

◆ I2C_I2STAT_M_RX_DAT_ACK

#define I2C_I2STAT_M_RX_DAT_ACK ((0x50))

Data has been received, ACK has been returned

Definition at line 138 of file i2c_11xx.h.

◆ I2C_I2STAT_M_RX_DAT_NACK

#define I2C_I2STAT_M_RX_DAT_NACK ((0x58))

Data has been received, NACK has been returned

Definition at line 139 of file i2c_11xx.h.

◆ I2C_I2STAT_M_RX_RESTART

#define I2C_I2STAT_M_RX_RESTART ((0x10))

A repeat start condition has been transmitted

Definition at line 134 of file i2c_11xx.h.

◆ I2C_I2STAT_M_RX_SLAR_ACK

#define I2C_I2STAT_M_RX_SLAR_ACK ((0x40))

SLA+R has been transmitted, ACK has been received

Definition at line 136 of file i2c_11xx.h.

◆ I2C_I2STAT_M_RX_SLAR_NACK

#define I2C_I2STAT_M_RX_SLAR_NACK ((0x48))

SLA+R has been transmitted, NACK has been received

Definition at line 137 of file i2c_11xx.h.

◆ I2C_I2STAT_M_RX_START

#define I2C_I2STAT_M_RX_START ((0x08))

A start condition has been transmitted

Definition at line 133 of file i2c_11xx.h.

◆ I2C_I2STAT_M_TX_ARB_LOST

#define I2C_I2STAT_M_TX_ARB_LOST ((0x38))

Arbitration lost in SLA+R/W or Data bytes

Definition at line 128 of file i2c_11xx.h.

◆ I2C_I2STAT_M_TX_DAT_ACK

#define I2C_I2STAT_M_TX_DAT_ACK ((0x28))

Data has been transmitted, ACK has been received

Definition at line 126 of file i2c_11xx.h.

◆ I2C_I2STAT_M_TX_DAT_NACK

#define I2C_I2STAT_M_TX_DAT_NACK ((0x30))

Data has been transmitted, NACK has been received

Definition at line 127 of file i2c_11xx.h.

◆ I2C_I2STAT_M_TX_RESTART

#define I2C_I2STAT_M_TX_RESTART ((0x10))

A repeat start condition has been transmitted

Definition at line 123 of file i2c_11xx.h.

◆ I2C_I2STAT_M_TX_SLAW_ACK

#define I2C_I2STAT_M_TX_SLAW_ACK ((0x18))

SLA+W has been transmitted, ACK has been received

Definition at line 124 of file i2c_11xx.h.

◆ I2C_I2STAT_M_TX_SLAW_NACK

#define I2C_I2STAT_M_TX_SLAW_NACK ((0x20))

SLA+W has been transmitted, NACK has been received

Definition at line 125 of file i2c_11xx.h.

◆ I2C_I2STAT_M_TX_START

#define I2C_I2STAT_M_TX_START ((0x08))

A start condition has been transmitted

Definition at line 122 of file i2c_11xx.h.

◆ I2C_I2STAT_NO_INF

#define I2C_I2STAT_NO_INF ((0xF8))

No relevant information

Definition at line 116 of file i2c_11xx.h.

◆ I2C_I2STAT_S_RX_ARB_LOST_M_GENCALL

#define I2C_I2STAT_S_RX_ARB_LOST_M_GENCALL ((0x78))

Arbitration lost in SLA+R/W (GENERAL CALL) as master

Definition at line 148 of file i2c_11xx.h.

◆ I2C_I2STAT_S_RX_ARB_LOST_M_SLA

#define I2C_I2STAT_S_RX_ARB_LOST_M_SLA ((0x68))

Arbitration lost in SLA+R/W as master

Definition at line 145 of file i2c_11xx.h.

◆ I2C_I2STAT_S_RX_GENCALL_ACK

#define I2C_I2STAT_S_RX_GENCALL_ACK ((0x70))

General call address has been received, ACK has been returned

Definition at line 147 of file i2c_11xx.h.

◆ I2C_I2STAT_S_RX_PRE_GENCALL_DAT_ACK

#define I2C_I2STAT_S_RX_PRE_GENCALL_DAT_ACK ((0x90))

Previously addressed with General Call; Data has been received and ACK has been returned

Definition at line 152 of file i2c_11xx.h.

◆ I2C_I2STAT_S_RX_PRE_GENCALL_DAT_NACK

#define I2C_I2STAT_S_RX_PRE_GENCALL_DAT_NACK ((0x98))

Previously addressed with General Call; Data has been received and NOT ACK has been returned

Definition at line 153 of file i2c_11xx.h.

◆ I2C_I2STAT_S_RX_PRE_SLA_DAT_ACK

#define I2C_I2STAT_S_RX_PRE_SLA_DAT_ACK ((0x80))

Previously addressed with own SLA; Data has been received, ACK has been returned

Definition at line 150 of file i2c_11xx.h.

◆ I2C_I2STAT_S_RX_PRE_SLA_DAT_NACK

#define I2C_I2STAT_S_RX_PRE_SLA_DAT_NACK ((0x88))

Previously addressed with own SLA;Data has been received and NOT ACK has been returned

Definition at line 151 of file i2c_11xx.h.

◆ I2C_I2STAT_S_RX_SLAW_ACK

#define I2C_I2STAT_S_RX_SLAW_ACK ((0x60))

Own slave address has been received, ACK has been returned

Definition at line 144 of file i2c_11xx.h.

◆ I2C_I2STAT_S_RX_STA_STO_SLVREC_SLVTRX

#define I2C_I2STAT_S_RX_STA_STO_SLVREC_SLVTRX ((0xA0))

A STOP condition or repeated START condition has been received while still addressed as SLV/REC (Slave Receive) or SLV/TRX (Slave Transmit)

Definition at line 154 of file i2c_11xx.h.

◆ I2C_I2STAT_S_TX_ARB_LOST_M_SLA

#define I2C_I2STAT_S_TX_ARB_LOST_M_SLA ((0xB0))

Arbitration lost in SLA+R/W as master

Definition at line 161 of file i2c_11xx.h.

◆ I2C_I2STAT_S_TX_DAT_ACK

#define I2C_I2STAT_S_TX_DAT_ACK ((0xB8))

Data has been transmitted, ACK has been received

Definition at line 163 of file i2c_11xx.h.

◆ I2C_I2STAT_S_TX_DAT_NACK

#define I2C_I2STAT_S_TX_DAT_NACK ((0xC0))

Data has been transmitted, NACK has been received

Definition at line 164 of file i2c_11xx.h.

◆ I2C_I2STAT_S_TX_LAST_DAT_ACK

#define I2C_I2STAT_S_TX_LAST_DAT_ACK ((0xC8))

Last data byte in I2DAT has been transmitted (AA = 0); ACK has been received

Definition at line 165 of file i2c_11xx.h.

◆ I2C_I2STAT_S_TX_SLAR_ACK

#define I2C_I2STAT_S_TX_SLAR_ACK ((0xA8))

Own SLA+R has been received, ACK has been returned

Definition at line 160 of file i2c_11xx.h.

◆ I2C_LAST_BYTE_RECV

#define I2C_LAST_BYTE_RECV 0x04

Definition at line 222 of file i2c_11xx.h.

◆ I2C_MONITOR_CFG_MATCHALL

#define I2C_MONITOR_CFG_MATCHALL I2C_I2MMCTRL_MATCH_ALL

Select interrupt register match

Definition at line 236 of file i2c_11xx.h.

◆ I2C_MONITOR_CFG_SCL_OUTPUT

#define I2C_MONITOR_CFG_SCL_OUTPUT I2C_I2MMCTRL_ENA_SCL

SCL output enable

Definition at line 235 of file i2c_11xx.h.

◆ I2C_NAK_RECV

#define I2C_NAK_RECV (0x10000000 | 0x01)

Definition at line 228 of file i2c_11xx.h.

◆ I2C_OK

#define I2C_OK 0x00

Definition at line 219 of file i2c_11xx.h.

◆ I2C_RECV_END

#define I2C_RECV_END 0x10

Definition at line 224 of file i2c_11xx.h.

◆ I2C_SEND_END

#define I2C_SEND_END 0x08

Definition at line 223 of file i2c_11xx.h.

◆ I2C_SETUP_STATUS_ARBF

#define I2C_SETUP_STATUS_ARBF (1 << 8)

Arbitration false

Definition at line 212 of file i2c_11xx.h.

◆ I2C_SETUP_STATUS_DONE

#define I2C_SETUP_STATUS_DONE (1 << 10)

Status DONE

Definition at line 214 of file i2c_11xx.h.

◆ I2C_SETUP_STATUS_NOACKF

#define I2C_SETUP_STATUS_NOACKF (1 << 9)

No ACK returned

Definition at line 213 of file i2c_11xx.h.

◆ I2C_SLAVE_TIME_OUT

#define I2C_SLAVE_TIME_OUT 0x10000000UL

Time out in case of using I2C slave mode

Definition at line 166 of file i2c_11xx.h.

◆ I2C_STA_STO_RECV [1/2]

#define I2C_STA_STO_RECV 0x20

I2C state handle return values.

Definition at line 225 of file i2c_11xx.h.

◆ I2C_STA_STO_RECV [2/2]

#define I2C_STA_STO_RECV 0x20

I2C state handle return values.

Definition at line 225 of file i2c_11xx.h.

◆ I2C_STAT_CODE_BITMASK

#define I2C_STAT_CODE_BITMASK ((0xF8))

Return Code mask in I2C status register

Definition at line 110 of file i2c_11xx.h.

◆ I2C_STAT_CODE_ERROR

#define I2C_STAT_CODE_ERROR ((0xFF))

Return Code error mask in I2C status register

Definition at line 111 of file i2c_11xx.h.

◆ I2DATA_BUFFER_BITMASK

#define I2DATA_BUFFER_BITMASK ((0xFF))

I2C Data buffer register bit mask

Definition at line 186 of file i2c_11xx.h.

◆ RET_SLAVE_BUSY

#define RET_SLAVE_BUSY 0

Return value, when slave is busy

Definition at line 73 of file i2c_11xx.h.

◆ RET_SLAVE_IDLE

#define RET_SLAVE_IDLE 2

Return value, when slave enter idle mode

Definition at line 72 of file i2c_11xx.h.

◆ RET_SLAVE_RX

#define RET_SLAVE_RX 5

Return value, when 1 byte RX'd successfully

Definition at line 71 of file i2c_11xx.h.

◆ RET_SLAVE_TX

#define RET_SLAVE_TX 6

Return values for SLAVE handler.

Note: Chip drivers will usally be designed to match their events with this value Return value, when 1 byte TX'd successfully

Definition at line 70 of file i2c_11xx.h.

Typedef Documentation

◆ I2C_EVENTHANDLER_T

typedef void(* I2C_EVENTHANDLER_T) (I2C_ID_T, I2C_EVENT_T)

Event handler function type.

Definition at line 303 of file i2c_11xx.h.

◆ I2C_ID_T

typedef enum I2C_ID I2C_ID_T

I2C interface IDs.

Note: All Chip functions will take this as the first parameter, I2C_NUM_INTERFACE must never be used for calling any Chip functions, it is only used to find the number of interfaces available in the Chip.

Enumeration Type Documentation

◆ I2C_EVENT_T

enum I2C_EVENT_T

I2C master events.

Enumerator
I2C_EVENT_WAIT	I2C Wait event
I2C_EVENT_DONE	Done event that wakes up Wait event
I2C_EVENT_LOCK	Re-entrency lock event for I2C transfer
I2C_EVENT_UNLOCK	Re-entrency unlock event for I2C transfer
I2C_EVENT_SLAVE_RX	Slave receive event
I2C_EVENT_SLAVE_TX	Slave transmit event

Definition at line 291 of file i2c_11xx.h.

◆ I2C_ID

enum I2C_ID

I2C interface IDs.

Note: All Chip functions will take this as the first parameter, I2C_NUM_INTERFACE must never be used for calling any Chip functions, it is only used to find the number of interfaces available in the Chip.

Enumerator
I2C0	ID I2C0
I2C_NUM_INTERFACE	Number of I2C interfaces in the chip

Definition at line 283 of file i2c_11xx.h.

◆ I2C_SLAVE_ID

enum I2C_SLAVE_ID

I2C Slave Identifiers.

Enumerator
I2C_SLAVE_GENERAL	Slave ID for general calls
I2C_SLAVE_0	Slave ID fo Slave Address 0
I2C_SLAVE_1	Slave ID fo Slave Address 1
I2C_SLAVE_2	Slave ID fo Slave Address 2
I2C_SLAVE_3	Slave ID fo Slave Address 3
I2C_SLAVE_NUM_INTERFACE	Number of slave interfaces

Definition at line 241 of file i2c_11xx.h.

◆ I2C_STATUS_T

enum I2C_STATUS_T

I2C transfer status.

Enumerator
I2C_STATUS_DONE	Transfer done successfully
I2C_STATUS_NAK	NAK received during transfer
I2C_STATUS_ARBLOST	Aribitration lost during transfer
I2C_STATUS_BUSERR	Bus error in I2C transfer
I2C_STATUS_BUSY	I2C is busy doing transfer

Definition at line 253 of file i2c_11xx.h.

Function Documentation

◆ Chip_I2C_DeInit()

void Chip_I2C_DeInit ( I2C_ID_T id )

De-initializes the I2C peripheral registers to their default reset values.

Parameters

id	: I2C peripheral ID (I2C0, I2C1 ... etc)

Returns: Nothing

◆ Chip_I2C_Disable()

void Chip_I2C_Disable ( I2C_ID_T id )

Disable I2C peripheral's operation.

Parameters

id	: I2C peripheral ID (I2C0, I2C1 ... etc)

Returns: Nothing

◆ Chip_I2C_EventHandler()

void Chip_I2C_EventHandler	(	I2C_ID_T	id,
		I2C_EVENT_T	event
	)

Default event handler for interrupt base operation.

Parameters

id	: I2C peripheral ID (I2C0, I2C1 ... etc)
event	: Event ID of the event that called the function

Returns: Nothing

◆ Chip_I2C_EventHandlerPolling()

void Chip_I2C_EventHandlerPolling	(	I2C_ID_T	id,
		I2C_EVENT_T	event
	)

Default event handler for polling operation.

Parameters

id	: I2C peripheral ID (I2C0, I2C1 ... etc)
event	: Event ID of the event that called the function

Returns: Nothing

◆ Chip_I2C_GetClockRate()

uint32_t Chip_I2C_GetClockRate ( I2C_ID_T id )

Get current clock rate for LPC_I2C peripheral.

Parameters

id	: I2C peripheral ID (I2C0, I2C1 ... etc)

Returns: The current I2C peripheral clock rate

◆ Chip_I2C_GetMasterEventHandler()

I2C_EVENTHANDLER_T Chip_I2C_GetMasterEventHandler ( I2C_ID_T id )

Get pointer to current function handling the events.

Parameters

id	: I2C peripheral ID (I2C0, I2C1 ... etc)

Returns: Pointer to function handing events of I2C

◆ Chip_I2C_Init()

void Chip_I2C_Init ( I2C_ID_T id )

Initializes the LPC_I2C peripheral with specified parameter.

Parameters

id	: I2C peripheral ID (I2C0, I2C1 ... etc)

Returns: Nothing

◆ Chip_I2C_IsMasterActive()

int Chip_I2C_IsMasterActive ( I2C_ID_T id )

Checks if master xfer in progress.

Parameters

id	: I2C peripheral ID (I2C0, I2C1 ... etc)

Returns: 1 if master xfer in progress 0 otherwise

Note: This API is generally used in interrupt handler of the application to decide whether to call master state handler or to call slave state handler

◆ Chip_I2C_IsStateChanged()

int Chip_I2C_IsStateChanged ( I2C_ID_T id )

I2C peripheral state change checking.

Parameters

id	: I2C peripheral ID (I2C0, I2C1 ... etc)

Returns: 1 if I2C peripheral id has changed its state, 0 if there is no state change

Note: This function must be used by the application when the polling has to be done based on state change.

◆ Chip_I2C_MasterCmdRead()

int Chip_I2C_MasterCmdRead	(	I2C_ID_T	id,
		uint8_t	slaveAddr,
		uint8_t	cmd,
		uint8_t *	buff,
		int	len
	)

Transfer a command to slave and receive data from slave after a repeated start.

Parameters

id	: I2C peripheral ID (I2C0, I2C1 ... etc)
slaveAddr	: Slave address of the I2C device
cmd	: Command (Address/Register) to be written
buff	: Pointer to memory that will hold the data received
len	: Number of bytes to receive

Returns: Number of bytes successfully received

◆ Chip_I2C_MasterRead()

int Chip_I2C_MasterRead	(	I2C_ID_T	id,
		uint8_t	slaveAddr,
		uint8_t *	buff,
		int	len
	)

Set function that must handle I2C events.

Parameters

id	: I2C peripheral ID (I2C0, I2C1 ... etc)
slaveAddr	: Slave address from which data be read
buff	: Pointer to memory where data read be stored
len	: Number of bytes to read from slave

Returns: Number of bytes read successfully

◆ Chip_I2C_MasterSend()

int Chip_I2C_MasterSend	(	I2C_ID_T	id,
		uint8_t	slaveAddr,
		const uint8_t *	buff,
		uint8_t	len
	)

Transmit data to I2C slave using I2C Master mode.

Parameters

id	: I2C peripheral ID (I2C0, I2C1 .. etc)
slaveAddr	: Slave address to which the data be written
buff	: Pointer to buffer having the array of data
len	: Number of bytes to be transfered from buff

Returns: Number of bytes successfully transfered

◆ Chip_I2C_MasterStateHandler()

void Chip_I2C_MasterStateHandler ( I2C_ID_T id )

I2C Master transfer state change handler.

Parameters

id	: I2C peripheral ID (I2C0, I2C1 ... etc)

Returns: Nothing

Note: Usually called from the appropriate Interrupt handler

◆ Chip_I2C_MasterTransfer()

int Chip_I2C_MasterTransfer	(	I2C_ID_T	id,
		I2C_XFER_T *	xfer
	)

Transmit and Receive data in master mode.

Parameters

id	: I2C peripheral selected (I2C0, I2C1 etc)
xfer	: Pointer to a I2C_XFER_T structure see notes below

Returns: Any of I2C_STATUS_T values, xfer->txSz will have number of bytes not sent due to error, xfer->rxSz will have the number of bytes yet to be received.

Note: The parameter xfer should have its member slaveAddr initialized to the 7-Bit slave address to which the master will do the xfer, Bit0 to bit6 should have the address and Bit8 is ignored. During the transfer no code (like event handler) must change the content of the memory pointed to by xfer. The member of xfer, txBuff and txSz be initialized to the memory from which the I2C must pick the data to be transfered to slave and the number of bytes to send respectively, similarly rxBuff and rxSz must have pointer to memroy where data received from slave be stored and the number of data to get from slave respectilvely.

◆ Chip_I2C_SetClockRate()

void Chip_I2C_SetClockRate	(	I2C_ID_T	id,
		uint32_t	clockrate
	)

Set up clock rate for LPC_I2C peripheral.

Parameters

id	: I2C peripheral ID (I2C0, I2C1 ... etc)
clockrate	: Target clock rate value to initialized I2C peripheral (Hz)

Returns: Nothing

Note: Parameter clockrate for I2C0 should be from 1000 up to 1000000 (1 KHz to 1 MHz), as I2C0 support Fast Mode Plus. If the clockrate is more than 400 KHz (Fast Plus Mode) Board_I2C_EnableFastPlus() must be called prior to calling this function.

◆ Chip_I2C_SetMasterEventHandler()

int Chip_I2C_SetMasterEventHandler	(	I2C_ID_T	id,
		I2C_EVENTHANDLER_T	event
	)

Set function that must handle I2C events.

Parameters

id	: I2C peripheral ID (I2C0, I2C1 ... etc)
event	: Pointer to function that will handle the event (Should not be NULL)

Returns: 1 when successful, 0 when a transfer is on going with its own event handler

◆ Chip_I2C_SlaveSetup()

void Chip_I2C_SlaveSetup	(	I2C_ID_T	id,
		I2C_SLAVE_ID	sid,
		I2C_XFER_T *	xfer,
		I2C_EVENTHANDLER_T	event,
		uint8_t	addrMask
	)

Setup a slave I2C device.

Parameters

id	: I2C peripheral ID (I2C0, I2C1 ... etc)
sid	: I2C Slave peripheral ID (I2C_SLAVE_0, I2C_SLAVE_1 etc)
xfer	: Pointer to transfer structure (see note below for more info)
event	: Event handler for slave transfers
addrMask	: Address mask to use along with slave address (see notes below for more info)

Returns: Nothing

Note

Parameter xfer should point to a valid I2C_XFER_T structure object and must have slaveAddr initialized with 7bit Slave address (From Bit1 to Bit7), Bit0 when set enables general call handling, slaveAddr along with addrMask will be used to match the slave address. rxBuff and txBuff must point to valid buffers where slave can receive or send the data from, size of which will be provided by rxSz and txSz respectively. Function pointed to by event will be called for the following events I2C_EVENT_SLAVE_RX (One byte of data received successfully from the master and stored inside memory pointed by xfer->rxBuff, incremented the pointer and decremented the xfer->rxSz), I2C_EVENT_SLAVE_TX (One byte of data from xfer->txBuff was sent to master successfully, incremented the pointer and decremented xfer->txSz), I2C_EVENT_DONE (Master is done doing its transfers with the slave).

Bit-0 of the parameter addrMask is reserved and should always be 0. Any bit (BIT1 to BIT7) set in addrMask will make the corresponding bit in xfer->slaveAddr as don't care. Thit is, if xfer->slaveAddr is (0x10 << 1) and addrMask is (0x03 << 1) then 0x10, 0x11, 0x12, 0x13 will all be considered as valid slave addresses for the registered slave. Upon receving any event xfer->slaveAddr (BIT1 to BIT7) will hold the actual address which was received from master.

General Call Handling
Slave can receive data from master using general call address (0x00). General call handling must be setup as given below

Call Chip_I2C_SlaveSetup() with argument sid as I2C_SLAVE_GENERAL
- xfer->slaveAddr ignored, argument addrMask ignored
- function provided by event will registered to be called when slave received data using addr 0x00
- xfer->rxBuff and xfer->rxSz should be valid in argument xfer
To handle General Call only (No other slaves are configured)
- Call Chip_I2C_SlaveSetup() with sid as I2C_SLAVE_X (X=0,1,2,3)
- setup xfer with slaveAddr member set to 0, event is ignored hence can be NULL
- provide addrMask (typically 0, if not you better be knowing what you are doing)
To handler General Call when other slave is active
- Call Chip_I2C_SlaveSetup() with sid as I2C_SLAVE_X (X=0,1,2,3)
- setup xfer with slaveAddr member set to 7-Bit Slave address [from Bit1 to 7]
- Set Bit0 of xfer->slaveAddr as 1
- Provide appropriate addrMask
- Argument event must point to function, that handles events from actual slaveAddress and not the GC

Warning: If the slave has only one byte in its txBuff, once that byte is transfered to master the event handler will be called for event I2C_EVENT_DONE. If the master attempts to read more bytes in the same transfer then the slave hardware will send 0xFF to master till the end of transfer, event handler will not be called to notify this. For more info see section below

Last data handling in slave
If the user wants to implement a slave which will read a byte from a specific location over and over again whenever master reads the slave. If the user initializes the xfer->txBuff as the location to read the byte from and xfer->txSz as 1, then say, if master reads one byte; slave will send the byte read from xfer->txBuff and will call the event handler with I2C_EVENT_DONE. If the master attempts to read another byte instead of sending the byte read from xfer->txBuff the slave hardware will send 0xFF and no event will occur. To handle this issue, slave should set xfer->txSz to 2, in which case when master reads the byte event handler will be called with I2C_EVENT_SLAVE_TX, in which the slave implementation can reset the buffer and size back to original location (i.e, xfer->txBuff–, xfer->txSz++), if the master reads another byte in the same transfer, byte read from xfer->txBuff will be sent and I2C_EVENT_SLAVE_TX will be called again, and the process repeats.

◆ Chip_I2C_SlaveStateHandler()

void Chip_I2C_SlaveStateHandler ( I2C_ID_T id )

I2C Slave event handler.

Parameters

id	: I2C peripheral ID (I2C0, I2C1 ... etc)

Returns: Nothing

Classes

Macros

Typedefs

Enumerations

Functions

Detailed Description

Macro Definition Documentation

◆ I2C_BYTE_RECV

◆ I2C_BYTE_SENT

◆ I2C_CheckError

◆ I2C_CON_AA

◆ I2C_CON_I2EN

◆ I2C_CON_SI

◆ I2C_CON_STA

◆ I2C_CON_STO

◆ I2C_ERR

◆ I2C_I2ADR_BITMASK

◆ I2C_I2ADR_GC

◆ I2C_I2CONCLR_AAC

◆ I2C_I2CONCLR_I2ENC

◆ I2C_I2CONCLR_SIC

◆ I2C_I2CONCLR_STAC

◆ I2C_I2CONCLR_STOC

◆ I2C_I2CONSET_AA

◆ I2C_I2CONSET_I2EN

◆ I2C_I2CONSET_SI

◆ I2C_I2CONSET_STA

◆ I2C_I2CONSET_STO

◆ I2C_I2DAT_BITMASK

◆ I2C_I2DAT_IDLE_CHAR

◆ I2C_I2MASK_MASK

◆ I2C_I2MMCTRL_BITMASK

◆ I2C_I2MMCTRL_ENA_SCL

◆ I2C_I2MMCTRL_MATCH_ALL

◆ I2C_I2MMCTRL_MM_ENA

◆ I2C_I2SCLH_BITMASK

◆ I2C_I2SCLL_BITMASK

◆ I2C_I2STAT_BUS_ERROR

◆ I2C_I2STAT_M_RX_ARB_LOST

◆ I2C_I2STAT_M_RX_DAT_ACK

◆ I2C_I2STAT_M_RX_DAT_NACK

◆ I2C_I2STAT_M_RX_RESTART

◆ I2C_I2STAT_M_RX_SLAR_ACK

◆ I2C_I2STAT_M_RX_SLAR_NACK

◆ I2C_I2STAT_M_RX_START

◆ I2C_I2STAT_M_TX_ARB_LOST

◆ I2C_I2STAT_M_TX_DAT_ACK

◆ I2C_I2STAT_M_TX_DAT_NACK

◆ I2C_I2STAT_M_TX_RESTART

◆ I2C_I2STAT_M_TX_SLAW_ACK

◆ I2C_I2STAT_M_TX_SLAW_NACK

◆ I2C_I2STAT_M_TX_START

◆ I2C_I2STAT_NO_INF

◆ I2C_I2STAT_S_RX_ARB_LOST_M_GENCALL

◆ I2C_I2STAT_S_RX_ARB_LOST_M_SLA

◆ I2C_I2STAT_S_RX_GENCALL_ACK

◆ I2C_I2STAT_S_RX_PRE_GENCALL_DAT_ACK

◆ I2C_I2STAT_S_RX_PRE_GENCALL_DAT_NACK

◆ I2C_I2STAT_S_RX_PRE_SLA_DAT_ACK

◆ I2C_I2STAT_S_RX_PRE_SLA_DAT_NACK

◆ I2C_I2STAT_S_RX_SLAW_ACK

◆ I2C_I2STAT_S_RX_STA_STO_SLVREC_SLVTRX

◆ I2C_I2STAT_S_TX_ARB_LOST_M_SLA

◆ I2C_I2STAT_S_TX_DAT_ACK

◆ I2C_I2STAT_S_TX_DAT_NACK

◆ I2C_I2STAT_S_TX_LAST_DAT_ACK

◆ I2C_I2STAT_S_TX_SLAR_ACK

◆ I2C_LAST_BYTE_RECV

◆ I2C_MONITOR_CFG_MATCHALL

◆ I2C_MONITOR_CFG_SCL_OUTPUT

◆ I2C_NAK_RECV

◆ I2C_OK

◆ I2C_RECV_END

◆ I2C_SEND_END

◆ I2C_SETUP_STATUS_ARBF

◆ I2C_SETUP_STATUS_DONE

◆ I2C_SETUP_STATUS_NOACKF

◆ I2C_SLAVE_TIME_OUT

◆ I2C_STA_STO_RECV [1/2]

◆ I2C_STA_STO_RECV [2/2]