Raspberry Pi - Ubuntu 20 Quick Start

Overview

This section provides Eclipse Kura™ quick installation procedures for the Raspberry Pi.

Warning

This quickstart will install the version of Kura with the administrative web UI and network configuration support but not CAN bus support. For more information on this please visit the Eclipse Kura download page

This quickstart has been tested using the latest Ubuntu 20.04.3 LTS Live Server for arm64 architecture flashed on the SD card through Raspberry Pi Imager.

The official images can be also found on the Project Page. Further information on the Ubuntu installation for Raspberry Pi can be found here.

Warning

Please note that, at the time of this writing, only 64 bit OS image is supported.

Enable SSH Access

On Ubuntu 20.04.3 the ssh access is enabled only for the standard ubuntu user. If you desire to remote login as root user, edit the file /etc/ssh/sshd_config (using the root permission) adding the line PermitRootLogin yes

Eclipse Kura™ Installation

To install Eclipse Kura with its dependencies on the Raspberry Pi, perform the following steps:

Boot the Raspberry Pi with the latest Ubuntu 20.04.3 LTS Server image.
Make sure your device is connected to internet. By default, eth0 lan network interface is configured in DHCP mode.

Upgrade the system:

sudo apt update

sudo apt upgrade

Tip

Optional: Since version 5.3.0 Kura also supports Eclipse Temurin™ as an alternative JVM. To install it you need to perform these additional steps:

sudo apt-get install -y wget apt-transport-https gnupg

sudo wget -O - https://packages.adoptium.net/artifactory/api/gpg/key/public | sudo apt-key add -

sudo echo "deb https://packages.adoptium.net/artifactory/deb $(awk -F= '/^VERSION_CODENAME/{print$2}' /etc/os-release) main" | sudo tee /etc/apt/sources.list.d/adoptium.list

sudo apt-get update

sudo apt-get install temurin-17-jdk

Download the Kura package with:
```
wget http://download.eclipse.org/kura/releases/<version>/kura-<kura-version>_generic-<arch>_installer.deb
```
Note: replace <version> in the URL above with the version number of the latest release (e.g. 5.5.0) and <arch> with your device architecture
Install Kura with:
```
sudo apt install ./kura-<kura-version>_generic-<arch>_installer.deb
```
All the required dependencies will be downloaded and installed.
Set the right Wi-Fi regulatory domain based on your current world region editing the /etc/default/crda and adding the ISO 3166-1 alpha-2 code of your region.

(Optional) Configure the GPIO replacing the content of the file /opt/eclise/kura/framework/jdk.dio.properties with the following text:

0 = deviceType: gpio.GPIOPin, pinNumber:0, name:GPIO0
1 = deviceType: gpio.GPIOPin, pinNumber:1, name:GPIO1
2 = deviceType: gpio.GPIOPin, pinNumber:2, name:GPI02
3 = deviceType: gpio.GPIOPin, pinNumber:3, name:GPIO3
4 = deviceType: gpio.GPIOPin, pinNumber:4, name:GPIO4
5 = deviceType: gpio.GPIOPin, pinNumber:5, name:GPIO5
6 = deviceType: gpio.GPIOPin, pinNumber:6, name:GPIO6
7 = deviceType: gpio.GPIOPin, pinNumber:7, name:GPIO7
8 = deviceType: gpio.GPIOPin, pinNumber:8, name:GPIO8
9 = deviceType: gpio.GPIOPin, pinNumber:9, name:GPIO9
10 = deviceType: gpio.GPIOPin, pinNumber:10, name:GPIO10
11 = deviceType: gpio.GPIOPin, pinNumber:11, name:GPIO11
12 = deviceType: gpio.GPIOPin, pinNumber:12, name:GPIO12
13 = deviceType: gpio.GPIOPin, pinNumber:13, name:GPIO13
14 = deviceType: gpio.GPIOPin, pinNumber:14, name:GPIO14
15 = deviceType: gpio.GPIOPin, pinNumber:14, name:GPIO15
16 = deviceType: gpio.GPIOPin, pinNumber:16, name:GPIO16
17 = deviceType: gpio.GPIOPin, pinNumber:17, name:GPIO17
18 = deviceType: gpio.GPIOPin, pinNumber:18, name:GPIO18
19 = deviceType: gpio.GPIOPin, pinNumber:19, name:GPIO19
20 = deviceType: gpio.GPIOPin, pinNumber:20, name:GPIO20
21 = deviceType: gpio.GPIOPin, pinNumber:21, name:GPIO21
22 = deviceType: gpio.GPIOPin, pinNumber:22, name:GPIO22
23 = deviceType: gpio.GPIOPin, pinNumber:23, name:GPIO23
24 = deviceType: gpio.GPIOPin, pinNumber:24, name:GPIO24
25 = deviceType: gpio.GPIOPin, pinNumber:25, name:GPIO25
26 = deviceType: gpio.GPIOPin, pinNumber:26, name:GPIO26
27 = deviceType: gpio.GPIOPin, pinNumber:27, name:GPIO27

gpio.GPIOPin = initValue:0, deviceNumber:0, direction:3, mode:-1, trigger:3
uart.UART = baudRate:19200, parity:0, dataBits:8, stopBits:1, flowControl:0

Reboot the Raspberry Pi with:
```
sudo reboot
```
Kura starts on the target platform after reboot.
Kura setups a local web ui that is available using a browser via:
```
https://<device-ip>
```
The browser will prompt the user to accept the connection to an endpoint with a self signed certificate, select Accept the risk and continue:

Once trusted the source, the user will be redirected to a login page where the following credentianls: username: admin password: admin