Skip to content

Add batcher cocotb regression coverage#1426

Draft
bengineerd wants to merge 4 commits into
packetizer-testsfrom
batcher-tests
Draft

Add batcher cocotb regression coverage#1426
bengineerd wants to merge 4 commits into
packetizer-testsfrom
batcher-tests

Conversation

@bengineerd
Copy link
Copy Markdown
Contributor

@bengineerd bengineerd commented May 28, 2026

Description

Adds focused cocotb regression coverage for the AXI Stream batcher family, including the batcher data path, AXI-Lite control/status interface, event-builder path, and common/async clock configurations.

Details

This batcher-focused slice adds thin VHDL wrappers under protocols/batcher/wrappers/ so cocotb can drive and observe the existing RTL through flattened AXI Stream and AXI-Lite interfaces. The wrappers cover:

  • AxiStreamBatcher
  • AxiStreamBatcherAxil
  • AxiStreamBatcherEventBuilder

The new Python regression support under tests/protocols/batcher/ adds shared batcher helpers and directed tests for:

  • batch formatting, frame boundaries, sequence/count behavior, and payload preservation;
  • ready/valid behavior and output frame checking for the core batcher path;
  • AXI-Lite register access, control/status behavior, and software-visible batcher configuration;
  • event-builder routing/formatting behavior through the wrapper topology;
  • common-clock and asynchronous-clock configurations used by the batcher/event-builder paths.

The branch also adds batcher regression planning and handoff notes under docs/plans/batcher-regression/ and updates the shared RTL regression notes with the batcher progress.

This PR is stacked after #1425 and should be merged after packetizer-tests and before rssi-tests.

Related

Depends on #1425. Follow-up stack: #1427.

…port and improved test coverage

- Updated AxiStreamBatcherAxilWrapper to support both common and independent AXI-Lite clock modes.
- Enhanced AxiStreamBatcherEventBuilderWrapper to include a new route mode for TDEST remapping.
- Modified tests for AxiStreamBatcherAxil to validate behavior under both clock configurations.
- Expanded tests for AxiStreamBatcherEventBuilder to cover additional routing scenarios and transition TDEST configurations.
- Improved documentation in handoff and progress files to reflect the latest implementation status and next steps.
Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot encountered an error and was unable to review this pull request. You can try again by re-requesting a review.

Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot encountered an error and was unable to review this pull request. You can try again by re-requesting a review.

Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 14 out of 14 changed files in this pull request and generated no new comments.

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.

2 participants