Introduction | Command line tools »


The ppci project is a compiler, assembler, linker and build-system written entirely in python. The project contains everything from language front-end to code generation. It contains a front-end for the c3 language, can optimize this code and generate ARM-code.

The project contains the following:

  • Language front-ends: Brainfuck, C3
  • Various code optimizers
  • Backends for various platforms: ARM, Thumb, Python
  • Assembler
  • Linker

Warning: This project is in alpha state and not read for production use!

Quick guide

ppci can be installed using pip:

$ pip install ppci

To invoke the builder and compile the snake demo, use the following:

$ -f examples/build.xml

If the compilation was succesful, the snake demo compiled into ‘examples/snake.bin’. This is a binary file with ARM-code which can be run in qemu as follows:

$ qemu-system-arm -M lm3s6965evb -kernel snake.bin -serial stdio

This runs the snake demo on an emulated lm3s demo board and displays the game to the console.

Instead of using the Command line tools, you can also use the API.