openpilot/tools/sim
iejMac 1830a87d9a
update simulator README
2021-03-17 00:42:32 -07:00
..
lib minor bug fixes in sim (#20286) 2021-03-09 19:52:43 -08:00
.gitignore Cleanup simulator and add usage instructions (#1050) 2020-02-04 19:46:57 -08:00
Dockerfile.sim Minimize sim docker image size (#20324) 2021-03-11 19:04:29 -08:00
README.md update simulator README 2021-03-17 00:42:32 -07:00
bridge.py improving tools readme (#20305) 2021-03-11 15:28:37 -08:00
build_container.sh Specify comma containers come from ghcr.io in docker pull commands. (#20342) 2021-03-14 12:59:05 -07:00
install_carla.sh Fix simulator docker: CPU only for now (#20227) 2021-03-07 23:02:57 -08:00
launch_openpilot.sh Manager cleanup (#20231) 2021-03-05 11:03:23 +01:00
start_carla.sh optimizing simulator performance (#20295) 2021-03-09 23:48:46 -08:00
start_openpilot_docker.sh mount openpilot in simulator docker image (#20379) 2021-03-16 22:23:38 -07:00
tmux_script.sh Add Flags to Control Simulator (#2246) 2020-09-29 14:00:03 -07:00

README.md

openpilot in simulator

Running the simulator

First, start the CARLA server.

./start_carla.sh

Then start bridge and openpilot.

./start_openpilot_docker.sh

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

Controls

You can control openpilot driving in the simulation with the following keys

key functionality
1 Cruise up 5 mph
2 Cruise down 5 mph
3 Cruise cancel
q Exit all

To see the options for changing the environment, such as the town, spawn point or precipitation, you can run ./start_openpilot_docker.sh --help. This will print the help output inside the docker container. You need to exit the docker container before running ./start_openpilot_docker.sh again.

System Requirements

openpilot doesn't have any extreme hardware requirements, however CARLA is very resource-intensive and may not run smoothly on your system. For this case, we have a low quality mode you can activate by running:

./start_openpilot_docker.sh --low_quality

NOTE: CARLA requires an NVIDIA graphics card.

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

Further Reading

The following resources contain more details and troubleshooting tips.