Ubuntu touch install

5/27/2018 Ubuntu touch install

1/57

Immutable Page Info

Attachments

More Actions:

Ubuntu Wiki Login Help
https://wiki.ubuntu.com/Homehttps://wiki.ubuntu.com/Touch/Install?action=loginhttps://wiki.ubuntu.com/HelpContentshttps://wiki.ubuntu.com/HelpContentshttps://wiki.ubuntu.com/Touch/Install?action=loginhttps://wiki.ubuntu.com/Homehttps://wiki.ubuntu.com/Touch/Install?action=AttachFilehttps://wiki.ubuntu.com/Touch/Install?action=info


2/57

Install

Ubuntu

Touch

Developer

Preview

Install

Get

started

here!

Get

involved!

Translate

FAQ

Release

Notes

SDKFeature

Status

Core

apps

Devices

Porting

Guide

Build

from

source

Deployi

Test

Spec
https://wiki.ubuntu.com/Touch/Specshttps://wiki.ubuntu.com/Touch/Testinghttps://wiki.ubuntu.com/Touch/Deployinghttps://wiki.ubuntu.com/Touch/Buildinghttps://wiki.ubuntu.com/Touch/Portinghttps://wiki.ubuntu.com/Touch/Deviceshttps://wiki.ubuntu.com/Touch/CoreAppshttps://wiki.ubuntu.com/Touch/SdkFeatureStatushttps://wiki.ubuntu.com/Touch/ReleaseNoteshttps://wiki.ubuntu.com/Touch/FAQhttps://wiki.ubuntu.com/Translations/Phonehttps://wiki.ubuntu.com/Touch/Contributehttps://wiki.ubuntu.com/Touch


3/57

Contents

1. Instructions forflashing a phone or

tablet device withUbuntu

Instructions for

flashing a phone or

tablet device withUbuntu
https://wiki.ubuntu.com/Touch/Install#Instructions_for_flashing_a_phone_or_tablet_device_with_Ubuntu


4/57

1. Disclaimer

2. What to expectafter flashing

2. Supported devices

and codenames

3. Community support

devices4. Flashing the device

1. Step 1 -Desktop Setup

1. Set up theTouch

DeveloperPreview
https://wiki.ubuntu.com/Touch/Install#Set_up_the_Touch_Developer_Preview_Tools_PPAhttps://wiki.ubuntu.com/Touch/Install#Step_1_-_Desktop_Setuphttps://wiki.ubuntu.com/Touch/Install#Flashing_the_devicehttps://wiki.ubuntu.com/Touch/Install#Community_support_deviceshttps://wiki.ubuntu.com/Touch/Install#Supported_devices_and_codenameshttps://wiki.ubuntu.com/Touch/Install#What_to_expect_after_flashinghttps://wiki.ubuntu.com/Touch/Install#Disclaimer


5/57

Tools

PPA

2. Step 1.5 -

Optional

Android

Backup

3. Step 2 - Deviceunlock

1. Devicefactory

reset4. Step 3 - Initial

Device Setup5. Step 4 -
https://wiki.ubuntu.com/Touch/Install#Step_4_-_Downloading_.26_Deploying_Image_to_Devicehttps://wiki.ubuntu.com/Touch/Install#Step_3_-_Initial_Device_Setuphttps://wiki.ubuntu.com/Touch/Install#Device_factory_resethttps://wiki.ubuntu.com/Touch/Install#Step_2_-_Device_unlockhttps://wiki.ubuntu.com/Touch/Install#Step_1.5_-_Optional_Android_Backup


6/57

Downloading

& Deploying

Image to

Device

1. Further

Examples

5. Restoring Android6. Manual Download

& Installation7. Check version after

install8. Need help?
https://wiki.ubuntu.com/Touch/Install#Need_help.3Fhttps://wiki.ubuntu.com/Touch/Install#Check_version_after_installhttps://wiki.ubuntu.com/Touch/Install#Manual_Download_.26_Installationhttps://wiki.ubuntu.com/Touch/Install#Restoring_Androidhttps://wiki.ubuntu.com/Touch/Install#Further_Examples


7/57

The Ubuntu Touch DeveloperPreview is intended to be used for

development and evaluationpurposes only. It is an

experimental developmentsnapshot that can potentially


8/57

brick your device. It does notprovide all of the features andservices of a retail phone andcannot replace your current handset.

This preview is the first release ofa very new and unfinished version

of Ubuntu and it will evolvequickly.

This process will delete all data

from the device. Restoring

Android will not restore this data.


9/57

Disclaimer

"Touch Developer Preview forUbuntu" is released for free non-

commercial use. It is providedwithout warranty, even the implied

warranty of merchantability,satisfaction or fitness for a

articular use. See the licenceincluded with each program fordetails.

Some licences may grant

additional rights; this notice shallnot limit your rights under each


10/57

rogram's licence. Licences foreach program are available in theusr/share/doc directory. Sourcecode for Ubuntu can be

downloaded fromarchive.ubuntu.com. Ubuntu, the

Ubuntu logo and Canonical areregistered trademarks of

Canonical Ltd. All othertrademarks are the property oftheir respective owners.

"Touch Preview for Ubuntu" is

released for limited use due to theinclusion of binary hardware


11/57

support files. The originalcomponents and licenses can befound at:

https://developers.google.com/andr
https://developers.google.com/android/nexus/drivers


12/57

What to expect after

flashingFor detailed information check the

release notes

1. Shell and core applications2. Connection to the GSM

network (on Galaxy Nexus andNexus 4)

3. Phone calls and SMS (on

Galaxy Nexus and Nexus 4)

4. Networking via Wifi

5. Functional camera (front and

back)
https://wiki.ubuntu.com/Touch/ReleaseNotes


13/57

6. Device accessible through the

Android Developer Bridge

tool (adb)


14/57

Supported devices

and codenames

The table below lists the supporteddevices and their corresponding

factory images, should you want toswitch back to Android. The images

can be found here.

Device Codename

Factoryfirmware

fromGoogle
https://developers.google.com/android/nexus/images


15/57

Nexus

4 mako occam

Nexus

10manta mantaray

Nexus

7 2013WiFi

flo flo or flo

Galaxy

Nexusmaguro

takju or

yakju

N k i
https://developers.google.com/android/nexus/images#yakjuhttps://developers.google.com/android/nexus/images#takjuhttps://developers.google.com/android/nexus/imageshttps://developers.google.com/android/nexus/imageshttps://wiki.ubuntu.com/WiFihttps://developers.google.com/android/nexus/images#mantarayhttps://developers.google.com/android/nexus/images#occamhttps://developers.google.com/android/nexus/images#nakasi


16/57

Nexus

7

grouper nakasi or

nakasig

Latest status can be found here

i
https://docs.google.com/a/canonical.com/spreadsheet/ccc?key=0ArLs7UPtu-hJdDZDNWliMmV1YUJ3Zk1pQlpDdGp4VFE&usp=sharing#gid=0https://developers.google.com/android/nexus/images#nakasighttps://developers.google.com/android/nexus/images#nakasi


17/57

Community support

devices

Whilst Canonical provides imagesfor the above Nexus devices, other

devices may be supported. They arelisted on the Devices wiki page.

Fl hi h d i
https://wiki.ubuntu.com/Touch/Devices


18/57

Flashing the device

St 1 D kt S t


19/57

Step 1 - Desktop Setup

The following steps are required onyour desktop system that you'll need

in order to flash and communicatewith the device.

Set up the Touch DeveloperPreview Tools PPA

The PPA has the tools and

dependencies to support Precise,Quantal, Raring and Saucy. Add the

Ubuntu Touch PPA by adding thefollowing custom source list entry

to your / t / t/ li t file


20/57

to your /etc/apt/sources.listfile.

On your computer, pressCtrl+Alt+T to start a terminal.

sudo add-apt-repository ppa:phablet-team

On Ubuntu 12.04, you will alsoneed to run:

sudo add-apt-repository ppa:ubuntu-sdk-t

Then do the following:sudo apt-get update

sudo apt-get install ubuntu-device-flash

Note: This requires that you have


21/57

Note: This requires that you haveUniverse repository enabled.

Step 1 5 Optional Android
https://help.ubuntu.com/community/Repositories/CommandLine#Adding_the_Universe_and_Multiverse_Repositories


22/57

Step 1.5 - Optional Android

BackupIf not enabled, enable

developer mode, by tappingSettings -> About phone ->

Build number (x 7 times)

If not enabled, enable usbdebugging in Settings ->

Developer options -> USB

debugging

Execute on your computer $adb backup -apk -shared -all

This should hopefully create


23/57

This should hopefully createbackup.ab with all of your apps,OS, and data. Later, after reflashingwith android (or rooting /

unlocking) you will be able to use $adb restore backup.ab to restore all

of your data.

Step 2 Device unlock


24/57

Step 2 - Device unlock

If the device is already unlocked,skip to Step 3. These steps will

wipe all personal data from thedevice.

1. With the device powered off,

power on the device by

holding the Power button +

volume up + volume down.

2. The device will boot into thebootloader.

3. Plug the device into thecomputer via the USB cable.

4 On your computer press


25/57

4. On your computer, press

Ctrl+Alt+T to start a terminal.

Type sudo fastboot oem unlock,

followed by Enter

5. On the device screen, accept

the terms of unlocking.6. Boot the device by pressing

the power button (pointed byan arrow with Start on the

screen).

Device factory reset

If you get stuck in a bootloop

rebooting the tablet after unlocking


26/57

rebooting the tablet after unlockingthe bootloader... Here's what youdo:

1. During the bootloop.. hold thepower button + volume up +

volume down buttonsimultaneously to get yourself

back into fastboot mode as youwere previously.

2. In fastboot mode.. use the

volume keys to scroll to

Recovery and the power butto

to select it.3. In Recovery (Android robot on

his back with a red triangle)


27/57

his back with a red triangle)...

tap the volume up button and

the power button

simultaneously which will

bring you into stock recovery.Again.. Don't hold the buttons,

just tap them simultaneously.Also make sure you're holding

the correct volume button. Upwill be the volume key on the

right.4. Once you're in Recovery..

perform a factory reset/data

wipe and then reboot your

tablet... you should now be


28/57

tablet... you should now be

back to the Welcome Screen.

Step 3 - Initial Device Setup


29/57

Step 3 Initial Device Setup

Follow these initial steps on yourdevice:

1. If not booted, boot the device

into Android2. Enable USB debugging on the

device

on Ice Cream Sandwich

(version 4.0) go toSettings and turn on USB

Debugging (Settings >System > Developer

options > USB


30/57

p

debugging).

on Jelly Bean (versions

4.1 and 4.2) you need toenter Settings, About

[Phone|Tablet] and tap the

Build number 7 times to

see the Developer

Options.

on 4.2.2, (settings > about> tap on build number 7

times to activate thedeveloper options menu

item).


31/57

)

On either Androidversion you must then

enable USB debuggingvia Settings > Developer

options > USB debugging.You will also need to

accept a host key on thedevice.

On the workstation-> adb kill-server;

adb start-server

3. Plug the device into the


32/57

g

computer via the USB cable.

Depending on the

installed Android

version, a popup willshow up on the device

with the host key thatneeds to be accepted for

the device tocommunicate with the

workstation.Note, 'adb devices'

should not show thedevice as 'offline'. If it

does, unplug the device,


33/57

run adb under sudo on the

workstation (sudo adb

kill-server; sudo adb

start-server), then plugthe device back in.

In some cases, the device

will continue to showoffline, and the host key

popup will not appear if

the USB connection

method is 'MTP' (default

for some devices and

versions of Android).


34/57

Unchecking all options in

the USB connection

method (Settings ->

Storage -> Menu -> USBcomputer connection ->

MTP, PTP) seems toresolve this adb

connection issue for someusers.

4. Save the version of the current

image on the device, if on

Android, to use as a reference

to revert back to. The version


35/57

can be found by going to

Settings > About Phone >

Build Number.

Newer Nexus 10s have not booted

fully after developer mode wasenabled. If this occurs boot into thebootloader and do "fastboot -w",then proceed to the next step.

Step 4 - Downloading &


36/57

p g

Deploying Image to DeviceTo install the Ubuntu Touch

Developer Preview on your device,you will need to execute the

command below. Please note, thiswill wipe the contents of the device

so ensure you have made a back-up.To install and get updates, you willhave to run ubuntu-device-flash

with a command and some flags;see ubuntu-device-flash --helpfor a list

of commands man ubuntu-device-flashfor additional usage information.

To bootstrap on the develchannel or


37/57

reinstall afresh (wiping everything)

the recommended command is to berun from the bootloader:

ubuntu-device-flash --channel=devel -

This step can take a very longtime. Bootstrap requires the

device is in the bootloader - adbreboot bootloader

Note that there are other channelsavailable, to see them, run:

ubuntu-device-flash --list-channels

This will deploy the latest build


38/57

onto your device. Your device

should reboot into the Ubuntu Unityshell.

Notes:

Be patient- some steps (like

pushing the files) take time.

Pogress is normally shown inthe terminal. Some screens on

the device seem to requireinput, but they actually don't:

Just wait.However, Nexus 10 may

prompt "ROM may flash


39/57

stock recovery on boot.

Fix?". Here it seems you

have to select "+++Go

back+++" on the tabletscreen (using tablet

buttons).

The files are saved in~/.cache/ubuntuimages.

If the deploy fails(ex boots toblack screen), try wiping the

/data partition on your deviceand redeploy

ubuntu-device-flashwill not


40/57

work unless you have booted

your device (it must not be

displaying the boot loader

screen and "adb devices" shouldlist your device).

if you get stuck at ' < waiting

for device > ' and your phabletreboots into android, you may

have to run ubuntu-device-

flash under sudo

Further Examples

Running bleeding edge / untestedi hil k i d t


41/57

images while keeping user data:

ubuntu-device-flash --channel=devel-

Re-flash with a clean start,removing all apps and data:

ubuntu-device-flash --wipe

If you have a nexus 7 3G, pass -d grouperwhile booted into the

bootloader: ubuntu-device-flash --bootstrap --de

You can make your device read-

write (a "sytem image developerd ") t ll diti t fil


42/57

mode") to allow editing system files

directly. Doing this will stop yourdevice from being updated, and is

not recommended unless you'redeveloping Ubuntu itself.

phablet-config writable-image adb reboot

If you have a device which isalready flashed and you've made it

read-write as above ("developermode"), but now want to re-enable

OTA updates (go back to read-only):

adb shell rm /userdata/.writable_imag adb shell system-image-cli --build 0


43/57

If you have a device which isalready flashed and you've made it

read-write, and want to update itand keep your data and retain read-

write mode adb shell system-image-cli --build 0

Switch from Saucy to Trusty

adb shell system-image-cli --channel

or ubuntu-device-flash --channel=trusty

If you want to install other version,you can do


44/57

you can do

ubuntu-device-flash --channel=saucy -

Restoring Android


45/57

g

The Ubuntu Touch Preview imageis not for everyone and may not suityour current needs (yet). Theimages can be found here. If you

wish to roll back to an Androidfactory image, follow these steps:

1. Recall the version that was

installed before flashing.

2. Download the factory image

corresponding to your device's

model and version (initial

table has links).

3 Ensure the device is connected
https://developers.google.com/android/nexus/images


46/57

3. Ensure the device is connected

and powered on.4. Extract the downloaded file

and cd into the extracteddirectory.

5. run adb reboot-bootloader

6. run ./flash-all.sh(use sudoif

lack of permissions on the

workstation don't allow you totalk to the device).

If you want to lock the bootloader

after restoring the factory image,follow these steps:


47/57

follow these steps:

1. Power on the device by

holding the Power button +volume up + volume down.

2. The device will boot into thebootloader.

3. Plug the device into the

computer via the USB cable.

4. On your computer, pressCtrl+Alt+T to start a terminal.

Type sudo fastboot oem lock,followed by Enter

Your device should boot intoAndroid after the process is


48/57

Android after the process is

finished.

Manual Download &


49/57

Installation

Get the hardware specific zipand img files for your device

from the Ubuntu cdimageserver here, i.e. for a Nexus7

this is trusty-preinstalled-touch-armel+grouper.zip

* Install the bootloader, recoveryand system images using the android

fastboottool

adb reboot fastbootfastboot flash recovery trusty-preinstalfastboot flash boot trusty-preinstalled-
http://cdimage.ubuntu.com/ubuntu-touch/daily-preinstalled/current/


50/57

y p

fastboot flash system trusty-preinstalled

Boot your device into recovery

mode

adb reboot -f recovery

Copy the zip file to the

/sdcard/ directory naming it"autodeploy.zip" on the device

using adb

adb push /path/to/your/downloaded/trusty-

Reboot into recovery mode

(This will install the file you copiedin the previous step)


51/57

in the previous step)


Make sure you are in recoverymode again for the second step

Get the trusty-preinstalled-

touch-armhf.zip file

Copy the zip file to the

/sdcard/ directory naming it

"autodeploy.zip" on the device

using adb

adb push /path/to/your/downloaded/trusty-

Reboot into recovery mode


52/57

(This will install the file you copiedin the previous step)


The device shouldautomatically reboot into the

Ubuntu Touch UI

Check version after


53/57

install

Check the following files to knowwhich version you installed:

Android Side

grep ro.build.date= /system/build.prop

Ubuntu Side

/var/log/installer/media-info (link to /

or run this command:

$ system-image-cli --info


54/57

To see what version an imageupdate would leave you at (withoutactually doing the update):

$ system-image-cli --dry-run

Need help?


55/57

If you got lost somewhere, youfound a bug or need some help,

we're happy to help you. The TouchDeveloper Preview is put together

by a community of many, who areeager to work together with you on

this.

If you've got any troubles orquestions with these installationinstructions, there's a community

willing to help: just ask on AskUbuntu!

You can also:
http://askubuntu.com/questions/ask?tags=mobile


56/57

Join us on IRCin #ubuntu-touch on irc.freenode.net

and/or

Join our mailing listby

1. Joining the ubuntu-phone

team on Launchpad and

2. Enabling the team mailinglist at

https://launchpad.net/~/+e

Touch/Install (last edited 2014-04-07 23:16:52 by popey @ cpc2-
https://launchpad.net/~/+editemailshttps://launchpad.net/~ubuntu-phonehttp://webchat.freenode.net/?channels=ubuntu-touchhttps://launchpad.net/~popey


57/57

y p p y @ p

farn5-2-0-cust103.6-2.cable.virginm.net[213.104.208.10
https://launchpad.net/~popey

Documents

Ubuntu touch install