Quick start demo
Below you can find instructions on how to setup the self-driving demo of AWSIM simulation controlled by Autoware. The instruction assumes using the Ubuntu OS.
AWSIM on the left, Autoware on the right.
Demo contents
AWSIM demo contents | |
---|---|
Vehicle | Lexus RX450h 2015 |
Map | Japan tokyo nishi-shinjuku |
Sensors | LiDAR * 1 Camera * 1 GNSS * 1 IMU * 1 |
Traffic | Randomized traffic |
ROS2 | humble |
1. Preparation
Please make sure that your computer meets the following requirements in order to run the simulation correctly
Warning
Requires Nvidia RTX graphics card as it uses raytracing.
Required PC specs | |
---|---|
OS | Ubuntu 22.04 |
CPU | 6 cores and 12 threads or higher |
GPU | RTX2080Ti or higher |
Memory | 32GB or higher |
Nvidia driver | 570 or higher |
Localhost settings
The simulation is based on the appropriate network setting, which allows for trouble-free communication of the AWSIM simulation with the Autoware software.
To apply required localhost settings please add the following lines to ~/.bashrc
file:
if [ ! -e /tmp/cycloneDDS_configured ]; then
sudo sysctl -w net.core.rmem_max=2147483647
sudo ip link set lo multicast on
touch /tmp/cycloneDDS_configured
fi
and these lines to ~/.profile
or in either of files: ~/.bash_profile
or ~/.bash_login
:
Info
A system restart is required for these changes to work.
2. Install Autoware
-
Clone Autoware and move to the directory.
-
Use the
main
branch. Please check current branch. - Configure the environment.
- Create the
src
directory and clone external dependent repositories into it. - Install dependent ROS packages.
- Build the workspace.
3. Download AWSIM demo
-
Install nvidia gpu driver (Skip if already installed).
- Add nvidia driver to apt repository.
-
Install the recommended version of the driver.
Info
Version 570 or higher is recommended.
-
Reboot your machine to make the installed driver detected by the system.
-
Open terminal and check if nvidia-smi command is available and outputs summary similar to the one presented below.
Check result.Fri May 2 18:55:24 2025 +-----------------------------------------------------------------------------------------+ | NVIDIA-SMI 570.124.06 Driver Version: 570.124.06 CUDA Version: 12.8 | |-----------------------------------------+------------------------+----------------------+ | GPU Name Persistence-M | Bus-Id Disp.A | Volatile Uncorr. ECC | | Fan Temp Perf Pwr:Usage/Cap | Memory-Usage | GPU-Util Compute M. | | | | MIG M. | |=========================================+========================+======================| | 0 NVIDIA GeForce RTX 4090 Off | 00000000:01:00.0 On | Off | | 0% 45C P8 25W / 450W | 5920MiB / 24564MiB | 7% Default | | | | N/A | +-----------------------------------------+------------------------+----------------------+
-
Install vulkan graphics library (Skip if already installed).
- Update the environment.
- Install the library.
-
Download AWSIM demo.
-
Download
AWSIM-Demo.zip
. -
Unzip the downloaded file.
-
Make the
AWSIM-Demo.x86_64
file executable. Rightclick theAWSIM-Demo.x86_64
file and check theExecute
checkbox.or execute the command below.
Info
If
AWSIM-Demo
is hefty, try AWSIM-Demo-LightWeight, a lightweight version.
-
4. Run AWSIM and Autoware
It is recommended to launch in the order of 1.AWSIM -> 2.Autoware
. Same procedure as the actual autoware's real vehicle.
-
Launch AWSIM demo
-
Double-click
AWSIM-Demo.x86_64
to start it. -
Check ros2 topic list (optional)
Result. Topics that AWSIM demo pub/subs./clock /control/command/control_cmd /control/command/emergency_cmd /control/command/gear_cmd /control/command/hazard_lights_cmd /control/command/turn_indicators_cmd /parameter_events /rosout /sensing/camera/traffic_light/camera_info /sensing/camera/traffic_light/image_raw /sensing/gnss/pose /sensing/gnss/pose_with_covariance /sensing/imu/tamagawa/imu_raw /sensing/lidar/top/pointcloud_raw /sensing/lidar/top/pointcloud_raw_ex /vehicle/status/control_mode /vehicle/status/gear_status /vehicle/status/hazard_lights_status /vehicle/status/steering_status /vehicle/status/turn_indicators_status /vehicle/status/velocity_status
-
-
Launch Autoware
-
Download
Shinjuku-Map.zip
and unzip them.
Download Shinjuku-Map.zipInfo
Autoware-shinjuku-map.zip file contains map files for
pcd
andosm
. -
Launch Autoware.
source install/setup.bash && ros2 launch autoware_launch e2e_simulator.launch.xml vehicle_model:=sample_vehicle sensor_model:=awsim_sensor_kit map_path:=<your mapfile location>
Warning
<your mapfile location>
must be changed arbitrarily. When specifying the path the~
operator cannot be used - please specify absolute full path.
-
-
Start autonomous driving !
-
With both AWSIM and Autoware activated, check if the vehicle's self-position estimation is normal.
-
Set the navigation goal for the vehicle.
-
Check generate path and press "Auto" button.
-
Enable self-driving.
Info
The default value of Autoware's maximum speed is 15 km/h. If you want more speed, you can modify it by entering the following command in the
autoware
directory.Learn more about demo simulation.
-