Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ingonyama-zk/ingo-hash
FPGA accelerated cryptographic hash functions
https://github.com/ingonyama-zk/ingo-hash
acceleration cryptography hardware hashing
Last synced: 2 days ago
JSON representation
FPGA accelerated cryptographic hash functions
- Host: GitHub
- URL: https://github.com/ingonyama-zk/ingo-hash
- Owner: ingonyama-zk
- License: apache-2.0
- Created: 2023-11-27T11:40:59.000Z (12 months ago)
- Default Branch: main
- Last Pushed: 2024-05-16T23:22:56.000Z (6 months ago)
- Last Synced: 2024-05-17T17:00:43.124Z (6 months ago)
- Topics: acceleration, cryptography, hardware, hashing
- Language: C++
- Homepage:
- Size: 43 KB
- Stars: 7
- Watchers: 4
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# ingo-hash
This repo contains various FPGA accelerated hash functions.
A demo kernel is included with each hash function that conforms to the following API:
```c++
// hashes a batch_size of messages, each of the same msg_size
void hash(char *msg_buffer, char *hash_buffer, int msg_size, int batch_size);
```
The demo application demonstrates correctness, however it is intended for the user
to integrate the internal building blocks in their own FPGA-based design
(e.g. instantiate multiple cores).
Currently only the Groestl_256 hash function is avaliable. More hash functions coming soon!
## Demo Application Stats
Note that the demo applications are bottlenecked by PCIe or memory bandwidth.
Power is measured as total card power.
| | LUTs | Freq (MHz) | Throughput (GiB/s) | Power (W) |
|-------------|---------|------------|--------------------|-----------|
| groestl_256 | 122K | 300 | 12.8189 | 31 |
| sha3_256 | | | | |
| blake2s | | | | |
## Hash Core Stats
Frequency achievable when instantiating the cores without data movers.
Power is measured just for the hash core.
| | LUTs | Freq (MHz) | Throughput (GiB/s) | Power (W) |
|-------------|------|------------|--------------------|-----------|
| groestl_256 | 115K | 750 | 44.7 | 12 |
| sha3_256 | | | | |
| blake2s | | | | |
## Total Board Throughput
Achievable throughput when instantiating as many cores as possible, ignoring
memory bandwidth. On cards with HBM, this throughput is realistically achievable.
| | U200 | U250 | U280 | U50 | U55C |
|-------------|-------------|-----------|-------------|-------------|-------------|
| groestl_256 | 312.9 GiB/s | 447 GiB/s | 357.6 GiB/s | 223.5 GiB/s | 357.6 GiB/s |
| sha3_256 | | | | | |
| blake2s | | | | | |
## Running the Demo
The demo is targets any AMD Alveo card, any of the following will work:
```
AMD U200
AMD U250
AMD U280
AMD U50
AMD U55C
```
### Install Deployment Prerequisites
Download and install the Xilinx Runtime (XRT) and the deployment target platform for your respective
device:
(NOTE: Tool version >= 2023.1 required)
https://www.xilinx.com/support/download/index.html/content/xilinx/en/downloadNav/alveo.html
For example, assuming you have an U250 on Ubuntu 22.04, install the packages using apt:
```bash
# Download files
wget https://www.xilinx.com/bin/public/openDownload?filename=xrt_202310.2.15.225_22.04-amd64-xrt.deb
wget https://www.xilinx.com/bin/public/openDownload?filename=xilinx-u250-gen3x16-xdma_2023.1_2023_0507_2220-all.deb.tar.gz
# Extract tar
tar -xvf ./xilinx-u250-gen3x16-xdma_2023.1_2023_0507_2220-all.deb.tar.gz
# Install all deb files
sudo apt install ./xrt_202310.2.15.225_22.04-amd64-xrt.deb
cd xilinx-u250-gen3x16-xdma_2023.1_2023_0507_2220-all
sudo apt install ./*.deb
```
If this is your first time using XRT with your card please follow the instructions to update your card from the user guide:
https://docs.xilinx.com/r/en-US/ug1301-getting-started-guide-alveo-accelerator-cards
### Compile and run the host application
```bash
git clone https://github.com/ingonyama-zk/ingo-hash.git
source /opt/xilinx/xrt/setup.sh
cd ingo-hash
cd host
make test
```
## Compiling the xclbin
In addition to the deployment platform you need the development platform for your respective card, and
install the latest Vitis 2023.2 tools.
After installing the tools, we can finally compile:
```bash
git clone https://github.com/ingonyama-zk/ingo-hash.git
source /tools/Xilinx/Vitis/2023.2/settings64.sh
source /opt/xilinx/xrt/setup.sh
cd ingo-hash
make pl/groestl/work/kernel_m_axi_groestl_256.xo
make work/xilinx_u250_gen3x16_xdma_4_1_202210_1/m_axi_groestl_256/hw/m_axi_groestl_256.xclbin
```