Skip to main content

runlevel

Description

Provides information if the vehicle is in manual or autonomy.

FielddatatypeDescription
utimestringBest estimate of when this message is from, host clock in UTC
runlevelstringThe current runlevel for the system.Actual mode of the vehicle being driven in autonomy or manual.
healthRunlevelstringThe runlevel specified by the health monitoring system based on the system's health checks.When the value is 'nominal' the vehicle is capable of being driven in autonomous mode. Any other value other than 'nominal' or 'controlled stop' indicates that the vehicle is not capable of being driven autonomously and the safety driver must take over the vehicle.
requestedRunlevelstringThe requested runlevel from a user. The runlevel that is currently being requested. For instance, the vehicle's healthRunlevel recommends that the vehicle be in autonomy mode, but if the vehicle is being driven manually, the requested runlevel will be manual.
vehiclestringunique vehicle name the data is associated to.
topicstringtype of telemetry data
Run Level
TypeDescription
NominalVehicle in Autonomy mode
ConservativeTBD(Reserved for future use)
Controlled StopVehicle comes to a comfortable stop as planned
Blind StopVehicle comes to a hard stop along last steering angle
ManualVehicle under manual control
ServiceVehicle under manual control, but is in some way only partially functional
SeabiscuitIf the software system fails, this backup system will kick in and bring the vehicle to a stop
Ignore(bad value)

Topic/channel string

For Realtime API

Pass the comma seperated topic name as a query param

/.vehicle.{vehiclename}.RUNLEVEL

For Batch API - TBD

To access the Batch API, you need to include the vehicle name and topic name as path parameters in the URL.

/vehicles/{vehiclename}/topics/RUNLEVEL

JSON Output

Order of fields might differ

{
"healthRunlevel": "NOMINAL",
"requestedRunlevel": "MANUAL",
"runlevel": "MANUAL",
"topic": "RUNLEVEL",
"utime": "1683642289466127",
"vehicle": "vehiclename"
}