How do I run Psyclone AIR Plug?

If you want to try the compiled examples first, you can give the following command (for cpptester):

./cpptester psyclone=localhost
Make sure Psyclone is running first.

If you need to compile the examples you merely enter the following command on the command line:

make

This will compile and build the three examples, which you can run manually by first starting up the Psyclone Server without a psySpec in one command window

./psyclone[version]ncl

and in another command windows run the Tester module

./cpptester

If Psyclone is running on a port other than 10000 you will have to specify this by

./cpptester psyclone=localhost:12000

or if Psyclone is running on another computer on the network

./cpptester psyclone=mikescomputer:12000

To include an external module when running Psyclone — and have Psyclone help you by starting the module for you automatically — you will need to create a psySpec and define a module which provides the full command line with which to start up the external module. For example, to define a module which uses an external module in the executable file mymodule, you would specify the module like this

<module name="MyModule">
        <description>This module is my first external module</description>
        <parameter name="maxcount" type="Integer" value="100"/>
        <parameter name="anotherparam" type="double" value="0.01"/>
        <parameter name="astringparam" type="String" value="Hello"/>
        <executable name="MyModuleName" consoleoutput="yes">
            ./mymodule psyclone=%host%:%port% name=%name%
        </executable>
        <spec>
            <context name="Psyclone.System.Ready">
                <phase id="1">
                    <triggers from="WB1">
                        <trigger after="100" type="Psyclone.System.Ready"/>
                        <trigger type="Test.Message.Type"/>
                    </triggers>
                    <posts>
                        <post to="WB1" type="Other.Message.Type" />
                    </posts>
                </phase>
            </context>
        </spec>
    </module>

You can even specify multiple command lines if the same psySpec is used on different computers and even different operating systems

        <executable name="MyModuleName" consoleoutput="yes">
           <sys hostname="mikescomputer">
                ./mymodule psyclone=%host%:%port% name=%name%
           </sys>
           <sys hostname="brianscomputer">
                ./mymodule psyclone=%host%:%port% name=%name%
           </sys>
           <sys ostype="Linux">
                ./mymodule psyclone=%host%:%port% name=%name%
           </sys>
           <sys ostype="OSX" hostname="johnscomputer">
                ./mymodule psyclone=%host%:%port% name=%name%
           </sys>
        </executable>

For more information on this, see the Psyclone Manual (psycloneManual.html).