User manual

PAL tutorial
2 DSM tutorials
There are two Data Stream Manager tutorials:
• Pattern matching tutorial: a simple example, targeting the DSM Simulation Virtual platform
• FIR filter tutorial: a more complex example, running on the DSM Sim platform, the RC200
and the Memec Virtex-II Pro development board.
The tutorials show you how to implement platform-independent hardware-software co-designs between
a processor and an FPGA using DK, and the DSM API.
There are also a number of DSM example programs. These include explanation of how to target
different platforms, but not how to program using DSM.
2.1 DSM pattern matching tutorial
The DSM pattern matching tutorial has 3 stages:
• Part 1: matches a single word of fixed-pattern data against a stream of information.
• Part 2: adds the ability to match against multiple words, and the words are sent using a
separate DSM port before the data is sent.
• Part 3: implements a fuzzy matching algorithm that will find the best match in any given
stream for any given pattern.
The PAL API is used to provide platform abstraction for peripheral access.
All interfacing between the software side and the hardware side is done using the DSM API.
Running the tutorial
You can run the tutorial using the DSM Virtual simulation platform. To compile the tutorial for simulation,
you will need DK for the hardware side and Microsoft Visual C++ v6 or v7 for the software side (other
compilers may work but have not been tested).
The tutorial workspace
The DK tutorial workspace can be accessed from the
Start menu under Programs>Celoxica>Platform
Developer's Kit
>DSM>DSM Tutorial Workspace [DK].
The tutorial workspace is already set up for use with DSM and contains three projects: "Part1", "Part2"
and "Part3", which refer to the three stages of the tutorial.
2.1.1 Running the DSM tutorial in simulation
The 3 stages of the DSM pattern matching tutorial can be run in simulation using the DSM Sim Virtual
Platform.
1. Open the DSM tutorial DK workspace from the start menu:
Start>Programs>Celoxica>Platform
Developer's Kit
>DSM>DSM Tutorial Workspace [DK].
2. Choose Part1, Part2 or Part3 of the tutorial projects by selecting
Project>Set Active Project.
3. Choose to target the "Sim" platform (
Build>Set Active Configuration).
4. Build the project by pressing F7.
5. Begin the simulation by pressing F5. A console window will open but will not generate any
output.
www.celoxica.com
Page 14