The apio examples package
The apio package with all the examples is called apio-examples and it is located in this repo: apio-examples. This package can be installed by means of the apio install examples command
For adding new examples follow these steps:
Fork the apio-examples repo and then clone it
Once the repo is cloned, enter into the apio-examples folder
There you will see many folder with the names of the supported boards. Find the board you want to use for your example and enter into that folder. If your board does not exist yet, create a new folder with that name
Inside your board folder you will find more folders with the names of the examples. Select the example you want to modify or creat a new folder if it is a new example
In this screenshot you can see that there are three examples inside the folder Alhambra-II
Inside the example folder there should be at least four files:
| File | Description |
|---|---|
| info | Text file with a single line with the description of the example. Is the messages displayed with the command apio example -l when listing all the examples |
| apio.ini | Apio project file. It is created with the command apio --init -b boardname |
| .pcf | The constaint file with associations between the top module ports and the FPGA pins |
| .v | One or more verilog files |
Once your example is ready emit a pull request for merging it with the upstream examples. In the next release cycle a new apio-exemples package will be ready with your new shiny example
This operation can only be done for those developers with enough permissions granted
Once a new version of the apio-example package is released it could be installed easily from apio with the command apio install examples
For releasing a new version follow these steps:
Choose a tag of the form x.y.z, where x,y and z are numbers. For example 0.0.18. Use the same tag as the number and add the description explaining what is new in this release
Then press the new release button. You will get something like this:
