Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

dft: per-chain enables, user-configurable name patterns #6412

Draft
wants to merge 1 commit into
base: master
Choose a base branch
from

Conversation

donn
Copy link
Contributor

@donn donn commented Dec 22, 2024

This changeset makes the DFT module a bit more flexible.

The highlights are new ports don't have to be punched- you can connect to any existing ITerm or BTerm and new ports are only punched as a fallback. Additionally, the scan chain order can be written in a JSON format so it may be consumed by other utilities.


  • dft::Dft::insertDft: Add capability for per-chain enable, ability to provide runtime format strings for scan enable/in/out patterns
  • dft::ScanStitch:
    • if a name pattern includes an un-escaped forward slash (/), steps are to attempt to find an existing ITerm instead of creating a new BTerm
    • else, if a BTerm already exists, the BTerm is reused.
    • finally, a new BTerm is created.
  • dft::Dft: create writeScanChains, which writes the scan chains (currently just names and ordering of flip-flops) in JSON format. Allows data to be passed to other DFT utilities.
  • dft: create ResetDomain, which encapsulates reset domains similar to how dft::ClockDomain encapsulates clock domains. currently unused

There is one breaking change, which is that scan_enable_{}/scan_in_{}/ etc are numbered starting from 0 instead of 1. The rationale is the chains themselves are numbered starting from 0 and there appears to be no good justification to start them from 1. Otherwise, tests will (hopefully) show this PR as fully backwards-compatible.

Copy link
Contributor

@github-actions github-actions bot left a comment

Choose a reason for hiding this comment

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

clang-tidy made some suggestions

src/dft/src/Dft.cpp Outdated Show resolved Hide resolved
src/dft/src/Dft.cpp Show resolved Hide resolved
src/dft/src/Dft.cpp Show resolved Hide resolved
src/dft/src/Dft.cpp Show resolved Hide resolved
src/dft/src/stitch/ScanStitch.cpp Show resolved Hide resolved
src/dft/src/stitch/ScanStitch.cpp Show resolved Hide resolved
src/dft/src/stitch/ScanStitch.cpp Show resolved Hide resolved
src/dft/src/stitch/ScanStitch.cpp Outdated Show resolved Hide resolved
src/dft/src/stitch/ScanStitch.hh Show resolved Hide resolved
src/dft/src/utils/Utils.cpp Outdated Show resolved Hide resolved
@donn donn force-pushed the dft_tweaks branch 2 times, most recently from 680b23b to 384887b Compare December 23, 2024 14:38
@donn donn marked this pull request as ready for review December 24, 2024 08:41
@donn donn force-pushed the dft_tweaks branch 2 times, most recently from 6af52bc to a9ff57d Compare December 24, 2024 14:30
@donn donn marked this pull request as draft December 24, 2024 14:53
This changeset makes the DFT module a bit more flexible.

The highlights are new ports don't have to be punched- you can connect to any existing ITerm or BTerm and new ports are only punched as a fallback. Additionally, the scan chain order can be written in a JSON format so it may be consumed by other utilities.

---

* dft::Dft::insertDft: Add capability for per-chain enable, ability to provide runtime format strings for scan enable/in/out patterns
* dft::ScanStitch:
  * if a name pattern includes an un-escaped forward slash (/), steps are to attempt to find an existing ITerm instead of creating a new BTerm
  * else, if a BTerm already exists, the BTerm is reused.
  * finally, a new BTerm is created.
* dft::Dft: create writeScanChains, which writes the scan chains (currently just names and ordering of flip-flops) in JSON format. Allows data to be passed to other DFT utilities.
* dft: create ResetDomain, which encapsulates reset domains similar to how dft::ClockDomain encapsulates clock domains. currently unused

---

There is one breaking change, which is that scan_enable_{}/scan_in_{}/ etc are numbered starting from 0 instead of 1. The rationale is the chains themselves are numbered starting from 0 and there appears to be no good justification to start them from 1. Otherwise, tests will (hopefully) show this PR as fully backwards-compatible.

Signed-off-by: Mohamed Gaber <[email protected]>
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.

1 participant