CreateControllerFromFile

void ISystem.CreateControllerFromFile(string filename, string sn, uint id, SimulatorSettings settings)

Creates a simulated top-controller from an XML controller description stored in file.

Parameters

• filename – Name of file 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 – SimulatorSettings containing simulator configuration settings.

Throws

• InvalidArgumentException – Empty serial number specified.

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

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

• InvalidArgumentException – Invalid CPU utilization specified in settings.

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

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

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

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

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

• TimeoutException – Simulator service communication timeout.

• AccessDeniedException – Unable to open file for reading.

• ReadErrorException – Error while reading from the specified file.

• CommunicationErrorException – Protocol error.