Tutorial CSP First Step: Difference between revisions

No edit summary
No edit summary
Line 42: Line 42:
[[file:ProB_CSPModelCheck.png|center||200px]]
[[file:ProB_CSPModelCheck.png|center||200px]]


By default, ProB will search for deadlocks and events on the "error" channel.
By default, ProB will search for deadlocks, illegal channel values and events on the "error" channel.
To turn the latter off, uncheck the invariant violation check box.
To turn the latter off, uncheck the invariant violation check box.
You can also search for events on the "goal"channel, by checking the corresponding check box.
You can also search for events on the "goal"channel, by checking the corresponding check box.
Line 48: Line 48:
Now press the "Model Check" button. ProB should find a deadlock and insert the counter-example into the history as follows:
Now press the "Model Check" button. ProB should find a deadlock and insert the counter-example into the history as follows:
[[file:ProB_CSPAfterModelCheck.png|center||700px]]
[[file:ProB_CSPAfterModelCheck.png|center||700px]]
== Error Highlighting ==
Now edit the definition of the BUS37 process and add an illegal output of value 1 on the alight37B channel:
BUS37 = board37A -> (pay90 -> alight37B!1 -> STOP
                    [] alight37A -> STOP)
Now save and reload the machine and again choose the "Model Checking" command. Now uncheck the "Deadlock" checkbox and press "Model Check".
ProB will report the following error:
Mismatch in number of arguments for channel synchronisation: Channel:ExtraArgs = alight37B:[int(1)]
### Line: 11, Column: 30
and highlight the error location in the source as follows:
[[file:ProB_CSPAfterModelCheck2.png|center||700px]]


== Other Features ==
== Other Features ==

Revision as of 19:25, 10 October 2010

[Category:User Manual]]


Startup

Start off by installing the standalone Tcl/Tk version of ProB. Follow the instructions in Installation. Start ProB by double-clicking on ProBWin (for Windows users), or by launching StartProB.sh from a Terminal (for Linux and Mac users).

Loading a first CSP specification

Use the "Open..." command in the "File" menu and then navigate to the "Examples" directory that came with your ProB installation. Inside the "CSP" subfolder, open the "buses.csp" specification. Your main ProB window should now look as follows:

ProB BusesAfterLoad.png

First Steps in Animation

We have now loaded a first simple CSP model. Let us look at the contents of the ProB window (ignoring the menu bar).

  • The upper half of the ProB window contains the source code of the model.
  • The lower half contains three panes.
    • The "State Properties" pane contains information about the current state of the model. We will explain the contents of this pane in more detail later.
    • The Pane called "Enabled Operations" contains a list of events that your CSP specification offers. At the very first step you have to choose a process to animate. If your CSP specification contains a MAIN process (as is the case in buses.csp), only this process will be shown.
    • The History pane contains the list of operations you have executed to reach the current state of the animator. Obviously, this list is initially empty.

Now, double click on "MAIN" process in the "Enabled Operations" Pane. This has the effect of computing the events offered by MAIN. The lower half of the ProB window should now look as follows (the upper half will remain unchanged):

ProB CSPAfterInit.png


In the "Enabled Operations" pane we can see that two tau events are offered: tau(int_choice_left) and tau(int_choice_right). The "History" pane shows us that we have started the "MAIN" process to reach the current state. By single-clicking on an event, we can see which parts of the CSP specification contributed to the event. For example, single clicking on the first tau event yields in the following picture:

ProB CSPAfterTauSingleClick.png

By repeatedly single clicking on the event you can cycle through the various locations that contributed to the event. To execute an event, simply double-click on it.

First Steps in Model Checking

You can use the model checker to search for certain errors. Execute the "Model Check" command in the "Verify Menu". The following dialog box will appear:

ProB CSPModelCheck.png

By default, ProB will search for deadlocks, illegal channel values and events on the "error" channel. To turn the latter off, uncheck the invariant violation check box. You can also search for events on the "goal"channel, by checking the corresponding check box.

Now press the "Model Check" button. ProB should find a deadlock and insert the counter-example into the history as follows:

ProB CSPAfterModelCheck.png

Error Highlighting

Now edit the definition of the BUS37 process and add an illegal output of value 1 on the alight37B channel: BUS37 = board37A -> (pay90 -> alight37B!1 -> STOP

                    [] alight37A -> STOP)

Now save and reload the machine and again choose the "Model Checking" command. Now uncheck the "Deadlock" checkbox and press "Model Check". ProB will report the following error:

Mismatch in number of arguments for channel synchronisation: Channel:ExtraArgs = alight37B:[int(1)]

### Line: 11, Column: 30

and highlight the error location in the source as follows:

ProB CSPAfterModelCheck2.png


Other Features

You can check more sophisticated temporal properties using the LTL model checker of ProB; see the corresponding part of the tutorial. It is also possible to perform trace refinement checks (see Refinement_Checking). The state space visualisation features of ProB are also available for CSP; see the corresponding part of the tutorial.