Science Score: 44.0%
This score indicates how likely this project is to be science-related based on various indicators:
-
✓CITATION.cff file
Found CITATION.cff file -
✓codemeta.json file
Found codemeta.json file -
✓.zenodo.json file
Found .zenodo.json file -
○DOI references
-
○Academic publication links
-
○Academic email domains
-
○Institutional organization owner
-
○JOSS paper metadata
-
○Scientific vocabulary similarity
Low similarity (4.5%) to scientific vocabulary
Keywords
Repository
Hardware Design of Ascon
Basic Info
- Host: GitHub
- Owner: rprimas
- License: cc0-1.0
- Language: Python
- Default Branch: main
- Homepage: https://ascon.isec.tugraz.at/
- Size: 2.63 MB
Statistics
- Stars: 25
- Watchers: 1
- Forks: 7
- Open Issues: 1
- Releases: 0
Topics
Metadata Files
README.md
Hardware Design of Ascon (SP 800-232)
This is a SystemVerilog implementation of Ascon as specified by NIST in SP 800-232.
Ascon is a family of authenticated encryption and hashing algorithms designed to be lightweight and easy to implement, even with added countermeasures against side-channel attacks. Ascon has been selected as new standard for lightweight cryptography in the NIST Lightweight Cryptography competition (2019–2023).
The following Ascon modes are available:
- Ascon-AEAD128
- Ascon-Hash256
- Ascon-XOF128
- Ascon-CXOF128
Available Variants
The Ascon core can be configured to support the following combinations of data-bus width and unrolled rounds of Ascon-p:
| Variant | Bus Width | Unrolling | |-------------|:-------------:|:-------------:| | v1 | 32-bit | 1 | | v2 | 32-bit | 2 | | v3 | 32-bit | 4 | | v4 | 64-bit | 1 | | v5 | 64-bit | 2 | | v6 | 64-bit | 4 |
Performance
Cycles required for processing x bytes of message and y bytes of associated data:
| Variant | Mode | ( x=0, y=0 ) | ( x=32, y=32 ) | ( x=1024, y=1024 ) |
|-------------|-----------------|:----------------:|:------------------:|:----------------------:|
| v1 | Ascon-AEAD128 | 41 | 99 | 1587 |
| v2 | Ascon-AEAD128 | 29 | 67 | 1059 |
| v3 | Ascon-AEAD128 | 23 | 51 | 795 |
| v4 | Ascon-AEAD128 | 35 | 85 | 1325 |
| v5 | Ascon-AEAD128 | 23 | 53 | 797 |
| v6 | Ascon-AEAD128 | 17 | 37 | 533 |
Cycles required for processing x bytes of message:
| Variant | Mode | ( x=0 ) | ( x=32 ) | ( x=1024 ) |
|-------------|-----------------|:-----------:|:------------:|:--------------:|
| v1 | Ascon-Hash256 | 70 | 126 | 1862 |
| v2 | Ascon-Hash256 | 40 | 72 | 1064 |
| v3 | Ascon-Hash256 | 25 | 45 | 665 |
| v4 | Ascon-Hash256 | 66 | 118 | 1730 |
| v5 | Ascon-Hash256 | 36 | 64 | 932 |
| v6 | Ascon-Hash256 | 21 | 37 | 533 |
Files
rtl/: SystemVerilog implementation of Ascon.surfer/: Files for the Surfer waveform viewer.syn/: Files for Yosys synthesis.ascon.py: Ascon's python reference implementation pyascon.CITATION.cff: Github citation information file.LICENSE: License file.Makefile: Makefile for rtl simulation, rtl synthesis, and waveform viewing.README.md: This README.test.py: Python script for running the cocotb test bench.
Interface
The following table contains a description of the interface signals:
| Name | Bits | Description |
|--------------|:--------:|--------------------------------------------------|
| clk | 1 | Clock signal. |
| rst | 1 | Reset signal. Note: Synchronous active high. |
| key | 32/64 | Key data input. |
| key_valid | 1 | Key data is valid. |
| key_ready | 1 | Ascon core is ready to receive a new key. |
| bdi | 32/64 | Block data input (BDI). |
| bdi_valid | 4/8 | Valid BDI data bytes. |
| bdi_ready | 1 | Ascon core is ready to receive data. |
| bdi_eot | 1 | Last BDI block of this type. |
| bdi_eoi | 1 | Last BDI block. |
| bdi_type | 4 | Type of BDI data. |
| mode | 4 | Ascon mode. |
| bdo | 32/64 | Block data output (BDO). |
| bdo_valid | 4/8 | Valid BDO data bytes. |
| bdo_ready | 1 | Test bench is ready to receive data. |
| bdo_type | 4 | Type of BDO data. |
| bdo_eoo | 1 | Last BDO block. |
| auth | 1 | Authentication success. |
| auth_valid | 1 | Authentication output is valid. |
RTL Simulation
- Install the Verilator open-source verilog simulator:
- Ubuntu:
apt-get install verilator- Fedora:
dnf install verilatordnf install verilator-devel- Build from source:
- Git Quick Install
- Install the cocotb open-source verilog test bench environment:
pip install cocotb
- Execute the cocotb test bench:
makeormake sim
RTL Synthesis
- Install the Yosys open-source synthesis suite (tested with version
0.53):- Ubuntu:
apt-get install yosys- Fedora:
dnf install yosys
- Execute the yosys synthesis script:
make syn
RTL Post-Synthesis Simulation
- Execute the yosys synthesis script:
make syn
- Execute the cocotb test bench for synthesized RTL:
make sim syn=1
View Waveforms
- Make sure you have a recent verilator version (>=
v5.0.38). - Uncomment all
--tracearguments in the Makefile. - Install the Surfer waveform viewer.
cargo install --git https://gitlab.com/surfer-project/surfer surfer
- View waveform of cocotb test bench run:
makeormake simmake surf
- View waveform of post-synthesis cocotb test bench run:
make synmake sim syn=1make surf syn=1
- Example waveform of test bench output:
Integration
- The Ascon core uses an interface that allows easy integration into projects using, e.g., an AXI4 bus.
- The Ascon core can handle stalls of the input/output data bus. This can be tested by setting
STALLS = 1intest.py. - Many ciphers, including Ascon, require that decrypted plaintext is not released to a potential attacker until the tag of the ciphertext was successfully verified. The current design of the Ascon core outputs decrypted plaintext immediately which could lead to security degradation. For real applications an additional buffer should be used to temporarily store decrypted plaintext until the Ascon core has successfully verified the ciphertext tag.
Contact
- Robert Primas (rprimas 'at' proton.me, https://rprimas.github.io)
Acknowledgements
The interface of the Ascon core is inspired by the LWC Hardware API Development Package that was mainly developed by the Cryptographic Engineering Research Group at George Mason University (GMU).
Owner
- Name: Robert Primas
- Login: rprimas
- Kind: user
- Website: https://rprimas.github.io/
- Repositories: 1
- Profile: https://github.com/rprimas
I am a postdoctoral researcher at Graz University of Technology. My research interests include designing and attacking cryptographic implementations.
Citation (CITATION.cff)
# See https://citation-file-format.github.io/
cff-version: 1.2.0
title: ascon-verilog
message: 'If you use this software, please cite it as below.'
type: software
authors:
- given-names: Robert
family-names: Primas
orcid: 'https://orcid.org/0000-0002-9569-8477'
repository-code: 'https://github.com/rprimas/ascon-verilog'
license: CC0-1.0
GitHub Events
Total
- Issues event: 3
- Watch event: 6
- Issue comment event: 3
- Push event: 48
- Fork event: 3
Last Year
- Issues event: 3
- Watch event: 6
- Issue comment event: 3
- Push event: 48
- Fork event: 3
Issues and Pull Requests
Last synced: 6 months ago
All Time
- Total issues: 2
- Total pull requests: 0
- Average time to close issues: 6 days
- Average time to close pull requests: N/A
- Total issue authors: 2
- Total pull request authors: 0
- Average comments per issue: 0.5
- Average comments per pull request: 0
- Merged pull requests: 0
- Bot issues: 0
- Bot pull requests: 0
Past Year
- Issues: 2
- Pull requests: 0
- Average time to close issues: 6 days
- Average time to close pull requests: N/A
- Issue authors: 2
- Pull request authors: 0
- Average comments per issue: 0.5
- Average comments per pull request: 0
- Merged pull requests: 0
- Bot issues: 0
- Bot pull requests: 0
Top Authors
Issue Authors
- meyanik (1)
- SZBihan (1)
- Manprocoder (1)