GitPlanet

Cheap and reliable Node.js hosting starts at $3/month, and $1/month static HTML hosting

Created with love in Canada, visit hostnodejs.com today

Feel like to post an Ad? Learn Details
All Projects → pulp-platform → hero-sdk

pulp-platform / hero-sdk

Licence: Apache-2.0 License
⛔ DEPRECATED ⛔ HERO Software Development Kit

Programming Languages

shell
77523 projects

Labels

openmpparallel-computingembedded-systemsriscvarmv7heterogeneous-parallel-programmingfpga-soc-linuxpulprisc-vopen-source-hardwareheterogeneous-systemsriscv32

Projects that are alternatives of or similar to hero-sdk

riscv em
Simple risc-v emulator, able to run linux, written in C.
Stars: ✭ 51 (+142.86%)
Mutual labels:  embedded-systems, riscv, risc-v, riscv32
gardenia
GARDENIA: Graph Analytics Repository for Designing Efficient Next-generation Accelerators
Stars: ✭ 22 (+4.76%)
Mutual labels:  openmp, parallel-computing, heterogeneous-parallel-programming
rv32emu
RISC-V RV32I[MAC] emulator with ELF support
Stars: ✭ 61 (+190.48%)
Mutual labels:  riscv, risc-v, riscv32
Zelda.RISCV.Emulator
A System Level RISCV32 Emulator Over x86_64: capable of booting RISCV Linux
Stars: ✭ 18 (-14.29%)
Mutual labels:  riscv, risc-v, riscv32
Maxine Vm
Maxine VM: A meta-circular research VM
Stars: ✭ 274 (+1204.76%)
Mutual labels:  riscv, armv7, risc-v
yarvi
Yet Another RISC-V Implementation
Stars: ✭ 59 (+180.95%)
Mutual labels:  riscv, risc-v, riscv32
nuclei-sdk
Nuclei RISC-V Software Development Kit
Stars: ✭ 65 (+209.52%)
Mutual labels:  embedded-systems, riscv, risc-v
Shecc
A self-hosting and educational C compiler
Stars: ✭ 286 (+1261.9%)
Mutual labels:  riscv, armv7, risc-v
arv
ARV: Asynchronous RISC-V Go High-level Functional Model
Stars: ✭ 18 (-14.29%)
Mutual labels:  riscv, risc-v, riscv32
riscv-meta
RISC-V Instruction Set Metadata
Stars: ✭ 33 (+57.14%)
Mutual labels:  riscv, risc-v
platform-shakti
Shakti: development platform for PlatformIO
Stars: ✭ 26 (+23.81%)
Mutual labels:  riscv, risc-v
r3
R3-OS — Experimental static (μITRON-esque) RTOS for deeply embedded systems, testing the limit of Rust's const eval and generics
Stars: ✭ 87 (+314.29%)
Mutual labels:  embedded-systems, risc-v
Foundations of HPC 2021
This repository collects the materials from the course "Foundations of HPC", 2021, at the Data Science and Scientific Computing Department, University of Trieste
Stars: ✭ 22 (+4.76%)
Mutual labels:  openmp, parallel-computing
ravel
A RISC-V simulator
Stars: ✭ 24 (+14.29%)
Mutual labels:  riscv, risc-v
Ctranslate2
Fast inference engine for OpenNMT models
Stars: ✭ 140 (+566.67%)
Mutual labels:  openmp, parallel-computing
yatcpu
Yet another toy CPU.
Stars: ✭ 42 (+100%)
Mutual labels:  riscv, risc-v
sedna
Sedna - a pure Java RISC-V emulator.
Stars: ✭ 52 (+147.62%)
Mutual labels:  riscv, risc-v
pulp soc
pulp_soc is the core building component of PULP based SoCs
Stars: ✭ 43 (+104.76%)
Mutual labels:  riscv, pulp
matrix multiplication
Parallel Matrix Multiplication Using OpenMP, Phtreads, and MPI
Stars: ✭ 41 (+95.24%)
Mutual labels:  openmp, parallel-computing
Arraymancer
A fast, ergonomic and portable tensor library in Nim with a deep learning focus for CPU, GPU and embedded devices via OpenMP, Cuda and OpenCL backends
Stars: ✭ 793 (+3676.19%)
Mutual labels:  openmp, parallel-computing
View All Similar Projects ➔

DEPRECATED

This repository is part of a deprecated version of HERO. Please refer to the current HERO repository for the current heterogeneous SDK.

HERO Software Development Kit

HERO [1], the open Heterogeneous Research Platform, combines a PULP-based [2] open-source parallel manycore accelerator implemented on FPGA with a hard ARM Cortex-A multicore host processor running full-stack Linux. HERO is the first heterogeneous system architecture that combines a powerful ARM multicore host with a highly parallel and scalable manycore accelerator based on a RISC-V cores. HERO offers a complete hardware and software platform which advances the state of the art of transparent accelerator programming using the OpenMP v4.5 Accelerator Model. The programmer can write a single application source file for the host and use OpenMP directives for parallelization and accelerator offloading. Lower-level details such as differing ISAs as well as shared virtual memory (SVM) [3] between host and accelerator are handled by our heterogeneous toolchain based on GCC 7 [4], runtime libraries, kernel driver and our open-source hardware IPs.

Contents

The HERO software development kit (SDK) contains the following submodules:

  • hero-gcc-toolchain: heterogeneous toolchain based on GCC 7 with RISC-V offloading support through OpenMP 4.5.
  • hero-support: accelerator kernel driver and user-space runtime library, host Linux system based on Buildroot.
  • hero-openmp-examples: HERO application examples using the OpenMP Accelerator Model.
  • libhero-target: HERO hardware-specific APIs accessible through OpenMP.
  • pulp-sdk: accelerator SDK (more info here)

Getting Started

Prerequisites

Hardware

The HERO SDK currently supports the Xilinx Zynq ZC706 Evaluation Kit as target hardware platform.

Software

First, make sure your shell environment does not deviate from the system defaults regarding paths (PATH, LD_LIBRARY_PATH, etc) before setting up the SDK or sourcing the environment of the HERO SDK.

Ubuntu 16.04

Starting from a fresh Ubuntu 16.04 distribution, here are the commands to be executed to get all required dependencies:

sudo apt install build-essential bison flex git python3-pip gawk texinfo libgmp-dev libmpfr-dev libmpc-dev swig3.0 libjpeg-dev lsb-core doxygen python-sphinx sox graphicsmagick-libmagick-dev-compat libsdl2-dev libswitch-perl libftdi1-dev cmake u-boot-tools fakeroot
sudo pip3 install artifactory twisted prettytable sqlalchemy pyelftools openpyxl xlsxwriter pyyaml numpy

CentOS 7 (Experimental)

Starting from a fresh CentOS 7 distribution, here are the commands to be executed to get all required dependencies:

sudo yum install git python34-pip python34-devel gawk texinfo gmp-devel mpfr-devel libmpc-devel swig libjpeg-turbo-devel redhat-lsb-core doxygen python-sphinx sox GraphicsMagick-devel ImageMagick-devel SDL2-devel perl-Switch libftdi-devel cmake uboot-utils fakeroot
sudo pip3 install artifactory twisted prettytable sqlalchemy pyelftools openpyxl xlsxwriter pyyaml numpy

Get the HERO SDK sources

The HERO SDK uses GIT submodules. Thus, you have to clone it recursively:

git clone --recursive [email protected]:pulp-platform/hero-sdk.git

or if you use HTTPS

git clone --recursive https://github.com/pulp-platform/hero-sdk.git

Build the HERO SDK from the sources

The build is automatically managed by various scripts. The main build script is hero-z-7045-builder. You can build everything by launching the following command:

./hero-z-7045-builder -A

The first build takes at least 1 hour (depending on your internet connection). The whole HERO SDK requires roughly 25 GiB of disk space. If you want to build a single module only, you can do so by triggering the corresponding build step separately. Execute

./hero-z-7045-builder -h

to list the available build commands. Note that some modules have dependencies and require to be built in order. The above command displays the various modules in the correct build order.

Setup of the HERO platform

Once you have built the host Linux system, you can set up operation of the HERO platform.

Format SD card (HERO boot medium)

To properly format your SD card, insert it to your computer and type dmesg to find out the device number of the SD card. In the following, it is referred to as /dev/sdX.

NOTE: Executing the following commands on a wrong device number will corrupt the data on your workstation. You need root privileges to format the SD card.

First of all, type

sudo dd if=/dev/zero of=/dev/sdX bs=1024 count=1

to erase the partition table of the SD card.

Next, start fdisk using

sudo fdisk /dev/sdX

and then type n followed by p and 1 to create a new primary partition. Type 1 followed by 1G to define the first and last cylinder, respectively. Then, type n followed by p and 2 to create a second primary partition. Select the first and last cylinder of this partition to use the rest of the SD card. Type p to list the newly created partitions and to get their device nodes, e.g., /dev/sdX1. To write the partition table to the SD card and exit fdisk, type w.

Next, execute

sudo mkfs -t vfat -n ZYNQ_BOOT /dev/sdX1

to create a new FAT filesystem for the boot partition, and

sudo mkfs -t ext2 -L STORAGE /dev/sdX2

to create an ext2 filesystem for storage. (Do not use FAT for storage because it does not support symlinks, which are needed to correctly install libraries.)

Load boot images to SD card

To install the generated images, copy the contents of the directory

linux-workspace/sd_image

to the first partition of the prepared SD card. You can do so by changing to this directory and executing the provided script

cd linux-workspace/sd_image
./copy_to_sd_card.sh

NOTE: By default, this script expects the SD card partition to be mounted at /run/media/${USER}/ZYNQ_BOOT but you can specify a custom SD card mount point by setting up the env variable SD_BOOT_PARTITION.

Insert the SD card into the board and make sure the board boots from the SD card. To this end, the boot mode switch of the Zynq must be set to 00110. Connect the board to your network. Boot the board.

Install HERO SDK support files

Once you have set up the board you can define the following environmental variables (e.g. in scripts/hero-z-7045-env.sh)

export HERO_TARGET_HOST=<user_id>@<hero-target-ip>
export HERO_TARGET_PATH=<installation_dir>

to enable the HERO builder to install the driver, support applications and libraries using a network connection. Then, execute

./hero-z-7045-builder -i

to install the files on the board.

By default, the root filesystem comes with pre-generated SSH keys in /etc/ssh/ssh_host*. The default root password is

hero

and is set at startup by the script /etc/init.d/S45password.

NOTE: We absolutely recommend to modify the root filesystem to set a custom root password and include your own SSH keys. How this can be done is explained on our HOWTO webpage. We are not responsible for any vulnerabilities and harm resulting from using the provided unsafe password and SSH keys.

Execute OpenMP Examples

Environmental Setup

The HERO SDK contains also some OpenMP 4.5 example applications. Before running an example application, you must have built the HERO SDK, set up the HERO platform and installed the driver, support applications and libraries.

Setup the build environment by executing

source scripts/hero-z-7045-env.sh

Connect to the board and load the PULP driver:

cd ${HERO_TARGET_PATH_DRIVER}
insmod pulp.ko

To print any UART output generated by PULP, connect to the HERO target board via SSH and start the PULP UART reader:

cd ${HERO_TARGET_PATH_APPS}
./uart

Application Execution

To compile and execute an application, navigate to the application folder and execute make:

cd hero-openmp-examples/helloworld
make clean all run

Alternatively, you can also directly connect to the board via SSH, and execute the binary on the board once it has been built:

cd ${HERO_TARGET_PATH_APPS}
export LD_LIBRARY_PATH=${HERO_TARGET_PATH_LIB}
./helloworld

Additional information

For additional information on how to build the host Linux system, customize the Buildroot root filesystem (e.g. installing your SSH keys) etc. visit the corresponding HOWTO webpage.

Issues and troubleshooting

If you find problems or issues during the build process, you can take a look at the troubleshooting page or you can directly open an issue in case your problem is not a common one.

References

  1. Kurth, Andreas, et al. "HERO: Heterogeneous Embedded Research Platform for Exploring RISC-V Manycore Accelerators on FPGA." arXiv preprint arXiv:1712.06497 (2017)
  2. Rossi, Davide, et al. "PULP: A parallel ultra low power platform for next generation IoT applications." Hot Chips 27 Symposium (HCS), 2015 IEEE. IEEE, 2015
  3. Vogel, Pirmin, Andrea Marongiu, and Luca Benini. "Lightweight virtual memory support for zero-copy sharing of pointer-rich data structures in heterogeneous embedded SoCs." IEEE Transactions on Parallel and Distributed Systems 28.7 (2017): 1947-1959. IEEE, (2017)
  4. Capotondi, Alessandro, and Andrea Marongiu. "Enabling zero-copy OpenMP offloading on the PULP many-core accelerator." Proceedings of the 20th International Workshop on Software and Compilers for Embedded Systems. ACM, 2017.
Note that the project description data, including the texts, logos, images, and/or trademarks, for each open source project belongs to its rightful owner. If you wish to add or remove any projects, please contact us at [email protected].