riscv: add CSR-defining macros #219
Commits on Oct 17, 2024
-
riscv: add CSR-defining macros
Adds helper macros for defining CSR types.
-
riscv: add enum branch to CSR macro
Adds the ability to define CSR types using an enum field type.
-
fixup: fixes for rebase on latest HEAD
Adds corrections to CSR creation macros for rebase on commit `a4d69614`. Includes: - additions of `try_*` function variants for fallible functions. - changing doc string macro arguments to idiomatic `///` comments
-
fixup: riscv: do not repeat macro field arguments
Replaces repeated field bit and range arguments with a single `bit` or `range` argument. Intended to reduce copy-paste, prevent typo errors, and clarify intent.
-
riscv: add try variants to read-only CSR macros
Adds `try_*` variants for fallible getter functions on read-only CSR macros.
-
riscv: add try variants to write-only CSR macros
Adds `try_*` variants for fallible getter functions on write-only CSR macros.
-
riscv: modularize CSR macro field helpers
Modularizes the `read_only_csr_field` and `write_only_csr_field` macro helpers for re-use in `read_write_only_csr_field`.
-
riscv: add explicit mask field to CSR macros
Adds the explicit `mask:` field name to CSR helper macros to clarify intent.
-
riscv: add field label to CSR macros
Adds the `field` macro argument label to CSR helper macros to clarify intent.
-
fixup: riscv: remove field args from CSR macro
Removes field arguments from CSR definition macros.
-
fixup: riscv: remove CSR number from csr macro
Removes the unused `csr` number argument from the `csr` macro.
-
fixup: riscv: use result for CSR enum conversion
Uses the crate result type for converting a CSR enum type from a `usize`.
-
fixup: riscv: read-only CSR compile-time asserts
Applies compile-time checks in read-only CSR macros. Authored-by: rmsyn <[email protected]> Co-authored-by: romancardenas <[email protected]>
-
fixup: riscv: write-only CSR compile-time asserts
Applies compile-time checks in write-only CSR macros. Authored-by: rmsyn <[email protected]> Co-authored-by: romancardenas <[email protected]>
-
fixup: riscv: remove equality check in CSR macros
Removes the equality check for range branches in CSR helper macros. Users who want a single-bit field, i.e. `start == end`, should use the single-bit branch variants. Authored-by: rmsyn <[email protected]> Co-authored-by: romancardenas <[email protected]>
-
fixup: riscv: remove CSR macro enum creation branch
Removes CSR helper macro branches that include field enum type creation. Leaves the creation of the field enum to the separate `csr_field_enum` macro, or manual definition of the field enum. Authored-by: rmsyn <[email protected]> Co-authored-by: romancardenas <[email protected]>
-
riscv: use paste for CSR helper macros
Uses the [`paste`](https://docs.rs/paste) dependency for concatenating idents in CSR helper macros.
-
-
Re-exports the `paste` macro to allow using CSR helper macros in external crates. Authored-by: rmsyn <[email protected]> Co-authored-by: romancardenas <[email protected]>
