Développé par MichelSama, cet outil permet d'automatiser certaines étapes du hack de la Nintendo Switch 2 en utilisant une Nintendo Switch de première génération comme périphérique USB.
Une solution intéressante pour les passionnés de homebrew, qui vise à simplifier les manipulations nécessaires à l'exploitation de la nouvelle console de Nintendo, sans avoir à utiliser systématiquement un ordinateur.

Text file preview

Installation de l'homebrew :

- Décompressez l'archive SD à la racine de la carte SD de la Switch 1. Pour une mise à jour, il suffit de remplacer ce fichier :

sdmc:/switch/plume-usb/plume-usb.nro

- Lancez Plume USB depuis hbmenu sous Atmosphere. Le mode application (maintenez la touche R enfoncée lors du lancement d'un jeu) est recommandé.
- Connectez le port USB-C de la Switch 1 à un hôte USB. Pour un test sur la Switch 2, utilisez un câble de données USB-A vers USB-C reliant la station d'accueil cible à la - Switch 1. Les connexions USB-C directes dépendent de la négociation des rôles.
- Ouvrez un champ de texte sur la console cible qui accepte un clavier USB.
- Faites correspondre la disposition AZERTY FR ou QWERTY US de l’application au paramètre de clavier de la console cible.
- Attendez que le clavier USB soit connecté, sélectionnez « Send Hello », puis appuyez sur A dans l’aperçu. L’envoi commence au bout de trois secondes aucune touche Entrée n’est ajoutée.
- Vérifiez le texte sur la console cible. Appuyez sur X pour activer ou désactiver le verrouillage des majuscules si nécessaire. Appuyez sur - pour accéder aux diagnostics USB.
- Le statut « connecté » nécessite une configuration USB et l’échange complet des descripteurs HID. Des rapports USB indiquant une réussite ne prouvent pas que le champ de texte cible a bien accepté les caractères. Des versions antérieures ont été utilisées pour saisir du texte sur une Switch 2 ; des sauts de ligne manquants ont été signalés à 0, 2 et 10 ms. La version corrigée utilisée pour la version 0.1.7 a reçu un retour positif lors des tests en console. La compatibilité avec d’autres éditeurs cibles et la vitesse maximale fiable dépendent toujours de la cible.

Fichiers texte et délais

- Sélectionnez n'importe quel fichier .txt présent sur la carte SD. Le dossier « texts » du pack contient des exemples. Les fichiers sont lus tels quels, sans modification.
- UTF-8, avec ou sans BOM : taille maximale de 256 KiB.
- L'intégralité du fichier est vérifiée avant l'envoi. Un UTF-8 non valide ou un caractère non pris en charge interrompt la préparation et signale sa position. Aucun remplacement n'est effectué à l'insu de l'utilisateur.
- La disposition américaine prend en charge les caractères ASCII imprimables, les sauts de ligne et les tabulations.
- La disposition française prend également en charge les caractères é, è, ç, à, ù, â, ê, î, ô, û, ä, ë, ï, ö, ü, € et £ ° µ. Les accents composés nécessitent que la cible prenne en charge les touches mortes. Les emojis, les guillemets courbes, le caractère œ, les majuscules accentuées et les accents Unicode décomposés ne sont pas pris en charge.
- Les combinaisons CRLF, CR et LF génèrent chacune une pression sur la touche Entrée. Les tabulations génèrent une tabulation.
- L’application n’ajoute pas d’Entrée finale un saut de ligne final présent dans le fichier est envoyé.
- L’aperçu affiche les premières lignes et jusqu’à 1 023 octets. L’envoi utilise l’intégralité du fichier.
- La touche ZR permet de basculer entre 80, 40, 10, 2, 0 et 160 ms. Le délai s’applique séparément à l’enfoncement et au relâchement de la touche. La touche Entrée utilise la temporisation distincte décrite ci-dessus, sauf si la pause Entrée est égale à 0. Chaque rapport USB doit être terminé avant que le rapport suivant ne soit envoyé, y compris à 0 ms. Les lettres répétées conservent un intervalle entre chaque pression.
- La vitesse réelle dépend de l’hôte USB et du champ de texte. Augmentez le délai si des caractères manquent. L’application ne peut pas détecter les caractères ignorés par l’application cible après l’achèvement de la transmission USB.
- Une déconnexion ou un transfert échoué interrompt l’envoi. La touche « B » annule l’opération et tente de relâcher toutes les touches. Il n’y a pas de nouvelle tentative automatique d’envoi du texte.

Changelog

0.1.7

- Compensation automatique de l'indentation : appuyez sur la touche L dans l'aperçu lorsque l'éditeur cible copie automatiquement l'indentation après avoir appuyé sur Entrée.
- Désactivée par défaut : le paramètre est enregistré.
- La compensation gère les espaces en début de ligne, les tabulations et les combinaisons des deux. Les caractères de retour arrière fournis dans un fichier texte ne sont toujours pas pris en charge et entraînent l'échec de la prévisualisation, même lorsque la compensation est activée.
- Les tests de régression couvrent la sortie de l'éditeur, les lignes vides, les désindentations, les indentations mixtes, les deux mises en page, le rejet des caractères de contrôle et la limite de fichier de 256 KiB.
- La version corrigée du PR a été testée avec succès sur les consoles des utilisateurs. Voir la section sur la compensation ci-dessous pour connaître les hypothèses relatives à l'éditeur.
Merci à AsteroidPizza39 pour la proposition de fonctionnalité et la mise en œuvre initiale dans le PR n° 2.

0.1.6

- Définir un délai d'entrée distinct pour les champs de texte qui ne détectent pas les appuis courts sur la touche Entrée. Par défaut : 50 ms avec toutes les touches relâchées avant l'appui sur Entrée, au moins 50 ms de maintien de la touche Entrée après sa confirmation USB, puis une pause de 200 ms après la confirmation de relâchement. Les délais entre les caractères restent indépendants.
- Dans l’aperçu du fichier, appuyez sur R ou sur la touche Entrée (pause) pour faire défiler les valeurs 200, 400, 800, 0 et 100 ms. Le réglage est enregistré. La valeur 0 désactive la synchronisation spéciale de la touche Entrée. À partir de 100 ms, les durées de relâchement et de maintien restent d’au moins 50 ms. Les délais de caractères sélectionnés plus longs sont conservés.
- Cette fonctionnalité vise à réduire les sauts de ligne manquants ; la compatibilité avec l’éditeur cible nécessite toutefois un test matériel. Commencez par 200 ms, puis essayez 400 ou 800 ms si des sauts de ligne manquent toujours. Aucune pression double sur la touche Entrée n’est insérée.

0.1.5

- Interface en anglais et libellés plus courts et descriptifs.
- Touche Caps Lock et raccourci X. Envoie une seule pression sur la touche Caps Lock à l'appareil connecté, puis la relâche. L'état affiché provient de l'hôte : activé, désactivé ou inconnu si l'hôte n'a pas signalé l'état des LED de son clavier.
- Les diagnostics USB utilisent désormais le raccourci moins (-).
- Les délais sont affichés directement en millisecondes : 80, 40, 10, 2, 0 et 160 ms. Les paramètres enregistrés existants conservent leur signification.
- La touche Caps Lock ne bloque jamais la saisie de texte. L’application ne la modifie ni ne la compense automatiquement ; la casse de la dernière lettre dépend de l’état de la cible. La commutation manuelle est disponible tant qu’aucun texte n’est en cours d’envoi.

Lien de téléchargement : Plume USB 0.1.7

Plume USB 0.1.7 disponible sur Nintendo, une automatisation du hack de la Switch 2 avec une Switch 1