#!/bin/sh # # gen_litedram.sh - Downloads and generates the litedram verilog source code for a specific phy or for simulation # # Copyright (c) 2024 Efthymios Kritikos # # This program is free software: you can redistribute it and/or modify # it under the terms of the GNU General Public License as published by # the Free Software Foundation, either version 3 of the License, or # (at your option) any later version. # # This program is distributed in the hope that it will be useful, # but WITHOUT ANY WARRANTY; without even the implied warranty of # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the # GNU General Public License for more details. # # You should have received a copy of the GNU General Public License # along with this program. If not, see . # set -eu SOURCE_CODE_URL=https://github.com/enjoy-digital/litedram/archive/refs/tags/2023.08.tar.gz SOURCE_MD5_SUM=afc2208c08e60994d126c445574960da PYTHON_APPIMAGE_URL=https://github.com/niess/python-appimage/releases/download/python3.9/python3.9.18-cp39-cp39-manylinux_2_28_x86_64.AppImage PYTHON_APPIMAGE_SUM=8c383ade3ace416cf508d5f458b30149 OUTPUT_ECP5_1_WISHBONE_MD5=c775ddb23fd97211f3ace40d6e8c2a5f OUTPUT_ECP5_1_WISHBONE_SIM_MD5=06d0b073d06937312b425767c1895c6c help(){ echo This scripts generates a verilog file from the litedram project echo It is currently hardcoded for the ECP5 PHY echo echo Usage: echo \ \ \ "$0" \ } STOP_PARSING=0 OUT_FILE="" QUIET=0 FORCE=0 SIMULATION=0 while [ $# -gt 0 ]; do if [ "$STOP_PARSING" = "1" ] then echo arguments after -- help exit 1 fi case $1 in -q|--quiet) QUIET="$1" shift ;; -h|--help) help exit 0 ;; -f|--force) FORCE=1 shift ;; -s|--simulation) SIMULATION=1 shift ;; --) if ! [ $# -gt 1 ] then echo No file after -- help exit 1 fi if [ "$OUT_FILE" ] then echo Error two output files given exit 1 fi OUT_FILE=$2 STOP_PARSING=1 shift shift ;; -*) echo "Unknown option $1" help exit 1 ;; *) if [ "$OUT_FILE" ] then echo Error two output files given exit 1 fi OUT_FILE=$1 shift # past argument ;; esac done if [ "$OUT_FILE" = "" ] then echo Error: No output file provided help exit 1 fi TEMP_DIR=$(mktemp -d) trap 'rm -rf -- "$TEMP_DIR"' EXIT CUR_DIR=$(pwd) if ! echo "$OUT_FILE" | grep '^/' > /dev/null then OUT_FILE="${CUR_DIR}/${OUT_FILE}" fi cd "$TEMP_DIR" if [ "$QUIET" = 0 ];then echo Downloading litedram source code... fi wget --output-document=source.tar.gz --quiet "$SOURCE_CODE_URL" if [ "$(md5sum source.tar.gz)" != "${SOURCE_MD5_SUM} source.tar.gz" ] then echo Downloaded litedram source downloaded doesn\'t match md5 sum exit 1 fi if [ "$QUIET" = 0 ];then echo Downloading python appimage... fi wget --output-document=python.AppImage --quiet "$PYTHON_APPIMAGE_URL" if [ "$(md5sum python.AppImage)" != "${PYTHON_APPIMAGE_SUM} python.AppImage" ] then echo Downloaded python appimage source doesn\'t match md5 sum exit 1 fi chmod a+x python.AppImage ./python.AppImage --appimage-extract >/dev/null PYTHON=$(realpath squashfs-root/AppRun) mkdir python_modules PYTHON_MODULES=$(realpath python_modules) ######### This is a patch ############ # It's because litedram needs modules # it doesn't really use for --sim and # pip doesn't currently have some wget --quiet https://github.com/enjoy-digital/litescope/archive/refs/tags/2023.08.tar.gz tar xf 2023.08.tar.gz mv litescope-2023.08/litescope/ "${PYTHON_MODULES}" rm -r litescope-2023.08 2023.08.tar.gz ###################################### if [ "$QUIET" = 0 ];then echo extracting the source... fi tar xvf source.tar.gz > source_dir SOURCE_DIR=$(head -n 1 source_dir) rm source_dir if [ "$QUIET" = 0 ];then echo patching the source... fi #Generate the following text by running this: (diff -Naur /dev/null examples/orangecrab_9086.yml | gzip -9 | base64 | tr -d '\n';echo) echo H4sIAAAAAAACA61US2+bQBA+179ihC+JMA4Pg4mlSo7sOLFaJ5bjHKqqQguMYxRg6QJ2UJX/3lkwUeKop3oOy2pmvm/niaZpcBHi7iIt4/iLqZuWZpiaboJhj6zhaGD13aFOYthDUOWlo6oq4AtLshjzCy5Y+oSBYL53qbtOv0rekVhguCNzONKtvnM5HNqubtoHkvEYNL2ng2r0LAPG4476p6MCdOEGUxQsBu2/RfIplFkUoDKi6/fZtf2omfZMcxc3pmtPlB69N1veXEHj1a8RQVZKdxLljqdITh+kC5PlIxRVhnCGL7DDFxHlwa4HOQo6JeS85kkwkV7EpUynK+szz3R1taiJOmoTauLle5YpQIi1KOnlJp4k9EKMWSUNJLqMeg5ljsAg5nvYsbhEKDiwHY9CEMhCiHGHcZQ+NdRdWN7+OEFF36qah4IlXsLDMsamWMpiPTC+OYOF4chMu/BQp9e45MA3UGwRfM5ECFzAw702nS8Wn8i81Cc+s3dUqrsy8VFIFr8qEJ4EL7P8HZiG8LmBAhj/Bku397BsWx1aTarrydKmRlGlmgTWssUEqgeEtG0pZwJ/l5gGFZyklFGalYUXxM/ehojrcAYuOnWTpQmCmAfPsHl79efkfrW6nqx/NYlU+UcwgDOQcNmCKi8w+URwRq2RGPgKB/T5EWmURkchgdmSzsl2TNmWZsIFwummTE6+X242KGgBsmJLkRhO77A8UtGOVcCThKUhNM5tNI+0kbDkosjhFNHQwgkvk3QUR/2zIuU+yrc+rbyny+08aEnfbn5rb3a5NoWsYN4+Cut8LPNgeK2/8nzt/AU14UE3kwUAAA== | base64 -d | gzip -d > 00-add_orangecrab_config.patch cd "$SOURCE_DIR" patch -s -p0 < ../00-add_orangecrab_config.patch > /dev/null if [ "$QUIET" = 0 ];then echo Downloading required python modules... fi if ! "$PYTHON" -m pip install --target "$PYTHON_MODULES" install "pyaml==23.9.7" "migen==0.9.2" "litex==2023.08" "litedram==2023.8" "liteeth==2022.12" "liteiclink==2022.12" "pythondata_misc_tapcfg" > "$TEMP_DIR/build_log" 2> "$TEMP_DIR/build_log" then echo ERROR: Failed download python modules cat "$TEMP_DIR/build_log" exit 1 fi if ! ./setup.py build > "$TEMP_DIR/build_log" 2> "$TEMP_DIR/build_log" then echo ERROR: Failed to run setup.py cat "$TEMP_DIR/build_log" exit 1 fi cd build/lib/litedram/ GEN_OPTIONS="" if [ $SIMULATION = 1 ] then GEN_OPTIONS="$GEN_OPTIONS --sim" fi if ! PYTHONPATH=$PYTHON_MODULES "$PYTHON" gen.py $GEN_OPTIONS ../../../examples/orangecrab_9086.yml --no-compile-software > "$TEMP_DIR/build_log" 2> "$TEMP_DIR/build_log" then echo ERROR: Failed to run gen.py cat "$TEMP_DIR/build_log" exit 1 fi if [ "$QUIET" = 0 ];then echo patching source file... fi if [ "$SIMULATION" = 0 ] then #This is just for some yosys warnings... echo H4sIAAAAAAACA82T326CMBTG73mKc7XBECnKAHUkvMeyNEdatZE/hiLEzPnsa5nL4pYh3izrTduc3/d9Jyet4ziw3IuMuWuseYsVdzNRc1ZhTtOy4uMGJmQydTzPmYRAgrkfzEk4noYzEgZh5INN1DJs2waX8cYt9lkG3yWRUo1nj5FPvMALzpIkASci/nQUgt3tASSJASilWBfw+tmFboKylaA7j7YVwxpH8LNGzrU3iC+roqh5tcKU01bXF/8igOYot30pHaCjzFNfGG25tTCcvw4EzFo8SEjMBwuWfC0KA/S6UKabspRqyxltMBNMwlMM0T0jiyHwM3nRvHlBLbHY5phuRMHJFwt3YJpXwB0eshIZFVJfleK39BaLWh+k1dmehhpXKLXgNIxOUVrWDbyauuKP/V1jWotG/WFlbRzhholUHBnEcb+7hj6GMti3rRR51bijVM+Weljv0yEXHY0EAAA= | base64 -d | gzip -d | patch -s -p0 CHECK_MD5SUM=$OUTPUT_ECP5_1_WISHBONE_MD5 else echo H4sIAAAAAAACA7WPOQ7CMBREe59ievPjPVvlC3AGMLGFIpkEZeP6pKBCoguvmPLNDBHhtvY5intY0itMSeR+SXEKj0s3TqnYAGipDSlNsoIqW2laVxWNaXTZWKfB5Q7jnEPEtIlhzRk/+BLZ1srCVLYuldPVR+Q9SJlTDb6ng/cMQtChMEbXpX+kuQs5QQ0zBNRzZsTo8Kp9PM5jXHP6x483iNz1Tr8BAAA= | base64 -d | gzip -d | patch -s -p0 CHECK_MD5SUM=$OUTPUT_ECP5_1_WISHBONE_SIM_MD5 fi if ! [ "$(sed 's@//.*@@' build/gateware/litedram_core.v | md5sum )" = "$CHECK_MD5SUM -" ] then if [ "$FORCE" = 0 ] then echo ERROR: File was successfully built but the md5sum doesn\'t match the one used in development. echo You can ignore this error by passing the --force flag exit 1 else echo WARNING: File was successfully built but the md5sum doesn\'t match the one used in development. fi fi cp build/gateware/litedram_core.v "$OUT_FILE" if [ "$QUIET" = 0 ];then echo File built correctly! fi