Getting started with the Papilio Pro and Xilinx ISE on Linux

Papilio Pro with LEDs and OV2640 camera module

Papilio Pro with LEDs and OV2640 camera module

My Papilio Pro arrived some days (weeks...) ago, let’s get started^^

First have a look at the Papilio Quick Start Guide: http://papilio.cc/index.php?n=Papilio.GettingStarted

Check that the Hardware is OK

If I get new hardware the first thing I always do is to check if its working properly. Sometimes you have to flash a basic Hello World example yourself but the Papilio Pro should have been flashed with a bitstream file already that:

  • Toggles all of the even numbered pins
  • Configures all of the odd number pins as inputs. When a odd number pin is asserted it will cause the even pin next to it to stop blinking and stay at 3.3V.
  • Sends the ASCII table at 9600 8N1 over the serial port in a continuous loop.

Lets check that, connect the Papilio via USB to your PC and use screen to open the serial port:

[chris@thinkpad ~]$ sudo screen /dev/ttyUSB1 9600
ASCII Table ~ Character Map
!, dec: 33, hex: 21, oct: 41, bin: 100001
", dec: 34, hex: 22, oct: 42, bin: 100010
#, dec: 35, hex: 23, oct: 43, bin: 100011
$, dec: 36, hex: 24, oct: 44, bin: 100100
%, dec: 37, hex: 25, oct: 45, bin: 100101
&, dec: 38, hex: 26, oct: 46, bin: 100110
', dec: 39, hex: 27, oct: 47, bin: 100111
(, dec: 40, hex: 28, oct: 50, bin: 101000
), dec: 41, hex: 29, oct: 51, bin: 101001
*, dec: 42, hex: 2A, oct: 52, bin: 101010
+, dec: 43, hex: 2B, oct: 53, bin: 101011
,, dec: 44, hex: 2C, oct: 54, bin: 101100
-, dec: 45, hex: 2D, oct: 55, bin: 101101
., dec: 46, hex: 2E, oct: 56, bin: 101110
/, dec: 47, hex: 2F, oct: 57, bin: 101111
0, dec: 48, hex: 30, oct: 60, bin: 110000
1, dec: 49, hex: 31, oct: 61, bin: 110001
2, dec: 50, hex: 32, oct: 62, bin: 110010
3, dec: 51, hex: 33, oct: 63, bin: 110011
4, dec: 52, hex: 34, oct: 64, bin: 110100
5, dec: 53, hex: 35, oct: 65, bin: 110101
6, dec: 54, hex: 36, oct: 66, bin: 110110
7, dec: 55, hex: 37, oct: 67, bin: 110111
8, dec: 56, hex: 38, oct: 70, bin: 111000
9, dec: 57, hex: 39, oct: 71, bin: 111001
:, dec: 58, hex: 3A, oct: 72, bin: 111010
;, dec: 59, hex: 3B, oct: 73, bin: 111011
<, dec: 60, hex: 3C, oct: 74, bin: 111100
=, dec: 61, hex: 3D, oct: 75, bin: 111101
>, dec: 62, hex: 3E, oct: 76, bin: 111110
?, dec: 63, hex: 3F, oct: 77, bin: 111111
@, dec: 64, hex: 40, oct: 100, bin: 1000000
A, dec: 65, hex: 41, oct: 101, bin: 1000001
B, dec: 66, hex: 42, oct: 102, bin: 1000010
C, dec: 67, hex: 43, oct: 103, bin: 1000011
Really kill this window [y/n]
[screen is terminating]
[chris@thinkpad ~]$

So this looks good, now the pins, you can easily check this if you connect an LED with a series resistor to 5V and PIN14 like seen in the tittle image. Then the LED should blink. Yippee!

Install the Papilio Loader and Drivers for Linux

Download the Papilio Loader and Drivers http://forum.gadgetfactory.net/index.php?/files/file/10-papilio-loader-gui/ and select Download (Linux Recommended) V2.6.tar.gz.

You will get a file Papilio-Loader-2.6.tar.gz. Extract it, ensure that libftdi-dev and the Java SDK are installed and run the installer:

[chris@thinkpad Papilio]$ tar -xf Papilio-Loader-2.6.tar.gz
[chris@thinkpad Papilio]$ sudo yum install libftdi.i686 libftdi-devel.i686 java-1.7.0-openjdk
[chris@thinkpad Papilio]$ cd Papilio-Loader-2.6/
[chris@thinkpad Papilio-Loader-2.6]$ ./linux-installer.sh
Be sure there is a Java installed. For ubuntu do a sudo apt-get install default-jdk
Be sure libftdi is installed. For ubuntu do a sudo apt-get install libftdi-dev
Note: Some input files use unchecked or unsafe operations.
Note: Recompile with -Xlint:unchecked for details.
[chris@thinkpad Papilio-Loader-2.6]$

Ubuntu

root@dockapp:/# dpkg --add-architecture i386
root@dockapp:/# apt-get update
root@dockapp:/# apt-get install libc6:i386 libncurses5:i386 libstdc++6:i386
root@dockapp:/# apt-get install libftdi-dev:i386 default-jdk

Note

It looks like everything can be build from source except data2mem, see here for a statement from the developer: http://forum.gadgetfactory.net/index.php?/topic/1569-wheres-the-sourcecode-for-the-papilio-arduino-15-plugin/

Now download the example bitstream file and try to flash it to the Papilio:

[chris@thinkpad Papilio]$ wget http://papilio.cc/sketches/Quickstart-Papilio_Pro_LX9-v1.5.bit
[chris@thinkpad Papilio]$ papilio-loader-gui
Papilio Loader GUI loading Quickstart-Papilio_Pro_LX9-v1.5.bit

Papilio Loader GUI loading Quickstart-Papilio_Pro_LX9-v1.5.bit

The first time I got an error because there were some missing 32-bit libraries (libftdi.i686 libftdi-devel.i686 libusb.i686 libusbx.i686):

/opt/GadgetFactory/papilio-loader/programmer/linux32/papilio-prog: error while loading shared libraries: libftdi.so.1: cannot open shared object file: No such file or directory

If everything is working as expected the board should start printing the ASCII table on the serial port again.

Using Xilinx ISE WebPack IDE with the Papilio

I’m following http://papilio.cc/index.php?n=Papilio.GettingStartedISE.

I’ve already installed Xilinx ISE WebPACK inside a Docker Container, so I will skip this here.

Create a new Project in Xilinx ISE Project Navigator

Start Xilinx ISE Project Navigator, click on “New Project” and name it Webpack_Quickstart:

Xilinx ISE Project Navigator -> New Project

Xilinx ISE Project Navigator -> New Project

Now the important part, device and project properties, for the Papilio Pro select:

  • Family: “Spartan6”
  • Device: “XC6SLX9”
  • Package: “TQG144”
  • Speed: “-2”
Xilinx ISE: Device Properties

Xilinx ISE: Device Properties

I’m making probably far two many screenshoots since every body knows how to create a new source file but here it is^^

Xilinx ISE: New Source

Xilinx ISE: New Source

And create a VHDL module named Webpack_Quickstart and just click “Next”, “Next” and “Finish”:

Xilinx ISE: New VHDL Module

Xilinx ISE: New VHDL Module

Now we need to download the User Constraint File (UCF) for our board: http://forum.gadgetfactory.net/index.php?/files/file/4-papilio-pro-generic-ucf/

This time click “Add Copy of Source” and add the BPC3011-Papilio_Pro-general.ucf file to the project:

Xilinx ISE: New VHDL Module

Xilinx ISE: New VHDL Module

Import the Example Code

Click on “Webpack_Quickstart.vhd” and replace the file contents with the code from below:

library IEEE;
use IEEE.STD_LOGIC_1164.ALL;
use IEEE.STD_LOGIC_ARITH.ALL;
use IEEE.STD_LOGIC_UNSIGNED.ALL;

entity Webpack_Quickstart is
    Port ( A : out  STD_LOGIC_VECTOR (15 downto 0);
           B : out  STD_LOGIC_VECTOR (15 downto 0);
           C : out  STD_LOGIC_VECTOR (15 downto 0);
                          clk : in STD_LOGIC);
end Webpack_Quickstart;

architecture Behavioral of Webpack_Quickstart is
 signal counter : STD_LOGIC_VECTOR(47 downto 0) := (others => '0');
begin
        --Counter to drive blinking pins
        count: process(clk)
   begin
     if rising_edge(clk) then
       counter <= counter+1;
     end if;
   end process;
        --Pins are connected to the counter
        --to cause blinking at varying frequencies
        A <= counter(35 downto 20);
        B <= counter(31 downto 16);
        C <= counter(15 downto 0);
end Behavioral;
Xilinx ISE: Example Code

Xilinx ISE: Example Code

https://github.com/GadgetFactory/VHDL_Example_Code/tree/master/WebPack_QuickStart

Synthesize the Design

First we need to modify the “Process Properties” a little bit. The generic UCF file that we are using has more pins defined then necessary for this project, by default the syntheses tool will generate an error when this happens. That’s why we have to change the settings so that those pins are ignored.

Xilinx ISE: Process Properties

Xilinx ISE: Process Properties

Put a check mark in “Allow Unmatched LOC Constraints”:

Warning

Be careful with this setting, it can mask problems such as a typo in your ucf file. The safest practice is to comment out unused lines from your ucf file. –http://papilio.cc/index.php?n=Papilio.GettingStartedISE

Xilinx ISE: Allow Unmatched LOC Constraints

Xilinx ISE: Allow Unmatched LOC Constraints

Comment out all line that have a PULLUP defined inside the UCF file:

Xilinx ISE: Comment out any lines with a PULLUP defined

Xilinx ISE: Comment out any lines with a PULLUP defined

Double click “Generate Programming File”:

Xilinx ISE: Generate Programming File

Xilinx ISE: Generate Programming File

And if you see Process "Synthesize - XST" failed, then you have done something wrong^^

Started : "Synthesize - XST".
Running xst...
Command Line: xst -intstyle ise -ifn "/share/home/app/VHDL/Webpack_Quickstart/Webpack_Quickstart.xst" -ofn "/share/home/app/VHDL/Webpack_Quickstart/Webpack_Quickstart.syr"
Reading design: Webpack_Quickstart.prj

=========================================================================
*                          HDL Parsing                                  *
=========================================================================
ERROR:Xst:2927 - "/share/home/app/VHDL/Webpack_Quickstart/Webpack_Quickstart.prj" line 1: Source file ../../../../share/home/app/VHDL/Webpack_Quickstart/Webpack_Quickstart.vhd does not exist
-->


Total memory usage is 306180 kilobytes

Number of errors   :    1 (   0 filtered)
Number of warnings :    0 (   0 filtered)
Number of infos    :    0 (   0 filtered)


Process "Synthesize - XST" failed

OK, after trying differnt things I’ve found the error, don’t use a path with symlinks...

Load the Bitstream to the FPGA

Now we have to use the papilio-loader-gui and select the Webpack_Quickstart.bit file from the project directory.

Papilio Loader: Webpack_Quickstart.bit

Papilio Loader: Webpack_Quickstart.bit

Verify the Design

Now verify that the design works as expected. First I thought something was wrong, because the LED was constantly on...

But the LEDs are blinking at quite different frequencies, so just connect the LEDs to different pins and see what’s happening ;)

Blinking Papilio

So now comes the hard work, to get further with my camera project...