Difference between revisions of "Ubuntu"

From UpWiki
Jump to: navigation, search
(Ubuntu 18.04 installation and configuration)
 
(47 intermediate revisions by 2 users not shown)
Line 1: Line 1:
= Ubuntu 16.04 installation and configuration =
 
  
== Install Ubuntu for UP, UP2, UP Core and UP Core Plus  ==
+
= Setup instructions for Ubuntu =  
=== Prerequisites ===
 
* an UP, UP2, UP Core or UP Core Plus board
 
* an USB stick with at least 8Gb of space
 
* keyboard, mouse, a screen and an internet connection
 
  
=== Installation ===
+
Please refer to the following pages for setting up your board with Ubuntu:
* Download '''Ubuntu 16.04.5''' ISO from the Ubuntu download page (works with desktop and server edition)
 
http://releases.ubuntu.com/16.04/ubuntu-16.04.5-desktop-amd64.iso
 
http://releases.ubuntu.com/16.04/ubuntu-16.04.5-server-amd64.iso
 
  
* Burn the downloaded image on a USB stick. We suggest to use etcher for doing that. You can download it from
+
* [[Ubuntu_16.04|Ubuntu 16.04 installation and configuration]]
https://etcher.io
+
* [[Ubuntu_18.04|Ubuntu 18.04 installation and configuration]]
 +
* [[Ubuntu_20.04|Ubuntu 20.04 support is planned for Q3 2020]]
  
* Insert the USB installer disk in a empty USB port and proceed with a normal Ubuntu installation.
+
= Compile your own Kernel for Ubuntu =
** While installing, do not select the option "automatic updates"
 
  
== Install Ubuntu kernel 4.15.0 for UP from PPA ==
+
You can modify and compile your own kernel for UP starting from the source code used by our prebuilt kernel packages.
After the reboot you need to add our repository:
+
Run the following command:
sudo add-apt-repository ppa:ubilinux/up
+
   
 
+
  apt-get source linux-image-$(uname -r)
Update the repository list
+
   
sudo apt update
+
Then follow the steps provided by Canonical: https://wiki.ubuntu.com/Kernel/BuildYourOwnKernel
 
 
Remove all the generic installed kernel
 
sudo apt-get autoremove --purge 'linux-.*generic'
 
 
 
Install our kernel:
 
sudo apt-get install linux-image-generic-hwe-16.04-upboard
 
 
 
Install the updates (please make sure to not upgrade the system to Ubuntu 18.04):
 
sudo apt dist-upgrade -y
 
sudo reboot
 
 
 
Reboot
 
sudo reboot
 
 
 
After the reboot you can verify that the kernel is indeed installed by typing
 
$ uname -a
 
Linux upsquared-UP-APL01 4.15.0-37-generic #40~upboard03-Ubuntu SMP Wed Dec 12 16:21:24 UTC 2018 x86_64 x86_64 x86_64 GNU/Linux
 
 
 
== Install the Ampak firmware for WiFi and Bluetooth ==
 
 
 
This firmware is available for UP Core (AP6214A chipset) and UP Core Plus (AP6355 chipset).
 
 
 
Just run the next command:
 
sudo apt install firmware-ampak
 
 
 
Reboot your machine to get the firmware working:
 
sudo reboot
 
 
 
=== WiFi ===
 
 
 
First at all, you may need to connect a WiFi antenna to your UP Core board [ANT1 connector].
 
 
 
Check the UP Core connectors in https://downloads.up-community.org/download/up-core-connectors-description/.
 
 
 
Scan your available WiFi networks:
 
sudo iwlist wlan0 scan
 
You will see all the WiFi interfaces in your area.
 
 
 
=== Bluetooth ===
 
 
 
Check your Bluetooth devices in your area:
 
hcitool scan
 
 
 
== Install Intel graphic driver ==
 
Follow the instruction on the Intel graphics update tool page
 
https://01.org/linuxgraphics/downloads/update-tool
 
 
 
You can also install Intel graphics firmware from
 
https://01.org/linuxgraphics/downloads/firmware
 
 
 
== Enable the HAT functionality from userspace ==
 
To be able to use the GPIO, PWM, SPI, I2C and uart functionality with a normal user we created a ubuntu package that set the correct permission.
 
 
 
NOTE: this could create security problem, do only if you know what are you doing
 
 
 
After adding our PPA you can install it with:
 
 
 
sudo apt install upboard-extras
 
 
 
after that you need to add the user that need to access the HAT functionality to the corresponding groups:
 
 
 
for example this command permit to the current user to access to the gpio functionality
 
sudo usermod -a -G gpio ${USER}
 
 
 
leds
 
sudo usermod -a -G leds ${USER}
 
 
 
spi
 
sudo usermod -a -G spi ${USER}
 
 
 
i2c
 
sudo usermod -a -G i2c ${USER}
 
 
 
uart
 
sudo usermod -a -G dialout ${USER}
 
 
 
to apply the permission changes after issuing the previous command a reboot is needed
 
sudo reboot
 
 
 
= Ubuntu 18.04 installation and configuration =
 
 
 
== Install Ubuntu for UP, UP2, UP Core and UP Core Plus  ==
 
=== Prerequisites ===
 
* an UP, UP2, UP Core or UP Core Plus board
 
* an USB stick with at least 8Gb of space
 
* keyboard, mouse, a screen and an internet connection
 
 
 
=== Installation ===
 
 
 
* Download '''Ubuntu 18.04.2''' ISO from the Ubuntu download page (works with desktop and server edition)
 
http://releases.ubuntu.com/18.04/ubuntu-18.04.2-desktop-amd64.iso
 
http://releases.ubuntu.com/18.04/ubuntu-18.04.2-live-server-amd64.iso
 
 
 
* Burn the downloaded image on a USB stick. We suggest to use etcher for doing that. You can download it from
 
https://etcher.io
 
 
 
* Insert the USB installer disk in a empty USB port and proceed with a normal Ubuntu installation.
 
** While installing, do not select the option "automatic updates"
 
 
 
== Install Ubuntu kernel 4.15.0 for UP from PPA on Ubuntu 18.04 ==
 
After the reboot you need to add our repository:
 
sudo add-apt-repository ppa:ubilinux/up
 
 
 
Update the repository list
 
sudo apt update
 
 
 
Remove all the generic installed kernel
 
  sudo apt-get autoremove --purge 'linux-.*generic'
 
 
 
Install our kernel:
 
  sudo apt-get install linux-image-generic-hwe-18.04-upboard
 
 
 
Install the updates (please make sure to not upgrade the system to Ubuntu 18.04):
 
sudo apt dist-upgrade -y
 
sudo reboot
 
 
 
Reboot
 
sudo reboot
 
 
 
After the reboot you can verify that the kernel is indeed installed by typing
 
$ uname -a
 
Linux upsquared-UP-APL01 4.15.0-37-generic #40~upboard03-Ubuntu SMP Wed Dec 12 16:21:24 UTC 2018 x86_64 x86_64 x86_64 GNU/Linux
 
 
 
== Install the Ampak firmware for WiFi and Bluetooth ==
 
 
 
This firmware is available for UP Core (AP6214A chipset) and UP Core Plus (AP6355 chipset).
 
 
 
Just run the next command:
 
  sudo apt install firmware-ampak
 
 
 
Reboot your machine to get the firmware working:
 
sudo reboot
 
 
 
=== WiFi ===
 
 
 
First at all, you may need to connect a WiFi antenna to your UP Core board [ANT1 connector].
 
 
 
Check the UP Core connectors in https://downloads.up-community.org/download/up-core-connectors-description/.
 
 
 
Scan your available WiFi networks:
 
sudo iwlist wlan0 scan
 
You will see all the WiFi interfaces in your area.
 
 
 
=== Bluetooth ===
 
 
 
Check your Bluetooth devices in your area:
 
hcitool scan
 
 
 
== Install Intel graphic driver ==
 
Follow the instruction on the Intel graphics update tool page
 
https://01.org/linuxgraphics/downloads/update-tool
 
 
 
You can also install Intel graphics firmware from
 
https://01.org/linuxgraphics/downloads/firmware
 
 
 
== Enable the HAT functionality from userspace ==
 
To be able to use the GPIO, PWM, SPI, I2C and uart functionality with a normal user we created a ubuntu package that set the correct permission.
 
 
 
NOTE: this could create security problem, do only if you know what are you doing
 
 
 
After adding our PPA you can install it with:
 
 
 
sudo apt install upboard-extras
 
 
 
after that you need to add the user that need to access the HAT functionality to the corresponding groups:
 
 
 
for example this command permit to the current user to access to the gpio functionality
 
sudo usermod -a -G gpio ${USER}
 
 
 
leds
 
sudo usermod -a -G leds ${USER}
 
 
 
spi
 
sudo usermod -a -G spi ${USER}
 
 
 
i2c
 
sudo usermod -a -G i2c ${USER}
 
 
 
uart
 
sudo usermod -a -G dialout ${USER}
 
 
 
to apply the permission changes after issuing the previous command a reboot is needed
 
sudo reboot
 
  
 
= Instruction for Legacy Ubuntu Version (only for up board) =
 
= Instruction for Legacy Ubuntu Version (only for up board) =
Line 222: Line 31:
 
= Guides =
 
= Guides =
 
*[[Serial_console#Ubuntu|Enabling the serial console on Ubuntu]]
 
*[[Serial_console#Ubuntu|Enabling the serial console on Ubuntu]]
 +
*[[iTCO_Watchdog#Ubuntu|Enabling the UP2 Watchdog on Ubuntu]]
 
[[Category:Software]]
 
[[Category:Software]]

Latest revision as of 07:47, 2 June 2020

Setup instructions for Ubuntu

Please refer to the following pages for setting up your board with Ubuntu:

Compile your own Kernel for Ubuntu

You can modify and compile your own kernel for UP starting from the source code used by our prebuilt kernel packages. Run the following command:

apt-get source linux-image-$(uname -r)

Then follow the steps provided by Canonical: https://wiki.ubuntu.com/Kernel/BuildYourOwnKernel

Instruction for Legacy Ubuntu Version (only for up board)

Ubuntu 14.04 LTS (Trusty Tahr)

sudo add-apt-repository ppa:ubilinux/up
  • Update the package database:
sudo apt update
  • Install the upboard kernel package
sudo apt install linux-upboard-lts-xenial
  • Remove the other kernel images
sudo apt-get autoremove --purge 'linux-.*generic'

Guides