Wrapper#

Overview#

The wrapper Generic Integration is a SCADE target designed to host any number of extensions. It has a behavior comparable to the SCADE Simulator:

  • It manages the graphical panels, UAs and/or A661 server connections when available.

  • It manages the registered extensions, for example instances of classes derived from CWuxSimulatorExtension through calls to the WuxXxx simulation hooks.

The wrapper does not generate code: it provides the main function, defined in WuxGoMain.cpp, and declares a target to the build system with the files generated by KCG and those added by the generation services with the tag WUX.

The lib/WuxGoMain.cpp resource file is declared to the Code Generator with the tag WUX.

Interface#

The extensions can redefine the following functions:

class CWuxSimulatorExtension
{
public:
    ...
    // integration interface
    virtual const char* GetIdent();
    virtual bool IntegrationStart(int argc, char* argv[]);
    virtual void IntegrationStop();
    virtual bool SelfPaced();
    virtual bool IsAlive();
    ...
};

  • GetIdent: Identifier of the extension, for error reporting or discrimination.

  • IntegrationStart: argc/argv are the command line parameters of the executable, no filter is applied. Returns false to stop the process.

  • IntegrationStop: Called just before the process terminates.

  • SelfPaced: Returns true if the extension is scheduled by the environment, for example by waiting for some event in the BeforeSimStep function.

  • IsAlive: Returns false to stop the process.

Refer to Simulator extension for more information about the CWuxSimulatorExtension class.

Main loop period#

When no extension is self-paced, the period is the one defined in the Code Generator Integration settings; Else, the period can be specified on the command line with the option -latency (ms) otherwise it is 0.

Note

The behavior is unclear when several extensions are registered and if at least one of them is self-paced. For a project involving conflicting extensions, it is advised to provide a customized version of lib/WuxGoMain.cpp to implement the desired scheduling and interactions between the required extensions.