Project

General

Profile

Actions

RecoveryInstallationWithHeimdall » History » Revision 53

« Previous | Revision 53/86 (diff) | Next »
Denis 'GNUtoo' Carikli, 04/23/2019 10:08 PM
Split the big command table as the right column is hardly visible on lower resolution screens


Recovery installation or update trough Heimdall

Warning

Theses new instructions are experimental and have not been tested yet on all the supported devices mentioned below.

Prerequisites

This guide applies only to the following devices:
  • Galaxy S 2 (I9100)
  • Galaxy S 3 (I9300)
  • Galaxy S 3 4G (I9305)
  • Galaxy Nexus (I9250)
  • Galaxy Note (N7000)
  • Galaxy Note 2 (N7100)
  • Galaxy Tab 2 7.0 (P3100)
  • Galaxy Tab 2 7.0 Wi-Fi (P3110)
  • Galaxy Tab 2 10.1 (P5100)
  • Galaxy Tab 2 10.1 Wi-Fi (P5110)
  • Galaxy Note 8.0 (N5100)
  • Galaxy Note 8.0 Wi-Fi (N5110)

Using the instructions of this page with a device not listed above can break it, up to the point where it is too long, complicated and expensive to repair, even for technical people.

In order to install the Replicant recovery on your device, it is assumed that you have a computer running a GNU/Linux operating system and everything necessary to connect your device to the computer through USB. Moreover, it is assumed that anyone performing the installation knows how to use the command line in a terminal and has basic knowledge about it.

Downloading the files

The first step in the installation process is to download and set up the files that will be used to install Replicant to the device. The files must be downloaded on your computer first.

1. First find the recovery latest image for your device in ReplicantImages. For instance for a Galaxy S2, the table will have

Galaxy S 2 (I9100)
in the device column.
2. Then identify the recovery file and its corresponding signature file:
The recovery file will look like that:
recovery-<yourdevice>.img

And the its corresponding signature file will look like that:
recovery-<yourdevice>.img.asc

For instance for the Samsung Galaxy S2, the file will be named like that:
  • recovery-i9100.img
  • recovery-i9100.img.asc

3. Download the latest recovery file and its corresponding signature file for your device on ReplicantImages.
4. Make sure you have added the Replicant release key to your GPG keyring

Check the signature of the recovery

1. From the command line, go inside the directory that has the downloaded files:
The emplacement where the files are downloaded might be different for you.
If it is the case, adjust the command below accordingly:

cd "${HOME}/Downloads/" 

2. Then check the signature of the recovery (and don't forget to sure to substitute "<yourdevice>" with the actual device name):

gpg --verify recovery-<yourdevice>.img.asc

Make sure the check succeeds, do not continue the recovery installation if it doesn't!

If the check fails, it might be because the download is corrupted or because you downloaded a compromised file.

Installing heimdall

The heimdall tool is required to flash the recovery image to the device.
Instructions to install heimdall: ToolsInstallation

Preparing the device

The next step in the installation process is to prepare the device for heimdall mode.

1. Make sure the device is completely turned off and the USB cable is disconnected from the device
2. Remove the device's external case or protection if it has one.

If your smartphone is the Galaxy Nexus (I9250):
3. Start the device by holding the following key combination: Volume down, Power.
4. Hold the key combination until the device shows a green "Start".

For all other devices:
3. Start the device by holding the following key combination: Volume down, Select, Power,
4. Hold the key combination until the device shows a Warning message.
5. Confirm that you want to download a custom OS using volume up
6. Make sure the device is in Downloading mode

You can then connect the USB cable to both the computer and the device

Installing the images

Now that both the computer and the device are set up, it is time to actually install the images to the device.

From the command line, return inside the directory that has the downloaded files:
The emplacement where the files are downloaded might be different for you.
If it is the case, adjust the command below accordingly:

cd "${HOME}/Downloads/" 

You can now use the next sections to install or upgrade the recovery.

Upgrading the recovery:

If you only want to update the recovery, without updating or installing Replicant, use the commands in the this section. This will make sure that your Replicant installation is not modified.

If instead you are installing Replicant for the first time use the commands in the Installing the recovery section below.

If your smartphone is the Galaxy Nexus (I9250) you can use the following command to update the recovery:

heimdall flash --recovery path/to/recovery-<yourdevice>.img

For all other devices you can use the following command to update the recovery:

heimdall flash --RECOVERY path/to/recovery-<yourdevice>.img

Installing the recovery:

When installing or upgrading Replicant, use the commands in the table below. This will make sure that the device is rebooted right into the recovery. It does that by also installing the recovery in the boot partition.

If instead you only want to upgrade an existing recovery use the commands in the Upgrading the recovery section above.

Once in the recovery you can then proceed to the installation or upgrade of Replicant with the MinorVersionUpgrade instructions.

Devices Command for installing the recovery
Galaxy Nexus (I9250)
heimdall flash --boot path/to/recovery-<yourdevice>.img --recovery path/to/recovery-<yourdevice>.img
Galaxy S 3 (I9300)
heimdall flash --BOOT path/to/recovery-<yourdevice>.img --RECOVERY path/to/recovery-<yourdevice>.img
Galaxy S 3 4G (I9305)
Galaxy Note 2 (N7100)
Galaxy Note 8.0 (N5100)
Galaxy Note 8.0 Wi-Fi (N5110)
Galaxy S 2 (I9100)
heimdall flash --KERNEL path/to/recovery-<yourdevice>.img --RECOVERY path/to/recovery-<yourdevice>.img
Galaxy Note (N7000)
Galaxy Tab 2 7.0 (P3100)
Galaxy Tab 2 7.0 Wi-Fi (P3110)
Galaxy Tab 2 10.1 (P5100)
Galaxy Tab 2 10.1 Wi-Fi (P5110)

Troubleshooting

Making sure that the device is connected in download mode

You can run the following command to verify if the device is in download mode:

lsusb

If it is you will then have one line that will be somewhat similar to that one:

Bus 004 Device 002: ID 04e8:685d Samsung Electronics Co., Ltd GT-I9100 Phone [Galaxy S II] (Download mode)

Heimdall failing with "ERROR: Protocol initialisation failed!"

It is pretty easy to end up with heimdall failling like that:

Heimdall v1.4.2

Copyright (c) 2010-2017 Benjamin Dobell, Glass Echidna
http://www.glassechidna.com.au/

This software is provided free of charge. Copying and redistribution is
encouraged.

If you appreciate this software and you would like to support future
development please consider donating:
http://www.glassechidna.com.au/donate/

Initialising connection...
Detecting device...
Claiming interface...
Setting up interface...

Initialising protocol...
ERROR: Protocol initialisation failed!

Releasing device interface...

In that case disconnect and reconnect the USB cable from the computer and try again.

Updated by Denis 'GNUtoo' Carikli almost 5 years ago · 53 revisions

Also available in: PDF HTML TXT