Skip to content

Support APB5 data user signals (PWUSER, PRUSER) - #39

Merged
vowstar merged 3 commits into
mainfrom
apb5-data-user
Nov 13, 2026
Merged

vowstar merged 3 commits into
mainfrom
apb5-data-user

Conversation

@vowstar

@vowstar vowstar commented Nov 13, 2026

Copy link
Copy Markdown
Owner

Why

APB5 peripherals use PWUSER and PRUSER to carry sideband data with each data
byte.

What this changes

Part Change
transport.data_user_bits_per_byte User bits per data byte, 0 to 4. The default 0 keeps existing output unchanged
APB5 data_user_width Sets both PWUSER and PRUSER. It must be 0 or bits per byte times data bytes. Other values produce NCL_APB5_DATA_USER_WIDTH
Byte groups Each group travels with its data byte through width conversion, packet splitting, clock crossings and pipes
Writes A byte with PSTRB zero carries a zero group
Reads Each byte's group comes from the access that returned it. A read that ends with PSLVERR returns zero in every PRUSER bit
Other protocols Endpoints without data user ports write zero groups and drop read groups
Fix A static pipe bypass across clock domains no longer fails the clock binding check
Docs User signal manual, definition, diagnostics, protocols, dedicated targets and README limits

How you checked it

Protocol simulation covers 8, 16 and 32 bit endpoints in one and two clock
domains, partial strobes, narrow splits, errors, timeouts and AXI4 traffic.
Negative controls swap neighbouring groups or keep groups for masked bytes, and
the tests catch both. The bypass fix has its own regression.

Closes: #4

Signed-off-by: Huang Rui <vowstar@gmail.com>
Signed-off-by: Huang Rui <vowstar@gmail.com>
Signed-off-by: Huang Rui <vowstar@gmail.com>
@vowstar
vowstar merged commit 7b36af0 into main Nov 13, 2026
4 checks passed
@vowstar
vowstar deleted the apb5-data-user branch November 13, 2026 20:15
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Support APB5 data user signals (PWUSER, PRUSER)

1 participant