Register descriptions¶

This chapter provides auto-generated register descriptions for the core.

I3CCSR address map¶

Absolute Address: 0x0
Base Offset: 0x0
Size: 0x26C

Offset	Identifier	Name
0x100	I3C_EC	Extended Capabilities

I3C_EC register file¶

Absolute Address: 0x100
Base Offset: 0x100
Size: 0x16C

Offset	Identifier	Name
0x000	SecFwRecoveryIf	Secure Firmware Recovery Interface
0x080	StdbyCtrlMode	Standby Controller Mode
0x0C0	TTI	Target Transaction Interface
0x100	SoCMgmtIf	SoC Management Interface
0x160	CtrlCfg	Controller Config
0x168	TERMINATION_EXTCAP_HEADER	—

SecFwRecoveryIf register file¶

Absolute Address: 0x100
Base Offset: 0x0
Size: 0x6C

Offset	Identifier	Name
0x00	EXTCAP_HEADER	—
0x04	PROT_CAP_0	Recovery Protocol Capabilities 0
0x08	PROT_CAP_1	Recovery Protocol Capabilities 1
0x0C	PROT_CAP_2	Recovery Protocol Capabilities 2
0x10	PROT_CAP_3	Recovery Protocol Capabilities 3
0x14	DEVICE_ID_0	Device Identification 0
0x18	DEVICE_ID_1	Device Identification 1
0x1C	DEVICE_ID_2	Device Identification 2
0x20	DEVICE_ID_3	Device Identification 3
0x24	DEVICE_ID_4	Device Identification 4
0x28	DEVICE_ID_5	Device Identification 5
0x2C	DEVICE_ID_RESERVED	Reserved
0x30	DEVICE_STATUS_0	Device status 0
0x34	DEVICE_STATUS_1	Device status 1
0x38	DEVICE_RESET	Reset control
0x3C	RECOVERY_CTRL	Recovery configuration/control
0x40	RECOVERY_STATUS	Recovery status
0x44	HW_STATUS	Hardware status
0x48	INDIRECT_FIFO_CTRL_0	Indirect FIFO Control 0
0x4C	INDIRECT_FIFO_CTRL_1	Indirect FIFO Control 1
0x50	INDIRECT_FIFO_STATUS_0	Indirect FIFO Status 0
0x54	INDIRECT_FIFO_STATUS_1	Indirect FIFO Status 1
0x58	INDIRECT_FIFO_STATUS_2	Indirect FIFO Status 2
0x5C	INDIRECT_FIFO_STATUS_3	Indirect FIFO Status 3
0x60	INDIRECT_FIFO_STATUS_4	Indirect FIFO Status 4
0x64	INDIRECT_FIFO_RESERVED	INDIRECT_FIFO_RESERVED
0x68	INDIRECT_FIFO_DATA	INDIRECT_FIFO_DATA

EXTCAP_HEADER register¶

Absolute Address: 0x100
Base Offset: 0x0
Size: 0x4

Bits	Identifier	Access	Reset	Name
7:0	CAP_ID	r	0xC0	CAP_ID
23:8	CAP_LENGTH	r	0x20	CAP_LENGTH

CAP_ID field¶

Extended Capability ID

CAP_LENGTH field¶

Capability Structure Length in DWORDs

PROT_CAP_0 register¶

Absolute Address: 0x104
Base Offset: 0x4
Size: 0x4

Bits	Identifier	Access	Reset	Name
31:0	REC_MAGIC_STRING_0	r	0x2050434F	Recovery protocol magic string

REC_MAGIC_STRING_0 field¶

Magic string 'OCP ' (1st part of 'OCP RECV') in ASCII code - '0x4f 0x43 0x50 0x20'

PROT_CAP_1 register¶

Absolute Address: 0x108
Base Offset: 0x8
Size: 0x4

Bits	Identifier	Access	Reset	Name
31:0	REC_MAGIC_STRING_1	r	0x56434552	Recovery protocol magic string

REC_MAGIC_STRING_1 field¶

Magic string 'RECV' (2nd part of 'OCP RECV') in ASCII code - '0x52 0x45 0x43 0x56'

PROT_CAP_2 register¶

Absolute Address: 0x10C
Base Offset: 0xC
Size: 0x4

Bits	Identifier	Access	Reset	Name
15:0	REC_PROT_VERSION	rw	0x0	Recovery protocol version
31:16	AGENT_CAPS	rw	0x0	Recovery protocol capabilities

REC_PROT_VERSION field¶

Byte 0: Major version number = 0x1
Byte 1: Minor version number = 0x1

AGENT_CAPS field¶

Agent capabilities:

bit 0: Identification (DEVICE_ID structure)
bit 1: Forced Recovery (From RESET)
bit 2: Mgmt reset (From RESET)
bit 3: Device Reset (From RESET)
bit 4: Device status (DEVICE_STATUS)
bit 5: Recovery memory access (INDIRECT_CTRL)
bit 6: Local C-image support
bit 7: Push C-image support
bit 8: Interface isolation
bit 9: Hardware status
bit 10: Vendor command
bit 11: Flashless boot (From RESET)
bit 12: FIFO CMS support (INDIRECT_FIFO_CTRL)
bits 13-15: Reserved

PROT_CAP_3 register¶

Absolute Address: 0x110
Base Offset: 0x10
Size: 0x4

Bits	Identifier	Access	Reset	Name
7:0	NUM_OF_CMS_REGIONS	rw	0x0	Total number of CMS regions
15:8	MAX_RESP_TIME	rw	0x0	Maximum Response Time
23:16	HEARTBEAT_PERIOD	rw	0x0	Heartbeat Period

NUM_OF_CMS_REGIONS field¶

0-255: The total number of component memory space (CMS) regions a device supports. This number includes any logging, code and vendor defined regions

MAX_RESP_TIME field¶

0-255: Maximum response time in 2^x microseconds(us).

HEARTBEAT_PERIOD field¶

0-255: Heartbeat period, 2^x microseconds (us), 0 indicates not supported

DEVICE_ID_0 register¶

Absolute Address: 0x114
Base Offset: 0x14
Size: 0x4

Bits	Identifier	Access	Reset	Name
7:0	DESC_TYPE	rw	0x0	Initial descriptor type
15:8	VENDOR_SPECIFIC_STR_LENGTH	rw	0x0	Vendor Specific String Length
31:16	DATA	rw	0x0

DESC_TYPE field¶

Based on table 8 from [DMTF PLDM FM]:

0x00: PCI Vendor
0x1: IANA
0x2: UUID
0x3: PnP Vendor
0x4: ACPI Vendor
0x5: IANA Enterprise Type
0x6-0xFE: Reserved
0xFF: NVMe-MI

VENDOR_SPECIFIC_STR_LENGTH field¶

0x0-0xFF: Total length of Vendor Specific String, 0 indicates not supported

DATA field¶

DEVICE_ID_1 register¶

Absolute Address: 0x118
Base Offset: 0x18
Size: 0x4

Bits	Identifier	Access	Reset	Name
31:0	DATA	rw	0x0

DATA field¶

DEVICE_ID_2 register¶

Absolute Address: 0x11C
Base Offset: 0x1C
Size: 0x4

Bits	Identifier	Access	Reset	Name
31:0	DATA	rw	0x0

DATA field¶

DEVICE_ID_3 register¶

Absolute Address: 0x120
Base Offset: 0x20
Size: 0x4

Bits	Identifier	Access	Reset	Name
31:0	DATA	rw	0x0

DATA field¶

DEVICE_ID_4 register¶

Absolute Address: 0x124
Base Offset: 0x24
Size: 0x4

Bits	Identifier	Access	Reset	Name
31:0	DATA	rw	0x0

DATA field¶

DEVICE_ID_5 register¶

Absolute Address: 0x128
Base Offset: 0x28
Size: 0x4

Bits	Identifier	Access	Reset	Name
31:0	DATA	rw	0x0

DATA field¶

DEVICE_ID_RESERVED register¶

Absolute Address: 0x12C
Base Offset: 0x2C
Size: 0x4

Bits	Identifier	Access	Reset	Name
31:0	DATA	r	0x0

DATA field¶

DEVICE_STATUS_0 register¶

Absolute Address: 0x130
Base Offset: 0x30
Size: 0x4

Bits	Identifier	Access	Reset	Name
7:0	DEV_STATUS	rw	0x0	Device status
15:8	PROT_ERROR	rw, rclr	0x0	Protocol Error
31:16	REC_REASON_CODE	rw	0x0	Recovery Reason Codes

DEV_STATUS field¶

0x0: Status Pending (Recover Reason Code not populated)
0x1: Device healthy (Recover Reason Code not populated)
0x2: Device Error (“soft” error or other error state) - (Recover Reason Code not populated)
0x3: Recovery mode - ready to accept recovery image - (Recover Reason Code populated)
0x4: Recovery Pending (waiting for activation) - (Recover Reason Code populated)
0x5: Running Recovery Image ( Recover Reason Code not populated)
0x6-0xD: Reserved
0xE: Boot Failure (Recover Reason Code populated)
0xF: Fatal Error (Recover Reason Code not populated)
0x10-FF:Reserved

PROT_ERROR field¶

0x0: No Protocol Error
0x1: Unsupported/Write Command - command is not support or a write to a RO command
0x2: Unsupported Parameter
0x3: Length write error (length of write command is incorrect)
0x4: CRC Error (if supported)
0x5-0xFE: Reserved
0xFF: General Protocol Error - catch all unclassified errors

REC_REASON_CODE field¶

0x0: No Boot Failure detected (BFNF)
0x1: Generic hardware error (BFGHWE)
0x2: Generic hardware soft error (BFGSE) - soft error may be recoverable
0x3: Self-test failure (BFSTF) (e.g., RSA self test failure, FIPs self test failure,, etc.)
0x4: Corrupted/missing critical data (BFCD)
0x5: Missing/corrupt key manifest (BFKMMC)
0x6: Authentication Failure on key manifest (BFKMAF)
0x7: Anti-rollback failure on key manifest (BFKIAR)
0x8: Missing/corrupt boot loader (first mutable code) firmware image (BFFIMC)
0x9: Authentication failure on boot loader ( 1st mutable code) firmware image (BFFIAF)
0xA: Anti-rollback failure boot loader (1st mutable code) firmware image (BFFIAR)
0xB: Missing/corrupt main/management firmware image (BFMFMC)
0xC: Authentication Failure main/management firmware image (BFMFAF)
0xD: Anti-rollback Failure main/management firmware image (BFMFAR)
0xE: Missing/corrupt recovery firmware (BFRFMC)
0xF: Authentication Failure recovery firmware (BFRFAF)
0x10: Anti-rollback Failure on recovery firmware (BFRFAR)
0x11: Forced Recovery (FR)
0x12: Flashless/Streaming Boot (FSB)
0x13-0x7F: Reserved
0x80-0xFF: Vendor Unique Boot Failure Codes

DEVICE_STATUS_1 register¶

Absolute Address: 0x134
Base Offset: 0x34
Size: 0x4

Bits	Identifier	Access	Reset	Name
15:0	HEARTBEAT	rw	0x0	Heartbeat
24:16	VENDOR_STATUS_LENGTH	rw	0x0	Vendor Status Length
31:25	VENDOR_STATUS	rw	0x0	Vendor defined status message

HEARTBEAT field¶

0-4095: Incrementing number (counter wraps)

VENDOR_STATUS_LENGTH field¶

0-248: Length in bytes of just VENDOR_STATUS. Zero indicates no vendor status and zero additional bytes.

DEVICE_RESET register¶

Absolute Address: 0x138
Base Offset: 0x38
Size: 0x4

For devices which support reset, this register will reset the device or management entity

Bits	Identifier	Access	Reset	Name
7:0	RESET_CTRL	rw, woclr	0x0	Device Reset Control
15:8	FORCED_RECOVERY	rw	0x0	Forced Recovery
23:16	IF_CTRL	rw	0x0	Interface Control

RESET_CTRL field¶

0x0: No reset
0x1: Reset Device (PCIe Fundamental Reset or equivalent. This is likely bus disruptive)
0x2: Reset Management. This reset will reset the management subsystem. If supported, this reset MUST not be bus disruptive (cause re-enumeration)
0x3-FF: Reserved

FORCED_RECOVERY field¶

0x0: No forced recovery
0x01-0xD: Reserved
0xE: Enter flashless boot mode on next platform reset
0xF: Enter recovery mode on next platform reset
0x10-FF: Reserved

IF_CTRL field¶

0x0: Disable Interface mastering
0x1: Enable Interface mastering

RECOVERY_CTRL register¶

Absolute Address: 0x13C
Base Offset: 0x3C
Size: 0x4

Bits	Identifier	Access	Reset	Name
7:0	CMS	rw	0x0	Component Memory Space (CMS)
15:8	REC_IMG_SEL	rw	0x0	Recovery Image Selection
23:16	ACTIVATE_REC_IMG	rw, woclr	0x0	Activate Recovery Image

CMS field¶

0-255: Selects a component memory space where the recovery image is. 0 is the default

REC_IMG_SEL field¶

0x0: No operation
0x1: Use Recovery Image from memory window (CMS)
0x2: Use Recovery Image stored on device (C-image)
0x3-FF: reserved

ACTIVATE_REC_IMG field¶

0x0: do not activate recovery image - after activation device will report this code.
0xF: Activate recovery image
0x10-FF-reserved

RECOVERY_STATUS register¶

Absolute Address: 0x140
Base Offset: 0x40
Size: 0x4

Bits	Identifier	Access	Reset	Name
3:0	DEV_REC_STATUS	rw	0x0	Device recovery status
7:4	REC_IMG_INDEX	rw	0x0	Recovery image index
15:8	VENDOR_SPECIFIC_STATUS	rw	0x0	Vendor specific status

DEV_REC_STATUS field¶

0x0: Not in recovery mode
0x1: Awaiting recovery image
0x2: Booting recovery image
0x3: Recovery successful
0xc: Recovery failed
0xd: Recovery image authentication error
0xe: Error entering Recovery mode (might be administratively disabled)
0xf: Invalid component address space

HW_STATUS register¶

Absolute Address: 0x144
Base Offset: 0x44
Size: 0x4

Bits	Identifier	Access	Reset	Name
0	TEMP_CRITICAL	rw	0x0	Device temperature critical
1	SOFT_ERR	rw	0x0	Hardware Soft Error
2	FATAL_ERR	rw	0x0	Hardware Fatal Error
7:3	RESERVED_7_3	rw	0x0	Reserved
15:8	VENDOR_HW_STATUS	rw	0x0	Vendor HW Status (bit mask active high)
23:16	CTEMP	rw	0x0	Composite temperature (CTemp)
31:24	VENDOR_HW_STATUS_LEN	rw	0x0	Vendor Specific Hardware Status length (bytes)

TEMP_CRITICAL field¶

Device temperature is critical (may need reset to clear)

SOFT_ERR field¶

Hardware Soft Error (may need reset to clear)

CTEMP field¶

Current temperatureof device in degrees Celsius: Compatible with NVMe-MI command code 0 offset 3.

0x00-0x7e: 0 to 126 C
0x7f: 127 C or higher
0x80: no temperature data, or data is older than 5 seconds
0x81: temperature sensor failure
0x82-0x83: reserved
0xc4: -60 C or lower
0xc5-0xff: -59 to -1 C (in two's complement)

VENDOR_HW_STATUS_LEN field¶

0-251: Length in bytes of Vendor Specific Hardware Status.

INDIRECT_FIFO_CTRL_0 register¶

Absolute Address: 0x148
Base Offset: 0x48
Size: 0x4

Bits	Identifier	Access	Reset	Name
7:0	CMS	rw	0x0	Indirect FIFO memory access configuration.
15:8	RESET	rw	0x0	Indirect memory configuration - reset

CMS field¶

This register selects a region within the device. Read/write access is through address spaces. Each space represents a FIFO. Component Memory Space (CMS):

0-255: Address region within a device.

RESET field¶

Reset (Write 1 Clear):

0x0: idle
0x1: reset Write Index and Read Index to initial value.
0x2 to 0xFF: reserved

INDIRECT_FIFO_CTRL_1 register¶

Absolute Address: 0x14C
Base Offset: 0x4C
Size: 0x4

Bits	Identifier	Access	Reset	Name
31:0	IMAGE_SIZE	rw	0x0	Indirect memory configuration - Image Size

IMAGE_SIZE field¶

Image Size: Size of the image to be loaded in 4B units

INDIRECT_FIFO_STATUS_0 register¶

Absolute Address: 0x150
Base Offset: 0x50
Size: 0x4

Bits	Identifier	Access	Reset	Name
0	EMPTY	r	0x1	FIFO Empty
1	FULL	r	0x0	FIFO Full
10:8	REGION_TYPE	r	0x0	Memory Region Type

EMPTY field¶

If set, FIFO is empty

FULL field¶

If set, FIFO is full

REGION_TYPE field¶

Memory Region Type:

0b000: Code space for recovery. (write only)
0b001: Log uses the defined debug format (read only)
0b100: Vendor Defined Region (write only)
0b101: Vendor Defined Region (read only)
0b111: Unsupported Region (address space out of range)

INDIRECT_FIFO_STATUS_1 register¶

Absolute Address: 0x154
Base Offset: 0x54
Size: 0x4

Bits	Identifier	Access	Reset	Name
31:0	WRITE_INDEX	r	0x0	FIFO Write Index

WRITE_INDEX field¶

Offset incremented for each access by the Recovery Agent in 4B units

INDIRECT_FIFO_STATUS_2 register¶

Absolute Address: 0x158
Base Offset: 0x58
Size: 0x4

Bits	Identifier	Access	Reset	Name
31:0	READ_INDEX	r	0x0	FIFO Read Index

READ_INDEX field¶

Offset incremented for each access by the device in 4B units

INDIRECT_FIFO_STATUS_3 register¶

Absolute Address: 0x15C
Base Offset: 0x5C
Size: 0x4

Bits	Identifier	Access	Reset	Name
31:0	FIFO_SIZE	r	0x40	Indirect FIFO size

FIFO_SIZE field¶

Size of memory window specified in 4B units. Current implementation supports only a constant size of 64.

INDIRECT_FIFO_STATUS_4 register¶

Absolute Address: 0x160
Base Offset: 0x60
Size: 0x4

Bits	Identifier	Access	Reset	Name
31:0	MAX_TRANSFER_SIZE	r	0x40	Max transfer size

MAX_TRANSFER_SIZE field¶

Max size of the data payload in each read/write to INDIRECT_FIFO_DATA in 4B units

Enforced to 256 bytes (64 DWORDs) by Caliptra Subsystem Recovery Sequence

INDIRECT_FIFO_RESERVED register¶

Absolute Address: 0x164
Base Offset: 0x64
Size: 0x4

Bits	Identifier	Access	Reset	Name
31:0	DATA	r	0x0	Reserved register

INDIRECT_FIFO_DATA register¶

Absolute Address: 0x168
Base Offset: 0x68
Size: 0x4

Indirect memory access to address space configured in INDIRECT_FIFO_CTRL at the Head Pointer offset.

Bits	Identifier	Access	Reset	Name
31:0	DATA	r	0x0	—

StdbyCtrlMode register file¶

Absolute Address: 0x180
Base Offset: 0x80
Size: 0x40

Offset	Identifier	Name
0x00	EXTCAP_HEADER	—
0x04	STBY_CR_CONTROL	Standby Controller Control
0x08	STBY_CR_DEVICE_ADDR	Standby Controller Device Address
0x0C	STBY_CR_CAPABILITIES	Standby Controller Capabilities
0x10	STBY_CR_VIRTUAL_DEVICE_CHAR	Standby Controller Virtual Device Characteristics
0x14	STBY_CR_STATUS	Standby Controller Status
0x18	STBY_CR_DEVICE_CHAR	Standby Controller Device Characteristics
0x1C	STBY_CR_DEVICE_PID_LO	Standby Controller Device PID Low
0x20	STBY_CR_INTR_STATUS	Standby Controller Interrupt Status
0x24	STBY_CR_VIRTUAL_DEVICE_PID_LO	Standby Controller Virtual Device PID Low
0x28	STBY_CR_INTR_SIGNAL_ENABLE	Standby Controller Interrupt Signal Enable
0x2C	STBY_CR_INTR_FORCE	Standby Controller Interrupt Force
0x30	STBY_CR_CCC_CONFIG_GETCAPS	Standby Controller CCC Configuration GETCAPS
0x34	STBY_CR_CCC_CONFIG_RSTACT_PARAMS	Standby Controller CCC Configuration RSTACT
0x38	STBY_CR_VIRT_DEVICE_ADDR	Standby Virtual Controller Device Address
0x3C	__rsvd_3	Reserved 3

EXTCAP_HEADER register¶

Absolute Address: 0x180
Base Offset: 0x0
Size: 0x4

Bits	Identifier	Access	Reset	Name
7:0	CAP_ID	r	0x12	CAP_ID
23:8	CAP_LENGTH	r	0x10	CAP_LENGTH

CAP_ID field¶

Extended Capability ID

CAP_LENGTH field¶

Capability Structure Length in DWORDs

STBY_CR_CONTROL register¶

Absolute Address: 0x184
Base Offset: 0x4
Size: 0x4

Bits	Identifier	Access	Reset	Name
0	PENDING_RX_NACK	rw	—	Pending RX NACK
1	HANDOFF_DELAY_NACK	rw	—	Handoff Delay NACK
2	ACR_FSM_OP_SELECT	rw	—	Active Controller Select
3	PRIME_ACCEPT_GETACCCR	rw	—	Prime to Accept Controller Role
4	HANDOFF_DEEP_SLEEP	rw, wset	0x0	Handoff Deep Sleep
5	CR_REQUEST_SEND	w	0x0	Send Controller Role Request
10:8	BAST_CCC_IBI_RING	rw	0x0	Ring Bundle IBI Selector for Broadcast CCC Capture
12	TARGET_XACT_ENABLE	rw	0x1	Target Transaction Interface Servicing Enable
13	DAA_SETAASA_ENABLE	rw	0x0	Dynamic Address Method Enable SETAASA
14	DAA_SETDASA_ENABLE	rw	0x0	Dynamic Address Method Enable SETDASA
15	DAA_ENTDAA_ENABLE	rw	0x0	Dynamic Address Method Enable ENTDAA
20	RSTACT_DEFBYTE_02	rw	0x0	RSTACT Support DefByte 0x02
31:30	STBY_CR_ENABLE_INIT	rw	0x0	Host Controller Secondary Controller Enable

PENDING_RX_NACK field¶

HANDOFF_DELAY_NACK field¶

ACR_FSM_OP_SELECT field¶

PRIME_ACCEPT_GETACCCR field¶

HANDOFF_DEEP_SLEEP field¶

If this field has a value of 1'b1, then the Secondary Controller Logic shall report a return from Deep Sleep state to the Active Controller. Writing 1'b1 to this bit is sticky. This field shall automatically clear to 1'b0 after accepting the Controller Role and transitioning to Active Controller mode.

CR_REQUEST_SEND field¶

Write of 1'b1 to this field shall instruct the Secondary Controller Logic to attempt to send a Controller Role Request to the I3C Bus.

BAST_CCC_IBI_RING field¶

Indicates which Ring Bundle will be used to capture Broadcast CCC data sent by the Active Controller. The Ring Bundle must be configured and enabled, and its IBI Ring Pair must also be initialized and ready to receive data.

TARGET_XACT_ENABLE field¶

Indicates whether Read-Type/Write-Type transaction servicing is enabled, via an I3C Target Transaction Interface to software (Section 6.17.3).

1'b0: DISABLED: not available

1'b1: ENABLED: available for software

DAA_SETAASA_ENABLE field¶

Indicates SETAASA method is enabled.

1'b0: DISABLED: will not respond

1'b1: ENABLED: will respond

DAA_SETDASA_ENABLE field¶

Indicates SETDASA method is enabled.

1'b0: DISABLED: will not respond

1'b1: ENABLED: will respond

DAA_ENTDAA_ENABLE field¶

Indicates ENTDAA method is enabled.

1'b0: DISABLED: will not respond

1'b1: ENABLED: will respond

RSTACT_DEFBYTE_02 field¶

Controls whether I3C Secondary Controller Logic supports RSTACT CCC with Defining Byte 0x02.

1'b0: NOT_SUPPORTED: Do not ACK Defining Byte 0x02

1'b1: HANDLE_INTR: Support Defining Byte 0x02

STBY_CR_ENABLE_INIT field¶

Enables or disables the Secondary Controller:

2'b00 - DISABLED: Secondary Controller is disabled.

2'b01 - ACM_INIT: Secondary Controller is enabled, but Host Controller initializes in Active Controller mode.

2'b10 - SCM_RUNNING: Secondary Controller operation is enabled, Host Controller initializes in Standby Controller mode.

2'b11 - SCM_HOT_JOIN: Secondary Controller operation is enabled, Host Controller conditionally becomes a Hot-Joining Device to receive its Dynamic Address before operating in Standby Controller mode.

STBY_CR_DEVICE_ADDR register¶

Absolute Address: 0x188
Base Offset: 0x8
Size: 0x4

Bits	Identifier	Access	Reset	Name
6:0	STATIC_ADDR	rw	0x0	Device Static Address
15	STATIC_ADDR_VALID	rw	0x0	Static Address is Valid
22:16	DYNAMIC_ADDR	rw	0x0	Device Dynamic Address
31	DYNAMIC_ADDR_VALID	rw	0x0	Dynamic Address is Valid

STATIC_ADDR field¶

This field contains the Host Controller Device’s Static Address.

STATIC_ADDR_VALID field¶

Indicates whether or not the value in the STATIC_ADDR field is valid.

1'b0: The Static Address field is not valid

1'b1: The Static Address field is valid

DYNAMIC_ADDR field¶

Contains the Host Controller Device’s Dynamic Address.

DYNAMIC_ADDR_VALID field¶

Indicates whether or not the value in the DYNAMIC_ADDR field is valid. 1'b0: DYNAMIC_ADDR field is not valid 1'b1: DYNAMIC_ADDR field is valid

STBY_CR_CAPABILITIES register¶

Absolute Address: 0x18C
Base Offset: 0xC
Size: 0x4

Bits	Identifier	Access	Reset	Name
5	SIMPLE_CRR_SUPPORT	r	0x0	SIMPLE_CRR_SUPPORT
12	TARGET_XACT_SUPPORT	r	0x1	TARGET_XACT_SUPPORT
13	DAA_SETAASA_SUPPORT	r	0x1	DAA_SETAASA_SUPPORT
14	DAA_SETDASA_SUPPORT	r	0x1	DAA_SETDASA_SUPPORT
15	DAA_ENTDAA_SUPPORT	r	0x0	DAA_ENTDAA_SUPPORT

SIMPLE_CRR_SUPPORT field¶

TARGET_XACT_SUPPORT field¶

Defines whether an I3C Target Transaction Interface is supported.

1'b0: DISABLED: Not supported

1'b1: ENABLED: Supported via vendor-defined Extended Capability structure

DAA_SETAASA_SUPPORT field¶

Defines whether Dynamic Address Assignment with SETAASA CCC (using Static Address) is supported.

1'b0: DISABLED: Not supported

1'b1: ENABLED: Supported

DAA_SETDASA_SUPPORT field¶

Defines whether Dynamic Address Assignment with SETDASA CCC (using Static Address) is supported.

1'b0: DISABLED: Not supported

1'b1: ENABLED: Supported

DAA_ENTDAA_SUPPORT field¶

Defines whether Dynamic Address Assignment with ENTDAA CCC is supported.

1'b0: DISABLED: Not supported

1'b1: ENABLED: Supported

STBY_CR_VIRTUAL_DEVICE_CHAR register¶

Absolute Address: 0x190
Base Offset: 0x10
Size: 0x4

Bits	Identifier	Access	Reset	Name
15:1	PID_HI	rw	0x7FFF	PID_HI
23:16	DCR	rw	0xBD	DCR
28:24	BCR_VAR	rw	0x6	BCR_VAR
31:29	BCR_FIXED	rw	0x1	BCR_FIXED

PID_HI field¶

High part of the 48-bit Target Device Provisioned ID.

DCR field¶

Device Characteristics Register. Value represents an OCP Recovery Device.

BCR_VAR field¶

Bus Characteristics, Variable Part.

Reset value is set to 5'b00110, because this device:

[bit4] is not a Virtual Target
[bit3] is not Offline Capable
[bit2] uses the MDB in the IBI Payload
[bit1] is capable of IBI requests
[bit0] has no speed limitation

BCR_FIXED field¶

Bus Characteristics, Fixed Part.

Reset value is set to 3'b001, because this device is an I3C Target, which supports extended capabilities

STBY_CR_STATUS register¶

Absolute Address: 0x194
Base Offset: 0x14
Size: 0x4

Bits	Identifier	Access	Reset	Name
2	AC_CURRENT_OWN	rw	—	AC_CURRENT_OWN
7:5	SIMPLE_CRR_STATUS	rw	—	SIMPLE_CRR_STATUS
8	HJ_REQ_STATUS	rw	—	HJ_REQ_STATUS

AC_CURRENT_OWN field¶

SIMPLE_CRR_STATUS field¶

HJ_REQ_STATUS field¶

STBY_CR_DEVICE_CHAR register¶

Absolute Address: 0x198
Base Offset: 0x18
Size: 0x4

Bits	Identifier	Access	Reset	Name
15:1	PID_HI	rw	0x7FFF	PID_HI
23:16	DCR	rw	0xBD	DCR
28:24	BCR_VAR	rw	0x6	BCR_VAR
31:29	BCR_FIXED	rw	0x1	BCR_FIXED

PID_HI field¶

High part of the 48-bit Target Device Provisioned ID.

DCR field¶

Device Characteristics Register. Value represents an OCP Recovery Device.

BCR_VAR field¶

Bus Characteristics, Variable Part.

Reset value is set to 5'b00110, because this device:

[bit4] is not a Virtual Target
[bit3] is not Offline Capable
[bit2] uses the MDB in the IBI Payload
[bit1] is capable of IBI requests
[bit0] has no speed limitation

BCR_FIXED field¶

Bus Characteristics, Fixed Part.

Reset value is set to 3'b001, because this device is an I3C Target, which supports extended capabilities

STBY_CR_DEVICE_PID_LO register¶

Absolute Address: 0x19C
Base Offset: 0x1C
Size: 0x4

Bits	Identifier	Access	Reset	Name
31:0	PID_LO	rw	0x5A00A5	PID_LO

PID_LO field¶

Low part of the 48-bit Target Device Provisioned ID.

STBY_CR_INTR_STATUS register¶

Absolute Address: 0x1A0
Base Offset: 0x20
Size: 0x4

Bits	Identifier	Access	Reset	Name
0	ACR_HANDOFF_OK_REMAIN_STAT	rw	—
1	ACR_HANDOFF_OK_PRIMED_STAT	rw	—
2	ACR_HANDOFF_ERR_FAIL_STAT	rw	—
3	ACR_HANDOFF_ERR_M3_STAT	rw	—
10	CRR_RESPONSE_STAT	rw	—
11	STBY_CR_DYN_ADDR_STAT	rw	—
12	STBY_CR_ACCEPT_NACKED_STAT	rw	—
13	STBY_CR_ACCEPT_OK_STAT	rw	—
14	STBY_CR_ACCEPT_ERR_STAT	rw	—
16	STBY_CR_OP_RSTACT_STAT	rw	0x0	Secondary Controller Operation Reset Action
17	CCC_PARAM_MODIFIED_STAT	rw	—
18	CCC_UNHANDLED_NACK_STAT	rw	—
19	CCC_FATAL_RSTDAA_ERR_STAT	rw	—

ACR_HANDOFF_OK_REMAIN_STAT field¶

ACR_HANDOFF_OK_PRIMED_STAT field¶

ACR_HANDOFF_ERR_FAIL_STAT field¶

ACR_HANDOFF_ERR_M3_STAT field¶

CRR_RESPONSE_STAT field¶

STBY_CR_DYN_ADDR_STAT field¶

STBY_CR_ACCEPT_NACKED_STAT field¶

STBY_CR_ACCEPT_OK_STAT field¶

STBY_CR_ACCEPT_ERR_STAT field¶

STBY_CR_OP_RSTACT_STAT field¶

The Host Controller shall write 1'b1 to this field to indicate that the Secondary Controller received a RSTACT CCC from the Active Controller, followed by the Target Reset Pattern.

CCC_PARAM_MODIFIED_STAT field¶

CCC_UNHANDLED_NACK_STAT field¶

CCC_FATAL_RSTDAA_ERR_STAT field¶

STBY_CR_VIRTUAL_DEVICE_PID_LO register¶

Absolute Address: 0x1A4
Base Offset: 0x24
Size: 0x4

Bits	Identifier	Access	Reset	Name
31:0	PID_LO	rw	0x5A10A5	PID_LO

PID_LO field¶

Low part of the 48-bit Target Virtual Device Provisioned ID.

STBY_CR_INTR_SIGNAL_ENABLE register¶

Absolute Address: 0x1A8
Base Offset: 0x28
Size: 0x4

When set to 1'b1, and the corresponding interrupt status field is set in register STBY_CR_INTR_STATUS, the Host Controller shall assert an interrupt to the Host.

Bits	Identifier	Access	Reset
0	ACR_HANDOFF_OK_REMAIN_SIGNAL_EN	rw	—
1	ACR_HANDOFF_OK_PRIMED_SIGNAL_EN	rw	—
2	ACR_HANDOFF_ERR_FAIL_SIGNAL_EN	rw	—
3	ACR_HANDOFF_ERR_M3_SIGNAL_EN	rw	—
10	CRR_RESPONSE_SIGNAL_EN	rw	—
11	STBY_CR_DYN_ADDR_SIGNAL_EN	rw	—
12	STBY_CR_ACCEPT_NACKED_SIGNAL_EN	rw	—
13	STBY_CR_ACCEPT_OK_SIGNAL_EN	rw	—
14	STBY_CR_ACCEPT_ERR_SIGNAL_EN	rw	—
16	STBY_CR_OP_RSTACT_SIGNAL_EN	rw	0x0
17	CCC_PARAM_MODIFIED_SIGNAL_EN	rw	—
18	CCC_UNHANDLED_NACK_SIGNAL_EN	rw	—
19	CCC_FATAL_RSTDAA_ERR_SIGNAL_EN	rw	—

ACR_HANDOFF_OK_REMAIN_SIGNAL_EN field¶

ACR_HANDOFF_OK_PRIMED_SIGNAL_EN field¶

ACR_HANDOFF_ERR_FAIL_SIGNAL_EN field¶

ACR_HANDOFF_ERR_M3_SIGNAL_EN field¶

CRR_RESPONSE_SIGNAL_EN field¶

STBY_CR_DYN_ADDR_SIGNAL_EN field¶

STBY_CR_ACCEPT_NACKED_SIGNAL_EN field¶

STBY_CR_ACCEPT_OK_SIGNAL_EN field¶

STBY_CR_ACCEPT_ERR_SIGNAL_EN field¶

STBY_CR_OP_RSTACT_SIGNAL_EN field¶

CCC_PARAM_MODIFIED_SIGNAL_EN field¶

CCC_UNHANDLED_NACK_SIGNAL_EN field¶

CCC_FATAL_RSTDAA_ERR_SIGNAL_EN field¶

STBY_CR_INTR_FORCE register¶

Absolute Address: 0x1AC
Base Offset: 0x2C
Size: 0x4

For software testing, when set to 1'b1, forces the corresponding interrupt to be sent to the Host, if the corresponding fields are set in register STBY_CR_INTR_SIGNAL_ENABLE

Bits	Identifier	Access	Reset
10	CRR_RESPONSE_FORCE	rw	—
11	STBY_CR_DYN_ADDR_FORCE	rw	—
12	STBY_CR_ACCEPT_NACKED_FORCE	rw	—
13	STBY_CR_ACCEPT_OK_FORCE	rw	—
14	STBY_CR_ACCEPT_ERR_FORCE	rw	—
16	STBY_CR_OP_RSTACT_FORCE	w	—
17	CCC_PARAM_MODIFIED_FORCE	rw	—
18	CCC_UNHANDLED_NACK_FORCE	rw	—
19	CCC_FATAL_RSTDAA_ERR_FORCE	rw	—

CRR_RESPONSE_FORCE field¶

STBY_CR_DYN_ADDR_FORCE field¶

STBY_CR_ACCEPT_NACKED_FORCE field¶

STBY_CR_ACCEPT_OK_FORCE field¶

STBY_CR_ACCEPT_ERR_FORCE field¶

STBY_CR_OP_RSTACT_FORCE field¶

CCC_PARAM_MODIFIED_FORCE field¶

CCC_UNHANDLED_NACK_FORCE field¶

CCC_FATAL_RSTDAA_ERR_FORCE field¶

STBY_CR_CCC_CONFIG_GETCAPS register¶

Absolute Address: 0x1B0
Base Offset: 0x30
Size: 0x4

Bits	Identifier	Access	Reset	Name
2:0	F2_CRCAP1_BUS_CONFIG	rw	—
11:8	F2_CRCAP2_DEV_INTERACT	rw	—

F2_CRCAP1_BUS_CONFIG field¶

F2_CRCAP2_DEV_INTERACT field¶

STBY_CR_CCC_CONFIG_RSTACT_PARAMS register¶

Absolute Address: 0x1B4
Base Offset: 0x34
Size: 0x4

Bits	Identifier	Access	Reset	Name
7:0	RST_ACTION	r	0x0	Defining Byte of the RSTACT CCC
15:8	RESET_TIME_PERIPHERAL	rw	0x0	Time to Reset Peripheral
23:16	RESET_TIME_TARGET	rw	0x0	Time to Reset Target
31	RESET_DYNAMIC_ADDR	rw	0x1	Reset Dynamic Address after Target Reset

RST_ACTION field¶

Contains the Defining Byte received with the last Direct SET CCC sent by the Active Controller.

RESET_TIME_PERIPHERAL field¶

For Direct GET CCC, this field is returned for Defining Byte 0x81.

RESET_TIME_TARGET field¶

For Direct GET CCC, this field is returned for Defining Byte 0x82.

RESET_DYNAMIC_ADDR field¶

If set to 1'b1, then the Secondary Controller Logic must clear its Dynamic Address in register STBY_CR_DEVICE_ADDR after receiving a Target Reset Pattern that followed a Broadcast or Direct SET RSTACT CCC sent to the Dynamic Address, with Defining Byte 0x01 or 0x02. Requires support for Dynamic Address Assignment with at least one supported method, such as the ENTDAA CCC, with field DAA_ENTDAA_ENABLE set to 1'b1 in register STBY_CR_CONTROL. If field ACR_FSM_OP_SELECT in register STBY_CR_CONTROL is set to 1'b1, then this field shall be cleared (i.e., readiness to accept the Controller Role shall be revoked) with this Target Reset Pattern.

STBY_CR_VIRT_DEVICE_ADDR register¶

Absolute Address: 0x1B8
Base Offset: 0x38
Size: 0x4

Bits	Identifier	Access	Reset	Name
6:0	VIRT_STATIC_ADDR	rw	0x0	Device Static Address
15	VIRT_STATIC_ADDR_VALID	rw	0x0	Virtual Device Static Address is Valid
22:16	VIRT_DYNAMIC_ADDR	rw	0x0	Virtual Device Dynamic Address
31	VIRT_DYNAMIC_ADDR_VALID	rw	0x0	Virtual Device Dynamic Address is Valid

VIRT_STATIC_ADDR field¶

This field contains the Host Controller Device’s Static Address.

VIRT_STATIC_ADDR_VALID field¶

Indicates whether or not the value in the VIRT_STATIC_ADDR field is valid.

1'b0: The Virtual Device Static Address field is not valid

1'b1: The Virtual Device Static Address field is valid

VIRT_DYNAMIC_ADDR field¶

Contains the Controller Virtual Device’s Dynamic Address.

VIRT_DYNAMIC_ADDR_VALID field¶

Indicates whether or not the value in the VIRT_DYNAMIC_ADDR field is valid. 1'b0: VIRT_DYNAMIC_ADDR field is not valid 1'b1: VIRT_DYNAMIC_ADDR field is valid

__rsvd_3 register¶

Absolute Address: 0x1BC
Base Offset: 0x3C
Size: 0x4

Bits	Identifier	Access	Reset	Name
31:0	__rsvd	rw	—	Reserved

__rsvd field¶

TTI register file¶

Absolute Address: 0x1C0
Base Offset: 0xC0
Size: 0x40

Offset	Identifier	Name
0x00	EXTCAP_HEADER	—
0x04	CONTROL	TTI Control
0x08	STATUS	TTI Status
0x0C	RESET_CONTROL	TTI Queue Reset Control
0x10	INTERRUPT_STATUS	TTI Interrupt Status
0x14	INTERRUPT_ENABLE	TTI Interrupt Enable
0x18	INTERRUPT_FORCE	TTI Interrupt Force
0x1C	RX_DESC_QUEUE_PORT	TTI RX Descriptor Queue Port
0x20	RX_DATA_PORT	TTI RX Data Port
0x24	TX_DESC_QUEUE_PORT	TTI TX Descriptor Queue Port
0x28	TX_DATA_PORT	TTI TX Data Port
0x2C	IBI_PORT	TTI IBI Data Port
0x30	QUEUE_SIZE	TTI Queue Size
0x34	IBI_QUEUE_SIZE	TTI IBI Queue Size
0x38	QUEUE_THLD_CTRL	TTI Queue Threshold Control
0x3C	DATA_BUFFER_THLD_CTRL	TTI IBI Queue Threshold Control

EXTCAP_HEADER register¶

Absolute Address: 0x1C0
Base Offset: 0x0
Size: 0x4

Bits	Identifier	Access	Reset	Name
7:0	CAP_ID	r	0xC4	CAP_ID
23:8	CAP_LENGTH	r	0x10	CAP_LENGTH

CAP_ID field¶

Extended Capability ID

CAP_LENGTH field¶

Capability Structure Length in DWORDs

CONTROL register¶

Absolute Address: 0x1C4
Base Offset: 0x4
Size: 0x4

Control Register

Bits	Identifier	Access	Reset	Name
10	HJ_EN	rw	0x1	HJ_EN
11	CRR_EN	rw	0x0	CRR_EN
12	IBI_EN	rw	0x1	IBI_EN
15:13	IBI_RETRY_NUM	rw	0x0	IBI_RETRY_NUM

HJ_EN field¶

Enable Hot-Join capability.

Values:

0x0 - Device is allowed to attempt Hot-Join.

0x1 - Device is not allowed to attempt Hot-Join.

CRR_EN field¶

Enable Controller Role Request.

Values:

0x0 - Device is allowed to perform Controller Role Request.

0x1 - Device is not allowed to perform Controller Role Request.

IBI_EN field¶

Enable the IBI queue servicing.

Values:

0x0 - Device will not service the IBI queue.

0x1 - Device will send IBI requests onto the bus, if possible.

IBI_RETRY_NUM field¶

Number of times the Target Device will try to request an IBI before giving up.

Values:

0x0 - Device will never retry.

0x1-0x6 - Device will retry this many times.

0x7 - Device will retry indefinitely until the Active Controller sets DISINT bit in the DISEC command.

STATUS register¶

Absolute Address: 0x1C8
Base Offset: 0x8
Size: 0x4

Status Register

Bits	Identifier	Access	Reset	Name
13	PROTOCOL_ERROR	r	0x0	PROTOCOL_ERROR
15:14	LAST_IBI_STATUS	r	0x0	LAST_IBI_STATUS

PROTOCOL_ERROR field¶

Protocol error occurred in the past. This field can only be reset by the Controller, if it issues the GETSTATUS CCC.

Values:

0 - no error occurred

1 - generic protocol error occurred in the past. It will be set until reception of the next GETSTATUS command.

LAST_IBI_STATUS field¶

Status of last IBI. Should be read after IBI_DONE interrupt.

Values:

00 - Success: IBI was transmitted and ACK'd by the Active Controller. 01 - Failure: Active Controller NACK'd the IBI before any data was sent. The Target Device will retry sending the IBI once. 10 - Failure: Active Controller NACK'd the IBI after partial data was sent. Part of data in the IBI queue is considered corrupted and will be discarded. 11 - Failure: IBI was terminated after 1 retry.

RESET_CONTROL register¶

Absolute Address: 0x1CC
Base Offset: 0xC
Size: 0x4

Queue Reset Control

Bits	Identifier	Access	Reset	Name
0	SOFT_RST	rw	0x0	SOFT_RST
1	TX_DESC_RST	rw	0x0	TX_DESC_RST
2	RX_DESC_RST	rw	0x0	RX_DESC_RST
3	TX_DATA_RST	rw	0x0	TX_DATA_RST
4	RX_DATA_RST	rw	0x0	RX_DATA_RST
5	IBI_QUEUE_RST	rw	0x0	IBI_QUEUE_RST

SOFT_RST field¶

Target Core Software Reset

TX_DESC_RST field¶

TTI TX Descriptor Queue Buffer Software Reset

RX_DESC_RST field¶

TTI RX Descriptor Queue Buffer Software Reset

TX_DATA_RST field¶

TTI TX Data Queue Buffer Software Reset

RX_DATA_RST field¶

TTI RX Data Queue Buffer Software Reset

IBI_QUEUE_RST field¶

TTI IBI Queue Buffer Software Reset

INTERRUPT_STATUS register¶

Absolute Address: 0x1D0
Base Offset: 0x10
Size: 0x4

Interrupt Status

Bits	Identifier	Access	Reset	Name
0	RX_DESC_STAT	rw, woclr	0x0	RX_DESC_STAT
1	TX_DESC_STAT	rw, woclr	0x0	TX_DESC_STAT
2	RX_DESC_TIMEOUT	rw, woclr	0x0	RX_DESC_TIMEOUT
3	TX_DESC_TIMEOUT	rw, woclr	0x0	TX_DESC_TIMEOUT
8	TX_DATA_THLD_STAT	rw, woclr	0x0	TX_DATA_THLD_STAT
9	RX_DATA_THLD_STAT	rw, woclr	0x0	RX_DATA_THLD_STAT
10	TX_DESC_THLD_STAT	rw, woclr	0x0	TX_DESC_THLD_STAT
11	RX_DESC_THLD_STAT	rw, woclr	0x0	RX_DESC_THLD_STAT
12	IBI_THLD_STAT	rw, woclr	0x0	IBI_THLD_STAT
13	IBI_DONE	rw, woclr	0x0	IBI_DONE
18:15	PENDING_INTERRUPT	rw, woclr	0x0	PENDING_INTERRUPT
25	TRANSFER_ABORT_STAT	rw, woclr	0x0	TRANSFER_ABORT_STAT
26	TX_DESC_COMPLETE	rw, woclr	0x0	TX_DESC_COMPLETE
31	TRANSFER_ERR_STAT	rw, woclr	0x0	TRANSFER_ERR_STAT

RX_DESC_STAT field¶

There is a pending Write Transaction. Software should read data from the RX Descriptor Queue and the RX Data Queue

TX_DESC_STAT field¶

There is a pending Read Transaction on the I3C Bus. Software should write data to the TX Descriptor Queue and the TX Data Queue

RX_DESC_TIMEOUT field¶

Pending Write was NACK’ed, because the RX_DESC_STAT event was not handled in time

TX_DESC_TIMEOUT field¶

Pending Read was NACK’ed, because the TX_DESC_STAT event was not handled in time

TX_DATA_THLD_STAT field¶

TTI TX Data Buffer Threshold Status, the Target Controller shall set this bit to 1 when the number of available entries in the TTI TX Data Queue is >= the value defined in TTI_TX_DATA_THLD

RX_DATA_THLD_STAT field¶

TTI RX Data Buffer Threshold Status, the Target Controller shall set this bit to 1 when the number of entries in the TTI RX Data Queue is >= the value defined in TTI_RX_DATA_THLD

TX_DESC_THLD_STAT field¶

TTI TX Descriptor Buffer Threshold Status, the Target Controller shall set this bit to 1 when the number of available entries in the TTI TX Descriptor Queue is >= the value defined in TTI_TX_DESC_THLD

RX_DESC_THLD_STAT field¶

TTI RX Descriptor Buffer Threshold Status, the Target Controller shall set this bit to 1 when the number of available entries in the TTI RX Descriptor Queue is >= the value defined in TTI_RX_DESC_THLD

IBI_THLD_STAT field¶

TTI IBI Buffer Threshold Status, the Target Controller shall set this bit to 1 when the number of available entries in the TTI IBI Queue is >= the value defined in TTI_IBI_THLD

IBI_DONE field¶

IBI is done, check LAST_IBI_STATUS for result.

PENDING_INTERRUPT field¶

Contains the interrupt number of any pending interrupt, or 0 if no interrupts are pending. This encoding allows for up to 15 numbered interrupts. If more than one interrupt is set, then the highest priority interrupt shall be returned.

TRANSFER_ABORT_STAT field¶

Bus aborted transaction

TX_DESC_COMPLETE field¶

Read Transaction on the I3C Bus completede

TRANSFER_ERR_STAT field¶

Bus error occurred

INTERRUPT_ENABLE register¶

Absolute Address: 0x1D4
Base Offset: 0x14
Size: 0x4

Interrupt Enable

Bits	Identifier	Access	Reset	Name
0	RX_DESC_STAT_EN	rw	0x0	RX_DESC_STAT_EN
1	TX_DESC_STAT_EN	rw	0x0	TX_DESC_STAT_EN
2	RX_DESC_TIMEOUT_EN	rw	0x0	RX_DESC_TIMEOUT_EN
3	TX_DESC_TIMEOUT_EN	rw	0x0	TX_DESC_TIMEOUT_EN
8	TX_DATA_THLD_STAT_EN	rw	0x0	TX_DATA_THLD_STAT_EN
9	RX_DATA_THLD_STAT_EN	rw	0x0	RX_DATA_THLD_STAT_EN
10	TX_DESC_THLD_STAT_EN	rw	0x0	TX_DESC_THLD_STAT_EN
11	RX_DESC_THLD_STAT_EN	rw	0x0	RX_DESC_THLD_STAT_EN
12	IBI_THLD_STAT_EN	rw	0x0	IBI_THLD_STAT_EN
13	IBI_DONE_EN	rw	0x0	IBI_DONE_EN
25	TRANSFER_ABORT_STAT_EN	rw	0x0	TRANSFER_ABORT_STAT_EN
26	TX_DESC_COMPLETE_EN	rw	0x0	TX_DESC_COMPLETE_EN
31	TRANSFER_ERR_STAT_EN	rw	0x0	TRANSFER_ERR_STAT_EN

RX_DESC_STAT_EN field¶

Enables the corresponding interrupt bit RX_DESC_STAT_EN

TX_DESC_STAT_EN field¶

Enables the corresponding interrupt bit TX_DESC_STAT_EN

RX_DESC_TIMEOUT_EN field¶

Enables the corresponding interrupt bit RX_DESC_TIMEOUT_EN

TX_DESC_TIMEOUT_EN field¶

Enables the corresponding interrupt bit TX_DESC_TIMEOUT_EN

TX_DATA_THLD_STAT_EN field¶

Enables the corresponding interrupt bit TTI_TX_DATA_THLD_STAT

RX_DATA_THLD_STAT_EN field¶

Enables the corresponding interrupt bit TTI_RX_DATA_THLD_STAT

TX_DESC_THLD_STAT_EN field¶

Enables the corresponding interrupt bit TTI_TX_DESC_THLD_STAT

RX_DESC_THLD_STAT_EN field¶

Enables the corresponding interrupt bit TTI_RX_DESC_THLD_STAT

IBI_THLD_STAT_EN field¶

Enables the corresponding interrupt bit TTI_IBI_THLD_STAT

IBI_DONE_EN field¶

Enables the corresponding interrupt bit IBI_DONE

TRANSFER_ABORT_STAT_EN field¶

Enables the corresponding interrupt bit TRANSFER_ABORT_STAT

TX_DESC_COMPLETE_EN field¶

Enables the corresponding interrupt bit TX_DESC_COMPLETE_EN

TRANSFER_ERR_STAT_EN field¶

Enables the corresponding interrupt bit TRANSFER_ERR_STAT

INTERRUPT_FORCE register¶

Absolute Address: 0x1D8
Base Offset: 0x18
Size: 0x4

Interrupt Force

Bits	Identifier	Access	Reset	Name
0	RX_DESC_STAT_FORCE	rw	0x0	RX_DESC_STAT_FORCE
1	TX_DESC_STAT_FORCE	rw	0x0	TX_DESC_STAT_FORCE
2	RX_DESC_TIMEOUT_FORCE	rw	0x0	RX_DESC_TIMEOUT_FORCE
3	TX_DESC_TIMEOUT_FORCE	rw	0x0	TX_DESC_TIMEOUT_FORCE
8	TX_DATA_THLD_FORCE	rw	0x0	TX_DATA_THLD_FORCE
9	RX_DATA_THLD_FORCE	rw	0x0	RX_DATA_THLD_FORCE
10	TX_DESC_THLD_FORCE	rw	0x0	TX_DESC_THLD_FORCE
11	RX_DESC_THLD_FORCE	rw	0x0	RX_DESC_THLD_FORCE
12	IBI_THLD_FORCE	rw	0x0	IBI_THLD_FORCE
13	IBI_DONE_FORCE	rw	0x0	IBI_DONE_FORCE
25	TRANSFER_ABORT_STAT_FORCE	rw	0x0	TRANSFER_ABORT_STAT_FORCE
26	TX_DESC_COMPLETE_FORCE	rw	0x0	TX_DESC_COMPLETE_FORCE
31	TRANSFER_ERR_STAT_FORCE	rw	0x0	TRANSFER_ERR_STAT_FORCE

RX_DESC_STAT_FORCE field¶

Enables the corresponding interrupt bit RX_DESC_STAT_FORCE

TX_DESC_STAT_FORCE field¶

Enables the corresponding interrupt bit TX_DESC_STAT_FORCE

RX_DESC_TIMEOUT_FORCE field¶

Enables the corresponding interrupt bit RX_DESC_TIMEOUT_FORCE

TX_DESC_TIMEOUT_FORCE field¶

Enables the corresponding interrupt bit TX_DESC_TIMEOUT_FORCE

TX_DATA_THLD_FORCE field¶

Forces the corresponding interrupt bit TTI_TX_DATA_THLD_STAT to be set to 1

RX_DATA_THLD_FORCE field¶

Forces the corresponding interrupt bit TTI_RX_DATA_THLD_STAT to be set to 1

TX_DESC_THLD_FORCE field¶

Forces the corresponding interrupt bit TTI_TX_DESC_THLD_STAT to be set to 1

RX_DESC_THLD_FORCE field¶

Forces the corresponding interrupt bit TTI_RX_DESC_THLD_STAT to be set to 1

IBI_THLD_FORCE field¶

Forces the corresponding interrupt bit TTI_IBI_THLD_STAT to be set to 1

IBI_DONE_FORCE field¶

Enables the corresponding interrupt bit IBI_DONE_FORCE

TRANSFER_ABORT_STAT_FORCE field¶

Enables the corresponding interrupt bit TRANSFER_ABORT_STAT_FORCE

TX_DESC_COMPLETE_FORCE field¶

Enables the corresponding interrupt bit TX_DESC_COMPLETE_FORCE

TRANSFER_ERR_STAT_FORCE field¶

Enables the corresponding interrupt bit TRANSFER_ERR_STAT_FORCE

RX_DESC_QUEUE_PORT register¶

Absolute Address: 0x1DC
Base Offset: 0x1C
Size: 0x4

RX Descriptor Queue Port

Bits	Identifier	Access	Reset	Name
31:0	RX_DESC	r	0x0	RX_DESC

RX_DESC field¶

RX Data

RX_DATA_PORT register¶

Absolute Address: 0x1E0
Base Offset: 0x20
Size: 0x4

RX Data Port

Bits	Identifier	Access	Reset	Name
31:0	RX_DATA	r	0x0	RX_DATA

RX_DATA field¶

RX Data

TX_DESC_QUEUE_PORT register¶

Absolute Address: 0x1E4
Base Offset: 0x24
Size: 0x4

TX Descriptor Queue Port

Bits	Identifier	Access	Reset	Name
31:0	TX_DESC	w	0x0	TX_DESC

TX_DESC field¶

TX Data

TX_DATA_PORT register¶

Absolute Address: 0x1E8
Base Offset: 0x28
Size: 0x4

TX Data Port

Bits	Identifier	Access	Reset	Name
31:0	TX_DATA	w	0x0	TX_DATA

TX_DATA field¶

TX Data

IBI_PORT register¶

Absolute Address: 0x1EC
Base Offset: 0x2C
Size: 0x4

IBI Data Port

Bits	Identifier	Access	Reset	Name
31:0	IBI_DATA	w	0x0	IBI_DATA

IBI_DATA field¶

IBI Data

QUEUE_SIZE register¶

Absolute Address: 0x1F0
Base Offset: 0x30
Size: 0x4

Queue Size

Bits	Identifier	Access	Reset	Name
7:0	RX_DESC_BUFFER_SIZE	r	0x5	RX_DESC_BUFFER_SIZE
15:8	TX_DESC_BUFFER_SIZE	r	0x5	TX_DESC_BUFFER_SIZE
23:16	RX_DATA_BUFFER_SIZE	r	0x5	RX_DATA_BUFFER_SIZE
31:24	TX_DATA_BUFFER_SIZE	r	0x5	TX_DATA_BUFFER_SIZE

RX_DESC_BUFFER_SIZE field¶

RX Descriptor Buffer Size in DWORDs calculated as 2^(N+1)

TX_DESC_BUFFER_SIZE field¶

TX Descriptor Buffer Size in DWORDs calculated as 2^(N+1)

RX_DATA_BUFFER_SIZE field¶

Receive Data Buffer Size in DWORDs calculated as 2^(N+1)

TX_DATA_BUFFER_SIZE field¶

Transmit Data Buffer Size in DWORDs calculated as 2^(N+1)

IBI_QUEUE_SIZE register¶

Absolute Address: 0x1F4
Base Offset: 0x34
Size: 0x4

IBI Queue Size

Bits	Identifier	Access	Reset	Name
7:0	IBI_QUEUE_SIZE	r	0x5	IBI_QUEUE_SIZE

IBI_QUEUE_SIZE field¶

IBI Queue Size in DWORDs calculated as 2^(N+1)

QUEUE_THLD_CTRL register¶

Absolute Address: 0x1F8
Base Offset: 0x38
Size: 0x4

Queue Threshold Control

Bits	Identifier	Access	Reset	Name
7:0	TX_DESC_THLD	rw	0x1	TX_DESC_THLD
15:8	RX_DESC_THLD	rw	0x1	RX_DESC_THLD
31:24	IBI_THLD	rw	0x1	IBI_THLD

TX_DESC_THLD field¶

Controls the minimum number of empty TTI TX Descriptor Queue entries needed to trigger the TTI TX Descriptor interrupt.

RX_DESC_THLD field¶

Controls the minimum number of TTI RX Descriptor Queue entries needed to trigger the TTI RX Descriptor interrupt.

IBI_THLD field¶

Controls the minimum number of IBI Queue entries needed to trigger the IBI threshold interrupt.

DATA_BUFFER_THLD_CTRL register¶

Absolute Address: 0x1FC
Base Offset: 0x3C
Size: 0x4

IBI Queue Threshold Control

Bits	Identifier	Access	Reset	Name
2:0	TX_DATA_THLD	rw	0x1	TX_DATA_THLD
10:8	RX_DATA_THLD	rw	0x1	RX_DATA_THLD
18:16	TX_START_THLD	rw	0x1	TX_DATA_THLD
26:24	RX_START_THLD	rw	0x1	RX_DATA_THLD

TX_DATA_THLD field¶

Minimum number of available TTI TX Data queue entries, in DWORDs, that will trigger the TTI TX Data interrupt. Interrupt triggers when 2^(N+1) TX Buffer DWORD entries are available.

RX_DATA_THLD field¶

Minimum number of TTI RX Data queue entries of data received, in DWORDs, that will trigger the TTI RX Data interrupt. Interrupt triggers when 2^(N+1) RX Buffer DWORD entries are received during the Read transfer.

TX_START_THLD field¶

Minimum number of available TTI TX Data queue entries, in DWORDs, that will trigger the TTI TX Data interrupt. Interrupt triggers when 2^(N+1) TX Buffer DWORD entries are available.

RX_START_THLD field¶

SoCMgmtIf register file¶

Absolute Address: 0x200
Base Offset: 0x100
Size: 0x5C

Offset	Identifier	Name
0x00	EXTCAP_HEADER	—
0x04	SOC_MGMT_CONTROL	SoC Management Control
0x08	SOC_MGMT_STATUS	SoC Management Status
0x0C	REC_INTF_CFG	Configuration of Recovery Interface
0x10	REC_INTF_REG_W1C_ACCESS	Mock hardware register access
0x14	SOC_MGMT_RSVD_2
0x18	SOC_MGMT_RSVD_3
0x1C	SOC_PAD_CONF	I3C Pad Configuration Register
0x20	SOC_PAD_ATTR	I3C Pad Attribute Configuration Register
0x24	SOC_MGMT_FEATURE_2
0x28	SOC_MGMT_FEATURE_3
0x2C	T_R_REG
0x30	T_F_REG
0x34	T_SU_DAT_REG
0x38	T_HD_DAT_REG
0x3C	T_HIGH_REG
0x40	T_LOW_REG
0x44	T_HD_STA_REG
0x48	T_SU_STA_REG
0x4C	T_SU_STO_REG
0x50	T_FREE_REG
0x54	T_AVAL_REG
0x58	T_IDLE_REG

EXTCAP_HEADER register¶

Absolute Address: 0x200
Base Offset: 0x0
Size: 0x4

Bits	Identifier	Access	Reset	Name
7:0	CAP_ID	r	0xC1	CAP_ID
23:8	CAP_LENGTH	r	0x18	CAP_LENGTH

CAP_ID field¶

Extended Capability ID

CAP_LENGTH field¶

Capability Structure Length in DWORDs

SOC_MGMT_CONTROL register¶

Absolute Address: 0x204
Base Offset: 0x4
Size: 0x4

Bits	Identifier	Access	Reset	Name
31:0	PLACEHOLDER	rw	0x0

PLACEHOLDER field¶

SOC_MGMT_STATUS register¶

Absolute Address: 0x208
Base Offset: 0x8
Size: 0x4

Bits	Identifier	Access	Reset	Name
31:0	PLACEHOLDER	rw	0x0

PLACEHOLDER field¶

REC_INTF_CFG register¶

Absolute Address: 0x20C
Base Offset: 0xC
Size: 0x4

Bits	Identifier	Access	Reset	Name
0	REC_INTF_BYPASS	rw	0x0	Recovery Interface access type
1	REC_PAYLOAD_DONE	rw	0x0	Recovery payload done

REC_INTF_BYPASS field¶

Choose Recovery Interface access type:

0 - I3C Core
1 - direct AXI

REC_PAYLOAD_DONE field¶

Inform Recovery Handler that payload transfer is finished.

REC_INTF_REG_W1C_ACCESS register¶

Absolute Address: 0x210
Base Offset: 0x10
Size: 0x4

Bits	Identifier	Access	Reset	Name
7:0	DEVICE_RESET_CTRL	rw	0x0	HW Device Reset Control
15:8	RECOVERY_CTRL_ACTIVATE_REC_IMG	rw	0x0	HW Activate Recovery Image
23:16	INDIRECT_FIFO_CTRL_RESET	rw	0x0	HW Indirect FIFO Reset Control

DEVICE_RESET_CTRL field¶

Write to 'Reset control - Device Reset Control' register, mocking a hardware access (bypassing 'write 1 to clear' register property).

RECOVERY_CTRL_ACTIVATE_REC_IMG field¶

Write to 'Recovery Control - Activate Recovery Image' register, mocking a hardware access (bypassing 'write 1 to clear' register property).

INDIRECT_FIFO_CTRL_RESET field¶

Write to 'Indirect memory configuration - reset' register, mocking a hardware access (bypassing 'write 1 to clear' register property).

SOC_MGMT_RSVD_2 register¶

Absolute Address: 0x214
Base Offset: 0x14
Size: 0x4

Bits	Identifier	Access	Reset	Name
31:0	PLACEHOLDER	rw	0x0

PLACEHOLDER field¶

SOC_MGMT_RSVD_3 register¶

Absolute Address: 0x218
Base Offset: 0x18
Size: 0x4

Bits	Identifier	Access	Reset	Name
31:0	PLACEHOLDER	rw	0x0

PLACEHOLDER field¶

SOC_PAD_CONF register¶

Absolute Address: 0x21C
Base Offset: 0x1C
Size: 0x4

Bits	Identifier	Access	Reset	Name
0	INPUT_ENABLE	rw	0x1	Enable Input
1	SCHMITT_EN	rw	0x0	Schmitt Trigger Enable
2	KEEPER_EN	rw	0x0	High-Keeper Enable
3	PULL_DIR	rw	0x0	Pull Direction
4	PULL_EN	rw	0x0	Pull Enable
5	IO_INVERSION	rw	0x0	IO INVERSION
6	OD_EN	rw	0x0	Open-Drain Enable
7	VIRTUAL_OD_EN	rw	0x0	Virtual Open Drain Enable
31:24	PAD_TYPE	rw	0x1	Pad type

INPUT_ENABLE field¶

Enable input:

0 - enabled

1 - disabled

SCHMITT_EN field¶

Enable the Schmitt Trigger:

0 - disabled

1 - enabled

KEEPER_EN field¶

Enable the High-Keeper:

0 - disabled

1 - enabled

PULL_DIR field¶

Direction of the pull:

0 - Pull down

1 - Pull up

PULL_EN field¶

Enable Pull:

0 - disabled

1 - enabled

IO_INVERSION field¶

Invert I/O signal:

0 - signals pass-through

1 - signals are inverted

OD_EN field¶

Enable Open-Drain:

0 - disabled

1 - enabled

VIRTUAL_OD_EN field¶

Enable virtual open drain:

0 - disabled

1 - enabled

PAD_TYPE field¶

Select pad type

0 - Bidirectional

1 - Open-drain

2 - Input-only

3 - Analog input

SOC_PAD_ATTR register¶

Absolute Address: 0x220
Base Offset: 0x20
Size: 0x4

Bits	Identifier	Access	Reset	Name
15:8	DRIVE_SLEW_RATE	rw	0xF	Driver Slew Rate
31:24	DRIVE_STRENGTH	rw	0xF	Driver Strength

DRIVE_SLEW_RATE field¶

Select driver slew rate

'0 - lowest

'1 - highest

DRIVE_STRENGTH field¶

Select driver strength

'0 - lowest

'1 - highest

SOC_MGMT_FEATURE_2 register¶

Absolute Address: 0x224
Base Offset: 0x24
Size: 0x4

Bits	Identifier	Access	Reset	Name
31:0	PLACEHOLDER	rw	0x0

PLACEHOLDER field¶

Reserved for: I/O ring and pad configuration

SOC_MGMT_FEATURE_3 register¶

Absolute Address: 0x228
Base Offset: 0x28
Size: 0x4

Bits	Identifier	Access	Reset	Name
31:0	PLACEHOLDER	rw	0x0

PLACEHOLDER field¶

Reserved for: I/O ring and pad configuration

T_R_REG register¶

Absolute Address: 0x22C
Base Offset: 0x2C
Size: 0x4

Bits	Identifier	Access	Reset	Name
19:0	T_R	rw	0x0

T_R field¶

Rise time of both SDA and SCL in clock units

T_F_REG register¶

Absolute Address: 0x230
Base Offset: 0x30
Size: 0x4

Bits	Identifier	Access	Reset	Name
19:0	T_F	rw	0x0

T_F field¶

Fall time of both SDA and SCL in clock units

T_SU_DAT_REG register¶

Absolute Address: 0x234
Base Offset: 0x34
Size: 0x4

Bits	Identifier	Access	Reset	Name
19:0	T_SU_DAT	rw	0x0

T_SU_DAT field¶

Data setup time in clock units

T_HD_DAT_REG register¶

Absolute Address: 0x238
Base Offset: 0x38
Size: 0x4

Bits	Identifier	Access	Reset	Name
19:0	T_HD_DAT	rw	0x0

T_HD_DAT field¶

Data hold time in clock units

T_HIGH_REG register¶

Absolute Address: 0x23C
Base Offset: 0x3C
Size: 0x4

Bits	Identifier	Access	Reset	Name
19:0	T_HIGH	rw	0x0	High period of the SCL in clock units

T_HIGH field¶

T_LOW_REG register¶

Absolute Address: 0x240
Base Offset: 0x40
Size: 0x4

Bits	Identifier	Access	Reset	Name
19:0	T_LOW	rw	0x0

T_LOW field¶

Low period of the SCL in clock units

T_HD_STA_REG register¶

Absolute Address: 0x244
Base Offset: 0x44
Size: 0x4

Bits	Identifier	Access	Reset	Name
19:0	T_HD_STA	rw	0x0

T_HD_STA field¶

Hold time for (repeated) START in clock units

T_SU_STA_REG register¶

Absolute Address: 0x248
Base Offset: 0x48
Size: 0x4

Bits	Identifier	Access	Reset	Name
19:0	T_SU_STA	rw	0x0

T_SU_STA field¶

Setup time for repeated START in clock units

T_SU_STO_REG register¶

Absolute Address: 0x24C
Base Offset: 0x4C
Size: 0x4

Bits	Identifier	Access	Reset	Name
19:0	T_SU_STO	rw	0x0

T_SU_STO field¶

Setup time for STOP in clock units

T_FREE_REG register¶

Absolute Address: 0x250
Base Offset: 0x50
Size: 0x4

Bits	Identifier	Access	Reset	Name
31:0	T_FREE	rw	0xC

T_FREE field¶

T_AVAL_REG register¶

Absolute Address: 0x254
Base Offset: 0x54
Size: 0x4

Bits	Identifier	Access	Reset	Name
31:0	T_AVAL	rw	0x12C

T_AVAL field¶

T_IDLE_REG register¶

Absolute Address: 0x258
Base Offset: 0x58
Size: 0x4

Bits	Identifier	Access	Reset	Name
31:0	T_IDLE	rw	0xEA60

T_IDLE field¶

CtrlCfg register file¶

Absolute Address: 0x260
Base Offset: 0x160
Size: 0x8

Offset	Identifier	Name
0x0	EXTCAP_HEADER	—
0x4	CONTROLLER_CONFIG	Controller Config

EXTCAP_HEADER register¶

Absolute Address: 0x260
Base Offset: 0x0
Size: 0x4

Bits	Identifier	Access	Reset	Name
7:0	CAP_ID	r	0x2	CAP_ID
23:8	CAP_LENGTH	r	0x2	CAP_LENGTH

CAP_ID field¶

Extended Capability ID

CAP_LENGTH field¶

Capability Structure Length in DWORDs

CONTROLLER_CONFIG register¶

Absolute Address: 0x264
Base Offset: 0x4
Size: 0x4

Bits	Identifier	Access	Reset	Name
5:4	OPERATION_MODE	r	0x1	Operation Mode

OPERATION_MODE field¶

TERMINATION_EXTCAP_HEADER register¶

Absolute Address: 0x268
Base Offset: 0x168
Size: 0x4

Register after the last EC must advertise ID == 0. Termination register is added to guarantee that the discovery mechanism reaches termination value.

Bits	Identifier	Access	Reset	Name
7:0	CAP_ID	r	0x0	CAP_ID
23:8	CAP_LENGTH	r	0x1	CAP_LENGTH

CAP_ID field¶

Extended Capability ID

CAP_LENGTH field¶

Capability Structure Length in DWORDs

Last update: 2025-04-24