README.md
AXIOM D5.1 Software release
===============================================================================

This archive contains software and documentations relative to D5.1 deliverable.
It is organized with the following directories:

* docs
This directory contains the documentation of AXIOM BSP and AXIOM
Software-Stack and it is organized with the following sub-folders:

* BSP
This folder contains the documentation of AXIOM Board and BSP:
* WP6 - ARCHITECTURE IMPLEMENTATION_AXIOM board - AXIOM Wiki.html
This page describes the AXIOM board. It is based on the Zynq®
UltraScale+™ MPSoC XCZU9EG-1FFC900.

* WP6 - ARCHITECTURE IMPLEMENTATION_BSP_ComponentsAndSources - AXIOM Wiki.html
This page describes the tools and the components of the AXIOM BSP.

* WP6 - ARCHITECTURE IMPLEMENTATION_BSP_FirstBoot - AXIOM Wiki.html
This page describes how to use and create bootable SD with
pre-compiled images and FileStystem.

* WP6 - ARCHITECTURE IMPLEMENTATION_BSP_KERNEL_PowerMonitor - AXIOM Wiki.html
This page explains how to monitor the power consumption using SYSFS
and IOCTL interfaces.

* WP6 - ARCHITECTURE IMPLEMENTATION_BSP_PetalinuxTool - AXIOM Wiki.html
This page provides the desctiption of a sub-set of the PetaLinux's
commands, useful to generate the AXIOM BSP.

* WP6 - ARCHITECTURE IMPLEMENTATION_BSP_PMT - AXIOM_WIKI.html
This page describes how to use a simple set of bash scripts to acquire
data about power consumption.

* WP6 - ARCHITECTURE IMPLEMENTATION_BSP_XGenImage - AXIOM Wiki.html
This page describes the xgenimage tool. It is a tool to generate OS
image for the AXIOM Board.

* SoftwareStack
This folder contains the documentation of AXIOM Software Stack:
* WP5 - AXIOM Software Stack - AXIOM Wiki.html
This page contains instruction on how to get, install, and run the
AXIOM NIC drivers and user-space applications developed for the
AXIOM board.
We added the following files that are linked in the wiki page above:
* axiom-evi_README-v1.0.txt
How to compile the AXIOM Software Stack and generate DEBs package
for the AXIOM board.
* axiom-evi-apps_README-v1.0.txt
How to run AXIOM applications and utilities
* axiom_nic_datasheet-v1.0.pdf
Datasheet of the real AXIOM NIC peripheral on the FPGA
* axiom-v1.0-doxygen-html.tgz
Doxygen documentation HTML of the AXIOM Software Stack
* axiom-evi-apps_tests_README-v1.0.txt
How to run the AXIOM regression tests
* axiom-evi_tests_gasnet_README-v1.0.txt
How to run the GASNet regression tests
* axiom-evi_tests_ompss_README-v1.0.txt
How to run the OmpSS regression tests

* software
This directory contains the source code developed and it is organized with
the following sub-folders:

* BSP
This directory contains the Petalinux 2016.3 project. It is the main
component of the Xilinx processing systems and it includes both hardware
and software setting for the AXIOM board.
* AXIOM-ZU9EG-2016.3_7948670.tar.gz

* BSP_Component
This directory contains the source code of Linux and U-Boot. The Linux
kernel 4.6.0 and U-Boot 2016.07 are based on Xilinx kernel and customized
for the AXIOM board.
* linux-4.6.0-AXIOM-v2016.3_aa575e7.tar.gz
* u-boot-2016.07-AXIOM-v2016.3_16eb184.tar.gz

* FileSystem
This directory contains File System with Ubuntu 16.04.
The 'minimal' version contains only tools needed for the basic board usage.
The 'desktop' version is built on the minimal version, adding Mate Desktop
environment and the video graphical acceleration driver.
* zynq-ubuntu-desktop_16.04-xenial_v1.3.tar.gz
* zynq-ubuntu-minimal_16.04-xenial_v1.3.tar.gz

* SoftwareStack
This directory contains the archives of the source and DEBs of AXIOM Software
Stack v1.0. It includes AXIOM drivers (NIC and MemoryDevice), AXIOM UserSpace
libraries, AXIOM application, GASNet with AXIOM Conduit, Nanos and
Mercurium with AXIOM support and several regression tests.
* axiom-evi-software_stack_src_v1.0.tar.gz
* axiom-evi-debs-v1.0.7z

* Tools
This directory contains the tool used to create a Ubuntu 16.04 based
FileSystem. As output of the execution of the tool there is a FileSystem
like the pre-build desktop one.
* xgenimage_6c40bc3.tar.gz