Git submodule workflow

1. Clone the repository with the --recursive option: git clone --recursive git@github.com:PerugiaOverNetDAQ/papero.git
2. To update the repository run:

git pull
git submodule update

3. If you already have cloned the repository:

git submodule init
git submodule update

---

Hog walkthrough

For more information, read the official documentation.

• Be sure to clone the repository with the --recursive option
• Top folder contains all the projects with their configuration files
• From the git root folder run ./Hog/CreateProject.sh papero to create the quartus project
  • The command regenerates the .qsys modules and includes all the other (qip, vhd, v, ...)
• The Quartus project (.qpf) is in the directory Projects/papero
• Once the compiling process is over, Hog copies the output .sof file and the reports in the folder bin
  • The files are organized in subfolders, named with the commit SHA and the tag
  • Make sure that all changes are committed (at least locally)
  • Create the correspondent incremental tag with the format vX.X.X (e.g. v.1.0.2)
  • These commit SHA and the tag are mapped in two FPGA registers