https://github.com/mit-plv/hemiola

A Coq framework to support structural design and proof of hardware cache-coherence protocols
https://github.com/mit-plv/hemiola

cache-coherence coq domain-specific-language hardware-verification proof-assistant

Last synced: 3 months ago
JSON representation

A Coq framework to support structural design and proof of hardware cache-coherence protocols

• Host: GitHub
• URL: https://github.com/mit-plv/hemiola
• Owner: mit-plv
• License: mit
• Created: 2021-01-23T17:39:51.000Z (about 4 years ago)
• Default Branch: master
• Last Pushed: 2022-05-07T04:43:04.000Z (almost 3 years ago)
• Last Synced: 2023-02-26T03:56:11.818Z (almost 2 years ago)
• Topics: cache-coherence, coq, domain-specific-language, hardware-verification, proof-assistant
• Language: Coq
• Homepage:
• Size: 4.94 MB
• Stars: 5
• Watchers: 9
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
Hemiola: A Framework for Structural Design and Proof of Cache-Coherence Protocols

=================================================================================

Requirements

------------

### Basic

- Coq 8.14.1 (https://coq.inria.fr/download) to machine-check all the proofs

### Optional

- Kami (https://github.com/mit-plv/kami/tree/master) to compile Hemiola protocols

- OCaml 4.0.4 and Batteries Library for OCaml (2.5.2) to use the Kami-to-Bluespec transliterator

- Bluespec compiler (https://github.com/B-Lang-org/bsc) to simulate or synthesize Bluespec code

- To synthesize Bluespec code on FPGAs

  + Connectal library (http://www.connectal.org/)

  + Vivado 2015.4

  + Xilinx Virtex-7 VC707 Evaluation Kit FPGA

Makefiles

---------

- To machine-check the Coq proofs in Hemiola

  + Check all the framework code: `make -j4` in `./src`

  + Only the library code: `make lib` in `./src`

- To compile Hemiola case-study: `make` in `./syn`

  + The default source protocol is the 3-level noninclusive MESI protocol.

  + It will generate `./syn/CC.bsv`.

  + All the case-study protocols are precompiled in `./syn/integration`:

    * `./syn/integration/CC_L1LL4`: the 2-level noninclusive MESI protocol

    * `./syn/integration/CC_L1L2LL`: the 3-level noninclusive MESI protocol

- To simulate a compiled protocol: `make` in `./syn/integration/sim`

- To synthesize a compiled protocol: `make -j4 build.vc707g2` in `./syn/integration/syn`