https://github.com/pulp-platform/axi_riscv_atomics

AXI Adapter(s) for RISC-V Atomic Operations
https://github.com/pulp-platform/axi_riscv_atomics

Last synced: about 2 months ago
JSON representation

AXI Adapter(s) for RISC-V Atomic Operations

• Host: GitHub
• URL: https://github.com/pulp-platform/axi_riscv_atomics
• Owner: pulp-platform
• License: other
• Created: 2019-02-18T17:49:13.000Z (over 5 years ago)
• Default Branch: master
• Last Pushed: 2024-07-26T13:47:51.000Z (about 2 months ago)
• Last Synced: 2024-07-26T14:35:34.881Z (about 2 months ago)
• Language: SystemVerilog
• Size: 365 KB
• Stars: 58
• Watchers: 9
• Forks: 15
• Open Issues: 4
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# AXI Adapter(s) for RISC-V Atomic Operations

**Disclaimer**: This repository is under active development and not yet stabilized.  Use only if you

know what you are doing and are prepared to adapt to wide-reaching changes as the project evolves.

Limited support is available for the latest v0.x version, but only for the latest, and we give no

backwards compatibility guarantees for versions before v1.0.

The modules in this repository implement atomic operations (AMOs) for RISC-V processors ("A"

extension version 2.0) on the AXI protocol.  The modules adheres to the RISC-V Weak Memory Ordering

(RVWMO) memory consistency model (version 0.1).

## Usage

Place one of the following modules in your memory hierarchy between an AXI master and slave, where

the slave owns a particular memory location (e.g., exclusive access to a memory controller or

adherence to a cache coherency protocol).  Choose depending on your needs:

- `axi_riscv_lrsc` tracks memory reservations for LR/SC, forwards only successful SCs, and responds

  accordingly.  This is sufficient to support LR/SC if the processor encodes them as AXI exclusive

  memory accesses.  Downstream modules do not have to support AXI exclusive memory accesses.

- `axi_riscv_atomics` implements all RISC-V AMOs in addition to LR/SC.  The processor needs to

  encode RISC-V AMOs as AXI atomic transactions (`AtomicSwap` for `AMOSWAP`, `AtomicLoad` with the

  corresponding opcode for all other AMOs).   This is sufficient to support the entire RISC-V "A"

  extension.  Downstream modules do not have to support AXI atomic transactions or exclusive

  memory accesses.

For each of those modules we additionally provide a wrapper (`_wrap` filename suffix) that exposes

SystemVerilog interfaces instead of `logic` ports.