User`s manual

12. Control Room Bus services
348/398
________________________________________________________________________________________
Apollo Rel. 1.9 User's Manual
12.2.2 Mode of operation
Data received via the serial interface are stored by the application until the character indicating the end of the
command has been received as well (terminator). The application then compares all samples saved in Serial-
CommandInterface.ini with the received data. In case of a match, the program launches the corresponding
application with the configured parameters.
Example:
Configuration:
$assign pattern program parameter terminator
assign "LoadFree" "ApolloProgram\DesktopCmd.exe" "-name:" CR
string sent:
„LoadFree Wall1 –region:Left –LoadLayout:English1<CR>“
The program launches the application "ApolloProgram\DesktopCmd.exe" with the
parameters „-name:Wall1 –region:Left –LoadLayout:English1“
In case the SerialCommandInterface.ini file includes a wrong configuration, the process is
terminated, and the respective entry into the log-file is written.
After startup of Apollo, there is a short period in which the Desktop Command interface
is not ready yet. Make sure that you only send commands via the serial command
interface when the Desktop Command has been started by Apollo (you can check this by
clicking onto the Control Room Bus icon in the status bar and then selecting Component
Viewer.
If the Desktop Command interface is not yet ready, and commands are sent via the
SerialCommandInterface, the SerialCommandInterface will start an own instance of the
Desktop Command Interface, thus running a second instance of this service. This is a very
instable situation; you have to stop both Desktop Command instances using the
Windows TaskManager. The next serial command will restart the DesktopCmd and the
system will function again.