Ubuntu 18 and Pepper QiSDK Emulator troubleshooting

Ubuntu 18 and Pepper QiSDK Emulator troubleshooting

You might face difficulties running the Pepper (QiSDK) Emulator from Android Studio under Linux Ubuntu 18.04 and a SDK error message may be displayed. You will find below how to solve this issue. This has been tested using API 4 of the SDK plugin, Android Studio 3.4.1

SDK Error popup window
SDK Error popup window


Linux Ubuntu 18 Operating System IS NOT OFFICIALLY SUPPORTED to work with the QiSDK plugin for Pepper. The tip presented in this article is given as a courtesy. Please check compatible platforms.

1. Make sure your user is in the kvm group.

KVM (Kernel-based Virtual Machine) is an open source virtualization technology built into Linux. KVM lets you turn Linux into a hypervisor that allows a host machine to run multiple, isolated virtual environments called virtual machines (VMs). That is what we need to run the Pepper (QiSDK) Emulator on Ubuntu.

  • Install qemu-kvm package if not yet available:

$ sudo apt install qemu-kvm

  • Check the ownership of /dev/kvm use:

$ ls -al /dev/kvm
crw-rw----+ 1 root kvm 10, 232 juin 13 09:28 /dev/kvm

  • The user is ‘root’ and the group ‘kvm’. Your user needs to be in the ‘kvm’ group. Being logged in with your user, on a terminal use the command :

$ groups
[groups you belong to]

This returns a list of groups your user account belongs to, separated by spaces.

If the group ‘kvm’ does not appear in the list, your account does not belong to ‘kvm’ group.

  • To add your user to the ‘kvm’ group, use :

$ sudo adduser $USER kvm

  • Check once again with the groups command

$ groups
kvm [other groups you belong to]

  • Log out and back in (or restart) for the permissions to take effect.

2. Relink the correct libz.so

Next step you need to relink to the proper zlib library. To do so :

  • Change directory to /home/$USER/.local/share/Softbank Robotics/RobotSDK/API 5/tools/lib

$ cd "/home/$USER/.local/share/Softbank Robotics/RobotSDK/API 4/tools/lib"

  • Backup the old libz.so.1 :

$ mv libz.so.1 libz.so.1.bak

  • And relink the system's one:

$ ln -s /usr/lib/x86_64-linux-gnu/libz.so libz.so.1

3. Restart Android Studio

You should now be able to start the Pepper (QiSDK) Emulator!