POD installation guide

Prerequisites

Mandatory

• python 2.6 : POD is written in python.
• pyparsing : a python module to parse files.

On ubuntu, python is already installed, just install pyparsing package with command :

[  ] $ sudo apt-get install python-pyparsing

Optional

• ghdl, gtkwave : it's not mandatory, POD can generate VHDL testbench ready for ghdl simulator. As it's standard VHDL, another simulator should work.
• ISE Webpack : to generate synthesis project for Xilinx.
• Quartus : to generate synthesis project for Altera.
• ARMadeus SDK : to generate driver project for the Armadeus boards.

Install from git tree

• Checkout the source code with following command (git is needed):

$ git clone git://git.code.sf.net/p/periphondemand/code periphondemand
$ cd periphondemand/

Note: For developpers with write right use following command : $ git clone ssh://USER@git.code.sf.net/p/periphondemand/code periphondemand

• Install POD (with root privileges):

$ sudo python setup.py install

Update from git tree

If you already installed pod from git and there is modification in the official sourceforge repository, you can update it with these commands :

$ sudo rm build/*
$ git pull
$ sudo python setup.py install

Install from package

Note: For this moment, package must be created from git repository first (see next Chapter). Release will be downloadable soon.

• Decompress the package PeriphOnDemand-X.X.tar.gz in install directory:

$ cd somewhere/
$ tar -zxvf PeriphOnDemand-X.X.tar.gz

• Walk through periphondemand/ directory:

$ cd periphondemand

• Then install POD with root privilege:

 $ sudo python setup.py install

Generate package from GIT tree

• If not already done, checkout the source code with following command (git is needed):

$ git clone git://periphondemand.git.sourceforge.net/gitroot/periphondemand/periphondemand
$ cd periphondemand/

• Make python POD distribution:

$ python setup.py sdist

• The POD package can be found in directory dist/