Mise à jour : TWRP 3.3.1.1
TWRP est un projet "open source" de développement d'un logiciel permettant l'installation de logiciels et ROMs non standards sur les périphériques Android.
Ce document décrit l'installation de TWRP et les différentes interfaces de communication de TWRP.
L'utilisation de TWRP pour
effacer, formater, sauvegarder, restaurer les données et les partitions
installer des ROMs alternatives telles que LineageOS
est décrite dans TWRP - Utilisation
Attention :
L'installation de TWRP supprime généralement la garantie constructeur sur le périphérique
Il est possible d'endommager définitivement son appareil en installant ou utilisant TWRP
Références
Sommaire
https://play.google.com/store/apps/details?id=flar2.devcheck
Dans l'onglet Système, relever le nom de l'Appareil, par exemple gts210velte
$ adb shell
gts210velte:/ $
Rechercher sur le site de TWRP, la dernière version du fichier TWRP correspondant au périphérique de destination et la télécharger la version au format .img. Dans le cas du périphérique gtsve210lte
twrp-3.2.3-0-gts210velte.img
Vérifier que la somme de contrôle MD5 affichée sur le site (b9ef5da993070c83a7d9c66b14d9873a, dans cet exemple) est égal à celle calculée avec le fichier téléchargé
$ md5sum twrp-3.2.3-0-gts210velte.img
b9ef5da993070c83a7d9c66b14d9873a twrp-3.2.3-0-gts210velte.img
Télécharger la clé publique de TeamWin (publi.asc) et l'importer avec la commande
$ gpg --import public.asc
gpg: key 1D8597D7891A43DF: public key "TeamWin <admin@teamw.in>" imported
gpg: Total number processed: 1
gpg: imported: 1
Télécharger la signature PGP du fichier twrp (dans cet exemple gts210velte.img.asc) et vérifier la "non-repudation" :
$ gpg --verify twrp-3.2.3-0-gts210velte.img.asc twrp-3.2.3-0-gts210velte.img
gpg: Signature made mar. 07 août 2018 04:26:52 CEST
gpg: using RSA key 95707D42307C9D41D09BF7091D8597D7891A43DF
gpg: Good signature from "TeamWin <admin@teamw.in>" [unknown]
gpg: WARNING: This key is not certified with a trusted signature!
gpg: There is no indication that the signature belongs to the owner.
Primary key fingerprint: 9570 7D42 307C 9D41 D09B F709 1D85 97D7 891A 43DF
Le message Good signature from .... indique que le fichier a bien pour origine TWRP
Flasher la partition de récupération avec l'image téléchargée, se reporter, selon le type de périphérique à
Redémarrer immédiatement en mode recovery, sans passer par le démarrage standard pour éviter l'écrasement de TWRP qui peut se produire sur certains périphériques. Le menu TWRP s'affiche.
Lorsque TWRP a été installé, pour installer une nouvelle version (au format .img), reflasher la nouvelle version
soit en mode Bootloader ou Download comme indiqué ci-dessus
soit depuis TWRP en utilisant le Menu Installation ou adb shell dd voir ci-dessous (attention le chemin pour la partition de recovery est différent de celui trouvé en mode système)
$ adb root
restarting adbd as root
$ $ adb shell find /dev/block -iname RECOVERY
/dev/block/by-name/RECOVERY
/dev/block/platform/13540000.dwmmc0/by-name/RECOVERY
$ adb shell dd if=recovery.img of=/dev/block/by-name/RECOVERY
TWRP dispose d'un shell autonome, enraciné, indépendant du système du périphérique, et fournit un accès aux ressources du périphérique
localement depuis une interface graphique et un terminal
à distance via une connexion adb usb
à distance via une connexion mtp usb
Un menu s'affiche avec les options Installer, Formater, Sauvegarder, Restaurer, Montage des partitions, Paramètres, Paramètres avancés, Redémarrer.
Dans le menu Paramètres,
Onglet Général, cocher par précaution Ne pas générer de Digest pendant la sauvegarde (sur d'anciennes versions de TWRP, la génération sur des sauvegardes volumineuses générait des erreurs), cocher le format d'horloge sur 24 heures
Sélectionner dans les onglets correspondants le fuseau horaire, la langue
Les autres paramètres par défaut conviennent généralement
Dans le menu Paramètres avancés, noter les options Terminal, Explorateur de fichiers et Transfert via ADB (sideload)
Les commandes adb disponibles dans le mode Système (voir TWRP - Installation et interfaces) sont généralement également utilisables en mode récupération TWRP en tenant compte des éléments suivants
Toutes les commandes adb sont passées en mode super-utilisateur sans qu'il soit nécessaire de passer adb en mode super-utilisateur.
$ adb shell id
uid=0(root) gid=0(root) groups=1004(input),1007(log),1011(adb),1015(sdcard_rw),1028(sdcard_r),3001(net_bt_admin),3002(net_bt),3003(inet),3006(net_bw_stats) context=u:r:su:s0
TWRP dispose de son propre shell et inclut une busybox. La commande busybox fournit son contenu
$ adb shell busybox
BusyBox v1.22.1 bionic (2017-09-23 12:51 +0200) multi-call binary.
.....
Currently defined functions:
[, [[, adjtimex, arp, ash, awk, base64, basename, bbconfig, blkid, ......
$ adb reboot sideload
$ adb sideload fichier.zip
TWRP supporte le protocole mtp et permet donc d'utiliser un explorateur de fichiers tel que thunar pour accéder aux données utilisateurs
mtp://[usb:003,016]/Internal Storage/
mtp://[usb:003,016]/Micro SDCard/
L'accès mtp peut-être activé / désactivé dans le menu "Montage partitions"