• Raspberry Pi 3
• Powered USB hub
• USB hard disk 1 Tb
• USB audio adapter
• Joystick controller
• LCD display 16×2 charaters

We started with a Raspbian 2017-11-29 lite, based on Debian Stretch. To have a minimal Kodi installation and support for the joystick, just install the following packages:

• kodi
• kodi-bin
• kodi-peripheral-joystick

Kodi will not start automatically at boot, just execute kodi-standalone from the command line.

NOTICE: Raspbian includes Kodi version 17.6 whereas Debian Stretch has Kodi 17.1, so beware of what packages you are installing and respect the right dependencies.

There are several recipes on the internet to start Kodi on boot; we searched one with the following features:

• Does not require xserver.xorg, as we have installed Raspbian Stretch Lite.
• Run Kodi as unprivileged user.
• Run as a service, do not use autologin and autostart tricks.
• Should be compliant with the underlying init system, which is systemd in Raspbian Stretch.
• Can perform reboot and poweroff from Kodi menu.

So we want to execute kodi-standalone as kodi user. Create that user first, and assign him to the required groups:

adduser --disabled-password --gecos "User to run Kodi Media Center" kodi
adduser kodi audio
adduser kodi video
adduser kodi plugdev
adduser kodi input

Then we created a systemd unit file /etc/systemd/system/kodi.service to start Kodi as a service. Please do not use an old fashioned sysvinit start/stop script (e.g. /etc/init.d/kodi), because the new systemd can use it only in compatibility mode.

[Unit]
Description = Kodi Media Center

# if you don't need the MySQL DB backend, this should be sufficient
After = systemd-user-sessions.service network.target sound.target

# if you need the MySQL DB backend, use this block instead of the previous
# After = systemd-user-sessions.service network.target sound.target mysql.service
# Wants = mysql.service

[Service]
User = kodi
Group = kodi
Type = simple
ExecStart = /usr/bin/kodi-standalone
Restart = always
RestartSec = 15

[Install]
WantedBy = multi-user.target

To actually enable and start the service, run:

systemctl daemon-reload
systemctl enable kodi.service
systemctl start kodi.service

Now we have to solve a problem: the unprivileged Kodi user cannot perform reboot and poweroff actions: as you can se the exit menu of Kodi shows only the Exit item. We need a piece of software: policykit-1. This package contains the framework which handles the authorizations, according to the Freedesktop.org guidelines.

apt-get install policykit-1

We created the file /etc/polkit-1/localauthority/50-local.d/50-kodi.pkla, which allows the Kodi user to execute some privileged actions:

[Actions for kodi user]
Identity=unix-group:kodi
Action=org.freedesktop.upower.*;org.freedesktop.udisks.*;org.freedesktop.login1*
ResultActive=yes
ResultAny=yes
ResultInactive=no

We keep all our media files (video, images, etc.) into an USB hard disk, connected through a powered USB hub. It can be possible that the Raspberry Pi will be started without the disk attached. In this case we want no Kodi service to be started. See this paragrph on how to configure systemd unit for that purpose.

• Kodi 14.2 Shutdown Functions not available - Raspian
• Autostart Kodi in Raspbian Jessie
• Starting Kodi automatically on Raspbian Jessie and Stretch
• kodi-standalone no possibilty for poweroff and reboot
• Shutdown does not work when Kodi autoboots with the Pi
• Archive:HOW-TO:Autostart Kodi for Linux

The first attempt was an Amazon Basics USB 3.0 4 ports hub. Unfortunately it is based on the VIA Labs chips, which seems to have a bug, so it is uncompatibile with the Raspberry Pi.

The device is listed on the USB bus:

Bus 001 Device 005: ID 2109:2811 VIA Labs, Inc. Hub

but when you connect even a simple mouse, you get plenty of errors, and the device does not work:

usb 1-1.4.1: new low-speed USB device number 6 using dwc_otg
usb 1-1.4.1: device descriptor read/64, error -71
usb 1-1.4.1: device descriptor read/64, error -71
usb 1-1.4.1: new low-speed USB device number 7 using dwc_otg
usb 1-1.4.1: device descriptor read/64, error -71
usb 1-1.4.1: device descriptor read/64, error -71
usb 1-1.4.1: new low-speed USB device number 8 using dwc_otg
usb 1-1.4.1: device not accepting address 8, error -71
usb 1-1.4.1: new low-speed USB device number 9 using dwc_otg
usb 1-1.4.1: device not accepting address 9, error -71
usb 1-1.4-port1: unable to enumerate USB device

I tried several workarounds: leaving the hub unpowered, attaching an USB 3.0 external hard disk, adding the option dwc_otg.speed=1 into /boot/cmdline.txt. None of that gave a minimal benefit. I returned the hub back to Amazon.

Here are some web references:

• USB 3.0 hub fails to pass through USB 2.0 devices (ID 2109:3431)
• AmazonBasics 4 Port USB 3.0 Hub not working
• documentation > hardware > raspberrypi > usb
• RPi Powered USB Hubs