openpilot0/tools/sim
Adeeb Shihadeh 35ff65121e pre-commit: add codespell (#25571)
old-commit-hash: 6590fb2b93
2022-08-30 11:20:55 -07:00
..
lib remove old tools script 2022-08-07 17:10:14 -07:00
tests controls: block resume if cruise not previously engaged (#25402) 2022-08-17 18:03:33 -07:00
Dockerfile.sim
Dockerfile.sim_nvidia
README.md
__init__.py
bridge.py pre-commit: add codespell (#25571) 2022-08-30 11:20:55 -07:00
build_container.sh
launch_openpilot.sh
start_carla.sh controlsd: handle radar missing + cleanup system error handling (#25179) 2022-07-14 19:55:18 -07:00
start_openpilot_docker.sh
tmux_script.sh

README.md

openpilot in simulator

openpilot implements a bridge that allows it to run in the CARLA simulator.

System Requirements

openpilot doesn't have any extreme hardware requirements, however CARLA requires an NVIDIA graphics card and is very resource-intensive and may not run smoothly on your system. For this case, we have a the simulator in low quality by default.

You can also check out the CARLA python documentation to find more parameters to tune that might increase performance on your system.

Running the simulator

Start Carla simulator, openpilot and bridge processes located in tools/sim:

# Terminal 1
./start_carla.sh

# Terminal 2 - Run openpilot and bridge in one Docker:
./start_openpilot_docker.sh

# Running the latest local code execute
    # Terminal 2:
    ./launch_openpilot.sh
    # Terminal 3
    ./bridge.py

Bridge usage

Same commands hold for start_openpilot_docker

$ ./bridge.py -h
Usage: bridge.py [options]
Bridge between CARLA and openpilot.

Options:
  -h, --help            show this help message and exit
  --joystick            Use joystick input to control the car
  --high_quality        Set simulator to higher quality (requires good GPU)
  --town TOWN           Select map to drive in
  --spawn_point NUM     Number of the spawn point to start in

To engage openpilot press 1 a few times while focused on bridge.py to increase the cruise speed. All inputs:

key functionality
1 Cruise up 1 mph
2 Cruise down 1 mph
3 Cruise cancel
q Exit all
wasd Control manually

Further Reading

The following resources contain more details and troubleshooting tips.