Registers

The abbreviations given in Column Access are explained in Section Access Types for Registers .

RTL8721Dx:

Base Address:

  • I2C0_REG : 0x41108000

  • I2C1_REG : 0x4110A000

Name

Address offset

Access

Description

REG_IC_CON

000h

R/W

REG_IC_TAR

004h

R/W

REG_IC_SAR

008h

R/W

REG_IC_HS_MAR

00Ch

R/W

REG_IC_DATA_CMD

010h

R/W

REG_IC_SS_SCL_HCNT

014h

R/W

REG_IC_SS_SCL_LCNT

018h

R/W

REG_IC_FS_SCL_HCNT

01Ch

R/W

REG_IC_FS_SCL_LCNT

020h

R/W

REG_IC_HS_SCL_HCNT

024h

R/W

REG_IC_HS_SCL_LCNT

028h

R/W

REG_IC_INTR_STAT

02Ch

R

REG_IC_INTR_MASK

030h

R/W

REG_IC_RAW_INTR_STAT

034h

R

REG_IC_RX_TL

038h

R/W

REG_IC_TX_TL

03Ch

R/W

REG_IC_CLR_INTR

040h

R

REG_IC_CLR_RX_UNDER

044h

R

REG_IC_CLR_RX_OVER

048h

R

REG_IC_CLR_TX_OVER

04Ch

R

REG_IC_CLR_RD_REQ

050h

R

REG_IC_CLR_TX_ABRT

054h

R

REG_IC_CLR_RX_DONE

058h

R

REG_IC_CLR_ACTIVITY

05Ch

R

REG_IC_CLR_STOP_DET

060h

R

REG_IC_CLR_START_DET

064h

R

REG_IC_CLR_GEN_CALL

068h

R

REG_IC_ENABLE

06Ch

R/W

REG_IC_STATUS

070h

R

REG_IC_TXFLR

074h

R

REG_IC_RXFLR

078h

R

REG_IC_SDA_HOLD

07Ch

R/W

REG_IC_TX_ABRT_SOURCE

080h

R

REG_IC_SLV_DATA_NACK_ONLY

084h

R/W

REG_IC_DMA_CR

088h

R/W

REG_IC_DMA_TDLR

08Ch

R/W

REG_IC_DMA_RDLR

090h

R/W

REG_IC_SDA_SETUP

094h

R/W

REG_IC_ACK_GENERAL_CALL

098h

R/W

REG_IC_ENABLE_STATUS

09Ch

R

REG_IC_DMA_CMD

0A0h

R/W

REG_IC_DMA_DATA_LEN

0A4h

R/W

REG_IC_DMA_MODE

0A8h

R/W

REG_IC_SLEEP

0ACh

R

REG_IC_DEBUG_SEL

0B0h

R/W

REG_IC_OUT_SMP_DLY

0B4h

R/W

REG_IC_CLR_ADDR_MATCH

0E4h

R

REG_IC_CLR_DMA_DONE

0E8h

R

REG_IC_FILTER

0ECh

R/W

REG_IC_SAR2

0F4h

R/W

REG_IC_COMP_VERSION

0FCh

R

REG_IC_DUMMY

100h

R

REG_IC_CON

  • Name: I2C Control Register

  • Size: 32

  • Address offset: 000h

  • Read/write access: R/W

31:8 RSVD 7 IC_SLAVE_DISABLE_1 6 IC_SLAVE_DISABLE_0 5 IC_RESTATRT_EN 4 RSVD 3 IC_10BITADDR_SLAVE 2:1 SPEED 0 MASTER_MODE

Bit

Symbol

Access

INI

Description

31:8

RSVD

R

-

Reserved

7

IC_SLAVE_DISABLE_1

R/W

0x0

This bit controls whether I2C has its slave2 (7-bit address) disabled.

  • 0: slave2 is enabled

  • 1: slave2 is disabled

6

IC_SLAVE_DISABLE_0

R/W

0x0

This bit controls whether I2C has its slave1 (7-bit or 10-bit address) disabled.

  • 0: slave1 is enabled

  • 1: slave1 is disabled

5

IC_RESTATRT_EN

R/W

0x0

Determine whether RESTART conditions may be sent when acting as a master.

  • 0: disable

  • 1: enable

4

RSVD

R

-

Reserved

3

IC_10BITADDR_SLAVE

R/W

0x0

When acting as a slave, this bit controls whether the I2C responds to 7- or 10-bit addresses.

  • 0: 7-bit addressing

  • 1: 10-bit addressing

2:1

SPEED

R/W

0x0

These bits control at which speed the I2C operates; its setting is relevant only if one is operating the I2C in master mode.

  • 1: standard mode (0 to 100kbit/s)

  • 2: fast mode (<=400kbit/s)

  • 3: high speed mode (<=3.4Mbit/s)

0

MASTER_MODE

R/W

0x0

This bit controls whether the I2C master is enabled.

  • 0: master disabled

  • 1: master enabled

REG_IC_TAR

  • Name: I2C Target Address Register

  • Size: 32

  • Address offset: 004h

  • Read/write access: R/W

31:13 RSVD 12 IC_10BITADDR_MASTER 11 SPECIAL 10 GC_OR_START 9:0 IC_TAR

Bit

Symbol

Access

INI

Description

31:13

RSVD

R

-

Reserved

12

IC_10BITADDR_MASTER

R/W

0x0

Control whether I2C starts its transfers in 7- or 10-bit addressing mode when acting as a master.

  • 0: 7-bit addressing

  • 1: 10-bit addressing

11

SPECIAL

R/W

0x0

This bit indicates whether software performs a General Call or START BYTE command.

  • 0: ignore bit 10 GC_OR_START and use IC_TAR normally

  • 1: perform special I2C command as specified in GC_OR_START bit

10

GC_OR_START

R/W

0x0

If SPECIAL is set to 1, then this bit indicates whether a General Call or START BYTE command is to be performed by I2C. (ic_clk domain)

  • 0: General Call - after issuing a General Call, only write may be performed

  • 1: START BYTE

9:0

IC_TAR

R/W

0x10

This is the target address for any master transaction. When transmitting a General Call, these bits are ignored. To generate a START BYTE, the CPU needs to write only once into these bits.

REG_IC_SAR

  • Name: I2C Slave Address Register

  • Size: 32

  • Address offset: 008h

  • Read/write access: R/W

31:10 RSVD 9:0 IC_SAR

Bit

Symbol

Access

INI

Description

31:10

RSVD

R

-

Reserved

9:0

IC_SAR

R/W

0x11

The IC_SAR holds the slave address when the I2C is operating as slave1. For 7-bit addressing, only IC_SAR[6:0] is used.

The register can be written only when the I2C interface is disabled, which corresponds to the IC_ENABLE register being set to 0. Writes at other times have no effect.

REG_IC_HS_MAR

  • Name: I2C High Speed Master Mode Code Address Register

  • Size: 32

  • Address offset: 00Ch

  • Read/write access: R/W

31:3 RSVD 2:0 IC_HS_MAR

Bit

Symbol

Access

INI

Description

31:3

RSVD

R

-

Reserved

2:0

IC_HS_MAR

R/W

0x0

This bit field holds the value of the I2C HS mode master code. HS-mode master codes are reserved 8-bit codes (00001xxx) that are not used for slave addressing or other purposes.

This register can be written only when the I2C interface is disabled, which corresponds to the IC_ENABLE register being set to 0. Write at other times have no effect.

REG_IC_DATA_CMD

  • Name: I2C Rx/Tx Data Buffer and Command Register

  • Size: 32

  • Address offset: 010h

  • Read/write access: R/W

31:12 RSVD 11 NULL_DATA 10 CMD_RESTART 9 CMD_STOP 8 CMD_RW 7:0 IC_DATA

Bit

Symbol

Access

INI

Description

31:12

RSVD

R

-

Reserved

11

NULL_DATA

R/W

0x0

  • 1: null data transfer

10

CMD_RESTART

R/W

0x0

This bit controls whether a RESTART is issued after the byte is sent or received.

  • 1: a RESTART is issued after the data is sent/received (according to the value of CMD_RW), regardless of whether or not the transfer direction is changing from the previous command.

9

CMD_STOP

R/W

0x0

This bit controls whether a STOP is issued after the byte is sent or received.

  • 1: STOP is issued after this byte, regardless of whether or not the Tx FIFO is empty. If the Tx FIFO is not empty, the master immediately tries to start a new transfer by issuing a START and arbitrating for the bus.

  • 0: STOP is not issued after this byte.

8

CMD_RW

R/W

0x0

This bit controls whether a read or write is performed. This bit does not control the direction when the I2C acts as a slave. It controls only the direction when it acts as a master.

  • 1: Read

  • 0: Write

7:0

IC_DATA

R/W

0x0

This register contains the data to be transmitted or received on the I2C bus. If you are writing to this register and want to perform a read, these bits are ignored by the I2C. However, when you read this register, these bits return the value of data received on the I2C interface.

REG_IC_SS_SCL_HCNT

  • Name: Standard Speed I2C Clock SCL High Count Register

  • Size: 32

  • Address offset: 014h

  • Read/write access: R/W

31:16 RSVD 15:0 IC_SS_SCL_HCNT

Bit

Symbol

Access

INI

Description

31:16

RSVD

R

-

Reserved

15:0

IC_SS_SCL_HCNT

R/W

0x0190

This register sets the SCL clock high-period count for standard speed.

This register must be set before any I2C bus transaction can take place to ensure proper I/O timing.

This register can be written only when the I2C interface is disabled which corresponds to the IC_ENABLE register being set to 0. Writes at other times have no effect.

REG_IC_SS_SCL_LCNT

  • Name: Standard Speed I2C Clock SCL Low Count Register

  • Size: 32

  • Address offset: 018h

  • Read/write access: R/W

31:16 RSVD 15:0 IC_SS_SCL_LCNT

Bit

Symbol

Access

INI

Description

31:16

RSVD

R

-

Reserved

15:0

IC_SS_SCL_LCNT

R/W

0x01D6

This register sets the SCL clock low-period count for standard speed.

This register must be set before any I2C bus transaction can take place to ensure proper I/O timing.

This register can be written only when the I2C interface is disabled which corresponds to the IC_ENABLE register being set to 0. Writes at other times have no effect.

REG_IC_FS_SCL_HCNT

  • Name: Fast Speed I2C Clock SCL High Count Register

  • Size: 32

  • Address offset: 01Ch

  • Read/write access: R/W

31:16 RSVD 15:0 IC_FS_SCL_HCNT

Bit

Symbol

Access

INI

Description

31:16

RSVD

R

-

Reserved

15:0

IC_FS_SCL_HCNT

R/W

0x003C

This register sets the SCL clock high-period count for fast speed.

This register must be set before any I2C bus transaction can take place to ensure proper I/O timing.

This register can be written only when the I2C interface is disabled which corresponds to the IC_ENABLE register being set to 0. Writes at other times have no effect.

REG_IC_FS_SCL_LCNT

  • Name: Fast Speed I2C Clock SCL Low Count Register

  • Size: 32

  • Address offset: 020h

  • Read/write access: R/W

31:16 RSVD 15:0 IC_FS_SCL_LCNT

Bit

Symbol

Access

INI

Description

31:16

RSVD

R

-

Reserved

15:0

IC_FS_SCL_LCNT

R/W

0x0082

This register sets the SCL clock low-period count for fast speed.

This register must be set before any I2C bus transaction can take place to ensure proper I/O timing.

This register can be written only when the I2C interface is disabled which corresponds to the IC_ENABLE register being set to 0. Writes at other times have no effect.

REG_IC_HS_SCL_HCNT

  • Name: High Speed I2C Clock SCL High Count Register

  • Size: 32

  • Address offset: 024h

  • Read/write access: R/W

31:16 RSVD 15:0 IC_HS_SCL_HCNT

Bit

Symbol

Access

INI

Description

31:16

RSVD

R

-

Reserved

15:0

IC_HS_SCL_HCNT

R/W

0x0006

This register sets the SCL clock high-period count for high speed.

This register must be set before any I2C bus transaction can take place to ensure proper I/O timing.

This register can be written only when the I2C interface is disabled which corresponds to the IC_ENABLE register being set to 0. Writes at other times have no effect.

The SCL High time depends on the loading of the bus. For 100pF loading, the SCL High time is 60ns; for 400pF loading, the SCL High time is 120ns.

REG_IC_HS_SCL_LCNT

  • Name: High Speed I2C Clock SCL Low Count Register

  • Size: 32

  • Address offset: 028h

  • Read/write access: R/W

31:16 RSVD 15:0 IC_HS_SCL_LCNT

Bit

Symbol

Access

INI

Description

31:16

RSVD

R

-

Reserved

15:0

IC_HS_SCL_LCNT

R/W

0x0010

This register sets the SCL clock low-period count for high speed.

This register must be set before any I2C bus transaction can take place to ensure proper I/O timing.

This register can be written only when the I2C interface is disabled which corresponds to the IC_ENABLE register being set to 0. Writes at other times have no effect.

The SCL Low time depends on the loading of the bus. For 100pF loading, the SCL High time is 160ns; for 400pF loading, the SCL High time is 320ns.

REG_IC_INTR_STAT

  • Name: I2C Interrupt Status Register

  • Size: 32

  • Address offset: 02Ch

  • Read/write access: R

31:14 RSVD 13 R_LP_WAKE_2 12 R_LP_WAKE_1 11 R_GEN_CALL 10 R_START_DET 9 R_STOP_DET 8 R_ACTIVITY 7 R_RX_DONE 6 R_TX_ABRT 5 R_RD_REQ 4 R_TX_EMPTY 3 R_TX_OVER 2 R_RX_FULL 1 R_RX_OVER 0 R_RX_UNDER

Bit

Symbol

Access

INI

Description

31:14

RSVD

R

-

Reserved

13

R_LP_WAKE_2

R

0x0

Refer to I2C Raw Interrupt Status Register (IC_RAW_INTR_STAT) for a detailed description of this bit.

12

R_LP_WAKE_1

R

0x0

Refer to I2C Raw Interrupt Status Register (IC_RAW_INTR_STAT) for a detailed description of this bit.

11

R_GEN_CALL

R

0x0

Refer to I2C Raw Interrupt Status Register (IC_RAW_INTR_STAT) for a detailed description of this bit.

10

R_START_DET

R

0x0

Refer to I2C Raw Interrupt Status Register (IC_RAW_INTR_STAT) for a detailed description of this bit.

9

R_STOP_DET

R

0x0

Refer to I2C Raw Interrupt Status Register (IC_RAW_INTR_STAT) for a detailed description of this bit.

8

R_ACTIVITY

R

0x0

Refer to I2C Raw Interrupt Status Register (IC_RAW_INTR_STAT) for a detailed description of this bit.

7

R_RX_DONE

R

0x0

Refer to I2C Raw Interrupt Status Register (IC_RAW_INTR_STAT) for a detailed description of this bit.

6

R_TX_ABRT

R

0x0

Refer to I2C Raw Interrupt Status Register (IC_RAW_INTR_STAT) for a detailed description of this bit.

5

R_RD_REQ

R

0x0

Refer to I2C Raw Interrupt Status Register (IC_RAW_INTR_STAT) for a detailed description of this bit.

4

R_TX_EMPTY

R

0x0

Refer to I2C Raw Interrupt Status Register (IC_RAW_INTR_STAT) for a detailed description of this bit.

3

R_TX_OVER

R

0x0

Refer to I2C Raw Interrupt Status Register (IC_RAW_INTR_STAT) for a detailed description of this bit.

2

R_RX_FULL

R

0x0

Refer to I2C Raw Interrupt Status Register (IC_RAW_INTR_STAT) for a detailed description of this bit.

1

R_RX_OVER

R

0x0

Refer to I2C Raw Interrupt Status Register (IC_RAW_INTR_STAT) for a detailed description of this bit.

0

R_RX_UNDER

R

0x0

Refer to I2C Raw Interrupt Status Register (IC_RAW_INTR_STAT) for a detailed description of this bit.

REG_IC_INTR_MASK

  • Name: I2C Interrupt Mask Register

  • Size: 32

  • Address offset: 030h

  • Read/write access: R/W

31:14 RSVD 13 M_LP_WAKE_2 12 M_LP_WAKE_1 11 M_GEN_CALL 10 M_START_DET 9 M_STOP_DET 8 M_ACTIVITY 7 M_RX_DONE 6 M_TX_ABRT 5 M_RD_REQ 4 M_TX_EMPTY 3 M_TX_OVER 2 M_RX_FULL 1 M_RX_OVER 0 M_RX_UNDER

Bit

Symbol

Access

INI

Description

31:14

RSVD

R

-

Reserved

13

M_LP_WAKE_2

R/W

0x0

This bit masks the corresponding interrupt status bit in the IC_INTR_STAT register.

12

M_LP_WAKE_1

R/W

0x0

This bit masks the corresponding interrupt status bit in the IC_INTR_STAT register.

11

M_GEN_CALL

R/W

0x0

This bit masks the corresponding interrupt status bit in the IC_INTR_STAT register.

10

M_START_DET

R/W

0x0

This bit masks the corresponding interrupt status bit in the IC_INTR_STAT register.

9

M_STOP_DET

R/W

0x0

This bit masks the corresponding interrupt status bit in the IC_INTR_STAT register.

8

M_ACTIVITY

R/W

0x0

This bit masks the corresponding interrupt status bit in the IC_INTR_STAT register.

7

M_RX_DONE

R/W

0x0

This bit masks the corresponding interrupt status bit in the IC_INTR_STAT register.

6

M_TX_ABRT

R/W

0x0

This bit masks the corresponding interrupt status bit in the IC_INTR_STAT register.

5

M_RD_REQ

R/W

0x0

This bit masks the corresponding interrupt status bit in the IC_INTR_STAT register.

4

M_TX_EMPTY

R/W

0x0

This bit masks the corresponding interrupt status bit in the IC_INTR_STAT register.

3

M_TX_OVER

R/W

0x0

This bit masks the corresponding interrupt status bit in the IC_INTR_STAT register.

2

M_RX_FULL

R/W

0x0

This bit masks the corresponding interrupt status bit in the IC_INTR_STAT register.

1

M_RX_OVER

R/W

0x0

This bit masks the corresponding interrupt status bit in the IC_INTR_STAT register.

0

M_RX_UNDER

R/W

0x0

This bit masks the corresponding interrupt status bit in the IC_INTR_STAT register.

REG_IC_RAW_INTR_STAT

  • Name: I2C Raw Interrupt Status Register

  • Size: 32

  • Address offset: 034h

  • Read/write access: R

31:14 RSVD 13 LP_WAKE_2 12 LP_WAKE_1 11 GEN_CALL 10 START_DET 9 STOP_DET 8 ACTIVITY 7 RX_DONE 6 TX_ABRT 5 RD_REQ 4 TX_EMPTY 3 TX_OVER 2 RX_FULL 1 RX_OVER 0 RX_UNDER

Bit

Symbol

Access

INI

Description

31:14

RSVD

R

-

Reserved

13

LP_WAKE_2

R

0x0

Set when address SAR_2 matches with address sending on I2C BUS.

12

LP_WAKE_1

R

0x0

Set when address SAR matches with address sending on I2C BUS.

11

GEN_CALL

R

0x0

Set only when a General Call address is received and it is acknowledged.

10

START_DET

R

0x0

Indicate whether a START or RESTART condition has occurred on the I2C interface regardless of whether I2C is operating in slave or master mode.

9

STOP_DET

R

0x0

Indicate whether a STOP condition has occurred on the I2C interface regardless of whether I2C is operating in slave or master mode.

8

ACTIVITY

R

0x0

This bit captures I2C activity.

7

RX_DONE

R

0x0

When the I2C is acting as a slave-transmitter, this bit is set to 1 if the master does not acknowledge a transmitted byte. This occurs on the last byte of the transmission, indicating that the transmission is done.

6

TX_ABRT

R

0x0

This bit indicates if I2C as a transmitter, is unable to complete the intended actions on the contents of the transmit FIFO. This situation can occur both as an I2C master or an I2C slave, and is referred to as a ‘transmit abort’.

  • 1: the IC_TX_ABRT_SOURCE register indicates the reason why the transmit abort take places.

5

RD_REQ

R

0x0

This bit is set to 1 when I2C is acting as a slave and another I2C master is attempting to read data from I2C. The I2C holds the I2C bus in a wait state (SCL=0) until this interrupt is serviced, which means that the slave has been addressed by a remote master that is asking for data to be transferred. The processor must respond to this interrupt and then write the requested data to the IC_DATA_CMD register.

4

TX_EMPTY

R

0x0

This bit is set to 1 when the transmit buffer is at or below the threshold value set in the IC_TX_TL register. It is automatically cleared by hardware when the buffer level goes above the threshold.

3

TX_OVER

R

0x0

Set during transmit if the transmit buffer is filled to IC_TX_BUFFER_DEPTH and the processor attempts to issue another I2C command by writing to the IC_DATA_CMD register.

2

RX_FULL

R

0x0

Set when the receive buffer goes above the RX_TL threshold in the IC_RX_TL register. It is automatically cleared by hardware when buffer level is equal to or less than the threshold.

1

RX_OVER

R

0x0

Not used. Set if the receive buffer is completely filled to IC_RX_BUFFER_DEPTH and an additional byte is received from an external I2C device.

0

RX_UNDER

R

0x0

Set if the processor attempts to read the receive buffer when it is empty by reading from the IC_DATA_CMD register.

REG_IC_RX_TL

  • Name: I2C Receive FIFO Threshold Register

  • Size: 32

  • Address offset: 038h

  • Read/write access: R/W

31:8 RSVD 7:0 IC_RX_0_TL

Bit

Symbol

Access

INI

Description

31:8

RSVD

R

-

Reserved

7:0

IC_RX_0_TL

R/W

0x0

Receive FIFO Threshold Level.

Control the level of entries (or above) that triggers the RX_FULL interrupt (bit[2] in IC_RAW_INTR_STAT register).

REG_IC_TX_TL

  • Name: I2C Transmit FIFO Threshold Register

  • Size: 32

  • Address offset: 03Ch

  • Read/write access: R/W

31:8 RSVD 7:0 IC_TX_0_TL

Bit

Symbol

Access

INI

Description

31:8

RSVD

R

-

Reserved

7:0

IC_TX_0_TL

R/W

0x0

Transmit FIFO Threshold Level.

Control the level of entries (or below) that triggers the TX_EMPTY interrupt (bit[4] in IC_RAW_INTR_STAT register).

REG_IC_CLR_INTR

  • Name: Clear Combined and Individual Interrupt Register

  • Size: 32

  • Address offset: 040h

  • Read/write access: R

31:1 RSVD 0 CLR_INRT

Bit

Symbol

Access

INI

Description

31:1

RSVD

R

-

Reserved

0

CLR_INRT

R

0x0

Read this register to clear the combined interrupt, all individual interrupts, and the IC_TX_ABRT_SOURCE register. This bit does not clear hardware clearable interrupts but software clearable interrupts.

REG_IC_CLR_RX_UNDER

  • Name: Clear RX_UNDER Interrupt Register

  • Size: 32

  • Address offset: 044h

  • Read/write access: R

31:1 RSVD 0 CLR_RX_UNDER

Bit

Symbol

Access

INI

Description

31:1

RSVD

R

-

Reserved

0

CLR_RX_UNDER

R

0x0

Read this register to clear the RX_UNDER interrupt (bit[0]) of IC_RAW_INTR_STAT register.

REG_IC_CLR_RX_OVER

  • Name: Clear RX_OVER Interrupt Register

  • Size: 32

  • Address offset: 048h

  • Read/write access: R

31:1 RSVD 0 CLR_RX_OVER

Bit

Symbol

Access

INI

Description

31:1

RSVD

R

-

Reserved

0

CLR_RX_OVER

R

0x0

Read this register to clear the RX_OVER interrupt (bit[1]) of IC_RAW_INTR_STAT register.

REG_IC_CLR_TX_OVER

  • Name: Clear TX_OVER Interrupt Register

  • Size: 32

  • Address offset: 04Ch

  • Read/write access: R

31:1 RSVD 0 CLR_TX_OVER

Bit

Symbol

Access

INI

Description

31:1

RSVD

R

-

Reserved

0

CLR_TX_OVER

R

0x0

Read this register to clear the TX_OVER interrupt (bit[3]) of IC_RAW_INTR_STAT register.

REG_IC_CLR_RD_REQ

  • Name: Clear RD_REQ Interrupt Register

  • Size: 32

  • Address offset: 050h

  • Read/write access: R

31:1 RSVD 0 CLR_RD_REQ

Bit

Symbol

Access

INI

Description

31:1

RSVD

R

-

Reserved

0

CLR_RD_REQ

R

0x0

Read this register to clear the RD_REQ interrupt (bit[5]) of IC_RAW_INTR_STAT register.

REG_IC_CLR_TX_ABRT

  • Name: Clear TX_ABRT Interrupt Register

  • Size: 32

  • Address offset: 054h

  • Read/write access: R

31:1 RSVD 0 CLR_TX_ABRT

Bit

Symbol

Access

INI

Description

31:1

RSVD

R

-

Reserved

0

CLR_TX_ABRT

R

0x0

Read this register to clear the TX_ABRT interrupt (bit[6]) of IC_RAW_INTR_STAT register and the IC_TX_ABRT_SOURCE register. This also releases the TxFIFO from the flushed/reset state, allowing more writes to the Tx FIFO.

REG_IC_CLR_RX_DONE

  • Name: Clear RX_DONE Interrupt Register

  • Size: 32

  • Address offset: 058h

  • Read/write access: R

31:1 RSVD 0 CLR_RX_DONE

Bit

Symbol

Access

INI

Description

31:1

RSVD

R

-

Reserved

0

CLR_RX_DONE

R

0x0

Read this register to clear the RX_DONE interrupt (bit[7]) of IC_RAW_INTR_STAT register.

REG_IC_CLR_ACTIVITY

  • Name: Clear ACTIVITY Interrupt Register

  • Size: 32

  • Address offset: 05Ch

  • Read/write access: R

31:1 RSVD 0 CLR_ACTIVITY

Bit

Symbol

Access

INI

Description

31:1

RSVD

R

-

Reserved

0

CLR_ACTIVITY

R

0x0

Read this register to clear the ACTIVITY interrupt if the I2C is not active anymore. If the I2C module is still active on the bus, the ACTIVITY interrupt bit continues to be set. It is automatically cleared by hardware if the module is disabled and if there is no further activity on the bus. The value read from this register to get status of the ACTIVITY interrupt (bit[8]) of the IC_RAW_INTR_STAT register.

REG_IC_CLR_STOP_DET

  • Name: Clear STOP_DET Interrupt Register

  • Size: 32

  • Address offset: 060h

  • Read/write access: R

31:1 RSVD 0 CLR_STOP_DET

Bit

Symbol

Access

INI

Description

31:1

RSVD

R

-

Reserved

0

CLR_STOP_DET

R

0x0

Read this register to clear the STOP_DET interrupt (bit[9]) of IC_RAW_INTR_STAT register.

REG_IC_CLR_START_DET

  • Name: Clear START_DET Interrupt Register

  • Size: 32

  • Address offset: 064h

  • Read/write access: R

31:1 RSVD 0 CLR_START_DET

Bit

Symbol

Access

INI

Description

31:1

RSVD

R

-

Reserved

0

CLR_START_DET

R

0x0

Read this register to clear the START_DET interrupt (bit[10]) of IC_RAW_INTR_STAT register.

REG_IC_CLR_GEN_CALL

  • Name: Clear GEN_ALL Interrupt Register

  • Size: 32

  • Address offset: 068h

  • Read/write access: R

31:1 RSVD 0 CLR_GEN_CALL

Bit

Symbol

Access

INI

Description

31:1

RSVD

R

-

Reserved

0

CLR_GEN_CALL

R

0x0

Read this register to clear the GEN_CALL interrupt (bit[11]) of IC_RAW_INTR_STAT register.

REG_IC_ENABLE

  • Name: I2C Enable Register

  • Size: 32

  • Address offset: 06Ch

  • Read/write access: R/W

31:2 RSVD 1 FORCE 0 ENABLE

Bit

Symbol

Access

INI

Description

31:2

RSVD

R

-

Reserved

1

FORCE

R/W

0x0

Force master I2C stop transfer immediately after IC_ENABLE set 0.

  • 1: when IC_ENABLE is set 0 during transfer, force master FSM go to IDLE immediately.

  • 0: when IC_ENABLE is set 0 during transfer, master FSM while finish current transition (include RESTART) before go to IDLE.

0

ENABLE

R/W

0x0

Control whether the I2C is enabled.

  • 0: Disable I2C (Tx and Rx FIFOs are held in an erased state)

  • 1: Enable I2C

REG_IC_STATUS

  • Name: I2C Status Register

  • Size: 32

  • Address offset: 070h

  • Read/write access: R

31:7 RSVD 6 SLV_ACTIVITY 5 MST_ACTIVITY 4 RFF 3 RFNE 2 TFE 1 TFNF 0 IC_ACTIVITY

Bit

Symbol

Access

INI

Description

31:7

RSVD

R

-

Reserved

6

SLV_ACTIVITY

R

0x0

Slave FSM Activity Status. When the Slave FSM is not in the IDLE state, this bit is set.

  • 0: Slave FSM is in the IDLE state so the slave part of I2C is not active

  • 1: Slave FSM is not he IDLE state so the slave part of I2C is active

5

MST_ACTIVITY

R

0x0

Master FSM Activity Status. When the Master FSM is not in the IDLE state, this bit is set.

  • 0: Master FSM is in the IDLE state so the master part of I2C is not active

  • 1: Master FSM is not he IDLE state so the master part of I2C is active

4

RFF

R

0x0

Receive FIFO Completely Full. When the receive FIFO is completely full, this bit is set. When the receive FIFO contains one or more empty location, this bit is cleared.

  • 0: Receive FIFO is not full

  • 1: Receive FIFO is full

3

RFNE

R

0x0

Receive FIFO Not Empty. This bit is set when the receive FIFO contains one or more entries; it is cleared when the receive FIFO is empty.

  • 0: Receive FIFO is empty

  • 1: Receive FIFO is not empty

2

TFE

R

0x1

Transmit FIFO Completely Empty. When the transmit FIFO is completely empty, this bit is set. When it contains one or more valid entries, this bit is cleared. This bit field does not request an interrupt.

  • 0: Transmit FIFO is not empty

  • 1: Transmit FIFO is empty

1

TFNF

R

0x1

Transmit FIFO Not Full. Set when the transmit FIFO contains one or more empty locations, and is cleared when the FIFO is full.

  • 0: Transmit FIFO is full

  • 1: Transmit FIFO is not full

0

IC_ACTIVITY

R

0x0

I2C Activity Status.

REG_IC_TXFLR

  • Name: I2C Transmit FIFO Level Register

  • Size: 32

  • Address offset: 074h

  • Read/write access: R

31:6 RSVD 5:0 TXFLR

Bit

Symbol

Access

INI

Description

31:6

RSVD

R

-

Reserved

5:0

TXFLR

R

0x0

Transmit FIFO Level. Contains the number of valid data entries in the transmit FIFO.

REG_IC_RXFLR

  • Name: I2C Receive FIFO Level Register

  • Size: 32

  • Address offset: 078h

  • Read/write access: R

31:6 RSVD 5:0 RXFLR

Bit

Symbol

Access

INI

Description

31:6

RSVD

R

-

Reserved

5:0

RXFLR

R

0x0

Receive FIFO Level. Contains the number of valid data entries in the receive FIFO.

REG_IC_SDA_HOLD

  • Name: I2C SDA Hold Time Length Register

  • Size: 32

  • Address offset: 07Ch

  • Read/write access: R/W

31:16 RSVD 15:0 IC_SDA_HOLD

Bit

Symbol

Access

INI

Description

31:16

RSVD

R

-

Reserved

15:0

IC_SDA_HOLD

R/W

0x1

Set the required SDA hold time in units of ic_clk period.

REG_IC_TX_ABRT_SOURCE

  • Name: I2C Transmit Abort Source Register

  • Size: 32

  • Address offset: 080h

  • Read/write access: R

31:15 RSVD 14 ABRT_SLV_ARBLOST 13 ABRT_SLVFLUSH_TXFIFO 12 ARBT_LOST 11 ABRT_MASTER_DIS 10 ABRT_10B_RD_NORSTRT 9 ABRT_SBYTE_NORSTRT 8 ABRT_HS_NORSTRT 7 ABRT_SBYTE_ACKDET 6 ABRT_HS_ACKDET 5 ABRT_GCALL_READ 4 ABRT_GCALL_NOACK 3 ABRT_TXDATA_NOACK 2 ABRT_10ADDR2_NOACK 1 ABRT_10ADDR1_NOACK 0 ABRT_7B_ADDR_NOACK

Bit

Symbol

Access

INI

Description

31:15

RSVD

R

-

Reserved

14

ABRT_SLV_ARBLOST

R

0x0

  • 1: Slave losts the bus while transmitting data to a remote master. IC_TX_ABRT_SOURCE[12] is set at the same time.

13

ABRT_SLVFLUSH_TXFIFO

R

0x0

  • 1: Slave has received a read command and some data exists in the TXFIFO so the slave issues a TX_ABRT interrupt to flush old data in Tx FIFO.

12

ARBT_LOST

R

0x0

  • 1: Master has lost arbitration, or if IC_TX_ABRT_SOURCE[14] is also set, then the slave transmitter has lost arbitration.

11

ABRT_MASTER_DIS

R

0x0

  • 1: User tries to initiate a Master operation with the master mode disabled.

10

ABRT_10B_RD_NORSTRT

R

0x0

  • 1: The restart is disabled and the master sends a read command in 10-bit addressing mode.

9

ABRT_SBYTE_NORSTRT

R

0x0

  • 1: The restart is disabled and the user is trying to send a START Byte.

8

ABRT_HS_NORSTRT

R

0x0

  • 1: The restart is disabled and the user is trying to use the master to transfer data in High Speed mode.

7

ABRT_SBYTE_ACKDET

R

0x0

  • 1: Master has send a START Byte and the START Byte was acknowledged (wrong behavior).

6

ABRT_HS_ACKDET

R

0x0

  • 1: Master is in High Speed mode and the High Speed Master code was acknowledged (wrong behavior).

5

ABRT_GCALL_READ

R

0x0

  • 1: I2C in master mode sents a General Call but the user programmed the byte following the General Call to be a read from the bus.

4

ABRT_GCALL_NOACK

R

0x0

  • 1: I2C in master mode sents a General Call and no slave on the bus acknowledged the General Call.

3

ABRT_TXDATA_NOACK

R

0x0

  • 1: This is a master-mode only bit. Master has received an acknowledgement for the address, but when it sent data byte(s) following the address, it did not receive an acknowledge from the remote slave(s).

2

ABRT_10ADDR2_NOACK

R

0x0

  • 1: Master is in 10-bit address mode and the second byte of the 10-bit address was not acknowledged by any slave.

1

ABRT_10ADDR1_NOACK

R

0x0

  • 1: Master is in 10-bit address mode and the first 10-bit address byte was not acknowledged by any slave.

0

ABRT_7B_ADDR_NOACK

R

0x0

  • 1: Master is in 7-bit addressing mode and the address sent was not acknowledged by any slave

REG_IC_SLV_DATA_NACK_ONLY

  • Name: Generate Slave Data NACK Register

  • Size: 32

  • Address offset: 084h

  • Read/write access: R/W

31:1 RSVD 0 NACK

Bit

Symbol

Access

INI

Description

31:1

RSVD

R

-

Reserved

0

NACK

R/W

0x0

Generate NACK. This NACK generation only occurs when I2C is a slave-receiver. If this register is set to a value of 1, it can only generate a NACK after a data byte is received; hence, the data transfer is aborted and the data received is not pushed to the receive buffer.

When the register is set to a value of 0, it generates NACK/ACK, depending on normal criteria.

  • 1: generate NACK after data byte received

  • 0: generate NACK/ACK normally

REG_IC_DMA_CR

  • Name: DMA Control Register

  • Size: 32

  • Address offset: 088h

  • Read/write access: R/W

31:2 RSVD 1 TDMAE 0 RDMAE

Bit

Symbol

Access

INI

Description

31:2

RSVD

R

-

Reserved

1

TDMAE

R/W

0x0

Transmit DMA Enable. This bit enables/disables the transmit FIFO DMA channel.

  • 0: Transmit DMA disabled

  • 1: Transmit DMA enabled

0

RDMAE

R/W

0x0

Receive DMA Enable. This bit enables/disables the receive FIFO DMA channel.

  • 0: Receive DMA disabled

  • 1: Receive DMA enabled

REG_IC_DMA_TDLR

  • Name: DMA Transmit Data Level Register

  • Size: 32

  • Address offset: 08Ch

  • Read/write access: R/W

31:4 RSVD 3:0 DMATDL

Bit

Symbol

Access

INI

Description

31:4

RSVD

R

-

Reserved

3:0

DMATDL

R/W

0x0

Transmit Data Level. This bit field controls the level at which a DMA request is made by the transmit logic. It is equal to the watermark level; that is, the dma_tx_req signal is generated when the number of valid data entries in the transmit FIFO is equal to or below this field value, and TDMAE=1.

REG_IC_DMA_RDLR

  • Name: I2C Receive Data Level Register

  • Size: 32

  • Address offset: 090h

  • Read/write access: R/W

31:4 RSVD 3:0 DMARDL

Bit

Symbol

Access

INI

Description

31:4

RSVD

R

-

Reserved

3:0

DMARDL

R/W

0x0

Receive Data Level. This bit field controls the level at which a DMA request is made by the receive logic. The watermark level=DMARDL+1; that is, the dma_tx_req signal is generated when the number of valid data entries in the receive FIFO is equal to or more than this field value+1, and RDMAE=1. For instance, when DMARDL is 0, the dma_rx_req is asserted when 1 or more data entries are present in the receive FIFO.

REG_IC_SDA_SETUP

  • Name: I2C SDA Setup Register

  • Size: 32

  • Address offset: 094h

  • Read/write access: R/W

31:8 RSVD 7:0 IC_SDA_SETUP

Bit

Symbol

Access

INI

Description

31:8

RSVD

R

-

Reserved

7:0

IC_SDA_SETUP

R/W

0x5

Set the required SDA setup time in units of ic_clk period.

REG_IC_ACK_GENERAL_CALL

  • Name: I2C ACK General Call Register

  • Size: 32

  • Address offset: 098h

  • Read/write access: R/W

31:1 RSVD 0 ACK_GEN_CALL

Bit

Symbol

Access

INI

Description

31:1

RSVD

R

-

Reserved

0

ACK_GEN_CALL

R/W

0x1

  • 1: I2C responds with a ACK when it receives a General Call.

  • 0: I2C does not generate General Call interrupts.

REG_IC_ENABLE_STATUS

  • Name: I2C Enable Status Register

  • Size: 32

  • Address offset: 09Ch

  • Read/write access: R

31:5 RSVD 4:3 BUSY_IN_MODE 2 SLV_DISABLE_WHILE_BUSY 1 RSVD 0 IC_EN

Bit

Symbol

Access

INI

Description

31:5

RSVD

R

-

Reserved

4:3

BUSY_IN_MODE

R

0x0

  • 00: I2C is disable while busy in legacy mode.

  • 01: I2C is disable while busy in DMA mode.

  • 10: I2C is disable while busy in Descriptor mode.

2

SLV_DISABLE_WHILE_BUSY

R

0x0

Slave Disabled While Busy (Transmit, Receive). This bit indicates if a potential or active Slave operation has been aborted due to the setting of the IC_SLAVE_DISBALE register from 1 to 0.

1

RSVD

R

-

Reserved

0

IC_EN

R

0x0

IC_EN Status. This bit always reflects the value driven on the output port IC_EN.

  • 1: I2C is deemed to be in an enabled state.

  • 0: I2C is deemed completely inactive.

REG_IC_DMA_CMD

  • Name: I2C DMA Command Register

  • Size: 32

  • Address offset: 0A0h

  • Read/write access: R/W

31:8 RSVD 7 DMODE_RESTART 6 DMODE_STOP 5 DMODE_CMD 4:1 RSVD 0 DMODE_ENABLE

Bit

Symbol

Access

INI

Description

31:8

RSVD

R

-

Reserved

7

DMODE_RESTART

R/W

0x0

This bit controls whether a RESTART is issued after the byte is sent or received in DMA mode.

  • 1: a RESTART is issued after the data is sent/received (according to the value of CMD_RW), regardless of whether or not the transfer direction is changing from the previous command.

6

DMODE_STOP

R/W

0x0

This bit controls whether a STOP is issued after the byte is sent or received in DMA mode.

  • 1: STOP is issued after this byte, regardless of whether or not the Tx FIFO is empty. If the Tx FIFO is not empty, the master immediately tries to start a new transfer by issuing a START and arbitrating for the bus.

  • 0: STOP is not issued after this byte.

5

DMODE_CMD

R/W

0x0

This bit controls whether a read or write is performed in DMA mode. This bit does not control the direction when the I2C acts as a slave. It controls only the direction when it acts as a master.

  • 1: Read

  • 0: Write

4:1

RSVD

R

-

Reserved

0

DMODE_ENABLE

R/W

0x0

  • 1: Set to enable DMA mode, cleared when transfer is done

REG_IC_DMA_DATA_LEN

  • Name: I2C DMA Mode Transfer Data Length Register

  • Size: 32

  • Address offset: 0A4h

  • Read/write access: R/W

31:16 RSVD 15:0 DMA_DAT_LEN

Bit

Symbol

Access

INI

Description

31:16

RSVD

R

-

Reserved

15:0

DMA_DAT_LEN

R/W

0x0

DMA transfer data length

REG_IC_DMA_MODE

  • Name: I2C DMA Mode Register

  • Size: 32

  • Address offset: 0A8h

  • Read/write access: R/W

31:2 RSVD 1:0 DMA_MODE

Bit

Symbol

Access

INI

Description

31:2

RSVD

R

-

Reserved

1:0

DMA_MODE

R/W

0x0

  • 0: DWC DMA legacy mode

  • 1: DMA with control register

  • 2: DMA with transfer descriptor

REG_IC_SLEEP

  • Name: I2C Sleep Mode Register

  • Size: 32

  • Address offset: 0ACh

  • Read/write access: R

31:0 RSVD

Bit

Symbol

Access

INI

Description

31:0

RSVD

R

-

Reserved

REG_IC_DEBUG_SEL

  • Name: I2C Debug SEL Register

  • Size: 32

  • Address offset: 0B0h

  • Read/write access: R/W

31:4 RSVD 3:0 IC_DEBUG_SEL

Bit

Symbol

Access

INI

Description

31:4

RSVD

R

-

Reserved

3:0

IC_DEBUG_SEL

R/W

0x0

  • 0: Debug clock

  • 1: Debug APB

  • 2: RSVD

  • 3: Debug FIFO

  • 4: Debug Timing

  • 5: Debug Slave Mode Address Match

  • 6: Debug Interrupt

REG_IC_OUT_SMP_DLY

  • Name: Sample Delay Register

  • Size: 32

  • Address offset: 0B4h

  • Read/write access: R/W

31:3 RSVD 2:0 IC_OUT_SMP_DLY

Bit

Symbol

Access

INI

Description

31:3

RSVD

R

-

Reserved

2:0

IC_OUT_SMP_DLY

R/W

0x2

Delay cycles for sample of master derived SCL value. The sample of master derived SCL is used for slave stretch.

Slave stretch is valid when master drive SCL High, but slave drive SCL low.

Valid value of IC_OUT_SMP_DLY is 0-7. Inicate a delay of 1 to 8 cycles.

REG_IC_CLR_ADDR_MATCH

  • Name: Clear Slave Mode Address Match Interrupt Register

  • Size: 32

  • Address offset: 0E4h

  • Read/write access: R

31:1 RSVD 0 IC_CLR_ADDR_MATCH

Bit

Symbol

Access

INI

Description

31:1

RSVD

R

-

Reserved

0

IC_CLR_ADDR_MATCH

R

0x0

Read this register to clear the slave mode address match interrupt (bit[13:12]) of IC_RAW_INTR_STAT register.

REG_IC_CLR_DMA_DONE

  • Name: Clear DMA DONE Interrupt Register

  • Size: 32

  • Address offset: 0E8h

  • Read/write access: R

31:1 RSVD 0 IC_CLR_RAW_INTR_STAT

Bit

Symbol

Access

INI

Description

31:1

RSVD

R

-

Reserved

0

IC_CLR_RAW_INTR_STAT

R

0x0

Read this register to clear the DMA_DONE interrupt (bit[15]) of IC_RAW_INTR_STAT register.

REG_IC_FILTER

  • Name: I2C Filter Register

  • Size: 32

  • Address offset: 0ECh

  • Read/write access: R/W

31:9 RSVD 8 IC_DIG_FLTR_SEL 7:4 RSVD 3:0 IC_DIG_FLTR_DEG

Bit

Symbol

Access

INI

Description

31:9

RSVD

R

-

Reserved

8

IC_DIG_FLTR_SEL

R/W

0x0

  • 1: Enable filter

7:4

RSVD

R

-

Reserved

3:0

IC_DIG_FLTR_DEG

R/W

0x0

DIG_FLTR_DEG is to define frequency range of filter. A greater value of DIG_FLTR_DEG results in a slower transfer speed and hardware would be able to filter a lower frequency.

REG_IC_SAR2

  • Name: I2C Slave2 Address Register

  • Size: 32

  • Address offset: 0F4h

  • Read/write access: R/W

31:7 RSVD 6:0 IC_SAR2

Bit

Symbol

Access

INI

Description

31:7

RSVD

R

-

Reserved

6:0

IC_SAR2

R/W

0x12

The IC_SAR2 holds the slave address when the I2C is operating as slave2. Slave2 only supports 7-bit address.

The register can be written only when the I2C interface is disabled, which corresponds to the IC_ENABLE register being set to 0. Writes at other times have no effect.

REG_IC_COMP_VERSION

  • Name: I2C Component Version Register

  • Size: 32

  • Address offset: 0FCh

  • Read/write access: R

31:0 IC_COMP_VERSION

Bit

Symbol

Access

INI

Description

31:0

IC_COMP_VERSION

R

0x20200702

I2C version number

REG_IC_DUMMY

  • Name: IC Dummy Register

  • Size: 32

  • Address offset: 100h

  • Read/write access: R

31:16 RSVD 15:0 DUMMY

Bit

Symbol

Access

INI

Description

31:16

RSVD

R

-

Reserved

15:0

DUMMY

R

0x0

Reserved for HW