CreateController

virtual void ISystem::CreateController(const std::string &xml, const std::string &sn, uint32_t id, const SSimulatorSettings &settings) = 0

Creates a simulated top-controller from an XML controller description provided as string.

Parameters

• xml – String containing XML controller description.

• sn – Serial number of the simulated top-controller.

• id – ID of the simulated top-controller, ignored if top-controller does not support an ID.

• settings – SSimulatorSettings containing simulator configuration settings.

Throws

• CInvalidArgumentException – Empty serial number specified.

• CInvalidArgumentException – Invalid simulator service address specified, i.e. invalid IP address or hostname could not be resolved.

• CInvalidArgumentException – Invalid client address specified, i.e. invalid IP address or hostname could not be resolved.

• CInvalidArgumentException – Invalid CPU utilization specified in settings.

• CInvalidArgumentException – Invalid number of real-time threads specified (zero).

• CInvalidArgumentException – Out-of-range speed factor specified (<0.001 or> 1000).

• CInvalidFormatException – Invalid XML contents (see exception message for details).

• CInvalidConfigException – Simulator service cannot start/locate the simulator executable.

• COutOfResourcesException – Maximum number of top-controllers or pipes reached (limited by simulator service platform hardware resources).

• CTimeoutException – Simulator service communication timeout.

• CCommunicationErrorException – Protocol error.