Introduction

This documentation describes a simple visualSTATE^® demo application for the IAR KickStart Kit for AT91SAM7X. In terms of 'User Interface' the inluded AT91SAM7X-EK board is rather basic; it has one 5 way joystick (4 directions and a push function) and 4 green LEDs (that can be PWM controlled). The visualSTATE statechart in this demo application simply uses the joystick to do some manipulation with the LEDs.

The example comes in a couple of variants. One utilizes the traditional Table Based code generation of visualSTATE and incorporates the RealLink feature for in-target debugging with the visualSTATE Validator (available in RAM or FLASH based configurations). The other build variant (in RAM configuration) utilizes Human Readable code generation and incorporates the CSpyLink integration between visualSTATE and the C-SPY debugger of Embedded Workbench to achieve high-level state machine debug feedback directly in C-SPY. In the distribution, the RAM based RealLink variant is pre-compiled.

You can read this text in the order listed in the menu to the left:

• The HW & SW part describes which hardware and software you must have, and how to connect the hardware.
• The Operation part describes what the application does.
• The First Test part shows how to load and run the precompiled variant of the project.
• The Implementation part describes the structure and contents of the files included in the example.
• The Build with RealLink section explains how to build, download and run the example project with the RealLink debug interface using traditional Table Based code generation
• The Using RealLink part describes how to use the RealLink feature of the visualSTATE Validator to debug the application running on the board.
• The Build with CSpyLink section explains how to build, download and run the example project with the CSpyLink debug interface using the new Human Readable code generation
• The Using C-SPY plug-in part describes how to use the visualSTATE C-SPY plug-in to debug the application running on the board.
• The Modify example section illustrates how to make a minor functional change of the example model with visualSTATE Designerl.

Notes:

• Instructions on how to start a program from the start menu has the form Start>Programs>.... If you are using a non-English version of Windows, the program folder may have a different name.
• Instructions on how to locate a file in the default program folder directory on your harddisk assumes that the folder is named c:\Program Files. If you are using a non-English version of Windows, this directory may have a different name.
• Relative references to files included in this example are relative to the directory named AT91SAM7xKickstart (if this example was part of your visualSTATE installation, the absolute path of this directory will often be c:\Program Files\IAR Systems\visualSTATE 6.1\Examples\SampleBoards\AT91SAM7xKickstart).
• It is recommended to first copy the entire directory tree of the example to another location of your choice in order to keep the original intact for reference.
• The screenshots used in this document are based on the standard version of visualSTATE 6.1 in DEMO mode..