Outils de gestion des adaptateurs raphnet

À propose de ce projet

La troisième génération de mon adaptateur Gamecube/N64 à USB peut être mise à jour par l'utilisateur et offre des fonctionnalités avancés comme la configuration de la fréquence d'interrogation et l'accès aux cartes mémoire N64.

Comme cela dépasse les capacités d'une manette de jeu standard, les systèmes d'exploitation ne prennent pas en charge ces nouvelles fonctions. Le développement de logiciels complémentaires a donc été nécessaire.

Ces outils (graphiques ou en ligne de commande) sont distribués et documentés sur cette page.

Fonctionnalités:
  • Affichage de la version d'adaptateur
  • Mise à jour du firmware d'un adaptateur
  • Affichage du type de manette branché à l'adaptateur
  • Test de vibration (N64 Rumble pak et vibration manette gamecube
  • Lecture et écriture de cartes mémoire N64, éditeur de carte mémoire.
  • Support du Transfer Pak pour N64:
    • Lecture du ROM des cartouches gameboy de type ROM-Only, MBC1, MBC2, MBC3, MBC5 et POCKET CAMERA.
    • Lecture et écriture de la RAM de sauvegarde pour les cartouches gameboy de type MBC1, MBC2, MBC3, MBC5 et POCKET CAMERA.
  • Gestion d'adaptateurs Gamecube à N64 (mise à jour, affichage de la version)
  • Pour Windows et Linux




Téléchargements

Flux RSS pour cette table
Version 2.1.30
22 mai 2024 (Mercredi)
Interface améliorée pour les adaptateurs pour deux joueurs et nouveau firmware. Détails:
  • Nouveau firmware 2.2 pour adaptateur Famicom à USB (Support 2 joueurs et manettes SNES)
  • Pour les adaptateurs deux joueurs, affiche également le type de manette détectée dans le port 2.
Fichier(s):
raphnet-tech_adapter_manager-install-2.1.30.exe (17.5 MB)
raphnet-tech_adapter_manager-2.1.30.tar.gz (2.7 MB)
Afficher les versions précédentes
Version 2.1.29
25 avril 2024 (Jeudi)
  • Devrait corriger les erreurs Failed to open adapter sous Windows qui surviennent lorsque des logiciels de contrôle d'éclairage tels que RGB Fusion, G HUB, Windows Dynamic lighting...
  • Nouveau firmware v2.1 pour les adaptateurs Dreamcast à USB
Fichier(s):
raphnet-tech_adapter_manager-install-2.1.29.exe (17.5 MB)
raphnet-tech_adapter_manager-2.1.29.tar.gz (2.6 MB)
Version 2.1.28
16 mars 2023 (Jeudi)
  • Nouveau firmware pour adaptateur Dreamcast à USB (v2.0.2):
    • Nouvelle option pour les gâchettes L/R qui permet de retourner des valeurs de (-32000 à 32000) plutôt que 0 à 32000.
  • Nouveau firmware pour adaptateur Famicom à USB (v2.1.0):
    • Support du Konami HyperShot.
    • Le clavier famicom n'est désormais pris en charge qu'en mode clavier.
Fichier(s):
raphnet-tech_adapter_manager-install-2.1.28.exe (17.5 MB)
raphnet-tech_adapter_manager-2.1.28.tar.gz (2.6 MB)
Version 2.1.27
11 août 2022 (Jeudi)
  • Nouveaux firmwares pour les adaptateurs SNES/N64/Classic à Gc/Wii implémentant des options de formattage moins courantes où les valeurs du C-Stick et/ou des gachettes L/R peuvent être rapportées au choix en employant 4 ou 8 bits. Ceci corrige le fonctionnement de l'aspirateur dans Luigi's Mansion, et probablement quelques autres jeux!
    • N64 à Gc/Wii v2.5
    • SNES à GC/Wii v2.5
    • Classic à GC/Wii v1.7
  • Ligne de commande: --gc_pollraw prends désomais en argument le mode de formattage à employet (Mode 3 pour C-Stick et gâchettes L/R sous 8 bits)
  • Support pour les adaptateurs avec accéléromètre
Fichier(s):
raphnet-tech_adapter_manager-install-2.1.27.exe (18.9 MB)
raphnet-tech_adapter_manager-2.1.27.tar.gz (2.6 MB)
Version 2.1.26
10 juin 2022 (Vendredi)
  • Nouveau firmware v2.2.7 pour l'adaptateur manette Classique à USB:
    • Nouvelle option pour inverser l'axe X ou Y du stick.
    • Mode souris: Support des guitares pour Wii.
    • Mode souris: Ajout d'une option pour déactiver le défilement avec une Nunchuk.
    • Correction des valeurs émises par l'option 'D-Pad as axes' (incorrect depuis la version v2.2.2)
  • Nouveau firmware 1.0.2 pour l'adaptateur PSX à USB:
    • Support du joystick analogique (SCPH-1110). Devrait également fonctionner pour la manette Dual Analog.
    • Support de la souris Playstation (SCPH-1030)
    • Utilisation de signaux plus lents lorsque l'intervalle d'interrogation est >= 10ms. Cela aidera peut-être certains périphérique non-Sony à fonctionner.
Fichier(s):
raphnet-tech_adapter_manager-install-2.1.26.exe (18.9 MB)
raphnet-tech_adapter_manager-2.1.26.tar.gz (2.6 MB)
Version 2.1.25
2 septembre 2021 (Jeudi)
  • Support pour l'inversion des valeurs d'axe X ou Y (pour les firmwares le supportant)
  • Firmware v1.6 pour adaptateur manette classique à GC/Wii : Ajout d'une nouvelle option d'équivalence des boutons
  • Firmware 2.4 pour adaptateur manette SNES à GC/Wii: Corrige un problème de centrage/dérive dans les jeux où la zone morte est très petite.
  • Firmware v1.6 pour l'adaptateur de manette SNES à N64 : Ajout d'une nouvelle option d'équivalence des boutons (mode 4)
Fichier(s):
raphnet-tech_adapter_manager-install-2.1.25.exe (18.9 MB)
raphnet-tech_adapter_manager-2.1.25.tar.gz (2.5 MB)
Ce projet est aussi disponible sur GitHub!
Pour suggérer de nouvelles fonctionnalités, signaler un problème ou contribuer au projet, vous pouvez m'écrire ou utiliser le dépôt GitHub:
https://github.com/raphnet/gcn64tools
Vous cherchez un fichier .hex de mise à jour de firmware? Les firmwares sont distribués depuis la page de l'adaptateur.


Interface graphique

L'interface graphique permet de tester la vibration, de faire la mise à jour de l'adaptateur et la lecture/écriture de mempak N64. L'éditeur de mempak intégré supporte les formats .N64 et .MPK. Le gestionnaire permet également d'exporter et d'importer des sauvegardes («notes») à l'unité.
Écran principal (Linux)

Écran principal (Linux)

Écran principal (Win7)

Écran principal (Win7)

Éditeur de mempak

Éditeur de mempak



Le processus de mise à jour vous demande de choisir le fichier .hex et fait quelques vérifications pour éviter les erreurs (ex: Mettre un firmware incompatible). Une fois le fichier choisi, il n'y a qu'à appuyer sur "Start update". Si tout se passe bien (surtout ne débranchez rien!) après quelques moments la fenêtre de succès (Update successful) confirmera la mise à jour.
Avant

Avant

Pendant

Pendant

Après

Après





Outils en ligne de commande

Les outils en ligne de commande sont très pratiques si c'est quelque chose que vous savez apprécier. L'installateur sous Windows les place dans le répertoire d'installation et créé un raccourci permettant d'y accéder facilement:


Outil gcn64ctl

Voici quelques exemples d'utilisations de gcn64ctl. Utilisez l'option --help pour avoir une liste complète.
# Lister les adaptateurs
$ ./gcn64ctl -l
Simply listing the devices...
Found device 'GC/N64 to USB v3.0', serial '000001'
1 device(s) found
# Pour afficher la version d'un adaptateur
$ ./gcn64ctl -s 000001 --get_version
Firmware version: 3.1.0
# Pour afficher la fréquence d'interrogation présentement configurée
$ ./gcn64ctl -s 000001 --get_poll_rate
Poll interval: 5 ms

# Et pour la configurer:
$ ./gcn64ctl -s 000001 --set_poll_rate 10
Setting poll interval to 10 ms
# Pour lire un mempak N64
$ ./gcn64ctl -s 000001 --n64_mempak_dump --outfile backup.n64
Output file: backup.n64
Reading mempak...
Reading address 0x7fe0 / 0x8000
Wrote file 'backup.n64' in N64 format

Outils de manipulation d'image de mempak

Ces outils permettent de convertir entre les formats .MPK et .N64, d'afficher et manipuler le contenu d'une image (ajouter/enlever/exported des «notes»), etc. Ces outils agissent sur des fichiers et n'accèdent pas au mempak. Pour lire et écrire le mempak d'un manette, utilisez gcn64ctl ou l'outil graphique.

Note: Toutes ces manipulations de sauvegardes sont également possibles via l'outil graphique.
# Afficher le contenu
$ ./mempak_ls test2.n64
File size: 36928 bytes
.N64 file detected
Mempak image loaded. Image type 3 (N64)
Mempak content is valid
Block usage: 97 / 123
Note 0: PERFECT DARK. (28 blocks) 
Note 1: QUEST64.0 (2 blocks) 
Note 2: TUROK LVL 8. (16 blocks) 
Note 3: RAMPAGE WT. (7 blocks) 
Note 4: TUROK LVL 8. (16 blocks) 
Note 5: PERFECT DARK. (28 blocks) 
Note 6: Free
...
Note 15: Free
# Pour effacer une « note » (numéro de note de mempak_ls)
./mempak_rm test2.n64 5
File size: 36928 bytes
.N64 file detected
Loaded pakfile in N64 format.
Deleting note 5 (28 blocks)
# Convertir le format d'image
./mempak_convert test2.n64 test2a.mpk -f mpk
File size: 36928 bytes
.N64 file detected
Loaded file 'test2.n64' (N64 format)
Wrote file 'test2a.mpk' in MPK format
# Création d'une image (formattage)
$ ./mempak_format new.n64
Wrote empty (formatted) memory card file 'new.n64' in 'N64' format
# Extraire une note
$ ./mempak_extract_note test2.n64 3 rampage.note
File size: 36928 bytes
.N64 file detected
Exported note 3 to file 'rampage.note'
# Insérer une note
$ ./mempak_insert_note new.n64 rampage.note
File size: 36928 bytes
.N64 file detected
Loaded pakfile in N64 format.
Current free blocks: 123
Note size: 7 blocks
Note name: RAMPAGE WT.
Note imported and written to slot 0



Mettre un adaptateur à jour sous Windows

Utilisateurs de Windows, SVP lire ceci:
  1. Lorsque vous ferez la mise à jour d'un adaptateur pour la toute première fois, Windows détectera un nouveau périphérique et voudra installer un pilote. C'est normal. Par contre, cela prends tellement de temps que la mise à jour échouera. Pas de panique, débranchez l'adaptateur, redémarrez et réessayez.
  2. Avec la version actuelle de l'outil, il y a malheureusement une fenêtre noire qui vient et part constamment durant la mise à jour. Ne vous inquiétez pas, c'est normal. Je corrigerai cela un jour, mais en attendant au moins ça fonctionne.
Note: Avant de vous plaindre des défauts de l'outil, sachez que mon absence d'intérêt pour la programmation d'interfaces graphiques combinée à une forte aversion pour la programmation sous Windows font que l'existence même de cet outil est pratiquement un miracle.

Prêt

Prêt

Fenêtre noire

Fenêtre noire





Notes pour Linux

Si bien que l'adaptateur soit branché l'outil ne le détecte pas, c'est très probablement parce que votre utilisateur n'a pas les droits pour y accéder.

Exécuter l'outil en tant que root fonctionnerait, mais c'est une très mauvaise pratique. Il vaut mieux configurer udev pour donner les droits à un utilisateur ou à un groupe. Sur mon système, mon usager est membre du groupe plugdev, et les fichiers suivants donnent accès au groupe plugdev à l'adaptateur en mode normal (99-raphnet.rules) et en mode de mise à jour (99-atmel-dfu.rules).

/etc/udev/rules.d/99-raphnet.rules
SUBSYSTEM=="hidraw", ATTRS{idVendor}=="289b", ATTRS{idProduct}=="0017", MODE="0664", GROUP="plugdev"
SUBSYSTEM=="hidraw", ATTRS{idVendor}=="289b", ATTRS{idProduct}=="001d", MODE="0664", GROUP="plugdev"
/etc/udev/rules.d/99-atmel-dfu.rules
ATTR{idVendor}=="03eb", ATTR{idProduct}=="2ff0", MODE="0664", GROUP="plugdev" # ATmega32U2 DFU
ATTR{idVendor}=="03eb", ATTR{idProduct}=="2ffb", MODE="0664", GROUP="plugdev" # AT90USB128 DFU
Note: Il va de soi que ces instructions pourraient nécessiter des adaptations selon la nature de votre système ou vos besoins.


Transfer Pak

Le Transfer Pak permet de lire et écrire la mémoire RAM de sauvegarde. Vous pouvez ainsi faire des copies de vos parties, ou les transférer vers des émulateurs. La mémoire ROM peut également être lue vers un fichier pour utilisation avec un émulateur...

Les types de cartouches

Il existe plusieurs types de cartouches Gameboy dont seulement quelques unes sont supportées en ce moment. Les types de cartouches et jeux testés jusqu'à présent sont:
  • ROM-Only: Tetris, Alley Way
  • MBC1: Final Fantasy Legend II, Nemesis
  • MBC2
  • MBC3: Pokemon blue
  • MBC5: Mario Golf, Mario Tennis
  • POCKET CAMERA: Caméra pour GameBoy

Transfert vers un émulateur

Les donnés de sauvegarde lues par cet outil seront au format .sav qui est utilisé par plusieurs émulateurs. Démarrez d'abord le jeu dans votre émualteur afin de créer un fichier de sauvegarde vierge. Trouvez ensuite l'endroit où votre émulateur stocke les fichiers .sav et écrasez celui dont le nom correspond lorsque vous lirez la mémoire de votre cartouche originale.

Voici un exemple utilisant VisualBoyAdvance sous Windows 10. Le fichier .sav est crée dans le même répertoire que le ROM (fichier .gb) et porte exactement le même nom:


Transfert vers la cartouche

Transférer la sauvegarde d'une émulateur vers une cartouche physique est le processus inverse de ce qui est décrit ci-dessus. Il s'agit de trouver l'endroit où l'émulateur a stocké votre toute dernière partie et de sélectionner le ficher correspondant pour lancer l'écriture. Les données seront ensuite inscrites dans la mémoire RAM, puis vérifiées par relecture.

Attention!: Avant d'écrire vers une cartouche contenant une précieuse partie, assurez-vous d'en avoir fait une copie et d'avoir testé la copie dans un émulateur (car qui sait, et s'il y avait eu une erreur de lecture?). Et quoi qu'il arrive, que cette précaution ait été prise ou non, je ne suis pas responsable si votre partie s'efface.




Avertissement

Je ne saurais être tenu responsable pour les dommages que l'utilisation des informations ou la mise en œuvre des instructions présentées sur cette page pourrait causer à votre équipement, à vous-même ou à autrui. Aussi, je ne donne aucune garantie quant à l'exactitude des informations et à leur fonctionnement.