Heimdall - Flashage en mode Download Samsung

Dernière mise à jour : Debian 10.10

Heimdall est un logiciel de flashage compatible avec le mode "Download" des périphériques Android Samsung (Tablettes, téléphones portables, ...). Les principaux usages sont

installer un nouveau Recovery, par exemple TWRP
réinstaller une ou plusieurs partitions de la ROM d'origine

Références :

Sommaire

1 - Installation

Heimdall peut-être utilisée

en ligne de commande, paquet heimdall-flash
et en interface graphique, paquet heimdall-frontend

Dans ce qui suit, on installe la version en ligne de commande, disponible dans les dépôts Debian.

La version disponible dans les dépôts Debian est 1.4.1

$ aptitude versions heimdall-flash
i   1.4.1-2+b1                                    stable                    500

Installer Heimdall version ligne de commande et optionnellement version avec interface graphique

$ sudo aptitude install heimdall-flash heimdall-frontend

Par précaution, redémarrer le PC afin que les nouvelles règles udev installées par Heimdall soient prises en compte.

La documentation est disponible via un fichier README

$ zless /usr/share/doc/heimdall-flash/README.gz

La liste des commandes est affichée avec

$ heimdall -h

2 - Principe d'utilisation

2.1 - Connexion et détection du périphérique

Prévoir de préférence l'utilisation du cordon USB d'origine (Samsung) pour raccorder le périphérique Android au PC
Raccorder le cordon au PC
Charger le périphérique à 100%
Démarrer le périphérique en mode Download sans le raccorder au PC
Un avertissement s'affiche, confirmer le passage au mode Download
Connecter le cordon USB sur le périphérique
Vérifier que le périphérique est reconnu

$ heimdall detect
Device detected

Vérifier que le fonctionnement est correct

$ heimdall print-pit

Après avoir affiché la table de partition (voir ci-dessous), le périphérique doit redémarrer automatiquement.

En cas d'échec, essayer de

Changer de cordon USB
Utiliser un cordon plus court, plus gros
Changer de prise USB sur le PC - En particulier prise USB2 à la place de prise USB3 (ou vice-versa)
Vérifier que le périphérique est correctement chargé
Utiliser la dernière version de Heimdall : voir Installation de heimdall à partir des sources

Plus d'informations peuvent être obtenues avec

$ heimdall print-pit --verbose

A noter : si la commande a échoué, il est inutile de la repasser plusieurs fois, redémarrer et recommencer

2.2 - Commandes successibles

Par défaut, les commandes heimdall ouvrant une session avec le périphérique (heimdall print-pit, heimdall flash, heimdall download-pit ...) se terminent par un redémarrage du périphérique en mode normal (système). Avant un redémarrage éventuel en mode download, ne pas oublier de déconnecter le cordon usb.
Pour éviter que le périphérique ne redémarre automatiquement après les commandes heimdall ouvrant une session,

Dans la première commande, utiliser l'option --no-reboot
Dans les commandes suivantes, utiliser les options --no-reboot --resume, en cas d'oubli de l'option --resume, le périphérique ne redémarrera pas, mais la commande (et les commandes suivantes) seront (silencieusement) pas ou mal exécutées

Exemple : On suppose que le périphérique vient d'être connecté en mode download, la liste de commandes suivantes ne provoquera pas de redémarrage automatique et devrait s'exécuter correctement

$ heimdall detect
$ heimdall print-pit --no-reboot
$ heimdall print-pit --no-reboot --resume
.....

Dans la pratique, la possibilité de passer plusieurs commandes les unes après les autres semble problématique, ce que confirme une recherches sur internet avec "ERROR: libusb error -7 whilst receiving bulk transfer. Retrying..." . Pour contourner le problème, ne pas utiliser l'option --no-reboot et passer les commandes les unes après les autres en effectuant un redémarrage entre chaque commande ...

2.3 - Partitions

Une table de partition est disponible dans le périphérique et peut-être lue par heimdall.
Pour chaque partition, sont indiquées plusieurs paramètres, dont un Identifiant - un Nom de partition - Le Nom du fichier tel qu'il a été défini par le constructeur

Pour afficher la table de partition du périphérique

$ heimdall print-pit --no-reboot
......
--- Entry #20 ---
Binary Type: 0 (AP)les
Device Type: 2 (MMC)
Identifier: 19
Attributes: 5 (Read/Write)
Update Attributes: 1 (FOTA)
Partition Block Size/Offset: 491520
Partition Block Count: 32768
File Offset (Obsolete): 0
File Size (Obsolete): 0
Partition Name: Kernel2
Flash Filename: recovery.img
FOTA Filename: 
....

Pour conserver une copie de la table partitionnement dans un format binaire, propre à heimdall, extension .pit

$ heimdall download-pit  --output Part.pit

Pour afficher la table de partition enregistrée dans un fichier au format .pit

$ heimdall print-pit --file Part.pit

2.4 - Flashage

Le flashage d'une partition s'effectue en indiquant

l'identifiant de la partition ou son nom
le fichier à flasher

Exemple de flashage de la partition de récupération 19 de nom Kernel2

à partir du nom de la partition Kernel2

$ heimdall flash --Kernel2 GT-I8190_TWRP_3.1.1-1.img.img

à partir de l'identifiant 19

$ heimdall flash --19 GT-I8190_TWRP_3.1.1-1.img

Pour flasher plusieurs partitions, indiquer à la suite les couples Identifiants de partition et Noms de fichiers, par exemple

$ heimdall flash 
--STEboot1 STE_boot1.img \
--STEboot2 STE_boot2.img \
--Modem modem.bin \
--Kernel boot.img \
--Kernel2 recovery.img \
--SYSTEM system.img \
--CACHEFS cache.img \
--HIDDEN hidden.img \

3 - Exemple - Installation de TWRP

TWRP fournit des fichiers de flashage de la partition de recovery pour un grand nombre de périphériques Android : voir https://twrp.me/Devices/
Télécharger et désarchiver le fichier téléchargé jusqu'à obtenir le fichier au format .img, par exemple twrp-3.5.2_9-0-a5y17lte.img

Rechercher le nom de la partition de recovery dans la table de partition, à partir du nom du fichier, généralement recovery.img

exemple 1: le nom de la partition est RECOVERY

$ heimdall print-pit |grep -B2 recovery.img
Partition Name: RECOVERY
Flash Filename: recovery.img

exemple 2 : le nom de la partition est Kernel2

$ heimdall print-pit |grep -B2 recovery.img
Partition Name: Kernel2
Flash Filename: recovery.img

Flasher la partition

dans le premier cas

$ heimdall flash RECOVEY twrp-3.5.2_9-0-a5y17lte.img

dans le second cas

$ heimdall flash Kernel2 twrp-3.5.2_9-0-a5y17lte.img

4 - Exemple - Reflashage de la partition de boot

Télécharger le fichier ROM, ROM originale ou ROM OEM (telle que LineageOS) et la désarchiver jusqu'à faire apparaître le fichier image de la partition de boot, généralement appelé boot.img.
Rechercher le nom de la partition associée au fichier boot.img dans la table de partition

$ heimdall print-pit --file Part.pit |grep -B1 boot.img
Partition Name: BOOT
Flash Filename: boot.img

Flasher la partition

$ heimdall flash BOOT boot.img

5 - Exemple - Réinstallation ROM fabricant

5.1 - Télécharger la ROM

On prend l'exemple d'une ROM fabricant SAMSUNG. Celle-ci peut généralement être téléchargée, gratuitement, après inscription, sur l'un des suites suivants

Afin d'identifier de façon sûre la référence de la ROM, utiliser par exemple une application telle DevCheck (gratuite sans publicité) ou Phone INFO ou Phone INFO * SAMSUG (gratuite avec publicités). Récupérer les informations

du périphérique

Nom modèle           SM-A520F
Nom appareil            a5y17lte

du firmware bootloader (BL)
du firmware radio (aussi appelé Radio ou Bande de base ou CP) (ici la version géographique du modem est indiquée par les lettres XX = Europe)
du code CSC (Consumer Software Customization) (Version géographique et langue du produit), XXF pour la France

Version du bootloader           A520FXXUBCSG1
Version de radio            A520FXXUBCSG1
Code CSC                       XXF

Le code CSC peut-être éventuellement choisi différent du code initial : voir https://www.droidviews.com/how-to-change-csc-in-samsung-galaxy-phones/

5.2 - Flasher la ROM

Désarchiver le fichier fournit jusqu'à obtenir les fichiers .img et .bin
Importer la table de partition ou utiliser la table de partition fournie et faire correspondre automatiquement, les partitions et les fichiers : Crédit : https://forum.xda-developers.com/wiki/Heimdall

$ heimdall print-pit --file A5Y17LTE_EUR_OPEN_HIDDEN200M.pit |grep 'Partition Name:\|Flash Filename:' |perl -pe 's/Partition Name: (.*?)\n/--\1 /' |perl -pe 's/(.*?Flash Filename: \n)|(Flash Filename: )//' |perl -pe 's/\n/ \\\n/'
--BOOTLOADER sboot.bin \
--CM cm.bin \
--ECT ect.bin \
--PIT - \
--MD5HDR md5.img \
--BOTA0 - \
--BOTA1 - \
--EFS efs.img \
........

En déduire le flashage des fichiers disponibles

$ sudo heimdall flash 
--BOOTLOADER sboot.bin \
--CM cm.bin \
--PARAM param.bin \
--BOOT boot.img \
--RECOVERY recovery.img \
--RADIO modem.bin \
--SYSTEM system.img \
--CACHE cache.img \
--HIDDEN hidden.img \