Skip to content

[i2c, dv] I2C V1 sign-off#616

Open
KinzaQamar wants to merge 1 commit into
lowRISC:mainfrom
KinzaQamar:i2c_v1_signoff
Open

[i2c, dv] I2C V1 sign-off#616
KinzaQamar wants to merge 1 commit into
lowRISC:mainfrom
KinzaQamar:i2c_v1_signoff

Conversation

@KinzaQamar

Copy link
Copy Markdown
Contributor

No description provided.

@KinzaQamar KinzaQamar linked an issue Jun 17, 2026 that may be closed by this pull request
Comment thread doc/proj/i2c.md
[i2c_bind.sv]: ../../hw/vendor/lowrisc_ip/ip/i2c/dv/sva/i2c_bind.sv
[tb.sv]: ../../hw/vendor/lowrisc_ip/ip/i2c/dv/tb/tb.sv
[I2C DV document]: ../../hw/vendor/lowrisc_ip/ip/i2c/dv/README.md
[I2C testplan]: ../../hw/vendor/lowrisc_ip/ip/i2c/data/i2c_testplan.hjson

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Duplicated link (already defined at line 80)

Comment thread doc/proj/i2c.md Outdated
Comment thread doc/proj/i2c.md Outdated
Comment thread doc/proj/i2c.md Outdated
Comment thread doc/proj/i2c.md Outdated
Comment thread doc/proj/i2c.md Outdated
Comment thread doc/proj/i2c.md

*Checklist to be defined — see [stages.md][verification stages].*

[COSMIC reports dashboard]: https://private.reports.lowrisc.org

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

That's our internal link, only accessible by us. You should change it into:

Suggested change
[COSMIC reports dashboard]: https://private.reports.lowrisc.org
[COSMIC reports dashboard]: https://dashboard.reports.lowrisc.org/cosmic/mocha/dashboard.html

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

This links gives a report on 29/4. Just a summary of percentage and not what is passing and failing? Do we have a proper public dashboard?

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Yes I have shared this issue already with @machshev, he's on holidays but I guess he'll take a look later. If you prefer you can say that you've checked on our private regressions and provide the date and share the Git hash mentioned in there, as such lowRISC fellows can cross-check at least. But please keep the public dashboard link as done in the template

@marnovandermaas marnovandermaas left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

Some initial nits from my end.

Comment thread doc/proj/i2c.md
* 7-bit target address
* all the mandatory features listed for controllers in [Table 2: I2C specification Rev 6][]
* multi-controller features such as bus arbitration and controller-controller clock synchronization
* clock stretching in both controller and target modes

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

Suggested change
* clock stretching in both controller and target modes
* clock stretching in both controller and target modes.

Comment thread doc/proj/i2c.md Outdated

The I2C block is imported from OpenTitan. The documentation is located [here][block doc].
The I2C block can be programmed in both controller and target modes. It supports:
* speeds for standard, fast and fast plus modes.

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

Suggested change
* speeds for standard, fast and fast plus modes.
* speeds for standard, fast and fast plus modes

Comment thread doc/proj/i2c.md
### D1

The sign-off checklist items are described in the [D1 design sign-off checklist][D1 checklist].
This sign-off is based on commit [`1234def`][d1-commit] (nightly yyyy-mm-dd).

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

This placeholder looks weird. Maybe we can say that D1 sign-off is not started yet.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

I think Kinza did that because of what I've done for the GPIO. To me it was looking more logic to keep the template placeholders, but since you are 2 feeling the other way, I'll change it in my PR too

Comment thread doc/proj/i2c.md
|---------------|------------------------------------|--------|------------------|
| Documentation | DV_DOC_DRAFT_COMPLETED | Done | [I2C DV document][] describes the goals, testbench architecture, stimulus, coverage and checking strategy |
| Documentation | TESTPLAN_COMPLETED | Done | [I2C testplan][] defines the V1 smoke test and post-V1 functional, error, performance and stress testpoints |
| Testbench | TB_TOP_CREATED | Done | [tb.sv][]; instantiates clock and reset, tilelink, I2C, and interrupt interfaces along with I2C DUT |

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

Suggested change
| Testbench | TB_TOP_CREATED | Done | [tb.sv][]; instantiates clock and reset, tilelink, I2C, and interrupt interfaces along with I2C DUT |
| Testbench | TB_TOP_CREATED | Done | [tb.sv][] instantiates clock and reset, tilelink, I2C, and interrupt interfaces along with I2C DUT |

Signed-off-by: Kinza Qamar <kqzaman@lowrisc.org>
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.

I2C DV - V1 signoff

3 participants