SUMO
Simulation of Urban MObility

- Home
- Download
- Documentation
- Wiki
- Trac
- Blog
- Contact
- SF-Project

# TraCI/Control-related commands

# Control-related commands

## Command 0x00: Get Version

-
no parameters

### Response 0x00: Version

integer | string
API Version | Identifier
--- | ---

The server responds to a Get Version command by sending two items:

- an API Version of 2 identifies the current state of the TraCI API (sumo 0.13.1 or later). It is guaranteed to increase as soon as
  - the TraCI message format (or its command format) changes
  - any TraCI command presented on these pages uses different parameters (either in data type, binary representation, or in meaning)
- an Identifier string identifies the software version running on the TraCI server in human-readable form
  - no guarantee is made regarding the content of this string
  - as an example, for SUMO 0.12.0, this string is "SUMO 0.12.0"

#### Tip

The client can find out if a particular command is supported by the current TraCI server (i.e., SUMO) by looking at the status response of the command. It may report "not implemented."

## Command 0x02: Simulation Step

integer
TargetTime [ms]

Forces SUMO to perform simulation. If TargetTime is 0 (zero), SUMO performs exactly one time step. Otherwise SUMO performs the simulation until the given time step is reached. If the given time step is smaller than the simulation step then SUMO performs one simulation step.

The response of this command is a list of subscription responses to TraCI/Object Variable Subscriptions and/or TraCI/Object Context Subscriptions referring to the last step executed:

integer | <SUBSCRIPTION RESPONSE> | ... | <SUBSCRIPTION RESPONSE>
Number of following subscription responses | <RESPONSE#1> | ... | <RESPONSE#n>
--- | --- | --- | ---

Please note, that both subscription types differ in their return values, so the parser should regard the id of the returned command.

## Command 0x7F: Close

Tells TraCI to close the connection to any client, stop simulation and shut down sumo.

This page was last modified on 17 September 2012, at 13:33.