Tutorials

Tutorial 1: Getting the car running

  1. Turn the engine on by turning the key completely to the right

  2. On the right side of the trunk, rotate the power button to the left

  3. Press the power button of the IPC until you hear a sound

  4. Turn the iPad on

  5. Wait a few minutes until you hear a short melody coming from the IPC, indicating that the boot sequence is complete

  6. Open the DreamView app on the iPad to control Apollo

  7. On the top right of the screen, select either "Pandora" or "RTK Record/Replay'' then "Kia Niro" and "Gloshaugen"

  8. Press the Setup button in the bottom left part of the screen

  9. If you are in RTK Record/Replay mode, you can then press the RTK Record Start/Stop buttons to record a trajectory. Then, RTK Replay Start to publish this trajectory as planning. Then Start Auto to let the car drive along this trajectory

Tutorial 2: Acquiring sensors data

Acquiring Pandora data from a laptop

For convenience, we recommend using an Ubuntu laptop to acquire Pandora data. On the laptop, .

Configure the Ethernet interface to be on the Pandora’s local network. You can use network-manager to setup the manual IPv4 address 192.168.20.100.

Clone, compile and run the Pandora_ros ROS node.

mkdir -p rosworkspace/src
cd rosworkspace/src
git clone --recursive https://github.com/HesaiTechnology/Pandora_ros
cd ..
catkin_make_isolated
source devel/setup.sh
roslaunch pandora pandora_driver.launch

You can now also run the rviz command and add PointCloud and Image viewers corresponding to the topics emitted by pandora_driver to visualize the data in real-time.

To record data, open a new terminal and type:

rosbag record -a

When you are done, just use Ctrl-C and wait for it to finish filling the file in.

Note: The same principle can be used to acquire data from the VLP16, by compiling the ROS node instead of Pandora_ros.

Note: The same principle can be used to acquire data on the IPC (eg: LIDAR+GPS+Perception output etc...), by running rosbag record from inside the Apollo Docker container or by starting the Record bag module from DreamView, while the other modules are running. The Record bag module from DreamView will record all topics on an external hard disk if connected or only the important topics on the IPC if no disk is connected.

Tutorial 3: Reinstalling the IPC

  1. Download

  2. Flash it on a USB stick using dd or unetbootin

  3. Reboot the IPC and while it boots, press F12

  4. Select the USB drive “Generic Flash Disk”

  5. Set the language to English

  6. Set the timezone to Other, Europe, Norway

  7. Set the locale to United States en_US.UTF-8

  8. Don’t detect layout, select Norwegian

  9. Set the disk to p5p1

  10. Set the hostname to kia-niro

  11. Set the full name to NAP Lab

  12. Set the username to naplab

  13. Set the password to 123456

  14. Accept the weak password

  15. Do not accept disk encryption

  16. Accept the Europe/Oslo timezone

  17. Unmount /dev/sda

  18. Choose Guided - use entire disk

  19. Choose /dev/nvme0n1

  20. Accept to write changes to disk

  21. Leave the package manager proxy blank

  22. Select no automatic updates

  23. Select OpenSSH server only

  24. Install the GRUB boot loader to the master boot record

  25. The system clock is set to UTC

  26. Continue and remove the USB stick

  27. Reboot the machine, connect and run the following commands:

sudo apt update
sudo apt upgrade
sudo apt install git make gcc libssl-dev beep
sudo curl -sSL https://get.docker.com/ | sh
git clone https://github.com/FlorentRevest/apollo
git clone https://github.com/FlorentRevest/apollo-kernel
cd apollo-kernel/linux
./build.sh rt
cd install/rt/
tar xvf install.tgz
cd install
sudo ./install_kernel.sh
sudo vi /etc/network/interfaces

Edit the /etc/network/interfaces file to have this content:

auto lo
iface lo inet loopback

allow-hotplug p5p1
iface p5p1 inet dhcp
iface p5p1 inet6 auto

allow-hotplug p6p1
iface p6p1 inet static
    address 192.168.20.100
    netmask 255.255.255.0

sudo usermod -aG docker naplab
sudo sed -i "s@GRUB_DEFAULT=0@GRUB_DEFAULT=saved@" /etc/default/grub
sudo sed -i "s@GRUB_TIMEOUT=10@GRUB_TIMEOUT=1@" /etc/default/grub
sudo grub-set-default 1
sudo update-grub
reboot

Wait for the IPC to reboot...

cd apollo-kernel/linux/
sudo ./install-nvidia.sh
reboot

Wait for the IPC to reboot again...

cd apollo
sed -i 's@<username>@fmrevest@' modules/calibration/data/kia_niro/gnss_params/gnss_conf.pb.txt
sed -i 's@<password>@4rS42sJh@' modules/calibration/data/kia_niro/gnss_params/gnss_conf.pb.txt
sed -i 's@api/js@api/js?key=AIzaSyDii-Y-bxQXWeUdnyZnBjszQS5rFym_HXQ@' modules/dreamview/frontend/src/store/config/parameters.yml
sudo sed -i "/snd_pcsp/d" /etc/modprobe.d/blacklist.conf
sudo sed -i "/pcspkr/d" /etc/modprobe.d/blacklist.conf
sudo sh -c 'echo "UUID=562032004DA2CCDB /media/external_hdd ntfs-3g  auto,nobootwait,users,uid=1000,gid=100,dmask=027,fmask=137,utf8 0 0" > /etc/fstab'
docker/scripts/dev_start.sh

Edit /etc/rc.local using nano or vi and add before before “exit 0”:

sudo -H -u naplab /home/naplab/apollo/docker/scripts/dev_start.sh
sudo ip link set can0 type can bitrate 500000
sudo ip link set up can0
sudo ip link set can1 type can bitrate 500000
sudo ip link set up can1
beep -f165.4064 -l100 -n -f130.813 -l100 -n -f261.626 -l100 -n -f523.251 -l100 -n -f1046.50 -l100 -n -f2093.00 -l100 -n -f4186.01 -l100

docker/scripts/dev_into.sh
./apollo.sh build_opt_gpu
PreviousCloud PlatformNextWorking Remotely with GPU resources

Last updated

Was this helpful?