cv32e40p icon indicating copy to clipboard operation
cv32e40p copied to clipboard

Pinout: Document Auxiliary Processing Unit (APU) interface

Open Silabs-ArjanB opened this issue 5 years ago • 11 comments

Currently there is no documentation about this interface in the User Manual. I added the core-v-docs/cores/cv32e40p/user_manual/source/apu.rst file to start the documentation for this feature including a list of the associated pins (and will do a pull request for this soon).

We need to have (at least) the following information in this section:

  • Description of the mentioned signals
  • Protocol (and semantics) of the mentioned signals
  • High level purpose of this interface
  • Clarification of the WAPUTYPE value (it is currently 0 leading to apu_master_type_o[-1:0] (negative range)
  • Interaction with the FPU
  • Relationship with the FPU parameter (if any)
  • Relationship with the PULP_ZFINX parameter (if any)

Silabs-ArjanB avatar May 18 '20 06:05 Silabs-ArjanB

@davideschiavone, @Silabs-ArjanB, I am not sure why this issue was closed. Very few of the goals defined above have been met.

MikeOpenHWGroup avatar Jul 27 '20 16:07 MikeOpenHWGroup

Hi @MikeOpenHWGroup As you can see this issue has not/never been closed. Only the duplicate issues https://github.com/openhwgroup/cv32e40p/issues/49 and openhwgroup/core-v-docs#68 have been closed.

Silabs-ArjanB avatar Jul 28 '20 06:07 Silabs-ArjanB

Ha! Right you are @Silabs-ArjanB. I saw the "closed" icons in the discussion thread and incorrectly thought they applied to this issue, not openhwgroup/core-v-docs#49. My mistake.

MikeOpenHWGroup avatar Jul 28 '20 11:07 MikeOpenHWGroup

@davideschiavone, do you have plans to do this documentation? It is currently gating openhwgroup/cv32e40p#537.

MikeOpenHWGroup avatar Oct 26 '20 15:10 MikeOpenHWGroup

Working on it with ETH, anyway that issue is a low priority task, not gating any verification or design issues

davideschiavone avatar Oct 26 '20 16:10 davideschiavone

issue is a low priority task, not gating any verification or design issues

I agree that it low priority, but we are pushing to RTL Freeze, so we either need to resolve all open issues or waive them.

MikeOpenHWGroup avatar Oct 26 '20 16:10 MikeOpenHWGroup

openhwgroup/core-v-docs#233 has been merged. Closing this issue.

davideschiavone avatar Oct 27 '20 06:10 davideschiavone

I do not think we can yet close this issue. The current head of the docs (f2355b88) falls short of the goals of this issue.

MikeOpenHWGroup avatar Oct 27 '20 13:10 MikeOpenHWGroup

This issue has a PARAM:FPU label which means that it will be waived for Functional RTL Freeze. I cannot agree with this since the APU interface of the core we are freezing does not match the ports specified in the Use Manual. We may be able to defer full and complete documentation of this interface, but at least the ports on the RTL and the UM should match.

MikeOpenHWGroup avatar Nov 03 '20 13:11 MikeOpenHWGroup

Hi @MikeOpenHWGroup I fixed the apu_* names in the integration chapter (see https://github.com/openhwgroup/core-v-docs/pull/243). As far as I am concerned we are then just waiting on completion of https://github.com/openhwgroup/core-v-docs/pull/237, which does not have to gate RTL freeze as far as I am concerned.

Silabs-ArjanB avatar Nov 03 '20 17:11 Silabs-ArjanB

Yep, I saw openhwgroup/core-v-docs#243, thanks. I agree that openhwgroup/core-v-docs#237 does not gate RTL Freeze. But we have time, so why not?

MikeOpenHWGroup avatar Nov 03 '20 17:11 MikeOpenHWGroup

APU interface is not visible anymore in new CV32E40P top level (cv32e40p_top). Only used internally to connect FPU.

pascalgouedo avatar Aug 04 '23 11:08 pascalgouedo