How commaai/openpilot works
openpilot is a robotics operating system providing driver assistance for supported cars. The principal workflow is: cameras and vehicle sensors produce observations; model, localization, planning, and control processes compute driving commands; panda communicates those commands to the car; the UI presents state and alerts. The manager initializes parameters, registers the device, and supervises runtime processes. Logging, upload, networking, remote routes, replay, and CAN-analysis tools are additional product capabilities. Several process internals were not sampled, so only documented or directly evidenced wiring is shown.
Main entry points: messaging.h Messaging Bus · manager.py Process Manager · pandad.py Panda Daemon · main.cc Camera Daemon
Components 23
Vehicle Sensing
- Camera Daemon
openpilot/system/camerad/main.cc - Sensor Daemon
openpilot/system/sensord/sensord.py - GPS Daemon
openpilot/system/ubloxd/ubloxd.py - Panda Daemon
openpilot/selfdrive/pandad/pandad.py
Driving Intelligence
- Driving Model
openpilot/selfdrive/modeld/modeld.py - Localization
openpilot/selfdrive/locationd/locationd.py - Motion Planner
openpilot/selfdrive/controls/plannerd.py - Vehicle Controller
openpilot/selfdrive/controls/controlsd.py
Device Runtime
- Messaging Bus
openpilot/cereal/messaging/messaging.h - Process Manager
openpilot/system/manager/manager.py - Persistent Params
openpilot/common/params.py - Drive Logger
openpilot/system/loggerd/loggerd.cc - Data Uploader
openpilot/system/loggerd/uploader.py
User Experience
- Onroad UI
openpilot/selfdrive/ui/layouts/main.py - Alert Manager
openpilot/selfdrive/selfdrived/alertmanager.py - WiFi Manager
openpilot/system/ui/lib/wifi_manager.py
Analysis Tools
- CAN Analyzer
openpilot/tools/cabana/ui/main.cc - Remote Routes
openpilot/tools/cabana/ui/dialogs/routesdialog.cc - Route Replay
openpilot/tools/replay/main.cc - Log Explorer
openpilot/tools/jotpluggler/app.cc
Other components
- Driver
- Supported Car
- Comma Cloud
Connections 25
- Process Manager → Persistent Params: initializes
- Process Manager → Comma Cloud: registers device
- Process Manager → Camera Daemon: starts process
- Process Manager → Sensor Daemon: starts process
- Process Manager → Panda Daemon: starts process
- Camera Daemon → Messaging Bus: publishes frames
- Sensor Daemon → Messaging Bus: publishes sensors
- GPS Daemon → Messaging Bus: publishes GPS
- Panda Daemon → Messaging Bus: publishes CAN
- Messaging Bus → Driving Model: delivers frames
- Messaging Bus → Localization: delivers sensors
- Driving Model → Messaging Bus: publishes predictions
- Localization → Messaging Bus: publishes pose
- Motion Planner → Messaging Bus: publishes plan
- Vehicle Controller → Panda Daemon: sends commands
- Driver → Onroad UI: operates interface
- Onroad UI → Messaging Bus: publishes bookmarks
- Alert Manager → Persistent Params: stores alerts
- Drive Logger → Messaging Bus: records streams
- Data Uploader → Comma Cloud: uploads driving data
- WiFi Manager → Comma Cloud: connects network
- Remote Routes → Comma Cloud: fetches routes
- CAN Analyzer → Route Replay: loads route data
- Log Explorer → Comma Cloud: streams routes
- Supported Car → Panda Daemon: exchanges CAN