Installation pour essais matériels / Hardware test installation¶

Version 0.x pour T2B1 et T3B1. Les opérations principales ont été vérifiées lors d’une première campagne physique T2B1/macOS. La recette matérielle complète est en cours. Consultez le rapport.

Installer en trois étapes¶

Télécharger et vérifier. Identifiez le modèle interne avec trezorctl get-features, puis téléchargez son .bin dans les versions GitHub. Vérifiez son SHA-256 et sauvegardez le portefeuille existant.
Déverrouiller et installer. Reconnectez en maintenant gauche, activez Init connection, puis déverrouillez une seule fois avec trezorctl device unlock-bootloader. Confirmez l’effacement irréversible. Reconnectez en bootloader et ouvrez Trezor Suite → Settings → Device → Danger Area → Install custom firmware. Sélectionnez ou glissez le .bin dans la zone de téléchargement et confirmez sur l’appareil. La procédure CLI détaillée ci-dessous a été testée sur T2B1 avec le bootloader 2.1.16.
Démarrer feuristic. Acceptez l’avertissement tiers, choisissez la langue et créez un PIN de test. Continuez avec le guide d’utilisation.

L’installation efface le portefeuille et supprime définitivement l’attestation constructeur. Le retour au firmware officiel ne la restaure pas. Le volume d’import OTP ne sert pas à installer un firmware.

Conséquences à accepter avant toute manipulation¶

Utiliser un appareil dédié aux essais, sans fonds ni identités de production. Conserver les sauvegardes existantes hors de cet appareil. feuristic ne restaure aucune phrase Trezor et ne migre aucun portefeuille.

Le déverrouillage du bootloader est irréversible. Il efface le stockage et les secrets d'appairage Optiga ; la preuve d'authenticité constructeur et l'attestation FIDO d'origine ne sont plus utilisables. Le firmware continue avec les protections restantes du stockage, mais ne revendique pas la même configuration d'attestation qu'un appareil d'origine. feuristic emploie une attestation FIDO propre à son profil, sans certification constructeur.

Preuves dans la base épinglée :

workflow de déverrouillage : confirmation locale, erase_storage, puis secret_unlock_bootloader ;
secret STM32F4 et secret STM32U5 : effacement du secret ou des emplacements privés ;
initialisation Optiga : perte du canal protégé et des attestations lorsque le secret n'est plus disponible ;
en-tête tiers T2B1 et T3B1 : avertissement UNSAFE, DO NOT USE!, clic utilisateur et délai.

Cet avertissement revient au démarrage. Le remplacer par un message de confiance constructeur n'est pas une étape d'installation.

Préparer le binaire et les outils¶

Depuis la racine du dépôt déjà préparé :

uv run trezorctl --help
uv run trezorctl device unlock-bootloader --help
uv run trezorctl firmware update --help

trezorctl provient du sous-module épinglé, via l'environnement uv du projet. Prévoir un câble USB de données fiable et une alimentation stable. Fermer Suite, les navigateurs et les autres clients de l'appareil avant le flash.

Construire le modèle exact, par exemple T2B1 :

make firmware MODEL=T2B1

Sélectionner le fichier de ce modèle, de cette version et du commit courant avec les commandes suivantes. Si la campagne fournit un autre artefact, définir FW avec son chemin exact et comparer au manifeste reçu. Ne pas utiliser un fichier DEBUG.bin.

FEURISTIC_TEST_MODEL=T2B1
FEURISTIC_TEST_VERSION=$(uv run --quiet python -c "import sys; sys.path.insert(0,'src'); from feuristic.version import VERSION; print(VERSION)")
FEURISTIC_TEST_REV=$(git rev-parse --short=12 HEAD)
FW="$PWD/dist/feuristic-$FEURISTIC_TEST_VERSION-$FEURISTIC_TEST_MODEL-$FEURISTIC_TEST_REV.bin"

Depuis le dossier contenant le binaire et son fichier .sha256, vérifier ensuite :

shasum -a 256 -c "$(basename "$FW").sha256"
uv run trezorctl firmware update --dry-run --filename "$FW"

Le dry-run requiert un appareil détectable ; il valide les étapes hôte sans écrire le firmware. Les builds d'essai utilisent les clés de développement publiques amont : un avertissement de clés de développement peut apparaître. Un SHA-256 assure l'intégrité par rapport au manifeste reçu ; il ne prouve pas à lui seul l'identité de son émetteur. Une erreur de modèle, d'en-tête ou de signature doit être diagnostiquée avant tout flash. Ne pas contourner ces contrôles avec --raw ou --skip-check.

Déverrouiller puis installer¶

Noter le modèle, la version de bootloader, la révision du dépôt et le SHA-256 du binaire dans le journal de recette.
Démarrer en bootloader : débrancher puis reconnecter le Safe 3 en maintenant le bouton gauche. Si le sous-menu propose « Factory Reset », « Exit menu » et « Reboot Trezor », sélectionner « Exit menu » avec gauche/droite et valider avec les deux boutons. Depuis l'écran principal du bootloader, choisir « Init connection » à gauche pour activer l'USB ; avant cette action, trezorctl peut ne détecter aucun appareil. Les indications affichées par l'appareil priment si son bootloader demande une autre séquence.
Après lecture des conséquences ci-dessus, lancer :

uv run trezorctl device unlock-bootloader

Confirmer physiquement le déverrouillage sur l'appareil. L'effacement est effectué par le bootloader. Annuler à l'écran permet de renoncer avant cet effacement, pas de restaurer les secrets après confirmation. Lorsque « Bootloader unlocked / Please reconnect the device » apparaît, débrancher/rebrancher puis reprendre l'étape 2, y compris « Init connection ». 4. Toujours dans le bootloader, installer le fichier déjà vérifié :

uv run trezorctl firmware update --filename "$FW"

Vérifier le modèle et les avertissements sur l'appareil, confirmer, puis attendre la fin sans retirer le câble. Redémarrer si demandé.
Le premier démarrage doit montrer l'avertissement tiers, le choix de langue, puis la création du PIN. Suivre R01 avant les autres essais. Un échec reste un défaut de candidat à enregistrer, jamais une qualification implicite.

La procédure officielle Trezor décrit l'installation d'un fichier via Suite et les confirmations du bootloader. Elle ne constitue pas une validation de feuristic. La procédure ci-dessus utilise les commandes standard disponibles dans le code amont épinglé.

Mise à jour et récupération¶

Avant une mise à jour feuristic, exporter les identités et effectuer un essai réel de restauration sur un autre appareil de test. La conservation du stockage entre versions non qualifiées n'est pas une garantie. Vérifier à nouveau modèle et empreinte, démarrer en bootloader et réutiliser firmware update --filename ; ne pas déverrouiller à nouveau un appareil déjà déverrouillé.

Si l'application ne démarre plus, le bootloader officiel constitue le chemin de récupération : maintenir gauche à la connexion et flasher un binaire connu du bon modèle. Ne pas remplacer boardloader/bootloader et ne pas employer les commandes SWD/DFU prévues pour cartes vierges. Un retour au firmware officiel doit suivre les instructions actuelles du constructeur ; il ne récupère ni les identités effacées ni l'attestation d'usine.