ProtoCollum Quick Start Guide (v0.1)

The purpose of this Quick Start Guide is to get the user up and running with ProtoCollum as quickly as possible. After showing how to download and install the tool, we take the user through the creation, exercising, and further development of a sample protocol.

We introduce the capabilities and operation of ProtoCollum by means of a simple example that gets progressively more complex through a series of enhancements. As in the real-world, this design starts with a high-level, introductory description that covers the main points. The enhancements either more precisely define existing operations or add additional operations (or a mixture of both).

To avoid any conceptual difficulties with the application area itself, we use an interaction that should be familiar to all: the use of an Automated Teller Machine (ATM). Since the operation of an ATM is already well-known, we can instead concentrate on how to use ProtoCollum.

Chapter 1 - Downloading and Installing ProtoCollum
Downloading ProtoCollum
Installing ProtoCollum
Testing the Installation
Chapter 2 - The Simple ATM Example
Defining a Simple Protocol
The Simple ATM Example
Capturing the Simple Protocol
Where to Go Next
Chapter 3 - Exercising the Simple ATM Example
Creating a Test Scenario
Adding a Test Sheet
Where to Go Next
Chapter 4 - Adding State to the Simple ATM Example
State Machine for Simple ATM
Maintaining State in ProtoCollum
Using Flags on the Test Sheet
Where to Go Next
Chapter 5 - Extending the ATM Example
The Digit Operation for the ATM
Extending the State Machine for the ATM
Writing the Support Code
Adding the PIN
Verifying the PIN with Flags
Adding the keypressDigit Message
Verifying PIN Digit Entry with Flags
Where to Go Next
Chapter 6 - More Operations for the ATM Example
Extending the State Machine for the ATM
Writing the Support Code
Exercising the New Operations
Where to Go Next

Copyright © 2003-2005 by Bellum Software™
last updated on 10 August 2005