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