/control/command/control_cmd#
Specifications#
| Item | Value |
|---|---|
| Last Updated | 2026-01-21 |
| Interface Type | topic |
| Interface Name | /control/command/control_cmd |
| Data Type | autoware_control_msgs/msg/Control |
| Rate [Hz] | 33 |
| QoS Reliability | reliable |
| QoS Durability | volatile |
Description#
Send the control command to the vehicle. This is the command format that can be used universally in vehicles based on the Ackermann kinematic model. At this stage, do not expect anything other than simple control such as smoothly approaching the target value. For example, the time-series control involving acceleration and deceleration to reach a target speed must have been completed in a previous stage. Therefore, it is generally assumed that the target value will be sent at a time close enough that linear interpolation is possible. If your vehicle interface would like to support time series data directly, please join the discussion of the ControlHorizon message.
Message#
For details about the message, see the readme of autoware_control_msgs.
The velocity, acceleration, and jerk values at a given time must be planned in advance and must be consistent, which is typically done by the planning/control component. If these values are inconsistent, which value takes priority depends on the vehicle implementation.
Sending the latest command will invalidate previous commands, which means that commands from different time stamps are not kept as a time series. Only the latest command, not the latest time stamp command, is valid.
Errors#
Command Timeout: If the command is not sent frequently enough to control the current vehicle speed, the vehicle executes an emergency stop.
Out of Range: If the command exceeds the given physical limit, the value is clamped to the maximum.
Support#
This interface is required. If there is only a vehicle-specific interface, provide a converter. For vehicles controlled by typical accelerator and brake pedals, consider using the autoware_raw_vehicle_cmd_converter.
Limitations#
Command filter: The commands may be filtered by a rate limiter to prevent physically impossible or unsafe rapid acceleration or steering.
Use Cases#
- Control the vehicle for autonomous driving.
- Relay commands from the operator.
Requirement#
- Support sending the control command to the vehicle.
- Ignore the control command depending on the control mode.
- Report the error as diagnostics in the following cases:
- Topic rate is too low or too high.
- An unacceptable target value is sent.
- It fails to achieve the target value.
Design#
TODO: Explanation of the basis for setting the topic frequency.
History#
| Date | Description |
|---|---|
| 2026-01-21 | First release in the new format. |