2/11/2017 UbuntuMATEfortheRaspberryPi2andRaspberryPi3|UbuntuMATE

Ubuntu MATE for the Raspberry Pi 2 and Raspberry Pi3

Martin Wimpress and Rohith Madhavan have made an Ubuntu MATE image for the Raspberry Pi 2 and Raspberry Pi 3 which you can download or buildyourself.

The image is based on the regular Ubuntu armhf base, not the new Snappy Core, which means that the installation procedure for applications is the same as that for
the regular desktop version, ie using aptget . However, since Ubuntu MATE 16.04 snap packages can be installed alongside classic debpackages.
We have done what we can to optimise the build for the Raspberry Pi 2 and Raspberry Pi 3, you can comfortably use applications such as LibreOffice, which in fact is a
joy to use :-) But the microSDHC I/O throughput is a bottleneck so we highly recommend that you use a Class 6 or Class 10 microSDHC card. Ubuntu MATE
16.04 also has fully working Bluetooth and Wifi on the Raspberry Pi3
Youll need a microSD card which is 8GB or greater to fit the image. The file system can be resized to occupy the unallocated space of the microSD card, on Ubuntu
MATE 16.04 this can be done via Ubuntu MATE Welcome.

NOTE! There are no predefined user accounts. The first time you boot one of the desktop images it will run through a setup wizard where you can create your own
user account and configure your regional settings. The first boot is quite slow but, once the first boot configuration is complete, subsequent boots are muchquicker.

Ubuntu MATE 16.04 running on the Raspberry Pi 3.

Download
Run Ubuntu MATE on your Raspberry Pi 2 or 3today.

Download Ubuntu MATE (../download/)

KnownIssues
During first boot configuration Ubiquity does not prompt to join available WiFi networks.
#1572793 (https://bugs.launchpad.net/bugs/1572793)
Upon completion of the first boot setup WiFi doesnt work, at all. Reboot and WiFi will be available.
#1572956 (https://bugs.launchpad.net/bugs/1572956)

Both these issues will be addressed in Ubuntu MATE 16.04.1 for Raspberry Pi 2 and 3 which is due in lateJuly.

Making amicroSDHC
The image can be directly written to a microSDHC using a utility like dd , but we prefer ddrescue (from the gddrescue (apt://gddrescue), forexample:

https://ubuntumate.org/raspberrypi/ 1/4
2/11/2017 UbuntuMATEfortheRaspberryPi2andRaspberryPi3|UbuntuMATE

sudoaptgetinstallgddrescuexzutils
unxzubuntumate16.04desktoparmhfraspberrypi.img.xz
sudoddrescueDforceubuntumate16.04desktoparmhfraspberrypi.img/dev/sdx

The microSDHC may be presented on any /dev/sdX so use the command lsblk tocheck.

Settingupgddrescue(1.192)...
[martin@wimpress~/ISO/ubuntumate]$unxzverboseubuntumate15.10.1desktop
armhfraspberrypi2.img.xz
ubuntumate15.10.1desktoparmhfraspberrypi2.img.xz(1/1)
100%958.3MiB/3,750.0MiB=0.25659MiB/s1:03
[martin@wimpress~/ISO/ubuntumate]$lsblk
NAMEMAJ:MINRMSIZEROTYPEMOUNTPOINT
sda8:001.8T0disk
sda18:10238.4G0part/
sda28:201.6T0part/home
sdb8:16029.8G0disk
sdb18:1701.9G0part/boot
sdb28:18015.3G0part
cryptswap1252:0015.3G0crypt[SWAP]
sdb38:19012.7G0part/tmp
sr011:011024M0rom
[martin@wimpress~/ISO/ubuntumate]$sudoddrescueDforceubuntumate15.10.
1desktoparmhfraspberrypi2.img/dev/sdg
GNUddrescue1.19
PressCtrlCtointerrupt
rescued:2121MB,errsize:0B,currentrate:7864kB/s
ipos:2121MB,errors:0,averagerate:15950kB/s
opos:2121MB,runtime:2.21m,successfulread:0sago
Copyingnontriedblocks...Pass1(forwards)

00:00

Powered by asciinema

If you prefer a graphical tool we recommend using GNOME Disks (apt://gnome-disk-utility) and the Restore Disk Image option, which natively supports XZ
compressed images.

sudoaptgetinstallgnomediskutility

Making a microSDHC withWindows

If you want to make a microSDHC using Windows werecommend:
7-Zip (http://www.7-zip.org/) to extract theimage.
Win32 Disk Imager (http://sourceforge.net/projects/win32diskimager/) to write theimage.

Re-size lesystem
Ubuntu MATE16.04
You can use Ubuntu MATE Welcome to resize to automatically resize the partitions to make full use of your microSHDC card capacity. Simply click the large
Raspberry Pi Information button on the Welcome screen, click the Resize button and then restart the RaspberryPi.
ManualMethod
Its not hard to do manually. Oncebooted:

sudofdisk/dev/mmcblk0

Delete the second partition (d, 2), then re-create it using the defaults (n, p, 2, enter, enter), then write and exit (w). Reboot the system,then:
https://ubuntumate.org/raspberrypi/ 2/4
2/11/2017 UbuntuMATEfortheRaspberryPi2andRaspberryPi3|UbuntuMATE

sudoresize2fs/dev/mmcblk0p2

Enable and DisableX11

We created a simple utility called graphical to disable/enable the MATE desktop environment for easily creating a headless server. Executing
graphicaldisable will present a console login on the next boot, with no X11 or associated services running. If you want to get the full Ubuntu MATE desktop
back, run graphicalenable andreboot.

Hardware accelerated video withomxplayer

Most videos will play with hardware acceleration using omxplayer which is pre-installed in Ubuntu MATE. However if you have MPEG-2 or VC-1 video video files
then you will need MPEG-2 and/or VC-1 licenses from the Raspberry Pi Store (http://www.raspberrypi.com/license-keys/).
Redirecting audiooutput
You can select which audio device omxplayer should output audioto.
ForHDMI

omxplayerohdmivideo.mp4

For 3.5mm audiojack

omxplayerolocalvideo.mp4

The sound will output to HDMI by default if both HDMI and the 3.5mm audio jack are connected. You can, however, force the system to output to a particular device
using amixer .
ForHDMI

sudoamixercsetnumid=32

For 3.5mm audiojack

sudoamixercsetnumid=31

Hardware accelerated video with VLC and mpeg

Ubuntu MATE 16.04 added OpemMAX IL hardware accelerated video playback to VLC and MMAL hardware accelerated video playback toffmpeg.
To enable hardware accelerated video playback in VLC go to Tools -> Preferences -> Video and select OpenMaxIL .
To use hardware accelerated video playback with ffplay you must specify the h264_mmal codec
ffplayvcodech264_mmalvideo.mp4

Hardware accelerated playback on the Raspberry Pi works by overlaying the video directly to the screen. Therefore there are no onscreen controls for playback control.
Youll need to use the VLC and ffmpeg keyboardshortcuts.
VLC keyboardcontrol (https://wiki.videolan.org/Hotkeys_table/)
ffplay keyboardcontrols (https://ffmpeg.org/ffplay.html#toc-While-playing)

Feedback andImprovements
Please post all feedback on the dedicated community forum (https://ubuntu-mate.community/c/support/raspberry-pi-2). If you have any improvements then please
submit a pull request to the Ubuntu Pi Flavour Maker project (https://ubuntu-pi-flavour-maker.org/).

Credits
Rohith Madhavan (http://rohithmadhavan.com) - Made the Ubuntu MATE 15.04 image for the Raspberry Pi2.
Martin Wimpress (https://flexion.org) - Added first boot setup wizard and architectureoptimisations.
Ryan Finnie (http://finnie.org) - Raspberry Pi 2 Kernel, Firmware and video driverpackages.
Sjoerd Simons (http://sjoerd.luon.net) - Made the initial Raspberry Pi 2 kernel patches for DebianJessie.
Sergio Conde (http://omxplayer.sconde.net/) - Maintains omxplayer for the RaspberryPi.
Spindle (https://github.com/RPi-Distro/spindle) - a tool to help spin distributionimages

RecentChanges
2016-04-24 - 16.04 Final Release for Raspbery Pi 2 and Raspberry Pi3
Added OpemMAX IL hardware accelerated video playback to VLC.
To enable hardware accelerated video playback go to Tools -> Preferences -> Video and select OpenMaxIL .
Added MMAL hardware accelerated video playback to ffmpeg.
To use hardware accelerated video playback with ffplay you must specify the h264_mmal codec - ffplayvcodech264_mmalvideo.mp4
Increased the minimum microSDHC card size to8GB.
Removed tboplayer .
2016-04-05 - 16.04 Beta 2 for Raspberry Pi 2 and Raspberry Pi3
Updated to Ubuntu MATE 16.04 including the new Welcome which comes with Raspberry Pi specificfeatures.
Updated BlueZ 5.37 with patches to support the Raspberry Pi 3 integrated Bluetooth.
Ubuntu MATE 16.04 now supports the on-board Raspberry Pi 3 Bluetooth andWifi.

https://ubuntumate.org/raspberrypi/ 3/4
2/11/2017 UbuntuMATEfortheRaspberryPi2andRaspberryPi3|UbuntuMATE
Updated to Linux4.1.19.
Updated to raspberrypifirmware 1.20160315-1.
Updated to omxplayer 0.3.7~git20160206~cb91001.
Updated to wiringpi 2.32.
Updated to nuscratch 20160115.
Updated to sonicpi 2.9.0.
Migrated configuration tweaks to raspberrypigeneralmods and raspberrypisysmods .
Experimental hardware accelerated OpenGL can be enabled, if you know how ;)
PreviousChanges
See what changed in earlierreleases. (../raspberry-pi-change-log/)

Other ARMv7 baseddevices

Wed love to see Ubuntu MATE images other ARMv7 based devices. Please take a look at our generic armhf Ubuntu MATE root file system and buildscripts.
Ubuntu MATE generic rootfs for aarch32 ARMv7devices (https://ubuntu-mate.org/armhf-rootfs)
Ubuntu MATE for Raspberry Pi 2 buildscripts (https://bitbucket.org/ubuntu-mate/ubuntu-mate-armhf)

Reportingissues
Please report any issues you may find on the projects bugtracker.
Ubuntu MATE BugTracker (https://bugs.launchpad.net/ubuntu-mate)

Gettinginvolved
Is there anything you can help with or want to be involved in? Maybe you just want to discuss your experiences or ask the maintainers some questions. Please come and
talk to us (../community/).

References
https://wiki.ubuntu.com/ARM/RaspberryPi (https://wiki.ubuntu.com/ARM/RaspberryPi)
http://omxplayer.sconde.net/ (http://omxplayer.sconde.net/)
https://github.com/bavison/arm-mem/ (https://github.com/bavison/arm-mem/)
https://www.raspberrypi.org/forums/viewtopic.php?t=47832&p=403191 (https://www.raspberrypi.org/forums/viewtopic.php?t=47832&p=403191)
https://www.raspberrypi.org/documentation/configuration/config-txt.md (https://www.raspberrypi.org/documentation/configuration/config-txt.md)
Peter Chubb. SD cards and filesystems for embedded systems.Linux.conf.au.
(http://mirror.linux.org.au/pub/linux.conf.au/2015/Case_Room_2/Friday/SD_Cards_and_filesystems_for_Embedded_Systems.webm)

Ubuntu (http://www.ubuntu.com/) is a trademark of Canonical Ltd (http://www.canonical.com/). ubuntu-mate.org is licensed under a Creative Commons Attribution-ShareAlike 4.0 International
License (http://creativecommons.org/licenses/by-sa/4.0/). Contents 2017 Ubuntu MATE Team.

(https://ubuntu-mate.org/rss.xml) (https://plus.google.com/communities/108331279007926658904) (https://twitter.com/ubuntu_mate)

(https://www.facebook.com/UbuntuMATEedition/)

https://ubuntumate.org/raspberrypi/ 4/4