Project

General

Profile

Building the FPGA Image

1. Prerequisites 2. Building the FPGA Image 3. Building the Bootloader 4. Building the Filesystem 5. Building the SD Card


Introduction

The reference project to the MitySOM-A10S Development Kit utilizes GNU make for building the FPGA from the command line. Please note that the project can be built using the normal flow of Quartus/Platform Designer if that is desired.

These instructions have been tested with Quartus Pro 18.1
Tested host machine: Ubuntu 18.04

Repository

Description Repository Branch
Quartus Reference Project git://git.criticallink.com/home/git/mitysom-a10s.git 18.1pro-stable

Reference Projects

Path Description
mitysom-a10s-devkit-goldenref MitySOM-A10S Golden Reference Design

Development Kit Pre-built Outputs

Description Link
270 KLE FPGA Images https://support.criticallink.com/redmine/attachments/download/26780/a10s-p8-fpga-20200929.zip
480 KLE FPGA Images https://support.criticallink.com/redmine/attachments/download/26783/a10s-p9-fpga-20200929.zip

Quick steps to Build

  1. Open a terminal
  2. Enter the following command that will allow you to use the quartus tools from the command line:
    /opt/intelFPGA_pro/18.1/embedded/embedded_command_shell.sh
  3. Change into the directory where project was cloned into (Example: /home/user/mitysom-a10s)
    cd /home/user/mitysom-a10s/mitysom-a10s-devkit-goldenref
  4. Run the following command that will do the following:
    1. Generate the qsys
    2. Compile the FPGA
    3. Convert the SOF to an RBF
      make rbf

Updating Reference Project to Build for the 480 KLE

The reference project can either build for the 270 KLE SOM or the 480 KLE SOM. To do this the QUARTUS_DEVICE variable in the Makefile will need to match the SOM to build for. After changing the QUARTUS_DEVICE the Quartus project files will need to be recreated from the TCL scripts that are in the project directory.

Warning: Changing the device with the Makefile will lose any changes done to the reference project!

Support SOMs:
SOM Model Number FPGA Device
A10S-P8-A5E-RI-SB 10AS027E3F29I2SG
A10S-P8-X5E-RC-SA 10AS027E3F29I2SG
A10S-P8-X5E-RI-SA 10AS027E3F29I2SG
A10S-P9-A5E-RI-SB 10AS048E3F29I2SG
A10S-P9-A5E-RC-SB 10AS048E3F29I2SG
A10S-P9-X5E-RC-SA 10AS048E3F29I2SG
A10S-P9-X5E-RI-SA 10AS048E3F29I2SG

To change to the build for the 480 KLE SOM:

  1. Open a terminal
  2. Enter the following command that will allow you to use the quartus tools from the command line:
    /opt/intelFPGA_pro/18.1/embedded/embedded_command_shell.sh
  3. Open the Makefile in a text editor
    gedit Makefile
  4. Comment out QUARTUS_DEVICE := 10AS027E3F29I2SG and uncomment QUARTUS_DEVICE := 10AS048E3F29I2SG
    - QUARTUS_DEVICE := 10AS027E3F29I2SG
    + #QUARTUS_DEVICE := 10AS027E3F29I2SG
    - #QUARTUS_DEVICE := 10AS048E3F29I2SG
    + QUARTUS_DEVICE := 10AS048E3F29I2SG
    
  5. Save and close the text editor
  6. Back in the terminal regenerate the project files: Warning: All changes will be lost in the Quartus Project/QSYS
    make generate_from_tcl
  7. Build the project like normal:
    make rbf

Updating the Pinout

The pin constraints for the project are generated from the edge_connector_pinout.xlsm(Excel) or edge_connector_pinout.ods(LibreOffice) spreadsheet. This spreadsheet has macros built in that will generate tcl pin constraint files that the qsf includes.

There are 6 sheets inside the spreadsheet document: SOM J4, SOM J600, Gen 1 Dev Kit FMC, Gen 2 Dev Kit FMC, SOM Only, and IO Standards. The idea is that the user will fill in the Baseboard Net and IO Standard for pins that are used on their baseboard. Once that is filled in, click the Generate Pinout button on each page. This will create the tcl script with the appropriate pin location selected.

Sheet Description
SOM J4 Large Samtec board to board connector on the SOM
SOM J600 Transceiver board to board connector on the SOM
Gen 1 Dev Kit FMC 1st Generation Dev kit FMC pinout, for FMC pinout use this sheet instead of J (80-0001201)
Gen 2 Dev Kit FMC 2nd Generation Dev kit FMC pinout, for FMC pinout use this sheet instead of J (80-0001218)
SOM Only Connections that don't leave the SOM (ie DDR)
IO Standards List of IO Standards that can be used

Opening Platform Designer and Quartus

The Makefile can also be used open Quartus or Platform designer.

Opening Quartus:

  1. Open a terminal
  2. Enter the following command that will allow you to use the quartus tools from the command line:
    /opt/intelFPGA_pro/18.1/embedded/embedded_command_shell.sh
  3. Open the current project with Quartus with the Makefile
     make quartus_edit

Opening Platform Designer:

  1. Open a terminal
  2. Enter the following command that will allow you to use the quartus tools from the command line:
    /opt/intelFPGA_pro/18.1/embedded/embedded_command_shell.sh
  3. Open the current project's top level qsys with Platform Designer with the Makefile
     make qsys_edit

Further Reading


1. Prerequisites 2. Building the FPGA Image 3. Building the Bootloader 4. Building the Filesystem 5. Building the SD Card

Go to top
Add picture from clipboard (Maximum size: 600 MB)