QSPY: QSPY MscGen Inteface

The QSPY host application can also generate data for the MscGen utility (http://www.mcternan.me.uk/mscgen/) to generate sequence diagrams.

Note:: The MscGen utility is also available in the Qtools collection (http://www.state-machine.com/downloads/index.php#QTOOLS).

To generate an MscGen file, you need to invoke QSPY with the -g<msc-file> option:

qspy -gdpp.msc ...

where <msc-file> is the file name to gnerate.

Note:: The generation of sequence diagrams relies on the following QS trace records being enabled: QS_QF_ACTIVE_POST_FIFO, QS_QF_ACTIVE_POST_LIFO. Additional annotations of the sequence diagrams are also available if the following QS trace records are enabled: QS_QF_PUBLISH, QS_QF_TICK, and QS_QEP_TRAN.

Subsequently, you need to invoke the MscGen utility to convert the generated file to graphical format, such as .PNG, .EPS, .SVG, or .ISMAP. For example, the following command generates a sequence diagram in .SVG from the dpp.msc file.

mscgen -Tsvg -idpp.msc

The following screen shot shows a sequence diagram generated from the Dining Philosophers Problem (DPP) application. The .MSC file has been converted to .SVG and viewed in a web browser (Google Chrome in this case).

Note:: The numbers preceeding the signal names in the diagram are the time stamps.