Quickstart

Installation

Using pip

Install ppci in a virtualenv environment:

$ virtualenv sandbox
$ source sandbox/bin/activate
(sandbox) $ pip install ppci
(sandbox) $ ppci-build.py -h

If ppci installed correcly, you will get a help message of the ppci-build.py commandline tool.

Manually

Alternatively you can download a zip package from PyPI or from BitBucket. Unpack the source archive and open a console in this directory.

$ virtualenv sandbox
$ source sandbox/bin/activate
(sandbox) $ python setup.py install
(sandbox) $ ppci-build.py -h

If ppci installed correcly, you will get a help message of the ppci-build.py commandline tool.

Example projects

Download and unzip examples.zip to checkout some demo projects that can be build using ppci.

stm32f4 example

To build the blinky project do the following:

$ cd examples/blinky
$ ppci-build.py

Flash the hexfile using your flashtool of choice on the stm32f4discovery board and enjoy the magic.

arduino example

To build and the arduino blink led example, follow the following commands:

$ cd examples/avr/arduino-blinky
$ ppci-build.py
$ avrdude -v -P /dev/ttyACM0 -c arduino -p m328p -U flash:w:blinky.hex

Linux x86_64 example

To build the hello world for 64-bit linux, go here:

$ cd examples/linux64/hello
$ ppci-build.py
$ ./hello

Or run the snake demo under linux:

$ cd examples/linux64/snake
$ ppci-build.py
$ ./snake

Next steps

If you have checked out the examples, head over to the howto, api and reference sections to learn more!