f4pga-examples/.github/scripts/build-examples.sh

#!/bin/bash
#
# Copyright (C) 2020  The SymbiFlow Authors.
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
#     https://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
#
# SPDX-License-Identifier: Apache-2.0

set -e

CURRENT_DIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" >/dev/null 2>&1 && pwd )"
source ${CURRENT_DIR}/common.sh

# -- validate input ----------------------------------------------------------

function help() {
   echo
   echo "Build examples from the repository"
   echo
   echo "Syntax: $0 fpga_family [examples]..."
   echo "Arguments:"
   echo "  fpga_family  - A supported FPGA family"
   echo "  examples     - A name of an available example"
   echo
}

if [[ ! $# -ge 1 ]]; then
  echo "Invalid number of arguments!"
  help
  exit 1
fi

# -- tuttest -----------------------------------------------------------------

fpga_family=$1
shift

examples="$@"
if [ "$fpga_family" == "xc7" -a -z "$examples" ]; then
    examples="counter picosoc litex litex_linux timer pulse_width_led button_controller registers_example uart_transmitter uart_tx-rx"
elif [ "$fpga_family" == "eos-s3" -a -z "$examples" ]; then
    examples="counter"
fi

# activate conda and enter example dir

snippets="docs/building-examples.rst:export-install-dir,fpga-fam-$fpga_family,conda-prep-env-$fpga_family,conda-act-env,enter-dir-$fpga_family"
additionalDesigns="docs/building-examples.rst:export-install-dir,fpga-fam-$fpga_family,conda-prep-env-$fpga_family,conda-act-env,enter-dir-$fpga_family,additional_examples"

# Xilinx 7-Series examples
if [ "$fpga_family" = "xc7" ]; then
    for example in $examples; do
        case $example in
            "counter")
                snippets="${snippets} xc7/counter_test/README.rst:example-counter-*-group"
                ;;
            "picosoc")
                snippets="${snippets} xc7/picosoc_demo/README.rst:example-picosoc-*-group"
                ;;
            "litex")
                snippets="${snippets} xc7/litex_demo/README.rst:example-litex-dir,example-litex-req,example-litex_picorv32-*-group,example-litex_vexriscv-*-group"
                ;;
            "litex_linux")
                snippets="${snippets} xc7/linux_litex_demo/README.rst:example-litex-*-group"
                ;;
            "pulse_width_led")
                snippets="${snippets} xc7/pulse_width_led/README.rst:example-pulse-arty-35t"
                ;;
            "timer")
                snippets="${snippets} xc7/timer/README.rst:example-watch-basys3"
                ;;

            #Additional examples:
            "button_controller")
                snippets="${additionalDesigns} xc7/additional_examples/button_controller/README.rst:example-debouncer-basys3"
                ;;
            "registers_example")
                snippets="${additionalDesigns} xc7/additional_examples/registers_example/README.rst:example-registers-basys3"
                ;;
            "uart_transmitter")
                snippets="${additionalDesigns} xc7/additional_examples/uart_transmitter/README.rst:example-uarttx-basys3"
                ;;
            "uart_tx-rx")
                snippets="${additionalDesigns} xc7/additional_examples/uart_tx-rx/README.rst:example-uarttx-rx-basys3"
                ;;
             *)
                echo "ERROR: Unknown example name: $example" >&2
                exit 1
                ;;
        esac
    done
# QuickLogic EOS-S3 examples
elif [ "$fpga_family" = "eos-s3" ]; then
    for example in $examples; do
        case $example in
            "counter")
                snippets="${snippets} eos-s3/btn_counter/README.rst:eos-s3-counter"
                ;;
             *)
                echo "ERROR: Unknown example name: $example" >&2
                exit 1
                ;;
        esac
    done
else
  echo "ERROR: Unknown fpga_family: $fpga_family" >&2
  exit 1
fi

# call tuttest
tuttest_exec ${snippets}