tsl/tools/replay
Dean Lee f1416f337c
replay: update README (#32966)
update README
2024-07-12 16:42:10 -07:00
..
lib refactor camera transformations (#31818) 2024-03-10 16:56:50 -07:00
tests replay: bug fixes and improvements (#32193) 2024-04-21 17:09:17 -07:00
.gitignore
README.md replay: update README (#32966) 2024-07-12 16:42:10 -07:00
SConscript Restructure msgq (#32652) 2024-06-09 17:44:34 -07:00
__init__.py
camera.cc replay: fix hangs on exit (#32795) 2024-06-20 00:16:14 -07:00
camera.h Split cereal into cereal/msgq (#32631) 2024-06-06 14:31:56 -07:00
can_replay.py boardd is pandad (#32628) 2024-06-04 19:16:55 -07:00
consoleui.cc cabana: bug fixes and improvements (#32934) 2024-07-08 14:50:31 -07:00
consoleui.h replay: support for setting a custom playback speed (#30462) 2023-11-18 22:12:35 -08:00
filereader.cc replay: bug fixes and improvements (#32193) 2024-04-21 17:09:17 -07:00
filereader.h
framereader.cc replay: shared decoder context (#32255) 2024-04-24 19:44:18 -07:00
framereader.h Split cereal into cereal/msgq (#32631) 2024-06-06 14:31:56 -07:00
logreader.cc cabana: avoid dead locks and improve responsiveness (#32740) 2024-06-16 12:32:45 -07:00
logreader.h replay: optimize memory usage with `MonotonicBuffer` (#32278) 2024-04-22 19:21:42 -07:00
main.cc replay: support for setting a custom playback speed (#30462) 2023-11-18 22:12:35 -08:00
replay.cc cabana: bug fixes and improvements (#32934) 2024-07-08 14:50:31 -07:00
replay.h cabana: bug fixes and improvements (#32934) 2024-07-08 14:50:31 -07:00
route.cc replay: handle route not found error with user warning message (#32895) 2024-07-03 15:27:54 -07:00
route.h cabana: improved error messaging (#32768) 2024-06-17 12:44:31 -07:00
ui.py long control: new API (#32706) 2024-06-14 00:08:58 -07:00
unlog_ci_segment.py LogReader: move opci to tools/lib (#31021) 2024-01-16 10:58:51 -08:00
util.cc Processor definition check for __APPLE__ has a typo on replay (#32930) 2024-07-08 17:10:26 +00:00
util.h cabana: avoid dead locks and improve responsiveness (#32740) 2024-06-16 12:32:45 -07:00

README.md

Replay

Replay driving data

replay replays all the messages logged while running openpilot.

# Log in via browser to have access to routes from your comma account
python tools/lib/auth.py

# Start a replay
tools/replay/replay <route-name>

# Example:
tools/replay/replay 'a2a0ccea32023010|2023-07-27--13-01-19'
# or use --demo to replay the default demo route:
tools/replay/replay --demo

# watch the replay with the normal openpilot UI
cd selfdrive/ui && ./ui

# or try out a debug visualizer:
python replay/ui.py

usage

$ tools/replay/replay -h
Usage: tools/replay/replay [options] route
Mock openpilot components by publishing logged messages.

Options:
  -h, --help             Displays this help.
  -a, --allow <allow>    whitelist of services to send
  -b, --block <block>    blacklist of services to send
  -c, --cache <n>        cache <n> segments in memory. default is 5
  -s, --start <seconds>  start from <seconds>
  -x <speed>             playback <speed>. between 0.2 - 3
  --demo                 use a demo route instead of providing your own
  --data_dir <data_dir>  local directory with routes
  --prefix <prefix>      set OPENPILOT_PREFIX
  --dcam                 load driver camera
  --ecam                 load wide road camera
  --no-loop              stop at the end of the route
  --no-cache             turn off local cache
  --qcam                 load qcamera
  --no-hw-decoder        disable HW video decoding
  --no-vipc              do not output video
  --all                  do output all messages including uiDebug, userFlag.
                         this may causes issues when used along with UI

Arguments:
  route                  the drive to replay. find your drives at
                         connect.comma.ai

watch3

watch all three cameras simultaneously from your comma three routes with watch3

simply replay a route using the --dcam and --ecam flags:

# start a replay
cd tools/replay && ./replay --demo --dcam --ecam

# then start watch3
cd selfdrive/ui && ./watch3

Stream CAN messages to your device

Replay CAN messages as they were recorded using a panda jungle. The jungle has 6x OBD-C ports for connecting all your comma devices. Check out the jungle repo for more info.

In order to run your device as if it was in a car:

  • connect a panda jungle to your PC
  • connect a comma device or panda to the jungle via OBD-C
  • run can_replay.py
batman:replay$ ./can_replay.py -h
usage: can_replay.py [-h] [route_or_segment_name]

Replay CAN messages from a route to all connected pandas and jungles
in a loop.

positional arguments:
  route_or_segment_name
                        The route or segment name to replay. If not
                        specified, a default public route will be
                        used. (default: None)

optional arguments:
  -h, --help            show this help message and exit