Difference between revisions of "Ubuntu"

From UpWiki
Jump to: navigation, search
(Install Ubuntu kernel 4.15.0 for UP locally from debian packages on Ubuntu 18.04)
 
(23 intermediate revisions by the same user 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.6''' ISO from the Ubuntu download page (works with desktop and server edition)
 
http://releases.ubuntu.com/16.04/ubuntu-16.04.6-desktop-amd64.iso
 
http://releases.ubuntu.com/16.04/ubuntu-16.04.6-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 on Ubuntu 16.04 ==
+
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 Ubuntu kernel 4.15.0 for UP locally from debian packages on Ubuntu 16.04 ==
 
 
 
Download the next debian packages from our Launchpad site listing the archives inside '''linux-hwe - 4.15.0-37.40~upboard03''':
 
 
 
https://launchpad.net/~ubilinux/+archive/ubuntu/up/+packages
 
 
 
linux-headers-4.15.0-37_4.15.0-37.40~upboard03_all.deb
 
linux-headers-4.15.0-37-generic_4.15.0-37.40~upboard03_amd64.deb
 
linux-image-unsigned-4.15.0-37-generic_4.15.0-37.40~upboard03_amd64.deb
 
linux-modules-4.15.0-37-generic_4.15.0-37.40~upboard03_amd64.deb
 
linux-modules-extra-4.15.0-37-generic_4.15.0-37.40~upboard03_amd64.deb
 
linux-source-4.15.0_4.15.0-37.40~upboard03_all.deb
 
 
 
Then, copy all the .deb files to your USB stick and connect to the USB port in your board.
 
 
 
To install the kernel locally you have to go to the directory where you saved the debian packages. There, just run the dpkg command to install all packages together:
 
sudo dpkg -i *.deb
 
 
 
Once the installation is done successfully, be sure the GRUB is updated to include the newst kernel:
 
sudo update-grub
 
 
 
Finally, reboot your machine and check your new kernel installed:
 
sudo reboot
 
 
 
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 the Ampak firmware for WiFi and Bluetooth locally from debian package on Ubuntu 16.04 ==
 
 
 
Download the next debian package from our Launchpad site listing the archives inside '''firmware-ampak - 1.2.0-0''':
 
 
 
https://launchpad.net/~ubilinux/+archive/ubuntu/up/+packages
 
 
 
firmware-ampak_1.2.0-0_all.deb
 
 
 
Then, copy the .deb file to your USB stick and connect to the USB port in your board.
 
 
 
To install the Ampak firmware locally you have to go to the directory where you saved the debian package. There, just run the dpkg command to install the package:
 
sudo dpkg -i *.deb
 
 
 
Reboot your machine to get the firmware working:
 
sudo reboot
 
 
 
=== WiFi ===
 
 
 
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 the Realtek firmware to enable WiFi with the 5M02.B module on Ubuntu 16.04 ==
 
 
 
 
 
To enable support on Ubuntu for WiFi when using our  [https://up-shop.org/up-peripherals/90-wifi-kit-for-up.html UP WiFi Kit 5M02.B module], please follow the steps available on the readme of our github repository:
 
[https://github.com/AAEONAEU-SW/rtl8812AU_8821AU_linux Add WiFi/BT support for 5M02.B]
 
 
 
== 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, UP Squared, UP Core, UP Core Plus and UP Xtreme  ==
 
=== Prerequisites ===
 
* an UP, UP Squared, UP Core, UP Core Plus or UP Xtreme board
 
* an USB stick with at least 8Gb of space
 
* keyboard, mouse, a screen and an internet connection
 
 
 
=== Installation ===
 
 
 
* Download '''Ubuntu 18.04.3''' ISO from the Ubuntu download page (works with desktop and server edition)
 
http://releases.ubuntu.com/18.04/ubuntu-18.04.3-desktop-amd64.iso
 
http://releases.ubuntu.com/18.04/ubuntu-18.04.3-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 ==
 
This kernel enable support for UP, UP Squared, UP Core and UP Core plus. For UP Xtreme please refer to the steps to [https://wiki.up-community.org/Ubuntu#Install_Ubuntu_kernel_5.0.0_for_UP_Xtreme_only_from_PPA_on_Ubuntu_18.04 install the Kernel 5.0 below].
 
 
 
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:
 
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~upboard04-Ubuntu SMP Thu Feb 14 13:49:37 UTC 2019 x86_64 x86_64 x86_64 GNU/Linux
 
 
 
== Install Ubuntu kernel 5.0.0 for UP Xtreme only from PPA on Ubuntu 18.04 ==
 
To enable support for UP Xtreme, the Kernel 5.0 has been released which includes additional changes required by the Whiskey Lake-U SoC.
 
 
 
After the reboot you need to add our repository:
 
sudo add-apt-repository ppa:aaeonaeu/upboard
 
 
 
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 install linux-generic-hwe-18.04-edge-upboard
 
 
 
Install the updates:
 
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 ...
 
 
 
== Install Ubuntu kernel 4.15.0 for UP locally from debian packages on Ubuntu 18.04 ==
 
The following steps are valid for UP, UP Squared, UP Core and UP Core Plus. For UP Xtreme please refer to the next section.
 
 
 
Download the next debian packages from our Launchpad site listing the archives inside '''linux-hwe - 4.15.0-37.40~upboard04''':
 
 
 
https://launchpad.net/~ubilinux/+archive/ubuntu/up/+packages
 
 
 
linux-headers-4.15.0-37_4.15.0-37.40_upboard04_all.deb
 
linux-headers-4.15.0-37-generic_4.15.0-37.40_upboard04_amd64.deb
 
linux-image-unsigned-4.15.0-37-generic_4.15.0-37.40_upboard04_amd64.deb
 
linux-modules-4.15.0-37-generic_4.15.0-37.40_upboard04_amd64.deb
 
linux-modules-extra-4.15.0-37-generic_4.15.0-37.40_upboard04_amd64.deb
 
  linux-source-4.15.0_4.15.0-37.40_upboard04_all.deb
 
 
 
Then, copy all the .deb files to your USB stick and connect to the USB port in your board.
 
 
 
To install the kernel locally you have to go to the directory where you saved the debian packages. There, just run the dpkg command to install all packages together:
 
sudo dpkg -i *.deb
 
 
 
Once the installation is done successfully, be sure the GRUB is updated to include the newst kernel:
 
sudo update-grub
 
 
 
Finally, reboot your machine and check your new kernel installed:
 
sudo reboot
 
 
 
uname -a
 
Linux upsquared-UP-APL01 4.15.0-37-generic #40~upboard04-Ubuntu SMP Thu Feb 14 13:49:37 UTC 2019 x86_64 x86_64 x86_64 GNU/Linux
 
 
 
 
 
== Install Ubuntu kernel 5.0.0 for UP Xtreme locally from debian packages on Ubuntu 18.04 ==
 
The following steps are valid only for UP Xtreme.
 
 
 
Download the next debian packages from our Launchpad site listing the archives inside '''linux-hwe-edge - 5.0.0-1.2~upboard4''':  
 
 
 
https://launchpad.net/~aaeonaeu/+archive/ubuntu/upboard/+packages
 
 
 
linux-headers-5.0.0-1_5.0.0-1.2~upboard4_all.deb
 
linux-headers-5.0.0-1-generic_5.0.0-1.2~upboard4_amd64.deb
 
linux-image-unsigned-5.0.0-1-generic_5.0.0-1.2~upboard4_amd64.deb
 
linux-modules-5.0.0-1-generic_5.0.0-1.2~upboard4_amd64.deb
 
linux-modules-extra-5.0.0-1-generic_5.0.0-1.2~upboard4_amd64.deb
 
linux-source-5.0.0_5.0.0-1.2~upboard4_all.deb
 
 
 
Then, copy all the .deb files to your USB stick and connect to the USB port in your board.
 
 
 
To install the kernel locally you have to go to the directory where you saved the debian packages. There, just run the dpkg command to install all packages together:
 
sudo dpkg -i *.deb
 
 
 
Once the installation is done successfully, be sure the GRUB is updated to include the newst kernel:
 
sudo update-grub
 
 
 
Finally, reboot your machine and check your new kernel installed:
 
sudo reboot
 
 
 
uname -a
 
Linux...
 
 
 
== Install the Ampak firmware for WiFi and Bluetooth from PPA on Ubuntu 18.04 ==
 
 
 
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 ===
 
 
 
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 the Ampak firmware for WiFi and Bluetooth locally from debian package on Ubuntu 18.04 ==
 
 
 
Download the next debian package from our Launchpad site listing the archives inside '''firmware-ampak - 1.2.1-0''':
 
 
 
https://launchpad.net/~ubilinux/+archive/ubuntu/up/+packages
 
 
 
firmware-ampak_1.2.1-0_all.deb
 
 
 
Then, copy the .deb file to your USB stick and connect to the USB port in your board.
 
 
 
To install the Ampak firmware locally you have to go to the directory where you saved the debian package. There, just run the dpkg command to install the package:
 
sudo dpkg -i *.deb
 
 
 
Reboot your machine to get the firmware working:
 
sudo reboot
 
 
 
=== WiFi ===
 
 
 
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 the Realtek firmware to enable WiFi with the 5M02.B module on Ubuntu 18.04 ==
 
 
 
To enable support on Ubuntu for WiFi when using our [https://up-shop.org/up-peripherals/90-wifi-kit-for-up.html UP WiFi Kit 5M02.B module], please follow the steps available on the readme of our github repository:
 
[https://github.com/AAEONAEU-SW/rtl8812AU_8821AU_linux | Add WiFi/BT support for 5M02.B]
 
 
 
== 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) =

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