Comments (5)
I'm actually working on the initial architecture for it as we speak, and hope to implement it quite soon.
One thing that will be the biggest help is to get ideas for what specific features people are looking for. Generally, I plan to have the tool generate both a struct overlay for register addressing, as well as #define
for field definitions. One good existing example is ARM's CMSIS headers: https://github.com/ARM-software/CMSIS_4/blob/master/CMSIS/Include/core_cm4.h
If there is anything specific you have seen in your experience that you'd like to see in the tool, let me know!
from peakrdl-cheader.
Seems like fortuitous timing. :) I am approaching this from a standing start (nearly).
Deeply embedded processor sub-systems I have designed and implemented have mostly been a very manual process. This approach is not sustainable, particularly for the projct I am currently working on.
I have talked to one of our SW devs, he agrees the example file you linked to would be good.
Some initial thoughts I have been pondering are below, this is by no means exhaustive but maybe a start;
- Where possible, maximise repeatability of macro/struct names from one RDL build to the next. The idea being to minimise unneccessry/avoidable changes to the Drivers that cuse the register HAL.
- If possible, generate optional C tests to self check and/or exercise register functionality.
- Annotate output (Doxygen?), especially properties like single pulse, clear on read, buffered read/write triggers
- Some kind of versioning that propagates from the RDL, to system verilog register build and through to Register C HAL. The idea being mistmatches can be detected.
- Propagate description strings and perhaps be able to provide URL prefix to link back to html documentation for internal team.
I am keen to help testing if you need/want.
from peakrdl-cheader.
Yep that's generally the idea.
- Macro/Struct type names will be derived from the RDL lexical type names where possible (Similar to how the structs are named for peakrdl-regblock)
- Yes tests to be included as an optional feature. Will be making unit tests anyways, so may as well bundle them with the tool too.
- Doxygen is a good idea and a tidy way to include the desc/name strings too. Hadn't thought to do it that way. Thanks!
- Versioning will be difficult to do generically, however if I also export defines for field reset values, that could be used as a common source of truth to bind header+Verilog versioning, assuming you have a version register or similar.
- URL prefix is a really interesting idea! So provide a mechanism to create links back to PeakRDL-html output. I like it.
from peakrdl-cheader.
Sounds great!
Versioning will be difficult to do generically, however if I also export defines for field reset values, that could be used as a common source of truth to bind header+Verilog versioning, assuming you have a version register or similar.
That would work, binding the header+verilog would be enough I guess. I could always use some kind of command line parameter to pass a GIT hash to a description string.
URL prefix is a really interesting idea! So provide a mechanism to create links back to PeakRDL-html output. I like it.
I haven't set it up yet, but I am planning on using a CI/CD flow for internal releases of FPGA builds prior to ASIC tapeout. There will be multiple build variants and iterations so a link back to html doco will be fantastic.
from peakrdl-cheader.
Refactored version released!
See v1.0.0
from peakrdl-cheader.
Related Issues (8)
- Installation failing HOT 1
- Peakrdl IPXACT - No module named 'peakrdl.ipxact' HOT 2
- Add support for register arrays with oversized stride
- During export, check for identifier collisions in output
- Problem with using multiple cheaders which share imported regfiles
- C header generate file doesn't have suffix HOT 6
- Wrong syntax generated for multidimensional arrays
Recommend Projects
-
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
-
Vue.js
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
-
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
-
TensorFlow
An Open Source Machine Learning Framework for Everyone
-
Django
The Web framework for perfectionists with deadlines.
-
Laravel
A PHP framework for web artisans
-
D3
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
-
Recommend Topics
-
javascript
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
-
web
Some thing interesting about web. New door for the world.
-
server
A server is a program made to process requests and deliver data to clients.
-
Machine learning
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
-
Visualization
Some thing interesting about visualization, use data art
-
Game
Some thing interesting about game, make everyone happy.
Recommend Org
-
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
-
Microsoft
Open source projects and samples from Microsoft.
-
Google
Google ❤️ Open Source for everyone.
-
Alibaba
Alibaba Open Source for everyone
-
D3
Data-Driven Documents codes.
-
Tencent
China tencent open source team.
from peakrdl-cheader.