Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/lowrisc/synfi
OpenTitan FI formal verification framework
https://github.com/lowrisc/synfi
Last synced: 1 day ago
JSON representation
OpenTitan FI formal verification framework
- Host: GitHub
- URL: https://github.com/lowrisc/synfi
- Owner: lowRISC
- License: apache-2.0
- Created: 2021-10-06T15:59:04.000Z (about 3 years ago)
- Default Branch: master
- Last Pushed: 2023-08-29T08:58:47.000Z (about 1 year ago)
- Last Synced: 2024-03-19T20:10:47.086Z (8 months ago)
- Language: Python
- Size: 433 KB
- Stars: 7
- Watchers: 22
- Forks: 5
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# SYNFI: FI Formal Verification Framework
## Introduction
This framework is capable of analyzing the effects of faults induced into
synthesized gate-level netlists. The tool automatically extracts the circuit to
analyze based on a fault specification file and injects multiple faults with
different effects into this subcircuit. The effectiveness of the injected faults
are evaluated and the tool verifies that the installed fault countermeasures
detect these faults.
The framework is broken into three phases:
1. a preprocessing phase,
2. a fault injection phase, and
3. an evaluation phase.
Further details can be found in the paper \[[0](#Publication)\].
## Usage
Install python3 and the corresponding packages:
```console
$ pip3 install -r requirements.txt
```
The `examples/circuit.json` file contains the netlist for the
[aes_cipher_control](https://github.com/lowRISC/opentitan/blob/master/hw/ip/aes/rtl/aes_cipher_control.sv)
module synthesized with the
[provided](https://github.com/lowRISC/opentitan/tree/master/hw/ip/aes/pre_syn)
Yosys flow.
To convert a cell library (e.g., the
[NANGATE45](https://github.com/The-OpenROAD-Project/OpenROAD-flow-scripts/tree/master/flow/platforms/nangate45/lib) library),
adapt the `examples/config.json` file and start the cell library generator:
```console
$ ./cell_lib_generator.py -l NangateOpenCellLibrary_typical.lib -n 16 \
-c examples/config.json -o cell_lib_nangate45_autogen.py
```
To start the preprocessing phase for this example netlist, create
the `output` directory and invoke the parser:
```console
$ ./parse.py -j examples/circuit.json -m aes_cipher_control \
-o output/circuit.pickle
```
The parser preprocesses the provided netlist and creates a directed graph, which
is then used by the fault injector to evaluate the effects of the induced
faults. To run the fault injector with the example netlist and the example fault
specification file, execute the fi_injector tool:
```console
$ ./fi_injector.py -p output/circuit.pickle -f examples/fault_model.json -n 16 \
-c cell_lib_nangate45_autogen.py
```
## Publication
[0]: Nasahl, P., Osorio, M., Vogel, P., Schaffner, M., Trippel, T., Rizzo, D. and
Mangard, S., 2022. [SYNFI: Pre-Silicon Fault Analysis of an Open-Source Secure Element](https://arxiv.org/pdf/2205.04775).
IACR Transactions on Cryptographic Hardware and Embedded Systems.
## Licensing
Unless otherwise noted, everything in this repository is covered by the Apache
License, Version 2.0 (see [LICENSE](./LICENSE) for full text).